Typed cross-repo contracts for the agentic system: handoff state, MCP I/O, hook events, skill manifests, bootstrap install manifest.
Project description
agentic-protocol
Single source of truth for cross-repo contracts in the agentic system. Pydantic v2 is canonical; JSON Schema artifacts under schemas/ are generated from the models so non-Python consumers (hook scripts, future TS/JS tooling) can validate without importing Python.
Schemas (rolled out incrementally per founding plan 0001)
| Status | Module | Schema |
|---|---|---|
| ✅ v0.1.0 | agentic_protocol.handoff |
HandoffState, ActiveTask, TaskRef, TargetWorktree, TaskPlanRef |
| ⏳ | agentic_protocol.mcp |
MCP tool I/O envelopes |
| ⏳ | agentic_protocol.hooks |
SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop |
| ⏳ | agentic_protocol.skills |
SkillManifest (with `scope: harness |
| ⏳ | agentic_protocol.bootstrap |
Bootstrap install manifest |
Generated artifacts
schemas/*.json is regenerated by scripts/generate_schemas.py and committed. Consumers that don't want to import Python can read the JSON Schema directly.
Versioning
Hard-pin major version per consumer. Bootstrap resolves a compatible quartet of (handoff, orchestrator, bootstrap, system) against a single agentic-protocol major.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentic_protocol-0.1.1.tar.gz.
File metadata
- Download URL: agentic_protocol-0.1.1.tar.gz
- Upload date:
- Size: 11.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30dff4c565b40d895b331f7db3237708fca848ee6518ee458da3063304592347
|
|
| MD5 |
68eb2e92511691ec0c2d9f66c5b26cc2
|
|
| BLAKE2b-256 |
1a40f09e6302f77f9908a8c5cddb2ba10622abadaff5e3e5bf4fd24b21e80165
|
File details
Details for the file agentic_protocol-0.1.1-py3-none-any.whl.
File metadata
- Download URL: agentic_protocol-0.1.1-py3-none-any.whl
- Upload date:
- Size: 10.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7d46689dad85dd7ab31ad1d1d5c1c923914381c86276fe9b878391a1cb82c837
|
|
| MD5 |
fc61c29e32dce53aa9ebaab7f2dcec47
|
|
| BLAKE2b-256 |
8e6118529f3ad22d665b8880baa6edd10f124213066918c2a180497a0c3e4abe
|
