@atelierai/uco 1.0.0

package/dist/devops/utils/connection.js

@@ -0,0 +1,77 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { verbose } from './ui.js';
+import { generatePortFromDirectory } from './port.js';
+import { readConfig, resolveConnectionFromConfig } from './config.js';
+import * as ui from './ui.js';
+/**
+ * Returns true if the given directory looks like a Unity project (has an Assets subfolder).
+ */
+export function isUnityProject(dir) {
+    return fs.existsSync(path.join(dir, 'Assets'));
+}
+/**
+ * Resolve the project path from positional arg, --path option, or cwd.
+ */
+export function resolveProjectPath(positionalPath, options) {
+    const resolved = path.resolve(positionalPath ?? options.path ?? process.cwd());
+    if ((positionalPath !== undefined || options.path !== undefined) && !fs.existsSync(resolved)) {
+        ui.error(`Project path does not exist: ${resolved}`);
+        process.exit(1);
+    }
+    return resolved;
+}
+/**
+ * Resolve the project path and validate it is a Unity project.
+ * Skips validation when --url is provided (explicit server override).
+ */
+export function resolveAndValidateProjectPath(positionalPath, options) {
+    const resolved = resolveProjectPath(positionalPath, options);
+    // Skip Unity project validation when --url is explicitly provided
+    if (options.url) {
+        return resolved;
+    }
+    if (!isUnityProject(resolved)) {
+        ui.error(`Not a Unity project (missing Assets folder): ${resolved}`);
+        ui.info('Provide a Unity project path as an argument, or use --url to connect to a server directly.');
+        process.exit(1);
+    }
+    return resolved;
+}
+/**
+ * Resolve the server URL and auth token.
+ *
+ * URL priority:
+ *   1. --url flag (explicit override)
+ *   2. Config file connectionMode → Custom: host, Cloud: hardcoded cloud URL
+ *   3. Deterministic port from project path
+ *
+ * Token priority:
+ *   1. --token flag (explicit override)
+ *   2. Config file token
+ */
+export function resolveConnection(projectPath, options) {
+    const config = readConfig(projectPath);
+    const fromConfig = config ? resolveConnectionFromConfig(config) : { url: undefined, token: undefined };
+    verbose(`Config loaded: connectionMode=${config?.connectionMode ?? 'N/A'}, configUrl=${fromConfig.url ?? 'N/A'}, hasToken=${!!fromConfig.token}`);
+    let url;
+    if (options.url) {
+        url = options.url.replace(/\/$/, '');
+        verbose(`Using explicit --url: ${url}`);
+    }
+    else if (fromConfig.url) {
+        url = fromConfig.url.replace(/\/$/, '');
+        verbose(`Using URL from config (${config?.connectionMode} mode): ${url}`);
+    }
+    else {
+        const port = generatePortFromDirectory(projectPath);
+        url = `http://localhost:${port}`;
+        verbose(`Using deterministic port URL: ${url}`);
+    }
+    const token = options.token ?? fromConfig.token;
+    if (options.token) {
+        verbose('Using explicit --token');
+    }
+    return { url, token };
+}
+//# sourceMappingURL=connection.js.map

package/dist/devops/utils/connection.js.map

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

package/dist/devops/utils/editor-cache.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Look up a previously-resolved editor binary path for the given
+ * Unity version (or `undefined` to look up the "auto / highest" slot).
+ * Returns null when no entry exists OR when the cached path no longer
+ * exists on disk — in the latter case the stale entry is dropped
+ * automatically so subsequent reads don't waste a stat call.
+ */
+export declare function readCachedEditorPath(version: string | undefined): string | null;
+/** Save the resolved editor path under the given version key. */
+export declare function writeCachedEditorPath(version: string | undefined, editorPath: string): void;
+/**
+ * Drop the cache entry for the given version. Called when a cached
+ * path turned out to be unusable (e.g. spawn failed) so the next
+ * invocation re-runs the full resolution.
+ */
+export declare function clearCachedEditorPath(version: string | undefined): void;

package/dist/devops/utils/editor-cache.js

@@ -0,0 +1,81 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { verbose } from './ui.js';
+const CACHE_FILE = join(homedir(), '.unity-mcp-cli-editor-cache.json');
+// Storage key for the version-less "highest installed" lookup.
+// Underscored to stay out of the Unity-version namespace (e.g. `6000.3.1f1`).
+const AUTO_KEY = '__auto__';
+function keyFor(version) {
+    return version ?? AUTO_KEY;
+}
+function readAll() {
+    try {
+        const raw = readFileSync(CACHE_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            const safe = Object.create(null);
+            for (const k of Object.keys(parsed)) {
+                safe[k] = parsed[k];
+            }
+            return safe;
+        }
+    }
+    catch {
+        // Missing or corrupt — treat as empty cache.
+    }
+    return Object.create(null);
+}
+function writeAll(cache) {
+    try {
+        writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch {
+        // Best-effort: a read-only home dir or full disk should never break `open`.
+    }
+}
+/**
+ * Look up a previously-resolved editor binary path for the given
+ * Unity version (or `undefined` to look up the "auto / highest" slot).
+ * Returns null when no entry exists OR when the cached path no longer
+ * exists on disk — in the latter case the stale entry is dropped
+ * automatically so subsequent reads don't waste a stat call.
+ */
+export function readCachedEditorPath(version) {
+    const cache = readAll();
+    const k = keyFor(version);
+    const entry = cache[k];
+    if (!entry || typeof entry.path !== 'string')
+        return null;
+    if (!existsSync(entry.path)) {
+        verbose(`editor-cache: stale entry for ${k} -> ${entry.path} (file missing), evicting`);
+        delete cache[k];
+        writeAll(cache);
+        return null;
+    }
+    verbose(`editor-cache: hit ${k} -> ${entry.path}`);
+    return entry.path;
+}
+/** Save the resolved editor path under the given version key. */
+export function writeCachedEditorPath(version, editorPath) {
+    const cache = readAll();
+    const k = keyFor(version);
+    cache[k] = { path: editorPath, savedAt: Date.now() };
+    writeAll(cache);
+    verbose(`editor-cache: stored ${k} -> ${editorPath}`);
+}
+/**
+ * Drop the cache entry for the given version. Called when a cached
+ * path turned out to be unusable (e.g. spawn failed) so the next
+ * invocation re-runs the full resolution.
+ */
+export function clearCachedEditorPath(version) {
+    const cache = readAll();
+    const k = keyFor(version);
+    if (cache[k] === undefined)
+        return;
+    delete cache[k];
+    writeAll(cache);
+    verbose(`editor-cache: cleared ${k}`);
+}
+//# sourceMappingURL=editor-cache.js.map

package/dist/devops/utils/editor-cache.js.map

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

package/dist/devops/utils/input.d.ts

@@ -0,0 +1,13 @@
+export interface InputOptions {
+    input?: string;
+    inputFile?: string;
+}
+/**
+ * Parse tool input from --input, --input-file, or stdin.
+ *
+ * - `--input-file -` or `--input-file /dev/stdin` reads from stdin (cross-platform).
+ * - `--input-file <path>` reads from a file.
+ * - `--input <json>` parses inline JSON.
+ * - Falls back to `{}` if nothing provided.
+ */
+export declare function parseInput(options: InputOptions): string;

package/dist/devops/utils/input.js

@@ -0,0 +1,72 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as ui from './ui.js';
+import { verbose } from './ui.js';
+import { parseJsonStrict, JsonParseError } from './json-parse.js';
+/**
+ * Parse tool input from --input, --input-file, or stdin.
+ *
+ * - `--input-file -` or `--input-file /dev/stdin` reads from stdin (cross-platform).
+ * - `--input-file <path>` reads from a file.
+ * - `--input <json>` parses inline JSON.
+ * - Falls back to `{}` if nothing provided.
+ */
+export function parseInput(options) {
+    if (options.inputFile) {
+        const isStdin = options.inputFile === '-' || options.inputFile === '/dev/stdin';
+        let content;
+        if (isStdin) {
+            verbose('Reading input from stdin...');
+            try {
+                content = fs.readFileSync(0, 'utf-8');
+            }
+            catch {
+                ui.error('Failed to read from stdin.');
+                process.exit(1);
+            }
+            if (!content.trim()) {
+                ui.error('No input received from stdin.');
+                process.exit(1);
+            }
+        }
+        else {
+            const filePath = path.resolve(options.inputFile);
+            if (!fs.existsSync(filePath)) {
+                ui.error(`Input file does not exist: ${filePath}`);
+                process.exit(1);
+            }
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        try {
+            parseJsonStrict(content);
+        }
+        catch (err) {
+            const source = isStdin ? 'stdin' : options.inputFile;
+            if (err instanceof JsonParseError) {
+                ui.error(`--input-file content from '${source}' must be valid JSON\n${err.message}`);
+            }
+            else {
+                ui.error(`--input-file content from '${source}' must be valid JSON`);
+            }
+            process.exit(1);
+        }
+        return content;
+    }
+    if (options.input) {
+        try {
+            const result = parseJsonStrict(options.input);
+            return result.raw;
+        }
+        catch (err) {
+            if (err instanceof JsonParseError) {
+                ui.error(`--input must be valid JSON\n${err.message}`);
+            }
+            else {
+                ui.error('--input must be valid JSON');
+            }
+            process.exit(1);
+        }
+    }
+    return '{}';
+}
+//# sourceMappingURL=input.js.map

package/dist/devops/utils/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/devops/utils/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOlE;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,SAAS,KAAK,YAAY,CAAC;QAChF,IAAI,OAAe,CAAC;QAEpB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,6BAA6B,CAAC,CAAC;YACvC,IAAI,CAAC;gBACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,EAAE,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC;YACH,eAAe,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;YACrD,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;gBAClC,EAAE,CAAC,KAAK,CAAC,8BAA8B,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACvF,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,KAAK,CAAC,8BAA8B,MAAM,sBAAsB,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;gBAClC,EAAE,CAAC,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/devops/utils/json-parse.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Robust JSON parsing with auto-stringify fallback and detailed error reporting.
+ *
+ * 1. Try to parse the raw string as JSON.
+ * 2. If that fails, wrap it in quotes (stringify) and try again.
+ * 3. If still invalid, report the exact position where parsing fails.
+ */
+export interface JsonParseResult {
+    readonly value: unknown;
+    readonly raw: string;
+    readonly wasStringified: boolean;
+}
+export declare class JsonParseError extends Error {
+    readonly position: number;
+    readonly snippet: string;
+    constructor(message: string, position: number, snippet: string);
+}
+/**
+ * Parse a string as strict JSON. Throws {@link JsonParseError} with
+ * position and snippet on failure.
+ *
+ * @param input  The raw string to parse as JSON.
+ * @returns      A result containing the parsed value.
+ * @throws       {@link JsonParseError} with position and snippet on failure.
+ */
+export declare function parseJsonStrict(input: string): JsonParseResult;
+/**
+ * Parse a string as JSON with auto-stringify fallback.
+ * If the input is not valid JSON, it wraps the raw string via
+ * `JSON.stringify` so it becomes a valid JSON string literal.
+ * Check {@link JsonParseResult.wasStringified} to detect this case.
+ *
+ * @param input  The raw string to parse as JSON.
+ * @returns      A result containing the parsed value (never throws).
+ */
+export declare function parseJsonRobust(input: string): JsonParseResult;

package/dist/devops/utils/json-parse.js

@@ -0,0 +1,105 @@
+export class JsonParseError extends Error {
+    position;
+    snippet;
+    constructor(message, position, snippet) {
+        super(message);
+        this.name = 'JsonParseError';
+        this.position = position;
+        this.snippet = snippet;
+    }
+}
+/**
+ * Extract the error position from a JSON.parse SyntaxError message.
+ * Common formats:
+ *   - "... at position 42"           (V8 / Node)
+ *   - "... at line 3 column 5"       (some engines)
+ *   - "Unexpected token X in JSON at position 42"
+ */
+function extractErrorPosition(error, input) {
+    const msg = error.message;
+    const posMatch = msg.match(/position\s+(\d+)/i);
+    if (posMatch) {
+        return parseInt(posMatch[1], 10);
+    }
+    const lineColMatch = msg.match(/line\s+(\d+)\s+column\s+(\d+)/i);
+    if (lineColMatch) {
+        const targetLine = parseInt(lineColMatch[1], 10);
+        const targetCol = parseInt(lineColMatch[2], 10);
+        const lines = input.split('\n');
+        let offset = 0;
+        for (let i = 0; i < targetLine - 1 && i < lines.length; i++) {
+            offset += lines[i].length + 1; // +1 for newline
+        }
+        return offset + targetCol - 1;
+    }
+    return -1;
+}
+/**
+ * Build a human-readable snippet around the error position.
+ */
+function buildSnippet(input, position) {
+    if (position < 0 || position > input.length) {
+        return input.length <= 80 ? input : input.slice(0, 80) + '...';
+    }
+    const contextBefore = 20;
+    const contextAfter = 20;
+    const start = Math.max(0, position - contextBefore);
+    const end = Math.min(input.length, position + contextAfter);
+    const before = (start > 0 ? '...' : '') + input.slice(start, position);
+    const errorChar = position < input.length ? input[position] : '<end>';
+    const after = input.slice(position + 1, end) + (end < input.length ? '...' : '');
+    const pointer = ' '.repeat(before.length) + '^';
+    return `${before}${errorChar}${after}\n${pointer}`;
+}
+/**
+ * Build a detailed error message for a JSON parse failure.
+ */
+function buildDetailedError(input, error) {
+    const position = extractErrorPosition(error, input);
+    const snippet = buildSnippet(input, position);
+    const posInfo = position >= 0 ? ` at position ${position}` : '';
+    const message = `Invalid JSON${posInfo}: ${error.message}\n\n` +
+        `  ${snippet.split('\n').join('\n  ')}\n`;
+    return new JsonParseError(message, position, snippet);
+}
+/**
+ * Parse a string as strict JSON. Throws {@link JsonParseError} with
+ * position and snippet on failure.
+ *
+ * @param input  The raw string to parse as JSON.
+ * @returns      A result containing the parsed value.
+ * @throws       {@link JsonParseError} with position and snippet on failure.
+ */
+export function parseJsonStrict(input) {
+    try {
+        const value = JSON.parse(input);
+        return { value, raw: input, wasStringified: false };
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw buildDetailedError(input, error);
+        }
+        throw error;
+    }
+}
+/**
+ * Parse a string as JSON with auto-stringify fallback.
+ * If the input is not valid JSON, it wraps the raw string via
+ * `JSON.stringify` so it becomes a valid JSON string literal.
+ * Check {@link JsonParseResult.wasStringified} to detect this case.
+ *
+ * @param input  The raw string to parse as JSON.
+ * @returns      A result containing the parsed value (never throws).
+ */
+export function parseJsonRobust(input) {
+    try {
+        const value = JSON.parse(input);
+        return { value, raw: input, wasStringified: false };
+    }
+    catch {
+        const stringified = JSON.stringify(input);
+        const value = JSON.parse(stringified);
+        return { value, raw: stringified, wasStringified: true };
+    }
+}
+//# sourceMappingURL=json-parse.js.map

package/dist/devops/utils/json-parse.js.map

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

package/dist/devops/utils/launch-error-dismiss.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Supported `process.platform` values for the launch-errors dialog
+ * dismiss helper. Narrowed alias of NodeJS.Platform — keeps the
+ * platform-dispatch table exhaustive in tests without forcing callers
+ * to import a Node-internal type.
+ */
+export type DismissPlatform = 'win32' | 'darwin' | 'linux';
+/**
+ * Outcome of a single dismiss attempt against the running OS desktop.
+ *
+ * `dismissed`: the dialog was found AND a click was dispatched
+ * successfully. The polling loop should stop and return.
+ *
+ * `not-found`: no matching dialog was visible on this poll tick. The
+ * polling loop should continue ticking until either the overall
+ * timeout elapses or Unity reports ready (the existing wait-for-ready
+ * logic, which runs in parallel, is the authoritative ready signal).
+ *
+ * `error`: an unexpected platform error happened (a required tool was
+ * missing, a syscall failed). The polling loop logs the error once
+ * and continues with `not-found` semantics — the dialog may simply
+ * not be open yet, and a single transient error must not abort the
+ * whole launch flow.
+ */
+export type DismissOutcome = {
+    kind: 'dismissed';
+    button: string;
+} | {
+    kind: 'not-found';
+} | {
+    kind: 'error';
+    message: string;
+};
+/**
+ * Window-title fragments matched against the Unity launch-errors
+ * dialog. Both legacy and current strings are listed so the matcher
+ * stays resilient across Unity versions. The match is case-insensitive
+ * and substring-based — Unity's actual title varies by version but
+ * always contains one of these.
+ *
+ * Exposed so tests can assert the matcher knows about both spellings
+ * without grepping the implementation.
+ */
+export declare const LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS: readonly string[];
+/** The button label this helper presses to dismiss the dialog. */
+export declare const DISMISS_BUTTON_LABEL = "Ignore";
+/**
+ * Producer-side prefixes for error messages that callers treat as
+ * permanent (the polling loop bails out instead of ticking again).
+ *
+ * Exported so the bailout matcher in `lib/open.ts` and the
+ * error-construction sites below reference the SAME literal — a
+ * future re-word lands in both places at once.
+ *
+ * The matcher in `lib/open.ts` uses `String.includes`, so each
+ * constant just needs to be a stable substring of the full message.
+ */
+export declare const LINUX_XDOTOOL_MISSING_PREFIX = "xdotool not found on PATH";
+export declare const UNSUPPORTED_PLATFORM_PREFIX = "Unsupported platform for launch-errors auto-dismiss";
+/**
+ * Try once to find and dismiss the Unity launch-errors dialog on the
+ * current OS desktop. Pure-ish — performs a single OS call and
+ * returns; never blocks past the underlying syscall's own timeout.
+ *
+ * Library-safe: never throws (errors are returned in the
+ * `DismissOutcome` union), never writes to stdout/stderr, never
+ * mutates global state.
+ *
+ * The helper is platform-dispatched:
+ * - **Windows**: Win32 (`FindWindowW` / `EnumWindows` /
+ *   `EnumChildWindows` / `GetWindowTextW` / `SendMessageW(BM_CLICK)`)
+ *   driven from PowerShell so we do not pull in a native node-gyp
+ *   dependency. UI Automation is the documented fallback if title
+ *   matching breaks on a future Unity release.
+ * - **macOS**: AppleScript via `osascript` (the leaner
+ *   AX-C-API-direct path is a documented follow-up). Requires the
+ *   user to have granted Accessibility permission to the terminal /
+ *   `unity-mcp-cli` binary once.
+ * - **Linux/X11**: `xdotool` (documented as a Linux platform
+ *   dependency; `wmctrl` is acceptable as an alternative window
+ *   enumerator). Wayland is deferred — call out explicitly in the
+ *   error message so the user does not waste time debugging.
+ */
+export declare function tryDismissLaunchErrorsDialog(platform?: DismissPlatform): Promise<DismissOutcome>;
+/**
+ * The PowerShell payload that probes for the Unity launch-errors
+ * dialog and clicks `Ignore` if found. Exported as a string (not a
+ * function) so tests can assert the script shape without launching
+ * PowerShell.
+ *
+ * Strategy:
+ *   1. P/Invoke `EnumWindows` via Add-Type to enumerate every visible
+ *      top-level window owned by `Unity.exe`.
+ *   2. Filter by title fragment (case-insensitive substring).
+ *   3. Walk child windows with `EnumChildWindows`, looking for a
+ *      Button whose text equals `Ignore`.
+ *   4. Send `BM_CLICK` (0x00F5) to the matched button. `BM_CLICK` is
+ *      preferred over a synthesised mouse event — it works even if
+ *      the user is mid-click in another app, and it does not steal
+ *      focus.
+ *
+ * The script writes a single-token result to stdout:
+ *   - `dismissed:<button>` on success
+ *   - `not-found` when no dialog was matched
+ *   - `error:<message>` on an unexpected exception
+ */
+export declare const WINDOWS_DISMISS_PS_SCRIPT: string;
+/**
+ * The AppleScript snippet used for the macOS dismiss path. Exposed as
+ * a string for testability.
+ *
+ * Strategy: iterate every window of the Unity application process and
+ * click the first button titled `Ignore`. If the Unity process is not
+ * running OR no matching button exists, the script reports
+ * `not-found`. Any AppleScript exception (e.g. Accessibility
+ * permission not granted) is reported as `error:<message>` so the
+ * caller can surface it once and continue polling.
+ *
+ * Requires the Terminal / `unity-mcp-cli` binary to have been granted
+ * Accessibility permission in System Settings → Privacy & Security →
+ * Accessibility. Documented in the README.
+ */
+export declare const MACOS_DISMISS_APPLESCRIPT = "\non run\n  try\n    tell application \"System Events\"\n      if not (exists process \"Unity\") then\n        return \"not-found\"\n      end if\n      tell process \"Unity\"\n        repeat with w in windows\n          try\n            if exists (button \"Ignore\" of w) then\n              click button \"Ignore\" of w\n              return \"dismissed:Ignore\"\n            end if\n          end try\n        end repeat\n      end tell\n    end tell\n    return \"not-found\"\n  on error errMsg\n    return \"error:\" & errMsg\n  end try\nend run\n";
+/**
+ * Reset the cached `xdotool` presence flag. Test-only — production
+ * code never needs to call this. Exposed so tests can simulate "the
+ * tool was installed mid-process" without affecting other tests.
+ */
+export declare function _resetXdotoolPresenceForTests(): void;
+/**
+ * Escape a literal string for safe use in `xdotool search --name`.
+ * `xdotool search --name` interprets its argument as a regex; without
+ * escaping, a future fragment containing metacharacters (e.g.
+ * `(Hold On)` or `Compiler Errors v2.0+`) would silently change the
+ * match semantics. The current fragments are regex-safe but this
+ * helper is defensive and zero-runtime-cost.
+ *
+ * Exposed for tests so the regex-safety contract is locked down.
+ */
+export declare function regexEscapeForXdotool(s: string): string;
+/**
+ * Parse the single-token contract every platform-specific dispatcher
+ * writes to stdout. Exposed for tests so we can exhaustively cover
+ * the parser without invoking PowerShell / osascript / xdotool.
+ *
+ * Inspects the LAST non-empty line of stdout, not the whole buffer:
+ * a stray PowerShell warning, `osascript` deprecation notice, or
+ * `xdotool` chatter printed before the contract token must not
+ * misclassify the result as `not-found`.
+ *
+ * Contract:
+ *   - `dismissed:<button>` → `{ kind: 'dismissed', button }`
+ *   - `not-found`          → `{ kind: 'not-found' }`
+ *   - `error:<message>`    → `{ kind: 'error', message }`
+ *   - any other / empty    → `{ kind: 'not-found' }` (defensive — a
+ *     transient parse miss is treated as "not yet visible" rather
+ *     than aborting the polling loop)
+ */
+export declare function parseDismissOutput(stdout: string): DismissOutcome;