unity-open-mcp 0.9.0 → 1.0.0

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

@@ -0,0 +1,40 @@
+export declare const inputsimKey: {
+    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-key.js

@@ -0,0 +1,72 @@
+// Input simulation — Input System keyboard device events.
+//
+// Compile-gated on com.unity.inputsystem (UNITY_OPEN_MCP_EXT_INPUTSIM_IS).
+// Queues Keyboard state events through the new Input System.
+//
+// K1 fix: `tap`/`hold` accept `advance_frames` to pump N player-loop frames
+// BETWEEN down and up, so polling game code (Keyboard.current[Key.Space]
+// .wasPressedThisFrame) can observe the press. Without `advance_frames`, both
+// updates run in one synchronous call and no MonoBehaviour.Update ticks while
+// the key is down — the press is invisible to polling code (callback-driven
+// InputAction.performed still fires). For polling input, pass advance_frames ≥ 1
+// (or use `down`, inputsim_step, `up`).
+//
+// K3 doc: `up` queues an EMPTY KeyboardState, releasing EVERY held key (the
+// named key, mods, and any key held by a prior `down`) — per-key release would
+// require cross-call state. This is documented, not silent.
+//
+// Play-mode only. Gate-free. Does NOT cover legacy UnityEngine.Input.
+import { makeTool } from "./schema-fragments.js";
+export const inputsimKey = makeTool("unity_open_mcp_inputsim_key", "Queue a keyboard event through the Input System (Keyboard.current) during " +
+    "play mode. Covers gameplay reading Keyboard.current / Key enum / " +
+    "InputAction.performed. `key` accepts a Unity Key enum name ('Space', 'W', " +
+    "'LeftArrow', 'Digit1') or a single character ('a', '1'). " +
+    "POLLING vs CALLBACK: without `advance_frames`, down+up process in a single " +
+    "InputSystem.Update and no MonoBehaviour.Update runs between them — so polling " +
+    "code (wasPressedThisFrame) CANNOT see a `tap`/`hold`; only callback-driven " +
+    "InputAction.performed fires. Pass `advance_frames` ≥ 1 to pump that many " +
+    "player-loop frames between down and up so polling code observes the press " +
+    "(or split into `down` → inputsim_step → `up`). `up` releases ALL held keys " +
+    "(the named key + mods + anything held by a prior `down`), since per-key " +
+    "release would require cross-call state. Play-mode only — refuses with " +
+    "`play_mode_required` otherwise. Gate-free. Requires com.unity.inputsystem. " +
+    "Does NOT cover legacy UnityEngine.Input.", {
+    required: ["action", "key"],
+    properties: {
+        action: {
+            type: "string",
+            enum: ["down", "up", "tap", "hold"],
+            description: "down = key pressed (queued, processed next InputSystem.Update); up = " +
+                "release ALL held keys (see tool description); tap = down+up (only visible " +
+                "to callback-driven input unless advance_frames ≥ 1); hold = down+up after " +
+                "advancing frames (so Hold interactions with a duration threshold can fire).",
+        },
+        key: {
+            type: "string",
+            description: "Unity Key enum name ('Space', 'W', 'LeftArrow', 'Digit1', 'F1') OR a " +
+                "single character ('a', '1', '!'). Resolved case-insensitively against " +
+                "UnityEngine.InputSystem.LowLevel.Key first, then as a character key.",
+        },
+        duration_ms: {
+            type: "integer",
+            default: 100,
+            description: "Recorded hold duration in milliseconds (for action='hold'). The real " +
+                "held-time gate is the number of advanced frames, not wall-clock — pair " +
+                "with advance_frames for Input System Hold interactions. Default 100.",
+        },
+        advance_frames: {
+            type: "integer",
+            default: 0,
+            minimum: 0,
+            maximum: 60,
+            description: "Pump this many player-loop frames (EditorApplication.Step) BETWEEN down " +
+                "and up so polling game code observes the press. 0 (default) keeps the " +
+                "old single-update behavior (only callback-driven input sees it). Cap 60. " +
+                "For polling input (wasPressedThisFrame) pass ≥ 1.",
+        },
+        shift: { type: "boolean", default: false, description: "Also hold Left Shift. Default false." },
+        ctrl: { type: "boolean", default: false, description: "Also hold Left Ctrl. Default false." },
+        alt: { type: "boolean", default: false, description: "Also hold Left Alt. Default false." },
+    },
+});
+//# sourceMappingURL=inputsim-key.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-key.js","sourceRoot":"","sources":["../../src/tools/inputsim-key.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,sEAAsE;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CACjC,6BAA6B,EAC7B,4EAA4E;IAC1E,mEAAmE;IACnE,4EAA4E;IAC5E,2DAA2D;IAC3D,6EAA6E;IAC7E,gFAAgF;IAChF,6EAA6E;IAC7E,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,wEAAwE;IACxE,6EAA6E;IAC7E,0CAA0C,EAC5C;IACE,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC3B,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;YACnC,WAAW,EACT,uEAAuE;gBACvE,4EAA4E;gBAC5E,4EAA4E;gBAC5E,6EAA6E;SAChF;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uEAAuE;gBACvE,wEAAwE;gBACxE,sEAAsE;SACzE;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG;YACZ,WAAW,EACT,uEAAuE;gBACvE,yEAAyE;gBACzE,sEAAsE;SACzE;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,WAAW,EACT,0EAA0E;gBAC1E,wEAAwE;gBACxE,2EAA2E;gBAC3E,mDAAmD;SACtD;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC/F,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,qCAAqC,EAAE;QAC7F,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,oCAAoC,EAAE;KAC5F;CACF,CACF,CAAC"}

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

@@ -0,0 +1,40 @@
+export declare const inputsimPointer: {
+    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-pointer.js

@@ -0,0 +1,121 @@
+// Input simulation — uGUI pointer dispatch (EventSystem + ExecuteEvents).
+//
+// Compile-gated on com.unity.ugui in the bridge (UNITY_OPEN_MCP_EXT_INPUTSIM_UGUI).
+// The workhorse for "click/swipe/drag a named object" during play mode.
+//
+// Resolution precedence: object_id > target > screen_x/screen_y.
+//   - object_id: a handle from scene_get_data / inputsim_probe, resolved via
+//     InstanceId (long, EntityId-safe on Unity 6000.5+). The most reliable way to
+//     address a specific object when names are ambiguous.
+//   - target: GameObject name or slash-path. Duplicate detection returns
+//     `ambiguous_target` with candidate paths; trailing-segment match lets a path
+//     inside an instantiated prefab resolve without the full scene-root path.
+//   - screen_x/screen_y: raycasts through EventSystem.current.RaycastAll.
+//
+// The response carries honesty fields — `interactable`, `blockedBy`, `dropTarget`
+// — so a click on a disabled button or behind a modal is never reported as an
+// unqualified ok. Dispatch still happens either way (occlusion-skipping is a
+// feature for reaching things a raycast would miss); the fields let the agent
+// judge whether the interaction was actually possible.
+//
+// Play-mode only (play_mode_required otherwise). Gate-free (writes no assets).
+// Pair with inputsim_step to advance frames between the interaction and a
+// screenshot so tweens/animations settle before you look.
+import { makeTool } from "./schema-fragments.js";
+export const inputsimPointer = makeTool("unity_open_mcp_inputsim_pointer", "Simulate a uGUI pointer interaction on a named GameObject or screen point " +
+    "during play mode, via the EventSystem + ExecuteEvents. Resolution precedence: " +
+    "object_id (a handle from scene_get_data / inputsim_probe) > target (name or " +
+    "slash-path, with duplicate detection + partial-path match) > screen_x/screen_y " +
+    "(raycasts through EventSystem.current). The response reports `interactable`, " +
+    "`blockedBy`, and (for drag) `dropTarget`/`dropLanded` so a click on a disabled " +
+    "button or behind a modal is never a silent ok. Play-mode only — refuses with " +
+    "`play_mode_required` otherwise; pair with editor_set_state to enter play mode " +
+    "and inputsim_step to advance frames before a screenshot. Gate-free. Requires " +
+    "com.unity.ugui.", {
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: ["click", "double_click", "press", "release", "hover", "hover_exit", "submit", "drag"],
+            description: "Pointer action. click = down+up+click (IPointerClickHandler); " +
+                "double_click = two triples with clickCount incrementing (so handlers " +
+                "reading eventData.clickCount==2 fire); press = pointer down only; " +
+                "release = pointer up only; hover = pointer Enter ONLY (so tooltip/" +
+                "highlight state can be screenshotted); hover_exit = pointer Exit (the " +
+                "pair); submit = ISubmitHandler (keyboard-style activate); drag = " +
+                "pointerDown → beginDrag → drag×N → pointerUp → drop (on the to-point " +
+                "target) → endDrag, matching uGUI's release order, with IDropHandler " +
+                "fired on the drop target.",
+        },
+        object_id: {
+            type: "string",
+            description: "InstanceId of the GameObject to dispatch on (from scene_get_data or " +
+                "inputsim_probe), as a quoted string. The most reliable addressing when " +
+                "names are ambiguous. Wins over target and screen_x/screen_y. On Unity " +
+                "6000.5+ this is an EntityId that can exceed 2^53, so pass it as a " +
+                "string to stay precise (the bridge accepts a quoted string or a bare " +
+                "number).",
+        },
+        target: {
+            type: "string",
+            description: "GameObject name ('StartButton') or slash-path ('Canvas/Panel/StartButton'). " +
+                "Path matching is trailing-segment aware, so 'Panel/Button' matches a " +
+                "nested prefab without knowing the scene root. When a name matches more " +
+                "than one active object the tool returns `ambiguous_target` with candidate " +
+                "paths — pass the full path or an object_id. Dispatched directly via " +
+                "ExecuteEvents.ExecuteHierarchy, so it fires even if the target is " +
+                "occluded (the response `blockedBy` field reports that case).",
+        },
+        screen_x: {
+            type: "number",
+            description: "Screen X (pixels) for the screen-point fallback path. Raycasts through " +
+                "EventSystem.current.RaycastAll and dispatches to the top hit. Pair with " +
+                "screen_y; omitted when object_id/target is given.",
+        },
+        screen_y: {
+            type: "number",
+            description: "Screen Y (pixels) for the screen-point fallback path. Pair with screen_x.",
+        },
+        view: {
+            type: "string",
+            enum: ["game", "scene"],
+            default: "game",
+            description: "Reserved for a future scene-view path; currently only the game view " +
+                "(Camera.main / canvas camera) is used to resolve screen points. Default 'game'.",
+        },
+        button: {
+            type: "string",
+            enum: ["left", "right", "middle"],
+            default: "left",
+            description: "Pointer button reported in PointerEventData. Default 'left'.",
+        },
+        drag_steps: {
+            type: "integer",
+            default: 8,
+            minimum: 1,
+            maximum: 100,
+            description: "Number of interpolated move events between drag endpoints. Each step " +
+                "runs a full EventSystem.RaycastAll, so this is capped at 100 to bound " +
+                "main-thread cost. The full begin/drag×N/pointerUp/drop/endDrag sequence " +
+                "dispatches in one frame (use inputsim_step afterward to let drag-driven " +
+                "tweens settle). Default 8.",
+        },
+        from_target: {
+            type: "string",
+            description: "Drag start — target name/path. When supplied, takes precedence over " +
+                "from_x/from_y; passing BOTH forms returns `both_endpoint_forms` (the " +
+                "explicit, non-silent precedence rule).",
+        },
+        from_x: { type: "number", description: "Drag start — screen X (alternative to from_target)." },
+        from_y: { type: "number", description: "Drag start — screen Y (alternative to from_target)." },
+        to_target: {
+            type: "string",
+            description: "Drag end / drop site — target name/path. When supplied, takes precedence " +
+                "over to_x/to_y; passing BOTH returns `both_endpoint_forms`. The drop " +
+                "target receives IDropHandler.OnDrop.",
+        },
+        to_x: { type: "number", description: "Drag end — screen X (alternative to to_target)." },
+        to_y: { type: "number", description: "Drag end — screen Y (alternative to to_target)." },
+    },
+});
+//# sourceMappingURL=inputsim-pointer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputsim-pointer.js","sourceRoot":"","sources":["../../src/tools/inputsim-pointer.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+export declare const inputsimPointer3d: {
+    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-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;
+};