unity-open-mcp 1.4.0 → 1.6.0

package/dist/tools/playtest-conditions.d.ts

@@ -0,0 +1,334 @@
+export declare const OBJECT_STATES: readonly ["exists", "active", "inactive", "destroyed"];
+export declare const LOG_LEVELS: readonly ["any", "log", "warning", "error", "exception"];
+export declare const CONDITION_LEAVES: readonly ["log", "ui", "object", "project_command", "frames", "ms"];
+export declare const CONDITION_MAX_CHILDREN = 16;
+/** The condition object schema (leaf, or all / any over leaves). */
+export declare function conditionSchema(description: string): {
+    readonly type: "object";
+    readonly description: string;
+    readonly properties: {
+        readonly all: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly items: {
+                readonly type: "object";
+                readonly description: "Exactly one of log, ui, object, project_command, frames, ms.";
+                readonly properties: {
+                    readonly log: {
+                        readonly type: "object";
+                        readonly required: readonly ["pattern"];
+                        readonly description: "A console message logged after the wait started matches `pattern` (latched once seen; reports the frame it was logged in).";
+                        readonly properties: {
+                            readonly pattern: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: ".NET regex, case-sensitive, matched against the message text.";
+                            };
+                            readonly level: {
+                                readonly type: "string";
+                                readonly enum: readonly ["any", "log", "warning", "error", "exception"];
+                                readonly description: "any (default) | log | warning | error (Error, Exception, Assert) | exception.";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly ui: {
+                        readonly type: "object";
+                        readonly description: string;
+                        readonly properties: {
+                            readonly text_contains: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Node display text contains this (normalised, case-insensitive; a control's text is its label).";
+                            };
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Node hierarchy path or trailing path suffix ('Popup/Title').";
+                            };
+                            readonly visible: {
+                                readonly type: "boolean";
+                                readonly description: "true (default) = count on-screen nodes only; false = count nodes that exist but are not visible.";
+                            };
+                            readonly matches: {
+                                readonly type: "boolean";
+                                readonly description: "true (default) = holds while at least one node matches; false = holds while none does (a popup closed).";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly object: {
+                        readonly type: "object";
+                        readonly description: string;
+                        readonly properties: {
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Hierarchy path (plain names, 'Root/Child') or a bare name (first match anywhere).";
+                            };
+                            readonly object_id: {
+                                readonly type: "string";
+                                readonly description: "Instance id (e.g. a ui_snapshot node id). Alternative to path.";
+                            };
+                            readonly state: {
+                                readonly type: "string";
+                                readonly enum: readonly ["exists", "active", "inactive", "destroyed"];
+                                readonly description: "exists (default) | active (activeInHierarchy) | inactive | destroyed (absent).";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly project_command: {
+                        readonly type: "object";
+                        readonly required: readonly ["id"];
+                        readonly description: string;
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Project command id (project.<owner>.<command>).";
+                            };
+                            readonly args: {
+                                readonly type: "object";
+                                readonly description: "The command's typed arguments (validated against its schema once, at start).";
+                            };
+                            readonly field: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Top-level field of the command's JSON object result that must be true.";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly frames: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1000000;
+                        readonly description: "Holds after this many frames have run since the start.";
+                    };
+                    readonly ms: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 3600000;
+                        readonly description: "Holds after this many ms (the call's `time` base) since the start.";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly description: "Holds when every leaf holds at the same poll (log leaves latch once seen).";
+        };
+        readonly any: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly items: {
+                readonly type: "object";
+                readonly description: "Exactly one of log, ui, object, project_command, frames, ms.";
+                readonly properties: {
+                    readonly log: {
+                        readonly type: "object";
+                        readonly required: readonly ["pattern"];
+                        readonly description: "A console message logged after the wait started matches `pattern` (latched once seen; reports the frame it was logged in).";
+                        readonly properties: {
+                            readonly pattern: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: ".NET regex, case-sensitive, matched against the message text.";
+                            };
+                            readonly level: {
+                                readonly type: "string";
+                                readonly enum: readonly ["any", "log", "warning", "error", "exception"];
+                                readonly description: "any (default) | log | warning | error (Error, Exception, Assert) | exception.";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly ui: {
+                        readonly type: "object";
+                        readonly description: string;
+                        readonly properties: {
+                            readonly text_contains: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Node display text contains this (normalised, case-insensitive; a control's text is its label).";
+                            };
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Node hierarchy path or trailing path suffix ('Popup/Title').";
+                            };
+                            readonly visible: {
+                                readonly type: "boolean";
+                                readonly description: "true (default) = count on-screen nodes only; false = count nodes that exist but are not visible.";
+                            };
+                            readonly matches: {
+                                readonly type: "boolean";
+                                readonly description: "true (default) = holds while at least one node matches; false = holds while none does (a popup closed).";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly object: {
+                        readonly type: "object";
+                        readonly description: string;
+                        readonly properties: {
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Hierarchy path (plain names, 'Root/Child') or a bare name (first match anywhere).";
+                            };
+                            readonly object_id: {
+                                readonly type: "string";
+                                readonly description: "Instance id (e.g. a ui_snapshot node id). Alternative to path.";
+                            };
+                            readonly state: {
+                                readonly type: "string";
+                                readonly enum: readonly ["exists", "active", "inactive", "destroyed"];
+                                readonly description: "exists (default) | active (activeInHierarchy) | inactive | destroyed (absent).";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly project_command: {
+                        readonly type: "object";
+                        readonly required: readonly ["id"];
+                        readonly description: string;
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Project command id (project.<owner>.<command>).";
+                            };
+                            readonly args: {
+                                readonly type: "object";
+                                readonly description: "The command's typed arguments (validated against its schema once, at start).";
+                            };
+                            readonly field: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "Top-level field of the command's JSON object result that must be true.";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly frames: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1000000;
+                        readonly description: "Holds after this many frames have run since the start.";
+                    };
+                    readonly ms: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 3600000;
+                        readonly description: "Holds after this many ms (the call's `time` base) since the start.";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly description: "Holds when one leaf holds; the result names it (fired.path, e.g. condition.any[1]).";
+        };
+        readonly log: {
+            readonly type: "object";
+            readonly required: readonly ["pattern"];
+            readonly description: "A console message logged after the wait started matches `pattern` (latched once seen; reports the frame it was logged in).";
+            readonly properties: {
+                readonly pattern: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: ".NET regex, case-sensitive, matched against the message text.";
+                };
+                readonly level: {
+                    readonly type: "string";
+                    readonly enum: readonly ["any", "log", "warning", "error", "exception"];
+                    readonly description: "any (default) | log | warning | error (Error, Exception, Assert) | exception.";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly ui: {
+            readonly type: "object";
+            readonly description: string;
+            readonly properties: {
+                readonly text_contains: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Node display text contains this (normalised, case-insensitive; a control's text is its label).";
+                };
+                readonly path: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Node hierarchy path or trailing path suffix ('Popup/Title').";
+                };
+                readonly visible: {
+                    readonly type: "boolean";
+                    readonly description: "true (default) = count on-screen nodes only; false = count nodes that exist but are not visible.";
+                };
+                readonly matches: {
+                    readonly type: "boolean";
+                    readonly description: "true (default) = holds while at least one node matches; false = holds while none does (a popup closed).";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly object: {
+            readonly type: "object";
+            readonly description: string;
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Hierarchy path (plain names, 'Root/Child') or a bare name (first match anywhere).";
+                };
+                readonly object_id: {
+                    readonly type: "string";
+                    readonly description: "Instance id (e.g. a ui_snapshot node id). Alternative to path.";
+                };
+                readonly state: {
+                    readonly type: "string";
+                    readonly enum: readonly ["exists", "active", "inactive", "destroyed"];
+                    readonly description: "exists (default) | active (activeInHierarchy) | inactive | destroyed (absent).";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly project_command: {
+            readonly type: "object";
+            readonly required: readonly ["id"];
+            readonly description: string;
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Project command id (project.<owner>.<command>).";
+                };
+                readonly args: {
+                    readonly type: "object";
+                    readonly description: "The command's typed arguments (validated against its schema once, at start).";
+                };
+                readonly field: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Top-level field of the command's JSON object result that must be true.";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly frames: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 1000000;
+            readonly description: "Holds after this many frames have run since the start.";
+        };
+        readonly ms: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 3600000;
+            readonly description: "Holds after this many ms (the call's `time` base) since the start.";
+        };
+    };
+    readonly additionalProperties: false;
+};
+/** True when a condition object has exactly one key (the bridge enforces the same rule). */
+export declare function isSingleKeyCondition(value: unknown): boolean;

package/dist/tools/playtest-conditions.js

@@ -0,0 +1,99 @@
+// Condition shapes shared by unity_open_mcp_playtest_wait (`condition`) and
+// unity_senses_capture_series (`start_on`). A condition is an object with
+// exactly one key: a leaf (log / ui / object / project_command / frames / ms)
+// or `all` / `any` over leaves (one level deep). The bridge parses and
+// enforces the one-key rule; the schema publishes the vocabulary.
+export const OBJECT_STATES = ["exists", "active", "inactive", "destroyed"];
+export const LOG_LEVELS = ["any", "log", "warning", "error", "exception"];
+export const CONDITION_LEAVES = ["log", "ui", "object", "project_command", "frames", "ms"];
+export const CONDITION_MAX_CHILDREN = 16;
+const leafProperties = {
+    log: {
+        type: "object",
+        required: ["pattern"],
+        description: "A console message logged after the wait started matches `pattern` (latched once seen; reports the frame it was logged in).",
+        properties: {
+            pattern: { type: "string", minLength: 1, description: ".NET regex, case-sensitive, matched against the message text." },
+            level: {
+                type: "string",
+                enum: [...LOG_LEVELS],
+                description: "any (default) | log | warning | error (Error, Exception, Assert) | exception.",
+            },
+        },
+        additionalProperties: false,
+    },
+    ui: {
+        type: "object",
+        description: "A ui_snapshot query over the uGUI screen model matches (or, with matches:false, stops matching). " +
+            "Needs text_contains and/or path. Requires com.unity.ugui.",
+        properties: {
+            text_contains: { type: "string", minLength: 1, description: "Node display text contains this (normalised, case-insensitive; a control's text is its label)." },
+            path: { type: "string", minLength: 1, description: "Node hierarchy path or trailing path suffix ('Popup/Title')." },
+            visible: { type: "boolean", description: "true (default) = count on-screen nodes only; false = count nodes that exist but are not visible." },
+            matches: { type: "boolean", description: "true (default) = holds while at least one node matches; false = holds while none does (a popup closed)." },
+        },
+        additionalProperties: false,
+    },
+    object: {
+        type: "object",
+        description: "A GameObject (loaded scenes + DontDestroyOnLoad, inactive included) by path or object_id is in `state`. " +
+            "Once found it is tracked: destroyed means that object was destroyed.",
+        properties: {
+            path: { type: "string", minLength: 1, description: "Hierarchy path (plain names, 'Root/Child') or a bare name (first match anywhere)." },
+            object_id: { type: "string", description: "Instance id (e.g. a ui_snapshot node id). Alternative to path." },
+            state: { type: "string", enum: [...OBJECT_STATES], description: "exists (default) | active (activeInHierarchy) | inactive | destroyed (absent)." },
+        },
+        additionalProperties: false,
+    },
+    project_command: {
+        type: "object",
+        required: ["id"],
+        description: "The project's own predicate: a synchronous, read-only project command (unity_open_mcp_project_commands) " +
+            "called at each poll holds when it returns JSON true — or, with `field`, an object whose `field` is true. " +
+            "Mutating or async commands are refused (command_not_allowed); there is no arbitrary C# predicate.",
+        properties: {
+            id: { type: "string", minLength: 1, description: "Project command id (project.<owner>.<command>)." },
+            args: { type: "object", description: "The command's typed arguments (validated against its schema once, at start)." },
+            field: { type: "string", minLength: 1, description: "Top-level field of the command's JSON object result that must be true." },
+        },
+        additionalProperties: false,
+    },
+    frames: { type: "integer", minimum: 0, maximum: 1_000_000, description: "Holds after this many frames have run since the start." },
+    ms: { type: "number", minimum: 0, maximum: 3_600_000, description: "Holds after this many ms (the call's `time` base) since the start." },
+};
+const leafCondition = {
+    type: "object",
+    description: "Exactly one of log, ui, object, project_command, frames, ms.",
+    properties: leafProperties,
+    additionalProperties: false,
+};
+/** The condition object schema (leaf, or all / any over leaves). */
+export function conditionSchema(description) {
+    return {
+        type: "object",
+        description,
+        properties: {
+            ...leafProperties,
+            all: {
+                type: "array",
+                minItems: 1,
+                maxItems: CONDITION_MAX_CHILDREN,
+                items: leafCondition,
+                description: "Holds when every leaf holds at the same poll (log leaves latch once seen).",
+            },
+            any: {
+                type: "array",
+                minItems: 1,
+                maxItems: CONDITION_MAX_CHILDREN,
+                items: leafCondition,
+                description: "Holds when one leaf holds; the result names it (fired.path, e.g. condition.any[1]).",
+            },
+        },
+        additionalProperties: false,
+    };
+}
+/** True when a condition object has exactly one key (the bridge enforces the same rule). */
+export function isSingleKeyCondition(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 1;
+}
+//# sourceMappingURL=playtest-conditions.js.map

package/dist/tools/playtest-conditions.js.map

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

package/dist/tools/playtest-session.d.ts

@@ -0,0 +1,45 @@
+export declare const PLAYTEST_SESSION_ACTIONS: readonly ["start", "mark", "status", "end", "resume", "list"];
+export declare const PLAYTEST_VERDICTS: readonly ["ok", "bug", "suspicious"];
+export declare const SESSION_ID_SCHEMA_PATTERN = "^[0-9]{8}-[0-9]{6}-[a-z0-9-]{1,40}$";
+/** Which arguments each action accepts (anything else is invalid_arguments). */
+export declare const PLAYTEST_SESSION_ACTION_KEYS: Record<(typeof PLAYTEST_SESSION_ACTIONS)[number], string[]>;
+export declare const playtestSession: {
+    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/playtest-session.js

@@ -0,0 +1,105 @@
+// Playtest — session recorder (server-side; group `playtest`).
+//
+// start → mark … → end. While a session is open, the owner's input / wait /
+// capture / project-command calls (and play-mode / Game view changes) are
+// recorded automatically into an append-only log in the platform app-data
+// folder; `end` writes report.md + frames + thumbnails next to it. Local
+// route: the MCP server owns the log (it sees every call); the bridge only
+// writes the frames. See src/playtest/recorder.ts.
+import { makeTool } from "./schema-fragments.js";
+export const PLAYTEST_SESSION_ACTIONS = ["start", "mark", "status", "end", "resume", "list"];
+export const PLAYTEST_VERDICTS = ["ok", "bug", "suspicious"];
+const SNAPSHOT_NAME_PATTERN = "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$";
+export const SESSION_ID_SCHEMA_PATTERN = "^[0-9]{8}-[0-9]{6}-[a-z0-9-]{1,40}$";
+/** Which arguments each action accepts (anything else is invalid_arguments). */
+export const PLAYTEST_SESSION_ACTION_KEYS = {
+    start: ["name", "device", "snapshot", "use_snapshot"],
+    mark: ["label", "note", "verdict", "session"],
+    status: [],
+    end: ["note", "diff", "session"],
+    resume: ["session"],
+    list: ["limit"],
+};
+export const playtestSession = makeTool("unity_open_mcp_playtest_session", "Record a playtest so a human can review it: start → mark each step → end writes a report. While a session is " +
+    "open, YOUR input (inputsim_*), wait (playtest_wait), capture (screenshots, capture_inline, capture_series, " +
+    "visual_compare), project-command (project_commands invoke, project-command / play-mode jobs) and control " +
+    "(editor_set_state, game_view set_*) calls are recorded automatically: tool, arguments with secrets redacted, " +
+    "status, duration, the frames they wrote, and console errors / exceptions logged during them or right after " +
+    "(matched by time from the bridge event stream). Other agents' calls are never recorded into your session. " +
+    "ACTIONS: start {name, device (free-text summary; the Game view / Simulator state is read too), snapshot:true " +
+    "(take a player_state snapshot now and diff it at end) or use_snapshot:<existing name>} — one open session per " +
+    "agent, a second start answers session_already_open; mark {label, verdict ok|bug|suspicious (default ok), note} " +
+    "after each player-visible step — answers how many errors the step logged; status — your open session, plus " +
+    "orphaned ones; end {note, diff (default true)} — writes report.md + full frames + thumbnails (steps with " +
+    "verdicts, the error list with first occurrence and stack, the state diff) and returns its path and a compact " +
+    "summary: hand the path to the human. The log is appended to disk per call in the app-data folder " +
+    "(…/unity-open-mcp/playtest-sessions/<company>/<product>/<session>/), so it survives a domain reload and an MCP " +
+    "server restart: after a restart call end (or resume) with session:<id> — the report names any call that was " +
+    "in flight and lost (no_open_session lists orphaned sessions). list = this project's sessions. Bounded: 500 " +
+    "calls, 200 marks, 300 frames (512 MB), 60 thumbnails per session.", {
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: [...PLAYTEST_SESSION_ACTIONS],
+            description: "start: open a session (recording begins). mark: close a step with a verdict. status: your open session. " +
+                "end: write the report. resume: re-attach a session left open by a stopped MCP server process. list: this project's sessions.",
+        },
+        name: {
+            type: "string",
+            minLength: 1,
+            maxLength: 80,
+            description: "[start] What the playtest covers (default \"playtest\"); also part of the session folder name.",
+        },
+        device: {
+            type: "string",
+            maxLength: 200,
+            description: "[start] Device / resolution summary for the report (e.g. \"iPhone 13 portrait via Device Simulator\"). The " +
+                "current Game view / Simulator state is recorded as well.",
+        },
+        snapshot: {
+            type: "boolean",
+            description: "[start] Take a player_state snapshot now (named playtest-<session>) and put its diff against the state at " +
+                "end into the report. Fails the start (snapshot_failed) rather than run unisolated. Prefer the project's own " +
+                "playtest.begin / playtest.end hook when it has one.",
+        },
+        use_snapshot: {
+            type: "string",
+            pattern: SNAPSHOT_NAME_PATTERN,
+            description: "[start] Diff against this existing player_state snapshot at end instead of taking a new one.",
+        },
+        label: {
+            type: "string",
+            minLength: 1,
+            maxLength: 120,
+            description: "[mark] The step that just finished, as a tester would name it (\"Tap Start Wave\").",
+        },
+        verdict: {
+            type: "string",
+            enum: [...PLAYTEST_VERDICTS],
+            description: "[mark] ok (default) | bug (wrong behaviour seen) | suspicious (needs a human look).",
+        },
+        note: {
+            type: "string",
+            maxLength: 2000,
+            description: "[mark / end] Free text: what was seen, expected vs actual. Secrets are redacted.",
+        },
+        session: {
+            type: "string",
+            pattern: SESSION_ID_SCHEMA_PATTERN,
+            description: "[mark / end / resume] The session id start returned. Needed only after an MCP server restart, to adopt the " +
+                "session the stopped process left open.",
+        },
+        diff: {
+            type: "boolean",
+            description: "[end] Diff the session's player-state snapshot against the current state into the report (default true).",
+        },
+        limit: {
+            type: "integer",
+            minimum: 1,
+            maximum: 50,
+            description: "[list] Newest sessions to list (default 10).",
+        },
+    },
+});
+//# sourceMappingURL=playtest-session.js.map

package/dist/tools/playtest-session.js.map

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

package/dist/tools/playtest-wait.d.ts

@@ -0,0 +1,46 @@
+/** Longest wait (timeout_ms) the direct call polls inline; longer ones become a job. */
+export declare const PLAYTEST_WAIT_INLINE_LIMIT_MS = 40000;
+export declare const PLAYTEST_WAIT_DEFAULT_TIMEOUT_MS = 30000;
+/** Mirrors the bridge's PlaytestWaitTools.MaxTimeoutMs. */
+export declare const PLAYTEST_WAIT_MAX_TIMEOUT_MS = 600000;
+export declare const PLAYTEST_WAIT_MAX_POLL_EVERY_FRAMES = 600;
+export declare const playtestWait: {
+    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;
+};