kompass-sdk 0.7.0 → 0.8.0

package/dist/ranking.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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";
+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;
+}
+export declare function normalizeReputation(agent: UnifiedAgent): NormalizedReputation;
+/**
+ * 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 declare function wilsonLowerBound(positive: number, total: number, z?: number): number;
+/**
+ * Rank agents using the full pipeline:
+ * Normalize → Bayesian adjust → Value score → Geometric composite
+ */
+export declare function rankAgentsV2(agents: UnifiedAgent[], query: string): RankedAgent[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,CA0D7E;AAgFD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,SAAO,GAAG,MAAM,CAOlF;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EAAE,EACtB,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CAyCf"}

package/dist/ranking.js

@@ -0,0 +1,273 @@
+/**
+ * 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)
+ */
+// ── 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) {
+    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) {
+    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, bayesianQ, allAgents) {
+    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 !== 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) {
+    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, total, z = 1.96) {
+    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, query) {
+    // 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 = {
+            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, maxExpected) {
+    if (value <= 0)
+        return 0;
+    return Math.min(100, (Math.log(1 + value) / Math.log(1 + maxExpected)) * 100);
+}
+function recencyScore(lastSeen) {
+    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) {
+    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, queryTerms) {
+    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, scores, normalized) {
+    const parts = [];
+    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(". ") + ".";
+}
+//# sourceMappingURL=ranking.js.map

package/dist/ranking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.js","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsCH,4DAA4D;AAE5D,MAAM,OAAO,GAAG;IACd,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,4CAA4C;AACnE,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,8CAA8C;AAE7E,6DAA6D;AAE7D,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAExF,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,iDAAiD;YACjD,OAAO;gBACL,OAAO,EAAE,GAAG,CAAC,KAAK;gBAClB,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC;gBACrC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACrC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,8BAA8B;aACxE,CAAC;QAEJ,KAAK,UAAU;YACb,iEAAiE;YACjE,OAAO;gBACL,OAAO,EAAE,GAAG,CAAC,KAAK;gBAClB,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,yBAAyB;gBAC5C,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACrC,UAAU,EAAE,GAAG,EAAE,6CAA6C;aAC/D,CAAC;QAEJ,KAAK,UAAU;YACb,4CAA4C;YAC5C,OAAO;gBACL,OAAO,EAAE,GAAG,CAAC,KAAK;gBAClB,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;gBACpC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACrC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;aACxC,CAAC;QAEJ,KAAK,oBAAoB;YACvB,wCAAwC;YACxC,OAAO;gBACL,OAAO,EAAE,kBAAkB,EAAE,8BAA8B;gBAC3D,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvC,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,gDAAgD;aAC9F,CAAC;QAEJ,KAAK,mBAAmB;YACtB,mCAAmC;YACnC,OAAO;gBACL,OAAO,EAAE,kBAAkB;gBAC3B,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,CAAC,EAAE,uCAAuC;aACvD,CAAC;QAEJ;YACE,OAAO;gBACL,OAAO,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB;gBACtE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;gBACpC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACrC,UAAU,EAAE,GAAG;aAChB,CAAC;IACN,CAAC;AACH,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,SAAS,eAAe,CAAC,UAAgC;IACvD,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,mCAAmC;IACtF,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;QAC5E,CAAC,cAAc,GAAG,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,4DAA4D;AAE5D;;;;;GAKG;AACH,SAAS,UAAU,CAAC,KAAmB,EAAE,SAAiB,EAAE,SAAyB;IACnF,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC,CAAC,0BAA0B;IACzD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,yCAAyC;IAE1F,wDAAwD;IACxD,MAAM,gBAAgB,GAAG,SAAS;SAC/B,GAAG,CAAC,eAAe,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAEnD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,sCAAsC;IAE3E,4CAA4C;IAC5C,wCAAwC;IACxC,uCAAuC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,GAAG,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,4DAA4D;AAE5D;;;;GAIG;AACH,SAAS,cAAc,CAAC,MAAwC;IAC9D,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,wCAAwC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;IAE7B,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAE3G,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAC1B,CAAC,GAAG,WAAW,CAChB,CAAC;AACJ,CAAC;AAED,4DAA4D;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,KAAa,EAAE,CAAC,GAAG,IAAI;IACxE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC9B,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,4DAA4D;AAE5D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAsB,EACtB,KAAa;IAEb,iFAAiF;IACjF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEhF,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,qCAAqC;QACrC,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAExD,kCAAkC;QAClC,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAE9C,4BAA4B;QAC5B,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAE5C,SAAS;QACT,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAEjC,UAAU;QACV,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAEnC,kBAAkB;QAClB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAkB;YAC5B,SAAS;YACT,OAAO;YACP,MAAM;YACN,OAAO;YACP,KAAK;YACL,SAAS,EAAE,CAAC;SACb,CAAC;QAEF,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAE1C,oBAAoB;QACpB,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAEhE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,4DAA4D;AAE5D,SAAS,YAAY,CAAC,KAAa,EAAE,WAAmB;IACtD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,QAAiB;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,CAAC,oBAAoB;IAC9C,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,IAAI,UAAU,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/B,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,SAAS;IAC1C,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,UAAU;IAC3C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAmB,EAAE,UAAoB;IACnE,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9H,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QACzD,IAAI,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAC/D,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QAChE,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAmB,EAAE,MAAqB,EAAE,UAAgC;IACpG,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,SAAS,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SACjD,IAAI,MAAM,CAAC,SAAS,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;;QACxD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE9B,IAAI,UAAU,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,OAAO,GAAG,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;aACjD,IAAI,MAAM,CAAC,OAAO,GAAG,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;;YACtD,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;SAClE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAEnE,IAAI,MAAM,CAAC,KAAK,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;SAC5C,IAAI,MAAM,CAAC,KAAK,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAE7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AAChC,CAAC"}

package/dist/sources/adp.d.ts

@@ -1,6 +1,6 @@
 /**
  * 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 } from "./types.js";
 export declare const adpAdapter: SourceAdapter;

package/dist/sources/adp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adp.d.ts","sourceRoot":"","sources":["../../src/sources/adp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,YAAY,CAAC;AAInF,eAAO,MAAM,UAAU,EAAE,aAsDxB,CAAC"}
+{"version":3,"file":"adp.d.ts","sourceRoot":"","sources":["../../src/sources/adp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,YAAY,CAAC;AAInF,eAAO,MAAM,UAAU,EAAE,aAwDxB,CAAC"}

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.8.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/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/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);