unity-open-mcp 0.9.0 → 1.1.0

package/dist/tools/resource-pressure.js

@@ -30,16 +30,27 @@ export const resourcePressure = makeTool("unity_open_mcp_resource_pressure", "Sa
     "reachable — the bridge is what dies on fd-exhaustion. Resolves the live " +
     "Unity PID via the process scan (same as `bridge_status` cold-Safe-Mode " +
     "detection). Response fields: `fdCount` (null when the probe failed), " +
-    "`fdMethod`, `approximate` (Windows handle count), `ceiling` (fixed 1024), " +
-    "`headroom`, `pressureRatio`, `state` (`ok` | `warn` at ≥80% | `critical` " +
-    "at ≥90% | `unknown` when the probe failed), `trend` (`stable` | `rising` " +
-    "| `leaking` — monotonic climb across successive samples = leak in " +
-    "progress; absolute count alone is not enough), and `samples[]` (the " +
-    "session-scoped in-memory ring of recent samples for this PID — no disk " +
-    "cache). When `state` is warn/critical or `trend.state` is leaking, the " +
-    "agent should surface the risk to the operator and recommend saving scene " +
-    "work + restarting via the Hub before the next domain reload trips the " +
-    "ceiling. Use this after heavy automation (many recompiles / domain " +
+    "`fdMethod`, `approximate` (Windows handle count), `ceiling` (the resolved " +
+    "fd ceiling — default 1024, configurable per project), `ceilingSource` " +
+    "(`\"default\"` | `\"config\"` — whether `.unity-open-mcp/settings.json` " +
+    "`resourcePressure.fdCeiling` overrode the default), `headroom`, " +
+    "`pressureRatio`, `state` (`ok` | `warn` at ≥80% | `critical` at ≥90% | " +
+    "`over_ceiling` when the count already exceeds the ceiling proxy | " +
+    "`unknown` when the probe failed), `trend` (`stable` | `rising` | " +
+    "`leaking` — monotonic climb across successive samples = leak in progress; " +
+    "absolute count alone is not enough), and `samples[]` (the session-scoped " +
+    "in-memory ring of recent samples for this PID — no disk cache). " +
+    "IMPORTANT for fd-heavy projects: an asset-heavy Editor legitimately sits " +
+    "OVER the ceiling proxy on a fresh healthy process (lsof/HandleCount count " +
+    "ALL OS fds — mmap'd assets, file watchers, FileStream handles — while only " +
+    "Mono-IOSelector-registered descriptors trip the hang), so `over_ceiling` " +
+    "is INFORMATIONAL, not an alarm: when `state` is `over_ceiling` and the " +
+    "trend is stable/no-history the response carries a `pressureNote` instead " +
+    "of a `warning`, and you should watch the TREND, not the absolute. The " +
+    "agent should surface a `warning` (recommend saving scene work + planning a " +
+    "restart) when `state` is warn/critical, OR `trend.state` is " +
+    "leaking/rising — do NOT call `restart_editor` yet (the Editor is still " +
+    "healthy). Use this after heavy automation (many recompiles / domain " +
     "reloads) to catch fd growth across reloads. No disk cache — samples live " +
     "in the session store and are cleared on MCP-server restart.", {
     properties: {

package/dist/tools/resource-pressure.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-pressure.js","sourceRoot":"","sources":["../../src/tools/resource-pressure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,2EAA2E;AAC3E,eAAe;AACf,EAAE;AACF,mFAAmF;AACnF,mEAAmE;AACnE,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,SAAS;AACT,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,kCAAkC,EAClC,4EAA4E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,sEAAsE;IACtE,sEAAsE;IACtE,mEAAmE;IACnE,oEAAoE;IACpE,0EAA0E;IAC1E,yEAAyE;IACzE,uEAAuE;IACvE,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,oEAAoE;IACpE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,6DAA6D,EAC/D;IACE,UAAU,EAAE;QACN,GAAG,EAAE;YACH,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,+DAA+D;gBAC/D,mEAAmE;gBACnE,mEAAmE;gBACnE,oEAAoE;gBACpE,gBAAgB;SACnB;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"resource-pressure.js","sourceRoot":"","sources":["../../src/tools/resource-pressure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,2EAA2E;AAC3E,eAAe;AACf,EAAE;AACF,mFAAmF;AACnF,mEAAmE;AACnE,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,SAAS;AACT,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,kCAAkC,EAClC,4EAA4E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,sEAAsE;IACtE,sEAAsE;IACtE,mEAAmE;IACnE,oEAAoE;IACpE,0EAA0E;IAC1E,yEAAyE;IACzE,uEAAuE;IACvE,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,kEAAkE;IAClE,yEAAyE;IACzE,oEAAoE;IACpE,mEAAmE;IACnE,4EAA4E;IAC5E,2EAA2E;IAC3E,kEAAkE;IAClE,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,6EAA6E;IAC7E,8DAA8D;IAC9D,yEAAyE;IACzE,sEAAsE;IACtE,2EAA2E;IAC3E,6DAA6D,EAC/D;IACE,UAAU,EAAE;QACN,GAAG,EAAE;YACH,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,+DAA+D;gBAC/D,mEAAmE;gBACnE,mEAAmE;gBACnE,oEAAoE;gBACpE,gBAAgB;SACnB;KACF;CACN,CACF,CAAC"}

package/dist/tools/run-tests.js

@@ -10,7 +10,11 @@ export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode o
     "looks like 'no results' but is a no-match filter, not a failure. " +
     "Tip: to run a single test method deterministically, invoke the test " +
     "class/method directly via unity_open_mcp_invoke_method — NUnit assertion " +
-    "failures come back verbatim in the error.", {
+    "failures come back verbatim in the error. " +
+    "This call is terminal: it starts the run AND waits for the results file, so there is no " +
+    "polling step for the caller to perform — `run_id` starts a run, it does not read one. " +
+    "It also cannot be a nested unity_open_mcp_batch_execute step (the batch route has no " +
+    "results poller and is refused up-front with batch_step_requires_server_poll).", {
     properties: {
         play_mode: {
             type: "boolean",
@@ -53,7 +57,12 @@ export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode o
         },
         run_id: {
             type: "string",
-            description: "Optional run id. Omit to let the bridge generate a safe one (<pid>-<unixMs>). " +
+            description: "Optional id for the run this call STARTS. It is NOT a poll handle: re-calling " +
+                "run_tests with the id from a previous response does not fetch that run's status — " +
+                "it would start a second run under the same id, so the bridge refuses it while the " +
+                "first is still in flight. There is nothing to poll by hand: this call already " +
+                "waits out `timeout_ms` and returns the terminal result (raise it for a long " +
+                "suite). Omit to let the bridge generate a safe one (<pid>-<unixMs>). " +
                 "Must be 1..128 chars of [A-Za-z0-9._-] only.",
         },
     },

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

@@ -1 +1 @@
-{"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,wDAAwD;IACxD,sEAAsE;IACtE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,sEAAsE;IACtE,2EAA2E;IAC3E,2CAA2C,EAC7C;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,yHAAyH;SACvI;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6EAA6E;gBAC7E,yEAAyE;gBACzE,6BAA6B;SAChC;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;gBACnF,6EAA6E;gBAC7E,uEAAuE;SAC1E;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gFAAgF;gBAChF,8CAA8C;SACjD;KACF;CACN,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,wDAAwD;IACxD,sEAAsE;IACtE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,sEAAsE;IACtE,2EAA2E;IAC3E,4CAA4C;IAC5C,0FAA0F;IAC1F,wFAAwF;IACxF,uFAAuF;IACvF,+EAA+E,EACjF;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,yHAAyH;SACvI;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6EAA6E;gBAC7E,yEAAyE;gBACzE,6BAA6B;SAChC;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;gBACnF,6EAA6E;gBAC7E,uEAAuE;SAC1E;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gFAAgF;gBAChF,oFAAoF;gBACpF,oFAAoF;gBACpF,gFAAgF;gBAChF,8EAA8E;gBAC9E,uEAAuE;gBACvE,8CAA8C;SACjD;KACF;CACN,CACF,CAAC"}

package/dist/tools/scan-all.js

@@ -1,10 +1,10 @@
 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.", {
+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 or any verify rule threw (rulesFailed lists them — the scan is incomplete, not clean).", {
     properties: {
         platform_profile: {
             enum: ["mobile", "console", "desktop"],
             default: "desktop",
-            description: "Stored in output metadata; does not filter rules in M5.",
+            description: "Applied to profile-sensitive rules (shader_analysis mobile-only detections) and echoed in output metadata. Does not filter which rules run.",
         },
         fail_on_severity: {
             enum: ["error", "warn", "info", "verbose", "never"],

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

@@ -1 +1 @@
-{"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"}
+{"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,+UAA+U,EAC/U;IACE,UAAU,EAAE;QACN,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACtC,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,6IAA6I;SAC3J;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/screenshot-window.js

@@ -1,19 +1,25 @@
 import { makeTool } from "./schema-fragments.js";
 // M20 Plan 1 / T20.1.2 — Editor window screenshot. Captures any EditorWindow
 // (Console, Hierarchy, Inspector, Project, Scene, Game, or a custom window).
-// Full-fidelity capture via the Win32 PrintWindow API is Windows-only; on
-// macOS/Linux a best-effort screen-rect readback is used and the response
-// carries platformLimited: true so the agent knows the capture may be partial
-// when the window is occluded. Returns the saved PNG file path.
+// feedback #6 (2026-08-07): on macOS/Linux the screen-readback path reads from
+// an unbound backbuffer during bridge dispatch and produces a blank frame, so
+// the tool now returns a structured `not_supported` error there (use the OS
+// screen-capture tool, or screenshot {view:"composed"} for the rendered Game
+// view). On Windows a screen-rect readback is used and a post-capture
+// solid-color check rejects blank frames with a `blank_capture` error instead
+// of reporting status:ok. `resolution` reports the actual capture size.
 export const screenshotWindow = makeTool("unity_senses_screenshot_window", "Capture a Unity Editor window (Console, Hierarchy, Inspector, Project, " +
-    "Scene, Game, or any custom EditorWindow) to a PNG file. Full-fidelity " +
-    "capture (occlusion-proof, no focus stealing) is Windows-only via the " +
-    "Win32 PrintWindow API; on macOS/Linux a best-effort screen-rect readback " +
-    "is used and the response carries platformLimited: true, so the capture " +
-    "may be partial or stale when the window is hidden behind others. Provide " +
-    "either window_title (visible tab text, e.g. \"Console\") or window_type " +
-    "(EditorWindow type name, e.g. \"UnityEditor.ConsoleWindow\"). Returns " +
-    "the saved PNG file path. Requires a live Unity Editor connection.", {
+    "Scene, Game, or any custom EditorWindow) to a PNG file. Windows-only: on " +
+    "macOS/Linux returns a `not_supported` error (the editor-window backbuffer " +
+    "is not bound during bridge dispatch, so a blank frame would result — use " +
+    "the OS screen-capture tool, or screenshot {view:\"composed\"} for the " +
+    "rendered Game view). On Windows a screen-rect readback is used; a blank/" +
+    "solid-color frame is rejected with a `blank_capture` error. `resolution` " +
+    "reports the ACTUAL capture size (clamped to the window's on-screen rect), " +
+    "not the requested maximum. Provide either window_title (visible tab text, " +
+    "e.g. \"Console\") or window_type (EditorWindow type name, e.g. " +
+    "\"UnityEditor.ConsoleWindow\"). Returns the saved PNG file path. Requires " +
+    "a live Unity Editor connection.", {
     properties: {
         window_title: {
             type: "string",

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

@@ -1 +1 @@
-{"version":3,"file":"screenshot-window.js","sourceRoot":"","sources":["../../src/tools/screenshot-window.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,gCAAgC,EAChC,yEAAyE;IACvE,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,mEAAmE,EACrE;IACE,UAAU,EAAE;QACN,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4DAA4D;gBAC5D,mEAAmE;gBACnE,iEAAiE;gBACjE,+CAA+C;SAClD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0DAA0D;gBAC1D,6DAA6D;gBAC7D,mDAAmD;SACtD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,oEAAoE;gBACpE,+BAA+B;SAClC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,qEAAqE;gBACrE,gCAAgC;SACnC;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"screenshot-window.js","sourceRoot":"","sources":["../../src/tools/screenshot-window.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,sEAAsE;AACtE,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,gCAAgC,EAChC,yEAAyE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,iEAAiE;IACjE,4EAA4E;IAC5E,iCAAiC,EACnC;IACE,UAAU,EAAE;QACN,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4DAA4D;gBAC5D,mEAAmE;gBACnE,iEAAiE;gBACjE,+CAA+C;SAClD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0DAA0D;gBAC1D,6DAA6D;gBAC7D,mDAAmD;SACtD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,oEAAoE;gBACpE,+BAA+B;SAClC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,qEAAqE;gBACrE,gCAAgC;SACnC;KACF;CACN,CACF,CAAC"}

package/dist/tools/screenshot.js

@@ -1,16 +1,23 @@
 import { makeTool } from "./schema-fragments.js";
-export const screenshot = makeTool("unity_senses_screenshot", "Capture a screenshot from the Unity Editor. Supports three views: " +
-    "'scene' (the Scene view), 'game' (the main camera / Game view), and " +
+export const screenshot = makeTool("unity_senses_screenshot", "Capture a screenshot from the Unity Editor. Supports four views: " +
+    "'scene' (the Scene view), 'game' (renders Camera.main only — NOT the full " +
+    "Game view; Screen-Space Overlay UI and multi-camera compositions are NOT " +
+    "included), 'composed' (the player's full composite frame — every camera by " +
+    "depth plus Screen-Space Overlay canvases; use this to verify UI edits), and " +
     "'isolated' (a clean 2x2 composite — Front/Right/Back/Top — of a single " +
     "GameObject with layer culling and background choice). " +
     "Returns the saved PNG file path. Requires a live Unity Editor connection.", {
     properties: {
         view: {
             type: "string",
-            enum: ["scene", "game", "isolated"],
+            enum: ["scene", "game", "composed", "isolated"],
             default: "scene",
-            description: "Capture target. 'scene' = Scene view camera, 'game' = main game camera, " +
-                "'isolated' = clean 2x2 composite of one GameObject.",
+            description: "Capture target. 'scene' = Scene view camera, 'game' = Camera.main only " +
+                "(Overlay canvases and other cameras are NOT rendered — prefer 'composed' " +
+                "to verify UI), 'composed' = the player's full frame (all cameras by depth + " +
+                "Screen-Space Overlay UI; in play mode uses ScreenCapture, in edit mode " +
+                "composites enabled cameras by depth), 'isolated' = clean 2x2 composite of " +
+                "one GameObject.",
         },
         width: {
             type: "integer",
@@ -35,7 +42,7 @@ export const screenshot = makeTool("unity_senses_screenshot", "Capture a screens
             type: "string",
             enum: ["transparent", "solid", "skybox"],
             default: "skybox",
-            description: "Background for 'isolated' view. Ignored for scene/game.",
+            description: "Background for 'isolated' view. Ignored for scene/game/composed.",
         },
     },
 });

package/dist/tools/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAChC,yBAAyB,EACzB,oEAAoE;IAClE,sEAAsE;IACtE,yEAAyE;IACzE,wDAAwD;IACxD,2EAA2E,EAC7E;IACE,UAAU,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;YACnC,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,0EAA0E;gBAC1E,qDAAqD;SACxD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,mFAAmF;SACtF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,oFAAoF;SACvF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,wEAAwE;gBACxE,0CAA0C;SAC7C;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,yDAAyD;SACvE;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAChC,yBAAyB,EACzB,mEAAmE;IACjE,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,wDAAwD;IACxD,2EAA2E,EAC7E;IACE,UAAU,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;YAC/C,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,yEAAyE;gBACzE,2EAA2E;gBAC3E,8EAA8E;gBAC9E,yEAAyE;gBACzE,4EAA4E;gBAC5E,iBAAiB;SACpB;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,mFAAmF;SACtF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,oFAAoF;SACvF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,wEAAwE;gBACxE,0CAA0C;SAC7C;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,kEAAkE;SAChF;KACF;CACN,CACF,CAAC"}

package/dist/tools/visual-compare.d.ts

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

@@ -0,0 +1,98 @@
+import { makeTool } from "./schema-fragments.js";
+// Visual regression compare — the one transferable idea worth taking from
+// unity-biome-mcp's "visual baseline/diff" feature. Capture a named reference
+// snapshot from a view (scene / game / isolated), then compare later captures
+// against it. The bridge returns pixelDiffPercent / mismatchedPixels /
+// perceptualDistance (8x8 aHash Hamming distance) / match, plus an inline diff
+// image (mismatched pixels in red over the current frame) when the diff is
+// non-zero. The diff image is carried as an `inlineImage` field the MCP server
+// unwraps into an MCP image content block (same mechanism as capture_inline).
+//
+// "reference snapshot" / "visual compare" is used instead of "baseline" — that
+// name is already taken by the verify-issue baseline tools (baseline_create,
+// regression_check), which compare compiler-error / project-health snapshots,
+// not images.
+export const visualCompare = makeTool("unity_senses_visual_compare", "Visual regression compare. Capture a named reference snapshot from a view " +
+    "(scene / game / isolated), then compare later captures against it to check " +
+    "whether an edit visually broke anything. Returns pixelDiffPercent, " +
+    "mismatchedPixels, perceptualDistance (8x8 average-hash Hamming distance — " +
+    "tolerates minor anti-aliasing drift), and match (true when pixelDiffPercent " +
+    "<= sensitivity * 100). On a non-zero diff, returns an inline diff image " +
+    "(mismatched pixels highlighted red over the current frame) as an MCP image " +
+    "content block. Actions: 'save' (capture + store a named reference), " +
+    "'compare' (capture + diff vs the named reference), 'list' (enumerate saved " +
+    "references), 'delete' (remove a reference). References persist under " +
+    "~/.unity-open-mcp/screenshots/references/. Requires a live Unity Editor " +
+    "connection.", {
+    properties: {
+        action: {
+            type: "string",
+            enum: ["save", "compare", "list", "delete"],
+            description: "save: capture + store a named reference. compare: capture + diff vs " +
+                "the named reference. list: enumerate saved references. delete: remove " +
+                "a named reference.",
+        },
+        name: {
+            type: "string",
+            description: "Reference name (required for save / compare / delete). Flat filename " +
+                "only — no path separators or traversal. Stored as " +
+                "<name>.png + <name>.meta.json.",
+        },
+        view: {
+            type: "string",
+            enum: ["scene", "game", "isolated"],
+            default: "game",
+            description: "Capture target. 'scene' = Scene view camera, 'game' = main game " +
+                "camera (default — visual regression usually targets what the player " +
+                "sees), 'isolated' = clean 2x2 composite of one GameObject. Ignored " +
+                "for list / delete.",
+        },
+        width: {
+            type: "integer",
+            default: 1280,
+            minimum: 64,
+            maximum: 4096,
+            description: "Capture width in pixels. For 'isolated', this is per-quadrant. The " +
+                "compare resamples the current capture to the reference dimensions if " +
+                "they differ, so the diff is resolution-stable.",
+        },
+        height: {
+            type: "integer",
+            default: 720,
+            minimum: 64,
+            maximum: 4096,
+            description: "Capture height in pixels. For 'isolated', this is per-quadrant.",
+        },
+        object_path: {
+            type: "string",
+            description: "Required for 'isolated' view. Hierarchy path of the target " +
+                "GameObject (e.g. \"Player\" or \"Enemies/Goblin\").",
+        },
+        background: {
+            type: "string",
+            enum: ["transparent", "solid", "skybox"],
+            default: "skybox",
+            description: "Background for 'isolated' view. Ignored for scene/game.",
+        },
+        sensitivity: {
+            type: "number",
+            default: 0.01,
+            minimum: 0,
+            maximum: 1,
+            description: "[compare] Match threshold as a fraction of mismatched pixels (0–1). " +
+                "match is true when pixelDiffPercent <= sensitivity * 100. Default 0.01 " +
+                "= 1% pixel diff. Raise for noisier scenes (dynamic backgrounds, " +
+                "particle systems); 0 = require an exact match.",
+        },
+        include_diff_image: {
+            type: "boolean",
+            default: true,
+            description: "[compare] When true (default) and the diff is non-zero, return the " +
+                "diff image (current frame with mismatched pixels set to red) as an " +
+                "inline MCP image content block. Set false to skip the image and " +
+                "receive metrics only.",
+        },
+    },
+    required: ["action"],
+});
+//# sourceMappingURL=visual-compare.js.map

package/dist/tools/visual-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-compare.js","sourceRoot":"","sources":["../../src/tools/visual-compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AACvE,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,cAAc;AACd,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,6BAA6B,EAC7B,4EAA4E;IAC1E,6EAA6E;IAC7E,qEAAqE;IACrE,4EAA4E;IAC5E,8EAA8E;IAC9E,0EAA0E;IAC1E,6EAA6E;IAC7E,sEAAsE;IACtE,6EAA6E;IAC7E,uEAAuE;IACvE,0EAA0E;IAC1E,aAAa,EACf;IACE,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC3C,WAAW,EACT,sEAAsE;gBACtE,wEAAwE;gBACxE,oBAAoB;SACvB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uEAAuE;gBACvE,oDAAoD;gBACpD,gCAAgC;SACnC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;YACnC,OAAO,EAAE,MAAM;YACf,WAAW,EACT,kEAAkE;gBAClE,sEAAsE;gBACtE,qEAAqE;gBACrE,oBAAoB;SACvB;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,qEAAqE;gBACrE,uEAAuE;gBACvE,gDAAgD;SACnD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,WAAW,EACT,iEAAiE;SACpE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,qDAAqD;SACxD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,yDAAyD;SACvE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EACT,sEAAsE;gBACtE,yEAAyE;gBACzE,kEAAkE;gBAClE,gDAAgD;SACnD;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACT,qEAAqE;gBACrE,qEAAqE;gBACrE,kEAAkE;gBAClE,uBAAuB;SAC1B;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CACF,CAAC"}

package/dist/unity-log.d.ts

@@ -43,7 +43,7 @@ export declare function projectEditorPrevLogPath(projectPath: string | null | un
  *  fell back to Editor-prev.log"). */
 export interface ResolvedEditorLog {
     path: string;
-    reason: "project_log" | "global_log" | "prev_log_live_editor" | "prev_log_fallback";
+    reason: "project_log" | "global_log" | "global_log_fresher" | "prev_log_live_editor" | "prev_log_fallback";
 }
 /**
  * Pick the authoritative Editor.log to read for compile-error extraction.
@@ -70,7 +70,7 @@ export interface ResolvedEditorLog {
  * rotation. `livePid` is optional; when absent the prev.log fallback only
  * triggers on a frozen-looking log, which is conservative.
  */
-export declare function resolveEditorLogPath(projectPath: string | null | undefined, platform?: UnityLogPlatform, livePid?: number): ResolvedEditorLog;
+export declare function resolveEditorLogPath(projectPath: string | null | undefined, platform?: UnityLogPlatform, livePid?: number, globalLogPathOverride?: string): ResolvedEditorLog;
 /** Default tail size. Bounded so a multi-MB log can't blow up the tool
  *  response; 256KB is ample for a compile-error burst (Unity writes the
  *  diagnostics in a contiguous block near the end of the log). */
@@ -149,3 +149,68 @@ export interface StaleAssemblyResult {
  * Never throws; returns a clean "not stale" on any resolution failure.
  */
 export declare function detectStaleAssembly(projectRoot: string | null | undefined): StaleAssemblyResult;
+export interface ErrorsPredateEditsResult {
+    /** Cited source files (project-relative) newer than the newest built DLL. */
+    files: string[];
+    /** Newest `Library/ScriptAssemblies/*.dll` mtime in epoch ms. */
+    dllMtimeMs: number;
+}
+/**
+ * Decide whether the reported compiler errors predate the on-disk edits to the
+ * files they cite.
+ *
+ * Returns `null` when the question cannot be answered (no project root, no
+ * built DLL mtime, no cited file resolvable inside the project) or when every
+ * cited file is older than the newest built assembly — i.e. a compile has run
+ * since the edits and the errors are current. Never throws.
+ */
+export declare function detectErrorsPredatingEdits(citedFiles: ReadonlyArray<string>, projectRoot: string | null | undefined, dllMtimeMs: number | undefined): ErrorsPredateEditsResult | null;
+export interface LogAuthorship {
+    /** Unity version parsed from the log header's "Unity Editor version:" line,
+     *  e.g. "6000.5.5f1". null when the header was not present in the tail. */
+    logUnityVersion: string | null;
+    /** True when the header's "Batch mode:" line is "YES". null when absent. */
+    logBatchMode: boolean | null;
+    /** ISO timestamp parsed from the header's "Date:" line, when present. */
+    logDate: string | null;
+}
+/**
+ * Parse the Unity Editor.log header fields that identify WHO wrote the log.
+ * Scans only the tail content already read by the tool (no extra disk I/O).
+ *
+ * Returns nulls (not throws) when the header lines are absent — a long-running
+ * live editor's tail starts mid-log and won't contain the header, which is the
+ * benign case (no version to compare against, so no false mismatch).
+ */
+export declare function parseLogAuthorship(tail: string): LogAuthorship;
+export interface LogAuthorshipMismatch {
+    /** True when the log's Unity version differs from the live bridge's. */
+    versionMismatch: boolean;
+    /** The version that wrote the log (from the header). */
+    logUnityVersion: string | null;
+    /** The live bridge's version, when known. */
+    liveUnityVersion: string | null;
+    /** True when the log was written by a -batchmode run (not the live editor). */
+    logBatchMode: boolean | null;
+    /** One-line agent-facing warning. Empty when not a mismatch. */
+    hint: string;
+}
+/**
+ * Compare the log's authorship against the live bridge's Unity version. This is
+ * the cross-check feedback-04-08-opus §2 asks for: a batch run of a NEWER Unity
+ * leaves a log whose errors (e.g. a deprecation that is only an error on that
+ * version) cannot occur in the live editor, so surfacing them as "current"
+ * sends the agent chasing ghosts (or refusing to continue) for minutes.
+ *
+ * Two cheap signals, both from data already at hand:
+ *   - the log's "Unity Editor version:" vs the live bridge unityVersion
+ *   - the log's "Batch mode:" flag (a batch run is never the live editor)
+ *
+ * Conservative: only flags a mismatch when BOTH the log version parsed AND a
+ * live version is known, AND they differ. A null log version (header scrolled
+ * past the tail) never fires — there is nothing to compare. When the log is a
+ * batch run but the versions agree, we surface the batch-mode flag WITHOUT
+ * calling it a mismatch (the agent still benefits from knowing it is a batch
+ * log). The router decides how to fold this into the response.
+ */
+export declare function compareLogAuthorship(authorship: LogAuthorship, liveUnityVersion: string | null | undefined): LogAuthorshipMismatch;