unity-open-mcp 1.2.3 → 1.4.0

package/dist/tools/jobs.d.ts

@@ -0,0 +1,40 @@
+export declare const jobs: {
+    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/jobs.js

@@ -0,0 +1,18 @@
+import { makeTool } from "./schema-fragments.js";
+import { JOB_STATES } from "../jobs/job-manager.js";
+export const jobs = makeTool("unity_open_mcp_jobs", "Observe session-owned asynchronous jobs: start, status, bounded wait, cooperative cancel, and paged list. Supported targets: unity_senses_run_tests and available async project commands. Other tools are unsupported. Test args are ordinary filters without run_id; project args contain nested args plus scope/gate options. Mutating starts require idempotency_key. Records expire 30 minutes after completion; server restart loses all records. Never blindly retry an orphaned job.", {
+    required: ["action"],
+    properties: {
+        action: { type: "string", enum: ["start", "status", "wait", "cancel", "list"] },
+        tool_or_command: { type: "string", minLength: 1, maxLength: 256 },
+        args: { type: "object", description: "Adapter arguments, including scope/gate intent where applicable." },
+        idempotency_key: { type: "string", minLength: 1, maxLength: 256 },
+        job_id: { type: "string", minLength: 1, maxLength: 128 },
+        timeout_ms: { type: "integer", minimum: 0, maximum: 30000 },
+        state: { type: "string", enum: [...JOB_STATES] },
+        operation: { type: "string", maxLength: 256 },
+        cursor: { type: "string", maxLength: 4096 },
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+    },
+});
+//# sourceMappingURL=jobs.js.map

package/dist/tools/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,qBAAqB,EAChD,6dAA6d,EAAE;IAC7d,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QAC/E,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;QACzG,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACxD,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE;QAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;QAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;KACrD;CACF,CAAC,CAAC"}

package/dist/tools/manage-tools.js

@@ -18,7 +18,7 @@ import { makeTool } from "./schema-fragments.js";
 // set in one call and emits `notifications/tools/list_changed` when the
 // visible surface changes. Unknown intent returns a structured empty
 // recommendation (no invented groups) and points the caller at `list_groups`.
-export const manageTools = makeTool("unity_open_mcp_manage_tools", "Manage which tool groups are visible in this session. Sessions start " +
+export const manageTools = makeTool("unity_open_mcp_manage_tools", "Manage tool visibility; invoke activated tools through a stable route; or use editor_search to build a human-facing Unity Search query (open_ui explicitly opts into focus). Sessions start " +
     "with two groups enabled: `core` and `gate-and-verify`; activate other " +
     "groups on demand to add their tools to your ListTools surface (and " +
     "deactivate to hide them). State is ephemeral and per-session — it resets " +
@@ -46,19 +46,24 @@ export const manageTools = makeTool("unity_open_mcp_manage_tools", "Manage which
     "`notifications/tools/list_changed`, but newly-activated tools only " +
     "appear in your tool list if your client honors that notification and " +
     "re-issues tools/list — if the tools do not show up, manually re-request " +
-    "the tool list, or route the tool by id through batch_execute (which " +
-    "works regardless of listChanged support).", {
+    "the tool list, or call manage_tools(action: invoke, tool_name, arguments), which uses " +
+    "the normal tool route even without listChanged support.", {
     required: ["action"],
     properties: {
+        search_text: { type: "string", description: "Literal asset name for editor_search, a human collaboration aid; use search_assets/find_references for structured data." },
+        asset_type: { type: "string", pattern: "^[A-Za-z_][A-Za-z0-9_.]*$" },
+        open_ui: { type: "boolean", description: "editor_search only: explicitly open/focus Unity Search. Omitted/false returns the query without UI interaction." },
+        tool_name: { type: "string", description: "Exact activated tool name for invoke; obtain its schema from capabilities(tool_name)." },
+        arguments: { type: "object", additionalProperties: true, description: "Arguments for invoke; validated against the target schema before its normal route, gates and lifecycle checks." },
         action: {
-            enum: ["list_groups", "activate", "deactivate", "reset", "suggest", "activate_for"],
+            enum: ["list_groups", "activate", "deactivate", "reset", "suggest", "activate_for", "invoke", "editor_search"],
             description: "list_groups: enumerate every group with active flag + tool roster. " +
                 "activate / deactivate: toggle one group (requires `group`). " +
                 "reset: restore the two default-on groups. " +
                 "suggest: recommend groups for an `intent` and/or `tags` WITHOUT " +
                 "changing state (read-only). " +
                 "activate_for: activate the recommended groups for an `intent` " +
-                "and/or `tags` in one call (idempotent; emits list_changed when " +
+                "and/or `tags` in one call, returning compact new schemas (idempotent; emits list_changed when " +
                 "the visible set changes).",
         },
         group: {

package/dist/tools/manage-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,uEAAuE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,+DAA+D;IAC/D,0EAA0E;IAC1E,mEAAmE;IACnE,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,aAAa;IACb,sEAAsE;IACtE,+DAA+D;IAC/D,qEAAqE;IACrE,uEAAuE;IACvE,0EAA0E;IAC1E,sEAAsE;IACtE,2CAA2C,EAC7C;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;YACnF,WAAW,EACT,qEAAqE;gBACrE,8DAA8D;gBAC9D,4CAA4C;gBAC5C,kEAAkE;gBAClE,8BAA8B;gBAC9B,gEAAgE;gBAChE,iEAAiE;gBACjE,2BAA2B;SAC9B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;gBAC/D,iEAAiE;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,qEAAqE;gBACrE,+DAA+D;gBAC/D,sCAAsC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,qEAAqE;gBACrE,+DAA+D;gBAC/D,kEAAkE;gBAClE,4BAA4B;SAC/B;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,8LAA8L;IAC5L,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,+DAA+D;IAC/D,0EAA0E;IAC1E,mEAAmE;IACnE,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,aAAa;IACb,sEAAsE;IACtE,+DAA+D;IAC/D,qEAAqE;IACrE,uEAAuE;IACvE,0EAA0E;IAC1E,wFAAwF;IACxF,yDAAyD,EAC3D;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE;QACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yHAAyH,EAAE;QACvK,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE;QACpE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iHAAiH,EAAE;QAC5J,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uFAAuF,EAAE;QACnI,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE,gHAAgH,EAAE;QACxL,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,CAAC;YAC9G,WAAW,EACT,qEAAqE;gBACrE,8DAA8D;gBAC9D,4CAA4C;gBAC5C,kEAAkE;gBAClE,8BAA8B;gBAC9B,gEAAgE;gBAChE,gGAAgG;gBAChG,2BAA2B;SAC9B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;gBAC/D,iEAAiE;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,qEAAqE;gBACrE,+DAA+D;gBAC/D,sCAAsC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,qEAAqE;gBACrE,+DAA+D;gBAC/D,kEAAkE;gBAClE,4BAA4B;SAC/B;KACF;CACN,CACF,CAAC"}

package/dist/tools/project-commands.d.ts

@@ -0,0 +1,40 @@
+export declare const projectCommands: {
+    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/project-commands.js

@@ -0,0 +1,23 @@
+import { makeTool, GATE_REQUEST_PROP } from "./schema-fragments.js";
+export const projectCommands = makeTool("unity_open_mcp_project_commands", "Discover project-owned commands from the live Editor without a server release or tool-list refresh. list returns a bounded compact catalog; describe takes one exact id and returns its schema, safety declarations and registration diagnostics. invoke validates args against a fresh schema and uses the normal scope, gate and lifecycle pipeline. Async/cancellable remain declarations only.", {
+    required: ["action"],
+    properties: {
+        action: { type: "string", enum: ["list", "describe", "invoke"] },
+        id: { type: "string", description: "Exact catalog id, required for describe; aliases are metadata only." },
+        command_id: { type: "string", description: "Exact command id, required for invoke." },
+        args: { type: "object", description: "Command arguments using canonical keys from describe." },
+        schema_version: { type: "string", description: "Optional version from describe; a changed contract is rejected." },
+        paths_hint: { type: "array", items: { type: "string" }, description: "Explicit mutation scope when the command declares no paths." },
+        gate: { ...GATE_REQUEST_PROP },
+        ignore_scene_dirty: { type: "boolean" },
+        confirm_bypass: { type: "boolean" },
+        timeout_ms: { type: "integer", minimum: 1000, maximum: 55000 },
+        query: { type: "string", maxLength: 256, description: "Case-insensitive substring in id, title or description." },
+        tags: { type: "array", maxItems: 20, items: { type: "string", maxLength: 128 }, description: "Match all tags exactly." },
+        group: { type: "string", maxLength: 128 },
+        package: { type: "string", maxLength: 256 },
+        offset: { type: "integer", minimum: 0, maximum: 2147483647 },
+        limit: { type: "integer", minimum: 1, maximum: 100, description: "Page size, defaults to 20." },
+    },
+});
+//# sourceMappingURL=project-commands.js.map

package/dist/tools/project-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../../src/tools/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CACrC,iCAAiC,EACjC,oYAAoY,EACpY;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE;QAChE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qEAAqE,EAAE;QAC1G,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;QACrF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;QAC9F,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iEAAiE,EAAE;QAClH,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,6DAA6D,EAAE;QACpI,IAAI,EAAE,EAAE,GAAG,iBAAiB,EAAE;QAC9B,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACvC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACnC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;QAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,yDAAyD,EAAE;QACjH,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACxH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;QACzC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE;QAC5D,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,4BAA4B,EAAE;KAChG;CACF,CACF,CAAC"}

package/dist/tools/read-compile-errors.js

@@ -6,99 +6,20 @@ import { toolHintReference } from "../tool-hint.js";
 // two can no longer drift.
 const RECOMPILE_SCRIPTS_HINT = toolHintReference("unity_open_mcp_recompile_scripts");
 const COMPILE_CHECK_HINT = toolHintReference("unity_open_mcp_compile_check");
-// Offline, filesystem-only tool: reads the tail of Unity's Editor.log and
-// extracts BOTH C# compiler errors AND package / assembly-level red flags AND
-// a hard Editor hang signal. The one recovery channel that works when the
-// bridge assembly itself has failed to compile — in that state every in-bridge
-// channel (read_console, editor_status) is dead with it, and compile_check
-// can't run either (the batch entry point shares the broken assembly, and
-// Unity's per-project lock blocks a second instance). The live Editor still
-// writes CSxxxx diagnostics AND assembly-resolution failures AND Package
-// Manager notices AND the Bee build-driver hang stack to Editor.log regardless
-// of bridge health, so this tool retrieves them without touching Unity or the
-// bridge.
-//
-// Log resolution: Unity 6000.5+ moved the Editor.log to a project-relative
-// path (<project>/Logs/Editor.log) and stops writing to the global per-user
-// log. The tool prefers the project-relative log when it exists (using the
-// --project path) and falls back to the global per-user log for older Unity
-// versions. This matters most when the Editor is in Safe Mode with a broken
-// bridge: the global log is stale there, and only the project-relative log
-// carries the current compile errors.
-//
-// Response fields:
-//   - status: "compile_failed" | "project_unhealthy" | "no_errors_found"
-//             | "stale_log" (errors may not apply — stale log / version
-//             mismatch) | "indeterminate" (no errors, but read from the
-//             ROTATED prev_log_* — not a verified clean bill of health)
-//   - unhealthy: true when compiler errors OR issues are present
-//   - headline: one-line triage summary (empty when healthy)
-//   - errors[]: structured CSxxxx diagnostics (file/line/code/message)
-//   - issues[]: package / assembly / Editor red flags with kind + hint:
-//       * assembly_resolution — Mono.Cecil unresolved-assembly failures
-//         (classic package-version / Unity-version mismatch, e.g. ProBuilder
-//         5.x compiled against an assembly ProBuilder 6 removed)
-//       * package_deprecated   — [Package Manager] <id> is deprecated
-//       * package_manager_error — other Package Manager conflict / resolution
-//         errors
-//       * editor_fd_exhaustion — the Editor hung mid-build after hitting an
-//         internal Mono/Unity file-descriptor limit (the Bee build driver's
-//         "Could not register to wait for file descriptor N" exception). This
-//         is NOT a code error and has no CSxxxx fix; the Editor must be
-//         restarted to recover. The hint carries restart instructions.
-export const readCompileErrors = makeTool("unity_open_mcp_read_compile_errors", "Read C# compiler errors AND package/assembly red flags AND an Editor " +
-    "hang signal directly from Unity's Editor.log (offline, no bridge, no " +
-    "Unity spawn). Returns structured CSxxxx compiler errors " +
-    "(file/line/code/message) PLUS an `issues` list of red flags with " +
-    "per-issue `kind` + `hint`: assembly_resolution (Mono.Cecil " +
-    "unresolved-assembly failures — the classic package-version / " +
-    "Unity-version mismatch, e.g. ProBuilder 5.x on Unity 6), " +
-    "package_deprecated ([Package Manager] <id> is deprecated), " +
-    "package_manager_error (conflict / resolution errors), and " +
-    "editor_fd_exhaustion (the Editor hung mid-build after hitting an " +
-    "internal Mono/Unity file-descriptor limit — NOT a code error; the hint " +
-    "carries restart instructions). Use this when: (a) the bridge is " +
-    "unreachable after a recompile — a 'bridge_compile_failed' response " +
-    "points here, or ping returns connected:false unexpectedly; (b) Unity " +
-    "showed a 'package update' / incompatibility popup; (c) you suspect a " +
-    "package is too old for the current Editor; (d) the Editor appears hung " +
-    "after heavy automation (many recompiles) with no compile errors to " +
-    "explain it — editor_fd_exhaustion is the likely cause and only a " +
-    "restart recovers it. Works even when the bridge assembly itself is " +
-    "broken, because it reads the log file the Editor writes independently " +
-    "of the bridge. Check `unhealthy` first; when true, scan `headline` for " +
-    "a one-line triage then drill into `errors` and `issues`. When the " +
-    "response carries `staleLogSuspected: true`, the cited source files " +
-    "were edited more recently than Editor.log — the error block may " +
-    "reference on-disk code you have already fixed (Unity's incremental " +
-    "compiler no-op'd the recompile). When the response carries " +
-    "`errorsMayPredateEdits: true`, at least one file the errors CITE is newer " +
-    "than the newest built assembly, so no compile has completed since you " +
-    "edited it and the error block is from an earlier compile — do not re-read " +
-    "or re-fix that code on the strength of it. When the response carries " +
-    "`staleAssembly: true`, at least one Assets/**/*.cs " +
-    "source is newer than the newest Library/ScriptAssemblies/*.dll — the " +
-    "running assembly predates the latest source, so a no_errors_found signal " +
-    "CANNOT be trusted until the assembly is rebuilt. When that flag is set " +
-    "WITH errors, the `headline` itself says the error block may predate the " +
-    "current sources (not just the separate staleAssemblyHint field). When " +
-    "`logSource` is a `prev_log_*` value (the read came from the ROTATED " +
-    "Editor-prev.log while a live Editor may be writing a different log) and " +
-    "no errors were found, `status` is `indeterminate`, NOT " +
-    "`no_errors_found` — a clean read from the rotated log is not a verified " +
-    "clean bill of health; confirm via the live bridge or re-read after the " +
-    "Editor settles. All staleness signals call for the " +
-    "same next step (one recommended path per situation, matching the runtime " +
-    `hints): call ${RECOMPILE_SCRIPTS_HINT} for a deterministic ` +
-    "force-recompile, then re-read compile errors; with the Editor closed or " +
-    `unreachable, ${COMPILE_CHECK_HINT} spawns a fresh headless recompile ` +
-    "instead. IMPORTANT — staged compilation: Unity compiles " +
-    "assemblies in dependency order, so when `errorCount` is small but the project " +
-    "has multiple assemblies (the response carries `partialCompileLikely: true` " +
-    "with `asmdefCount`/`assembliesWithErrors`), the reported errors may be a " +
-    "SUBSET — the failing assembly aborted the pipeline before dependent ones were " +
-    "reached. Do NOT treat `errorCount` as the complete picture; fix the reported " +
-    "errors and re-check until `errorCount` is 0.", {
+// A bounded live compile snapshot is preferred; the filesystem fallback stays
+// available when the bridge itself cannot compile, without launching Unity.
+export const readCompileErrors = makeTool("unity_open_mcp_read_compile_errors", "Read current compiler state from the live CompilationPipeline when available, with a bounded " +
+    "read-only probe and offline Editor.log fallback (never spawns Unity). Live status distinguishes " +
+    "currently_compiling, assembly_stale, compile_failed, and no_errors_found. A completed compile " +
+    "generation with matching source content outranks historical log errors; generation and before/after " +
+    "assembly mtimes identify the evidence. historicalLogErrors and historicalLogIssues preserve older " +
+    "log evidence separately. Without confirmed live state, returns log diagnostics with source/authorship " +
+    "and staleAssembly/staleLogSuspected caveats; a clean rotated log is indeterminate. Log issues include " +
+    "assembly_resolution, package_deprecated, package_manager_error, and editor_fd_exhaustion. " +
+    `For stale sources call ${RECOMPILE_SCRIPTS_HINT}, then re-read. ` +
+    `With the Editor closed, ${COMPILE_CHECK_HINT} can verify headlessly; never launch a second Unity ` +
+    "while a live Editor owns the project. Check unhealthy, status, headline, errors, and issues; " +
+    "offline partialCompileLikely means a failing assembly may hide downstream errors.", {
     properties: {
         tail_bytes: {
             type: "integer",

package/dist/tools/read-compile-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,2BAA2B;AAC3B,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,kCAAkC,CAAC,CAAC;AACrF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;AAE7E,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,yEAAyE;AACzE,+EAA+E;AAC/E,8EAA8E;AAC9E,UAAU;AACV,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,mBAAmB;AACnB,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AACxE,iEAAiE;AACjE,6DAA6D;AAC7D,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,6EAA6E;AAC7E,iEAAiE;AACjE,sEAAsE;AACtE,8EAA8E;AAC9E,iBAAiB;AACjB,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,oCAAoC,EACpC,uEAAuE;IACrE,uEAAuE;IACvE,0DAA0D;IAC1D,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,2DAA2D;IAC3D,6DAA6D;IAC7D,4DAA4D;IAC5D,mEAAmE;IACnE,yEAAyE;IACzE,kEAAkE;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,6DAA6D;IAC7D,4EAA4E;IAC5E,wEAAwE;IACxE,4EAA4E;IAC5E,uEAAuE;IACvE,qDAAqD;IACrD,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,sEAAsE;IACtE,0EAA0E;IAC1E,yDAAyD;IACzD,0EAA0E;IAC1E,yEAAyE;IACzE,qDAAqD;IACrD,2EAA2E;IAC3E,gBAAgB,sBAAsB,uBAAuB;IAC7D,0EAA0E;IAC1E,gBAAgB,kBAAkB,qCAAqC;IACvE,0DAA0D;IAC1D,gFAAgF;IAChF,6EAA6E;IAC7E,2EAA2E;IAC3E,gFAAgF;IAChF,+EAA+E;IAC/E,8CAA8C,EAChD;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;SACtE;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,2BAA2B;AAC3B,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,kCAAkC,CAAC,CAAC;AACrF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;AAE7E,8EAA8E;AAC9E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,oCAAoC,EACpC,+FAA+F;IAC7F,kGAAkG;IAClG,gGAAgG;IAChG,sGAAsG;IACtG,oGAAoG;IACpG,wGAAwG;IACxG,wGAAwG;IACxG,4FAA4F;IAC5F,0BAA0B,sBAAsB,kBAAkB;IAClE,2BAA2B,kBAAkB,sDAAsD;IACnG,+FAA+F;IAC/F,mFAAmF,EACrF;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;SACtE;KACF;CACN,CACF,CAAC"}

package/dist/tools/scan-paths.js

@@ -1,6 +1,6 @@
 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 " +
+    "Valid rule IDs are enumerated in the schema; unknown IDs fail before dispatch. 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 " +
@@ -13,7 +13,7 @@ export const scanPaths = makeTool("unity_open_mcp_scan_paths", "Run one or more
         categories: {
             type: "array",
             items: { type: "string" },
-            description: "Verify rule IDs; auto-selected from paths if omitted. Unknown IDs error with availableRules.",
+            description: "Verify rule IDs; auto-selected from paths if omitted. Valid IDs are enumerated below.",
         },
         include_rules: {
             type: "array",
@@ -30,14 +30,14 @@ export const scanPaths = makeTool("unity_open_mcp_scan_paths", "Run one or more
         profile: {
             enum: ["compact", "balanced", "full"],
             default: "compact",
-            description: "Token-budget output profile (M22). 'compact' (default) = passed + issue counts grouped by severity " +
+            description: "Token-budget output profile. '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 " +
+            description: "Page the issues list (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: {

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

@@ -1 +1 @@
-{"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"}
+{"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,mJAAmJ;IACnJ,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,uFAAuF;SAC1F;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,+FAA+F;gBAC/F,yGAAyG;gBACzG,oBAAoB;SACvB;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,4GAA4G;gBAC5G,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/schema-fragments.d.ts

@@ -11,6 +11,19 @@ export declare const GATE_PROP: {
     enum: ["enforce", "warn", "off"];
     default: "enforce";
 };
+/** Request-selected gate; omission delegates to the project's bridge setting. */
+export declare const GATE_REQUEST_PROP: {
+    enum: ["enforce", "warn", "off"];
+};
+/**
+ * Gate selector for the rare mutator whose bridge contract is explicitly
+ * gate-free because it writes external configuration/package pins rather than
+ * Unity assets. Keep the enum canonical while advertising the bridge default.
+ */
+export declare const GATE_OFF_PROP: {
+    enum: ["enforce", "warn", "off"];
+    default: "off";
+};
 /**
  * The base `paths_hint` property: array-of-string with NO description. Almost
  * every tool that declares `paths_hint` adds a per-tool description specific
@@ -79,8 +92,7 @@ export interface ToolSchemaBody {
  * + `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.
+ * The body is cloned and canonicalized without mutating shared fragments.
+ * Wire-key annotations keep handler arguments aligned with public locators.
  */
 export declare function makeTool(name: string, description: string, body: ToolSchemaBody): Tool;

package/dist/tools/schema-fragments.js

@@ -2,19 +2,18 @@
 //
 // 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
+// per-tool property block, then canonical locator aliases and verify-rule
+// constraints are applied by canonicalSchema. The golden snapshot pins the
+// published result. 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[]`.
+//   1. **Canonical output.** Shared fragments preserve their types;
+//      canonicalSchema adds locator wire mappings, deprecated aliases,
+//      and selectable verify-rule enums consistently across the registry.
+//      The golden snapshot makes every published change explicit.
 //
 //   2. **Description text stays per-tool where it varies.** Most tools have
 //      a unique `paths_hint` description ("Mutation scope — the .anim asset
@@ -39,6 +38,7 @@
 //     },
 //   });
 //   ```
+import { canonicalSchema } from "../tool-contract.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
@@ -51,6 +51,17 @@ export const GATE_PROP = {
     enum: ["enforce", "warn", "off"],
     default: "enforce",
 };
+/** Request-selected gate; omission delegates to the project's bridge setting. */
+export const GATE_REQUEST_PROP = { enum: GATE_PROP.enum };
+/**
+ * Gate selector for the rare mutator whose bridge contract is explicitly
+ * gate-free because it writes external configuration/package pins rather than
+ * Unity assets. Keep the enum canonical while advertising the bridge default.
+ */
+export const GATE_OFF_PROP = {
+    enum: ["enforce", "warn", "off"],
+    default: "off",
+};
 /**
  * The base `paths_hint` property: array-of-string with NO description. Almost
  * every tool that declares `paths_hint` adds a per-tool description specific
@@ -99,21 +110,20 @@ export const CONFIRM_BYPASS_BASE = {
  * + `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.
+ * The body is cloned and canonicalized without mutating shared fragments.
+ * Wire-key annotations keep handler arguments aligned with public locators.
  */
 export function makeTool(name, description, body) {
     return {
         name,
         description,
-        inputSchema: {
+        inputSchema: canonicalSchema(name, {
             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

@@ -1 +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"}
+{"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,0EAA0E;AAC1E,2EAA2E;AAC3E,4DAA4D;AAC5D,uEAAuE;AACvE,oBAAoB;AACpB,EAAE;AACF,sBAAsB;AACtB,EAAE;AACF,oEAAoE;AACpE,uEAAuE;AACvE,0EAA0E;AAC1E,kEAAkE;AAClE,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;AAER,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD;;;;;;;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,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAA+B;IAC9D,OAAO,EAAE,KAAc;CACxB,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;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,WAAmB,EACnB,IAAoB;IAEpB,OAAO;QACL,IAAI;QACJ,WAAW;QACX,WAAW,EAAE,eAAe,CAAC,IAAI,EAAE;YACjC,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,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/upgrade.d.ts

@@ -0,0 +1,40 @@
+export declare const upgrade: {
+    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/upgrade.js

@@ -0,0 +1,55 @@
+import { GATE_OFF_PROP, makeTool } from "./schema-fragments.js";
+export const upgrade = makeTool("unity_open_mcp_upgrade", "Preview or apply a coordinated update of the open Unity project to one trio version. " +
+    "Scans project and home-scoped MCP client configs, agent-facing prose/examples, and the " +
+    "bridge + verify UPM pins. Home configs are rewritten only when their UNITY_PROJECT_PATH " +
+    "belongs exclusively to the open project. `dry_run` defaults true and returns the exact " +
+    "per-file report without writing. With `dry_run:false`, config/prose files receive one-time " +
+    "`.bak` backups before rewriting; a Git-installed bridge and verify pair are then re-pinned " +
+    "atomically through Unity Package Manager, which may reload the Editor. Embedded/file bridge " +
+    "installs are preserved and reported while selected config/prose updates remain available. " +
+    "Omit `target_version` to resolve the latest published npm version explicitly for this call.", {
+    properties: {
+        target_version: {
+            type: "string",
+            pattern: "^\\d+\\.\\d+\\.\\d+$",
+            description: "Target trio version (X.Y.Z). Omit to query the latest npm release.",
+        },
+        dry_run: {
+            type: "boolean",
+            default: true,
+            description: "Preview only by default. Set false to write selected files and schedule UPM.",
+        },
+        update_upm: {
+            type: "boolean",
+            default: true,
+            description: "Update the bridge + verify Git packages atomically when the bridge source is Git.",
+        },
+        update_project_configs: {
+            type: "boolean",
+            default: true,
+            description: "Update MCP client configs found in this project or its repository ancestors.",
+        },
+        update_home_configs: {
+            type: "boolean",
+            default: true,
+            description: "Update home-scoped configs only when the entry belongs exclusively to this project.",
+        },
+        update_prose: {
+            type: "boolean",
+            default: true,
+            description: "Update allowlisted agent prose, installed core skills, and MCP config examples.",
+        },
+        paths_hint: {
+            type: "array",
+            items: { type: "string" },
+            default: ["Packages/manifest.json"],
+            description: "Audit scope materialized automatically. The gate is off because this workflow mutates " +
+                "package/configuration pins rather than Unity assets; packages-lock.json is implicit.",
+        },
+        gate: {
+            ...GATE_OFF_PROP,
+            description: "Defaults off: project-asset validation does not model external configs or UPM pins.",
+        },
+    },
+});
+//# sourceMappingURL=upgrade.js.map

package/dist/tools/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/tools/upgrade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAC7B,wBAAwB,EACxB,uFAAuF;IACrF,yFAAyF;IACzF,0FAA0F;IAC1F,yFAAyF;IACzF,6FAA6F;IAC7F,6FAA6F;IAC7F,8FAA8F;IAC9F,4FAA4F;IAC5F,6FAA6F,EAC/F;IACE,UAAU,EAAE;QACV,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sBAAsB;YAC/B,WAAW,EAAE,oEAAoE;SAClF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,8EAA8E;SAC5F;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,mFAAmF;SACjG;QACD,sBAAsB,EAAE;YACtB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,8EAA8E;SAC5F;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,qFAAqF;SACnG;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,iFAAiF;SAC/F;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,OAAO,EAAE,CAAC,wBAAwB,CAAC;YACnC,WAAW,EACT,wFAAwF;gBACxF,sFAAsF;SACzF;QACD,IAAI,EAAE;YACJ,GAAG,aAAa;YAChB,WAAW,EAAE,qFAAqF;SACnG;KACF;CACF,CACF,CAAC"}

package/dist/unity-install-discovery.d.ts

@@ -11,6 +11,23 @@ export interface ResolvedUnityPath {
     version: string;
     source: UnityPathSource;
 }
+export type UnityPathResolution = {
+    ok: true;
+    value: ResolvedUnityPath;
+} | {
+    ok: false;
+    reason: "not_discovered" | "preferred_not_installed" | "env_version_mismatch";
+    preferredVersion?: string;
+    configuredVersion?: string;
+    availableVersions: string[];
+};
+/** Read the exact editor version recorded by a Unity project. */
+export declare function readProjectUnityVersion(projectPath: string): string | null;
+/**
+ * Best-effort version inference for a conventional Hub executable path.
+ * Unknown/custom layouts deliberately return null rather than guessing.
+ */
+export declare function inferUnityVersionFromExecutablePath(executablePath: string): string | null;
 /**
  * OS-default Unity Hub install roots, matching the Hub's
  * `get_os_default_hub_paths()`. Each holds version-named subfolders
@@ -77,3 +94,10 @@ export declare function versionMatches(candidateVersion: string, projectVersion?
  * real machine state.
  */
 export declare function resolveUnityPath(preferredVersion?: string | null, roots?: string[]): ResolvedUnityPath | null;
+/**
+ * Fail-closed resolver for opening a concrete project in batch mode.
+ * Unlike the legacy/general resolver above, a known project version never
+ * falls through to a neighbouring patch or the newest installed editor unless
+ * the operator explicitly opts in to a mismatch.
+ */
+export declare function resolveUnityPathForProject(preferredVersion: string | null, roots?: string[], allowVersionMismatch?: boolean): UnityPathResolution;