Skip to main content
Version: v0.12.11

Agent Action Records

PEAC records evidence for agent actions across four surfaces: A2A protocol handoffs, CLI command executions, lifecycle observations (approvals, evaluations, experiments), and workflow transitions.

A2A handoff records (v0.14.1+)

npm install @peac/mappings-a2a

The org.peacprotocol/a2a-handoff extension group (10 type URIs) records task delegation events in Agent-to-Agent Protocol v1.0 flows. Compatible with Microsoft AGT and AAIF.

import { buildA2AHandoffRecord } from '@peac/mappings-a2a';

const record = await buildA2AHandoffRecord({
taskId: 'urn:task:abc',
fromAgent: 'urn:agent:orchestrator',
toAgent: 'urn:agent:worker',
}, privateKey, { iss: 'https://api.example.com' });

CLI execution records (v0.14.1+)

Issue signed records for CLI commands and CI pipelines:

# Unsigned observation
peac observe command -- npm test

# Signed interaction record
peac record command --signing-key <key> --issuer <url> -- npm test

Security defaults: argv hashed by default, stdin none by default, raw capture requires explicit double opt-in.

Lifecycle observation records (v0.14.1+)

The org.peacprotocol/lifecycle-observation extension group (9 type URIs) records workflow approvals, evaluations, experiment assignments, and mode transitions:

peac emit lifecycle --kind lifecycle-approval-granted --approver-ref urn:user:alice --subject-ref urn:agent:abc

Agent action records (v0.14.3+)

The org.peacprotocol/agent-action extension group (6 type URIs, Section 32) records agent decision and action evidence.

Runtime governance records (v0.12.10+)

The org.peacprotocol/runtime-governance extension group records policy evaluation, safety check, compliance gate, and mode transition outcomes. See the runtime governance profile.