unity-open-mcp 0.7.0 → 0.8.2

package/dist/tools/scan-paths.js

@@ -1,59 +1,54 @@
-export const scanPaths = {
-    name: "unity_open_mcp_scan_paths",
-    description: "Run one or more ported verify rules scoped to paths. For a single rule, pass categories: [\"missing_references\"]. " +
-        "Unknown rule IDs error with availableRules. Use include_rules / exclude_rules to filter the auto-selected set " +
-        "(exclude always wins; include narrows an explicit categories list, otherwise it is additive). " +
-        "fail_on_severity defaults to the project setting verify.severityThreshold in .unity-open-mcp/settings.json. " +
-        "Default (`profile: 'compact'`) returns passed + issue counts grouped by severity (no per-issue list); raise to " +
-        "balanced/full for the full issues list, and page large result sets with page_size/cursor. " +
-        "Each issue carries ruleId + categoryId (alias), severity, code + issueCode (alias), assetPath, description, " +
-        "and fixId + fixSafe when a fix is available. rulesApplied lists the post-filter rule set.",
-    inputSchema: {
-        type: "object",
-        required: ["paths"],
-        properties: {
-            paths: { type: "array", items: { type: "string" }, description: "Asset paths to scan" },
-            categories: {
-                type: "array",
-                items: { type: "string" },
-                description: "Verify rule IDs; auto-selected from paths if omitted. Unknown IDs error with availableRules.",
-            },
-            include_rules: {
-                type: "array",
-                items: { type: "string" },
-                description: "Allow-list applied to the resolved rule set. When `categories` is set, include_rules narrows to their intersection; " +
-                    "without `categories` it is additive on top of the auto-selected set.",
-            },
-            exclude_rules: {
-                type: "array",
-                items: { type: "string" },
-                description: "Deny-list. Always wins over categories and include_rules.",
-            },
-            platform_profile: { enum: ["mobile", "console", "desktop"], default: "desktop" },
-            profile: {
-                enum: ["compact", "balanced", "full"],
-                default: "compact",
-                description: "Token-budget output profile (M22). 'compact' (default) = passed + issue counts grouped by severity " +
-                    "(issues[] stripped; drill in with balanced/full). 'balanced'/'full' = the full issues list (paged when " +
-                    "page_size is set).",
-            },
-            page_size: {
-                type: "integer",
-                minimum: 1,
-                description: "Page the issues list (M22 uniform paging; balanced/full). When set, the response carries a `pagination` block " +
-                    "with a `next_cursor` to resume. Omit to receive the whole issues list in one response.",
-            },
-            cursor: {
-                type: "string",
-                description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the issues list.",
-            },
-            fail_on_severity: {
-                enum: ["error", "warn", "info", "verbose", "never"],
-                description: "Severity threshold for the `passed` flag. Omit to use the project default " +
-                    "(verify.severityThreshold in .unity-open-mcp/settings.json; falls back to `error`).",
-            },
+import { makeTool } from "./schema-fragments.js";
+export const scanPaths = makeTool("unity_open_mcp_scan_paths", "Run one or more ported verify rules scoped to paths. For a single rule, pass categories: [\"missing_references\"]. " +
+    "Unknown rule IDs error with availableRules. Use include_rules / exclude_rules to filter the auto-selected set " +
+    "(exclude always wins; include narrows an explicit categories list, otherwise it is additive). " +
+    "fail_on_severity defaults to the project setting verify.severityThreshold in .unity-open-mcp/settings.json. " +
+    "Default (`profile: 'compact'`) returns passed + issue counts grouped by severity (no per-issue list); raise to " +
+    "balanced/full for the full issues list, and page large result sets with page_size/cursor. " +
+    "Each issue carries ruleId + categoryId (alias), severity, code + issueCode (alias), assetPath, description, " +
+    "and fixId + fixSafe when a fix is available. rulesApplied lists the post-filter rule set.", {
+    required: ["paths"],
+    properties: {
+        paths: { type: "array", items: { type: "string" }, description: "Asset paths to scan" },
+        categories: {
+            type: "array",
+            items: { type: "string" },
+            description: "Verify rule IDs; auto-selected from paths if omitted. Unknown IDs error with availableRules.",
+        },
+        include_rules: {
+            type: "array",
+            items: { type: "string" },
+            description: "Allow-list applied to the resolved rule set. When `categories` is set, include_rules narrows to their intersection; " +
+                "without `categories` it is additive on top of the auto-selected set.",
+        },
+        exclude_rules: {
+            type: "array",
+            items: { type: "string" },
+            description: "Deny-list. Always wins over categories and include_rules.",
+        },
+        platform_profile: { enum: ["mobile", "console", "desktop"], default: "desktop" },
+        profile: {
+            enum: ["compact", "balanced", "full"],
+            default: "compact",
+            description: "Token-budget output profile (M22). 'compact' (default) = passed + issue counts grouped by severity " +
+                "(issues[] stripped; drill in with balanced/full). 'balanced'/'full' = the full issues list (paged when " +
+                "page_size is set).",
+        },
+        page_size: {
+            type: "integer",
+            minimum: 1,
+            description: "Page the issues list (M22 uniform paging; balanced/full). When set, the response carries a `pagination` block " +
+                "with a `next_cursor` to resume. Omit to receive the whole issues list in one response.",
+        },
+        cursor: {
+            type: "string",
+            description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the issues list.",
+        },
+        fail_on_severity: {
+            enum: ["error", "warn", "info", "verbose", "never"],
+            description: "Severity threshold for the `passed` flag. Omit to use the project default " +
+                "(verify.severityThreshold in .unity-open-mcp/settings.json; falls back to `error`).",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=scan-paths.js.map

package/dist/tools/scan-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"scan-paths.js","sourceRoot":"","sources":["../../src/tools/scan-paths.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,qHAAqH;QACrH,gHAAgH;QAChH,gGAAgG;QAChG,8GAA8G;QAC9G,iHAAiH;QACjH,4FAA4F;QAC5F,8GAA8G;QAC9G,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE;YACvF,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,8FAA8F;aACjG;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,sHAAsH;oBACtH,sEAAsE;aACzE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,2DAA2D;aACzE;YACD,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;YAChF,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,qGAAqG;oBACrG,yGAAyG;oBACzG,oBAAoB;aACvB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,gHAAgH;oBAChH,wFAAwF;aAC3F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sGAAsG;aACzG;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACnD,WAAW,EACT,4EAA4E;oBAC5E,qFAAqF;aACxF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"scan-paths.js","sourceRoot":"","sources":["../../src/tools/scan-paths.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAC/B,2BAA2B,EAC3B,qHAAqH;IACnH,gHAAgH;IAChH,gGAAgG;IAChG,8GAA8G;IAC9G,iHAAiH;IACjH,4FAA4F;IAC5F,8GAA8G;IAC9G,2FAA2F,EAC7F;IACE,QAAQ,EAAE,CAAC,OAAO,CAAC;IACf,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE;QACvF,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,8FAA8F;SACjG;QACD,aAAa,EAAE;YACb,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,sHAAsH;gBACtH,sEAAsE;SACzE;QACD,aAAa,EAAE;YACb,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,2DAA2D;SACzE;QACD,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;QAChF,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;YACrC,OAAO,EAAE,SAAS;YAClB,WAAW,EACT,qGAAqG;gBACrG,yGAAyG;gBACzG,oBAAoB;SACvB;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,gHAAgH;gBAChH,wFAAwF;SAC3F;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,sGAAsG;SACzG;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;YACnD,WAAW,EACT,4EAA4E;gBAC5E,qFAAqF;SACxF;KACF;CACN,CACF,CAAC"}

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

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

@@ -1,47 +1,46 @@
+import { GATE_PROP, IGNORE_SCENE_DIRTY_BASE, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 3 — typed scene create. Mutating: writes a new .unity asset and
 // opens it. Runs the full gate path; `paths_hint` is the new .unity path.
-export const sceneCreate = {
-    name: "unity_open_mcp_scene_create",
-    description: "Create a new scene asset and save it at the given `.unity` path, opening it in the editor. " +
-        "Mutating: runs the full gate path; `paths_hint` should be the new `.unity` asset path. " +
-        "Returns the new scene's name, path, isDirty, isLoaded, rootCount, and buildIndex so the " +
-        "agent can chain scene_get_data / gameobject_create / scene_save without an extra lookup. " +
-        "Prefer this over raw execute_csharp EditorSceneManager.NewScene — schema-validated, " +
-        "undo-recorded, and the gate surfaces asset-reference fallout.",
-    inputSchema: {
-        type: "object",
-        required: ["path", "paths_hint"],
-        properties: {
-            path: {
-                type: "string",
-                description: "Destination asset path. Must start with 'Assets/' (or be relative to the project " +
-                    "root) and end with '.unity'. Intermediate folders must already exist.",
-            },
-            setup: {
-                type: "string",
-                enum: ["empty", "default"],
-                default: "empty",
-                description: "New-scene setup. 'empty' = NewSceneSetup.EmptyScene (no objects); 'default' = " +
-                    "NewSceneSetup.DefaultGameObjects (camera + directional light). Defaults to 'empty'.",
-            },
-            mode: {
-                type: "string",
-                enum: ["single", "additive"],
-                default: "single",
-                description: "New-scene mode. 'single' closes currently opened scenes and opens this one; " +
-                    "'additive' keeps currently opened scenes and opens this one alongside them.",
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — the new `.unity` asset path.",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
-            },
+export const sceneCreate = makeTool("unity_open_mcp_scene_create", "Create a new scene asset and save it at the given `.unity` path, opening it in the editor. " +
+    "Mutating: runs the full gate path; `paths_hint` should be the new `.unity` asset path. " +
+    "Returns the new scene's name, path, isDirty, isLoaded, rootCount, and buildIndex so the " +
+    "agent can chain scene_get_data / gameobject_create / scene_save without an extra lookup. " +
+    "Prefer this over raw execute_csharp EditorSceneManager.NewScene — schema-validated, " +
+    "undo-recorded, and the gate surfaces asset-reference fallout. The default 'single' mode " +
+    "closes all currently-open scenes without saving, so the active-scene dirty guard preflights " +
+    "this tool (refuses with `scene_dirty` when any loaded scene has unsaved changes); pass " +
+    "`ignore_scene_dirty: true` to accept the risk, or `mode: 'additive'` to keep open scenes.", {
+    required: ["path", "paths_hint"],
+    properties: {
+        path: {
+            type: "string",
+            description: "Destination asset path. Must start with 'Assets/' (or be relative to the project " +
+                "root) and end with '.unity'. Intermediate folders must already exist.",
         },
-        additionalProperties: false,
+        setup: {
+            type: "string",
+            enum: ["empty", "default"],
+            default: "empty",
+            description: "New-scene setup. 'empty' = NewSceneSetup.EmptyScene (no objects); 'default' = " +
+                "NewSceneSetup.DefaultGameObjects (camera + directional light). Defaults to 'empty'.",
+        },
+        mode: {
+            type: "string",
+            enum: ["single", "additive"],
+            default: "single",
+            description: "New-scene mode. 'single' closes currently opened scenes and opens this one; " +
+                "'additive' keeps currently opened scenes and opens this one alongside them.",
+        },
+        ignore_scene_dirty: {
+            ...IGNORE_SCENE_DIRTY_BASE,
+            description: "Bypass the active-scene dirty guard. The default 'single' mode closes every open " +
+                "scene without saving, so a dirty scene would trigger Unity's native save modal " +
+                "mid-flow; the guard refuses preflight instead. Set true to proceed and accept the " +
+                "risk of losing unsaved changes. No effect for 'additive' mode (it does not close " +
+                "open scenes).",
+        },
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the new `.unity` asset path." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=scene-create.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scene-create.js","sourceRoot":"","sources":["../../src/tools/scene-create.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,6FAA6F;QAC7F,yFAAyF;QACzF,0FAA0F;QAC1F,2FAA2F;QAC3F,sFAAsF;QACtF,+DAA+D;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;QAChC,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,uEAAuE;aAC1E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC1B,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,gFAAgF;oBAChF,qFAAqF;aACxF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,WAAW,EACT,8EAA8E;oBAC9E,6EAA6E;aAChF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;aAC7D;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-create.js","sourceRoot":"","sources":["../../src/tools/scene-create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtG,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,6FAA6F;IAC3F,yFAAyF;IACzF,0FAA0F;IAC1F,2FAA2F;IAC3F,sFAAsF;IACtF,0FAA0F;IAC1F,8FAA8F;IAC9F,yFAAyF;IACzF,2FAA2F,EAC7F;IACE,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;IAC5B,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mFAAmF;gBACnF,uEAAuE;SAC1E;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YAC1B,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,gFAAgF;gBAChF,qFAAqF;SACxF;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;YAC5B,OAAO,EAAE,QAAQ;YACjB,WAAW,EACT,8EAA8E;gBAC9E,6EAA6E;SAChF;QACD,kBAAkB,EAAE;YAClB,GAAG,uBAAuB;YAC1B,WAAW,EACT,mFAAmF;gBACnF,iFAAiF;gBACjF,oFAAoF;gBACpF,mFAAmF;gBACnF,eAAe;SAClB;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,+CAA+C,EAAE;QAChG,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/scene-focus.d.ts

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

@@ -1,55 +1,43 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
 // M16 Plan 3 — typed scene focus. Mutating: moves the SceneView camera onto
 // a GameObject. Runs the full gate path.
-export const sceneFocus = {
-    name: "unity_open_mcp_scene_focus",
-    description: "Frame a GameObject in the SceneView camera and optionally set a view axis. Mutating: runs " +
-        "the full gate path; `paths_hint` should be the scene path containing the target. Computes " +
-        "the target's combined renderer+collider bounds and calls SceneView.LookAtDirect, so the " +
-        "agent can point the editor at a specific object before screenshot or before a human takes " +
-        "over. Returns the resulting SceneView pivot / camera position / rotation / size and the " +
-        "resolved axis. Resolve the target by `instance_id` (canonical) or `path` / `name`, matching " +
-        "spatial_query and gameobject_find. Prefer this over raw execute_csharp SceneView.lastActiveSceneView.",
-    inputSchema: {
-        type: "object",
-        required: ["paths_hint"],
-        properties: {
-            instance_id: {
-                type: ["string", "integer"],
-                default: 0,
-                description: "Instance ID of the target GameObject (canonical address).",
-            },
-            path: {
-                type: "string",
-                description: "Hierarchy path of the target GameObject (fallback address).",
-            },
-            name: {
-                type: "string",
-                description: "Target GameObject name (lowest priority address).",
-            },
-            axis: {
-                type: "string",
-                enum: ["top", "bottom", "front", "back", "left", "right"],
-                description: "Optional view axis to orient the SceneView camera. Omit to keep the current rotation. " +
-                    "top = look straight down (–Y), bottom = +Y, front = look along –Z, back = +Z, " +
-                    "left = look along +X, right = –X.",
-            },
-            size: {
-                type: "number",
-                minimum: 0,
-                description: "Optional SceneView size (half-extent of the framing box). Omit to derive from the " +
-                    "target bounds.",
-            },
-            paths_hint: {
-                type: "array",
-                items: { type: "string" },
-                description: "Mutation scope — the scene path containing the target.",
-            },
-            gate: {
-                enum: ["enforce", "warn", "off"],
-                default: "enforce",
-            },
+export const sceneFocus = makeTool("unity_open_mcp_scene_focus", "Frame a GameObject in the SceneView camera and optionally set a view axis. Mutating: runs " +
+    "the full gate path; `paths_hint` should be the scene path containing the target. Computes " +
+    "the target's combined renderer+collider bounds and calls SceneView.LookAtDirect, so the " +
+    "agent can point the editor at a specific object before screenshot or before a human takes " +
+    "over. Returns the resulting SceneView pivot / camera position / rotation / size and the " +
+    "resolved axis. Resolve the target by `instance_id` (canonical) or `path` / `name`, matching " +
+    "spatial_query and gameobject_find. Prefer this over raw execute_csharp SceneView.lastActiveSceneView.", {
+    required: ["paths_hint"],
+    properties: {
+        instance_id: {
+            type: ["string", "integer"],
+            default: 0,
+            description: "Instance ID of the target GameObject (canonical address).",
         },
-        additionalProperties: false,
+        path: {
+            type: "string",
+            description: "Hierarchy path of the target GameObject (fallback address).",
+        },
+        name: {
+            type: "string",
+            description: "Target GameObject name (lowest priority address).",
+        },
+        axis: {
+            type: "string",
+            enum: ["top", "bottom", "front", "back", "left", "right"],
+            description: "Optional view axis to orient the SceneView camera. Omit to keep the current rotation. " +
+                "top = look straight down (–Y), bottom = +Y, front = look along –Z, back = +Z, " +
+                "left = look along +X, right = –X.",
+        },
+        size: {
+            type: "number",
+            minimum: 0,
+            description: "Optional SceneView size (half-extent of the framing box). Omit to derive from the " +
+                "target bounds.",
+        },
+        paths_hint: { ...PATHS_HINT_TYPE, description: "Mutation scope — the scene path containing the target." },
+        gate: { ...GATE_PROP },
     },
-};
+});
 //# sourceMappingURL=scene-focus.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scene-focus.js","sourceRoot":"","sources":["../../src/tools/scene-focus.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,yCAAyC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,4FAA4F;QAC5F,4FAA4F;QAC5F,0FAA0F;QAC1F,4FAA4F;QAC5F,0FAA0F;QAC1F,8FAA8F;QAC9F,uGAAuG;IACzG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,2DAA2D;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;gBACzD,WAAW,EACT,wFAAwF;oBACxF,gFAAgF;oBAChF,mCAAmC;aACtC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oFAAoF;oBACpF,gBAAgB;aACnB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,wDAAwD;aACtE;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-focus.js","sourceRoot":"","sources":["../../src/tools/scene-focus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,4EAA4E;AAC5E,yCAAyC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAChC,4BAA4B,EAC5B,4FAA4F;IAC1F,4FAA4F;IAC5F,0FAA0F;IAC1F,4FAA4F;IAC5F,0FAA0F;IAC1F,8FAA8F;IAC9F,uGAAuG,EACzG;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,2DAA2D;SACzE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6DAA6D;SAC3E;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;SACjE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YACzD,WAAW,EACT,wFAAwF;gBACxF,gFAAgF;gBAChF,mCAAmC;SACtC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,WAAW,EACT,oFAAoF;gBACpF,gBAAgB;SACnB;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,wDAAwD,EAAE;QACzG,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}

package/dist/tools/scene-get-data.d.ts

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

@@ -1,78 +1,73 @@
+import { makeTool } from "./schema-fragments.js";
 // M16 Plan 3 — read-only scene get data. Gate-free. The structured scene
 // hierarchy read that supersedes the standalone M10 scene snapshot (T3.8),
 // unifying summarize + hierarchy_describe into `detail`/`summary` modes.
 // Bounded output drives see-edit-verify loops.
-export const sceneGetData = {
-    name: "unity_open_mcp_scene_get_data",
-    description: "Read the hierarchy of an opened scene as compact, drill-down structured data. Read-only " +
-        "(gate-free). Supersedes the standalone M10 scene snapshot, unifying summarize + " +
-        "hierarchy_describe into the `detail`/`profile` modes below. Default (`profile: 'compact'`) returns a " +
-        "cheap overview — scene name/path/isDirty/isLoaded/rootCount/buildIndex + a root-GameObject " +
-        "roster with name + childCount + components (no nested children). `profile: 'balanced'` adds " +
-        "the first `depth` levels of nested children with per-node active/tag/layer/component set. " +
-        "`profile: 'full'` adds per-node transform (position/rotation/scale) and instance_id so the " +
-        "agent can chain gameobject_modify / component_modify without an extra lookup. " +
-        "Page large hierarchies with page_size/cursor. " +
-        "Scene identity is path-first: provide `path` to resolve an opened scene by its asset path, " +
-        "or `name` to resolve by display name; when both are supplied, `path` wins. " +
-        "Use scene_list_opened to enumerate scenes. Prefer this over read_asset on the .unity file " +
-        "(which is YAML-heavy and does not reflect unsaved editor state).",
-    inputSchema: {
-        type: "object",
-        properties: {
-            path: {
-                type: "string",
-                description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to read. Resolves the scene " +
-                    "by its asset path — the authoritative identity. When supplied, takes precedence over " +
-                    "`name`. Omit (and omit `name`) to read the active scene.",
-            },
-            name: {
-                type: "string",
-                description: "Opened scene name (fallback when `path` is not supplied). Omit (and omit `path`) to " +
-                    "read the active scene. Use scene_list_opened to enumerate opened scene names.",
-            },
-            profile: {
-                enum: ["compact", "balanced", "full"],
-                default: "compact",
-                description: "Token-budget output profile (M22). 'compact' (default): scene overview + root-GameObject roster " +
-                    "(name/childCount/components, no nested children). 'balanced': + nested children to `depth` with " +
-                    "active/tag/layer/component set. 'full': + per-node instance_id and transform (position/rotation/scale). " +
-                    "An explicit profile wins over the legacy `detail` param; the two map onto the same axis.",
-            },
-            page_size: {
-                type: "integer",
-                minimum: 1,
-                description: "Page the flattened node stream (M22 uniform paging). When set, the response carries a flat `nodes` " +
-                    "array for the current page + a `pagination` block with a `next_cursor` to resume. Omit to receive the " +
-                    "structural root/hierarchy view in one response.",
-            },
-            cursor: {
-                type: "string",
-                description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the node stream.",
-            },
-            detail: {
-                type: "string",
-                enum: ["summary", "normal", "verbose"],
-                default: "summary",
-                description: "Legacy detail level (alias for `profile`: summary=compact, normal=balanced, verbose=full). " +
-                    "Prefer `profile`; ignored when `profile` is set.",
-            },
-            depth: {
-                type: "integer",
-                default: 3,
-                minimum: 0,
-                description: "Max hierarchy depth to emit when detail is 'normal'/'verbose' (profile balanced/full). 0 = roots only. " +
-                    "Nodes past the cap are counted in `moreHidden` per-root, not emitted.",
-            },
-            max_nodes: {
-                type: "integer",
-                default: 200,
-                minimum: 1,
-                description: "Hard cap on total nodes emitted across all roots (controls token budget). Remaining " +
-                    "nodes are counted in `truncated`. Legacy alias; defaults to 200.",
-            },
+export const sceneGetData = makeTool("unity_open_mcp_scene_get_data", "Read the hierarchy of an opened scene as compact, drill-down structured data. Read-only " +
+    "(gate-free). Supersedes the standalone M10 scene snapshot, unifying summarize + " +
+    "hierarchy_describe into the `detail`/`profile` modes below. Default (`profile: 'compact'`) returns a " +
+    "cheap overview — scene name/path/isDirty/isLoaded/rootCount/buildIndex + a root-GameObject " +
+    "roster with name + childCount + components (no nested children). `profile: 'balanced'` adds " +
+    "the first `depth` levels of nested children with per-node active/tag/layer/component set. " +
+    "`profile: 'full'` adds per-node transform (position/rotation/scale) and instance_id so the " +
+    "agent can chain gameobject_modify / component_modify without an extra lookup. " +
+    "Page large hierarchies with page_size/cursor. " +
+    "Scene identity is path-first: provide `path` to resolve an opened scene by its asset path, " +
+    "or `name` to resolve by display name; when both are supplied, `path` wins. " +
+    "Use scene_list_opened to enumerate scenes. Prefer this over read_asset on the .unity file " +
+    "(which is YAML-heavy and does not reflect unsaved editor state).", {
+    properties: {
+        path: {
+            type: "string",
+            description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to read. Resolves the scene " +
+                "by its asset path — the authoritative identity. When supplied, takes precedence over " +
+                "`name`. Omit (and omit `name`) to read the active scene.",
+        },
+        name: {
+            type: "string",
+            description: "Opened scene name (fallback when `path` is not supplied). Omit (and omit `path`) to " +
+                "read the active scene. Use scene_list_opened to enumerate opened scene names.",
+        },
+        profile: {
+            enum: ["compact", "balanced", "full"],
+            default: "compact",
+            description: "Token-budget output profile (M22). 'compact' (default): scene overview + root-GameObject roster " +
+                "(name/childCount/components, no nested children). 'balanced': + nested children to `depth` with " +
+                "active/tag/layer/component set. 'full': + per-node instance_id and transform (position/rotation/scale). " +
+                "An explicit profile wins over the legacy `detail` param; the two map onto the same axis.",
+        },
+        page_size: {
+            type: "integer",
+            minimum: 1,
+            description: "Page the flattened node stream (M22 uniform paging). When set, the response carries a flat `nodes` " +
+                "array for the current page + a `pagination` block with a `next_cursor` to resume. Omit to receive the " +
+                "structural root/hierarchy view in one response.",
+        },
+        cursor: {
+            type: "string",
+            description: "Opaque continuation token from a previous response's `pagination.next_cursor`. Page the node stream.",
+        },
+        detail: {
+            type: "string",
+            enum: ["summary", "normal", "verbose"],
+            default: "summary",
+            description: "Legacy detail level (alias for `profile`: summary=compact, normal=balanced, verbose=full). " +
+                "Prefer `profile`; ignored when `profile` is set.",
+        },
+        depth: {
+            type: "integer",
+            default: 3,
+            minimum: 0,
+            description: "Max hierarchy depth to emit when detail is 'normal'/'verbose' (profile balanced/full). 0 = roots only. " +
+                "Nodes past the cap are counted in `moreHidden` per-root, not emitted.",
+        },
+        max_nodes: {
+            type: "integer",
+            default: 200,
+            minimum: 1,
+            description: "Hard cap on total nodes emitted across all roots (controls token budget). Remaining " +
+                "nodes are counted in `truncated`. Legacy alias; defaults to 200.",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=scene-get-data.js.map