unity-open-mcp 1.4.0 → 1.6.0

package/dist/tools/inputsim-gesture.js

@@ -0,0 +1,123 @@
+// Input simulation — keyframed touch gestures over real play-mode frames.
+//
+// The bridge starts the gesture on its shared play-mode scheduler (a player-loop
+// tick at the start of EarlyUpdate) and returns an operation id at once; this
+// server turns that into the terminal trace by polling POST /playmode-operations
+// (tool-router `routeInputsimGesture`). A gesture longer than the inline budget
+// runs as a `jobs` play-mode operation instead and the call returns its job id.
+//
+// Routing matches inputsim_touch: legacy Input Manager touches (+ emulated
+// legacy mouse) and/or Input System Touchscreen events, `backend` reported as an
+// array. Legacy is single-finger (id 0). Cancel / exit play / reload release
+// every held finger. `capture_at_ms` captures the composed game frame at those
+// offsets in the same scheduled operation (a tap and the frames after it).
+import { makeTool } from "./schema-fragments.js";
+import { textTargetProps } from "./text-target.js";
+/** Longest gesture (ms) the direct call waits for inline; longer ones become a job. */
+export const INPUTSIM_GESTURE_INLINE_LIMIT_MS = 40_000;
+/** Hard cap on a gesture's last keyframe (mirrors the bridge's GesturePlan.MaxDurationMs). */
+export const INPUTSIM_GESTURE_MAX_DURATION_MS = 300_000;
+/** Mirrors the bridge's GestureTools.MaxCaptures. */
+export const INPUTSIM_GESTURE_MAX_CAPTURES = 30;
+const keyframe = {
+    type: "object",
+    required: ["at_ms"],
+    properties: {
+        at_ms: {
+            type: "number",
+            minimum: 0,
+            maximum: INPUTSIM_GESTURE_MAX_DURATION_MS,
+            description: "Time of this keyframe from the gesture start, in ms (strictly increasing per finger).",
+        },
+        x: { type: "number", description: "Screen X (coords: screen = pixels, bottom-left origin; normalized = 0..1; target = pixel offset from the target center)." },
+        y: { type: "number", description: "Screen Y, same space as x." },
+        target: { type: "string", description: "coords: target only — GameObject name or hierarchy path whose visual center is the point." },
+        ...textTargetProps("coords: target only — the keyframe point (instead of `target`; x/y stay pixel offsets)"),
+        phase: {
+            type: "string",
+            enum: ["down", "move", "hold", "up"],
+            description: "down = first keyframe (default there): finger touches. move = default in between: " +
+                "interpolate from the previous keyframe. hold = stay at the previous point until at_ms " +
+                "(x/y may be omitted). up = last keyframe (default there): move to this point and lift.",
+        },
+    },
+    additionalProperties: false,
+};
+export const inputsimGesture = makeTool("unity_open_mcp_inputsim_gesture", "Play a touch gesture across REAL play-mode frames: per-finger keyframed paths " +
+    "(down → move/hold → up) interpolated every frame, so polled gameplay input " +
+    "(Input.GetTouch / Input.mousePosition / Touchscreen.current) follows the finger " +
+    "for seconds — hold, drag, trace a curve. `time: gameplay` follows Time.timeScale. " +
+    "Routing like inputsim_touch: legacy Input Manager touches (legacy_touch, also " +
+    "driving the legacy mouse API and StandaloneInputModule) and/or Input System " +
+    "Touchscreen events (input_system); `backend` in the result is an array. Legacy is " +
+    "single-finger (id 0) — more fingers refuse with legacy_multitouch_unsupported; " +
+    "no reachable backend refuses with input_backend_unavailable (with the detected " +
+    "configuration), an unverified Editor with unsupported_editor_version. The call " +
+    "waits for the terminal result: a bounded trace (per keyframe: frame, screen point, " +
+    "uGUI top hit) plus console errors raised meanwhile. capture_at_ms [0, 100, 300, …] also captures the " +
+    "composed game frame at those offsets from the gesture start inside the same operation (the " +
+    "capture_series recorder: native size, files + per-frame frame / play_time under `captures`), so a tap " +
+    "and its follow-up frames come back from one call. Gestures longer than " +
+    `${INPUTSIM_GESTURE_INLINE_LIMIT_MS / 1000}s return a job_id instead — wait on it with ` +
+    "unity_open_mcp_jobs (you can also start one there directly). Cancel, exiting play " +
+    "mode and a domain reload release every held finger. One input gesture at a time " +
+    "(playmode_operation_busy). Play-mode only; gate-free. Not allowed inside batch_execute.", {
+    required: ["fingers"],
+    properties: {
+        fingers: {
+            type: "array",
+            minItems: 1,
+            maxItems: 10,
+            description: "One entry per finger: { id (0-9, default = index), path: [keyframes] }.",
+            items: {
+                type: "object",
+                required: ["path"],
+                properties: {
+                    id: { type: "integer", minimum: 0, maximum: 9 },
+                    path: { type: "array", minItems: 2, maxItems: 256, items: keyframe },
+                },
+                additionalProperties: false,
+            },
+        },
+        coords: {
+            type: "string",
+            enum: ["screen", "normalized", "target"],
+            default: "screen",
+            description: "screen = Screen pixels (bottom-left origin, same as Input.mousePosition); normalized = " +
+                "0..1 of the Game view size; target = each keyframe names a target or a target_text " +
+                "(on-screen label, like inputsim_touch), x/y are pixel offsets.",
+        },
+        time: {
+            type: "string",
+            enum: ["realtime", "gameplay"],
+            default: "realtime",
+            description: "realtime = unscaled wall time; gameplay = scaled by Time.timeScale (a paused game never advances).",
+        },
+        backend: {
+            type: "string",
+            enum: ["auto", "legacy_touch", "input_system"],
+            default: "auto",
+            description: "auto = every enabled, reachable backend (legacy_touch when the legacy Input Manager is " +
+                "on; input_system when a Touchscreen device exists). Force one with legacy_touch / input_system.",
+        },
+        capture_at_ms: {
+            type: "array",
+            minItems: 1,
+            maxItems: INPUTSIM_GESTURE_MAX_CAPTURES,
+            items: { type: "number", minimum: 0, maximum: INPUTSIM_GESTURE_MAX_DURATION_MS },
+            description: "Capture the composed game frame at these offsets (ms, the gesture's `time` base) from the gesture " +
+                "start — the call returns when the gesture and the last capture are done. Result `captures.frames[]`: " +
+                "frame, play_time, elapsed_ms, file, `unchanged`. Needs a rendering Game view / Simulator (Unity 6). " +
+                "In gameplay time a paused game (timeScale 0) ends the gesture after a wall-clock limit (error_code " +
+                "timed_out); captured frames are kept.",
+        },
+        operation_id: {
+            type: "string",
+            pattern: "^[A-Za-z0-9-]{8,64}$",
+            description: "Optional idempotency handle for the bridge operation (8-64 letters, digits, dashes). A retried " +
+                "call with the same id returns the same operation instead of starting another. Omit it normally " +
+                "(the server generates one); jobs always set it to the job id.",
+        },
+    },
+});
+//# sourceMappingURL=inputsim-gesture.js.map

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

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

package/dist/tools/inputsim-pointer.js

@@ -18,10 +18,17 @@
 // feature for reaching things a raycast would miss); the fields let the agent
 // judge whether the interaction was actually possible.
 //
+// routing: "raycast_real" skips ExecuteEvents and injects a real touch through
+// the project's input backend (legacy touches and/or Input System Touchscreen),
+// so the scene's own EventSystem input module raycasts and decides what is hit —
+// a cover graphic absorbs the tap like it would a finger. The response reports
+// the top hit, whether it is the target, the input module and the backend.
+//
 // 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";
+import { textTargetProps } from "./text-target.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 " +
@@ -30,8 +37,19 @@ export const inputsimPointer = makeTool("unity_open_mcp_inputsim_pointer", "Simu
     "`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.", {
+    "and inputsim_step to advance frames before a screenshot. ROUTING: `dispatch` " +
+    "(default) is the ExecuteEvents path above (reaches IPointer*/IDrag handlers only, " +
+    "bypasses occlusion). `raycast_real` instead injects a real touch at the point " +
+    "through the project's input backend (`backend`: auto | legacy_touch | input_system, " +
+    "reported as an array) so the scene's own EventSystem input module raycasts and " +
+    "dispatches it — whatever is on top receives it; the response reports `topHit`, " +
+    "`targetHit`, `blockedBy`, `inputModule` and `notes` (e.g. module/backend mismatch). " +
+    "raycast_real supports click, double_click, press, release, drag with the left " +
+    "button only and refuses like inputsim_touch (input_backend_unavailable, " +
+    "unsupported_editor_version). TARGET BY LABEL: `target_text` (+ under, index, text_match) picks " +
+    "the visible element whose text matches (see ui_snapshot) — exclusive with object_id/target/" +
+    "screen_x/screen_y (conflicting_targets); ambiguous labels refuse with ambiguous_target. " +
+    "Gate-free. Requires com.unity.ugui.", {
     required: ["action"],
     properties: {
         action: {
@@ -116,6 +134,21 @@ export const inputsimPointer = makeTool("unity_open_mcp_inputsim_pointer", "Simu
         },
         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)." },
+        routing: {
+            type: "string",
+            enum: ["dispatch", "raycast_real"],
+            default: "dispatch",
+            description: "dispatch = ExecuteEvents on the resolved object (default). raycast_real = inject a real " +
+                "touch at its screen point so the project's input module decides what is hit (a cover " +
+                "graphic absorbs it); the response still reports the top hit.",
+        },
+        backend: {
+            type: "string",
+            enum: ["auto", "legacy_touch", "input_system"],
+            default: "auto",
+            description: "Input backend for routing: raycast_real (ignored by dispatch; must stay auto there).",
+        },
+        ...textTargetProps("Element to act on (the drag start for drag)"),
     },
 });
 //# sourceMappingURL=inputsim-pointer.js.map

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

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

package/dist/tools/inputsim-touch.js

@@ -1,31 +1,42 @@
-// Input simulation — Input System touch / swipe device events.
+// Input simulation — backend-aware touch / swipe.
 //
-// Compile-gated on com.unity.inputsystem (UNITY_OPEN_MCP_EXT_INPUTSIM_IS).
-// Queues Touchscreen state events through the new Input System.
+// The bridge routes each call to the project's real input backend(s) and reports
+// them as `backend` (an array): legacy Input Manager touches (`legacy_touch`,
+// which also drive the legacy mouse API through Input.simulateMouseWithTouches
+// and therefore StandaloneInputModule) and/or Input System Touchscreen state
+// events (`input_system`). With activeInputHandler Both, `auto` injects into both.
+// The tool compiles in every project (no com.unity.inputsystem requirement).
 //
 // 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 dispatch —
-// documented honestly now (previously mis-advertised as "across real frames").
+// phase, so the swipe genuinely unfolds across frames for polling code. The
+// legacy backend always advances at least one frame between phases (its phases
+// collapse otherwise). Real-time gestures that last seconds: inputsim_gesture.
 //
-// Play-mode only. Gate-free. Requires com.unity.inputsystem.
+// Play-mode only. Gate-free.
 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 within one " +
-    "dispatch — 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. The Began phase also advances before the first move. Endpoints " +
+import { textTargetProps } from "./text-target.js";
+export const inputsimTouch = makeTool("unity_open_mcp_inputsim_touch", "Simulate a touch / swipe during play mode through the project's REAL input " +
+    "backend, reported as `backend` (array): legacy Input Manager touches (legacy_touch — " +
+    "Input.GetTouch, plus the legacy mouse API via Input.simulateMouseWithTouches, which " +
+    "StandaloneInputModule reads) and/or Input System Touchscreen events (input_system). " +
+    "`backend: auto` (default) injects into every enabled, reachable backend " +
+    "(activeInputHandler Both → both when a Touchscreen device exists; skipped backends are " +
+    "listed). Refusals: input_backend_unavailable (with the detected configuration and next " +
+    "steps), legacy_multitouch_unsupported (legacy is finger 0 only), " +
+    "unsupported_editor_version, no_device (explicit input_system without a Touchscreen). " +
+    "`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: with input_system only and no `advance_frames`, all phases process " +
+    "within one dispatch — polling code sees a collapsed jump. Pass `advance_frames` ≥ 1 to " +
+    "advance frames after Began and each Moved phase; legacy_touch always advances at least " +
+    "one frame between phases. For seconds-long holds/drags use inputsim_gesture. Endpoints " +
     "resolve target-first (name/path to visual center) or accept screen coordinates. " +
     "Root-anchored paths win over suffix matches; ambiguous names/paths return " +
     "ambiguous_target with candidate paths. This tool has no object_id parameter; " +
-    "use a unique path or screen coordinates. Play-mode only — refuses " +
-    "with `play_mode_required` otherwise. Gate-free. Requires com.unity.inputsystem.", {
+    "use a unique path, screen coordinates, or `target_text` — the visible uGUI element whose " +
+    "text matches (exclusive with target/screen_x/screen_y; for swipe it is the start, exclusive with " +
+    "from_target/from_x/from_y — conflicting_targets). Play-mode only — refuses " +
+    "with `play_mode_required` otherwise. Gate-free.", {
     required: ["action"],
     properties: {
         action: {
@@ -40,7 +51,7 @@ export const inputsimTouch = makeTool("unity_open_mcp_inputsim_touch", "Queue a
             default: 0,
             minimum: 0,
             maximum: 9,
-            description: "Touch finger index (0–9) for multi-touch. Default 0.",
+            description: "Touch finger index (0–9). The legacy_touch backend supports finger 0 only. Default 0.",
         },
         target: {
             type: "string",
@@ -75,8 +86,17 @@ export const inputsimTouch = makeTool("unity_open_mcp_inputsim_touch", "Queue a
             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 dispatch — only callback-driven input sees it then. Also advances after Began. Cap 60.",
+                "into one dispatch — only callback-driven input sees it then. Also advances after Began. " +
+                "The legacy_touch backend uses at least 1. Cap 60.",
         },
+        backend: {
+            type: "string",
+            enum: ["auto", "legacy_touch", "input_system"],
+            default: "auto",
+            description: "auto = every enabled, reachable backend; legacy_touch = legacy Input Manager only; " +
+                "input_system = Input System Touchscreen only (allows fingers 1–9).",
+        },
+        ...textTargetProps("Point to tap/press/release (the swipe start for swipe)"),
     },
 });
 //# sourceMappingURL=inputsim-touch.js.map

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

@@ -1 +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,uEAAuE;AACvE,+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,gEAAgE;IAChE,oEAAoE;IACpE,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,kFAAkF;IAClF,4EAA4E;IAC5E,+EAA+E;IAC/E,oEAAoE;IACpE,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,iGAAiG;SACpG;KACF;CACF,CACF,CAAC"}
+{"version":3,"file":"inputsim-touch.js","sourceRoot":"","sources":["../../src/tools/inputsim-touch.ts"],"names":[],"mappings":"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"}

package/dist/tools/jobs.js

@@ -1,6 +1,6 @@
 import { makeTool } from "./schema-fragments.js";
 import { JOB_STATES } from "../jobs/job-manager.js";
-export const jobs = makeTool("unity_open_mcp_jobs", "Observe session-owned asynchronous jobs: start, status, bounded wait, cooperative cancel, and paged list. Supported targets: unity_senses_run_tests and available async project commands. Other tools are unsupported. Test args are ordinary filters without run_id; project args contain nested args plus scope/gate options. Mutating starts require idempotency_key. Records expire 30 minutes after completion; server restart loses all records. Never blindly retry an orphaned job.", {
+export const jobs = makeTool("unity_open_mcp_jobs", "Observe session-owned asynchronous jobs: start, status, bounded wait, cooperative cancel, and paged list. Supported targets: unity_senses_run_tests, available async project commands, and play-mode operations (unity_open_mcp_inputsim_gesture, unity_open_mcp_playtest_wait, unity_senses_capture_series; cancellable — cancel releases held input and restores a wait's time scale). Other tools are unsupported. Test args are ordinary filters without run_id; project args contain nested args plus scope/gate options; play-mode operation args are the tool's own arguments (the job owns operation_id). Mutating starts require idempotency_key. Records expire 30 minutes after completion; server restart loses all records. Never blindly retry an orphaned job.", {
     required: ["action"],
     properties: {
         action: { type: "string", enum: ["start", "status", "wait", "cancel", "list"] },

package/dist/tools/jobs.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,qBAAqB,EAChD,6dAA6d,EAAE;IAC7d,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QAC/E,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;QACzG,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACxD,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE;QAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;QAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;KACrD;CACF,CAAC,CAAC"}
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,qBAAqB,EAChD,+uBAA+uB,EAAE;IAC/uB,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QAC/E,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;QACzG,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;QACxD,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE;QAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;QAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;KACrD;CACF,CAAC,CAAC"}

package/dist/tools/player-state.d.ts

@@ -0,0 +1,42 @@
+export declare const PLAYER_STATE_ACTIONS: readonly ["snapshot", "diff", "restore", "list", "delete"];
+export declare const PLAYER_STATE_RESTORE_SCOPE = "ProjectSettings/ProjectSettings.asset";
+export declare const playerState: {
+    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/player-state.js

@@ -0,0 +1,142 @@
+// Playtest — player-state sandbox for a live playtest.
+//
+// snapshot / diff / restore / list / delete over the state a play session
+// changes: PlayerPrefs (all keys, typed — read from the platform store after the
+// bridge flushes PlayerPrefs.Save, since Unity has no enumeration API), opt-in
+// EditorPrefs by key prefix, and the files under persistentDataPath. Snapshots
+// live in the platform app-data folder outside the project
+// (`…/unity-open-mcp/player-state/<company>/<product>/<name>/`). Only `restore`
+// with `confirm: true` writes state: the bridge classifies it as a mutation per
+// request, so it runs the normal gate + audit path; its `paths_hint` defaults to
+// ProjectSettings/ProjectSettings.asset (the company / product identity the
+// snapshot is bound to — restore writes no project asset). Group `playtest`.
+import { GATE_PROP, makeTool } from "./schema-fragments.js";
+export const PLAYER_STATE_ACTIONS = ["snapshot", "diff", "restore", "list", "delete"];
+export const PLAYER_STATE_RESTORE_SCOPE = "ProjectSettings/ProjectSettings.asset";
+// No "..", no trailing "." (the bridge refuses both).
+const SNAPSHOT_NAME_PATTERN = "^(?!.*\\.\\.)(?!.*\\.$)[A-Za-z0-9][A-Za-z0-9._-]{0,63}$";
+export const playerState = makeTool("unity_open_mcp_player_state", "Isolate the player state a live playtest changes: snapshot it, see what a session changed, put it back. " +
+    "STATE = PlayerPrefs (every key with its type, read from the platform store after PlayerPrefs.Save so it " +
+    "is what the game wrote, even unsaved), persistentDataPath files (size + sha256; default excludes " +
+    "Unity/** and TestResults.xml, cap max_files_mb), and EditorPrefs only under editor_prefs_prefixes " +
+    "(opt-in; EditorPrefs are shared by every project on the machine). Unity's own session keys " +
+    "(unity.player_session*, unity_connect.*) are excluded by default; excluded keys and paths are never " +
+    "captured, diffed or touched. Snapshots are stored outside the project in the app-data folder " +
+    "(…/unity-open-mcp/player-state/<company>/<product>/<name>/). ACTIONS: snapshot = capture into `name` " +
+    "(snapshot_exists unless overwrite); diff = `name` vs the current state (or vs snapshot `against`): " +
+    "prefs / editor_prefs / files added, removed, changed — small values shown, long strings and files as " +
+    "size + sha256; restore = EDIT MODE ONLY; without confirm a dry run returning the diff it would apply " +
+    "(current → snapshot) with EVERY removal and overwrite listed and a `plan` id; with confirm:true + that " +
+    "plan it OVERWRITES the current state (plan_changed when the state moved since the dry run) — " +
+    "PlayerPrefs.DeleteAll + the snapshot's keys + Save (so the Editor's in-memory cache and the store agree), " +
+    "EditorPrefs only under the snapshot's prefixes, persistentDataPath mirrored exactly (files not in the " +
+    "snapshot are DELETED) — then re-reads and reports verified; it is the only gated action (paths_hint " +
+    "defaults to ProjectSettings/ProjectSettings.asset) and refuses edit_mode_required in play mode and " +
+    "snapshot_project_mismatch for another project's snapshot; list / delete = the snapshots of this " +
+    "project (company + product address another project's store). Prefer a project's own isolated-save " +
+    "hook (project_commands playtest.begin / playtest.end) when it exists; otherwise snapshot → play → diff " +
+    "→ stop → restore (dry run, then confirm with its plan). macOS verified; Windows registry and Linux readers are " +
+    "untested in the field.", {
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: [...PLAYER_STATE_ACTIONS],
+            description: "snapshot: capture into name. diff: name vs current (or against). restore: dry run, or apply with " +
+                "confirm:true (edit mode). list: snapshots of this project. delete: remove snapshot name.",
+        },
+        name: {
+            type: "string",
+            pattern: SNAPSHOT_NAME_PATTERN,
+            description: "[snapshot / diff / restore / delete] Snapshot name: 1-64 of [A-Za-z0-9._-], starting with a letter or digit.",
+        },
+        against: {
+            type: "string",
+            pattern: SNAPSHOT_NAME_PATTERN,
+            description: "[diff] Compare `name` with this other snapshot instead of the current state.",
+        },
+        confirm: {
+            type: "boolean",
+            default: false,
+            description: "[restore] false (default) = dry run: returns the diff restore would apply and its plan id, nothing " +
+                "changes. true = apply (needs `plan`): overwrites PlayerPrefs, opted-in EditorPrefs and persistentDataPath " +
+                "(removing files not in the snapshot). Review the dry run's removals and overwrites first.",
+        },
+        plan: {
+            type: "string",
+            pattern: "^[0-9a-f]{16}$",
+            description: "[restore confirm:true] The `plan` id the dry run returned. Required with confirm:true: restore applies " +
+                "only the plan that was reviewed and refuses plan_changed when the current state moved since (a new " +
+                "save file, a changed key) — run the dry run again then.",
+        },
+        editor_prefs_prefixes: {
+            type: "array",
+            items: { type: "string", minLength: 3 },
+            minItems: 1,
+            maxItems: 16,
+            description: "[snapshot] Also capture EditorPrefs whose key starts with one of these prefixes (≥ 3 characters each). " +
+                "Off by default: EditorPrefs are shared by all projects on this machine. restore touches only keys " +
+                "under the snapshot's prefixes (never EditorPrefs.DeleteAll).",
+        },
+        exclude: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            maxItems: 32,
+            description: "[snapshot] Extra glob patterns of persistentDataPath paths to leave out (added to the defaults " +
+                "Unity/** and TestResults.xml): '**' any depth, '*' / '?' within a name; a pattern without '/' " +
+                "matches a file or folder name at any depth (e.g. '*.log', 'Cache/**'). Excluded paths are never " +
+                "restored or removed.",
+        },
+        exclude_keys: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            maxItems: 32,
+            description: "[snapshot] Extra PlayerPrefs key patterns to leave out ('*' any run, '?' one character), added to " +
+                "the defaults unity.player_session* and unity_connect.* (Unity's per-session bookkeeping). Excluded " +
+                "keys keep their current values on restore.",
+        },
+        max_files_mb: {
+            type: "integer",
+            minimum: 1,
+            maximum: 1024,
+            description: "[snapshot] Size cap for the persistentDataPath copy after excludes (default 64; at most 5000 files). " +
+                "Over the cap → persistent_data_too_large with the largest files, nothing written.",
+        },
+        overwrite: {
+            type: "boolean",
+            description: "[snapshot] Replace an existing snapshot of the same name (default false → snapshot_exists).",
+        },
+        company: {
+            type: "string",
+            minLength: 1,
+            description: "[diff / restore / list / delete] Company name of another project's snapshot store (default: the open " +
+                "project's). restore refuses a snapshot whose company / product differ from the open project.",
+        },
+        product: {
+            type: "string",
+            minLength: 1,
+            description: "[diff / restore / list / delete] Product name of another project's snapshot store (default: the open project's).",
+        },
+        limit: {
+            type: "integer",
+            minimum: 1,
+            maximum: 1000,
+            description: "[diff / restore] Entries listed per list (default 100; counts are always complete, `truncated` says " +
+                "how many were left out). diff bounds added / removed / changed; restore bounds only added and always " +
+                "lists every removal and overwrite.",
+        },
+        paths_hint: {
+            type: "array",
+            items: { type: "string" },
+            default: [PLAYER_STATE_RESTORE_SCOPE],
+            description: "Audit / gate scope for restore with confirm:true, materialized automatically: restore writes no " +
+                "project asset; ProjectSettings.asset holds the company / product the snapshot is bound to. Ignored " +
+                "by every other action.",
+        },
+        gate: {
+            ...GATE_PROP,
+            description: "[restore confirm:true] Gate mode for the applied restore. Other actions are not gated.",
+        },
+    },
+});
+//# sourceMappingURL=player-state.js.map

package/dist/tools/player-state.js.map

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