Metadata-Version: 2.4
Name: agentic-protocol
Version: 0.1.1
Summary: Typed cross-repo contracts for the agentic system: handoff state, MCP I/O, hook events, skill manifests, bootstrap install manifest.
License: MIT
Project-URL: Homepage, https://github.com/darce/agentic-protocol-monorepo
Project-URL: Source, https://github.com/darce/agentic-protocol-monorepo/tree/main/packages/agentic-protocol
Project-URL: Changelog, https://github.com/darce/agentic-protocol-monorepo/blob/main/packages/agentic-protocol/CHANGELOG.md
Project-URL: Issues, https://github.com/darce/agentic-protocol-monorepo/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.6
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"

# 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 | project`) |
| ⏳ | `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.
