dominus-cli 0.5.3 → 0.5.5

package/dist/index.js

@@ -1180,13 +1180,17 @@ var init_get_properties = __esm({
     init_protocol();
     tool5 = {
       name: "get_properties",
-      description: "Get all properties of an instance in Roblox Studio by its path.",
+      description: "Get all properties of a single instance in Roblox Studio. By default uses compact mode which strips read-only, nil, deprecated, and default-valued properties. For inspecting UI trees, prefer serialize_ui or get_descendants_properties.",
       parameters: {
         type: "object",
         properties: {
           path: {
             type: "string",
             description: 'Full instance path (e.g., "Workspace.Part")'
+          },
+          compact: {
+            type: "boolean",
+            description: "Strip read-only, nil, deprecated, and default-valued properties (default true). Set false for full dump."
           }
         },
         required: ["path"]
@@ -1195,9 +1199,10 @@ var init_get_properties = __esm({
         if (!ctx.isStudioConnected()) {
           return { success: false, error: "Studio is not connected" };
         }
+        const compact = params.compact !== false;
         const response = await ctx.sendToStudio(
           CliMsg.GET_PROPERTIES,
-          { path: params.path }
+          { path: params.path, compact }
         );
         return { success: true, data: response.payload };
       }
@@ -2581,10 +2586,19 @@ async function startMcpServer() {
   }
   const mcp = new McpServer({
     name: "dominus",
-    version: "0.2.1"
+    version: "0.5.5"
   }, {
     instructions: INTERNAL_MEMORY
   });
+  function luaStr(s) {
+    return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r")}"`;
+  }
+  function resolvePath(dotPath) {
+    const parts = dotPath.split(".");
+    let r = "game";
+    for (const p of parts) r += `[${luaStr(p)}]`;
+    return r;
+  }
   mcp.tool(
     "read_script",
     "Read the source code of a script in Roblox Studio",
@@ -2636,11 +2650,14 @@ async function startMcpServer() {
   );
   mcp.tool(
     "get_properties",
-    "Get all properties of an instance in Roblox Studio",
-    { path: z.string().describe("Full instance path") },
-    async ({ path: path5 }) => {
+    "Get all properties of a single instance in Roblox Studio. Returns property name, value, type, and category. For inspecting UI trees, prefer serialize_ui (structured tree) or get_descendants_properties (flat list with compact filtering).",
+    {
+      path: z.string().describe('Full instance path (e.g. "Workspace.Part", "StarterGui.MyUI.Frame")'),
+      compact: z.boolean().optional().default(true).describe("Strip read-only, nil, deprecated, and default-valued properties (default true). Set false for full dump.")
+    },
+    async ({ path: path5, compact }) => {
       assertConnected();
-      const res = await bridge.sendRequest(CliMsg.GET_PROPERTIES, { path: path5 });
+      const res = await bridge.sendRequest(CliMsg.GET_PROPERTIES, { path: path5, compact });
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
   );
@@ -2856,16 +2873,10 @@ async function startMcpServer() {
     },
     async (params) => {
       assertConnected();
-      const parts = params.path.split(".");
-      let resolve = "game";
-      for (const p of parts) resolve += `["${p}"]`;
-      const lines = [`local orig = ${resolve}`, `local clone = orig:Clone()`];
-      if (params.newName) lines.push(`clone.Name = "${params.newName}"`);
+      const lines = [`local orig = ${resolvePath(params.path)}`, `local clone = orig:Clone()`];
+      if (params.newName) lines.push(`clone.Name = ${luaStr(params.newName)}`);
       if (params.newParent) {
-        const pp = params.newParent.split(".");
-        let pr = "game";
-        for (const p of pp) pr += `["${p}"]`;
-        lines.push(`clone.Parent = ${pr}`);
+        lines.push(`clone.Parent = ${resolvePath(params.newParent)}`);
       } else {
         lines.push(`clone.Parent = orig.Parent`);
       }
@@ -2881,7 +2892,7 @@ async function startMcpServer() {
   );
   mcp.tool(
     "group_instances",
-    "Group multiple instances into a Model or Folder",
+    "Group multiple instances into a Model or Folder. All listed instances become children of the new group.",
     {
       paths: z.array(z.string()).describe("Array of instance paths to group"),
       groupName: z.string().describe("Name for the group"),
@@ -2892,20 +2903,11 @@ async function startMcpServer() {
       assertConnected();
       const gc = params.groupClass ?? "Model";
       const parent = params.parent ?? "Workspace";
-      const parentParts = parent.split(".");
-      let parentResolve = "game";
-      for (const p of parentParts) parentResolve += `["${p}"]`;
-      const resolves = params.paths.map((path5) => {
-        const parts = path5.split(".");
-        let r = "game";
-        for (const part of parts) r += `["${part}"]`;
-        return r;
-      });
       const code = [
-        `local group = Instance.new("${gc}")`,
-        `group.Name = "${params.groupName}"`,
-        `group.Parent = ${parentResolve}`,
-        ...resolves.map((r) => `${r}.Parent = group`),
+        `local group = Instance.new(${luaStr(gc)})`,
+        `group.Name = ${luaStr(params.groupName)}`,
+        `group.Parent = ${resolvePath(parent)}`,
+        ...params.paths.map((p) => `${resolvePath(p)}.Parent = group`),
         `print("Grouped ${params.paths.length} instances into: " .. group:GetFullName())`
       ].join("\n");
       const res = await bridge.sendRequest(CliMsg.RUN_CODE, { code });
@@ -2914,7 +2916,7 @@ async function startMcpServer() {
   );
   mcp.tool(
     "build_multiple",
-    "Create many parts/instances in one batch. Send an array of specs \u2014 all created in a single round-trip. Ideal for building trees, houses, vehicles.",
+    "Create many parts/instances in one batch. Send an array of specs \u2014 all created in a single round-trip. Ideal for building trees, houses, vehicles. Supports hex colors, rgb() colors, and BrickColor names.",
     {
       parts: z.array(z.object({
         name: z.string(),
@@ -2922,10 +2924,11 @@ async function startMcpServer() {
         parent: z.string().optional(),
         position: z.object({ x: z.number(), y: z.number(), z: z.number() }).optional(),
         size: z.object({ x: z.number(), y: z.number(), z: z.number() }).optional(),
-        color: z.string().optional().describe('Hex "#RRGGBB" or BrickColor name'),
-        material: z.string().optional(),
+        color: z.string().optional().describe('Hex "#RRGGBB", "rgb(r,g,b)", or BrickColor name'),
+        material: z.string().optional().describe("Enum.Material name: Plastic, Wood, Neon, Glass, etc."),
         transparency: z.number().optional(),
         anchored: z.boolean().optional(),
+        canCollide: z.boolean().optional(),
         shape: z.enum(["Block", "Ball", "Cylinder", "Wedge"]).optional()
       })).describe("Array of part specifications"),
       groupName: z.string().optional().describe("Group all parts into a Model with this name"),
@@ -2936,35 +2939,36 @@ async function startMcpServer() {
       const parts = params.parts;
       const groupName = params.groupName;
       const groupParent = params.groupParent ?? "Workspace";
-      function resolveP(path5) {
-        const segs = path5.split(".");
-        let r = "game";
-        for (const s of segs) r += `["${s}"]`;
-        return r;
-      }
       const lines = [];
       if (groupName) {
         lines.push(`local _group = Instance.new("Model")`);
-        lines.push(`_group.Name = "${groupName}"`);
-        lines.push(`_group.Parent = ${resolveP(groupParent)}`);
+        lines.push(`_group.Name = ${luaStr(groupName)}`);
+        lines.push(`_group.Parent = ${resolvePath(groupParent)}`);
       }
       for (let i = 0; i < parts.length; i++) {
         const p = parts[i];
         const v = `_p${i}`;
         const cn = p.className ?? (p.shape === "Wedge" ? "WedgePart" : "Part");
-        lines.push(`local ${v} = Instance.new("${cn}")`);
-        lines.push(`${v}.Name = "${p.name}"`);
+        lines.push(`local ${v} = Instance.new(${luaStr(cn)})`);
+        lines.push(`${v}.Name = ${luaStr(p.name)}`);
         if (p.position) lines.push(`${v}.Position = Vector3.new(${p.position.x}, ${p.position.y}, ${p.position.z})`);
         if (p.size) lines.push(`${v}.Size = Vector3.new(${p.size.x}, ${p.size.y}, ${p.size.z})`);
         if (p.color) {
-          if (p.color.startsWith("#")) lines.push(`${v}.Color = Color3.fromHex("${p.color}")`);
-          else lines.push(`${v}.BrickColor = BrickColor.new("${p.color}")`);
+          if (p.color.startsWith("#")) {
+            lines.push(`${v}.Color = Color3.fromHex(${luaStr(p.color)})`);
+          } else if (p.color.startsWith("rgb(")) {
+            const m = p.color.match(/rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/);
+            if (m) lines.push(`${v}.Color = Color3.fromRGB(${m[1]}, ${m[2]}, ${m[3]})`);
+          } else {
+            lines.push(`${v}.BrickColor = BrickColor.new(${luaStr(p.color)})`);
+          }
         }
         if (p.material) lines.push(`${v}.Material = Enum.Material.${p.material}`);
         if (p.transparency !== void 0) lines.push(`${v}.Transparency = ${p.transparency}`);
         lines.push(`${v}.Anchored = ${p.anchored ?? true}`);
+        if (p.canCollide !== void 0) lines.push(`${v}.CanCollide = ${p.canCollide}`);
         if (p.shape && p.shape !== "Block" && cn === "Part") lines.push(`${v}.Shape = Enum.PartType.${p.shape}`);
-        lines.push(`${v}.Parent = ${groupName ? "_group" : resolveP(p.parent ?? "Workspace")}`);
+        lines.push(`${v}.Parent = ${groupName ? "_group" : resolvePath(p.parent ?? "Workspace")}`);
       }
       lines.push(`print("Built ${parts.length} parts${groupName ? ` in ${groupName}` : ""}")`);
       const res = await bridge.sendRequest(CliMsg.RUN_CODE, { code: lines.join("\n") });
@@ -2991,6 +2995,184 @@ async function startMcpServer() {
       return { content: [{ type: "text", text: JSON.stringify(res.payload.tree, null, 2) }] };
     }
   );
+  mcp.tool(
+    "move_instance",
+    "Move (reparent) an instance to a new parent in Roblox Studio. Preserves the instance and all descendants \u2014 much better than delete + recreate. Sets a ChangeHistoryService waypoint so the move can be undone.",
+    {
+      path: z.string().describe('Full path of the instance to move (e.g. "Workspace.OldFolder.MyPart")'),
+      newParent: z.string().describe('Full path of the new parent (e.g. "Workspace.NewFolder")')
+    },
+    async ({ path: path5, newParent }) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.MOVE_INSTANCE,
+        { path: path5, newParent }
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "bulk_set_properties",
+    "Set properties on multiple instances at once in a single call. Much faster than calling set_properties repeatedly. Two modes:\n1. Explicit: provide targets array of {path, properties} objects\n2. Filter: provide root + className + properties to apply to all matches",
+    {
+      targets: z.array(z.object({
+        path: z.string(),
+        properties: z.record(z.unknown())
+      })).optional().describe("Array of {path, properties} for explicit mode"),
+      root: z.string().optional().describe("Root path to search under (filter mode)"),
+      className: z.string().optional().describe("Only apply to instances of this ClassName (filter mode)"),
+      properties: z.record(z.unknown()).optional().describe("Properties to set on all matches (filter mode)")
+    },
+    async (params) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.BULK_SET_PROPERTIES,
+        {
+          targets: params.targets,
+          root: params.root,
+          className: params.className,
+          properties: params.properties
+        },
+        1e3 * 60
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "find_replace_scripts",
+    "Find and replace text across all scripts in the game (or under a root path). Supports plain text and Lua patterns. Use dryRun=true to preview changes without applying.",
+    {
+      find: z.string().describe("Text or Lua pattern to search for"),
+      replace: z.string().describe("Replacement text (supports Lua pattern captures like %1, %2)"),
+      root: z.string().optional().describe("Root path to limit search scope (optional)"),
+      usePattern: z.boolean().optional().default(false).describe("Treat find/replace as Lua patterns"),
+      dryRun: z.boolean().optional().default(false).describe("Preview matches without modifying scripts")
+    },
+    async (params) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.FIND_REPLACE_SCRIPTS,
+        {
+          find: params.find,
+          replace: params.replace,
+          root: params.root,
+          usePattern: params.usePattern,
+          dryRun: params.dryRun
+        },
+        1e3 * 60 * 5
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "undo",
+    "Undo the last action in Roblox Studio (ChangeHistoryService). Works like Ctrl+Z. Use to roll back mistakes.",
+    {},
+    async () => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.UNDO, {});
+      return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
+    }
+  );
+  mcp.tool(
+    "redo",
+    "Redo the last undone action in Roblox Studio (ChangeHistoryService). Works like Ctrl+Y.",
+    {},
+    async () => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.REDO, {});
+      return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
+    }
+  );
+  mcp.tool(
+    "move_instance",
+    "Move (reparent) an instance to a new parent in Roblox Studio. Preserves the instance and all descendants \u2014 much better than delete + recreate. Sets a ChangeHistoryService waypoint so the move can be undone.",
+    {
+      path: z.string().describe('Full path of the instance to move (e.g. "Workspace.OldFolder.MyPart")'),
+      newParent: z.string().describe('Full path of the new parent (e.g. "Workspace.NewFolder")')
+    },
+    async ({ path: path5, newParent }) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.MOVE_INSTANCE,
+        { path: path5, newParent }
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "bulk_set_properties",
+    "Set properties on multiple instances at once in a single call. Much faster than calling set_properties repeatedly. Two modes:\n1. Explicit: provide targets array of {path, properties} objects\n2. Filter: provide root + className + properties to apply to all matches",
+    {
+      targets: z.array(z.object({
+        path: z.string(),
+        properties: z.record(z.unknown())
+      })).optional().describe("Array of {path, properties} for explicit mode"),
+      root: z.string().optional().describe("Root path to search under (filter mode)"),
+      className: z.string().optional().describe("Only apply to instances of this ClassName (filter mode)"),
+      properties: z.record(z.unknown()).optional().describe("Properties to set on all matches (filter mode)")
+    },
+    async (params) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.BULK_SET_PROPERTIES,
+        {
+          targets: params.targets,
+          root: params.root,
+          className: params.className,
+          properties: params.properties
+        },
+        1e3 * 60
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "find_replace_scripts",
+    "Find and replace text across all scripts in the game (or under a root path). Supports plain text and Lua patterns. Use dryRun=true to preview changes without applying.",
+    {
+      find: z.string().describe("Text or Lua pattern to search for"),
+      replace: z.string().describe("Replacement text (supports Lua pattern captures like %1, %2)"),
+      root: z.string().optional().describe("Root path to limit search scope (optional)"),
+      usePattern: z.boolean().optional().default(false).describe("Treat find/replace as Lua patterns"),
+      dryRun: z.boolean().optional().default(false).describe("Preview matches without modifying scripts")
+    },
+    async (params) => {
+      assertConnected();
+      const res = await bridge.sendRequest(
+        CliMsg.FIND_REPLACE_SCRIPTS,
+        {
+          find: params.find,
+          replace: params.replace,
+          root: params.root,
+          usePattern: params.usePattern,
+          dryRun: params.dryRun
+        },
+        1e3 * 60 * 5
+      );
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
+  mcp.tool(
+    "undo",
+    "Undo the last action in Roblox Studio (ChangeHistoryService). Works like Ctrl+Z. Use to roll back mistakes.",
+    {},
+    async () => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.UNDO, {});
+      return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
+    }
+  );
+  mcp.tool(
+    "redo",
+    "Redo the last undone action in Roblox Studio (ChangeHistoryService). Works like Ctrl+Y.",
+    {},
+    async () => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.REDO, {});
+      return { content: [{ type: "text", text: JSON.stringify(res.payload) }] };
+    }
+  );
   mcp.tool(
     "recall_memory",
     "Search persistent memory for facts about the current Roblox project",