unity-open-mcp 0.9.0 → 1.1.0

package/dist/tools/inputsim-pointer3d.js

@@ -0,0 +1,55 @@
+// Input simulation — 3D / legacy world-space pointer (M3).
+//
+// Reaches physics-collider gameplay and old-Input-Manager code that
+// inputsim_pointer (uGUI ExecuteEvents) cannot. Mechanics: Physics.Raycast from
+// the screen → SendMessage("OnMouseDown"/"OnMouseUp"/"OnMouseUpAsButton"/
+// "OnMouseDrag"). No package dependency beyond built-in UnityEngine.Physics.
+// Gate-free, play-mode-only. Compile-gated on com.unity.ugui (shares the uGUI
+// sub-asmdef for target/screen resolution helpers, though it uses neither
+// EventSystem nor uGUI types at the dispatch path).
+import { makeTool } from "./schema-fragments.js";
+export const inputsimPointer3d = makeTool("unity_open_mcp_inputsim_pointer3d", "Simulate a world-space / legacy mouse interaction during play mode by " +
+    "raycasting from the screen point through Camera.main and SendMessage-ing the " +
+    "OnMouseDown / OnMouseUp / OnMouseUpAsButton / OnMouseDrag magic methods on " +
+    "the hit collider. Reaches physics gameplay and old-Input-Manager code that " +
+    "inputsim_pointer (uGUI ExecuteEvents) cannot — the only way to drive " +
+    "world-space gameplay in a project running the legacy Input Manager. " +
+    "Resolution: object_id > target > screen_x/screen_y (same as inputsim_pointer). " +
+    "Play-mode only — refuses with `play_mode_required` otherwise. Gate-free. " +
+    "Requires a tagged MainCamera in the scene.", {
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: ["click", "down", "up", "drag"],
+            description: "click = OnMouseDown + OnMouseUpAsButton + OnMouseUp; down = OnMouseDown; " +
+                "up = OnMouseUp; drag = OnMouseDown + OnMouseDrag×drag_steps + OnMouseUp " +
+                "(requires to_x/to_y).",
+        },
+        object_id: {
+            type: "string",
+            description: "InstanceId of a GameObject used to refine the screen point (its center " +
+                "is raycast), as a quoted string. The actual target is whatever the ray " +
+                "hits at that point. Wins over target and screen_x/screen_y. Pass as a " +
+                "string to stay precise on Unity 6000.5+ where an EntityId can exceed " +
+                "2^53 (the bridge accepts a quoted string or a bare number).",
+        },
+        target: {
+            type: "string",
+            description: "GameObject name/path used to refine the screen point. Alternative to object_id/screen.",
+        },
+        screen_x: { type: "number", description: "Screen X (pixels) to raycast from. Pair with screen_y." },
+        screen_y: { type: "number", description: "Screen Y (pixels) to raycast from. Pair with screen_x." },
+        to_x: { type: "number", description: "Drag end — screen X (action: drag only). Pair with to_y." },
+        to_y: { type: "number", description: "Drag end — screen Y (action: drag only). Pair with to_x." },
+        drag_steps: {
+            type: "integer",
+            default: 8,
+            minimum: 1,
+            maximum: 100,
+            description: "Number of OnMouseDrag calls between from and to (action: drag). Capped at " +
+                "100 to bound main-thread cost. Default 8.",
+        },
+    },
+});
+//# sourceMappingURL=inputsim-pointer3d.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-pointer3d.js","sourceRoot":"","sources":["../../src/tools/inputsim-pointer3d.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,oEAAoE;AACpE,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,oDAAoD;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,mCAAmC,EACnC,wEAAwE;IACtE,+EAA+E;IAC/E,6EAA6E;IAC7E,6EAA6E;IAC7E,uEAAuE;IACvE,sEAAsE;IACtE,iFAAiF;IACjF,2EAA2E;IAC3E,4CAA4C,EAC9C;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;YACrC,WAAW,EACT,2EAA2E;gBAC3E,0EAA0E;gBAC1E,uBAAuB;SAC1B;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yEAAyE;gBACzE,yEAAyE;gBACzE,wEAAwE;gBACxE,uEAAuE;gBACvE,6DAA6D;SAChE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wFAAwF;SACtG;QACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QACnG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QACnG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;QACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;QACjG,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,WAAW,EACT,4EAA4E;gBAC5E,2CAA2C;SAC9C;KACF;CACF,CACF,CAAC"}

package/dist/tools/inputsim-probe.d.ts

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

@@ -0,0 +1,43 @@
+// Input simulation — interactable discovery (M2).
+//
+// Turns the surface self-sufficient: the testing loop becomes
+//   probe → click by path → step → screenshot
+// instead of screenshot → guess a name → target_not_found → guess again.
+// Lists active uGUI interactables (IPointer*Handler / IDragHandler / IDropHandler /
+// ISubmitHandler / Selectable) with hierarchy path, screen rect, interactable
+// flag, instanceId, and whether anything occludes their center.
+//
+// Read-only. Works in edit mode AND play mode (use it to build a click plan
+// before entering play mode). Compile-gated on com.unity.ugui.
+import { makeTool } from "./schema-fragments.js";
+export const inputsimProbe = makeTool("unity_open_mcp_inputsim_probe", "List active uGUI interactables (objects with IPointer*Handler / IDragHandler / " +
+    "IDropHandler / ISubmitHandler / Selectable) so an agent can build a click plan " +
+    "without guessing names. Each entry carries: hierarchy path, name, instanceId " +
+    "(pass it to inputsim_pointer.object_id for unambiguous targeting), screen " +
+    "rect, interactable (false when the Selectable or an ancestor CanvasGroup " +
+    "disables it), and occluded (true when something else raycast-hits in front of " +
+    "the element's center — play mode only). Read-only; works in edit mode and play " +
+    "mode. The intended loop: probe → inputsim_pointer (object_id) → inputsim_step " +
+    "→ screenshot. Requires com.unity.ugui.", {
+    required: [],
+    properties: {
+        page_size: {
+            type: "integer",
+            default: 50,
+            minimum: 1,
+            maximum: 200,
+            description: "Max entries per page. Default 50, hard cap 200.",
+        },
+        cursor: {
+            type: "string",
+            description: "Opaque pagination cursor from a previous response's pagination.next_cursor. " +
+                "Omit on the first call.",
+        },
+        scene: {
+            type: "string",
+            description: "Optional loaded-scene name filter — only enumerate interactables in this " +
+                "scene. Omit to enumerate across all loaded scenes.",
+        },
+    },
+});
+//# sourceMappingURL=inputsim-probe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-probe.js","sourceRoot":"","sources":["../../src/tools/inputsim-probe.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,8DAA8D;AAC9D,8CAA8C;AAC9C,yEAAyE;AACzE,oFAAoF;AACpF,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,+DAA+D;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,+BAA+B,EAC/B,iFAAiF;IAC/E,iFAAiF;IACjF,+EAA+E;IAC/E,4EAA4E;IAC5E,2EAA2E;IAC3E,gFAAgF;IAChF,iFAAiF;IACjF,gFAAgF;IAChF,wCAAwC,EAC1C;IACE,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,iDAAiD;SAC/D;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,8EAA8E;gBAC9E,yBAAyB;SAC5B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2EAA2E;gBAC3E,oDAAoD;SACvD;KACF;CACF,CACF,CAAC"}

package/dist/tools/inputsim-step.d.ts

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

@@ -0,0 +1,50 @@
+// Input simulation — frame advance. The missing middle of the play-mode
+// testing loop: inject input (inputsim_pointer / _key / _touch), then advance N
+// frames so gameplay MonoBehaviour.Update / coroutines / tweens run, THEN
+// screenshot. Without this, a click that opens a panel with a 0.3s tween
+// screenshots as the old panel.
+//
+// Also the fix for K1/K2/`hold`: a synchronous tool cannot otherwise let a key
+// press or swipe be observed by polling game code. `step` lets the documented
+// `down → advance → up` workflow actually work.
+//
+// Implementation: EditorApplication.Step() is synchronous — it runs one full
+// player-loop frame inline (Update/FixedUpdate/coroutines/render) before
+// returning, so a tight loop pumps N frames within one tool dispatch. Unlike
+// QueuePlayerLoopUpdate + Thread.Sleep (documented broken elsewhere in the
+// bridge — the sleeping thread is the one that would service the update), Step
+// does not deadlock. Play-mode only (no-op in edit mode → play_mode_required).
+import { makeTool } from "./schema-fragments.js";
+export const inputsimStep = makeTool("unity_open_mcp_inputsim_step", "Advance the Unity play-mode player loop by N frames, then return. Pump the " +
+    "frames synchronously via EditorApplication.Step (each Step runs one full " +
+    "Update/FixedUpdate/coroutines/render cycle inline). Use between an input " +
+    "injection (inputsim_pointer / _key / _touch) and a screenshot so gameplay " +
+    "code, tweens, and animations actually run before you look — and so polling " +
+    "game code (`wasPressedThisFrame`, per-frame touch delta) can observe a " +
+    "press/swipe injected with inputsim_key/_touch (which otherwise process in a " +
+    "single InputSystem.Update and are invisible to polling). Play-mode only — " +
+    "refuses with `play_mode_required` otherwise (Step is a no-op in edit mode). " +
+    "Gate-free (writes no assets). Cap 60 frames per call to bound dispatch cost; " +
+    "for longer advances, call repeatedly.", {
+    required: [],
+    properties: {
+        frames: {
+            type: "integer",
+            default: 1,
+            minimum: 0,
+            maximum: 60,
+            description: "Number of player-loop frames to advance. Default 1. Hard cap 60 to " +
+                "bound dispatch cost (each frame is a full Update cycle). 0 is allowed " +
+                "and useful as a pure settle tick (one QueuePlayerLoopUpdate).",
+        },
+        settle_ms: {
+            type: "integer",
+            default: 0,
+            minimum: 0,
+            description: "Optional extra wall-clock settle in milliseconds AFTER stepping, as a " +
+                "single QueuePlayerLoopUpdate (lets one more render tick land before a " +
+                "screenshot). Default 0 (no extra tick).",
+        },
+    },
+});
+//# sourceMappingURL=inputsim-step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-step.js","sourceRoot":"","sources":["../../src/tools/inputsim-step.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,gFAAgF;AAChF,0EAA0E;AAC1E,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,8BAA8B,EAC9B,6EAA6E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,yEAAyE;IACzE,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,+EAA+E;IAC/E,uCAAuC,EACzC;IACE,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,WAAW,EACT,qEAAqE;gBACrE,wEAAwE;gBACxE,+DAA+D;SAClE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EACT,wEAAwE;gBACxE,wEAAwE;gBACxE,yCAAyC;SAC5C;KACF;CACF,CACF,CAAC"}

package/dist/tools/inputsim-touch.d.ts

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

@@ -1,4 +1,4 @@
-import { BRIDGE_DEFAULT_TIMEOUT_MS } from "../constants.js";
+import { BRIDGE_DEFAULT_TIMEOUT_MS, BRIDGE_MIN_TIMEOUT_MS, BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS } from "../constants.js";
 import { GATE_PROP, PATHS_HINT_TYPE, IGNORE_SCENE_DIRTY_BASE, makeTool } from "./schema-fragments.js";
 // M16 Plan 6 — invoke_method enhanced in place with better overload + generic-
 // arg resolution. Two new inputs:
@@ -69,6 +69,20 @@ export const invokeMethod = makeTool("unity_open_mcp_invoke_method", "Call a met
         timeout_ms: {
             type: "integer",
             default: BRIDGE_DEFAULT_TIMEOUT_MS,
+            minimum: BRIDGE_MIN_TIMEOUT_MS,
+            // specs/feedback.md 2026-08-24 — the live POST path clamps every
+            // forwarded timeout_ms to BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS, so the
+            // ceiling has to be DECLARED: a schema with no `maximum` invites a
+            // 120000 first call, which a validating client rejects outright
+            // (too_big) and a non-validating one gets clamped anyway. Same cap
+            // and same reasoning as execute_csharp / execute_menu.
+            maximum: BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS,
+            description: `How long to wait for the invocation to return. Hard cap ${BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS} ms ` +
+                "(the transport cap shared with execute_csharp / execute_menu): values above a typical " +
+                "MCP host request timeout (~60s) are unreachable because the host aborts the tools/call " +
+                "first, so the route clamps server-side and reports the clamp. A method that needs longer " +
+                "belongs in unity_senses_run_tests (async job-poll shape) or split into smaller calls. " +
+                "Default 30000.",
         },
         max_depth: {
             type: "integer",

package/dist/tools/invoke-method.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoke-method.js","sourceRoot":"","sources":["../../src/tools/invoke-method.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtG,+EAA+E;AAC/E,kCAAkC;AAClC,wEAAwE;AACxE,+EAA+E;AAC/E,0DAA0D;AAC1D,8EAA8E;AAC9E,+DAA+D;AAC/D,0EAA0E;AAC1E,2EAA2E;AAC3E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,8BAA8B,EAC9B,qFAAqF;IACnF,oFAAoF;IACpF,uFAAuF;IACvF,uFAAuF;IACvF,sFAAsF,EACxF;IACE,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IAClC,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2BAA2B;SACzC;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;SACf;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,6BAA6B;YAC1C,KAAK,EAAE,EAAE;SACV;QACD,cAAc,EAAE;YACd,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,+DAA+D;gBAC/D,+EAA+E;gBAC/E,mFAAmF;gBACnF,8EAA8E;gBAC9E,YAAY;SACf;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,oFAAoF;gBACpF,iFAAiF;gBACjF,uFAAuF;SAC1F;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACf;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oDAAoD;SACvD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,gEAAgE;gBAChE,+DAA+D;gBAC/D,iEAAiE;gBACjE,gEAAgE;gBAChE,iEAAiE;gBACjE,uCAAuC;SAC1C;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE;QAClC,kBAAkB,EAAE,EAAE,GAAG,uBAAuB,EAAE,WAAW,EAAE,kEAAkE,GAAG,kEAAkE,GAAG,iEAAiE,GAAG,qEAAqE,EAAE;QACpV,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;QACtB,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,yBAAyB;SACnC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EACT,6EAA6E;SAChF;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,WAAW,EACT,+HAA+H;SAClI;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"invoke-method.js","sourceRoot":"","sources":["../../src/tools/invoke-method.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AACpH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtG,+EAA+E;AAC/E,kCAAkC;AAClC,wEAAwE;AACxE,+EAA+E;AAC/E,0DAA0D;AAC1D,8EAA8E;AAC9E,+DAA+D;AAC/D,0EAA0E;AAC1E,2EAA2E;AAC3E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,8BAA8B,EAC9B,qFAAqF;IACnF,oFAAoF;IACpF,uFAAuF;IACvF,uFAAuF;IACvF,sFAAsF,EACxF;IACE,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IAClC,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2BAA2B;SACzC;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;SACf;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,6BAA6B;YAC1C,KAAK,EAAE,EAAE;SACV;QACD,cAAc,EAAE;YACd,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,+DAA+D;gBAC/D,+EAA+E;gBAC/E,mFAAmF;gBACnF,8EAA8E;gBAC9E,YAAY;SACf;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,oFAAoF;gBACpF,iFAAiF;gBACjF,uFAAuF;SAC1F;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACf;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oDAAoD;SACvD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EACT,gEAAgE;gBAChE,+DAA+D;gBAC/D,iEAAiE;gBACjE,gEAAgE;gBAChE,iEAAiE;gBACjE,uCAAuC;SAC1C;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE;QAClC,kBAAkB,EAAE,EAAE,GAAG,uBAAuB,EAAE,WAAW,EAAE,kEAAkE,GAAG,kEAAkE,GAAG,iEAAiE,GAAG,qEAAqE,EAAE;QACpV,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;QACtB,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE,qBAAqB;YAC9B,iEAAiE;YACjE,kEAAkE;YAClE,mEAAmE;YACnE,gEAAgE;YAChE,mEAAmE;YACnE,uDAAuD;YACvD,OAAO,EAAE,+BAA+B;YACxC,WAAW,EACT,2DAA2D,+BAA+B,MAAM;gBAChG,wFAAwF;gBACxF,yFAAyF;gBACzF,2FAA2F;gBAC3F,wFAAwF;gBACxF,gBAAgB;SACnB;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EACT,6EAA6E;SAChF;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,WAAW,EACT,+HAA+H;SAClI;KACF;CACN,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,11 @@
 import { makeTool } from "./schema-fragments.js";
+import { toolHintReference } from "../tool-hint.js";
+// specs/feedback.md 2026-08-14 — the description and the runtime hints must
+// prescribe the SAME recovery path and must both carry the activation call for
+// a tool outside the default surface. Both come from toolHintReference so the
+// two can no longer drift.
+const RECOMPILE_SCRIPTS_HINT = toolHintReference("unity_open_mcp_recompile_scripts");
+const COMPILE_CHECK_HINT = toolHintReference("unity_open_mcp_compile_check");
 // Offline, filesystem-only tool: reads the tail of Unity's Editor.log and
 // extracts BOTH C# compiler errors AND package / assembly-level red flags AND
 // a hard Editor hang signal. The one recovery channel that works when the
@@ -21,6 +28,9 @@ import { makeTool } from "./schema-fragments.js";
 //
 // Response fields:
 //   - status: "compile_failed" | "project_unhealthy" | "no_errors_found"
+//             | "stale_log" (errors may not apply — stale log / version
+//             mismatch) | "indeterminate" (no errors, but read from the
+//             ROTATED prev_log_* — not a verified clean bill of health)
 //   - unhealthy: true when compiler errors OR issues are present
 //   - headline: one-line triage summary (empty when healthy)
 //   - errors[]: structured CSxxxx diagnostics (file/line/code/message)
@@ -61,15 +71,34 @@ export const readCompileErrors = makeTool("unity_open_mcp_read_compile_errors",
     "response carries `staleLogSuspected: true`, the cited source files " +
     "were edited more recently than Editor.log — the error block may " +
     "reference on-disk code you have already fixed (Unity's incremental " +
-    "compiler no-op'd the recompile). Force a genuine recompile via " +
-    "unity_open_mcp_reimport_package (local package) or " +
-    "unity_open_mcp_compile_check before trusting the errors. When the " +
-    "response carries `staleAssembly: true`, at least one Assets/**/*.cs " +
+    "compiler no-op'd the recompile). When the response carries " +
+    "`errorsMayPredateEdits: true`, at least one file the errors CITE is newer " +
+    "than the newest built assembly, so no compile has completed since you " +
+    "edited it and the error block is from an earlier compile — do not re-read " +
+    "or re-fix that code on the strength of it. When the response carries " +
+    "`staleAssembly: true`, at least one Assets/**/*.cs " +
     "source is newer than the newest Library/ScriptAssemblies/*.dll — the " +
     "running assembly predates the latest source, so a no_errors_found signal " +
-    "CANNOT be trusted until the assembly is rebuilt. Call " +
-    "unity_open_mcp_recompile_scripts (deterministic force-recompile) then " +
-    "re-read compile errors.", {
+    "CANNOT be trusted until the assembly is rebuilt. When that flag is set " +
+    "WITH errors, the `headline` itself says the error block may predate the " +
+    "current sources (not just the separate staleAssemblyHint field). When " +
+    "`logSource` is a `prev_log_*` value (the read came from the ROTATED " +
+    "Editor-prev.log while a live Editor may be writing a different log) and " +
+    "no errors were found, `status` is `indeterminate`, NOT " +
+    "`no_errors_found` — a clean read from the rotated log is not a verified " +
+    "clean bill of health; confirm via the live bridge or re-read after the " +
+    "Editor settles. All staleness signals call for the " +
+    "same next step (one recommended path per situation, matching the runtime " +
+    `hints): call ${RECOMPILE_SCRIPTS_HINT} for a deterministic ` +
+    "force-recompile, then re-read compile errors; with the Editor closed or " +
+    `unreachable, ${COMPILE_CHECK_HINT} spawns a fresh headless recompile ` +
+    "instead. IMPORTANT — staged compilation: Unity compiles " +
+    "assemblies in dependency order, so when `errorCount` is small but the project " +
+    "has multiple assemblies (the response carries `partialCompileLikely: true` " +
+    "with `asmdefCount`/`assembliesWithErrors`), the reported errors may be a " +
+    "SUBSET — the failing assembly aborted the pipeline before dependent ones were " +
+    "reached. Do NOT treat `errorCount` as the complete picture; fix the reported " +
+    "errors and re-check until `errorCount` is 0.", {
     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,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,2BAA2B;AAC3B,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,kCAAkC,CAAC,CAAC;AACrF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;AAE7E,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,yEAAyE;AACzE,+EAA+E;AAC/E,8EAA8E;AAC9E,UAAU;AACV,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,mBAAmB;AACnB,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AACxE,iEAAiE;AACjE,6DAA6D;AAC7D,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,6EAA6E;AAC7E,iEAAiE;AACjE,sEAAsE;AACtE,8EAA8E;AAC9E,iBAAiB;AACjB,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,oCAAoC,EACpC,uEAAuE;IACrE,uEAAuE;IACvE,0DAA0D;IAC1D,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,2DAA2D;IAC3D,6DAA6D;IAC7D,4DAA4D;IAC5D,mEAAmE;IACnE,yEAAyE;IACzE,kEAAkE;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,6DAA6D;IAC7D,4EAA4E;IAC5E,wEAAwE;IACxE,4EAA4E;IAC5E,uEAAuE;IACvE,qDAAqD;IACrD,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,sEAAsE;IACtE,0EAA0E;IAC1E,yDAAyD;IACzD,0EAA0E;IAC1E,yEAAyE;IACzE,qDAAqD;IACrD,2EAA2E;IAC3E,gBAAgB,sBAAsB,uBAAuB;IAC7D,0EAA0E;IAC1E,gBAAgB,kBAAkB,qCAAqC;IACvE,0DAA0D;IAC1D,gFAAgF;IAChF,6EAA6E;IAC7E,2EAA2E;IAC3E,gFAAgF;IAChF,+EAA+E;IAC/E,8CAA8C,EAChD;IACE,UAAU,EAAE;QACN,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EACT,6DAA6D;gBAC7D,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;SACtE;KACF;CACN,CACF,CAAC"}

package/dist/tools/regression-check.js

@@ -1,6 +1,7 @@
 import { makeTool } from "./schema-fragments.js";
 export const regressionCheck = makeTool("unity_open_mcp_regression_check", "Compare current full scan against a baseline file. Returns exitCode 1 when the error count increase exceeds " +
-    "regression_threshold (global) or any per-category threshold, or when the baseline is missing/invalid. " +
+    "regression_threshold (global) or any per-category threshold, when the baseline is missing/invalid, or when any " +
+    "verify rule threw (rulesFailed — the scan is incomplete and the verdict covers only rules that ran clean on both sides). " +
     "per_category_thresholds maps a ruleId to its max tolerated error-count increase; rules absent from the map " +
     "fall back to regression_threshold. Emits a compact regression summary (with optional per-rule breakdown) " +
     "suitable for CI logs.", {

package/dist/tools/regression-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"regression-check.js","sourceRoot":"","sources":["../../src/tools/regression-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CACrC,iCAAiC,EACjC,8GAA8G;IAC5G,wGAAwG;IACxG,6GAA6G;IAC7G,2GAA2G;IAC3G,uBAAuB,EACzB;IACE,QAAQ,EAAE,CAAC,eAAe,CAAC;IACvB,UAAU,EAAE;QACV,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yEAAyE;SACvF;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,gFAAgF;SAC9F;QACD,uBAAuB,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACrD,WAAW,EACT,gHAAgH;gBAChH,qGAAqG;SACxG;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACtC,OAAO,EAAE,SAAS;SACnB;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"regression-check.js","sourceRoot":"","sources":["../../src/tools/regression-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CACrC,iCAAiC,EACjC,8GAA8G;IAC5G,iHAAiH;IACjH,2HAA2H;IAC3H,6GAA6G;IAC7G,2GAA2G;IAC3G,uBAAuB,EACzB;IACE,QAAQ,EAAE,CAAC,eAAe,CAAC;IACvB,UAAU,EAAE;QACV,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yEAAyE;SACvF;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,gFAAgF;SAC9F;QACD,uBAAuB,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACrD,WAAW,EACT,gHAAgH;gBAChH,qGAAqG;SACxG;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACtC,OAAO,EAAE,SAAS;SACnB;KACF;CACN,CACF,CAAC"}