Part of the Agentic Evidence Suite — six interoperating components for verifiable agentic AI. See
REFERENCE-ARCHITECTURE.mdfor the suite-level architecture.
Standard receipts and trace semantics for verifiable agent execution.
This repo defines:
- Receipt and trace event schemas
- Canonicalization rules for deterministic hashing
- Hash-chaining and signature envelopes
- Redaction semantics that preserve integrity verification
- Test vectors for cross-implementation compatibility
Most agent systems produce logs. Logs are not verification. This specification defines receipts that can be independently validated to confirm:
- What the agent did
- Under which policy constraints
- What artifacts were produced
- Whether the record was tampered with
- Trace: ordered event stream (JSONL) describing agent actions.
- Receipt: cryptographic attestation for an event (hash + prev_hash + signature).
- Bundle: portable directory containing trace + receipts + artifacts + metadata.
- Policy Decision: allow/deny receipt produced by a non-bypassable policy layer.
- Validate schemas:
./tools/validate_schemas.sh - Review examples:
examples/minimal/ - Use vectors to build verifiers:
vectors/v1/
Downstream projects should treat this repo as the canonical source of truth for:
schemas/spec/vectors/
See: spec/threat-model.md
This spec implements the receipts and trace semantics layer of ATVC — the Agentic Trust Validation Certification framework. Specifically:
| ATVC Phase | Coverage |
|---|---|
| Phase 02 — Architecture (steps 26–50) | Receipt schema, canonicalization, hash-chain, signature envelope, redaction model |
| Phase 03 — Engineering (steps 51–75) | Conformance test vectors, threat model, validation tooling |
Conformance vectors in vectors/v1/ are referenceable as ATVC validation artifacts for the Architecture phase-exit contract.
This repo is part of the Agentic Evidence Suite:
- agentic-receipts (standard)
- agentic-trace-cli (tooling)
- agentic-artifacts (outputs)
- agentic-policy-engine (governance)
- agentic-eval-harness (scenarios)
- agentic-evidence-viewer (review UI)
MIT