unity-open-mcp 0.9.0 → 1.0.0

package/dist/tools/inputsim-touch.js

@@ -0,0 +1,83 @@
+// Input simulation — Input System touch / swipe device events.
+//
+// Compile-gated on com.unity.inputsystem (UNITY_OPEN_MCP_EXT_INPUTSIM_IS).
+// Queues Touchscreen state events through the new Input System.
+//
+// K2 fix: `swipe` accepts `advance_frames` to advance a frame AFTER each Moved
+// phase, so the swipe genuinely unfolds across frames for polling code (per-frame
+// primaryTouch.delta, distance/velocity gesture recognizers). Without
+// `advance_frames`, all Moved phases collapse into a single InputSystem.Update —
+// documented honestly now (previously mis-advertised as "across real frames").
+//
+// Play-mode only. Gate-free. Requires com.unity.inputsystem.
+import { makeTool } from "./schema-fragments.js";
+export const inputsimTouch = makeTool("unity_open_mcp_inputsim_touch", "Queue a touch / swipe event sequence through the Input System " +
+    "(Touchscreen.current) during play mode. `tap` = press+release at a point; " +
+    "`swipe` = press at from_, move across `steps` interpolated points, release " +
+    "at to_; `press`/`release` = single-phase control. POLLING vs CALLBACK: " +
+    "without `advance_frames`, all touch phases process in a single " +
+    "InputSystem.Update — so polling code (per-frame primaryTouch.delta, gesture " +
+    "recognizers) sees a collapsed jump, not a real swipe. Pass `advance_frames` " +
+    "≥ 1 to advance a frame after each Moved phase so the swipe unfolds across " +
+    "real frames for polling code. Callback-driven InputAction.performed fires " +
+    "either way. Endpoints resolve target-first (object_id/name/path → screen " +
+    "point) or accept screen_x/screen_y directly. NOTE: target resolution here " +
+    "uses a plain GameObject.Find name/path match (no ambiguity detection or " +
+    "partial-path matching — that lives in the uGUI-gated inputsim_pointer, and " +
+    "this tool compiles against the Input System package only); prefer an " +
+    "object_id or a full unique path for the target. Play-mode only — refuses " +
+    "with `play_mode_required` otherwise. Gate-free. Requires com.unity.inputsystem.", {
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: ["tap", "swipe", "press", "release"],
+            description: "tap = press+release at one point; swipe = press at from_, move across " +
+                "`steps` interpolated points, release at to_; press = touch down only; " +
+                "release = touch up only.",
+        },
+        finger: {
+            type: "integer",
+            default: 0,
+            minimum: 0,
+            maximum: 9,
+            description: "Touch finger index (0–9) for multi-touch. Default 0.",
+        },
+        target: {
+            type: "string",
+            description: "GameObject to tap/press/release — name or hierarchy path. Resolved to a " +
+                "screen point via the active camera. Omit when using screen_x/screen_y.",
+        },
+        screen_x: { type: "number", description: "Screen X (pixels) for tap/press/release. Pair with screen_y." },
+        screen_y: { type: "number", description: "Screen Y (pixels) for tap/press/release. Pair with screen_x." },
+        from_target: {
+            type: "string",
+            description: "Swipe start — target name/path (alternative to from_x/from_y).",
+        },
+        from_x: { type: "number", description: "Swipe start — screen X (alternative to from_target)." },
+        from_y: { type: "number", description: "Swipe start — screen Y (alternative to from_target)." },
+        to_target: { type: "string", description: "Swipe end — target name/path (alternative to to_x/to_y)." },
+        to_x: { type: "number", description: "Swipe end — screen X (alternative to to_target)." },
+        to_y: { type: "number", description: "Swipe end — screen Y (alternative to to_target)." },
+        duration_ms: { type: "integer", default: 200, description: "Swipe total duration in milliseconds (recorded). Default 200." },
+        steps: {
+            type: "integer",
+            default: 10,
+            minimum: 1,
+            maximum: 100,
+            description: "Number of interpolated move events in a swipe. Capped at 100 to bound " +
+                "main-thread cost (each step can run advance_frames × Step). Default 10.",
+        },
+        advance_frames: {
+            type: "integer",
+            default: 0,
+            minimum: 0,
+            maximum: 60,
+            description: "Pump this many player-loop frames (EditorApplication.Step) AFTER each " +
+                "Moved phase so the swipe unfolds across real frames for polling code " +
+                "(per-frame delta, gesture recognizers). 0 (default) collapses all phases " +
+                "into one update — only callback-driven input sees it then. Cap 60.",
+        },
+    },
+});
+//# sourceMappingURL=inputsim-touch.js.map

package/dist/tools/inputsim-touch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-touch.js","sourceRoot":"","sources":["../../src/tools/inputsim-touch.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,gEAAgE;AAChE,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,sEAAsE;AACtE,iFAAiF;AACjF,+EAA+E;AAC/E,EAAE;AACF,6DAA6D;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,+BAA+B,EAC/B,gEAAgE;IAC9D,4EAA4E;IAC5E,6EAA6E;IAC7E,yEAAyE;IACzE,iEAAiE;IACjE,8EAA8E;IAC9E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,6EAA6E;IAC7E,uEAAuE;IACvE,2EAA2E;IAC3E,iFAAiF,EACnF;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;YAC1C,WAAW,EACT,wEAAwE;gBACxE,wEAAwE;gBACxE,0BAA0B;SAC7B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,sDAAsD;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,0EAA0E;gBAC1E,wEAAwE;SAC3E;QACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;QACzG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;QACzG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;QAC/F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;QAC/F,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;QACtG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;QACzF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;QACzF,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,+DAA+D,EAAE;QAC5H,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,WAAW,EACT,wEAAwE;gBACxE,yEAAyE;SAC5E;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,WAAW,EACT,wEAAwE;gBACxE,uEAAuE;gBACvE,2EAA2E;gBAC3E,oEAAoE;SACvE;KACF;CACF,CACF,CAAC"}

package/dist/tools/memory-snapshot-capture.js

@@ -1,3 +1,4 @@
+import { BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS } from "../constants.js";
 import { makeTool } from "./schema-fragments.js";
 // M20 Plan 7 / T20.7.3 — Memory Profiler snapshot capture. Compile-gated in
 // the bridge (UNITY_OPEN_MCP_EXT_MEMORYPROFILER on com.unity.memoryprofiler) +
@@ -44,12 +45,17 @@ export const memorySnapshotCapture = makeTool("unity_senses_memory_snapshot_capt
         timeout_ms: {
             type: "integer",
             description: "Maximum milliseconds to wait for the callback-based capture to " +
-                "finish (default 60000, clamped to 300000). The capture blocks until " +
-                "the snapshot file is written; if it times out the tool returns " +
-                "memoryprofiler_capture_timeout.",
-            default: 60000,
+                "finish (default + maximum = the transport cap, ~55000 ms). The " +
+                "capture blocks until the snapshot file is written; if it times out " +
+                "the tool returns memoryprofiler_capture_timeout. The ceiling is the " +
+                "bridge transport cap (BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS): a single " +
+                "blocking tool call cannot run longer than a typical MCP host " +
+                "request timeout, so a snapshot that needs more than ~55s cannot " +
+                "complete in one call — run it manually from the Memory Profiler " +
+                "window (Window > Analysis > Memory Profiler) for very large heaps.",
+            default: BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS,
             minimum: 1000,
-            maximum: 300000,
+            maximum: BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS,
         },
     },
 });

package/dist/tools/memory-snapshot-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-snapshot-capture.js","sourceRoot":"","sources":["../../src/tools/memory-snapshot-capture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,yEAAyE;AACzE,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,6EAA6E;AAC7E,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAC3C,sCAAsC,EACtC,+DAA+D;IAC7D,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,sEAAsE;IACtE,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,iEAAiE;IACjE,wDAAwD;IACxD,6EAA6E;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,sEAAsE;IACtE,uEAAuE;IACvE,YAAY,EACd;IACE,UAAU,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uEAAuE;gBACvE,sEAAsE;gBACtE,mEAAmE;gBACnE,oEAAoE;gBACpE,oEAAoE;gBACpE,gDAAgD;SACnD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,WAAW,EACT,iEAAiE;gBACjE,sEAAsE;gBACtE,iEAAiE;gBACjE,iCAAiC;YACnC,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;SAChB;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"memory-snapshot-capture.js","sourceRoot":"","sources":["../../src/tools/memory-snapshot-capture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,yEAAyE;AACzE,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,6EAA6E;AAC7E,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAC3C,sCAAsC,EACtC,+DAA+D;IAC7D,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,sEAAsE;IACtE,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,iEAAiE;IACjE,wDAAwD;IACxD,6EAA6E;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,sEAAsE;IACtE,uEAAuE;IACvE,YAAY,EACd;IACE,UAAU,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uEAAuE;gBACvE,sEAAsE;gBACtE,mEAAmE;gBACnE,oEAAoE;gBACpE,oEAAoE;gBACpE,gDAAgD;SACnD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,WAAW,EACT,iEAAiE;gBACjE,iEAAiE;gBACjE,qEAAqE;gBACrE,sEAAsE;gBACtE,mEAAmE;gBACnE,+DAA+D;gBAC/D,kEAAkE;gBAClE,kEAAkE;gBAClE,oEAAoE;YACtE,OAAO,EAAE,+BAA+B;YACxC,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,+BAA+B;SACzC;KACF;CACN,CACF,CAAC"}

package/dist/tools/pull-events.js

@@ -12,12 +12,15 @@ import { makeTool } from "./schema-fragments.js";
 // keeps the model in the loop and lets an agent decide when to drain (e.g.
 // right after a mutation that may produce logs).
 export const pullEvents = makeTool("unity_senses_pull_events", "Drain incremental bridge events (console logs + editor-state transitions) since the previous call. " +
-    "The first call opens a server-side SSE subscription; later calls return only new events. " +
-    "Use this after execute_csharp / mutations to stream console output without polling /ping or " +
-    "re-reading the full console. Each event carries `seq`, `ts`, `type` ('log' | 'editor_state'), " +
-    "and type-specific fields (logType/message/stack for logs, state/isCompiling/isPlaying for state). " +
-    "`dropped` reports events evicted from the queue before this pull; `connected` reports the SSE reader " +
-    "state. Requires a live Unity Editor connection.", {
+    "The first call opens a server-side SSE subscription and returns nothing (an empty events array with " +
+    "started:true); console history is NOT replayed. For anything that happened before the first call, " +
+    "read the Editor log via unity_open_mcp_read_compile_errors (compile errors) or call this tool BEFORE " +
+    "the operation you want to observe, then again after. Later calls return only events that arrived " +
+    "since the previous drain. Use this after execute_csharp / mutations to stream console output without " +
+    "polling /ping or re-reading the full console. Each event carries `seq`, `ts`, `type` ('log' | " +
+    "'editor_state'), and type-specific fields (logType/message/stack for logs, " +
+    "state/isCompiling/isPlaying for state). `dropped` reports events evicted from the queue before this " +
+    "pull; `connected` reports the SSE reader state. Requires a live Unity Editor connection.", {
     properties: {
         max_events: {
             type: "integer",
@@ -26,12 +29,17 @@ export const pullEvents = makeTool("unity_senses_pull_events", "Drain incrementa
             maximum: 1000,
             description: "Maximum events to return per call. Additional buffered events are counted in `dropped`.",
         },
-        // Hidden-but-documented: an explicit subscriber id lets a long-lived
-        // agent session resume across MCP server restarts. Defaults to a
-        // server-scoped id; callers normally omit it.
+        // feedback #8 — an explicit subscriber id gives the caller its OWN
+        // read cursor over the shared queue: a fresh subscriber's first call
+        // returns started:true with NO events (its cursor starts at the current
+        // high-water mark, so history is not replayed). A returning subscriber
+        // resumes from its saved cursor. Omit to drain the shared queue
+        // (legacy behaviour). Use a distinct id per agent session.
         subscriber: {
             type: "string",
-            description: "Optional subscriber id to resume a prior subscription (defaults to a server-scoped id).",
+            description: "Optional subscriber id. A NEW id starts a fresh read cursor at the current " +
+                "high-water mark (no backlog replay); a returning id resumes from its saved " +
+                "cursor. Omit to drain the shared queue.",
         },
     },
 });

package/dist/tools/pull-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"pull-events.js","sourceRoot":"","sources":["../../src/tools/pull-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,qCAAqC;AACrC,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,0BAA0B;AAC1B,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAChC,0BAA0B,EAC1B,qGAAqG;IACnG,2FAA2F;IAC3F,8FAA8F;IAC9F,gGAAgG;IAChG,oGAAoG;IACpG,uGAAuG;IACvG,iDAAiD,EACnD;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;YACb,WAAW,EACT,yFAAyF;SAC5F;QACD,qEAAqE;QACrE,iEAAiE;QACjE,8CAA8C;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yFAAyF;SAC5F;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"pull-events.js","sourceRoot":"","sources":["../../src/tools/pull-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,qCAAqC;AACrC,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,0BAA0B;AAC1B,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAChC,0BAA0B,EAC1B,qGAAqG;IACnG,sGAAsG;IACtG,oGAAoG;IACpG,uGAAuG;IACvG,mGAAmG;IACnG,uGAAuG;IACvG,gGAAgG;IAChG,6EAA6E;IAC7E,sGAAsG;IACtG,0FAA0F,EAC5F;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;YACb,WAAW,EACT,yFAAyF;SAC5F;QACD,mEAAmE;QACnE,qEAAqE;QACrE,wEAAwE;QACxE,uEAAuE;QACvE,gEAAgE;QAChE,2DAA2D;QAC3D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6EAA6E;gBAC7E,6EAA6E;gBAC7E,yCAAyC;SAC5C;KACF;CACN,CACF,CAAC"}

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

@@ -1,4 +1,5 @@
 import { makeTool } from "./schema-fragments.js";
+import { TYPED_EDITOR_ACTIVATE_INSTRUCTION } from "../constants.js";
 // Offline, filesystem-only tool: reads the tail of Unity's Editor.log and
 // extracts BOTH C# compiler errors AND package / assembly-level red flags AND
 // a hard Editor hang signal. The one recovery channel that works when the
@@ -68,8 +69,15 @@ export const readCompileErrors = makeTool("unity_open_mcp_read_compile_errors",
     "source is newer than the newest Library/ScriptAssemblies/*.dll — the " +
     "running assembly predates the latest source, so a no_errors_found signal " +
     "CANNOT be trusted until the assembly is rebuilt. Call " +
-    "unity_open_mcp_recompile_scripts (deterministic force-recompile) then " +
-    "re-read compile errors.", {
+    "unity_open_mcp_recompile_scripts (deterministic force-recompile; it is in " +
+    `the typed-editor group — ${TYPED_EDITOR_ACTIVATE_INSTRUCTION} first) ` +
+    "then re-read compile errors. IMPORTANT — staged compilation: Unity compiles " +
+    "assemblies in dependency order, so when `errorCount` is small but the project " +
+    "has multiple assemblies (the response carries `partialCompileLikely: true` " +
+    "with `asmdefCount`/`assembliesWithErrors`), the reported errors may be a " +
+    "SUBSET — the failing assembly aborted the pipeline before dependent ones were " +
+    "reached. Do NOT treat `errorCount` as the complete picture; fix the reported " +
+    "errors and re-check until `errorCount` is 0.", {
     properties: {
         tail_bytes: {
             type: "integer",

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

@@ -1 +1 @@
-{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,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,GAAG,QAAQ,CACvC,oCAAoC,EACpC,uEAAuE;IACrE,uEAAuE;IACvE,0DAA0D;IAC1D,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,2DAA2D;IAC3D,6DAA6D;IAC7D,4DAA4D;IAC5D,mEAAmE;IACnE,yEAAyE;IACzE,kEAAkE;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,iEAAiE;IACjE,qDAAqD;IACrD,oEAAoE;IACpE,sEAAsE;IACtE,uEAAuE;IACvE,2EAA2E;IAC3E,wDAAwD;IACxD,wEAAwE;IACxE,yBAAyB,EAC3B;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;SACtE;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"read-compile-errors.js","sourceRoot":"","sources":["../../src/tools/read-compile-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAEpE,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,GAAG,QAAQ,CACvC,oCAAoC,EACpC,uEAAuE;IACrE,uEAAuE;IACvE,0DAA0D;IAC1D,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,2DAA2D;IAC3D,6DAA6D;IAC7D,4DAA4D;IAC5D,mEAAmE;IACnE,yEAAyE;IACzE,kEAAkE;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,iEAAiE;IACjE,qDAAqD;IACrD,oEAAoE;IACpE,sEAAsE;IACtE,uEAAuE;IACvE,2EAA2E;IAC3E,wDAAwD;IACxD,4EAA4E;IAC5E,4BAA4B,iCAAiC,UAAU;IACvE,8EAA8E;IAC9E,gFAAgF;IAChF,6EAA6E;IAC7E,2EAA2E;IAC3E,gFAAgF;IAChF,+EAA+E;IAC/E,8CAA8C,EAChD;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;SACtE;KACF;CACN,CACF,CAAC"}

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/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,52 @@ 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 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;