@itachisol/plugin-x402-swarms 0.1.0

package/dist/providers/x402Provider.js

@@ -0,0 +1,72 @@
+/**
+ * Injects x402 payment context into the agent's LLM prompt.
+ * Lets the agent know its wallet status, spending history, budget, and access pass.
+ */
+export const x402Provider = {
+    name: "X402_PAYMENT_CONTEXT",
+    description: "Provides x402 payment wallet status, Dexter budget, and spending context to the agent",
+    get: async (runtime, _message, _state) => {
+        const walletService = runtime.getService("X402_WALLET");
+        if (!walletService) {
+            return { text: "[x402] Payment service not initialized." };
+        }
+        const config = walletService.getConfig();
+        const budgetAccount = walletService.getBudgetAccount();
+        const history = walletService.getPaymentHistory();
+        const recentPayments = history.slice(-3).map((p) => `  - $${p.amount.toFixed(4)} -> ${p.domain} on ${p.network}`);
+        const accessPassLine = config.accessPassTier
+            ? `Access pass: ${config.accessPassTier} tier (auto-renew enabled)`
+            : "Access pass: not configured";
+        // Build spending history and endpoint value sections from PaymentMemoryService
+        let spendingSection = "";
+        const memoryService = runtime.getService("PAYMENT_MEMORY");
+        if (memoryService) {
+            const stats24h = memoryService.getSpendingStats("24h");
+            const stats7d = memoryService.getSpendingStats("7d");
+            const stats30d = memoryService.getSpendingStats("30d");
+            if (stats24h.totalCalls > 0 || stats7d.totalCalls > 0 || stats30d.totalCalls > 0) {
+                spendingSection += `\nSpending History:
+  Last 24h: $${stats24h.totalSpent.toFixed(2)} across ${stats24h.totalCalls} calls
+  Last 7d: $${stats7d.totalSpent.toFixed(2)} across ${stats7d.totalCalls} calls
+  Last 30d: $${stats30d.totalSpent.toFixed(2)} across ${stats30d.totalCalls} calls`;
+            }
+            const scores = memoryService.getEndpointScoreSummary();
+            const scoredEndpoints = scores.filter((s) => s.avgQuality > 0);
+            if (scoredEndpoints.length > 0) {
+                // Best value: highest quality/cost ratio (already sorted best-first)
+                const bestValue = scoredEndpoints.slice(0, 3);
+                spendingSection += `\n\nBest Value Endpoints:`;
+                bestValue.forEach((ep, i) => {
+                    spendingSection += `\n  ${i + 1}. ${ep.domain} — $${ep.avgCostPerCall.toFixed(2)}/call, quality ${ep.avgQuality.toFixed(1)}/5 (${ep.totalCalls} calls)`;
+                });
+                // Worst value: lowest ratio (reverse of sorted)
+                const worstValue = scoredEndpoints.slice(-3).reverse();
+                // Only show if distinct from best value endpoints
+                const bestDomains = new Set(bestValue.map((e) => e.domain));
+                const uniqueWorst = worstValue.filter((e) => !bestDomains.has(e.domain));
+                if (uniqueWorst.length > 0) {
+                    spendingSection += `\n\nAvoid (Low Value):`;
+                    uniqueWorst.forEach((ep, i) => {
+                        spendingSection += `\n  ${i + 1}. ${ep.domain} — $${ep.avgCostPerCall.toFixed(2)}/call, quality ${ep.avgQuality.toFixed(1)}/5 (${ep.totalCalls} calls)`;
+                    });
+                }
+            }
+        }
+        return {
+            text: `[x402 Wallet Context — Dexter SDK]
+Network: ${config.networkId}
+Auto-pay limit: $${config.maxAutoPayUsd} per request
+Budget remaining: ${budgetAccount?.remaining ?? "not configured"}
+Total spent this session: $${(budgetAccount?.spentAmount ?? 0).toFixed(4)}
+Payments made: ${budgetAccount?.payments ?? 0}
+Hourly spend: $${(walletService.getHourlySpend()).toFixed(4)}
+${accessPassLine}
+Recent payments (last 3):
+${recentPayments.length > 0 ? recentPayments.join("\n") : "  None yet"}
+${spendingSection}
+You can pay for x402-protected APIs autonomously up to $${config.maxAutoPayUsd} per call.
+Use DISCOVER_X402_SERVICES to find available services on OpenDexter, PAY_FOR_X402_SERVICE to access paid endpoints, DELEGATE_TO_SWARM for complex tasks, or DELEGATE_TO_SWARM_WITH_PAYMENT for tasks that need paid external data fed into swarm analysis.`,
+        };
+    },
+};
+//# sourceMappingURL=x402Provider.js.map

package/dist/providers/x402Provider.js.map

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

package/dist/providers/x402ServerProvider.d.ts

@@ -0,0 +1,7 @@
+import { type Provider } from "@elizaos/core";
+/**
+ * Injects sell-side x402 revenue context into the agent's LLM prompt.
+ * Active only when X402_RECEIVE_ADDRESS is configured and X402ServerService is running.
+ */
+export declare const x402ServerProvider: Provider;
+//# sourceMappingURL=x402ServerProvider.d.ts.map

package/dist/providers/x402ServerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402ServerProvider.d.ts","sourceRoot":"","sources":["../../src/providers/x402ServerProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAKd,MAAM,eAAe,CAAC;AAevB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAiDhC,CAAC"}

package/dist/providers/x402ServerProvider.js

@@ -0,0 +1,48 @@
+/**
+ * Sell-side endpoint catalog used for the LLM context.
+ * Kept in sync with x402Routes definitions.
+ */
+const SELL_SIDE_ENDPOINTS = [
+    { path: "POST /x402/research", price: "$0.05", desc: "Run a ResearchPipeline swarm" },
+    { path: "POST /x402/analyze", price: "$0.03", desc: "Run an AnalysisPanel swarm" },
+    { path: "POST /x402/agent", price: "$0.02", desc: "Single agent run" },
+    { path: "GET  /x402/catalog", price: "FREE", desc: "List all paid endpoints" },
+    { path: "GET  /x402/health", price: "FREE", desc: "Service status" },
+];
+/**
+ * Injects sell-side x402 revenue context into the agent's LLM prompt.
+ * Active only when X402_RECEIVE_ADDRESS is configured and X402ServerService is running.
+ */
+export const x402ServerProvider = {
+    name: "X402_SERVER_CONTEXT",
+    description: "Provides x402 sell-side context: revenue earned, settlements, and available paid endpoints",
+    get: async (runtime, _message, _state) => {
+        const serverService = runtime.getService("X402_SERVER");
+        if (!serverService?.isAvailable()) {
+            return { text: "[x402 Server] Not configured." };
+        }
+        const receiveAddress = serverService.getReceiveAddress();
+        const network = serverService.getNetwork();
+        const totalRevenue = serverService.getTotalRevenueUsd();
+        const settlementCount = serverService.getSettlementCount();
+        const history = serverService.getRevenueHistory();
+        const recentPayments = history.slice(-3).map((r) => `  - $${r.amountUsd.toFixed(4)} from ${r.payer || "unknown"} for ${r.endpoint} (tx: ${r.txHash.slice(0, 12)}...)`);
+        const endpointList = SELL_SIDE_ENDPOINTS.map((e) => `  - ${e.path} — ${e.price} — ${e.desc}`).join("\n");
+        return {
+            text: `[x402 Server Context — Sell Side]
+Receive address: ${receiveAddress}
+Network: ${network}
+Total revenue: $${totalRevenue.toFixed(4)}
+Settlements: ${settlementCount}
+
+Recent incoming payments (last 3):
+${recentPayments.length > 0 ? recentPayments.join("\n") : "  None yet"}
+
+Available sell-side endpoints:
+${endpointList}
+
+You are accepting x402 payments for agent services. Clients pay USDC to access your endpoints above.`,
+        };
+    },
+};
+//# sourceMappingURL=x402ServerProvider.js.map

package/dist/providers/x402ServerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402ServerProvider.js","sourceRoot":"","sources":["../../src/providers/x402ServerProvider.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,mBAAmB,GAAG;IAC1B,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,8BAA8B,EAAE;IACrF,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE;IAClF,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACtE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,EAAE;IAC9E,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE;CACrE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,4FAA4F;IAE9F,GAAG,EAAE,KAAK,EACR,OAAsB,EACtB,QAAgB,EAChB,MAAc,EACW,EAAE;QAC3B,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CACtC,aAAoB,CACrB,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,cAAc,GAAG,aAAa,CAAC,iBAAiB,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;QACxD,MAAM,eAAe,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,EAAE,CAAC;QAElD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAC1C,CAAC,CAAC,EAAE,EAAE,CACJ,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,SAAS,QAAQ,CAAC,CAAC,QAAQ,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CACpH,CAAC;QAEF,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,EAAE,CAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,IAAI,EAAE;mBACO,cAAc;WACtB,OAAO;kBACA,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;eAC1B,eAAe;;;EAG5B,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;;;EAGpE,YAAY;;qGAEuF;SAChG,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/routes/advancedRoutes.d.ts

@@ -0,0 +1,5 @@
+import type { Route } from "@elizaos/core";
+import type { X402ServiceEndpoint } from "../types.js";
+export declare const ADVANCED_CATALOG: X402ServiceEndpoint[];
+export declare const advancedRoutes: Route[];
+//# sourceMappingURL=advancedRoutes.d.ts.map

package/dist/routes/advancedRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedRoutes.d.ts","sourceRoot":"","sources":["../../src/routes/advancedRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAiKvD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAiCjD,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,KAAK,EA0xBjC,CAAC"}