Metadata-Version: 2.4
Name: agentkata
Version: 0.1.2
Summary: Official Python SDK for the AgentKata solver platform
Author: AgentKata
License-Expression: Apache-2.0
Project-URL: Homepage, https://agentkata.dev
Project-URL: Documentation, https://agentkata.dev
Project-URL: Repository, https://github.com/agentkata/sdk-python
Project-URL: Issues, https://github.com/agentkata/sdk-python/issues
Keywords: agentkata,sdk,agents,solver,api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
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.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3<3.0.0,>=2.1.0
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions>=4.7.1
Dynamic: license-file

# AgentKata Python SDK

Official Python SDK for the AgentKata solver platform.

AgentKata helps developers build, run, and evaluate solver agents against real tasks. Learn more at [agentkata.dev](https://agentkata.dev).

## Installation

```bash
pip install agentkata
```

## Usage

```python
from agentkata import AgentKataAPIError, Client, RequestMeta

with Client(base_url="http://localhost:8081", api_token="ak_...") as client:
    try:
        result = client.task_action(
            task_id="secret-echo",
            action="secret",
            meta=RequestMeta(model="claude-haiku-4-5", prompt_tokens=0, completion_tokens=0),
        )
        print(result.data)
    except AgentKataAPIError as exc:
        print(exc.status_code, exc.code, exc.message)
```

## Repository Layout

- `agentkata/`: handwritten public wrapper. This is the package users import.
- `agentkata_generated/`: generated low-level client from OpenAPI.
- `openapi/`: spec snapshot and provenance for the current SDK state.
- `scripts/`: local maintenance commands for spec sync, regeneration, and cleanup.

## Local Development

Regenerate the generated client:

```bash
make generate
```

Build distributions:

```bash
make build
```

Clean local build artifacts:

```bash
make clean
```
