The Spec
A structured format for recording agent decisions
A structured format that gives every agent framework a consistent way to record what agents are authorized to do, what they did, and what happened.
The Lifecycle
Every agent activity follows the same recorded lifecycle.
Define what the agent is authorized to do. Scope, constraints, and success criteria — structured and machine-readable.
Agent passes subtasks to other agents. The chain is recorded. Constraints inherit automatically. Every handoff is tracked.
The agent acts and records structured evidence of what it did. Activity records accumulate. Each is append-only.
Was the outcome within the authorized scope? The record is finalized. The full chain of custody is preserved.
SDK
The SDK handles authorization recording, delegation tracking, activity records, and outcome evaluation.
// Record authorization, delegate, execute, evaluate
const authorization = await ledger.authorize({
agent: marketingAgent.id,
delegate: contentAgent.id,
scope: "content-rewrite",
constraints: { budget: 500, audience: "enterprise" }
});
await ledger.delegate(authorization.id, analyticsAgent);
await ledger.recordActivity(authorization.id, evidence);
await ledger.evaluate(authorization.id, "completed");
// Full decision chain — recorded, auditable, tamper-evidentSpec Scope
Structured authorization criteria, bilateral acceptance, and a state machine that tracks every activity from authorization through evaluation. Standard record types for any operational context.
Parent-child linkage with inherited constraints. Accountability flows up the chain even as work flows down. The SDK validates child ≤ parent before submitting.
Core Primitive
The system's primitive is the structured activity record — what was authorized, what happened, and whether the outcome was within scope. Activity records are append-only, accumulate against an authorization's success criteria, and form the basis for every audit trail, compliance report, and incident reconstruction.
Agents decide. Activity accumulates. Records endure.
Protocol Complement
Agent protocols handle how agents communicate and access tools. The Agentic Contract Spec handles what agents committed to — the authorization, the delegation chain, and the outcome. Protocol-agnostic by design.
Permanent record, chain reconstruction, reliability insights, and incident resolution.