kompass-sdk 0.7.0 → 0.9.0

package/src/sources/adp.ts

@@ -1,51 +1,55 @@
 /**
  * Agent Discovery Protocol (ADP) Source Adapter
- * agentdiscovery.io — open protocol for autonomous agent commerce
+ * Uses the real ADP v2 API at agentdiscovery.io
  */
 
 import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./types.js";
 
-const ADP_BASE = "https://agentdiscovery.io";
+const ADP_BASE = "https://agentdiscovery.io/api/adp/v2";
 
 export const adpAdapter: SourceAdapter = {
   name: "adp",
-  displayName: "Agent Discovery Protocol",
+  displayName: "Agent Discovery Protocol (ADP v2)",
 
   async search(query: string, options?: SourceSearchOptions): Promise<UnifiedAgent[]> {
     try {
-      // Try the ADP API
-      const res = await fetch(`${ADP_BASE}/api/agents?q=${encodeURIComponent(query)}&limit=${options?.limit ?? 20}`, {
+      // First try discovery endpoint with intent
+      const discoverRes = await fetch(`${ADP_BASE}/discover`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ intent: query, category: query }),
         signal: AbortSignal.timeout(options?.timeout ?? 5000),
       });
 
-      if (!res.ok) return [];
+      if (discoverRes.ok) {
+        const data = await discoverRes.json();
+        const agents = data.matches ?? data.agents ?? data.results ?? [];
+        if (Array.isArray(agents) && agents.length > 0) {
+          return agents.slice(0, options?.limit ?? 20).map(mapAdpAgent);
+        }
+      }
 
-      const data = await res.json();
-      const agents = Array.isArray(data) ? data : data.agents ?? data.data ?? [];
+      // Fallback: list all agents
+      const listRes = await fetch(`${ADP_BASE}/agents`, {
+        signal: AbortSignal.timeout(options?.timeout ?? 5000),
+      });
+
+      if (!listRes.ok) return [];
 
-      return agents.map((agent: any) => ({
-        id: `adp:${agent.id ?? agent.address}`,
-        nativeId: String(agent.id ?? agent.address),
-        name: agent.name ?? "ADP Agent",
-        description: agent.description ?? "",
-        categories: agent.categories ?? agent.tags ?? ["general"],
-        capabilities: agent.capabilities ?? [agent.description ?? ""],
-        source: "adp" as const,
-        protocol: (agent.protocol ?? "http") as any,
-        endpoints: {
-          http: agent.endpoint ?? agent.url,
-          a2a: agent.a2aEndpoint,
-          x402: agent.x402Endpoint,
-        },
-        reputation: agent.reputation ? {
-          score: agent.reputation.score ?? 0,
-          count: agent.reputation.count ?? 0,
-          source: "adp",
-        } : undefined,
-        pricing: agent.pricing,
-        verified: agent.verified ?? false,
-        raw: agent,
-      }));
+      const data = await listRes.json();
+      const agents = data.agents ?? [];
+      if (!Array.isArray(agents)) return [];
+
+      // Client-side filter by query
+      const lower = query.toLowerCase();
+      return agents
+        .filter((a: any) => {
+          if (!query) return true;
+          const text = `${a.name ?? ""} ${a.role ?? ""} ${(a.categories ?? []).join(" ")} ${(a.capabilities ?? []).map((c: any) => c.description ?? c.key ?? "").join(" ")}`.toLowerCase();
+          return lower.split(/\s+/).some((t) => text.includes(t));
+        })
+        .slice(0, options?.limit ?? 20)
+        .map(mapAdpAgent);
     } catch {
       return [];
     }
@@ -53,12 +57,30 @@ export const adpAdapter: SourceAdapter = {
 
   async ping(): Promise<boolean> {
     try {
-      const res = await fetch(`${ADP_BASE}/api/health`, {
-        signal: AbortSignal.timeout(3000),
-      });
+      const res = await fetch(`${ADP_BASE}/agents`, { signal: AbortSignal.timeout(3000) });
       return res.ok;
     } catch {
       return false;
     }
   },
 };
+
+function mapAdpAgent(agent: any): UnifiedAgent {
+  return {
+    id: `adp:${agent.did ?? agent.id ?? agent.name}`,
+    nativeId: agent.did ?? agent.id ?? "",
+    name: agent.name ?? "ADP Agent",
+    description: (agent.capabilities ?? []).map((c: any) => c.description ?? c.key ?? "").join(". ") || (agent.role ?? ""),
+    categories: agent.categories ?? [agent.role ?? "general"],
+    capabilities: (agent.capabilities ?? []).map((c: any) => `${c.key}: ${c.description ?? ""}`),
+    source: "adp",
+    protocol: "a2a",
+    endpoints: {
+      http: agent.endpoint ?? agent.url,
+      a2a: agent.a2a_endpoint,
+    },
+    pricing: agent.pricing,
+    verified: !!agent.did,
+    raw: agent,
+  };
+}

package/src/unified.ts

@@ -13,6 +13,7 @@
 import { createAllSources, type SourceAdapter, type UnifiedAgent } from "./sources/index.js";
 import { Aggregator, type AggregatorOptions, type AggregatorResult } from "./aggregator.js";
 import { rankAgents, type MatchResult } from "./matching.js";
+import { rankAgentsV2, type RankedAgent } from "./ranking.js";
 import { ProtocolBridge, type BridgeHireOptions, type BridgeHireResult } from "./bridge.js";
 import { CapabilityRouter, type DoOptions, type DoResult } from "./router.js";
 import type { ReputationWriterConfig } from "./reputation-writer.js";
@@ -44,8 +45,10 @@ export interface FindOptions {
 }
 
 export interface FindResult extends AggregatorResult {
-  /** Agents re-ranked by multi-layer matching */
+  /** Agents re-ranked by multi-layer matching (v1) */
   ranked: MatchResult[];
+  /** Agents re-ranked by v2 engine (Bayesian + geometric + value) */
+  rankedV2?: RankedAgent[];
 }
 
 export class KompassUnified {
@@ -89,18 +92,22 @@ export class KompassUnified {
       timeout: options?.timeout,
     });
 
-    // Re-rank with multi-layer matching
+    // Re-rank with v2 ranking engine (Bayesian + geometric + value-for-money)
+    const rankedV2 = rankAgentsV2(aggregatorResult.agents, query);
+
+    // Also keep v1 for backward compat
     const ranked = rankAgents(aggregatorResult.agents, query);
 
-    // Apply limit and min score
+    // Apply limit and min score using v2 composite
     const filtered = options?.minScore
-      ? ranked.filter((r) => r.scores.total >= options.minScore!)
-      : ranked;
+      ? rankedV2.filter((r) => r.scores.composite >= options.minScore!)
+      : rankedV2;
 
     return {
       ...aggregatorResult,
       agents: filtered.slice(0, options?.limit ?? 20).map((r) => r.agent),
-      ranked: filtered.slice(0, options?.limit ?? 20),
+      ranked: ranked.slice(0, options?.limit ?? 20), // v1 for backward compat
+      rankedV2: filtered.slice(0, options?.limit ?? 20), // v2 with proper scoring
     };
   }
 

package/test-ranking.ts

@@ -0,0 +1,53 @@
+import { KompassUnified } from './src/unified.js';
+
+async function main() {
+  const kompass = await KompassUnified.create();
+  const result = await kompass.find('DeFi yield data', { limit: 20 });
+
+  console.log('=== SOURCES ===');
+  for (const s of result.sources) {
+    console.log(`  ${s.name}: ${s.count} agents (${s.durationMs}ms)${s.error ? ' ERROR: '+s.error : ''}`);
+  }
+
+  console.log(`\nTotal: ${result.totalFound} found, ${result.deduplicated} deduped, ${result.queryTimeMs}ms`);
+
+  const bySrc: Record<string, number> = {};
+  const byProto: Record<string, number> = {};
+  for (const a of result.agents) {
+    bySrc[a.source] = (bySrc[a.source] || 0) + 1;
+    byProto[a.protocol] = (byProto[a.protocol] || 0) + 1;
+  }
+
+  console.log('\n=== BY SOURCE ===');
+  for (const [k, v] of Object.entries(bySrc).sort((a, b) => b[1] - a[1])) console.log(`  ${k}: ${v}`);
+
+  console.log('\n=== BY PROTOCOL ===');
+  for (const [k, v] of Object.entries(byProto).sort((a, b) => b[1] - a[1])) console.log(`  ${k}: ${v}`);
+
+  console.log('\n=== V2 RANKING (Bayesian + Geometric + Value-for-Money) ===');
+  console.log('  #  Proto   Name                                 Source              Cost       Composite  Relevance  Quality    Volume     Value      Explanation');
+  console.log('  ' + '─'.repeat(170));
+
+  const v2 = result.rankedV2 ?? [];
+  for (let i = 0; i < Math.min(20, v2.length); i++) {
+    const r = v2[i];
+    const a = r.agent;
+    const s = r.scores;
+    const proto = a.protocol.toUpperCase().padEnd(6);
+    const name = (a.name ?? '?').slice(0, 35).padEnd(35);
+    const src = a.source.padEnd(18);
+    const price = a.pricing?.amount ? `$${a.pricing.amount}` : 'free/?';
+
+    console.log(
+      `  ${String(i + 1).padStart(2)} [${proto}] ${name} | ${src} | ${price.padEnd(10)} | ` +
+      `comp=${s.composite.toFixed(1).padEnd(6)} | ` +
+      `rel=${s.relevance.toFixed(0).padEnd(4)} | ` +
+      `qual=${s.quality.toFixed(1).padEnd(6)} | ` +
+      `vol=${s.volume.toFixed(0).padEnd(4)} | ` +
+      `val=${s.value.toFixed(1).padEnd(6)} | ` +
+      `${r.explanation}`
+    );
+  }
+}
+
+main().catch(console.error);