@agirails/sdk 3.3.0 → 3.5.3

package/dist/negotiation/ProviderOrchestrator.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * ProviderOrchestrator — autonomous provider-side negotiation flow.
+ *
+ * Two responsibilities:
+ *
+ *   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.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 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.negotiationChannel = cfg.negotiationChannel;
+        this.log = cfg.log ?? (() => undefined);
+        this.quoteBuilder = new QuoteBuilder_1.QuoteBuilder(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. Pure policy — no chain, no channel.
+     */
+    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 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.
+     */
+    async quote(req, providerDID) {
+        const decision = this.evaluateRequest(req);
+        if (decision.action === 'skip')
+            return { decision };
+        const now = Math.floor(Date.now() / 1000);
+        const currency = this.policyEngine.policyCurrency;
+        const decimals = currency.toUpperCase() === 'USDC' ? 6 : 6;
+        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,
+        });
+        await this.runtime.submitQuote(req.txId, quote);
+        if (this.negotiationChannel) {
+            try {
+                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) };
+            }
+        }
+        // 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)
+    // --------------------------------------------------------------------------
+    /**
+     * 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, lastQuoteAmountBaseUnits, requotesUsed = 0) {
+        await this.counterVerifier.verify(counter, this.kernelAddress);
+        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

@@ -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,188 @@
+/**
+ * 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;
+    /**
+     * 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';
+    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 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: 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;
+    /** 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":"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"}