@agirails/sdk 3.4.1 → 3.5.3

package/dist/negotiation/ProviderOrchestrator.d.ts

@@ -1,44 +1,64 @@
 /**
- * ProviderOrchestrator — autonomous provider-side quote flow.
+ * ProviderOrchestrator — autonomous provider-side negotiation 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.
+ * Two responsibilities:
  *
- * 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.
+ *   1. Accept an incoming request → decide whether to quote → if yes,
+ *      build + sign a QuoteMessage, anchor on-chain via submitQuote,
+ *      post it on the NegotiationChannel for the buyer.
+ *
+ *   2. (3.5.0) Run a long-lived `start()` listener on the channel:
+ *      every counter that arrives is evaluated against ProviderPolicy;
+ *      based on `counter_strategy` we either auto-accept (build + post
+ *      CounterAcceptMessage), auto-requote (build + post a new
+ *      QuoteMessage with the conceded amount), or walk (log + drop).
+ *
+ * Symmetric to BuyerOrchestrator's channel-driven multi-round loop —
+ * together they implement the full AIP-2.1 §6 negotiation protocol
+ * without either party needing to host an HTTP endpoint.
  *
  * @module negotiation/ProviderOrchestrator
- * @see Protocol/aips/AIP-2.1-DRAFT.md §5.2
+ * @see Protocol/aips/AIP-2.1.md §5.2 (provider quote flow)
+ * @see Protocol/aips/AIP-2.1.md §6 (NegotiationChannel)
  */
 import { Signer } from 'ethers';
 import { IACTPRuntime } from '../runtime/IACTPRuntime';
 import { QuoteMessage } from '../builders/QuoteBuilder';
 import { CounterOfferMessage } from '../builders/CounterOfferBuilder';
 import { NonceManager } from '../utils/NonceManager';
-import { QuoteChannelClient } from '../transport/QuoteChannel';
+import { NegotiationChannel, Subscription } from './NegotiationChannel';
 import { ProviderPolicy, IncomingRequest } from './ProviderPolicy';
 export interface ProviderOrchestratorConfig {
     policy: ProviderPolicy;
     runtime: IACTPRuntime;
-    /** Provider's EOA signer — signs QuoteMessages. */
+    /** Provider's EOA signer — signs QuoteMessages + CounterAcceptMessages. */
     signer: Signer;
-    /** Kernel address the signer will use for EIP-712 domain. */
+    /** Kernel address for EIP-712 domain. */
     kernelAddress: string;
-    /** Chain id the signer is on (84532 or 8453). */
+    /** Chain id (84532 or 8453). */
     chainId: number;
     /**
-     * Nonce manager for provider's quote messages. Defaults to an
-     * in-memory manager. Production providers should pass a persistent
-     * one so restarts don't replay nonces (NonceManager has a FileBased
-     * variant).
+     * Provider's DID — used for `subscribeAgent` filter on the channel
+     * AND as the `provider` field on outbound QuoteMessage /
+     * CounterAcceptMessage. Required for `start()`.
+     */
+    providerDID?: string;
+    /**
+     * Persistent nonce manager. Defaults to in-memory (fine for dev;
+     * production should pass a FileBased one so restarts don't replay).
      */
     nonceManager?: NonceManager;
-    /** Channel client for off-chain delivery. Defaults to a fresh one. */
-    channel?: QuoteChannelClient;
+    /**
+     * Negotiation channel. Required for `start()` long-running mode.
+     * Optional for the one-shot `quote()` method (caller may handle
+     * delivery via direct HTTP / IPFS / etc).
+     */
+    negotiationChannel?: NegotiationChannel;
+    /**
+     * Logger for observability. Default: noop. `actp agent` wires this
+     * to its terminal Output.
+     */
+    log?: (level: 'info' | 'warn' | 'error', msg: string) => void;
 }
 export type QuoteDecision = {
     action: 'quote';
@@ -55,9 +75,9 @@ export type QuoteDecision = {
 };
 export interface QuoteResult {
     decision: QuoteDecision;
-    /** Set when action === 'quote' and both on-chain + off-chain calls succeeded. */
+    /** Set when action === 'quote' and on-chain anchoring succeeded. */
     quote?: QuoteMessage;
-    /** Set when action === 'quote' and the off-chain POST failed (on-chain still succeeded — caller should retry channel only). */
+    /** Set when channel post failed (on-chain still succeeded). */
     channelError?: string;
 }
 export type CounterDecision = {
@@ -66,6 +86,10 @@ export type CounterDecision = {
 } | {
     action: 'reject';
     reason: string;
+} | {
+    action: 'requote';
+    amountBaseUnits: string;
+    reason: string;
 };
 export declare class ProviderOrchestrator {
     private readonly policy;
@@ -74,35 +98,61 @@ export declare class ProviderOrchestrator {
     private readonly signer;
     private readonly kernelAddress;
     private readonly chainId;
+    private readonly providerDID?;
     private readonly nonceManager;
-    private readonly channel;
+    private readonly negotiationChannel?;
     private readonly quoteBuilder;
     private readonly counterVerifier;
+    private readonly counterAcceptBuilder;
+    private readonly log;
+    /** Per-tx state for the multi-round counter listener. */
+    private readonly txStates;
+    /** Active channel subscription opened by `start()`. */
+    private channelSubscription?;
     constructor(cfg: ProviderOrchestratorConfig);
     /**
-     * Decide whether to quote. Does NOT touch the chain — pure policy.
-     * Use `quote()` below to act on the decision.
+     * Decide whether to quote. Pure policy — no chain, no channel.
      */
     evaluateRequest(req: IncomingRequest): QuoteDecision;
     /**
      * Full quote flow: evaluate → build signed QuoteMessage → submit
-     * on-chain → POST to buyer's endpoint.
+     * on-chain → post on negotiationChannel.
+     *
+     * Channel post failure is non-fatal: on-chain anchor succeeded so
+     * buyer can still observe the quote, just won't see the off-chain
+     * signed body. Caller can retry channel post separately.
+     */
+    quote(req: IncomingRequest, providerDID: string): Promise<QuoteResult>;
+    /**
+     * Subscribe to the negotiation channel and auto-respond to incoming
+     * counter-offers per `counter_strategy`. Idempotent — calling start()
+     * twice replaces the previous subscription.
+     *
+     * Returns a Subscription so the caller can stop the daemon cleanly.
      *
-     * 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".
+     * @throws if `negotiationChannel` or `providerDID` was not set in config.
      */
-    quote(req: IncomingRequest, providerDID: string, consumerEndpoint?: string): Promise<QuoteResult>;
+    start(): Promise<Subscription>;
     /**
-     * Verify + evaluate a buyer counter-offer. Returns the decision;
-     * does NOT send any response — Phase 3 wires the response path.
+     * Stop the active channel subscription if any. Idempotent.
+     */
+    stop(): void;
+    /**
+     * Verify + evaluate a buyer counter-offer. Returns the decision
+     * (accept / reject / requote with concession amount). Does NOT send
+     * any response — caller drives the next step. Use `start()` for
+     * autonomous operation.
+     *
+     * `lastQuoteAmountBaseUnits` — provider's most recent quote amount
+     * for this tx. On the first counter pass `counter.quoteAmount`.
+     *
+     * `requotesUsed` — defaults to 0; pass the real count for multi-round.
      *
      * @throws if the counter signature / band / expiry fails verify.
      */
-    evaluateCounter(counter: CounterOfferMessage): Promise<CounterDecision>;
+    evaluateCounter(counter: CounterOfferMessage, lastQuoteAmountBaseUnits?: string, requotesUsed?: number): Promise<CounterDecision>;
     /** Read-only policy accessor for UIs and tests. */
     getPolicy(): ProviderPolicy;
+    private _handleIncomingCounter;
 }
 //# sourceMappingURL=ProviderOrchestrator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ProviderOrchestrator.d.ts","sourceRoot":"","sources":["../../src/negotiation/ProviderOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAgB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAEL,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAwB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,cAAc,EAEd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sEAAsE;IACtE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GACrB;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,iFAAiF;IACjF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+HAA+H;IAC/H,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzC,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;gBAE1C,GAAG,EAAE,0BAA0B;IAe3C;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa;IAgBpD;;;;;;;;;OASG;IACG,KAAK,CACT,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC;IAiDvB;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ7E,mDAAmD;IACnD,SAAS,IAAI,cAAc;CAG5B"}
+{"version":3,"file":"ProviderOrchestrator.d.ts","sourceRoot":"","sources":["../../src/negotiation/ProviderOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAgB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAEL,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,YAAY,EAAwB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EAEd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,MAAM,aAAa,GACrB;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,oEAAoE;IACpE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgBnE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiD;IAErE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,uDAAuD;IACvD,OAAO,CAAC,mBAAmB,CAAC,CAAe;gBAE/B,GAAG,EAAE,0BAA0B;IAoB3C;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa;IAgBpD;;;;;;;OAOG;IACG,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA8C5E;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAgCpC;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;;;;;;;;;;;OAYG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,EAC5B,wBAAwB,CAAC,EAAE,MAAM,EACjC,YAAY,SAAI,GACf,OAAO,CAAC,eAAe,CAAC;IAU3B,mDAAmD;IACnD,SAAS,IAAI,cAAc;YAQb,sBAAsB;CAiFrC"}

package/dist/negotiation/ProviderOrchestrator.js

@@ -1,48 +1,61 @@
 "use strict";
 /**
- * ProviderOrchestrator — autonomous provider-side quote flow.
+ * ProviderOrchestrator — autonomous provider-side negotiation 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.
+ * Two responsibilities:
  *
- * 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.
+ *   1. Accept an incoming request → decide whether to quote → if yes,
+ *      build + sign a QuoteMessage, anchor on-chain via submitQuote,
+ *      post it on the NegotiationChannel for the buyer.
+ *
+ *   2. (3.5.0) Run a long-lived `start()` listener on the channel:
+ *      every counter that arrives is evaluated against ProviderPolicy;
+ *      based on `counter_strategy` we either auto-accept (build + post
+ *      CounterAcceptMessage), auto-requote (build + post a new
+ *      QuoteMessage with the conceded amount), or walk (log + drop).
+ *
+ * Symmetric to BuyerOrchestrator's channel-driven multi-round loop —
+ * together they implement the full AIP-2.1 §6 negotiation protocol
+ * without either party needing to host an HTTP endpoint.
  *
  * @module negotiation/ProviderOrchestrator
- * @see Protocol/aips/AIP-2.1-DRAFT.md §5.2
+ * @see Protocol/aips/AIP-2.1.md §5.2 (provider quote flow)
+ * @see Protocol/aips/AIP-2.1.md §6 (NegotiationChannel)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProviderOrchestrator = void 0;
 const QuoteBuilder_1 = require("../builders/QuoteBuilder");
 const CounterOfferBuilder_1 = require("../builders/CounterOfferBuilder");
+const CounterAcceptBuilder_1 = require("../builders/CounterAcceptBuilder");
 const NonceManager_1 = require("../utils/NonceManager");
-const QuoteChannel_1 = require("../transport/QuoteChannel");
+const NegotiationChannel_1 = require("./NegotiationChannel");
 const ProviderPolicy_1 = require("./ProviderPolicy");
 // ============================================================================
 // Orchestrator
 // ============================================================================
 class ProviderOrchestrator {
     constructor(cfg) {
+        /** Per-tx state for the multi-round counter listener. */
+        this.txStates = new Map();
         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.providerDID = cfg.providerDID;
         this.nonceManager = cfg.nonceManager ?? new NonceManager_1.InMemoryNonceManager();
-        this.channel = cfg.channel ?? new QuoteChannel_1.QuoteChannelClient();
+        this.negotiationChannel = cfg.negotiationChannel;
+        this.log = cfg.log ?? (() => undefined);
         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);
+        this.counterVerifier = new CounterOfferBuilder_1.CounterOfferBuilder(); // verify-only
+        this.counterAcceptBuilder = new CounterAcceptBuilder_1.CounterAcceptBuilder(this.signer, this.nonceManager);
     }
+    // --------------------------------------------------------------------------
+    // One-shot quote (caller-driven)
+    // --------------------------------------------------------------------------
     /**
-     * Decide whether to quote. Does NOT touch the chain — pure policy.
-     * Use `quote()` below to act on the decision.
+     * Decide whether to quote. Pure policy — no chain, no channel.
      */
     evaluateRequest(req) {
         const result = this.policyEngine.evaluate(req);
@@ -61,27 +74,19 @@ class ProviderOrchestrator {
     }
     /**
      * Full quote flow: evaluate → build signed QuoteMessage → submit
-     * on-chain → POST to buyer's endpoint.
+     * on-chain → post on negotiationChannel.
      *
-     * 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".
+     * Channel post failure is non-fatal: on-chain anchor succeeded so
+     * buyer can still observe the quote, just won't see the off-chain
+     * signed body. Caller can retry channel post separately.
      */
-    async quote(req, providerDID, consumerEndpoint) {
+    async quote(req, providerDID) {
         const decision = this.evaluateRequest(req);
-        if (decision.action === 'skip') {
+        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 decimals = currency.toUpperCase() === 'USDC' ? 6 : 6;
         const quote = await this.quoteBuilder.build({
             txId: req.txId,
             provider: providerDID,
@@ -95,42 +100,187 @@ class ProviderOrchestrator {
             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) {
+        if (this.negotiationChannel) {
             try {
-                await this.channel.sendQuote(consumerEndpoint, quote);
+                await this.negotiationChannel.post(req.txId, { type: 'agirails.quote.v1', message: quote });
             }
             catch (err) {
-                return {
-                    decision,
-                    quote,
-                    channelError: err instanceof Error ? err.message : String(err),
-                };
+                return { decision, quote, channelError: err instanceof Error ? err.message : String(err) };
             }
         }
+        // Seed per-tx state so a follow-up counter is evaluated with the
+        // right `lastQuote` baseline if the listener is running.
+        this.txStates.set(req.txId, {
+            lastQuote: quote,
+            requotesUsed: 0,
+            consumerDID: req.consumer,
+        });
         return { decision, quote };
     }
+    // --------------------------------------------------------------------------
+    // Long-running listener (channel-driven, multi-round)
+    // --------------------------------------------------------------------------
     /**
-     * Verify + evaluate a buyer counter-offer. Returns the decision;
-     * does NOT send any response — Phase 3 wires the response path.
+     * Subscribe to the negotiation channel and auto-respond to incoming
+     * counter-offers per `counter_strategy`. Idempotent — calling start()
+     * twice replaces the previous subscription.
+     *
+     * Returns a Subscription so the caller can stop the daemon cleanly.
+     *
+     * @throws if `negotiationChannel` or `providerDID` was not set in config.
+     */
+    async start() {
+        if (!this.negotiationChannel) {
+            throw new Error('ProviderOrchestrator.start() requires negotiationChannel in config');
+        }
+        if (!this.providerDID) {
+            throw new Error('ProviderOrchestrator.start() requires providerDID in config');
+        }
+        // Replace any prior subscription.
+        if (this.channelSubscription) {
+            this.channelSubscription.unsubscribe();
+        }
+        const sub = this.negotiationChannel.subscribeAgent(this.providerDID, async (txId, delivered) => {
+            if (!(0, NegotiationChannel_1.isCounterOfferEnvelope)(delivered.envelope))
+                return;
+            try {
+                await this._handleIncomingCounter(txId, delivered.envelope.message);
+            }
+            catch (err) {
+                this.log('error', `Counter handler crashed for tx ${txId.slice(0, 12)}…: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        });
+        this.channelSubscription = sub;
+        this.log('info', `ProviderOrchestrator listening on channel for ${this.providerDID}`);
+        return {
+            unsubscribe: () => {
+                sub.unsubscribe();
+                this.channelSubscription = undefined;
+                this.log('info', 'ProviderOrchestrator stopped');
+            },
+        };
+    }
+    /**
+     * Stop the active channel subscription if any. Idempotent.
+     */
+    stop() {
+        if (this.channelSubscription) {
+            this.channelSubscription.unsubscribe();
+            this.channelSubscription = undefined;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Single-shot counter evaluation (tests + callers that want manual control)
+    // --------------------------------------------------------------------------
+    /**
+     * Verify + evaluate a buyer counter-offer. Returns the decision
+     * (accept / reject / requote with concession amount). Does NOT send
+     * any response — caller drives the next step. Use `start()` for
+     * autonomous operation.
+     *
+     * `lastQuoteAmountBaseUnits` — provider's most recent quote amount
+     * for this tx. On the first counter pass `counter.quoteAmount`.
+     *
+     * `requotesUsed` — defaults to 0; pass the real count for multi-round.
      *
      * @throws if the counter signature / band / expiry fails verify.
      */
-    async evaluateCounter(counter) {
+    async evaluateCounter(counter, lastQuoteAmountBaseUnits, requotesUsed = 0) {
         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.
+        const lastAmount = lastQuoteAmountBaseUnits ?? counter.quoteAmount;
+        const verdict = this.policyEngine.evaluateCounter(counter.counterAmount, lastAmount, requotesUsed);
+        if (verdict.decision === 'requote') {
+            return { action: 'requote', amountBaseUnits: verdict.amountBaseUnits, reason: verdict.reason };
+        }
         return { action: verdict.decision, reason: verdict.reason };
     }
     /** Read-only policy accessor for UIs and tests. */
     getPolicy() {
         return this.policy;
     }
+    // --------------------------------------------------------------------------
+    // Internals
+    // --------------------------------------------------------------------------
+    async _handleIncomingCounter(txId, counter) {
+        if (!this.providerDID || !this.negotiationChannel)
+            return;
+        // Look up per-tx state. If we never quoted (counter arrived without
+        // prior `quote()` call), we still process — `counter.quoteAmount`
+        // is the provider's quote per buyer's view, so we use it as baseline.
+        const state = this.txStates.get(txId) ?? {
+            lastQuote: null,
+            requotesUsed: 0,
+            consumerDID: counter.consumer,
+        };
+        const lastAmount = state.lastQuote?.quotedAmount ?? counter.quoteAmount;
+        let decision;
+        try {
+            decision = await this.evaluateCounter(counter, lastAmount, state.requotesUsed);
+        }
+        catch (err) {
+            this.log('warn', `[counter] tx=${txId.slice(0, 12)}… verify failed: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        this.log('info', `[counter] tx=${txId.slice(0, 12)}… counter=${counter.counterAmount} → ${decision.action}: ${decision.reason}`);
+        if (decision.action === 'accept') {
+            const accept = await this.counterAcceptBuilder.build({
+                txId,
+                provider: this.providerDID,
+                consumer: counter.consumer,
+                acceptedAmount: counter.counterAmount,
+                inReplyTo: new CounterOfferBuilder_1.CounterOfferBuilder().computeHash(counter),
+                chainId: this.chainId,
+                kernelAddress: this.kernelAddress,
+            });
+            await this.negotiationChannel.post(txId, { type: 'agirails.counteraccept.v1', message: accept });
+            this.txStates.delete(txId); // terminal
+            return;
+        }
+        if (decision.action === 'requote') {
+            const now = Math.floor(Date.now() / 1000);
+            const currency = this.policyEngine.policyCurrency;
+            const decimals = currency.toUpperCase() === 'USDC' ? 6 : 6;
+            // QuoteBuilder enforces `quotedAmount >= originalAmount` (AIP-2
+            // invariant: provider can't quote below buyer's offered amount).
+            // For re-quotes the buyer's original amount lives on-chain
+            // as tx.amount (set at createTransaction, immutable until
+            // acceptQuote). Fall back to counter.counterAmount if read
+            // fails (matches what buyer is willing to pay anyway).
+            let originalAmount = counter.counterAmount;
+            try {
+                const onChainTx = await this.runtime.getTransaction(txId);
+                if (onChainTx?.amount)
+                    originalAmount = String(onChainTx.amount);
+            }
+            catch {
+                /* fall back to counter.counterAmount */
+            }
+            const newQuote = await this.quoteBuilder.build({
+                txId,
+                provider: this.providerDID,
+                consumer: counter.consumer,
+                quotedAmount: decision.amountBaseUnits,
+                originalAmount,
+                maxPrice: counter.maxPrice,
+                currency,
+                decimals,
+                expiresAt: now + this.policyEngine.quoteTtlSeconds,
+                chainId: this.chainId,
+                kernelAddress: this.kernelAddress,
+            });
+            // Re-quotes are off-chain only — kernel forbids QUOTED → QUOTED.
+            await this.negotiationChannel.post(txId, { type: 'agirails.quote.v1', message: newQuote });
+            this.txStates.set(txId, {
+                lastQuote: newQuote,
+                requotesUsed: state.requotesUsed + 1,
+                consumerDID: counter.consumer,
+            });
+            return;
+        }
+        // reject — let buyer's TTL expire to CANCELLED. Drop state.
+        this.txStates.delete(txId);
+    }
 }
 exports.ProviderOrchestrator = ProviderOrchestrator;
 //# sourceMappingURL=ProviderOrchestrator.js.map

package/dist/negotiation/ProviderOrchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderOrchestrator.js","sourceRoot":"","sources":["../../src/negotiation/ProviderOrchestrator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIH,2DAAsE;AACtE,yEAGyC;AACzC,wDAA2E;AAC3E,4DAA+D;AAC/D,qDAI0B;AA+C1B,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAa,oBAAoB;IAY/B,YAAY,GAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,qCAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,mCAAoB,EAAE,CAAC;QACnE,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,iCAAkB,EAAE,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrE,uEAAuE;QACvE,+DAA+D;QAC/D,IAAI,CAAC,eAAe,GAAG,IAAI,yCAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACjF,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,GAAoB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzE,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,MAAM,CAAC,mCAAoC;YAC5D,MAAM,EAAE,oCAAoC,MAAM,CAAC,mCAAmC,aAAa;SACpG,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CACT,GAAoB,EACpB,WAAmB,EACnB,gBAAyB;QAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QAED,mEAAmE;QACnE,gEAAgE;QAChE,mEAAmE;QACnE,8DAA8D;QAC9D,+DAA+D;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;QAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oCAAoC;QAChG,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAC1C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,YAAY,EAAE,QAAQ,CAAC,eAAe;YACtC,cAAc,EAAE,GAAG,CAAC,aAAa;YACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe;YAClD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;QAEH,4DAA4D;QAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEhD,6DAA6D;QAC7D,iEAAiE;QACjE,kEAAkE;QAClE,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,QAAQ;oBACR,KAAK;oBACL,YAAY,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAA4B;QAChD,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACzE,6DAA6D;QAC7D,gDAAgD;QAChD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IAED,mDAAmD;IACnD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAhID,oDAgIC"}
+{"version":3,"file":"ProviderOrchestrator.js","sourceRoot":"","sources":["../../src/negotiation/ProviderOrchestrator.ts"],"names":[],"mappings":"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"}

package/dist/negotiation/ProviderPolicy.d.ts

@@ -48,6 +48,37 @@ export interface ProviderPolicy {
      * Defaults to 60s if omitted.
      */
     min_deadline_seconds?: number;
+    /**
+     * Multi-round counter strategy (3.5.0). Controls what the orchestrator
+     * does when a buyer's counter is below our floor:
+     *
+     *   'walk'     — reject and log; buyer's TTL expires → CANCELLED. Default.
+     *   'concede'  — re-quote at a price between our previous quote and
+     *                our floor (governed by `concede_pct`), up to
+     *                `max_requotes` times before walking.
+     *
+     * The buyer side enforces its own `rounds_per_provider` cap; provider
+     * `max_requotes` is independent and provides defense-in-depth — if a
+     * misbehaving buyer keeps countering low, we stop responding after N
+     * concessions.
+     */
+    counter_strategy?: 'walk' | 'concede';
+    /**
+     * Concede strategy: when re-quoting, our new amount =
+     *   last_quote - (last_quote - floor) * concede_pct / 100
+     *
+     * Default 30 (we move 30% of the way from last quote toward floor
+     * each round). Bounded [1, 99]; 100 would give the buyer everything
+     * (just accept), 0 would be a no-op.
+     */
+    concede_pct?: number;
+    /**
+     * Hard cap on re-quotes per (provider, txId). Default 2 — combined
+     * with the buyer's typical rounds_per_provider=3 this gives 1 initial
+     * quote + 2 re-quotes = 3 quote messages total per tx, matching the
+     * buyer's expected exchange depth.
+     */
+    max_requotes?: number;
 }
 export type ProviderPolicyViolation = {
     rule: 'service_not_offered';
@@ -117,15 +148,29 @@ export declare class ProviderPolicyEngine {
      */
     evaluate(req: IncomingRequest): ProviderPolicyResult;
     /**
-     * Decide whether to accept a buyer's counter-offer.
+     * 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.
      *
-     * 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.
+     * All arithmetic uses BigInt on base units — no float drift.
      */
-    evaluateCounter(counterAmountBaseUnits: string): {
-        decision: 'accept' | 'reject';
+    evaluateCounter(counterAmountBaseUnits: string, lastQuoteAmountBaseUnits: string, requotesUsed: number): {
+        decision: 'accept' | 'reject' | 'requote';
         reason: string;
+        amountBaseUnits?: string;
     };
     /** Expose ttl as seconds for callers building QuoteMessage.expiresAt. */
     get quoteTtlSeconds(): number;

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

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