unity-open-mcp 0.8.4 → 1.0.0

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/manage-tools.js

@@ -40,7 +40,14 @@ export const manageTools = makeTool("unity_open_mcp_manage_tools", "Manage which
     "package is installed (e.g. `shadergraph` when `com.unity.shadergraph` " +
     "is present) — these surface in `list_groups` with " +
     "`activationSource: \"auto\"` and require no manual call; deactivate to " +
-    "hide them.", {
+    "hide them. " +
+    "Visibility note: activation is ADDITIVE (activating one group never " +
+    "drops another). After activate/activate_for the server emits " +
+    "`notifications/tools/list_changed`, but newly-activated tools only " +
+    "appear in your tool list if your client honors that notification and " +
+    "re-issues tools/list — if the tools do not show up, manually re-request " +
+    "the tool list, or route the tool by id through batch_execute (which " +
+    "works regardless of listChanged support).", {
     required: ["action"],
     properties: {
         action: {

package/dist/tools/manage-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,uEAAuE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,+DAA+D;IAC/D,0EAA0E;IAC1E,mEAAmE;IACnE,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,YAAY,EACd;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;YACnF,WAAW,EACT,qEAAqE;gBACrE,8DAA8D;gBAC9D,4CAA4C;gBAC5C,kEAAkE;gBAClE,8BAA8B;gBAC9B,gEAAgE;gBAChE,iEAAiE;gBACjE,2BAA2B;SAC9B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;gBAC/D,iEAAiE;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,qEAAqE;gBACrE,+DAA+D;gBAC/D,sCAAsC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,qEAAqE;gBACrE,+DAA+D;gBAC/D,kEAAkE;gBAClE,4BAA4B;SAC/B;KACF;CACN,CACF,CAAC"}
+{"version":3,"file":"manage-tools.js","sourceRoot":"","sources":["../../src/tools/manage-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,uEAAuE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,2EAA2E;IAC3E,+DAA+D;IAC/D,0EAA0E;IAC1E,mEAAmE;IACnE,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,wEAAwE;IACxE,oDAAoD;IACpD,yEAAyE;IACzE,aAAa;IACb,sEAAsE;IACtE,+DAA+D;IAC/D,qEAAqE;IACrE,uEAAuE;IACvE,0EAA0E;IAC1E,sEAAsE;IACtE,2CAA2C,EAC7C;IACE,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;YACnF,WAAW,EACT,qEAAqE;gBACrE,8DAA8D;gBAC9D,4CAA4C;gBAC5C,kEAAkE;gBAClE,8BAA8B;gBAC9B,gEAAgE;gBAChE,iEAAiE;gBACjE,2BAA2B;SAC9B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;gBAC/D,iEAAiE;SACpE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;gBAC7D,gEAAgE;gBAChE,kEAAkE;gBAClE,qEAAqE;gBACrE,+DAA+D;gBAC/D,sCAAsC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gEAAgE;gBAChE,mEAAmE;gBACnE,qEAAqE;gBACrE,+DAA+D;gBAC/D,kEAAkE;gBAClE,4BAA4B;SAC/B;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/prefab-instantiate.js

@@ -21,6 +21,17 @@ export const prefabInstantiate = makeTool("unity_open_mcp_prefab_instantiate", "
             description: "Optional destination scene path \"Root/Parent\" — the parent must already exist. " +
                 "Omit to instantiate at scene root.",
         },
+        scene_path: {
+            type: "string",
+            description: "Optional target scene asset path (e.g. 'Assets/Scenes/Bootstrap.unity') for the instance root. " +
+                "The scene must already be loaded (use unity_open_mcp_scene_open Additive first). Omit to " +
+                "instantiate in the active scene. Ignored when parent_path is supplied (the parent's scene wins).",
+        },
+        scene_name: {
+            type: "string",
+            description: "Optional target scene name for the instance root (alternative to scene_path). The scene must " +
+                "already be loaded. Omit to instantiate in the active scene.",
+        },
         position: {
             type: "string",
             description: "Optional world-space position as \"x,y,z\". Defaults to 0,0,0.",

package/dist/tools/prefab-instantiate.js.map

@@ -1 +1 @@
-{"version":3,"file":"prefab-instantiate.js","sourceRoot":"","sources":["../../src/tools/prefab-instantiate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,mCAAmC,EACnC,+FAA+F;IAC7F,kGAAkG;IAClG,mGAAmG;IACnG,4FAA4F;IAC5F,iGAAiG,EACnG;IACE,QAAQ,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;IACzC,UAAU,EAAE;QACV,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;SACjD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uEAAuE;SACrF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mFAAmF;gBACnF,oCAAoC;SACvC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iFAAiF;SAC/F;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6DAA6D;SAC3E;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,iHAAiH,EAAE;QAClK,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;CACN,CACF,CAAC"}
+{"version":3,"file":"prefab-instantiate.js","sourceRoot":"","sources":["../../src/tools/prefab-instantiate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,mCAAmC,EACnC,+FAA+F;IAC7F,kGAAkG;IAClG,mGAAmG;IACnG,4FAA4F;IAC5F,iGAAiG,EACnG;IACE,QAAQ,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;IACzC,UAAU,EAAE;QACV,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;SACjD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uEAAuE;SACrF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,mFAAmF;gBACnF,oCAAoC;SACvC;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iGAAiG;gBACjG,2FAA2F;gBAC3F,kGAAkG;SACrG;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+FAA+F;gBAC/F,6DAA6D;SAChE;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iFAAiF;SAC/F;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6DAA6D;SAC3E;QACD,UAAU,EAAE,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,iHAAiH,EAAE;QAClK,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;KACvB;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
@@ -63,7 +64,20 @@ export const readCompileErrors = makeTool("unity_open_mcp_read_compile_errors",
     "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.", {
+    "unity_open_mcp_compile_check before trusting the errors. 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; 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,0DAA0D,EAC5D;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/recompile-scripts.d.ts

@@ -0,0 +1,40 @@
+export declare const recompileScripts: {
+    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/recompile-scripts.js

@@ -0,0 +1,35 @@
+import { GATE_PROP, PATHS_HINT_TYPE, makeTool } from "./schema-fragments.js";
+// feedback-01-08-glm §5 — a first-class "force a real recompile and wait for
+// it" primitive. Fills the gap left by assets_refresh / execute_csharp, which
+// frequently no-op on edited C# (Unity's incremental compiler sees no import
+// change), leaving the running assembly stale while read_compile_errors reports
+// the old healthy state.
+//
+// Mutating: calls CompilationPipeline.RequestScriptCompilation and blocks on
+// the post-request compile via its restart_then_settle lifecycle. The response
+// reports dllMtimeBefore / dllMtimeAfter (newest Library/ScriptAssemblies/*.dll
+// mtime, in UTC ticks) and a recompiled boolean so a no-op recompile is
+// detectable; on a no-op or an already-in-flight compile, agentNextSteps points
+// at the right fallback (assets_refresh / reimport_package / poll isCompiling).
+export const recompileScripts = makeTool("unity_open_mcp_recompile_scripts", "Force Unity to recompile ALL scripts and block until the compile settles. Use this when " +
+    "unity_open_mcp_assets_refresh or unity_open_mcp_execute_csharp fail to recompile after a C# edit " +
+    "(Unity's incremental compiler frequently no-ops on unchanged-import views, leaving the running " +
+    "assembly stale while read_compile_errors reports the old healthy state). Mutating: calls " +
+    "CompilationPipeline.RequestScriptCompilation and blocks on the compile via its restart_then_settle " +
+    "lifecycle (a domain reload may follow). The response reports dllMtimeBefore / dllMtimeAfter (newest " +
+    "Library/ScriptAssemblies/*.dll mtime, in UTC ticks) and a recompiled boolean so a no-op recompile is " +
+    "detectable; agentNextSteps branches on the outcome. paths_hint is the set of script assets you edited " +
+    "(the gate validates the post-recompile state of those paths). Prefer this over assets_refresh when you " +
+    "need a DETERMINISTIC recompile of edited C#.", {
+    required: ["paths_hint"],
+    properties: {
+        paths_hint: {
+            ...PATHS_HINT_TYPE,
+            description: "Mutation scope — the script asset(s) you edited (e.g. [\"Assets/Scripts/MyClass.cs\"]). " +
+                "The gate validates the post-recompile state of these paths. The recompile itself is " +
+                "project-wide; paths_hint exists to give the gate a non-empty, scoped hint.",
+        },
+        gate: { ...GATE_PROP, description: "Gate mode. Default 'enforce' — fails the call if the recompile surfaces new errors." },
+    },
+});
+//# sourceMappingURL=recompile-scripts.js.map

package/dist/tools/recompile-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recompile-scripts.js","sourceRoot":"","sources":["../../src/tools/recompile-scripts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7E,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,yBAAyB;AACzB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAChF,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CACtC,kCAAkC,EAClC,0FAA0F;IACxF,mGAAmG;IACnG,iGAAiG;IACjG,2FAA2F;IAC3F,qGAAqG;IACrG,sGAAsG;IACtG,uGAAuG;IACvG,wGAAwG;IACxG,yGAAyG;IACzG,8CAA8C,EAChD;IACE,QAAQ,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE;QACV,UAAU,EAAE;YACV,GAAG,eAAe;YAClB,WAAW,EACT,0FAA0F;gBAC1F,sFAAsF;gBACtF,4EAA4E;SAC/E;QACD,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,qFAAqF,EAAE;KAC3H;CACN,CACF,CAAC"}