@contextstream/mcp-server 0.4.25 → 0.4.26

package/dist/index.js

@@ -5141,6 +5141,7 @@ var ContextStreamClient = class {
       body: {
         ...this.withDefaults(body),
         search_type: "semantic",
+        output_format: body.output_format,
         filters: body.workspace_id ? {} : { file_types: [], languages: [], file_paths: [], exclude_paths: [], content_types: [], tags: [] }
       }
     });
@@ -5150,6 +5151,7 @@ var ContextStreamClient = class {
       body: {
         ...this.withDefaults(body),
         search_type: "hybrid",
+        output_format: body.output_format,
         filters: body.workspace_id ? {} : { file_types: [], languages: [], file_paths: [], exclude_paths: [], content_types: [], tags: [] }
       }
     });
@@ -5159,6 +5161,7 @@ var ContextStreamClient = class {
       body: {
         ...this.withDefaults(body),
         search_type: "keyword",
+        output_format: body.output_format,
         filters: body.workspace_id ? {} : { file_types: [], languages: [], file_paths: [], exclude_paths: [], content_types: [], tags: [] }
       }
     });
@@ -5168,6 +5171,7 @@ var ContextStreamClient = class {
       body: {
         ...this.withDefaults(body),
         search_type: "pattern",
+        output_format: body.output_format,
         filters: body.workspace_id ? {} : { file_types: [], languages: [], file_paths: [], exclude_paths: [], content_types: [], tags: [] }
       }
     });
@@ -5182,6 +5186,7 @@ var ContextStreamClient = class {
       body: {
         ...this.withDefaults(body),
         search_type: "exhaustive",
+        output_format: body.output_format,
         filters: body.workspace_id ? {} : { file_types: [], languages: [], file_paths: [], exclude_paths: [], content_types: [], tags: [] }
       }
     });
@@ -7888,6 +7893,18 @@ Only after this preflight, proceed with search/analysis below.
 
 \u26A0\uFE0F **STOP: Before using Search/Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
 
+**\u274C WRONG workflow (wastes tokens, slow):**
+\`\`\`
+Grep "function" \u2192 Read file1.ts \u2192 Read file2.ts \u2192 Read file3.ts \u2192 finally understand
+\`\`\`
+
+**\u2705 CORRECT workflow (fast, complete):**
+\`\`\`
+search(mode="hybrid", query="function implementation") \u2192 done (results include context)
+\`\`\`
+
+**Why?** ContextStream search returns semantic matches + context + file locations in ONE call. Local tools require multiple round-trips.
+
 **Search order:**
 1. \`session(action="smart_search", query="...")\` - context-enriched
 2. \`search(mode="hybrid", query="...", limit=3)\` or \`search(mode="keyword", query="<filename>", limit=3)\`
@@ -7895,6 +7912,22 @@ Only after this preflight, proceed with search/analysis below.
 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 Mode Selection:**
+
+| Need | Mode | Example |
+|------|------|---------|
+| Find code by meaning | \`hybrid\` | "authentication logic", "error handling" |
+| Exact string/symbol | \`keyword\` | "UserAuthService", "API_KEY" |
+| File patterns | \`pattern\` | "*.sql", "test_*.py" |
+| ALL matches (refactoring) | \`exhaustive\` | "oldFunctionName" (rename across codebase) |
+| Conceptual search | \`semantic\` | "how does caching work" |
+
+**Token Efficiency:** Use \`output_format\` to reduce response size:
+- \`full\` (default): Full content for understanding code
+- \`paths\`: File paths only (80% token savings) - use for file listings
+- \`minimal\`: Compact format (60% savings) - use for refactoring
+- \`count\`: Match counts only (90% savings) - use for quick checks
+
 **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.
@@ -8010,6 +8043,18 @@ Rules Version: ${RULES_VERSION}
 
 \u26A0\uFE0F **STOP: Before using Search/Glob/Grep/Read/Explore** \u2192 Call \`search(mode="hybrid")\` FIRST. Use local tools ONLY if ContextStream returns 0 results.
 
+**\u274C WRONG workflow (wastes tokens, slow):**
+\`\`\`
+Grep "function" \u2192 Read file1.ts \u2192 Read file2.ts \u2192 Read file3.ts \u2192 finally understand
+\`\`\`
+
+**\u2705 CORRECT workflow (fast, complete):**
+\`\`\`
+search(mode="hybrid", query="function implementation") \u2192 done (results include context)
+\`\`\`
+
+**Why?** ContextStream search returns semantic matches + context + file locations in ONE call. Local tools require multiple round-trips.
+
 - **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)
@@ -8022,6 +8067,24 @@ Rules Version: ${RULES_VERSION}
 - **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
 - **On mistakes/corrections**: Immediately capture lessons with \`session(action="capture_lesson")\`
 
+### Search Mode Selection
+
+| Need | Mode | Example |
+|------|------|---------|
+| Find code by meaning | \`hybrid\` | "authentication logic", "error handling" |
+| Exact string/symbol | \`keyword\` | "UserAuthService", "API_KEY" |
+| File patterns | \`pattern\` | "*.sql", "test_*.py" |
+| ALL matches (refactoring) | \`exhaustive\` | "oldFunctionName" (rename across codebase) |
+| Conceptual search | \`semantic\` | "how does caching work" |
+
+### Token Efficiency
+
+Use \`output_format\` to reduce response size:
+- \`full\` (default): Full content for understanding code
+- \`paths\`: File paths only (80% token savings) - use for file listings
+- \`minimal\`: Compact format (60% savings) - use for refactoring
+- \`count\`: Match counts only (90% savings) - use for quick checks
+
 ### Plans & Tasks
 
 When user asks to create a plan or implementation roadmap:
@@ -10604,7 +10667,8 @@ Access: Free`,
       offset,
       content_max_chars: contentMax,
       context_lines: contextLines,
-      exact_match_boost: exactMatchBoost
+      exact_match_boost: exactMatchBoost,
+      output_format: input.output_format
     };
   }
   registerTool(
@@ -13432,7 +13496,9 @@ Use this to remove a reminder that is no longer relevant.`,
       "search",
       {
         title: "Search",
-        description: `Search workspace memory and knowledge. Modes: semantic (meaning-based), hybrid (semantic + keyword), keyword (exact match), pattern (regex), exhaustive (all matches like grep).`,
+        description: `Search workspace memory and knowledge. Modes: semantic (meaning-based), hybrid (semantic + keyword), keyword (exact match), pattern (regex), exhaustive (all matches like grep).
+
+Output formats: full (default, includes content), paths (file paths only - 80% token savings), minimal (compact - 60% savings), count (match counts only - 90% savings).`,
         inputSchema: external_exports.object({
           mode: external_exports.enum(["semantic", "hybrid", "keyword", "pattern", "exhaustive"]).describe("Search mode"),
           query: external_exports.string().describe("Search query"),
@@ -13442,7 +13508,8 @@ Use this to remove a reminder that is no longer relevant.`,
           offset: external_exports.number().optional().describe("Offset for pagination"),
           content_max_chars: external_exports.number().optional().describe("Max chars per result content (default: 400)"),
           context_lines: external_exports.number().min(0).max(10).optional().describe("Lines of context around matches (like grep -C)"),
-          exact_match_boost: external_exports.number().min(1).max(10).optional().describe("Boost factor for exact matches (default: 2.0)")
+          exact_match_boost: external_exports.number().min(1).max(10).optional().describe("Boost factor for exact matches (default: 2.0)"),
+          output_format: external_exports.enum(["full", "paths", "minimal", "count"]).optional().describe("Response format: full (default), paths (80% savings), minimal (60% savings), count (90% savings)")
         })
       },
       async (input) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.25",
+  "version": "0.4.26",
   "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",