@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

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

@@ -0,0 +1,109 @@
+/**
+ * Controller — the one Windows Chrome run.
+ *
+ * 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 { firstLine } from "../status.js";
+import { isWindowsExecutablePath } from "../platform.js";
+import { windowsChromeProjectDir, withBrowserUrlFlag } from "../windows/index.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
+ * the settled state is mirrored before the run is returned.
+ */
+export async function runWindowsChrome(controller) {
+    const { state } = controller;
+    if (!controller.wslHost) {
+        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}`);
+    }
+    // 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,
+            ...(candidates === void 0 ? {} : { candidates })
+        });
+    }
+    catch (error) {
+        result = { state: "launch-failed", port: 0, url: "", profileDir: "", error: firstLine(error instanceof Error ? error.message : String(error)) };
+    }
+    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:
+                // kept untouched, the link never clobbers what is already there
+                // — say it once, not on every run.
+                if (!state.profileLinkKeptShown) {
+                    state.profileLinkKeptShown = true;
+                    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(`dsh-chrome-mcp(${controller.config.serverName}): Windows Chrome profile ${result.profileDir}, workspace view ${projectDir}/.chrome`);
+            }
+        }
+        state.live.lastError = "";
+        publishLive(controller);
+        return { state: result.state, port: result.port, url: result.url, profileDir: result.profileDir, error: "" };
+    }
+    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

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

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

@@ -0,0 +1,47 @@
+/**
+ * Chrome discovery — the candidate list.
+ *
+ * Where discovery looks before anything is picked: the platform's stable-channel
+ * 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. 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[];
+    darwin: string[];
+    win32: string[];
+};
+/** The default discovery candidate list for one platform; [] probes nothing. */
+export declare function defaultChromePaths(platform?: NodeJS.Platform): string[];
+/**
+ * Every path one executable run probes: the row-config candidate list (default
+ * 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, extraCandidates?: readonly string[]): string[];
+//# sourceMappingURL=candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,68 @@
+/**
+ * Google Chrome stable-channel locations probed by discovery when
+ * `chromePath` is empty — mirrors the upstream (puppeteer) system-channel
+ * 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: [
+        "/opt/google/chrome/chrome",
+        "/usr/bin/google-chrome",
+        "/usr/bin/google-chrome-stable",
+        "/usr/local/bin/google-chrome",
+        "google-chrome"
+    ],
+    darwin: ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"],
+    win32: [
+        "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+        "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
+    ]
+};
+/** The default discovery candidate list for one platform; [] probes nothing. */
+export function defaultChromePaths(platform = process.platform) {
+    const candidates = DEFAULT_CHROME_PATHS[platform];
+    return Array.isArray(candidates) ? [...candidates] : [];
+}
+/**
+ * Every path one executable run probes: the row-config candidate list (default
+ * 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 = "", 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) => {
+        const path = String(value ?? "").trim();
+        if (path === "" || seen.has(path))
+            return;
+        seen.add(path);
+        candidates.push(path);
+    };
+    for (const path of rowPaths)
+        push(path);
+    for (const path of extra)
+        push(path);
+    for (const path of saved)
+        push(path);
+    push(effectivePath);
+    return candidates;
+}
+//# sourceMappingURL=candidates.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+/**
+ * Host half — the Chrome executable: candidate locations, the `--version`
+ * probes, the executable **scan** that produces the card's dropdown options, and
+ * the check run that ties them together.
+ *
+ *   ./candidates.ts  the platform Chrome locations + the ordered candidate list
+ *   ./probe.ts       the `--version` probe + presence + identity helpers
+ *   ./scan.ts        the scan, the discover-the-first-runnable run, the check
+ *
+ * Upstream starts the browser LAZILY, on the first tool call, so the check runs
+ * probes eagerly instead of waiting for a tool call. There is no "auto" mode:
+ * the scan lists what exists, the card picks one, and what is picked stays
+ * picked — a path that later disappears is reported broken, never silently
+ * 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

@@ -0,0 +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,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

@@ -0,0 +1,19 @@
+/**
+ * Host half — the Chrome executable: candidate locations, the `--version`
+ * probes, the executable **scan** that produces the card's dropdown options, and
+ * the check run that ties them together.
+ *
+ *   ./candidates.ts  the platform Chrome locations + the ordered candidate list
+ *   ./probe.ts       the `--version` probe + presence + identity helpers
+ *   ./scan.ts        the scan, the discover-the-first-runnable run, the check
+ *
+ * Upstream starts the browser LAZILY, on the first tool call, so the check runs
+ * probes eagerly instead of waiting for a tool call. There is no "auto" mode:
+ * the scan lists what exists, the card picks one, and what is picked stays
+ * picked — a path that later disappears is reported broken, never silently
+ * 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

@@ -0,0 +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,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

@@ -0,0 +1,29 @@
+/**
+ * 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 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
+ * directory separator go straight to the spawn so the OS resolves them
+ * through `PATH`. */
+export declare function presentOnDisk(candidate: string): boolean;
+/** Identity key used to fold two spellings of the same binary (`google-chrome`
+ * resolving onto `/usr/bin/google-chrome`) into one option. Falls back to the
+ * path itself when `realpath` cannot resolve it. */
+export declare function identity(candidate: string): string;
+//# sourceMappingURL=probe.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

package/lib/host/discovery/probe.js

@@ -0,0 +1,155 @@
+/**
+ * Chrome discovery — the low-level `--version` probe and the on-disk/identity
+ * helpers it rides on.
+ *
+ * The one place discovery reaches outside the process: `chromePath --version`
+ * run through a scrubbed parent env under a bounded timeout, the rule that says
+ * whether a path is worth spawning at all (a directory, socket or fifo never
+ * reaches a probe — a Chrome-less host must run one scan that launches nothing),
+ * and the identity key that folds two spellings of the same binary into one
+ * answer. The scan that drives them lives in ./scan.ts.
+ */
+import { spawn } from "node:child_process";
+import { accessSync, constants, readdirSync, realpathSync, statSync } from "node:fs";
+import * as path from "node:path";
+import { scrubbedParentEnv } from "@deepseek-ai/dsh-subprocess";
+import { CHECK_TIMEOUT_MS, WINDOWS_VERSION_UNKNOWN } from "../constants.js";
+import { firstLine } from "../status.js";
+/** A Chromium install's version folder name: `155.0.8059.85`. */
+const VERSION_FOLDER = /^\d+\.\d+\.\d+\.\d+$/u;
+/** The "not found" rejection, carrying code "ENOENT" for the scan to drop. */
+function missingExecutable(target) {
+    const missing = new Error(`Chrome executable not found: ${target}`);
+    Object.defineProperty(missing, "code", { value: "ENOENT", writable: true, enumerable: false, configurable: true });
+    return missing;
+}
+/**
+ * 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 function readWindowsInstallVersion(target) {
+    const win = path.win32;
+    if (!target.includes("/") && !target.includes("\\"))
+        return WINDOWS_VERSION_UNKNOWN;
+    let isFile = false;
+    try {
+        isFile = statSync(target).isFile();
+    }
+    catch {
+        // Absent — answered below like a spawn's ENOENT.
+    }
+    if (!isFile)
+        throw missingExecutable(target);
+    let names;
+    try {
+        names = readdirSync(win.dirname(target));
+    }
+    catch {
+        return WINDOWS_VERSION_UNKNOWN;
+    }
+    const versions = names.filter((name) => VERSION_FOLDER.test(name));
+    if (versions.length === 0)
+        return WINDOWS_VERSION_UNKNOWN;
+    const parts = (name) => name.split(".").map(Number);
+    versions.sort((a, b) => {
+        const [pa, pb] = [parts(a), parts(b)];
+        for (let i = 0; i < 4; i++)
+            if (pa[i] !== pb[i])
+                return pa[i] - pb[i];
+        return 0;
+    });
+    return versions[versions.length - 1];
+}
+/**
+ * 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 function probeExecutable(target, platform = process.platform) {
+    if (platform === "win32") {
+        try {
+            return Promise.resolve(readWindowsInstallVersion(target));
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(target, ["--version"], {
+                env: scrubbedParentEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+                timeout: CHECK_TIMEOUT_MS,
+                killSignal: "SIGKILL"
+            });
+        }
+        catch (error) {
+            reject(new Error(`could not run "${target} --version": ${String(error)}`));
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => (stdout += chunk));
+        child.stderr?.on("data", (chunk) => (stderr += chunk));
+        child.on("error", (error) => {
+            const code = error && typeof error.code === "string" ? error.code : "";
+            if (code === "ENOENT") {
+                reject(missingExecutable(target));
+                return;
+            }
+            reject(new Error(`could not run "${target} --version": ${String(error)}`));
+        });
+        child.on("close", (code) => {
+            if (code === null) {
+                reject(new Error(`"${target} --version" timed out after ${String(CHECK_TIMEOUT_MS)}ms`));
+                return;
+            }
+            if (code !== 0) {
+                const detail = firstLine(stderr) !== "" ? firstLine(stderr) : firstLine(stdout) !== "" ? firstLine(stdout) : `exit code ${String(code)}`;
+                reject(new Error(`"${target} --version" failed: ${detail}`));
+                return;
+            }
+            resolve(firstLine(stdout));
+        });
+    });
+}
+/** 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
+ * directory separator go straight to the spawn so the OS resolves them
+ * through `PATH`. */
+export function presentOnDisk(candidate) {
+    if (!candidate.includes("/") && !candidate.includes("\\"))
+        return true;
+    try {
+        // A directory (or a socket, or a fifo) is not an executable, and
+        // spawning one to find out is a side effect we do not want.
+        if (!statSync(candidate).isFile())
+            return false;
+        accessSync(candidate, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Identity key used to fold two spellings of the same binary (`google-chrome`
+ * resolving onto `/usr/bin/google-chrome`) into one option. Falls back to the
+ * path itself when `realpath` cannot resolve it. */
+export function identity(candidate) {
+    try {
+        return realpathSync(candidate);
+    }
+    catch {
+        return candidate;
+    }
+}
+//# sourceMappingURL=probe.js.map

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

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

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

@@ -0,0 +1,72 @@
+import type { ChromeExecutableStatus, ChromeMcpConfig } from "../types/index.js";
+/**
+ * What one run probes: every candidate it has — the row-config candidate list,
+ * the paths the saved rows carry, and the current selection (see
+ * {@link chromeExecutableCandidates}) — probed in that order.
+ *
+ * A candidate that runs answers with its `--version` line; one that is present
+ * but not runnable (bad binary, a probe that timed out) keeps its place in the
+ * list carrying the failure, so a broken pin stays visible instead of vanishing
+ * into a red dot.
+ *
+ * - absent / not executable → dropped without a spawn,
+ * - `blockedForPlatform` answers non-empty → **no spawn**: the candidate keeps
+ *   its place carrying that reason as a `note`, never as a failure (the one case
+ *   is a Windows `chrome.exe` on a WSL host, whose probe would start a browser
+ *   instance it can never drive — see {@link WSL_WINDOWS_LAUNCH_ERROR}),
+ * - two spellings of the same binary collapse into the first one seen.
+ *
+ * An empty candidate list resolves `[]` (nothing probed: unknown platform, or a
+ * host patched down to nothing).
+ *
+ * @param candidates - candidate executable paths.
+ * @param blockedForPlatform - answers a reason for a candidate this host must
+ * never exec, `""` for one it may probe.
+ */
+export declare function scanChromeExecutables(candidates: string[], blockedForPlatform?: (candidate: string) => string): Promise<ChromeExecutableStatus[]>;
+/**
+ * Discover usable Google Chrome executables when nothing is fixed: probe every
+ * candidate and report the first runnable one. Kept for its `Promise<string>`
+ * contract (`src/index.ts` re-export, tests, diagnostics).
+ * @param candidatePaths - candidate executable paths (default: platform list).
+ * @param blockedForPlatform - answers a reason for a candidate this host must
+ * never exec, `""` for one it may probe.
+ * @returns the discovered executable version line.
+ */
+export declare function discoverChrome(candidatePaths: string[], blockedForPlatform?: (candidate: string) => string): Promise<string>;
+/**
+ * One check run — the public "did we find a runnable Chrome?" question:
+ *
+ * - `chromePath` non-empty → probe that executable (ENOENT → "Chrome
+ *   executable not found: <path>"; non-zero → first stderr/stdout line;
+ *   success → the version line).
+ * - `chromePath` empty → run the scan over the candidate list (row config
+ *   `chromePaths`, default {@link defaultChromePaths}) and report the first
+ *   runnable entry. Nothing usable → the known executable-missing error;
+ *   only-present-but-broken entries → that entry's failure.
+ *   - the extra flags leave the check mute: they declare a connect mode
+ *     (`--browserUrl` / `--browser-url` / `-u`, `--wsEndpoint` /
+ *     `--ws-endpoint` / `-w`, `--autoConnect` / `--auto-connect`), name a
+ *     config file (`--config`), or fix another `--channel` than the `stable`
+ *     the candidate list models → resolve "": there is no local executable
+ *     this check could honestly answer for.
+ * - `blockedForPlatform` answers non-empty for what is selected → resolve "" with
+ *   **no spawn**. A Windows `chrome.exe` on a WSL host is the case: its
+ *   `--version` probe answers (which is why the selection looks healthy) but
+ *   answering means attaching to the Windows browser session, and that *starts*
+ *   a browser instance no tool call could drive
+ *   ({@link WSL_WINDOWS_LAUNCH_ERROR}).
+ *
+ * A run that probes **nothing** (no candidates, a connect mode, a config file
+ * or another channel standing in for the local executable, or a blocked path)
+ * resolves "" — callers must treat that as "no evidence", never as health.
+ *
+ * @param entry - validated {@link ChromeMcpConfig}.
+ * @param extraFlags - the flags list the bridge currently launches with;
+ *   inspected for the entries that leave the check mute.
+ * @param blockedForPlatform - answers a reason for a path this host must never
+ *   exec, `""` for one it may probe.
+ * @returns the executable version line, or "" when nothing is probed.
+ */
+export declare function checkChrome(entry: ChromeMcpConfig, extraFlags?: string[], blockedForPlatform?: (candidate: string) => string): Promise<string>;
+//# sourceMappingURL=scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/host/discovery/scan.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKjF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAAE,EACpB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAiB,GAC7D,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmDnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAChC,cAAc,EAAE,MAAM,EAAE,EACxB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAiB,GAC7D,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,eAAe,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAiB,GAC7D,OAAO,CAAC,MAAM,CAAC,CAUjB"}