@contextstream/mcp-server 0.4.20 → 0.4.22

package/README.md

@@ -289,7 +289,7 @@ In consolidated mode, you call **domain tools** with `action` / `mode`:
 ### Examples
 
 ```
-search(mode="semantic", query="auth middleware")
+search(mode="semantic", query="auth middleware", limit=3)
 memory(action="create_node", node_type="decision", title="Auth strategy", content="...")
 graph(action="impact", target="UserService")
 ```
@@ -327,9 +327,11 @@ Set **one** of:
 | `CONTEXTSTREAM_PROGRESSIVE_MODE` | Enables Router mode (~2 meta-tools) |
 | `CONTEXTSTREAM_CONTEXT_PACK` | Enable Context Pack for `context_smart` (code + graph + distill). Defaults to `true` |
 | `CONTEXTSTREAM_TOOLSET` | Legacy granular tool bundle: `light` / `standard` / `complete` (only when consolidated is off) |
-| `CONTEXTSTREAM_TOOL_ALLOWLIST` | Comma-separated tool names to expose (legacy granular mode) |
-| `CONTEXTSTREAM_SCHEMA_MODE` | Reduce schema verbosity; e.g., `compact` |
-| `CONTEXTSTREAM_OUTPUT_FORMAT` | Output formatting; e.g., `compact` / `pretty` |
+| `CONTEXTSTREAM_TOOL_ALLOWLIST` | Comma-separated tool names to expose (legacy granular mode) |
+| `CONTEXTSTREAM_SCHEMA_MODE` | Reduce schema verbosity; e.g., `compact` |
+| `CONTEXTSTREAM_OUTPUT_FORMAT` | Output formatting; e.g., `compact` / `pretty` |
+| `CONTEXTSTREAM_SEARCH_LIMIT` | Default MCP search limit (default: 3) |
+| `CONTEXTSTREAM_SEARCH_MAX_CHARS` | Max chars per search result content (default: 400) |
 
 ### Optional Defaults
 

package/dist/index.js

@@ -7482,6 +7482,7 @@ var CONTEXTSTREAM_TOOL_NAMES = [
   "session_init",
   "context_smart",
   "context_feedback",
+  "generate_rules",
   // Consolidated domain tools (v0.4.x default)
   "search",
   // Modes: semantic, hybrid, keyword, pattern
@@ -7518,7 +7519,7 @@ Rules Version: ${RULES_VERSION}
 
 | Message | What to Call |
 |---------|--------------|
-| **1st message** | \`session_init(folder_path="...", context_hint="<user's message>")\` |
+| **1st message** | \`session_init(folder_path="...", context_hint="<user's message>")\`, then \`context_smart(user_message="<user's message>", format="minified", max_tokens=400)\` |
 | **2nd+ messages** | \`context_smart(user_message="<user's message>", format="minified", max_tokens=400)\` |
 | **Before risky/non-trivial work** | \`session(action="get_lessons", query="<topic>")\` |
 | **After completing task** | \`session(action="capture", event_type="decision", ...)\` - MUST capture |
@@ -7527,6 +7528,8 @@ Rules Version: ${RULES_VERSION}
 
 **NO EXCEPTIONS.** Do not skip even if you think you have enough context.
 
+**First message rule:** After \`session_init\`, always call \`context_smart\` before any other tool or response.
+
 **Context Pack (Pro+):** If enabled, use \`context_smart(..., mode="pack", distill=true)\` for code/file queries. If unavailable or disabled, omit \`mode\` and proceed with standard \`context_smart\` (the API will fall back).
 
 **Tool naming:** Use the exact tool names exposed by your MCP client. Claude Code typically uses \`mcp__<server>__<tool>\` where \`<server>\` matches your MCP config (often \`contextstream\`). If a tool call fails with "No such tool available", refresh rules and match the tool list.
@@ -7539,13 +7542,13 @@ v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode
 
 ### Standalone Tools (Always Call)
 - **\`session_init\`** - Initialize session with workspace detection + context
-- **\`context_smart\`** - Semantic search for relevant context (CALL EVERY MESSAGE)
+- **\`context_smart\`** - Semantic search for relevant context (CALL EVERY MESSAGE, including immediately after \`session_init\`)
 
 ### Domain Tools (Use action/mode parameter)
 
 | 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")\` |
@@ -7588,7 +7591,7 @@ If context still feels missing, use \`session(action="recall", query="...")\` fo
 
 ### Rules Update Notices
 
-- If you see **[RULES_NOTICE]**, update rules via \`generate_editor_rules(folder_path="<cwd>")\` (or rerun setup).
+- If you see **[RULES_NOTICE]**, update rules via \`generate_rules()\` (or rerun setup).
 - If you see **[VERSION_NOTICE]**, tell the user to update MCP using the provided command.
 
 ---
@@ -7618,11 +7621,13 @@ Only after this preflight, proceed with search/analysis below.
 
 **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
 
+**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. Do NOT use local Search/Explore/Read unless you need exact code edits.
 
 **Code Analysis:**
@@ -7709,7 +7714,7 @@ Rules Version: ${RULES_VERSION}
 
 | Message | What to Call |
 |---------|--------------|
-| **1st message** | \`session_init(folder_path="<cwd>", context_hint="<user_message>")\` |
+| **1st message** | \`session_init(folder_path="<cwd>", context_hint="<user_message>")\`, then \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` |
 | **2nd+ messages** | \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` |
 | **Capture decisions** | \`session(action="capture", event_type="decision", title="...", content="...")\` |
 | **Before risky work** | \`session(action="get_lessons", query="<topic>")\` |
@@ -7723,7 +7728,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 |
@@ -7734,14 +7739,14 @@ Rules Version: ${RULES_VERSION}
 
 ### Behavior Rules
 
-- **First message**: Always call \`session_init\` with context_hint
+- **First message**: Call \`session_init\` with context_hint, then call \`context_smart\` before any other tool or response
 - **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 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
-- **On [RULES_NOTICE]**: Use \`generate_editor_rules(folder_path="<cwd>")\` to update rules
+- **On [RULES_NOTICE]**: Use \`generate_rules()\` to update rules
 - **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
 - **On mistakes/corrections**: Immediately capture lessons with \`session(action="capture_lesson")\`
 
@@ -8174,12 +8179,12 @@ function getRulesNotice(folderPath, clientName) {
   const candidates = resolveRulesCandidatePaths(folderPath, editorKey);
   const existing = candidates.filter((filePath) => fs3.existsSync(filePath));
   if (existing.length === 0) {
-    const updateCommand2 = folderPath ? `generate_editor_rules(folder_path="${folderPath}")` : 'generate_editor_rules(folder_path="<cwd>")';
+    const updateCommand2 = "generate_rules()";
     const notice2 = {
       status: "missing",
       latest: RULES_VERSION,
       files_checked: candidates,
-      update_tool: "generate_editor_rules",
+      update_tool: "generate_rules",
       update_args: {
         ...folderPath ? { folder_path: folderPath } : {},
         editors: editorKey ? [editorKey] : ["all"]
@@ -8213,7 +8218,7 @@ function getRulesNotice(folderPath, clientName) {
     return null;
   }
   const current = versions.sort(compareVersions2).at(-1);
-  const updateCommand = folderPath ? `generate_editor_rules(folder_path="${folderPath}")` : 'generate_editor_rules(folder_path="<cwd>")';
+  const updateCommand = "generate_rules()";
   const notice = {
     status: filesOutdated.length > 0 ? "behind" : "unknown",
     current,
@@ -8221,7 +8226,7 @@ function getRulesNotice(folderPath, clientName) {
     files_checked: existing,
     ...filesOutdated.length > 0 ? { files_outdated: filesOutdated } : {},
     ...filesMissingVersion.length > 0 ? { files_missing_version: filesMissingVersion } : {},
-    update_tool: "generate_editor_rules",
+    update_tool: "generate_rules",
     update_args: {
       ...folderPath ? { folder_path: folderPath } : {},
       editors: editorKey ? [editorKey] : ["all"]
@@ -8444,6 +8449,55 @@ async function writeEditorRules(options) {
   }
   return results;
 }
+function listGlobalRuleTargets(editors) {
+  const targets = [];
+  for (const editor of editors) {
+    const globalPaths = RULES_GLOBAL_FILES[editor];
+    if (!globalPaths || globalPaths.length === 0) {
+      continue;
+    }
+    for (const filePath of globalPaths) {
+      targets.push({ editor, filePath });
+    }
+  }
+  return targets;
+}
+async function writeGlobalRules(options) {
+  const results = [];
+  for (const editor of options.editors) {
+    const rule = generateRuleContent(editor, {
+      mode: options.mode
+    });
+    if (!rule) {
+      results.push({ editor, filename: "", status: "unknown editor", scope: "global" });
+      continue;
+    }
+    const globalPaths = RULES_GLOBAL_FILES[editor] ?? [];
+    if (globalPaths.length === 0) {
+      results.push({ editor, filename: rule.filename, status: "skipped (no global path)", scope: "global" });
+      continue;
+    }
+    for (const filePath of globalPaths) {
+      if (fs3.existsSync(filePath) && !options.overwriteExisting) {
+        results.push({ editor, filename: filePath, status: "skipped (exists)", scope: "global" });
+        continue;
+      }
+      try {
+        const status = await upsertRuleFile(filePath, rule.content);
+        results.push({ editor, filename: filePath, status, scope: "global" });
+      } catch (err) {
+        results.push({
+          editor,
+          filename: filePath,
+          status: `error: ${err.message}`,
+          scope: "global"
+        });
+      }
+    }
+  }
+  rulesNoticeCache.clear();
+  return results;
+}
 var WRITE_VERBS = /* @__PURE__ */ new Set([
   "create",
   "update",
@@ -8645,6 +8699,7 @@ var LIGHT_TOOLSET = /* @__PURE__ */ new Set([
   "session_delta",
   // Setup and configuration (3)
   "generate_editor_rules",
+  "generate_rules",
   "workspace_associate",
   "workspace_bootstrap",
   // Project management (5)
@@ -8690,6 +8745,7 @@ var STANDARD_TOOLSET = /* @__PURE__ */ new Set([
   "session_delta",
   // Setup and configuration (3)
   "generate_editor_rules",
+  "generate_rules",
   "workspace_associate",
   "workspace_bootstrap",
   // Workspace management (2)
@@ -8898,7 +8954,8 @@ var TOOL_BUNDLES = {
     "session_compress",
     "session_delta",
     "decision_trace",
-    "generate_editor_rules"
+    "generate_editor_rules",
+    "generate_rules"
   ]),
   // Memory bundle (~12 tools) - full memory CRUD operations
   memory: /* @__PURE__ */ new Set([
@@ -9033,7 +9090,7 @@ function inferOperationCategory(name) {
   if (name.startsWith("reminder")) return "Reminders";
   if (name.startsWith("slack_") || name.startsWith("github_") || name.startsWith("integration")) return "Integrations";
   if (name.startsWith("ai_")) return "AI";
-  if (name === "auth_me" || name === "mcp_server_version" || name === "generate_editor_rules") return "Utility";
+  if (name === "auth_me" || name === "mcp_server_version" || name === "generate_editor_rules" || name === "generate_rules") return "Utility";
   if (name === "tools_enable_bundle" || name === "contextstream" || name === "contextstream_help") return "Meta";
   return "Other";
 }
@@ -9099,14 +9156,22 @@ 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",
   // Standalone - complex initialization
   "context_smart",
   // Standalone - called every message
+  "generate_rules",
+  // Standalone - rule generation helper
   "search",
   // Consolidates search_semantic, search_hybrid, search_keyword, search_pattern
   "session",
@@ -10246,13 +10311,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) };
     }
   );
@@ -10260,7 +10340,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) };
     }
   );
@@ -10268,7 +10348,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) };
     }
   );
@@ -10276,7 +10356,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) };
     }
   );
@@ -11819,6 +11899,98 @@ Example: "What were the auth decisions?" or "What are my TypeScript preferences?
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
+  registerTool(
+    "generate_rules",
+    {
+      title: "Generate ContextStream rules",
+      description: `Generate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider).
+Defaults to the current project folder; no folder_path required when run from a project.
+Supported editors: ${getAvailableEditors().join(", ")}`,
+      inputSchema: external_exports.object({
+        folder_path: external_exports.string().optional().describe("Absolute path to the project folder (defaults to IDE root/cwd)"),
+        editors: external_exports.array(external_exports.enum(["codex", "windsurf", "cursor", "cline", "kilo", "roo", "claude", "aider", "all"])).optional().describe("Which editors to generate rules for. Defaults to all."),
+        workspace_name: external_exports.string().optional().describe("Workspace name to include in rules"),
+        workspace_id: external_exports.string().uuid().optional().describe("Workspace ID to include in rules"),
+        project_name: external_exports.string().optional().describe("Project name to include in rules"),
+        additional_rules: external_exports.string().optional().describe("Additional project-specific rules to append"),
+        mode: external_exports.enum(["minimal", "full"]).optional().describe("Rule verbosity mode (default: minimal)"),
+        overwrite_existing: external_exports.boolean().optional().describe("Allow overwriting existing rule files (ContextStream block only)"),
+        apply_global: external_exports.boolean().optional().describe("Also write global rule files for supported editors"),
+        dry_run: external_exports.boolean().optional().describe("If true, return content without writing files")
+      })
+    },
+    async (input) => {
+      const folderPath = resolveFolderPath(input.folder_path, sessionManager);
+      if (!folderPath) {
+        return errorResult("Error: folder_path is required. Provide folder_path or run from a project directory.");
+      }
+      const editors = input.editors?.includes("all") || !input.editors ? getAvailableEditors() : input.editors.filter((e) => e !== "all");
+      const results = [];
+      if (input.dry_run) {
+        for (const editor of editors) {
+          const rule = generateRuleContent(editor, {
+            workspaceName: input.workspace_name,
+            workspaceId: input.workspace_id,
+            projectName: input.project_name,
+            additionalRules: input.additional_rules,
+            mode: input.mode
+          });
+          if (!rule) {
+            results.push({ editor, filename: "", status: "unknown editor" });
+            continue;
+          }
+          results.push({
+            editor,
+            filename: rule.filename,
+            status: "dry run - would update"
+          });
+        }
+      } else {
+        const writeResults = await writeEditorRules({
+          folderPath,
+          editors,
+          workspaceName: input.workspace_name,
+          workspaceId: input.workspace_id,
+          projectName: input.project_name,
+          additionalRules: input.additional_rules,
+          mode: input.mode,
+          overwriteExisting: input.overwrite_existing
+        });
+        results.push(...writeResults);
+      }
+      const globalTargets = listGlobalRuleTargets(editors);
+      let globalResults;
+      if (input.apply_global) {
+        if (input.dry_run) {
+          globalResults = globalTargets.map((target) => ({
+            editor: target.editor,
+            filename: target.filePath,
+            status: "dry run - would update",
+            scope: "global"
+          }));
+        } else {
+          globalResults = await writeGlobalRules({
+            editors,
+            mode: input.mode,
+            overwriteExisting: input.overwrite_existing
+          });
+        }
+      }
+      const createdCount = results.filter((r) => r.status === "created" || r.status === "updated" || r.status === "appended").length;
+      const skippedCount = results.filter((r) => r.status.startsWith("skipped")).length;
+      const baseMessage = input.dry_run ? "Dry run complete. Use dry_run: false to write files." : skippedCount > 0 ? `Generated ${createdCount} rule files. ${skippedCount} skipped (existing files). Re-run with overwrite_existing: true to replace ContextStream blocks.` : `Generated ${createdCount} rule files.`;
+      const globalPrompt = input.apply_global ? "Global rule update complete." : globalTargets.length > 0 ? "Apply rules globally too? Re-run with apply_global: true." : "No global rule locations are known for these editors.";
+      const summary = {
+        folder: folderPath,
+        results,
+        ...globalResults ? { global_results: globalResults } : {},
+        ...globalTargets.length > 0 ? { global_targets: globalTargets } : {},
+        message: baseMessage,
+        global_prompt: globalPrompt
+      };
+      return { content: [{ type: "text", text: formatContent(summary) }], structuredContent: toStructured(summary) };
+    }
+  );
   registerTool(
     "generate_editor_rules",
     {
@@ -12969,16 +13141,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":
@@ -15169,7 +15338,8 @@ function registerPrompts(server) {
               "- Otherwise ask me for an absolute folder path.",
               "- Ask which editor(s) (windsurf,cursor,cline,kilo,roo,claude,aider) or default to all.",
               "",
-              "Then call `generate_editor_rules` and confirm which files were created/updated."
+              "Then call `generate_rules` and confirm which files were created/updated.",
+              "Ask if the user also wants to apply rules globally (pass apply_global: true)."
             ].join("\n")
           }
         }
@@ -16589,10 +16759,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 }));
@@ -16604,14 +16771,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}
@@ -17098,6 +17262,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,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "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",
@@ -22,7 +22,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "zod": "^3.23.8"
   },
   "devDependencies": {