codesift-mcp 0.9.5 → 0.10.0

package/dist/search/tool-embedding-storage.js

@@ -0,0 +1,56 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { atomicWriteFile } from "../storage/_shared.js";
+export function getToolEmbeddingCachePath() {
+    return join(homedir(), ".codesift", "tool-embeddings.ndjson");
+}
+export async function readToolEmbeddingCache(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf-8"));
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const record = parsed;
+        if (typeof record["fingerprint"] !== "string"
+            || typeof record["embeddings"] !== "object"
+            || record["embeddings"] === null
+            || Array.isArray(record["embeddings"])) {
+            return null;
+        }
+        const embeddings = record["embeddings"];
+        const vectors = Object.values(embeddings);
+        // A cache with no vectors at all is a half-written file, not a valid empty
+        // catalog — the fingerprint it carries was computed from real tool defs.
+        if (vectors.length === 0)
+            return null;
+        let dimension = null;
+        for (const value of vectors) {
+            // `[].some()` is vacuously false, so an empty vector slips through a
+            // bare some()-check — it has to be rejected on length explicitly.
+            if (!Array.isArray(value) || value.length === 0)
+                return null;
+            if (value.some((entry) => !Number.isFinite(entry)))
+                return null;
+            // Every vector comes from one provider+model, so a dimension mismatch
+            // means the file is corrupt or was written across a provider switch.
+            // Left unchecked, cosine() returns 0 for the odd ones out and those
+            // tools silently vanish from semantic ranking with no error.
+            dimension ??= value.length;
+            if (value.length !== dimension)
+                return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeToolEmbeddingCache(path, cache) {
+    try {
+        await atomicWriteFile(path, JSON.stringify(cache));
+    }
+    catch {
+        // Cache persistence is optional; ranking can regenerate embeddings.
+    }
+}
+//# sourceMappingURL=tool-embedding-storage.js.map

package/dist/search/tool-embedding-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-embedding-storage.js","sourceRoot":"","sources":["../../src/search/tool-embedding-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,wBAAwB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,IACE,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ;eACtC,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ;eACxC,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI;eAC7B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EACtC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAA4B,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,qEAAqE;YACrE,kEAAkE;YAClE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,sEAAsE;YACtE,qEAAqE;YACrE,oEAAoE;YACpE,6DAA6D;YAC7D,SAAS,KAAK,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;QAC9C,CAAC;QACD,OAAO,MAA8B,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAY,EACZ,KAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC"}

package/dist/search/tool-ranker-bm25.d.ts

@@ -0,0 +1,6 @@
+import { type BM25Index } from "./bm25.js";
+import type { ToolDefinition } from "../register-tools.js";
+export declare function toolDefsFingerprint(toolDefs: readonly ToolDefinition[]): string;
+export declare function buildToolBM25Index(toolDefs: readonly ToolDefinition[]): BM25Index;
+export declare function clearToolBM25Cache(): void;
+//# sourceMappingURL=tool-ranker-bm25.d.ts.map

package/dist/search/tool-ranker-bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-bm25.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-bm25.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAU3D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAW/E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAMjF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/search/tool-ranker-bm25.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { buildBM25Index } from "./bm25.js";
+let bm25Cache = null;
+export function toolDefsFingerprint(toolDefs) {
+    const subset = toolDefs.map((definition) => [
+        definition.name,
+        definition.description,
+        definition.searchHint ?? "",
+        definition.category ?? "",
+    ]);
+    return createHash("sha1")
+        .update(JSON.stringify(subset))
+        .digest("hex")
+        .slice(0, 16);
+}
+export function buildToolBM25Index(toolDefs) {
+    const fingerprint = toolDefsFingerprint(toolDefs);
+    if (bm25Cache?.fingerprint === fingerprint)
+        return bm25Cache.index;
+    const index = buildBM25Index(toolDefs.map(toolToSymbol));
+    bm25Cache = { fingerprint, index };
+    return index;
+}
+export function clearToolBM25Cache() {
+    bm25Cache = null;
+}
+function toolToSymbol(definition) {
+    return {
+        id: definition.name,
+        repo: "__tools__",
+        name: definition.name,
+        kind: "function",
+        file: `__tools__/${definition.category ?? "uncategorized"}.tool`,
+        start_line: 1,
+        end_line: 1,
+        signature: definition.description,
+        docstring: definition.searchHint ?? "",
+    };
+}
+//# sourceMappingURL=tool-ranker-bm25.js.map

package/dist/search/tool-ranker-bm25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-bm25.js","sourceRoot":"","sources":["../../src/search/tool-ranker-bm25.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAkB,MAAM,WAAW,CAAC;AAS3D,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C,MAAM,UAAU,mBAAmB,CAAC,QAAmC;IACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1C,UAAU,CAAC,IAAI;QACf,UAAU,CAAC,WAAW;QACtB,UAAU,CAAC,UAAU,IAAI,EAAE;QAC3B,UAAU,CAAC,QAAQ,IAAI,EAAE;KAC1B,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SAC9B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAmC;IACpE,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,WAAW,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC;IACnE,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACzD,SAAS,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,UAA0B;IAC9C,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,IAAI;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa,UAAU,CAAC,QAAQ,IAAI,eAAe,OAAO;QAChE,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,UAAU,CAAC,WAAW;QACjC,SAAS,EAAE,UAAU,CAAC,UAAU,IAAI,EAAE;KACvC,CAAC;AACJ,CAAC"}

package/dist/search/tool-ranker-orchestrator.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRankerContext, ToolRecommendation } from "./tool-ranker-types.js";
+export declare function rankTools(context: ToolRankerContext): ToolRecommendation[];
+//# sourceMappingURL=tool-ranker-orchestrator.d.ts.map

package/dist/search/tool-ranker-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-orchestrator.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-orchestrator.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAWrG,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,CAmB1E"}

package/dist/search/tool-ranker-orchestrator.js

@@ -0,0 +1,49 @@
+import { tokenizeText } from "./bm25.js";
+import { buildToolBM25Index } from "./tool-ranker-bm25.js";
+import { calibrationCap, generateReasoning } from "./tool-ranker-reasoning.js";
+import { collectToolSignals, computeLexicalSignals, computeSemanticSignals, } from "./tool-ranker-signals.js";
+import { weightedSignalScore } from "./tool-ranker-signal-math.js";
+const MAX_RECOMMENDATIONS = 10;
+export function rankTools(context) {
+    const { query, toolDefs } = context;
+    if (toolDefs.length === 0 || !query.trim())
+        return [];
+    const lexical = computeLexicalSignals(query, buildToolBM25Index(toolDefs));
+    const semantic = computeSemanticSignals(toolDefs, context.embeddings, context.queryEmbedding);
+    const signalContext = {
+        query,
+        lexical,
+        semantic,
+        usage: context.usageFrequency,
+        frameworkTools: new Set(context.frameworkTools),
+    };
+    const scored = scoreTools(toolDefs, signalContext).sort((left, right) => right.raw - left.raw);
+    const top = scored.slice(0, MAX_RECOMMENDATIONS);
+    if (top.length === 0)
+        return [];
+    const topRaw = top[0]?.raw ?? 0;
+    const cap = calibrationCap(query, tokenizeText(query), topRaw, top[1]?.raw ?? 0);
+    const coreNames = context.coreToolNames ?? new Set();
+    return top.map((tool) => toRecommendation(tool, query, topRaw, cap, coreNames));
+}
+function scoreTools(definitions, context) {
+    const output = [];
+    for (const def of definitions) {
+        const signals = collectToolSignals(def.name, context);
+        const raw = weightedSignalScore(signals);
+        if (raw > 0)
+            output.push({ def, raw, signals });
+    }
+    return output;
+}
+function toRecommendation(tool, query, topRaw, cap, coreNames) {
+    const normalised = topRaw > 0 ? tool.raw / topRaw : 0;
+    const confidence = Math.max(0, Math.min(cap, normalised * cap));
+    return {
+        name: tool.def.name,
+        confidence: Math.round(confidence * 1000) / 1000,
+        reasoning: generateReasoning(tool.def.name, query, tool.signals),
+        is_hidden: !coreNames.has(tool.def.name),
+    };
+}
+//# sourceMappingURL=tool-ranker-orchestrator.js.map

package/dist/search/tool-ranker-orchestrator.js.map

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

package/dist/search/tool-ranker-reasoning.d.ts

@@ -0,0 +1,4 @@
+import type { SignalBreakdown } from "./tool-ranker-types.js";
+export declare function generateReasoning(id: string, query: string, signals: SignalBreakdown): string;
+export declare function calibrationCap(query: string, tokens: string[], topScore: number, secondScore: number): number;
+//# sourceMappingURL=tool-ranker-reasoning.d.ts.map

package/dist/search/tool-ranker-reasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-reasoning.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-reasoning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACvB,MAAM,CAcR;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR"}

package/dist/search/tool-ranker-reasoning.js

@@ -0,0 +1,35 @@
+const VAGUE_WORDS = new Set([
+    "help", "code", "find", "search", "what", "how", "show", "look",
+]);
+export function generateReasoning(id, query, signals) {
+    const reasons = [];
+    if (signals.identity > 0)
+        reasons.push("exact name match");
+    if (signals.lexical > 0.01 && signals.lexicalTokens.length > 0) {
+        reasons.push(`keywords: ${signals.lexicalTokens.slice(0, 3).join(", ")}`);
+    }
+    if (signals.semantic >= 0.55)
+        reasons.push("semantic similarity");
+    if (signals.structural >= 0.5)
+        reasons.push("high usage frequency");
+    if (signals.framework > 0)
+        reasons.push("relevant to project stack");
+    if (reasons.length === 0) {
+        const stem = query.trim().slice(0, 30) || id;
+        return `general match for "${stem}"`;
+    }
+    return reasons.join("; ");
+}
+export function calibrationCap(query, tokens, topScore, secondScore) {
+    const trimmed = query.trim();
+    const wordCount = trimmed.split(/\s+/).filter(Boolean).length;
+    const allVague = tokens.length > 0 && tokens.every((token) => VAGUE_WORDS.has(token));
+    if (trimmed.length < 10 || allVague)
+        return 0.5;
+    if (wordCount === 1 || tokens.length <= 1)
+        return 0.6;
+    if (topScore > 0 && topScore - secondScore < 0.1)
+        return 0.4;
+    return 1;
+}
+//# sourceMappingURL=tool-ranker-reasoning.js.map

package/dist/search/tool-ranker-reasoning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-reasoning.js","sourceRoot":"","sources":["../../src/search/tool-ranker-reasoning.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;CAChE,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAC/B,EAAU,EACV,KAAa,EACb,OAAwB;IAExB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,UAAU,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,sBAAsB,IAAI,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,MAAgB,EAChB,QAAgB,EAChB,WAAmB;IAEnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,QAAQ;QAAE,OAAO,GAAG,CAAC;IAChD,IAAI,SAAS,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IACtD,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,WAAW,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC7D,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/search/tool-ranker-signal-math.d.ts

@@ -0,0 +1,6 @@
+import type { SignalBreakdown } from "./tool-ranker-types.js";
+export declare function computeIdentity(query: string, toolName: string): number;
+export declare function cosine(left: number[], right: number[]): number;
+export declare function normaliseUsage(usage: Map<string, number>, toolName: string): number;
+export declare function weightedSignalScore(signals: SignalBreakdown): number;
+//# sourceMappingURL=tool-ranker-signal-math.d.ts.map

package/dist/search/tool-ranker-signal-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-signal-math.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-signal-math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAe9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQnF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAMpE"}

package/dist/search/tool-ranker-signal-math.js

@@ -0,0 +1,51 @@
+const SIGNAL_WEIGHTS = {
+    lexical: 1,
+    identity: 2,
+    semantic: 0.8,
+    structural: 0.1,
+    framework: 0.6,
+};
+export function computeIdentity(query, toolName) {
+    const lowerQuery = query.toLowerCase();
+    const lowerName = toolName.toLowerCase();
+    if (!lowerName)
+        return 0;
+    return lowerQuery.includes(lowerName) || lowerQuery.includes(lowerName.replace(/_/g, " ")) ? 1 : 0;
+}
+export function cosine(left, right) {
+    if (left.length !== right.length || left.length === 0)
+        return 0;
+    let dot = 0;
+    let leftNorm = 0;
+    let rightNorm = 0;
+    for (let index = 0; index < left.length; index++) {
+        const leftValue = left[index] ?? 0;
+        const rightValue = right[index] ?? 0;
+        if (!Number.isFinite(leftValue) || !Number.isFinite(rightValue))
+            return 0;
+        dot += leftValue * rightValue;
+        leftNorm += leftValue * leftValue;
+        rightNorm += rightValue * rightValue;
+    }
+    const denominator = Math.sqrt(leftNorm) * Math.sqrt(rightNorm);
+    return denominator > 0 ? dot / denominator : 0;
+}
+export function normaliseUsage(usage, toolName) {
+    const value = usage.get(toolName) ?? 0;
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    let maximum = 0;
+    for (const candidate of usage.values()) {
+        if (Number.isFinite(candidate) && candidate > maximum)
+            maximum = candidate;
+    }
+    return maximum > 0 ? Math.min(1, value / maximum) : 0;
+}
+export function weightedSignalScore(signals) {
+    return SIGNAL_WEIGHTS.lexical * signals.lexical
+        + SIGNAL_WEIGHTS.identity * signals.identity
+        + SIGNAL_WEIGHTS.semantic * signals.semantic
+        + SIGNAL_WEIGHTS.structural * signals.structural
+        + SIGNAL_WEIGHTS.framework * signals.framework;
+}
+//# sourceMappingURL=tool-ranker-signal-math.js.map

package/dist/search/tool-ranker-signal-math.js.map

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

package/dist/search/tool-ranker-signals.d.ts

@@ -0,0 +1,20 @@
+import { type BM25Index } from "./bm25.js";
+import type { ToolDefinition } from "../register-tools.js";
+import type { SignalBreakdown } from "./tool-ranker-types.js";
+export interface SignalCollectionContext {
+    query: string;
+    lexical: Map<string, {
+        score: number;
+        matches: string[];
+    }>;
+    semantic: Map<string, number>;
+    usage: Map<string, number>;
+    frameworkTools: Set<string>;
+}
+export declare function computeLexicalSignals(query: string, index: BM25Index): Map<string, {
+    score: number;
+    matches: string[];
+}>;
+export declare function computeSemanticSignals(toolDefs: readonly ToolDefinition[], embeddings: Map<string, number[]> | null, queryEmbedding: number[] | null): Map<string, number>;
+export declare function collectToolSignals(name: string, context: SignalCollectionContext): SignalBreakdown;
+//# sourceMappingURL=tool-ranker-signals.d.ts.map

package/dist/search/tool-ranker-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-signals.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAWD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,GACf,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYnD;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EACxC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUrB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,eAAe,CAUjB"}

package/dist/search/tool-ranker-signals.js

@@ -0,0 +1,50 @@
+import { searchBM25 } from "./bm25.js";
+import { computeIdentity, cosine, normaliseUsage } from "./tool-ranker-signal-math.js";
+const BM25_TOP_K = 50;
+const TOOL_FIELD_WEIGHTS = {
+    name: 5,
+    signature: 2.5,
+    docstring: 2,
+    body: 0,
+    comments: 0,
+};
+export function computeLexicalSignals(query, index) {
+    const results = searchBM25(index, query, BM25_TOP_K, TOOL_FIELD_WEIGHTS);
+    const output = new Map();
+    const topScore = results[0]?.score ?? 0;
+    if (topScore <= 0)
+        return output;
+    for (const result of results) {
+        output.set(result.symbol.id, {
+            score: result.score / topScore,
+            matches: result.matches ?? [],
+        });
+    }
+    return output;
+}
+export function computeSemanticSignals(toolDefs, embeddings, queryEmbedding) {
+    const output = new Map();
+    if (!embeddings || !queryEmbedding?.length)
+        return output;
+    for (const def of toolDefs) {
+        const vector = embeddings.get(def.name);
+        if (!vector?.length)
+            continue;
+        const similarity = cosine(queryEmbedding, vector);
+        if (similarity > 0)
+            output.set(def.name, similarity);
+    }
+    return output;
+}
+export function collectToolSignals(name, context) {
+    const lexicalSignal = context.lexical.get(name);
+    return {
+        lexical: lexicalSignal?.score ?? 0,
+        identity: computeIdentity(context.query, name),
+        semantic: context.semantic.get(name) ?? 0,
+        structural: normaliseUsage(context.usage, name),
+        framework: context.frameworkTools.has(name) ? 1 : 0,
+        lexicalTokens: lexicalSignal?.matches ?? [],
+    };
+}
+//# sourceMappingURL=tool-ranker-signals.js.map

package/dist/search/tool-ranker-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-signals.js","sourceRoot":"","sources":["../../src/search/tool-ranker-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAYvF,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,KAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgD,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACxC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,QAAQ;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAmC,EACnC,UAAwC,EACxC,cAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,MAAM;YAAE,SAAS;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,UAAU,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,OAAgC;IAEhC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;QAClC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9C,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAC/C,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,aAAa,EAAE,aAAa,EAAE,OAAO,IAAI,EAAE;KAC5C,CAAC;AACJ,CAAC"}

package/dist/search/tool-ranker-types.d.ts

@@ -0,0 +1,26 @@
+import type { ToolDefinition } from "../register-tools.js";
+export interface ToolRecommendation {
+    name: string;
+    confidence: number;
+    reasoning: string;
+    suggested_params?: Record<string, string>;
+    is_hidden: boolean;
+}
+export interface ToolRankerContext {
+    query: string;
+    toolDefs: readonly ToolDefinition[];
+    embeddings: Map<string, number[]> | null;
+    queryEmbedding: number[] | null;
+    usageFrequency: Map<string, number>;
+    frameworkTools: string[];
+    coreToolNames?: Set<string>;
+}
+export interface SignalBreakdown {
+    lexical: number;
+    identity: number;
+    semantic: number;
+    structural: number;
+    framework: number;
+    lexicalTokens: string[];
+}
+//# sourceMappingURL=tool-ranker-types.d.ts.map

package/dist/search/tool-ranker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-types.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/search/tool-ranker-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-ranker-types.js.map

package/dist/search/tool-ranker-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-ranker-types.js","sourceRoot":"","sources":["../../src/search/tool-ranker-types.ts"],"names":[],"mappings":""}

package/dist/search/tool-ranker.d.ts

@@ -1,90 +1,7 @@
-/**
- * Tool-ranker — ranks MCP tool definitions against a natural-language query
- * using BM25 (lexical), exact-name (identity), embedding cosine (semantic),
- * usage frequency (structural), and framework-match (framework) signals.
- *
- * Used by the `plan_turn` / tool-recommendation meta tools to surface the
- * most relevant tools for an agent's current intent.
- *
- * All signals are optional — semantic and structural gracefully degrade to
- * zero when the corresponding input is unavailable (e.g. no embedding API
- * key, fresh session with no usage history).
- */
-import { type BM25Index } from "./bm25.js";
-import type { ToolDefinition } from "../register-tools.js";
-export interface ToolRecommendation {
-    name: string;
-    confidence: number;
-    reasoning: string;
-    suggested_params?: Record<string, string>;
-    is_hidden: boolean;
-}
-export interface ToolRankerContext {
-    query: string;
-    toolDefs: readonly ToolDefinition[];
-    embeddings: Map<string, number[]> | null;
-    queryEmbedding: number[] | null;
-    usageFrequency: Map<string, number>;
-    frameworkTools: string[];
-    /**
-     * Names of tools visible in ListTools (core tools). When provided, tools
-     * outside this set are flagged as `is_hidden=true` in the recommendation.
-     * Defaults to an empty set → every tool is reported as hidden.
-     */
-    coreToolNames?: Set<string>;
-}
-/** Per-signal contributions for a single tool — used for reasoning + debugging. */
-interface SignalBreakdown {
-    lexical: number;
-    identity: number;
-    semantic: number;
-    structural: number;
-    framework: number;
-    lexicalTokens: string[];
-}
-/**
- * Compute a stable fingerprint for a list of tool definitions. Used to
- * invalidate the BM25 cache when the tool catalog is modified (tests,
- * hot-reload, new deployments).
- *
- * Exported for tests that need to predict cache-hit behaviour.
- */
-export declare function toolDefsFingerprint(toolDefs: readonly ToolDefinition[]): string;
-/**
- * Build (or return cached) BM25 index for a tool catalog. Cache is keyed
- * by fingerprint — subsequent calls with the same shape return instantly.
- */
-export declare function buildToolBM25Index(toolDefs: readonly ToolDefinition[]): BM25Index;
-/** Clear the BM25 cache — for tests and hot-reload. */
-export declare function clearToolBM25Cache(): void;
-/**
- * Render a one-line, human-readable reason explaining why this tool was
- * picked. Falls back to a generic "general match" when no signal dominates.
- */
-export declare function generateReasoning(id: string, query: string, signals: SignalBreakdown): string;
-/**
- * Rank tools against a natural-language query by combining lexical, identity,
- * semantic, structural, and framework signals. Returns up to 10 `ToolRecommendation`
- * entries sorted by raw weighted score, with calibrated confidence values.
- *
- * Gracefully handles missing inputs:
- *   - no embeddings           → semantic contribution is 0
- *   - empty usageFrequency    → structural contribution is 0
- *   - empty frameworkTools    → framework contribution is 0
- */
-export declare function rankTools(ctx: ToolRankerContext): ToolRecommendation[];
-/** Absolute path to the on-disk tool-embedding cache. */
-export declare function getToolEmbeddingCachePath(): string;
-/**
- * Fetch (or compute) embeddings for every tool in `defs`. Uses the on-disk
- * cache when the fingerprint matches; otherwise regenerates via the configured
- * embedding provider and persists the result.
- *
- * Returns:
- *   - `Map<toolName, number[]>` on success
- *   - `null` when no embedding provider is configured (no API key) or the
- *     provider call fails — callers should degrade to non-semantic ranking.
- */
-export declare function getToolEmbeddings(defs: readonly ToolDefinition[]): Promise<Map<string, number[]> | null>;
-export {};
+/** Public facade for tool ranking and its caches. */
+export { rankTools } from "./tool-ranker-orchestrator.js";
+export { generateReasoning } from "./tool-ranker-reasoning.js";
+export { buildToolBM25Index, clearToolBM25Cache, toolDefsFingerprint, } from "./tool-ranker-bm25.js";
+export { getToolEmbeddingCachePath, getToolEmbeddings, } from "./tool-embedding-cache.js";
+export type { ToolRankerContext, ToolRecommendation, } from "./tool-ranker-types.js";
 //# sourceMappingURL=tool-ranker.d.ts.map

package/dist/search/tool-ranker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ranker.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAMrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,mFAAmF;AACnF,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAqCD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAa/E;AA0BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAUjF;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAuFD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACvB,MAAM,CA+BR;AAgDD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,CA2FtE;AAaD,yDAAyD;AACzD,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAiCD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,cAAc,EAAE,GAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAuDvC"}
+{"version":3,"file":"tool-ranker.d.ts","sourceRoot":"","sources":["../../src/search/tool-ranker.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}