@agirails/sdk 2.6.0 → 3.0.0

package/dist/negotiation/BuyerOrchestrator.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * BuyerOrchestrator — Autonomous buyer-side negotiation orchestrator.
+ *
+ * Flow:
+ *   1. Discover candidates (via agirails.app API)
+ *   2. Score with DecisionEngine (weighted ranking)
+ *   3. Validate with PolicyEngine (5 guardrails)
+ *   4. For each candidate (up to rounds_max):
+ *      a. createTransaction → INITIATED
+ *      b. Poll for QUOTED state (within quote_ttl)
+ *      c. Validate quote against policy
+ *      d. Accept → linkEscrow → COMMITTED
+ *      e. OR reject → try next candidate
+ *   5. Track everything via SessionStore
+ *
+ * Accepts ACTPClient for on-chain operations. Caller manages lifecycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuyerOrchestrator = void 0;
+const agirailsApp_1 = require("../api/agirailsApp");
+const PolicyEngine_1 = require("./PolicyEngine");
+const DecisionEngine_1 = require("./DecisionEngine");
+const SessionStore_1 = require("./SessionStore");
+// ============================================================================
+// BuyerOrchestrator
+// ============================================================================
+class BuyerOrchestrator {
+    constructor(policy, runtime, requesterAddress, actpDir) {
+        this.policy = policy;
+        this.runtime = runtime;
+        this.requesterAddress = requesterAddress;
+        this.policyEngine = new PolicyEngine_1.PolicyEngine(policy, actpDir);
+        this.decisionEngine = new DecisionEngine_1.DecisionEngine(policy.selection.weights);
+        this.sessionStore = new SessionStore_1.SessionStore(actpDir);
+    }
+    /**
+     * Execute the full negotiation flow.
+     */
+    async negotiate(config = {}) {
+        const pollInterval = config.pollIntervalMs ?? 3000;
+        const emit = config.onProgress ?? (() => { });
+        // Create session
+        const session = this.sessionStore.create(this.policy.task);
+        const rounds = [];
+        try {
+            return await this._negotiate(session, rounds, config, pollInterval, emit);
+        }
+        catch (err) {
+            // Guarantee session reaches terminal status on any uncaught throw
+            const currentSession = this.sessionStore.get(session.commerce_session_id);
+            if (currentSession && currentSession.status === 'active') {
+                this.sessionStore.updateStatus(session.commerce_session_id, 'failed');
+            }
+            throw err;
+        }
+    }
+    async _negotiate(session, rounds, config, pollInterval, emit) {
+        // 1. Discover candidates
+        const discoverParams = {
+            search: this.policy.task,
+            sort: 'reputation',
+            limit: 20,
+            maxPrice: this.policy.constraints.max_unit_price.amount,
+            ...config.discover,
+        };
+        const discovered = await (0, agirailsApp_1.discoverAgents)(discoverParams);
+        emit({ type: 'discovery', candidates: discovered.agents.length });
+        if (discovered.agents.length === 0) {
+            emit({ type: 'complete', success: false, reason: 'No candidates found' });
+            this.sessionStore.updateStatus(session.commerce_session_id, 'failed');
+            return {
+                success: false,
+                commerce_session_id: session.commerce_session_id,
+                rounds_used: 0,
+                reason: 'No candidates found',
+                rounds,
+            };
+        }
+        // 2. Score candidates with DecisionEngine
+        const candidateStats = this.mapToCandidateStats(discovered.agents);
+        const ranked = this.decisionEngine.rank(candidateStats, this.policy.constraints.max_unit_price.amount);
+        emit({ type: 'scoring', ranked: ranked.length });
+        if (ranked.length === 0) {
+            emit({ type: 'complete', success: false, reason: 'No candidates within budget' });
+            this.sessionStore.updateStatus(session.commerce_session_id, 'failed');
+            return {
+                success: false,
+                commerce_session_id: session.commerce_session_id,
+                rounds_used: 0,
+                reason: 'No candidates within budget after scoring',
+                rounds,
+            };
+        }
+        // Dry-run: return ranked candidates without creating transactions
+        if (config.dryRun) {
+            this.sessionStore.updateStatus(session.commerce_session_id, 'completed');
+            emit({ type: 'complete', success: true, reason: 'Dry run complete' });
+            return {
+                success: true,
+                commerce_session_id: session.commerce_session_id,
+                rounds_used: 0,
+                reason: `Dry run: ${ranked.length} candidates ranked`,
+                rounds: ranked.map((c, i) => ({
+                    round: i + 1,
+                    provider_slug: c.slug,
+                    provider_address: this.findAgentAddress(discovered.agents, c.slug),
+                    action: 'accepted',
+                    reason: `Score: ${c.score.toFixed(3)}`,
+                })),
+            };
+        }
+        // 3. Try candidates up to rounds_max
+        const maxRounds = Math.min(this.policy.negotiation.rounds_max, ranked.length);
+        const quoteTtlSeconds = PolicyEngine_1.PolicyEngine.parseTtl(this.policy.negotiation.quote_ttl);
+        // Price tracking for deadlock detection (PRD-5B)
+        const priceHistory = [];
+        let deadlockDetected = false;
+        for (let round = 0; round < maxRounds; round++) {
+            const candidate = ranked[round];
+            const providerAddress = this.findAgentAddress(discovered.agents, candidate.slug);
+            emit({ type: 'round_start', round: round + 1, provider: candidate.slug });
+            this.sessionStore.recordAttempt(session.commerce_session_id, candidate.slug);
+            // 3a. Pre-validate with PolicyEngine
+            const offer = {
+                provider: candidate.slug,
+                unit_price: this.findAgentPrice(discovered.agents, candidate.slug),
+                currency: this.policy.constraints.max_unit_price.currency,
+                unit: this.policy.constraints.max_unit_price.unit,
+                reputation_score: this.findAgentReputation(discovered.agents, candidate.slug),
+                commerce_session_id: session.commerce_session_id,
+                expires_at: Math.floor(Date.now() / 1000) + quoteTtlSeconds,
+                final_offer: deadlockDetected,
+            };
+            const validation = this.policyEngine.validate(offer);
+            if (!validation.allowed) {
+                const reason = validation.violations.map(v => `${v.rule}: ${v.detail}`).join('; ');
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'rejected',
+                    reason: `Policy violation: ${reason}`,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'rejected', reason });
+                continue;
+            }
+            // 3b. Create transaction
+            let txId;
+            try {
+                const amount = this.toBaseUnits(offer.unit_price);
+                txId = await this.runtime.createTransaction({
+                    provider: providerAddress,
+                    requester: this.requesterAddress,
+                    amount,
+                    deadline: Math.floor(Date.now() / 1000) + quoteTtlSeconds + 3600, // quote TTL + 1h buffer
+                    serviceDescription: JSON.stringify({ service: this.policy.task, session: session.commerce_session_id }),
+                });
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'error',
+                    reason: `createTransaction failed: ${reason}`,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'error', reason });
+                continue;
+            }
+            // 3c. Wait for quote or direct commit (ACTP allows INITIATED → COMMITTED fast path)
+            emit({ type: 'waiting_quote', txId, ttlSeconds: quoteTtlSeconds });
+            const reachedState = await this.waitForState(txId, ['QUOTED', 'COMMITTED'], quoteTtlSeconds * 1000, pollInterval);
+            if (!reachedState) {
+                // Timeout or cancelled — cancel and try next
+                try {
+                    await this.runtime.transitionState(txId, 'CANCELLED');
+                }
+                catch {
+                    // Best-effort cancel
+                }
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'timeout',
+                    reason: `No quote within ${quoteTtlSeconds}s`,
+                    tx_id: txId,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'timeout', reason: 'Quote TTL expired' });
+                continue;
+            }
+            emit({ type: 'quote_received', txId });
+            // 3d. Read quoted price from on-chain for tracking (PRD-5B)
+            let quotedPrice;
+            try {
+                const quotedTx = await this.runtime.getTransaction(txId);
+                if (quotedTx && quotedTx.amount) {
+                    const rawAmount = typeof quotedTx.amount === 'string' ? parseFloat(quotedTx.amount) : quotedTx.amount;
+                    quotedPrice = rawAmount / 1000000; // Convert base units to USDC
+                    priceHistory.push(quotedPrice);
+                    // Deadlock detection: if 2+ consecutive identical prices, flag deadlock
+                    if (priceHistory.length >= 2) {
+                        const last = priceHistory[priceHistory.length - 1];
+                        const prev = priceHistory[priceHistory.length - 2];
+                        if (last === prev) {
+                            deadlockDetected = true;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Non-fatal — price tracking is best-effort
+            }
+            // 3e. Reserve budget and link escrow (or recognize already-committed).
+            // ACTP invariant: tx.amount is immutable (set at createTransaction).
+            // Policy was already validated pre-round, so offer.unit_price
+            // is the correct amount for both reservation and escrow.
+            if (reachedState === 'COMMITTED') {
+                // COMMITTED is terminal on-chain — this is a success regardless of local ledger state.
+                // Best-effort reserve for local budget tracking; failure is non-fatal.
+                try {
+                    this.policyEngine.reserve(session.commerce_session_id, offer.unit_price, offer.currency);
+                }
+                catch {
+                    // Local ledger out of sync — log but don't fail the already-committed tx
+                }
+                this.sessionStore.linkTransaction(session.commerce_session_id, txId, candidate.slug);
+                const reason = 'Provider already committed, escrow recognized';
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'accepted',
+                    reason,
+                    tx_id: txId,
+                    quoted_price: quotedPrice,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'accepted', reason });
+                emit({ type: 'complete', success: true, reason: 'Negotiation complete' });
+                return {
+                    success: true,
+                    commerce_session_id: session.commerce_session_id,
+                    actp_tx_id: txId,
+                    selected_provider: candidate.slug,
+                    rounds_used: round + 1,
+                    reason: 'Negotiation complete — already committed',
+                    rounds,
+                    deadlock_detected: deadlockDetected,
+                };
+            }
+            // QUOTED path: reserve budget + link escrow (both must succeed, or try next candidate)
+            const escrowAmount = this.toBaseUnits(offer.unit_price);
+            try {
+                this.policyEngine.reserve(session.commerce_session_id, offer.unit_price, offer.currency);
+                await this.runtime.linkEscrow(txId, escrowAmount);
+                // Success
+                this.sessionStore.linkTransaction(session.commerce_session_id, txId, candidate.slug);
+                const reason = 'Quote accepted, escrow linked';
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'accepted',
+                    reason,
+                    tx_id: txId,
+                    quoted_price: quotedPrice,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'accepted', reason });
+                emit({ type: 'complete', success: true, reason: 'Negotiation complete' });
+                return {
+                    success: true,
+                    commerce_session_id: session.commerce_session_id,
+                    actp_tx_id: txId,
+                    selected_provider: candidate.slug,
+                    rounds_used: round + 1,
+                    reason: 'Negotiation complete — escrow linked',
+                    rounds,
+                    deadlock_detected: deadlockDetected,
+                };
+            }
+            catch (err) {
+                // Reserve or linkEscrow failed — release and try next
+                this.policyEngine.release(session.commerce_session_id);
+                const reason = err instanceof Error ? err.message : String(err);
+                rounds.push({
+                    round: round + 1,
+                    provider_slug: candidate.slug,
+                    provider_address: providerAddress,
+                    action: 'error',
+                    reason: `Escrow failed: ${reason}`,
+                    tx_id: txId,
+                    quoted_price: quotedPrice,
+                });
+                emit({ type: 'round_end', round: round + 1, action: 'error', reason });
+                continue;
+            }
+        }
+        // All rounds exhausted
+        this.sessionStore.updateStatus(session.commerce_session_id, 'failed');
+        emit({ type: 'complete', success: false, reason: 'All candidates exhausted' });
+        const exhaustedReason = deadlockDetected
+            ? `All ${rounds.length} candidates exhausted (price deadlock detected)`
+            : `All ${rounds.length} candidates exhausted`;
+        return {
+            success: false,
+            commerce_session_id: session.commerce_session_id,
+            rounds_used: rounds.length,
+            reason: exhaustedReason,
+            rounds,
+            deadlock_detected: deadlockDetected,
+        };
+    }
+    // ============================================================================
+    // Helpers
+    // ============================================================================
+    /**
+     * Poll until tx reaches one of the target states.
+     * Returns the reached state, or null on timeout/cancelled.
+     * Resilient to transient RPC errors (retries until deadline).
+     */
+    async waitForState(txId, targetStates, timeoutMs, pollIntervalMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            try {
+                const tx = await this.runtime.getTransaction(txId);
+                if (tx && targetStates.includes(tx.state))
+                    return tx.state;
+                // Exit early if CANCELLED by provider
+                if (tx && tx.state === 'CANCELLED')
+                    return null;
+            }
+            catch {
+                // Transient error (RPC timeout, network blip) — keep polling until deadline
+            }
+            await this.sleep(Math.min(pollIntervalMs, deadline - Date.now()));
+        }
+        return null;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
+    }
+    mapToCandidateStats(agents) {
+        return agents
+            .filter(a => a.wallet_address && a.published_config?.pricing)
+            .map(a => ({
+            slug: a.slug,
+            unit_price: typeof a.published_config.pricing.amount === 'string'
+                ? parseFloat(a.published_config.pricing.amount)
+                : (a.published_config.pricing.amount ?? 0),
+            reputation_score: a.stats?.reputation_score ?? 0,
+            success_rate: a.stats?.success_rate ?? 0,
+            avg_completion_time_seconds: a.stats?.avg_completion_time_seconds ?? null,
+            completed_transactions: a.stats?.completed_transactions ?? 0,
+        }));
+    }
+    findAgentAddress(agents, slug) {
+        return agents.find(a => a.slug === slug)?.wallet_address ?? '';
+    }
+    findAgentPrice(agents, slug) {
+        const agent = agents.find(a => a.slug === slug);
+        const amount = agent?.published_config?.pricing?.amount;
+        if (typeof amount === 'string')
+            return parseFloat(amount);
+        return amount ?? 0;
+    }
+    findAgentReputation(agents, slug) {
+        return agents.find(a => a.slug === slug)?.stats?.reputation_score;
+    }
+    /** Convert a USDC amount (e.g. 0.80) to base units string (e.g. "800000") */
+    toBaseUnits(amount) {
+        return String(Math.round(amount * 1000000));
+    }
+}
+exports.BuyerOrchestrator = BuyerOrchestrator;
+//# sourceMappingURL=BuyerOrchestrator.js.map

package/dist/negotiation/BuyerOrchestrator.js.map

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

package/dist/negotiation/DecisionEngine.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DecisionEngine — Weighted scoring for agent candidate ranking.
+ *
+ * Scores policy-valid candidates using configurable weights:
+ *   score = w_quality * quality + w_price * price + w_speed * speed + w_reliability * reliability
+ *
+ * Default weights: quality=0.35, price=0.30, speed=0.20, reliability=0.15
+ *
+ * Tie-breakers: lower price → better on-time rate → earlier in discovery results.
+ */
+export interface ScoringWeights {
+    quality?: number;
+    price?: number;
+    speed?: number;
+    reliability?: number;
+}
+export interface CandidateStats {
+    slug: string;
+    unit_price: number;
+    reputation_score: number;
+    success_rate: number;
+    avg_completion_time_seconds: number | null;
+    completed_transactions: number;
+}
+export interface ScoredCandidate {
+    slug: string;
+    score: number;
+    breakdown: {
+        quality: number;
+        price: number;
+        speed: number;
+        reliability: number;
+    };
+}
+export declare class DecisionEngine {
+    private weights;
+    constructor(weights?: ScoringWeights);
+    /**
+     * Score and rank candidates. Returns sorted by score descending.
+     * If maxPrice is provided, candidates exceeding it are filtered out.
+     */
+    rank(candidates: CandidateStats[], maxPrice?: number): ScoredCandidate[];
+}
+//# sourceMappingURL=DecisionEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionEngine.d.ts","sourceRoot":"","sources":["../../src/negotiation/DecisionEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAiBD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA2B;gBAE9B,OAAO,CAAC,EAAE,cAAc;IAkBpC;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;CAgFzE"}

package/dist/negotiation/DecisionEngine.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * DecisionEngine — Weighted scoring for agent candidate ranking.
+ *
+ * Scores policy-valid candidates using configurable weights:
+ *   score = w_quality * quality + w_price * price + w_speed * speed + w_reliability * reliability
+ *
+ * Default weights: quality=0.35, price=0.30, speed=0.20, reliability=0.15
+ *
+ * Tie-breakers: lower price → better on-time rate → earlier in discovery results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionEngine = void 0;
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_WEIGHTS = {
+    quality: 0.35,
+    price: 0.30,
+    speed: 0.20,
+    reliability: 0.15,
+};
+// ============================================================================
+// DecisionEngine
+// ============================================================================
+class DecisionEngine {
+    constructor(weights) {
+        this.weights = {
+            quality: weights?.quality ?? DEFAULT_WEIGHTS.quality,
+            price: weights?.price ?? DEFAULT_WEIGHTS.price,
+            speed: weights?.speed ?? DEFAULT_WEIGHTS.speed,
+            reliability: weights?.reliability ?? DEFAULT_WEIGHTS.reliability,
+        };
+        // Normalize weights to sum to 1.0
+        const total = this.weights.quality + this.weights.price + this.weights.speed + this.weights.reliability;
+        if (total > 0 && Math.abs(total - 1.0) > 0.001) {
+            this.weights.quality /= total;
+            this.weights.price /= total;
+            this.weights.speed /= total;
+            this.weights.reliability /= total;
+        }
+    }
+    /**
+     * Score and rank candidates. Returns sorted by score descending.
+     * If maxPrice is provided, candidates exceeding it are filtered out.
+     */
+    rank(candidates, maxPrice) {
+        // Filter out over-budget candidates
+        const eligible = maxPrice != null
+            ? candidates.filter((c) => c.unit_price <= maxPrice)
+            : candidates;
+        if (eligible.length === 0)
+            return [];
+        // Compute min/max for normalization
+        const prices = eligible.map((c) => c.unit_price);
+        const times = eligible
+            .map((c) => c.avg_completion_time_seconds)
+            .filter((t) => t != null);
+        const minPrice = Math.min(...prices);
+        const maxPriceVal = Math.max(...prices);
+        const priceRange = maxPriceVal - minPrice;
+        const minTime = times.length > 0 ? Math.min(...times) : 0;
+        const maxTime = times.length > 0 ? Math.max(...times) : 1;
+        const timeRange = maxTime - minTime;
+        const scored = eligible.map((c) => {
+            // Quality: reputation_score normalized to 0-1
+            const quality = c.reputation_score / 100;
+            // Price: inverted (lower is better), normalized to 0-1
+            const price = priceRange > 0
+                ? 1 - (c.unit_price - minPrice) / priceRange
+                : 1; // all same price → all get max score
+            // Speed: inverted (faster is better), normalized to 0-1
+            // Agents with no completion data are penalized (0.5) vs those with data (1.0 when equal)
+            let speed;
+            if (c.avg_completion_time_seconds != null) {
+                speed = timeRange > 0
+                    ? 1 - (c.avg_completion_time_seconds - minTime) / timeRange
+                    : 1.0; // all candidates with data are equal on speed
+            }
+            else {
+                speed = 0.5; // no data — penalized vs agents with track record
+            }
+            // Reliability: success_rate normalized to 0-1
+            const reliability = c.success_rate / 100;
+            const score = this.weights.quality * quality +
+                this.weights.price * price +
+                this.weights.speed * speed +
+                this.weights.reliability * reliability;
+            return {
+                slug: c.slug,
+                score,
+                breakdown: { quality, price, speed, reliability },
+            };
+        });
+        // Sort by score descending, then tie-breakers
+        scored.sort((a, b) => {
+            if (Math.abs(b.score - a.score) > 0.001)
+                return b.score - a.score;
+            // Tie-breaker 1: lower price
+            const aCandidate = eligible.find((c) => c.slug === a.slug);
+            const bCandidate = eligible.find((c) => c.slug === b.slug);
+            if (aCandidate.unit_price !== bCandidate.unit_price) {
+                return aCandidate.unit_price - bCandidate.unit_price;
+            }
+            // Tie-breaker 2: higher success rate (on-time proxy)
+            if (aCandidate.success_rate !== bCandidate.success_rate) {
+                return bCandidate.success_rate - aCandidate.success_rate;
+            }
+            // Tie-breaker 3: original order (earlier in discovery results)
+            return 0;
+        });
+        return scored;
+    }
+}
+exports.DecisionEngine = DecisionEngine;
+//# sourceMappingURL=DecisionEngine.js.map

package/dist/negotiation/DecisionEngine.js.map

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