Agent Action Records
Record evidence for agent actions across four surfaces: A2A protocol handoffs, CLI command executions, lifecycle observations such as approvals and evaluations, and workflow transitions. An auditor or counterparty can verify a record offline without calling the runtime that produced it.
Packages: @peac/mappings-a2a, @peac/cli, @peac/schema
A2A handoff records
The org.peacprotocol/a2a-handoff extension group records task observation and handoff events in Agent-to-Agent Protocol v1.0 flows. It is compatible with Microsoft AGT and AAIF. Map a task observation with fromA2ATaskObservation, then issue and sign it.
import { fromA2ATaskObservation } from '@peac/mappings-a2a';
import { issue } from '@peac/protocol';
const claims = fromA2ATaskObservation(task, {
iss: 'https://api.example.com',
});
const record = await issue(claims, privateKey);CLI execution records
Issue signed records for CLI commands and CI pipelines. Security defaults are conservative: argv is hashed by default, stdin is captured as none by default, and raw capture requires an explicit double opt-in.
# Unsigned observation peac observe command -- npm test # Signed interaction record peac record command --issuer-id https://ci.example.com -- npm test
Lifecycle observation records
The org.peacprotocol/lifecycle-observation extension group 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 event kinds
The org.peacprotocol/agent-action extension group (Section 32) records agent decision and action evidence across six observed event kinds. Validate with validateAgentAction() from @peac/schema before issuing.
| Type URI | Records |
|---|---|
org.peacprotocol/agent-action-invoked-observed | An agent invoked an action |
org.peacprotocol/agent-action-delegated-observed | An action was delegated to another agent |
org.peacprotocol/agent-action-approved-observed | An action was approved |
org.peacprotocol/agent-action-denied-observed | An action was denied |
org.peacprotocol/agent-action-cancelled-observed | An action was cancelled |
org.peacprotocol/agent-action-timed-out-observed | An action timed out |
Semantic Boundary
PEAC records observed agent actions as evidence. It does not orchestrate agents, make or enforce the decisions it records, or run the agent runtime. Inline prompts, messages, and secrets are blocked by the validator. An agent action record proves what the issuer observed, not more.
Links
Portable Agent Evidence
A signed agent action record lets a counterparty verify what happened offline, with only the issuer's public key. The same record format travels across A2A, MCP, and HTTP.