dominus-cli 0.2.1 → 0.5.1

package/dist/index.js

@@ -19,6 +19,7 @@ import { randomBytes } from 'crypto';
 import Spinner from 'ink-spinner';
 import OpenAI from 'openai';
 import https from 'https';
+import { fileURLToPath } from 'url';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -221,6 +222,7 @@ var init_protocol = __esm({
       SET_SCRIPT: "cli:set:script",
       RUN_CODE: "cli:run",
       GET_PROPERTIES: "cli:get:properties",
+      GET_DESCENDANTS_PROPERTIES: "cli:get:descendants:properties",
       SET_PROPERTIES: "cli:set:properties",
       INSERT_INSTANCE: "cli:insert",
       DELETE_INSTANCE: "cli:delete",
@@ -234,7 +236,13 @@ var init_protocol = __esm({
       END_TEST: "cli:test:end",
       BUILD_UI: "cli:build:ui",
       GET_REFLECTION: "cli:get:reflection",
-      UPLOAD_ASSET: "cli:upload:asset"
+      UPLOAD_ASSET: "cli:upload:asset",
+      SERIALIZE_UI: "cli:serialize:ui",
+      MOVE_INSTANCE: "cli:move:instance",
+      UNDO: "cli:undo",
+      REDO: "cli:redo",
+      BULK_SET_PROPERTIES: "cli:bulk:set:properties",
+      FIND_REPLACE_SCRIPTS: "cli:find:replace:scripts"
     };
   }
 });
@@ -1119,16 +1127,65 @@ var init_get_properties = __esm({
   }
 });
 
+// src/tools/studio/get-descendants-properties.ts
+var get_descendants_properties_exports = {};
+__export(get_descendants_properties_exports, {
+  tool: () => tool6
+});
+var tool6;
+var init_get_descendants_properties = __esm({
+  "src/tools/studio/get-descendants-properties.ts"() {
+    init_protocol();
+    tool6 = {
+      name: "get_descendants_properties",
+      description: "Easily get all descendants of a UI instance (or any instance) and all of their properties.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Full instance path (e.g., "Workspace.Part", "StarterGui.ScreenGui")'
+          },
+          outputFile: {
+            type: "string",
+            description: "Optional file path to write the JSON result to, useful for very large trees where context limits apply."
+          }
+        },
+        required: ["path"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(
+          CliMsg.GET_DESCENDANTS_PROPERTIES,
+          { path: params.path },
+          1e3 * 60 * 5
+          // 5 minute timeout since getting ALL descendants can take a very long time
+        );
+        if (params.outputFile && typeof params.outputFile === "string") {
+          const fs6 = await import('fs/promises');
+          const path5 = await import('path');
+          const outputPath = path5.resolve(process.cwd(), params.outputFile);
+          await fs6.writeFile(outputPath, JSON.stringify(response.payload, null, 2), "utf-8");
+          return { success: true, data: `Successfully saved descendants to ${outputPath}` };
+        }
+        return { success: true, data: response.payload };
+      }
+    };
+  }
+});
+
 // src/tools/studio/set-properties.ts
 var set_properties_exports = {};
 __export(set_properties_exports, {
-  tool: () => tool6
+  tool: () => tool7
 });
-var tool6;
+var tool7;
 var init_set_properties = __esm({
   "src/tools/studio/set-properties.ts"() {
     init_protocol();
-    tool6 = {
+    tool7 = {
       name: "set_properties",
       description: "Set properties on an instance in Roblox Studio.",
       parameters: {
@@ -1166,13 +1223,13 @@ var init_set_properties = __esm({
 // src/tools/studio/insert-instance.ts
 var insert_instance_exports = {};
 __export(insert_instance_exports, {
-  tool: () => tool7
+  tool: () => tool8
 });
-var tool7;
+var tool8;
 var init_insert_instance = __esm({
   "src/tools/studio/insert-instance.ts"() {
     init_protocol();
-    tool7 = {
+    tool8 = {
       name: "insert_instance",
       description: "Insert a new instance into the Roblox Studio DataModel.",
       parameters: {
@@ -1220,13 +1277,13 @@ var init_insert_instance = __esm({
 // src/tools/studio/delete-instance.ts
 var delete_instance_exports = {};
 __export(delete_instance_exports, {
-  tool: () => tool8
+  tool: () => tool9
 });
-var tool8;
+var tool9;
 var init_delete_instance = __esm({
   "src/tools/studio/delete-instance.ts"() {
     init_protocol();
-    tool8 = {
+    tool9 = {
       name: "delete_instance",
       description: "Delete an instance from the Roblox Studio DataModel by path.",
       parameters: {
@@ -1257,13 +1314,13 @@ var init_delete_instance = __esm({
 // src/tools/studio/get-output.ts
 var get_output_exports = {};
 __export(get_output_exports, {
-  tool: () => tool9
+  tool: () => tool10
 });
-var tool9;
+var tool10;
 var init_get_output = __esm({
   "src/tools/studio/get-output.ts"() {
     init_protocol();
-    tool9 = {
+    tool10 = {
       name: "get_output",
       description: "Get recent output log entries from Roblox Studio (prints, warnings, errors).",
       parameters: {
@@ -1298,13 +1355,13 @@ var init_get_output = __esm({
 // src/tools/studio/get-selection.ts
 var get_selection_exports = {};
 __export(get_selection_exports, {
-  tool: () => tool10
+  tool: () => tool11
 });
-var tool10;
+var tool11;
 var init_get_selection = __esm({
   "src/tools/studio/get-selection.ts"() {
     init_protocol();
-    tool10 = {
+    tool11 = {
       name: "get_selection",
       description: "Get the currently selected instances in Roblox Studio.",
       parameters: {
@@ -1325,13 +1382,13 @@ var init_get_selection = __esm({
 // src/tools/studio/search-scripts.ts
 var search_scripts_exports = {};
 __export(search_scripts_exports, {
-  tool: () => tool11
+  tool: () => tool12
 });
-var tool11;
+var tool12;
 var init_search_scripts = __esm({
   "src/tools/studio/search-scripts.ts"() {
     init_protocol();
-    tool11 = {
+    tool12 = {
       name: "search_scripts",
       description: "Search across all scripts in Roblox Studio for a text pattern. Returns matching lines with context.",
       parameters: {
@@ -1366,13 +1423,13 @@ var init_search_scripts = __esm({
 // src/tools/studio/run-tests.ts
 var run_tests_exports = {};
 __export(run_tests_exports, {
-  tool: () => tool12
+  tool: () => tool13
 });
-var tool12;
+var tool13;
 var init_run_tests = __esm({
   "src/tools/studio/run-tests.ts"() {
     init_protocol();
-    tool12 = {
+    tool13 = {
       name: "run_tests",
       description: "Run tests in Roblox Studio using StudioTestService. Can run all tests or a specific test by name.",
       parameters: {
@@ -1406,13 +1463,13 @@ var init_run_tests = __esm({
 // src/tools/studio/get-class-info.ts
 var get_class_info_exports = {};
 __export(get_class_info_exports, {
-  tool: () => tool13
+  tool: () => tool14
 });
-var tool13;
+var tool14;
 var init_get_class_info = __esm({
   "src/tools/studio/get-class-info.ts"() {
     init_protocol();
-    tool13 = {
+    tool14 = {
       name: "get_class_info",
       description: "Look up the full schema of a Roblox class using ReflectionService. Returns all properties (with their types), methods (with parameters), and events. ALWAYS call this before creating or modifying GUI/UI elements (Frame, TextLabel, ImageLabel, etc.) to know the correct property names and expected types (e.g., Size is UDim2 for GUI, Vector3 for Parts).",
       parameters: {
@@ -1443,13 +1500,13 @@ var init_get_class_info = __esm({
 // src/tools/studio/create-ui.ts
 var create_ui_exports = {};
 __export(create_ui_exports, {
-  tool: () => tool14
+  tool: () => tool15
 });
-var tool14;
+var tool15;
 var init_create_ui = __esm({
   "src/tools/studio/create-ui.ts"() {
     init_protocol();
-    tool14 = {
+    tool15 = {
       name: "create_ui",
       description: 'Create an entire UI tree in Roblox Studio in a SINGLE call. Pass a declarative JSON tree with ClassName, Name, properties, and Children. All types are auto-coerced natively in Luau \u2014 UDim2, Color3, Font, enums all work. This is 10x faster than run_code for UI because it handles everything in one round-trip with no Luau syntax issues. Replaces any existing instance with the same name.\n\nExample: create a pastel hello world screen:\n{\n  "parent": "StarterGui",\n  "tree": {\n    "ClassName": "ScreenGui",\n    "Name": "HelloWorld",\n    "ResetOnSpawn": false,\n    "Children": [{\n      "ClassName": "Frame",\n      "Name": "Background",\n      "Size": [1, 0, 1, 0],\n      "BackgroundColor3": "#F0E6FF",\n      "Children": [\n        { "ClassName": "UICorner", "CornerRadius": [0, 12] },\n        { "ClassName": "TextLabel", "Name": "Title", "Text": "Hello World!",\n          "Size": [0.5, 0, 0.1, 0], "Position": [0.25, 0, 0.45, 0],\n          "BackgroundTransparency": 1, "TextColor3": "#6C5CE7",\n          "TextScaled": true, "Font": "GothamBold" }\n      ]\n    }]\n  }\n}',
       parameters: {
@@ -1461,7 +1518,11 @@ var init_create_ui = __esm({
           },
           tree: {
             type: "object",
-            description: 'The root UI node. Each node has: ClassName (string), Name (string), any properties as key-value pairs, and Children (array of child nodes). Property values are auto-coerced:\n  UDim2: [xScale, xOffset, yScale, yOffset] or {XScale, XOffset, YScale, YOffset}\n  Color3: "#hex", "rgb(r,g,b)", [r,g,b], or BrickColor name\n  UDim: [scale, offset] or number\n  Vector2: {x, y} or [x, y]\n  Font: "GothamBold", "SourceSans", etc. (Enum.Font names)\n  Enums: string name like "Center", "Left", "Fit"\n  FontFace: {Family, Weight, Style}'
+            description: 'The root UI node. Each node has: ClassName (string), Name (string), any properties as key-value pairs, and Children (array of child nodes). Property values are auto-coerced:\n  UDim2: [xScale, xOffset, yScale, yOffset] or {XScale, XOffset, YScale, YOffset}\n  Color3: "#hex", "rgb(r,g,b)", [r,g,b], or BrickColor name\n  UDim: [scale, offset] or number\n  Vector2: [x, y] or {x, y} (auto-disambiguated from UDim by property name)\n  NumberRange: [min, max] or number\n  Rect: [minX, minY, maxX, maxY] or {MinX, MinY, MaxX, MaxY}\n  Font: "GothamBold", "SourceSans", etc. (Enum.Font names)\n  Enums: string name like "Center", "Left", "Fit"\n  FontFace: {Family, Weight, Style}\n  2-element arrays are auto-disambiguated: AnchorPoint\u2192Vector2, CornerRadius/Padding\u2192UDim, etc.'
+          },
+          animate: {
+            type: "boolean",
+            description: "If true, task.wait() will be injected between creation of nodes so that the UI writes out dynamically."
           }
         },
         required: ["tree"]
@@ -1472,6 +1533,7 @@ var init_create_ui = __esm({
         }
         const response = await ctx.sendToStudio(CliMsg.BUILD_UI, {
           parent: params.parent ?? "StarterGui",
+          animate: params.animate,
           tree: params.tree
         });
         const payload = response.payload;
@@ -1490,13 +1552,13 @@ var init_create_ui = __esm({
 // src/tools/studio/execute-run-test.ts
 var execute_run_test_exports = {};
 __export(execute_run_test_exports, {
-  tool: () => tool15
+  tool: () => tool16
 });
-var tool15;
+var tool16;
 var init_execute_run_test = __esm({
   "src/tools/studio/execute-run-test.ts"() {
     init_protocol();
-    tool15 = {
+    tool16 = {
       name: "execute_run_test",
       description: "Start a Run mode test session in Roblox Studio using StudioTestService:ExecuteRunModeAsync(). Passes args that server scripts can retrieve via GetTestArgs(). Yields until the session ends (via EndTest or manual stop). Returns the value passed to EndTest(). Use this for headless automated tests \u2014 no player character, just server scripts running.",
       parameters: {
@@ -1535,13 +1597,13 @@ var init_execute_run_test = __esm({
 // src/tools/studio/execute-play-test.ts
 var execute_play_test_exports = {};
 __export(execute_play_test_exports, {
-  tool: () => tool16
+  tool: () => tool17
 });
-var tool16;
+var tool17;
 var init_execute_play_test = __esm({
   "src/tools/studio/execute-play-test.ts"() {
     init_protocol();
-    tool16 = {
+    tool17 = {
       name: "execute_play_test",
       description: "Start a solo Play mode test session in Roblox Studio using StudioTestService:ExecutePlayModeAsync(). Passes args that server scripts can retrieve via GetTestArgs(). Yields until the session ends (via EndTest or manual stop). Returns the value passed to EndTest(). Use this for tests that need a player character and full client-server simulation.",
       parameters: {
@@ -1580,13 +1642,13 @@ var init_execute_play_test = __esm({
 // src/tools/studio/create-part.ts
 var create_part_exports = {};
 __export(create_part_exports, {
-  tool: () => tool17
+  tool: () => tool18
 });
-var tool17;
+var tool18;
 var init_create_part = __esm({
   "src/tools/studio/create-part.ts"() {
     init_protocol();
-    tool17 = {
+    tool18 = {
       name: "create_part",
       description: "Create a Part in Roblox Studio with position, size, color, material and more \u2014 all in one call. Much faster than insert_instance + set_properties separately.",
       parameters: {
@@ -1679,7 +1741,7 @@ var init_create_part = __esm({
 // src/tools/studio/clone-instance.ts
 var clone_instance_exports = {};
 __export(clone_instance_exports, {
-  tool: () => tool18
+  tool: () => tool19
 });
 function buildCloneCode(params) {
   const path5 = params.path;
@@ -1714,11 +1776,11 @@ function buildCloneCode(params) {
   lines.push(`print("Cloned: " .. clone:GetFullName())`);
   return lines.join("\n");
 }
-var tool18;
+var tool19;
 var init_clone_instance = __esm({
   "src/tools/studio/clone-instance.ts"() {
     init_protocol();
-    tool18 = {
+    tool19 = {
       name: "clone_instance",
       description: "Clone an existing instance in Roblox Studio and optionally reposition/rename it. Great for duplicating parts, models, or entire trees.",
       parameters: {
@@ -1754,13 +1816,13 @@ var init_clone_instance = __esm({
 // src/tools/studio/group-instances.ts
 var group_instances_exports = {};
 __export(group_instances_exports, {
-  tool: () => tool19
+  tool: () => tool20
 });
-var tool19;
+var tool20;
 var init_group_instances = __esm({
   "src/tools/studio/group-instances.ts"() {
     init_protocol();
-    tool19 = {
+    tool20 = {
       name: "group_instances",
       description: 'Group multiple instances under a new Model or Folder. Useful for organizing parts into objects (e.g., grouping trunk + leaves into a "Tree" model).',
       parameters: {
@@ -1820,7 +1882,7 @@ var init_group_instances = __esm({
 // src/tools/studio/build-multiple.ts
 var build_multiple_exports = {};
 __export(build_multiple_exports, {
-  tool: () => tool20
+  tool: () => tool21
 });
 function generateBatchCode(parts, groupName, groupParent) {
   const lines = [];
@@ -1879,11 +1941,11 @@ function generateBatchCode(parts, groupName, groupParent) {
   lines.push(`print("Built ${parts.length} parts${groupName ? ` in ${groupName}` : ""}")`);
   return lines.join("\n");
 }
-var tool20;
+var tool21;
 var init_build_multiple = __esm({
   "src/tools/studio/build-multiple.ts"() {
     init_protocol();
-    tool20 = {
+    tool21 = {
       name: "build_multiple",
       description: "Create multiple parts/instances in one batch call. Send an array of specs and they all get created in a single Studio round-trip. Ideal for building trees, houses, vehicles, terrain \u2014 anything composed of multiple parts.",
       parameters: {
@@ -1952,16 +2014,234 @@ var init_build_multiple = __esm({
   }
 });
 
+// src/tools/studio/serialize-ui.ts
+var serialize_ui_exports = {};
+__export(serialize_ui_exports, {
+  tool: () => tool22
+});
+var tool22;
+var init_serialize_ui = __esm({
+  "src/tools/studio/serialize-ui.ts"() {
+    init_protocol();
+    tool22 = {
+      name: "serialize_ui",
+      description: "Serialize an existing UI tree from Roblox Studio into create_ui-compatible JSON. This is the reverse of create_ui \u2014 read any instance and get back a declarative JSON tree you can modify and pass back to create_ui. Perfect for cloning, templating, or refactoring UIs.\n\nThe output includes ClassName, Name, all non-default properties (with values converted to JSON-friendly formats like [r,g,b] for Color3, [xS,xO,yS,yO] for UDim2, etc.), and Children.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Instance path to serialize (e.g. "StarterGui.MyScreenGui")'
+          },
+          maxDepth: {
+            type: "number",
+            description: "Maximum depth to serialize (default: 50)"
+          }
+        },
+        required: ["path"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.SERIALIZE_UI, {
+          path: params.path,
+          maxDepth: params.maxDepth ?? 50
+        }, 1e3 * 60 * 2);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Serialization failed" };
+        }
+        return { success: true, data: payload.tree };
+      }
+    };
+  }
+});
+
+// src/tools/studio/move-instance.ts
+var move_instance_exports = {};
+__export(move_instance_exports, {
+  tool: () => tool23
+});
+var tool23;
+var init_move_instance = __esm({
+  "src/tools/studio/move-instance.ts"() {
+    init_protocol();
+    tool23 = {
+      name: "move_instance",
+      description: "Move (reparent) an instance to a new parent in Roblox Studio. This preserves the instance and all its descendants \u2014 much better than delete + recreate. Sets a ChangeHistoryService waypoint so the move can be undone.",
+      parameters: {
+        type: "object",
+        properties: {
+          path: {
+            type: "string",
+            description: 'Full path of the instance to move (e.g. "Workspace.OldFolder.MyPart")'
+          },
+          newParent: {
+            type: "string",
+            description: 'Full path of the new parent (e.g. "Workspace.NewFolder")'
+          }
+        },
+        required: ["path", "newParent"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.MOVE_INSTANCE, {
+          path: params.path,
+          newParent: params.newParent
+        });
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Move failed" };
+        }
+        return { success: true, data: { newPath: payload.newPath } };
+      }
+    };
+  }
+});
+
+// src/tools/studio/bulk-set-properties.ts
+var bulk_set_properties_exports = {};
+__export(bulk_set_properties_exports, {
+  tool: () => tool24
+});
+var tool24;
+var init_bulk_set_properties = __esm({
+  "src/tools/studio/bulk-set-properties.ts"() {
+    init_protocol();
+    tool24 = {
+      name: "bulk_set_properties",
+      description: 'Set properties on multiple instances at once in a single call. Much faster than calling set_properties repeatedly. Supports two modes:\n1. Explicit paths: provide an array of {path, properties} objects\n2. By class filter: provide a root path, className filter, and properties to apply to all matches\n\nExample (explicit): [{"path": "StarterGui.HUD.Title", "properties": {"TextColor3": "#fff"}}, ...]\nExample (filter): root="StarterGui.HUD", className="TextLabel", properties={"Font": "GothamBold"}',
+      parameters: {
+        type: "object",
+        properties: {
+          targets: {
+            type: "array",
+            description: "Array of {path, properties} objects for explicit mode.",
+            items: {
+              type: "object",
+              description: "A target with path and properties to set."
+            }
+          },
+          root: {
+            type: "string",
+            description: "Root instance path to search under (filter mode)"
+          },
+          className: {
+            type: "string",
+            description: "Only apply to instances of this ClassName (filter mode)"
+          },
+          properties: {
+            type: "object",
+            description: "Properties to set on all matched instances (filter mode)"
+          }
+        }
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.BULK_SET_PROPERTIES, {
+          targets: params.targets,
+          root: params.root,
+          className: params.className,
+          properties: params.properties
+        }, 1e3 * 60);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Bulk set failed" };
+        }
+        return {
+          success: true,
+          data: {
+            modified: payload.modified,
+            errors: payload.errors?.length ? payload.errors : void 0
+          }
+        };
+      }
+    };
+  }
+});
+
+// src/tools/studio/find-replace-scripts.ts
+var find_replace_scripts_exports = {};
+__export(find_replace_scripts_exports, {
+  tool: () => tool25
+});
+var tool25;
+var init_find_replace_scripts = __esm({
+  "src/tools/studio/find-replace-scripts.ts"() {
+    init_protocol();
+    tool25 = {
+      name: "find_replace_scripts",
+      description: 'Find and replace text across all scripts in the game (or under a root path). Supports plain text and Lua pattern matching. Returns a list of modified scripts with match counts.\n\nUse dryRun=true to preview changes without applying them.\nExample: find="workspace" replace="Workspace" root="ServerScriptService"',
+      parameters: {
+        type: "object",
+        properties: {
+          find: {
+            type: "string",
+            description: "Text or Lua pattern to search for"
+          },
+          replace: {
+            type: "string",
+            description: "Replacement text (supports Lua pattern captures like %1, %2)"
+          },
+          root: {
+            type: "string",
+            description: "Root path to limit search scope (optional, searches entire game if omitted)"
+          },
+          usePattern: {
+            type: "boolean",
+            description: "If true, treat find/replace as Lua patterns. Default: false (plain text)"
+          },
+          dryRun: {
+            type: "boolean",
+            description: "If true, report matches but do not modify scripts. Default: false"
+          }
+        },
+        required: ["find", "replace"]
+      },
+      async execute(params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.FIND_REPLACE_SCRIPTS, {
+          find: params.find,
+          replace: params.replace,
+          root: params.root,
+          usePattern: params.usePattern ?? false,
+          dryRun: params.dryRun ?? false
+        }, 1e3 * 60 * 5);
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Find/replace failed" };
+        }
+        return {
+          success: true,
+          data: {
+            totalFiles: payload.totalFiles,
+            totalMatches: payload.totalMatches,
+            modified: payload.modified,
+            dryRun: params.dryRun ?? false
+          }
+        };
+      }
+    };
+  }
+});
+
 // src/tools/memory/recall.ts
 var recall_exports = {};
 __export(recall_exports, {
-  tool: () => tool21
+  tool: () => tool26
 });
-var tool21;
+var tool26;
 var init_recall = __esm({
   "src/tools/memory/recall.ts"() {
     init_store();
-    tool21 = {
+    tool26 = {
       name: "recall_memory",
       description: "Search your memory for previously learned facts about the current project. Use this to recall architecture decisions, patterns, known bugs, or user preferences.",
       parameters: {
@@ -2000,13 +2280,13 @@ var init_recall = __esm({
 // src/tools/memory/remember.ts
 var remember_exports = {};
 __export(remember_exports, {
-  tool: () => tool22
+  tool: () => tool27
 });
-var tool22;
+var tool27;
 var init_remember = __esm({
   "src/tools/memory/remember.ts"() {
     init_store();
-    tool22 = {
+    tool27 = {
       name: "remember",
       description: "Store a fact about the current project in persistent memory. Use this to remember architecture decisions, patterns, bugs found, or user preferences so you can recall them in future sessions.",
       parameters: {
@@ -2046,12 +2326,12 @@ var init_remember = __esm({
 // src/tools/cloud/upload-asset.ts
 var upload_asset_exports = {};
 __export(upload_asset_exports, {
-  tool: () => tool23
+  tool: () => tool28
 });
-var tool23;
+var tool28;
 var init_upload_asset = __esm({
   "src/tools/cloud/upload-asset.ts"() {
-    tool23 = {
+    tool28 = {
       name: "upload_asset",
       description: "Upload a local file (image, model, audio) to Roblox via the Open Cloud API. Requires an Open Cloud API key configured in dominus.",
       parameters: {
@@ -2147,6 +2427,57 @@ var init_upload_asset = __esm({
   }
 });
 
+// src/tools/studio/undo-redo.ts
+var undo_redo_exports = {};
+__export(undo_redo_exports, {
+  redoTool: () => redoTool,
+  undoTool: () => undoTool
+});
+var undoTool, redoTool;
+var init_undo_redo = __esm({
+  "src/tools/studio/undo-redo.ts"() {
+    init_protocol();
+    undoTool = {
+      name: "undo",
+      description: "Undo the last action in Roblox Studio using ChangeHistoryService. Works just like Ctrl+Z. Use this to roll back mistakes.",
+      parameters: {
+        type: "object",
+        properties: {}
+      },
+      async execute(_params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.UNDO, {});
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Undo failed" };
+        }
+        return { success: true, data: "Undo performed" };
+      }
+    };
+    redoTool = {
+      name: "redo",
+      description: "Redo the last undone action in Roblox Studio using ChangeHistoryService. Works just like Ctrl+Y.",
+      parameters: {
+        type: "object",
+        properties: {}
+      },
+      async execute(_params, ctx) {
+        if (!ctx.isStudioConnected()) {
+          return { success: false, error: "Studio is not connected" };
+        }
+        const response = await ctx.sendToStudio(CliMsg.REDO, {});
+        const payload = response.payload;
+        if (!payload.success) {
+          return { success: false, error: payload.error ?? "Redo failed" };
+        }
+        return { success: true, data: "Redo performed" };
+      }
+    };
+  }
+});
+
 // src/mcp/server.ts
 var server_exports = {};
 __export(server_exports, {
@@ -2228,6 +2559,19 @@ async function startMcpServer() {
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
   );
+  mcp.tool(
+    "get_descendants_properties",
+    "Easily get all descendants of a UI instance (or any instance) and all of their properties.",
+    {
+      path: z.string().describe('Full instance path (e.g., "Workspace.Part", "StarterGui.ScreenGui")'),
+      outputFile: z.string().optional().describe("Optional file path to write to prevent limit errors/timeouts")
+    },
+    async ({ path: path5, outputFile }) => {
+      assertConnected();
+      const res = await bridge.sendRequest(CliMsg.GET_DESCENDANTS_PROPERTIES, { path: path5, outputFile }, 1e3 * 60 * 5);
+      return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
+    }
+  );
   mcp.tool(
     "set_properties",
     "Set properties on an instance in Roblox Studio",
@@ -2327,13 +2671,14 @@ async function startMcpServer() {
       parent: z.string().optional().describe('Parent: "StarterGui", "PlayerGui", or path. Default: StarterGui'),
       tree: z.record(z.unknown()).describe(
         'Root UI node: {ClassName, Name, properties..., Children: [{...}, ...]}. UDim2 as [xScale, xOffset, yScale, yOffset], Color3 as "#hex", Font as "GothamBold"'
-      )
+      ),
+      animate: z.boolean().optional().describe("If true, task.wait() will be injected between creation of nodes so that the UI writes out dynamically.")
     },
-    async ({ parent, tree }) => {
+    async ({ parent, tree, animate }) => {
       assertConnected();
       const res = await bridge.sendRequest(
         CliMsg.BUILD_UI,
-        { parent: parent ?? "StarterGui", tree }
+        { parent: parent ?? "StarterGui", tree, animate }
       );
       return { content: [{ type: "text", text: JSON.stringify(res.payload, null, 2) }] };
     }
@@ -3775,13 +4120,13 @@ var AIProvider = class {
     yield { type: "done" };
   }
 };
-function toolToOpenAI(tool24) {
+function toolToOpenAI(tool29) {
   return {
     type: "function",
     function: {
-      name: tool24.name,
-      description: tool24.description,
-      parameters: tool24.parameters
+      name: tool29.name,
+      description: tool29.description,
+      parameters: tool29.parameters
     }
   };
 }
@@ -4237,11 +4582,11 @@ var AgentLoop = class {
 // src/tools/registry.ts
 var ToolRegistry = class {
   tools = /* @__PURE__ */ new Map();
-  register(tool24) {
-    if (this.tools.has(tool24.name)) {
-      throw new Error(`Tool already registered: ${tool24.name}`);
+  register(tool29) {
+    if (this.tools.has(tool29.name)) {
+      throw new Error(`Tool already registered: ${tool29.name}`);
     }
-    this.tools.set(tool24.name, tool24);
+    this.tools.set(tool29.name, tool29);
   }
   get(name) {
     return this.tools.get(name);
@@ -4253,12 +4598,12 @@ var ToolRegistry = class {
     return this.getAll();
   }
   async execute(call, ctx) {
-    const tool24 = this.tools.get(call.name);
-    if (!tool24) {
+    const tool29 = this.tools.get(call.name);
+    if (!tool29) {
       return { success: false, error: `Unknown tool: ${call.name}` };
     }
     try {
-      return await tool24.execute(call.arguments, ctx);
+      return await tool29.execute(call.arguments, ctx);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       return { success: false, error: message };
@@ -4276,6 +4621,7 @@ function createDefaultRegistry() {
     Promise.resolve().then(() => (init_run_code(), run_code_exports)),
     Promise.resolve().then(() => (init_get_explorer(), get_explorer_exports)),
     Promise.resolve().then(() => (init_get_properties(), get_properties_exports)),
+    Promise.resolve().then(() => (init_get_descendants_properties(), get_descendants_properties_exports)),
     Promise.resolve().then(() => (init_set_properties(), set_properties_exports)),
     Promise.resolve().then(() => (init_insert_instance(), insert_instance_exports)),
     Promise.resolve().then(() => (init_delete_instance(), delete_instance_exports)),
@@ -4291,6 +4637,10 @@ function createDefaultRegistry() {
     Promise.resolve().then(() => (init_clone_instance(), clone_instance_exports)),
     Promise.resolve().then(() => (init_group_instances(), group_instances_exports)),
     Promise.resolve().then(() => (init_build_multiple(), build_multiple_exports)),
+    Promise.resolve().then(() => (init_serialize_ui(), serialize_ui_exports)),
+    Promise.resolve().then(() => (init_move_instance(), move_instance_exports)),
+    Promise.resolve().then(() => (init_bulk_set_properties(), bulk_set_properties_exports)),
+    Promise.resolve().then(() => (init_find_replace_scripts(), find_replace_scripts_exports)),
     Promise.resolve().then(() => (init_recall(), recall_exports)),
     Promise.resolve().then(() => (init_remember(), remember_exports)),
     Promise.resolve().then(() => (init_upload_asset(), upload_asset_exports))
@@ -4301,6 +4651,10 @@ function createDefaultRegistry() {
       if (m.tool) registry.register(m.tool);
     })
   );
+  void Promise.resolve().then(() => (init_undo_redo(), undo_redo_exports)).then((m) => {
+    registry.register(m.undoTool);
+    registry.register(m.redoTool);
+  });
   return registry;
 }
 
@@ -4398,7 +4752,62 @@ function formatUpdateMessage(info) {
     ""
   ].join("\n");
 }
-var VERSION = "0.2.1";
+async function autoUpdate(currentVersion) {
+  const info = await checkForUpdate(currentVersion);
+  if (!info?.updateAvailable) {
+    return { success: true, from: currentVersion, to: currentVersion };
+  }
+  const managers = [
+    { name: "pnpm", check: "pnpm list -g dominus-cli", cmd: "pnpm add -g dominus-cli@latest" },
+    { name: "npm", check: "npm list -g dominus-cli", cmd: "npm install -g dominus-cli@latest" },
+    { name: "yarn", check: "yarn global list --pattern dominus-cli", cmd: "yarn global add dominus-cli@latest" }
+  ];
+  let installCmd = null;
+  for (const mgr of managers) {
+    try {
+      const out = execSync(mgr.check, { stdio: "pipe", timeout: 1e4 }).toString();
+      if (out.includes("dominus-cli")) {
+        installCmd = mgr.cmd;
+        break;
+      }
+    } catch {
+    }
+  }
+  if (!installCmd) {
+    try {
+      const out = execSync("pnpm list -g dominus-cli", { stdio: "pipe", timeout: 1e4 }).toString();
+      if (out.includes("link:")) {
+        const pkgPath = path4.resolve(__dirname$1, "..");
+        if (fs5.existsSync(path4.join(pkgPath, ".git"))) {
+          try {
+            execSync("git pull", { cwd: pkgPath, stdio: "pipe", timeout: 3e4 });
+            execSync("pnpm install", { cwd: pkgPath, stdio: "pipe", timeout: 6e4 });
+            execSync("pnpm build", { cwd: pkgPath, stdio: "pipe", timeout: 6e4 });
+            execSync("pnpm build:plugin", { cwd: pkgPath, stdio: "pipe", timeout: 3e4 });
+            return { success: true, from: currentVersion, to: info.latestVersion };
+          } catch (err) {
+            return { success: false, from: currentVersion, to: info.latestVersion, error: `Git pull/rebuild failed: ${err}` };
+          }
+        }
+        return { success: false, from: currentVersion, to: info.latestVersion, error: 'Linked install without git \u2014 run "pnpm build" manually in the repo' };
+      }
+    } catch {
+    }
+  }
+  if (!installCmd) {
+    installCmd = `npm install -g ${NPM_PACKAGE}@latest`;
+  }
+  try {
+    execSync(installCmd, { stdio: "pipe", timeout: 12e4 });
+    writeCache({ lastCheck: 0, latestVersion: null });
+    return { success: true, from: currentVersion, to: info.latestVersion };
+  } catch (err) {
+    return { success: false, from: currentVersion, to: info.latestVersion, error: `Update command failed: ${err}` };
+  }
+}
+var __dirname$1 = path4.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, "$1"));
+var __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
+var VERSION = JSON.parse(fs5.readFileSync(path4.join(__dirname2, "..", "package.json"), "utf-8")).version;
 var program = new Command();
 program.name("dominus").description("AI-powered autonomous agent for Roblox Studio development").version(VERSION);
 program.command("start", { isDefault: true }).description("Launch the Dominus TUI agent").option("-p, --port <port>", "WebSocket server port", "18088").action(async (opts) => {
@@ -4510,9 +4919,24 @@ rulesCmd.command("list").description("List all rules").action(() => {
   }
   console.log("");
 });
+program.command("update").description("Auto-update Dominus to the latest version").action(async () => {
+  console.log(`  Current version: ${VERSION}`);
+  console.log("  Checking for updates...");
+  const result = await autoUpdate(VERSION);
+  if (result.from === result.to && result.success) {
+    console.log("  Already on the latest version.");
+    return;
+  }
+  if (result.success) {
+    console.log(`  \u2714 Updated: ${result.from} \u2192 ${result.to}`);
+    console.log("  Restart dominus to use the new version.");
+  } else {
+    console.error(`  \u2718 Update failed: ${result.error}`);
+  }
+});
 program.command("install-plugin").description("Build & install the Dominus plugin into Roblox Studio").action(async () => {
-  const { execSync: execSync2 } = await import('child_process');
-  const packageRoot = path4.resolve(import.meta.dirname ?? __dirname, "..");
+  const { execSync: execSync3 } = await import('child_process');
+  const packageRoot = path4.resolve(import.meta.dirname ?? __dirname2, "..");
   const pluginDir = path4.join(packageRoot, "plugin");
   const pluginProject = path4.join(pluginDir, "default.project.json");
   const studioPlugins = path4.join(
@@ -4533,14 +4957,14 @@ program.command("install-plugin").description("Build & install the Dominus plugi
   }
   let rojoAvailable = false;
   try {
-    execSync2("rojo --version", { stdio: "pipe" });
+    execSync3("rojo --version", { stdio: "pipe" });
     rojoAvailable = true;
   } catch {
   }
   if (rojoAvailable) {
     try {
       console.log("  Building plugin with Rojo...");
-      execSync2(`rojo build "${pluginDir}" -o "${destFile}"`, { stdio: "pipe" });
+      execSync3(`rojo build "${pluginDir}" -o "${destFile}"`, { stdio: "pipe" });
       console.log(`  \u2714 Plugin built and installed to: ${destFile}`);
       console.log("  Restart Roblox Studio to load the plugin.");
     } catch (err) {