conduit-mcp 2.2.0 → 2.2.1

package/dist/{chunk-NV56BC2A.js → chunk-26DDWVEB.js}

@@ -37,6 +37,31 @@ var log = {
   }
 };
 
+// src/utils/version.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var cached = null;
+function getServerVersion() {
+  if (cached) return cached;
+  const here = dirname(fileURLToPath(import.meta.url));
+  for (const rel of ["..", join("..", "..")]) {
+    try {
+      const pkg = JSON.parse(
+        readFileSync(join(here, rel, "package.json"), "utf-8")
+      );
+      if (pkg.name === "conduit-mcp" && typeof pkg.version === "string") {
+        const version = pkg.version;
+        cached = version;
+        return version;
+      }
+    } catch {
+    }
+  }
+  cached = "unknown";
+  return cached;
+}
+
 // src/bridge.ts
 var REQUEST_TIMEOUT_MS = 6e4;
 var HEARTBEAT_CHECK_INTERVAL_MS = 5e3;
@@ -280,9 +305,11 @@ var Bridge = class extends EventEmitter {
             clearTimeout(timer);
             this.pendingRequests.delete(id);
             log.warn(
-              `WebSocket send failed for studio "${this.activeStudioId}": ${err.message}`
+              `WebSocket send failed for studio "${targetStudioId}": ${err.message}`
             );
-            this.evictStaleStudio(this.activeStudioId);
+            if (targetStudioId) {
+              this.evictStaleStudio(targetStudioId);
+            }
             reject(
               new Error(
                 `Failed to send to Roblox Studio: ${err.message}. The plugin connection may have dropped \u2014 it should auto-reconnect shortly. Please retry.`
@@ -454,7 +481,8 @@ var Bridge = class extends EventEmitter {
             studioId: msg.studioId,
             placeId: msg.placeId,
             placeName: msg.placeName,
-            connectedAt: Date.now()
+            connectedAt: Date.now(),
+            pluginVersion: msg.version
           });
           return;
         }
@@ -529,6 +557,7 @@ var Bridge = class extends EventEmitter {
     log.info(
       `Studio registered: ${studioId}` + (info.placeName ? ` (${info.placeName})` : "")
     );
+    this.warnOnVersionMismatch(info);
     this.startHeartbeatMonitor();
     this.startPingInterval();
     if (ws.__earlyClose) {
@@ -583,6 +612,14 @@ var Bridge = class extends EventEmitter {
       }
     });
   }
+  warnOnVersionMismatch(info) {
+    const serverVersion = getServerVersion();
+    if (info.pluginVersion && serverVersion !== "unknown" && info.pluginVersion !== serverVersion) {
+      log.warn(
+        `Plugin version ${info.pluginVersion} does not match server ${serverVersion} \u2014 run "npx conduit-mcp --install" and restart Studio to update the plugin`
+      );
+    }
+  }
   failPendingForStudio(studioId, code, reason) {
     for (const [id, pending] of this.pendingRequests) {
       if (pending.studioId === studioId) {
@@ -737,6 +774,7 @@ var Bridge = class extends EventEmitter {
           status: "ok",
           connected: this.isConnected,
           port: this.actualPort,
+          serverVersion: getServerVersion(),
           studios: this.getStudios(),
           activeStudioId: this.activeStudioId
         })
@@ -745,7 +783,11 @@ var Bridge = class extends EventEmitter {
     }
     if (req.method === "GET" && pathname === "/poll") {
       const studioId = parsedUrl.searchParams.get("studioId") ?? this.activeStudioId ?? "_default";
-      this.handlePoll(studioId, res);
+      this.handlePoll(
+        studioId,
+        parsedUrl.searchParams.get("version") ?? void 0,
+        res
+      );
       return;
     }
     if (req.method === "POST" && pathname === "/result") {
@@ -760,17 +802,19 @@ var Bridge = class extends EventEmitter {
     res.writeHead(404);
     res.end("Not found");
   }
-  handlePoll(studioId, res) {
+  handlePoll(studioId, pluginVersion, res) {
     if (!this.studios.has(studioId) && studioId !== "_default") {
       if (!this.httpStudios.has(studioId)) {
         const info = {
           studioId,
-          connectedAt: Date.now()
+          connectedAt: Date.now(),
+          pluginVersion
         };
         this.httpStudios.set(studioId, info);
         this.lastHeartbeats.set(studioId, Date.now());
         this.emit("studio-connected", info);
         log.info(`HTTP-only studio registered: ${studioId}`);
+        this.warnOnVersionMismatch(info);
         this.startHeartbeatMonitor();
       }
       this.lastHeartbeats.set(studioId, Date.now());
@@ -1719,14 +1763,18 @@ ${outputText}
 // src/tools/playtest.ts
 import { z as z4 } from "zod";
 var playtestStartedAt = null;
+var errorWatchCursor = null;
+var errorWatchSeenAtCursor = /* @__PURE__ */ new Set();
+var errorWatchStudioId = null;
+var ERROR_WATCH_FETCH_LIMIT = 500;
 function register4(server, bridge) {
   server.registerTool(
     "playtest",
     {
       title: "Playtest Control & Virtual Input",
-      description: "Control Roblox Studio playtesting and simulate user input.\n\nIMPORTANT: Use mode='run' (default) for reliable MCP control during playtest. Run mode keeps the plugin connection stable. Play mode (F5) may briefly drop the connection during transition.\n\nActions:\n- `start`: Begin a playtest session. Default: Run mode (F8, server-side). Set mode='play' for Play mode (F5, client with player character \u2014 connection may briefly drop).\n- `stop`: End the current playtest.\n- `execute`: Run Lua code in the game context. Works in both edit mode and during playtest.\n- `get_output`: Get console/log output from Studio (works in edit mode and during playtest).\n- `inspect`: Evaluate a Luau expression and return the typed result. Can access Workspace, ServerStorage, Players, etc.\n- `navigate`: Walk a player character to a position using PathfindingService (requires active playtest with a player character).\n- `mouse_click`: Simulate a mouse click at screen coordinates (requires active playtest).\n- `mouse_move`: Move the virtual mouse to screen coordinates (requires active playtest).\n- `key_press`: Press and release a key (requires active playtest).\n- `key_down`: Hold a key down (requires active playtest).\n- `key_up`: Release a held key (requires active playtest).\n- `screenshot`: Capture the viewport. Useful for seeing the game state visually.",
+      description: "Control Roblox Studio playtesting and simulate user input.\n\nIMPORTANT: Use mode='run' (default) for reliable MCP control during playtest. Run mode keeps the plugin connection stable. Play mode (F5) may briefly drop the connection during transition.\n\nActions:\n- `start`: Begin a playtest session. Default: Run mode (F8, server-side). Set mode='play' for Play mode (F5, client with player character \u2014 connection may briefly drop).\n- `stop`: End the current playtest.\n- `execute`: Run Lua code in the game context. Works in both edit mode and during playtest.\n- `get_output`: Get console/log output from Studio (works in edit mode and during playtest).\n- `get_new_errors`: Return only errors/warnings that appeared since the previous get_new_errors call (first call: since playtest start, or recent history). Cheap to poll in edit\u2192test\u2192fix loops.\n- `inspect`: Evaluate a Luau expression and return the typed result. Can access Workspace, ServerStorage, Players, etc.\n- `navigate`: Walk a player character to a position using PathfindingService (requires active playtest with a player character).\n- `mouse_click`: Simulate a mouse click at screen coordinates (requires active playtest).\n- `mouse_move`: Move the virtual mouse to screen coordinates (requires active playtest).\n- `key_press`: Press and release a key (requires active playtest).\n- `key_down`: Hold a key down (requires active playtest).\n- `key_up`: Release a held key (requires active playtest).\n- `screenshot`: Capture the viewport. Useful for seeing the game state visually.",
       inputSchema: z4.object({
-        action: z4.enum(["start", "stop", "execute", "get_output", "inspect", "navigate", "mouse_click", "mouse_move", "key_press", "key_down", "key_up", "screenshot"]).describe("Playtest action"),
+        action: z4.enum(["start", "stop", "execute", "get_output", "get_new_errors", "inspect", "navigate", "mouse_click", "mouse_move", "key_press", "key_down", "key_up", "screenshot"]).describe("Playtest action"),
         mode: z4.enum(["play", "run"]).default("run").describe("Playtest mode: 'run' (F8, default, reliable MCP control) or 'play' (F5, full client with player \u2014 connection may briefly drop)"),
         code: z4.string().optional().describe("Lua code to execute (for 'execute' action)"),
         // get_output params
@@ -1778,6 +1826,62 @@ ${logText}
           content: [{ type: "text", text: applyTokenBudget(text2, void 0) }]
         };
       }
+      if (params.action === "get_new_errors") {
+        const activeStudio = bridge.getActiveStudioId();
+        if (activeStudio !== errorWatchStudioId) {
+          errorWatchStudioId = activeStudio;
+          errorWatchCursor = null;
+          errorWatchSeenAtCursor = /* @__PURE__ */ new Set();
+        }
+        const since = errorWatchCursor ?? playtestStartedAt ?? void 0;
+        const result2 = await bridge.send("get_log_output", {
+          messageTypes: ["MessageError", "MessageWarning"],
+          since,
+          limit: ERROR_WATCH_FETCH_LIMIT
+        });
+        const keyOf = (l) => `${l.messageType}|${l.message}`;
+        const fresh = result2.logs.filter(
+          (l) => errorWatchCursor === null || l.timestamp > errorWatchCursor || l.timestamp === errorWatchCursor && !errorWatchSeenAtCursor.has(keyOf(l))
+        );
+        if (fresh.length > 0) {
+          const maxTs = Math.max(...fresh.map((l) => l.timestamp));
+          if (maxTs !== errorWatchCursor) {
+            errorWatchSeenAtCursor = /* @__PURE__ */ new Set();
+          }
+          errorWatchCursor = maxTs;
+          for (const l of fresh) {
+            if (l.timestamp === maxTs) {
+              errorWatchSeenAtCursor.add(keyOf(l));
+            }
+          }
+        }
+        if (fresh.length === 0) {
+          return {
+            content: [{ type: "text", text: "No new errors or warnings." }]
+          };
+        }
+        const displayLimit = params.limit ?? 50;
+        const shown = fresh.slice(0, displayLimit);
+        const notes = [];
+        if (fresh.length > shown.length) {
+          notes.push(
+            `_\u2026${fresh.length - shown.length} newer entries omitted (oldest shown first \u2014 the first occurrence is usually the root cause)._`
+          );
+        }
+        if (result2.total > result2.logs.length) {
+          notes.push(
+            `_Log buffer overflowed: ${result2.total - result2.logs.length} entries were dropped before this check._`
+          );
+        }
+        const text2 = `**New Errors/Warnings** (${fresh.length})
+
+\`\`\`
+` + shown.map((l) => `[${l.messageType}] ${l.message}`).join("\n") + "\n```" + (notes.length > 0 ? `
+${notes.join("\n")}` : "");
+        return {
+          content: [{ type: "text", text: applyTokenBudget(text2, void 0) }]
+        };
+      }
       if (params.action === "inspect") {
         if (!params.expression) {
           return {
@@ -2485,12 +2589,14 @@ function register8(server, bridge) {
           ]
         };
       }
+      const serverVersion = getServerVersion();
       const lines = studios.map((s) => {
         const active = s.studioId === activeId ? " **\u2190 active**" : "";
         const place = s.placeName ? ` \u2014 ${s.placeName}` : "";
         const placeId = s.placeId ? ` (Place ID: ${s.placeId})` : "";
         const duration = Math.floor((Date.now() - s.connectedAt) / 1e3);
-        return `- \`${s.studioId}\`${place}${placeId} \u2014 connected ${duration}s ago${active}`;
+        const version = s.pluginVersion && serverVersion !== "unknown" && s.pluginVersion !== serverVersion ? ` \u26A0 plugin v${s.pluginVersion} \u2260 server v${serverVersion} \u2014 user should run \`npx conduit-mcp --install\` and restart Studio` : "";
+        return `- \`${s.studioId}\`${place}${placeId} \u2014 connected ${duration}s ago${active}${version}`;
       });
       const text = `**Connected Studios (${studios.length}):**
 ${lines.join("\n")}`;
@@ -2536,16 +2642,16 @@ import { z as z9 } from "zod";
 
 // src/utils/builds.ts
 import { homedir } from "os";
-import { join } from "path";
+import { join as join2 } from "path";
 import {
   existsSync,
   mkdirSync,
-  readFileSync,
+  readFileSync as readFileSync2,
   writeFileSync,
   readdirSync,
   statSync
 } from "fs";
-var BUILDS_DIR = join(homedir(), ".conduit", "builds");
+var BUILDS_DIR = join2(homedir(), ".conduit", "builds");
 function ensureDir() {
   if (!existsSync(BUILDS_DIR)) {
     mkdirSync(BUILDS_DIR, { recursive: true });
@@ -2566,7 +2672,7 @@ function saveBuild(name, root, description) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     root
   };
-  const filePath = join(BUILDS_DIR, `${name}.json`);
+  const filePath = join2(BUILDS_DIR, `${name}.json`);
   writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
   return {
     name,
@@ -2578,19 +2684,19 @@ function saveBuild(name, root, description) {
 }
 function loadBuild(name) {
   validateBuildName(name);
-  const filePath = join(BUILDS_DIR, `${name}.json`);
+  const filePath = join2(BUILDS_DIR, `${name}.json`);
   if (!existsSync(filePath)) {
     throw new Error(`Build "${name}" not found. Use builds --action list to see available builds.`);
   }
-  return JSON.parse(readFileSync(filePath, "utf-8"));
+  return JSON.parse(readFileSync2(filePath, "utf-8"));
 }
 function listBuilds() {
   ensureDir();
   const files = readdirSync(BUILDS_DIR).filter((f) => f.endsWith(".json"));
   return files.map((f) => {
-    const filePath = join(BUILDS_DIR, f);
+    const filePath = join2(BUILDS_DIR, f);
     try {
-      const data = JSON.parse(readFileSync(filePath, "utf-8"));
+      const data = JSON.parse(readFileSync2(filePath, "utf-8"));
       const rootObj = data.root;
       return {
         name: data.name,
@@ -2742,7 +2848,7 @@ async function startServer(port = 3200, options = {}) {
   const server = new McpServer(
     {
       name: "conduit-mcp",
-      version: "2.0.0"
+      version: getServerVersion()
     },
     {
       instructions: [
@@ -2793,6 +2899,7 @@ async function startServer(port = 3200, options = {}) {
     if (shuttingDown) return;
     shuttingDown = true;
     log.info("Shutting down...");
+    setTimeout(() => process.exit(1), 5e3).unref();
     await bridge.stop();
     await server.close();
     process.exit(0);
@@ -2815,4 +2922,4 @@ async function startServer(port = 3200, options = {}) {
 export {
   startServer
 };
-//# sourceMappingURL=chunk-NV56BC2A.js.map
+//# sourceMappingURL=chunk-26DDWVEB.js.map