agent-passport-system 1.5.0 → 1.6.0

package/README.md

@@ -2,12 +2,12 @@
 
 [![npm version](https://img.shields.io/npm/v/agent-passport-system)](https://www.npmjs.com/package/agent-passport-system)
 [![license](https://img.shields.io/npm/l/agent-passport-system)](https://github.com/aeoess/agent-passport-system/blob/main/LICENSE)
-[![tests](https://img.shields.io/badge/tests-65%20passing-brightgreen)](https://github.com/aeoess/agent-passport-system)
+[![tests](https://img.shields.io/badge/tests-165%20passing-brightgreen)](https://github.com/aeoess/agent-passport-system)
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18749779.svg)](https://doi.org/10.5281/zenodo.18749779)
 
-Cryptographic identity, ethical governance, economic attribution, protocol-native communication, and intent architecture for autonomous AI agents.
+Cryptographic identity, ethical governance, economic attribution, protocol-native communication, intent architecture, cascade revocation, and coordination primitives for autonomous AI agents.
 
-**5 layers. 65 tests. Zero heavy dependencies. Running code.**
+**7 layers. 165 tests. Zero heavy dependencies. Running code. MCP server included.**
 
 > *As AI agents from different creators, running different models, serving different humans begin to collaborate — who is responsible, under what authority, according to what values, and who benefits?*
 
@@ -166,10 +166,83 @@ const eval = evaluateConsensus(delib)
 // → { converged: true, standardDeviation: 4.2, recommendation: 'converged' }
 ```
 
+### Layer 7 — Coordination Primitives
+
+```typescript
+import {
+  createTaskBrief, assignTask, acceptTask,
+  submitEvidence, reviewEvidence, handoffEvidence,
+  submitDeliverable, completeTask
+} from 'agent-passport-system'
+
+// Operator creates a task brief
+const brief = createTaskBrief({
+  title: 'Competitive Protocol Analysis',
+  roles: { researcher: { count: 1 }, analyst: { count: 1 } },
+  deliverables: [
+    { id: 'd1', description: 'Evidence packet', assignedRole: 'researcher' },
+    { id: 'd2', description: 'Synthesis report', assignedRole: 'analyst' }
+  ],
+  acceptanceCriteria: [
+    { id: 'c1', description: 'Min 3 sources', threshold: 70 }
+  ]
+}, operatorKeys)
+
+// Assign agents to roles
+const assigned = assignTask(brief, 'researcher', agentId, agentPubKey, ['web_search'], operatorKeys)
+
+// Worker accepts
+const accepted = acceptTask(assigned.brief, agentKeys)
+
+// Researcher submits evidence (every claim needs a 10+ word quote)
+const evidence = submitEvidence({
+  taskId: brief.id, role: 'researcher',
+  claims: [
+    { claim: 'Protocol X has 50 stars', source: 'github.com/x', quote: 'Repository shows 50 stars as of Feb 2026', confidence: 'verified' }
+  ],
+  methodology: 'GitHub search + npm registry analysis',
+  gaps: [{ area: 'Performance data', reason: 'No benchmarks published' }]
+}, researcherKeys)
+
+// Operator reviews (cannot approve below threshold)
+const review = reviewEvidence(evidence.id, {
+  verdict: 'approve', score: 85, threshold: 70,
+  notes: 'Solid sourcing, gap acknowledged'
+}, operatorKeys)
+
+// Handoff to analyst (requires approved review)
+const handoff = handoffEvidence(evidence.id, review.id, 'analyst', analystPubKey, operatorKeys)
+
+// Analyst submits deliverable citing evidence
+const deliverable = submitDeliverable({
+  taskId: brief.id, role: 'analyst',
+  content: 'Protocol X shows moderate adoption...',
+  evidencePacketIds: [evidence.id],
+  citationCount: 3, gapsFlagged: 1
+}, analystKeys)
+
+// Operator closes with metrics
+const completion = completeTask(brief.id, {
+  status: 'completed',
+  retrospective: {
+    overheadRatio: 0.9, gapRate: 0.08,
+    reworkCount: 0, errorsCaught: 1
+  }
+}, operatorKeys)
+```
+
 ## Architecture
 
 ```
 ┌─────────────────────────────────────────────────┐
+│  Layer 7: Coordination Primitives               │
+│  Task briefs · Role assignment · Evidence ·      │
+│  Review gates · Handoffs · Deliverables · Metrics│
+├─────────────────────────────────────────────────┤
+│  Layer 6: Cascade Revocation & Policy Engine    │
+│  3-signature chain · Chain tracking · Batch      │
+│  revoke · Validation events · Policy receipts    │
+├─────────────────────────────────────────────────┤
 │  Layer 5: Intent Architecture                   │
 │  Roles · Tradeoff rules · Deliberative          │
 │  consensus · Precedent memory · Signed outcomes  │
@@ -202,6 +275,10 @@ const eval = evaluateConsensus(delib)
 
 **Layer 5 — Intent Architecture.** Context tells agents what they know. Intent tells them what to care about. Four agent roles (operator, collaborator, consultant, observer) with five autonomy levels from fully supervised to fully autonomous. Machine-readable intent documents encode organizational goals with quantified tradeoff rules: "when quality and speed conflict, prefer quality until 2× time cost, then prefer speed." Deliberative consensus protocol where agents score independently, revise after seeing others' reasoning, and converge or escalate to humans. Every resolved deliberation becomes a citable precedent. The `IntentPassportExtension` bridges Layer 1 identity with Layer 5 governance — no role without a passport, no autonomy without accountability.
 
+**Layer 6 — Cascade Revocation & Policy Engine.** Three-signature action chain: agent creates intent, policy validator evaluates against floor principles and delegation scope, agent executes and signs receipt. Parent→child chain registry tracks all delegation relationships. Revoking a parent automatically cascade-revokes all descendants. Batch revocation by agent ID. Chain validation detects broken links, revoked delegations, and continuity breaks. Revocation events emitted for real-time monitoring.
+
+**Layer 7 — Coordination Primitives.** Protocol-native multi-agent task orchestration. Operator creates a signed task brief with roles, deliverables, and acceptance criteria. Agents are assigned to roles and sign acceptance. Researchers submit signed evidence packets with citations (every claim needs a 10+ word quote from source). Operator reviews evidence against a quality threshold — cannot approve below threshold, forcing rework. Approved evidence is handed off between roles (handoff requires approved review). Analysts submit deliverables citing evidence packets. Operator closes the task with metrics: overhead ratio, gap rate, rework count, errors caught. Full lifecycle container (`TaskUnit`) with integrity validation catches mismatched IDs, unapproved handoffs, and missing references.
+
 ## Human Values Floor — v0.1
 
 | ID | Principle | Enforcement |
@@ -216,17 +293,49 @@ const eval = evaluateConsensus(delib)
 
 Full manifest: [`values/floor.yaml`](values/floor.yaml)
 
+## MCP Server
+
+The protocol ships with a coordination-native MCP server — any MCP client (Claude Desktop, Cursor, etc.) can connect agents directly.
+
+```bash
+npm install agent-passport-system-mcp
+```
+
+**14 tools, role-scoped access control.** Operator creates task briefs, assigns agents, reviews evidence, hands off between roles, closes tasks. Workers accept assignments, submit evidence, get handed-off evidence, submit deliverables.
+
+```json
+{
+  "mcpServers": {
+    "agent-passport": {
+      "command": "npx",
+      "args": ["agent-passport-system-mcp"],
+      "env": {
+        "AGENT_KEY": "<public_key>",
+        "AGENT_PRIVATE_KEY": "<private_key>",
+        "AGENT_ID": "my-agent"
+      }
+    }
+  }
+}
+```
+
+Every operation is Ed25519 signed. Role is auto-detected from task assignments. Role-specific prompts served via MCP prompts API. File-backed task persistence at `~/.agent-passport-tasks.json`.
+
+npm: [agent-passport-system-mcp](https://www.npmjs.com/package/agent-passport-system-mcp) · GitHub: [aeoess/agent-passport-mcp](https://github.com/aeoess/agent-passport-mcp)
+
 ## Tests
 
 ```bash
 npm test
-# 65 tests across 6 files, 0 failures
+# 165 tests across 12 files, 40 suites, 0 failures
 ```
 
 Includes 23 adversarial tests: Merkle tree tampering, attribution gaming resistance, compliance violations, floor negotiation attacks, wrong-key attestations.
 
 15 Agora-specific tests: message signing, tamper detection, registry membership, feed operations, threading, full feed verification.
 
+17 coordination tests: task brief creation/verification, role assignment, evidence submission, review gates (score vs threshold), handoff enforcement (requires approved review), deliverable submission, full lifecycle, task unit validation.
+
 ## Paper
 
 **"The Agent Social Contract: Cryptographic Identity, Ethical Governance, and Beneficiary Economics for Autonomous AI Agents"**
@@ -246,21 +355,24 @@ By Tymofii Pidlisnyi — Published on Zenodo
 | Values layer | Attested + auditable | — | Rules | — | — |
 | Attribution | Merkle proofs | — | — | — | — |
 | Communication | Signed Agora | — | — | — | — |
-| Tests | 65 (23 adversarial) | None | Limited | None | None |
+| Coordination | Task units + MCP server | — | — | — | — |
+| Tests | 165 (23 adversarial) | None | Limited | None | None |
 | Dependencies | Node.js crypto + uuid | — | Multi-LLM | — | Consensus network |
 
 ## Structure
 
 ```
-src/                    19 source files
+src/                    21 source files
   contract.ts          — High-level API (6 functions)
   core/
     passport.ts        — Ed25519 identity
-    delegation.ts      — Scoped delegation, receipts, revocation
+    delegation.ts      — Scoped delegation, receipts, cascade revocation
     values.ts          — Floor attestation, compliance, negotiation
     attribution.ts     — Merkle trees, beneficiary tracing
     agora.ts           — Protocol-native signed communication
     intent.ts          — Intent architecture, deliberation, roles
+    policy.ts          — 3-signature chain, policy validation
+    coordination.ts    — Task briefs, evidence, review, handoff, deliverables
   cli/
     index.ts           — CLI (14 commands)
   crypto/
@@ -269,13 +381,21 @@ src/                    19 source files
     passport.ts        — Layers 1–3 types
     agora.ts           — Layer 4 types
     intent.ts          — Layer 5 types
-tests/                  6 test files, 65 tests
+    policy.ts          — Layer 6 types
+    coordination.ts    — Layer 7 types
+tests/                  12 test files, 165 tests (40 suites)
   adversarial.ts       — 23 adversarial cases
   agora.test.ts        — 15 Agora tests
   contract.test.ts     — High-level API tests
   passport.test.ts     — v1.0 primitives
   v1.1-integration.ts  — Delegation chains, receipts, revocation
   v2.0-integration.ts  — Full-stack integration (7 acts)
+  values.test.ts       — Floor loading, attestation, compliance
+  delegation.test.ts   — Delegation, sub-delegation, depth limits
+  attribution.test.ts  — Merkle trees, attribution, collaboration
+  policy.test.ts       — Intent, policy decision, 3-sig chain
+  cascade.test.ts      — Chain registry, cascade revocation, batch
+  coordination.test.ts — Task briefs, evidence, review, handoff, lifecycle
 values/
   floor.yaml           — Human Values Floor manifest
 papers/
@@ -289,6 +409,7 @@ Designed and built by **Tymofii Pidlisnyi** with AI assistance from **Claude** (
 Protocol page: [aeoess.com/protocol.html](https://aeoess.com/protocol.html)
 Agora: [aeoess.com/agora.html](https://aeoess.com/agora.html)
 npm: [npmjs.com/package/agent-passport-system](https://www.npmjs.com/package/agent-passport-system)
+MCP server: [npmjs.com/package/agent-passport-system-mcp](https://www.npmjs.com/package/agent-passport-system-mcp)
 
 ## LLM Documentation
 

package/dist/src/core/commerce.d.ts

@@ -0,0 +1,100 @@
+import type { SignedPassport } from '../types/passport.js';
+import type { ACPCheckoutSession, ACPLineItem, ACPMoney, ACPAddress, CommerceConfig, CommerceDelegation, CommercePreflightResult, CommerceActionReceipt, HumanApprovalRequest } from '../types/commerce.js';
+export declare function commercePreflight(opts: {
+    signedPassport: SignedPassport;
+    delegation: CommerceDelegation;
+    merchantName: string;
+    estimatedTotal: ACPMoney;
+    config?: CommerceConfig;
+}): CommercePreflightResult;
+export declare function createCheckout(opts: {
+    signedPassport: SignedPassport;
+    delegation: CommerceDelegation;
+    config: CommerceConfig;
+    items: {
+        skuId: string;
+        quantity: number;
+    }[];
+    customer?: {
+        name?: string;
+        email?: string;
+    };
+    fulfillmentAddress?: ACPAddress;
+    privateKey: string;
+}): Promise<{
+    session: ACPCheckoutSession;
+    receipt: CommerceActionReceipt;
+}>;
+export declare function updateCheckout(opts: {
+    signedPassport: SignedPassport;
+    delegation: CommerceDelegation;
+    config: CommerceConfig;
+    sessionId: string;
+    updates: {
+        items?: {
+            id: string;
+            quantity: number;
+        }[];
+        fulfillmentAddress?: ACPAddress;
+        fulfillmentOptionId?: string;
+    };
+    privateKey: string;
+}): Promise<{
+    session: ACPCheckoutSession;
+    receipt: CommerceActionReceipt;
+}>;
+export declare function completeCheckout(opts: {
+    signedPassport: SignedPassport;
+    delegation: CommerceDelegation;
+    config: CommerceConfig;
+    sessionId: string;
+    paymentToken: string;
+    paymentMethod?: string;
+    privateKey: string;
+}): Promise<{
+    session: ACPCheckoutSession;
+    receipt: CommerceActionReceipt;
+    spendUpdated: CommerceDelegation;
+}>;
+export declare function cancelCheckout(opts: {
+    signedPassport: SignedPassport;
+    delegation: CommerceDelegation;
+    config: CommerceConfig;
+    sessionId: string;
+    privateKey: string;
+}): Promise<{
+    session: ACPCheckoutSession;
+    receipt: CommerceActionReceipt;
+}>;
+export declare function requestHumanApproval(opts: {
+    agentId: string;
+    delegationId: string;
+    merchantName: string;
+    items: ACPLineItem[];
+    totalAmount: ACPMoney;
+    reason: string;
+    expiresInMinutes?: number;
+}): HumanApprovalRequest;
+export declare function createCommerceDelegation(opts: {
+    agentId: string;
+    delegationId: string;
+    spendLimit: number;
+    currency?: string;
+    approvedMerchants?: string[];
+    requireHumanApproval?: boolean;
+    humanApprovalThreshold?: number;
+    additionalScopes?: string[];
+}): CommerceDelegation;
+export declare function getSpendSummary(delegation: CommerceDelegation): {
+    limit: number;
+    spent: number;
+    remaining: number;
+    currency: string;
+    utilizationPercent: number;
+    nearLimit: boolean;
+};
+export declare function verifyCommerceReceipt(receipt: CommerceActionReceipt, publicKey: string): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=commerce.d.ts.map

package/dist/src/core/commerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../../src/core/commerce.ts"],"names":[],"mappings":"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"}

package/dist/src/core/commerce.js

@@ -0,0 +1,389 @@
+// ══════════════════════════════════════════════════════════════════
+// Layer 7 — Agentic Commerce: Implementation
+// ══════════════════════════════════════════════════════════════════
+// Integration with the Agentic Commerce Protocol (ACP) by OpenAI + Stripe.
+//
+// Every commerce action flows through a 4-gate pipeline:
+//   1. Passport verification — is this agent who it claims to be?
+//   2. Delegation scope check — does this agent have commerce:checkout?
+//   3. Spend limit check — would this purchase exceed the cap?
+//   4. Values Floor check (F-003 Scoped Authority) — is this within policy?
+//
+// Only after all 4 gates pass does the agent interact with the merchant.
+// Every completed action produces a signed CommerceActionReceipt.
+// ══════════════════════════════════════════════════════════════════
+import { randomBytes } from 'node:crypto';
+import { sign, verify as ed25519Verify } from '../crypto/keys.js';
+import { canonicalize } from './canonical.js';
+import { verifyPassport } from '../verification/verify.js';
+// ── Commerce Scopes ──
+const COMMERCE_SCOPES = [
+    'commerce:checkout',
+    'commerce:browse',
+    'commerce:purchase',
+    'commerce:cancel',
+];
+function hasScope(delegation, required) {
+    return delegation.scope.includes(required) || delegation.scope.includes('commerce:*');
+}
+// ── Preflight Check: 4-Gate Pipeline ──
+export function commercePreflight(opts) {
+    const checks = [];
+    const warnings = [];
+    // Gate 1: Passport verification
+    const passportResult = verifyPassport(opts.signedPassport);
+    checks.push({
+        check: 'passport_valid',
+        passed: passportResult.valid,
+        detail: passportResult.valid
+            ? `Passport verified for ${opts.signedPassport.passport.agentId}`
+            : `Passport failed: ${passportResult.errors.join(', ')}`,
+    });
+    // Gate 2: Delegation scope
+    const hasCheckoutScope = hasScope(opts.delegation, 'commerce:checkout');
+    checks.push({
+        check: 'delegation_scope',
+        passed: hasCheckoutScope,
+        detail: hasCheckoutScope
+            ? `Agent has commerce:checkout scope via delegation ${opts.delegation.delegationId}`
+            : `Agent lacks commerce:checkout scope. Has: [${opts.delegation.scope.join(', ')}]`,
+    });
+    // Gate 3: Spend limit
+    const amountInBase = opts.estimatedTotal.amount;
+    const remainingBudget = opts.delegation.spendLimit - opts.delegation.spentAmount;
+    const withinBudget = amountInBase <= remainingBudget;
+    checks.push({
+        check: 'spend_limit',
+        passed: withinBudget,
+        detail: withinBudget
+            ? `Purchase ${amountInBase} within budget (${remainingBudget} remaining of ${opts.delegation.spendLimit})`
+            : `Purchase ${amountInBase} exceeds remaining budget of ${remainingBudget} (limit: ${opts.delegation.spendLimit}, spent: ${opts.delegation.spentAmount})`,
+    });
+    // Gate 3b: Human approval threshold
+    if (opts.delegation.requireHumanApproval && opts.delegation.humanApprovalThreshold) {
+        if (amountInBase > opts.delegation.humanApprovalThreshold) {
+            warnings.push(`Purchase of ${amountInBase} exceeds human approval threshold of ${opts.delegation.humanApprovalThreshold}. Human confirmation required.`);
+        }
+    }
+    // Gate 4: Merchant allowlist (if configured)
+    if (opts.delegation.approvedMerchants && opts.delegation.approvedMerchants.length > 0) {
+        const merchantApproved = opts.delegation.approvedMerchants.includes(opts.merchantName);
+        checks.push({
+            check: 'merchant_approved',
+            passed: merchantApproved,
+            detail: merchantApproved
+                ? `Merchant "${opts.merchantName}" is on approved list`
+                : `Merchant "${opts.merchantName}" is NOT on approved list: [${opts.delegation.approvedMerchants.join(', ')}]`,
+        });
+    }
+    const permitted = checks.every(c => c.passed);
+    return {
+        permitted,
+        checks,
+        delegation: opts.delegation,
+        warnings,
+        blockedReason: permitted ? undefined : checks.find(c => !c.passed)?.detail,
+    };
+}
+// ── ACP Client: Create Checkout Session ──
+export async function createCheckout(opts) {
+    // Run preflight — estimate total as 0 for creation (real total comes from merchant)
+    const preflight = commercePreflight({
+        signedPassport: opts.signedPassport,
+        delegation: opts.delegation,
+        merchantName: opts.config.merchantName,
+        estimatedTotal: { amount: 0, currency: opts.delegation.currency },
+    });
+    if (!preflight.permitted) {
+        throw new Error(`Commerce preflight DENIED: ${preflight.blockedReason}`);
+    }
+    // Build ACP CreateCheckoutRequest
+    const requestBody = {
+        items: opts.items.map(i => ({ sku_id: i.skuId, quantity: i.quantity })),
+        ...(opts.customer && { customer: opts.customer }),
+        ...(opts.fulfillmentAddress && { fulfillment_address: opts.fulfillmentAddress }),
+    };
+    // Call merchant endpoint
+    const url = `${opts.config.merchantBaseUrl}/checkout_sessions`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(opts.config.bearerToken && { 'Authorization': `Bearer ${opts.config.bearerToken}` }),
+        },
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        throw new Error(`ACP CreateCheckout failed: ${response.status} ${response.statusText}`);
+    }
+    const session = await response.json();
+    // Generate signed receipt
+    const receipt = signCommerceReceipt({
+        agentId: opts.signedPassport.passport.agentId,
+        delegationId: opts.delegation.delegationId,
+        actionType: 'commerce:create_checkout',
+        target: url,
+        method: 'POST',
+        session,
+        merchantName: opts.config.merchantName,
+        delegationChain: extractDelegationChain(opts.signedPassport),
+        beneficiary: opts.signedPassport.passport.metadata?.beneficiaryPrincipalId || 'unknown',
+        privateKey: opts.privateKey,
+    });
+    return { session, receipt };
+}
+// ── ACP Client: Update Checkout Session ──
+export async function updateCheckout(opts) {
+    const url = `${opts.config.merchantBaseUrl}/checkout_sessions/${opts.sessionId}`;
+    const response = await fetch(url, {
+        method: 'PUT',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(opts.config.bearerToken && { 'Authorization': `Bearer ${opts.config.bearerToken}` }),
+        },
+        body: JSON.stringify({
+            ...(opts.updates.items && { items: opts.updates.items }),
+            ...(opts.updates.fulfillmentAddress && { fulfillment_address: opts.updates.fulfillmentAddress }),
+            ...(opts.updates.fulfillmentOptionId && { fulfillment_option_id: opts.updates.fulfillmentOptionId }),
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`ACP UpdateCheckout failed: ${response.status} ${response.statusText}`);
+    }
+    const session = await response.json();
+    const receipt = signCommerceReceipt({
+        agentId: opts.signedPassport.passport.agentId,
+        delegationId: opts.delegation.delegationId,
+        actionType: 'commerce:update_checkout',
+        target: url,
+        method: 'PUT',
+        session,
+        merchantName: opts.config.merchantName,
+        delegationChain: extractDelegationChain(opts.signedPassport),
+        beneficiary: opts.signedPassport.passport.metadata?.beneficiaryPrincipalId || 'unknown',
+        privateKey: opts.privateKey,
+    });
+    return { session, receipt };
+}
+// ── ACP Client: Complete Checkout (Payment) ──
+export async function completeCheckout(opts) {
+    // Re-run preflight with actual total — fetch current session first
+    const getUrl = `${opts.config.merchantBaseUrl}/checkout_sessions/${opts.sessionId}`;
+    const getResponse = await fetch(getUrl, {
+        headers: opts.config.bearerToken ? { 'Authorization': `Bearer ${opts.config.bearerToken}` } : {},
+    });
+    if (!getResponse.ok) {
+        throw new Error(`ACP GetCheckout failed: ${getResponse.status}`);
+    }
+    const currentSession = await getResponse.json();
+    const total = currentSession.totals.total;
+    // Final preflight with real amount
+    const preflight = commercePreflight({
+        signedPassport: opts.signedPassport,
+        delegation: opts.delegation,
+        merchantName: opts.config.merchantName,
+        estimatedTotal: total,
+    });
+    if (!preflight.permitted) {
+        throw new Error(`Commerce preflight DENIED at payment: ${preflight.blockedReason}`);
+    }
+    // Check human approval threshold
+    if (opts.delegation.requireHumanApproval && opts.delegation.humanApprovalThreshold) {
+        if (total.amount > opts.delegation.humanApprovalThreshold) {
+            throw new Error(`HUMAN_APPROVAL_REQUIRED: Purchase of ${total.amount} ${total.currency} exceeds threshold of ${opts.delegation.humanApprovalThreshold}. ` +
+                `Use requestHumanApproval() to get confirmation before completing.`);
+        }
+    }
+    // Complete checkout via ACP
+    const url = `${opts.config.merchantBaseUrl}/checkout_sessions/${opts.sessionId}/complete`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(opts.config.bearerToken && { 'Authorization': `Bearer ${opts.config.bearerToken}` }),
+        },
+        body: JSON.stringify({
+            payment_token: opts.paymentToken,
+            ...(opts.paymentMethod && { payment_method: opts.paymentMethod }),
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`ACP CompleteCheckout failed: ${response.status} ${response.statusText}`);
+    }
+    const session = await response.json();
+    // Update spend tracking on the delegation
+    const spendUpdated = {
+        ...opts.delegation,
+        spentAmount: opts.delegation.spentAmount + total.amount,
+    };
+    // Generate signed receipt with full purchase details
+    const receipt = signCommerceReceipt({
+        agentId: opts.signedPassport.passport.agentId,
+        delegationId: opts.delegation.delegationId,
+        actionType: 'commerce:complete_checkout',
+        target: url,
+        method: 'POST',
+        session,
+        merchantName: opts.config.merchantName,
+        delegationChain: extractDelegationChain(opts.signedPassport),
+        beneficiary: opts.signedPassport.passport.metadata?.beneficiaryPrincipalId || 'unknown',
+        privateKey: opts.privateKey,
+    });
+    return { session, receipt, spendUpdated };
+}
+// ── ACP Client: Cancel Checkout ──
+export async function cancelCheckout(opts) {
+    const url = `${opts.config.merchantBaseUrl}/checkout_sessions/${opts.sessionId}/cancel`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(opts.config.bearerToken && { 'Authorization': `Bearer ${opts.config.bearerToken}` }),
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`ACP CancelCheckout failed: ${response.status} ${response.statusText}`);
+    }
+    const session = await response.json();
+    const receipt = signCommerceReceipt({
+        agentId: opts.signedPassport.passport.agentId,
+        delegationId: opts.delegation.delegationId,
+        actionType: 'commerce:cancel_checkout',
+        target: url,
+        method: 'POST',
+        session,
+        merchantName: opts.config.merchantName,
+        delegationChain: extractDelegationChain(opts.signedPassport),
+        beneficiary: opts.signedPassport.passport.metadata?.beneficiaryPrincipalId || 'unknown',
+        privateKey: opts.privateKey,
+    });
+    return { session, receipt };
+}
+// ── Human Approval Request ──
+export function requestHumanApproval(opts) {
+    const now = new Date();
+    const expiresAt = new Date(now.getTime() + (opts.expiresInMinutes || 30) * 60 * 1000);
+    return {
+        requestId: `approval-${randomBytes(8).toString('hex')}`,
+        agentId: opts.agentId,
+        merchantName: opts.merchantName,
+        items: opts.items,
+        totalAmount: opts.totalAmount,
+        delegationId: opts.delegationId,
+        reason: opts.reason,
+        createdAt: now.toISOString(),
+        expiresAt: expiresAt.toISOString(),
+        status: 'pending',
+    };
+}
+// ── Commerce Receipt Signing ──
+function signCommerceReceipt(opts) {
+    const receipt = {
+        receiptId: `rcpt-commerce-${randomBytes(8).toString('hex')}`,
+        version: '1.0',
+        timestamp: new Date().toISOString(),
+        agentId: opts.agentId,
+        delegationId: opts.delegationId,
+        action: {
+            type: opts.actionType,
+            target: opts.target,
+            method: opts.method,
+            scopeUsed: 'commerce:checkout',
+            spend: {
+                amount: opts.session.totals.total.amount,
+                currency: opts.session.totals.total.currency,
+            },
+        },
+        checkout: {
+            sessionId: opts.session.id,
+            merchantName: opts.merchantName,
+            items: opts.session.items.map(i => ({
+                skuId: i.skuId,
+                name: i.name,
+                quantity: i.quantity,
+                unitPrice: i.unitPrice.amount,
+            })),
+            totalAmount: opts.session.totals.total.amount,
+            totalCurrency: opts.session.totals.total.currency,
+            status: opts.session.status,
+        },
+        delegationChain: opts.delegationChain,
+        beneficiary: opts.beneficiary,
+    };
+    const payload = canonicalize(receipt);
+    const signature = sign(payload, opts.privateKey);
+    return { ...receipt, signature };
+}
+// ── Helpers ──
+function extractDelegationChain(sp) {
+    const chain = [sp.passport.publicKey];
+    if (sp.passport.delegations) {
+        for (const d of sp.passport.delegations) {
+            if (!chain.includes(d.delegatedBy))
+                chain.push(d.delegatedBy);
+        }
+    }
+    return chain;
+}
+// ── Commerce Delegation Factory ──
+export function createCommerceDelegation(opts) {
+    return {
+        agentId: opts.agentId,
+        delegationId: opts.delegationId,
+        scope: ['commerce:checkout', 'commerce:browse', ...(opts.additionalScopes || [])],
+        spendLimit: opts.spendLimit,
+        spentAmount: 0,
+        currency: opts.currency || 'usd',
+        approvedMerchants: opts.approvedMerchants,
+        requireHumanApproval: opts.requireHumanApproval ?? true,
+        humanApprovalThreshold: opts.humanApprovalThreshold,
+    };
+}
+// ── Spend Analytics ──
+export function getSpendSummary(delegation) {
+    const remaining = delegation.spendLimit - delegation.spentAmount;
+    const utilization = delegation.spendLimit > 0
+        ? (delegation.spentAmount / delegation.spendLimit) * 100
+        : 0;
+    return {
+        limit: delegation.spendLimit,
+        spent: delegation.spentAmount,
+        remaining,
+        currency: delegation.currency,
+        utilizationPercent: Math.round(utilization * 100) / 100,
+        nearLimit: utilization >= 80,
+    };
+}
+// ── Verify Commerce Receipt ──
+export function verifyCommerceReceipt(receipt, publicKey) {
+    const errors = [];
+    // Verify signature
+    const { signature, ...payload } = receipt;
+    const canonical = canonicalize(payload);
+    try {
+        const signatureValid = ed25519Verify(canonical, signature, publicKey);
+        if (!signatureValid) {
+            errors.push('Commerce receipt signature is invalid');
+        }
+    }
+    catch {
+        errors.push('Failed to verify commerce receipt signature');
+    }
+    // Verify required fields
+    if (!receipt.receiptId)
+        errors.push('Missing receiptId');
+    if (!receipt.agentId)
+        errors.push('Missing agentId');
+    if (!receipt.delegationId)
+        errors.push('Missing delegationId');
+    if (!receipt.action?.type)
+        errors.push('Missing action type');
+    if (!receipt.action?.scopeUsed)
+        errors.push('Missing scopeUsed');
+    if (!receipt.beneficiary)
+        errors.push('Missing beneficiary');
+    if (!receipt.checkout?.sessionId)
+        errors.push('Missing checkout sessionId');
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=commerce.js.map

package/dist/src/core/commerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.js","sourceRoot":"","sources":["../../../src/core/commerce.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -19,4 +19,6 @@ export { createTaskBrief, verifyTaskBrief, assignTask, acceptTask, submitEvidenc
 export type { CoordinationRole, TaskStatus, ReviewVerdict, TaskBrief, TaskRoleSpec, DeliverableSpec, TaskAssignment, EvidencePacket, EvidenceClaim, ReviewDecision, ReviewIssue, EvidenceHandoff, Deliverable, TaskCompletion, TaskMetrics, TaskUnit, } from './types/coordination.js';
 export { createActionIntent, verifyActionIntent, evaluateIntent, verifyPolicyDecision, createPolicyReceipt, verifyPolicyReceipt, FloorValidatorV1, requestAction, } from './core/policy.js';
 export type { ActionIntent, PolicyDecision, PolicyReceipt, PolicyVerdict, PrincipleEvaluation, PolicyValidator, ValidationContext, PolicyEvaluationResult, } from './types/policy.js';
+export { commercePreflight, createCheckout, updateCheckout, completeCheckout, cancelCheckout, requestHumanApproval, createCommerceDelegation, getSpendSummary, verifyCommerceReceipt, } from './core/commerce.js';
+export type { ACPCheckoutSession, ACPLineItem, ACPMoney, ACPTotals, ACPFulfillment, ACPFulfillmentOption, ACPPaymentMethod, ACPCustomer, ACPAddress, ACPOrderEvent, CommerceConfig, CommerceDelegation, CommercePreflightResult, CommercePreflightCheck, CommerceActionReceipt, HumanApprovalRequest, } from './types/commerce.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -33,4 +33,6 @@ export { assignRole, createTradeoffRule, evaluateTradeoff, createIntentDocument,
 export { createTaskBrief, verifyTaskBrief, assignTask, acceptTask, submitEvidence, verifyEvidence, reviewEvidence, verifyReview, handoffEvidence, verifyHandoff, submitDeliverable, verifyDeliverable, completeTask, verifyCompletion, createTaskUnit, getTaskStatus, validateTaskUnit, } from './core/coordination.js';
 // ── Values Floor Policy Engine ──
 export { createActionIntent, verifyActionIntent, evaluateIntent, verifyPolicyDecision, createPolicyReceipt, verifyPolicyReceipt, FloorValidatorV1, requestAction, } from './core/policy.js';
+// ── Layer 7: Agentic Commerce (ACP) ──
+export { commercePreflight, createCheckout, updateCheckout, completeCheckout, cancelCheckout, requestHumanApproval, createCommerceDelegation, getSpendSummary, verifyCommerceReceipt, } from './core/commerce.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,6DAA6D;AAC7D,EAAE;AACF,+BAA+B;AAC/B,8DAA8D;AAC9D,mDAAmD;AACnD,8CAA8C;AAC9C,2DAA2D;AAC3D,sEAAsE;AACtE,4DAA4D;AAC5D,EAAE;AACF,8DAA8D;AAE9D,yCAAyC;AACzC,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EACxC,QAAQ,EAAE,UAAU,EACpB,kBAAkB,EAAE,eAAe,EACpC,MAAM,eAAe,CAAA;AAOtB,2CAA2C;AAC3C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAE1F,0CAA0C;AAC1C,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAC/C,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAAE,aAAa,EAC3C,cAAc,EAAE,aAAa,EAAE,YAAY,EAC3C,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,aAAa,EAAE,WAAW,EACxC,MAAM,sBAAsB,CAAA;AAE7B,oCAAoC;AACpC,OAAO,EACL,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,iBAAiB,EAC9B,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAAE,uBAAuB,EAC3C,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EACvD,+BAA+B,EAC/B,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,6CAA6C;AAC7C,OAAO,EACL,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EACvE,cAAc,EAAE,aAAa,EAAE,UAAU,EAC1C,MAAM,iBAAiB,CAAA;AA8BxB,qCAAqC;AACrC,OAAO,EACL,UAAU,EACV,kBAAkB,EAAE,gBAAgB,EACpC,oBAAoB,EACpB,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAChF,oBAAoB,EAAE,aAAa,EACnC,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AAczB,yCAAyC;AACzC,OAAO,EACL,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,YAAY,EAC5B,eAAe,EAAE,aAAa,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,gBAAgB,EAC9B,cAAc,EAAE,aAAa,EAAE,gBAAgB,GAChD,MAAM,wBAAwB,CAAA;AAW/B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,oBAAoB,EACpC,mBAAmB,EAAE,mBAAmB,EACxC,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,6DAA6D;AAC7D,EAAE;AACF,+BAA+B;AAC/B,8DAA8D;AAC9D,mDAAmD;AACnD,8CAA8C;AAC9C,2DAA2D;AAC3D,sEAAsE;AACtE,4DAA4D;AAC5D,EAAE;AACF,8DAA8D;AAE9D,yCAAyC;AACzC,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EACxC,QAAQ,EAAE,UAAU,EACpB,kBAAkB,EAAE,eAAe,EACpC,MAAM,eAAe,CAAA;AAOtB,2CAA2C;AAC3C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAE1F,0CAA0C;AAC1C,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAC/C,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAAE,aAAa,EAC3C,cAAc,EAAE,aAAa,EAAE,YAAY,EAC3C,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,aAAa,EAAE,WAAW,EACxC,MAAM,sBAAsB,CAAA;AAE7B,oCAAoC;AACpC,OAAO,EACL,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,iBAAiB,EAC9B,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAAE,uBAAuB,EAC3C,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EACvD,+BAA+B,EAC/B,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,6CAA6C;AAC7C,OAAO,EACL,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EACvE,cAAc,EAAE,aAAa,EAAE,UAAU,EAC1C,MAAM,iBAAiB,CAAA;AA8BxB,qCAAqC;AACrC,OAAO,EACL,UAAU,EACV,kBAAkB,EAAE,gBAAgB,EACpC,oBAAoB,EACpB,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAChF,oBAAoB,EAAE,aAAa,EACnC,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AAczB,yCAAyC;AACzC,OAAO,EACL,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,YAAY,EAC5B,eAAe,EAAE,aAAa,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,gBAAgB,EAC9B,cAAc,EAAE,aAAa,EAAE,gBAAgB,GAChD,MAAM,wBAAwB,CAAA;AAW/B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,oBAAoB,EACpC,mBAAmB,EAAE,mBAAmB,EACxC,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAA;AAQzB,wCAAwC;AACxC,OAAO,EACL,iBAAiB,EACjB,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAChE,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,GACtB,MAAM,oBAAoB,CAAA"}

package/dist/src/types/commerce.d.ts

@@ -0,0 +1,151 @@
+export interface ACPCheckoutSession {
+    id: string;
+    status: 'open' | 'completed' | 'cancelled' | 'expired';
+    items: ACPLineItem[];
+    totals: ACPTotals;
+    fulfillment?: ACPFulfillment;
+    fulfillmentOptions?: ACPFulfillmentOption[];
+    paymentMethods?: ACPPaymentMethod[];
+    customer?: ACPCustomer;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ACPLineItem {
+    id: string;
+    skuId: string;
+    name: string;
+    description?: string;
+    quantity: number;
+    unitPrice: ACPMoney;
+    totalPrice: ACPMoney;
+    imageUrl?: string;
+    productUrl?: string;
+}
+export interface ACPMoney {
+    amount: number;
+    currency: string;
+}
+export interface ACPTotals {
+    subtotal: ACPMoney;
+    tax?: ACPMoney;
+    shipping?: ACPMoney;
+    discount?: ACPMoney;
+    total: ACPMoney;
+}
+export interface ACPFulfillment {
+    type: 'shipping' | 'pickup' | 'digital';
+    address?: ACPAddress;
+    optionId?: string;
+}
+export interface ACPFulfillmentOption {
+    id: string;
+    name: string;
+    description?: string;
+    price: ACPMoney;
+    estimatedDelivery?: string;
+}
+export interface ACPPaymentMethod {
+    type: 'shared_payment_token' | 'card' | 'link' | string;
+    id?: string;
+}
+export interface ACPCustomer {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+export interface ACPAddress {
+    name?: string;
+    lineOne: string;
+    lineTwo?: string;
+    city: string;
+    state?: string;
+    country: string;
+    postalCode: string;
+}
+export interface ACPOrderEvent {
+    eventId: string;
+    type: 'order.created' | 'order.updated' | 'order.shipped' | 'order.delivered' | 'order.cancelled';
+    checkoutSessionId: string;
+    orderId: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export interface CommerceConfig {
+    merchantBaseUrl: string;
+    merchantName: string;
+    bearerToken?: string;
+    webhookUrl?: string;
+    webhookSecret?: string;
+    defaultCurrency?: string;
+}
+export interface CommerceDelegation {
+    agentId: string;
+    delegationId: string;
+    scope: string[];
+    spendLimit: number;
+    spentAmount: number;
+    currency: string;
+    approvedMerchants?: string[];
+    requireHumanApproval?: boolean;
+    humanApprovalThreshold?: number;
+}
+export interface CommercePreflightResult {
+    permitted: boolean;
+    checks: CommercePreflightCheck[];
+    delegation?: CommerceDelegation;
+    warnings: string[];
+    blockedReason?: string;
+}
+export interface CommercePreflightCheck {
+    check: string;
+    passed: boolean;
+    detail: string;
+}
+export interface CommerceActionReceipt {
+    receiptId: string;
+    version: string;
+    timestamp: string;
+    agentId: string;
+    delegationId: string;
+    action: {
+        type: 'commerce:create_checkout' | 'commerce:update_checkout' | 'commerce:complete_checkout' | 'commerce:cancel_checkout';
+        target: string;
+        method: string;
+        scopeUsed: string;
+        spend: {
+            amount: number;
+            currency: string;
+        };
+    };
+    checkout: {
+        sessionId: string;
+        merchantName: string;
+        items: {
+            skuId: string;
+            name: string;
+            quantity: number;
+            unitPrice: number;
+        }[];
+        totalAmount: number;
+        totalCurrency: string;
+        status: string;
+    };
+    delegationChain: string[];
+    beneficiary: string;
+    valuesFloorVersion?: string;
+    signature: string;
+}
+export interface HumanApprovalRequest {
+    requestId: string;
+    agentId: string;
+    merchantName: string;
+    items: ACPLineItem[];
+    totalAmount: ACPMoney;
+    delegationId: string;
+    reason: string;
+    createdAt: string;
+    expiresAt: string;
+    status: 'pending' | 'approved' | 'denied';
+}
+//# sourceMappingURL=commerce.d.ts.map

package/dist/src/types/commerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../../src/types/commerce.ts"],"names":[],"mappings":"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"}

package/dist/src/types/commerce.js

@@ -0,0 +1,9 @@
+// ══════════════════════════════════════════════════════════════════
+// Layer 7 — Agentic Commerce: Type Definitions
+// ══════════════════════════════════════════════════════════════════
+// Integration with the Agentic Commerce Protocol (ACP) by OpenAI + Stripe.
+// Every commerce action is passport-verified, delegation-scoped,
+// spend-limited, and produces signed ActionReceipts.
+// ══════════════════════════════════════════════════════════════════
+export {};
+//# sourceMappingURL=commerce.js.map

package/dist/src/types/commerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.js","sourceRoot":"","sources":["../../../src/types/commerce.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,+CAA+C;AAC/C,qEAAqE;AACrE,2EAA2E;AAC3E,iEAAiE;AACjE,qDAAqD;AACrD,qEAAqE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-passport-system",
-  "version": "1.5.0",
-  "description": "The Agent Social Contract — cryptographic identity, ethical governance, beneficiary attribution, and protocol-native communication for autonomous AI agents.",
+  "version": "1.6.0",
+  "description": "The Agent Social Contract — cryptographic identity, ethical governance, beneficiary attribution, protocol-native communication, and agentic commerce for autonomous AI agents.",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -16,7 +16,7 @@
   },
   "scripts": {
     "build": "tsc && chmod +x dist/src/cli/index.js",
-    "test": "tsx --test tests/passport.test.ts tests/v1.1-integration.ts tests/adversarial.ts tests/v2.0-integration.ts tests/contract.test.ts tests/agora.test.ts tests/values.test.ts tests/delegation.test.ts tests/attribution.test.ts tests/policy.test.ts tests/cascade.test.ts tests/coordination.test.ts",
+    "test": "tsx --test tests/passport.test.ts tests/v1.1-integration.ts tests/adversarial.ts tests/v2.0-integration.ts tests/contract.test.ts tests/agora.test.ts tests/values.test.ts tests/delegation.test.ts tests/attribution.test.ts tests/policy.test.ts tests/cascade.test.ts tests/coordination.test.ts tests/commerce.test.ts",
     "test:quick": "tsx --test tests/passport.test.ts",
     "lint": "tsc --noEmit",
     "clean": "rm -rf dist",