Metadata-Version: 2.4
Name: watchllm
Version: 0.3.1
Summary: The Flight Recorder SDK for AI Agents — zero-config instrumentation for LangChain, CrewAI, MCP, and AutoGen.
Author-email: Pranav Kaadi <hello@watchllm.dev>
License: MIT
Keywords: agents,crewai,debugging,langchain,llm,mcp,observability,time-travel
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.10
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: pydantic<3.0,>=2.0
Provides-Extra: all
Requires-Dist: crewai<2.0,>=0.80; extra == 'all'
Requires-Dist: langchain-core<1.0,>=0.3; extra == 'all'
Requires-Dist: mcp<2.0,>=1.0; extra == 'all'
Provides-Extra: crewai
Requires-Dist: crewai<2.0,>=0.80; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain-core<1.0,>=0.3; extra == 'langchain'
Provides-Extra: mcp
Requires-Dist: mcp<2.0,>=1.0; extra == 'mcp'
Description-Content-Type: text/markdown

# WatchLLM SDK

The Flight Recorder SDK for AI Agents.

## Install

```bash
pip install watchllm
```

Optional extras:

```bash
pip install "watchllm[langchain]"
pip install "watchllm[crewai]"
pip install "watchllm[mcp]"
pip install "watchllm[all]"
```

## Quick Start

```python
import watchllm

watchllm.configure(
    api_url="https://watchllm-7a6am.ondigitalocean.app",
    project_name="my-project",
)

@watchllm.watch
def run_agent(prompt: str):
    return {"ok": True, "prompt": prompt}

run_agent("hello")
```

## Features

- `@watch` decorator for automatic trace capture
- `watch_trace()` context manager for manual instrumentation
- LangChain callback handler support
- CrewAI hook support
- MCP client wrapper support
- Fork & resume API (`resume_from_fork`)
