chp-core

Capability Host Protocol

CHP is the open protocol for declaring, governing, and proving what agents, tools, and systems do — the single signed plane where a human approval, an agent's action, and a system call become the same governed, tamper-evident, replayable event.

The hook is simple:

See what your agents and tools actually did — and what governed it.

CHP is not another agent framework, tool protocol, or workflow engine. It is the governed evidence plane at the capability boundary: what ran and what governed it (policy, risk tier, safety checks, human approval, autonomy budgets, denial) emit onto one signed, correlated record. Observability tools split execution across separate, optional, unsigned signals and carry no governance; CHP unifies both and proves them.

What CHP Defines

• Capability descriptors
• Host descriptors
• Invocation envelopes
• Correlation context
• Structured execution evidence
• Outcome, error, and denial semantics
• Replay queries and results
• Replay by correlation ID
• Minimal conformance requirements

Quickstart

Install the Python reference host from this checkout:

python -m pip install -e packages/python

Run the agent/tool observability demo:

python examples/agent-operations-demo/demo.py

Run a served capability host endpoint demo:

chp demo endpoint

Run conformance:

python conformance/runner.py

Record development work as CHP evidence:

chp work run \
  --intent "Verify CHP tests." \
  --correlation-id chp-dev-001 \
  --test-run unit \
  -- python -m unittest discover -s packages/python/tests
chp work summary chp-dev-001

Validate the served-host demo as evidence:

chp work validate-demo endpoint --correlation-id chp-demo-validation
chp work replay chp-demo-validation

Check v0.1 protocol alignment:

chp work check-alignment --correlation-id chp-alignment

Check launch messaging:

chp work check-messaging --correlation-id chp-messaging

Minimal Capability

from chp_core import LocalCapabilityHost, capability

host = LocalCapabilityHost("example-host")

@capability(
    id="math.add",
    version="1.0.0",
    description="Add two numbers.",
)
def add(a: int, b: int):
    return {"sum": a + b}

host.register(add)

result = host.invoke(
    "math.add",
    {"a": 2, "b": 3},
    correlation_id="demo-correlation",
)

events = host.replay("demo-correlation")

The host emits execution_started and execution_completed evidence for the invocation. If execution fails, it emits execution_failed. If the host denies invocation, it emits execution_denied.

Repository Map

• spec/README.md: the specification index — core (v0.1), governance

vocabulary, invocation pipeline, HTTP binding, evidence integrity + anchors (v0.2), reserved names, test vectors, changelog, proposal process

• schemas/: JSON Schemas for protocol objects
• packages/python/chp_core/: reference host (Python)
• packages/chp-sdk/ + packages/chp-host-ts/: the second implementation (TypeScript)
• examples/capability-host-endpoint-demo/: HTTP-served host demo
• examples/agent-operations-demo/: agent/tool observability demo
• examples/codex-self-observation-demo/: Codex dogfooding demo
• examples/mcp-bridge-demo/: experimental MCP-style bridge prototype
• conformance/: conformance runner
• docs/comparisons/chp-vs-mcp.md: precise MCP comparison
• docs/comparisons/chp-and-opentelemetry.md: OpenTelemetry alignment note
• docs/comparisons/landscape.md: adjacent framework comparison
• docs/design/codex-self-observation.md: Codex dogfooding pattern
• docs/design/public-v0.1-internal-legacy-boundary.md: public/internal boundary
• docs/design/evidence-integrity-v0.2.md: future evidence integrity proposal
• docs/security/threat-model-v0.1.md: v0.1 threat model
• docs/release-checklist-v0.1.md: release-readiness checklist
• docs/packaging-v0.1.md: packaging and versioning plan

Production Posture

The reference implementation is hardened for production operation: WAL multi-writer safety with hot backup (chp store backup --verify), SIGTERM drain (in-flight work completes before exit), a fail-loud auth flag (CHP_HOST_REQUIRE_AUTH=1), non-root container images with health checks, scheduled retention, and operator metrics (store size, witness-loop liveness, revocation counts, internal errors). Operations, backup/restore, rolling upgrades, and the key-compromise runbook: docs/production-runbook.md. Vulnerability reporting: SECURITY.md.

CHP vs MCP

MCP exposes tools and context to AI applications. CHP governs and evidences execution of capabilities.

They fit together. MCP can be a source of capability invocation, and CHP can add correlation, replay, evidence, denial semantics, and future governance at the execution boundary.

Read more: docs/comparisons/chp-vs-mcp.md.

Open Source Boundary

Open source should include local visibility:

• spec and schemas
• local host
• SDK primitives
• conformance
• local replay
• agent observability wrapper
• experimental MCP bridge prototype

Commercial value can remain around production trust:

• hosted capability graph
• multi-host trace stitching
• retention
• team workspaces
• advanced explanation
• invariant libraries
• assurance derivation
• compliance exports
• enterprise identity and RBAC

Guiding rule:

Local visibility should be free. Production trust should be paid.

License

CHP is dual-licensed by asset:

• Code (packages/, conformance/, examples/, scripts/): Apache License 2.0 — see LICENSE.
• Specification, schemas & docs (spec/, schemas/, docs/): Creative Commons Attribution 4.0 (CC BY 4.0) — see LICENSE-DOCS. Implementing the specification is additionally covered by a royalty-free patent grant — see PATENTS.
• Trademarks: "CHP" and "CHP-Certified" — see TRADEMARK.md.

Contributions are accepted under the Contributor License Agreement; see CONTRIBUTING.md.

Copyright © 2026 Project Auxo, Inc. See NOTICE.