Metadata-Version: 2.4
Name: aerograph-sdk
Version: 0.2.0
Summary: Python SDK for AeroGraph — emit trace events from Python agent workflows.
Project-URL: Homepage, https://github.com/SGcpu/AeroGraph
Project-URL: Repository, https://github.com/SGcpu/AeroGraph
Project-URL: Issues, https://github.com/SGcpu/AeroGraph/issues
License: Apache-2.0
Keywords: aerograph,agent,ai,observability,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: datamodel-code-generator>=0.25.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# aerograph-sdk

Python SDK for [AeroGraph](https://github.com/SGcpu/AeroGraph) — the open-source flight recorder for AI agent workflows.

## Installation

```bash
pip install aerograph-sdk
```

## Quickstart

```python
from aerograph_sdk import FlightRecorder

recorder = FlightRecorder(
    endpoint="http://localhost:4317",
    actor={"id": "my-agent", "name": "My Agent"},
)

# Emit events
prompt_event = recorder.prompt(parent_span_id=None, text="What is AeroGraph?")
recorder.response(parent_span_id=prompt_event.spanId, text="AeroGraph records agent traces.")
```

## Features

- Emit 10 event kinds: `prompt`, `response`, `tool_call`, `tool_result`, `handoff`, `error`, `note`, `state_snapshot`, `retriever`, `checkpoint`
- Sync and async emission via `httpx`
- Batch emission with deterministic event ordering
- Cross-language hash compatibility with the TypeScript SDK
- Pydantic v2 contract validation

## License

Apache-2.0
