unity-open-mcp 0.6.1 → 0.8.2

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

@@ -1 +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,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,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"}
+{"version":3,"file":"gameobject-duplicate.js","sourceRoot":"","sources":["../../src/tools/gameobject-duplicate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CACzC,qCAAqC,EACrC,uFAAuF;IACrF,6FAA6F;IAC7F,0FAA0F;IAC1F,4FAA4F;IAC5F,sCAAsC,EACxC;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,2DAA2D;SACzE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;SAC/E;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;SAC/E;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,qEAAqE,EAAE;QACtH,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

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

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const gameobjectFind: Tool;
+export declare const gameobjectFind: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/gameobject-find.js

@@ -1,59 +1,54 @@
+import { makeTool } from "./schema-fragments.js";
 // 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: ["string", "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,
+export const gameobjectFind = makeTool("unity_open_mcp_gameobject_find", "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.", {
+    properties: {
+        instance_id: {
+            type: ["string", "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'.",
+        },
     },
-};
+});
 //# sourceMappingURL=gameobject-find.js.map

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

@@ -1 +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,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,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"}
+{"version":3,"file":"gameobject-find.js","sourceRoot":"","sources":["../../src/tools/gameobject-find.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,oEAAoE;AACpE,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CACpC,gCAAgC,EAChC,8FAA8F;IAC5F,8FAA8F;IAC9F,4FAA4F;IAC5F,4FAA4F;IAC5F,8FAA8F;IAC9F,4FAA4F;IAC5F,gGAAgG,EAClG;IACE,UAAU,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EACT,uFAAuF;gBACvF,oCAAoC;SACvC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+CAA+C;SAC7D;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+CAA+C;SAC7D;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iDAAiD;SAC/D;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;SACjE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,qFAAqF;gBACrF,2CAA2C;SAC9C;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EACT,sFAAsF;gBACtF,iBAAiB;SACpB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,mEAAmE;SACjF;KACF;CACN,CACF,CAAC"}

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

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const gameobjectModify: Tool;
+export declare const gameobjectModify: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

package/dist/tools/gameobject-modify.js

@@ -1,3 +1,4 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 2 — typed GameObject modify. Mutating: runs the full gate path.
 // Covers name / tag / layer / active AND transform (pos/rot/scale).
 //
@@ -10,77 +11,93 @@
 // Apply order: jsonPatches → pathPatches → gameObjectDiffs/flat. When any path
 // or json surface is present, the response carries a `surfaces` breakdown; a
 // legacy (root-only) call keeps the original compact result shape.
-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.\n\n" +
-        "Three-surface form (RFC 7396 JSON Merge Patch, additive): beyond the legacy flat fields you " +
-        "may pass gameObjectDiffs (root-target patches grouped in one object), " +
-        "pathPatchesPerGameObject ({childPath: diffs} applied to descendants of the target), and " +
-        "jsonPatchesPerGameObject ({componentTypeName: {field: value}} applied to the target's " +
-        "components via reflection, reusing object_modify's value shape). Apply order is " +
-        "jsonPatches → pathPatches → gameObjectDiffs/flat.",
-    inputSchema: {
-        type: "object",
-        required: ["paths_hint"],
-        properties: {
-            instance_id: {
-                type: ["string", "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 (legacy flat field). Omit to leave unchanged. Prefer gameObjectDiffs for new code.",
-            },
-            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.",
-            },
-            gameObjectDiffs: {
+export const gameobjectModify = makeTool("unity_open_mcp_gameobject_modify", "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.\n\n" +
+    "Three-surface form (RFC 7396 JSON Merge Patch, additive): beyond the legacy flat fields you " +
+    "may pass gameObjectDiffs (root-target patches grouped in one object), " +
+    "pathPatchesPerGameObject ({childPath: diffs} applied to descendants of the target), and " +
+    "jsonPatchesPerGameObject ({componentTypeName: {field: value}} applied to the target's " +
+    "components via reflection, reusing object_modify's value shape). Apply order is " +
+    "jsonPatches → pathPatches → gameObjectDiffs/flat.", {
+    required: ["paths_hint"],
+    properties: {
+        instance_id: {
+            type: ["string", "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 (legacy flat field). Omit to leave unchanged. Prefer gameObjectDiffs for new code.",
+        },
+        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.",
+        },
+        gameObjectDiffs: {
+            type: "object",
+            description: "M22 T22.1.4 surface 1 — root-target patches grouped in one object: " +
+                "{name, tag, layer, active, position, rotation, scale, local_space}. Same field shape as " +
+                "the legacy flat fields; when present, takes precedence over them. Omit any field to leave it unchanged.",
+            properties: {
+                name: { type: "string" },
+                tag: { type: "string" },
+                layer: { type: "integer", minimum: 0, maximum: 31 },
+                active: { type: "boolean" },
+                position: { type: "string" },
+                rotation: { type: "string" },
+                scale: { type: "string" },
+                local_space: { type: "boolean", default: false },
+            },
+            additionalProperties: false,
+        },
+        pathPatchesPerGameObject: {
+            type: "object",
+            description: "M22 T22.1.4 surface 2 — {childPath: diffs} applied to descendants of the target. Each " +
+                "key is a slash-delimited path relative to the target (e.g. \"Body/Arm\"); the value is " +
+                "the same diffs shape as gameObjectDiffs. Per-child errors accumulate and do not abort the batch.",
+            additionalProperties: {
                 type: "object",
-                description: "M22 T22.1.4 surface 1 — root-target patches grouped in one object: " +
-                    "{name, tag, layer, active, position, rotation, scale, local_space}. Same field shape as " +
-                    "the legacy flat fields; when present, takes precedence over them. Omit any field to leave it unchanged.",
+                description: "Diffs for the descendant GameObject at this path.",
                 properties: {
                     name: { type: "string" },
                     tag: { type: "string" },
@@ -93,51 +110,22 @@ export const gameobjectModify = {
                 },
                 additionalProperties: false,
             },
-            pathPatchesPerGameObject: {
-                type: "object",
-                description: "M22 T22.1.4 surface 2 — {childPath: diffs} applied to descendants of the target. Each " +
-                    "key is a slash-delimited path relative to the target (e.g. \"Body/Arm\"); the value is " +
-                    "the same diffs shape as gameObjectDiffs. Per-child errors accumulate and do not abort the batch.",
-                additionalProperties: {
-                    type: "object",
-                    description: "Diffs for the descendant GameObject at this path.",
-                    properties: {
-                        name: { type: "string" },
-                        tag: { type: "string" },
-                        layer: { type: "integer", minimum: 0, maximum: 31 },
-                        active: { type: "boolean" },
-                        position: { type: "string" },
-                        rotation: { type: "string" },
-                        scale: { type: "string" },
-                        local_space: { type: "boolean", default: false },
-                    },
-                    additionalProperties: false,
-                },
-            },
-            jsonPatchesPerGameObject: {
+        },
+        jsonPatchesPerGameObject: {
+            type: "object",
+            description: "M22 T22.1.4 surface 3 — {componentTypeName: mergePatch} applied to the root target's " +
+                "components via reflection. The key names a component type on the target (class name " +
+                "first, e.g. \"Rigidbody\", then full name); the value is a RFC 7396 merge patch " +
+                "{field: value} reusing object_modify's value shape (scalars, [x,y,z] vectors, " +
+                "{\"path\":...} refs). Per-component/per-field errors accumulate. Apply order: this " +
+                "surface runs before pathPatches and the root diff.",
+            additionalProperties: {
                 type: "object",
-                description: "M22 T22.1.4 surface 3 — {componentTypeName: mergePatch} applied to the root target's " +
-                    "components via reflection. The key names a component type on the target (class name " +
-                    "first, e.g. \"Rigidbody\", then full name); the value is a RFC 7396 merge patch " +
-                    "{field: value} reusing object_modify's value shape (scalars, [x,y,z] vectors, " +
-                    "{\"path\":...} refs). Per-component/per-field errors accumulate. Apply order: this " +
-                    "surface runs before pathPatches and the root diff.",
-                additionalProperties: {
-                    type: "object",
-                    description: "RFC 7396 merge patch of {fieldName: value} for this component.",
-                },
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — the scene path that contains the target.",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
+                description: "RFC 7396 merge patch of {fieldName: value} for this component.",
             },
         },
-        additionalProperties: false,
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the scene path that contains the target." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=gameobject-modify.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"gameobject-modify.js","sourceRoot":"","sources":["../../src/tools/gameobject-modify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gameobject-modify.js","sourceRoot":"","sources":["../../src/tools/gameobject-modify.ts"],"names":[],"mappings":"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"}

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

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const gameobjectSetParent: Tool;
+export declare const gameobjectSetParent: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+};

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

@@ -1,55 +1,47 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // 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: ["string", "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: ["string", "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",
-            },
+export const gameobjectSetParent = makeTool("unity_open_mcp_gameobject_set_parent", "Reparent a GameObject under another GameObject in the active scene, or detach it to the scene " +
+    "root. 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; pass an explicit empty parent_path with parent_instance_id=0 " +
+    "to detach the child to the scene root. world_position_stays (default true) preserves world " +
+    "transform across the reparent.", {
+    required: ["paths_hint"],
+    properties: {
+        instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Child GameObject instance ID. Highest priority resolver.",
         },
-        additionalProperties: false,
+        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: ["string", "integer"],
+            default: 0,
+            description: "New parent GameObject instance ID. Takes precedence over parent_path when both are set. " +
+                "Omit (or set 0) together with an explicit empty parent_path to detach to scene root.",
+        },
+        parent_path: {
+            type: "string",
+            description: "New parent hierarchy path \"Root/Parent\". Pass an explicit empty string (\"\") with " +
+                "parent_instance_id=0 to detach the child to the scene root.",
+        },
+        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: { ...PATHS_HINT_TYPE, description: "Mutation scope — the scene path that contains the child." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=gameobject-set-parent.js.map