@contextstream/mcp-server 0.3.46 → 0.3.48

package/README.md

@@ -69,6 +69,16 @@ npm install -g @contextstream/mcp-server
 contextstream-mcp
 ```
 
+### Keeping updated
+
+To get the latest features and bug fixes, update periodically:
+
+```bash
+npm update -g @contextstream/mcp-server
+```
+
+The MCP server will warn you when a newer version is available. After updating, restart your AI tool to use the new version.
+
 ## Configure your MCP client
 
 ### Manual setup

package/dist/index.js

@@ -4698,6 +4698,9 @@ var globalCache = new MemoryCache();
 
 // src/version.ts
 import { createRequire } from "module";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { homedir } from "os";
+import { join as join3 } from "path";
 function getVersion() {
   try {
     const require2 = createRequire(import.meta.url);
@@ -4709,6 +4712,86 @@ function getVersion() {
   return "unknown";
 }
 var VERSION = getVersion();
+function compareVersions(v1, v2) {
+  const parts1 = v1.split(".").map(Number);
+  const parts2 = v2.split(".").map(Number);
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const p1 = parts1[i] ?? 0;
+    const p2 = parts2[i] ?? 0;
+    if (p1 < p2) return -1;
+    if (p1 > p2) return 1;
+  }
+  return 0;
+}
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+function getCacheFilePath() {
+  return join3(homedir(), ".contextstream", "version-cache.json");
+}
+function readCache() {
+  try {
+    const cacheFile = getCacheFilePath();
+    if (!existsSync2(cacheFile)) return null;
+    const data = JSON.parse(readFileSync2(cacheFile, "utf-8"));
+    if (Date.now() - data.checkedAt > CACHE_TTL_MS) return null;
+    return data;
+  } catch {
+    return null;
+  }
+}
+function writeCache(latestVersion) {
+  try {
+    const configDir = join3(homedir(), ".contextstream");
+    if (!existsSync2(configDir)) {
+      mkdirSync2(configDir, { recursive: true });
+    }
+    const cacheFile = getCacheFilePath();
+    writeFileSync2(cacheFile, JSON.stringify({
+      latestVersion,
+      checkedAt: Date.now()
+    }));
+  } catch {
+  }
+}
+async function checkForUpdates() {
+  const currentVersion = VERSION;
+  if (currentVersion === "unknown") return;
+  try {
+    const cached = readCache();
+    if (cached) {
+      if (compareVersions(currentVersion, cached.latestVersion) < 0) {
+        showUpdateWarning(currentVersion, cached.latestVersion);
+      }
+      return;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    const response = await fetch("https://registry.npmjs.org/@contextstream/mcp-server/latest", {
+      signal: controller.signal,
+      headers: { "Accept": "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return;
+    const data = await response.json();
+    const latestVersion = data.version;
+    if (typeof latestVersion !== "string") return;
+    writeCache(latestVersion);
+    if (compareVersions(currentVersion, latestVersion) < 0) {
+      showUpdateWarning(currentVersion, latestVersion);
+    }
+  } catch {
+  }
+}
+function showUpdateWarning(currentVersion, latestVersion) {
+  console.error("");
+  console.error("\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.error(`\u26A0\uFE0F  Update available: v${currentVersion} \u2192 v${latestVersion}`);
+  console.error("");
+  console.error("   Run: npm update -g @contextstream/mcp-server");
+  console.error("");
+  console.error("   Then restart your AI tool to use the new version.");
+  console.error("\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.error("");
+}
 
 // src/client.ts
 var uuidSchema = external_exports.string().uuid();
@@ -4775,10 +4858,12 @@ var ContextStreamClient = class {
   }
   withDefaults(input) {
     const { defaultWorkspaceId, defaultProjectId } = this.config;
+    const workspaceId = input.workspace_id || defaultWorkspaceId;
+    const useDefaultProject = !input.project_id && (!input.workspace_id || input.workspace_id === defaultWorkspaceId);
     return {
       ...input,
-      workspace_id: input.workspace_id || defaultWorkspaceId,
-      project_id: input.project_id || defaultProjectId
+      workspace_id: workspaceId,
+      project_id: input.project_id || (useDefaultProject ? defaultProjectId : void 0)
     };
   }
   coerceUuid(value) {
@@ -5626,6 +5711,29 @@ var ContextStreamClient = class {
         });
         if (batchedContext.workspace) {
           context.workspace = batchedContext.workspace;
+          if (batchedContext.workspace.id && batchedContext.workspace.id !== workspaceId) {
+            console.error(`[ContextStream] Workspace mismatch: config=${workspaceId}, API returned=${batchedContext.workspace.id}. Using API workspace.`);
+            const oldWorkspaceId = workspaceId;
+            workspaceId = batchedContext.workspace.id;
+            workspaceName = batchedContext.workspace.name;
+            context.workspace_id = workspaceId;
+            context.workspace_name = workspaceName;
+            context.workspace_source = "api_fallback";
+            context.workspace_mismatch_warning = `Config had workspace ${oldWorkspaceId} but you don't have access. Using ${workspaceId} instead.`;
+            projectId = batchedContext.project?.id;
+            context.project_id = projectId;
+            this.config.defaultProjectId = projectId;
+            if (rootPath) {
+              writeLocalConfig(rootPath, {
+                workspace_id: workspaceId,
+                workspace_name: workspaceName,
+                project_id: projectId,
+                // Use API-returned project or undefined
+                associated_at: (/* @__PURE__ */ new Date()).toISOString()
+              });
+              console.error(`[ContextStream] Updated local config with accessible workspace: ${workspaceId}`);
+            }
+          }
         }
         if (batchedContext.project) {
           context.project = batchedContext.project;
@@ -7569,7 +7677,17 @@ function getCoreToolsHint() {
 // src/tools.ts
 var LESSON_DEDUP_WINDOW_MS = 2 * 60 * 1e3;
 var recentLessonCaptures = /* @__PURE__ */ new Map();
-var CORE_TOOLSET = /* @__PURE__ */ new Set([
+var LIGHT_TOOLSET = /* @__PURE__ */ new Set([
+  "session_init",
+  "context_smart",
+  "session_capture",
+  "session_recall",
+  "session_remember",
+  "auth_me",
+  "mcp_server_version"
+]);
+var STANDARD_TOOLSET = /* @__PURE__ */ new Set([
+  // Core session tools
   "session_init",
   "session_tools",
   "context_smart",
@@ -7583,18 +7701,33 @@ var CORE_TOOLSET = /* @__PURE__ */ new Set([
   "session_smart_search",
   "session_compress",
   "session_delta",
+  // Setup and configuration
   "generate_editor_rules",
   "workspace_associate",
   "workspace_bootstrap",
   "projects_create",
   "projects_list",
+  // Project indexing - essential for code context
+  "projects_ingest_local",
+  "projects_index",
+  "projects_index_status",
+  "projects_files",
+  // Utility
   "auth_me",
   "mcp_server_version"
 ]);
 var TOOLSET_ALIASES = {
-  core: CORE_TOOLSET,
-  minimal: CORE_TOOLSET,
-  essential: CORE_TOOLSET
+  // Light mode - minimal, fastest
+  light: LIGHT_TOOLSET,
+  minimal: LIGHT_TOOLSET,
+  // Standard mode - balanced (default)
+  standard: STANDARD_TOOLSET,
+  core: STANDARD_TOOLSET,
+  essential: STANDARD_TOOLSET,
+  // Complete mode - all tools
+  complete: null,
+  full: null,
+  all: null
 };
 function parseToolList(raw) {
   return new Set(
@@ -7602,30 +7735,29 @@ function parseToolList(raw) {
   );
 }
 function resolveToolFilter() {
-  const defaultToolset = CORE_TOOLSET;
   const allowlistRaw = process.env.CONTEXTSTREAM_TOOL_ALLOWLIST;
   if (allowlistRaw) {
     const allowlist = parseToolList(allowlistRaw);
     if (allowlist.size === 0) {
-      console.error("[ContextStream] CONTEXTSTREAM_TOOL_ALLOWLIST is empty; using core tool list.");
-      return { allowlist: defaultToolset, source: "core" };
+      console.error("[ContextStream] CONTEXTSTREAM_TOOL_ALLOWLIST is empty; using standard toolset.");
+      return { allowlist: STANDARD_TOOLSET, source: "standard" };
     }
     return { allowlist, source: "allowlist" };
   }
   const toolsetRaw = process.env.CONTEXTSTREAM_TOOLSET;
   if (!toolsetRaw) {
-    return { allowlist: defaultToolset, source: "core" };
+    return { allowlist: STANDARD_TOOLSET, source: "standard" };
   }
   const key = toolsetRaw.trim().toLowerCase();
-  if (!key || key === "full" || key === "all") {
-    return { allowlist: null, source: "full" };
-  }
-  const resolved = TOOLSET_ALIASES[key];
-  if (resolved) {
+  if (key in TOOLSET_ALIASES) {
+    const resolved = TOOLSET_ALIASES[key];
+    if (resolved === null) {
+      return { allowlist: null, source: "complete" };
+    }
     return { allowlist: resolved, source: key };
   }
-  console.error(`[ContextStream] Unknown CONTEXTSTREAM_TOOLSET "${toolsetRaw}". Using core tool list.`);
-  return { allowlist: defaultToolset, source: "core" };
+  console.error(`[ContextStream] Unknown CONTEXTSTREAM_TOOLSET "${toolsetRaw}". Using standard toolset.`);
+  return { allowlist: STANDARD_TOOLSET, source: "standard" };
 }
 function formatContent(data) {
   return JSON.stringify(data, null, 2);
@@ -7670,9 +7802,11 @@ function registerTools(server, client, sessionManager) {
   const toolFilter = resolveToolFilter();
   const toolAllowlist = toolFilter.allowlist;
   if (toolAllowlist) {
-    const source = toolFilter.source ?? "custom";
-    const hint = source === "core" ? " Set CONTEXTSTREAM_TOOLSET=full to expose all tools." : "";
-    console.error(`[ContextStream] Toolset limited (${source}): ${toolAllowlist.size} tools.${hint}`);
+    const source = toolFilter.source;
+    const hint = source === "light" ? " Set CONTEXTSTREAM_TOOLSET=standard or complete for more tools." : source === "standard" ? " Set CONTEXTSTREAM_TOOLSET=complete for all tools." : "";
+    console.error(`[ContextStream] Toolset: ${source} (${toolAllowlist.size} tools).${hint}`);
+  } else {
+    console.error(`[ContextStream] Toolset: complete (all tools).`);
   }
   const defaultProTools = /* @__PURE__ */ new Set([
     // AI endpoints (typically paid/credit-metered)
@@ -8008,7 +8142,7 @@ Access: Free`,
         }
       }
       const response = {
-        ...result,
+        ...result && typeof result === "object" ? result : {},
         folder_path: input.folder_path,
         config_written: input.folder_path ? true : void 0,
         editor_rules_generated: rulesGenerated.length > 0 ? rulesGenerated : void 0
@@ -10745,26 +10879,26 @@ var SessionManager = class {
 };
 
 // src/index.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join7 } from "path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join8 } from "path";
 
 // src/setup.ts
 import * as fs5 from "node:fs/promises";
 import * as path6 from "node:path";
-import { homedir as homedir2 } from "node:os";
+import { homedir as homedir3 } from "node:os";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
 
 // src/credentials.ts
 import * as fs4 from "node:fs/promises";
 import * as path5 from "node:path";
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 function normalizeApiUrl(input) {
   return String(input ?? "").trim().replace(/\/+$/, "");
 }
 function credentialsFilePath() {
-  return path5.join(homedir(), ".contextstream", "credentials.json");
+  return path5.join(homedir2(), ".contextstream", "credentials.json");
 }
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -10862,21 +10996,42 @@ async function fileExists(filePath) {
     return false;
   }
 }
-async function upsertTextFile(filePath, content, marker) {
+var CONTEXTSTREAM_START_MARKER = "<!-- BEGIN ContextStream -->";
+var CONTEXTSTREAM_END_MARKER = "<!-- END ContextStream -->";
+function wrapWithMarkers(content) {
+  return `${CONTEXTSTREAM_START_MARKER}
+${content.trim()}
+${CONTEXTSTREAM_END_MARKER}`;
+}
+async function upsertTextFile(filePath, content, _marker) {
   await fs5.mkdir(path6.dirname(filePath), { recursive: true });
   const exists = await fileExists(filePath);
+  const wrappedContent = wrapWithMarkers(content);
   if (!exists) {
-    await fs5.writeFile(filePath, content, "utf8");
+    await fs5.writeFile(filePath, wrappedContent + "\n", "utf8");
     return "created";
   }
   const existing = await fs5.readFile(filePath, "utf8").catch(() => "");
-  if (existing.includes(marker)) return "skipped";
-  const joined = existing.trimEnd() + "\n\n" + content.trim() + "\n";
+  const startIdx = existing.indexOf(CONTEXTSTREAM_START_MARKER);
+  const endIdx = existing.indexOf(CONTEXTSTREAM_END_MARKER);
+  if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+    const before = existing.substring(0, startIdx);
+    const after = existing.substring(endIdx + CONTEXTSTREAM_END_MARKER.length);
+    const updated = before.trimEnd() + "\n\n" + wrappedContent + "\n" + after.trimStart();
+    await fs5.writeFile(filePath, updated.trim() + "\n", "utf8");
+    return "updated";
+  }
+  if (existing.includes("ContextStream")) {
+    const joined2 = existing.trimEnd() + "\n\n" + wrappedContent + "\n";
+    await fs5.writeFile(filePath, joined2, "utf8");
+    return "updated";
+  }
+  const joined = existing.trimEnd() + "\n\n" + wrappedContent + "\n";
   await fs5.writeFile(filePath, joined, "utf8");
   return "appended";
 }
 function globalRulesPathForEditor(editor) {
-  const home = homedir2();
+  const home = homedir3();
   switch (editor) {
     case "codex":
       return path6.join(home, ".codex", "AGENTS.md");
@@ -10984,7 +11139,7 @@ async function upsertJsonVsCodeMcpConfig(filePath, server) {
   return before === after ? "skipped" : "updated";
 }
 function claudeDesktopConfigPath() {
-  const home = homedir2();
+  const home = homedir3();
   if (process.platform === "darwin") {
     return path6.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
   }
@@ -11282,16 +11437,16 @@ Created API key: ${maskApiKey(apiKey)}
     const modeChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
     const mode = modeChoice === "2" ? "full" : "minimal";
     console.log("\nMCP toolset (which tools to expose to the AI):");
-    console.log("  1) Core (recommended) \u2014 essential session/context tools (~17 tools, lower token overhead)");
-    console.log("     Best for: most users, Claude Code, Claude Desktop (avoids large-context warnings)");
-    console.log("  2) Full \u2014 all tools including workspaces, projects, search, memory, graph, AI, integrations (~86 tools)");
-    console.log("     Best for: power users needing direct access to all workspace/project/graph/AI tools");
-    console.log("     Note: Claude Code/Desktop may warn about large tool lists when using full toolset.");
+    console.log("  1) Light \u2014 minimal essential tools for fastest responses (~7 tools)");
+    console.log("     Best for: simple tasks, resource-constrained environments");
+    console.log("  2) Standard (recommended) \u2014 balanced set of session and context tools (~20 tools)");
+    console.log("     Best for: most users, balances speed with capabilities");
+    console.log("  3) Complete \u2014 all tools including memory, knowledge graph, AI, integrations (~86 tools)");
+    console.log("     Best for: power users needing full workspace/project/graph capabilities");
     console.log("");
-    console.log("  Tip: You can switch toolsets later by editing the MCP config and setting CONTEXTSTREAM_TOOLSET=full");
-    console.log("       See https://contextstream.io/docs/mcp/tools for the full tool catalog.");
-    const toolsetChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
-    const toolset = toolsetChoice === "2" ? "full" : "core";
+    console.log("  Tip: Change later by setting CONTEXTSTREAM_TOOLSET=light|standard|complete");
+    const toolsetChoice = normalizeInput(await rl.question("Choose [1/2/3] (default 2): ")) || "2";
+    const toolset = toolsetChoice === "1" ? "light" : toolsetChoice === "3" ? "complete" : "standard";
     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]}`));
@@ -11322,9 +11477,9 @@ Created API key: ${maskApiKey(apiKey)}
     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 === "full" ? buildContextStreamMcpServer({ apiUrl, apiKey, toolset: "full" }) : buildContextStreamMcpServer({ apiUrl, apiKey });
+    const mcpServer = toolset === "complete" ? buildContextStreamMcpServer({ apiUrl, apiKey, toolset: "complete" }) : buildContextStreamMcpServer({ apiUrl, apiKey });
     const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
-    const vsCodeServer = toolset === "full" ? buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset: "full" }) : buildContextStreamVsCodeServer({ apiUrl, apiKey });
+    const vsCodeServer = toolset === "complete" ? buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset: "complete" }) : buildContextStreamVsCodeServer({ apiUrl, apiKey });
     const needsGlobalMcpConfig = mcpScope === "global" || mcpScope === "both" || mcpScope === "project" && hasCodex;
     if (needsGlobalMcpConfig) {
       console.log("\nInstalling global MCP config...");
@@ -11332,20 +11487,20 @@ Created API key: ${maskApiKey(apiKey)}
         if (mcpScope === "project" && editor !== "codex") continue;
         try {
           if (editor === "codex") {
-            const filePath = path6.join(homedir2(), ".codex", "config.toml");
+            const filePath = path6.join(homedir3(), ".codex", "config.toml");
             if (dryRun) {
               writeActions.push({ kind: "mcp-config", target: filePath, status: "dry-run" });
               console.log(`- ${EDITOR_LABELS[editor]}: would update ${filePath}`);
               continue;
             }
-            const codexParams = toolset === "full" ? { apiUrl, apiKey, toolset: "full" } : { apiUrl, apiKey };
+            const codexParams = toolset === "complete" ? { apiUrl, apiKey, toolset: "complete" } : { apiUrl, apiKey };
             const status = await upsertCodexTomlConfig(filePath, codexParams);
             writeActions.push({ kind: "mcp-config", target: filePath, status });
             console.log(`- ${EDITOR_LABELS[editor]}: ${status} ${filePath}`);
             continue;
           }
           if (editor === "windsurf") {
-            const filePath = path6.join(homedir2(), ".codeium", "windsurf", "mcp_config.json");
+            const filePath = path6.join(homedir3(), ".codeium", "windsurf", "mcp_config.json");
             if (dryRun) {
               writeActions.push({ kind: "mcp-config", target: filePath, status: "dry-run" });
               console.log(`- ${EDITOR_LABELS[editor]}: would update ${filePath}`);
@@ -11377,7 +11532,7 @@ Created API key: ${maskApiKey(apiKey)}
             continue;
           }
           if (editor === "cursor") {
-            const filePath = path6.join(homedir2(), ".cursor", "mcp.json");
+            const filePath = path6.join(homedir3(), ".cursor", "mcp.json");
             if (dryRun) {
               writeActions.push({ kind: "mcp-config", target: filePath, status: "dry-run" });
               console.log(`- ${EDITOR_LABELS[editor]}: would update ${filePath}`);
@@ -11575,14 +11730,15 @@ 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.`);
-      console.log(`Toolset: ${toolset} (${toolset === "full" ? "~86 tools" : "~17 core tools"})`);
+      const toolsetDesc = toolset === "light" ? "~7 tools" : toolset === "complete" ? "~86 tools" : "~20 tools";
+      console.log(`Toolset: ${toolset} (${toolsetDesc})`);
     }
     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("- If any tools require UI-based MCP setup (e.g. Cline/Kilo/Roo global), follow https://contextstream.io/docs/mcp.");
-    if (toolset === "full") {
-      console.log("- Note: Claude Code/Desktop may warn about large tool contexts. This is expected with the full toolset.");
+    if (toolset === "complete") {
+      console.log("- Note: Claude Code/Desktop may warn about large tool contexts. This is expected with the complete toolset.");
     }
   } finally {
     rl.close();
@@ -11591,14 +11747,14 @@ Applying to ${projects.length} project(s)...`);
 
 // src/index.ts
 function showFirstRunMessage() {
-  const configDir = join7(homedir3(), ".contextstream");
-  const starShownFile = join7(configDir, ".star-shown");
-  if (existsSync3(starShownFile)) {
+  const configDir = join8(homedir4(), ".contextstream");
+  const starShownFile = join8(configDir, ".star-shown");
+  if (existsSync4(starShownFile)) {
     return;
   }
-  if (!existsSync3(configDir)) {
+  if (!existsSync4(configDir)) {
     try {
-      mkdirSync3(configDir, { recursive: true });
+      mkdirSync4(configDir, { recursive: true });
     } catch {
       return;
     }
@@ -11611,7 +11767,7 @@ function showFirstRunMessage() {
   console.error("\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.error("");
   try {
-    writeFileSync3(starShownFile, (/* @__PURE__ */ new Date()).toISOString());
+    writeFileSync4(starShownFile, (/* @__PURE__ */ new Date()).toISOString());
   } catch {
   }
 }
@@ -11632,7 +11788,7 @@ Environment variables:
   CONTEXTSTREAM_JWT       JWT for authentication (alternative to API key)
   CONTEXTSTREAM_WORKSPACE_ID  Optional default workspace ID
   CONTEXTSTREAM_PROJECT_ID    Optional default project ID
-  CONTEXTSTREAM_TOOLSET       Optional tool bundle (core|full). Defaults to core to reduce tool context size.
+  CONTEXTSTREAM_TOOLSET       Tool mode: light|standard|complete (default: standard)
   CONTEXTSTREAM_TOOL_ALLOWLIST Optional comma-separated tool names to expose (overrides toolset)
   CONTEXTSTREAM_PRO_TOOLS     Optional comma-separated PRO tool names (default: AI tools)
   CONTEXTSTREAM_UPGRADE_URL   Optional upgrade URL shown for PRO tools on Free plan
@@ -11681,6 +11837,8 @@ async function main() {
   await server.connect(transport);
   console.error("ContextStream MCP server connected and ready");
   showFirstRunMessage();
+  checkForUpdates().catch(() => {
+  });
 }
 main().catch((err) => {
   console.error("ContextStream MCP server failed to start:", err?.message || err);

package/dist/test-server.js

@@ -4093,6 +4093,7 @@ function getVersion() {
   return "unknown";
 }
 var VERSION = getVersion();
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 
 // src/test-server.ts
 var PORT = parseInt(process.env.MCP_TEST_PORT || "3099", 10);

package/package.json

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