unity-open-mcp 0.6.1 → 0.8.2

package/dist/tools/restart-editor.js

@@ -0,0 +1,74 @@
+import { makeTool } from "./schema-fragments.js";
+// M31 Plan 3 / T31.3 — Editor fd-exhaustion auto-recovery (kill half).
+//
+// Companion to `read_compile_errors` (which surfaces the
+// `editor_fd_exhaustion` hang signature from Editor.log). Where
+// read_compile_errors only *diagnoses* the Bee build-driver hang, this tool
+// *acts* on it: with explicit confirmation it terminates the hung Unity
+// process so the operator/Hub can relaunch a fresh one. The relaunch itself
+// is deferred — the interactive Editor's launch recipe (the flags the Hub
+// used) is not knowable from the server, so the response carries clear
+// "relaunch via the Hub" guidance instead.
+//
+// Operator-only surface (sibling to bridge_status): no group assignment in
+// `capabilities/tool-groups.ts`, so it sits in the always-visible meta-tool
+// bucket. It is NOT a mutating project-asset tool — the gate validates asset
+// fallout, which does not apply to an OS process kill — so it routes local
+// with no gate hop.
+//
+// Safety contract (the plan's "explicit confirmation" requirement):
+//   1. Refuses unless `confirm: true` is passed. A dry-run call (confirm false
+//      or absent) returns the PID + diagnosis it would act on, no side effect.
+//   2. Refuses when the `editor_fd_exhaustion` signature is ABSENT from the
+//      Editor.log tail. Never restart on a plain `dead_bridge` (usually a
+//      fixable compile failure) or a merely offline bridge.
+//   3. Surfaces unsaved-scene risk in the response when the bridge is still
+//      reachable enough to report dirty scenes. Killing the Editor can destroy
+//      unsaved scene work and in-flight asset imports.
+//   4. SIGTERM → grace period → SIGKILL fallback on macOS/Linux; `taskkill /T
+//      /F` on Windows.
+export const restartEditor = makeTool("unity_open_mcp_restart_editor", "Auto-recover from Editor file-descriptor exhaustion by terminating the " +
+    "hung Unity process. Use ONLY after `read_compile_errors` reports an " +
+    "`editor_fd_exhaustion` issue (the Bee build-driver hang signature: " +
+    "'Could not register to wait for file descriptor N'). The Editor is hung " +
+    "mid-build in that state and will not recover on its own. Requires " +
+    "EXPLICIT confirmation (`confirm: true`) — killing the Editor can destroy " +
+    "unsaved scene work and in-flight asset imports. The tool refuses when " +
+    "the fd-exhaustion signature is absent (no restart on a plain " +
+    "`dead_bridge` / fixable compile failure), when no live Unity process " +
+    "matches this project, or when the PID is invalid. Local-routed: it acts " +
+    "on the OS process via process.kill (SIGTERM → SIGKILL on macOS/Linux) or " +
+    "taskkill /T /F on Windows — no bridge round-trip, no Unity spawn. The " +
+    "response carries the killed PID + kill method + clear 'Editor terminated, " +
+    "relaunch required via the Hub' guidance; relaunch is NOT automatic. A " +
+    "dry-run call (confirm false/absent) returns what WOULD happen without " +
+    "any side effect. After relaunch, poll `unity_open_mcp_bridge_status` " +
+    "until it returns `running` to confirm the bridge reconnected. The " +
+    "active-scene-dirty signal is checked when the bridge is still reachable " +
+    "and surfaced as a `dirtyScenesWarning` in the response (it does NOT " +
+    "block the kill — the Editor is hung).", {
+    properties: {
+        confirm: {
+            type: "boolean",
+            default: false,
+            description: "Must be `true` to actually terminate the Editor. When false or " +
+                "absent the call is a dry-run: it returns the PID + diagnosis it " +
+                "would act on without any side effect. Killing the Editor is " +
+                "destructive (unsaved scene work, in-flight imports) — never pass " +
+                "this without first confirming the fd-exhaustion signature via " +
+                "`read_compile_errors`.",
+        },
+        kill_grace_ms: {
+            type: "integer",
+            default: 5000,
+            minimum: 0,
+            maximum: 15000,
+            description: "SIGTERM→SIGKILL grace window in milliseconds on macOS/Linux. " +
+                "Default 5000ms. Ignored on Windows (taskkill /F is forced). Raise " +
+                "to give Unity more time to flush its log + release the per-project " +
+                "lock on a cooperative shutdown; lower to fail faster when the " +
+                "Editor is fully wedged.",
+        },
+    },
+});
+//# sourceMappingURL=restart-editor.js.map

package/dist/tools/restart-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-editor.js","sourceRoot":"","sources":["../../src/tools/restart-editor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,uEAAuE;AACvE,EAAE;AACF,yDAAyD;AACzD,gEAAgE;AAChE,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,2CAA2C;AAC3C,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,oBAAoB;AACpB,EAAE;AACF,oEAAoE;AACpE,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAC1E,4DAA4D;AAC5D,4EAA4E;AAC5E,+EAA+E;AAC/E,uDAAuD;AACvD,8EAA8E;AAC9E,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,+BAA+B,EAC/B,yEAAyE;IACvE,sEAAsE;IACtE,qEAAqE;IACrE,0EAA0E;IAC1E,oEAAoE;IACpE,2EAA2E;IAC3E,wEAAwE;IACxE,+DAA+D;IAC/D,uEAAuE;IACvE,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,4EAA4E;IAC5E,wEAAwE;IACxE,wEAAwE;IACxE,uEAAuE;IACvE,oEAAoE;IACpE,0EAA0E;IAC1E,sEAAsE;IACtE,uCAAuC,EACzC;IACE,UAAU,EAAE;QACN,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EACT,iEAAiE;gBACjE,kEAAkE;gBAClE,8DAA8D;gBAC9D,mEAAmE;gBACnE,gEAAgE;gBAChE,wBAAwB;SAC3B;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,KAAK;YACd,WAAW,EACT,+DAA+D;gBAC/D,oEAAoE;gBACpE,qEAAqE;gBACrE,gEAAgE;gBAChE,yBAAyB;SAC5B;KACF;CACN,CACF,CAAC"}

package/dist/tools/run-tests.d.ts

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

@@ -1,49 +1,44 @@
-export const runTests = {
-    name: "unity_senses_run_tests",
-    description: "Run Unity EditMode or PlayMode tests and return structured results. " +
-        "EditMode runs in-process and results are available within seconds. " +
-        "PlayMode survives domain reload via file handoff. " +
-        "Filter by assembly, namespace, class, or method name.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            play_mode: {
-                type: "boolean",
-                default: false,
-                description: "Run PlayMode tests instead of EditMode. Requires domain reload.",
-            },
-            assembly_name: {
-                type: "string",
-                description: "Filter: run tests in this assembly only (e.g. 'MyAssembly').",
-            },
-            test_namespace: {
-                type: "string",
-                description: "Filter: run tests under this namespace.",
-            },
-            test_class: {
-                type: "string",
-                description: "Filter: run tests in this class (full or partial name).",
-            },
-            test_method: {
-                type: "string",
-                description: "Filter: run only this test method (fully qualified name).",
-            },
-            include_passes: {
-                type: "boolean",
-                default: true,
-                description: "Include passing tests in the results array. Set false to return " +
-                    "only failures/inconclusive — the summary still reports the full " +
-                    "counts. Recommended for large suites to avoid truncation.",
-            },
-            timeout_ms: {
-                type: "integer",
-                default: 60000,
-                minimum: 1000,
-                maximum: 600000,
-                description: "Maximum time to wait for results (PlayMode may take longer due to domain reload).",
-            },
+import { makeTool } from "./schema-fragments.js";
+export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode or PlayMode tests and return structured results. " +
+    "EditMode runs in-process and results are available within seconds. " +
+    "PlayMode survives domain reload via file handoff. " +
+    "Filter by assembly, namespace, class, or method name.", {
+    properties: {
+        play_mode: {
+            type: "boolean",
+            default: false,
+            description: "Run PlayMode tests instead of EditMode. Requires domain reload.",
+        },
+        assembly_name: {
+            type: "string",
+            description: "Filter: run tests in this assembly only (e.g. 'MyAssembly').",
+        },
+        test_namespace: {
+            type: "string",
+            description: "Filter: run tests under this namespace.",
+        },
+        test_class: {
+            type: "string",
+            description: "Filter: run tests in this class (full or partial name).",
+        },
+        test_method: {
+            type: "string",
+            description: "Filter: run only this test method (fully qualified name).",
+        },
+        include_passes: {
+            type: "boolean",
+            default: true,
+            description: "Include passing tests in the results array. Set false to return " +
+                "only failures/inconclusive — the summary still reports the full " +
+                "counts. Recommended for large suites to avoid truncation.",
+        },
+        timeout_ms: {
+            type: "integer",
+            default: 60000,
+            minimum: 1000,
+            maximum: 600000,
+            description: "Maximum time to wait for results (PlayMode may take longer due to domain reload).",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=run-tests.js.map

package/dist/tools/run-tests.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../src/tools/run-tests.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,sEAAsE;QACtE,qEAAqE;QACrE,oDAAoD;QACpD,uDAAuD;IACzD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;aACvE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EACT,kEAAkE;oBAClE,kEAAkE;oBAClE,2DAA2D;aAC9D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,mFAAmF;aACtF;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../src/tools/run-tests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAC9B,wBAAwB,EACxB,sEAAsE;IACpE,qEAAqE;IACrE,oDAAoD;IACpD,uDAAuD,EACzD;IACE,UAAU,EAAE;QACN,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,iEAAiE;SAC/E;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8DAA8D;SAC5E;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yDAAyD;SACvE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2DAA2D;SACzE;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACT,kEAAkE;gBAClE,kEAAkE;gBAClE,2DAA2D;SAC9D;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;YACf,WAAW,EACT,mFAAmF;SACtF;KACF;CACN,CACF,CAAC"}

package/dist/tools/scan-all.d.ts

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

@@ -1,25 +1,20 @@
-export const scanAll = {
-    name: "unity_open_mcp_scan_all",
-    description: "Full project scan using all ported verify rules. Runs in batch mode (headless Unity) — no open Editor required. Returns severity counts, per-rule summaries, timing, and issue details. exitCode 0 = pass, 1 = issues above fail_on_severity threshold.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            platform_profile: {
-                enum: ["mobile", "console", "desktop"],
-                default: "desktop",
-                description: "Stored in output metadata; does not filter rules in M5.",
-            },
-            fail_on_severity: {
-                enum: ["error", "warn", "info", "verbose", "never"],
-                default: "warn",
-                description: "Severity threshold for exit code. 'warn' = fail on any error or warning.",
-            },
-            output_path: {
-                type: "string",
-                description: "Optional JSON report path inside project (relative to project root or absolute).",
-            },
+import { makeTool } from "./schema-fragments.js";
+export const scanAll = makeTool("unity_open_mcp_scan_all", "Full project scan using all ported verify rules. Runs in batch mode (headless Unity) — no open Editor required. Returns severity counts, per-rule summaries, timing, and issue details. exitCode 0 = pass, 1 = issues above fail_on_severity threshold.", {
+    properties: {
+        platform_profile: {
+            enum: ["mobile", "console", "desktop"],
+            default: "desktop",
+            description: "Stored in output metadata; does not filter rules in M5.",
+        },
+        fail_on_severity: {
+            enum: ["error", "warn", "info", "verbose", "never"],
+            default: "warn",
+            description: "Severity threshold for exit code. 'warn' = fail on any error or warning.",
+        },
+        output_path: {
+            type: "string",
+            description: "Optional JSON report path inside project (relative to project root or absolute).",
         },
-        additionalProperties: false,
     },
-};
+});
 //# sourceMappingURL=scan-all.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scan-all.js","sourceRoot":"","sources":["../../src/tools/scan-all.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,yPAAyP;IAC3P,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,yDAAyD;aACvE;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACnD,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,0EAA0E;aACxF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kFAAkF;aAChG;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"scan-all.js","sourceRoot":"","sources":["../../src/tools/scan-all.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAC7B,yBAAyB,EACzB,yPAAyP,EACzP;IACE,UAAU,EAAE;QACN,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACtC,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,yDAAyD;SACvE;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;YACnD,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,0EAA0E;SACxF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kFAAkF;SAChG;KACF;CACN,CACF,CAAC"}

package/dist/tools/scan-paths.d.ts

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