unity-open-mcp 0.7.0 → 0.8.3

package/dist/tools/scene-unload.js

@@ -1,47 +1,34 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 3 — typed scene unload. Mutating: removes an opened scene from
 // the editor (without saving). Runs the full gate path.
 //
 // Scene identity (path-first): `path` resolves an opened scene by its asset
 // path; `name` resolves by display name. Precedence: when both are supplied,
 // `path` wins; `name` is the fallback when only it is supplied.
-export const sceneUnload = {
-    name: "unity_open_mcp_scene_unload",
-    description: "Unload an opened scene from the Unity Editor (without saving — call scene_save first if " +
-        "the scene has unsaved changes you want to keep). Mutating: runs the full gate path; " +
-        "`paths_hint` should be the scene's asset path. Scene identity is path-first: provide `path` " +
-        "(the scene's `Assets/.../*.unity` asset path) to resolve unambiguously, or `name` to resolve " +
-        "by display name. When both are supplied, `path` wins and `name` is ignored. The response " +
-        "carries `resolvedBy` (\"path\" or \"name\") so the agent can tell which identity key resolved " +
-        "the target. Returns the " +
-        "post-unload list of opened scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/isActive). " +
-        "Prefer this over raw execute_csharp SceneManager.UnloadSceneAsync.",
-    inputSchema: {
-        type: "object",
-        required: ["paths_hint"],
-        properties: {
-            path: {
-                type: "string",
-                description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to unload. Resolves the scene " +
-                    "by its asset path — the authoritative identity. When supplied, takes precedence over " +
-                    "`name`. Use scene_list_opened to enumerate opened scene paths.",
-            },
-            name: {
-                type: "string",
-                description: "Name of the opened scene to unload (fallback when `path` is not supplied). Must match " +
-                    "an opened scene's display name. Use scene_list_opened to enumerate opened scene names.",
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — the unloaded scene's asset path (or its name when it is not yet " +
-                    "asset-backed).",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
-            },
+export const sceneUnload = makeTool("unity_open_mcp_scene_unload", "Unload an opened scene from the Unity Editor (without saving — call scene_save first if " +
+    "the scene has unsaved changes you want to keep). Mutating: runs the full gate path; " +
+    "`paths_hint` should be the scene's asset path. Scene identity is path-first: provide `path` " +
+    "(the scene's `Assets/.../*.unity` asset path) to resolve unambiguously, or `name` to resolve " +
+    "by display name. When both are supplied, `path` wins and `name` is ignored. The response " +
+    "carries `resolvedBy` (\"path\" or \"name\") so the agent can tell which identity key resolved " +
+    "the target. Returns the " +
+    "post-unload list of opened scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/isActive). " +
+    "Prefer this over raw execute_csharp SceneManager.UnloadSceneAsync.", {
+    required: ["paths_hint"],
+    properties: {
+        path: {
+            type: "string",
+            description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to unload. Resolves the scene " +
+                "by its asset path — the authoritative identity. When supplied, takes precedence over " +
+                "`name`. Use scene_list_opened to enumerate opened scene paths.",
         },
-        additionalProperties: false,
+        name: {
+            type: "string",
+            description: "Name of the opened scene to unload (fallback when `path` is not supplied). Must match " +
+                "an opened scene's display name. Use scene_list_opened to enumerate opened scene names.",
+        },
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the unloaded scene's asset path (or its name when it is not yet " + "asset-backed)." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=scene-unload.js.map

package/dist/tools/scene-unload.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,8FAA8F;QAC9F,+FAA+F;QAC/F,2FAA2F;QAC3F,gGAAgG;QAChG,0BAA0B;QAC1B,gGAAgG;QAChG,oEAAoE;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yFAAyF;oBACzF,uFAAuF;oBACvF,gEAAgE;aACnE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;oBACxF,wFAAwF;aAC3F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;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":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,0EAA0E;AAC1E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,0FAA0F;IACxF,sFAAsF;IACtF,8FAA8F;IAC9F,+FAA+F;IAC/F,2FAA2F;IAC3F,gGAAgG;IAChG,0BAA0B;IAC1B,gGAAgG;IAChG,oEAAoE,EACtE;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yFAAyF;gBACzF,uFAAuF;gBACvF,gEAAgE;SACnE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,wFAAwF;gBACxF,wFAAwF;SAC3F;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,mFAAmF,GAAG,gBAAgB,EAAE;QACvJ,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/sceneview-get-camera.d.ts

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

@@ -1,16 +1,11 @@
+import { makeTool } from "./schema-fragments.js";
 // M20 Plan 9 / T20.9.4 — SceneView pose read. Distinct from scene_focus:
 // scene_focus frames a target object, while this reports the current editor
 // camera pose/pivot ("what is the agent currently looking at?").
-export const sceneviewGetCamera = {
-    name: "unity_open_mcp_sceneview_get_camera",
-    description: "Read the SceneView camera pose: camera position, rotation (Euler), pivot, " +
-        "orthographic flag, size, and field of view. Read-only and gate-free. " +
-        "Use this to inspect the current editor viewpoint before screenshot, " +
-        "scene_focus, or manual takeover.",
-    inputSchema: {
-        type: "object",
-        properties: {},
-        additionalProperties: false,
-    },
-};
+export const sceneviewGetCamera = makeTool("unity_open_mcp_sceneview_get_camera", "Read the SceneView camera pose: camera position, rotation (Euler), pivot, " +
+    "orthographic flag, size, and field of view. Read-only and gate-free. " +
+    "Use this to inspect the current editor viewpoint before screenshot, " +
+    "scene_focus, or manual takeover.", {
+    properties: {},
+});
 //# sourceMappingURL=sceneview-get-camera.js.map

package/dist/tools/sceneview-get-camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneview-get-camera.js","sourceRoot":"","sources":["../../src/tools/sceneview-get-camera.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,4EAA4E;AAC5E,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,4EAA4E;QAC5E,uEAAuE;QACvE,sEAAsE;QACtE,kCAAkC;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"sceneview-get-camera.js","sourceRoot":"","sources":["../../src/tools/sceneview-get-camera.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,yEAAyE;AACzE,4EAA4E;AAC5E,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CACxC,qCAAqC,EACrC,4EAA4E;IAC1E,uEAAuE;IACvE,sEAAsE;IACtE,kCAAkC,EACpC;IACE,UAAU,EAAE,EAAE;CACf,CACF,CAAC"}

package/dist/tools/sceneview-set-camera.d.ts

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

@@ -1,58 +1,46 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M20 Plan 9 / T20.9.4 — SceneView pose mutation. Distinct from scene_focus:
 // this sets pose-level camera state directly (position/rotation/projection),
 // while scene_focus frames a target object.
-export const sceneviewSetCamera = {
-    name: "unity_open_mcp_sceneview_set_camera",
-    description: "Set the SceneView camera pose (position required; optional rotation / " +
-        "orthographic / size). Mutating editor UI state (window/camera movement): " +
-        "runs the gate path and requires `paths_hint` scoped to the active scene " +
-        "path. Returns `windowMoved: true` and the resulting camera pose.",
-    inputSchema: {
-        type: "object",
-        required: ["position", "paths_hint"],
-        properties: {
-            position: {
-                type: "object",
-                required: ["x", "y", "z"],
-                properties: {
-                    x: { type: "number" },
-                    y: { type: "number" },
-                    z: { type: "number" },
-                },
-                additionalProperties: false,
-                description: "Desired SceneView camera position (world space).",
+export const sceneviewSetCamera = makeTool("unity_open_mcp_sceneview_set_camera", "Set the SceneView camera pose (position required; optional rotation / " +
+    "orthographic / size). Mutating editor UI state (window/camera movement): " +
+    "runs the gate path and requires `paths_hint` scoped to the active scene " +
+    "path. Returns `windowMoved: true` and the resulting camera pose.", {
+    required: ["position", "paths_hint"],
+    properties: {
+        position: {
+            type: "object",
+            required: ["x", "y", "z"],
+            properties: {
+                x: { type: "number" },
+                y: { type: "number" },
+                z: { type: "number" },
             },
-            rotation: {
-                type: "object",
-                required: ["x", "y", "z"],
-                properties: {
-                    x: { type: "number" },
-                    y: { type: "number" },
-                    z: { type: "number" },
-                },
-                additionalProperties: false,
-                description: "Optional SceneView camera Euler rotation in degrees.",
-            },
-            orthographic: {
-                type: "boolean",
-                description: "Optional projection mode switch for the SceneView camera.",
-            },
-            size: {
-                type: "number",
-                minimum: 0,
-                description: "Optional SceneView size (zoom distance factor). Omit to keep current value.",
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — active scene path (records editor-camera move in gate history).",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
+            additionalProperties: false,
+            description: "Desired SceneView camera position (world space).",
+        },
+        rotation: {
+            type: "object",
+            required: ["x", "y", "z"],
+            properties: {
+                x: { type: "number" },
+                y: { type: "number" },
+                z: { type: "number" },
             },
+            additionalProperties: false,
+            description: "Optional SceneView camera Euler rotation in degrees.",
+        },
+        orthographic: {
+            type: "boolean",
+            description: "Optional projection mode switch for the SceneView camera.",
+        },
+        size: {
+            type: "number",
+            minimum: 0,
+            description: "Optional SceneView size (zoom distance factor). Omit to keep current value.",
         },
-        additionalProperties: false,
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — active scene path (records editor-camera move in gate history)." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=sceneview-set-camera.js.map

package/dist/tools/sceneview-set-camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"sceneview-set-camera.js","sourceRoot":"","sources":["../../src/tools/sceneview-set-camera.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,6EAA6E;AAC7E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,wEAAwE;QACxE,2EAA2E;QAC3E,0EAA0E;QAC1E,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QACpC,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;gBACzB,UAAU,EAAE;oBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACtB;gBACD,oBAAoB,EAAE,KAAK;gBAC3B,WAAW,EAAE,kDAAkD;aAChE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;gBACzB,UAAU,EAAE;oBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACtB;gBACD,oBAAoB,EAAE,KAAK;gBAC3B,WAAW,EAAE,sDAAsD;aACpE;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,6EAA6E;aAChF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,kFAAkF;aACrF;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":"sceneview-set-camera.js","sourceRoot":"","sources":["../../src/tools/sceneview-set-camera.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CACxC,qCAAqC,EACrC,wEAAwE;IACtE,2EAA2E;IAC3E,0EAA0E;IAC1E,kEAAkE,EACpE;IACE,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IAChC,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YACzB,UAAU,EAAE;gBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACtB;YACD,oBAAoB,EAAE,KAAK;YAC3B,WAAW,EAAE,kDAAkD;SAChE;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YACzB,UAAU,EAAE;gBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACtB;YACD,oBAAoB,EAAE,KAAK;YAC3B,WAAW,EAAE,sDAAsD;SACpE;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,2DAA2D;SACzE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,WAAW,EACT,6EAA6E;SAChF;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,kFAAkF,EAAE;QACnI,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/schema-fragments.d.ts

@@ -0,0 +1,86 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * The `gate` property: enum + default. Inlined in 137 tool files pre-change;
+ * 128 of those have NO description (pure enum + default), 9 add a per-tool
+ * description via `{ ...GATE_PROP, description: "..." }`.
+ *
+ * `as const` locks the literal tuple so `enum` stays `["enforce","warn","off"]`
+ * not `string[]` after the spread.
+ */
+export declare const GATE_PROP: {
+    enum: ["enforce", "warn", "off"];
+    default: "enforce";
+};
+/**
+ * The base `paths_hint` property: array-of-string with NO description. Almost
+ * every tool that declares `paths_hint` adds a per-tool description specific
+ * to its mutation scope ("Mutation scope — the .anim asset path", etc.).
+ * Spread the base and add the description inline:
+ *
+ *   ```ts
+ *   paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — …" },
+ *   ```
+ *
+ * A handful of tools (e.g. `execute-menu.ts`) declare `paths_hint` with no
+ * description — for those, spread the base alone.
+ */
+export declare const PATHS_HINT_TYPE: {
+    type: "array";
+    items: {
+        type: "string";
+    };
+};
+/**
+ * Base for `ignore_scene_dirty`: boolean, default false, no description. The
+ * ~10 tools that declare this property each carry a distinct wording variant
+ * (some mention "recompile / scene switch", others mention "menu that can
+ * disrupt the editor" or "entering play mode"). Spread the base and add the
+ * per-tool description inline so the variants stay byte-identical to
+ * pre-change:
+ *
+ *   ```ts
+ *   ignore_scene_dirty: { ...IGNORE_SCENE_DIRTY_BASE, description: "…" },
+ *   ```
+ */
+export declare const IGNORE_SCENE_DIRTY_BASE: {
+    type: "boolean";
+    default: false;
+};
+/**
+ * Base for `confirm_bypass`: boolean, default false, no description. Each of
+ * the 3 tools that declares it (execute_csharp / execute_menu / build_start)
+ * carries a distinct description listing the destructive patterns specific to
+ * that tool. Spread the base and add the per-tool description inline.
+ */
+export declare const CONFIRM_BYPASS_BASE: {
+    type: "boolean";
+    default: false;
+};
+/**
+ * Shape of the per-tool schema body passed to {@link makeTool}. Omits the
+ * outer `type: "object"` and `additionalProperties: false` (those are added
+ * by `makeTool`) and the wrapper `name` / `description` / `inputSchema`
+ * fields (those are added by `makeTool` from the named args).
+ *
+ * `oneOf` is optional — two tools (`dependencies`, `find_references`) use it
+ * at the top level to express "asset_path XOR guid" variants; `makeTool`
+ * passes it through to the schema unchanged.
+ */
+export interface ToolSchemaBody {
+    /** Optional list of required property names. */
+    required?: string[];
+    /** The declared properties (each a JSON-Schema property descriptor). */
+    properties: Record<string, object>;
+    /** Optional JSON-Schema `oneOf` clause (used by XOR-shape tools). */
+    oneOf?: object[];
+}
+/**
+ * Build a {@link Tool} with the project-norm schema envelope: `type: "object"`
+ * + `properties` + `additionalProperties: false`. The `additionalProperties`
+ * literal lives here once instead of being copy-pasted into every tool file.
+ *
+ * The body's `properties` record is kept as-is (callers spread shared
+ * fragments like `GATE_PROP` into it). The resulting `inputSchema` is
+ * byte-identical to the pre-change inline form.
+ */
+export declare function makeTool(name: string, description: string, body: ToolSchemaBody): Tool;

package/dist/tools/schema-fragments.js

@@ -0,0 +1,119 @@
+// M31-optimizations Plan 5 / T5.1 (H9) — shared schema fragments + `makeTool`.
+//
+// Single source of truth for the schema boilerplate that was duplicated
+// across ~265 tool files in this directory. The fragments are SPREAD into a
+// per-tool property block; the JSON Schema each tool emits is byte-identical
+// to the pre-change inline form (verified by the golden-snapshot test in
+// `tool-schema-parity.test.ts`). Per-tool descriptions stay inline where
+// they vary — only the truly shared boilerplate (enum/default/type) is
+// centralized here.
+//
+// Design constraints:
+//
+//   1. **Byte-identical output.** The MCP client sees `inputSchema`
+//      post-`JSON.stringify`. Spreading `{ ...GATE_PROP }` yields the same
+//      property set + value types as the inline literal (verified by parity
+//      test). The `as const` assertions lock the literal types so TypeScript
+//      does not widen `enum` to `string[]`.
+//
+//   2. **Description text stays per-tool where it varies.** Most tools have
+//      a unique `paths_hint` description ("Mutation scope — the .anim asset
+//      path", etc.) — these are NOT centralized. Only the type/default
+//      boilerplate is shared. `ignore_scene_dirty` / `confirm_bypass` carry
+//      a small number of distinct wording variants; the base object captures
+//      `type + default`, and each tool adds its description inline.
+//
+//   3. **`makeTool` always adds `additionalProperties: false`.** The project
+//      norm (enforced by `tool-schema-parity.test.ts`) is that every tool
+//      schema forbids additional properties. Centralizing it here removes
+//      265 copies of the literal.
+//
+// Usage:
+//   ```ts
+//   export const myTool = makeTool("unity_open_mcp_my_tool", "Does the thing.", {
+//     required: ["foo"],
+//     properties: {
+//       foo: { type: "string", description: "..." },
+//       gate: { ...GATE_PROP },
+//       paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — …" },
+//     },
+//   });
+//   ```
+/**
+ * The `gate` property: enum + default. Inlined in 137 tool files pre-change;
+ * 128 of those have NO description (pure enum + default), 9 add a per-tool
+ * description via `{ ...GATE_PROP, description: "..." }`.
+ *
+ * `as const` locks the literal tuple so `enum` stays `["enforce","warn","off"]`
+ * not `string[]` after the spread.
+ */
+export const GATE_PROP = {
+    enum: ["enforce", "warn", "off"],
+    default: "enforce",
+};
+/**
+ * The base `paths_hint` property: array-of-string with NO description. Almost
+ * every tool that declares `paths_hint` adds a per-tool description specific
+ * to its mutation scope ("Mutation scope — the .anim asset path", etc.).
+ * Spread the base and add the description inline:
+ *
+ *   ```ts
+ *   paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — …" },
+ *   ```
+ *
+ * A handful of tools (e.g. `execute-menu.ts`) declare `paths_hint` with no
+ * description — for those, spread the base alone.
+ */
+export const PATHS_HINT_TYPE = {
+    type: "array",
+    items: { type: "string" },
+};
+/**
+ * Base for `ignore_scene_dirty`: boolean, default false, no description. The
+ * ~10 tools that declare this property each carry a distinct wording variant
+ * (some mention "recompile / scene switch", others mention "menu that can
+ * disrupt the editor" or "entering play mode"). Spread the base and add the
+ * per-tool description inline so the variants stay byte-identical to
+ * pre-change:
+ *
+ *   ```ts
+ *   ignore_scene_dirty: { ...IGNORE_SCENE_DIRTY_BASE, description: "…" },
+ *   ```
+ */
+export const IGNORE_SCENE_DIRTY_BASE = {
+    type: "boolean",
+    default: false,
+};
+/**
+ * Base for `confirm_bypass`: boolean, default false, no description. Each of
+ * the 3 tools that declares it (execute_csharp / execute_menu / build_start)
+ * carries a distinct description listing the destructive patterns specific to
+ * that tool. Spread the base and add the per-tool description inline.
+ */
+export const CONFIRM_BYPASS_BASE = {
+    type: "boolean",
+    default: false,
+};
+/**
+ * Build a {@link Tool} with the project-norm schema envelope: `type: "object"`
+ * + `properties` + `additionalProperties: false`. The `additionalProperties`
+ * literal lives here once instead of being copy-pasted into every tool file.
+ *
+ * The body's `properties` record is kept as-is (callers spread shared
+ * fragments like `GATE_PROP` into it). The resulting `inputSchema` is
+ * byte-identical to the pre-change inline form.
+ */
+export function makeTool(name, description, body) {
+    return {
+        name,
+        description,
+        inputSchema: {
+            type: "object",
+            ...(body.required !== undefined ? { required: body.required } : {}),
+            properties: body.properties,
+            ...(body.oneOf !== undefined ? { oneOf: body.oneOf } : {}),
+            additionalProperties: false,
+        },
+    };
+}
+//# sourceMappingURL=schema-fragments.js.map

package/dist/tools/schema-fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fragments.js","sourceRoot":"","sources":["../../src/tools/schema-fragments.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AACvE,oBAAoB;AACpB,EAAE;AACF,sBAAsB;AACtB,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,4CAA4C;AAC5C,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,4EAA4E;AAC5E,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,kCAAkC;AAClC,EAAE;AACF,SAAS;AACT,UAAU;AACV,kFAAkF;AAClF,yBAAyB;AACzB,oBAAoB;AACpB,qDAAqD;AACrD,gCAAgC;AAChC,+EAA+E;AAC/E,SAAS;AACT,QAAQ;AACR,QAAQ;AAIR;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAA+B;IAC9D,OAAO,EAAE,SAAkB;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,OAAgB;IACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;CACnC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAkB;IACxB,OAAO,EAAE,KAAc;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,SAAkB;IACxB,OAAO,EAAE,KAAc;CACxB,CAAC;AAqBF;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,WAAmB,EACnB,IAAoB;IAEpB,OAAO;QACL,IAAI;QACJ,WAAW;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,oBAAoB,EAAE,KAAK;SAC5B;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/screenshot-camera.d.ts

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