unity-open-mcp 0.6.1 → 0.8.2

package/dist/tools/component-get.js

@@ -1,87 +1,82 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 2 / M30 Plan 4 — read-only component get. Gate-free, profile-bounded.
 // Returns the serialized field/property list of one component.
-export const componentGet = {
-    name: "unity_open_mcp_component_get",
-    description: "Read the serialized fields and (optionally) public properties of a single Component on a " +
-        "GameObject. Read-only (gate-free). Defaults to profile=\"compact\" (top-level serialized " +
-        "fields only; public properties omitted unless include_properties is true). Returns each " +
-        "field's path (SerializedProperty path), type, and current value so an agent can plan a " +
-        "component_modify without trial-and-error. Use property_path to drill into one subtree; use " +
-        "profile=\"balanced\" / \"full\" or page_size + cursor to expand without unbounded dumps. " +
-        "Address the host by instance_id > path > name; identify the component by instance_id " +
-        "(specific instance) or type_name (full name preferred, class-name fallback).",
-    inputSchema: {
-        type: "object",
-        properties: {
-            instance_id: {
-                type: ["string", "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.",
-            },
-            type_name: {
-                type: "string",
-                description: "Component type to read (full name preferred, class-name fallback). Use this OR " +
-                    "component_instance_id. Ignored when component_instance_id is set.",
-            },
-            component_instance_id: {
-                type: ["string", "integer"],
-                default: 0,
-                description: "Specific Component instance ID (for types that allow multiples). Takes precedence " +
-                    "over type_name when set.",
-            },
-            profile: {
-                type: "string",
-                enum: ["compact", "balanced", "full"],
-                default: "compact",
-                description: "Output verbosity. compact (default) = top-level SerializedObject fields only; " +
-                    "balanced = + leaf public properties; full = + nested serialized children up to max_depth.",
-            },
-            page_size: {
-                type: ["string", "integer"],
-                minimum: 1,
-                description: "When set, page the combined fields+properties stream. Response carries pagination " +
-                    "with next_cursor (component_get:<offset>). Omit to receive the whole profile-shaped " +
-                    "payload up to max_fields.",
-            },
-            cursor: {
-                type: "string",
-                description: "Opaque continuation token from a previous pagination.next_cursor. Mismatched cursors " +
-                    "restart from the first page.",
-            },
-            property_path: {
-                type: "string",
-                description: "Drill into one SerializedProperty subtree by path (e.g. m_LocalPosition, m_Color.r). " +
-                    "Omit to read the component root per profile.",
-            },
-            max_depth: {
-                type: ["string", "integer"],
-                default: 3,
-                minimum: 1,
-                description: "Nested serialized depth cap when profile=\"full\" (default 3).",
-            },
-            max_fields: {
-                type: ["string", "integer"],
-                minimum: 1,
-                description: "Max fields+properties collected. Fields hidden by this cap are reported in the top-level " +
-                    "`truncated` count (raise max_fields or switch to profile=full to see them); when page_size " +
-                    "is set, fields after the current page window are reported separately in pagination.truncated " +
-                    "(page on via next_cursor). Profile defaults: compact=40, balanced=100, full=200.",
-            },
-            include_properties: {
-                type: "boolean",
-                description: "Include non-serialized public properties (e.g. Rigidbody.velocity). Profile default: " +
-                    "false for compact, true for balanced/full. Set explicitly to override.",
-            },
+export const componentGet = makeTool("unity_open_mcp_component_get", "Read the serialized fields and (optionally) public properties of a single Component on a " +
+    "GameObject. Read-only (gate-free). Defaults to profile=\"compact\" (top-level serialized " +
+    "fields only; public properties omitted unless include_properties is true). Returns each " +
+    "field's path (SerializedProperty path), type, and current value so an agent can plan a " +
+    "component_modify without trial-and-error. Use property_path to drill into one subtree; use " +
+    "profile=\"balanced\" / \"full\" or page_size + cursor to expand without unbounded dumps. " +
+    "Address the host by instance_id > path > name; identify the component by instance_id " +
+    "(specific instance) or type_name (full name preferred, class-name fallback).", {
+    properties: {
+        instance_id: {
+            type: ["string", "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.",
+        },
+        type_name: {
+            type: "string",
+            description: "Component type to read (full name preferred, class-name fallback). Use this OR " +
+                "component_instance_id. Ignored when component_instance_id is set.",
+        },
+        component_instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Specific Component instance ID (for types that allow multiples). Takes precedence " +
+                "over type_name when set.",
+        },
+        profile: {
+            type: "string",
+            enum: ["compact", "balanced", "full"],
+            default: "compact",
+            description: "Output verbosity. compact (default) = top-level SerializedObject fields only; " +
+                "balanced = + leaf public properties; full = + nested serialized children up to max_depth.",
+        },
+        page_size: {
+            type: ["string", "integer"],
+            minimum: 1,
+            description: "When set, page the combined fields+properties stream. Response carries pagination " +
+                "with next_cursor (component_get:<offset>). Omit to receive the whole profile-shaped " +
+                "payload up to max_fields.",
+        },
+        cursor: {
+            type: "string",
+            description: "Opaque continuation token from a previous pagination.next_cursor. Mismatched cursors " +
+                "restart from the first page.",
+        },
+        property_path: {
+            type: "string",
+            description: "Drill into one SerializedProperty subtree by path (e.g. m_LocalPosition, m_Color.r). " +
+                "Omit to read the component root per profile.",
+        },
+        max_depth: {
+            type: ["string", "integer"],
+            default: 3,
+            minimum: 1,
+            description: "Nested serialized depth cap when profile=\"full\" (default 3).",
+        },
+        max_fields: {
+            type: ["string", "integer"],
+            minimum: 1,
+            description: "Max fields+properties collected. Fields hidden by this cap are reported in the top-level " +
+                "`truncated` count (raise max_fields or switch to profile=full to see them); when page_size " +
+                "is set, fields after the current page window are reported separately in pagination.truncated " +
+                "(page on via next_cursor). Profile defaults: compact=40, balanced=100, full=200.",
+        },
+        include_properties: {
+            type: "boolean",
+            description: "Include non-serialized public properties (e.g. Rigidbody.velocity). Profile default: " +
+                "false for compact, true for balanced/full. Set explicitly to override.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=component-get.js.map

package/dist/tools/component-get.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-get.js","sourceRoot":"","sources":["../../src/tools/component-get.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,2FAA2F;QAC3F,2FAA2F;QAC3F,0FAA0F;QAC1F,yFAAyF;QACzF,6FAA6F;QAC7F,2FAA2F;QAC3F,uFAAuF;QACvF,8EAA8E;IAChF,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,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,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iFAAiF;oBACjF,mEAAmE;aACtE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,0BAA0B;aAC7B;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,gFAAgF;oBAChF,2FAA2F;aAC9F;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,sFAAsF;oBACtF,2BAA2B;aAC9B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,8BAA8B;aACjC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,8CAA8C;aACjD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,gEAAgE;aAC9E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,2FAA2F;oBAC3F,6FAA6F;oBAC7F,+FAA+F;oBAC/F,kFAAkF;aACrF;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,uFAAuF;oBACvF,wEAAwE;aAC3E;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"component-get.js","sourceRoot":"","sources":["../../src/tools/component-get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,iFAAiF;AACjF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,8BAA8B,EAC9B,2FAA2F;IACzF,2FAA2F;IAC3F,0FAA0F;IAC1F,yFAAyF;IACzF,6FAA6F;IAC7F,2FAA2F;IAC3F,uFAAuF;IACvF,8EAA8E,EAChF;IACE,UAAU,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,yDAAyD;SACvE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qCAAqC;SACnD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iFAAiF;gBACjF,mEAAmE;SACtE;QACD,qBAAqB,EAAE;YACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EACT,oFAAoF;gBACpF,0BAA0B;SAC7B;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;YACrC,OAAO,EAAE,SAAS;YAClB,WAAW,EACT,gFAAgF;gBAChF,2FAA2F;SAC9F;QACD,SAAS,EAAE;YACT,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EACT,oFAAoF;gBACpF,sFAAsF;gBACtF,2BAA2B;SAC9B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uFAAuF;gBACvF,8BAA8B;SACjC;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uFAAuF;gBACvF,8CAA8C;SACjD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,gEAAgE;SAC9E;QACD,UAAU,EAAE;YACV,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EACT,2FAA2F;gBAC3F,6FAA6F;gBAC7F,+FAA+F;gBAC/F,kFAAkF;SACrF;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,uFAAuF;gBACvF,wEAAwE;SAC3E;KACF;CACN,CACF,CAAC"}

package/dist/tools/component-list-all.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const componentListAll: Tool;
+export declare const componentListAll: {
+    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/component-list-all.js

@@ -1,38 +1,33 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 2 — read-only component catalog. Gate-free, token-bounded.
-export const componentListAll = {
-    name: "unity_open_mcp_component_list_all",
-    description: "Enumerate component types that can be attached via AddComponent — built-in + project " +
-        "MonoBehaviours from every loaded assembly. Read-only (gate-free). Token-bounded by " +
-        "max_results. Use the optional `query` substring to narrow by namespace/type-name (case-" +
-        "insensitive, matched against both the full name and the bare class name). Each entry " +
-        "returns fullName (use this in component_add / type_name), name (short class name), " +
-        "namespace, assembly, and builtin flag. Use this before component_add to discover valid type names.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            query: {
-                type: "string",
-                description: "Optional case-insensitive substring filter on the type's full name OR class name. " +
-                    "Example: \"Rigidbody\" matches UnityEngine.Rigidbody and MyNamespace.RigidbodyController.",
-            },
-            max_results: {
-                type: "integer",
-                default: 200,
-                minimum: 1,
-                description: "Max types returned; remaining count is reported in 'truncated'.",
-            },
-            include_builtin: {
-                type: "boolean",
-                default: true,
-                description: "Include Unity built-in components (UnityEngine.* / UnityEditor.* assemblies). Default true.",
-            },
-            include_project: {
-                type: "boolean",
-                default: true,
-                description: "Include project + package MonoBehaviours from loaded assemblies. Default true.",
-            },
+export const componentListAll = makeTool("unity_open_mcp_component_list_all", "Enumerate component types that can be attached via AddComponent — built-in + project " +
+    "MonoBehaviours from every loaded assembly. Read-only (gate-free). Token-bounded by " +
+    "max_results. Use the optional `query` substring to narrow by namespace/type-name (case-" +
+    "insensitive, matched against both the full name and the bare class name). Each entry " +
+    "returns fullName (use this in component_add / type_name), name (short class name), " +
+    "namespace, assembly, and builtin flag. Use this before component_add to discover valid type names.", {
+    properties: {
+        query: {
+            type: "string",
+            description: "Optional case-insensitive substring filter on the type's full name OR class name. " +
+                "Example: \"Rigidbody\" matches UnityEngine.Rigidbody and MyNamespace.RigidbodyController.",
+        },
+        max_results: {
+            type: "integer",
+            default: 200,
+            minimum: 1,
+            description: "Max types returned; remaining count is reported in 'truncated'.",
+        },
+        include_builtin: {
+            type: "boolean",
+            default: true,
+            description: "Include Unity built-in components (UnityEngine.* / UnityEditor.* assemblies). Default true.",
+        },
+        include_project: {
+            type: "boolean",
+            default: true,
+            description: "Include project + package MonoBehaviours from loaded assemblies. Default true.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=component-list-all.js.map

package/dist/tools/component-list-all.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-list-all.js","sourceRoot":"","sources":["../../src/tools/component-list-all.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,uFAAuF;QACvF,qFAAqF;QACrF,yFAAyF;QACzF,uFAAuF;QACvF,qFAAqF;QACrF,oGAAoG;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oFAAoF;oBACpF,2FAA2F;aAC9F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,iEAAiE;aAC/E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,6FAA6F;aAChG;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,gFAAgF;aACnF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"component-list-all.js","sourceRoot":"","sources":["../../src/tools/component-list-all.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,mCAAmC,EACnC,uFAAuF;IACrF,qFAAqF;IACrF,yFAAyF;IACzF,uFAAuF;IACvF,qFAAqF;IACrF,oGAAoG,EACtG;IACE,UAAU,EAAE;QACN,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oFAAoF;gBACpF,2FAA2F;SAC9F;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,iEAAiE;SAC/E;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACT,6FAA6F;SAChG;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACT,gFAAgF;SACnF;KACF;CACN,CACF,CAAC"}

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

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const componentModify: Tool;
+export declare const componentModify: {
+    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/component-modify.js

@@ -1,80 +1,68 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 2 — typed component modify. Mutating: runs the full gate path.
 // Per-path serialized patches via SerializedObject.
-export const componentModify = {
-    name: "unity_open_mcp_component_modify",
-    description: "Modify serialized fields on a Component by path via SerializedObject. Undo-recorded. " +
-        "Mutating: runs the full gate path; `paths_hint` is the scene path that contains the host. " +
-        "`fields` is an array of {path, value, type?} patches where `path` is the SerializedProperty " +
-        "path (e.g. \"m_Color\", \"m_Mass\", \"m_Colors.Array.data[0]\"). Per-entry errors are " +
-        "accumulated, so a single bad patch does not abort the batch. Use component_get first to " +
-        "discover valid paths and value types. Address the host by instance_id > path > name; " +
-        "identify the component by component_instance_id or type_name.",
-    inputSchema: {
-        type: "object",
-        required: ["fields", "paths_hint"],
-        properties: {
-            instance_id: {
-                type: ["string", "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.",
-            },
-            type_name: {
-                type: "string",
-                description: "Component type to modify (full name preferred, class-name fallback). Use this OR " +
-                    "component_instance_id. Ignored when component_instance_id is set.",
-            },
-            component_instance_id: {
-                type: ["string", "integer"],
-                default: 0,
-                description: "Specific Component instance ID. Takes precedence over type_name when set.",
-            },
-            fields: {
-                type: "array",
-                description: "Serialized-property patches to apply in order. Each entry: { path: string, value: any, type?: \"name\" | \"int\" }. " +
-                    "value shape depends on the property's SerializedPropertyType — see component_get output. " +
-                    "For enum properties, set type=\"name\" to set by enum name (default is int index). " +
-                    "For object references, value is {\"path\": \"Assets/...\"} or {\"instance_id\": N} or null.",
-                items: {
-                    type: "object",
-                    required: ["path", "value"],
-                    properties: {
-                        path: {
-                            type: "string",
-                            description: "SerializedProperty.propertyPath (e.g. \"m_Color\", \"m_Mass\").",
-                        },
-                        value: {
-                            description: "New value. Scalars/strings/bools as JSON primitives; vectors/colors as [x,y,(z,(w))]; " +
-                                "object references as {\"path\": \"...\"} or null; enums as int (default) or name " +
-                                "(when type=\"name\").",
-                        },
-                        type: {
-                            type: "string",
-                            enum: ["name", "int"],
-                            description: "Optional hint. \"name\" = interpret value as an enum NAME (default is int index).",
-                        },
+export const componentModify = makeTool("unity_open_mcp_component_modify", "Modify serialized fields on a Component by path via SerializedObject. Undo-recorded. " +
+    "Mutating: runs the full gate path; `paths_hint` is the scene path that contains the host. " +
+    "`fields` is an array of {path, value, type?} patches where `path` is the SerializedProperty " +
+    "path (e.g. \"m_Color\", \"m_Mass\", \"m_Colors.Array.data[0]\"). Per-entry errors are " +
+    "accumulated, so a single bad patch does not abort the batch. Use component_get first to " +
+    "discover valid paths and value types. Address the host by instance_id > path > name; " +
+    "identify the component by component_instance_id or type_name.", {
+    required: ["fields", "paths_hint"],
+    properties: {
+        instance_id: {
+            type: ["string", "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.",
+        },
+        type_name: {
+            type: "string",
+            description: "Component type to modify (full name preferred, class-name fallback). Use this OR " +
+                "component_instance_id. Ignored when component_instance_id is set.",
+        },
+        component_instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Specific Component instance ID. Takes precedence over type_name when set.",
+        },
+        fields: {
+            type: "array",
+            description: "Serialized-property patches to apply in order. Each entry: { path: string, value: any, type?: \"name\" | \"int\" }. " +
+                "value shape depends on the property's SerializedPropertyType — see component_get output. " +
+                "For enum properties, set type=\"name\" to set by enum name (default is int index). " +
+                "For object references, value is {\"path\": \"Assets/...\"} or {\"instance_id\": N} or null.",
+            items: {
+                type: "object",
+                required: ["path", "value"],
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "SerializedProperty.propertyPath (e.g. \"m_Color\", \"m_Mass\").",
+                    },
+                    value: {
+                        description: "New value. Scalars/strings/bools as JSON primitives; vectors/colors as [x,y,(z,(w))]; " +
+                            "object references as {\"path\": \"...\"} or null; enums as int (default) or name " +
+                            "(when type=\"name\").",
+                    },
+                    type: {
+                        type: "string",
+                        enum: ["name", "int"],
+                        description: "Optional hint. \"name\" = interpret value as an enum NAME (default is int index).",
                     },
-                    additionalProperties: false,
                 },
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — the scene path that contains the host.",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
+                additionalProperties: false,
             },
         },
-        additionalProperties: false,
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the scene path that contains the host." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=component-modify.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"component-modify.js","sourceRoot":"","sources":["../../src/tools/component-modify.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,uFAAuF;QACvF,4FAA4F;QAC5F,8FAA8F;QAC9F,wFAAwF;QACxF,0FAA0F;QAC1F,uFAAuF;QACvF,+DAA+D;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;QAClC,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,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,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,mEAAmE;aACtE;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,2EAA2E;aAC9E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,sHAAsH;oBACtH,2FAA2F;oBAC3F,qFAAqF;oBACrF,6FAA6F;gBAC/F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;oBAC3B,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iEAAiE;yBAC/E;wBACD,KAAK,EAAE;4BACL,WAAW,EACT,wFAAwF;gCACxF,mFAAmF;gCACnF,uBAAuB;yBAC1B;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;4BACrB,WAAW,EACT,mFAAmF;yBACtF;qBACF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;aACF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yDAAyD;aACvE;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":"component-modify.js","sourceRoot":"","sources":["../../src/tools/component-modify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CACrC,iCAAiC,EACjC,uFAAuF;IACrF,4FAA4F;IAC5F,8FAA8F;IAC9F,wFAAwF;IACxF,0FAA0F;IAC1F,uFAAuF;IACvF,+DAA+D,EACjE;IACE,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;IAC9B,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,yDAAyD;SACvE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qCAAqC;SACnD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mFAAmF;gBACnF,mEAAmE;SACtE;QACD,qBAAqB,EAAE;YACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EACT,2EAA2E;SAC9E;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,WAAW,EACT,sHAAsH;gBACtH,2FAA2F;gBAC3F,qFAAqF;gBACrF,6FAA6F;YAC/F,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC3B,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iEAAiE;qBAC/E;oBACD,KAAK,EAAE;wBACL,WAAW,EACT,wFAAwF;4BACxF,mFAAmF;4BACnF,uBAAuB;qBAC1B;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;wBACrB,WAAW,EACT,mFAAmF;qBACtF;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,yDAAyD,EAAE;QAC1G,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/console-clear.d.ts

@@ -1,2 +1,40 @@
-import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const consoleClear: Tool;
+export declare const consoleClear: {
+    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/console-clear.js

@@ -1,19 +1,14 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 5 — typed console clear. Mutates editor console state but touches
 // no assets, so it routes as a gate-free direct-response tool (same footing as
 // unity_senses_read_console, which already clears via `clear: true`).
 // Complements the read side — do NOT duplicate it.
-export const consoleClear = {
-    name: "unity_open_mcp_console_clear",
-    description: "Clear the Unity Editor console. Mutates console state only (no asset " +
-        "writes), so it is gate-free and returns directly without the gate " +
-        "envelope — same footing as unity_senses_read_console with clear: true. " +
-        "Complements read_console (the read side). Prefer this over raw " +
-        "execute_csharp LogEntries.Clear() — schema-validated and surfaced as a " +
-        "first-class tool so a failed clear is visible as a structured error.",
-    inputSchema: {
-        type: "object",
-        properties: {},
-        additionalProperties: false,
-    },
-};
+export const consoleClear = makeTool("unity_open_mcp_console_clear", "Clear the Unity Editor console. Mutates console state only (no asset " +
+    "writes), so it is gate-free and returns directly without the gate " +
+    "envelope — same footing as unity_senses_read_console with clear: true. " +
+    "Complements read_console (the read side). Prefer this over raw " +
+    "execute_csharp LogEntries.Clear() — schema-validated and surfaced as a " +
+    "first-class tool so a failed clear is visible as a structured error.", {
+    properties: {},
+});
 //# sourceMappingURL=console-clear.js.map

package/dist/tools/console-clear.js.map

@@ -1 +1 @@
-{"version":3,"file":"console-clear.js","sourceRoot":"","sources":["../../src/tools/console-clear.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,+EAA+E;AAC/E,sEAAsE;AACtE,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,uEAAuE;QACvE,oEAAoE;QACpE,yEAAyE;QACzE,iEAAiE;QACjE,yEAAyE;QACzE,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"console-clear.js","sourceRoot":"","sources":["../../src/tools/console-clear.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,6EAA6E;AAC7E,+EAA+E;AAC/E,sEAAsE;AACtE,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,8BAA8B,EAC9B,uEAAuE;IACrE,oEAAoE;IACpE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,sEAAsE,EACxE;IACE,UAAU,EAAE,EAAE;CACf,CACF,CAAC"}