unity-open-mcp 0.6.1 → 0.8.2

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;
+};

package/dist/tools/screenshot-camera.js

@@ -1,59 +1,54 @@
+import { makeTool } from "./schema-fragments.js";
 // M20 Plan 1 / T20.1.1 — arbitrary-pose screenshot. Renders from a transient
 // camera at the requested world-space pose without moving the scene/game
 // camera. Returns the saved PNG file path (use capture_inline for an inline
 // base64 image instead of a file).
-export const screenshotCamera = {
-    name: "unity_senses_screenshot_camera",
-    description: "Render a screenshot from an arbitrary world-space camera pose (position + " +
-        "rotation in degrees + field of view) without moving the scene or game " +
-        "camera. Uses a transient Camera positioned at the requested pose, so the " +
-        "live editor view is never disturbed. Returns the saved PNG file path. " +
-        "Requires a live Unity Editor connection.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            position: {
-                type: "string",
-                default: "0,0,0",
-                description: "World-space camera position as \"x,y,z\" (e.g. \"5,10,-7\").",
-            },
-            rotation: {
-                type: "string",
-                default: "0,0,0",
-                description: "Camera rotation as Euler angles in degrees \"x,y,z\" (e.g. " +
-                    "\"30,-45,0\" for a 30° down-tilt facing south-east).",
-            },
-            fov: {
-                type: "number",
-                default: 60,
-                exclusiveMinimum: 0,
-                exclusiveMaximum: 180,
-                description: "Field of view in degrees. Must be strictly between 0 and 180.",
-            },
-            width: {
-                type: "integer",
-                default: 1280,
-                minimum: 64,
-                maximum: 4096,
-                description: "Capture width in pixels.",
-            },
-            height: {
-                type: "integer",
-                default: 720,
-                minimum: 64,
-                maximum: 4096,
-                description: "Capture height in pixels.",
-            },
-            background: {
-                type: "string",
-                enum: ["transparent", "solid", "skybox"],
-                default: "skybox",
-                description: "Background. 'skybox' = skybox (default), 'solid' = solid color, " +
-                    "'transparent' = alpha-clear. A nonexistent main camera falls back " +
-                    "to a sensible default culling mask / clip range.",
-            },
+export const screenshotCamera = makeTool("unity_senses_screenshot_camera", "Render a screenshot from an arbitrary world-space camera pose (position + " +
+    "rotation in degrees + field of view) without moving the scene or game " +
+    "camera. Uses a transient Camera positioned at the requested pose, so the " +
+    "live editor view is never disturbed. Returns the saved PNG file path. " +
+    "Requires a live Unity Editor connection.", {
+    properties: {
+        position: {
+            type: "string",
+            default: "0,0,0",
+            description: "World-space camera position as \"x,y,z\" (e.g. \"5,10,-7\").",
+        },
+        rotation: {
+            type: "string",
+            default: "0,0,0",
+            description: "Camera rotation as Euler angles in degrees \"x,y,z\" (e.g. " +
+                "\"30,-45,0\" for a 30° down-tilt facing south-east).",
+        },
+        fov: {
+            type: "number",
+            default: 60,
+            exclusiveMinimum: 0,
+            exclusiveMaximum: 180,
+            description: "Field of view in degrees. Must be strictly between 0 and 180.",
+        },
+        width: {
+            type: "integer",
+            default: 1280,
+            minimum: 64,
+            maximum: 4096,
+            description: "Capture width in pixels.",
+        },
+        height: {
+            type: "integer",
+            default: 720,
+            minimum: 64,
+            maximum: 4096,
+            description: "Capture height in pixels.",
+        },
+        background: {
+            type: "string",
+            enum: ["transparent", "solid", "skybox"],
+            default: "skybox",
+            description: "Background. 'skybox' = skybox (default), 'solid' = solid color, " +
+                "'transparent' = alpha-clear. A nonexistent main camera falls back " +
+                "to a sensible default culling mask / clip range.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=screenshot-camera.js.map

package/dist/tools/screenshot-camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot-camera.js","sourceRoot":"","sources":["../../src/tools/screenshot-camera.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,4EAA4E;QAC5E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,0CAA0C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,8DAA8D;aACjE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,6DAA6D;oBAC7D,sDAAsD;aACzD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,gBAAgB,EAAE,CAAC;gBACnB,gBAAgB,EAAE,GAAG;gBACrB,WAAW,EAAE,+DAA+D;aAC7E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,0BAA0B;aACxC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,2BAA2B;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACxC,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,kEAAkE;oBAClE,oEAAoE;oBACpE,kDAAkD;aACrD;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"screenshot-camera.js","sourceRoot":"","sources":["../../src/tools/screenshot-camera.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,gCAAgC,EAChC,4EAA4E;IAC1E,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,0CAA0C,EAC5C;IACE,UAAU,EAAE;QACN,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,8DAA8D;SACjE;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,sDAAsD;SACzD;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,gBAAgB,EAAE,CAAC;YACnB,gBAAgB,EAAE,GAAG;YACrB,WAAW,EAAE,+DAA+D;SAC7E;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,0BAA0B;SACxC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,2BAA2B;SACzC;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,QAAQ;YACjB,WAAW,EACT,kEAAkE;gBAClE,oEAAoE;gBACpE,kDAAkD;SACrD;KACF;CACN,CACF,CAAC"}

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

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

@@ -1,54 +1,49 @@
+import { makeTool } from "./schema-fragments.js";
 // M20 Plan 1 / T20.1.2 — Editor window screenshot. Captures any EditorWindow
 // (Console, Hierarchy, Inspector, Project, Scene, Game, or a custom window).
 // Full-fidelity capture via the Win32 PrintWindow API is Windows-only; on
 // macOS/Linux a best-effort screen-rect readback is used and the response
 // carries platformLimited: true so the agent knows the capture may be partial
 // when the window is occluded. Returns the saved PNG file path.
-export const screenshotWindow = {
-    name: "unity_senses_screenshot_window",
-    description: "Capture a Unity Editor window (Console, Hierarchy, Inspector, Project, " +
-        "Scene, Game, or any custom EditorWindow) to a PNG file. Full-fidelity " +
-        "capture (occlusion-proof, no focus stealing) is Windows-only via the " +
-        "Win32 PrintWindow API; on macOS/Linux a best-effort screen-rect readback " +
-        "is used and the response carries platformLimited: true, so the capture " +
-        "may be partial or stale when the window is hidden behind others. Provide " +
-        "either window_title (visible tab text, e.g. \"Console\") or window_type " +
-        "(EditorWindow type name, e.g. \"UnityEditor.ConsoleWindow\"). Returns " +
-        "the saved PNG file path. Requires a live Unity Editor connection.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            window_title: {
-                type: "string",
-                description: "Visible tab title of the target window (e.g. \"Console\", " +
-                    "\"Hierarchy\", \"Inspector\", \"Project\", \"Scene\", \"Game\"). " +
-                    "Common titles map to their built-in EditorWindow types; custom " +
-                    "titles match any open window with that title.",
-            },
-            window_type: {
-                type: "string",
-                description: "EditorWindow type name (simple or fully-qualified, e.g. " +
-                    "\"ConsoleWindow\" or \"UnityEditor.ConsoleWindow\"). Takes " +
-                    "precedence over window_title when both are given.",
-            },
-            width: {
-                type: "integer",
-                default: 1280,
-                minimum: 64,
-                maximum: 4096,
-                description: "Maximum capture width in pixels. The actual capture is clamped to " +
-                    "the window's on-screen width.",
-            },
-            height: {
-                type: "integer",
-                default: 720,
-                minimum: 64,
-                maximum: 4096,
-                description: "Maximum capture height in pixels. The actual capture is clamped to " +
-                    "the window's on-screen height.",
-            },
+export const screenshotWindow = makeTool("unity_senses_screenshot_window", "Capture a Unity Editor window (Console, Hierarchy, Inspector, Project, " +
+    "Scene, Game, or any custom EditorWindow) to a PNG file. Full-fidelity " +
+    "capture (occlusion-proof, no focus stealing) is Windows-only via the " +
+    "Win32 PrintWindow API; on macOS/Linux a best-effort screen-rect readback " +
+    "is used and the response carries platformLimited: true, so the capture " +
+    "may be partial or stale when the window is hidden behind others. Provide " +
+    "either window_title (visible tab text, e.g. \"Console\") or window_type " +
+    "(EditorWindow type name, e.g. \"UnityEditor.ConsoleWindow\"). Returns " +
+    "the saved PNG file path. Requires a live Unity Editor connection.", {
+    properties: {
+        window_title: {
+            type: "string",
+            description: "Visible tab title of the target window (e.g. \"Console\", " +
+                "\"Hierarchy\", \"Inspector\", \"Project\", \"Scene\", \"Game\"). " +
+                "Common titles map to their built-in EditorWindow types; custom " +
+                "titles match any open window with that title.",
+        },
+        window_type: {
+            type: "string",
+            description: "EditorWindow type name (simple or fully-qualified, e.g. " +
+                "\"ConsoleWindow\" or \"UnityEditor.ConsoleWindow\"). Takes " +
+                "precedence over window_title when both are given.",
+        },
+        width: {
+            type: "integer",
+            default: 1280,
+            minimum: 64,
+            maximum: 4096,
+            description: "Maximum capture width in pixels. The actual capture is clamped to " +
+                "the window's on-screen width.",
+        },
+        height: {
+            type: "integer",
+            default: 720,
+            minimum: 64,
+            maximum: 4096,
+            description: "Maximum capture height in pixels. The actual capture is clamped to " +
+                "the window's on-screen height.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=screenshot-window.js.map

package/dist/tools/screenshot-window.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot-window.js","sourceRoot":"","sources":["../../src/tools/screenshot-window.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,2EAA2E;QAC3E,yEAAyE;QACzE,2EAA2E;QAC3E,0EAA0E;QAC1E,wEAAwE;QACxE,mEAAmE;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4DAA4D;oBAC5D,mEAAmE;oBACnE,iEAAiE;oBACjE,+CAA+C;aAClD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0DAA0D;oBAC1D,6DAA6D;oBAC7D,mDAAmD;aACtD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,oEAAoE;oBACpE,+BAA+B;aAClC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,qEAAqE;oBACrE,gCAAgC;aACnC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"screenshot-window.js","sourceRoot":"","sources":["../../src/tools/screenshot-window.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,gCAAgC,EAChC,yEAAyE;IACvE,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,mEAAmE,EACrE;IACE,UAAU,EAAE;QACN,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4DAA4D;gBAC5D,mEAAmE;gBACnE,iEAAiE;gBACjE,+CAA+C;SAClD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0DAA0D;gBAC1D,6DAA6D;gBAC7D,mDAAmD;SACtD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,oEAAoE;gBACpE,+BAA+B;SAClC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,qEAAqE;gBACrE,gCAAgC;SACnC;KACF;CACN,CACF,CAAC"}