@youdie006/prodex 0.39.3 → 0.39.4

package/dist/mcp-tools.js

@@ -199,3 +199,27 @@ function assertMcpFiles(files) {
         assertMcpTextField(file.path, `files[${index}].path`, MAX_MCP_SHORT_TEXT_BYTES);
     }
 }
+/**
+ * A running MCP server keeps the code it loaded at startup: Node reads a module
+ * once. So installing a newer prodex changes nothing for a server that is
+ * already up, and the fixes in it look like they did not work. Measured on one
+ * machine, three servers serving consults had been running since the middle of
+ * the previous month, two releases behind, with nothing saying so.
+ */
+export function staleServerWarning(input) {
+    const running = input.running?.trim();
+    const installed = input.installed?.trim();
+    if (!running || !installed || running === installed)
+        return undefined;
+    return (`server_outdated: this prodex MCP server is running ${running}, but ${installed} is installed on this machine. ` +
+        `A server keeps the code it loaded when it started, so anything fixed since ${running} is not in this one. ` +
+        `Restart it - restart the agent session that launched it - to pick up ${installed}.`);
+}
+/** Carries a server-version notice back on a tool result that has room for it. */
+export function withServerVersionNotice(result, warning) {
+    if (!warning || typeof result !== "object" || result === null)
+        return result;
+    const existing = result.warnings;
+    const warnings = Array.isArray(existing) ? existing : [];
+    return { ...result, warnings: [warning, ...warnings] };
+}

package/dist/mcp.js

@@ -1,10 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import process from "node:process";
 import { serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
 import { JSONRPCMessageSchema } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-import { createMcpToolHandlers, MAX_MCP_BRIDGE_TEXT_BYTES, MAX_MCP_SHORT_TEXT_BYTES } from "./mcp-tools.js";
+import { createMcpToolHandlers, MAX_MCP_BRIDGE_TEXT_BYTES, MAX_MCP_SHORT_TEXT_BYTES, staleServerWarning, withServerVersionNotice } from "./mcp-tools.js";
 import { ReceiptKindSchema } from "./schema.js";
 const McpBridgeTextSchema = z.string().max(MAX_MCP_BRIDGE_TEXT_BYTES);
 const McpShortTextSchema = z.string().max(MAX_MCP_SHORT_TEXT_BYTES);
@@ -25,6 +26,29 @@ function asText(value) {
     };
 }
 const mcpPackageJson = createRequire(import.meta.url)("../package.json");
+/**
+ * The version on disk right now, which is NOT what this process is running:
+ * `mcpPackageJson` was read once, when the server started. Comparing the two is
+ * how a server that has been up for weeks can say so. Read per browser call
+ * (those take seconds at least, so one small file read is nothing) and never
+ * allowed to break the call it decorates.
+ */
+function installedVersionOnDisk() {
+    try {
+        const path = createRequire(import.meta.url).resolve("../package.json");
+        return JSON.parse(readFileSync(path, "utf8")).version;
+    }
+    catch {
+        return undefined;
+    }
+}
+function serverVersionNotice() {
+    const installed = installedVersionOnDisk();
+    return staleServerWarning({
+        ...(mcpPackageJson.version !== undefined ? { running: mcpPackageJson.version } : {}),
+        ...(installed !== undefined ? { installed } : {})
+    });
+}
 export function createServer(cwd = process.cwd(), options = {}) {
     const server = new McpServer({ name: "prodex", version: mcpPackageJson.version ?? "0.0.0" });
     const handlers = createMcpToolHandlers({ cwd, source: options.source, claimedBy: options.claimedBy });
@@ -184,7 +208,7 @@ export function createServer(cwd = process.cwd(), options = {}) {
                         // Progress delivery must never break the consult.
                     });
                 };
-            return asText(await browserConsult(input, onProgress));
+            return asText(withServerVersionNotice(await browserConsult(input, onProgress), serverVersionNotice()));
         });
     }
     const browserRecover = options.browserRecover;
@@ -195,7 +219,7 @@ export function createServer(cwd = process.cwd(), options = {}) {
                 thread: McpShortTextSchema.min(1).describe("The ChatGPT conversation URL from the blocker (its `thread` field)."),
                 timeout_ms: z.number().int().positive().max(600_000).optional()
             }
-        }, async (input) => asText(await browserRecover(input)));
+        }, async (input) => asText(withServerVersionNotice(await browserRecover(input), serverVersionNotice())));
     }
     return server;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdie006/prodex",
-  "version": "0.39.3",
+  "version": "0.39.4",
   "description": "Local receipt bus for coordinating Codex execution with ChatGPT Pro/Projects consultation.",
   "author": "youdie006",
   "license": "MIT",