@contextstream/mcp-server 0.4.1 → 0.4.3

package/dist/index.js

@@ -7289,116 +7289,29 @@ import * as path4 from "node:path";
 // src/rules-templates.ts
 var DEFAULT_CLAUDE_MCP_SERVER_NAME = "contextstream";
 var CONTEXTSTREAM_TOOL_NAMES = [
-  // Session/Context (standard)
+  // Standalone tools (always present)
   "session_init",
   "context_smart",
   "context_feedback",
-  "session_summary",
-  "session_capture",
-  "session_capture_lesson",
-  "session_get_lessons",
-  "session_recall",
-  "session_remember",
-  "session_get_user_context",
-  "session_smart_search",
-  "session_compress",
-  "session_delta",
-  // Editor Rules
-  "generate_editor_rules",
-  // Workspaces
-  "workspace_associate",
-  "workspace_bootstrap",
-  "workspaces_list",
-  "workspaces_create",
-  "workspaces_update",
-  "workspaces_delete",
-  "workspaces_get",
-  "workspaces_overview",
-  "workspaces_analytics",
-  "workspaces_content",
-  // Projects
-  "projects_list",
-  "projects_create",
-  "projects_update",
-  "projects_delete",
-  "projects_get",
-  "projects_overview",
-  "projects_statistics",
-  "projects_files",
-  "projects_index",
-  "projects_index_status",
-  "projects_ingest_local",
-  // Search
-  "search_semantic",
-  "search_hybrid",
-  "search_keyword",
-  "search_pattern",
-  "search_suggestions",
-  // Memory
-  "memory_create_event",
-  "memory_bulk_ingest",
-  "memory_list_events",
-  "memory_create_node",
-  "memory_list_nodes",
-  "memory_search",
-  "memory_decisions",
-  "decision_trace",
-  "memory_get_event",
-  "memory_update_event",
-  "memory_delete_event",
-  "memory_distill_event",
-  "memory_get_node",
-  "memory_update_node",
-  "memory_delete_node",
-  "memory_supersede_node",
-  "memory_timeline",
-  "memory_summary",
-  // Graph
-  "graph_related",
-  "graph_path",
-  "graph_decisions",
-  "graph_dependencies",
-  "graph_call_path",
-  "graph_impact",
-  "graph_circular_dependencies",
-  "graph_unused_code",
-  "graph_ingest",
-  "graph_contradictions",
-  // AI (PRO)
-  "ai_context",
-  "ai_enhanced_context",
-  "ai_context_budget",
-  "ai_embeddings",
-  "ai_plan",
-  "ai_tasks",
-  // GitHub Integration (PRO)
-  "github_stats",
-  "github_repos",
-  "github_contributors",
-  "github_activity",
-  "github_issues",
-  "github_search",
-  // Slack Integration (PRO)
-  "slack_stats",
-  "slack_channels",
-  "slack_contributors",
-  "slack_activity",
-  "slack_discussions",
-  "slack_search",
-  "slack_sync_users",
-  "slack_knowledge",
-  "slack_summary",
-  // GitHub additional
-  "github_knowledge",
-  "github_summary",
-  // Cross-source integrations
-  "integrations_status",
-  "integrations_search",
-  "integrations_summary",
-  "integrations_knowledge",
-  // Auth/Meta
-  "auth_me",
-  "mcp_server_version"
+  // Consolidated domain tools (v0.4.x default)
+  "search",
+  // Modes: semantic, hybrid, keyword, pattern
+  "session",
+  // Actions: capture, capture_lesson, get_lessons, recall, remember, user_context, summary, compress, delta, smart_search, decision_trace
+  "memory",
+  // Actions: 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
+  "graph",
+  // Actions: dependencies, impact, call_path, related, path, decisions, ingest, circular_dependencies, unused_code, contradictions
+  "project",
+  // Actions: list, get, create, update, index, overview, statistics, files, index_status, ingest_local
+  "workspace",
+  // Actions: list, get, associate, bootstrap
+  "reminder",
+  // Actions: list, active, create, snooze, complete, dismiss
+  "integration",
+  // Provider: slack, github, all; Actions: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues
+  "help"
+  // Actions: tools, auth, version, editor_rules, enable_bundle
 ];
 function applyMcpToolPrefix(markdown, toolPrefix) {
   const toolPattern = CONTEXTSTREAM_TOOL_NAMES.join("|");
@@ -7406,9 +7319,10 @@ function applyMcpToolPrefix(markdown, toolPrefix) {
   return markdown.replace(toolRegex, `${toolPrefix}$1`);
 }
 var CONTEXTSTREAM_RULES_FULL = `
-## ContextStream Integration (Enhanced)
+## ContextStream v0.4.x Integration (Enhanced)
 
 You have access to ContextStream MCP tools for persistent memory and context.
+v0.4.x uses **~11 consolidated domain tools** for ~75% token reduction vs previous versions.
 
 ## TL;DR - REQUIRED EVERY MESSAGE
 
@@ -7416,15 +7330,39 @@ You have access to ContextStream MCP tools for persistent memory and context.
 |---------|--------------|
 | **1st message** | \`session_init(folder_path="...", context_hint="<user's message>")\` |
 | **2nd+ messages** | \`context_smart(user_message="<user's message>", format="minified", max_tokens=400)\` |
-| **Before risky/non-trivial work** | \`session_get_lessons(query="<topic>")\` |
-| **After completing task** | \`session_capture(...)\` - MUST capture decisions/insights |
-| **User frustration/correction** | \`session_capture_lesson(...)\` - MUST capture lessons |
-| **Command/tool error + fix** | \`session_capture_lesson(...)\` - MUST capture lessons |
+| **Before risky/non-trivial work** | \`session(action="get_lessons", query="<topic>")\` |
+| **After completing task** | \`session(action="capture", event_type="decision", ...)\` - MUST capture |
+| **User frustration/correction** | \`session(action="capture_lesson", ...)\` - MUST capture lessons |
+| **Command/tool error + fix** | \`session(action="capture_lesson", ...)\` - MUST capture lessons |
 
 **NO EXCEPTIONS.** Do not skip even if you think you have enough context.
 
 ---
 
+## Consolidated Domain Tools Architecture
+
+v0.4.x consolidates ~58 individual tools into ~11 domain tools with action/mode dispatch:
+
+### Standalone Tools (Always Call)
+- **\`session_init\`** - Initialize session with workspace detection + context
+- **\`context_smart\`** - Semantic search for relevant context (CALL EVERY MESSAGE)
+
+### Domain Tools (Use action/mode parameter)
+
+| Domain | Actions/Modes | Example |
+|--------|---------------|---------|
+| **\`search\`** | mode: semantic, hybrid, keyword, pattern | \`search(mode="hybrid", query="auth implementation")\` |
+| **\`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")\` |
+| **\`project\`** | action: list, get, create, update, index, overview, statistics, files, index_status, ingest_local | \`project(action="statistics")\` |
+| **\`workspace\`** | action: list, get, associate, bootstrap | \`workspace(action="list")\` |
+| **\`reminder\`** | action: list, active, create, snooze, complete, dismiss | \`reminder(action="active")\` |
+| **\`integration\`** | provider: slack/github/all; action: status, search, stats, activity, contributors, knowledge, summary, channels, discussions, sync_users, repos, issues | \`integration(provider="github", action="search", query="...")\` |
+| **\`help\`** | action: tools, auth, version, editor_rules, enable_bundle | \`help(action="tools")\` |
+
+---
+
 ### Why context_smart is Required (Even After session_init)
 
 **Common mistake:** "session_init already gave me context, I don't need context_smart"
@@ -7447,126 +7385,124 @@ You have access to ContextStream MCP tools for persistent memory and context.
 
 - For trivial/local edits: \`context_smart(..., max_tokens=200)\`
 - Default: \`context_smart(..., max_tokens=400)\`
-- Deep debugging/architecture or heavy "what did we decide?": \`context_smart(..., max_tokens=800)\`
-- Keep \`format="minified"\` (default) unless you're debugging tool output
+- Deep debugging/architecture: \`context_smart(..., max_tokens=800)\`
+- Keep \`format="minified"\` (default) unless debugging
 
-If context still feels missing, increase \`max_tokens\` and/or call \`session_recall\` for a focused deep lookup.
+If context still feels missing, use \`session(action="recall", query="...")\` for focused deep lookup.
 
 ---
 
 ### Preferences & Lessons (Use Early)
 
-- If preferences or style matter, call \`session_get_user_context\`.
-- Before risky changes or when past mistakes may apply, call \`session_get_lessons(query="<topic>")\`.
-- When frustration, corrections, or tool mistakes occur, immediately call \`session_capture_lesson\`.
+- If preferences/style matter: \`session(action="user_context")\`
+- Before risky changes: \`session(action="get_lessons", query="<topic>")\`
+- On frustration/corrections: \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\`
 
 ---
 
-### Search, Graphs, and Code Intelligence (ContextStream-first)
+### Search & Code Intelligence (ContextStream-first)
+
+**Search order:**
+1. \`session(action="smart_search", query="...")\` - context-enriched
+2. \`search(mode="hybrid", query="...")\` - semantic + keyword
+3. \`graph(action="dependencies", ...)\` - code structure
+4. Local repo scans (rg/ls/find) - only if ContextStream returns no results
 
-- Default order: \`session_smart_search\` -> \`search_hybrid\`/\`search_keyword\`/\`search_semantic\` -> graph tools -> local repo scans (rg/ls/find) only if ContextStream returns no results.
-- Use \`session_smart_search\` before scanning the repo or grepping.
-- Use \`search_semantic\`/\`search_hybrid\`/\`search_keyword\` for targeted queries.
-- For dependencies/impact/call paths, use \`graph_dependencies\`, \`graph_impact\`, and \`graph_call_path\`.
-- If the toolset is complete (Elite), prefer \`graph_call_path\` and \`graph_path\` for call relationships instead of manual searches.
-- If the graph is missing or stale, run \`graph_ingest\` (async by default with \`wait: false\`). Tell the user it can take a few minutes; optionally call \`projects_statistics\` to estimate time.
+**Code Analysis:**
+- Dependencies: \`graph(action="dependencies", file_path="...")\`
+- Change impact: \`graph(action="impact", symbol_name="...")\`
+- Call path: \`graph(action="call_path", from_symbol="...", to_symbol="...")\`
+- Build graph: \`graph(action="ingest")\` - async, can take a few minutes
 
 ---
 
 ### Distillation & Memory Hygiene
 
-- Use \`session_summary\` for a fast workspace snapshot.
-- Use \`session_compress\` when the chat is long or context limits are near.
-- Use \`memory_summary\` for recent work summaries and \`memory_distill_event\` to condense noisy memory entries.
+- Quick context: \`session(action="summary")\`
+- Long chat: \`session(action="compress", content="...")\`
+- Memory summary: \`memory(action="summary")\`
+- Condense noisy entries: \`memory(action="distill_event", event_id="...")\`
 
 ---
 
 ### When to Capture (MANDATORY)
 
-| When | Tool | Example |
+| When | Call | Example |
 |------|------|---------|
-| User makes a decision | \`session_capture\` | "Let's use PostgreSQL" -> capture as decision |
-| User states preference | \`session_capture\` | "I prefer TypeScript" -> capture as preference |
-| You complete a task | \`session_capture\` | Capture what was done, decisions made |
-| Need past context | \`session_recall\` | "What did we decide about X?" |
+| User makes decision | \`session(action="capture", event_type="decision", ...)\` | "Let's use PostgreSQL" |
+| User states preference | \`session(action="capture", event_type="preference", ...)\` | "I prefer TypeScript" |
+| You complete a task | \`session(action="capture", event_type="task", ...)\` | Capture what was done |
+| Need past context | \`session(action="recall", query="...")\` | "What did we decide about X?" |
 
 **You MUST capture after completing any significant task.** This ensures future sessions have context.
 
 ---
 
-### Full Tool Catalog
-
-To expose all tools below, set \`CONTEXTSTREAM_TOOLSET=complete\` in your MCP config. The default (\`standard\`) includes the essential session, search, memory, and graph tools above.
-
-**To enable the complete toolset in your MCP config:**
-\`\`\`json
-{
-  "env": {
-    "CONTEXTSTREAM_TOOLSET": "complete"
-  }
-}
-\`\`\`
-
-**Available tool categories (when \`CONTEXTSTREAM_TOOLSET=complete\`):**
-
-**Session/Context** (included in standard):
-\`session_init\`, \`context_smart\`, \`context_feedback\`, \`session_summary\`, \`session_capture\`, \`session_capture_lesson\`, \`session_get_lessons\`, \`session_recall\`, \`session_remember\`, \`session_get_user_context\`, \`session_smart_search\`, \`session_compress\`, \`session_delta\`, \`generate_editor_rules\`, \`workspace_associate\`, \`workspace_bootstrap\`
-
-**Workspaces**:
-\`workspaces_list\`, \`workspaces_create\`, \`workspaces_update\`, \`workspaces_delete\`, \`workspaces_get\`, \`workspaces_overview\`, \`workspaces_analytics\`, \`workspaces_content\`
-
-**Projects**:
-\`projects_list\`, \`projects_create\`, \`projects_update\`, \`projects_delete\`, \`projects_get\`, \`projects_overview\`, \`projects_statistics\`, \`projects_files\`, \`projects_index\`, \`projects_index_status\`, \`projects_ingest_local\`
-
-**Search**:
-\`search_semantic\`, \`search_hybrid\`, \`search_keyword\`, \`search_pattern\`, \`search_suggestions\`
-
-**Memory**:
-\`memory_create_event\`, \`memory_bulk_ingest\`, \`memory_list_events\`, \`memory_create_node\`, \`memory_list_nodes\`, \`memory_search\`, \`memory_decisions\`, \`decision_trace\`, \`memory_get_event\`, \`memory_update_event\`, \`memory_delete_event\`, \`memory_distill_event\`, \`memory_get_node\`, \`memory_update_node\`, \`memory_delete_node\`, \`memory_supersede_node\`, \`memory_timeline\`, \`memory_summary\`
-
-**Graph** (code analysis):
-\`graph_related\`, \`graph_path\`, \`graph_decisions\`, \`graph_dependencies\`, \`graph_call_path\`, \`graph_impact\`, \`graph_circular_dependencies\`, \`graph_unused_code\`, \`graph_ingest\`, \`graph_contradictions\`
-
-**AI** (PRO):
-\`ai_context\`, \`ai_enhanced_context\`, \`ai_context_budget\`, \`ai_embeddings\`, \`ai_plan\`, \`ai_tasks\`
-
-**GitHub Integration** (PRO):
-\`github_stats\`, \`github_repos\`, \`github_contributors\`, \`github_activity\`, \`github_issues\`, \`github_search\`, \`github_knowledge\`, \`github_summary\`
-
-**Slack Integration** (PRO):
-\`slack_stats\`, \`slack_channels\`, \`slack_contributors\`, \`slack_activity\`, \`slack_discussions\`, \`slack_search\`, \`slack_sync_users\`, \`slack_knowledge\`, \`slack_summary\`
-
-**Cross-Source Integrations** (PRO):
-\`integrations_status\`, \`integrations_search\`, \`integrations_summary\`, \`integrations_knowledge\`
+### Complete Action Reference
+
+**session actions:**
+- \`capture\` - Save decision/insight/task (requires: event_type, title, content)
+- \`capture_lesson\` - Save lesson from mistake (requires: title, category, trigger, impact, prevention)
+- \`get_lessons\` - Retrieve relevant lessons (optional: query, category, severity)
+- \`recall\` - Natural language memory recall (requires: query)
+- \`remember\` - Quick save to memory (requires: content)
+- \`user_context\` - Get user preferences/style
+- \`summary\` - Workspace summary
+- \`compress\` - Compress long conversation
+- \`delta\` - Changes since timestamp
+- \`smart_search\` - Context-enriched search
+- \`decision_trace\` - Trace decision provenance
+
+**memory actions:**
+- Event CRUD: \`create_event\`, \`get_event\`, \`update_event\`, \`delete_event\`, \`list_events\`, \`distill_event\`
+- Node CRUD: \`create_node\`, \`get_node\`, \`update_node\`, \`delete_node\`, \`list_nodes\`, \`supersede_node\`
+- Query: \`search\`, \`decisions\`, \`timeline\`, \`summary\`
+
+**graph actions:**
+- Analysis: \`dependencies\`, \`impact\`, \`call_path\`, \`related\`, \`path\`
+- Quality: \`circular_dependencies\`, \`unused_code\`, \`contradictions\`
+- Management: \`ingest\`, \`decisions\`
 
 See full documentation: https://contextstream.io/docs/mcp/tools
 `.trim();
 var CONTEXTSTREAM_RULES_MINIMAL = `
-## ContextStream (Standard)
-
-- First user message: \`session_init(folder_path="<cwd>", context_hint="<user_message>")\`, then answer.
-- Every user message: \`context_smart(user_message="<user_message>", format="minified", max_tokens=400)\` BEFORE answering.
-  - Use \`max_tokens=200\` for trivial/local edits, \`max_tokens=800\` for deep debugging/architecture.
-- Before risky/non-trivial work: check \`session_get_lessons(query="<topic>")\`; use \`session_get_user_context\` when preferences/style matter.
-- For discovery: use \`session_smart_search\` first; use \`search_semantic\`/\`search_hybrid\`/\`search_keyword\` for targeted lookups; avoid local scans until ContextStream returns no results.
-- For code intelligence: use \`graph_dependencies\`/\`graph_impact\`/\`graph_call_path\`; if the toolset is complete (Elite), prefer \`graph_call_path\`/\`graph_path\` for call relationships; run \`graph_ingest\` if the graph is missing (async by default, can take a few minutes).
-- For distillation: use \`session_summary\` for quick context; use \`session_compress\` for long chats; use \`memory_summary\` or \`memory_distill_event\` to condense memory.
-- After meaningful work/decisions/preferences: \`session_capture(event_type=decision|preference|task|insight, title="...", content="...")\`.
-- On frustration/corrections/tool mistakes: \`session_capture_lesson(...)\`.
+## ContextStream v0.4.x (Consolidated Domain Tools)
 
-### Tool Catalog
+v0.4.x uses ~11 consolidated domain tools for ~75% token reduction vs previous versions.
 
-By default, the MCP server exposes the **standard** toolset (~58 tools). To expose fewer tools, set \`CONTEXTSTREAM_TOOLSET=light\`. To expose everything (~86 tools), set \`CONTEXTSTREAM_TOOLSET=complete\` in your MCP config:
+### Required Every Message
 
-\`\`\`json
-{
-  "env": {
-    "CONTEXTSTREAM_TOOLSET": "complete"
-  }
-}
-\`\`\`
-
-Full tool reference: https://contextstream.io/docs/mcp/tools
+| Message | What to Call |
+|---------|--------------|
+| **1st message** | \`session_init(folder_path="<cwd>", context_hint="<user_message>")\` |
+| **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>")\` |
+| **On user frustration** | \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\` |
+
+### Quick Reference: Domain Tools
+
+| Tool | Common Usage |
+|------|--------------|
+| \`search\` | \`search(mode="semantic", query="...")\` \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 |
+| \`project\` | \`project(action="list", ...)\` \u2014 list, get, create, update, index, statistics |
+| \`workspace\` | \`workspace(action="list", ...)\` \u2014 list, get, associate, bootstrap |
+| \`integration\` | \`integration(provider="github", action="search", ...)\` \u2014 GitHub/Slack integration |
+| \`help\` | \`help(action="tools")\` \u2014 tools, auth, version, editor_rules |
+
+### Behavior Rules
+
+- **First message**: Always call \`session_init\` with context_hint
+- **Every message after**: Always call \`context_smart\` BEFORE responding (semantic search for relevant context)
+- **For discovery**: Use \`session(action="smart_search")\` or \`search(mode="hybrid")\` before local repo scans
+- **For code analysis**: Use \`graph(action="dependencies")\` or \`graph(action="impact")\` for call/dependency analysis
+- **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
+- **On mistakes/corrections**: Immediately capture lessons with \`session(action="capture_lesson")\`
+
+Full docs: https://contextstream.io/docs/mcp/tools
 `.trim();
 var TEMPLATES = {
   codex: {
@@ -15215,8 +15151,8 @@ function buildContextStreamMcpServer(params) {
     CONTEXTSTREAM_API_URL: params.apiUrl,
     CONTEXTSTREAM_API_KEY: params.apiKey
   };
-  if (params.toolset) {
-    env.CONTEXTSTREAM_TOOLSET = params.toolset;
+  if (params.toolset === "router") {
+    env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
   return {
     command: "npx",
@@ -15229,8 +15165,8 @@ function buildContextStreamVsCodeServer(params) {
     CONTEXTSTREAM_API_URL: params.apiUrl,
     CONTEXTSTREAM_API_KEY: params.apiKey
   };
-  if (params.toolset) {
-    env.CONTEXTSTREAM_TOOLSET = params.toolset;
+  if (params.toolset === "router") {
+    env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
   return {
     type: "stdio",
@@ -15312,7 +15248,7 @@ async function upsertCodexTomlConfig(filePath, params) {
   const existing = exists ? await fs5.readFile(filePath, "utf8").catch(() => "") : "";
   const marker = "[mcp_servers.contextstream]";
   const envMarker = "[mcp_servers.contextstream.env]";
-  const toolsetLine = params.toolset ? `CONTEXTSTREAM_TOOLSET = "${params.toolset}"
+  const toolsetLine = params.toolset === "router" ? `CONTEXTSTREAM_PROGRESSIVE_MODE = "true"
 ` : "";
   const block = `
 
@@ -15602,19 +15538,16 @@ Created API key: ${maskedNewKey}
     console.log(`
 Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
     console.log("\nMCP toolset (which tools to expose to the AI):");
-    console.log("  1) Light \u2014 core session, project, and basic memory/graph tools (~31 tools)");
-    console.log("     Best for: Claude Code, faster responses, token-constrained environments");
-    console.log("  2) Standard (recommended) \u2014 adds workspace, memory CRUD, graph analysis, search (~58 tools)");
-    console.log("     Best for: most users, full development workflow with memory + code analysis");
-    console.log("  3) Complete \u2014 all tools including full graph + AI, GitHub, Slack integrations (~86 tools)");
-    console.log("     Best for: Elite users or power users needing full graph + integrations");
+    console.log("  1) Standard (recommended) \u2014 consolidated domain tools (~11 tools, ~75% token reduction)");
+    console.log("     Best for: all users, full functionality with minimal token overhead");
+    console.log("     Includes: session_init, context_smart + 9 domain tools (search, session, memory, graph, etc.)");
+    console.log("  2) Router \u2014 ultra-minimal with AI routing (~2 meta-tools)");
+    console.log("     Best for: experimental, routes requests through session_init + context_smart only");
     console.log("");
-    console.log("  Note: Slack/GitHub tools are auto-hidden until you connect those integrations.");
-    console.log("  Tip: Elite users should choose Complete to unlock full graph tools.");
-    console.log("  Tip: Change later by setting CONTEXTSTREAM_TOOLSET=light|standard|complete");
-    const toolsetDefault = detectedGraphTier === "full" ? "3" : "2";
-    const toolsetChoice = normalizeInput(await rl.question(`Choose [1/2/3] (default ${toolsetDefault}): `)) || toolsetDefault;
-    const toolset = toolsetChoice === "1" ? "light" : toolsetChoice === "3" ? "complete" : "standard";
+    console.log("  Note: v0.4.x uses consolidated domain tools by default for ~75% token reduction.");
+    console.log("  Tip: Change later by setting CONTEXTSTREAM_CONSOLIDATED=true|false");
+    const toolsetChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
+    const toolset = toolsetChoice === "2" ? "router" : "consolidated";
     const editors = ["codex", "claude", "cursor", "windsurf", "cline", "kilo", "roo", "aider"];
     console.log('\nSelect editors to configure (comma-separated numbers, or "all"):');
     editors.forEach((e, i) => console.log(`  ${i + 1}) ${EDITOR_LABELS[e]}`));
@@ -15671,9 +15604,9 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
     const mcpChoiceDefault = hasCodex && !hasProjectMcpEditors ? "1" : "3";
     const mcpChoice = normalizeInput(await rl.question(`Choose [${hasCodex && !hasProjectMcpEditors ? "1/2" : "1/2/3/4"}] (default ${mcpChoiceDefault}): `)) || mcpChoiceDefault;
     const mcpScope = mcpChoice === "2" && hasCodex && !hasProjectMcpEditors ? "skip" : mcpChoice === "4" ? "skip" : mcpChoice === "1" ? "global" : mcpChoice === "2" ? "project" : "both";
-    const mcpServer = toolset === "complete" ? buildContextStreamMcpServer({ apiUrl, apiKey, toolset: "complete" }) : buildContextStreamMcpServer({ apiUrl, apiKey });
+    const mcpServer = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
     const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
-    const vsCodeServer = toolset === "complete" ? buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset: "complete" }) : buildContextStreamVsCodeServer({ apiUrl, apiKey });
+    const vsCodeServer = buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset });
     const needsGlobalMcpConfig = mcpScope === "global" || mcpScope === "both" || mcpScope === "project" && hasCodex;
     if (needsGlobalMcpConfig) {
       console.log("\nInstalling global MCP config...");
@@ -15687,8 +15620,7 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
               console.log(`- ${EDITOR_LABELS[editor]}: would update ${filePath}`);
               continue;
             }
-            const codexParams = toolset === "complete" ? { apiUrl, apiKey, toolset: "complete" } : { apiUrl, apiKey };
-            const status = await upsertCodexTomlConfig(filePath, codexParams);
+            const status = await upsertCodexTomlConfig(filePath, { apiUrl, apiKey, toolset });
             writeActions.push({ kind: "mcp-config", target: filePath, status });
             console.log(`- ${EDITOR_LABELS[editor]}: ${status} ${filePath}`);
             continue;
@@ -15721,7 +15653,8 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
               }
             }
             console.log("- Claude Code: global MCP config is best done via `claude mcp add --transport stdio ...` (see docs).");
-            console.log(`  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=... --env CONTEXTSTREAM_TOOLSET=${toolset} -- npx -y @contextstream/mcp-server`);
+            const envHint = toolset === "router" ? " --env CONTEXTSTREAM_PROGRESSIVE_MODE=true" : "";
+            console.log(`  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=...${envHint} -- npx -y @contextstream/mcp-server`);
             console.log("  Windows (native): use `cmd /c npx -y @contextstream/mcp-server` after `--` if `npx` is not found.");
             continue;
           }
@@ -15925,17 +15858,16 @@ Applying to ${projects.length} project(s)...`);
       const skipped = writeActions.filter((a) => a.status === "skipped").length;
       const dry = writeActions.filter((a) => a.status === "dry-run").length;
       console.log(`Summary: ${created} created, ${updated} updated, ${appended} appended, ${skipped} skipped, ${dry} dry-run.`);
-      const toolsetDesc = toolset === "light" ? "~31 tools" : toolset === "complete" ? "~86 tools" : "~58 tools";
+      const toolsetDesc = toolset === "router" ? "~2 meta-tools (router mode)" : "~11 domain tools (consolidated)";
       console.log(`Toolset: ${toolset} (${toolsetDesc})`);
-      console.log(`Auto-hide: Slack/GitHub tools hidden until integrations connected.`);
+      console.log(`Token reduction: ~75% compared to previous versions.`);
     }
     console.log("\nNext steps:");
     console.log("- Restart your editor/CLI after changing MCP config or rules.");
-    console.log("- Prefer ContextStream search first: use session_smart_search (or mcp__contextstream__session_smart_search) before raw repo scans (rg/ls/find).");
+    console.log("- v0.4.x uses consolidated domain tools by default (~11 tools vs ~58 in v0.3.x).");
     console.log("- If any tools require UI-based MCP setup (e.g. Cline/Kilo/Roo global), follow https://contextstream.io/docs/mcp.");
-    if (toolset === "complete") {
-      console.log("- For full graph tools, run graph_ingest once per project (async; can take a few minutes).");
-      console.log("- Note: Claude Code/Desktop may warn about large tool contexts. This is expected with the complete toolset.");
+    if (toolset === "router") {
+      console.log("- Router mode uses 2 meta-tools (session_init + context_smart) for ultra-minimal token usage.");
     }
   } finally {
     rl.close();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",