codesift-mcp 0.8.6 → 0.8.10

package/dist/register-tools.js

@@ -762,19 +762,25 @@ export const OutputSchemas = {
     /** list_repos */
     repoList: z.union([z.array(z.string()), z.array(z.object({ name: z.string() }).passthrough())]),
 };
+/** Usage-critical tools that must never require discover_tools/describe_tools. */
+export const ALWAYS_VISIBLE_TOOL_NAMES = [
+    "search_text",
+    "get_file_outline",
+    "plan_turn",
+    "index_file",
+    "search_symbols",
+    "get_file_tree",
+    "search_all_conversations",
+    "codebase_retrieval",
+];
 /** Tools visible in ListTools — core (high usage) + direct-use (agents call without discovery) */
 export const CORE_TOOL_NAMES = new Set([
-    // --- Top 10 by usage (91% of calls) ---
-    "search_text", // #1: 1841 calls
-    "codebase_retrieval", // #2: 574 calls
-    "get_file_outline", // #3: 351 calls
-    "search_symbols", // #4: 332 calls
-    "list_repos", // #5: 292 calls
-    "get_file_tree", // #6: 268 calls
-    "index_file", // #7: 209 calls
-    "get_symbol", // #8: 138 calls
-    "search_patterns", // #9: 135 calls
-    "index_conversations", // #10: 127 calls
+    ...ALWAYS_VISIBLE_TOOL_NAMES,
+    // --- Additional high-usage/direct-use tools ---
+    "list_repos",
+    "get_symbol",
+    "search_patterns",
+    "index_conversations",
     // --- Direct-use: agents call these without discovery ---
     "assemble_context", // 64 calls, 21 sessions, 100% direct
     "get_symbols", // 69 calls — batch symbol reads
@@ -809,7 +815,6 @@ export const CORE_TOOL_NAMES = new Set([
     "index_folder", // repo onboarding
     "discover_tools", // meta: discovers remaining hidden tools
     "describe_tools", // meta: full schema for hidden tools
-    "plan_turn", // meta: route query to best tools/symbols/files
     "initial_instructions", // meta: Serena-style onboarding tool, "must call first"
     "get_session_snapshot", // session: compaction survival
     "analyze_project", // project profile
@@ -1034,9 +1039,11 @@ const TOOL_DEFINITIONS = [
                 auto_group: args.auto_group,
                 ranked: args.ranked,
             });
-            // Zero-result hint: 41% of search_text calls return nothing in telemetry.
-            // Suggest the most likely fix based on query shape so the agent doesn't
-            // burn 2-3 follow-up turns guessing.
+            // Zero-result fallback: 44% of search_text calls return nothing in
+            // telemetry. Instead of a bare empty array, return (a) shape-based
+            // hints, (b) near-miss symbol names from the index vocabulary, and
+            // (c) semantic results when an embeddings index already exists —
+            // so the agent doesn't burn 2-3 follow-up turns guessing.
             const isEmpty = (Array.isArray(result) && result.length === 0)
                 || (typeof result === "string" && result.length === 0);
             if (isEmpty) {
@@ -1054,7 +1061,19 @@ const TOOL_DEFINITIONS = [
                     hints.push("Try regex=false (literal) — escapes may be off.");
                 if (!fp && !looksLikeSymbol)
                     hints.push("Try a shorter substring, or add file_pattern= to scope.");
-                return { matches: [], hint: hints.join(" ") };
+                const { zeroHitFallback } = await import("./register-tool-loaders.js");
+                const fallback = await zeroHitFallback(args.repo, q);
+                if (fallback.semantic_results) {
+                    hints.push("Exact text not found — semantic_fallback below shows closest matches by meaning.");
+                }
+                const response = { matches: [], hint: hints.join(" ") };
+                if (fallback.suggestions) {
+                    response["did_you_mean"] = fallback.suggestions;
+                }
+                if (fallback.semantic_results) {
+                    response["semantic_fallback"] = fallback.semantic_results;
+                }
+                return response;
             }
             return result;
         },
@@ -3594,7 +3613,12 @@ const TOOL_DEFINITIONS = [
                 // Pass first matched workspace path through the existing file_pattern-style hook
                 opts.file_pattern = `${scope.rootPaths[0]}/**`;
             }
-            return nestAudit(args.repo ?? "", opts);
+            const result = await nestAudit(args.repo ?? "", opts);
+            // Telemetry: nest_audit averaged 18.4K tok/call with 110K-tok peaks —
+            // cap arrays to keep JSON valid instead of letting the cascade
+            // hard-truncate mid-structure.
+            const { capArraysToBudget } = await import("./formatters-shortening.js");
+            return capArraysToBudget(result);
         },
     },
     // --- Agent config audit ---