@agirails/sdk 3.3.0 → 3.5.3

package/dist/negotiation/ProviderPolicy.js

@@ -0,0 +1,259 @@
+"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 what to do with a buyer's counter-offer (3.5.0 multi-round).
+     *
+     *   accept  — counter ≥ floor: take the deal
+     *   requote — counter < floor AND counter_strategy === 'concede' AND
+     *             requotesUsed < max_requotes: send a new quote at the
+     *             concession price (between last quote and floor)
+     *   reject  — anything else (walk strategy, or requote budget spent)
+     *
+     * `lastQuoteAmountBaseUnits` is the amount we most recently quoted to
+     * this txId — the concession baseline. On the FIRST counter it equals
+     * the counter's `quoteAmount` field (provider's original quote);
+     * on subsequent rounds it equals the orchestrator's most recent
+     * re-quote.
+     *
+     * `requotesUsed` is how many re-quotes we've already sent for this
+     * txId. Pass 0 on first call.
+     *
+     * All arithmetic uses BigInt on base units — no float drift.
+     */
+    evaluateCounter(counterAmountBaseUnits, lastQuoteAmountBaseUnits, requotesUsed) {
+        let counter;
+        try {
+            counter = BigInt(counterAmountBaseUnits);
+        }
+        catch {
+            return { decision: 'reject', reason: `Invalid counter amount: ${counterAmountBaseUnits}` };
+        }
+        if (counter >= this.floorBaseUnits) {
+            return {
+                decision: 'accept',
+                reason: `Counter ${formatFromBaseUnits(counter, this.currency)} meets our floor`,
+            };
+        }
+        // Below floor — consider concession.
+        const strategy = this.policy.counter_strategy ?? 'walk';
+        if (strategy === 'walk') {
+            return {
+                decision: 'reject',
+                reason: `Counter ${formatFromBaseUnits(counter, this.currency)} below floor; counter_strategy=walk`,
+            };
+        }
+        const maxRequotes = this.policy.max_requotes ?? 2;
+        if (requotesUsed >= maxRequotes) {
+            return {
+                decision: 'reject',
+                reason: `Counter below floor and requote budget exhausted (${requotesUsed}/${maxRequotes})`,
+            };
+        }
+        // Concede: new quote = last - (last - floor) * pct / 100.
+        let lastQuote;
+        try {
+            lastQuote = BigInt(lastQuoteAmountBaseUnits);
+        }
+        catch {
+            return { decision: 'reject', reason: `Invalid lastQuoteAmount: ${lastQuoteAmountBaseUnits}` };
+        }
+        if (lastQuote <= this.floorBaseUnits) {
+            // Already at floor — nothing to concede.
+            return {
+                decision: 'reject',
+                reason: `Cannot concede: last quote ${formatFromBaseUnits(lastQuote, this.currency)} already at/below floor`,
+            };
+        }
+        const pct = this.policy.concede_pct ?? 30;
+        const safePct = pct < 1 ? 1 : pct > 99 ? 99 : pct;
+        const gap = lastQuote - this.floorBaseUnits;
+        const concession = (gap * BigInt(safePct)) / 100n;
+        let newQuote = lastQuote - concession;
+        // Defensive: never go below floor regardless of math.
+        if (newQuote < this.floorBaseUnits)
+            newQuote = this.floorBaseUnits;
+        return {
+            decision: 'requote',
+            amountBaseUnits: newQuote.toString(),
+            reason: `Conceding ${safePct}% from ${formatFromBaseUnits(lastQuote, this.currency)} toward floor → ${formatFromBaseUnits(newQuote, this.currency)} (round ${requotesUsed + 1}/${maxRequotes})`,
+        };
+    }
+    /** 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":";AAAA;;;;;;;;;;;GAWG;;;AAuHH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,2EAA2E;AAC3E,MAAM,kBAAkB,GAA2B;IACjD,IAAI,EAAE,QAAU;CACjB,CAAC;AACF,6DAA6D;AAC7D,MAAM,uBAAuB,GAA2B;IACtD,IAAI,EAAE,MAAO;CACd,CAAC;AACF,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAExC,oEAAoE;AACpE,SAAS,WAAW,CAAC,MAAc,EAAE,QAAgB;IACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IAClE,kEAAkE;IAClE,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,mEAAmE;AACnE,SAAS,mBAAmB,CAAC,SAAiB,EAAE,QAAgB;IAC9D,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,SAAS,aAAa,CAAC;IAC9C,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACjC,MAAM,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5F,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;AACxD,CAAC;AAED,MAAa,oBAAoB;IAM/B,YAAY,MAAsB;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC;QACxD,MAAM,WAAW,GAAG,uBAAuB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,iEAAiE;QACjE,4CAA4C;QAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEzE,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0BAA0B,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,6BAA6B,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,CAC3I,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,uBAAuB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,sCAAsC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAC7I,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAoB;QAC3B,MAAM,UAAU,GAA8B,EAAE,CAAC;QAEjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,qBAAqB;gBAC3B,MAAM,EAAE,2BAA2B,GAAG,CAAC,WAAW,kBAAkB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACtG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/D,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,mBAAmB;gBACzB,MAAM,EAAE,cAAc,GAAG,CAAC,QAAQ,iBAAiB,IAAI,CAAC,QAAQ,EAAE;aACnE,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,gEAAgE;QAChE,4CAA4C;QAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,iBAAiB,GAAG,CAAC,IAAI,iCAAiC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,GAAG;aAC7G,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,qBAAqB,GAAG,CAAC,QAAQ,EAAE;aAC5C,CAAC,CAAC;YACH,UAAU,GAAG,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,kBAAkB,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,oBAAoB,mBAAmB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;aACtJ,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,4BAA4B,CAAC;QAC5F,IAAI,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,kBAAkB,EAAE,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,oBAAoB;gBAC1B,MAAM,EAAE,uBAAuB,GAAG,CAAC,QAAQ,GAAG,GAAG,aAAa,kBAAkB,GAAG;aACpF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACxC,CAAC;QAED,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QACtF,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QAExF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,mCAAmC,EAAE,aAAa,CAAC,QAAQ,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CACb,sBAA8B,EAC9B,wBAAgC,EAChC,YAAoB;QAEpB,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,2BAA2B,sBAAsB,EAAE,EAAE,CAAC;QAC7F,CAAC;QACD,IAAI,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,WAAW,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB;aACjF,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC;QACxD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,WAAW,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,qCAAqC;aACpG,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;QAClD,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;YAChC,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,qDAAqD,YAAY,IAAI,WAAW,GAAG;aAC5F,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,4BAA4B,wBAAwB,EAAE,EAAE,CAAC;QAChG,CAAC;QACD,IAAI,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,yCAAyC;YACzC,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,8BAA8B,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,yBAAyB;aAC7G,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,MAAM,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC;QAC5C,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;QAClD,IAAI,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;QACtC,sDAAsD;QACtD,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc;YAAE,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACnE,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,eAAe,EAAE,QAAQ,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,aAAa,OAAO,UAAU,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,YAAY,GAAG,CAAC,IAAI,WAAW,GAAG;SAChM,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,IAAI,eAAe;QACjB,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,4DAA4D;IAC5D,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,6DAA6D;IAC7D,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC;IACjD,CAAC;CACF;AAxND,oDAwNC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,sCAAsC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC;AAVD,4BAUC"}

package/dist/negotiation/RelayChannel.d.ts

@@ -0,0 +1,59 @@
+/**
+ * RelayChannel — default NegotiationChannel impl, polls agirails.app.
+ *
+ * Both buyer and provider can use this — neither needs to host an HTTP
+ * endpoint. Messages are POSTed to and pulled from agirails.app's
+ * negotiation relay (see Protocol/aips/AIP-2.1.md §6).
+ *
+ * Verification model: relay stores messages opaquely (just bytes +
+ * cursor + indexes). The receiving SDK runs full EIP-712 verify
+ * BEFORE delivering to the orchestrator subscriber, so a malicious
+ * relay or intercepted POST can at worst spam the subscriber's
+ * deduper with junk that fails verify on the receive side.
+ *
+ * Polling cadence: 1500ms by default. Conservative: short enough that
+ * negotiations feel snappy (< 1.5s p95 latency per round trip), long
+ * enough that 100 idle subscriptions don't burn a CPU. Tunable via
+ * `pollIntervalMs` for tests.
+ *
+ * @module negotiation/RelayChannel
+ */
+import { NegotiationChannel, NegotiationMessage, Subscription, DeliveredMessage } from './NegotiationChannel';
+export interface RelayChannelConfig {
+    /** Base URL of the relay. Default: https://agirails.app */
+    baseUrl?: string;
+    /**
+     * Kernel address per chainId — needed for EIP-712 verify on receive.
+     * If a message arrives for a chainId not in this map, it's dropped
+     * (channel logs + skips delivery).
+     */
+    kernelAddressByChainId: Record<number, string>;
+    /** Poll interval in ms. Default: 1500. Tests use 50. */
+    pollIntervalMs?: number;
+    /** fetch override (Node 18+ has it built-in; injected for tests). */
+    fetchImpl?: typeof fetch;
+    /** Logger. Default: noop. */
+    log?: (level: 'info' | 'warn' | 'error', msg: string, ctx?: unknown) => void;
+}
+export declare class RelayChannel implements NegotiationChannel {
+    private readonly baseUrl;
+    private readonly kernelAddressByChainId;
+    private readonly pollIntervalMs;
+    private readonly fetchImpl;
+    private readonly log;
+    private readonly quoteVerifier;
+    private readonly counterVerifier;
+    private readonly counterAcceptVerifier;
+    private readonly subscriptions;
+    constructor(cfg: RelayChannelConfig);
+    post(txId: string, envelope: NegotiationMessage): Promise<void>;
+    subscribeTxId(txId: string, onMessage: (delivered: DeliveredMessage) => void | Promise<void>): Subscription;
+    subscribeAgent(agentDid: string, onMessage: (txId: string, delivered: DeliveredMessage) => void | Promise<void>): Subscription;
+    close(): Promise<void>;
+    /**
+     * Verify + dedup + dispatch one item. Errors in the subscriber callback
+     * are caught + logged so a single bad handler doesn't kill the loop.
+     */
+    private deliver;
+}
+//# sourceMappingURL=RelayChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RelayChannel.d.ts","sourceRoot":"","sources":["../../src/negotiation/RelayChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAIjB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9E;AAmBD,qBAAa,YAAa,YAAW,kBAAkB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyC;IAE7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA8B;IAEpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;gBAE1C,GAAG,EAAE,kBAAkB;IAQ7B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC/D,YAAY;IA6Cf,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC7E,YAAY;IAyCT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;;OAGG;YACW,OAAO;CAkDtB"}

package/dist/negotiation/RelayChannel.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * RelayChannel — default NegotiationChannel impl, polls agirails.app.
+ *
+ * Both buyer and provider can use this — neither needs to host an HTTP
+ * endpoint. Messages are POSTed to and pulled from agirails.app's
+ * negotiation relay (see Protocol/aips/AIP-2.1.md §6).
+ *
+ * Verification model: relay stores messages opaquely (just bytes +
+ * cursor + indexes). The receiving SDK runs full EIP-712 verify
+ * BEFORE delivering to the orchestrator subscriber, so a malicious
+ * relay or intercepted POST can at worst spam the subscriber's
+ * deduper with junk that fails verify on the receive side.
+ *
+ * Polling cadence: 1500ms by default. Conservative: short enough that
+ * negotiations feel snappy (< 1.5s p95 latency per round trip), long
+ * enough that 100 idle subscriptions don't burn a CPU. Tunable via
+ * `pollIntervalMs` for tests.
+ *
+ * @module negotiation/RelayChannel
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayChannel = void 0;
+const QuoteBuilder_1 = require("../builders/QuoteBuilder");
+const CounterOfferBuilder_1 = require("../builders/CounterOfferBuilder");
+const CounterAcceptBuilder_1 = require("../builders/CounterAcceptBuilder");
+const NegotiationChannel_1 = require("./NegotiationChannel");
+const DEFAULT_BASE_URL = 'https://agirails.app';
+const DEFAULT_POLL_MS = 1500;
+class RelayChannel {
+    constructor(cfg) {
+        // Verifier instances are signer-independent (verify-only) — see CounterOfferBuilder/CounterAcceptBuilder.
+        this.quoteVerifier = new QuoteBuilder_1.QuoteBuilder();
+        this.counterVerifier = new CounterOfferBuilder_1.CounterOfferBuilder();
+        this.counterAcceptVerifier = new CounterAcceptBuilder_1.CounterAcceptBuilder();
+        this.subscriptions = new Set();
+        this.baseUrl = (cfg.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.kernelAddressByChainId = cfg.kernelAddressByChainId;
+        this.pollIntervalMs = cfg.pollIntervalMs ?? DEFAULT_POLL_MS;
+        this.fetchImpl = cfg.fetchImpl ?? fetch;
+        this.log = cfg.log ?? (() => undefined);
+    }
+    async post(txId, envelope) {
+        const url = `${this.baseUrl}/api/v1/negotiations/${encodeURIComponent(txId)}/messages`;
+        const res = await this.fetchImpl(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(envelope),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Relay POST ${res.status}: ${body.slice(0, 200)}`);
+        }
+    }
+    subscribeTxId(txId, onMessage) {
+        const state = { cursor: null, delivered: new Set(), cancelled: false };
+        this.subscriptions.add(state);
+        const pollOnce = async () => {
+            if (state.cancelled)
+                return;
+            try {
+                const url = new URL(`${this.baseUrl}/api/v1/negotiations/${encodeURIComponent(txId)}/messages`);
+                if (state.cursor)
+                    url.searchParams.set('after', state.cursor);
+                const res = await this.fetchImpl(url.toString());
+                if (res.ok) {
+                    const body = await res.json();
+                    for (const item of body.messages ?? []) {
+                        await this.deliver(item, state, (d) => onMessage(d));
+                        state.cursor = item.cursor;
+                    }
+                }
+                else {
+                    this.log('warn', `Relay GET ${res.status} for tx ${txId.slice(0, 12)}…`);
+                }
+            }
+            catch (err) {
+                this.log('warn', `Relay poll error for tx ${txId.slice(0, 12)}…`, err);
+            }
+            if (!state.cancelled) {
+                state.timer = setTimeout(pollOnce, this.pollIntervalMs);
+                // Allow process to exit even if subscription is still armed
+                // (matches Node's `unref()` convention; no-op in browsers).
+                if (typeof state.timer.unref === 'function') {
+                    state.timer.unref();
+                }
+            }
+        };
+        // Kick off first poll on next tick so subscribers can attach handlers
+        // synchronously before the first delivery attempt.
+        state.timer = setTimeout(pollOnce, 0);
+        return {
+            unsubscribe: () => {
+                state.cancelled = true;
+                if (state.timer)
+                    clearTimeout(state.timer);
+                this.subscriptions.delete(state);
+            },
+        };
+    }
+    subscribeAgent(agentDid, onMessage) {
+        const state = { cursor: null, delivered: new Set(), cancelled: false };
+        this.subscriptions.add(state);
+        const pollOnce = async () => {
+            if (state.cancelled)
+                return;
+            try {
+                const url = new URL(`${this.baseUrl}/api/v1/negotiations/inbox/${encodeURIComponent(agentDid)}`);
+                if (state.cursor)
+                    url.searchParams.set('after', state.cursor);
+                const res = await this.fetchImpl(url.toString());
+                if (res.ok) {
+                    const body = await res.json();
+                    for (const item of body.messages ?? []) {
+                        await this.deliver(item, state, (d) => onMessage(item.txId, d));
+                        state.cursor = item.cursor;
+                    }
+                }
+                else {
+                    this.log('warn', `Relay agent-inbox GET ${res.status} for ${agentDid}`);
+                }
+            }
+            catch (err) {
+                this.log('warn', `Relay agent-inbox poll error for ${agentDid}`, err);
+            }
+            if (!state.cancelled) {
+                state.timer = setTimeout(pollOnce, this.pollIntervalMs);
+                if (typeof state.timer.unref === 'function') {
+                    state.timer.unref();
+                }
+            }
+        };
+        state.timer = setTimeout(pollOnce, 0);
+        return {
+            unsubscribe: () => {
+                state.cancelled = true;
+                if (state.timer)
+                    clearTimeout(state.timer);
+                this.subscriptions.delete(state);
+            },
+        };
+    }
+    async close() {
+        for (const state of this.subscriptions) {
+            state.cancelled = true;
+            if (state.timer)
+                clearTimeout(state.timer);
+        }
+        this.subscriptions.clear();
+    }
+    // --------------------------------------------------------------------------
+    // Internals
+    // --------------------------------------------------------------------------
+    /**
+     * Verify + dedup + dispatch one item. Errors in the subscriber callback
+     * are caught + logged so a single bad handler doesn't kill the loop.
+     */
+    async deliver(item, state, invoke) {
+        // Dedup by signature (every signed message has a unique sig per nonce).
+        // CRITICAL: dedup-check BEFORE verify, but only ADD to dedup-set AFTER
+        // verify SUCCEEDS. Otherwise an attacker who can POST to the relay
+        // (it's permissionless) can craft a tampered envelope carrying a
+        // valid signature — verify fails, message is dropped, but the sig
+        // is now in the dedup-set; when the legitimate message later
+        // arrives it gets silently dropped as "duplicate". (P0 audit finding.)
+        const sig = item.envelope.message.signature;
+        if (state.delivered.has(sig))
+            return;
+        // Verify EIP-712 against the kernel address for this chainId.
+        const chainId = item.envelope.message.chainId;
+        const kernelAddress = this.kernelAddressByChainId[chainId];
+        if (!kernelAddress) {
+            this.log('warn', `Dropping message for unknown chainId ${chainId}`);
+            return;
+        }
+        try {
+            if ((0, NegotiationChannel_1.isQuoteEnvelope)(item.envelope)) {
+                await this.quoteVerifier.verify(item.envelope.message, kernelAddress);
+            }
+            else if ((0, NegotiationChannel_1.isCounterOfferEnvelope)(item.envelope)) {
+                await this.counterVerifier.verify(item.envelope.message, kernelAddress);
+            }
+            else if ((0, NegotiationChannel_1.isCounterAcceptEnvelope)(item.envelope)) {
+                await this.counterAcceptVerifier.verify(item.envelope.message, kernelAddress);
+            }
+        }
+        catch (err) {
+            this.log('warn', `Dropping message that failed verify`, err);
+            return;
+        }
+        // Verify passed → safe to dedup. From here on the same sig will not
+        // re-deliver even on poll-loop overlap.
+        state.delivered.add(sig);
+        const delivered = {
+            cursor: item.cursor,
+            receivedAt: item.receivedAt ?? Math.floor(Date.now() / 1000),
+            envelope: item.envelope,
+        };
+        try {
+            await invoke(delivered);
+        }
+        catch (err) {
+            this.log('error', 'Subscriber callback threw', err);
+        }
+    }
+}
+exports.RelayChannel = RelayChannel;
+//# sourceMappingURL=RelayChannel.js.map

package/dist/negotiation/RelayChannel.js.map

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