A2A Integration Kit
The A2A integration kit provides everything needed to carry verifiable interaction evidence through Agent-to-Agent Protocol flows.
What you get
- Receipt attachment to TaskStatus, Message, and Artifact metadata
- Agent Card extension discovery via
https://www.peacprotocol.org/ext/traceability/v1 - Dual-version support for A2A v1.0.0 and v0.3.0 via a transition normalizer
- 3-step discovery: Agent Card, well-known, header probe
Quick start
Terminal
pnpm add @peac/mappings-a2a @peac/protocol @peac/crypto
a2a-attach.ts
import { attachReceiptToTaskStatus } from '@peac/mappings-a2a';
const taskStatus = attachReceiptToTaskStatus(originalStatus, {
receipt_ref: 'sha256:abc123...',
receipt_jws: 'eyJhbGciOiJFZERTQSIs...',
});
Key concepts
Evidence carrier placement: Receipts travel in A2A metadata under the extension URI https://www.peacprotocol.org/ext/traceability/v1.
Transport limits: 64 KB embed limit for A2A metadata.
A2A v1.0.0 compatibility: The transition normalizer handles dual-version Agent Card, TaskState, and Parts. v0.3.0 is deprecated with a process.emitWarning() notice; removal at v0.13.0.