conduit-mcp 2.0.4 → 2.1.1

package/dist/{chunk-T5QDC4DR.js → chunk-3FU4T3TX.js}

@@ -698,6 +698,10 @@ function truncateToTokenBudget(text, budget) {
 
 // src/utils/formatting.ts
 function formatTree(data, depth = 0, indent = "") {
+  if (data.className === "_collapsed") {
+    return `${indent}  *${data.name}*
+`;
+  }
   let line = `${indent}- **${data.name}** \`${data.className}\``;
   if (data.properties && Object.keys(data.properties).length > 0) {
     const props = Object.entries(data.properties).map(([k, v]) => `${k}=${formatValue(v)}`).join(", ");
@@ -844,10 +848,13 @@ function register(server, bridge) {
     "get_info",
     {
       title: "Get Instance Info",
-      description: "Get detailed information about a single instance: class, parent, children count, properties, attributes, tags, and optionally a typed property list \u2014 all in one call.",
+      description: "Get detailed information about a single instance: class, parent, children count, properties, attributes, tags, and optionally a typed property list \u2014 all in one call.\n\nUse this to inspect runtime UI layout (Size, Position, Transparency, Visible, Text, etc.), part properties, lighting, sounds, and more. Reads ~60 common properties automatically. Use `propertyNames` to request only specific properties for a leaner response.\n\nFor UI debugging: check BackgroundTransparency, Visible, Size, Position, AnchorPoint, ZIndex, LayoutOrder on GuiObjects.",
       inputSchema: z.object({
         path: z.string().describe("Path to the instance, e.g. 'game.Workspace.Part'"),
-        includeProperties: z.boolean().default(true).describe("Include property values"),
+        includeProperties: z.boolean().default(true).describe("Include property values (reads ~60 common properties)"),
+        propertyNames: z.array(z.string()).optional().describe(
+          "Request only these specific properties by name, e.g. ['Size', 'Position', 'Transparency']. When set, only these properties are returned (much leaner than the full property dump)."
+        ),
         includeAttributes: z.boolean().default(true).describe("Include custom attributes"),
         includeTags: z.boolean().default(true).describe("Include CollectionService tags"),
         includePropertyList: z.boolean().default(false).describe("Include a typed list of all discoverable properties with types and values"),
@@ -865,6 +872,7 @@ function register(server, bridge) {
       const result = await bridge.send("get_info", {
         path: params.path,
         includeProperties: params.includeProperties,
+        propertyNames: params.propertyNames,
         includeAttributes: params.includeAttributes,
         includeTags: params.includeTags,
         includePropertyList: params.includePropertyList,
@@ -1187,13 +1195,26 @@ function registerReadScript(server, bridge) {
     "read_script",
     {
       title: "Read Script Source",
-      description: "Read the Lua source code of a script instance. Optionally restrict to a line range.",
+      description: "Read the Lua source code of a script instance. Optionally restrict to a line range. Use outline=true to get just function signatures and top-level declarations with line numbers \u2014 much cheaper than reading the full source for large scripts.\n\nSupports batch mode: pass `paths` (array) instead of `path` to read multiple scripts in a single call. Each entry can independently use outline or lineRange.",
       inputSchema: z3.object({
-        path: z3.string().describe("Path to the script instance"),
+        path: z3.string().optional().describe("Path to a single script instance"),
+        paths: z3.array(
+          z3.object({
+            path: z3.string().describe("Script path"),
+            outline: z3.boolean().default(false).describe("Return outline instead of source"),
+            lineRange: z3.object({
+              start: z3.number().int().min(1).describe("Start line (1-based)"),
+              end: z3.number().int().min(1).describe("End line (1-based, inclusive)")
+            }).optional().describe("Optional line range")
+          })
+        ).optional().describe("Batch mode: read multiple scripts in one call. Each entry can independently use outline or lineRange."),
+        outline: z3.boolean().default(false).describe(
+          "If true, return only a structural outline (function signatures, top-level locals, types, return) with line numbers instead of full source. Ideal for navigating large scripts."
+        ),
         lineRange: z3.object({
           start: z3.number().int().min(1).describe("Start line (1-based)"),
           end: z3.number().int().min(1).describe("End line (1-based, inclusive)")
-        }).optional().describe("Optional line range to read"),
+        }).optional().describe("Optional line range to read (ignored when outline=true)"),
         maxTokens: z3.number().optional().describe("Maximum token budget for the response")
       }),
       annotations: {
@@ -1204,6 +1225,69 @@ function registerReadScript(server, bridge) {
       }
     },
     async (params) => {
+      if (params.paths && params.paths.length > 0) {
+        const result2 = await bridge.send("batch_read_scripts", {
+          scripts: params.paths
+        });
+        const sections = [];
+        for (const r of result2.results) {
+          if (r.outline) {
+            const lines = [`### Outline: \`${r.path}\` (${r.totalLines} lines)`, ""];
+            for (const entry of r.outline) {
+              const pad = " ".repeat(entry.indent);
+              lines.push(`${entry.line}: ${pad}${entry.text}`);
+            }
+            if (r.outline.length === 0) {
+              lines.push("*No functions, type definitions, or top-level declarations found.*");
+            }
+            sections.push(lines.join("\n"));
+          } else {
+            sections.push(formatScript(r.source ?? "", r.path));
+          }
+        }
+        if (result2.errors && result2.errors.length > 0) {
+          const errLines = ["**Errors:**"];
+          for (const e of result2.errors) {
+            errLines.push(`- \`${e.path}\`: ${e.error}`);
+          }
+          sections.push(errLines.join("\n"));
+        }
+        const text2 = sections.join("\n\n---\n\n");
+        return {
+          content: [
+            { type: "text", text: applyTokenBudget(text2, params.maxTokens) }
+          ]
+        };
+      }
+      if (!params.paths && !params.path) {
+        return {
+          content: [{ type: "text", text: "Provide either `path` (single script) or `paths` (batch read)." }],
+          isError: true
+        };
+      }
+      const path = params.path;
+      if (params.outline) {
+        const result2 = await bridge.send("outline_script", {
+          path
+        });
+        const lines = [
+          `### Outline: \`${result2.path}\` (${result2.totalLines} lines)`,
+          ""
+        ];
+        for (const entry of result2.outline) {
+          const pad = " ".repeat(entry.indent);
+          lines.push(`${entry.line}: ${pad}${entry.text}`);
+        }
+        if (result2.outline.length === 0) {
+          lines.push("*No functions, type definitions, or top-level declarations found.*");
+        }
+        const text2 = lines.join("\n");
+        return {
+          content: [
+            { type: "text", text: applyTokenBudget(text2, params.maxTokens) }
+          ]
+        };
+      }
       if (params.lineRange && params.lineRange.end < params.lineRange.start) {
         return {
           content: [{ type: "text", text: "lineRange.end must be >= lineRange.start." }],
@@ -1211,10 +1295,10 @@ function registerReadScript(server, bridge) {
         };
       }
       const result = await bridge.send("read_script", {
-        path: params.path,
+        path,
         lineRange: params.lineRange
       });
-      const text = formatScript(result.source, params.path);
+      const text = formatScript(result.source, path);
       return {
         content: [
           { type: "text", text: applyTokenBudget(text, params.maxTokens) }
@@ -1228,10 +1312,10 @@ function registerWriteTools(server, bridge) {
     "edit_script",
     {
       title: "Edit Script Source",
-      description: "Edit the Lua source code of a script. Supports four modes: 'full' replaces the entire source, 'range' replaces specific line/column ranges, 'find_replace' does text find-and-replace on one script, and 'multi_replace' does find-and-replace across multiple scripts in one undoable operation.",
+      description: "Edit the Lua source code of a script. Supports five modes:\n- 'full': Replace entire source.\n- 'range': Replace specific line/column ranges.\n- 'find_replace': Text find-and-replace on one script.\n- 'multi_replace': Same find-and-replace across multiple scripts.\n- 'batch': Different find-and-replace edits across different scripts in one atomic operation. Use this when you need different changes in different scripts.\n\nTip: Wrap multiple edits in a transaction (begin/commit) to group them into a single Ctrl+Z undo point.",
       inputSchema: z3.object({
-        path: z3.string().describe("Path to the script instance"),
-        mode: z3.enum(["full", "range", "find_replace", "multi_replace"]).describe("Edit mode: full, range, find_replace, or multi_replace"),
+        path: z3.string().optional().describe("Path to the script instance (not needed for 'multi_replace' or 'batch' modes)"),
+        mode: z3.enum(["full", "range", "find_replace", "multi_replace", "batch"]).describe("Edit mode"),
         source: z3.string().optional().describe("Complete new source (for 'full' mode)"),
         edits: z3.array(
           z3.object({
@@ -1245,7 +1329,18 @@ function registerWriteTools(server, bridge) {
         find: z3.string().optional().describe("Text or pattern to find (for 'find_replace' mode)"),
         replace: z3.string().optional().describe("Replacement text (for 'find_replace' mode)"),
         regex: z3.boolean().optional().describe("Treat 'find' as a Lua pattern (for 'find_replace' and 'multi_replace' modes)"),
-        scripts: z3.array(z3.string()).optional().describe("Array of script paths to apply find/replace across (for 'multi_replace' mode)")
+        scripts: z3.array(z3.string()).optional().describe("Array of script paths to apply find/replace across (for 'multi_replace' mode)"),
+        batch: z3.array(
+          z3.object({
+            path: z3.string().describe("Script path"),
+            source: z3.string().optional().describe("Complete new source (for full replacement). Mutually exclusive with find/replace."),
+            find: z3.string().optional().describe("Text or pattern to find"),
+            replace: z3.string().default("").describe("Replacement text (used with find)"),
+            regex: z3.boolean().default(false).describe("Treat find as a Lua pattern (used with find)")
+          })
+        ).optional().describe(
+          "Array of per-script edit operations (for 'batch' mode). Each entry can either use `source` for full replacement or `find`/`replace` for targeted edits."
+        )
       }),
       annotations: {
         readOnlyHint: false,
@@ -1307,6 +1402,51 @@ function registerWriteTools(server, bridge) {
         }
         return { content: [{ type: "text", text: lines.join("\n") }] };
       }
+      if (params.mode === "batch") {
+        if (!params.batch || params.batch.length === 0) {
+          return {
+            content: [{ type: "text", text: "batch mode requires a non-empty `batch` array." }],
+            isError: true
+          };
+        }
+        for (const entry of params.batch) {
+          if (entry.source !== void 0 && entry.find !== void 0) {
+            return {
+              content: [{ type: "text", text: `Batch entry for \`${entry.path}\`: provide either \`source\` or \`find\`, not both.` }],
+              isError: true
+            };
+          }
+          if (entry.source === void 0 && entry.find === void 0) {
+            return {
+              content: [{ type: "text", text: `Batch entry for \`${entry.path}\`: must provide either \`source\` (full replacement) or \`find\` (find/replace).` }],
+              isError: true
+            };
+          }
+        }
+        const result2 = await bridge.send("batch_edit_scripts", {
+          edits: params.batch
+        });
+        const lines = [
+          `**Batch edit** \u2014 ${result2.scriptsModified} script(s) modified`,
+          ""
+        ];
+        for (const r of result2.results) {
+          if (r.success) {
+            if (r.mode === "full") {
+              lines.push(`- \`${r.path}\`: full source replaced`);
+            } else {
+              lines.push(`- \`${r.path}\`: ${r.replacements ?? 0} replacement(s)`);
+            }
+          }
+        }
+        if (result2.errors && result2.errors.length > 0) {
+          lines.push("", "**Errors:**");
+          for (const e of result2.errors) {
+            lines.push(`- \`${e.path}\`: ${e.error}`);
+          }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
       const result = await bridge.send("edit_script", {
         path: params.path,
         mode: params.mode,
@@ -1379,9 +1519,9 @@ function register4(server, bridge) {
     "playtest",
     {
       title: "Playtest Control & Virtual Input",
-      description: "Control Roblox Studio playtesting and simulate user input.\n\nActions:\n- `start`: Begin a playtest session. Defaults to Play mode (F5, full client with player character). Set mode='run' for Run mode (F8, server-only, no player).\n- `stop`: End the current playtest.\n- `execute`: Run Lua code in the running game context.\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 (requires active playtest).\n- `navigate`: Walk the player character to a position using PathfindingService (requires client playtest).\n- `mouse_click`: Simulate a mouse click at screen coordinates.\n- `mouse_move`: Move the virtual mouse to screen coordinates.\n- `key_press`: Press and release a key.\n- `key_down`: Hold a key down.\n- `key_up`: Release a held key.",
+      description: "Control Roblox Studio playtesting and simulate user input.\n\nActions:\n- `start`: Begin a playtest session. Defaults to Play mode (F5, full client with player character). Set mode='run' for Run mode (F8, server-only, no player).\n- `stop`: End the current playtest.\n- `execute`: Run Lua code in the running game context.\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 (requires active playtest).\n- `navigate`: Walk the player character to a position using PathfindingService (requires client playtest).\n- `mouse_click`: Simulate a mouse click at screen coordinates.\n- `mouse_move`: Move the virtual mouse to screen coordinates.\n- `key_press`: Press and release a key.\n- `key_down`: Hold a key down.\n- `key_up`: Release a held key.\n- `screenshot`: Capture the viewport during playtest. 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"]).describe("Playtest action"),
+        action: z4.enum(["start", "stop", "execute", "get_output", "inspect", "navigate", "mouse_click", "mouse_move", "key_press", "key_down", "key_up", "screenshot"]).describe("Playtest action"),
         mode: z4.enum(["play", "run"]).default("play").describe("Playtest mode: 'play' (F5, full client with player) or 'run' (F8, server-only). Default: play"),
         code: z4.string().optional().describe("Lua code to execute (for 'execute' action)"),
         // get_output params
@@ -1465,6 +1605,25 @@ ${logText}
 ${result2.message}` : ""}`;
         return { content: [{ type: "text", text: text2 }] };
       }
+      if (params.action === "screenshot") {
+        const result2 = await bridge.send("screenshot", {});
+        if (result2.imageBase64 && result2.mimeType) {
+          return {
+            content: [
+              {
+                type: "image",
+                data: result2.imageBase64,
+                mimeType: result2.mimeType
+              }
+            ]
+          };
+        }
+        return {
+          content: [
+            { type: "text", text: `Playtest screenshot: ${result2.message ?? result2.status}` }
+          ]
+        };
+      }
       if (params.action === "mouse_click" || params.action === "mouse_move" || params.action === "key_press" || params.action === "key_down" || params.action === "key_up") {
         if ((params.action === "mouse_click" || params.action === "mouse_move") && (params.x === void 0 || params.y === void 0)) {
           return {
@@ -1955,7 +2114,7 @@ function register7(server, bridge) {
     "screenshot",
     {
       title: "Take Screenshot",
-      description: "Capture a screenshot of the current Roblox Studio viewport. Returns base64 image data when available for vision model consumption.",
+      description: "Capture a screenshot of the current Roblox Studio viewport. Works in both edit mode and during playtest.\n\nThe screenshot is saved to the user's Roblox screenshots folder. Base64 image data is returned when the EditableImage API is available (Roblox platform limitation).\n\nTip: During playtest, use this to capture the game viewport. Combine with `playtest start` + a short delay via `playtest execute` (e.g. `task.wait(2)`) to capture after the game loads.",
       inputSchema: z7.object({}),
       annotations: {
         readOnlyHint: true,
@@ -2014,10 +2173,11 @@ function register7(server, bridge) {
     "transaction",
     {
       title: "Transaction Control",
-      description: "Group multiple mutating tool calls into a single Ctrl+Z undo point.\n\nUsage: ALWAYS call `begin` first, then make your changes, then call `commit` or `rollback`. Calling `commit` or `rollback` without a prior `begin` will error.\n\nActions:\n- `begin`: Start a transaction. All subsequent writes share one undo recording.\n- `commit`: Finish an open transaction and commit all changes as one undo point. Requires a prior `begin`.\n- `rollback`: Cancel an open transaction and undo all changes made since begin. Requires a prior `begin`.\n\nTransactions auto-rollback after 60 seconds if not committed.",
+      description: "Group multiple tool calls into a single Ctrl+Z undo point \u2014 essential when making several related edits that the user should be able to revert together.\n\n**When to use:** Before starting a multi-edit session (e.g. refactoring across scripts, creating multiple instances, UI changes). Call `begin`, make all your changes, then `commit`. The user can undo everything in one Ctrl+Z.\n\nActions:\n- `begin`: Start a transaction. All subsequent writes share one undo recording.\n- `commit`: Finish and commit all changes as one undo point.\n- `rollback`: Cancel and revert all changes since begin.\n\nTransactions auto-rollback after the timeout (default 120s) if not committed.",
       inputSchema: z7.object({
         action: z7.enum(["begin", "commit", "rollback"]).describe("Transaction action"),
-        name: z7.string().optional().describe("Transaction name for the undo history (for 'begin' action)")
+        name: z7.string().optional().describe("Transaction name for the undo history (for 'begin' action)"),
+        timeout: z7.number().int().min(10).max(300).optional().describe("Auto-rollback timeout in seconds (default 120, min 10, max 300). Increase for large multi-edit sessions.")
       }),
       annotations: {
         readOnlyHint: false,
@@ -2031,7 +2191,8 @@ function register7(server, bridge) {
       if (params.action === "begin") {
         try {
           const result = await bridge.send("begin_transaction", {
-            name: params.name
+            name: params.name,
+            timeout: params.timeout
           });
           transactionState.set(studioId, true);
           return {
@@ -2428,4 +2589,4 @@ async function startServer(port = 3200, options = {}) {
 export {
   startServer
 };
-//# sourceMappingURL=chunk-T5QDC4DR.js.map
+//# sourceMappingURL=chunk-3FU4T3TX.js.map