@contextstream/mcp-server 0.3.52 → 0.3.54

package/dist/index.js

@@ -4701,6 +4701,8 @@ 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";
+var UPGRADE_COMMAND = "npm update -g @contextstream/mcp-server";
+var NPM_LATEST_URL = "https://registry.npmjs.org/@contextstream/mcp-server/latest";
 function getVersion() {
   try {
     const require2 = createRequire(import.meta.url);
@@ -4724,6 +4726,7 @@ function compareVersions(v1, v2) {
   return 0;
 }
 var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var latestVersionPromise = null;
 function getCacheFilePath() {
   return join3(homedir(), ".contextstream", "version-cache.json");
 }
@@ -4752,33 +4755,40 @@ function writeCache(latestVersion) {
   } catch {
   }
 }
-async function checkForUpdates() {
-  const currentVersion = VERSION;
-  if (currentVersion === "unknown") return;
+async function fetchLatestVersion() {
   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", {
+    const response = await fetch(NPM_LATEST_URL, {
       signal: controller.signal,
       headers: { "Accept": "application/json" }
     });
     clearTimeout(timeout);
-    if (!response.ok) return;
+    if (!response.ok) return null;
     const data = await response.json();
-    const latestVersion = data.version;
-    if (typeof latestVersion !== "string") return;
-    writeCache(latestVersion);
-    if (compareVersions(currentVersion, latestVersion) < 0) {
-      showUpdateWarning(currentVersion, latestVersion);
-    }
+    return typeof data.version === "string" ? data.version : null;
   } catch {
+    return null;
+  }
+}
+async function resolveLatestVersion() {
+  const cached = readCache();
+  if (cached) return cached.latestVersion;
+  if (!latestVersionPromise) {
+    latestVersionPromise = fetchLatestVersion().finally(() => {
+      latestVersionPromise = null;
+    });
+  }
+  const latestVersion = await latestVersionPromise;
+  if (latestVersion) {
+    writeCache(latestVersion);
+  }
+  return latestVersion;
+}
+async function checkForUpdates() {
+  const notice = await getUpdateNotice();
+  if (notice?.behind) {
+    showUpdateWarning(notice.current, notice.latest);
   }
 }
 function showUpdateWarning(currentVersion, latestVersion) {
@@ -4786,12 +4796,30 @@ function showUpdateWarning(currentVersion, latestVersion) {
   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(`   Run: ${UPGRADE_COMMAND}`);
   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("");
 }
+async function getUpdateNotice() {
+  const currentVersion = VERSION;
+  if (currentVersion === "unknown") return null;
+  try {
+    const latestVersion = await resolveLatestVersion();
+    if (!latestVersion) return null;
+    if (compareVersions(currentVersion, latestVersion) < 0) {
+      return {
+        current: currentVersion,
+        latest: latestVersion,
+        behind: true,
+        upgrade_command: UPGRADE_COMMAND
+      };
+    }
+  } catch {
+  }
+  return null;
+}
 
 // src/client.ts
 var uuidSchema = external_exports.string().uuid();
@@ -5174,6 +5202,19 @@ var ContextStreamClient = class {
     };
     return request(this.config, "/graph/impact-analysis", { body: apiBody });
   }
+  graphIngest(body) {
+    const withDefaults = this.withDefaults(body);
+    const projectId = withDefaults.project_id;
+    if (!projectId) {
+      throw new Error("project_id is required to ingest the graph.");
+    }
+    uuidSchema.parse(projectId);
+    const apiBody = {};
+    if (body.wait !== void 0) {
+      apiBody.wait = body.wait;
+    }
+    return request(this.config, `/graph/ingest/${projectId}`, { body: apiBody });
+  }
   // AI
   buildAiContextRequest(input) {
     const payload = {
@@ -6598,6 +6639,11 @@ W:${wsHint}
 [/CTX]`;
       candidateContext = context;
     }
+    let versionNotice = null;
+    try {
+      versionNotice = await getUpdateNotice();
+    } catch {
+    }
     this.trackTokenSavings({
       tool: "context_smart",
       workspace_id: withDefaults.workspace_id,
@@ -6618,6 +6664,7 @@ W:${wsHint}
       token_estimate: Math.ceil(context.length / 4),
       format,
       sources_used: items.filter((i) => context.includes(i.value.slice(0, 20))).length,
+      ...versionNotice ? { version_notice: versionNotice } : {},
       ...errors.length > 0 && { errors }
       // Include errors for debugging
     };
@@ -7244,6 +7291,7 @@ var CONTEXTSTREAM_TOOL_NAMES = [
   "graph_impact",
   "graph_circular_dependencies",
   "graph_unused_code",
+  "graph_ingest",
   "graph_contradictions",
   // AI (PRO)
   "ai_context",
@@ -7474,7 +7522,7 @@ To expose all tools below, set \`CONTEXTSTREAM_TOOLSET=full\` in your MCP config
 \`memory_create_event\`, \`memory_bulk_ingest\`, \`memory_list_events\`, \`memory_create_node\`, \`memory_list_nodes\`, \`memory_search\`, \`memory_decisions\`, \`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_contradictions\`
+\`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\`
@@ -7670,6 +7718,7 @@ var TOOL_CATALOG = [
       { name: "path", hint: "trace" },
       { name: "decisions", hint: "choices" },
       { name: "dependencies", hint: "deps" },
+      { name: "ingest", hint: "build" },
       { name: "impact", hint: "changes" },
       { name: "contradictions", hint: "conflicts" }
     ]
@@ -7856,6 +7905,7 @@ var STANDARD_TOOLSET = /* @__PURE__ */ new Set([
   "graph_impact",
   "graph_circular_dependencies",
   "graph_unused_code",
+  "graph_ingest",
   // Search (3)
   "search_semantic",
   "search_hybrid",
@@ -8631,6 +8681,25 @@ Access: Free`,
       return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
     }
   );
+  registerTool(
+    "graph_ingest",
+    {
+      title: "Ingest code graph",
+      description: "Build and persist the dependency graph for a project",
+      inputSchema: external_exports.object({
+        project_id: external_exports.string().uuid().optional(),
+        wait: external_exports.boolean().optional().describe("If true, wait for ingestion to finish before returning.")
+      })
+    },
+    async (input) => {
+      const projectId = resolveProjectId(input.project_id);
+      if (!projectId) {
+        return errorResult("Error: project_id is required. Please call session_init first or provide project_id explicitly.");
+      }
+      const result = await client.graphIngest({ project_id: projectId, wait: input.wait });
+      return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+    }
+  );
   registerTool(
     "ai_context",
     {
@@ -10145,8 +10214,10 @@ This saves ~80% tokens compared to including full chat history.`,
       const footer = `
 ---
 \u{1F3AF} ${result.sources_used} sources | ~${result.token_estimate} tokens | format: ${result.format}`;
+      const versionNoticeLine = result.version_notice?.behind ? `
+[VERSION_NOTICE] current=${result.version_notice.current} latest=${result.version_notice.latest} upgrade="${result.version_notice.upgrade_command}"` : "";
       return {
-        content: [{ type: "text", text: result.context + footer }],
+        content: [{ type: "text", text: result.context + footer + versionNoticeLine }],
         structuredContent: toStructured(result)
       };
     }

package/package.json

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