Metadata-Version: 2.4
Name: centurian-sdk
Version: 0.1.0b2
Summary: Centurian Python SDK — thin MCP wrapper for AI agents. Auto-registers, instruments tool calls, attributes cost. Implements ADR-017 SDK perf primitives: local rule cache + per-action OPA decision cache + durable sqlite-backed event queue + async batched MCP calls. Owner: Connect agent (T12 W3-W5).
Author-email: Centurian <engineering@centurian.ai>
License: Proprietary
Project-URL: Homepage, https://centurian.ai
Project-URL: Documentation, https://centurian.ai/docs/quickstart
Project-URL: Repository, https://github.com/omniviewai/Centurian
Keywords: centurian,mcp,agent,observability,compliance
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: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: http
Requires-Dist: httpx>=0.27.0; extra == "http"

# centurian-sdk (Python)

Thin MCP wrapper for AI agents. See `docs/prd/v4.1/Centurian_Solo_Developer_Experience.md`.

## Install (local, side-by-side with the monorepo)

`pnpm` does not manage Python packages. Install directly:

```bash
pip install -e ./packages/sdk-python
# or, from a template directory:
pip install -e ../../packages/sdk-python
```

## Use

```python
from centurian import Agent

agent = Agent(name="my-agent", purpose="Answer questions about my docs")

@agent.tool
def search_docs(query: str) -> str:
    return run_my_search(query)

agent.run()
```

Reads `CENTURIAN_TOKEN`, `CENTURIAN_MCP_URL`, `CENTURIAN_ORG_ID`,
`CENTURIAN_OWNER_USER_ID`, `CENTURIAN_QUEUE_PATH` from env.

Day-1 status: real MCP calls are stubbed; the public API surface is locked so
templates and customer code written today survive the T2 transport swap.
