@contextstream/mcp-server 0.4.47 → 0.4.48

package/dist/index.js

@@ -12104,36 +12104,48 @@ function applyMcpToolPrefix(markdown, toolPrefix) {
   return markdown.replace(toolRegex, `${toolPrefix}$1`);
 }
 var CONTEXTSTREAM_RULES_DYNAMIC = `
-## ContextStream Dynamic Rules (Powered by our SmartRouter)
+# ContextStream Rules (MANDATORY)
 
-All rules are served dynamically via \`context\`. This file is minimal by design.
+## \u{1F6A8} CRITICAL: Call These Tools or Fail \u{1F6A8}
 
-### Every Message Protocol
+<contextstream_protocol>
+**EVERY response MUST start with:**
+1. \`init()\` (1st message only) \u2192 then \`context(user_message="<msg>")\`
+2. \`context(user_message="<msg>")\` (EVERY subsequent message)
 
-| Message | What to Call |
-|---------|--------------|
-| **1st message** | \`init()\` then \`context(user_message="<msg>")\` |
-| **2nd+ messages** | \`context(user_message="<msg>")\` |
+**BEFORE Glob/Grep/Read/Search/Explore:**
+\u2192 \`search(mode="hybrid", query="...")\` FIRST \u2014 local tools ONLY if 0 results
 
-Note: \`init()\` auto-detects folder from IDE. Only pass \`folder_path\` if auto-detection fails.
+**HOOKS: Follow \`<system-reminder>\` instructions \u2014 they ARE the rules**
+</contextstream_protocol>
 
-### Follow the Instructions Field
+### Why This Matters
 
-The \`context\` response includes an \`instructions\` field with context-aware guidance.
-**Follow these instructions.** They are dynamically matched to your query and include:
-- Search guidance (when/how to search)
-- Git workflow rules (commit, PR, safety)
-- Planning rules (use ContextStream plans, not file-based)
-- Media/code analysis guidance
-- Lessons from past mistakes
-- And more...
+- **\`context()\`** = Your rules, lessons, and relevant memories delivered dynamically
+- **\`search()\`** = Indexed search (1 call) vs Grep\u2192Read\u2192Read (4+ calls)
+- **Hooks inject \`<system-reminder>\` tags** = Follow these instructions, they enforce ContextStream-first
+- **Skipping these = missing context, repeated mistakes, slow searches**
 
-### Notices
+### Protocol
 
-Handle notices from \`context\` response:
-- **[VERSION_NOTICE]**: Tell user to update MCP
-- **[RULES_NOTICE]**: Run \`generate_rules()\`
-- **[LESSONS_WARNING]**: Apply lessons immediately
+| When | Do This |
+|------|---------|
+| 1st message | \`init()\` \u2192 \`context(user_message="...")\` |
+| Every message after | \`context(user_message="...")\` |
+| Before ANY file search | \`search(mode="hybrid")\` first |
+| On \`<system-reminder>\` | **Follow the instructions inside** |
+| Save decisions | \`session(action="capture", ...)\` |
+
+### Handle Notices from context()
+
+- **[LESSONS_WARNING]** \u2192 Tell user about past mistakes BEFORE proceeding
+- **[RULES_NOTICE]** \u2192 Run \`generate_rules()\` to update
+- **[VERSION_NOTICE]** \u2192 Tell user to update MCP
+
+### Fast Path (Skip context only for these)
+
+Simple utility commands: "list workspaces", "show version", "list reminders"
+\u2192 Just execute directly: \`workspace(action="list")\`, \`help(action="version")\`
 
 Rules Version: ${RULES_VERSION}
 `.trim();
@@ -12591,83 +12603,71 @@ memory(action="create_task", title="<task title>", plan_id="<plan_id from step 1
 See full documentation: https://contextstream.io/docs/mcp/tools
 `.trim();
 var CONTEXTSTREAM_RULES_MINIMAL = `
-## ContextStream Rules
+# ContextStream Rules (MANDATORY)
 
-<contextstream_rules>
-1. **SIMPLE UTILITY?** (list/show/version) \u2192 Just execute, skip context calls
-2. **CODING TASK?** \u2192 init \u2192 context \u2192 work \u2192 capture
-3. **SEARCH FIRST:** Before Glob/Grep/Read \u2192 \`search(mode="hybrid")\` FIRST
-</contextstream_rules>
+## \u{1F6A8} CRITICAL: These Rules Are Non-Negotiable \u{1F6A8}
 
-**Display this block at the start of responses to keep rules in context.**
+<contextstream_protocol>
+**EVERY coding response MUST start with:**
+1. \`init()\` (1st message only) \u2192 then \`context(user_message="<msg>")\`
+2. \`context(user_message="<msg>")\` (EVERY subsequent message)
 
----
+**BEFORE Glob/Grep/Read/Search/Explore:**
+\u2192 \`search(mode="hybrid", query="...")\` FIRST \u2014 local tools ONLY if 0 results
 
-## ContextStream v0.4.x (Hooks Enforced)
+**HOOKS: \`<system-reminder>\` tags contain instructions \u2014 FOLLOW THEM**
+</contextstream_protocol>
 
 Rules Version: ${RULES_VERSION}
-**Note:** PreToolUse hooks block Glob/Grep/Search when ContextStream is available.
 
-### For Coding Tasks
+---
 
-| Action | Tool Call |
-|--------|-----------|
-| **1st message** | \`init(folder_path="<cwd>", context_hint="<msg>")\` then \`context(...)\` |
-| **2nd+ messages** | \`context(user_message="<msg>", format="minified", max_tokens=400)\` |
-| **Code search** | \`search(mode="hybrid", query="...")\` \u2014 BEFORE any local tools |
-| **Save decisions** | \`session(action="capture", event_type="decision", ...)\` |
+## Why ContextStream First?
 
-### Search Modes
+| \u274C WRONG | \u2705 CORRECT |
+|----------|-----------|
+| \`Grep \u2192 Read \u2192 Read \u2192 Read\` (4+ calls) | \`search(mode="hybrid")\` (1 call) |
+| Missing past decisions & lessons | \`context()\` = rules + lessons + memory |
+| Ignoring \`<system-reminder>\` hooks | Hooks enforce ContextStream-first |
+
+**\`context()\` delivers: rules, lessons from past mistakes, relevant decisions, semantic matches**
+**\`search()\` is indexed: faster, returns context, one call vs many**
+**Hooks inject \`<system-reminder>\` tags: these ARE the rules, follow them**
+
+---
 
-| Mode | Use Case |
-|------|----------|
-| \`hybrid\` | General code search (default) |
-| \`keyword\` | Exact symbol/string match |
-| \`exhaustive\` | Find ALL matches (grep-like) |
+## Protocol
+
+| When | Call |
+|------|------|
+| 1st message | \`init()\` \u2192 \`context(user_message="...")\` |
+| Every message after | \`context(user_message="...")\` |
+| Before ANY file discovery | \`search(mode="hybrid", query="...")\` |
+| On \`<system-reminder>\` | **Follow instructions inside** |
+| Save important decisions | \`session(action="capture", event_type="decision", ...)\` |
+| Check past mistakes | \`session(action="get_lessons", query="...")\` |
+
+## Search Modes
+
+| Mode | When |
+|------|------|
+| \`hybrid\` | Default \u2014 semantic + keyword |
+| \`keyword\` | Exact symbol match |
+| \`exhaustive\` | Find ALL occurrences |
 | \`semantic\` | Conceptual questions |
 
-### Why ContextStream First?
+## Handle Notices from context()
 
-\u274C **WRONG:** \`Grep \u2192 Read \u2192 Read \u2192 Read\` (4+ tool calls, slow)
-\u2705 **CORRECT:** \`search(mode="hybrid")\` (1 call, returns context)
+- **[LESSONS_WARNING]** \u2192 Tell user about past mistakes BEFORE proceeding
+- **[RULES_NOTICE]** \u2192 Run \`generate_rules()\`
+- **[VERSION_NOTICE]** \u2192 Tell user to update MCP
 
-ContextStream search is **indexed** and returns semantic matches + context in ONE call.
+## Fast Path (Simple Utilities Only)
 
-### Quick Reference
+Skip init/context ONLY for: "list workspaces", "show version", "list reminders"
+\u2192 Just call: \`workspace(action="list")\`, \`help(action="version")\`, etc.
 
-| Tool | Example |
-|------|---------|
-| \`search\` | \`search(mode="hybrid", query="auth", limit=3)\` |
-| \`session\` | \`session(action="capture", event_type="decision", title="...", content="...")\` |
-| \`memory\` | \`memory(action="list_events", limit=10)\` |
-| \`graph\` | \`graph(action="dependencies", file_path="...")\` |
-
-### \u{1F680} FAST PATH: Simple Utility Operations
-
-**For simple utility commands, SKIP the ceremony and just execute directly:**
-
-| Command Type | Just Call | Skip |
-|--------------|-----------|------|
-| List workspaces | \`workspace(action="list")\` | init, context, capture |
-| List projects | \`project(action="list")\` | init, context, capture |
-| Show version | \`help(action="version")\` | init, context, capture |
-| List reminders | \`reminder(action="list")\` | init, context, capture |
-| Check auth | \`help(action="auth")\` | init, context, capture |
-
-**Detect simple operations by these patterns:**
-- "list ...", "show ...", "what are my ...", "get ..."
-- Single-action queries with no context dependency
-- User just wants data, not analysis or coding help
-
-**DO NOT add overhead for utility operations:**
-- \u274C Don't call init just to list workspaces
-- \u274C Don't call context for simple queries
-- \u274C Don't capture "listed workspaces" as an event (that's noise)
-
-**Use full context ceremony ONLY for:**
-- Coding tasks (edit, create, refactor, debug)
-- Search/discovery (finding code, understanding architecture)
-- Tasks where past decisions or lessons matter
+Everything else = full protocol (init \u2192 context \u2192 search \u2192 work)
 
 ### Lessons (Past Mistakes)
 
@@ -21120,13 +21120,19 @@ ${formatContent(result)}`
             if (!workspaceId) {
               return errorResult("create_doc requires workspace_id. Call session_init first.");
             }
+            const detectedEditor = getDetectedClientName();
+            const aiMetadata = detectedEditor ? {
+              created_by_ai: true,
+              ai_editor: detectedEditor,
+              ...input.metadata || {}
+            } : input.metadata;
             const docResult = await client.docsCreate({
               workspace_id: workspaceId,
               project_id: projectId,
               title: input.title,
               content: input.content,
               doc_type: input.doc_type,
-              metadata: input.metadata,
+              metadata: aiMetadata,
               is_personal: input.is_personal
             });
             return {
@@ -23207,7 +23213,7 @@ function registerLimitedTools(server) {
             text: `ContextStream: API key not configured.
 
 To set up (creates key + configures your editor):
-  npx -y @contextstream/mcp-server setup
+  npx --prefer-online -y @contextstream/mcp-server@latest setup
 
 This will:
 - Start a 5-day Pro trial
@@ -23215,7 +23221,7 @@ This will:
 - Write rules files for better AI assistance
 
 Preview first:
-  npx -y @contextstream/mcp-server setup --dry-run
+  npx --prefer-online -y @contextstream/mcp-server@latest setup --dry-run
 
 After setup, restart your editor to enable all ContextStream tools.`
           }
@@ -25354,13 +25360,13 @@ function buildContextStreamMcpServer(params) {
   if (IS_WINDOWS) {
     return {
       command: "cmd",
-      args: ["/c", "npx", "-y", "@contextstream/mcp-server"],
+      args: ["/c", "npx", "--prefer-online", "-y", "@contextstream/mcp-server@latest"],
       env
     };
   }
   return {
     command: "npx",
-    args: ["-y", "@contextstream/mcp-server"],
+    args: ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
     env
   };
 }
@@ -25383,14 +25389,14 @@ function buildContextStreamVsCodeServer(params) {
     return {
       type: "stdio",
       command: "cmd",
-      args: ["/c", "npx", "-y", "@contextstream/mcp-server"],
+      args: ["/c", "npx", "--prefer-online", "-y", "@contextstream/mcp-server@latest"],
       env
     };
   }
   return {
     type: "stdio",
     command: "npx",
-    args: ["-y", "@contextstream/mcp-server"],
+    args: ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
     env
   };
 }
@@ -25484,9 +25490,9 @@ async function upsertCodexTomlConfig(filePath, params) {
   const showTimingLine = params.showTiming ? `CONTEXTSTREAM_SHOW_TIMING = "true"
 ` : "";
   const commandLine = IS_WINDOWS ? `command = "cmd"
-args = ["/c", "npx", "-y", "@contextstream/mcp-server"]
+args = ["/c", "npx", "--prefer-online", "-y", "@contextstream/mcp-server@latest"]
 ` : `command = "npx"
-args = ["-y", "@contextstream/mcp-server"]
+args = ["--prefer-online", "-y", "@contextstream/mcp-server@latest"]
 `;
   const block = `
 
@@ -25634,7 +25640,7 @@ async function runSetupWizard(args) {
       console.log(`   Latest version is v${versionNotice.latest}`);
       console.log("");
       console.log("   To use the latest version, exit and run:");
-      console.log("   npx -y @contextstream/mcp-server@latest setup");
+      console.log("   npx --prefer-online -y @contextstream/mcp-server@latest setup");
       console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
       console.log("");
       const continueAnyway = normalizeInput(
@@ -25989,10 +25995,10 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
             const envHint = toolset === "router" ? " --env CONTEXTSTREAM_PROGRESSIVE_MODE=true" : "";
             const packHint = contextPackEnabled === false ? " --env CONTEXTSTREAM_CONTEXT_PACK=false" : " --env CONTEXTSTREAM_CONTEXT_PACK=true";
             console.log(
-              `  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=...${envHint}${packHint} -- npx -y @contextstream/mcp-server`
+              `  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=...${envHint}${packHint} -- npx --prefer-online -y @contextstream/mcp-server@latest`
             );
             console.log(
-              "  Windows (native): use `cmd /c npx -y @contextstream/mcp-server` after `--` if `npx` is not found."
+              "  Windows (native): use `cmd /c npx --prefer-online -y @contextstream/mcp-server@latest` after `--` if `npx` is not found."
             );
             continue;
           }
@@ -26327,7 +26333,7 @@ function printHelp() {
   console.log(`ContextStream MCP Server (contextstream-mcp) v${VERSION}
 
 Usage:
-  npx -y @contextstream/mcp-server
+  npx --prefer-online -y @contextstream/mcp-server@latest
   contextstream-mcp
   contextstream-mcp setup
   contextstream-mcp http
@@ -26374,10 +26380,10 @@ Environment variables:
 Examples:
   CONTEXTSTREAM_API_URL="https://api.contextstream.io" \\
   CONTEXTSTREAM_API_KEY="your_api_key" \\
-  npx -y @contextstream/mcp-server
+  npx --prefer-online -y @contextstream/mcp-server@latest
 
 Setup wizard:
-  npx -y @contextstream/mcp-server setup
+  npx --prefer-online -y @contextstream/mcp-server@latest setup
 
 Notes:
   - When used from an MCP client (e.g. Codex, Cursor, VS Code),
@@ -26391,7 +26397,7 @@ async function runLimitedModeServer() {
   });
   registerLimitedTools(server);
   console.error(`ContextStream MCP server v${VERSION} (limited mode)`);
-  console.error('Run "npx -y @contextstream/mcp-server setup" to enable all tools.');
+  console.error('Run "npx --prefer-online -y @contextstream/mcp-server@latest setup" to enable all tools.');
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("ContextStream MCP server connected (limited mode - setup required)");

package/package.json

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