@contextstream/mcp-server 0.2.7 → 0.3.0

package/README.md

@@ -35,15 +35,14 @@ A powerful Model Context Protocol (MCP) server that provides persistent memory,
 
 ## Installation
 
-Add ContextStream to your AI tool's MCP configuration:
+Add ContextStream to your AI tool's MCP configuration (works with **Cursor**, **VS Code**, **Claude Code**, **Windsurf**, and any MCP-compatible client):
 
-### Cursor / VS Code
 ```json
 {
   "mcpServers": {
     "contextstream": {
       "command": "npx",
-      "args": ["@contextstream/mcp-server"],
+      "args": ["-y", "@contextstream/mcp-server"],
       "env": {
         "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
         "CONTEXTSTREAM_API_KEY": "your_api_key"
@@ -53,39 +52,30 @@ Add ContextStream to your AI tool's MCP configuration:
 }
 ```
 
-### Claude Code
-```json
-{
-  "mcpServers": {
-    "contextstream": {
-      "command": "npx",
-      "args": ["@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "your_api_key"
-      }
-    }
-  }
-}
-```
+Get your API key at [contextstream.io](https://contextstream.io)
 
-### Windsurf
-```json
-{
-  "mcpServers": {
-    "contextstream": {
-      "command": "npx",
-      "args": ["@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "your_api_key"
-      }
-    }
-  }
-}
+## ✨ Auto-Context (v0.3.0+)
+
+Context loads **automatically** on the first tool call of any conversation. No need to manually call `session_init` — your AI assistant gets workspace info, recent memory, and decisions immediately.
+
+```
+═══════════════════════════════════════════
+🧠 AUTO-CONTEXT LOADED (ContextStream)
+═══════════════════════════════════════════
+📁 Workspace: my-project
+📂 Project: backend-api
+
+📋 Recent Decisions:
+   • Use PostgreSQL for persistence
+   • JWT for authentication
+
+🧠 Recent Context:
+   • [decision] API design patterns
+   • [preference] TypeScript strict mode
+═══════════════════════════════════════════
 ```
 
-Get your API key at [contextstream.io](https://contextstream.io)
+Works with **all MCP clients** — no client-side changes required.
 
 ## Environment Variables
 

package/dist/index.js

@@ -5025,8 +5025,41 @@ function toStructured(data) {
   }
   return void 0;
 }
-function registerTools(server, client) {
-  server.registerTool(
+function registerTools(server, client, sessionManager) {
+  function wrapWithAutoContext(toolName, handler) {
+    if (!sessionManager) {
+      return handler;
+    }
+    return async (input) => {
+      const skipAutoInit = toolName === "session_init";
+      let contextPrefix = "";
+      if (!skipAutoInit) {
+        const autoInitResult = await sessionManager.autoInitialize();
+        if (autoInitResult) {
+          contextPrefix = autoInitResult.contextSummary + "\n\n";
+        }
+      }
+      const result = await handler(input);
+      if (contextPrefix && result && typeof result === "object") {
+        const r = result;
+        if (r.content && r.content.length > 0 && r.content[0].type === "text") {
+          r.content[0] = {
+            ...r.content[0],
+            text: contextPrefix + "--- Tool Response ---\n\n" + r.content[0].text
+          };
+        }
+      }
+      return result;
+    };
+  }
+  function registerTool(name, config, handler) {
+    server.registerTool(
+      name,
+      config,
+      wrapWithAutoContext(name, handler)
+    );
+  }
+  registerTool(
     "auth_me",
     {
       title: "Get current user",
@@ -5038,7 +5071,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_list",
     {
       title: "List workspaces",
@@ -5050,7 +5083,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_create",
     {
       title: "Create workspace",
@@ -5066,7 +5099,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_list",
     {
       title: "List projects",
@@ -5078,7 +5111,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_create",
     {
       title: "Create project",
@@ -5094,7 +5127,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_index",
     {
       title: "Index project",
@@ -5112,7 +5145,7 @@ function registerTools(server, client) {
     project_id: external_exports.string().uuid().optional(),
     limit: external_exports.number().optional()
   });
-  server.registerTool(
+  registerTool(
     "search_semantic",
     { title: "Semantic search", description: "Semantic vector search", inputSchema: searchSchema },
     async (input) => {
@@ -5120,7 +5153,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "search_hybrid",
     { title: "Hybrid search", description: "Hybrid search (semantic + keyword)", inputSchema: searchSchema },
     async (input) => {
@@ -5128,7 +5161,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "search_keyword",
     { title: "Keyword search", description: "Keyword search", inputSchema: searchSchema },
     async (input) => {
@@ -5136,7 +5169,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "search_pattern",
     { title: "Pattern search", description: "Pattern/regex search", inputSchema: searchSchema },
     async (input) => {
@@ -5144,7 +5177,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_create_event",
     {
       title: "Create memory event",
@@ -5163,7 +5196,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_bulk_ingest",
     {
       title: "Bulk ingest events",
@@ -5179,7 +5212,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_list_events",
     {
       title: "List memory events",
@@ -5195,7 +5228,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_create_node",
     {
       title: "Create knowledge node",
@@ -5219,7 +5252,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_list_nodes",
     {
       title: "List knowledge nodes",
@@ -5235,7 +5268,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_search",
     {
       title: "Memory-aware search",
@@ -5252,7 +5285,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_decisions",
     {
       title: "Decision summaries",
@@ -5268,7 +5301,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_related",
     {
       title: "Related knowledge nodes",
@@ -5285,7 +5318,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_path",
     {
       title: "Knowledge path",
@@ -5302,7 +5335,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_decisions",
     {
       title: "Decision graph",
@@ -5318,7 +5351,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_dependencies",
     {
       title: "Code dependencies",
@@ -5334,7 +5367,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_call_path",
     {
       title: "Call path",
@@ -5350,7 +5383,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_impact",
     {
       title: "Impact analysis",
@@ -5362,7 +5395,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "ai_context",
     {
       title: "Build AI context",
@@ -5382,7 +5415,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "ai_embeddings",
     {
       title: "Generate embeddings",
@@ -5394,7 +5427,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "ai_plan",
     {
       title: "Generate dev plan",
@@ -5410,7 +5443,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "ai_tasks",
     {
       title: "Generate tasks",
@@ -5427,7 +5460,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "ai_enhanced_context",
     {
       title: "Enhanced AI context",
@@ -5447,7 +5480,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_get",
     {
       title: "Get project",
@@ -5459,7 +5492,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_overview",
     {
       title: "Project overview",
@@ -5471,7 +5504,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_statistics",
     {
       title: "Project statistics",
@@ -5483,7 +5516,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_files",
     {
       title: "List project files",
@@ -5495,7 +5528,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_index_status",
     {
       title: "Index status",
@@ -5507,7 +5540,7 @@ function registerTools(server, client) {
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "projects_ingest_local",
     {
       title: "Ingest local files",
@@ -5551,7 +5584,7 @@ Automatically detects code files and skips ignored directories like node_modules
       };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_get",
     {
       title: "Get workspace",
@@ -5563,7 +5596,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_overview",
     {
       title: "Workspace overview",
@@ -5575,7 +5608,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_analytics",
     {
       title: "Workspace analytics",
@@ -5587,7 +5620,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspaces_content",
     {
       title: "Workspace content",
@@ -5599,7 +5632,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_get_event",
     {
       title: "Get memory event",
@@ -5611,7 +5644,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_update_event",
     {
       title: "Update memory event",
@@ -5629,7 +5662,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_delete_event",
     {
       title: "Delete memory event",
@@ -5641,7 +5674,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_distill_event",
     {
       title: "Distill memory event",
@@ -5653,7 +5686,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_get_node",
     {
       title: "Get knowledge node",
@@ -5665,7 +5698,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_update_node",
     {
       title: "Update knowledge node",
@@ -5683,7 +5716,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_delete_node",
     {
       title: "Delete knowledge node",
@@ -5695,7 +5728,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_supersede_node",
     {
       title: "Supersede knowledge node",
@@ -5712,7 +5745,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_timeline",
     {
       title: "Memory timeline",
@@ -5724,7 +5757,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "memory_summary",
     {
       title: "Memory summary",
@@ -5736,7 +5769,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_circular_dependencies",
     {
       title: "Find circular dependencies",
@@ -5748,7 +5781,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_unused_code",
     {
       title: "Find unused code",
@@ -5760,7 +5793,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "graph_contradictions",
     {
       title: "Find contradictions",
@@ -5772,7 +5805,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "search_suggestions",
     {
       title: "Search suggestions",
@@ -5788,7 +5821,7 @@ Automatically detects code files and skips ignored directories like node_modules
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_init",
     {
       title: "Initialize conversation session",
@@ -5821,10 +5854,13 @@ IMPORTANT: If you know the current workspace folder path, pass it as folder_path
         ideRoots = [input.folder_path];
       }
       const result = await client.initSession(input, ideRoots);
+      if (sessionManager) {
+        sessionManager.markInitialized(result);
+      }
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_get_user_context",
     {
       title: "Get user context and preferences",
@@ -5839,7 +5875,7 @@ Use this to understand how the user likes to work and adapt your responses accor
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "workspace_associate",
     {
       title: "Associate folder with workspace",
@@ -5859,7 +5895,7 @@ Optionally creates a parent folder mapping (e.g., all repos under /dev/company/*
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_capture",
     {
       title: "Capture context to memory",
@@ -5881,7 +5917,7 @@ Use this to persist decisions, insights, preferences, or important information.`
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_smart_search",
     {
       title: "Smart context search",
@@ -5900,7 +5936,7 @@ Returns memory matches, relevant code, and related decisions in one call.`,
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_remember",
     {
       title: "Remember this",
@@ -5934,7 +5970,7 @@ Example: "Remember that I prefer TypeScript strict mode" or "Remember we decided
       return { content: [{ type: "text", text: `Remembered: ${input.content.slice(0, 100)}...` }], structuredContent: toStructured(result) };
     }
   );
-  server.registerTool(
+  registerTool(
     "session_recall",
     {
       title: "Recall from memory",
@@ -6292,20 +6328,191 @@ Then synthesize the retrieved context into a coherent briefing that will help wi
   );
 }
 
+// src/session-manager.ts
+var SessionManager = class {
+  constructor(server, client) {
+    this.server = server;
+    this.client = client;
+    this.initialized = false;
+    this.initializationPromise = null;
+    this.context = null;
+    this.ideRoots = [];
+    this.folderPath = null;
+  }
+  /**
+   * Check if session has been auto-initialized
+   */
+  isInitialized() {
+    return this.initialized;
+  }
+  /**
+   * Get the auto-loaded context (if any)
+   */
+  getContext() {
+    return this.context;
+  }
+  /**
+   * Mark session as manually initialized (e.g., when session_init is called explicitly)
+   */
+  markInitialized(context) {
+    this.initialized = true;
+    this.context = context;
+  }
+  /**
+   * Set the folder path hint (can be passed from tools that know the workspace path)
+   */
+  setFolderPath(path3) {
+    this.folderPath = path3;
+  }
+  /**
+   * Auto-initialize the session if not already done.
+   * Returns context summary to prepend to tool response.
+   * 
+   * This is the core of the auto-context feature.
+   */
+  async autoInitialize() {
+    if (this.initialized) {
+      return null;
+    }
+    if (this.initializationPromise) {
+      await this.initializationPromise;
+      return null;
+    }
+    try {
+      const rootsResponse = await this.server.server.listRoots();
+      if (rootsResponse?.roots) {
+        this.ideRoots = rootsResponse.roots.map(
+          (r) => r.uri.replace("file://", "")
+        );
+      }
+    } catch {
+    }
+    if (this.ideRoots.length === 0 && this.folderPath) {
+      this.ideRoots = [this.folderPath];
+    }
+    this.initializationPromise = this._doInitialize();
+    try {
+      const result = await this.initializationPromise;
+      return result;
+    } finally {
+      this.initializationPromise = null;
+    }
+  }
+  async _doInitialize() {
+    try {
+      console.error("[ContextStream] Auto-initializing session context...");
+      const context = await this.client.initSession(
+        {
+          auto_index: true,
+          include_recent_memory: true,
+          include_decisions: true
+        },
+        this.ideRoots
+      );
+      this.initialized = true;
+      this.context = context;
+      const summary = this.buildContextSummary(context);
+      console.error("[ContextStream] Auto-initialization complete");
+      console.error(`[ContextStream] Workspace: ${context.workspace_name || "unknown"}`);
+      console.error(`[ContextStream] Project: ${context.project_id ? "loaded" : "none"}`);
+      return { contextSummary: summary, context };
+    } catch (error) {
+      console.error("[ContextStream] Auto-initialization failed:", error);
+      this.initialized = true;
+      return null;
+    }
+  }
+  /**
+   * Build a concise context summary for prepending to tool responses
+   */
+  buildContextSummary(context) {
+    const parts = [];
+    parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    parts.push("\u{1F9E0} AUTO-CONTEXT LOADED (ContextStream)");
+    parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    if (context.status === "requires_workspace_selection") {
+      parts.push("");
+      parts.push("\u26A0\uFE0F  NEW FOLDER DETECTED");
+      parts.push(`Folder: ${context.folder_name || "unknown"}`);
+      parts.push("");
+      parts.push("Please ask the user which workspace this belongs to:");
+      const candidates = context.workspace_candidates;
+      if (candidates) {
+        candidates.forEach((w, i) => {
+          parts.push(`  ${i + 1}. ${w.name}${w.description ? ` - ${w.description}` : ""}`);
+        });
+      }
+      parts.push("  \u2022 Or create a new workspace");
+      parts.push("");
+      parts.push("Use workspace_associate tool after user selects.");
+      parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+      return parts.join("\n");
+    }
+    if (context.workspace_name) {
+      parts.push(`\u{1F4C1} Workspace: ${context.workspace_name}`);
+      if (context.workspace_created) {
+        parts.push("   (auto-created for this folder)");
+      }
+    }
+    if (context.project_id) {
+      const project = context.project;
+      parts.push(`\u{1F4C2} Project: ${project?.name || "loaded"}`);
+      if (context.project_created) {
+        parts.push("   (auto-created, indexing in background)");
+      }
+      if (context.indexing_status === "started") {
+        parts.push("   \u23F3 Code indexing in progress...");
+      }
+    }
+    const decisions = context.recent_decisions;
+    if (decisions?.items && decisions.items.length > 0) {
+      parts.push("");
+      parts.push("\u{1F4CB} Recent Decisions:");
+      decisions.items.slice(0, 3).forEach((d) => {
+        const title = d.title || d.content?.slice(0, 50) || "Untitled";
+        parts.push(`   \u2022 ${title}`);
+      });
+    }
+    const memory = context.recent_memory;
+    if (memory?.items && memory.items.length > 0) {
+      parts.push("");
+      parts.push("\u{1F9E0} Recent Context:");
+      memory.items.slice(0, 3).forEach((m) => {
+        const title = m.title || "Note";
+        const type = m.event_type || "";
+        parts.push(`   \u2022 [${type}] ${title}`);
+      });
+    }
+    if (context.ide_roots && context.ide_roots.length > 0) {
+      const roots = context.ide_roots;
+      parts.push("");
+      parts.push(`\u{1F5A5}\uFE0F  IDE Roots: ${roots.map((r) => r.split("/").pop()).join(", ")}`);
+    }
+    parts.push("");
+    parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    parts.push("Use session_remember to save important context.");
+    parts.push("Use session_recall to retrieve past context.");
+    parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    return parts.join("\n");
+  }
+};
+
 // src/index.ts
 async function main() {
   const config = loadConfig();
   const client = new ContextStreamClient(config);
   const server = new McpServer({
     name: "contextstream-mcp",
-    version: "0.2.0"
+    version: "0.3.0"
   });
-  registerTools(server, client);
+  const sessionManager = new SessionManager(server, client);
+  registerTools(server, client, sessionManager);
   registerResources(server, client, config.apiUrl);
   registerPrompts(server);
   console.error(`ContextStream MCP server starting...`);
   console.error(`API URL: ${config.apiUrl}`);
   console.error(`Auth: ${config.apiKey ? "API Key" : config.jwt ? "JWT" : "None"}`);
+  console.error(`Auto-Context: ENABLED (context loads on first tool call)`);
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("ContextStream MCP server connected and ready");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",