Metadata-Version: 2.4
Name: agent-runtime-kit
Version: 0.1.1
Summary: One typed runtime API for Claude, Codex, and Antigravity agent SDKs.
Project-URL: Homepage, https://github.com/ebarti/agent-runtime-kit
Project-URL: Repository, https://github.com/ebarti/agent-runtime-kit
Project-URL: Issues, https://github.com/ebarti/agent-runtime-kit/issues
Author: Eloi Barti
License-Expression: MIT
License-File: LICENSE
Keywords: agents,antigravity,claude,codex,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: all
Requires-Dist: claude-agent-sdk>=0.2.87; extra == 'all'
Requires-Dist: google-antigravity>=0.1.2; extra == 'all'
Requires-Dist: openai-codex>=0.1.0b3; extra == 'all'
Provides-Extra: antigravity
Requires-Dist: google-antigravity>=0.1.2; extra == 'antigravity'
Provides-Extra: claude
Requires-Dist: claude-agent-sdk>=0.2.87; extra == 'claude'
Provides-Extra: codex
Requires-Dist: openai-codex>=0.1.0b3; extra == 'codex'
Description-Content-Type: text/markdown

# agent-runtime-kit

`agent-runtime-kit` is a small Python runtime layer for agent SDKs. It gives
applications one typed async API for dispatching an agentic task through Claude
Agent SDK, OpenAI Codex SDK, or Google Antigravity SDK while keeping provider
capabilities visible.

The package is intentionally not a router, benchmark harness, queue, hosted
service, or full agent framework. It is the reusable layer underneath those
systems: task models, runtime capabilities, event sinks, availability
diagnostics, and adapters.

## Install

Core only:

```bash
pip install agent-runtime-kit
```

Provider extras:

```bash
pip install "agent-runtime-kit[claude]"
pip install "agent-runtime-kit[codex]"
pip install "agent-runtime-kit[antigravity]"
pip install "agent-runtime-kit[all]"
```

```python
import asyncio

from agent_runtime_kit import AgentTask, FakeAgentRuntime


async def main() -> None:
    runtime = FakeAgentRuntime(output="done")
    result = await runtime.run(AgentTask(goal="Summarize this repository"))
    print(result.output)


asyncio.run(main())
```

The core package has no Claude, Codex, or Antigravity dependency. Vendor SDKs
are added through optional extras.

## Real Providers

```python
import asyncio

from agent_runtime_kit import AgentTask
from agent_runtime_kit.adapters import ClaudeAgentRuntime


async def main() -> None:
    runtime = ClaudeAgentRuntime(default_model="claude-sonnet-4-6")
    diagnostic = runtime.availability()
    if not diagnostic.available:
        raise RuntimeError(diagnostic.message)
    result = await runtime.run(AgentTask(goal="Summarize this repository"))
    print(result.output)


asyncio.run(main())
```

## Runtime Fields

`AgentTask` supports goal, system prompt, working directory, permission profile,
MCP stdio servers, session/resume handles, output schema, budget, metadata, and
an async event sink. Where a runtime cannot honor a field (for example only
Claude maps `budget_usd`; Codex and Antigravity reject it with a typed
`UnsupportedTaskInputError`) the adapter raises rather than silently dropping it.

`AgentResult` returns output, finish reason, parsed structured output, usage,
cost, session id, artifacts, tool-call audits, and provider metadata.

## Docs

- [Quickstart](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/quickstart.md)
- [Provider diagnostics](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/providers.md)
- [Capability matrix](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/capability-matrix.md)
- [Live smoke tests](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/live-smoke.md)
- [Mestre migration notes](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/mestre-migration.md)
- [Publish checklist](https://github.com/ebarti/agent-runtime-kit/blob/main/docs/publish-checklist.md)
