@agirails/sdk 3.2.0 → 3.4.1

package/dist/negotiation/ProviderOrchestrator.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * ProviderOrchestrator — autonomous provider-side quote flow.
+ *
+ * Symmetric to BuyerOrchestrator but smaller: one decision per incoming
+ * request (quote-or-skip, at what price), one submitQuote tx on-chain,
+ * one off-chain POST to the buyer's quote channel. Counter-offer
+ * evaluation is delegated to the policy engine; counter-counter
+ * strategies are Phase 3 territory and out of scope here.
+ *
+ * This module does NOT listen to the chain. Callers (Agent.ts in
+ * Phase 3) surface an IncomingRequest + consumer endpoint; the
+ * orchestrator decides + acts + returns the outcome.
+ *
+ * @module negotiation/ProviderOrchestrator
+ * @see Protocol/aips/AIP-2.1-DRAFT.md §5.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderOrchestrator = void 0;
+const QuoteBuilder_1 = require("../builders/QuoteBuilder");
+const CounterOfferBuilder_1 = require("../builders/CounterOfferBuilder");
+const NonceManager_1 = require("../utils/NonceManager");
+const QuoteChannel_1 = require("../transport/QuoteChannel");
+const ProviderPolicy_1 = require("./ProviderPolicy");
+// ============================================================================
+// Orchestrator
+// ============================================================================
+class ProviderOrchestrator {
+    constructor(cfg) {
+        this.policy = cfg.policy;
+        this.policyEngine = new ProviderPolicy_1.ProviderPolicyEngine(cfg.policy);
+        this.runtime = cfg.runtime;
+        this.signer = cfg.signer;
+        this.kernelAddress = cfg.kernelAddress;
+        this.chainId = cfg.chainId;
+        this.nonceManager = cfg.nonceManager ?? new NonceManager_1.InMemoryNonceManager();
+        this.channel = cfg.channel ?? new QuoteChannel_1.QuoteChannelClient();
+        this.quoteBuilder = new QuoteBuilder_1.QuoteBuilder(this.signer, this.nonceManager);
+        // Verifier side — builder instance is signer-independent for verify().
+        // We hand it the same signer to keep the construction trivial.
+        this.counterVerifier = new CounterOfferBuilder_1.CounterOfferBuilder(this.signer, this.nonceManager);
+    }
+    /**
+     * Decide whether to quote. Does NOT touch the chain — pure policy.
+     * Use `quote()` below to act on the decision.
+     */
+    evaluateRequest(req) {
+        const result = this.policyEngine.evaluate(req);
+        if (!result.allowed) {
+            return {
+                action: 'skip',
+                reason: result.violations.map((v) => `${v.rule}: ${v.detail}`).join('; '),
+                violations: result.violations,
+            };
+        }
+        return {
+            action: 'quote',
+            amountBaseUnits: result.recommended_quote_amount_base_units,
+            reason: `Policy passed; recommended quote ${result.recommended_quote_amount_base_units} base units`,
+        };
+    }
+    /**
+     * Full quote flow: evaluate → build signed QuoteMessage → submit
+     * on-chain → POST to buyer's endpoint.
+     *
+     * On-chain failure → throws (caller decides retry / cancel).
+     * Off-chain POST failure → returns successfully with `channelError`
+     * set so caller knows to retry only the delivery step. Preserves the
+     * invariant "on-chain tx is what buyer observes regardless of our
+     * off-chain delivery".
+     */
+    async quote(req, providerDID, consumerEndpoint) {
+        const decision = this.evaluateRequest(req);
+        if (decision.action === 'skip') {
+            return { decision };
+        }
+        // Build + sign QuoteMessage. Amount stays in base units throughout
+        // (no float round-trip). Currency / decimals come from policy —
+        // hardcoding would silently mask a config drift if we ever support
+        // non-USDC tokens. QuoteBuilder validates USDC/6 today; other
+        // currencies will throw there until the builder grows support.
+        const now = Math.floor(Date.now() / 1000);
+        const currency = this.policyEngine.policyCurrency;
+        const decimals = currency.toUpperCase() === 'USDC' ? 6 : 6; // placeholder for future currencies
+        const quote = await this.quoteBuilder.build({
+            txId: req.txId,
+            provider: providerDID,
+            consumer: req.consumer,
+            quotedAmount: decision.amountBaseUnits,
+            originalAmount: req.offeredAmount,
+            maxPrice: req.maxPrice,
+            currency,
+            decimals,
+            expiresAt: now + this.policyEngine.quoteTtlSeconds,
+            chainId: this.chainId,
+            kernelAddress: this.kernelAddress,
+        });
+        // On-chain: INITIATED → QUOTED, hash stored in tx.metadata.
+        await this.runtime.submitQuote(req.txId, quote);
+        // Off-chain: deliver the signed message so buyer can verify.
+        // Caller may omit consumerEndpoint when the transport is handled
+        // outside this orchestrator (e.g. Telegram, IPFS pubsub adapter).
+        if (consumerEndpoint) {
+            try {
+                await this.channel.sendQuote(consumerEndpoint, quote);
+            }
+            catch (err) {
+                return {
+                    decision,
+                    quote,
+                    channelError: err instanceof Error ? err.message : String(err),
+                };
+            }
+        }
+        return { decision, quote };
+    }
+    /**
+     * Verify + evaluate a buyer counter-offer. Returns the decision;
+     * does NOT send any response — Phase 3 wires the response path.
+     *
+     * @throws if the counter signature / band / expiry fails verify.
+     */
+    async evaluateCounter(counter) {
+        await this.counterVerifier.verify(counter, this.kernelAddress);
+        const verdict = this.policyEngine.evaluateCounter(counter.counterAmount);
+        // Engine returns `{decision, reason}`; orchestrator API uses
+        // `{action, reason}` — reshape at the boundary.
+        return { action: verdict.decision, reason: verdict.reason };
+    }
+    /** Read-only policy accessor for UIs and tests. */
+    getPolicy() {
+        return this.policy;
+    }
+}
+exports.ProviderOrchestrator = ProviderOrchestrator;
+//# sourceMappingURL=ProviderOrchestrator.js.map

package/dist/negotiation/ProviderOrchestrator.js.map

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

package/dist/negotiation/ProviderPolicy.d.ts

@@ -0,0 +1,143 @@
+/**
+ * ProviderPolicy — hard guardrails for autonomous provider quoting.
+ *
+ * Symmetric to BuyerPolicy. Provider configures what they'll deliver,
+ * their price floor, and their lifecycle preferences; ProviderPolicyEngine
+ * enforces those invariants on every incoming request so the provider
+ * never quotes below floor, outside their service menu, or for a
+ * transaction they can't realistically complete before the deadline.
+ *
+ * @module negotiation/ProviderPolicy
+ * @see Protocol/aips/AIP-2.1-DRAFT.md §5.2 (ProviderPolicy.ts creation)
+ */
+/**
+ * What this agent provides + at what terms.
+ *
+ * Pricing invariant (enforced at construction):
+ *   ideal_price.amount ≥ min_acceptable.amount ≥ PLATFORM_MIN_USDC
+ *
+ * `currency`/`unit` must be identical across min_acceptable and
+ * ideal_price — we compare amounts directly, there's no FX in v1.
+ */
+export interface ProviderPolicy {
+    /**
+     * Services this provider offers. Incoming requests for service types
+     * NOT in this list get a 'skip' decision (let the tx timeout to
+     * CANCELLED; we don't quote for work we don't do).
+     */
+    services: string[];
+    pricing: {
+        /** Absolute floor. Any buyer maxPrice below this → skip. */
+        min_acceptable: {
+            amount: number;
+            currency: string;
+            unit: string;
+        };
+        /** Preferred quote amount when buyer's maxPrice ≥ ideal. */
+        ideal_price: {
+            amount: number;
+            currency: string;
+            unit: string;
+        };
+    };
+    /** Quote validity window (e.g. "15m"). Governs our QuoteMessage expiresAt. */
+    quote_ttl: string;
+    /**
+     * Minimum time (seconds) we need between now and tx.deadline to
+     * realistically deliver. Requests with a tighter deadline get 'skip'.
+     * Defaults to 60s if omitted.
+     */
+    min_deadline_seconds?: number;
+}
+export type ProviderPolicyViolation = {
+    rule: 'service_not_offered';
+    detail: string;
+} | {
+    rule: 'max_price_below_floor';
+    detail: string;
+} | {
+    rule: 'deadline_too_tight';
+    detail: string;
+} | {
+    rule: 'currency_mismatch';
+    detail: string;
+} | {
+    rule: 'unit_mismatch';
+    detail: string;
+};
+export interface ProviderPolicyResult {
+    allowed: boolean;
+    violations: ProviderPolicyViolation[];
+    /**
+     * When `allowed`, the amount we SHOULD quote per this policy,
+     * expressed in USDC base units (1e6 per $1) as a decimal string.
+     * Using string-of-base-units throughout avoids Number/float drift
+     * on very large amounts and matches what the QuoteMessage carries.
+     *
+     * Rule: quote our ideal if buyer maxPrice ≥ ideal; otherwise quote
+     * at buyer maxPrice (still ≥ floor, validated above). Never below
+     * min_acceptable.
+     */
+    recommended_quote_amount_base_units?: string;
+}
+/**
+ * Incoming request surface — the minimum the orchestrator needs to
+ * decide whether + at what price to quote. Extracted from the
+ * on-chain transaction plus any off-chain context the caller has
+ * (service type, consumer DID).
+ */
+export interface IncomingRequest {
+    txId: string;
+    consumer: string;
+    /** Buyer's offered amount in USDC base units (smallest unit, string). */
+    offeredAmount: string;
+    /** Buyer's ceiling in USDC base units. */
+    maxPrice: string;
+    /** Unix seconds — tx.deadline from on-chain. */
+    deadline: number;
+    /** Service identifier (e.g. "code-review"). */
+    serviceType: string;
+    currency: string;
+    unit: string;
+}
+export declare class ProviderPolicyEngine {
+    private readonly policy;
+    private readonly floorBaseUnits;
+    private readonly idealBaseUnits;
+    private readonly currency;
+    constructor(policy: ProviderPolicy);
+    /**
+     * Evaluate an incoming request against policy. Returns `allowed: true`
+     * with `recommended_quote_amount_base_units` (bigint-as-string) when
+     * we should quote, or `allowed: false` with the specific rule(s)
+     * violated.
+     *
+     * All numeric comparisons use BigInt on base units — no float drift,
+     * no precision loss for large amounts.
+     */
+    evaluate(req: IncomingRequest): ProviderPolicyResult;
+    /**
+     * Decide whether to accept a buyer's counter-offer.
+     *
+     * Simple rule: accept if counter ≥ min_acceptable; reject otherwise.
+     * All arithmetic is BigInt on base units — no float drift.
+     * Phase 3 will extend this with `counter-counter` strategies.
+     */
+    evaluateCounter(counterAmountBaseUnits: string): {
+        decision: 'accept' | 'reject';
+        reason: string;
+    };
+    /** Expose ttl as seconds for callers building QuoteMessage.expiresAt. */
+    get quoteTtlSeconds(): number;
+    /** Expose the policy's currency for orchestrator wiring. */
+    get policyCurrency(): string;
+    /** Expose the policy's unit for orchestrator wiring + UI. */
+    get policyUnit(): string;
+}
+/**
+ * Parse a short duration string like "15m", "1h", "30s" into seconds.
+ * Mirror of PolicyEngine.parseTtl (buyer side) so both sides use the
+ * same format in their JSON policies.
+ */
+export declare function parseTtl(ttl: string): number;
+//# sourceMappingURL=ProviderPolicy.d.ts.map

package/dist/negotiation/ProviderPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderPolicy.d.ts","sourceRoot":"","sources":["../../src/negotiation/ProviderPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,OAAO,EAAE;QACP,4DAA4D;QAC5D,cAAc,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACnE,4DAA4D;QAC5D,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACjE,CAAC;IAEF,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC;;;;;;;;;OASG;IACH,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAqCD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,cAAc;IAmClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,oBAAoB;IAsEpD;;;;;;OAMG;IACH,eAAe,CAAC,sBAAsB,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAmBlG,yEAAyE;IACzE,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,4DAA4D;IAC5D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,6DAA6D;IAC7D,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU5C"}

package/dist/negotiation/ProviderPolicy.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * ProviderPolicy — hard guardrails for autonomous provider quoting.
+ *
+ * Symmetric to BuyerPolicy. Provider configures what they'll deliver,
+ * their price floor, and their lifecycle preferences; ProviderPolicyEngine
+ * enforces those invariants on every incoming request so the provider
+ * never quotes below floor, outside their service menu, or for a
+ * transaction they can't realistically complete before the deadline.
+ *
+ * @module negotiation/ProviderPolicy
+ * @see Protocol/aips/AIP-2.1-DRAFT.md §5.2 (ProviderPolicy.ts creation)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTtl = exports.ProviderPolicyEngine = void 0;
+// ============================================================================
+// Engine
+// ============================================================================
+/** Base units per $1 for supported currencies. USDC = 1e6 (6 decimals). */
+const BASE_UNITS_PER_USD = {
+    USDC: 1000000n,
+};
+/** Platform minimum in base units — $0.05 × 1e6 for USDC. */
+const PLATFORM_MIN_BASE_UNITS = {
+    USDC: 50000n,
+};
+const DEFAULT_MIN_DEADLINE_SECONDS = 60;
+/** Convert a human amount (e.g. 5, 10.5) to base units (bigint). */
+function toBaseUnits(amount, currency) {
+    const perUsd = BASE_UNITS_PER_USD[currency.toUpperCase()];
+    if (!perUsd)
+        throw new Error(`Unsupported currency: ${currency}`);
+    // Do the scaling as string→BigInt to avoid float drift on amounts
+    // that don't fit cleanly in double precision (e.g. 0.1).
+    const [whole, frac = ''] = String(amount).split('.');
+    const fracPadded = (frac + '000000').slice(0, String(perUsd).length - 1);
+    return BigInt(whole) * perUsd + BigInt(fracPadded || '0');
+}
+/** Format base units back to a human string for error messages. */
+function formatFromBaseUnits(baseUnits, currency) {
+    const perUsd = BASE_UNITS_PER_USD[currency.toUpperCase()];
+    if (!perUsd)
+        return `${baseUnits} base units`;
+    const whole = baseUnits / perUsd;
+    const frac = baseUnits % perUsd;
+    const fracStr = frac.toString().padStart(String(perUsd).length - 1, '0').replace(/0+$/, '');
+    return fracStr ? `$${whole}.${fracStr}` : `$${whole}`;
+}
+class ProviderPolicyEngine {
+    constructor(policy) {
+        const currency = policy.pricing.min_acceptable.currency;
+        const platformMin = PLATFORM_MIN_BASE_UNITS[currency.toUpperCase()];
+        if (!platformMin) {
+            throw new Error(`Unsupported currency in policy: ${currency}`);
+        }
+        // Enforce pricing invariants at construction — fail fast so mis-
+        // configured providers don't quote garbage.
+        const floorBu = toBaseUnits(policy.pricing.min_acceptable.amount, currency);
+        const idealBu = toBaseUnits(policy.pricing.ideal_price.amount, currency);
+        if (floorBu < platformMin) {
+            throw new Error(`min_acceptable.amount (${formatFromBaseUnits(floorBu, currency)}) below platform minimum (${formatFromBaseUnits(platformMin, currency)})`);
+        }
+        if (idealBu < floorBu) {
+            throw new Error(`ideal_price.amount (${formatFromBaseUnits(idealBu, currency)}) must be ≥ min_acceptable.amount (${formatFromBaseUnits(floorBu, currency)})`);
+        }
+        if (policy.pricing.min_acceptable.currency !== policy.pricing.ideal_price.currency) {
+            throw new Error('min_acceptable.currency must equal ideal_price.currency');
+        }
+        if (policy.pricing.min_acceptable.unit !== policy.pricing.ideal_price.unit) {
+            throw new Error('min_acceptable.unit must equal ideal_price.unit');
+        }
+        this.policy = policy;
+        this.floorBaseUnits = floorBu;
+        this.idealBaseUnits = idealBu;
+        this.currency = currency;
+    }
+    /**
+     * Evaluate an incoming request against policy. Returns `allowed: true`
+     * with `recommended_quote_amount_base_units` (bigint-as-string) when
+     * we should quote, or `allowed: false` with the specific rule(s)
+     * violated.
+     *
+     * All numeric comparisons use BigInt on base units — no float drift,
+     * no precision loss for large amounts.
+     */
+    evaluate(req) {
+        const violations = [];
+        if (!this.policy.services.includes(req.serviceType)) {
+            violations.push({
+                rule: 'service_not_offered',
+                detail: `We don't offer service "${req.serviceType}". Configured: ${this.policy.services.join(', ')}`,
+            });
+        }
+        if (req.currency.toUpperCase() !== this.currency.toUpperCase()) {
+            violations.push({
+                rule: 'currency_mismatch',
+                detail: `Request in ${req.currency}, we quote in ${this.currency}`,
+            });
+        }
+        // `unit` is the pricing unit (job, hour, page, request, …).
+        // Buyer quoting $5/hour vs provider priced-per-job is a genuine
+        // mismatch and must not silently be quoted.
+        if (req.unit !== this.policy.pricing.min_acceptable.unit) {
+            violations.push({
+                rule: 'unit_mismatch',
+                detail: `Request unit "${req.unit}" does not match policy unit "${this.policy.pricing.min_acceptable.unit}"`,
+            });
+        }
+        let maxPriceBu;
+        try {
+            maxPriceBu = BigInt(req.maxPrice);
+        }
+        catch {
+            violations.push({
+                rule: 'max_price_below_floor',
+                detail: `Invalid maxPrice: ${req.maxPrice}`,
+            });
+            maxPriceBu = 0n;
+        }
+        if (maxPriceBu < this.floorBaseUnits) {
+            violations.push({
+                rule: 'max_price_below_floor',
+                detail: `Buyer maxPrice ${formatFromBaseUnits(maxPriceBu, this.currency)} below our floor ${formatFromBaseUnits(this.floorBaseUnits, this.currency)}`,
+            });
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const minDeadlineSeconds = this.policy.min_deadline_seconds ?? DEFAULT_MIN_DEADLINE_SECONDS;
+        if (req.deadline - now < minDeadlineSeconds) {
+            violations.push({
+                rule: 'deadline_too_tight',
+                detail: `tx.deadline - now = ${req.deadline - now}s, need ≥ ${minDeadlineSeconds}s`,
+            });
+        }
+        if (violations.length > 0) {
+            return { allowed: false, violations };
+        }
+        // Recommended quote: ideal unless buyer can't afford it, in which
+        // case we quote at maxPrice (still above floor — validated above).
+        // BigInt min/max via ternary since there's no Math.min for BigInt.
+        const ceilingBu = maxPriceBu < this.idealBaseUnits ? maxPriceBu : this.idealBaseUnits;
+        const recommendedBu = ceilingBu > this.floorBaseUnits ? ceilingBu : this.floorBaseUnits;
+        return {
+            allowed: true,
+            violations: [],
+            recommended_quote_amount_base_units: recommendedBu.toString(),
+        };
+    }
+    /**
+     * Decide whether to accept a buyer's counter-offer.
+     *
+     * Simple rule: accept if counter ≥ min_acceptable; reject otherwise.
+     * All arithmetic is BigInt on base units — no float drift.
+     * Phase 3 will extend this with `counter-counter` strategies.
+     */
+    evaluateCounter(counterAmountBaseUnits) {
+        let counter;
+        try {
+            counter = BigInt(counterAmountBaseUnits);
+        }
+        catch {
+            return { decision: 'reject', reason: `Invalid counter amount: ${counterAmountBaseUnits}` };
+        }
+        if (counter < this.floorBaseUnits) {
+            return {
+                decision: 'reject',
+                reason: `Counter ${formatFromBaseUnits(counter, this.currency)} below our floor ${formatFromBaseUnits(this.floorBaseUnits, this.currency)}`,
+            };
+        }
+        return {
+            decision: 'accept',
+            reason: `Counter ${formatFromBaseUnits(counter, this.currency)} meets our floor`,
+        };
+    }
+    /** Expose ttl as seconds for callers building QuoteMessage.expiresAt. */
+    get quoteTtlSeconds() {
+        return parseTtl(this.policy.quote_ttl);
+    }
+    /** Expose the policy's currency for orchestrator wiring. */
+    get policyCurrency() {
+        return this.currency;
+    }
+    /** Expose the policy's unit for orchestrator wiring + UI. */
+    get policyUnit() {
+        return this.policy.pricing.min_acceptable.unit;
+    }
+}
+exports.ProviderPolicyEngine = ProviderPolicyEngine;
+/**
+ * Parse a short duration string like "15m", "1h", "30s" into seconds.
+ * Mirror of PolicyEngine.parseTtl (buyer side) so both sides use the
+ * same format in their JSON policies.
+ */
+function parseTtl(ttl) {
+    const match = ttl.trim().match(/^(\d+)\s*([smh])$/i);
+    if (!match) {
+        throw new Error(`Invalid TTL format: "${ttl}" (expected e.g. "15m", "1h", "30s")`);
+    }
+    const n = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (unit === 's')
+        return n;
+    if (unit === 'm')
+        return n * 60;
+    return n * 3600;
+}
+exports.parseTtl = parseTtl;
+//# sourceMappingURL=ProviderPolicy.js.map

package/dist/negotiation/ProviderPolicy.js.map

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

package/dist/negotiation/index.d.ts

@@ -5,5 +5,12 @@ export type { ScoringWeights, CandidateStats, ScoredCandidate } from './Decision
 export { SessionStore } from './SessionStore';
 export type { SessionMapping } from './SessionStore';
 export { BuyerOrchestrator } from './BuyerOrchestrator';
-export type { NegotiationResult, RoundResult, OrchestratorConfig, ProgressEvent } from './BuyerOrchestrator';
+export type { NegotiationResult, RoundResult, OrchestratorConfig, ProgressEvent, BuyerNegotiationContext, } from './BuyerOrchestrator';
+export { verifyQuoteHashOnChain } from './verifyQuoteOnChain';
+export type { VerifySource, VerifyOnChainResult } from './verifyQuoteOnChain';
+export type { QuoteForEvaluation, QuoteEvaluation } from './DecisionEngine';
+export { ProviderPolicyEngine, parseTtl as parseProviderTtl } from './ProviderPolicy';
+export type { ProviderPolicy, ProviderPolicyViolation, ProviderPolicyResult, IncomingRequest } from './ProviderPolicy';
+export { ProviderOrchestrator } from './ProviderOrchestrator';
+export type { ProviderOrchestratorConfig, QuoteDecision, QuoteResult, CounterDecision } from './ProviderOrchestrator';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/negotiation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1G,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/negotiation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1G,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtF,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/negotiation/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BuyerOrchestrator = exports.SessionStore = exports.DecisionEngine = exports.PolicyEngine = void 0;
+exports.ProviderOrchestrator = exports.parseProviderTtl = exports.ProviderPolicyEngine = exports.verifyQuoteHashOnChain = exports.BuyerOrchestrator = exports.SessionStore = exports.DecisionEngine = exports.PolicyEngine = void 0;
 var PolicyEngine_1 = require("./PolicyEngine");
 Object.defineProperty(exports, "PolicyEngine", { enumerable: true, get: function () { return PolicyEngine_1.PolicyEngine; } });
 var DecisionEngine_1 = require("./DecisionEngine");
@@ -9,4 +9,11 @@ var SessionStore_1 = require("./SessionStore");
 Object.defineProperty(exports, "SessionStore", { enumerable: true, get: function () { return SessionStore_1.SessionStore; } });
 var BuyerOrchestrator_1 = require("./BuyerOrchestrator");
 Object.defineProperty(exports, "BuyerOrchestrator", { enumerable: true, get: function () { return BuyerOrchestrator_1.BuyerOrchestrator; } });
+var verifyQuoteOnChain_1 = require("./verifyQuoteOnChain");
+Object.defineProperty(exports, "verifyQuoteHashOnChain", { enumerable: true, get: function () { return verifyQuoteOnChain_1.verifyQuoteHashOnChain; } });
+var ProviderPolicy_1 = require("./ProviderPolicy");
+Object.defineProperty(exports, "ProviderPolicyEngine", { enumerable: true, get: function () { return ProviderPolicy_1.ProviderPolicyEngine; } });
+Object.defineProperty(exports, "parseProviderTtl", { enumerable: true, get: function () { return ProviderPolicy_1.parseTtl; } });
+var ProviderOrchestrator_1 = require("./ProviderOrchestrator");
+Object.defineProperty(exports, "ProviderOrchestrator", { enumerable: true, get: function () { return ProviderOrchestrator_1.ProviderOrchestrator; } });
 //# sourceMappingURL=index.js.map

package/dist/negotiation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/negotiation/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAGvB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/negotiation/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAGvB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAS1B,2DAA8D;AAArD,4HAAA,sBAAsB,OAAA;AAK/B,mDAAsF;AAA7E,sHAAA,oBAAoB,OAAA;AAAE,kHAAA,QAAQ,OAAoB;AAG3D,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}

package/dist/negotiation/verifyQuoteOnChain.d.ts

@@ -0,0 +1,58 @@
+/**
+ * verifyQuoteOnChain — cross-reference a received QuoteMessage against
+ * the hash a provider committed on-chain via `transitionState(QUOTED, …)`.
+ *
+ * AIP-2.1 §3.6 (legacy compatibility). Two matchers, tried in order:
+ *
+ *   1. `'aip2'`   — canonical EIP-712 hash: keccak256(canonicalJson(
+ *                   QuoteMessage minus signature)). This is what
+ *                   AIP-2.1-compliant providers emit.
+ *   2. `'legacy'` — ad-hoc hash from Agent.ts:1035-1038 (the
+ *                   counter-offer pricing path that shipped before the
+ *                   formal AIP-2.1 submitQuote runtime method). Hash is:
+ *                     keccak256(JSON.stringify({
+ *                       txId, providerIdealPrice, actualEscrow, provider
+ *                     }))
+ *                   where `providerIdealPrice` is the provider's intended
+ *                   sell price in USDC base units (string), `actualEscrow`
+ *                   is tx.amount (the buyer-offered amount), and `provider`
+ *                   is the provider's EOA address. This path is used
+ *                   only when the SDK-authored hash can't be reconstructed
+ *                   (e.g. pre-AIP-2.1 agents still running).
+ *
+ * Both paths return a `{ source, match: true }` tagged result so the
+ * orchestrator + telemetry can see how many transactions are still
+ * coming through the legacy path. The legacy matcher is
+ * observability-tagged technical debt — planned removal in 2 SDK
+ * minor releases per the AIP-2.1 migration schedule.
+ *
+ * @module negotiation/verifyQuoteOnChain
+ */
+import { QuoteMessage } from '../builders/QuoteBuilder';
+export type VerifySource = 'aip2' | 'legacy';
+export interface VerifyOnChainResult {
+    match: boolean;
+    /** Which matcher accepted the hash. Only set when `match === true`. */
+    source?: VerifySource;
+    /** Expected hash per the canonical matcher, for debugging mismatches. */
+    canonicalHash?: string;
+    /** Expected legacy hash (same purpose). */
+    legacyHash?: string;
+}
+/**
+ * Cross-reference an off-chain QuoteMessage against the hash stored on
+ * chain in `tx.metadata` (or equivalent — MockTransaction.quoteHash).
+ *
+ * Passing `providerAddress` and `actualEscrow` enables the legacy
+ * fallback. Omit them on fresh deployments where legacy is impossible.
+ *
+ * @param quote          - signed QuoteMessage received off-chain
+ * @param onChainHash    - hash committed on-chain at QUOTED
+ * @param providerAddress - provider's EOA address (needed for legacy)
+ * @param actualEscrow   - tx.amount at QUOTED time (needed for legacy)
+ */
+export declare function verifyQuoteHashOnChain(quote: QuoteMessage, onChainHash: string, opts?: {
+    providerAddress?: string;
+    actualEscrow?: string;
+}): VerifyOnChainResult;
+//# sourceMappingURL=verifyQuoteOnChain.d.ts.map

package/dist/negotiation/verifyQuoteOnChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyQuoteOnChain.d.ts","sourceRoot":"","sources":["../../src/negotiation/verifyQuoteOnChain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAgB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAItE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IACJ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,mBAAmB,CAiCrB"}