Reference · glossary

The vocabulary of the capability boundary.

CHP names a small set of primitives precisely, so that what an agent or system did can be declared, governed, and proven the same way every time. These are the terms, defined.

Capability

A named, invokable unit of useful work.

The atomic thing a system can do — schedule_technician, transfer_funds, approve_discount, read_file. In CHP a capability is declared with a stable id, a version, an input schema, and the policy it requires, before anyone calls it. Capabilities are what the protocol governs and proves.

Browse the capabilities catalog

Capability boundary

The line an action crosses to go from intent into effect.

The moment an invocation stops being a decision and becomes a real effect on the world. It is the same line regardless of who initiated it — a person, an agent, or a product — which is why it is the right place to declare, govern, and prove what happens. Governance lives at the boundary, not in the model.

Read: the capability boundary

Capability host

Anything that exposes and runs capabilities under the protocol.

A host can be a person approving something, a business process, a device, an application, or another vendor’s agent framework. The host declares its capabilities, enforces policy at the boundary, and emits evidence. CHP is host-agnostic by design — that breadth is why it is a protocol rather than a feature.

How hosts work

Invocation

A single attempt to call a capability.

Carried in an InvocationEnvelope with the capability id, the inputs, the subject making the call, and a correlation that ties it to everything else in the session. Every invocation produces an outcome — success, denial, or unavailable — and an evidence event, every time.

Evidence

A structured, tamper-evident record of what happened at the boundary.

Each invocation emits an ExecutionEvidence event: a stable action id, the host, the correlation, an explicit outcome, and a hash linking it to the prior event. Evidence is designed to outlive the system that produced it — portable and verifiable on its own terms, which is what makes it trustworthy to a skeptic.

Read: logs aren’t evidence

Hash chain

SHA256 links that make any alteration detectable.

Each evidence event includes a hash of the previous one, so the records form a chain. Alter or remove any record and the chain breaks visibly. This is, almost literally, chain of custody — the property defensibility and audit actually require, and the reason CHP’s evidence is more than a log.

Correlation

The id that ties every action in one process together.

A shared correlation runs through every invocation in a session, matter, or workflow — even across multiple hosts. It is what lets a distributed process reconstruct as a single ordered trace instead of being inferred from scattered logs.

Denial

A refused action, recorded as a first-class outcome.

When a policy or entitlement check fails at the boundary, CHP denies the action and records why — an explicit reason code, the deciding subject, and an evidence id — rather than swallowing it as an exception. “Why was this denied?” becomes a query, not a reconstruction.

Governing actions

Replay

Reconstructing a process from its evidence, in order.

Because every action shares a correlation and is recorded as the same kind of event, the whole sequence — what an agent touched, what a person decided, in what order — can be replayed from the evidence store. Replay is how “show me what happened” is answered.

Conformance

A versioned check that an implementation behaves as the spec requires.

CHP ships a conformance suite so independent hosts can demonstrate they declare, govern, and prove capabilities correctly. Conformance is what makes the protocol trustworthy across vendors — a record means the same thing no matter who produced it.

Conformance

Capability descriptor

The schema that defines a capability declaration.

The CapabilityDescriptor carries a capability’s id, version, description, input schema, and governance metadata — who may invoke it, under what policy, and whether it emits evidence. It is the unit behind both the catalog and capabilities.txt.

capabilities.txt

Adapter

A package that exposes a provider’s actions as CHP capabilities.

Adapters turn external systems — SaaS APIs, databases, devices — into declared, governed capabilities, so an action through them is recorded the same way as any other. The open adapter ecosystem is what the capabilities catalog draws from.

Browse adapters

capabilities.txt

A public, well-known file advertising what a host can do.

A discovery sibling to robots.txt and llms.txt: a crawlable, static declaration of the capabilities a host exposes, pointing to an MCP, HTTP, or CHP endpoint for the actual call. Discovery and invocation are different jobs — capabilities.txt does discovery.

The proposal

Want the full specification?

These terms are defined normatively in the protocol spec, with schemas and a conformance suite.

Read the docs