unity-open-mcp 1.2.3 → 1.3.0

package/dist/cli/update-command.js

@@ -0,0 +1,271 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { dirname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { isRecord } from "./json-guards.js";
+import { PACKAGE_NAME, compareSemver, resolveLatestVersion, } from "../release-lookup.js";
+// The release lookups live in `release-lookup.ts` (shared with the
+// `unity_open_mcp_upgrade` route); re-exported so this command stays the one
+// entry point existing importers know.
+export { compareSemver, resolveLatestVersion } from "../release-lookup.js";
+const execFileAsync = promisify(execFile);
+export const UPDATE_EXIT = {
+    AVAILABLE: 10,
+    LOOKUP_FAILED: 11,
+    INSTALL_FAILED: 12,
+};
+const defaultDependencies = {
+    fetch: globalThis.fetch.bind(globalThis),
+    runProcess: async (command, args, cwd) => {
+        try {
+            const result = await execFileAsync(command, args, {
+                cwd,
+                encoding: "utf8",
+                maxBuffer: 4 * 1024 * 1024,
+                // `npm` is `npm.cmd` on Windows, which Node can only start through
+                // the shell (a bare execFile fails with `spawn npm ENOENT`). The
+                // arguments this command passes are fixed literals, so shell
+                // quoting is not a concern.
+                shell: process.platform === "win32",
+                windowsHide: true,
+            });
+            return { exitCode: 0, stdout: result.stdout, stderr: result.stderr };
+        }
+        catch (error) {
+            const failed = error;
+            return {
+                exitCode: typeof failed.code === "number" ? failed.code : 1,
+                stdout: failed.stdout ?? "",
+                stderr: failed.stderr ?? failed.message,
+            };
+        }
+    },
+    env: process.env,
+    packageRoot: resolve(dirname(fileURLToPath(import.meta.url)), "../.."),
+    cwd: process.cwd(),
+    readTextFile: (path) => readFile(path, "utf8"),
+};
+export async function runUpdateCommand(options) {
+    const deps = { ...defaultDependencies, ...options.dependencies };
+    let latest;
+    try {
+        latest = await resolveLatestVersion(deps.fetch);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            exitCode: UPDATE_EXIT.LOOKUP_FAILED,
+            json: {
+                command: "update",
+                check: options.check,
+                currentVersion: options.currentVersion,
+                status: "lookup_failed",
+                error: { code: "update_lookup_failed", message },
+            },
+            human: `Could not check for updates: ${message}\n` +
+                "No files were changed. Retry when npm or GitHub is reachable.",
+            errorLabel: "update_lookup_failed",
+        };
+    }
+    const comparison = compareSemver(latest.version, options.currentVersion);
+    if (comparison === null) {
+        const message = `Cannot compare installed version '${options.currentVersion}' with ` +
+            `published version '${latest.version}'.`;
+        return {
+            exitCode: UPDATE_EXIT.LOOKUP_FAILED,
+            json: {
+                command: "update",
+                check: options.check,
+                currentVersion: options.currentVersion,
+                latestVersion: latest.version,
+                source: latest.source,
+                status: "lookup_failed",
+                error: { code: "invalid_update_version", message },
+            },
+            human: `${message}\nNo files were changed.`,
+            errorLabel: "invalid_update_version",
+        };
+    }
+    const available = comparison > 0;
+    if (options.check) {
+        const status = available ? "update_available" : "up_to_date";
+        return {
+            exitCode: available ? UPDATE_EXIT.AVAILABLE : 0,
+            json: {
+                command: "update",
+                check: options.check,
+                currentVersion: options.currentVersion,
+                latestVersion: latest.version,
+                source: latest.source,
+                status,
+                updateAvailable: available,
+                fallbackReason: latest.fallbackReason,
+            },
+            human: available
+                ? `Update available: ${options.currentVersion} → ${latest.version} (${latest.source}).`
+                : `unity-open-mcp ${options.currentVersion} is up to date (${latest.source}).`,
+        };
+    }
+    if (!available) {
+        return {
+            exitCode: 0,
+            json: {
+                command: "update",
+                check: false,
+                currentVersion: options.currentVersion,
+                latestVersion: latest.version,
+                source: latest.source,
+                status: "up_to_date",
+                updateAvailable: false,
+                fallbackReason: latest.fallbackReason,
+                scope: "mcp_server_only",
+            },
+            human: [
+                `unity-open-mcp ${options.currentVersion} is up to date (${latest.source}).`,
+                projectUpdateGuidance(),
+            ].join("\n"),
+        };
+    }
+    const target = await detectInstallTarget(deps);
+    if (target.mode === "npx" || target.mode === "unknown") {
+        const invocation = `npx -y ${PACKAGE_NAME}@latest update --check`;
+        const reason = target.mode === "npx"
+            ? "This process is running from npx's cache, which cannot safely replace itself."
+            : "The active package is not an npm global or project-local install.";
+        return {
+            exitCode: 0,
+            json: {
+                command: "update",
+                check: false,
+                currentVersion: options.currentVersion,
+                latestVersion: latest.version,
+                source: latest.source,
+                status: "guidance",
+                updateAvailable: true,
+                installMode: target.mode,
+                applied: false,
+                nextCommand: invocation,
+            },
+            human: [
+                `Update available: ${options.currentVersion} → ${latest.version} (${latest.source}).`,
+                reason,
+                `Change the MCP client pin to ${PACKAGE_NAME}@${latest.version}, or verify the latest release with:`,
+                `  ${invocation}`,
+                projectUpdateGuidance(),
+            ].join("\n"),
+        };
+    }
+    const args = target.mode === "global"
+        ? ["install", "--global", `${PACKAGE_NAME}@${latest.version}`]
+        : ["install", `${PACKAGE_NAME}@${latest.version}`];
+    const install = await deps.runProcess("npm", args, target.cwd);
+    if (install.exitCode !== 0) {
+        const detail = lastNonEmptyLine(install.stderr) || "npm exited non-zero";
+        return {
+            exitCode: UPDATE_EXIT.INSTALL_FAILED,
+            json: {
+                command: "update",
+                check: false,
+                currentVersion: options.currentVersion,
+                latestVersion: latest.version,
+                source: latest.source,
+                status: "install_failed",
+                installMode: target.mode,
+                applied: false,
+                error: { code: "update_install_failed", message: detail },
+            },
+            human: `npm could not update ${PACKAGE_NAME} to ${latest.version}: ${detail}\n` +
+                "No Unity project or MCP client configuration was changed.",
+            errorLabel: "update_install_failed",
+        };
+    }
+    return {
+        exitCode: 0,
+        json: {
+            command: "update",
+            check: false,
+            currentVersion: options.currentVersion,
+            latestVersion: latest.version,
+            source: latest.source,
+            status: "updated",
+            installMode: target.mode,
+            applied: true,
+        },
+        human: [
+            `Updated ${PACKAGE_NAME}: ${options.currentVersion} → ${latest.version} (${target.mode} npm install).`,
+            "Restart the MCP client so it launches the new server.",
+            projectUpdateGuidance(),
+        ].join("\n"),
+    };
+}
+async function detectInstallTarget(deps) {
+    // Comparisons run on a lower-cased copy, but any path handed back to npm
+    // (the local install's cwd) must keep the on-disk casing: case-sensitive
+    // filesystems reject a lower-cased directory with ENOENT.
+    const forwardRoot = forwardSlashes(deps.packageRoot);
+    const normalizedRoot = forwardRoot.toLowerCase();
+    if (deps.env.npm_command === "exec" ||
+        deps.env.npm_lifecycle_event === "npx" ||
+        normalizedRoot.includes("/_npx/")) {
+        return { mode: "npx" };
+    }
+    const globalRoot = await deps.runProcess("npm", ["root", "--global"]);
+    if (globalRoot.exitCode === 0) {
+        const normalizedGlobal = normalizePath(globalRoot.stdout.trim());
+        if (normalizedGlobal && isWithin(normalizedRoot, normalizedGlobal)) {
+            return { mode: "global" };
+        }
+    }
+    // A project-local install is only certain when the owning package.json
+    // declares this package. Without that check a global install whose
+    // `npm root -g` probe failed would be mistaken for a local one and npm
+    // would be run inside the global lib directory.
+    const markerIndex = forwardRoot.search(/\/node_modules\//i);
+    if (markerIndex > 0) {
+        const owner = denormalizePath(forwardRoot.slice(0, markerIndex));
+        if (await declaresDependency(deps, owner)) {
+            return { mode: "local", cwd: owner };
+        }
+    }
+    return { mode: "unknown", cwd: deps.cwd };
+}
+async function declaresDependency(deps, projectDir) {
+    try {
+        const manifest = JSON.parse(await deps.readTextFile(join(projectDir, "package.json")));
+        if (!isRecord(manifest))
+            return false;
+        return ["dependencies", "devDependencies", "optionalDependencies"].some((field) => {
+            const section = manifest[field];
+            return isRecord(section) && typeof section[PACKAGE_NAME] === "string";
+        });
+    }
+    catch {
+        return false;
+    }
+}
+function projectUpdateGuidance() {
+    return ("This command updates only the MCP server. Next, update both Unity packages and client pins " +
+        "from the bridge window's Updates section (or use the setup wizard/manual package path), " +
+        "then run `unity-open-mcp ping` or `unity-open-mcp status` to confirm versions.");
+}
+function forwardSlashes(path) {
+    return path.replaceAll("\\", "/").replace(/\/$/, "");
+}
+function normalizePath(path) {
+    return forwardSlashes(path).toLowerCase();
+}
+function denormalizePath(path) {
+    return sep === "\\" ? path.replaceAll("/", "\\") : path;
+}
+function isWithin(candidate, parent) {
+    return candidate === parent || candidate.startsWith(`${parent}/`);
+}
+function lastNonEmptyLine(value) {
+    return (value
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .at(-1) ?? "");
+}
+//# sourceMappingURL=update-command.js.map

package/dist/cli/update-command.js.map

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

package/dist/compile-verify.d.ts

@@ -8,6 +8,9 @@
 export interface CompileVerifySnapshot {
     /** Count of tools the bridge compiled in, or undefined when unreachable. */
     bridgeToolCount?: number;
+    compileGeneration?: number;
+    compileStatus?: string;
+    sourceMatches?: boolean;
     /**
      * Newest mtime (epoch ms) of Library/ScriptAssemblies/*.dll, or undefined.
      * Captured from the MCP server side via fs.statSync.

package/dist/compile-verify.js

@@ -55,6 +55,10 @@ export const COMPILE_VERIFY_RECOMMENDATIONS = {
  */
 export function detectCompileVerify(input) {
     const { before, after, sourceMtimeMs } = input;
+    // A completed generation with identical input content can legitimately retain DLL mtimes.
+    if (after.sourceMatches === true || after.compileStatus === "currently_compiling") {
+        return { code: null, recommendation: null };
+    }
     // 1. dll_stale — highest confidence: the DLL is provably older than the edit.
     if (sourceMtimeMs !== undefined &&
         after.dllMtimeMs !== undefined &&

package/dist/compile-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile-verify.js","sourceRoot":"","sources":["../src/compile-verify.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAC/E,yEAAyE;AACzE,uEAAuE;AACvE,uBAAuB;AACvB,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,0EAA0E;AAC1E,oEAAoE;AACpE,+DAA+D;AAC/D,+EAA+E;AAC/E,wDAAwD;AACxD,EAAE;AACF,wDAAwD;AACxD,2DAA2D;AAC3D,qEAAqE;AACrE,mEAAmE;AAwCnE;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAgD;IACzF,YAAY,EACV,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,gEAAgE;QAChE,oEAAoE;QACpE,0CAA0C;IAC5C,SAAS,EACP,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,oEAAoE;QACpE,mEAAmE;QACnE,qBAAqB;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAE/C,8EAA8E;IAC9E,IACE,aAAa,KAAK,SAAS;QAC3B,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,KAAK,CAAC,UAAU,GAAG,aAAa,EAChC,CAAC;QACD,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,cAAc,EAAE,8BAA8B,CAAC,SAAS;SACzD,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,uCAAuC;IACvC,MAAM,cAAc,GAClB,MAAM,CAAC,eAAe,KAAK,SAAS;QACpC,KAAK,CAAC,eAAe,KAAK,SAAS;QACnC,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,CAAC;IACnD,MAAM,gBAAgB,GACpB,MAAM,CAAC,UAAU,KAAK,SAAS;QAC/B,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAExC,IAAI,cAAc,IAAI,gBAAgB,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,cAAc,EAAE,8BAA8B,CAAC,YAAY;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA2B;IAE3B,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"compile-verify.js","sourceRoot":"","sources":["../src/compile-verify.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAC/E,yEAAyE;AACzE,uEAAuE;AACvE,uBAAuB;AACvB,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,0EAA0E;AAC1E,oEAAoE;AACpE,+DAA+D;AAC/D,+EAA+E;AAC/E,wDAAwD;AACxD,EAAE;AACF,wDAAwD;AACxD,2DAA2D;AAC3D,qEAAqE;AACrE,mEAAmE;AA2CnE;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAgD;IACzF,YAAY,EACV,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,gEAAgE;QAChE,oEAAoE;QACpE,0CAA0C;IAC5C,SAAS,EACP,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,oEAAoE;QACpE,mEAAmE;QACnE,qBAAqB;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAE/C,0FAA0F;IAC1F,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,IAAI,KAAK,CAAC,aAAa,KAAK,qBAAqB,EAAE,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,8EAA8E;IAC9E,IACE,aAAa,KAAK,SAAS;QAC3B,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,KAAK,CAAC,UAAU,GAAG,aAAa,EAChC,CAAC;QACD,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,cAAc,EAAE,8BAA8B,CAAC,SAAS;SACzD,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,uCAAuC;IACvC,MAAM,cAAc,GAClB,MAAM,CAAC,eAAe,KAAK,SAAS;QACpC,KAAK,CAAC,eAAe,KAAK,SAAS;QACnC,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,CAAC;IACnD,MAAM,gBAAgB,GACpB,MAAM,CAAC,UAAU,KAAK,SAAS;QAC/B,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAExC,IAAI,cAAc,IAAI,gBAAgB,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,cAAc,EAAE,8BAA8B,CAAC,YAAY;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA2B;IAE3B,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;AACtE,CAAC"}

package/dist/constants.d.ts

@@ -78,7 +78,15 @@ export declare const BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS = 55000;
  * (`packages/bridge/Editor/Bridge/BridgeSession.cs`), which carries the
  * revision log.
  */
-export declare const EXPECTED_BRIDGE_WIRE_CONTRACT = 1;
+export declare const EXPECTED_BRIDGE_WIRE_CONTRACT = 2;
+/**
+ * Request/response header pair for the compile state that qualifies a tool
+ * result (`BridgeCompileState.Header`). Sent as `1` with a tool call, it asks
+ * the bridge to snapshot the state inside that call's own main-thread dispatch
+ * and return it (base64 UTF-8 JSON) under the same name; an older bridge
+ * ignores it, and the server then reads `/compile-state`.
+ */
+export declare const COMPILE_STATE_HEADER = "X-Unity-Open-MCP-Compile-State";
 /**
  * The npm package the MCP server is published as, pinned to the shared
  * trio version (`unity-open-mcp@X.Y.Z`) for the `npx -y` invocation.
@@ -86,7 +94,7 @@ export declare const EXPECTED_BRIDGE_WIRE_CONTRACT = 1;
  * verify packages. Mirrors the C# `BridgeConstants.NpmPackage`. Kept in
  * sync by `scripts/sync-version.mjs`.
  */
-export declare const NPM_PACKAGE = "unity-open-mcp@1.2.3";
+export declare const NPM_PACKAGE = "unity-open-mcp@1.3.0";
 /**
  * Build the bridge base URL for a given port. Centralizes the loopback +
  * scheme so every caller produces the same string.

package/dist/constants.js

@@ -89,7 +89,15 @@ export const BRIDGE_HOST_SAFE_TIMEOUT_CAP_MS = 55_000;
  * (`packages/bridge/Editor/Bridge/BridgeSession.cs`), which carries the
  * revision log.
  */
-export const EXPECTED_BRIDGE_WIRE_CONTRACT = 1;
+export const EXPECTED_BRIDGE_WIRE_CONTRACT = 2;
+/**
+ * Request/response header pair for the compile state that qualifies a tool
+ * result (`BridgeCompileState.Header`). Sent as `1` with a tool call, it asks
+ * the bridge to snapshot the state inside that call's own main-thread dispatch
+ * and return it (base64 UTF-8 JSON) under the same name; an older bridge
+ * ignores it, and the server then reads `/compile-state`.
+ */
+export const COMPILE_STATE_HEADER = "X-Unity-Open-MCP-Compile-State";
 /**
  * The npm package the MCP server is published as, pinned to the shared
  * trio version (`unity-open-mcp@X.Y.Z`) for the `npx -y` invocation.
@@ -97,7 +105,7 @@ export const EXPECTED_BRIDGE_WIRE_CONTRACT = 1;
  * verify packages. Mirrors the C# `BridgeConstants.NpmPackage`. Kept in
  * sync by `scripts/sync-version.mjs`.
  */
-export const NPM_PACKAGE = "unity-open-mcp@1.2.3";
+export const NPM_PACKAGE = "unity-open-mcp@1.3.0";
 /**
  * Build the bridge base URL for a given port. Centralizes the loopback +
  * scheme so every caller produces the same string.

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,SAAS;AAET;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,wCAAwC,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,UAAU,aAAa,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,2CAA2C,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,8CAA8C,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,+CAA+C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,SAAS;AAET;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,wCAAwC,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gCAAgC,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,UAAU,aAAa,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,2CAA2C,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,8CAA8C,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,+CAA+C,CAAC"}

package/dist/dialog-dismiss.d.ts

@@ -72,6 +72,8 @@ export interface DismissProbeOptions {
      * the modal is blocked (audit line, no click) unless this is set.
      */
     allowUnsavedSceneDismiss: boolean;
+    /** Allow continuing through a non-matching Editor warning. Off by default. */
+    allowVersionMismatch: boolean;
     /**
      * M12 — optional abort signal. When fired while a probe is in flight, the
      * underlying `execFile`/`execFileSync` child is killed so the loop can exit
@@ -108,8 +110,9 @@ export declare function tryDismissDialog(opts: DismissProbeOptions): Promise<Dis
  * Strategy:
  *   1. P/Invoke `EnumWindows` to enumerate every visible top-level window
  *      owned by `Unity.exe`.
- *   2. For each, normalize the title (alphanumeric lowercase) and match it
- *      against the embedded per-kind fragment table to classify it.
+ *   2. For each, skip the main Editor window ({@link isUnityEditorWindowTitle}),
+ *      normalize the title (alphanumeric lowercase) and match it against the
+ *      embedded per-kind fragment table to classify it.
  *   3. If the kind is in the blocked list → emit `blocked:<kind>` and skip
  *      the click. If the kind's token list is null → skip (not-found).
  *   4. Walk child windows with `EnumChildWindows`, find a Button whose
@@ -127,25 +130,94 @@ export declare function tryDismissDialog(opts: DismissProbeOptions): Promise<Dis
  * The token table is passed via stdin (one JSON blob) so the script body
  * stays constant and testable; embedding it inline would bloat the assertion.
  */
-export declare const WINDOWS_DISMISS_PS_SCRIPT = "\n$ErrorActionPreference = 'Stop'\ntry {\n  if (-not ([System.Management.Automation.PSTypeName]'UnityOpenMcp.Dialogs.Dismisser').Type) {\n    Add-Type -TypeDefinition @\"\nusing System;\nusing System.Collections.Generic;\nusing System.Runtime.InteropServices;\nusing System.Text;\nnamespace UnityOpenMcp.Dialogs {\n  public static class Dismisser {\n    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);\n    [DllImport(\"user32.dll\")] static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern int GetWindowTextW(IntPtr hWnd, StringBuilder lpString, int nMaxCount);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern int GetClassNameW(IntPtr hWnd, StringBuilder lpClassName, int nMaxCount);\n    [DllImport(\"user32.dll\")] static extern bool IsWindowVisible(IntPtr hWnd);\n    [DllImport(\"user32.dll\")] static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);\n    [DllImport(\"user32.dll\")] static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern IntPtr SendMessageW(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);\n    const uint BM_CLICK = 0x00F5;\n    static string Norm(string s) {\n      var sb = new StringBuilder(s.Length);\n      foreach (var ch in s) {\n        if ((ch >= '0' && ch <= '9') || (ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z')) {\n          sb.Append(char.ToLowerInvariant(ch));\n        }\n      }\n      return sb.ToString();\n    }\n    public static string TryDismiss(int[] unityPids, string tableJson) {\n      var unityPidSet = new HashSet<uint>();\n      for (int i = 0; i < unityPids.Length; i++) unityPidSet.Add((uint)unityPids[i]);\n      var table = System.Text.Json.JsonSerializer.Deserialize<Types.Table>(tableJson);\n      var candidates = new List<IntPtr>();\n      var sb = new StringBuilder(512);\n      EnumWindows((hWnd, lParam) => {\n        if (!IsWindowVisible(hWnd)) return true;\n        uint procId; GetWindowThreadProcessId(hWnd, out procId);\n        if (!unityPidSet.Contains(procId)) return true;\n        sb.Length = 0;\n        GetWindowTextW(hWnd, sb, sb.Capacity);\n        candidates.Add(hWnd);\n        return true;\n      }, IntPtr.Zero);\n      foreach (var hWnd in candidates) {\n        sb.Length = 0;\n        GetWindowTextW(hWnd, sb, sb.Capacity);\n        var title = sb.ToString();\n        var norm = Norm(title);\n        string kind = null;\n        foreach (var kv in table.kinds) {\n          foreach (var frag in kv.Value.fragments) {\n            if (norm.Contains(frag)) { kind = kv.Key; break; }\n          }\n          if (kind != null) break;\n        }\n        string[] tokens = null;\n        if (kind != null) {\n          if (table.blocked.Contains(kind)) return \"blocked:\" + kind;\n          if (!table.kinds[kind].tokensSpecified) continue;\n          tokens = table.kinds[kind].tokens;\n        } else {\n          if (table.genericTokens.Length == 0) continue;\n          tokens = table.genericTokens;\n        }\n        IntPtr matchedButton = IntPtr.Zero;\n        string matchedText = null;\n        EnumChildWindows(hWnd, (hChild, lParam) => {\n          sb.Length = 0;\n          GetClassNameW(hChild, sb, sb.Capacity);\n          if (sb.ToString() != \"Button\") return true;\n          sb.Length = 0;\n          GetWindowTextW(hChild, sb, sb.Capacity);\n          var text = sb.ToString();\n          var textNorm = Norm(text);\n          foreach (var token in tokens) {\n            if (textNorm.Contains(token)) { matchedButton = hChild; matchedText = text; return false; }\n          }\n          return true;\n        }, IntPtr.Zero);\n        if (matchedButton == IntPtr.Zero) continue;\n        SendMessageW(matchedButton, BM_CLICK, IntPtr.Zero, IntPtr.Zero);\n        return \"dismissed:\" + matchedText + \":\" + (kind ?? \"unknown\");\n      }\n      return \"not-found\";\n    }\n  }\n}\n\"@\n  }\n  $unityPids = @(Get-Process -Name 'Unity' -ErrorAction SilentlyContinue | ForEach-Object { [int]$_.Id })\n  if ($unityPids.Count -eq 0) { Write-Output 'not-found'; return }\n  $tableJson = [Console]::In.ReadToEnd();\n  Write-Output ([UnityOpenMcp.Dialogs.Dismisser]::TryDismiss([int[]]$unityPids, $tableJson))\n} catch {\n  Write-Output ('error:' + $_.Exception.Message)\n}\n";
+export declare const WINDOWS_DISMISS_PS_SCRIPT = "\n$ErrorActionPreference = 'Stop'\ntry {\n  if (-not ([System.Management.Automation.PSTypeName]'UnityOpenMcp.Dialogs.Dismisser').Type) {\n    Add-Type -TypeDefinition @\"\nusing System;\nusing System.Collections.Generic;\nusing System.Runtime.InteropServices;\nusing System.Text;\nnamespace UnityOpenMcp.Dialogs {\n  public static class Dismisser {\n    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);\n    [DllImport(\"user32.dll\")] static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern int GetWindowTextW(IntPtr hWnd, StringBuilder lpString, int nMaxCount);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern int GetClassNameW(IntPtr hWnd, StringBuilder lpClassName, int nMaxCount);\n    [DllImport(\"user32.dll\")] static extern bool IsWindowVisible(IntPtr hWnd);\n    [DllImport(\"user32.dll\")] static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);\n    [DllImport(\"user32.dll\")] static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);\n    [DllImport(\"user32.dll\", CharSet=CharSet.Unicode)] static extern IntPtr SendMessageW(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);\n    const uint BM_CLICK = 0x00F5;\n    static string Norm(string s) {\n      var sb = new StringBuilder(s.Length);\n      foreach (var ch in s) {\n        if ((ch >= '0' && ch <= '9') || (ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z')) {\n          sb.Append(char.ToLowerInvariant(ch));\n        }\n      }\n      return sb.ToString();\n    }\n    public static string TryDismiss(int[] unityPids, string tableJson) {\n      var unityPidSet = new HashSet<uint>();\n      for (int i = 0; i < unityPids.Length; i++) unityPidSet.Add((uint)unityPids[i]);\n      var table = System.Text.Json.JsonSerializer.Deserialize<Types.Table>(tableJson);\n      var candidates = new List<IntPtr>();\n      var sb = new StringBuilder(512);\n      EnumWindows((hWnd, lParam) => {\n        if (!IsWindowVisible(hWnd)) return true;\n        uint procId; GetWindowThreadProcessId(hWnd, out procId);\n        if (!unityPidSet.Contains(procId)) return true;\n        sb.Length = 0;\n        GetWindowTextW(hWnd, sb, sb.Capacity);\n        candidates.Add(hWnd);\n        return true;\n      }, IntPtr.Zero);\n      foreach (var hWnd in candidates) {\n        sb.Length = 0;\n        GetWindowTextW(hWnd, sb, sb.Capacity);\n        var title = sb.ToString();\n        // The main Editor window title embeds project/scene names; never classify it.\n        if (title.IndexOf(\" - Unity \", StringComparison.OrdinalIgnoreCase) >= 0) continue;\n        var norm = Norm(title);\n        string kind = null;\n        foreach (var kv in table.kinds) {\n          foreach (var frag in kv.Value.fragments) {\n            if (norm.Contains(frag)) { kind = kv.Key; break; }\n          }\n          if (kind != null) break;\n        }\n        string[] tokens = null;\n        if (kind != null) {\n          if (table.blocked.Contains(kind)) return \"blocked:\" + kind;\n          if (!table.kinds[kind].tokensSpecified) continue;\n          tokens = table.kinds[kind].tokens;\n        } else {\n          if (table.genericTokens.Length == 0) continue;\n          tokens = table.genericTokens;\n        }\n        IntPtr matchedButton = IntPtr.Zero;\n        string matchedText = null;\n        EnumChildWindows(hWnd, (hChild, lParam) => {\n          sb.Length = 0;\n          GetClassNameW(hChild, sb, sb.Capacity);\n          if (sb.ToString() != \"Button\") return true;\n          sb.Length = 0;\n          GetWindowTextW(hChild, sb, sb.Capacity);\n          var text = sb.ToString();\n          var textNorm = Norm(text);\n          foreach (var token in tokens) {\n            if (textNorm.Contains(token)) { matchedButton = hChild; matchedText = text; return false; }\n          }\n          return true;\n        }, IntPtr.Zero);\n        if (matchedButton == IntPtr.Zero) continue;\n        SendMessageW(matchedButton, BM_CLICK, IntPtr.Zero, IntPtr.Zero);\n        return \"dismissed:\" + matchedText + \":\" + (kind ?? \"unknown\");\n      }\n      return \"not-found\";\n    }\n  }\n}\n\"@\n  }\n  $unityPids = @(Get-Process -Name 'Unity' -ErrorAction SilentlyContinue | ForEach-Object { [int]$_.Id })\n  if ($unityPids.Count -eq 0) { Write-Output 'not-found'; return }\n  $tableJson = [Console]::In.ReadToEnd();\n  Write-Output ([UnityOpenMcp.Dialogs.Dismisser]::TryDismiss([int[]]$unityPids, $tableJson))\n} catch {\n  Write-Output ('error:' + $_.Exception.Message)\n}\n";
 /**
  * The AppleScript template used for the macOS dismiss path. Exposed as a
- * function of the token table so tests can assert the script shape without
+ * function of the probe options so tests can assert the script shape without
  * launching osascript.
  *
- * Strategy: iterate every window of the Unity process, normalize its title,
- * classify it against the table, and click the first button whose normalized
- * label contains a policy token. If the kind is blocked, emit `blocked:<kind>`
- * without clicking. If Unity 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:<msg>`.
+ * Strategy: iterate every window of the Unity process except the main Editor
+ * window (its title contains {@link UNITY_EDITOR_WINDOW_TITLE_MARKER}),
+ * classify it by its title normalized with `normLabel` (see
+ * {@link macosTitleMatch}), and act per kind as {@link focusDialogAction}
+ * decides from the shared policy table (see {@link macosDialogKindBlock}):
+ *
+ *   - `focus`   — the policy picks the kind's focused/default button
+ *                 ({@link DIALOG_FOCUSED_BUTTON_TOKENS}): press Return, but
+ *                 only when the window shows a button with that label.
+ *   - `named`   — the policy picks another button (e.g. Enter Safe Mode, or
+ *                 Quit/Cancel under `cancel`): click the first button whose
+ *                 normalized title equals a policy token, in priority order,
+ *                 or report `blocked:<kind>` when none is found. Return is
+ *                 never pressed, because it would click the focused button.
+ *   - `blocked` — the policy blocks the kind: report `blocked:<kind>`.
+ *   - `skip`    — the policy declines the kind: no block; the window falls
+ *                 through to `not-found` so polling continues.
+ *
+ * Project Upgrade is always reported as `blocked` (never clicked), and
+ * unsaved scene changes have their own named-button block behind the opt-in.
+ * If Unity is not running or nothing matches, the script reports `not-found`.
+ * Any AppleScript exception (e.g. Accessibility permission not granted) is
+ * reported as `error:<msg>`.
  *
  * Requires the Terminal / `node` binary to have been granted Accessibility
  * permission in System Settings → Privacy & Security → Accessibility.
- *
- * The token table is JSON-escaped into the script header.
  */
 export declare function macosDismissAppleScript(opts: DismissProbeOptions): string;
+/**
+ * AppleScript mirror of {@link normalizeDialogLabel}: keep ASCII letters and
+ * digits only. AppleScript string comparison (`is`, `contains`) ignores case
+ * by default, so the handler does not lowercase. Exported for tests.
+ */
+export declare const MACOS_NORM_LABEL_HANDLER = "\n-- Mirror of normalizeDialogLabel: keep ASCII letters and digits only.\n-- (String comparison is case-insensitive by default, so no lowercasing.)\non normLabel(s)\n  set out to \"\"\n  repeat with c in (characters of s)\n    set ch to contents of c\n    set cid to id of ch\n    -- \"id of\" yields a LIST for a character made of several code points\n    -- (decomposed accents, emoji); comparing a list numerically would raise\n    -- and abort the whole probe, so such characters are simply dropped.\n    if class of cid is integer then\n      if (cid >= 48 and cid <= 57) or (cid >= 65 and cid <= 90) or (cid >= 97 and cid <= 122) then set out to out & ch\n    end if\n  end repeat\n  return out\nend normLabel\n";
+/**
+ * How a focus-driven platform (macOS AppleScript, Linux xdotool) may act on a
+ * dialog of the given kind under the active policy. Derived from the shared
+ * policy table so every platform agrees:
+ *
+ *   - `blocked` — the policy blocks the kind (e.g. Project Upgrade without its
+ *                 opt-in). Report `blocked:<kind>`, never click.
+ *   - `skip`    — the policy declines the kind (no preference tokens). Do
+ *                 nothing; try the next kind.
+ *   - `focus`   — the policy's first choice is the kind's focused button
+ *                 ({@link DIALOG_FOCUSED_BUTTON_TOKENS}): pressing Return is
+ *                 safe.
+ *   - `named`   — the policy's first choice is some other button (e.g. Enter
+ *                 Safe Mode, Quit, Cancel). Return would press the focused
+ *                 button instead, so only a named-button click may act.
+ *
+ * Pure; exported for tests.
+ */
+export declare function focusDialogAction(kind: DialogKind, opts: Pick<DismissProbeOptions, "policy" | "allowProjectUpgrade" | "allowUnsavedSceneDismiss" | "allowVersionMismatch">): "blocked" | "skip" | "focus" | "named";
+/**
+ * AppleScript title condition per focus-classified kind, over `wn` — the
+ * window title normalized by `normLabel`. The fragments are normalized
+ * (letters and digits only), and AppleScript `contains` ignores case but not
+ * spaces or punctuation, so matching the raw title would never fire
+ * (`"Enter Safe Mode?" contains "safemode"` is false). Non-Matching Editor
+ * matches the short `nonmatchingeditor` stem so both the hyphenated and the
+ * spaced spelling qualify. Exported for tests.
+ */
+export declare function macosTitleMatch(kind: DialogKind): string;
+/**
+ * AppleScript block for one dialog kind inside the window loop (`w` / `wt`),
+ * shaped by {@link focusDialogAction}:
+ *
+ *   - `blocked` → `blocked:<kind>` when the title matches.
+ *   - `skip`    → a comment only; the window falls through.
+ *   - `focus`   → press Return on the focused button, when the window has a
+ *                 button whose normalized title equals the kind's focused
+ *                 token; otherwise fall through (no press).
+ *   - `named`   → for each policy token in priority order, click the first
+ *                 button whose normalized title equals it; if none matches,
+ *                 report `blocked:<kind>`. Never presses Return.
+ *
+ * Exact normalized equality (not substring) keeps a short token such as `no`
+ * from matching an unrelated label such as "Ignore".
+ *
+ * Pure; exported for tests.
+ */
+export declare function macosDialogKindBlock(kind: DialogKind, opts: Pick<DismissProbeOptions, "policy" | "allowProjectUpgrade" | "allowUnsavedSceneDismiss" | "allowVersionMismatch">): string;
 /**
  * Reset the cached `xdotool` presence flag. Test-only — production code
  * never needs to call this.
@@ -157,6 +229,26 @@ export declare function _resetXdotoolPresenceForTests(): void;
  * containing metacharacters would silently change the match semantics.
  */
 export declare function regexEscapeForXdotool(s: string): string;
+/**
+ * The `xdotool search --name` pattern for a normalized title fragment.
+ * Fragments are letters and digits only ("entersafemode"), while real titles
+ * carry spaces and punctuation ("Enter Safe Mode?"), so the pattern allows any
+ * run of non-alphanumerics between consecutive characters and spells each
+ * letter in both cases. That is the regex form of "the normalized title
+ * contains the fragment" and does not depend on xdotool's case handling.
+ * Any other character is escaped literally.
+ */
+export declare function xdotoolTitlePattern(fragment: string): string;
+/**
+ * What the Linux/X11 path does with a Unity-owned window of the given kind:
+ * {@link focusDialogAction} with `named` folded into `blocked`, because
+ * xdotool can only press Return on the focused (default) button — it cannot
+ * click a named one (e.g. `cancel` on the Safe Mode prompt, whose focused
+ * button is Ignore, is reported as blocked for a human).
+ *
+ * Pure; exported for tests.
+ */
+export declare function linuxFocusAction(kind: DialogKind, opts: Pick<DismissProbeOptions, "policy" | "allowProjectUpgrade" | "allowUnsavedSceneDismiss" | "allowVersionMismatch">): "blocked" | "skip" | "focus";
 /**
  * Parse the single-token contract every platform-specific dispatcher writes
  * to stdout. Inspects the LAST non-empty line of stdout, not the whole
@@ -206,6 +298,8 @@ export declare function armSigkillEscalation(child: {
  *   - `UNITY_OPEN_MCP_ALLOW_UNSAVED_SCENE_DISMISS=1` opts in to auto-dismissing
  *     the "Unsaved changes to scene" modal (destructive under every policy —
  *     off by default). See isUnsavedSceneBlocked.
+ *   - `UNITY_OPEN_MCP_ALLOW_VERSION_MISMATCH=1` opts in to opening a project
+ *     with a different Unity Editor version. Without it the dialog is blocked.
  *   - `UNITY_OPEN_MCP_DISMISS_TIMEOUT_MS` overrides the overall timeout.
  *   - `UNITY_OPEN_MCP_DISMISS_INTERVAL_MS` overrides the poll interval.
  *
@@ -219,6 +313,7 @@ export interface DismissConfig {
     policy: DialogPolicy;
     allowProjectUpgrade: boolean;
     allowUnsavedSceneDismiss: boolean;
+    allowVersionMismatch: boolean;
 }
 export declare function readDismissConfig(env?: NodeJS.ProcessEnv): DismissConfig;
 /**
@@ -233,6 +328,7 @@ export interface PollAndDismissOptions {
     policy: DialogPolicy;
     allowProjectUpgrade: boolean;
     allowUnsavedSceneDismiss: boolean;
+    allowVersionMismatch: boolean;
     /**
      * Override the platform — exposed for tests so the polling logic can be
      * exercised across all three OS branches without hopping process.platform.