centurian-sdk 0.1.0b2

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).

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:

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

Use

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.