unity-open-mcp 0.1.2 → 0.3.0

package/dist/tools/ui-canvas-add.js

@@ -0,0 +1,66 @@
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tool. Built-in UI module (no extra
+// UPM); the `ui` group is hidden until manage_tools activates it. Mutating:
+// runs the full gate path; paths_hint is the host / new-root scene path.
+// Address the host by instance_id > path > name (same model as gameobject_* /
+// component_*). When no host is addressed, a new scene root is created
+// (new_root_name controls its name; defaults to "Canvas"). Param shape:
+// renderMode overlay/camera/world + EventSystem.
+const targetSchema = {
+    instance_id: {
+        type: "integer",
+        default: 0,
+        description: "Host GameObject instance ID. Highest priority resolver. When omitted, a new scene root is created.",
+    },
+    path: {
+        type: "string",
+        description: "Host hierarchy path \"Root/Child\".",
+    },
+    name: {
+        type: "string",
+        description: "Host GameObject name (first match). Lowest priority resolver.",
+    },
+    paths_hint: {
+        type: "array",
+        items: { type: "string" },
+        description: "Mutation scope — the host's (or new root's) scene path.",
+    },
+    gate: {
+        enum: ["enforce", "warn", "off"],
+        default: "enforce",
+    },
+};
+export const uiCanvasAdd = {
+    name: "unity_open_mcp_ui_canvas_add",
+    description: "Add a Canvas to a GameObject (or as a new scene root when no host is addressed). " +
+        "Ensures the canvas has a CanvasScaler + GraphicRaycaster, and ensures an EventSystem " +
+        "exists in the open scene(s). Set render_mode (ScreenSpaceOverlay | ScreenSpaceCamera | " +
+        "WorldSpace, default ScreenSpaceOverlay) and sorting_order (default 0). Idempotent — " +
+        "re-using an existing Canvas reports added:false (the scaler / raycaster / EventSystem " +
+        "are still ensured). Mutating: runs the full gate path; paths_hint is the host / " +
+        "new-root scene path. Built-in UI module (no package dependency); the ui group is " +
+        "hidden until manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            ...targetSchema,
+            render_mode: {
+                type: "string",
+                default: "ScreenSpaceOverlay",
+                enum: ["ScreenSpaceOverlay", "ScreenSpaceCamera", "WorldSpace"],
+                description: "Canvas render mode.",
+            },
+            sorting_order: {
+                type: "integer",
+                default: 0,
+                description: "Canvas sorting order (higher = drawn on top).",
+            },
+            new_root_name: {
+                type: "string",
+                description: "Name for the new scene root when no host is addressed (defaults to 'Canvas').",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=ui-canvas-add.js.map

package/dist/tools/ui-canvas-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-canvas-add.js","sourceRoot":"","sources":["../../src/tools/ui-canvas-add.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oGAAoG;KAClH;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+DAA+D;KAC7E;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,mFAAmF;QACnF,uFAAuF;QACvF,yFAAyF;QACzF,sFAAsF;QACtF,wFAAwF;QACxF,kFAAkF;QAClF,mFAAmF;QACnF,yCAAyC;IAC3C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,GAAG,YAAY;YACf,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,oBAAoB;gBAC7B,IAAI,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,CAAC;gBAC/D,WAAW,EAAE,qBAAqB;aACnC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,+CAA+C;aAC7D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+EAA+E;aAC7F;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/ui-element-add.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const uiElementAdd: Tool;

package/dist/tools/ui-element-add.js

@@ -0,0 +1,65 @@
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tool. Adds a uGUI element as a child
+// of a parent RectTransform. Built-in UI module. Mutating: runs the full gate
+// path; paths_hint is the parent scene path. The parent MUST exist — every
+// uGUI element lives under a Canvas in the hierarchy. TMP_Text requires the
+// TextMesh Pro package; when absent, returns `tmp_package_required` (no silent
+// legacy-Text fallback). Param shape: element types + parent + common fields.
+export const uiElementAdd = {
+    name: "unity_open_mcp_ui_element_add",
+    description: "Add a uGUI element as a child of a parent RectTransform. element_type is one of " +
+        "Text | TMP_Text | Image | Button | Slider | Toggle | InputField. Common fields: " +
+        "text (Text / TMP_Text / InputField), color (Graphic.color, r,g,b,a 0-1), " +
+        "sprite_path (Image / Button / Toggle sprite, Assets/-rooted). TMP_Text requires the " +
+        "TextMesh Pro package — when absent, returns `tmp_package_required` (no silent " +
+        "legacy-Text fallback). Mutating: runs the full gate path; paths_hint is the parent " +
+        "scene path. Built-in UI module (no package dependency); the ui group is hidden " +
+        "until manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["element_type", "paths_hint"],
+        properties: {
+            parent_instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Parent GameObject instance ID. Highest priority resolver.",
+            },
+            parent_path: {
+                type: "string",
+                description: "Parent hierarchy path \"Root/Parent\".",
+            },
+            parent_name: {
+                type: "string",
+                description: "Parent GameObject name (first match). Lowest priority resolver.",
+            },
+            element_type: {
+                type: "string",
+                enum: ["Text", "TMP_Text", "Image", "Button", "Slider", "Toggle", "InputField"],
+                description: "uGUI element type to add.",
+            },
+            element_name: {
+                type: "string",
+                description: "Name for the new element GameObject (defaults to element_type).",
+            },
+            text: {
+                type: "string",
+                description: "Initial text (Text / TMP_Text / InputField).",
+            },
+            color: {
+                type: "string",
+                description: "Graphic.color as 'r,g,b,a' (0-1).",
+            },
+            sprite_path: {
+                type: "string",
+                description: "Assets/-rooted Sprite path (Image / Button / Toggle sprite).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the parent scene path. No whole-project fallback.",
+            },
+            gate: { enum: ["enforce", "warn", "off"], default: "enforce" },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=ui-element-add.js.map

package/dist/tools/ui-element-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-element-add.js","sourceRoot":"","sources":["../../src/tools/ui-element-add.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,kFAAkF;QAClF,kFAAkF;QAClF,2EAA2E;QAC3E,sFAAsF;QACtF,gFAAgF;QAChF,qFAAqF;QACrF,iFAAiF;QACjF,kCAAkC;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;QACxC,UAAU,EAAE;YACV,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,2DAA2D;aACzE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC;gBAC/E,WAAW,EAAE,2BAA2B;aACzC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oEAAoE;aAClF;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/ui-element-modify.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const uiElementModify: Tool;

package/dist/tools/ui-element-modify.js

@@ -0,0 +1,59 @@
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tool. Typed patch on a uGUI
+// component. Built-in UI module. Mutating: runs the full gate path; paths_hint
+// is the host scene path. Mirrors component_modify's shape but is scoped to
+// uGUI types so the value conversion is purpose-built for the common fields
+// (Graphic.color, Graphic.raycastTarget, Selectable.interactable, LayoutElement
+// preferred sizes, Text / TMP_Text text).
+export const uiElementModify = {
+    name: "unity_open_mcp_ui_element_modify",
+    description: "Set typed fields on a uGUI component attached to a target GameObject. Select the " +
+        "component by 'component_type' (Text | TMP_Text | Image | Button | Slider | Toggle | " +
+        "InputField | Canvas | CanvasScaler | GraphicRaycaster | HorizontalLayoutGroup | " +
+        "VerticalLayoutGroup | GridLayoutGroup | LayoutElement | Selectable). Each entry is " +
+        "{ field, value, type? } where type is 'int' | 'float' | 'bool' | 'string' | 'color' " +
+        "| 'vector' (default inferred from the current value). Unknown fields are reported " +
+        "as errors and the tool fails atomically (no partial writes) when any field fails " +
+        "to convert. Mutating: runs the full gate path; paths_hint is the host scene path. " +
+        "Built-in UI module (no package dependency); the ui group is hidden until " +
+        "manage_tools activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["component_type", "fields_json", "paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Host GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Host hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Host GameObject name (first match). Lowest priority resolver.",
+            },
+            component_type: {
+                type: "string",
+                description: "uGUI component type name. One of Text | TMP_Text | Image | Button | Slider | " +
+                    "Toggle | InputField | Canvas | CanvasScaler | GraphicRaycaster | " +
+                    "HorizontalLayoutGroup | VerticalLayoutGroup | GridLayoutGroup | LayoutElement | " +
+                    "Selectable.",
+            },
+            fields_json: {
+                type: "string",
+                description: "JSON array of { field, value, type? } entries. type is 'int' | 'float' | 'bool' " +
+                    "| 'string' | 'color' | 'vector' (default inferred). color is 'r,g,b,a' (0-1); " +
+                    "vector is 'x,y' (Vector2) or 'x,y,z' (Vector3).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the host scene path. No whole-project fallback.",
+            },
+            gate: { enum: ["enforce", "warn", "off"], default: "enforce" },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=ui-element-modify.js.map

package/dist/tools/ui-element-modify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-element-modify.js","sourceRoot":"","sources":["../../src/tools/ui-element-modify.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,gFAAgF;AAChF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,mFAAmF;QACnF,sFAAsF;QACtF,kFAAkF;QAClF,qFAAqF;QACrF,sFAAsF;QACtF,oFAAoF;QACpF,mFAAmF;QACnF,oFAAoF;QACpF,2EAA2E;QAC3E,4BAA4B;IAC9B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,gBAAgB,EAAE,aAAa,EAAE,YAAY,CAAC;QACzD,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,yDAAyD;aACvE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,+EAA+E;oBAC/E,mEAAmE;oBACnE,kFAAkF;oBAClF,aAAa;aAChB;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kFAAkF;oBAClF,gFAAgF;oBAChF,iDAAiD;aACpD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kEAAkE;aAChF;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/ui-layout-group-add.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const uiLayoutGroupAdd: Tool;

package/dist/tools/ui-layout-group-add.js

@@ -0,0 +1,80 @@
+// M20 Plan 3 / T20.3.2 — UI (uGUI) domain tool. Adds a layout group to a parent
+// RectTransform. Built-in UI module. Mutating: runs the full gate path;
+// paths_hint is the parent scene path. Idempotent — re-using an existing group
+// of the same type reports added:false.
+export const uiLayoutGroupAdd = {
+    name: "unity_open_mcp_ui_layout_group_add",
+    description: "Add a layout group to a parent RectTransform. layout_type is " +
+        "HorizontalLayoutGroup | VerticalLayoutGroup | GridLayoutGroup. Optional: padding " +
+        "(left,right,top,bottom — defaults 0), spacing (x,y — defaults 0), child_alignment " +
+        "(TextAnchor name, default UpperLeft), child_control_width / child_control_height " +
+        "(default true), child_force_expand_width / child_force_expand_height (default true). " +
+        "Idempotent — re-using an existing group of the same type reports added:false. " +
+        "Mutating: runs the full gate path; paths_hint is the parent scene path. Built-in " +
+        "UI module (no package dependency); the ui group is hidden until manage_tools " +
+        "activates it.",
+    inputSchema: {
+        type: "object",
+        required: ["layout_type", "paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Parent GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Parent hierarchy path \"Root/Parent\".",
+            },
+            name: {
+                type: "string",
+                description: "Parent GameObject name (first match). Lowest priority resolver.",
+            },
+            layout_type: {
+                type: "string",
+                enum: ["HorizontalLayoutGroup", "VerticalLayoutGroup", "GridLayoutGroup"],
+                description: "Layout group type to add.",
+            },
+            padding: {
+                type: "string",
+                description: "Padding as 'left,right,top,bottom' (int). Defaults to 0 on all sides.",
+            },
+            spacing: {
+                type: "string",
+                description: "Spacing as 'x,y' (GridLayoutGroup) or 'x' (HV groups — y ignored). Defaults to 0.",
+            },
+            child_alignment: {
+                type: "string",
+                description: "TextAnchor name (e.g. 'UpperLeft', 'MiddleCenter'). Default UpperLeft.",
+            },
+            child_control_width: {
+                type: "boolean",
+                default: true,
+                description: "HorizontalOrVerticalLayoutGroup: control child widths.",
+            },
+            child_control_height: {
+                type: "boolean",
+                default: true,
+                description: "HorizontalOrVerticalLayoutGroup: control child heights.",
+            },
+            child_force_expand_width: {
+                type: "boolean",
+                default: true,
+                description: "HorizontalOrVerticalLayoutGroup: force-expand child widths.",
+            },
+            child_force_expand_height: {
+                type: "boolean",
+                default: true,
+                description: "HorizontalOrVerticalLayoutGroup: force-expand child heights.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the parent scene path. No whole-project fallback.",
+            },
+            gate: { enum: ["enforce", "warn", "off"], default: "enforce" },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=ui-layout-group-add.js.map

package/dist/tools/ui-layout-group-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-layout-group-add.js","sourceRoot":"","sources":["../../src/tools/ui-layout-group-add.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,wEAAwE;AACxE,+EAA+E;AAC/E,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,+DAA+D;QAC/D,mFAAmF;QACnF,oFAAoF;QACpF,mFAAmF;QACnF,uFAAuF;QACvF,gFAAgF;QAChF,mFAAmF;QACnF,+EAA+E;QAC/E,eAAe;IACjB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;QACvC,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,uBAAuB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC;gBACzE,WAAW,EAAE,2BAA2B;aACzC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mFAAmF;aACjG;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wEAAwE;aACtF;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,wDAAwD;aACtE;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,yDAAyD;aACvE;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,6DAA6D;aAC3E;YACD,yBAAyB,EAAE;gBACzB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,8DAA8D;aAC5E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oEAAoE;aAClF;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/validate-edit.js

@@ -1,7 +1,9 @@
 export const validateEdit = {
     name: "unity_open_mcp_validate_edit",
     description: "Scoped health check without a preceding mutation. Used by agents for manual verification or pre-commit checks. " +
-        "Use include_rules / exclude_rules to narrow the auto-selected rule set. Each issue carries ruleId + categoryId (alias), " +
+        "Use include_rules / exclude_rules to narrow the auto-selected rule set. Default (`profile: 'compact'`) returns " +
+        "passed + issue counts grouped by severity (no per-issue list); raise to balanced/full for the full issues list, " +
+        "and page large result sets with page_size/cursor. Each issue carries ruleId + categoryId (alias), " +
         "severity, code + issueCode (alias), assetPath, description, and fixId + fixSafe when a fix exists.",
     inputSchema: {
         type: "object",
@@ -32,9 +34,28 @@ export const validateEdit = {
                 enum: ["mobile", "console", "desktop"],
                 default: "desktop",
             },
+            profile: {
+                enum: ["compact", "balanced", "full"],
+                default: "compact",
+                description: "Token-budget output profile (M22). 'compact' (default) = passed + issue counts grouped by severity " +
+                    "(issues[] stripped; drill in with balanced/full). 'balanced'/'full' = the full issues list (paged when " +
+                    "page_size is set). An explicit profile wins over the legacy `detail` param.",
+            },
+            page_size: {
+                type: "integer",
+                minimum: 1,
+                description: "Page the issues list (M22 uniform paging; balanced/full). When set, the response carries a `pagination` block " +
+                    "with a `next_cursor` to resume. Omit to receive the whole issues list in one response.",
+            },
+            cursor: {
+                type: "string",
+                description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the issues list.",
+            },
             detail: {
                 enum: ["summary", "normal", "verbose"],
                 default: "normal",
+                description: "Legacy compression level (alias for `profile`: summary=compact, normal/full=verbose). Prefer `profile`; " +
+                    "ignored when `profile` is set.",
             },
         },
         additionalProperties: false,

package/dist/tools/validate-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-edit.js","sourceRoot":"","sources":["../../src/tools/validate-edit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,iHAAiH;QACjH,0HAA0H;QAC1H,oGAAoG;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;aACZ;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sDAAsD;aACpE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sHAAsH;oBACtH,sEAAsE;aACzE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;aACnB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;aAClB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"validate-edit.js","sourceRoot":"","sources":["../../src/tools/validate-edit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,iHAAiH;QACjH,iHAAiH;QACjH,kHAAkH;QAClH,oGAAoG;QACpG,oGAAoG;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;aACZ;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sDAAsD;aACpE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sHAAsH;oBACtH,sEAAsE;aACzE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;aACnB;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,qGAAqG;oBACrG,yGAAyG;oBACzG,6EAA6E;aAChF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,gHAAgH;oBAChH,wFAAwF;aAC3F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sGAAsG;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,0GAA0G;oBAC1G,gCAAgC;aACnC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/vfx-block-edit.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const vfxBlockEdit: Tool;

package/dist/tools/vfx-block-edit.js

@@ -0,0 +1,51 @@
+// M20 Plan 7 / T20.7.2 — VFX Graph block_edit. Compile-gated + auto-activating
+// (see vfx-list.ts). Mutating: patches a single property on a block in a .vfx
+// — paths_hint is the .vfx asset path, EditorSettle lifecycle. VFX Graph's
+// editor graph model is internal and requires the VFX Graph window to be open
+// (no stable public headless entry point); when the model cannot be reached,
+// the tool returns a structured vfx_block_edit_requires_editor_window error and
+// the agent falls back to manual editing.
+export const vfxBlockEdit = {
+    name: "unity_open_mcp_vfx_block_edit",
+    description: "Patch a single property on a block in a VisualEffectGraph (.vfx). " +
+        "block_selector names the target block (by type-name fragment, e.g. " +
+        "'SetVelocity', 'SetColor'); property is the field name; value_json is the " +
+        "new value. Mutating: runs the full gate path; paths_hint is the .vfx asset " +
+        "path. Requires com.unity.visualeffectgraph. VFX Graph's editor graph model " +
+        "is internal and requires the VFX Graph window to be open; when it is not, " +
+        "the tool returns a structured vfx_block_edit_requires_editor_window error " +
+        "— open the graph in the VFX Graph window (unity_open_mcp_vfx_open) and " +
+        "retry, or edit the block manually in the window.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path", "block_selector", "property", "value_json", "paths_hint"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "VisualEffectGraph asset path ('Assets/.../*.vfx').",
+            },
+            block_selector: {
+                type: "string",
+                description: "Target block selector — a type-name fragment (e.g. 'SetVelocity', " +
+                    "'SetColor'). The first block whose type name contains the fragment " +
+                    "(case-insensitive) is patched.",
+            },
+            property: {
+                type: "string",
+                description: "The block field to patch.",
+            },
+            value_json: {
+                type: "string",
+                description: "The new value as a JSON literal (string / number / bool / object).",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — must include the .vfx asset path.",
+            },
+            gate: { enum: ["enforce", "warn", "off"], default: "enforce" },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=vfx-block-edit.js.map

package/dist/tools/vfx-block-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-block-edit.js","sourceRoot":"","sources":["../../src/tools/vfx-block-edit.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oEAAoE;QACpE,qEAAqE;QACrE,4EAA4E;QAC5E,6EAA6E;QAC7E,6EAA6E;QAC7E,4EAA4E;QAC5E,4EAA4E;QAC5E,yEAAyE;QACzE,kDAAkD;IACpD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;QAClF,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;oBACpE,qEAAqE;oBACrE,gCAAgC;aACnC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oEAAoE;aACvE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oDAAoD;aAClE;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/vfx-list.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const vfxList: Tool;

package/dist/tools/vfx-list.js

@@ -0,0 +1,31 @@
+// M20 Plan 7 / T20.7.2 — VFX Graph list. Compile-gated in the bridge
+// (UNITY_OPEN_MCP_EXT_VFX on com.unity.visualeffectgraph) + auto-activating
+// (the `vfx` group auto-activates when the package is present). Read-only:
+// enumerates every VisualEffectGraph (.vfx) asset under Assets/. Gate = Off,
+// no paths_hint. Uses the public runtime VisualEffectAsset type so the path is
+// version-stable.
+export const vfxList = {
+    name: "unity_open_mcp_vfx_list",
+    description: "List every VisualEffectGraph (.vfx) asset under Assets/. Read-only (Gate " +
+        "is Off, no paths_hint). Returns each asset's path, name, and file size. " +
+        "Optionally filter by name/path substring (filter) and cap results " +
+        "(max_results, default 100, max 500). Requires the " +
+        "com.unity.visualeffectgraph package installed.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            filter: {
+                type: "string",
+                description: "Optional substring filter on asset path (case-insensitive).",
+            },
+            max_results: {
+                type: "integer",
+                description: "Maximum number of assets to return (default 100, clamped to 500).",
+                minimum: 1,
+                maximum: 500,
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=vfx-list.js.map

package/dist/tools/vfx-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-list.js","sourceRoot":"","sources":["../../src/tools/vfx-list.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAC/E,kBAAkB;AAClB,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,2EAA2E;QAC3E,0EAA0E;QAC1E,oEAAoE;QACpE,oDAAoD;QACpD,gDAAgD;IAClD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6DAA6D;aAChE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,mEAAmE;gBACrE,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;aACb;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/vfx-open.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const vfxOpen: Tool;

package/dist/tools/vfx-open.js

@@ -0,0 +1,29 @@
+// M20 Plan 7 / T20.7.2 — VFX Graph open. Compile-gated + auto-activating
+// (see vfx-list.ts). Read-only window bring-up: opens the .vfx in the VFX Graph
+// editor window and returns a structured summary (context count, block count,
+// exposed property count, property names). Non-mutating state change —
+// Gate = Off, no paths_hint. The summary reads off the public runtime
+// VisualEffectAsset type and the stable serialized file format, so it is
+// version-stable without editor-model reflection.
+export const vfxOpen = {
+    name: "unity_open_mcp_vfx_open",
+    description: "Open a VisualEffectGraph (.vfx) asset in the VFX Graph editor window and " +
+        "return a structured summary (context count, block count, exposed property " +
+        "count, property names). Read-only window bring-up — Gate is Off, no " +
+        "paths_hint. The summary reads off the public runtime VisualEffectAsset type " +
+        "and the serialized file format, so it is stable across package versions. " +
+        "Requires com.unity.visualeffectgraph.",
+    inputSchema: {
+        type: "object",
+        required: ["asset_path"],
+        properties: {
+            asset_path: {
+                type: "string",
+                description: "VisualEffectGraph asset path ('Assets/.../*.vfx'). Highest and only " +
+                    "resolver.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=vfx-open.js.map

package/dist/tools/vfx-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfx-open.js","sourceRoot":"","sources":["../../src/tools/vfx-open.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,gFAAgF;AAChF,8EAA8E;AAC9E,uEAAuE;AACvE,sEAAsE;AACtE,yEAAyE;AACzE,kDAAkD;AAClD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,2EAA2E;QAC3E,4EAA4E;QAC5E,sEAAsE;QACtE,8EAA8E;QAC9E,2EAA2E;QAC3E,uCAAuC;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;oBACtE,WAAW;aACd;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-open-mcp",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "MCP server (stdio) routing tool calls to the live Unity Open MCP Bridge or batch Unity processes.",
   "type": "module",
   "main": "dist/index.js",