robloxstudio-mcp 2.6.0-next.0 → 2.6.0-next.2

package/dist/index.js

@@ -99,15 +99,18 @@ var init_install_plugin = __esm({
   }
 });
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/server.js
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+// ../core/dist/server.js
+import { Server as Server2 } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema as CallToolRequestSchema2, ErrorCode as ErrorCode2, ListToolsRequestSchema as ListToolsRequestSchema2, McpError as McpError2 } from "@modelcontextprotocol/sdk/types.js";
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/http-server.js
+// ../core/dist/http-server.js
 import express from "express";
 import cors from "cors";
 import http from "http";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from "@modelcontextprotocol/sdk/types.js";
 var TOOL_HANDLERS = {
   get_file_tree: (tools, body) => tools.getFileTree(body.path),
   search_files: (tools, body) => tools.searchFiles(body.query, body.searchType),
@@ -155,10 +158,11 @@ var TOOL_HANDLERS = {
   remove_tag: (tools, body) => tools.removeTag(body.instancePath, body.tagName),
   get_tagged: (tools, body) => tools.getTagged(body.tagName),
   get_selection: (tools) => tools.getSelection(),
-  execute_luau: (tools, body) => tools.executeLuau(body.code),
-  start_playtest: (tools, body) => tools.startPlaytest(body.mode),
+  execute_luau: (tools, body) => tools.executeLuau(body.code, body.target),
+  start_playtest: (tools, body) => tools.startPlaytest(body.mode, body.numPlayers),
   stop_playtest: (tools) => tools.stopPlaytest(),
-  get_playtest_output: (tools) => tools.getPlaytestOutput(),
+  get_playtest_output: (tools, body) => tools.getPlaytestOutput(body.target),
+  get_connected_instances: (tools) => tools.getConnectedInstances(),
   export_build: (tools, body) => tools.exportBuild(body.instancePath, body.outputId, body.style),
   create_build: (tools, body) => tools.createBuild(body.id, body.style, body.palette, body.parts, body.bounds),
   generate_build: (tools, body) => tools.generateBuild(body.id, body.style, body.palette, body.code, body.seed),
@@ -174,15 +178,54 @@ var TOOL_HANDLERS = {
   get_asset_thumbnail: (tools, body) => tools.getAssetThumbnail(body.assetId, body.size),
   insert_asset: (tools, body) => tools.insertAsset(body.assetId, body.parentPath, body.position),
   preview_asset: (tools, body) => tools.previewAsset(body.assetId, body.includeProperties, body.maxDepth),
-  capture_screenshot: (tools) => tools.captureScreenshot()
+  render_object_screenshot: (tools, body) => tools.renderObjectScreenshot(body.instancePath, {
+    cameraPreset: body.cameraPreset,
+    padding: body.padding,
+    backdropColor: body.backdropColor,
+    savePath: body.savePath,
+    outputDir: body.outputDir,
+    fileName: body.fileName,
+    returnImage: body.returnImage
+  }),
+  render_model_screenshot: (tools, body) => tools.renderModelScreenshot(body.instancePath, {
+    cameraPreset: body.cameraPreset,
+    padding: body.padding,
+    backdropColor: body.backdropColor,
+    savePath: body.savePath,
+    outputDir: body.outputDir,
+    fileName: body.fileName,
+    returnImage: body.returnImage
+  }),
+  batch_render_objects: (tools, body) => tools.batchRenderObjects(body.parentPath, body.outputDir, {
+    recursive: body.recursive,
+    cameraPreset: body.cameraPreset,
+    padding: body.padding,
+    backdropColor: body.backdropColor
+  }),
+  batch_render_models: (tools, body) => tools.batchRenderModels(body.parentPath, body.outputDir, {
+    recursive: body.recursive,
+    cameraPreset: body.cameraPreset,
+    padding: body.padding,
+    backdropColor: body.backdropColor
+  }),
+  capture_screenshot: (tools) => tools.captureScreenshot(),
+  simulate_mouse_input: (tools, body) => tools.simulateMouseInput(body.action, body.x, body.y, body.button, body.scrollDirection, body.target),
+  simulate_keyboard_input: (tools, body) => tools.simulateKeyboardInput(body.keyCode, body.action, body.duration, body.target),
+  character_navigation: (tools, body) => tools.characterNavigation(body.position, body.instancePath, body.waitForCompletion, body.timeout, body.target),
+  find_and_replace_in_scripts: (tools, body) => tools.findAndReplaceInScripts(body.pattern, body.replacement, {
+    caseSensitive: body.caseSensitive,
+    usePattern: body.usePattern,
+    path: body.path,
+    classFilter: body.classFilter,
+    dryRun: body.dryRun,
+    maxReplacements: body.maxReplacements
+  })
 };
-function createHttpServer(tools, bridge, allowedTools) {
+function createHttpServer(tools, bridge, allowedTools, serverConfig) {
   const app = express();
-  let pluginConnected = false;
   let mcpServerActive = false;
   let lastMCPActivity = 0;
   let mcpServerStartTime = 0;
-  let lastPluginActivity = 0;
   const proxyInstances = /* @__PURE__ */ new Set();
   const setMCPServerActive = (active) => {
     mcpServerActive = active;
@@ -205,44 +248,78 @@ function createHttpServer(tools, bridge, allowedTools) {
     return Date.now() - lastMCPActivity < 3e4;
   };
   const isPluginConnected = () => {
-    return pluginConnected && Date.now() - lastPluginActivity < 3e4;
+    return bridge.getInstances().length > 0;
   };
   app.use(cors());
   app.use(express.json({ limit: "50mb" }));
   app.use(express.urlencoded({ limit: "50mb", extended: true }));
   app.get("/health", (req, res) => {
+    const instances = bridge.getInstances();
     res.json({
       status: "ok",
       service: "robloxstudio-mcp",
-      pluginConnected,
+      version: serverConfig?.version,
+      pluginConnected: instances.length > 0,
+      instanceCount: instances.length,
+      instances: instances.map((i) => ({
+        instanceId: i.instanceId,
+        role: i.role,
+        lastActivity: i.lastActivity,
+        connectedAt: i.connectedAt
+      })),
       mcpServerActive: isMCPServerActive(),
       uptime: mcpServerActive ? Date.now() - mcpServerStartTime : 0,
-      proxyInstanceCount: proxyInstances.size
+      pendingRequests: bridge.getPendingRequestCount(),
+      proxyInstanceCount: proxyInstances.size,
+      streamableHttp: !!serverConfig
     });
   });
   app.post("/ready", (req, res) => {
-    pluginConnected = true;
-    lastPluginActivity = Date.now();
-    res.json({ success: true });
+    const { instanceId, role } = req.body;
+    if (instanceId && role) {
+      const assignedRole = bridge.registerInstance(instanceId, role);
+      res.json({ success: true, assignedRole });
+    } else {
+      bridge.registerInstance("legacy", "edit");
+      res.json({ success: true, assignedRole: "edit" });
+    }
   });
   app.post("/disconnect", (req, res) => {
-    pluginConnected = false;
-    bridge.clearAllPendingRequests();
+    const { instanceId } = req.body;
+    if (instanceId) {
+      bridge.unregisterInstance(instanceId);
+    } else {
+      bridge.unregisterInstance("legacy");
+      bridge.clearAllPendingRequests();
+    }
     res.json({ success: true });
   });
   app.get("/status", (req, res) => {
+    const instances = bridge.getInstances();
     res.json({
-      pluginConnected: isPluginConnected(),
+      pluginConnected: instances.length > 0,
+      instanceCount: instances.length,
+      instances: instances.map((i) => ({ instanceId: i.instanceId, role: i.role })),
       mcpServerActive: isMCPServerActive(),
       lastMCPActivity,
       uptime: mcpServerActive ? Date.now() - mcpServerStartTime : 0
     });
   });
+  app.get("/instances", (req, res) => {
+    res.json({ instances: bridge.getInstances() });
+  });
   app.get("/poll", (req, res) => {
-    if (!pluginConnected) {
-      pluginConnected = true;
+    const instanceId = req.query.instanceId;
+    if (instanceId) {
+      bridge.updateInstanceActivity(instanceId);
+    }
+    let callerRole = "edit";
+    if (instanceId) {
+      const inst = bridge.getInstances().find((i) => i.instanceId === instanceId);
+      if (inst) {
+        callerRole = inst.role;
+      }
     }
-    lastPluginActivity = Date.now();
     if (!isMCPServerActive()) {
       res.status(503).json({
         error: "MCP server not connected",
@@ -252,7 +329,7 @@ function createHttpServer(tools, bridge, allowedTools) {
       });
       return;
     }
-    const pendingRequest = bridge.getPendingRequest();
+    const pendingRequest = bridge.getPendingRequest(callerRole);
     if (pendingRequest) {
       res.json({
         request: pendingRequest.request,
@@ -280,7 +357,7 @@ function createHttpServer(tools, bridge, allowedTools) {
     res.json({ success: true });
   });
   app.post("/proxy", async (req, res) => {
-    const { endpoint, data, proxyInstanceId } = req.body;
+    const { endpoint, data, target, proxyInstanceId } = req.body;
     if (!endpoint) {
       res.status(400).json({ error: "endpoint is required" });
       return;
@@ -289,12 +366,76 @@ function createHttpServer(tools, bridge, allowedTools) {
       proxyInstances.add(proxyInstanceId);
     }
     try {
-      const response = await bridge.sendRequest(endpoint, data);
+      const response = await bridge.sendRequest(endpoint, data, target || "edit");
       res.json({ response });
     } catch (err) {
       res.status(500).json({ error: err.message || "Proxy request failed" });
     }
   });
+  if (serverConfig) {
+    const filteredTools = serverConfig.tools.filter((t) => !allowedTools || allowedTools.has(t.name));
+    app.post("/mcp", async (req, res) => {
+      try {
+        trackMCPActivity();
+        const server = new Server({ name: serverConfig.name, version: serverConfig.version }, { capabilities: { tools: {} } });
+        server.setRequestHandler(ListToolsRequestSchema, async () => ({
+          tools: filteredTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema
+          }))
+        }));
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+          const { name, arguments: args } = request.params;
+          if (allowedTools && !allowedTools.has(name)) {
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+          }
+          const handler = TOOL_HANDLERS[name];
+          if (!handler) {
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+          }
+          try {
+            return await handler(tools, args || {});
+          } catch (error) {
+            if (error instanceof McpError)
+              throw error;
+            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
+          }
+        });
+        const transport = new StreamableHTTPServerTransport({
+          sessionIdGenerator: void 0
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        res.on("close", () => {
+          transport.close();
+          server.close();
+        });
+      } catch (error) {
+        if (!res.headersSent) {
+          res.status(500).json({
+            jsonrpc: "2.0",
+            error: { code: -32603, message: "Internal server error" },
+            id: null
+          });
+        }
+      }
+    });
+    app.get("/mcp", (req, res) => {
+      res.writeHead(405).end(JSON.stringify({
+        jsonrpc: "2.0",
+        error: { code: -32e3, message: "Method not allowed." },
+        id: null
+      }));
+    });
+    app.delete("/mcp", (req, res) => {
+      res.writeHead(405).end(JSON.stringify({
+        jsonrpc: "2.0",
+        error: { code: -32e3, message: "Method not allowed." },
+        id: null
+      }));
+    });
+  }
   app.use("/mcp/*", (req, res, next) => {
     trackMCPActivity();
     next();
@@ -352,15 +493,15 @@ function bindPort(app, host, port) {
   });
 }
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/tools/studio-client.js
+// ../core/dist/tools/studio-client.js
 var StudioHttpClient = class {
   bridge;
   constructor(bridge) {
     this.bridge = bridge;
   }
-  async request(endpoint, data) {
+  async request(endpoint, data, target = "edit") {
     try {
-      const response = await this.bridge.sendRequest(endpoint, data);
+      const response = await this.bridge.sendRequest(endpoint, data, target);
       return response;
     } catch (error) {
       if (error instanceof Error && error.message === "Request timeout") {
@@ -371,7 +512,7 @@ var StudioHttpClient = class {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/tools/build-executor.js
+// ../core/dist/tools/build-executor.js
 import * as vm from "vm";
 var DEFAULT_TIMEOUT = 1e4;
 var DEFAULT_MAX_PARTS = 1e4;
@@ -768,7 +909,7 @@ function runBuildExecutor(code, palette, seed, options) {
   return { parts, bounds, partCount: parts.length };
 }
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/opencloud-client.js
+// ../core/dist/opencloud-client.js
 var OpenCloudClient = class {
   apiKey;
   baseUrl;
@@ -905,19 +1046,37 @@ var OpenCloudClient = class {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/png-encoder.js
-import { deflateSync, crc32 } from "zlib";
+// ../core/dist/png-encoder.js
+import { deflateSync } from "zlib";
 var PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+var CRC_TABLE = new Uint32Array(256);
+for (let n = 0; n < 256; n++) {
+  let c = n;
+  for (let k = 0; k < 8; k++)
+    c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+  CRC_TABLE[n] = c;
+}
+function crc32(buf) {
+  let crc = 4294967295;
+  for (let i = 0; i < buf.length; i++)
+    crc = CRC_TABLE[(crc ^ buf[i]) & 255] ^ crc >>> 8;
+  return (crc ^ 4294967295) >>> 0;
+}
 function writeChunk(type, data) {
   const typeBytes = Buffer.from(type, "ascii");
   const length = Buffer.alloc(4);
   length.writeUInt32BE(data.length);
   const crcInput = Buffer.concat([typeBytes, data]);
   const checksum = Buffer.alloc(4);
-  checksum.writeUInt32BE(crc32(crcInput) >>> 0);
+  checksum.writeUInt32BE(crc32(crcInput));
   return Buffer.concat([length, typeBytes, data, checksum]);
 }
 function rgbaToPng(rgba, width, height) {
+  if (width <= 0 || height <= 0)
+    throw new Error(`Invalid PNG dimensions: ${width}x${height}`);
+  const expected = width * height * 4;
+  if (rgba.length < expected)
+    throw new Error(`Buffer too small: got ${rgba.length}, need ${expected}`);
   const stride = width * 4;
   const filtered = Buffer.alloc(height * (1 + stride));
   for (let y = 0; y < height; y++) {
@@ -940,14 +1099,50 @@ function rgbaToPng(rgba, width, height) {
   ]);
 }
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/tools/index.js
+// ../core/dist/tools/index.js
 import * as fs from "fs";
 import * as path from "path";
+function encodePngFromRgbaResponse(response) {
+  if (!response.data || response.width === void 0 || response.height === void 0) {
+    throw new Error("Render response missing data, width, or height");
+  }
+  const rgbaBuffer = Buffer.from(response.data, "base64");
+  return rgbaToPng(rgbaBuffer, response.width, response.height);
+}
+function ensureParentDirectory(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+function writePng(filePath, pngBuffer) {
+  ensureParentDirectory(filePath);
+  fs.writeFileSync(filePath, pngBuffer);
+}
+function sanitizeFileSegment(name) {
+  const sanitized = name.replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").replace(/\s+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+  return sanitized || "model";
+}
+function ensurePngExtension(fileName) {
+  return path.extname(fileName) ? fileName : `${fileName}.png`;
+}
+function getDefaultObjectName(instancePath, instanceName) {
+  return instanceName || instancePath.split(".").pop() || "object";
+}
+function resolveSingleRenderSavePath(instancePath, instanceName, options) {
+  if (options?.savePath) {
+    return options.savePath;
+  }
+  if (!options?.outputDir) {
+    return void 0;
+  }
+  const baseName = sanitizeFileSegment(options.fileName || getDefaultObjectName(instancePath, instanceName));
+  return path.join(options.outputDir, ensurePngExtension(baseName));
+}
 var RobloxStudioTools = class _RobloxStudioTools {
   client;
+  bridge;
   openCloudClient;
   constructor(bridge) {
     this.client = new StudioHttpClient(bridge);
+    this.bridge = bridge;
     this.openCloudClient = new OpenCloudClient();
   }
   async getFileTree(path2 = "") {
@@ -1466,11 +1661,11 @@ var RobloxStudioTools = class _RobloxStudioTools {
       ]
     };
   }
-  async executeLuau(code) {
+  async executeLuau(code, target) {
     if (!code) {
       throw new Error("Code is required for execute_luau");
     }
-    const response = await this.client.request("/api/execute-luau", { code });
+    const response = await this.client.request("/api/execute-luau", { code }, target || "edit");
     return {
       content: [
         {
@@ -1480,11 +1675,15 @@ var RobloxStudioTools = class _RobloxStudioTools {
       ]
     };
   }
-  async startPlaytest(mode) {
+  async startPlaytest(mode, numPlayers) {
     if (mode !== "play" && mode !== "run") {
       throw new Error('mode must be "play" or "run"');
     }
-    const response = await this.client.request("/api/start-playtest", { mode });
+    const data = { mode };
+    if (numPlayers !== void 0) {
+      data.numPlayers = numPlayers;
+    }
+    const response = await this.client.request("/api/start-playtest", data);
     return {
       content: [
         {
@@ -1505,8 +1704,8 @@ var RobloxStudioTools = class _RobloxStudioTools {
       ]
     };
   }
-  async getPlaytestOutput() {
-    const response = await this.client.request("/api/get-playtest-output", {});
+  async getPlaytestOutput(target) {
+    const response = await this.client.request("/api/get-playtest-output", {}, target || "edit");
     return {
       content: [
         {
@@ -1516,6 +1715,17 @@ var RobloxStudioTools = class _RobloxStudioTools {
       ]
     };
   }
+  async getConnectedInstances() {
+    const instances = this.bridge.getInstances();
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ instances, count: instances.length })
+        }
+      ]
+    };
+  }
   async undo() {
     const response = await this.client.request("/api/undo", {});
     return {
@@ -1991,6 +2201,212 @@ var RobloxStudioTools = class _RobloxStudioTools {
       }]
     };
   }
+  async requestRenderObjectScreenshot(instancePath, options) {
+    if (!instancePath) {
+      throw new Error("instancePath is required for render_object_screenshot");
+    }
+    const response = await this.client.request("/api/render-model-screenshot", {
+      instancePath,
+      cameraPreset: options?.cameraPreset,
+      padding: options?.padding,
+      backdropColor: options?.backdropColor
+    });
+    if (response.error) {
+      throw new Error(response.error);
+    }
+    return response;
+  }
+  async renderObjectScreenshot(instancePath, options) {
+    const response = await this.requestRenderObjectScreenshot(instancePath, options);
+    const pngBuffer = encodePngFromRgbaResponse(response);
+    const savePath = resolveSingleRenderSavePath(response.instancePath ?? instancePath, response.instanceName, options);
+    const returnImage = options?.returnImage ?? true;
+    if (savePath) {
+      writePng(savePath, pngBuffer);
+    }
+    const content = [];
+    if (returnImage) {
+      content.push({
+        type: "image",
+        data: pngBuffer.toString("base64"),
+        mimeType: "image/png"
+      });
+    }
+    content.push({
+      type: "text",
+      text: JSON.stringify({
+        success: true,
+        instancePath: response.instancePath ?? instancePath,
+        instanceName: response.instanceName,
+        cameraPreset: response.cameraPreset ?? options?.cameraPreset ?? "isometric",
+        width: response.width,
+        height: response.height,
+        savedPath: savePath
+      })
+    });
+    return { content };
+  }
+  async renderModelScreenshot(instancePath, options) {
+    return this.renderObjectScreenshot(instancePath, options);
+  }
+  async collectRenderablePaths(parentPath, recursive) {
+    const response = await this.client.request("/api/instance-children", {
+      instancePath: parentPath
+    });
+    if (response.error) {
+      throw new Error(response.error);
+    }
+    const children = response.children ?? [];
+    const renderablePaths = children.filter((child) => child.className === "Model" || child.className === "Part" || child.className === "MeshPart" || child.className === "WedgePart" || child.className === "CornerWedgePart" || child.className === "TrussPart" || child.className === "SpawnLocation" || child.className === "Seat" || child.className === "VehicleSeat" || child.className === "UnionOperation").map((child) => child.path);
+    if (!recursive) {
+      return renderablePaths;
+    }
+    const nestedTargets = children.filter((child) => child.hasChildren).map((child) => child.path);
+    for (const nestedPath of nestedTargets) {
+      renderablePaths.push(...await this.collectRenderablePaths(nestedPath, true));
+    }
+    return renderablePaths;
+  }
+  async batchRenderObjects(parentPath, outputDir, options) {
+    if (!parentPath || !outputDir) {
+      throw new Error("parentPath and outputDir are required for batch_render_objects");
+    }
+    const recursive = options?.recursive ?? false;
+    const renderablePaths = await this.collectRenderablePaths(parentPath, recursive);
+    const usedFilePaths = /* @__PURE__ */ new Set();
+    const results = [];
+    fs.mkdirSync(outputDir, { recursive: true });
+    for (const objectPath of renderablePaths) {
+      const objectName = objectPath.split(".").pop() || "object";
+      const fileBaseName = sanitizeFileSegment(objectName);
+      let filePath = path.join(outputDir, `${fileBaseName}.png`);
+      let suffix = 1;
+      while (usedFilePaths.has(filePath)) {
+        filePath = path.join(outputDir, `${fileBaseName}_${suffix}.png`);
+        suffix += 1;
+      }
+      usedFilePaths.add(filePath);
+      try {
+        const response = await this.requestRenderObjectScreenshot(objectPath, options);
+        const pngBuffer = encodePngFromRgbaResponse(response);
+        writePng(filePath, pngBuffer);
+        results.push({
+          success: true,
+          instancePath: response.instancePath ?? objectPath,
+          instanceName: response.instanceName ?? objectName,
+          cameraPreset: response.cameraPreset ?? options?.cameraPreset ?? "isometric",
+          width: response.width,
+          height: response.height,
+          filePath
+        });
+      } catch (error) {
+        results.push({
+          success: false,
+          instancePath: objectPath,
+          instanceName: objectName,
+          filePath,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    const manifestPath = path.join(outputDir, "render-manifest.json");
+    fs.writeFileSync(manifestPath, JSON.stringify({
+      parentPath,
+      outputDir,
+      recursive,
+      cameraPreset: options?.cameraPreset ?? "isometric",
+      totalObjects: renderablePaths.length,
+      renderedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      results
+    }, null, 2));
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          success: true,
+          parentPath,
+          outputDir,
+          recursive,
+          totalObjects: renderablePaths.length,
+          manifestPath,
+          results
+        })
+      }]
+    };
+  }
+  async batchRenderModels(parentPath, outputDir, options) {
+    return this.batchRenderObjects(parentPath, outputDir, options);
+  }
+  async simulateMouseInput(action, x, y, button, scrollDirection, target) {
+    if (!action) {
+      throw new Error("action is required for simulate_mouse_input");
+    }
+    const response = await this.client.request("/api/simulate-mouse-input", {
+      action,
+      x,
+      y,
+      button,
+      scrollDirection
+    }, target || "edit");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(response)
+      }]
+    };
+  }
+  async simulateKeyboardInput(keyCode, action, duration, target) {
+    if (!keyCode) {
+      throw new Error("keyCode is required for simulate_keyboard_input");
+    }
+    const response = await this.client.request("/api/simulate-keyboard-input", {
+      keyCode,
+      action,
+      duration
+    }, target || "edit");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(response)
+      }]
+    };
+  }
+  async characterNavigation(position, instancePath, waitForCompletion, timeout, target) {
+    if (!position && !instancePath) {
+      throw new Error("Either position or instancePath is required for character_navigation");
+    }
+    const response = await this.client.request("/api/character-navigation", {
+      position,
+      instancePath,
+      waitForCompletion,
+      timeout
+    }, target || "edit");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(response)
+      }]
+    };
+  }
+  async findAndReplaceInScripts(pattern, replacement, options) {
+    if (!pattern) {
+      throw new Error("pattern is required for find_and_replace_in_scripts");
+    }
+    if (replacement === void 0 || replacement === null) {
+      throw new Error("replacement is required for find_and_replace_in_scripts");
+    }
+    const response = await this.client.request("/api/find-and-replace-in-scripts", {
+      pattern,
+      replacement,
+      ...options
+    });
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(response)
+      }]
+    };
+  }
   async captureScreenshot() {
     const response = await this.client.request("/api/capture-screenshot", {});
     if (response.error) {
@@ -2001,8 +2417,7 @@ var RobloxStudioTools = class _RobloxStudioTools {
         }]
       };
     }
-    const rgbaBuffer = Buffer.from(response.data, "base64");
-    const pngBuffer = rgbaToPng(rgbaBuffer, response.width, response.height);
+    const pngBuffer = encodePngFromRgbaResponse(response);
     return {
       content: [{
         type: "image",
@@ -2013,12 +2428,61 @@ var RobloxStudioTools = class _RobloxStudioTools {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/bridge-service.js
+// ../core/dist/bridge-service.js
 import { v4 as uuidv4 } from "uuid";
+var STALE_INSTANCE_MS = 3e4;
 var BridgeService = class {
   pendingRequests = /* @__PURE__ */ new Map();
+  instances = /* @__PURE__ */ new Map();
+  nextClientIndex = 1;
   requestTimeout = 3e4;
-  async sendRequest(endpoint, data) {
+  registerInstance(instanceId, role) {
+    let assignedRole = role;
+    if (role === "client") {
+      assignedRole = `client-${this.nextClientIndex}`;
+      this.nextClientIndex++;
+    }
+    this.instances.set(instanceId, {
+      instanceId,
+      role: assignedRole,
+      lastActivity: Date.now(),
+      connectedAt: Date.now()
+    });
+    return assignedRole;
+  }
+  unregisterInstance(instanceId) {
+    this.instances.delete(instanceId);
+    for (const [id, req] of this.pendingRequests.entries()) {
+      const targetRole = req.target;
+      const hasHandler = Array.from(this.instances.values()).some((i) => i.role === targetRole);
+      if (!hasHandler) {
+        clearTimeout(req.timeoutId);
+        this.pendingRequests.delete(id);
+        req.reject(new Error(`Target instance "${targetRole}" disconnected`));
+      }
+    }
+  }
+  getInstances() {
+    return Array.from(this.instances.values());
+  }
+  getPendingRequestCount() {
+    return this.pendingRequests.size;
+  }
+  updateInstanceActivity(instanceId) {
+    const inst = this.instances.get(instanceId);
+    if (inst) {
+      inst.lastActivity = Date.now();
+    }
+  }
+  cleanupStaleInstances() {
+    const now = Date.now();
+    for (const [id, inst] of this.instances.entries()) {
+      if (now - inst.lastActivity > STALE_INSTANCE_MS) {
+        this.unregisterInstance(id);
+      }
+    }
+  }
+  async sendRequest(endpoint, data, target = "edit") {
     const requestId = uuidv4();
     return new Promise((resolve, reject) => {
       const timeoutId = setTimeout(() => {
@@ -2031,6 +2495,7 @@ var BridgeService = class {
         id: requestId,
         endpoint,
         data,
+        target,
         timestamp: Date.now(),
         resolve,
         reject,
@@ -2039,9 +2504,11 @@ var BridgeService = class {
       this.pendingRequests.set(requestId, request);
     });
   }
-  getPendingRequest() {
+  getPendingRequest(callerRole = "edit") {
     let oldestRequest = null;
     for (const request of this.pendingRequests.values()) {
+      if (request.target !== callerRole)
+        continue;
       if (!oldestRequest || request.timestamp < oldestRequest.timestamp) {
         oldestRequest = request;
       }
@@ -2092,7 +2559,7 @@ var BridgeService = class {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/proxy-bridge-service.js
+// ../core/dist/proxy-bridge-service.js
 import { v4 as uuidv42 } from "uuid";
 var ProxyBridgeService = class extends BridgeService {
   primaryBaseUrl;
@@ -2103,14 +2570,14 @@ var ProxyBridgeService = class extends BridgeService {
     this.primaryBaseUrl = primaryBaseUrl;
     this.proxyInstanceId = uuidv42();
   }
-  async sendRequest(endpoint, data) {
+  async sendRequest(endpoint, data, target = "edit") {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.proxyRequestTimeout);
     try {
       const response = await fetch(`${this.primaryBaseUrl}/proxy`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ endpoint, data, proxyInstanceId: this.proxyInstanceId }),
+        body: JSON.stringify({ endpoint, data, target, proxyInstanceId: this.proxyInstanceId }),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -2137,7 +2604,7 @@ var ProxyBridgeService = class extends BridgeService {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/server.js
+// ../core/dist/server.js
 var RobloxStudioMCPServer = class {
   server;
   tools;
@@ -2147,7 +2614,7 @@ var RobloxStudioMCPServer = class {
   constructor(config) {
     this.config = config;
     this.allowedToolNames = new Set(config.tools.map((t) => t.name));
-    this.server = new Server({
+    this.server = new Server2({
       name: config.name,
       version: config.version
     }, {
@@ -2160,7 +2627,7 @@ var RobloxStudioMCPServer = class {
     this.setupToolHandlers();
   }
   setupToolHandlers() {
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+    this.server.setRequestHandler(ListToolsRequestSchema2, async () => {
       return {
         tools: this.config.tools.map((t) => ({
           name: t.name,
@@ -2169,10 +2636,10 @@ var RobloxStudioMCPServer = class {
         }))
       };
     });
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    this.server.setRequestHandler(CallToolRequestSchema2, async (request) => {
       const { name, arguments: args } = request.params;
       if (!this.allowedToolNames.has(name)) {
-        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        throw new McpError2(ErrorCode2.MethodNotFound, `Unknown tool: ${name}`);
       }
       try {
         switch (name) {
@@ -2258,13 +2725,15 @@ var RobloxStudioMCPServer = class {
           case "get_selection":
             return await this.tools.getSelection();
           case "execute_luau":
-            return await this.tools.executeLuau(args?.code);
+            return await this.tools.executeLuau(args?.code, args?.target);
           case "start_playtest":
-            return await this.tools.startPlaytest(args?.mode);
+            return await this.tools.startPlaytest(args?.mode, args?.numPlayers);
           case "stop_playtest":
             return await this.tools.stopPlaytest();
           case "get_playtest_output":
-            return await this.tools.getPlaytestOutput();
+            return await this.tools.getPlaytestOutput(args?.target);
+          case "get_connected_instances":
+            return await this.tools.getConnectedInstances();
           case "export_build":
             return await this.tools.exportBuild(args?.instancePath, args?.outputId, args?.style);
           case "create_build":
@@ -2295,15 +2764,64 @@ var RobloxStudioMCPServer = class {
             return await this.tools.insertAsset(args?.assetId, args?.parentPath, args?.position);
           case "preview_asset":
             return await this.tools.previewAsset(args?.assetId, args?.includeProperties, args?.maxDepth);
+          case "render_object_screenshot":
+            return await this.tools.renderObjectScreenshot(args?.instancePath, {
+              cameraPreset: args?.cameraPreset,
+              padding: args?.padding,
+              backdropColor: args?.backdropColor,
+              savePath: args?.savePath,
+              outputDir: args?.outputDir,
+              fileName: args?.fileName,
+              returnImage: args?.returnImage
+            });
+          case "render_model_screenshot":
+            return await this.tools.renderModelScreenshot(args?.instancePath, {
+              cameraPreset: args?.cameraPreset,
+              padding: args?.padding,
+              backdropColor: args?.backdropColor,
+              savePath: args?.savePath,
+              outputDir: args?.outputDir,
+              fileName: args?.fileName,
+              returnImage: args?.returnImage
+            });
+          case "batch_render_objects":
+            return await this.tools.batchRenderObjects(args?.parentPath, args?.outputDir, {
+              recursive: args?.recursive,
+              cameraPreset: args?.cameraPreset,
+              padding: args?.padding,
+              backdropColor: args?.backdropColor
+            });
+          case "batch_render_models":
+            return await this.tools.batchRenderModels(args?.parentPath, args?.outputDir, {
+              recursive: args?.recursive,
+              cameraPreset: args?.cameraPreset,
+              padding: args?.padding,
+              backdropColor: args?.backdropColor
+            });
           case "capture_screenshot":
             return await this.tools.captureScreenshot();
+          case "simulate_mouse_input":
+            return await this.tools.simulateMouseInput(args?.action, args?.x, args?.y, args?.button, args?.scrollDirection, args?.target);
+          case "simulate_keyboard_input":
+            return await this.tools.simulateKeyboardInput(args?.keyCode, args?.action, args?.duration, args?.target);
+          case "character_navigation":
+            return await this.tools.characterNavigation(args?.position, args?.instancePath, args?.waitForCompletion, args?.timeout, args?.target);
+          case "find_and_replace_in_scripts":
+            return await this.tools.findAndReplaceInScripts(args?.pattern, args?.replacement, {
+              caseSensitive: args?.caseSensitive,
+              usePattern: args?.usePattern,
+              path: args?.path,
+              classFilter: args?.classFilter,
+              dryRun: args?.dryRun,
+              maxReplacements: args?.maxReplacements
+            });
           default:
-            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            throw new McpError2(ErrorCode2.MethodNotFound, `Unknown tool: ${name}`);
         }
       } catch (error) {
-        if (error instanceof McpError)
+        if (error instanceof McpError2)
           throw error;
-        throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        throw new McpError2(ErrorCode2.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
       }
     });
   }
@@ -2316,11 +2834,12 @@ var RobloxStudioMCPServer = class {
     let boundPort = 0;
     let promotionInterval;
     try {
-      primaryApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames);
+      primaryApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames, this.config);
       const result = await listenWithRetry(primaryApp, host, basePort, 5);
       httpHandle = result.server;
       boundPort = result.port;
       console.error(`HTTP server listening on ${host}:${boundPort} for Studio plugin (primary mode)`);
+      console.error(`Streamable HTTP MCP endpoint: http://localhost:${boundPort}/mcp`);
     } catch {
       bridgeMode = "proxy";
       primaryApp = void 0;
@@ -2333,7 +2852,7 @@ var RobloxStudioMCPServer = class {
         try {
           this.bridge = new BridgeService();
           this.tools = new RobloxStudioTools(this.bridge);
-          primaryApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames);
+          primaryApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames, this.config);
           const result = await listenWithRetry(primaryApp, host, basePort, 5);
           httpHandle = result.server;
           boundPort = result.port;
@@ -2353,7 +2872,7 @@ var RobloxStudioMCPServer = class {
     let legacyHandle;
     let legacyApp;
     if (boundPort !== LEGACY_PORT && bridgeMode === "primary") {
-      legacyApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames);
+      legacyApp = createHttpServer(this.tools, this.bridge, this.allowedToolNames, this.config);
       try {
         const result = await listenWithRetry(legacyApp, host, LEGACY_PORT, 1);
         legacyHandle = result.server;
@@ -2391,13 +2910,16 @@ var RobloxStudioMCPServer = class {
     }, 5e3);
     const cleanupInterval = setInterval(() => {
       this.bridge.cleanupOldRequests();
+      this.bridge.cleanupStaleInstances();
     }, 5e3);
-    const shutdown = () => {
+    const shutdown = async () => {
       console.error("Shutting down MCP server...");
       clearInterval(activityInterval);
       clearInterval(cleanupInterval);
       if (promotionInterval)
         clearInterval(promotionInterval);
+      await this.server.close().catch(() => {
+      });
       if (httpHandle)
         httpHandle.close();
       if (legacyHandle)
@@ -2412,7 +2934,7 @@ var RobloxStudioMCPServer = class {
   }
 };
 
-// ../../node_modules/@robloxstudio-mcp/core/dist/tools/definitions.js
+// ../core/dist/tools/definitions.js
 var TOOL_DEFINITIONS = [
   // === File & Instance Browsing ===
   {
@@ -2424,8 +2946,7 @@ var TOOL_DEFINITIONS = [
       properties: {
         path: {
           type: "string",
-          description: "Root path (default: game root)",
-          default: ""
+          description: "Root path (default: game root)"
         }
       }
     }
@@ -2444,8 +2965,7 @@ var TOOL_DEFINITIONS = [
         searchType: {
           type: "string",
           enum: ["name", "type", "content"],
-          description: "Search mode",
-          default: "name"
+          description: "Search mode (default: name)"
         }
       },
       required: ["query"]
@@ -2489,8 +3009,7 @@ var TOOL_DEFINITIONS = [
         searchType: {
           type: "string",
           enum: ["name", "class", "property"],
-          description: "Search mode",
-          default: "name"
+          description: "Search mode (default: name)"
         },
         propertyName: {
           type: "string",
@@ -2514,8 +3033,7 @@ var TOOL_DEFINITIONS = [
         },
         excludeSource: {
           type: "boolean",
-          description: "For scripts, return SourceLength/LineCount instead of full source (default: false)",
-          default: false
+          description: "For scripts, return SourceLength/LineCount instead of full source (default: false)"
         }
       },
       required: ["instancePath"]
@@ -2580,18 +3098,15 @@ var TOOL_DEFINITIONS = [
       properties: {
         path: {
           type: "string",
-          description: "Root path (default: workspace root)",
-          default: ""
+          description: "Root path (default: workspace root)"
         },
         maxDepth: {
           type: "number",
-          description: "Max traversal depth (default: 3)",
-          default: 3
+          description: "Max traversal depth (default: 3)"
         },
         scriptsOnly: {
           type: "boolean",
-          description: "Show only scripts",
-          default: false
+          description: "Show only scripts (default: false)"
         }
       }
     }
@@ -2613,7 +3128,7 @@ var TOOL_DEFINITIONS = [
           description: "Property name"
         },
         propertyValue: {
-          description: "Value to set"
+          description: "Value to set (string, number, boolean, or object for Vector3/Color3/UDim2)"
         }
       },
       required: ["instancePath", "propertyName", "propertyValue"]
@@ -2636,7 +3151,7 @@ var TOOL_DEFINITIONS = [
           description: "Property name"
         },
         propertyValue: {
-          description: "Value to set"
+          description: "Value to set (string, number, boolean, or object for Vector3/Color3/UDim2)"
         }
       },
       required: ["paths", "propertyName", "propertyValue"]
@@ -2768,22 +3283,16 @@ var TOOL_DEFINITIONS = [
             positionOffset: {
               type: "array",
               items: { type: "number" },
-              minItems: 3,
-              maxItems: 3,
               description: "X, Y, Z offset per duplicate"
             },
             rotationOffset: {
               type: "array",
               items: { type: "number" },
-              minItems: 3,
-              maxItems: 3,
               description: "X, Y, Z rotation offset"
             },
             scaleOffset: {
               type: "array",
               items: { type: "number" },
-              minItems: 3,
-              maxItems: 3,
               description: "X, Y, Z scale multiplier"
             },
             propertyVariations: {
@@ -2831,22 +3340,16 @@ var TOOL_DEFINITIONS = [
                   positionOffset: {
                     type: "array",
                     items: { type: "number" },
-                    minItems: 3,
-                    maxItems: 3,
                     description: "X, Y, Z offset per duplicate"
                   },
                   rotationOffset: {
                     type: "array",
                     items: { type: "number" },
-                    minItems: 3,
-                    maxItems: 3,
                     description: "X, Y, Z rotation offset"
                   },
                   scaleOffset: {
                     type: "array",
                     items: { type: "number" },
-                    minItems: 3,
-                    maxItems: 3,
                     description: "X, Y, Z scale multiplier"
                   },
                   propertyVariations: {
@@ -2920,7 +3423,7 @@ var TOOL_DEFINITIONS = [
           description: "Operation"
         },
         value: {
-          description: "Operand value"
+          description: "Operand value (number or object for Vector3/UDim2 components)"
         },
         component: {
           type: "string",
@@ -3014,8 +3517,7 @@ var TOOL_DEFINITIONS = [
         },
         afterLine: {
           type: "number",
-          description: "Insert after this line (0 = beginning)",
-          default: 0
+          description: "Insert after this line (0 = beginning)"
         },
         newContent: {
           type: "string",
@@ -3084,7 +3586,7 @@ var TOOL_DEFINITIONS = [
           description: "Attribute name"
         },
         attributeValue: {
-          description: "Value. Objects for Vector3/Color3/UDim2."
+          description: "Value (string, number, boolean, or object for Vector3/Color3/UDim2)"
         },
         valueType: {
           type: "string",
@@ -3218,6 +3720,10 @@ var TOOL_DEFINITIONS = [
         code: {
           type: "string",
           description: "Luau code to execute"
+        },
+        target: {
+          type: "string",
+          description: 'Instance target: "edit" (default), "server", "client-1", "client-2", etc.'
         }
       },
       required: ["code"]
@@ -3237,23 +3743,19 @@ var TOOL_DEFINITIONS = [
         },
         caseSensitive: {
           type: "boolean",
-          description: "Case-sensitive search (default: false)",
-          default: false
+          description: "Case-sensitive search (default: false)"
         },
         usePattern: {
           type: "boolean",
-          description: "Use Lua pattern matching instead of literal (default: false)",
-          default: false
+          description: "Use Lua pattern matching instead of literal (default: false)"
         },
         contextLines: {
           type: "number",
-          description: "Number of context lines before/after each match (like rg -C)",
-          default: 0
+          description: "Number of context lines before/after each match (default: 0)"
         },
         maxResults: {
           type: "number",
-          description: "Max total matches before stopping (default: 100)",
-          default: 100
+          description: "Max total matches before stopping (default: 100)"
         },
         maxResultsPerScript: {
           type: "number",
@@ -3261,8 +3763,7 @@ var TOOL_DEFINITIONS = [
         },
         filesOnly: {
           type: "boolean",
-          description: "Only return matching script paths, not line details (like rg -l)",
-          default: false
+          description: "Only return matching script paths, not line details (default: false)"
         },
         path: {
           type: "string",
@@ -3281,7 +3782,7 @@ var TOOL_DEFINITIONS = [
   {
     name: "start_playtest",
     category: "read",
-    description: "Start playtest. Captures print/warn/error via LogService. Poll with get_playtest_output, end with stop_playtest.",
+    description: "Start playtest. Captures print/warn/error via LogService. Poll with get_playtest_output, end with stop_playtest. Use numPlayers for multi-client testing (server + N clients).",
     inputSchema: {
       type: "object",
       properties: {
@@ -3289,6 +3790,10 @@ var TOOL_DEFINITIONS = [
           type: "string",
           enum: ["play", "run"],
           description: "Play mode"
+        },
+        numPlayers: {
+          type: "number",
+          description: "Number of client players (1-8). Triggers server + clients mode via TestService."
         }
       },
       required: ["mode"]
@@ -3307,6 +3812,21 @@ var TOOL_DEFINITIONS = [
     name: "get_playtest_output",
     category: "read",
     description: "Poll output buffer without stopping. Returns isRunning and captured messages.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        target: {
+          type: "string",
+          description: 'Instance target: "edit" (default), "server", "client-1", "client-2", etc.'
+        }
+      }
+    }
+  },
+  // === Multi-Instance ===
+  {
+    name: "get_connected_instances",
+    category: "read",
+    description: "List all connected plugin instances with their roles. Use during multi-client playtest to discover server and client instances for targeted commands.",
     inputSchema: {
       type: "object",
       properties: {}
@@ -3350,8 +3870,7 @@ var TOOL_DEFINITIONS = [
         style: {
           type: "string",
           enum: ["medieval", "modern", "nature", "scifi", "misc"],
-          description: "Style category for the build",
-          default: "misc"
+          description: "Style category for the build (default: misc)"
         }
       },
       required: ["instancePath"]
@@ -3382,7 +3901,6 @@ var TOOL_DEFINITIONS = [
           description: "Array of part arrays. Each: [posX, posY, posZ, sizeX, sizeY, sizeZ, rotX, rotY, rotZ, paletteKey, shape?, transparency?]. Shapes: Block (default), Wedge, Cylinder, Ball, CornerWedge.",
           items: {
             type: "array",
-            minItems: 10,
             items: {
               anyOf: [{ type: "number" }, { type: "string" }]
             }
@@ -3391,8 +3909,6 @@ var TOOL_DEFINITIONS = [
         bounds: {
           type: "array",
           items: { type: "number" },
-          minItems: 3,
-          maxItems: 3,
           description: "Optional bounding box [X, Y, Z]. Auto-computed if omitted."
         }
       },
@@ -3487,8 +4003,6 @@ part(0,2,0,2,1,1,"b")`,
         position: {
           type: "array",
           items: { type: "number" },
-          minItems: 3,
-          maxItems: 3,
           description: "World position offset [X, Y, Z]"
         }
       },
@@ -3523,8 +4037,7 @@ part(0,2,0,2,1,1,"b")`,
         },
         maxResults: {
           type: "number",
-          description: "Max results to return (default: 50)",
-          default: 50
+          description: "Max results to return (default: 50)"
         }
       }
     }
@@ -3570,38 +4083,28 @@ part(0,2,0,2,1,1,"b")`,
                     required: ["modelKey", "position"],
                     properties: {
                       modelKey: {
-                        type: "string",
-                        minLength: 1
+                        type: "string"
                       },
                       position: {
                         type: "array",
-                        items: { type: "number" },
-                        minItems: 3,
-                        maxItems: 3
+                        items: { type: "number" }
                       },
                       rotation: {
                         type: "array",
-                        items: { type: "number" },
-                        minItems: 3,
-                        maxItems: 3
+                        items: { type: "number" }
                       }
                     }
                   },
                   {
                     type: "array",
-                    minItems: 2,
-                    maxItems: 3,
                     items: {
                       anyOf: [
                         {
-                          type: "string",
-                          minLength: 1
+                          type: "string"
                         },
                         {
                           type: "array",
-                          items: { type: "number" },
-                          minItems: 3,
-                          maxItems: 3
+                          items: { type: "number" }
                         }
                       ]
                     }
@@ -3618,8 +4121,7 @@ part(0,2,0,2,1,1,"b")`,
         },
         targetPath: {
           type: "string",
-          description: "Parent instance path for the scene (default: game.Workspace)",
-          default: "game.Workspace"
+          description: "Parent instance path for the scene (default: game.Workspace)"
         }
       },
       required: ["sceneData"]
@@ -3644,19 +4146,16 @@ part(0,2,0,2,1,1,"b")`,
         },
         maxResults: {
           type: "number",
-          description: "Max results to return (default: 25)",
-          default: 25
+          description: "Max results to return (default: 25)"
         },
         sortBy: {
           type: "string",
           enum: ["Relevance", "Trending", "Top", "AudioDuration", "CreateTime", "UpdatedTime", "Ratings"],
-          description: "Sort order (default: Relevance)",
-          default: "Relevance"
+          description: "Sort order (default: Relevance)"
         },
         verifiedCreatorsOnly: {
           type: "boolean",
-          description: "Only show assets from verified creators",
-          default: false
+          description: "Only show assets from verified creators (default: false)"
         }
       },
       required: ["assetType"]
@@ -3691,8 +4190,7 @@ part(0,2,0,2,1,1,"b")`,
         size: {
           type: "string",
           enum: ["150x150", "420x420", "768x432"],
-          description: "Thumbnail size (default: 420x420)",
-          default: "420x420"
+          description: "Thumbnail size (default: 420x420)"
         }
       },
       required: ["assetId"]
@@ -3711,8 +4209,7 @@ part(0,2,0,2,1,1,"b")`,
         },
         parentPath: {
           type: "string",
-          description: "Parent instance path (default: game.Workspace)",
-          default: "game.Workspace"
+          description: "Parent instance path (default: game.Workspace)"
         },
         position: {
           type: "object",
@@ -3740,18 +4237,180 @@ part(0,2,0,2,1,1,"b")`,
         },
         includeProperties: {
           type: "boolean",
-          description: "Include detailed properties for each instance (default: true)",
-          default: true
+          description: "Include detailed properties for each instance (default: true)"
         },
         maxDepth: {
           type: "number",
-          description: "Max hierarchy traversal depth (default: 10)",
-          default: 10
+          description: "Max hierarchy traversal depth (default: 10)"
         }
       },
       required: ["assetId"]
     }
   },
+  {
+    name: "render_object_screenshot",
+    category: "write",
+    description: "Stage a renderable Studio object by instance path, frame it with a temporary camera, capture a screenshot, and optionally save the PNG to disk. Supports Models and BaseParts such as MeshPart.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        instancePath: {
+          type: "string",
+          description: "Target Studio instance path. Must resolve to a Model or BasePart such as MeshPart."
+        },
+        cameraPreset: {
+          type: "string",
+          enum: ["front", "isometric", "top", "icon"],
+          description: "Camera angle preset (default: isometric)"
+        },
+        padding: {
+          type: "number",
+          description: "Framing multiplier applied to the object bounds (default: 1.35)"
+        },
+        backdropColor: {
+          type: "array",
+          items: { type: "number" },
+          description: "Solid RGB backdrop color as [r, g, b] (default: [0,255,0])"
+        },
+        savePath: {
+          type: "string",
+          description: "Optional filesystem path where the PNG should be written"
+        },
+        outputDir: {
+          type: "string",
+          description: "Optional filesystem directory where the PNG should be written with an auto-generated filename"
+        },
+        fileName: {
+          type: "string",
+          description: "Optional file name to use when outputDir is provided (default: derived from the object name)"
+        },
+        returnImage: {
+          type: "boolean",
+          description: "Return the PNG image content in the MCP response (default: true)"
+        }
+      },
+      required: ["instancePath"]
+    }
+  },
+  {
+    name: "render_model_screenshot",
+    category: "write",
+    description: "Deprecated alias for render_object_screenshot. Stages a Model or BasePart from Studio by instance path, frames it with a temporary camera, captures a screenshot, and optionally saves the PNG to disk.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        instancePath: {
+          type: "string",
+          description: "Target Studio instance path. Must resolve to a Model or BasePart such as MeshPart."
+        },
+        cameraPreset: {
+          type: "string",
+          enum: ["front", "isometric", "top", "icon"],
+          description: "Camera angle preset (default: isometric)"
+        },
+        padding: {
+          type: "number",
+          description: "Framing multiplier applied to the model bounds (default: 1.35)"
+        },
+        backdropColor: {
+          type: "array",
+          items: { type: "number" },
+          description: "Solid RGB backdrop color as [r, g, b] (default: [0,255,0])"
+        },
+        savePath: {
+          type: "string",
+          description: "Optional filesystem path where the PNG should be written"
+        },
+        outputDir: {
+          type: "string",
+          description: "Optional filesystem directory where the PNG should be written with an auto-generated filename"
+        },
+        fileName: {
+          type: "string",
+          description: "Optional file name to use when outputDir is provided (default: derived from the object name)"
+        },
+        returnImage: {
+          type: "boolean",
+          description: "Return the PNG image content in the MCP response (default: true)"
+        }
+      },
+      required: ["instancePath"]
+    }
+  },
+  {
+    name: "batch_render_objects",
+    category: "write",
+    description: "Render all direct or descendant renderable objects under a Studio path and save PNGs plus a manifest to an output directory. Supports Models and BaseParts such as MeshPart.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        parentPath: {
+          type: "string",
+          description: "Studio path whose child or descendant Models/BaseParts should be rendered"
+        },
+        outputDir: {
+          type: "string",
+          description: "Filesystem directory for generated PNGs and manifest JSON"
+        },
+        recursive: {
+          type: "boolean",
+          description: "Recursively traverse nested folders/models (default: false)"
+        },
+        cameraPreset: {
+          type: "string",
+          enum: ["front", "isometric", "top", "icon"],
+          description: "Camera angle preset used for each render (default: isometric)"
+        },
+        padding: {
+          type: "number",
+          description: "Framing multiplier applied to each object bounds (default: 1.35)"
+        },
+        backdropColor: {
+          type: "array",
+          items: { type: "number" },
+          description: "Solid RGB backdrop color as [r, g, b] (default: [0,255,0])"
+        }
+      },
+      required: ["parentPath", "outputDir"]
+    }
+  },
+  {
+    name: "batch_render_models",
+    category: "write",
+    description: "Deprecated alias for batch_render_objects. Renders child Models/BaseParts under a Studio path and saves PNGs plus a manifest to an output directory.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        parentPath: {
+          type: "string",
+          description: "Studio path whose child or descendant Models/BaseParts should be rendered"
+        },
+        outputDir: {
+          type: "string",
+          description: "Filesystem directory for generated PNGs and manifest JSON"
+        },
+        recursive: {
+          type: "boolean",
+          description: "Recursively traverse nested folders/models (default: false)"
+        },
+        cameraPreset: {
+          type: "string",
+          enum: ["front", "isometric", "top", "icon"],
+          description: "Camera angle preset used for each render (default: isometric)"
+        },
+        padding: {
+          type: "number",
+          description: "Framing multiplier applied to each model bounds (default: 1.35)"
+        },
+        backdropColor: {
+          type: "array",
+          items: { type: "number" },
+          description: "Solid RGB backdrop color as [r, g, b] (default: [0,255,0])"
+        }
+      },
+      required: ["parentPath", "outputDir"]
+    }
+  },
   {
     name: "capture_screenshot",
     category: "read",
@@ -3760,6 +4419,150 @@ part(0,2,0,2,1,1,"b")`,
       type: "object",
       properties: {}
     }
+  },
+  // === Input Simulation ===
+  {
+    name: "simulate_mouse_input",
+    category: "write",
+    description: "Simulate mouse input in the Roblox Studio viewport via VirtualInputManager. Use during playtest to click UI buttons, interact with objects, or navigate menus. Coordinates are viewport pixels (top-left is 0,0). Use capture_screenshot to identify UI element positions before clicking.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["click", "mouseDown", "mouseUp", "move", "scroll"],
+          description: 'Mouse action to perform. "click" does mouseDown + short delay + mouseUp.'
+        },
+        x: {
+          type: "number",
+          description: "Viewport pixel X coordinate"
+        },
+        y: {
+          type: "number",
+          description: "Viewport pixel Y coordinate"
+        },
+        button: {
+          type: "string",
+          enum: ["Left", "Right", "Middle"],
+          description: "Mouse button (default: Left)"
+        },
+        scrollDirection: {
+          type: "string",
+          enum: ["up", "down"],
+          description: 'Scroll direction (only for "scroll" action)'
+        },
+        target: {
+          type: "string",
+          description: 'Instance target: "edit" (default), "server", "client-1", "client-2", etc.'
+        }
+      },
+      required: ["action", "x", "y"]
+    }
+  },
+  {
+    name: "simulate_keyboard_input",
+    category: "write",
+    description: 'Simulate keyboard input via VirtualInputManager. Use during playtest for character movement (W/A/S/D), jumping (Space), interactions (E), or any key-driven action. For sustained movement, use "press" to hold and "release" to let go.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        keyCode: {
+          type: "string",
+          description: 'Enum.KeyCode name: "W", "A", "S", "D", "Space", "E", "F", "LeftShift", "LeftControl", "Return", "Tab", "Escape", "One", "Two", etc.'
+        },
+        action: {
+          type: "string",
+          enum: ["press", "release", "tap"],
+          description: '"tap" (default) = press + wait + release. "press" = key down only. "release" = key up only.'
+        },
+        duration: {
+          type: "number",
+          description: 'Hold duration in seconds for "tap" action (default: 0.1). Use longer values for sustained input like walking.'
+        },
+        target: {
+          type: "string",
+          description: 'Instance target: "edit" (default), "server", "client-1", "client-2", etc.'
+        }
+      },
+      required: ["keyCode"]
+    }
+  },
+  // === Character Navigation ===
+  {
+    name: "character_navigation",
+    category: "write",
+    description: 'Move the player character to a target position or instance during playtest. Uses PathfindingService for automatic navigation around obstacles, falling back to direct movement. Requires an active playtest in "play" mode. Does NOT simulate player input \u2014 moves the character directly.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        position: {
+          type: "array",
+          items: { type: "number" },
+          description: "Target world position [x, y, z]. Either this or instancePath is required."
+        },
+        instancePath: {
+          type: "string",
+          description: "Instance to navigate to (dot notation). The character walks to its Position. Either this or position is required."
+        },
+        waitForCompletion: {
+          type: "boolean",
+          description: "Wait for the character to arrive before returning (default: true)"
+        },
+        timeout: {
+          type: "number",
+          description: "Max seconds to wait for navigation to complete (default: 25)"
+        },
+        target: {
+          type: "string",
+          description: 'Instance target: "edit" (default), "server", "client-1", "client-2", etc.'
+        }
+      }
+    }
+  },
+  // === Find and Replace ===
+  {
+    name: "find_and_replace_in_scripts",
+    category: "write",
+    description: "Find and replace text across all scripts in the game. Supports literal and Lua pattern matching. Use dryRun to preview changes before applying. Pairs with grep_scripts for search-only operations.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        pattern: {
+          type: "string",
+          description: "Text or Lua pattern to find"
+        },
+        replacement: {
+          type: "string",
+          description: "Replacement text. When usePattern is true, supports Lua captures (%1, %2, etc.)."
+        },
+        caseSensitive: {
+          type: "boolean",
+          description: "Case-sensitive matching (default: false). Must be true when usePattern is true."
+        },
+        usePattern: {
+          type: "boolean",
+          description: "Use Lua pattern matching instead of literal (default: false). Requires caseSensitive: true."
+        },
+        path: {
+          type: "string",
+          description: 'Limit scope to a subtree (e.g. "game.ServerScriptService")'
+        },
+        classFilter: {
+          type: "string",
+          enum: ["Script", "LocalScript", "ModuleScript"],
+          description: "Only search scripts of this class type"
+        },
+        dryRun: {
+          type: "boolean",
+          description: "Preview changes without applying them (default: false)"
+        },
+        maxReplacements: {
+          type: "number",
+          description: "Safety limit on total replacements (default: 1000)"
+        }
+      },
+      required: ["pattern", "replacement"]
+    }
   }
 ];
 var getAllTools = () => [...TOOL_DEFINITIONS];