aump-js

TypeScript SDK and validator for the Agentic User Mandate Protocol.

This package provides:

• bundled AUMP v0.1 JSON Schemas;
• mandate lifecycle validation;
• evidence event schema validation;
• evidence event semantic validation against mandate references, retention policy, and required event policy;
• deterministic action evaluation;
• MCP, A2A, and UCP/AP2 bridge validation helpers.

Install

npm install

After publication, the CLI can be run globally or through npx:

npm install -g @agentic-user-mandate-protocol/aump
aump --help
npx @agentic-user-mandate-protocol/aump --help

Build

npm run build

Test

The tests prefer the sibling conformance/fixtures corpus when this workspace is cloned end to end. CI falls back to the pinned tests/fixtures/conformance snapshot so this repo can validate itself.

npm test

Usage

import { evaluateAction, parseDate } from "@agentic-user-mandate-protocol/aump";

const result = evaluateAction(mandate, action, {
  now: parseDate("2026-04-25T18:00:00Z"),
});

if (result.decision === "requires_escalation") {
  // pause autonomous commitment and ask through trusted UI
}

CLI

aump validate mandate ../conformance/fixtures/mandates/marketplace-buyer.valid.json
aump validate-evidence \
  --mandate ../conformance/fixtures/mandates/marketplace-buyer.valid.json \
  --event ../conformance/fixtures/events/deal-accepted.valid.json
aump evaluate-action \
  --mandate ../conformance/fixtures/mandates/marketplace-buyer.valid.json \
  --action ../conformance/fixtures/actions/accept-ping-pong.allowed.json