unity-open-mcp 0.5.0 → 0.6.1

package/dist/tools/probuilder-create-shape.js

@@ -1,7 +1,7 @@
-// M16 Plan 10 / T6.6.5 — ProBuilder extension tool. Requires the
-// `com.alexeyperov.unity-open-mcp-ext-probuilder` extension pack installed in
-// the target project. Mutating: runs the full gate path; paths_hint is the
-// active scene path.
+// M16 Plan 10 / T6.6.5 — ProBuilder extension tool. The bridge-side handler
+// is embedded in the bridge (compile-gated by UNITY_OPEN_MCP_EXT_PROBUILDER,
+// active when com.unity.probuilder is present). Mutating: runs the full gate
+// path; paths_hint is the active scene path.
 export const probuilderCreateShape = {
     name: "unity_open_mcp_probuilder_create_shape",
     description: "Create a new editable ProBuilderMesh GameObject from a ShapeType primitive " +

package/dist/tools/probuilder-create-shape.js.map

@@ -1 +1 @@
-{"version":3,"file":"probuilder-create-shape.js","sourceRoot":"","sources":["../../src/tools/probuilder-create-shape.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,8EAA8E;AAC9E,2EAA2E;AAC3E,qBAAqB;AACrB,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,6EAA6E;QAC7E,2EAA2E;QAC3E,8EAA8E;QAC9E,2EAA2E;QAC3E,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,0EAA0E;oBAC1E,yCAAyC;aAC5C;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YAC1E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YAC1F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0EAA0E;aACxF;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"probuilder-create-shape.js","sourceRoot":"","sources":["../../src/tools/probuilder-create-shape.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,6EAA6E;QAC7E,2EAA2E;QAC3E,8EAA8E;QAC9E,2EAA2E;QAC3E,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM;gBACf,WAAW,EACT,0EAA0E;oBAC1E,yCAAyC;aAC5C;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YAC1E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YAC1F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0EAA0E;aACxF;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;SAC/D;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

@@ -1,13 +1,14 @@
 // Offline, filesystem-only tool: reads the tail of Unity's Editor.log and
-// extracts BOTH C# compiler errors AND package / assembly-level red flags.
-// 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 to Editor.log
-// regardless of bridge health, so this tool retrieves them without touching
-// Unity or the bridge.
+// 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
@@ -22,36 +23,48 @@
 //   - 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 red flags with kind + hint:
+//   - 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 = {
     name: "unity_open_mcp_read_compile_errors",
-    description: "Read C# compiler errors AND package/assembly red flags directly from " +
-        "Unity's Editor.log (offline, no bridge, no Unity spawn). Returns " +
-        "structured CSxxxx compiler errors (file/line/code/message) PLUS a " +
-        "`issues` list of package-level 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), and package_manager_error (conflict / resolution errors). " +
-        "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. 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). Force a genuine recompile via unity_open_mcp_reimport_package " +
-        "(local package) or unity_open_mcp_compile_check before trusting the errors.",
+    description: "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). Force a genuine recompile via " +
+        "unity_open_mcp_reimport_package (local package) or " +
+        "unity_open_mcp_compile_check before trusting the errors.",
     inputSchema: {
         type: "object",
         properties: {

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":"AAEA,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,uBAAuB;AACvB,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,mBAAmB;AACnB,yEAAyE;AACzE,iEAAiE;AACjE,6DAA6D;AAC7D,uEAAuE;AACvE,+DAA+D;AAC/D,wEAAwE;AACxE,6EAA6E;AAC7E,iEAAiE;AACjE,sEAAsE;AACtE,8EAA8E;AAC9E,iBAAiB;AACjB,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,uEAAuE;QACvE,mEAAmE;QACnE,oEAAoE;QACpE,mEAAmE;QACnE,yEAAyE;QACzE,wEAAwE;QACxE,iEAAiE;QACjE,yEAAyE;QACzE,qEAAqE;QACrE,gEAAgE;QAChE,sEAAsE;QACtE,sEAAsE;QACtE,wEAAwE;QACxE,uEAAuE;QACvE,oEAAoE;QACpE,2EAA2E;QAC3E,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,4EAA4E;QAC5E,6EAA6E;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,6DAA6D;oBAC7D,oEAAoE;oBACpE,kEAAkE;oBAClE,mEAAmE;aACtE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AAEA,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,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,GAAS;IACrC,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,uEAAuE;QACvE,uEAAuE;QACvE,0DAA0D;QAC1D,mEAAmE;QACnE,6DAA6D;QAC7D,+DAA+D;QAC/D,2DAA2D;QAC3D,6DAA6D;QAC7D,4DAA4D;QAC5D,mEAAmE;QACnE,yEAAyE;QACzE,kEAAkE;QAClE,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,yEAAyE;QACzE,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,oEAAoE;QACpE,qEAAqE;QACrE,kEAAkE;QAClE,qEAAqE;QACrE,iEAAiE;QACjE,qDAAqD;QACrD,0DAA0D;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,WAAW,EACT,6DAA6D;oBAC7D,oEAAoE;oBACpE,kEAAkE;oBAClE,mEAAmE;aACtE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-get-data.js

@@ -13,15 +13,23 @@ export const sceneGetData = {
         "`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. Omit (or empty) to read the active scene. Use scene_list_opened " +
-                    "to enumerate opened scene names.",
+                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"],

package/dist/tools/scene-get-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-get-data.js","sourceRoot":"","sources":["../../src/tools/scene-get-data.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,0FAA0F;QAC1F,kFAAkF;QAClF,uGAAuG;QACvG,6FAA6F;QAC7F,8FAA8F;QAC9F,4FAA4F;QAC5F,6FAA6F;QAC7F,gFAAgF;QAChF,gDAAgD;QAChD,4FAA4F;QAC5F,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qFAAqF;oBACrF,kCAAkC;aACrC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,kGAAkG;oBAClG,kGAAkG;oBAClG,0GAA0G;oBAC1G,0FAA0F;aAC7F;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,qGAAqG;oBACrG,wGAAwG;oBACxG,iDAAiD;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sGAAsG;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,6FAA6F;oBAC7F,kDAAkD;aACrD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,yGAAyG;oBACzG,uEAAuE;aAC1E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,sFAAsF;oBACtF,kEAAkE;aACrE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"scene-get-data.js","sourceRoot":"","sources":["../../src/tools/scene-get-data.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,0FAA0F;QAC1F,kFAAkF;QAClF,uGAAuG;QACvG,6FAA6F;QAC7F,8FAA8F;QAC9F,4FAA4F;QAC5F,6FAA6F;QAC7F,gFAAgF;QAChF,gDAAgD;QAChD,6FAA6F;QAC7F,6EAA6E;QAC7E,4FAA4F;QAC5F,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,uFAAuF;oBACvF,0DAA0D;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sFAAsF;oBACtF,+EAA+E;aAClF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;gBACrC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,kGAAkG;oBAClG,kGAAkG;oBAClG,0GAA0G;oBAC1G,0FAA0F;aAC7F;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,qGAAqG;oBACrG,wGAAwG;oBACxG,iDAAiD;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sGAAsG;aACzG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,SAAS;gBAClB,WAAW,EACT,6FAA6F;oBAC7F,kDAAkD;aACrD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,yGAAyG;oBACzG,uEAAuE;aAC1E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,sFAAsF;oBACtF,kEAAkE;aACrE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/tools/scene-save.js

@@ -1,12 +1,21 @@
 // M16 Plan 3 — typed scene save. Mutating: writes an opened scene back to
 // its .unity asset (or a new path). Runs the full gate path.
+//
+// Scene identity + destination: `path` does double duty. When it matches an
+// opened scene's asset path, it selects that scene and saves it back to its
+// own path (path-as-identity). When it does NOT match an opened scene, it is a
+// save-as destination for the active (or `name`-selected) scene. `name`
+// always selects an opened scene by display name when supplied.
 export const sceneSave = {
     name: "unity_open_mcp_scene_save",
     description: "Save an opened scene back to its asset file, or to a new `.unity` path when `path` is " +
         "provided. Mutating: runs the full gate path; `paths_hint` should be the destination `.unity` " +
-        "asset path. When `name` is omitted, saves the active scene. Returns { saved, name, path } " +
-        "with `saved: false` and a note when the scene was not dirty (idempotent). Prefer this over " +
-        "raw execute_csharp EditorSceneManager.SaveScene.",
+        "asset path. When `name` is omitted, saves the active scene. `path` is dual-purpose: when it " +
+        "matches an opened scene's asset path it selects that scene and saves it back to its own " +
+        "path (path-as-identity); otherwise it is a save-as destination for the active or " +
+        "`name`-selected scene. Returns { saved, name, path } with `saved: false` and a note when the " +
+        "scene was not dirty (idempotent). Prefer this over raw execute_csharp " +
+        "EditorSceneManager.SaveScene.",
     inputSchema: {
         type: "object",
         required: ["paths_hint"],
@@ -18,8 +27,10 @@ export const sceneSave = {
             },
             path: {
                 type: "string",
-                description: "Optional destination `.unity` asset path (save-as). Omit to save back to the scene's " +
-                    "existing path. When provided, must end with '.unity'.",
+                description: "Dual-purpose. When it matches an opened scene's asset path (e.g. " +
+                    "'Assets/Scenes/Foo.unity'), it selects that scene and saves it back to its own path " +
+                    "(path-as-identity). When it does not match an opened scene, it is a save-as destination " +
+                    "for the active or `name`-selected scene and must end with '.unity'.",
             },
             paths_hint: {
                 type: "array",

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

@@ -1 +1 @@
-{"version":3,"file":"scene-save.js","sourceRoot":"","sources":["../../src/tools/scene-save.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,wFAAwF;QACxF,+FAA+F;QAC/F,4FAA4F;QAC5F,6FAA6F;QAC7F,kDAAkD;IACpD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2EAA2E;oBAC3E,oDAAoD;aACvD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,uFAAuF;oBACvF,uDAAuD;aAC1D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,uFAAuF;oBACvF,qBAAqB;aACxB;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-save.js","sourceRoot":"","sources":["../../src/tools/scene-save.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,wEAAwE;AACxE,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,wFAAwF;QACxF,+FAA+F;QAC/F,8FAA8F;QAC9F,0FAA0F;QAC1F,mFAAmF;QACnF,+FAA+F;QAC/F,wEAAwE;QACxE,+BAA+B;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2EAA2E;oBAC3E,oDAAoD;aACvD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mEAAmE;oBACnE,sFAAsF;oBACtF,0FAA0F;oBAC1F,qEAAqE;aACxE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,uFAAuF;oBACvF,qBAAqB;aACxB;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"}

package/dist/tools/scene-set-active.js

@@ -1,21 +1,37 @@
 // M16 Plan 3 — typed scene set active. Mutating: marks an opened scene as
 // the active scene. Runs the full gate path.
+//
+// Scene identity (path-first): `path` resolves an opened scene by its asset
+// path; `name` resolves by display name. Precedence: when both are supplied,
+// `path` wins (asset paths are the authoritative identity for an asset-centric
+// MCP); `name` is the fallback when only it is supplied.
 export const sceneSetActive = {
     name: "unity_open_mcp_scene_set_active",
     description: "Mark an opened scene as the editor's active scene (the scene new GameObjects are added to " +
         "and the default for many operations). Mutating: runs the full gate path; `paths_hint` should " +
         "be the scene's asset path. The target scene must already be opened (use scene_open first). " +
-        "Returns the post-set list of opened scenes (name/path/isDirty/isLoaded/rootCount/buildIndex/" +
-        "isActive) so the agent can confirm which scene is now active. Prefer this over raw " +
-        "execute_csharp EditorSceneManager.SetActiveScene.",
+        "Scene identity is path-first: provide `path` (the scene's `Assets/.../*.unity` asset path) to " +
+        "resolve unambiguously, or `name` to resolve by display name. When both are supplied, `path` " +
+        "wins and `name` is ignored. The response carries `resolvedBy` (\"path\" or \"name\") so the " +
+        "agent can tell which identity key resolved the target — useful for debugging duplicate-name " +
+        "ambiguity. Returns the post-set list of opened scenes (name/path/isDirty/" +
+        "isLoaded/rootCount/buildIndex/isActive) so the agent can confirm which scene is now active. " +
+        "Prefer this over raw execute_csharp EditorSceneManager.SetActiveScene.",
     inputSchema: {
         type: "object",
-        required: ["name", "paths_hint"],
+        required: ["paths_hint"],
         properties: {
+            path: {
+                type: "string",
+                description: "Opened scene asset path (e.g. 'Assets/Scenes/Foo.unity') to mark as active. Resolves the " +
+                    "scene by its asset path — the authoritative identity. When supplied, takes precedence " +
+                    "over `name`. Use scene_list_opened to enumerate opened scene paths.",
+            },
             name: {
                 type: "string",
-                description: "Name of the opened scene to mark as active. Must match an opened scene. Use " +
-                    "scene_list_opened to enumerate opened scene names.",
+                description: "Name of the opened scene to mark as active (fallback when `path` is not supplied). Must " +
+                    "match an opened scene's display name. Use scene_list_opened to enumerate opened scene " +
+                    "names.",
             },
             paths_hint: {
                 type: "array",

package/dist/tools/scene-set-active.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-set-active.js","sourceRoot":"","sources":["../../src/tools/scene-set-active.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,4FAA4F;QAC5F,+FAA+F;QAC/F,6FAA6F;QAC7F,8FAA8F;QAC9F,qFAAqF;QACrF,mDAAmD;IACrD,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,8EAA8E;oBAC9E,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0CAA0C;aACxD;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-set-active.js","sourceRoot":"","sources":["../../src/tools/scene-set-active.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,4FAA4F;QAC5F,+FAA+F;QAC/F,6FAA6F;QAC7F,gGAAgG;QAChG,8FAA8F;QAC9F,8FAA8F;QAC9F,8FAA8F;QAC9F,2EAA2E;QAC3E,8FAA8F;QAC9F,wEAAwE;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,2FAA2F;oBAC3F,wFAAwF;oBACxF,qEAAqE;aACxE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0FAA0F;oBAC1F,wFAAwF;oBACxF,QAAQ;aACX;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,0CAA0C;aACxD;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"}

package/dist/tools/scene-unload.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,wFAAwF;QACxF,0FAA0F;QAC1F,+CAA+C;IACjD,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,sEAAsE;oBACtE,oDAAoD;aACvD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}
+{"version":3,"file":"scene-unload.js","sourceRoot":"","sources":["../../src/tools/scene-unload.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0FAA0F;QAC1F,sFAAsF;QACtF,8FAA8F;QAC9F,+FAA+F;QAC/F,2FAA2F;QAC3F,gGAAgG;QAChG,0BAA0B;QAC1B,gGAAgG;QAChG,oEAAoE;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yFAAyF;oBACzF,uFAAuF;oBACvF,gEAAgE;aACnE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;oBACxF,wFAAwF;aAC3F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,mFAAmF;oBACnF,gBAAgB;aACnB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,SAAS;aACnB;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unity-open-mcp",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "MCP server (stdio) routing tool calls to the live Unity Open MCP Bridge or batch Unity processes.",
   "type": "module",
   "main": "dist/index.js",