Skip to content

docs: evidence carrier contract spec, registry, and AGENTS.md#415

Merged
jithinraj merged 3 commits intofeat/evidence-carrier-typesfrom
feat/evidence-carrier-spec
Feb 23, 2026
Merged

docs: evidence carrier contract spec, registry, and AGENTS.md#415
jithinraj merged 3 commits intofeat/evidence-carrier-typesfrom
feat/evidence-carrier-spec

Conversation

@jithinraj
Copy link
Member

Summary

  • Adds normative EVIDENCE-CARRIER-CONTRACT.md spec covering the universal evidence carry interface (DD-124, DD-127, DD-129, DD-131)
  • Updates registries.json (version 0.9.19 -> 0.10.0): adds a2a (Linux Foundation), ucp, and stripe entries
  • Updates AGENTS.md for A2A v0.3.0: capabilities.extensions[] array format, carrier metadata layout, updated discovery paths

Key Changes

Evidence Carrier Contract Spec

Normative specification covering:

  • PeacEvidenceCarrier field definitions (MUST/SHOULD/MAY per field)
  • CarrierAdapter<TInput, TOutput> interface with extract/attach/validateConstraints
  • Transport size limits per DD-127 (MCP 64KB, A2A 64KB, HTTP 8KB headers)
  • computeReceiptRef() algorithm (SHA-256 of UTF-8 JWS bytes via WebCrypto)
  • verifyReceiptRefConsistency() tamper detection (DD-129)
  • Protocol-specific placement: MCP _meta, A2A metadata[URI], ACP/UCP/x402/HTTP
  • Security: ASI-04 extraction defense (DD-131), canonical PEAC-Receipt header spelling

Registry Updates

  • Version bump: 0.9.19 -> 0.10.0 (monotonically increasing)
  • New agent_protocols: a2a (Agent-to-Agent Protocol, Linux Foundation), ucp (Universal Commerce Protocol)
  • New payment_rails: stripe (Stripe payment processing)

AGENTS.md

  • A2A Agent Card: updated from legacy extensions object to v0.3.0 capabilities.extensions[] array
  • MCP: updated from legacy org.peacprotocol/receipt to carrier format (receipt_ref + receipt_jws)
  • Discovery: added peac-issuer.json, updated agent.json to agent-card.json

Test plan

  • pnpm build passes (77/77, cached)
  • pnpm lint passes
  • pnpm format:check passes
  • guard.sh passes
  • check-planning-leak.sh passes
  • Registry JSON validates (valid JSON, version monotonically increasing)
  • Spec follows existing docs/specs/ conventions (RFC 2119, status header, sections)

Stacked on: PR #414 (feat/evidence-carrier-types)

…-124)

Add normative EVIDENCE-CARRIER-CONTRACT.md spec covering PeacEvidenceCarrier
type definitions, CarrierAdapter interface, transport size limits (DD-127),
receipt_ref integrity (DD-129), and ASI-04 extraction defense (DD-131).

- spec: EVIDENCE-CARRIER-CONTRACT.md with RFC 2119 keywords
- registry: bump version 0.9.19 -> 0.10.0; add a2a, ucp, stripe entries
- AGENTS.md: update A2A Agent Card to v0.3.0 capabilities.extensions[] array
- AGENTS.md: update MCP _meta to carrier format (receipt_ref + receipt_jws)
- AGENTS.md: add peac-issuer.json and agent-card.json to discovery table
Transport table: remove stale body-embed rows for ACP and x402.
Both use PEAC-Receipt header (compact JWS, 8 KB limit) in v0.11.1.
Sections 7.3 and 7.5 rewritten to match shipped adapter behavior.
@jithinraj jithinraj changed the title docs: evidence carrier contract spec, registry, and AGENTS.md (DD-124) docs: evidence carrier contract spec, registry, and AGENTS.md Feb 23, 2026
@jithinraj jithinraj merged commit 6e2aca7 into feat/evidence-carrier-types Feb 23, 2026
1 check passed
@jithinraj jithinraj deleted the feat/evidence-carrier-spec branch February 24, 2026 21:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant