Metadata-Version: 2.4
Name: chronicle-agent-sdk
Version: 0.8.0
Summary: Python SDK for capturing and shipping AI agent traces to a Chronicle server
Project-URL: Homepage, https://github.com/chidhvilasa/chronicle
Project-URL: Repository, https://github.com/chidhvilasa/chronicle
Project-URL: Issues, https://github.com/chidhvilasa/chronicle/issues
Project-URL: Changelog, https://github.com/chidhvilasa/chronicle/blob/main/CHANGELOG.md
Author: chidhvilasa
License: MIT
Keywords: agents,ai,debugging,langgraph,llm,observability,tracing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: h11>=0.16.0
Requires-Dist: httpx>=0.28.0
Provides-Extra: all
Requires-Dist: crewai>=0.70.0; extra == 'all'
Requires-Dist: langgraph>=0.2.0; extra == 'all'
Requires-Dist: openai-agents>=0.0.3; extra == 'all'
Requires-Dist: pyautogen>=0.2.0; extra == 'all'
Requires-Dist: pydantic-ai>=0.0.14; extra == 'all'
Requires-Dist: semantic-kernel>=1.0.0; extra == 'all'
Provides-Extra: autogen
Requires-Dist: pyautogen>=0.2.0; extra == 'autogen'
Provides-Extra: crewai
Requires-Dist: crewai>=0.70.0; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: hypothesis>=6.100.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.2.0; extra == 'langgraph'
Provides-Extra: openai-agents
Requires-Dist: openai-agents>=0.0.3; extra == 'openai-agents'
Provides-Extra: pydanticai
Requires-Dist: pydantic-ai>=0.0.14; extra == 'pydanticai'
Provides-Extra: semantic-kernel
Requires-Dist: semantic-kernel>=1.0.0; extra == 'semantic-kernel'
Description-Content-Type: text/markdown

# chronicle-sdk

Python SDK for [Chronicle](../README.md) — the Chrome DevTools for AI agents.

Instrument your agent code with `ChronicleTracer` to capture tool calls, LLM
calls, agent messages, memory updates, errors, and retries. Events are
buffered and flushed to a local Chronicle server over HTTP in batches; if the
server isn't running, unsent events are written to
`chronicle_runs/{run_id}.json` so nothing is lost.

## Install

```bash
pip install -e .
```

## Usage

```python
from chronicle import ChronicleTracer

with ChronicleTracer() as tracer:
    tracer.record_event("tool_call", data={"tool_name": "search", "arguments": {"query": "weather in nyc"}})
    tracer.record_event("llm_call", data={"model": "gpt-4o", "prompt": "What's the weather?"})
    tracer.record_event("agent_message", data={"role": "assistant", "content": "It's sunny."})
```

## LangGraph / LangChain

```python
from chronicle import ChronicleTracer, LangGraphAdapter

tracer = ChronicleTracer()
adapter = LangGraphAdapter(tracer)

graph.invoke(input, config={"callbacks": [adapter]})
```

## Development

```bash
pip install -e ".[dev]"
pytest
```
