Metadata-Version: 2.4
Name: missiontrace
Version: 0.1.0
Summary: Observability and tracing SDK for AI agent systems
Author-email: Aniruddha Mandal <aniruddha1.2.3.3.2.1@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/AniLeo-01/missiontrace-python
Project-URL: Repository, https://github.com/AniLeo-01/missiontrace-python
Project-URL: Issues, https://github.com/AniLeo-01/missiontrace-python/issues
Keywords: observability,tracing,ai,agents,llm,opentelemetry
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0
Requires-Dist: opentelemetry-api>=1.20
Requires-Dist: opentelemetry-sdk>=1.20
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.20
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == "openai"
Provides-Extra: tinyfish
Requires-Dist: tinyfish>=0.2; extra == "tinyfish"
Provides-Extra: all
Requires-Dist: openai>=1.0; extra == "all"
Requires-Dist: tinyfish>=0.2; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Dynamic: license-file

# MissionTrace SDK

[![PyPI version](https://img.shields.io/pypi/v/missiontrace.svg)](https://pypi.org/project/missiontrace/)
[![Downloads](https://img.shields.io/pypi/dm/missiontrace.svg)](https://pypi.org/project/missiontrace/)
[![CI](https://github.com/aniruddha/missiontrace-python/actions/workflows/ci.yml/badge.svg)](https://github.com/aniruddha/missiontrace-python/actions/workflows/ci.yml)

Observability and tracing SDK for AI agent systems.

## Installation

```bash
pip install missiontrace
```

**With adapters:**

```bash
pip install missiontrace[openai]    # OpenAI + compatible LLMs
pip install missiontrace[tinyfish]  # TinyFish web agents
pip install missiontrace[all]       # All adapters
```

## Quick Start

```python
import missiontrace

missiontrace.init(api_key="mt_xxx", project="my-project")

with missiontrace.mission(name="research-task") as m:
    with missiontrace.action("inference", name="openai.chat", intent="generation") as act:
        result = call_llm("Summarize Acme Corp")
        act.set_output({"response": result})
```

## Adapters

### OpenAI (+ Compatible Providers)

```bash
pip install missiontrace[openai]
```

```python
from missiontrace.adapters.openai import instrument
instrument()

client = OpenAI()
response = client.chat.completions.create(model="gpt-4o", messages=[...])
```

Auto-detects: OpenAI, Gemini, Groq, Together, Mistral, Fireworks, DeepSeek, OpenRouter, Cerebras, Perplexity, Azure OpenAI.

### TinyFish (Web Agents)

```bash
pip install missiontrace[tinyfish]
```

```python
from missiontrace.adapters.tinyfish import instrument
instrument()

client = TinyFish(api_key="tf_xxx")
response = client.agent.run(goal="Find the price", url="https://example.com")
```
