@contextstream/mcp-server 0.4.21 → 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

@@ -7548,7 +7548,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")\` |
@@ -7621,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:**
@@ -7726,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 |
@@ -9154,8 +9156,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",
@@ -10303,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) };
     }
   );
@@ -10317,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) };
     }
   );
@@ -10325,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) };
     }
   );
@@ -10333,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) };
     }
   );
@@ -13118,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":
@@ -16739,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 }));
@@ -16754,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}
@@ -17248,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.21",
+  "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": {