All notable changes to the XAP protocol will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
verity-receipt.json: Five new optional fields closing institutional-grade audit gaps:timestamp_authority: RFC 3161 TSA token for independent temporal proofrules_applied.policy_content_hash: SHA-256 of governing policy documentrules_applied.policy_url: Where to retrieve and verify the policykey_id: Identifies the specific signing key for historical lookupcausality: Links receipt to its position in a multi-agent workflow chaincondition_results[].verifier_attestation: Cryptographic attestation from external probabilistic verifiers
policy-version.json: New schema for content-addressed XAP policy documentsagent-key-history.json: New schema for agent Ed25519 key rotation history- Three new example files
All new fields are optional. No existing receipt validation breaks. Systems that do not implement the new fields produce v0.2-compatible receipts. Systems that implement all fields produce v0.3-compatible receipts. v0.2 and v0.3 receipts are accepted by any XAP-compliant verifier.
- AgentManifest — sixth primitive (primitive 0). Pre-negotiation trust credential with Ed25519 signature, Verity-backed capability attestations, and economic terms. The first cryptographic proof-of-performance in agent discovery.
- RegistryQuery — complete query interface for agent discovery with composite scoring, cursor-based pagination, and AND-combined filters.
- RegistryQuery response — ranked agent summaries with relevance scoring and pagination metadata.
- Federation hints —
also_registered_atandidentity_portable_prooffields in AgentManifest seed v1.1 cross-registry discovery. - 14 new validation tests for AgentManifest (2 valid examples, 12 invalid edge cases).
- Production and simple manifest examples.
- Renamed protocol from ACP to XAP (eXchange Agent Protocol) to differentiate from Stripe/OpenAI Agentic Commerce Protocol
- Renamed schema directory from
/acp/schemas/to/xap/schemas/ - All monetary amounts now use integer minor units (no floating point)
- Split shares now use basis points (integer, 1-10000)
- Primitive count: 5 → 6 (AgentManifest added as primitive 0)
- Organizational identity hierarchy (org_id, team_id) in AgentIdentity
- Chargeback policy field in SettlementIntent
- Identity portability mechanism (export/import)
- Verity outcome states: SUCCESS, FAIL, UNKNOWN, DISPUTED, REVERSED
- CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md
- Edge case registry with continuous learning system
- Schema hardening across all six primitives
- Field-by-field documentation for every schema
- Error codes for every validation failure
- Initial draft of five XAP primitive schemas
- AgentIdentity
- NegotiationContract
- SettlementIntent
- ExecutionReceipt
- VerityReceipt (partial)
- README with protocol overview
- MIT License