kompass-sdk 0.14.0 → 0.16.0

package/dist/wallet/handlers/locus.js

@@ -0,0 +1,220 @@
+/**
+ * Locus Payment Handler
+ * Calls Locus wrapped APIs — pay-per-use via USDC on Base.
+ * No upstream API keys needed — Locus proxies the call and charges the wallet.
+ *
+ * Flow:
+ * 1. Get or create Locus API key (self-register if needed)
+ * 2. Wait for wallet deployment
+ * 3. Call the wrapped API endpoint
+ * 4. Locus charges USDC from wallet, returns response
+ *
+ * Docs: https://beta.paywithlocus.com/skill.md
+ */
+const LOCUS_API = "https://beta-api.paywithlocus.com/api";
+export async function handleLocusPayment(wallet, agent, task) {
+    let apiKey = process.env.LOCUS_API_KEY;
+    try {
+        // Step 1: Self-register if no API key
+        if (!apiKey) {
+            const walletAddress = wallet.getAddress();
+            const registerRes = await fetch(`${LOCUS_API}/register`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    wallet_address: walletAddress,
+                    agent_name: "kompass-agent",
+                }),
+                signal: AbortSignal.timeout(15000),
+            });
+            if (!registerRes.ok) {
+                const errBody = await registerRes.text().catch(() => "");
+                return {
+                    success: false,
+                    deliverable: {
+                        error: `Locus registration failed: ${registerRes.status}`,
+                        details: errBody,
+                        hint: "Set LOCUS_API_KEY env var or fund a Locus wallet at paywithlocus.com",
+                    },
+                };
+            }
+            const registerData = await registerRes.json();
+            apiKey = registerData.data?.apiKey;
+            if (!apiKey) {
+                return {
+                    success: false,
+                    deliverable: { error: "Locus registration did not return an API key" },
+                };
+            }
+            // Wait for wallet deployment
+            for (let i = 0; i < 10; i++) {
+                const statusRes = await fetch(`${LOCUS_API}/status`, {
+                    headers: { "Authorization": `Bearer ${apiKey}` },
+                    signal: AbortSignal.timeout(5000),
+                }).catch(() => null);
+                if (statusRes?.ok) {
+                    const statusData = await statusRes.json();
+                    if (statusData.data?.walletStatus === "deployed")
+                        break;
+                }
+                await new Promise((r) => setTimeout(r, 3000));
+            }
+        }
+        const headers = {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`,
+        };
+        // Step 2: Determine if this is a wrapped API call or a direct payment
+        const rawData = agent.raw;
+        const isWrappedApi = rawData?.type === "locus-wrapped-api";
+        if (isWrappedApi) {
+            // Call the wrapped API directly
+            // The endpoint URL is like: /api/wrapped/{provider}/{endpoint}
+            // We need to figure out the best endpoint for the task
+            const provider = rawData.provider;
+            const availableEndpoints = rawData.endpoints || [];
+            // Pick the best endpoint and build the right params for each provider
+            const { endpoint, params } = buildLocusRequest(provider, availableEndpoints, task);
+            const callUrl = `${LOCUS_API}/wrapped/${provider}/${endpoint}`;
+            const callRes = await fetch(callUrl, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(params),
+                signal: AbortSignal.timeout(30000),
+            });
+            if (!callRes.ok) {
+                const errBody = await callRes.text().catch(() => "");
+                return {
+                    success: false,
+                    deliverable: {
+                        error: `Locus wrapped API call failed: ${callRes.status}`,
+                        provider,
+                        endpoint,
+                        details: errBody,
+                    },
+                };
+            }
+            const result = await callRes.json();
+            return {
+                success: true,
+                deliverable: result,
+            };
+        }
+        // Step 3: Direct USDC payment to agent address
+        const toAddress = agent.endpoints.acp?.walletAddress ?? agent.endpoints.http;
+        const amount = agent.pricing?.amount ?? "0.01";
+        if (!toAddress || !toAddress.startsWith("0x")) {
+            return {
+                success: false,
+                deliverable: { error: "No valid target address for Locus payment" },
+            };
+        }
+        const sendRes = await fetch(`${LOCUS_API}/pay/send`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                to_address: toAddress,
+                amount: parseFloat(amount),
+                memo: `Kompass task: ${task.slice(0, 100)}`,
+            }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!sendRes.ok) {
+            const errBody = await sendRes.text().catch(() => "");
+            return {
+                success: false,
+                deliverable: { error: `Locus payment failed: ${sendRes.status}`, details: errBody },
+            };
+        }
+        const sendData = await sendRes.json();
+        return {
+            success: true,
+            deliverable: sendData,
+            txHash: sendData.data?.tx_hash ?? sendData.data?.transaction_id,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            deliverable: { error: err instanceof Error ? err.message : String(err) },
+        };
+    }
+}
+/**
+ * Build the right endpoint and params for each Locus wrapped API provider.
+ * Each provider has different input formats — this maps the natural language task
+ * to the correct API call based on the provider's docs.
+ */
+function buildLocusRequest(provider, endpoints, task) {
+    // Extract URLs from task
+    const urlMatch = task.match(/https?:\/\/[^\s"']+/);
+    const url = urlMatch?.[0];
+    switch (provider) {
+        // Web scraping providers — need "url" param
+        case "firecrawl":
+            return { endpoint: url ? "scrape" : "search", params: url ? { url } : { query: task } };
+        case "abstract-web-scraping":
+            return { endpoint: "scrape", params: { url: url || task } };
+        case "diffbot":
+            return { endpoint: "analyze", params: { url: url || task } };
+        case "tavily":
+            return { endpoint: url ? "extract" : "search", params: url ? { urls: [url] } : { query: task } };
+        // Search providers — need "query" or "q" param
+        case "brave":
+            return { endpoint: "web-search", params: { q: task } };
+        case "exa":
+            return { endpoint: "search", params: { query: task } };
+        case "perplexity":
+            return { endpoint: "sonar-chat", params: { messages: [{ role: "user", content: task }] } };
+        // Crypto / Finance
+        case "coingecko": {
+            // Extract coin name from task
+            const coins = ["bitcoin", "ethereum", "solana", "base", "usdc"];
+            const coin = coins.find(c => task.toLowerCase().includes(c)) || "ethereum";
+            const coinId = coin === "eth" ? "ethereum" : coin;
+            return { endpoint: "simple-price", params: { ids: coinId, vs_currencies: "usd" } };
+        }
+        case "alphavantage":
+            return { endpoint: "global-quote", params: { symbol: task.match(/[A-Z]{1,5}/)?.[0] || "ETH" } };
+        // LLM providers — need "messages" or "prompt"
+        case "openai":
+        case "anthropic":
+        case "gemini":
+        case "deepseek":
+        case "grok":
+        case "groq":
+        case "mistral":
+            return { endpoint: "chat", params: { messages: [{ role: "user", content: task }] } };
+        // Image/Media generation
+        case "fal":
+            return { endpoint: "generate", params: { prompt: task } };
+        case "stability-ai":
+            return { endpoint: "generate-core", params: { prompt: task } };
+        case "replicate":
+            return { endpoint: "run-model", params: { input: { prompt: task } } };
+        case "suno":
+            return { endpoint: "generate-music", params: { prompt: task } };
+        // Code execution
+        case "judge0":
+            return { endpoint: "execute-code", params: { source_code: task, language_id: 63 } }; // 63 = JavaScript
+        // Screenshot
+        case "screenshotone":
+            return { endpoint: "take-screenshot", params: { url: url || task } };
+        // Social
+        case "x":
+            return { endpoint: "search-recent-tweets", params: { query: task } };
+        // Knowledge
+        case "wolframalpha":
+            return { endpoint: "short-answer", params: { input: task } };
+        // Security
+        case "virustotal":
+            return { endpoint: url ? "url-report" : "domain-report", params: url ? { resource: url } : { domain: task } };
+        // Default — try common param names
+        default:
+            return {
+                endpoint: endpoints[0]?.toLowerCase().replace(/\s+/g, "-") || "search",
+                params: { query: task, prompt: task, q: task, input: task },
+            };
+    }
+}
+//# sourceMappingURL=locus.js.map

package/dist/wallet/handlers/locus.js.map

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

package/dist/wallet/payment-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-router.d.ts","sourceRoot":"","sources":["../../src/wallet/payment-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AASvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CAkFxB"}
+{"version":3,"file":"payment-router.d.ts","sourceRoot":"","sources":["../../src/wallet/payment-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAWvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CA4FxB"}

package/dist/wallet/payment-router.js

@@ -8,6 +8,8 @@ import { handleL402Payment } from "./handlers/l402.js";
 import { handleMPPPayment } from "./handlers/mpp.js";
 import { handleNanopayment } from "./handlers/nanopayments.js";
 import { handleFreePayment } from "./handlers/free.js";
+import { handleBankrPayment } from "./handlers/bankr.js";
+import { handleLocusPayment } from "./handlers/locus.js";
 import { ensureSufficientBalance } from "./bridge.js";
 export async function routePayment(wallet, agent, task, options) {
     const protocol = determinePaymentProtocol(agent);
@@ -47,6 +49,14 @@ export async function routePayment(wallet, agent, task, options) {
                 const result = await handleNanopayment(wallet, agent, task);
                 return { ...result, protocol: "circle-nanopayments", costUSDC: parseFloat(agent.pricing?.amount ?? "0") };
             }
+            case "bankr": {
+                const result = await handleBankrPayment(wallet, agent, task);
+                return { ...result, protocol: "bankr", costUSDC: parseFloat(agent.pricing?.amount ?? "0") };
+            }
+            case "locus": {
+                const result = await handleLocusPayment(wallet, agent, task);
+                return { ...result, protocol: "locus", costUSDC: parseFloat(agent.pricing?.amount ?? "0") };
+            }
             case "free":
             case "mcp": {
                 // MCP servers and free tools — try to execute directly
@@ -106,6 +116,8 @@ function determinePaymentProtocol(agent) {
         case "l402-directory": return "l402";
         case "mcp-registry": return "free";
         case "skills-registry": return "free";
+        case "bankr": return "bankr";
+        case "locus": return "locus";
         default: return agent.protocol === "onchain" ? "acp" : "free";
     }
 }

package/dist/wallet/payment-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-router.js","sourceRoot":"","sources":["../../src/wallet/payment-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAYtD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAqB,EACrB,KAAmB,EACnB,IAAY,EACZ,OAA8C;IAE9C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,8DAA8D;QAC9D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC;YAClE,IAAI,CAAC;gBACH,MAAM,uBAAuB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ;oBACR,KAAK,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;iBACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7F,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;YACnG,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7E,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;YACnD,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC3D,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;YAClG,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC5D,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5G,CAAC;YAED,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,uDAAuD;gBACvD,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;oBACxB,wCAAwC;oBACxC,IAAI,CAAC;wBACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;wBACxD,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;wBACpC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;wBACrD,OAAO;4BACL,OAAO,EAAE,SAAS,CAAC,OAAO;4BAC1B,QAAQ,EAAE,KAAK;4BACf,WAAW,EAAE,SAAS,CAAC,WAAW;4BAClC,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,QAAQ,EAAE,CAAC;yBACZ,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;wBACP,+BAA+B;oBACjC,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACpD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACtD,CAAC;YAED;gBACE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,iCAAiC,QAAQ,EAAE;iBACnD,CAAC;QACN,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAmB;IACnD,aAAa;IACb,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oCAAoC;IACpC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEtC,oBAAoB;IACpB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC;QACzB,KAAK,gBAAgB,CAAC,CAAC,OAAO,MAAM,CAAC;QACrC,KAAK,gBAAgB,CAAC,CAAC,OAAO,MAAM,CAAC;QACrC,KAAK,cAAc,CAAC,CAAC,OAAO,MAAM,CAAC;QACnC,KAAK,iBAAiB,CAAC,CAAC,OAAO,MAAM,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,CAAC;AACH,CAAC"}
+{"version":3,"file":"payment-router.js","sourceRoot":"","sources":["../../src/wallet/payment-router.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kompass-sdk",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Get any job done. Universal agent capability discovery + coordination across ACP, MCP, x402, A2A, skills, L402, and ERC-8004.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/matching.ts

@@ -147,6 +147,15 @@ function multiCriteriaScore(agent: UnifiedAgent): number {
   const endpointCount = Object.values(agent.endpoints).filter(Boolean).length;
   score += endpointCount * 2;
 
+  // MCP servers with remote endpoints are directly callable — boost them
+  // They don't have reputation data so they'd otherwise rank too low
+  if (agent.protocol === "mcp" && agent.endpoints.mcp) {
+    score += 8; // Callable remote MCP server bonus
+  }
+
+  // Free tools get a small accessibility bonus (no wallet needed)
+  if (agent.pricing?.model === "free") score += 3;
+
   // Recency
   if (agent.lastSeen) {
     const hoursSince = (Date.now() - agent.lastSeen) / (1000 * 60 * 60);

package/src/sources/acp.ts

@@ -1,26 +1,37 @@
 /**
  * Virtuals ACP Source Adapter
- * Searches the ACP marketplace via CLI (most reliable method)
+ * Searches the ACP marketplace via HTTP API at acpx.virtuals.gg
  */
 
-import { execSync } from "child_process";
 import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
 
-const ACP_CLI_PATH = "/tmp/openclaw-acp";
+const ACP_API = "https://acpx.virtuals.gg/api/agents";
 
 export const acpAdapter: SourceAdapter = {
   name: "acp",
   displayName: "Virtuals ACP Marketplace",
 
   async search(query: string, options?: SourceSearchOptions): Promise<UnifiedAgent[]> {
+    const limit = options?.limit ?? 20;
+    const timeout = options?.timeout ?? 15000;
+
     try {
-      const result = execSync(
-        `cd ${ACP_CLI_PATH} && npx acp browse "${query}" --json 2>/dev/null`,
-        { timeout: options?.timeout ?? 30000, encoding: "utf-8" }
-      );
+      const url = new URL(ACP_API);
+      if (query) url.searchParams.set("q", query);
+      url.searchParams.set("limit", String(limit));
+
+      const res = await fetch(url.toString(), {
+        signal: AbortSignal.timeout(timeout),
+      });
+
+      if (!res.ok) return [];
+
+      const json = await res.json();
+      const agents = json.data ?? json.results ?? json;
+
+      if (!Array.isArray(agents)) return [];
 
-      const agents: any[] = JSON.parse(result);
-      return agents.slice(0, options?.limit ?? 50).map(mapAcpAgent);
+      return agents.slice(0, limit).map(mapAcpAgent);
     } catch {
       return [];
     }
@@ -28,11 +39,10 @@ export const acpAdapter: SourceAdapter = {
 
   async ping(): Promise<boolean> {
     try {
-      execSync(`cd ${ACP_CLI_PATH} && npx acp whoami --json 2>/dev/null`, {
-        timeout: 10000,
-        encoding: "utf-8",
+      const res = await fetch(`${ACP_API}?limit=1`, {
+        signal: AbortSignal.timeout(5000),
       });
-      return true;
+      return res.ok;
     } catch {
       return false;
     }
@@ -40,7 +50,7 @@ export const acpAdapter: SourceAdapter = {
 };
 
 function mapAcpAgent(agent: any): UnifiedAgent {
-  const offerings = agent.jobs ?? agent.jobOfferings ?? [];
+  const offerings = agent.jobs ?? agent.jobOfferings ?? agent.offerings ?? [];
   const topOffering = offerings[0];
 
   return {
@@ -49,7 +59,7 @@ function mapAcpAgent(agent: any): UnifiedAgent {
     name: agent.name ?? "Unknown ACP Agent",
     description: agent.description ?? offerings.map((o: any) => o.description).join(". ") ?? "",
     categories: extractAcpCategories(agent, offerings),
-    capabilities: offerings.map((o: any) => `${o.name}: ${o.description ?? ""}`),
+    capabilities: offerings.map((o: any) => `${o.name}: ${o.description ?? ""}${o.requirement ? ` [expects: ${typeof o.requirement === 'object' ? Object.keys(o.requirement).join(', ') : o.requirement}]` : ""}`),
     source: "acp",
     protocol: "acp",
     endpoints: {
@@ -59,18 +69,17 @@ function mapAcpAgent(agent: any): UnifiedAgent {
       },
     },
     reputation: agent.metrics ? {
-      score: agent.metrics.successRate ?? 0,
-      count: agent.metrics.completedJobs ?? agent.metrics.successfulJobCount ?? 0,
+      score: agent.metrics.successRate ?? agent.successRate ?? 0,
+      count: agent.metrics.successfulJobCount ?? agent.successfulJobCount ?? 0,
       source: "acp",
     } : undefined,
-    // Surface online status — skip offline agents in ranking
     lastSeen: agent.metrics?.isOnline ? Date.now() : (agent.metrics?.minsFromLastOnlineTime ? Date.now() - agent.metrics.minsFromLastOnlineTime * 60000 : undefined),
     pricing: topOffering ? {
       model: "escrow",
-      amount: String(topOffering.price ?? "0"),
+      amount: String(topOffering.price ?? topOffering.priceUsd ?? "0"),
       currency: "USDC",
     } : undefined,
-    verified: true, // ACP agents are registered
+    verified: true,
     raw: agent,
   };
 }

package/src/sources/bankr.ts

@@ -0,0 +1,87 @@
+/**
+ * Bankr Source Adapter
+ * Searches Bankr LLM Gateway for trading/DeFi agent services
+ * API at https://api.bankr.bot
+ */
+
+import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
+
+const BANKR_API = "https://api.bankr.bot";
+
+export const bankrAdapter: SourceAdapter = {
+  name: "bankr",
+  displayName: "Bankr Trading Gateway",
+
+  async search(query: string, options?: SourceSearchOptions): Promise<UnifiedAgent[]> {
+    const limit = options?.limit ?? 20;
+    const timeout = options?.timeout ?? 10000;
+
+    try {
+      const apiKey = process.env.BANKR_API_KEY;
+      if (!apiKey) return [];
+
+      const headers: Record<string, string> = {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey,
+      };
+
+      const url = new URL(`${BANKR_API}/agents`);
+      if (query) url.searchParams.set("q", query);
+      url.searchParams.set("limit", String(limit));
+
+      const res = await fetch(url.toString(), {
+        headers,
+        signal: AbortSignal.timeout(timeout),
+      });
+
+      if (!res.ok) return [];
+
+      const data = await res.json();
+      const agents = data.agents ?? data.data ?? data.results ?? data;
+
+      if (!Array.isArray(agents)) return [];
+
+      return agents.slice(0, limit).map(mapBankrAgent);
+    } catch {
+      return [];
+    }
+  },
+
+  async ping(): Promise<boolean> {
+    try {
+      const res = await fetch(`${BANKR_API}/agent/prompt`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ prompt: "ping" }),
+        signal: AbortSignal.timeout(5000),
+      });
+      // 401 means the API is alive, just needs auth
+      return res.status === 401 || res.ok;
+    } catch {
+      return false;
+    }
+  },
+};
+
+function mapBankrAgent(agent: any): UnifiedAgent {
+  return {
+    id: `bankr:${agent.id ?? agent.name ?? agent.slug}`,
+    nativeId: agent.id ?? agent.slug ?? "",
+    name: agent.name ?? "Bankr Agent",
+    description: agent.description ?? "",
+    categories: agent.categories ?? ["defi", "trading"],
+    capabilities: agent.capabilities ?? [agent.description ?? ""].filter(Boolean),
+    source: "bankr",
+    protocol: "http",
+    endpoints: {
+      http: agent.endpoint ?? `${BANKR_API}/agent/prompt`,
+    },
+    pricing: {
+      model: agent.pricing?.model ?? "per-call",
+      amount: agent.pricing?.amount ?? "0.01",
+      currency: agent.pricing?.currency ?? "USDC",
+    },
+    verified: agent.verified ?? true,
+    raw: agent,
+  };
+}

package/src/sources/index.ts

@@ -14,6 +14,9 @@ import { a2aWellknownAdapter } from "./a2a-wellknown.js";
 import { l402DirectoryAdapter } from "./l402-directory.js";
 import { adpAdapter } from "./adp.js";
 import { skillsAdapter } from "./skills.js";
+import { bankrAdapter } from "./bankr.js";
+import { locusAdapter } from "./locus.js";
+import { olasAdapter } from "./olas.js";
 
 export interface SourceRegistryConfig {
   /** Kompass SDK config (for kompass-registry adapter) */
@@ -34,6 +37,9 @@ export function createAllSources(config?: SourceRegistryConfig): SourceAdapter[]
     l402DirectoryAdapter,
     adpAdapter,
     skillsAdapter,
+    bankrAdapter,
+    locusAdapter,
+    olasAdapter,
   ];
 
   // Add Kompass registry if config provided