@chrrxs/robloxstudio-mcp-inspector 2.10.0 → 2.11.0

package/dist/index.js

@@ -372,6 +372,9 @@ var init_http_server = __esm({
       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),
+      get_memory_breakdown: (tools, body) => tools.getMemoryBreakdown(body.target, body.tags),
+      export_rbxm: (tools, body) => tools.exportRbxm(body.instance_paths, body.output_path, body.target),
+      import_rbxm: (tools, body) => tools.importRbxm(body.source, body.parent_path, body.target),
       find_and_replace_in_scripts: (tools, body) => tools.findAndReplaceInScripts(body.pattern, body.replacement, {
         caseSensitive: body.caseSensitive,
         usePattern: body.usePattern,
@@ -1212,6 +1215,37 @@ function luaLongQuote(s) {
 ${s}
 ]${eq}]`;
 }
+function buildModuleScriptInvokeWrapper(opts) {
+  const wrapped = `return ((function()
+${opts.userCode}
+end)())`;
+  return `
+local HttpService = game:GetService("HttpService")
+local bf = game:GetService("${opts.service}"):FindFirstChild("${opts.bridgeName}")
+if not bf then
+	return HttpService:JSONEncode({
+		bridge = "missing",
+		error = ${luaLongQuote(opts.missingError)},
+	})
+end
+local USER_CODE = ${luaLongQuote(wrapped)}
+local m = Instance.new("ModuleScript")
+m.Name = "__MCPEvalPayload"
+local okSet, setErr = pcall(function() m.Source = USER_CODE end)
+if not okSet then
+	m:Destroy()
+	return HttpService:JSONEncode({ bridge = "ok", ok = false, result = "ModuleScript Source set failed: " .. tostring(setErr) })
+end
+m.Parent = workspace
+local ok, result = bf:Invoke(m)
+m:Destroy()
+return HttpService:JSONEncode({
+	bridge = "ok",
+	ok = ok,
+	result = if result == nil then nil else tostring(result),
+})
+`;
+}
 function parseBridgeResponse(response) {
   const r = response;
   if (r && typeof r.returnValue === "string") {
@@ -1771,23 +1805,12 @@ ${code}`
         if (!code) {
           throw new Error("Code is required for eval_server_runtime");
         }
-        const wrapper = `
-local HttpService = game:GetService("HttpService")
-local bf = game:GetService("ServerScriptService"):FindFirstChild("${SERVER_LOCAL_NAME}")
-if not bf then
-	return HttpService:JSONEncode({
-		bridge = "missing",
-		error = "ServerEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_server_runtime.",
-	})
-end
-local USER_CODE = ${luaLongQuote(code)}
-local ok, result = bf:Invoke(USER_CODE)
-return HttpService:JSONEncode({
-	bridge = "ok",
-	ok = ok,
-	result = if result == nil then nil else tostring(result),
-})
-`;
+        const wrapper = buildModuleScriptInvokeWrapper({
+          service: "ServerScriptService",
+          bridgeName: SERVER_LOCAL_NAME,
+          missingError: "ServerEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_server_runtime.",
+          userCode: code
+        });
         const response = await this.client.request("/api/execute-luau", { code: wrapper }, "server");
         return {
           content: [
@@ -1806,32 +1829,12 @@ return HttpService:JSONEncode({
         if (!clientTarget.startsWith("client-")) {
           throw new Error(`eval_client_runtime requires target=client-N (got: ${clientTarget})`);
         }
-        const wrapper = `
-local HttpService = game:GetService("HttpService")
-local bf = game:GetService("ReplicatedStorage"):FindFirstChild("${CLIENT_LOCAL_NAME}")
-if not bf then
-	return HttpService:JSONEncode({
-		bridge = "missing",
-		error = "ClientEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_client_runtime.",
-	})
-end
-local USER_CODE = ${luaLongQuote(code)}
-local m = Instance.new("ModuleScript")
-m.Name = "__MCPEvalPayload"
-local okSet, setErr = pcall(function() m.Source = USER_CODE end)
-if not okSet then
-	m:Destroy()
-	return HttpService:JSONEncode({ bridge = "ok", ok = false, result = "ModuleScript Source set failed: " .. tostring(setErr) })
-end
-m.Parent = workspace
-local ok, result = bf:Invoke(m)
-m:Destroy()
-return HttpService:JSONEncode({
-	bridge = "ok",
-	ok = ok,
-	result = if result == nil then nil else tostring(result),
-})
-`;
+        const wrapper = buildModuleScriptInvokeWrapper({
+          service: "ReplicatedStorage",
+          bridgeName: CLIENT_LOCAL_NAME,
+          missingError: "ClientEvalBridge not installed. Bridges are auto-installed at start_playtest and removed at stop_playtest. Start a playtest before calling eval_client_runtime.",
+          userCode: code
+        });
         const response = await this.client.request("/api/execute-luau", { code: wrapper }, clientTarget);
         return {
           content: [
@@ -2777,6 +2780,139 @@ return HttpService:JSONEncode({
           }]
         };
       }
+      async getMemoryBreakdown(target, tags) {
+        const tgt = target ?? "all";
+        const data = {};
+        if (tags !== void 0)
+          data.tags = tags;
+        if (tgt !== "all") {
+          const response = await this.client.request("/api/get-memory-breakdown", data, tgt);
+          return { content: [{ type: "text", text: JSON.stringify(response) }] };
+        }
+        const targets = this.bridge.getInstances().filter((i) => i.role !== "edit-proxy").map((i) => i.role);
+        const responses = await Promise.allSettled(targets.map(async (t) => ({
+          peer: t,
+          result: await this.client.request("/api/get-memory-breakdown", data, t)
+        })));
+        const body = {};
+        for (let i = 0; i < responses.length; i++) {
+          const r = responses[i];
+          const peer = targets[i];
+          if (r.status === "fulfilled") {
+            body[peer] = r.value.result;
+          } else {
+            body[peer] = { error: "disconnected" };
+          }
+        }
+        return { content: [{ type: "text", text: JSON.stringify(body) }] };
+      }
+      async exportRbxm(instancePaths, outputPath, target) {
+        if (!Array.isArray(instancePaths) || instancePaths.length === 0) {
+          throw new Error("instance_paths must be a non-empty array for export_rbxm");
+        }
+        if (!outputPath || typeof outputPath !== "string") {
+          throw new Error("output_path is required for export_rbxm");
+        }
+        const tgt = target || "edit";
+        if (tgt !== "edit" && tgt !== "server") {
+          throw new Error(`export_rbxm target must be "edit" or "server" (got: ${tgt})`);
+        }
+        const response = await this.client.request("/api/export-rbxm", { instance_paths: instancePaths }, tgt);
+        if (response.error) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: response.error }) }] };
+        }
+        if (!response.base64) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "plugin returned no base64 payload" }) }] };
+        }
+        const bytes = Buffer.from(response.base64, "base64");
+        const resolved = path.resolve(outputPath);
+        try {
+          fs.mkdirSync(path.dirname(resolved), { recursive: true });
+          fs.writeFileSync(resolved, bytes);
+        } catch (err) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: `failed to write ${resolved}: ${err.message}` }) }] };
+        }
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              bytes_written: bytes.length,
+              instance_count: response.instance_count ?? instancePaths.length,
+              output_path: resolved
+            })
+          }]
+        };
+      }
+      async importRbxm(source, parentPath, target) {
+        if (!source || typeof source !== "object") {
+          throw new Error("source is required for import_rbxm");
+        }
+        if (!parentPath || typeof parentPath !== "string") {
+          throw new Error("parent_path is required for import_rbxm");
+        }
+        const tgt = target || "edit";
+        if (tgt !== "edit" && tgt !== "server") {
+          throw new Error(`import_rbxm target must be "edit" or "server" (got: ${tgt})`);
+        }
+        const modes = ["path", "url", "base64"].filter((k) => source[k] !== void 0);
+        if (modes.length !== 1) {
+          throw new Error(`source must contain exactly one of { path, url, base64 } (got: ${modes.join(", ") || "none"})`);
+        }
+        let bytes;
+        let sourceLabel;
+        if (source.path !== void 0) {
+          const resolved = path.resolve(source.path);
+          try {
+            bytes = fs.readFileSync(resolved);
+          } catch (err) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `failed to read ${resolved}: ${err.message}` }) }] };
+          }
+          sourceLabel = resolved;
+        } else if (source.url !== void 0) {
+          let parsedUrl;
+          try {
+            parsedUrl = new URL(source.url);
+          } catch {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `import_rbxm url is not a valid URL: ${source.url}` }) }] };
+          }
+          if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `import_rbxm url must use http(s); got ${parsedUrl.protocol}` }) }] };
+          }
+          const MAX_IMPORT_BYTES = 50 * 1024 * 1024;
+          try {
+            const res = await fetch(source.url);
+            if (!res.ok) {
+              const snippet = (await res.text()).slice(0, 500);
+              return { content: [{ type: "text", text: JSON.stringify({ error: `fetch ${source.url} returned ${res.status}: ${snippet}` }) }] };
+            }
+            const claimed = Number(res.headers.get("content-length") ?? "0");
+            if (claimed > MAX_IMPORT_BYTES) {
+              return { content: [{ type: "text", text: JSON.stringify({ error: `fetch ${source.url}: content-length ${claimed} exceeds ${MAX_IMPORT_BYTES} byte cap` }) }] };
+            }
+            const arr = await res.arrayBuffer();
+            if (arr.byteLength > MAX_IMPORT_BYTES) {
+              return { content: [{ type: "text", text: JSON.stringify({ error: `fetch ${source.url}: downloaded ${arr.byteLength} bytes exceeds ${MAX_IMPORT_BYTES} byte cap` }) }] };
+            }
+            bytes = Buffer.from(arr);
+          } catch (err) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `fetch ${source.url} failed: ${err.message}` }) }] };
+          }
+          sourceLabel = source.url;
+        } else {
+          try {
+            bytes = Buffer.from(source.base64, "base64");
+          } catch (err) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `base64 decode failed: ${err.message}` }) }] };
+          }
+          sourceLabel = `base64(${bytes.length}B)`;
+        }
+        const response = await this.client.request("/api/import-rbxm", {
+          base64: bytes.toString("base64"),
+          parent_path: parentPath,
+          source_label: sourceLabel
+        }, tgt);
+        return { content: [{ type: "text", text: JSON.stringify(response) }] };
+      }
       async captureScreenshot() {
         const response = await this.client.request("/api/capture-screenshot", {});
         if (response.error) {
@@ -3909,7 +4045,7 @@ var init_definitions = __esm({
       {
         name: "eval_server_runtime",
         category: "write",
-        description: "Execute Luau on the server peer in the running game's Script VM (shares require cache with user game scripts). Use this instead of execute_luau target=server when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest. Requires ServerScriptService.LoadStringEnabled=true.",
+        description: "Execute Luau on the server peer in the running game's Script VM (shares require cache with user game scripts). Use this instead of execute_luau target=server when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest.",
         inputSchema: {
           type: "object",
           properties: {
@@ -3924,7 +4060,7 @@ var init_definitions = __esm({
       {
         name: "eval_client_runtime",
         category: "write",
-        description: "Execute Luau on a client peer in the running game's LocalScript VM (shares require cache with user game scripts). Use this instead of execute_luau target=client-N when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest. Does not require LoadStringEnabled.",
+        description: "Execute Luau on a client peer in the running game's LocalScript VM (shares require cache with user game scripts). Use this instead of execute_luau target=client-N when you need to see runtime-mutated module state. Auto-installed at start_playtest, removed at stop_playtest.",
         inputSchema: {
           type: "object",
           properties: {
@@ -4746,6 +4882,86 @@ part(0,2,0,2,1,1,"b")`,
           required: ["instancePath", "attributes"]
         }
       },
+      // === Per-peer memory breakdown ===
+      {
+        name: "get_memory_breakdown",
+        category: "read",
+        description: `Read per-category memory usage by iterating Enum.DeveloperMemoryTag and calling Stats:GetMemoryUsageMbForTag per item (workaround for Stats:GetMemoryUsageMbAllCategories being gated by Capabilities: InternalTest and not callable from plugin context), plus Stats:GetTotalMemoryUsageMb for the rollup. target="all" (default) returns { peer: { total_mb, categories, timestamp } } for every connected peer except edit-proxy; single-peer targets return that peer's object directly. Optional tags whitelist filters to only those DeveloperMemoryTag entries; unknown tags come back with value 0 and are listed in unknown_tags so cross-version drift doesn't error. timestamp is Unix milliseconds (DateTime.now().UnixTimestampMillis). Per-peer MemoryTrackingEnabled=false surfaces as { error } on that peer only.`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            target: {
+              type: "string",
+              description: 'Peer to read from: "edit", "server", "client-N", or "all" (default).'
+            },
+            tags: {
+              type: "array",
+              items: { type: "string" },
+              description: "Optional DeveloperMemoryTag whitelist. Unknown tag names return 0 + unknown_tags list."
+            }
+          }
+        }
+      },
+      // === SerializationService round-trip ===
+      {
+        name: "export_rbxm",
+        category: "read",
+        description: "Serialize one or more instances to a .rbxm file on disk via SerializationService:SerializeInstancesAsync (engine v668+, PluginSecurity). Throws if any path resolves to nil, a service, or a non-creatable instance.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            instance_paths: {
+              type: "array",
+              items: { type: "string" },
+              description: 'DataModel paths to serialize (e.g. ["Workspace.TestRig", "ServerStorage.Templates.NPC"])'
+            },
+            output_path: {
+              type: "string",
+              description: "Absolute filesystem path where the .rbxm should be written"
+            },
+            target: {
+              type: "string",
+              enum: ["edit", "server"],
+              description: 'Which DataModel to read from (default: "edit"). "server" serializes live runtime state during a playtest.'
+            }
+          },
+          required: ["instance_paths", "output_path"]
+        }
+      },
+      {
+        name: "import_rbxm",
+        category: "write",
+        description: "Deserialize a .rbxm via SerializationService:DeserializeInstancesAsync (engine v668+, PluginSecurity) and parent the resulting instances under parent_path. All-or-nothing parenting: if any single instance fails to parent, every already-parented sibling is unparented and the call errors. Wrapped in ChangeHistoryService for edit target so one Ctrl+Z reverses the whole import.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            source: {
+              type: "object",
+              description: "Exactly one of { path }, { url }, or { base64 }. path = read from local disk; url = http(s) only, fetched by the MCP server process, capped at 50 MiB; base64 = raw bytes inline.",
+              properties: {
+                path: { type: "string" },
+                url: { type: "string" },
+                base64: { type: "string" }
+              },
+              oneOf: [
+                { required: ["path"] },
+                { required: ["url"] },
+                { required: ["base64"] }
+              ]
+            },
+            parent_path: {
+              type: "string",
+              description: 'DataModel path of the Instance to parent imported instances under (e.g. "ServerStorage.Imported")'
+            },
+            target: {
+              type: "string",
+              enum: ["edit", "server"],
+              description: 'Which DataModel to import into (default: "edit"). "server" parents into the live play-server DM.'
+            }
+          },
+          required: ["source", "parent_path"]
+        }
+      },
       // === Find and Replace ===
       {
         name: "find_and_replace_in_scripts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrrxs/robloxstudio-mcp-inspector",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Read-only MCP Server for Roblox Studio (fork of boshyxd/robloxstudio-mcp-inspector with per-peer execute_luau fixes baked in)",
   "main": "dist/index.js",
   "type": "module",