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 bind/read/reset accessors of the ambient run context
variables, the storage path guard, and Agent's default
astream/terminal-drain with its park conversion SuspendedFinal.to_suspended_interaction;
everything else is a pydantic model, Protocol, ABC, or
enum. Logic over this vocabulary that plugins, engines and the server share
lives in tai42-kit: park adoption and the chained-call notices
(tai42_kit.interactions.park_adoption), the park marker builder and reader
(park_marker), the whole-chain kill handlers (park_kill), the failed-outcome
text (outcome_text), and the inbound-media turn shaping and entry-params policy
(tai42_kit.conversations.inbound_media, tai42_kit.conversations.entry_params). Vendor types (fastmcp, 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.
Four packages; each depends only on the ones to its left:
tai42-kit <--.
/ (helpers) \
tai42-contract <-+ +-- tai42-skeleton
(interfaces) \ / (the server)
tai42-cli <--'
(the remote client)
tai42-contract is the leaf: it depends on no other tai-* package, so anything —
the skeleton, the CLI, a plugin, a helper — can import it without pulling in an
implementation.
Install
Requires Python 3.13+. Install from PyPI into the environment that runs the
server. Usually pulled in transitively via tai42-kit / tai42-skeleton, but it
installs directly too:
uv add tai42-contract
Or from source — clone this repo and add it as an editable dependency:
git clone https://github.com/tai42ai/tai42 # next to your app checkout
cd /path/to/your/app
uv add --editable ../tai42/core/contract
Development
uv venv --python 3.13
uv pip install --no-sources --editable ".[dev]" # pydantic + tooling + vendor libs (for pyright)
uv run --no-sync ruff check .
uv run --no-sync ruff format --check .
uv run --no-sync pyright
uv run --no-sync pytest --cov --cov-report=term-missing # self-contained contract tests
Documentation
The whole platform — concepts, guides, and the generated reference — lives in the unified documentation site:
- Layering & the contract/kit/cli/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.
1 maintainer
Metadata
1 maintainer
Release files for tai42-contract 19.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tai42_contract-19.0.0.tar.gz | 328.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tai42_contract-19.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 731.3 kB
Release files / tai42_contract-19.0.0.tar.gz
| Download URL | tai42_contract-19.0.0.tar.gz |
|---|---|
| Size | 328.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b91532e3830e7a782410e416fb1ccde55f3b8d8039f8a23d42392ea47f3468e4
|
|
BLAKE2b-256 checksum How to use checksums |
f5be8f9e605bbddbb9dd9db948c164bb4e32164bc0d7232be22c5fca03943c45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tai42_contract-19.0.0-py3-none-any.whl
| Download URL | tai42_contract-19.0.0-py3-none-any.whl |
|---|---|
| Size | 402.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
90462190c2b9a4b8148e1d91084294504397b74a598e34fe06eb53b4e98f31db
|
|
BLAKE2b-256 checksum How to use checksums |
56174d61460c7a3d36862e11d514ec40d9e1b6bbba5cfa363988de4990bfceec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
