agent-passport-system 1.19.4 → 1.21.0

package/README.md

@@ -5,9 +5,11 @@
 [![tests](https://img.shields.io/badge/tests-1081%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)
 
+> **🤖 For AI agents:** If you are an agent reading this, visit [aeoess.com/llms.txt](https://aeoess.com/llms.txt) for machine-readable documentation or [llms-full.txt](https://aeoess.com/llms-full.txt) for the complete technical reference. This README is designed for humans.
+
 Cryptographic identity, ethical governance, economic attribution, data source registration, protocol-native communication, intent architecture, cascade revocation, coordination primitives, and agentic commerce for autonomous AI agents.
 
-**37 core modules + 32 v2 constitutional modules. 1090 tests. Zero heavy dependencies. Running code. MCP server included.**
+**37 core modules + 32 v2 constitutional modules. 1148 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?*
 
@@ -407,7 +409,7 @@ Or zero-install remote mode:
 npx agent-passport-system-mcp setup --remote
 ```
 
-**72 tools across all 37 modules, role-scoped access control.** Identity, delegation, agora, values/policy, coordination, and commerce — all accessible via MCP. Every operation Ed25519 signed. Auto-configures Claude Desktop and Cursor.
+**72 tools across all 39 modules, role-scoped access control.** Identity, delegation, agora, values/policy, coordination, and commerce — all accessible via MCP. Every operation Ed25519 signed. Auto-configures Claude Desktop and Cursor.
 
 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`.
 
@@ -429,7 +431,7 @@ PyPI: [agent-passport-system](https://pypi.org/project/agent-passport-system/)
 
 ```bash
 npm test
-# 1090 tests across 58 files, 290 suites, 0 failures
+# 1148 tests across 58 files, 310 suites, 0 failures
 ```
 
 Includes 50 adversarial tests across 4 test files: Merkle tree tampering, attribution gaming resistance, compliance violations, floor negotiation attacks, wrong-key attestations, cross-chain confused deputy, taint laundering, permit bypass, causal chain manipulation.
@@ -525,7 +527,7 @@ src/                    32 source files
     reputation-authority.ts — Reputation/tier types
     cross-chain.ts     — Cross-chain taint/SAO types
     data-source.ts     — Data source/access receipt types
-tests/                  58 test files, 1090 tests (290 suites)
+tests/                  61 test files, 1148 tests (310 suites)
   adversarial.ts       — 50 adversarial cases
   adversarial-paper.test.ts — 22 paper-linked attack scenarios
   adversarial-causal-chain.test.ts — 18 causal chain attacks

package/dist/src/core/data-contribution.d.ts

@@ -0,0 +1,16 @@
+import { DataAccessReceipt } from '../types/data-source.js';
+import { ContributionRecord, ContributionQuery, SourceMetrics, AgentDataFootprint } from '../types/data-contribution.js';
+export interface ContributionLedger {
+    records: Map<string, ContributionRecord>;
+    index: {
+        bySource: Map<string, Set<string>>;
+        byAgent: Map<string, Set<string>>;
+        byPrincipal: Map<string, Set<string>>;
+    };
+}
+export declare function createContributionLedger(): ContributionLedger;
+export declare function recordContribution(ledger: ContributionLedger, receipt: DataAccessReceipt, sourceDescriptor?: string): ContributionRecord;
+export declare function queryContributions(ledger: ContributionLedger, query: ContributionQuery): ContributionRecord[];
+export declare function getSourceMetrics(ledger: ContributionLedger, sourceReceiptId: string): SourceMetrics | null;
+export declare function getAgentDataFootprint(ledger: ContributionLedger, agentId: string): AgentDataFootprint | null;
+//# sourceMappingURL=data-contribution.d.ts.map

package/dist/src/core/data-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-contribution.d.ts","sourceRoot":"","sources":["../../../src/core/data-contribution.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EACpD,kBAAkB,EACnB,MAAM,+BAA+B,CAAA;AAKtC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IACxC,KAAK,EAAE;QACL,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;KACtC,CAAA;CACF;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAS7D;AA2CD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,gBAAgB,GAAE,MAAW,GAC5B,kBAAkB,CAiDpB;AAID,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,EAAE,CA2BtB;AAKD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,MAAM,GACtB,aAAa,GAAG,IAAI,CA2CtB;AAKD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CAmC3B"}

package/dist/src/core/data-contribution.js

@@ -0,0 +1,215 @@
+// ══════════════════════════════════════════════════════════════════════
+// Module 38: Data Contribution Ledger
+// ══════════════════════════════════════════════════════════════════════
+// Aggregation layer on top of Module 36A (Data Source Registration).
+// Tracks who accessed what data, how many times, and what's owed.
+//
+// Key principle: receipts are the evidence, the ledger is the index.
+// The ledger doesn't replace 36A — it aggregates 36A receipts into
+// queryable contribution records with compensation accrual.
+// ══════════════════════════════════════════════════════════════════════
+import crypto from 'crypto';
+export function createContributionLedger() {
+    return {
+        records: new Map(),
+        index: {
+            bySource: new Map(),
+            byAgent: new Map(),
+            byPrincipal: new Map(),
+        },
+    };
+}
+// ── Compensation Computation ──
+function computeCompensation(terms, accessCount) {
+    const model = terms.compensation;
+    const base = {
+        model: model.type,
+        totalOwed: 0,
+        currency: 'usd',
+        accessesBilled: accessCount,
+        lastComputedAt: new Date().toISOString(),
+    };
+    switch (model.type) {
+        case 'none':
+        case 'attribution_only':
+        case 'negotiate':
+            return base;
+        case 'per_access':
+            return { ...base, totalOwed: model.amount * accessCount, currency: model.currency };
+        case 'revenue_share':
+            // Revenue share requires external revenue data — track percentage only
+            return { ...base, model: 'revenue_share', totalOwed: 0 };
+        case 'pool':
+            return { ...base, model: 'pool' };
+        default:
+            return base;
+    }
+}
+// ── Record a Contribution ──
+// Takes a DataAccessReceipt from Module 36A and updates the ledger.
+function ledgerKey(receipt) {
+    return `${receipt.sourceReceiptId}:${receipt.agentId}:${receipt.principalId}`;
+}
+function addToIndex(index, key, id) {
+    if (!index.has(key))
+        index.set(key, new Set());
+    index.get(key).add(id);
+}
+export function recordContribution(ledger, receipt, sourceDescriptor = '') {
+    const key = ledgerKey(receipt);
+    const existing = Array.from(ledger.records.values()).find(r => r.sourceReceiptId === receipt.sourceReceiptId
+        && r.agentId === receipt.agentId
+        && r.principalId === receipt.principalId);
+    if (existing) {
+        // Update existing contribution record
+        existing.accessCount += 1;
+        existing.lastAccessAt = receipt.timestamp;
+        if (!existing.purposes.includes(receipt.declaredPurpose)) {
+            existing.purposes.push(receipt.declaredPurpose);
+        }
+        if (!existing.accessMethods.includes(receipt.accessMethod)) {
+            existing.accessMethods.push(receipt.accessMethod);
+        }
+        existing.receiptIds.push(receipt.accessReceiptId);
+        existing.compensationAccrued = computeCompensation(receipt.termsAtAccessTime, existing.accessCount);
+        return existing;
+    }
+    // Create new contribution record
+    const record = {
+        contributionId: 'dcr_' + crypto.randomUUID(),
+        sourceReceiptId: receipt.sourceReceiptId,
+        sourceDescriptor,
+        agentId: receipt.agentId,
+        agentPublicKey: receipt.agentPublicKey,
+        principalId: receipt.principalId,
+        accessCount: 1,
+        firstAccessAt: receipt.timestamp,
+        lastAccessAt: receipt.timestamp,
+        purposes: [receipt.declaredPurpose],
+        accessMethods: [receipt.accessMethod],
+        compensationAccrued: computeCompensation(receipt.termsAtAccessTime, 1),
+        receiptIds: [receipt.accessReceiptId],
+    };
+    ledger.records.set(record.contributionId, record);
+    addToIndex(ledger.index.bySource, receipt.sourceReceiptId, record.contributionId);
+    addToIndex(ledger.index.byAgent, receipt.agentId, record.contributionId);
+    addToIndex(ledger.index.byPrincipal, receipt.principalId, record.contributionId);
+    return record;
+}
+// ── Query Contributions ──
+export function queryContributions(ledger, query) {
+    let candidates;
+    // Use index for fast lookup when possible
+    if (query.sourceReceiptId && ledger.index.bySource.has(query.sourceReceiptId)) {
+        const ids = ledger.index.bySource.get(query.sourceReceiptId);
+        candidates = Array.from(ids).map(id => ledger.records.get(id)).filter(Boolean);
+    }
+    else if (query.agentId && ledger.index.byAgent.has(query.agentId)) {
+        const ids = ledger.index.byAgent.get(query.agentId);
+        candidates = Array.from(ids).map(id => ledger.records.get(id)).filter(Boolean);
+    }
+    else if (query.principalId && ledger.index.byPrincipal.has(query.principalId)) {
+        const ids = ledger.index.byPrincipal.get(query.principalId);
+        candidates = Array.from(ids).map(id => ledger.records.get(id)).filter(Boolean);
+    }
+    else {
+        candidates = Array.from(ledger.records.values());
+    }
+    return candidates.filter(r => {
+        if (query.sourceReceiptId && r.sourceReceiptId !== query.sourceReceiptId)
+            return false;
+        if (query.agentId && r.agentId !== query.agentId)
+            return false;
+        if (query.principalId && r.principalId !== query.principalId)
+            return false;
+        if (query.purpose && !r.purposes.includes(query.purpose))
+            return false;
+        if (query.after && r.lastAccessAt < query.after)
+            return false;
+        if (query.before && r.firstAccessAt > query.before)
+            return false;
+        if (query.minAccessCount && r.accessCount < query.minAccessCount)
+            return false;
+        return true;
+    });
+}
+// ── Source Metrics ──
+// "Show me how many agents used our dataset this month and what's owed"
+export function getSourceMetrics(ledger, sourceReceiptId) {
+    const records = queryContributions(ledger, { sourceReceiptId });
+    if (records.length === 0)
+        return null;
+    const uniqueAgents = new Set(records.map(r => r.agentId));
+    const uniquePrincipals = new Set(records.map(r => r.principalId));
+    const purposeBreakdown = {};
+    let totalAccesses = 0;
+    let totalOwed = 0;
+    let currency = 'usd';
+    for (const r of records) {
+        totalAccesses += r.accessCount;
+        totalOwed += r.compensationAccrued.totalOwed;
+        currency = r.compensationAccrued.currency || currency;
+        for (const p of r.purposes) {
+            purposeBreakdown[p] = (purposeBreakdown[p] || 0) + r.accessCount;
+        }
+    }
+    const topAgents = records
+        .sort((a, b) => b.accessCount - a.accessCount)
+        .slice(0, 10)
+        .map(r => ({ agentId: r.agentId, accessCount: r.accessCount }));
+    return {
+        sourceReceiptId,
+        sourceDescriptor: records[0]?.sourceDescriptor || '',
+        totalAccesses,
+        uniqueAgents: uniqueAgents.size,
+        uniquePrincipals: uniquePrincipals.size,
+        purposeBreakdown,
+        compensationOwed: {
+            model: records[0]?.compensationAccrued.model || 'none',
+            totalOwed,
+            currency,
+            accessesBilled: totalAccesses,
+            lastComputedAt: new Date().toISOString(),
+        },
+        firstAccess: records.reduce((min, r) => r.firstAccessAt < min ? r.firstAccessAt : min, records[0].firstAccessAt),
+        lastAccess: records.reduce((max, r) => r.lastAccessAt > max ? r.lastAccessAt : max, records[0].lastAccessAt),
+        topAgents,
+    };
+}
+// ── Agent Data Footprint ──
+// "Show me every data source this agent has touched"
+export function getAgentDataFootprint(ledger, agentId) {
+    const records = queryContributions(ledger, { agentId });
+    if (records.length === 0)
+        return null;
+    let totalAccesses = 0;
+    let totalComp = 0;
+    let currency = 'usd';
+    const sources = records.map(r => {
+        totalAccesses += r.accessCount;
+        totalComp += r.compensationAccrued.totalOwed;
+        currency = r.compensationAccrued.currency || currency;
+        const status = r.compensationAccrued.model === 'none' ? 'none'
+            : r.compensationAccrued.model === 'attribution_only' ? 'attribution_only'
+                : r.compensationAccrued.totalOwed > 0 ? 'accruing' : 'none';
+        return {
+            sourceReceiptId: r.sourceReceiptId,
+            sourceDescriptor: r.sourceDescriptor,
+            accessCount: r.accessCount,
+            purposes: r.purposes,
+            lastAccess: r.lastAccessAt,
+            compensationStatus: status,
+        };
+    });
+    return {
+        agentId,
+        agentPublicKey: records[0].agentPublicKey,
+        principalId: records[0].principalId,
+        sourcesAccessed: sources,
+        totalSources: records.length,
+        totalAccesses,
+        totalCompensationAccrued: totalComp,
+        currency,
+    };
+}
+//# sourceMappingURL=data-contribution.js.map

package/dist/src/core/data-contribution.js.map

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

package/dist/src/core/data-enforcement.d.ts

@@ -0,0 +1,59 @@
+import { DataAccessReceipt, SourceReceipt, DataPurpose, AccessMethod } from '../types/data-source.js';
+import { ContributionLedger } from './data-contribution.js';
+export interface DataEnforcementConfig {
+    gatewayId: string;
+    gatewayPublicKey: string;
+    gatewayPrivateKey: string;
+    mode: 'enforce' | 'audit' | 'off';
+    onAccessBlocked?: (agentId: string, sourceId: string, violations: string[]) => void;
+    onAccessRecorded?: (receipt: DataAccessReceipt) => void;
+    onTermsWarning?: (agentId: string, sourceId: string, warnings: string[]) => void;
+}
+export interface DataAccessRequest {
+    agentId: string;
+    agentPublicKey: string;
+    principalId: string;
+    delegationId?: string;
+    sourceReceiptId: string;
+    declaredPurpose: DataPurpose;
+    accessMethod: AccessMethod;
+    accessScope: string;
+    executionFrameId: string;
+    dataHash?: string;
+}
+export interface DataAccessDecision {
+    allowed: boolean;
+    sourceReceiptId: string;
+    hardViolations: string[];
+    advisoryWarnings: string[];
+    receipt?: DataAccessReceipt;
+    accessesRemaining?: number;
+}
+export declare class DataEnforcementGate {
+    private config;
+    private sources;
+    private ledger;
+    private receipts;
+    constructor(config: DataEnforcementConfig, ledger?: ContributionLedger);
+    /** Register a data source with the gate. Only registered sources are enforced. */
+    registerSource(receipt: SourceReceipt, descriptor: string): void;
+    /** Get the contribution ledger for settlement/reporting */
+    getLedger(): ContributionLedger;
+    /** Get all access receipts */
+    getReceipts(): DataAccessReceipt[];
+    /** Get Merkle root of all receipts */
+    getMerkleRoot(): string;
+    /**
+     * Check whether an agent can access a data source.
+     * In 'enforce' mode, blocks non-compliant access.
+     * In 'audit' mode, logs but allows.
+     * Always generates a receipt and feeds the contribution ledger.
+     */
+    checkAccess(request: DataAccessRequest): DataAccessDecision;
+    /** Bulk check: verify an agent can access all required sources before starting execution */
+    preflightCheck(requests: DataAccessRequest[]): {
+        allAllowed: boolean;
+        decisions: DataAccessDecision[];
+    };
+}
+//# sourceMappingURL=data-enforcement.d.ts.map

package/dist/src/core/data-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-enforcement.d.ts","sourceRoot":"","sources":["../../../src/core/data-enforcement.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,iBAAiB,EAAa,aAAa,EAAE,WAAW,EAAE,YAAY,EACvE,MAAM,yBAAyB,CAAA;AAIhC,OAAO,EACL,kBAAkB,EACnB,MAAM,wBAAwB,CAAA;AAI/B,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAA;IAEjC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACnF,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACvD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CACjF;AAYD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,WAAW,CAAA;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,kBAAkB;IAKtE,kFAAkF;IAClF,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhE,2DAA2D;IAC3D,SAAS,IAAI,kBAAkB;IAE/B,8BAA8B;IAC9B,WAAW,IAAI,iBAAiB,EAAE;IAElC,sCAAsC;IACtC,aAAa,IAAI,MAAM;IAEvB;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB;IA4E3D,4FAA4F;IAC5F,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE;CAsBxG"}

package/dist/src/core/data-enforcement.js

@@ -0,0 +1,132 @@
+// ══════════════════════════════════════════════════════════════════════
+// Data Enforcement Gate
+// ══════════════════════════════════════════════════════════════════════
+// Sits alongside the ProxyGateway. Before an agent accesses data,
+// the enforcement gate checks DataTerms, blocks if non-compliant,
+// and automatically generates access receipts + contribution records.
+//
+// Key principle: the agent cannot skip this check. The gateway calls
+// the enforcement gate before executing any data-accessing tool.
+// ══════════════════════════════════════════════════════════════════════
+import crypto from 'crypto';
+import { checkTermsCompliance, recordDataAccess, buildDataAccessMerkleRoot, } from './data-source.js';
+import { createContributionLedger, recordContribution, } from './data-contribution.js';
+// ── Data Enforcement Gate ──
+export class DataEnforcementGate {
+    config;
+    sources = new Map();
+    ledger;
+    receipts = [];
+    constructor(config, ledger) {
+        this.config = config;
+        this.ledger = ledger || createContributionLedger();
+    }
+    /** Register a data source with the gate. Only registered sources are enforced. */
+    registerSource(receipt, descriptor) {
+        this.sources.set(receipt.sourceReceiptId, { receipt, descriptor, accessCount: 0 });
+    }
+    /** Get the contribution ledger for settlement/reporting */
+    getLedger() { return this.ledger; }
+    /** Get all access receipts */
+    getReceipts() { return [...this.receipts]; }
+    /** Get Merkle root of all receipts */
+    getMerkleRoot() { return buildDataAccessMerkleRoot(this.receipts); }
+    /**
+     * Check whether an agent can access a data source.
+     * In 'enforce' mode, blocks non-compliant access.
+     * In 'audit' mode, logs but allows.
+     * Always generates a receipt and feeds the contribution ledger.
+     */
+    checkAccess(request) {
+        if (this.config.mode === 'off') {
+            return { allowed: true, sourceReceiptId: request.sourceReceiptId, hardViolations: [], advisoryWarnings: [] };
+        }
+        const source = this.sources.get(request.sourceReceiptId);
+        if (!source) {
+            return {
+                allowed: false,
+                sourceReceiptId: request.sourceReceiptId,
+                hardViolations: ['Source not registered with enforcement gate'],
+                advisoryWarnings: [],
+            };
+        }
+        // Check terms compliance
+        const compliance = checkTermsCompliance({
+            sourceReceipt: source.receipt,
+            agentId: request.agentId,
+            principalId: request.principalId,
+            declaredPurpose: request.declaredPurpose,
+            currentAccessCount: source.accessCount,
+        });
+        // In enforce mode, block if hard violations exist
+        if (this.config.mode === 'enforce' && !compliance.compliant) {
+            this.config.onAccessBlocked?.(request.agentId, request.sourceReceiptId, compliance.hardViolations);
+            return {
+                allowed: false,
+                sourceReceiptId: request.sourceReceiptId,
+                hardViolations: compliance.hardViolations,
+                advisoryWarnings: compliance.advisoryWarnings,
+                accessesRemaining: compliance.accessesRemaining,
+            };
+        }
+        // Advisory warnings (both modes)
+        if (compliance.advisoryWarnings.length > 0) {
+            this.config.onTermsWarning?.(request.agentId, request.sourceReceiptId, compliance.advisoryWarnings);
+        }
+        // Generate access receipt (gateway-signed, third-party attestation)
+        const receipt = recordDataAccess({
+            sourceReceipt: source.receipt,
+            dataHash: request.dataHash || crypto.createHash('sha256').update(request.executionFrameId + request.sourceReceiptId).digest('hex'),
+            agentId: request.agentId,
+            agentPublicKey: request.agentPublicKey,
+            delegationId: request.delegationId,
+            principalId: request.principalId,
+            executionFrameId: request.executionFrameId,
+            accessScope: request.accessScope,
+            accessMethod: request.accessMethod,
+            declaredPurpose: request.declaredPurpose,
+            gatewayId: this.config.gatewayId,
+            gatewayPublicKey: this.config.gatewayPublicKey,
+            gatewayPrivateKey: this.config.gatewayPrivateKey,
+        });
+        // Update tracking
+        source.accessCount++;
+        this.receipts.push(receipt);
+        this.config.onAccessRecorded?.(receipt);
+        // Feed the contribution ledger
+        recordContribution(this.ledger, receipt, source.descriptor);
+        return {
+            allowed: true,
+            sourceReceiptId: request.sourceReceiptId,
+            hardViolations: compliance.hardViolations, // empty in enforce mode if we got here
+            advisoryWarnings: compliance.advisoryWarnings,
+            receipt,
+            accessesRemaining: compliance.accessesRemaining,
+        };
+    }
+    /** Bulk check: verify an agent can access all required sources before starting execution */
+    preflightCheck(requests) {
+        const decisions = requests.map(r => {
+            // Dry run — don't generate receipts, just check compliance
+            const source = this.sources.get(r.sourceReceiptId);
+            if (!source)
+                return { allowed: false, sourceReceiptId: r.sourceReceiptId, hardViolations: ['Source not registered'], advisoryWarnings: [] };
+            const compliance = checkTermsCompliance({
+                sourceReceipt: source.receipt,
+                agentId: r.agentId,
+                principalId: r.principalId,
+                declaredPurpose: r.declaredPurpose,
+                currentAccessCount: source.accessCount,
+            });
+            return {
+                allowed: this.config.mode === 'enforce' ? compliance.compliant : true,
+                sourceReceiptId: r.sourceReceiptId,
+                hardViolations: compliance.hardViolations,
+                advisoryWarnings: compliance.advisoryWarnings,
+                accessesRemaining: compliance.accessesRemaining,
+            };
+        });
+        return { allAllowed: decisions.every(d => d.allowed), decisions };
+    }
+}
+//# sourceMappingURL=data-enforcement.js.map

package/dist/src/core/data-enforcement.js.map

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

package/dist/src/core/data-settlement.d.ts

@@ -0,0 +1,9 @@
+import { SettlementRecord, SettlementPeriod, SettlementVerification, DataComplianceReport } from '../types/data-contribution.js';
+import { ContributionLedger } from './data-contribution.js';
+export declare function generateSettlement(ledger: ContributionLedger, period: SettlementPeriod, generatorPublicKey: string, generatorPrivateKey: string): SettlementRecord;
+export declare function verifySettlement(record: SettlementRecord): SettlementVerification;
+export declare function generateComplianceReport(ledger: ContributionLedger, period: SettlementPeriod, reportType: DataComplianceReport['reportType'], generatorPrivateKey: string, options?: {
+    agentId?: string;
+    principalId?: string;
+}): DataComplianceReport;
+//# sourceMappingURL=data-settlement.d.ts.map

package/dist/src/core/data-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-settlement.d.ts","sourceRoot":"","sources":["../../../src/core/data-settlement.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,gBAAgB,EAAsB,gBAAgB,EACtD,sBAAsB,EAAE,oBAAoB,EAC7C,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAsB,MAAM,wBAAwB,CAAA;AAwC/E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,gBAAgB,EACxB,kBAAkB,EAAE,MAAM,EAC1B,mBAAmB,EAAE,MAAM,GAC1B,gBAAgB,CAkDlB;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CAkCjF;AAKD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,EAC9C,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,oBAAoB,CAyDtB"}