@aae/protocol (TypeScript)

TypeScript / JavaScript SDK for the Accountable Agentic Execution (AAE) protocol.

Install

npm install @aae/protocol
# or
pnpm add @aae/protocol

What this provides

• Zod schemas for every AAE protocol type (parse-and-validate at runtime, infer TS types at compile time)
• Hash chain helpers (RFC 8785 canonicalization via json-canonicalize, SHA-256 chain construction, verification)
• Capability token mint/verify (JWT via jose)
• Reference adapters for policy, audit sink, and approval delivery (TODO)

Quick example

import { ProposalSchema, type Proposal, BlastRadius } from "@aae/protocol";
import { verifyChain } from "@aae/protocol/hashchain";
import { ulid } from "ulid";

const proposal: Proposal = ProposalSchema.parse({
  aae_version: "0.1",
  proposal_id: ulid(),
  agent_id: "ops-agent-v3",
  tenant_id: "default",
  intent: "restart_test_service",
  context: { rationale: "QA asked" },
  steps: [
    {
      tool: "ssh_exec",
      args: { host: "test-01", command: "systemctl restart test" },
      blast_radius: BlastRadius.SINGLE_SERVICE,
    },
  ],
  submitted_at: new Date().toISOString(),
});

Status

v0.1 — early development. APIs may shift before v1.0.

License

MIT OR Apache-2.0