@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

package/lib/host/controller/state.d.ts

@@ -4,26 +4,37 @@
  *
  * The public half (`createChromeMcpController`, `ChromeMcpController`,
  * `ChromeMcpControllerDeps`) lives in ./controller.ts; the behavior it wires
- * together is split across the sibling modules here (`notes`, `bridge-run`,
+ * together is split across the sibling modules here (`notes`, `connections`,
  * `runs`, `windows-run`, `persist`, `captures`, `commits`). This file names the
- * state those helpers share — every base-layer mutation targets `state.entry`,
- * every run reads its source through `state.source`, and the immutable context
- * pieces a method needs to act on (the row config, the WSL answer, the injected
- * Windows run) sit alongside it. Nothing here is part of the public surface.
+ * state those helpers share — every live answer targets `state.live` and reaches
+ * the card through `publishLive`, every layer read goes through `state.source`,
+ * and the immutable context pieces a method needs to act on (the row config, the
+ * WSL answer, the injected Windows run, the manager's connection service) sit
+ * alongside it. Nothing here is part of the public surface.
  */
-import type { BridgeStderrMode, ChromeMcpConfig, ChromeExecutableEntry, EffectiveChromeSource, McpBridge, PluginContext, SettingsResolved, WindowsChromeRun } from "../types/index.js";
+import type { BridgeStderrMode, ChromeMcpConfig, ChromeExecutableEntry, ConfigLayers, ConfigLiveFields, ChromeMcpForm, EffectiveChromeSource, PluginContext, WindowsChromeRun } from "../types/index.js";
 import type { WindowsChromeRunOptions } from "../windows/index.js";
+import type { LiveMirror } from "@comecaramelos/dsh-ancesters/host";
+import type { McpConnectionsService } from "@comecaramelos/dsh-mcp-manager/api";
+import type { RunningAnswers } from "./connections.js";
 /** The live state one controller instance owns and mutates. */
 export interface ControllerState {
-    /** The composition base layer served alongside the user layer. */
-    entry: SettingsResolved;
-    /** The live resolved settings source (swapped by the installSection hook). */
-    source: () => SettingsResolved;
-    /** Flags the nested bridge currently launches with. */
+    /** The live mirror — what every Host answer carries, published through the
+     * volatile references on every change batch, never persisted. */
+    live: ConfigLiveFields;
+    /** The configuration form once it is attached (undefined until the settings
+     * service resolves and the row's entry id is known). */
+    form: ChromeMcpForm | undefined;
+    /** Read the form's layers (the user layer over the row config). Swapped when
+     * the form attaches; before that the references answer alone. */
+    source: () => ConfigLayers;
+    /** Flags the default answers run with — what a connection with no own
+     * `extra` answer is answered with. Mirrored from the last resolve, so what
+     * the machine page states is what is running, not what was last configured. */
     runningFlags: string[];
-    /** Effective bridge stderr mode ("log"/"console"). */
+    /** Effective console-output mode of the default answer ("log"/"console"). */
     runningStderrMode: BridgeStderrMode;
-    /** Executable the bridge actually launches with. */
+    /** Executable the default answer launches with. */
     runningChromePath: string;
     /** Where that executable came from. */
     runningChromeSource: EffectiveChromeSource;
@@ -41,30 +52,121 @@ export interface ControllerState {
     seenUserSelection: boolean;
     /** Serializes runs so rapid actions never interleave. */
     runs: Promise<unknown>;
+    /**
+     * One bounded retry of a FAILED executable run. The run chain answers once
+     * per queue and never re-tries on its own — a host that answers empty (the
+     * shape a WSL boot takes while the interop mount is not served yet) would
+     * read "not found" until someone pressed Fetch. So a failing run arms
+     * **one** retry behind `DISCOVERY_RETRY_DELAY_MS`, capped across the
+     * instance at `DISCOVERY_RETRY_MAX`, and any run that no longer stands
+     * failed resets the count. Cancelled when the instance is disposed.
+     */
+    retryTimer: NodeJS.Timeout | undefined;
+    /** Consecutive scheduled retries after failed runs; reset on a non-failed
+     * run. */
+    retriesPending: number;
+    /** Set once this instance is disposed: a late retry answer must not fire
+     * runs for an instance that no longer exists. */
+    disposed: boolean;
     /** Whether the WSL + Windows-executable warning has been logged already. */
     wslNoticeShown: boolean;
     /** Whether the workspace `.chrome` view "kept" notice has been logged. */
     profileLinkKeptShown: boolean;
     /** Whether the legacy hand-typed MRU has been folded into the rows already. */
     legacyPathsMerged: boolean;
+    /** Whether the row config's legacy `--executablePath` fold has been announced
+     * already (one warn line, however often the layers churn). */
+    legacyPinAnnounced: boolean;
+    /** The live mirror (ancestros' `createLiveMirror`), stood up on the first
+     * publish. */
+    mirror: LiveMirror | undefined;
+    /** Set while one coalesced "kinds changed" notice is already queued. */
+    kindsNotifyQueued: boolean;
+    /** The manager's `mcpConnections` service while the manager runs it (see
+     * ../manager.ts). Undefined when no manager stands behind this row — the
+     * component then answers the row's own page and starts nothing. */
+    connections: McpConnectionsService | undefined;
+    /** Says "what a picker would answer just moved" (./../manager.ts installs
+     * the real half); a no-op until then. */
+    notifyKindsChanged: () => void;
 }
-/** Everything a controller method needs: the immutable context + the state. */
+/** Everything a controller method needs: the immutable context + the state.
+ * `ChromeMcpController` is this same type — the public surface is the object
+ * itself, and every consumer (the form, the commands, the kinds) works through
+ * one and the same instance. */
 export interface Controller {
     ctx: PluginContext;
+    /** The config `apply` validated. Every `.volatile()` field here is a
+     * reference, not a value — read them through `readConfigField`. */
     config: ChromeMcpConfig;
     /** True on a WSL host (where the Windows run is the only working path). */
     wslHost: boolean;
+    /** True on a Linux host. The candidate list models the stable-channel
+     * installs a Linux host carries, so the executable-missing answer's advice
+     * keys on this (see `runs.ts`); WSL is the case with the Windows-side
+     * alternative next to it. */
+    linuxHost: boolean;
     /** A path this host must never exec (a Windows binary under WSL). */
     blockedForPlatform: (candidate: string) => string;
-    /** The row-config executable source ("" = unset). */
-    rowChromePath: string;
-    /** The row-config extra flags, executable-path flag folded out. */
-    rowFlags: string[];
+    /** The `DSH_CHROME_MCP_FLAGS` answer from the launch environment (anything
+     * the caller did not supply is "no answer"). */
+    launchFlags: unknown;
     /** The Windows run half — injected by tests, the real one otherwise. */
     windowsChrome: (options: WindowsChromeRunOptions) => Promise<WindowsChromeRun>;
-    /** The nested bridge fiber, driven by every flag/executable/stderr switch. */
-    bridge: McpBridge;
+    /** The Windows-side executables this host carries, in preference order and
+     * in their Windows spelling — located through the interop mount, `[]` off
+     * WSL. A run folds them into its candidate list (they are never probed: a
+     * Windows binary answers `note`, never a version) so the picker can name the
+     * executable a run drives instead of hiding it. */
+    windowsExecutables: () => string[];
     /** The live mutable state. */
     state: ControllerState;
+    /** Bind the configuration form to this controller (the first call also serves
+     * as the mount's first read, so the registration run fires off the first
+     * commit's nonce diffs instead of being called separately). */
+    attachForm(form: ChromeMcpForm): void;
+    /** Drop the form again — the references stand in for the layers until it
+     * returns. */
+    detachForm(): void;
+    /** Route one configuration-form commit: re-derive the default answers, and
+     * run one executable refresh on the fetch trigger. */
+    onFormCommit(): void;
+    /** Run one executable refresh (probe the candidates, merge what is found
+     * into the saved rows, seed a never-configured host) and re-probe the
+     * selection — the whole fetch the card's **Fetch executables** fires. Runs
+     * are serialized so rapid actions never interleave. */
+    run(): Promise<unknown>;
+    /** Read the configuration form's live layers — the same read every commit
+     * and every run makes (the references, plus the described row once it
+     * exists). A headless surface (the slash commands) reads the saved rows
+     * through it. */
+    source(): ConfigLayers;
+    /** The live mirror — every answer the Host has standing. Headless surfaces
+     * (the slash commands) read their answers off it and write nothing to it:
+     * answers belong to the controller's own modules. */
+    readonly live: ConfigLiveFields;
+    /** Write one executable selection through the Host write-back channel — the
+     * same persisted `chromePath` field the card's picker writes — and re-fire
+     * the run behind it. `""` clears the user layer back to the row config. */
+    selectChromePath(path: string): Promise<void>;
+    /** Run the Windows Chrome path once (locate, prereq, port, launch, wait for
+     * the bind) on the same one-run-at-a-time chain the button drives through,
+     * and answer with what the run stated. */
+    prelaunchWindowsChrome(): Promise<string>;
+    /** Mirror what one live connection answered it runs with (./connections.ts).
+     * Every kind `resolve` ends with this. */
+    noteRunning(entry: {
+        id: string;
+    }, answers: RunningAnswers): void;
+    /** Drive the prelaunch machinery once for a live `chrome-windows`
+     * connection's async `resolve`. */
+    prelaunchForConnection(): Promise<WindowsChromeRun>;
+    /** Mark the standalone-config translation dismissed (./../migration.ts
+     * D4): the row's `migrationDismissed` flips true so the offer stops. */
+    dismissMigration(): void;
+    /** Stand this instance down: nothing late (the bounded retry behind a failed
+     * run most of all) may fire runs for an instance that no longer exists. A
+     * hot re-apply disposes the prior instance this way. */
+    dispose(): void;
 }
 //# sourceMappingURL=state.d.ts.map

package/lib/host/controller/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/host/controller/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC5B,kEAAkE;IAClE,KAAK,EAAE,gBAAgB,CAAC;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,gBAAgB,CAAC;IAC/B,uDAAuD;IACvD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,iEAAiE;IACjE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yDAAyD;IACzD,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+EAA+E;IAC/E,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wEAAwE;IACxE,aAAa,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/E,8EAA8E;IAC9E,MAAM,EAAE,SAAS,CAAC;IAClB,8BAA8B;IAC9B,KAAK,EAAE,eAAe,CAAC;CAC1B"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/host/controller/state.ts"],"names":[],"mappings":"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"}

package/lib/host/controller/windows-run.d.ts

@@ -1,9 +1,17 @@
+import type { WindowsChromeRun } from "../types/index.js";
 import type { Controller } from "./state.js";
 /**
  * One **Prelaunch Windows Chrome** run. When the host is not WSL there is simply
  * nothing to drive and the answer is `not-applicable`; otherwise the state moves
  * through `launching` while the run (locate, prereq, launch, port) settles, and
- * a connect that lands writes the flag through the ordinary bridge path.
+ * the settled state is mirrored before the run is returned.
  */
-export declare function runWindowsChrome(controller: Controller): Promise<void>;
+export declare function runWindowsChrome(controller: Controller): Promise<WindowsChromeRun>;
+/**
+ * The kind-side half of the run: a live `chrome-windows` connection's async
+ * `resolve` drives the launch through the same one-run-at-a-time chain the
+ * button uses, and gets the run result back to turn into the connect-mode
+ * stdio config.
+ */
+export declare function prelaunchWindowsForConnection(controller: Controller): Promise<WindowsChromeRun>;
 //# sourceMappingURL=windows-run.d.ts.map

package/lib/host/controller/windows-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows-run.d.ts","sourceRoot":"","sources":["../../../src/host/controller/windows-run.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD5E"}
+{"version":3,"file":"windows-run.d.ts","sourceRoot":"","sources":["../../../src/host/controller/windows-run.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,mBAAmB,CAAC;AAI9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkExF;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOrG"}

package/lib/host/controller/windows-run.js

@@ -1,51 +1,74 @@
 /**
  * Controller — the one Windows Chrome run.
  *
- * The whole Windows path the card's **Prelaunch Windows Chrome** button drives,
- * sequenced here against the injected run half (./run.ts in ../windows). Success
- * ends with the connect entry written into the *saved* flags (replace-by-key, so
- * what the bridge launches with afterwards is exactly what the card claims), and
- * the run never kills what it started. Everything it answers lands in the base
- * layer's `windowsChromeStatus`; the answer is read back off that mirror, never
- * off the promise.
+ * The whole Windows path the **Prelaunch Windows Chrome** surface drives (the
+ * card button, the `prelaunch_windows_chrome` tool, and the async `resolve` of a
+ * live `chrome-windows` connection), sequenced here against the injected run
+ * half (./run.ts in ../windows). The run never kills what it started; everything
+ * it answers lands in the live mirror's `windowsChromeStatus`, and the run
+ * result is handed back to the caller — in the component model the browser is
+ * driven by a connection, not by a bridge this row owns, so a successful run
+ * writes no flag anywhere: the debugging URL belongs to the connection's own
+ * answer, not to this row's configuration.
+ *
+ * Re-entry is cheap by construction: when a previous run already left the live
+ * mirror connected, the URL it stated rides into `currentFlags`, and the
+ * underlying run reuses that port when the browser behind it still answers —
+ * so re-running is idempotent, never a second browser.
  */
-import { sameFlags } from "../flags.js";
 import { firstLine } from "../status.js";
+import { isWindowsExecutablePath } from "../platform.js";
 import { windowsChromeProjectDir, withBrowserUrlFlag } from "../windows/index.js";
-import { applyFlags } from "./bridge-run.js";
-import { persistExtraFlags } from "./persist.js";
+import { resolveLaunchFlags, resolveSelection } from "../values.js";
+import { publishLive } from "./publish.js";
 /**
  * One **Prelaunch Windows Chrome** run. When the host is not WSL there is simply
  * nothing to drive and the answer is `not-applicable`; otherwise the state moves
  * through `launching` while the run (locate, prereq, launch, port) settles, and
- * a connect that lands writes the flag through the ordinary bridge path.
+ * the settled state is mirrored before the run is returned.
  */
 export async function runWindowsChrome(controller) {
     const { state } = controller;
     if (!controller.wslHost) {
-        state.entry.windowsChromeStatus = { state: "not-applicable", port: 0, error: "" };
-        return;
+        state.live.windowsChromeStatus = { state: "not-applicable", port: 0, error: "" };
+        publishLive(controller);
+        return { state: "not-applicable", port: 0, url: "", profileDir: "", error: "" };
+    }
+    state.live.windowsChromeStatus = { state: "launching", port: state.live.windowsChromeStatus.port, error: "" };
+    publishLive(controller);
+    let currentFlags = resolveLaunchFlags(state.source(), controller.launchFlags);
+    // A run answering from a mirror that stands connected carries its own URL in
+    // — that is what makes re-entry (tool re-run, pool re-prepare) idempotent:
+    // the underlying run reuses the live port instead of launching again.
+    if (state.live.windowsChromeStatus.state === "connected" && state.live.windowsChromeStatus.port > 0) {
+        currentFlags = withBrowserUrlFlag(currentFlags, `http://127.0.0.1:${state.live.windowsChromeStatus.port}`);
     }
-    state.entry.windowsChromeStatus = { state: "launching", port: state.entry.windowsChromeStatus.port, error: "" };
-    const live = state.source();
-    const currentFlags = Array.isArray(live.extraFlags) ? live.extraFlags : state.runningFlags;
-    let result;
     // The workspace that carries the run's `.chrome` view: the row-config `cwd`,
     // else the live session's workspace — the run answers the GUI the user is
     // driving, not the directory `dsh web` happened to be launched from (a view
     // rooted at `~` links `~/.chrome`) — else the host's own cwd.
     const projectDir = windowsChromeProjectDir(controller.config.cwd, controller.ctx.get("sessions"), process.cwd());
+    // The executable the picker selected, when that selection is a Windows one:
+    // what the run launches is then exactly what the card named, not the first
+    // location the run happens to find. Nothing else stands in — a selection
+    // that is not there answers by naming it — while a selection naming no
+    // Windows executable (nothing picked, or a local one) leaves the run's own
+    // locate in charge, exactly as it was.
+    const selected = resolveSelection(state.source()).path;
+    const candidates = isWindowsExecutablePath(selected) ? [selected] : void 0;
+    let result;
     try {
         result = await controller.windowsChrome({
             cwd: projectDir,
-            currentFlags
+            currentFlags,
+            ...(candidates === void 0 ? {} : { candidates })
         });
     }
     catch (error) {
         result = { state: "launch-failed", port: 0, url: "", profileDir: "", error: firstLine(error instanceof Error ? error.message : String(error)) };
     }
-    state.entry.windowsChromeStatus = { state: result.state, port: result.port, error: firstLine(result.error) };
-    if (result.state === "connected" && result.url !== "") {
+    state.live.windowsChromeStatus = { state: result.state, port: result.port, error: firstLine(result.error) };
+    if (result.state === "connected") {
         if (result.profileDir !== "") {
             if (result.profileLink === "kept") {
                 // A real `.chrome` directory already sits at the view's spot:
@@ -53,26 +76,34 @@ export async function runWindowsChrome(controller) {
                 // — say it once, not on every run.
                 if (!state.profileLinkKeptShown) {
                     state.profileLinkKeptShown = true;
-                    controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): ${projectDir}/.chrome is an existing directory — the Windows profile stays at ${result.profileDir}, not linked into the checkout`);
+                    controller.ctx.logger.warn(`dsh-chrome-mcp(${controller.config.serverName}): ${projectDir}/.chrome is an existing directory — the Windows profile stays at ${result.profileDir}, not linked into the checkout`);
                 }
             }
             else {
-                controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): Windows Chrome profile ${result.profileDir}, workspace view ${projectDir}/.chrome`);
+                controller.ctx.logger.info(`dsh-chrome-mcp(${controller.config.serverName}): Windows Chrome profile ${result.profileDir}, workspace view ${projectDir}/.chrome`);
             }
         }
-        const next = withBrowserUrlFlag(currentFlags, result.url);
-        state.entry.lastError = "";
-        if (!sameFlags(next, state.runningFlags)) {
-            // The bridge now connects instead of launching — the same flag path
-            // the extra-flags editor writes through. Persisting is what keeps
-            // connect mode across a reconnect and the next dsh start.
-            controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): Windows Chrome connected at ${result.url} — switching the bridge to connect mode`);
-            applyFlags(controller, next);
-            void persistExtraFlags(controller, next);
-        }
-        return;
+        state.live.lastError = "";
+        publishLive(controller);
+        return { state: result.state, port: result.port, url: result.url, profileDir: result.profileDir, error: "" };
     }
-    state.entry.lastError = firstLine(result.error);
-    controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): Windows Chrome run did not connect: ${state.entry.lastError}`);
+    state.live.lastError = firstLine(result.error);
+    publishLive(controller);
+    controller.ctx.logger.warn(`dsh-chrome-mcp(${controller.config.serverName}): Windows Chrome run did not connect: ${state.live.lastError}`);
+    return { state: result.state, port: result.port, url: result.url, profileDir: result.profileDir, error: state.live.lastError };
+}
+/**
+ * The kind-side half of the run: a live `chrome-windows` connection's async
+ * `resolve` drives the launch through the same one-run-at-a-time chain the
+ * button uses, and gets the run result back to turn into the connect-mode
+ * stdio config.
+ */
+export async function prelaunchWindowsForConnection(controller) {
+    const { state } = controller;
+    const off = "off";
+    const failed = "launch-failed";
+    return state.runs
+        .then(async () => (state.disposed ? { state: off, port: 0, url: "", profileDir: "", error: "the component was disposed" } : runWindowsChrome(controller)))
+        .catch((error) => ({ state: failed, port: 0, url: "", profileDir: "", error: firstLine(error instanceof Error ? error.message : String(error)) }));
 }
 //# sourceMappingURL=windows-run.js.map

package/lib/host/controller/windows-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"windows-run.js","sourceRoot":"","sources":["../../../src/host/controller/windows-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"windows-run.js","sourceRoot":"","sources":["../../../src/host/controller/windows-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAsB;IACzD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACjF,WAAW,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACpF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9G,WAAW,CAAC,UAAU,CAAC,CAAC;IACxB,IAAI,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAClG,YAAY,GAAG,kBAAkB,CAAC,YAAY,EAAE,oBAAoB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,6EAA6E;IAC7E,0EAA0E;IAC1E,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,UAAU,GAAG,uBAAuB,CACtC,UAAU,CAAC,MAAM,CAAC,GAAG,EACrB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAyC,EACtE,OAAO,CAAC,GAAG,EAAE,CAChB,CAAC;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,yEAAyE;IACzE,uEAAuE;IACvE,2EAA2E;IAC3E,uCAAuC;IACvC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;IACvD,MAAM,UAAU,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3E,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC;YACpC,GAAG,EAAE,UAAU;YACf,YAAY;YACZ,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;SACnD,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,GAAG,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACpJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5G,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;gBAChC,8DAA8D;gBAC9D,gEAAgE;gBAChE,mCAAmC;gBACnC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;oBAC9B,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC;oBAClC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,UAAU,CAAC,MAAM,CAAC,UAAU,MAAM,UAAU,oEAAoE,MAAM,CAAC,UAAU,gCAAgC,CAAC,CAAC;gBACpN,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,UAAU,CAAC,MAAM,CAAC,UAAU,6BAA6B,MAAM,CAAC,UAAU,oBAAoB,UAAU,UAAU,CAAC,CAAC;YACrK,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QAC1B,WAAW,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/C,WAAW,CAAC,UAAU,CAAC,CAAC;IACxB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,UAAU,CAAC,MAAM,CAAC,UAAU,0CAA0C,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3I,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;AACnI,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,UAAsB;IACtE,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,MAAM,GAAG,GAAuB,KAAK,CAAC;IACtC,MAAM,MAAM,GAAuB,eAAe,CAAC;IACnD,OAAO,KAAK,CAAC,IAAI;SACZ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;SACzJ,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3J,CAAC"}

package/lib/host/discovery/candidates.d.ts

@@ -2,20 +2,23 @@
  * Chrome discovery — the candidate list.
  *
  * Where discovery looks before anything is picked: the platform's stable-channel
- * Chrome locations (mirroring upstream puppeteer's, WSL Windows-side `/mnt/c/…`
- * deliberately absent) and the ordered candidate list one run folds together —
- * row-config `chromePaths`, then the saved rows' ids, then the selection. The
- * probes over that list live in ./scan.ts; the `--version` probe itself in
- * ./probe.ts.
+ * Chrome locations (mirroring upstream puppeteer's) and the ordered candidate
+ * list one run folds together — row-config `chromePaths`, then whatever else this
+ * host carries (on a WSL host: the Windows-side executables answering through the
+ * interop mount, never spawned from here), then the saved rows' ids, then the
+ * selection. The probes over that list live in ./scan.ts; the `--version` probe
+ * itself in ./probe.ts.
  */
 import type { ChromeMcpConfig } from "../types/index.js";
 /**
  * Google Chrome stable-channel locations probed by discovery when
  * `chromePath` is empty — mirrors the upstream (puppeteer) system-channel
- * resolution. WSL Windows-side locations (`/mnt/c/...`) are deliberately
- * absent: the interop launch cannot work (see .probe), and reporting a found
- * Windows binary as healthy would be a false negative for the known
- * executable-missing error. Unknown platforms probe nothing.
+ * resolution. The Windows-side locations a WSL host reaches through the interop
+ * mount are deliberately not mixed into the *platform* list (their spelling
+ * belongs to the other side of the boundary); a WSL host's run folds them in
+ * separately, as the candidates it offers without probing (see
+ * `chromeExecutableCandidates`' `extraCandidates` and the never-spawn rule in
+ * ./scan.ts). Unknown platforms probe nothing.
  */
 export declare const DEFAULT_CHROME_PATHS: {
     linux: string[];
@@ -26,12 +29,19 @@ export declare const DEFAULT_CHROME_PATHS: {
 export declare function defaultChromePaths(platform?: NodeJS.Platform): string[];
 /**
  * Every path one executable run probes: the row-config candidate list (default
- * the platform list), then the ids the saved rows carry, then the current
- * selection — deduplicated, in this order, so the list reads "what the profile
- * configures, then what the card saved, then what runs".
+ * the platform list), then whatever else this host carries, then the ids the
+ * saved rows carry, then the current selection — deduplicated, in this order,
+ * so the list reads "what the profile configures, then what the machine carries,
+ * then what the card saved, then what runs".
  * @param entry - validated row config (`chromePaths` is the candidate list).
  * @param savedIds - the saved rows' ids, in row order (see ./catalog.ts).
  * @param effectivePath - the currently selected path, always kept in the list.
+ * @param extraCandidates - what this host carries beyond the configured list:
+ * the Windows-side executables a WSL host reaches through the interop mount.
+ * They join the list so the **Prelaunch Windows Chrome** run drives what the
+ * picker picked rather than what it happens to locate first — and, offered
+ * without being probed, they answer a note and never a version (see the
+ * `blockedForPlatform` answer threaded through ./scan.ts).
  */
-export declare function chromeExecutableCandidates(entry: Pick<ChromeMcpConfig, "chromePaths">, savedIds?: readonly string[], effectivePath?: string): string[];
+export declare function chromeExecutableCandidates(entry: Pick<ChromeMcpConfig, "chromePaths">, savedIds?: readonly string[], effectivePath?: string, extraCandidates?: readonly string[]): string[];
 //# sourceMappingURL=candidates.d.ts.map

package/lib/host/discovery/candidates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;CAahC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,EAAE,CAGzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAC3C,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,aAAa,SAAK,GACnB,MAAM,EAAE,CAeV"}
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;CAahC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,EAAE,CAGzF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAC3C,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,aAAa,SAAK,EAClB,eAAe,GAAE,SAAS,MAAM,EAAO,GACxC,MAAM,EAAE,CAiBV"}

package/lib/host/discovery/candidates.js

@@ -1,10 +1,12 @@
 /**
  * Google Chrome stable-channel locations probed by discovery when
  * `chromePath` is empty — mirrors the upstream (puppeteer) system-channel
- * resolution. WSL Windows-side locations (`/mnt/c/...`) are deliberately
- * absent: the interop launch cannot work (see .probe), and reporting a found
- * Windows binary as healthy would be a false negative for the known
- * executable-missing error. Unknown platforms probe nothing.
+ * resolution. The Windows-side locations a WSL host reaches through the interop
+ * mount are deliberately not mixed into the *platform* list (their spelling
+ * belongs to the other side of the boundary); a WSL host's run folds them in
+ * separately, as the candidates it offers without probing (see
+ * `chromeExecutableCandidates`' `extraCandidates` and the never-spawn rule in
+ * ./scan.ts). Unknown platforms probe nothing.
  */
 export const DEFAULT_CHROME_PATHS = {
     linux: [
@@ -27,16 +29,24 @@ export function defaultChromePaths(platform = process.platform) {
 }
 /**
  * Every path one executable run probes: the row-config candidate list (default
- * the platform list), then the ids the saved rows carry, then the current
- * selection — deduplicated, in this order, so the list reads "what the profile
- * configures, then what the card saved, then what runs".
+ * the platform list), then whatever else this host carries, then the ids the
+ * saved rows carry, then the current selection — deduplicated, in this order,
+ * so the list reads "what the profile configures, then what the machine carries,
+ * then what the card saved, then what runs".
  * @param entry - validated row config (`chromePaths` is the candidate list).
  * @param savedIds - the saved rows' ids, in row order (see ./catalog.ts).
  * @param effectivePath - the currently selected path, always kept in the list.
+ * @param extraCandidates - what this host carries beyond the configured list:
+ * the Windows-side executables a WSL host reaches through the interop mount.
+ * They join the list so the **Prelaunch Windows Chrome** run drives what the
+ * picker picked rather than what it happens to locate first — and, offered
+ * without being probed, they answer a note and never a version (see the
+ * `blockedForPlatform` answer threaded through ./scan.ts).
  */
-export function chromeExecutableCandidates(entry, savedIds = [], effectivePath = "") {
+export function chromeExecutableCandidates(entry, savedIds = [], effectivePath = "", extraCandidates = []) {
     const rowPaths = Array.isArray(entry?.chromePaths) ? entry.chromePaths : [];
     const saved = Array.isArray(savedIds) ? savedIds : [];
+    const extra = Array.isArray(extraCandidates) ? extraCandidates : [];
     const seen = new Set();
     const candidates = [];
     const push = (value) => {
@@ -48,6 +58,8 @@ export function chromeExecutableCandidates(entry, savedIds = [], effectivePath =
     };
     for (const path of rowPaths)
         push(path);
+    for (const path of extra)
+        push(path);
     for (const path of saved)
         push(path);
     push(effectivePath);

package/lib/host/discovery/candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../../src/host/discovery/candidates.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,KAAK,EAAE;QACH,2BAA2B;QAC3B,wBAAwB;QACxB,+BAA+B;QAC/B,8BAA8B;QAC9B,eAAe;KAClB;IACD,MAAM,EAAE,CAAC,8DAA8D,CAAC;IACxE,KAAK,EAAE;QACH,4DAA4D;QAC5D,kEAAkE;KACrE;CACJ,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,WAA4B,OAAO,CAAC,QAAQ;IAC3E,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAA6C,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAA2C,EAC3C,WAA8B,EAAE,EAChC,aAAa,GAAG,EAAE;IAElB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAQ,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpB,OAAO,UAAU,CAAC;AACtB,CAAC"}
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../../src/host/discovery/candidates.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,KAAK,EAAE;QACH,2BAA2B;QAC3B,wBAAwB;QACxB,+BAA+B;QAC/B,8BAA8B;QAC9B,eAAe;KAClB;IACD,MAAM,EAAE,CAAC,8DAA8D,CAAC;IACxE,KAAK,EAAE;QACH,4DAA4D;QAC5D,kEAAkE;KACrE;CACJ,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,WAA4B,OAAO,CAAC,QAAQ;IAC3E,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAA6C,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAA2C,EAC3C,WAA8B,EAAE,EAChC,aAAa,GAAG,EAAE,EAClB,kBAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAQ,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpB,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/lib/host/discovery/index.d.ts

@@ -14,5 +14,6 @@
  * substituted. See ./scan.ts for the full behaviour and the WSL interop note.
  */
 export { chromeExecutableCandidates, DEFAULT_CHROME_PATHS, defaultChromePaths } from "./candidates.js";
+export { probeExecutable, readWindowsInstallVersion } from "./probe.js";
 export { checkChrome, discoverChrome, scanChromeExecutables } from "./scan.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/host/discovery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/lib/host/discovery/index.js

@@ -14,5 +14,6 @@
  * substituted. See ./scan.ts for the full behaviour and the WSL interop note.
  */
 export { chromeExecutableCandidates, DEFAULT_CHROME_PATHS, defaultChromePaths } from "./candidates.js";
+export { probeExecutable, readWindowsInstallVersion } from "./probe.js";
 export { checkChrome, discoverChrome, scanChromeExecutables } from "./scan.js";
 //# sourceMappingURL=index.js.map

package/lib/host/discovery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/lib/host/discovery/probe.d.ts

@@ -1,10 +1,21 @@
 /**
- * Spawn one `chromePath --version` probe (scrubbed parent env, bounded
- * timeout). Resolves the first stdout line (the version); ENOENT rejects with
- * "Chrome executable not found: <path>" carrying code "ENOENT"; a non-zero
- * exit rejects with the first non-empty stderr/stdout line.
+ * The version a Windows install states without being run: the highest
+ * `<major>.<minor>.<build>.<patch>` folder beside the executable (the layout
+ * Chrome, Edge, Brave and Chromium all install with), or
+ * {@link WINDOWS_VERSION_UNKNOWN} when none is there. A missing file rejects
+ * like the spawn would; a bare name (no folder to look in) answers unknown.
  */
-export declare function probeExecutable(target: string): Promise<string>;
+export declare function readWindowsInstallVersion(target: string): string;
+/**
+ * Answer one executable's version. On Windows nothing is spawned — a Chromium
+ * browser asked `--version` there opens a window instead of answering — and
+ * the version is read off the install ({@link readWindowsInstallVersion}).
+ * Everywhere else: one `chromePath --version` probe (scrubbed parent env,
+ * bounded timeout). Resolves the first stdout line (the version); ENOENT
+ * rejects with "Chrome executable not found: <path>" carrying code "ENOENT"; a
+ * non-zero exit rejects with the first non-empty stderr/stdout line.
+ */
+export declare function probeExecutable(target: string, platform?: NodeJS.Platform): Promise<string>;
 /** True when a candidate path can be handed to the OS for a `--version` probe.
  * A path that is absent (or not executable) never reaches the spawn: a
  * Chrome-less host runs one scan without launching anything. Paths with no

package/lib/host/discovery/probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/probe.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C/D;AAED;;;;qBAIqB;AACrB,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;oDAEoD;AACpD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlD"}
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/probe.ts"],"names":[],"mappings":"AA6BA;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C7G;AAED;;;;qBAIqB;AACrB,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;oDAEoD;AACpD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlD"}