tai42-contract 0.1.0

Pure interface contracts (protocols, ABCs, models) for the TAI ecosystem. No logic; pydantic-only at runtime.

tai42-contract

Pure interface contracts for the TAI ecosystem: the protocols, ABCs, pydantic models, and enums every other package builds against. At runtime this package imports nothing but pydantic, and its behaviour is limited to a narrow whitelisted surface — the tai42_app forwarding handle, model-level validators/normalizers, the storage path guard, and Agent's default astream/terminal-drain; everything else is a pydantic model, Protocol, ABC, or enum. Vendor types (fastmcp, langchain, starlette, mcp) appear only inside TYPE_CHECKING blocks, so they are never loaded when the code runs.

Position in the ecosystem

TAI is an open-source runtime for MCP tools, agents, and workflows — the server that hosts a capability and supplies the operational layer around it (manifest loading, access control, OAuth connectors, background execution, monitoring, storage, and human-in-the-loop steps). Everything plugs in against the interfaces this package defines.

Three packages; each depends only on the ones to its left:

tai42-contract  <--  tai42-kit  <--  tai42-skeleton
(interfaces)      (helpers)     (the server)

tai42-contract is the leaf: it depends on no other tai-* package, so anything — the skeleton, a plugin, a helper — can import it without pulling in an implementation.

Install

Requires Python 3.13+. Nothing is on PyPI yet, so install from source — clone this repo alongside your tai-skeleton checkout and add it as an editable dependency of the environment that runs the server. Usually pulled in transitively via tai42-kit / tai42-skeleton, but it installs directly too:

git clone https://github.com/tai42ai/tai-contract
cd tai-skeleton   # or your own app checkout
uv add --editable ../tai-contract   # once published: uv add tai42-contract

Development

uv sync --extra dev      # pydantic + tooling + vendor libs (for pyright)
uv run ruff check .
uv run pyright
uv run pytest            # self-contained contract tests

Documentation

The whole platform — concepts, guides, and the generated reference — lives in the unified documentation site:

• Layering & the contract/kit/skeleton split: https://tai42.ai/concepts/layering
• Python SDK reference (this package's public API): https://tai42.ai/reference/python-sdk

License

Apache-2.0. See LICENSE and NOTICE.