Metadata-Version: 2.5
Name: kitaru-openai-agents
Version: 0.3.0
Summary: OpenAI Agents SDK recording adapter for Kitaru.
Project-URL: Homepage, https://kitaru.ai
Project-URL: Documentation, https://docs.zenml.io/kitaru/adapters/openai-agents
Project-URL: Repository, https://github.com/zenml-io/kitaru
Project-URL: Issues, https://github.com/zenml-io/kitaru/issues
Project-URL: Changelog, https://github.com/zenml-io/kitaru/blob/develop/plugins/packages/openai-agents/CHANGELOG.md
Author-email: ZenML GmbH <info@zenml.io>
License-Expression: Apache-2.0
Keywords: ai-agents,kitaru,openai-agents,recording,replay
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: kitaru>=0.27.0
Requires-Dist: openai-agents<0.23,>=0.19.3
Description-Content-Type: text/markdown

# Kitaru OpenAI Agents adapter

Record OpenAI Agents SDK runs with Kitaru. The adapter is non-streaming: it preserves the native `RunResult` while recording each run as a Kitaru session with root and observed activity nodes.

## Install

```bash
uv add kitaru-openai-agents
```

## Use

```python
import uuid

from agents import Agent

from kitaru_openai_agents import KitaruRunner

agent = Agent(
    name="assistant",
    instructions="Answer in one concise sentence.",
    model="gpt-5-nano",
)
runner = KitaruRunner(
    agent_id=uuid.UUID("018f0000-0000-7000-8000-000000000100"),
    session_name="openai-agents-example",
)
result = runner.run_sync(agent, "Hello")
print(result.final_output)
```

`KitaruRunner.run()` and `KitaruRunner.run_sync()` accept the same run arguments as the OpenAI Agents SDK `Runner`. Kitaru workers provide task, replay, and authentication context through the standard task environment.

The adapter supports bounded replay of non-streaming runs. See the [OpenAI Agents SDK adapter guide](https://docs.zenml.io/kitaru/adapters/openai-agents) for supported overrides and tool policies, capture limits, approval and resume boundaries, and recording-failure behavior.

## Links

- [Kitaru documentation](https://docs.zenml.io/kitaru)
- [Source code](https://github.com/zenml-io/kitaru)
- [Issue tracker](https://github.com/zenml-io/kitaru/issues)

Licensed under Apache-2.0.
