kompass-sdk 0.13.0 → 0.15.0

package/dist/wallet/handlers/locus.js

@@ -0,0 +1,144 @@
+/**
+ * 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 first/most relevant endpoint
+            // For now use the first endpoint — the provider slug is already in the URL
+            const endpoint = availableEndpoints[0]?.toLowerCase().replace(/\s+/g, "-") || "search";
+            const callUrl = `${LOCUS_API}/wrapped/${provider}/${endpoint}`;
+            const callRes = await fetch(callUrl, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ query: task, prompt: task, q: task }),
+                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) },
+        };
+    }
+}
+//# 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.13.0",
+  "version": "0.15.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

@@ -49,7 +49,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: {

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,8 @@ 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";
 
 export interface SourceRegistryConfig {
   /** Kompass SDK config (for kompass-registry adapter) */
@@ -34,6 +36,8 @@ export function createAllSources(config?: SourceRegistryConfig): SourceAdapter[]
     l402DirectoryAdapter,
     adpAdapter,
     skillsAdapter,
+    bankrAdapter,
+    locusAdapter,
   ];
 
   // Add Kompass registry if config provided

package/src/sources/locus.ts

@@ -0,0 +1,156 @@
+/**
+ * Locus Wrapped API Source Adapter
+ * Fetches Locus's live API catalog and indexes 50+ pay-per-use providers
+ * as discoverable capabilities. Each wrapped API becomes a searchable agent.
+ * Agents pay per-call via USDC on Base — no upstream API keys needed.
+ *
+ * Docs: https://beta.paywithlocus.com/skill.md
+ * Live index: https://beta.paywithlocus.com/wapi/index.md
+ */
+
+import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
+
+const LOCUS_API = "https://beta-api.paywithlocus.com/api";
+const WAPI_INDEX_URL = "https://beta.paywithlocus.com/wapi/index.md";
+
+interface LocusProvider {
+  name: string;
+  slug: string;
+  category: string;
+  endpoints: string;
+  description: string;
+}
+
+// Cache fetched providers — refresh every 10 minutes
+let providerCache: LocusProvider[] | null = null;
+let cacheTime = 0;
+const CACHE_TTL = 10 * 60 * 1000;
+
+/**
+ * Parse the live markdown index from Locus into structured provider data.
+ * The index is a markdown table with columns: Provider, Category, Endpoints, Description
+ */
+function parseMarkdownIndex(md: string): LocusProvider[] {
+  const providers: LocusProvider[] = [];
+  const lines = md.split("\n");
+
+  for (const line of lines) {
+    // Match table rows: | [Provider Name](url) | Category | Endpoints | Description |
+    const match = line.match(/^\| \[([^\]]+)\]\(https:\/\/[^)]*\/wapi\/([^.]+)\.md\)\s*\|\s*([^|]+)\|\s*([^|]+)\|\s*([^|]+)\|/);
+    if (match) {
+      providers.push({
+        name: match[1].trim(),
+        slug: match[2].trim(),
+        category: match[3].trim().toLowerCase(),
+        endpoints: match[4].trim(),
+        description: match[5].trim(),
+      });
+    }
+  }
+
+  return providers;
+}
+
+async function fetchProviders(timeout: number): Promise<LocusProvider[]> {
+  if (providerCache && Date.now() - cacheTime < CACHE_TTL) {
+    return providerCache;
+  }
+
+  try {
+    const res = await fetch(WAPI_INDEX_URL, {
+      signal: AbortSignal.timeout(timeout),
+    });
+
+    if (!res.ok) return providerCache ?? [];
+
+    const md = await res.text();
+    const parsed = parseMarkdownIndex(md);
+
+    if (parsed.length > 0) {
+      providerCache = parsed;
+      cacheTime = Date.now();
+    }
+
+    return providerCache ?? [];
+  } catch {
+    return providerCache ?? [];
+  }
+}
+
+export const locusAdapter: SourceAdapter = {
+  name: "locus" as any,
+  displayName: "Locus Wrapped APIs",
+
+  async search(query: string, options?: SourceSearchOptions): Promise<UnifiedAgent[]> {
+    const limit = options?.limit ?? 20;
+    const timeout = options?.timeout ?? 10000;
+    const lower = query.toLowerCase();
+    const terms = lower.split(/\s+/).filter(t => t.length > 2);
+
+    const providers = await fetchProviders(timeout);
+
+    // Score each provider by relevance
+    const scored = providers.map(provider => {
+      let score = 0;
+      const searchText = `${provider.name} ${provider.description} ${provider.category} ${provider.endpoints}`.toLowerCase();
+
+      for (const term of terms) {
+        if (provider.name.toLowerCase().includes(term)) score += 5;
+        if (provider.description.toLowerCase().includes(term)) score += 3;
+        if (provider.endpoints.toLowerCase().includes(term)) score += 2;
+        if (provider.category.includes(term)) score += 4;
+        if (searchText.includes(term)) score += 1;
+      }
+
+      return { provider, score };
+    })
+      .filter(s => s.score > 0)
+      .sort((a, b) => b.score - a.score)
+      .slice(0, limit);
+
+    return scored.map(s => mapLocusProvider(s.provider));
+  },
+
+  async ping(): Promise<boolean> {
+    try {
+      const res = await fetch(WAPI_INDEX_URL, {
+        signal: AbortSignal.timeout(5000),
+      });
+      return res.ok;
+    } catch {
+      return false;
+    }
+  },
+};
+
+function mapLocusProvider(provider: LocusProvider): UnifiedAgent {
+  const endpointList = provider.endpoints.split(",").map(e => e.trim()).slice(0, 5);
+
+  return {
+    id: `locus:${provider.slug}`,
+    nativeId: provider.slug,
+    name: `${provider.name} (via Locus)`,
+    description: `${provider.description} Pay-per-use via USDC — no API key needed.`,
+    categories: [provider.category.split(" / ")[0].toLowerCase(), "api", "pay-per-use"],
+    capabilities: endpointList.map(e => `${provider.name}: ${e}`),
+    source: "locus" as any,
+    protocol: "http",
+    endpoints: {
+      http: `${LOCUS_API}/wrapped/${provider.slug}`,
+    },
+    pricing: {
+      model: "per-call",
+      amount: "0.01",
+      currency: "USDC",
+    },
+    verified: true,
+    lastSeen: Date.now(),
+    raw: {
+      type: "locus-wrapped-api",
+      provider: provider.slug,
+      category: provider.category,
+      endpoints: endpointList,
+      allEndpoints: provider.endpoints,
+    },
+  };
+}