unity-open-mcp 0.1.0

package/dist/tools/find-references.js

@@ -0,0 +1,29 @@
+export const findReferences = {
+    name: "unity_open_mcp_find_references",
+    description: "Reverse dependency lookup for assets. Returns all assets that reference the given asset path or GUID. " +
+        "Works offline (scanning YAML on disk) when no Editor is running, or via the live bridge when connected.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            asset_path: { type: "string", description: "Asset path (e.g. Assets/Prefabs/Player.prefab)" },
+            guid: { type: "string", pattern: "^[0-9a-fA-F]{32}$", description: "Asset GUID (32 hex chars)" },
+            detail: {
+                enum: ["summary", "normal", "verbose"],
+                default: "normal",
+                description: "summary: counts only. normal: referencing asset paths grouped by kind/folder. verbose: also includes which fields reference the target.",
+            },
+            max_results: { type: "integer", default: 100, description: "Maximum number of referencing assets to return" },
+            max_per_file: { type: "integer", default: 5, description: "Verbose mode: max field locations per file" },
+            pattern_threshold: {
+                type: "integer",
+                default: 0,
+                description: "Collapse folders with >= this many referencing files into a single summary entry (0 = disabled)",
+            },
+        },
+        oneOf: [
+            { required: ["asset_path"] },
+            { required: ["guid"] },
+        ],
+    },
+};
+//# sourceMappingURL=find-references.js.map

package/dist/tools/find-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-references.js","sourceRoot":"","sources":["../../src/tools/find-references.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,wGAAwG;QACxG,yGAAyG;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC7F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAChG,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,yIAAyI;aACvJ;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC7G,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACxG,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,iGAAiG;aAC/G;SACF;QACD,KAAK,EAAE;YACL,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;YAC5B,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;SACvB;KACF;CACF,CAAC"}

package/dist/tools/gameobject-create.d.ts

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

package/dist/tools/gameobject-create.js

@@ -0,0 +1,61 @@
+// M16 Plan 2 — typed GameObject create. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the destination scene path.
+export const gameobjectCreate = {
+    name: "unity_open_mcp_gameobject_create",
+    description: "Create a new GameObject in the active scene, optionally parented under an existing scene " +
+        "GameObject and pre-positioned. Pass `primitive_type` to spawn a Unity primitive (Cube/Sphere/" +
+        "Capsule/Cylinder/Plane/Quad) with its default renderer+collider. Mutating: runs the full gate " +
+        "path; `paths_hint` should be the destination scene path (the GameObject is a scene side-effect). " +
+        "Returns the new instance's instanceId, name, path, transform, and component list so the agent " +
+        "can immediately chain component_add / modify / set_parent without an extra lookup.",
+    inputSchema: {
+        type: "object",
+        required: ["name", "paths_hint"],
+        properties: {
+            name: {
+                type: "string",
+                description: "Name for the new GameObject.",
+            },
+            primitive_type: {
+                type: "string",
+                enum: ["Cube", "Sphere", "Capsule", "Cylinder", "Plane", "Quad"],
+                description: "When set, the GameObject is created via GameObject.CreatePrimitive (adds the matching " +
+                    "MeshFilter/MeshRenderer/Collider). Omit for an empty GameObject.",
+            },
+            parent_path: {
+                type: "string",
+                description: "Optional destination scene path \"Root/Parent\" — the parent must already exist. " +
+                    "Omit to create at scene root.",
+            },
+            position: {
+                type: "string",
+                description: "Optional position as \"x,y,z\". Defaults to 0,0,0.",
+            },
+            rotation: {
+                type: "string",
+                description: "Optional Euler rotation in degrees as \"x,y,z\". Defaults to 0,0,0.",
+            },
+            scale: {
+                type: "string",
+                description: "Optional scale as \"x,y,z\". Defaults to 1,1,1.",
+            },
+            local_space: {
+                type: "boolean",
+                default: false,
+                description: "When true, position/rotation are interpreted in the parent's local space (matches " +
+                    "the Inspector when the GameObject is parented). Default false = world space.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — include the active scene path (the GameObject is a scene side-effect).",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-create.js.map

package/dist/tools/gameobject-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-create.js","sourceRoot":"","sources":["../../src/tools/gameobject-create.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,2FAA2F;QAC3F,+FAA+F;QAC/F,gGAAgG;QAChG,mGAAmG;QACnG,gGAAgG;QAChG,oFAAoF;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;gBAChE,WAAW,EACT,wFAAwF;oBACxF,kEAAkE;aACrE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,+BAA+B;aAClC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qEAAqE;aACnF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,oFAAoF;oBACpF,8EAA8E;aACjF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yFAAyF;aAC5F;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-destroy.d.ts

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

package/dist/tools/gameobject-destroy.js

@@ -0,0 +1,38 @@
+// M16 Plan 2 — typed GameObject destroy. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the scene that contains the target.
+export const gameobjectDestroy = {
+    name: "unity_open_mcp_gameobject_destroy",
+    description: "Destroy a GameObject (and its children) in the active scene. Undo-recorded. Mutating: runs " +
+        "the full gate path; `paths_hint` is the scene path that contains the target. Address the " +
+        "target by instance_id (canonical) > path > name — same vocabulary as spatial_query.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Target GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Target hierarchy path \"Root/Child\". Middle-priority resolver.",
+            },
+            name: {
+                type: "string",
+                description: "Target GameObject name (first match). Lowest priority resolver.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the target.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-destroy.js.map

package/dist/tools/gameobject-destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-destroy.js","sourceRoot":"","sources":["../../src/tools/gameobject-destroy.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,6FAA6F;QAC7F,2FAA2F;QAC3F,qFAAqF;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,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,iEAAiE;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-duplicate.d.ts

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

package/dist/tools/gameobject-duplicate.js

@@ -0,0 +1,40 @@
+// M16 Plan 2 — typed GameObject duplicate. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the scene that contains the target.
+export const gameobjectDuplicate = {
+    name: "unity_open_mcp_gameobject_duplicate",
+    description: "Duplicate a GameObject (and its children) in the active scene, preserving the parent " +
+        "relationship and transform. Undo-recorded. Mutating: runs the full gate path; `paths_hint` " +
+        "is the scene path that contains the target. Returns the clone's instanceId, name, path, " +
+        "transform, and component list so the agent can immediately chain further ops. Address the " +
+        "source by instance_id > path > name.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Source GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Source hierarchy path \"Root/Child\". Middle-priority resolver.",
+            },
+            name: {
+                type: "string",
+                description: "Source GameObject name (first match). Lowest priority resolver.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the source and clone.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-duplicate.js.map

package/dist/tools/gameobject-duplicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-duplicate.js","sourceRoot":"","sources":["../../src/tools/gameobject-duplicate.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,uFAAuF;QACvF,6FAA6F;QAC7F,0FAA0F;QAC1F,4FAA4F;QAC5F,sCAAsC;IACxC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,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,iEAAiE;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,qEAAqE;aACnF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-find.d.ts

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

package/dist/tools/gameobject-find.js

@@ -0,0 +1,59 @@
+// M16 Plan 2 — read-only GameObject find. Gate-free, token-bounded.
+// Two modes: (a) targeted lookup by instance_id/path/name → single-object
+// result; (b) list mode (no target) → enumerate with optional filters.
+export const gameobjectFind = {
+    name: "unity_open_mcp_gameobject_find",
+    description: "Find GameObjects in loaded scenes. Read-only (gate-free). Two modes: (a) targeted lookup by " +
+        "instance_id / path / name — returns a single-object result (empty list when not found, with " +
+        "notFound=true); (b) list mode (omit all three) — enumerates loaded-scene GameObjects with " +
+        "optional filters (name_contains, tag, component, root_only), bounded by max_results. Each " +
+        "result includes instanceId, name, path, active, tag, layer, scene, transform, and component " +
+        "list so the agent can chain add/modify/set_parent without an extra call. Prefer this over " +
+        "raw invoke_method GameObject.Find* — structured output + addressing parity with spatial_query.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Targeted mode: GameObject instance ID. When set (or path/name set), returns a single " +
+                    "object. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Targeted mode: hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Targeted mode: GameObject name (first match).",
+            },
+            name_contains: {
+                type: "string",
+                description: "List mode: substring filter on GameObject name.",
+            },
+            tag: {
+                type: "string",
+                description: "List mode: filter by tag (must be a defined tag).",
+            },
+            component: {
+                type: "string",
+                description: "List mode: filter by component type name (class or full name). The GameObject must " +
+                    "have a component whose type name matches.",
+            },
+            root_only: {
+                type: "boolean",
+                default: false,
+                description: "List mode: only return root-level GameObjects (skip children). Default false = full " +
+                    "hierarchy walk.",
+            },
+            max_results: {
+                type: "integer",
+                default: 50,
+                minimum: 1,
+                description: "Max objects returned; remaining count is reported in 'truncated'.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-find.js.map

package/dist/tools/gameobject-find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-find.js","sourceRoot":"","sources":["../../src/tools/gameobject-find.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,8FAA8F;QAC9F,8FAA8F;QAC9F,4FAA4F;QAC5F,4FAA4F;QAC5F,8FAA8F;QAC9F,4FAA4F;QAC5F,gGAAgG;IAClG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,uFAAuF;oBACvF,oCAAoC;aACvC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qFAAqF;oBACrF,2CAA2C;aAC9C;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,sFAAsF;oBACtF,iBAAiB;aACpB;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,mEAAmE;aACjF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-modify.d.ts

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

package/dist/tools/gameobject-modify.js

@@ -0,0 +1,76 @@
+// M16 Plan 2 — typed GameObject modify. Mutating: runs the full gate path.
+// Covers name / tag / layer / active AND transform (pos/rot/scale).
+export const gameobjectModify = {
+    name: "unity_open_mcp_gameobject_modify",
+    description: "Modify one or more GameObject fields in a single call: name, tag, layer, active, and " +
+        "transform (position, rotation, scale). Only provided fields are touched; omitted fields are " +
+        "preserved. Undo-recorded. Mutating: runs the full gate path; `paths_hint` is the scene path " +
+        "that contains the target. Use local_space=true to interpret transform values in the parent's " +
+        "local space (matches Inspector). Address the target by instance_id > path > name.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Target GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Target hierarchy path \"Root/Child\".",
+            },
+            name_target: {
+                type: "string",
+                description: "Target GameObject name (first match). Lowest priority resolver.",
+            },
+            name: {
+                type: "string",
+                description: "New name. Omit to leave unchanged.",
+            },
+            tag: {
+                type: "string",
+                description: "New tag. Must be a defined tag (use editor_get_tags from Plan 5 to enumerate). Omit to leave unchanged.",
+            },
+            layer: {
+                type: "integer",
+                minimum: 0,
+                maximum: 31,
+                description: "New layer index (0-31). Omit to leave unchanged.",
+            },
+            active: {
+                type: "boolean",
+                description: "Toggle active state. Omit to leave unchanged.",
+            },
+            position: {
+                type: "string",
+                description: "New position as \"x,y,z\". Omit to leave unchanged.",
+            },
+            rotation: {
+                type: "string",
+                description: "New Euler rotation in degrees as \"x,y,z\". Omit to leave unchanged.",
+            },
+            scale: {
+                type: "string",
+                description: "New scale as \"x,y,z\". Omit to leave unchanged.",
+            },
+            local_space: {
+                type: "boolean",
+                default: false,
+                description: "When true, position/rotation are local-space (parent-relative). Default false = world " +
+                    "space. Unset fields inherit the same space as the previously-set value so they round-trip cleanly.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the target.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-modify.js.map

package/dist/tools/gameobject-modify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-modify.js","sourceRoot":"","sources":["../../src/tools/gameobject-modify.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,uFAAuF;QACvF,8FAA8F;QAC9F,8FAA8F;QAC9F,+FAA+F;QAC/F,mFAAmF;IACrF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,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,uCAAuC;aACrD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yGAAyG;aAC5G;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,kDAAkD;aAChE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+CAA+C;aAC7D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,wFAAwF;oBACxF,oGAAoG;aACvG;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gameobject-set-parent.d.ts

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

package/dist/tools/gameobject-set-parent.js

@@ -0,0 +1,55 @@
+// M16 Plan 2 — typed GameObject reparent. Mutating: runs the full gate path.
+// Scene side-effect — scope paths_hint to the scene that contains the target.
+export const gameobjectSetParent = {
+    name: "unity_open_mcp_gameobject_set_parent",
+    description: "Reparent a GameObject under another GameObject in the active scene. Undo-recorded. Cycle-safe " +
+        "(refuses to parent a GameObject under one of its own descendants). Mutating: runs the full " +
+        "gate path; `paths_hint` is the scene path that contains the target. Address the child by " +
+        "instance_id > path > name. Identify the new parent by parent_instance_id or parent_path. " +
+        "world_position_stays (default true) preserves world transform across the reparent.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            instance_id: {
+                type: "integer",
+                default: 0,
+                description: "Child GameObject instance ID. Highest priority resolver.",
+            },
+            path: {
+                type: "string",
+                description: "Child hierarchy path \"Root/Child\".",
+            },
+            name: {
+                type: "string",
+                description: "Child GameObject name (first match). Lowest priority resolver.",
+            },
+            parent_instance_id: {
+                type: "integer",
+                default: 0,
+                description: "New parent GameObject instance ID. Takes precedence over parent_path when both are set.",
+            },
+            parent_path: {
+                type: "string",
+                description: "New parent hierarchy path \"Root/Parent\".",
+            },
+            world_position_stays: {
+                type: "boolean",
+                default: true,
+                description: "When true (default), preserves the GameObject's world position/rotation/scale across " +
+                    "the reparent. Set false to keep local-space values instead.",
+            },
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                description: "Mutation scope — the scene path that contains the child.",
+            },
+            gate: {
+                enum: ["enforce", "warn", "off"],
+                default: "enforce",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gameobject-set-parent.js.map

package/dist/tools/gameobject-set-parent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameobject-set-parent.js","sourceRoot":"","sources":["../../src/tools/gameobject-set-parent.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EACT,gGAAgG;QAChG,6FAA6F;QAC7F,2FAA2F;QAC3F,2FAA2F;QAC3F,oFAAoF;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,0DAA0D;aACxE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gEAAgE;aAC9E;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,yFAAyF;aAC5F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,oBAAoB,EAAE;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,uFAAuF;oBACvF,6DAA6D;aAChE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0DAA0D;aACxE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/gate-budget-estimate.d.ts

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

package/dist/tools/gate-budget-estimate.js

@@ -0,0 +1,59 @@
+// M16 Plan 8 — gate intelligence. gate_budget_estimate forecasts the cost of
+// validating a planned mutation scope before paying for it. It composes
+// VerifyGateAdapter.ResolveRuleIds + VerifyCacheService / VerifyRunner to
+// return an estimatedDurationMs + estimatedIssueBudget plus a confidence band
+// and the basis the estimate was derived from.
+//
+// Two modes:
+//   - "cache"  (default): inspect the most recent VerifyCacheService snapshot.
+//                Cheap and deterministic, but coarse (the cache is a single
+//                global snapshot, not keyed by scope).
+//   - "sample": run a cheap Checkpoint-mode scan over the resolved scope and
+//                time it. More accurate, pays one scan.
+//
+// Heuristic only — checkpoint-mode is lighter than full validation, so the
+// duration estimate is a lower bound. Run validate_edit to measure actuals.
+// No Unity-MCP / UCP / UUMCP equivalent; composed from existing foundations.
+export const gateBudgetEstimate = {
+    name: "unity_open_mcp_gate_budget_estimate",
+    description: "Forecast validation duration + issue budget for a planned mutation scope before mutating. Returns " +
+        "estimatedDurationMs (a lower bound on the real gate path), estimatedIssueBudget (an upper bound on " +
+        "issues the gate might surface), the resolved rule set, and the basis + confidence of the estimate. " +
+        "Read-only and gate-free. Use mode 'cache' (default) for a cheap, coarse signal or 'sample' for a " +
+        "grounded-but-paid measurement. The estimate is heuristic — run validate_edit for actuals.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                minItems: 1,
+                description: "Scope to forecast — the same vocabulary the gate uses.",
+            },
+            categories: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional explicit verify rule IDs. Auto-selected from paths when omitted.",
+            },
+            include_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Allow-list applied to the resolved rule set.",
+            },
+            exclude_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Deny-list. Always wins over categories and include_rules.",
+            },
+            mode: {
+                enum: ["cache", "sample"],
+                default: "cache",
+                description: "'cache' (default) inspects the latest VerifyCacheService snapshot (cheap, coarse). 'sample' " +
+                    "runs a cheap checkpoint-mode scan over the scope and times it (grounded, paid).",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=gate-budget-estimate.js.map

package/dist/tools/gate-budget-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-budget-estimate.js","sourceRoot":"","sources":["../../src/tools/gate-budget-estimate.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,aAAa;AACb,+EAA+E;AAC/E,4EAA4E;AAC5E,uDAAuD;AACvD,6EAA6E;AAC7E,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,oGAAoG;QACpG,qGAAqG;QACrG,qGAAqG;QACrG,mGAAmG;QACnG,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,wDAAwD;aACtE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2EAA2E;aACzF;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,8CAA8C;aAC5D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACzB,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,8FAA8F;oBAC9F,iFAAiF;aACpF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/generate-skill.d.ts

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

package/dist/tools/generate-skill.js

@@ -0,0 +1,37 @@
+import { knownClientKeys } from "../skill/client-paths.js";
+// The `clients` enum is derived from the single-source manifest at
+// `skills/client-paths.json`. Do not hand-maintain a literal array
+// here — edit the manifest instead.
+const CLIENT_ENUM = knownClientKeys();
+const clientListDoc = CLIENT_ENUM.map((c) => `\`${c}\``).join(", ");
+export const generateSkill = {
+    name: "unity_open_mcp_generate_skill",
+    description: "Generate a project-specific agent skill file (SKILL.md) that reflects the " +
+        "actual project state: Unity version, installed packages (including bridge/verify " +
+        "versions), available tools and verify rules, key MonoBehaviour/ScriptableObject " +
+        "types, and the mutate→gate→fix workflow. Set write=true to persist the file into " +
+        "the client skill directories derived from skills/client-paths.json. Regenerate " +
+        "after package or script changes to keep the skill current.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            write: {
+                type: "boolean",
+                default: false,
+                description: "When true, write the generated skill file to the client skill directories. " +
+                    "When false (default), return the skill content as a string for preview.",
+            },
+            clients: {
+                type: "array",
+                items: {
+                    enum: CLIENT_ENUM,
+                },
+                description: "Which client skill directories to write to. Only used when write=true. " +
+                    `Defaults to ["claude"]. Allowed values: ${clientListDoc}. Each entry writes ` +
+                    "to the project-relative path declared for that client in skills/client-paths.json.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=generate-skill.js.map

package/dist/tools/generate-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-skill.js","sourceRoot":"","sources":["../../src/tools/generate-skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,mEAAmE;AACnE,mEAAmE;AACnE,oCAAoC;AACpC,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;AACtC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,4EAA4E;QAC5E,mFAAmF;QACnF,kFAAkF;QAClF,mFAAmF;QACnF,iFAAiF;QACjF,4DAA4D;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,6EAA6E;oBAC7E,yEAAyE;aAC5E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,WAAW;iBAClB;gBACD,WAAW,EACT,yEAAyE;oBACzE,2CAA2C,aAAa,sBAAsB;oBAC9E,oFAAoF;aACvF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/impact-preview.d.ts

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

package/dist/tools/impact-preview.js

@@ -0,0 +1,50 @@
+// M16 Plan 8 — gate intelligence. impact_preview is a read-only, gate-free
+// pre-mutation projection of what the gate would look at for a given scope.
+// It composes VerifyGateAdapter.ResolveRuleIds (which rules apply) with
+// AssetDatabase (does each path exist, what asset kind) — it does NOT run a
+// rule scan. That is what validate_edit is for. impact_preview answers "if I
+// mutate this scope, what will the gate inspect, and how big is the surface?"
+// so an agent can size risk before paying for a checkpoint.
+//
+// Heuristic only — confidence bounds are surfaced in the response so an agent
+// treats the risk band as guidance, not ground truth. No Unity-MCP / UCP /
+// UUMCP equivalent; composed from existing gate/verify foundations.
+export const impactPreview = {
+    name: "unity_open_mcp_impact_preview",
+    description: "Project the gate's view of a planned mutation scope WITHOUT mutating. Resolves the auto-selected " +
+        "verify rule set for the given `paths_hint`, classifies each path (exists / folder / asset kind / " +
+        "rules-for-extension), and reports a coarse risk band (low / moderate / high) with an explicit " +
+        "confidence level. Read-only and gate-free — it does not run a rule scan, only projects scope. " +
+        "Use validate_edit to confirm actual issues before or after mutating.",
+    inputSchema: {
+        type: "object",
+        required: ["paths_hint"],
+        properties: {
+            paths_hint: {
+                type: "array",
+                items: { type: "string" },
+                minItems: 1,
+                description: "Scope to project — the same vocabulary the gate uses. Asset paths, folder scopes " +
+                    "(Assets/-rooted), Packages/manifest.json, or ProjectSettings/*.asset.",
+            },
+            categories: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional explicit verify rule IDs. Auto-selected from paths when omitted (same semantics " +
+                    "as validate_edit / scan_paths).",
+            },
+            include_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Allow-list applied to the resolved rule set (same semantics as validate_edit).",
+            },
+            exclude_rules: {
+                type: "array",
+                items: { type: "string" },
+                description: "Deny-list. Always wins over categories and include_rules.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=impact-preview.js.map

package/dist/tools/impact-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-preview.js","sourceRoot":"","sources":["../../src/tools/impact-preview.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,mGAAmG;QACnG,mGAAmG;QACnG,gGAAgG;QAChG,gGAAgG;QAChG,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,QAAQ,EAAE,CAAC;gBACX,WAAW,EACT,mFAAmF;oBACnF,uEAAuE;aAC1E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,2FAA2F;oBAC3F,iCAAiC;aACpC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,gFAAgF;aAC9F;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,30 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const M2_TOOLS: Tool[];
+export declare const M2_5_TOOLS: Tool[];
+export declare const M3_TOOLS: Tool[];
+export declare const M5_TOOLS: Tool[];
+export declare const M9_TOOLS: Tool[];
+export declare const M10_TOOLS: Tool[];
+export declare const M20_PLAN1_TOOLS: Tool[];
+export declare const M11_TOOLS: Tool[];
+export declare const M12_TOOLS: Tool[];
+export declare const M13_TOOLS: Tool[];
+export declare const M14_TOOLS: Tool[];
+export declare const BRIDGE_ADMIN_TOOLS: Tool[];
+export declare const M18_PLAN2_TOOLS: Tool[];
+export declare const M16_PLAN1_TOOLS: Tool[];
+export declare const M16_PLAN2_TOOLS: Tool[];
+export declare const M16_PLAN3_TOOLS: Tool[];
+export declare const M16_PLAN4_TOOLS: Tool[];
+export declare const M16_PLAN5_TOOLS: Tool[];
+export declare const M16_PLAN6_TOOLS: Tool[];
+export declare const M16_PLAN7_TOOLS: Tool[];
+export declare const M16_PLAN8_TOOLS: Tool[];
+export declare const M16_PLAN9_TOOLS: Tool[];
+export declare const M16_PLAN10_TOOLS: Tool[];
+export declare const M16_PLAN10_INPUTSYSTEM_TOOLS: Tool[];
+export declare const M16_PLAN10_PROBUILDER_TOOLS: Tool[];
+export declare const M16_PLAN10_PARTICLESYSTEM_TOOLS: Tool[];
+export declare const M16_PLAN10_ANIMATION_TOOLS: Tool[];
+export declare const M18_PLAN7_SPLINES_TOOLS: Tool[];
+export declare const ALL_TOOLS: Tool[];