dominus-cli 0.5.1 → 0.5.2

package/dist/index.js

@@ -629,6 +629,66 @@ var init_ws_client = __esm({
   }
 });
 
+// src/agent/internal-memory.ts
+var INTERNAL_MEMORY;
+var init_internal_memory = __esm({
+  "src/agent/internal-memory.ts"() {
+    INTERNAL_MEMORY = `## Internal Memory \u2014 Known Quirks & Lessons
+
+These are built-in lessons that ship with Dominus. Follow them exactly.
+
+### create_ui \u2014 property format
+- Each node accepts properties in **either** of two shapes:
+  - **Flattened (preferred)**: props as top-level keys next to \`ClassName\`, \`Name\`, \`Children\`.
+    \`\`\`json
+    { "ClassName": "TextButton", "Name": "Btn", "Text": "OK", "Size": [0, 100, 0, 40] }
+    \`\`\`
+  - **Nested bag**: props grouped under \`properties\` / \`Properties\` / \`props\` / \`Props\`.
+    \`\`\`json
+    { "ClassName": "TextButton", "Name": "Btn",
+      "properties": { "Text": "OK", "Size": [0, 100, 0, 40] } }
+    \`\`\`
+- Do NOT mix a nested \`properties\` bag with flattened props of the same name \u2014 the bag wins.
+- Reserved keys (never treated as instance properties): \`ClassName\`, \`className\`, \`Name\`, \`name\`, \`Children\`, \`children\`, \`properties\`, \`Properties\`, \`props\`, \`Props\`.
+
+### build_multiple \u2014 schema is strict
+- Top-level keys only: \`name\`, \`className\`, \`position\`, \`size\`, \`color\`, \`material\`, \`anchored\`, \`shape\`, \`transparency\`, \`parent\`, \`canCollide\`.
+- Does NOT accept a nested \`properties\` bag. For anything outside those fields use \`insert_instance\` + \`set_properties\`.
+- \`shape\` values: \`Block\`, \`Ball\`, \`Cylinder\`, \`Wedge\`.
+
+### Color formats (accepted everywhere)
+- Hex: \`"#RRGGBB"\`
+- RGB string: \`"rgb(255, 128, 0)"\`
+- BrickColor name: \`"Bright red"\`, \`"Institutional white"\`, \`"Really black"\`, etc.
+- Array: \`[r, g, b]\` (0\u20131 floats) or \`[255, 128, 0]\` (auto-detected if any value > 1)
+
+### UDim2 / UDim / Vector2 / Color3 coercion (create_ui)
+- UDim2: \`[xScale, xOffset, yScale, yOffset]\` or \`{XScale, XOffset, YScale, YOffset}\`.
+- UDim: \`[scale, offset]\` or a plain number (treated as pixels).
+- Vector2 (e.g. \`AnchorPoint\`): \`[x, y]\` or \`{x, y}\`.
+- 2-element arrays are auto-disambiguated by property name (\`AnchorPoint\` \u2192 Vector2, \`CornerRadius\` \u2192 UDim).
+
+### Common GUI property names
+- GUI uses \`Size\`/\`Position\` as **UDim2** \u2014 never Vector3.
+- \`BackgroundColor3\`, \`TextColor3\`, \`BorderColor3\`, \`ImageColor3\` \u2192 Color3.
+- \`Font\` accepts a string enum name like \`"GothamBold"\`, \`"SourceSans"\`.
+- Enum properties take the string name: \`"Center"\`, \`"Left"\`, \`"Fit"\`.
+
+### Tool selection cheat-sheet
+- Single 3D part \u2192 \`create_part\`
+- Many 3D parts (tree, building, vehicle) \u2192 \`build_multiple\` with \`groupName\`
+- Full UI tree \u2192 \`create_ui\` (one call, never loop \`insert_instance\` for UI)
+- Adjusting an existing instance \u2192 \`set_properties\` (not \`run_code\`)
+- Anything exotic or procedural \u2192 \`run_code\` as last resort
+
+### Verification habits
+- After a build, call \`get_explorer\` or \`get_selection\` to confirm the tree looks right.
+- After editing a script, read it back.
+- After \`run_code\`, check \`get_output\` for errors.
+`;
+  }
+});
+
 // src/memory/store.ts
 var store_exports = {};
 __export(store_exports, {
@@ -1518,7 +1578,7 @@ 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} (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.'
+            description: 'The root UI node. Each node has: ClassName (string), Name (string), Children (array of child nodes), and properties. Properties may be specified either flattened at the top level of the node, OR nested under a "properties" / "Properties" / "props" key \u2014 both work. 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",
@@ -2499,6 +2559,8 @@ async function startMcpServer() {
   const mcp = new McpServer({
     name: "dominus",
     version: "0.2.1"
+  }, {
+    instructions: INTERNAL_MEMORY
   });
   mcp.tool(
     "read_script",
@@ -2951,6 +3013,7 @@ var init_server = __esm({
     init_protocol();
     init_store();
     init_config();
+    init_internal_memory();
   }
 });
 var CROWN_ART = `    \u25C6       \u25C6       \u25C6
@@ -4132,6 +4195,7 @@ function toolToOpenAI(tool29) {
 }
 
 // src/agent/system-prompt.ts
+init_internal_memory();
 function buildSystemPrompt(opts) {
   const parts = [];
   parts.push(`You are Dominus, an expert AI agent for Roblox Studio development.
@@ -4290,7 +4354,9 @@ The \`get_class_info\` tool queries Roblox's ReflectionService to return the com
 - All events with parameter types
 - Superclass, creatability, serialization info
 
-Use it whenever you're unsure about property names or types. It's fast and cached.`);
+Use it whenever you're unsure about property names or types. It's fast and cached.
+
+${INTERNAL_MEMORY}`);
   return parts.join("\n");
 }