clodds 1.1.0

package/dist/acp/discovery.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * Agent Discovery Protocol for Agent Commerce Protocol
+ *
+ * Intelligent discovery mechanism for finding agents:
+ * - Semantic search by capability
+ * - Price optimization
+ * - Reputation-weighted ranking
+ * - Auto-negotiation
+ * - Service matching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDiscoveryService = createDiscoveryService;
+exports.getDiscoveryService = getDiscoveryService;
+exports.findService = findService;
+exports.quickHire = quickHire;
+const logger_1 = require("../utils/logger");
+const registry_1 = require("./registry");
+const agreement_1 = require("./agreement");
+const DEFAULT_WEIGHTS = {
+    relevance: 0.35,
+    reputation: 0.25,
+    price: 0.20,
+    availability: 0.10,
+    experience: 0.10,
+};
+function calculateRelevanceScore(service, request) {
+    let score = 0;
+    const maxScore = 100;
+    // Category match
+    if (request.categories?.includes(service.capability.category)) {
+        score += 30;
+    }
+    // Required capabilities match
+    if (request.requiredCapabilities?.length) {
+        const capName = service.capability.name.toLowerCase();
+        const capDesc = service.capability.description.toLowerCase();
+        const matched = request.requiredCapabilities.filter(cap => capName.includes(cap.toLowerCase()) || capDesc.includes(cap.toLowerCase()));
+        score += (matched.length / request.requiredCapabilities.length) * 40;
+    }
+    else {
+        score += 20; // No specific requirements
+    }
+    // Preferred capabilities bonus
+    if (request.preferredCapabilities?.length) {
+        const capName = service.capability.name.toLowerCase();
+        const matched = request.preferredCapabilities.filter(cap => capName.includes(cap.toLowerCase()));
+        score += (matched.length / request.preferredCapabilities.length) * 20;
+    }
+    // Keyword match in need description
+    if (request.need) {
+        const needWords = request.need.toLowerCase().split(/\s+/);
+        const serviceText = `${service.capability.name} ${service.description}`.toLowerCase();
+        const matchedWords = needWords.filter(word => word.length > 3 && serviceText.includes(word));
+        score += Math.min((matchedWords.length / needWords.length) * 10, 10);
+    }
+    return Math.min(score, maxScore);
+}
+function calculateReputationScore(agent) {
+    const { averageRating, totalTransactions, successfulTransactions, disputeRate } = agent.reputation;
+    // Base score from rating (0-50)
+    let score = (averageRating / 5) * 50;
+    // Experience bonus (0-30)
+    const experienceBonus = Math.min(Math.log10(totalTransactions + 1) * 10, 30);
+    score += experienceBonus;
+    // Success rate bonus (0-15)
+    if (totalTransactions > 0) {
+        const successRate = successfulTransactions / totalTransactions;
+        score += successRate * 15;
+    }
+    // Dispute penalty
+    score -= disputeRate * 20;
+    return Math.max(0, Math.min(score, 100));
+}
+function calculatePriceScore(service, maxPrice) {
+    if (!maxPrice)
+        return 50; // Neutral if no budget specified
+    const servicePrice = BigInt(service.pricing.amount);
+    const budget = BigInt(maxPrice);
+    if (servicePrice > budget) {
+        return 0; // Over budget
+    }
+    // Score based on how much under budget
+    const savingsRatio = Number(budget - servicePrice) / Number(budget);
+    return Math.min(50 + savingsRatio * 50, 100);
+}
+function calculateAvailabilityScore(service) {
+    if (!service.enabled)
+        return 0;
+    let score = 50; // Base score for being available
+    if (service.sla) {
+        // Availability SLA bonus
+        score += (service.sla.availabilityPercent - 90) * 2; // Bonus for >90%
+        // Response time bonus
+        if (service.sla.maxResponseTimeMs < 1000) {
+            score += 20;
+        }
+        else if (service.sla.maxResponseTimeMs < 5000) {
+            score += 10;
+        }
+    }
+    return Math.min(score, 100);
+}
+function calculateOverallScore(service, agent, request, weights = DEFAULT_WEIGHTS) {
+    const relevance = calculateRelevanceScore(service, request);
+    const reputation = calculateReputationScore(agent);
+    const price = calculatePriceScore(service, request.maxPrice);
+    const availability = calculateAvailabilityScore(service);
+    const experience = Math.min(Math.log10(agent.reputation.totalTransactions + 1) * 25, 100);
+    const score = relevance * weights.relevance +
+        reputation * weights.reputation +
+        price * weights.price +
+        availability * weights.availability +
+        experience * weights.experience;
+    const reasons = [];
+    if (relevance > 70)
+        reasons.push('Highly relevant to your needs');
+    if (reputation > 80)
+        reasons.push('Excellent reputation');
+    if (price > 80)
+        reasons.push('Great value for price');
+    if (agent.reputation.totalTransactions > 100)
+        reasons.push('Experienced provider');
+    if (service.sla?.availabilityPercent && service.sla.availabilityPercent > 99)
+        reasons.push('High availability SLA');
+    return { score, reasons };
+}
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+function createDiscoveryService() {
+    const registry = (0, registry_1.getRegistryService)();
+    const agreements = (0, agreement_1.getAgreementService)();
+    return {
+        async discover(request) {
+            // Build search filters
+            const filters = {
+                status: 'active',
+            };
+            if (request.categories?.length === 1) {
+                filters.category = request.categories[0];
+            }
+            if (request.maxPrice) {
+                filters.maxPrice = request.maxPrice;
+            }
+            if (request.minRating) {
+                filters.minRating = request.minRating;
+            }
+            if (request.requiredCapabilities?.length) {
+                filters.capabilities = request.requiredCapabilities;
+            }
+            // Search services
+            const services = await registry.searchServices(filters);
+            // Score and rank matches
+            const matches = [];
+            for (const service of services) {
+                const agent = await registry.getAgent(service.agentId);
+                if (!agent || agent.status !== 'active')
+                    continue;
+                // Check if can fulfill
+                if (!this.canFulfill(service, request))
+                    continue;
+                const { score, reasons } = calculateOverallScore(service, agent, request);
+                matches.push({
+                    agent,
+                    service,
+                    score,
+                    reasons,
+                    estimatedCost: service.pricing.amount,
+                    estimatedDelivery: request.deadline,
+                });
+            }
+            // Sort by score descending
+            matches.sort((a, b) => b.score - a.score);
+            logger_1.logger.info({
+                need: request.need,
+                matchCount: matches.length,
+                topScore: matches[0]?.score,
+            }, 'Discovery completed');
+            return matches;
+        },
+        async findBest(request) {
+            const matches = await this.discover(request);
+            return matches[0] || null;
+        },
+        async negotiate(request) {
+            const { match, buyerAddress, proposedPrice, proposedDeadline, customTerms } = request;
+            // Simple auto-accept logic for now
+            // In production, this would involve actual negotiation protocol
+            const acceptPrice = proposedPrice
+                ? BigInt(proposedPrice) >= BigInt(match.service.pricing.amount)
+                : true;
+            const acceptDeadline = proposedDeadline
+                ? proposedDeadline >= Date.now() + 24 * 60 * 60 * 1000 // At least 24h
+                : true;
+            if (!acceptPrice || !acceptDeadline) {
+                // Counter offer
+                return {
+                    accepted: false,
+                    counterOffer: {
+                        price: match.service.pricing.amount,
+                        deadline: Date.now() + 7 * 24 * 60 * 60 * 1000, // 7 days
+                        terms: ['Standard service terms apply'],
+                    },
+                };
+            }
+            // Create agreement
+            const price = proposedPrice || match.service.pricing.amount;
+            const deadline = proposedDeadline || Date.now() + 7 * 24 * 60 * 60 * 1000;
+            const agreementConfig = (0, agreement_1.createServiceAgreement)(buyerAddress, match.agent.address, `${match.service.capability.name}: ${match.service.description}`, price, match.service.pricing.currency, deadline);
+            // Add custom terms
+            if (customTerms?.length) {
+                for (const term of customTerms) {
+                    agreementConfig.terms.push({
+                        id: `custom_${Date.now()}`,
+                        type: 'custom',
+                        description: term,
+                    });
+                }
+            }
+            const agreement = await agreements.create(agreementConfig);
+            logger_1.logger.info({
+                agreementId: agreement.id,
+                buyer: buyerAddress,
+                seller: match.agent.address,
+                price,
+            }, 'Negotiation successful');
+            return {
+                accepted: true,
+                agreement,
+            };
+        },
+        async autoNegotiate(request) {
+            const bestMatch = await this.findBest(request);
+            if (!bestMatch) {
+                logger_1.logger.warn({ need: request.need }, 'No matching services found');
+                return null;
+            }
+            return this.negotiate({
+                match: bestMatch,
+                buyerAddress: request.buyerAddress,
+                proposedPrice: request.maxPrice,
+                proposedDeadline: request.deadline,
+            });
+        },
+        async getRecommendations(buyerAddress, limit = 5) {
+            // Get buyer's past agreements
+            const pastAgreements = await agreements.list(buyerAddress);
+            // Extract categories and capabilities from past interactions
+            const preferredCategories = [];
+            const preferredCapabilities = [];
+            // For now, return top agents in various categories
+            const topAgents = await registry.getTopAgents(undefined, limit);
+            const matches = [];
+            for (const agent of topAgents) {
+                const topService = agent.services.find(s => s.enabled);
+                if (topService) {
+                    matches.push({
+                        agent,
+                        service: topService,
+                        score: calculateReputationScore(agent),
+                        reasons: ['Top-rated provider', 'Recommended based on reputation'],
+                        estimatedCost: topService.pricing.amount,
+                    });
+                }
+            }
+            return matches;
+        },
+        canFulfill(service, requirements) {
+            if (!service.enabled)
+                return false;
+            // Price check
+            if (requirements.maxPrice) {
+                if (BigInt(service.pricing.amount) > BigInt(requirements.maxPrice)) {
+                    return false;
+                }
+            }
+            // Category check
+            if (requirements.categories?.length) {
+                if (!requirements.categories.includes(service.capability.category)) {
+                    return false;
+                }
+            }
+            // Required capabilities check
+            if (requirements.requiredCapabilities?.length) {
+                const capText = `${service.capability.name} ${service.capability.description}`.toLowerCase();
+                const hasAll = requirements.requiredCapabilities.every(cap => capText.includes(cap.toLowerCase()));
+                if (!hasAll)
+                    return false;
+            }
+            return true;
+        },
+    };
+}
+// =============================================================================
+// SINGLETON & EXPORTS
+// =============================================================================
+let discoveryService = null;
+function getDiscoveryService() {
+    if (!discoveryService) {
+        discoveryService = createDiscoveryService();
+    }
+    return discoveryService;
+}
+// =============================================================================
+// CONVENIENCE FUNCTIONS
+// =============================================================================
+/**
+ * Quick search for a service
+ */
+async function findService(need, buyerAddress, options) {
+    const discovery = getDiscoveryService();
+    return discovery.findBest({
+        need,
+        buyerAddress,
+        categories: options?.category ? [options.category] : undefined,
+        maxPrice: options?.maxPrice,
+        minRating: options?.minRating,
+    });
+}
+/**
+ * Quick negotiate and create agreement
+ */
+async function quickHire(need, buyerAddress, maxPrice) {
+    const discovery = getDiscoveryService();
+    return discovery.autoNegotiate({
+        need,
+        buyerAddress,
+        maxPrice,
+    });
+}
+//# sourceMappingURL=discovery.js.map

package/dist/acp/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/acp/discovery.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA0OH,wDA8MC;AAQD,kDAKC;AASD,kCAkBC;AAKD,8BAYC;AA/eD,4CAAyC;AACzC,yCAMoB;AACpB,2CAAqF;AAsFrF,MAAM,eAAe,GAAmB;IACtC,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,IAAI;IACX,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,SAAS,uBAAuB,CAAC,OAAuB,EAAE,OAAyB;IACjF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,QAAQ,GAAG,GAAG,CAAC;IAErB,iBAAiB;IACjB,IAAI,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,8BAA8B;IAC9B,IAAI,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CACjD,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAClF,CAAC;QACF,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,EAAE,CAAC,CAAC,2BAA2B;IAC1C,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACjG,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACxE,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;QACtF,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7F,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAmB;IACnD,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;IAEnG,gCAAgC;IAChC,IAAI,KAAK,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAErC,0BAA0B;IAC1B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7E,KAAK,IAAI,eAAe,CAAC;IAEzB,4BAA4B;IAC5B,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,sBAAsB,GAAG,iBAAiB,CAAC;QAC/D,KAAK,IAAI,WAAW,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,KAAK,IAAI,WAAW,GAAG,EAAE,CAAC;IAE1B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAuB,EAAE,QAAiB;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,CAAC,iCAAiC;IAE3D,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC,CAAC,cAAc;IAC1B,CAAC;IAED,uCAAuC;IACvC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,YAAY,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAuB;IACzD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAE/B,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,iCAAiC;IAEjD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,yBAAyB;QACzB,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB;QAEtE,sBAAsB;QACtB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,EAAE,CAAC;YACzC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,EAAE,CAAC;YAChD,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAAuB,EACvB,KAAmB,EACnB,OAAyB,EACzB,UAA0B,eAAe;IAEzC,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAE1F,MAAM,KAAK,GACT,SAAS,GAAG,OAAO,CAAC,SAAS;QAC7B,UAAU,GAAG,OAAO,CAAC,UAAU;QAC/B,KAAK,GAAG,OAAO,CAAC,KAAK;QACrB,YAAY,GAAG,OAAO,CAAC,YAAY;QACnC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAElC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,SAAS,GAAG,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAClE,IAAI,UAAU,GAAG,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC1D,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,UAAU,CAAC,iBAAiB,GAAG,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,GAAG,EAAE,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEpH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,SAAgB,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAA,6BAAkB,GAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAA,+BAAmB,GAAE,CAAC;IAEzC,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAAyB;YACtC,uBAAuB;YACvB,MAAM,OAAO,GAAkB;gBAC7B,MAAM,EAAE,QAAQ;aACjB,CAAC;YAEF,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACtC,CAAC;YAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YACxC,CAAC;YAED,IAAI,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBACzC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;YACtD,CAAC;YAED,kBAAkB;YAClB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAExD,yBAAyB;YACzB,MAAM,OAAO,GAAqB,EAAE,CAAC;YAErC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAAE,SAAS;gBAElD,uBAAuB;gBACvB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;oBAAE,SAAS;gBAEjD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBAE1E,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK;oBACL,OAAO;oBACP,KAAK;oBACL,OAAO;oBACP,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;oBACrC,iBAAiB,EAAE,OAAO,CAAC,QAAQ;iBACpC,CAAC,CAAC;YACL,CAAC;YAED,2BAA2B;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAE1C,eAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK;aAC5B,EAAE,qBAAqB,CAAC,CAAC;YAE1B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,OAAyB;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,OAA2B;YACzC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;YAEtF,mCAAmC;YACnC,gEAAgE;YAEhE,MAAM,WAAW,GAAG,aAAa;gBAC/B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC/D,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,cAAc,GAAG,gBAAgB;gBACrC,CAAC,CAAC,gBAAgB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe;gBACtE,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,CAAC,WAAW,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpC,gBAAgB;gBAChB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,YAAY,EAAE;wBACZ,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM;wBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;wBACzD,KAAK,EAAE,CAAC,8BAA8B,CAAC;qBACxC;iBACF,CAAC;YACJ,CAAC;YAED,mBAAmB;YACnB,MAAM,KAAK,GAAG,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5D,MAAM,QAAQ,GAAG,gBAAgB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAE1E,MAAM,eAAe,GAAG,IAAA,kCAAsB,EAC5C,YAAY,EACZ,KAAK,CAAC,KAAK,CAAC,OAAO,EACnB,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAChE,KAAK,EACL,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAC9B,QAAQ,CACT,CAAC;YAEF,mBAAmB;YACnB,IAAI,WAAW,EAAE,MAAM,EAAE,CAAC;gBACxB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;oBAC/B,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;wBACzB,EAAE,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE;wBAC1B,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,IAAI;qBAClB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAE3D,eAAM,CAAC,IAAI,CAAC;gBACV,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;gBAC3B,KAAK;aACN,EAAE,wBAAwB,CAAC,CAAC;YAE7B,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,SAAS;aACV,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAyB;YAC3C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,eAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,aAAa,EAAE,OAAO,CAAC,QAAQ;gBAC/B,gBAAgB,EAAE,OAAO,CAAC,QAAQ;aACnC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,kBAAkB,CAAC,YAAoB,EAAE,KAAK,GAAG,CAAC;YACtD,8BAA8B;YAC9B,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE3D,6DAA6D;YAC7D,MAAM,mBAAmB,GAAsB,EAAE,CAAC;YAClD,MAAM,qBAAqB,GAAa,EAAE,CAAC;YAE3C,mDAAmD;YACnD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAEhE,MAAM,OAAO,GAAqB,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,UAAU,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK;wBACL,OAAO,EAAE,UAAU;wBACnB,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC;wBACtC,OAAO,EAAE,CAAC,oBAAoB,EAAE,iCAAiC,CAAC;wBAClE,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM;qBACzC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,UAAU,CAAC,OAAuB,EAAE,YAA8B;YAChE,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAEnC,cAAc;YACd,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC1B,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnE,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAED,iBAAiB;YACjB,IAAI,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBACpC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnE,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAED,8BAA8B;YAC9B,IAAI,YAAY,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC7F,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CACpC,CAAC;gBACF,IAAI,CAAC,MAAM;oBAAE,OAAO,KAAK,CAAC;YAC5B,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,IAAI,gBAAgB,GAA4B,IAAI,CAAC;AAErD,SAAgB,mBAAmB;IACjC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,YAAoB,EACpB,OAIC;IAED,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,OAAO,SAAS,CAAC,QAAQ,CAAC;QACxB,IAAI;QACJ,YAAY;QACZ,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9D,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,SAAS,EAAE,OAAO,EAAE,SAAS;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,YAAoB,EACpB,QAAiB;IAEjB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,OAAO,SAAS,CAAC,aAAa,CAAC;QAC7B,IAAI;QACJ,YAAY;QACZ,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/acp/escrow.d.ts

@@ -0,0 +1,139 @@
+/**
+ * On-Chain Escrow for Agent Commerce Protocol
+ *
+ * Secure escrow system for agent-to-agent transactions:
+ * - Deposit funds into escrow
+ * - Release on successful completion
+ * - Refund on failure/timeout
+ * - Dispute resolution
+ *
+ * Keypairs are stored encrypted in the database (AES-256-GCM)
+ * and cached in memory for performance.
+ *
+ * Supports both Solana (native) and EVM (Base) chains
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+export type EscrowStatus = 'pending' | 'funded' | 'released' | 'refunded' | 'disputed' | 'expired';
+export type EscrowChain = 'solana' | 'base';
+export interface EscrowParty {
+    address: string;
+    role: 'buyer' | 'seller' | 'arbiter';
+}
+export interface EscrowCondition {
+    type: 'time' | 'signature' | 'oracle' | 'custom';
+    value: string | number;
+    description?: string;
+}
+export interface EscrowConfig {
+    /** Unique escrow ID */
+    id: string;
+    /** Chain to use */
+    chain: EscrowChain;
+    /** Buyer (depositor) */
+    buyer: string;
+    /** Seller (recipient) */
+    seller: string;
+    /** Optional arbiter for disputes */
+    arbiter?: string;
+    /** Amount in smallest unit (lamports/wei) */
+    amount: string;
+    /** Token mint (null for native SOL/ETH) */
+    tokenMint?: string;
+    /** Release conditions */
+    releaseConditions: EscrowCondition[];
+    /** Refund conditions */
+    refundConditions: EscrowCondition[];
+    /** Expiration timestamp (Unix) */
+    expiresAt: number;
+    /** Service description */
+    description?: string;
+    /** Agreement hash (links to proof-of-agreement) */
+    agreementHash?: string;
+}
+export interface Escrow extends EscrowConfig {
+    status: EscrowStatus;
+    createdAt: number;
+    fundedAt?: number;
+    completedAt?: number;
+    escrowAddress: string;
+    txSignatures: string[];
+}
+export interface EscrowResult {
+    success: boolean;
+    escrowId: string;
+    signature?: string;
+    error?: string;
+}
+export interface EscrowService {
+    /** Create a new escrow */
+    create(config: EscrowConfig): Promise<Escrow>;
+    /** Fund an escrow (buyer deposits) */
+    fund(escrowId: string, payer: Keypair): Promise<EscrowResult>;
+    /** Release escrow to seller */
+    release(escrowId: string, authorizer: Keypair): Promise<EscrowResult>;
+    /** Refund escrow to buyer */
+    refund(escrowId: string, authorizer: Keypair): Promise<EscrowResult>;
+    /** Initiate dispute */
+    dispute(escrowId: string, initiator: Keypair, reason: string): Promise<EscrowResult>;
+    /** Resolve dispute (arbiter only) */
+    resolveDispute(escrowId: string, arbiter: Keypair, releaseTo: 'buyer' | 'seller'): Promise<EscrowResult>;
+    /** Get escrow by ID */
+    get(escrowId: string): Promise<Escrow | null>;
+    /** List escrows for an address */
+    list(address: string, role?: 'buyer' | 'seller' | 'arbiter'): Promise<Escrow[]>;
+    /** Check if escrow conditions are met */
+    checkConditions(escrowId: string, type: 'release' | 'refund'): Promise<boolean>;
+}
+/**
+ * Oracle configuration for condition checks
+ * Supports: Pyth Network, HTTP endpoints, Switchboard
+ */
+export interface OracleConfig {
+    /** Oracle type */
+    type: 'pyth' | 'http' | 'switchboard';
+    /** Feed ID (Pyth price feed or Switchboard feed) or HTTP URL */
+    feedId: string;
+    /** Comparison operator */
+    operator: 'gt' | 'lt' | 'gte' | 'lte' | 'eq';
+    /** Target value to compare against */
+    targetValue: number;
+    /** JSON path for HTTP oracle response (e.g., "data.price") */
+    jsonPath?: string;
+}
+/**
+ * Custom condition handler function type
+ * Receives the escrow and condition, returns whether the condition is met
+ */
+export type CustomConditionHandler = (escrow: Escrow, condition: EscrowCondition) => Promise<boolean>;
+/**
+ * Register a custom condition handler
+ * @param name - Unique name for the condition (e.g., "delivery_confirmed")
+ * @param handler - Async function that checks if condition is met
+ */
+export declare function registerCustomCondition(name: string, handler: CustomConditionHandler): void;
+/**
+ * Unregister a custom condition handler
+ */
+export declare function unregisterCustomCondition(name: string): boolean;
+/**
+ * List all registered custom condition handlers
+ */
+export declare function listCustomConditions(): string[];
+/**
+ * Create Solana escrow service with real on-chain transactions
+ */
+export declare function createSolanaEscrowService(connection: Connection): EscrowService;
+export declare function getEscrowService(connection?: Connection): EscrowService;
+export declare function initEscrowService(connection: Connection): EscrowService;
+export declare function formatEscrowAmount(amount: string, tokenMint?: string): string;
+export declare function createEscrowId(): string;
+/**
+ * Create an oracle condition string
+ * @example createOracleCondition('pyth', 'BTC/USD', 'gt', 50000)
+ * @example createOracleCondition('http', 'https://api.example.com/price', 'lt', 100, 'data.price')
+ */
+export declare function createOracleCondition(type: OracleConfig['type'], feedId: string, operator: OracleConfig['operator'], targetValue: number, jsonPath?: string): string;
+/**
+ * Validate an oracle condition string format
+ */
+export declare function isValidOracleCondition(value: string): boolean;