kompass-sdk 0.4.0 → 0.6.0

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kompass-sdk",
-  "version": "0.4.0",
+  "version": "0.6.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/cli.ts

@@ -248,14 +248,24 @@ program
   .option("--json", "output as JSON")
   .option("--log <path>", "write structured agent_log.json to path")
   .option("--manifest <path>", "write agent.json manifest to path")
+  .option("-w, --wallet <path>", "path to Kompass wallet keystore")
   .action(
     async (
       task: string,
-      opts: { budget: string; cost: string; protocol?: string; dryRun?: boolean; json?: boolean; log?: string; manifest?: string }
+      opts: { budget: string; cost: string; protocol?: string; dryRun?: boolean; json?: boolean; log?: string; manifest?: string; wallet?: string }
     ) => {
       const { KompassUnified } = await import("./unified.js");
       const { writeFileSync } = await import("fs");
-      const kompass = await KompassUnified.create();
+
+      // Load wallet if specified
+      let walletInstance: any = undefined;
+      if (opts.wallet) {
+        const { KompassWallet } = await import("./wallet/index.js");
+        walletInstance = KompassWallet.load(opts.wallet);
+        if (!opts.json) console.log(`Using wallet: ${walletInstance.getAddress()} (${walletInstance.getNetwork()})`);
+      }
+
+      const kompass = await KompassUnified.create({ wallet: walletInstance });
 
       if (!opts.json) {
         console.log(`\n⚡ Kompass: Getting it done — "${task}"\n`);

package/src/router.ts

@@ -16,6 +16,8 @@ import { Aggregator } from "./aggregator.js";
 import { rankAgents, parseIntent, type MatchResult } from "./matching.js";
 import { ProtocolBridge, type BridgeHireResult } from "./bridge.js";
 import { ReputationWriter, type ReputationWriterConfig } from "./reputation-writer.js";
+import { routePayment, type PaymentResult } from "./wallet/payment-router.js";
+import type { KompassWallet } from "./wallet/index.js";
 
 export type CostPreference = "cheapest" | "balanced" | "best-quality";
 
@@ -71,10 +73,12 @@ export class CapabilityRouter {
   private aggregator: Aggregator;
   private bridge: ProtocolBridge;
   private reputationWriter?: ReputationWriter;
+  private wallet?: KompassWallet;
 
-  constructor(aggregator: Aggregator, bridge: ProtocolBridge, reputationConfig?: ReputationWriterConfig) {
+  constructor(aggregator: Aggregator, bridge: ProtocolBridge, reputationConfig?: ReputationWriterConfig, wallet?: KompassWallet) {
     this.aggregator = aggregator;
     this.bridge = bridge;
+    this.wallet = wallet;
     if (reputationConfig) {
       this.reputationWriter = new ReputationWriter(reputationConfig);
     }
@@ -142,18 +146,49 @@ export class CapabilityRouter {
       };
     }
 
-    // 7. Execute (unless dry run)
+    // 7. Execute (unless dry run) — with retry on failure
     let execution: BridgeHireResult | null = null;
+    let actualSelected = selected;
 
     if (!dryRun) {
-      execution = await this.bridge.hire(selected.agent, {
-        task,
-        timeout: options.timeout,
-        payload: options.payload,
-      });
+      // Try up to 5 candidates if one fails/rejects
+      for (let attempt = 0; attempt < Math.min(5, reranked.length); attempt++) {
+        const candidate = reranked[attempt];
+        actualSelected = candidate;
+
+        if (this.wallet) {
+          const paymentResult = await routePayment(this.wallet, candidate.agent, task);
+          execution = {
+            success: paymentResult.success,
+            protocol: paymentResult.protocol as any,
+            agent: candidate.agent,
+            jobId: paymentResult.jobId,
+            deliverable: paymentResult.deliverable,
+            txHash: paymentResult.txHash,
+            error: paymentResult.error,
+            durationMs: 0,
+          };
+        } else {
+          execution = await this.bridge.hire(candidate.agent, {
+            task,
+            timeout: options.timeout,
+            payload: options.payload,
+          });
+        }
+
+        if (execution?.success) break;
+
+        // Log failure and try next candidate
+        const phase = (execution?.deliverable as any)?.phase;
+        if (phase === "REJECTED" || !execution?.success) {
+          console.log(`[Kompass] ${candidate.agent.name} failed/rejected. Trying next candidate...`);
+          continue;
+        }
+        break;
+      }
 
       // 8. Write ERC-8004 reputation feedback on-chain
-      if (this.reputationWriter && selected.agent.reputation?.source === "erc8004") {
+      if (this.reputationWriter && actualSelected.agent.reputation?.source === "erc8004") {
         const agentId = BigInt(selected.agent.nativeId || "0");
         if (agentId > 0n) {
           const category = selected.agent.categories[0] ?? "general";
@@ -167,13 +202,13 @@ export class CapabilityRouter {
       }
     }
 
-    const reasoning = this.explainChoice(selected, reranked, options);
+    const reasoning = this.explainChoice(actualSelected, reranked, options);
 
     return {
       success: dryRun ? true : (execution?.success ?? false),
       task,
       options: capabilityOptions.slice(0, 10), // Top 10 options
-      selected,
+      selected: actualSelected,
       execution,
       discovery: {
         sourcesQueried: searchResult.sources.length,
@@ -214,15 +249,6 @@ export class CapabilityRouter {
   private applyPreferences(options: CapabilityOption[], doOptions: DoOptions): CapabilityOption[] {
     let sorted = [...options];
 
-    // Protocol preference
-    if (doOptions.preferProtocol) {
-      sorted.sort((a, b) => {
-        const aMatch = a.protocol === doOptions.preferProtocol ? 1 : 0;
-        const bMatch = b.protocol === doOptions.preferProtocol ? 1 : 0;
-        return bMatch - aMatch;
-      });
-    }
-
     // Source preference
     if (doOptions.preferSource) {
       sorted.sort((a, b) => {
@@ -265,6 +291,13 @@ export class CapabilityRouter {
         break;
     }
 
+    // Protocol preference — ALWAYS applied last to take highest priority
+    if (doOptions.preferProtocol) {
+      const preferred = sorted.filter((o) => o.protocol === doOptions.preferProtocol || o.source === doOptions.preferProtocol);
+      const rest = sorted.filter((o) => o.protocol !== doOptions.preferProtocol && o.source !== doOptions.preferProtocol);
+      sorted = [...preferred, ...rest];
+    }
+
     return sorted;
   }
 

package/src/sources/l402-directory.ts

@@ -1,51 +1,71 @@
 /**
- * L402 Directory Source Adapter
- * Indexes Lightning 402 endpoints from known directories
+ * L402 Lightning Directory Source Adapter
+ * Searches 402index.io filtered to L402 (Lightning) protocol
+ * Real data — not hardcoded seed list
  */
 
 import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
 
-// Known L402 services (from satring, l402.directory, and community)
-const KNOWN_L402_SERVICES = [
-  { name: "Satring", url: "https://satring.com", description: "Curated L402 + x402 API directory. 36 endpoints across 4 providers", categories: ["directory", "tools"] },
-  { name: "Lightning Faucet L402", url: "https://lightningfaucet.com", description: "L402 API registry and testing tools", categories: ["tools", "testing"] },
-  { name: "Nostr NIP-68 Bridge", url: "https://l402.nostr.com", description: "L402 payments over Nostr relay network", categories: ["social", "payments"] },
-  { name: "Stacker News", url: "https://stacker.news", description: "Lightning-powered news with L402 API access", categories: ["content", "data"] },
-  { name: "Nodana", url: "https://nodana.io", description: "L402 agentic access for Bitcoin app deployment", categories: ["development", "compute"] },
-];
+const INDEX_API = "https://402index.io/api/v1/services";
 
 export const l402DirectoryAdapter: SourceAdapter = {
   name: "l402-directory",
-  displayName: "L402 Lightning Directory",
+  displayName: "L402 Lightning Directory (402index)",
 
   async search(query: string, options?: SourceSearchOptions): Promise<UnifiedAgent[]> {
-    const lower = query.toLowerCase();
-    const filtered = query
-      ? KNOWN_L402_SERVICES.filter(
-          (s) =>
-            s.name.toLowerCase().includes(lower) ||
-            s.description.toLowerCase().includes(lower) ||
-            s.categories.some((c) => c.includes(lower))
-        )
-      : KNOWN_L402_SERVICES;
-
-    return filtered.slice(0, options?.limit ?? 50).map((service) => ({
-      id: `l402-directory:${service.name.toLowerCase().replace(/\s+/g, "-")}`,
-      nativeId: service.name,
-      name: service.name,
-      description: service.description,
-      categories: service.categories,
-      capabilities: [service.description],
-      source: "l402-directory" as const,
-      protocol: "l402" as const,
-      endpoints: { l402: service.url, http: service.url },
-      pricing: { model: "per-call" as const, currency: "BTC/sats" },
-      verified: true,
-      raw: service,
-    }));
+    const limit = options?.limit ?? 20;
+    const timeout = options?.timeout ?? 10000;
+
+    try {
+      const url = new URL(INDEX_API);
+      if (query) url.searchParams.set("q", query);
+      url.searchParams.set("protocol", "L402");
+      url.searchParams.set("limit", String(limit));
+      url.searchParams.set("health", "healthy");
+      url.searchParams.set("sort", "reliability");
+
+      const res = await fetch(url.toString(), { signal: AbortSignal.timeout(timeout) });
+      if (!res.ok) return [];
+
+      const data = await res.json();
+      const services = data.services ?? data.data ?? [];
+      if (!Array.isArray(services)) return [];
+
+      return services.slice(0, limit).map((s: any) => ({
+        id: `l402-directory:${s.id ?? s.url}`,
+        nativeId: s.id ?? s.name,
+        name: (s.name ?? "L402 Service").replace(/^\s+/g, "").split("\n")[0].trim().slice(0, 100),
+        description: (s.description ?? "").replace(/^\s+|\s+$/g, "").replace(/\s+/g, " ").slice(0, 300),
+        categories: s.category ? s.category.split("/").map((c: string) => c.trim()) : ["general"],
+        capabilities: [s.description ?? s.name ?? ""],
+        source: "l402-directory" as const,
+        protocol: "l402" as const,
+        endpoints: { l402: s.url, http: s.url },
+        pricing: {
+          model: "per-call" as const,
+          amount: s.price_sats ? `${s.price_sats} sats` : s.price_usd ? String(s.price_usd) : undefined,
+          currency: "sats",
+        },
+        reputation: s.reliability_score ? {
+          score: s.reliability_score,
+          count: s.uptime_30d ? Math.round(s.uptime_30d * 100) : 0,
+          source: "402index",
+        } : undefined,
+        verified: s.health_status === "healthy",
+        lastSeen: s.last_checked ? new Date(s.last_checked).getTime() : undefined,
+        raw: s,
+      }));
+    } catch {
+      return [];
+    }
   },
 
   async ping(): Promise<boolean> {
-    return true; // Seed list always available
+    try {
+      const res = await fetch(`${INDEX_API}?protocol=L402&limit=1`, { signal: AbortSignal.timeout(5000) });
+      return res.ok;
+    } catch {
+      return false;
+    }
   },
 };

package/src/sources/skills.ts

@@ -1,13 +1,16 @@
 /**
  * Skills Source Adapter
- * Searches skills.sh (Vercel) and ClawHub registries for agent skills
- * 13,700+ capabilities indexed across both registries
+ * Searches REAL APIs:
+ * - skills.sh (Vercel) — /api/search?q=
+ * - ClawHub (OpenClaw) — /api/search?q= (vector search)
+ *
+ * No hardcoded seed lists. All real data.
  */
 
 import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
 
-const SKILLS_SH_API = "https://skills.sh";
-const CLAWHUB_API = "https://clawhub.ai";
+const SKILLS_SH_API = "https://skills.sh/api/search";
+const CLAWHUB_API = "https://clawhub.ai/api/search";
 
 export const skillsAdapter: SourceAdapter = {
   name: "skills-registry",
@@ -19,143 +22,111 @@ export const skillsAdapter: SourceAdapter = {
     const results: UnifiedAgent[] = [];
 
     // Search skills.sh
-    try {
-      const skillsShResults = await searchSkillsSh(query, Math.ceil(limit / 2), timeout);
-      results.push(...skillsShResults);
-    } catch {
-      // skills.sh might not have a public search API — fall back to known skills
-    }
-
-    // Search ClawHub
-    try {
-      const clawHubResults = await searchClawHub(query, Math.ceil(limit / 2), timeout);
-      results.push(...clawHubResults);
-    } catch {
-      // ClawHub might be rate-limited
-    }
+    const [skillsShResults, clawHubResults] = await Promise.allSettled([
+      searchSkillsSh(query, Math.ceil(limit / 2), timeout),
+      searchClawHub(query, Math.ceil(limit / 2), timeout),
+    ]);
 
-    // If both APIs fail, return from seed list
-    if (results.length === 0) {
-      return searchSeedList(query, limit);
-    }
+    if (skillsShResults.status === "fulfilled") results.push(...skillsShResults.value);
+    if (clawHubResults.status === "fulfilled") results.push(...clawHubResults.value);
 
     return results.slice(0, limit);
   },
 
   async ping(): Promise<boolean> {
     try {
-      const res = await fetch(SKILLS_SH_API, { signal: AbortSignal.timeout(3000) });
+      const res = await fetch(`${SKILLS_SH_API}?q=test`, { signal: AbortSignal.timeout(3000) });
       return res.ok;
     } catch {
-      return true; // Seed list always available
+      return false;
     }
   },
 };
 
 async function searchSkillsSh(query: string, limit: number, timeout: number): Promise<UnifiedAgent[]> {
-  // skills.sh has a search page — try to query it
-  const res = await fetch(`${SKILLS_SH_API}/api/search?q=${encodeURIComponent(query)}&limit=${limit}`, {
-    signal: AbortSignal.timeout(timeout),
-  });
-
-  if (!res.ok) {
-    // Try the leaderboard endpoint
-    const lbRes = await fetch(`${SKILLS_SH_API}/api/leaderboard?limit=${limit}`, {
+  try {
+    const res = await fetch(`${SKILLS_SH_API}?q=${encodeURIComponent(query)}`, {
       signal: AbortSignal.timeout(timeout),
     });
-    if (!lbRes.ok) return [];
-    const data = await lbRes.json();
-    const skills = Array.isArray(data) ? data : data.skills ?? data.data ?? [];
-    return skills
-      .filter((s: any) => matchesQuery(s, query))
-      .map((s: any) => mapSkill(s, "skills-sh"));
-  }
 
-  const data = await res.json();
-  const skills = Array.isArray(data) ? data : data.skills ?? data.results ?? [];
-  return skills.map((s: any) => mapSkill(s, "skills-sh"));
+    if (!res.ok) return [];
+
+    const data = await res.json();
+    const skills = data.skills ?? [];
+
+    return skills.slice(0, limit).map((s: any) => ({
+      id: `skills-registry:skills-sh:${s.id ?? s.skillId}`,
+      nativeId: s.id ?? s.skillId,
+      name: s.name ?? s.skillId ?? "Unknown Skill",
+      description: s.description ?? "",
+      categories: extractSkillCategories(s.name ?? "", s.description ?? ""),
+      capabilities: [s.name, s.description].filter(Boolean),
+      source: "skills-registry" as const,
+      protocol: "skill" as const,
+      endpoints: {
+        http: `https://skills.sh/${s.source ?? s.id}`,
+      },
+      pricing: { model: "free" as const },
+      verified: (s.installs ?? 0) > 100,
+      reputation: s.installs ? {
+        score: Math.min(s.installs / 100, 100),
+        count: s.installs,
+        source: "skills-sh-installs",
+      } : undefined,
+      raw: { ...s, registry: "skills-sh" },
+    }));
+  } catch {
+    return [];
+  }
 }
 
 async function searchClawHub(query: string, limit: number, timeout: number): Promise<UnifiedAgent[]> {
-  const res = await fetch(`${CLAWHUB_API}/api/skills/search?q=${encodeURIComponent(query)}&limit=${limit}`, {
-    signal: AbortSignal.timeout(timeout),
-  });
-
-  if (!res.ok) return [];
-
-  const data = await res.json();
-  const skills = Array.isArray(data) ? data : data.skills ?? data.results ?? [];
-  return skills.map((s: any) => mapSkill(s, "clawhub"));
-}
-
-function mapSkill(skill: any, registry: string): UnifiedAgent {
-  const name = skill.name ?? skill.slug ?? skill.title ?? "Unknown Skill";
-  const description = skill.description ?? "";
-  const repo = skill.repo ?? skill.repository ?? skill.url ?? "";
-  const installs = skill.installs ?? skill.downloads ?? 0;
-
-  return {
-    id: `skills-registry:${registry}:${name.toLowerCase().replace(/\s+/g, "-")}`,
-    nativeId: skill.id ?? name,
-    name,
-    description,
-    categories: extractSkillCategories(name, description),
-    capabilities: [description, ...(skill.tags ?? [])],
-    source: "skills-registry" as any,
-    protocol: "skill" as any,
-    endpoints: {
-      http: repo || `https://skills.sh/${name}`,
-    },
-    pricing: { model: "free" as const },
-    verified: installs > 100,
-    lastSeen: Date.now(),
-    raw: { ...skill, registry },
-  };
-}
-
-// Seed list of well-known skills for when APIs are unavailable
-const KNOWN_SKILLS = [
-  { name: "remotion-best-practices", description: "Video creation in React with Remotion", categories: ["media", "development"], registry: "skills-sh", installs: 145000 },
-  { name: "web-design-guidelines", description: "UI/UX design best practices for web development", categories: ["design", "development"], registry: "skills-sh", installs: 89000 },
-  { name: "react-best-practices", description: "React and Next.js performance optimization from Vercel", categories: ["development"], registry: "skills-sh", installs: 120000 },
-  { name: "solana-dev", description: "End-to-end Solana development playbook", categories: ["development", "defi"], registry: "skills-sh", installs: 50000 },
-  { name: "cairo-contracts", description: "Write Cairo smart contracts on Starknet", categories: ["development", "defi"], registry: "skills-sh", installs: 30000 },
-  { name: "x402-skill", description: "x402 HTTP payment protocol for monetizing APIs", categories: ["payments", "development"], registry: "skills-sh", installs: 25000 },
-  { name: "agent-browser", description: "Automate browser interactions, screenshots, form filling", categories: ["tools", "automation"], registry: "skills-sh", installs: 70000 },
-  { name: "implement-design", description: "Translate Figma designs into production-ready code", categories: ["design", "development"], registry: "skills-sh", installs: 60000 },
-  { name: "find-skills", description: "Discover and install new agent skills", categories: ["tools", "discovery"], registry: "skills-sh", installs: 200000 },
-  { name: "tailwind-v4-shadcn", description: "Set up Tailwind v4 with shadcn/ui", categories: ["development", "design"], registry: "skills-sh", installs: 45000 },
-  { name: "ethskills", description: "Learn Ethereum, Solidity, smart contracts, web3 development", categories: ["development", "defi"], registry: "skills-sh", installs: 8000 },
-  { name: "soul-markets", description: "Agent skill marketplace — monetize agent capabilities", categories: ["marketplace", "commerce"], registry: "clawhub", installs: 5000 },
-  { name: "a2a-market", description: "Buy and sell agent skills using USDC on Base via A2A", categories: ["marketplace", "commerce"], registry: "clawhub", installs: 3000 },
-  { name: "skillzmarket", description: "Discover and install skills from community marketplace", categories: ["marketplace", "discovery"], registry: "clawhub", installs: 4000 },
-  { name: "x402-agent-marketplace", description: "x402 agent marketplace for paid AI capabilities", categories: ["marketplace", "payments"], registry: "clawhub", installs: 2000 },
-];
-
-function searchSeedList(query: string, limit: number): UnifiedAgent[] {
-  const lower = query.toLowerCase();
-  return KNOWN_SKILLS
-    .filter((s) => matchesQuery(s, query))
-    .slice(0, limit)
-    .map((s) => mapSkill({ ...s, installs: s.installs }, s.registry));
-}
+  try {
+    const res = await fetch(`${CLAWHUB_API}?q=${encodeURIComponent(query)}`, {
+      signal: AbortSignal.timeout(timeout),
+    });
 
-function matchesQuery(skill: any, query: string): boolean {
-  if (!query) return true;
-  const lower = query.toLowerCase();
-  const text = `${skill.name ?? ""} ${skill.description ?? ""} ${(skill.tags ?? []).join(" ")} ${(skill.categories ?? []).join(" ")}`.toLowerCase();
-  return lower.split(/\s+/).some((term) => text.includes(term));
+    if (!res.ok) return [];
+
+    const data = await res.json();
+    const skills = data.results ?? [];
+
+    return skills.slice(0, limit).map((s: any) => ({
+      id: `skills-registry:clawhub:${s.slug}`,
+      nativeId: s.slug,
+      name: s.displayName ?? s.slug ?? "Unknown Skill",
+      description: s.summary ?? "",
+      categories: extractSkillCategories(s.displayName ?? "", s.summary ?? ""),
+      capabilities: [s.summary ?? s.displayName ?? ""],
+      source: "skills-registry" as const,
+      protocol: "skill" as const,
+      endpoints: {
+        http: `https://clawhub.ai/${s.slug}`,
+      },
+      pricing: { model: "free" as const },
+      verified: true,
+      reputation: s.score ? {
+        score: Math.round(s.score * 25),
+        count: 0,
+        source: "clawhub-relevance",
+      } : undefined,
+      raw: { ...s, registry: "clawhub" },
+    }));
+  } catch {
+    return [];
+  }
 }
 
 function extractSkillCategories(name: string, description: string): string[] {
   const text = `${name} ${description}`.toLowerCase();
   const cats: string[] = [];
   if (text.match(/react|next|vue|svelte|frontend|css|tailwind|design/)) cats.push("development");
-  if (text.match(/defi|yield|swap|solidity|ethereum|solana|contract/)) cats.push("defi");
+  if (text.match(/defi|yield|swap|solidity|ethereum|solana|contract|crypto/)) cats.push("defi");
   if (text.match(/image|video|audio|media|remotion|figma/)) cats.push("media");
-  if (text.match(/data|analytics|research|search/)) cats.push("data");
+  if (text.match(/data|analytics|research|search|scrape/)) cats.push("data");
   if (text.match(/browser|automat|tool|file/)) cats.push("tools");
   if (text.match(/market|commerce|pay|x402|monetiz/)) cats.push("commerce");
   if (text.match(/security|audit|test/)) cats.push("security");
+  if (text.match(/ai|llm|model|agent/)) cats.push("ai");
   return cats.length > 0 ? cats : ["general"];
 }