kompass-sdk 0.7.0 → 0.9.0

package/dist/sources/adp.js

@@ -1,44 +1,48 @@
 /**
  * Agent Discovery Protocol (ADP) Source Adapter
- * agentdiscovery.io — open protocol for autonomous agent commerce
+ * Uses the real ADP v2 API at agentdiscovery.io
  */
-const ADP_BASE = "https://agentdiscovery.io";
+const ADP_BASE = "https://agentdiscovery.io/api/adp/v2";
 export const adpAdapter = {
     name: "adp",
-    displayName: "Agent Discovery Protocol",
+    displayName: "Agent Discovery Protocol (ADP v2)",
     async search(query, options) {
         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)
+            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);
+                }
+            }
+            // Fallback: list all agents
+            const listRes = await fetch(`${ADP_BASE}/agents`, {
+                signal: AbortSignal.timeout(options?.timeout ?? 5000),
+            });
+            if (!listRes.ok)
                 return [];
-            const data = await res.json();
-            const agents = Array.isArray(data) ? data : data.agents ?? data.data ?? [];
-            return agents.map((agent) => ({
-                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",
-                protocol: (agent.protocol ?? "http"),
-                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) => {
+                if (!query)
+                    return true;
+                const text = `${a.name ?? ""} ${a.role ?? ""} ${(a.categories ?? []).join(" ")} ${(a.capabilities ?? []).map((c) => c.description ?? c.key ?? "").join(" ")}`.toLowerCase();
+                return lower.split(/\s+/).some((t) => text.includes(t));
+            })
+                .slice(0, options?.limit ?? 20)
+                .map(mapAdpAgent);
         }
         catch {
             return [];
@@ -46,9 +50,7 @@ export const adpAdapter = {
     },
     async ping() {
         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 {
@@ -56,4 +58,23 @@ export const adpAdapter = {
         }
     },
 };
+function mapAdpAgent(agent) {
+    return {
+        id: `adp:${agent.did ?? agent.id ?? agent.name}`,
+        nativeId: agent.did ?? agent.id ?? "",
+        name: agent.name ?? "ADP Agent",
+        description: (agent.capabilities ?? []).map((c) => c.description ?? c.key ?? "").join(". ") || (agent.role ?? ""),
+        categories: agent.categories ?? [agent.role ?? "general"],
+        capabilities: (agent.capabilities ?? []).map((c) => `${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,
+    };
+}
 //# sourceMappingURL=adp.js.map

package/dist/sources/adp.js.map

@@ -1 +1 @@
-{"version":3,"file":"adp.js","sourceRoot":"","sources":["../../src/sources/adp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,0BAA0B;IAEvC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAA6B;QACvD,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE;gBAC7G,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;aACtD,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAE3E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;gBACjC,EAAE,EAAE,OAAO,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE;gBACtC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;gBAC3C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;gBAC/B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC;gBACzD,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC7D,MAAM,EAAE,KAAc;gBACtB,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAQ;gBAC3C,SAAS,EAAE;oBACT,IAAI,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG;oBACjC,GAAG,EAAE,KAAK,CAAC,WAAW;oBACtB,IAAI,EAAE,KAAK,CAAC,YAAY;iBACzB;gBACD,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;oBAC7B,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;oBAClC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;oBAClC,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC,CAAC,SAAS;gBACb,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;gBACjC,GAAG,EAAE,KAAK;aACX,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,aAAa,EAAE;gBAChD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"adp.js","sourceRoot":"","sources":["../../src/sources/adp.ts"],"names":[],"mappings":"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"}

package/dist/unified.d.ts

@@ -12,6 +12,7 @@
 import { type UnifiedAgent } from "./sources/index.js";
 import { type AggregatorResult } from "./aggregator.js";
 import { type MatchResult } from "./matching.js";
+import { type RankedAgent } from "./ranking.js";
 import { type BridgeHireOptions, type BridgeHireResult } from "./bridge.js";
 import { type DoOptions, type DoResult } from "./router.js";
 import type { ReputationWriterConfig } from "./reputation-writer.js";
@@ -40,8 +41,10 @@ export interface FindOptions {
     minScore?: number;
 }
 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 declare class KompassUnified {
     private aggregator;

package/dist/unified.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../src/unified.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAClC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,uDAAuD;IACvD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,kCAAkC;IAClC,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,+CAA+C;IAC/C,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAElC,OAAO,CAAC,MAAM,CAAC,CAAgB;IAE/B,OAAO;WAQM,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAcpE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBrE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9G;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,GACjD,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAa7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAInF;;;;;;;;;OASG;IACG,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}
+{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../src/unified.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAClC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,uDAAuD;IACvD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,kCAAkC;IAClC,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,oDAAoD;IACpD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAElC,OAAO,CAAC,MAAM,CAAC,CAAgB;IAE/B,OAAO;WAQM,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAcpE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BrE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9G;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,GACjD,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAa7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAInF;;;;;;;;;OASG;IACG,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/unified.js

@@ -12,6 +12,7 @@
 import { createAllSources } from "./sources/index.js";
 import { Aggregator } from "./aggregator.js";
 import { rankAgents } from "./matching.js";
+import { rankAgentsV2 } from "./ranking.js";
 import { ProtocolBridge } from "./bridge.js";
 import { CapabilityRouter } from "./router.js";
 export class KompassUnified {
@@ -48,16 +49,19 @@ export class KompassUnified {
             sources: options?.sources,
             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/dist/unified.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kompass-sdk",
-  "version": "0.7.0",
+  "version": "0.9.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

@@ -249,10 +249,11 @@ program
   .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")
+  .option("--context <text>", "context from a previous step to pass to the agent")
   .action(
     async (
       task: string,
-      opts: { budget: string; cost: string; protocol?: string; dryRun?: boolean; json?: boolean; log?: string; manifest?: string; wallet?: string }
+      opts: { budget: string; cost: string; protocol?: string; dryRun?: boolean; json?: boolean; log?: string; manifest?: string; wallet?: string; context?: string }
     ) => {
       const { KompassUnified } = await import("./unified.js");
       const { writeFileSync } = await import("fs");
@@ -277,6 +278,7 @@ program
         costPreference: opts.cost as any,
         preferProtocol: opts.protocol,
         dryRun: opts.dryRun,
+        context: opts.context,
       });
 
       if (opts.json) {

package/src/ranking.ts

@@ -0,0 +1,336 @@
+/**
+ * Kompass Ranking Engine
+ *
+ * Fair, cross-protocol ranking of agents/services using:
+ * 1. Source-specific reputation normalization
+ * 2. Bayesian average for cold-start protection
+ * 3. Value-for-money scoring (cost:quality ratio)
+ * 4. Geometric mean composite for final ranking
+ * 5. Wilson score for confidence-adjusted reputation
+ *
+ * Based on: npm scoring, Reddit Wilson, Twitter log-engagement,
+ * Amazon sales velocity, Airbnb market-relative pricing,
+ * IMDB Bayesian average, AgentRank (0xIntuition)
+ */
+
+import type { UnifiedAgent } from "./sources/types.js";
+
+// ── Types ────────────────────────────────────────────────
+
+export interface NormalizedReputation {
+  /** Quality signal 0-100 (success rate, reliability) */
+  quality: number;
+  /** Volume signal 0-100 (log-normalized job count, installs) */
+  volume: number;
+  /** Recency signal 0-100 (time since last active) */
+  recency: number;
+  /** Confidence 0-1 (how much evidence backs this score) */
+  confidence: number;
+}
+
+export interface RankingScores {
+  /** How well agent matches the query (0-100) */
+  relevance: number;
+  /** Bayesian-adjusted quality (0-100) */
+  quality: number;
+  /** Log-normalized usage volume (0-100) */
+  volume: number;
+  /** Time-decay recency (0-100) */
+  recency: number;
+  /** Value for money — quality relative to price (0-100) */
+  value: number;
+  /** Final composite score */
+  composite: number;
+}
+
+export interface RankedAgent {
+  agent: UnifiedAgent;
+  scores: RankingScores;
+  explanation: string;
+}
+
+// ── Configuration ────────────────────────────────────────
+
+const WEIGHTS = {
+  relevance: 0.30,
+  quality: 0.25,
+  volume: 0.15,
+  recency: 0.10,
+  value: 0.20,
+};
+
+const BAYESIAN_C = 10; // Confidence parameter for Bayesian average
+const GLOBAL_AVG_QUALITY = 50; // Prior assumption: average quality is 50/100
+
+// ── Step 1: Source-Specific Normalization ─────────────────
+
+export function normalizeReputation(agent: UnifiedAgent): NormalizedReputation {
+  const rep = agent.reputation;
+  if (!rep) return { quality: GLOBAL_AVG_QUALITY, volume: 0, recency: 50, confidence: 0 };
+
+  switch (rep.source) {
+    case "acp":
+      // successRate is 0-100%, count is completed jobs
+      return {
+        quality: rep.score,
+        volume: logNormalize(rep.count, 1000),
+        recency: recencyScore(agent.lastSeen),
+        confidence: Math.min(1, rep.count / 20), // Full confidence at 20+ jobs
+      };
+
+    case "402index":
+      // reliability_score is 0-100, count is uptime percentage (0-100)
+      return {
+        quality: rep.score,
+        volume: rep.count, // Uptime as volume proxy
+        recency: recencyScore(agent.lastSeen),
+        confidence: 0.7, // Automated monitoring = moderate confidence
+      };
+
+    case "8004scan":
+      // total_score is 0-100, count is star_count
+      return {
+        quality: rep.score,
+        volume: logNormalize(rep.count, 100),
+        recency: recencyScore(agent.lastSeen),
+        confidence: Math.min(1, rep.count / 10),
+      };
+
+    case "skills-sh-installs":
+      // Installs tell popularity, NOT quality
+      return {
+        quality: GLOBAL_AVG_QUALITY, // Unknown quality — use prior
+        volume: logNormalize(rep.count, 100000),
+        recency: 50,
+        confidence: Math.min(0.5, rep.count / 1000), // Installs give weak quality signal, cap at 0.5
+      };
+
+    case "clawhub-relevance":
+      // Search relevance, NOT reputation
+      return {
+        quality: GLOBAL_AVG_QUALITY,
+        volume: 0,
+        recency: 50,
+        confidence: 0, // Relevance says nothing about quality
+      };
+
+    default:
+      return {
+        quality: rep.score > 0 ? Math.min(rep.score, 100) : GLOBAL_AVG_QUALITY,
+        volume: logNormalize(rep.count, 100),
+        recency: recencyScore(agent.lastSeen),
+        confidence: 0.3,
+      };
+  }
+}
+
+// ── Step 2: Bayesian Average ─────────────────────────────
+
+/**
+ * Bayesian average prevents new agents with 1 job at 100%
+ * from outranking established agents with 95% over 200 jobs.
+ *
+ * Formula: (count * score + C * prior) / (count + C)
+ *
+ * Examples:
+ * - 2 jobs at 100% → 66.7 (pulls toward prior)
+ * - 200 jobs at 95% → 93.3 (mostly own data)
+ * - 0 jobs → 50.0 (pure prior)
+ */
+function bayesianQuality(normalized: NormalizedReputation): number {
+  const effectiveCount = normalized.confidence * 20; // Scale confidence to pseudo-count
+  return (effectiveCount * normalized.quality + BAYESIAN_C * GLOBAL_AVG_QUALITY) /
+    (effectiveCount + BAYESIAN_C);
+}
+
+// ── Step 3: Value Score ──────────────────────────────────
+
+/**
+ * Value = quality relative to price.
+ * A $0.01 agent with 82% success is better value than $0.25 at 76%.
+ *
+ * Free services get a moderate value score (good value but unknown quality).
+ */
+function valueScore(agent: UnifiedAgent, bayesianQ: number, allAgents: UnifiedAgent[]): number {
+  const price = parseAgentPrice(agent);
+
+  if (price === null) return 50; // Unknown price → neutral
+  if (price === 0) return Math.min(bayesianQ, 70); // Free → capped (free doesn't mean best)
+
+  // Find min price among agents with similar capabilities
+  const comparablePrices = allAgents
+    .map(parseAgentPrice)
+    .filter((p): p is number => p !== null && p > 0);
+
+  if (comparablePrices.length === 0) return 50;
+
+  const minPrice = Math.min(...comparablePrices);
+  const priceRatio = minPrice / price; // 1.0 = cheapest, <1 = more expensive
+
+  // Value = quality-adjusted price efficiency
+  // High quality + low price = high value
+  // Low quality + high price = low value
+  return Math.min(100, (bayesianQ * 0.6 + priceRatio * 100 * 0.4));
+}
+
+// ── Step 4: Geometric Mean Composite ─────────────────────
+
+/**
+ * Geometric mean ensures ALL factors must be non-zero.
+ * An agent that's free but unreliable scores zero.
+ * An agent that's perfect quality but irrelevant also scores low.
+ */
+function compositeScore(scores: Omit<RankingScores, "composite">): number {
+  const eps = 1; // Prevent zero from killing the product
+  const r = scores.relevance + eps;
+  const q = scores.quality + eps;
+  const v = scores.volume + eps;
+  const t = scores.recency + eps;
+  const p = scores.value + eps;
+
+  const totalWeight = WEIGHTS.relevance + WEIGHTS.quality + WEIGHTS.volume + WEIGHTS.recency + WEIGHTS.value;
+
+  return Math.pow(
+    Math.pow(r, WEIGHTS.relevance) *
+    Math.pow(q, WEIGHTS.quality) *
+    Math.pow(v, WEIGHTS.volume) *
+    Math.pow(t, WEIGHTS.recency) *
+    Math.pow(p, WEIGHTS.value),
+    1 / totalWeight
+  );
+}
+
+// ── Step 5: Wilson Score (Confidence-Adjusted) ───────────
+
+/**
+ * Lower bound of Wilson score confidence interval.
+ * Penalizes agents with few interactions even if success rate is high.
+ *
+ * Agent with 5/5 success → Wilson ~0.57
+ * Agent with 95/100 success → Wilson ~0.90
+ */
+export function wilsonLowerBound(positive: number, total: number, z = 1.96): number {
+  if (total === 0) return 0;
+  const phat = positive / total;
+  const denominator = 1 + z * z / total;
+  const center = phat + z * z / (2 * total);
+  const spread = z * Math.sqrt((phat * (1 - phat) + z * z / (4 * total)) / total);
+  return Math.max(0, (center - spread) / denominator);
+}
+
+// ── Main Ranking Function ────────────────────────────────
+
+/**
+ * Rank agents using the full pipeline:
+ * Normalize → Bayesian adjust → Value score → Geometric composite
+ */
+export function rankAgentsV2(
+  agents: UnifiedAgent[],
+  query: string
+): RankedAgent[] {
+  // Calculate relevance for each agent (reuse existing BM25 + structured matching)
+  const queryTerms = query.toLowerCase().split(/\s+/).filter((t) => t.length > 2);
+
+  return agents
+    .map((agent) => {
+      // Relevance (BM25-lite + structured)
+      const relevance = calculateRelevance(agent, queryTerms);
+
+      // Normalize reputation per source
+      const normalized = normalizeReputation(agent);
+
+      // Bayesian-adjusted quality
+      const quality = bayesianQuality(normalized);
+
+      // Volume
+      const volume = normalized.volume;
+
+      // Recency
+      const recency = normalized.recency;
+
+      // Value for money
+      const value = valueScore(agent, quality, agents);
+
+      const scores: RankingScores = {
+        relevance,
+        quality,
+        volume,
+        recency,
+        value,
+        composite: 0,
+      };
+
+      scores.composite = compositeScore(scores);
+
+      // Build explanation
+      const explanation = buildExplanation(agent, scores, normalized);
+
+      return { agent, scores, explanation };
+    })
+    .sort((a, b) => b.scores.composite - a.scores.composite);
+}
+
+// ── Helpers ──────────────────────────────────────────────
+
+function logNormalize(value: number, maxExpected: number): number {
+  if (value <= 0) return 0;
+  return Math.min(100, (Math.log(1 + value) / Math.log(1 + maxExpected)) * 100);
+}
+
+function recencyScore(lastSeen?: number): number {
+  if (!lastSeen) return 50; // Unknown → neutral
+  const hoursSince = (Date.now() - lastSeen) / (1000 * 60 * 60);
+  if (hoursSince < 1) return 100;
+  if (hoursSince < 24) return 80;
+  if (hoursSince < 168) return 60; // 1 week
+  if (hoursSince < 720) return 40; // 1 month
+  return 20;
+}
+
+function parseAgentPrice(agent: UnifiedAgent): number | null {
+  if (!agent.pricing?.amount) return null;
+  const amount = agent.pricing.amount;
+  if (typeof amount === "number") return amount;
+  const parsed = parseFloat(amount);
+  return isNaN(parsed) ? null : parsed;
+}
+
+function calculateRelevance(agent: UnifiedAgent, queryTerms: string[]): number {
+  const text = `${agent.name} ${agent.description} ${agent.categories.join(" ")} ${agent.capabilities.join(" ")}`.toLowerCase();
+  let score = 0;
+
+  for (const term of queryTerms) {
+    if (agent.name.toLowerCase().includes(term)) score += 15;
+    if (agent.description.toLowerCase().includes(term)) score += 8;
+    if (agent.categories.some((c) => c.includes(term))) score += 12;
+    if (agent.capabilities.some((c) => c.toLowerCase().includes(term))) score += 5;
+  }
+
+  return Math.min(100, score);
+}
+
+function buildExplanation(agent: UnifiedAgent, scores: RankingScores, normalized: NormalizedReputation): string {
+  const parts: string[] = [];
+
+  if (scores.relevance > 30) parts.push("Strong match");
+  else if (scores.relevance > 15) parts.push("Moderate match");
+  else parts.push("Weak match");
+
+  if (normalized.confidence > 0.5) {
+    if (scores.quality > 70) parts.push("proven quality");
+    else if (scores.quality > 50) parts.push("decent quality");
+    else parts.push("unproven quality");
+  } else {
+    parts.push("limited track record");
+  }
+
+  const price = parseAgentPrice(agent);
+  if (price === 0) parts.push("free");
+  else if (price !== null && price < 0.05) parts.push("very affordable");
+  else if (price !== null && price > 1) parts.push("premium priced");
+
+  if (scores.value > 70) parts.push("great value");
+  else if (scores.value < 30) parts.push("questionable value");
+
+  return parts.join(". ") + ".";
+}

package/src/router.ts

@@ -36,6 +36,8 @@ export interface DoOptions {
   timeout?: number;
   /** Return options without executing (dry run) */
   dryRun?: boolean;
+  /** Context from a previous step — passed to the agent as additional info */
+  context?: string;
   /** Additional payload to send to the capability */
   payload?: Record<string, unknown>;
 }
@@ -85,7 +87,11 @@ export class CapabilityRouter {
   }
 
   async do(options: DoOptions): Promise<DoResult> {
-    const { task, dryRun = false } = options;
+    const { dryRun = false } = options;
+    // Prepend context from previous step if provided
+    const task = options.context
+      ? `${options.task}\n\nContext from previous step:\n${options.context.slice(0, 2000)}`
+      : options.task;
 
     // 1. Search all sources
     const searchResult = await this.aggregator.search(task, {