@contextstream/mcp-server 0.4.21 → 0.4.23

package/dist/index.js

@@ -4905,6 +4905,13 @@ function normalizeGraphTier(value) {
 }
 var AI_PLAN_TIMEOUT_MS = 5e4;
 var AI_PLAN_RETRIES = 0;
+var INGEST_BENEFITS = [
+  "Enable semantic code search across your entire codebase",
+  "Get AI-powered code understanding and context for your questions",
+  "Unlock dependency analysis and impact assessment",
+  "Allow the AI assistant to find relevant code without manual file navigation",
+  "Build a searchable knowledge base of your codebase structure"
+];
 var ContextStreamClient = class {
   constructor(config) {
     this.config = config;
@@ -5450,6 +5457,72 @@ var ContextStreamClient = class {
     uuidSchema.parse(projectId);
     return request(this.config, `/projects/${projectId}/index/status`, { method: "GET" });
   }
+  /**
+   * Check if project ingestion is recommended and return a recommendation.
+   * This is used by session_init to inform the AI about the project's index status.
+   *
+   * @param projectId - Project UUID
+   * @param folderPath - Optional folder path for generating the ingest command
+   * @returns IngestRecommendation with status, reason, and benefits if recommended
+   */
+  async checkIngestRecommendation(projectId, folderPath) {
+    try {
+      const status = await this.projectIndexStatus(projectId);
+      const data = status.data || status;
+      const indexedFiles = data.indexed_files ?? 0;
+      const lastUpdated = data.last_updated;
+      const statusDetail = data.status_detail;
+      const isStale = lastUpdated ? Date.now() - new Date(lastUpdated).getTime() > 24 * 60 * 60 * 1e3 : false;
+      const isRecent = lastUpdated ? Date.now() - new Date(lastUpdated).getTime() < 60 * 60 * 1e3 : false;
+      const ingestCommand = folderPath ? `project(action="ingest_local", path="${folderPath}")` : `project(action="ingest_local", path="<your_project_path>")`;
+      if (indexedFiles === 0 || statusDetail === "no_files_indexed") {
+        return {
+          recommended: true,
+          status: "not_indexed",
+          indexed_files: 0,
+          reason: "No files have been indexed yet. Ingesting your codebase will enable semantic search and AI-powered code understanding.",
+          benefits: INGEST_BENEFITS,
+          command: ingestCommand
+        };
+      }
+      if (isStale) {
+        return {
+          recommended: true,
+          status: "stale",
+          indexed_files: indexedFiles,
+          last_indexed: lastUpdated,
+          reason: `Index is over 24 hours old (${indexedFiles} files). Re-ingesting will capture any recent changes.`,
+          benefits: ["Capture recent code changes", "Update dependency analysis", "Improve search accuracy"],
+          command: ingestCommand
+        };
+      }
+      if (isRecent) {
+        return {
+          recommended: false,
+          status: "recently_indexed",
+          indexed_files: indexedFiles,
+          last_indexed: lastUpdated,
+          reason: `Project was recently indexed (${indexedFiles} files). No action needed.`
+        };
+      }
+      return {
+        recommended: false,
+        status: "indexed",
+        indexed_files: indexedFiles,
+        last_indexed: lastUpdated,
+        reason: `Project is indexed (${indexedFiles} files). Consider re-indexing if you've made significant changes.`
+      };
+    } catch (error) {
+      const ingestCommand = folderPath ? `project(action="ingest_local", path="${folderPath}")` : `project(action="ingest_local", path="<your_project_path>")`;
+      return {
+        recommended: true,
+        status: "not_indexed",
+        reason: "Unable to determine index status. Ingesting will ensure your codebase is searchable.",
+        benefits: INGEST_BENEFITS,
+        command: ingestCommand
+      };
+    }
+  }
   /**
    * Ingest files for indexing
    * This uploads files to the API for indexing
@@ -5784,20 +5857,45 @@ var ContextStreamClient = class {
             });
           }
         }
-        if (projectId && (params.auto_index === void 0 || params.auto_index === true)) {
-          context.indexing_status = "started";
-          const projectIdCopy = projectId;
-          const rootPathCopy = rootPath;
-          (async () => {
+        if (projectId) {
+          const autoIndex = params.auto_index === void 0 || params.auto_index === true;
+          if (autoIndex) {
+            context.indexing_status = "started";
+            context.ingest_recommendation = {
+              recommended: false,
+              status: "auto_started",
+              reason: "Background ingestion started automatically. Your codebase will be searchable shortly."
+            };
+            const projectIdCopy = projectId;
+            const rootPathCopy = rootPath;
+            (async () => {
+              try {
+                for await (const batch of readAllFilesInBatches(rootPathCopy, { batchSize: 50 })) {
+                  await this.ingestFiles(projectIdCopy, batch);
+                }
+                console.error(`[ContextStream] Background indexing completed for ${rootPathCopy}`);
+              } catch (e) {
+                console.error(`[ContextStream] Background indexing failed:`, e);
+              }
+            })();
+          } else {
             try {
-              for await (const batch of readAllFilesInBatches(rootPathCopy, { batchSize: 50 })) {
-                await this.ingestFiles(projectIdCopy, batch);
+              const recommendation = await this.checkIngestRecommendation(projectId, rootPath);
+              context.ingest_recommendation = recommendation;
+              if (recommendation.recommended) {
+                console.error(`[ContextStream] Ingest recommended for ${rootPath}: ${recommendation.status}`);
               }
-              console.error(`[ContextStream] Background indexing completed for ${rootPathCopy}`);
             } catch (e) {
-              console.error(`[ContextStream] Background indexing failed:`, e);
+              console.error(`[ContextStream] Failed to check ingest recommendation:`, e);
+              context.ingest_recommendation = {
+                recommended: true,
+                status: "not_indexed",
+                reason: "Unable to determine index status. Consider ingesting to enable code search.",
+                benefits: INGEST_BENEFITS,
+                command: `project(action="ingest_local", path="${rootPath}")`
+              };
             }
-          })();
+          }
         }
       } catch (e) {
         context.project_error = String(e);
@@ -5877,6 +5975,22 @@ var ContextStreamClient = class {
         await this._fetchSessionContextFallback(context, workspaceId, projectId, params);
       }
     }
+    if (projectId && !context.ingest_recommendation) {
+      try {
+        const recommendation = await this.checkIngestRecommendation(projectId, rootPath);
+        context.ingest_recommendation = recommendation;
+        if (recommendation.recommended) {
+          console.error(`[ContextStream] Ingest recommended for existing project ${projectId}: ${recommendation.status}`);
+        }
+      } catch (e) {
+        console.error(`[ContextStream] Failed to check ingest recommendation for existing project:`, e);
+        context.ingest_recommendation = {
+          recommended: false,
+          status: "indexed",
+          reason: 'Unable to determine exact index status. Use project(action="index_status") to check.'
+        };
+      }
+    }
     return context;
   }
   /**
@@ -6717,8 +6831,11 @@ var ContextStreamClient = class {
     let charsUsed = 0;
     const maxChars = maxTokens * 4;
     let candidateContext;
+    const CS_FIRST_RULE = "\u26A0\uFE0F STOP: Before Glob/Grep/Read \u2192 search(mode=hybrid) FIRST. Local tools ONLY if 0 results.";
+    const CS_FIRST_RULE_MINIFIED = "R:CS-first|Idx:project.index_status->ingest|NoLocalScanUnlessCSempty";
     if (format === "minified") {
-      const parts = [];
+      const parts = [CS_FIRST_RULE_MINIFIED];
+      charsUsed = CS_FIRST_RULE_MINIFIED.length + 1;
       for (const item of items) {
         const entry = `${item.type}:${item.value}`;
         if (charsUsed + entry.length + 1 > maxChars) break;
@@ -6726,9 +6843,10 @@ var ContextStreamClient = class {
         charsUsed += entry.length + 1;
       }
       context = parts.join("|");
-      candidateContext = items.map((i) => `${i.type}:${i.value}`).join("|");
+      candidateContext = [CS_FIRST_RULE_MINIFIED, ...items.map((i) => `${i.type}:${i.value}`)].join("|");
     } else if (format === "structured") {
-      const grouped = {};
+      const grouped = { R: [CS_FIRST_RULE] };
+      charsUsed = CS_FIRST_RULE.length + 10;
       for (const item of items) {
         if (charsUsed > maxChars) break;
         if (!grouped[item.type]) grouped[item.type] = [];
@@ -6736,14 +6854,15 @@ var ContextStreamClient = class {
         charsUsed += item.value.length + 5;
       }
       context = JSON.stringify(grouped);
-      const candidateGrouped = {};
+      const candidateGrouped = { R: [CS_FIRST_RULE] };
       for (const item of items) {
         if (!candidateGrouped[item.type]) candidateGrouped[item.type] = [];
         candidateGrouped[item.type].push(item.value);
       }
       candidateContext = JSON.stringify(candidateGrouped);
     } else {
-      const lines = ["[CTX]"];
+      const lines = [CS_FIRST_RULE, "", "[CTX]"];
+      charsUsed = CS_FIRST_RULE.length + 10;
       for (const item of items) {
         const line = `${item.type}:${item.value}`;
         if (charsUsed + line.length + 1 > maxChars) break;
@@ -6752,7 +6871,7 @@ var ContextStreamClient = class {
       }
       lines.push("[/CTX]");
       context = lines.join("\n");
-      const candidateLines = ["[CTX]"];
+      const candidateLines = [CS_FIRST_RULE, "", "[CTX]"];
       for (const item of items) {
         candidateLines.push(`${item.type}:${item.value}`);
       }
@@ -6761,7 +6880,9 @@ var ContextStreamClient = class {
     }
     if (context.length === 0 && withDefaults.workspace_id) {
       const wsHint = items.find((i) => i.type === "W")?.value || withDefaults.workspace_id;
-      context = format === "minified" ? `W:${wsHint}|[NO_MATCHES]` : `[CTX]
+      context = format === "minified" ? `${CS_FIRST_RULE_MINIFIED}|W:${wsHint}|[NO_MATCHES]` : `${CS_FIRST_RULE}
+
+[CTX]
 W:${wsHint}
 [NO_MATCHES]
 [/CTX]`;
@@ -7548,7 +7669,7 @@ v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode
 
 | Domain | Actions/Modes | Example |
 |--------|---------------|---------|
-| **\`search\`** | mode: semantic, hybrid, keyword, pattern | \`search(mode="hybrid", query="auth implementation")\` |
+| **\`search\`** | mode: semantic, hybrid, keyword, pattern | \`search(mode="hybrid", query="auth implementation", limit=3)\` |
 | **\`session\`** | action: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace | \`session(action="capture", event_type="decision", title="Use JWT", content="...")\` |
 | **\`memory\`** | action: create_event, get_event, update_event, delete_event, list_events, distill_event, create_node, get_node, update_node, delete_node, list_nodes, supersede_node, search, decisions, timeline, summary | \`memory(action="list_events", limit=10)\` |
 | **\`graph\`** | action: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions | \`graph(action="impact", symbol_name="AuthService")\` |
@@ -7619,14 +7740,18 @@ Only after this preflight, proceed with search/analysis below.
 
 ### Search & Code Intelligence (ContextStream-first)
 
+\u26A0\uFE0F **STOP: Before using Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
+
 **Search order:**
 1. \`session(action="smart_search", query="...")\` - context-enriched
-2. \`search(mode="hybrid", query="...")\` or \`search(mode="keyword", query="<filename>")\`
+2. \`search(mode="hybrid", query="...", limit=3)\` or \`search(mode="keyword", query="<filename>", limit=3)\`
 3. \`project(action="files")\` - file tree/list (only when needed)
 4. \`graph(action="dependencies", ...)\` - code structure
-5. Local repo scans (rg/ls/find) - only if ContextStream returns no results, errors, or the user explicitly asks
+5. Local repo scans (rg/ls/find) - ONLY if ContextStream returns no results, errors, or the user explicitly asks
 
-If ContextStream returns results, stop and use them. Do NOT use local Search/Explore/Read unless you need exact code edits.
+**Search defaults:** \`search\` returns the top 3 results with compact snippets. Use \`limit\` + \`offset\` for pagination, and \`content_max_chars\` to expand snippets when needed.
+
+If ContextStream returns results, stop and use them. NEVER use local Search/Explore/Read unless you need exact code edits or ContextStream returned 0 results.
 
 **Code Analysis:**
 - Dependencies: \`graph(action="dependencies", file_path="...")\`
@@ -7726,7 +7851,7 @@ Rules Version: ${RULES_VERSION}
 
 | Tool | Common Usage |
 |------|--------------|
-| \`search\` | \`search(mode="semantic", query="...")\` \u2014 modes: semantic, hybrid, keyword, pattern |
+| \`search\` | \`search(mode="semantic", query="...", limit=3)\` \u2014 modes: semantic, hybrid, keyword, pattern |
 | \`session\` | \`session(action="capture", ...)\` \u2014 actions: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search |
 | \`memory\` | \`memory(action="list_events", ...)\` \u2014 CRUD for events/nodes, search, decisions, timeline, summary |
 | \`graph\` | \`graph(action="dependencies", ...)\` \u2014 dependencies, impact, call_path, related, ingest |
@@ -7737,10 +7862,13 @@ Rules Version: ${RULES_VERSION}
 
 ### Behavior Rules
 
+\u26A0\uFE0F **STOP: Before using Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
+
 - **First message**: Call \`session_init\` with context_hint, then call \`context_smart\` before any other tool or response
+- **On [INGEST_RECOMMENDED]**: Ask the user if they want to enable semantic code search. Explain: "Indexing your codebase enables AI-powered code search, dependency analysis, and better context. This takes a few minutes." If user agrees, run the provided \`project(action="ingest_local")\` command.
 - **Every message after**: Always call \`context_smart\` BEFORE responding (semantic search for relevant context)
 - **Before searching files/code**: Check \`project(action="index_status")\`; if missing/stale run \`project(action="ingest_local", path="<cwd>")\` or \`project(action="index")\`, and use \`graph(action="ingest")\` if needed
-- **For discovery**: Use \`session(action="smart_search")\` or \`search(mode="hybrid")\` before any local repo scans
+- **For discovery**: Use \`session(action="smart_search")\` or \`search(mode="hybrid")\` \u2014 NEVER use local Glob/Grep/Read first
 - **For file/function/config lookups**: Use \`search\`/\`graph\` first; only fall back to rg/ls/find if ContextStream returns no results
 - **If ContextStream returns results**: Do NOT use local Search/Explore/Read; only open specific files when needed for exact edits
 - **For code analysis**: Use \`graph(action="dependencies")\` or \`graph(action="impact")\` for call/dependency analysis
@@ -9154,8 +9282,14 @@ function getOperationSchema(name) {
     };
   }
 }
+function parsePositiveInt(raw, fallback) {
+  const parsed = Number.parseInt(raw ?? "", 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
 var OUTPUT_FORMAT = process.env.CONTEXTSTREAM_OUTPUT_FORMAT || "compact";
 var COMPACT_OUTPUT = OUTPUT_FORMAT === "compact";
+var DEFAULT_SEARCH_LIMIT = parsePositiveInt(process.env.CONTEXTSTREAM_SEARCH_LIMIT, 3);
+var DEFAULT_SEARCH_CONTENT_MAX_CHARS = parsePositiveInt(process.env.CONTEXTSTREAM_SEARCH_MAX_CHARS, 400);
 var CONSOLIDATED_MODE = process.env.CONTEXTSTREAM_CONSOLIDATED !== "false";
 var CONSOLIDATED_TOOLS = /* @__PURE__ */ new Set([
   "session_init",
@@ -9735,6 +9869,9 @@ Access: ${accessLabel}${showUpgrade ? ` (upgrade: ${upgradeUrl2})` : ""}`;
         const isPlanLimit = String(errorCode).toUpperCase() === "FORBIDDEN" && String(errorMessage).toLowerCase().includes("plan limit reached");
         const upgradeHint = isPlanLimit ? `
 Upgrade: ${upgradeUrl2}` : "";
+        const isUnauthorized = String(errorCode).toUpperCase() === "UNAUTHORIZED";
+        const sessionHint = isUnauthorized ? `
+Hint: Run session_init(folder_path="<your_project_path>") first to establish a session, or check that your API key is valid.` : "";
         const errorPayload = {
           success: false,
           error: {
@@ -9743,7 +9880,7 @@ Upgrade: ${upgradeUrl2}` : "";
             details: errorDetails
           }
         };
-        const errorText = `[${errorCode}] ${errorMessage}${upgradeHint}${errorDetails ? `: ${JSON.stringify(errorDetails)}` : ""}`;
+        const errorText = `[${errorCode}] ${errorMessage}${upgradeHint}${sessionHint}${errorDetails ? `: ${JSON.stringify(errorDetails)}` : ""}`;
         return {
           content: [{ type: "text", text: errorText }],
           structuredContent: errorPayload,
@@ -10303,13 +10440,28 @@ Access: Free`,
     query: external_exports.string(),
     workspace_id: external_exports.string().uuid().optional(),
     project_id: external_exports.string().uuid().optional(),
-    limit: external_exports.number().optional()
+    limit: external_exports.number().optional().describe("Max results to return (default: 3)"),
+    offset: external_exports.number().optional().describe("Offset for pagination"),
+    content_max_chars: external_exports.number().optional().describe("Max chars per result content (default: 400)")
   });
+  function normalizeSearchParams(input) {
+    const limit = typeof input.limit === "number" && input.limit > 0 ? Math.min(Math.floor(input.limit), 100) : DEFAULT_SEARCH_LIMIT;
+    const offset = typeof input.offset === "number" && input.offset > 0 ? Math.floor(input.offset) : void 0;
+    const contentMax = typeof input.content_max_chars === "number" && input.content_max_chars > 0 ? Math.max(50, Math.min(Math.floor(input.content_max_chars), 1e4)) : DEFAULT_SEARCH_CONTENT_MAX_CHARS;
+    return {
+      query: input.query,
+      workspace_id: resolveWorkspaceId(input.workspace_id),
+      project_id: resolveProjectId(input.project_id),
+      limit,
+      offset,
+      content_max_chars: contentMax
+    };
+  }
   registerTool(
     "search_semantic",
     { title: "Semantic search", description: "Semantic vector search", inputSchema: searchSchema },
     async (input) => {
-      const result = await client.searchSemantic(input);
+      const result = await client.searchSemantic(normalizeSearchParams(input));
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
@@ -10317,7 +10469,7 @@ Access: Free`,
     "search_hybrid",
     { title: "Hybrid search", description: "Hybrid search (semantic + keyword)", inputSchema: searchSchema },
     async (input) => {
-      const result = await client.searchHybrid(input);
+      const result = await client.searchHybrid(normalizeSearchParams(input));
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
@@ -10325,7 +10477,7 @@ Access: Free`,
     "search_keyword",
     { title: "Keyword search", description: "Keyword search", inputSchema: searchSchema },
     async (input) => {
-      const result = await client.searchKeyword(input);
+      const result = await client.searchKeyword(normalizeSearchParams(input));
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
@@ -10333,7 +10485,7 @@ Access: Free`,
     "search_pattern",
     { title: "Pattern search", description: "Pattern/regex search", inputSchema: searchSchema },
     async (input) => {
-      const result = await client.searchPattern(input);
+      const result = await client.searchPattern(normalizeSearchParams(input));
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
@@ -11149,8 +11301,12 @@ Runs in the background and returns immediately; use 'projects_index_status' to m
       title: "Initialize conversation session",
       description: `Initialize a new conversation session and automatically retrieve relevant context.
 This is the FIRST tool AI assistants should call when starting a conversation.
-Returns: workspace info, project info, recent memory, recent decisions, relevant context, and high-priority lessons.
-Automatically detects the IDE workspace/project path and can auto-index code.
+Returns: workspace info, project info, recent memory, recent decisions, relevant context, high-priority lessons, and ingest_recommendation.
+
+The ingest_recommendation field indicates if the project needs indexing for code search:
+- If [INGEST_RECOMMENDED] appears, ask the user if they want to enable semantic code search
+- Benefits: AI-powered code understanding, dependency analysis, better context retrieval
+- If user agrees, run: project(action="ingest_local", path="<project_path>")
 
 IMPORTANT: Pass the user's FIRST MESSAGE as context_hint to get semantically relevant context!
 Example: session_init(folder_path="/path/to/project", context_hint="how do I implement auth?")
@@ -11283,10 +11439,24 @@ This does semantic search on the first message. You only need context_smart on s
       if (versionNotice?.behind) {
         noticeLines.push(`[VERSION_NOTICE] current=${versionNotice.current} latest=${versionNotice.latest} upgrade="${versionNotice.upgrade_command}"`);
       }
+      const ingestRec = result.ingest_recommendation;
+      if (ingestRec?.recommended) {
+        const benefitsList = ingestRec.benefits?.slice(0, 3).map((b) => `  \u2022 ${b}`).join("\n") || "";
+        noticeLines.push(
+          `[INGEST_RECOMMENDED] status=${ingestRec.status}`,
+          `Reason: ${ingestRec.reason}`,
+          ingestRec.benefits ? `Benefits:
+${benefitsList}` : "",
+          `Action: Ask the user if they want to enable code search by running:`,
+          `  ${ingestRec.command || 'project(action="ingest_local", path="<project_path>")'}`
+        );
+      } else if (ingestRec?.status === "auto_started") {
+        noticeLines.push(`[INGEST_STATUS] Background indexing started. Codebase will be searchable shortly.`);
+      }
       if (noticeLines.length > 0) {
         text = `${text}
 
-${noticeLines.join("\n")}`;
+${noticeLines.filter(Boolean).join("\n")}`;
       }
       return { content: [{ type: "text", text }], structuredContent: toStructured(result) };
     }
@@ -13118,16 +13288,13 @@ Use this to remove a reminder that is no longer relevant.`,
           query: external_exports.string().describe("Search query"),
           workspace_id: external_exports.string().uuid().optional(),
           project_id: external_exports.string().uuid().optional(),
-          limit: external_exports.number().optional()
+          limit: external_exports.number().optional().describe("Max results to return (default: 3)"),
+          offset: external_exports.number().optional().describe("Offset for pagination"),
+          content_max_chars: external_exports.number().optional().describe("Max chars per result content (default: 400)")
         })
       },
       async (input) => {
-        const params = {
-          query: input.query,
-          workspace_id: resolveWorkspaceId(input.workspace_id),
-          project_id: resolveProjectId(input.project_id),
-          limit: input.limit
-        };
+        const params = normalizeSearchParams(input);
         let result;
         switch (input.mode) {
           case "semantic":
@@ -16739,10 +16906,7 @@ Code: ${device.user_code}`);
         }
         apiKey = createdKey.secret_key.trim();
         apiKeySource = "browser";
-        const maskedNewKey = maskApiKey(apiKey);
-        console.log(`
-Created API key: ${maskedNewKey}
-`);
+        console.log("\nCreated API key\n");
       }
     }
     const client = new ContextStreamClient(buildClientConfig({ apiUrl, apiKey }));
@@ -16754,14 +16918,11 @@ Created API key: ${maskedNewKey}
       throw new Error(`Authentication failed. Check your API key. (${message})`);
     }
     const email = typeof me?.data?.email === "string" ? me.data.email : typeof me?.email === "string" ? me.email : void 0;
-    const maskedKey = maskApiKey(apiKey);
-    console.log(`Authenticated as: ${email || "unknown user"} (${maskedKey})
-`);
+    console.log("Authenticated\n");
     if (!dryRun && (apiKeySource === "browser" || apiKeySource === "paste")) {
       try {
-        const saved = await writeSavedCredentials({ apiUrl, apiKey, email });
-        console.log(`Saved API key for future runs: ${saved.path} (${maskedKey})
-`);
+        await writeSavedCredentials({ apiUrl, apiKey, email });
+        console.log("Saved API key for future runs\n");
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         console.log(`Warning: failed to save API key for future runs (${credentialsFilePath()}): ${msg}
@@ -17248,6 +17409,8 @@ Environment variables:
   CONTEXTSTREAM_PROGRESSIVE_MODE  Progressive disclosure: true|false (default: false, starts with ~13 core tools)
   CONTEXTSTREAM_ROUTER_MODE   Router pattern: true|false (default: false, exposes only 2 meta-tools)
   CONTEXTSTREAM_OUTPUT_FORMAT Output verbosity: compact|pretty (default: compact, ~30% fewer tokens)
+  CONTEXTSTREAM_SEARCH_LIMIT  Default MCP search limit (default: 3)
+  CONTEXTSTREAM_SEARCH_MAX_CHARS  Max chars per search result content (default: 400)
   CONTEXTSTREAM_CONSOLIDATED  Consolidated domain tools: true|false (default: true in v0.4.x, ~75% token reduction)
   CONTEXTSTREAM_CONTEXT_PACK  Enable Context Pack in context_smart: true|false (default: true)
   CONTEXTSTREAM_PRO_TOOLS     Optional comma-separated PRO tool names (default: AI tools)

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "@contextstream/mcp-server",
-  "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.21",
-  "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
-  "type": "module",
-  "license": "MIT",
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "bin": {
-    "contextstream-mcp": "dist/index.js"
-  },
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --external:@modelcontextprotocol/sdk --banner:js=\"#!/usr/bin/env node\" && esbuild src/test-server.ts --bundle --platform=node --target=node18 --outfile=dist/test-server.js --format=esm --external:@modelcontextprotocol/sdk",
-    "start": "node dist/index.js",
-    "test-server": "tsx src/test-server.ts",
-    "test-server:start": "node dist/test-server.js",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.22.0",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "esbuild": "^0.27.0",
-    "tsx": "^4.15.4",
-    "typescript": "^5.6.3"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "contextstream",
-    "ai",
-    "code-context",
-    "memory",
-    "knowledge-graph"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/contextstream/mcp-server.git"
-  },
-  "homepage": "https://contextstream.io/docs/mcp",
-  "bugs": {
-    "url": "https://github.com/contextstream/mcp-server/issues"
-  },
-  "overrides": {
-    "qs": "6.14.1"
-  }
-}
+{
+  "name": "@contextstream/mcp-server",
+  "mcpName": "io.github.contextstreamio/mcp-server",
+  "version": "0.4.23",
+  "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "contextstream-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --external:@modelcontextprotocol/sdk --banner:js=\"#!/usr/bin/env node\" && esbuild src/test-server.ts --bundle --platform=node --target=node18 --outfile=dist/test-server.js --format=esm --external:@modelcontextprotocol/sdk",
+    "start": "node dist/index.js",
+    "test-server": "tsx src/test-server.ts",
+    "test-server:start": "node dist/test-server.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "esbuild": "^0.27.0",
+    "tsx": "^4.15.4",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "contextstream",
+    "ai",
+    "code-context",
+    "memory",
+    "knowledge-graph"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/contextstream/mcp-server.git"
+  },
+  "homepage": "https://contextstream.io/docs/mcp",
+  "bugs": {
+    "url": "https://github.com/contextstream/mcp-server/issues"
+  },
+  "overrides": {
+    "qs": "6.14.1"
+  }
+}