unity-open-mcp 0.8.4 → 1.0.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

@@ -2,7 +2,15 @@ import { makeTool } from "./schema-fragments.js";
 export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode or PlayMode tests and return structured results. " +
     "EditMode runs in-process and results are available within seconds. " +
     "PlayMode survives domain reload via file handoff. " +
-    "Filter by assembly, namespace, class, or method name.", {
+    "Filter by assembly, namespace, class, or method name. " +
+    "Results are retrieved by the server polling a results file (NOT via " +
+    "unity_senses_pull_events, which streams only console/editor-state). " +
+    "Note: when the filter matches ZERO tests, Execute runs nothing and the " +
+    "result carries status completed with summary.total:0 and a note — this " +
+    "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.", {
     properties: {
         play_mode: {
             type: "boolean",
@@ -11,7 +19,7 @@ export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode o
         },
         assembly_name: {
             type: "string",
-            description: "Filter: run tests in this assembly only (e.g. 'MyAssembly').",
+            description: "Filter: run tests in this assembly only (e.g. 'MyAssembly'). Must name a real test assembly or the run matches nothing.",
         },
         test_namespace: {
             type: "string",
@@ -19,7 +27,9 @@ export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode o
         },
         test_class: {
             type: "string",
-            description: "Filter: run tests in this class (full or partial name).",
+            description: "Filter: run tests in this class. Maps to NUnit groupNames (a partial/group " +
+                "match), so a partial class name may match more or less than expected — " +
+                "prefer the full class name.",
         },
         test_method: {
             type: "string",
@@ -37,7 +47,14 @@ export const runTests = makeTool("unity_senses_run_tests", "Run Unity EditMode o
             default: 60000,
             minimum: 1000,
             maximum: 600000,
-            description: "Maximum time to wait for results (PlayMode may take longer due to domain reload).",
+            description: "Client-side polling budget (milliseconds) the server waits for the results file. " +
+                "Not a bridge parameter — the bridge run is async and writes a results file " +
+                "the server polls. Raise for PlayMode (domain reload) or large suites.",
+        },
+        run_id: {
+            type: "string",
+            description: "Optional run id. 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,uDAAuD,EACzD;IACE,UAAU,EAAE;QACN,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,iEAAiE;SAC/E;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8DAA8D;SAC5E;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yDAAyD;SACvE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2DAA2D;SACzE;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EACT,kEAAkE;gBAClE,kEAAkE;gBAClE,2DAA2D;SAC9D;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;YACf,WAAW,EACT,mFAAmF;SACtF;KACF;CACN,CACF,CAAC"}
+{"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"}

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/ui-canvas-add.js

@@ -25,12 +25,14 @@ const targetSchema = {
 };
 export const uiCanvasAdd = makeTool("unity_open_mcp_ui_canvas_add", "Add a Canvas to a GameObject (or as a new scene root when no host is addressed). " +
     "Ensures the canvas has a CanvasScaler + GraphicRaycaster, and ensures an EventSystem " +
-    "exists in the open scene(s). Set render_mode (ScreenSpaceOverlay | ScreenSpaceCamera | " +
-    "WorldSpace, default ScreenSpaceOverlay) and sorting_order (default 0). Idempotent — " +
-    "re-using an existing Canvas reports added:false (the scaler / raycaster / EventSystem " +
-    "are still ensured). Mutating: runs the full gate path; paths_hint is the host / " +
-    "new-root scene path. Built-in UI module (no package dependency); the ui group is " +
-    "hidden until manage_tools activates it.", {
+    "exists in the Canvas's scene (scoped per-scene so a stray EventSystem is not created in or " +
+    "stolen from a different loaded scene). Set render_mode (ScreenSpaceOverlay | ScreenSpaceCamera | " +
+    "WorldSpace, default ScreenSpaceOverlay) and sorting_order (default 0). When multiple scenes are " +
+    "loaded, pass scene_path/scene_name to control which scene receives the new Canvas root + " +
+    "EventSystem — otherwise both land in the active scene. Idempotent — re-using an existing Canvas " +
+    "reports added:false (the scaler / raycaster / EventSystem are still ensured). Mutating: runs the " +
+    "full gate path; paths_hint is the host / new-root scene path. Built-in UI module (no package " +
+    "dependency); the ui group is hidden until manage_tools activates it.", {
     required: ["paths_hint"],
     properties: {
         ...targetSchema,
@@ -49,6 +51,17 @@ export const uiCanvasAdd = makeTool("unity_open_mcp_ui_canvas_add", "Add a Canva
             type: "string",
             description: "Name for the new scene root when no host is addressed (defaults to 'Canvas').",
         },
+        scene_path: {
+            type: "string",
+            description: "Optional target scene asset path (e.g. 'Assets/Scenes/Bootstrap.unity') for the new Canvas " +
+                "root + EventSystem when no host is addressed. The scene must already be loaded " +
+                "(use unity_open_mcp_scene_open Additive first). Omit to create in the active scene.",
+        },
+        scene_name: {
+            type: "string",
+            description: "Optional target scene name for the new Canvas root + EventSystem (alternative to scene_path). " +
+                "The scene must already be loaded. Omit to create in the active scene.",
+        },
     },
 });
 //# sourceMappingURL=ui-canvas-add.js.map

package/dist/tools/ui-canvas-add.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-canvas-add.js","sourceRoot":"","sources":["../../src/tools/ui-canvas-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC3B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oGAAoG;KAClH;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+DAA+D;KAC7E;IACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,yDAAyD,EAAE;IAC1G,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,8BAA8B,EAC9B,mFAAmF;IACjF,uFAAuF;IACvF,yFAAyF;IACzF,sFAAsF;IACtF,wFAAwF;IACxF,kFAAkF;IAClF,mFAAmF;IACnF,yCAAyC,EAC3C;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,GAAG,YAAY;QACf,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,oBAAoB;YAC7B,IAAI,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,CAAC;YAC/D,WAAW,EAAE,qBAAqB;SACnC;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,+CAA+C;SAC7D;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+EAA+E;SAC7F;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"ui-canvas-add.js","sourceRoot":"","sources":["../../src/tools/ui-canvas-add.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC3B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oGAAoG;KAClH;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qCAAqC;KACnD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+DAA+D;KAC7E;IACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,yDAAyD,EAAE;IAC1G,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,8BAA8B,EAC9B,mFAAmF;IACjF,uFAAuF;IACvF,6FAA6F;IAC7F,mGAAmG;IACnG,kGAAkG;IAClG,2FAA2F;IAC3F,kGAAkG;IAClG,mGAAmG;IACnG,+FAA+F;IAC/F,sEAAsE,EACxE;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,GAAG,YAAY;QACf,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,oBAAoB;YAC7B,IAAI,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,CAAC;YAC/D,WAAW,EAAE,qBAAqB;SACnC;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,+CAA+C;SAC7D;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+EAA+E;SAC7F;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6FAA6F;gBAC7F,iFAAiF;gBACjF,qFAAqF;SACxF;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,gGAAgG;gBAChG,uEAAuE;SAC1E;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

@@ -13,6 +13,38 @@ export declare function editorLogPath(platform?: UnityLogPlatform): string;
  * (`<project>/Logs/Editor.log`). Returns null when no project path is given.
  */
 export declare function projectEditorLogPath(projectPath: string | null | undefined): string | null;
+/**
+ * The rotated previous log. Unity renames the live Editor.log to
+ * Editor-prev.log on every fresh launch (a new Editor start, AND a failed
+ * batch spawn against an already-open project). When a live editor holds the
+ * project and a batch invocation rotates the log, the live editor keeps its
+ * open handle and writes to Editor-prev.log from then on, while Editor.log is
+ * frozen at a tiny startup size — reading it returns "no errors" forever
+ * (feedback-fable-31-07 §5).
+ *
+ * Returns the GLOBAL prev-log path. On Unity 6000.5+ the rotated prev log
+ * lives next to the project-relative live log (`<project>/Logs/Editor-prev.log`),
+ * not in the global dir — use {@link projectEditorPrevLogPath} when the
+ * project-relative live log is the resolved candidate.
+ */
+export declare function editorPrevLogPath(platform?: UnityLogPlatform): string;
+/**
+ * Resolve the project-relative Editor-prev.log path Unity 6000.5+ rotates the
+ * live log into (`<project>/Logs/Editor-prev.log`). Returns null when no
+ * project path is given. Mirrors {@link projectEditorLogPath}: on 6000.5+ the
+ * prev log follows the live log into the project's Logs dir, so the prev-log
+ * fallback must read THAT file, not the stale global Editor-prev.log left over
+ * from a pre-6000.5 session.
+ */
+export declare function projectEditorPrevLogPath(projectPath: string | null | undefined): string | null;
+/** Outcome of resolveEditorLogPath: the chosen path plus a short machine/
+ *  agent-facing reason so callers can surface WHY a non-obvious file was read
+ *  (e.g. "Editor.log frozen at 2.5KB while a live editor holds the project;
+ *  fell back to Editor-prev.log"). */
+export interface ResolvedEditorLog {
+    path: string;
+    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.
  *
@@ -29,8 +61,16 @@ export declare function projectEditorLogPath(projectPath: string | null | undefi
  *
  * When the project path is unknown (no `--project`), or the project-relative
  * log doesn't exist, the global log is used as before.
+ *
+ * feedback-fable-31-07 §5 — Editor-prev.log fallback. When a live editor
+ * holds the project (a known `livePid` is alive) and the resolved Editor.log
+ * looks frozen (implausibly small, e.g. < 4KB — the tell-tale sign of a
+ * rotated log the live editor is no longer writing to), fall back to
+ * Editor-prev.log, which is where the live editor keeps writing after the
+ * 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): string;
+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). */
@@ -88,3 +128,73 @@ export interface StaleLogResult {
  * helper strips a trailing `(...)` locator and accepts both forms.
  */
 export declare function detectStaleLog(logPath: string, citedFiles: ReadonlyArray<string>, projectRoot: string | null | undefined): StaleLogResult;
+export interface StaleAssemblyResult {
+    /** True when at least one source .cs is newer than the newest built DLL. */
+    staleAssembly: boolean;
+    /** Newest Library/ScriptAssemblies/*.dll mtime in epoch ms, when readable. */
+    dllMtimeMs?: number;
+    /** Project-relative source files newer than the newest DLL (bounded). */
+    newerSources: string[];
+    /** One-line agent-facing recovery hint. Empty when not stale. */
+    hint: string;
+}
+/**
+ * Decide whether the built assembly set under `<project>/Library/ScriptAssemblies`
+ * is stale relative to the on-disk C# sources under `<project>/Assets`.
+ *
+ * Conservative: flags staleness only when ALL of:
+ *   - the ScriptAssemblies dir exists and holds at least one .dll,
+ *   - at least one C# source under Assets is strictly newer than the newest
+ *     .dll mtime.
+ * Never throws; returns a clean "not stale" on any resolution failure.
+ */
+export declare function detectStaleAssembly(projectRoot: string | null | undefined): StaleAssemblyResult;
+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;