Metadata-Version: 2.4
Name: kantan-agents
Version: 0.1.0
Summary: kantan-agents is a thin, opinionated wrapper around the OpenAI Agents SDK that makes observability and evaluation “just happen” by default.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: kantan-llm>=0.1.6
Requires-Dist: openai-agents>=0.6.4

# kantan-agents

kantan-agents is a thin, opinionated wrapper around the OpenAI Agents SDK that makes observability and evaluation "just happen" by default.

## What it does

- Re-exports the Agents SDK tracing API.
- Provides an Agent wrapper that injects standardized Trace metadata.
- Provides a minimal Prompt model for versioned instructions.
- Supports structured outputs via `output_type` and a `RUBRIC` schema helper.
- Supports handoffs between Agent instances.

## Quick Start

```python
from kantan_agents import Agent

agent = Agent(name="basic-agent", instructions="You are a helpful assistant.")
result = agent.run("Hello")
print(result.final_output)
```

## Docs

- `docs/concept.md`
- `docs/spec.md`
- `docs/architecture.md`
- `docs/plan.md`
- `docs/tutorial.md`
- `docs/usage.md`
