@comecaramelos/dsh-chrome-mcp 0.0.1 → 1.0.0

package/lib/host/controller/runs.js

@@ -0,0 +1,211 @@
+/**
+ * Controller — the executable run, its serialization, and the Windows trigger.
+ *
+ * Every executable action goes through one **run**: probe the candidate list the
+ * saved rows + row config + selection carry, publish the per-path answers, and
+ * merge what was found back into the saved rows (keeping the names the user
+ * gave them). When nothing is configured at all, the first runnable entry is
+ * seeded. A `probe` is the follow-up probe of the selection that answers the
+ * version line the card shows; the Windows Chrome run shares this same
+ * one-run-at-a-time chain.
+ */
+import { bridgeConfig } from "../bridge.js";
+import { entryIds, mergeEntries, normalizeEntries } from "../catalog.js";
+import { checkChrome, chromeExecutableCandidates, scanChromeExecutables } from "../discovery/index.js";
+import { flagsSkipCheck } from "../flags.js";
+import { firstLine, isChromeMissing } from "../status.js";
+import { windowsChromeUrl } from "../windows/index.js";
+import { readPersistedCustomPaths } from "../values.js";
+import { configForBridge, restartBridge } from "./bridge-run.js";
+import { noteSelection, noteStderr } from "./notes.js";
+import { persistChromePath, persistExecutables } from "./persist.js";
+import { runWindowsChrome } from "./windows-run.js";
+/** Element-wise equality of two saved-row lists (order is the dropdown order). */
+export function sameEntries(a, b) {
+    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+        return false;
+    return a.every((entry, index) => entry.id === b[index].id && entry.name === b[index].name);
+}
+/**
+ * Fold the legacy hand-typed MRU into the rows, exactly once. It is the same list
+ * the older card used to write, so reading it never duplicates a row the card
+ * already saved: the merge keeps stored rows and only appends ids that are
+ * missing, and the result lands in the persisted rows instead of staying
+ * readable forever as a second source.
+ */
+export function mergeLegacyPaths(controller) {
+    const { state } = controller;
+    if (state.legacyPathsMerged)
+        return state.runningExecutables;
+    state.legacyPathsMerged = true;
+    const legacy = readPersistedCustomPaths(controller.ctx);
+    if (legacy.length === 0)
+        return state.runningExecutables;
+    const merged = mergeEntries(state.runningExecutables, legacy);
+    if (merged.changed) {
+        state.runningExecutables = merged.entries;
+        void persistExecutables(controller, merged.entries);
+        controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): folded ${String(legacy.length)} saved path(s) from the legacy chromeCustomPaths list into the executable rows`);
+    }
+    return state.runningExecutables;
+}
+/**
+ * One executable run. Probe every candidate the row config and the saved rows
+ * carry (plus the selection — the same path may appear as a row), publish what
+ * answered as per-path status, and merge what was found into the saved rows,
+ * keeping the names their user gave them. When nothing is configured at all
+ * (neither layer carries a path) the first runnable entry is **seeded**: written
+ * into the persisted `chromePath` once, so what the picker shows is what the
+ * bridge runs. A selection that is already fixed is never re-resolved, however
+ * broken.
+ * @returns the per-path statuses the run answered with.
+ */
+export async function runExecutableDiscovery(controller) {
+    const { state } = controller;
+    const live = state.source();
+    // Rows are user-authored; re-normalize on every read (the client writes them
+    // in one shot, so the shape it hands may be anything).
+    const stored = normalizeEntries(live.executables);
+    const storedChanged = !sameEntries(stored, state.runningExecutables);
+    state.runningExecutables = storedChanged ? stored : mergeLegacyPaths(controller);
+    const savedIds = entryIds(state.runningExecutables);
+    const candidates = chromeExecutableCandidates(controller.config, savedIds, state.runningChromePath);
+    let statuses = [];
+    try {
+        statuses = await scanChromeExecutables(candidates, controller.blockedForPlatform);
+    }
+    catch (error) {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): executable run failed: ${String(error)}`);
+    }
+    state.entry.executableStatus = statuses;
+    // A found path that is not a row yet becomes one, nameless; a row the user
+    // named keeps that name. A path that vanished is dropped by the scan and so
+    // stops being offered — the reference's "Fetch executables" rule.
+    const merged = mergeEntries(state.runningExecutables, statuses.map((status) => status.path));
+    if (merged.changed) {
+        state.runningExecutables = merged.entries;
+        void persistExecutables(controller, merged.entries);
+    }
+    if (state.runningChromePath === "") {
+        const seeded = statuses.find((status) => status.version !== "" && status.error === "");
+        if (seeded !== void 0 && !flagsSkipCheck(state.runningFlags)) {
+            // Seeding is a selection change like any other: the bridge has to
+            // restart carrying it, otherwise the card would claim a path the
+            // running argv does not carry.
+            controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): no executable configured — seeding chromePath = ${seeded.path} (found by scan)`);
+            state.seededPath = seeded.path;
+            void persistChromePath(controller, seeded.path);
+            // Already inside this run: the status list above already carries the
+            // seeded path's own answer, so no follow-up run.
+            applyChromePath(controller, seeded.path, "selected", false);
+        }
+        else if (candidates.length > 0 && !flagsSkipCheck(state.runningFlags) && statuses.every((status) => status.error !== "" || status.version === "")) {
+            // Nothing present at all: the known executable-missing state.
+            state.entry.lastError = firstLine(`Chrome executable not found: no executable detected (checked: ${candidates.join(", ")})`);
+            state.entry.chromeMissing = isChromeMissing(state.entry.lastError);
+        }
+    }
+    noteSelection(controller);
+    return statuses;
+}
+/**
+ * The probe of the *selection* — the one run that answers the version line the
+ * card shows under the pill. Nothing probed (no selection, or a connect-mode
+ * flag) must not clear anything: upstream starts the browser lazily, so silence
+ * is not health.
+ */
+export async function probeSelection(controller) {
+    const { state } = controller;
+    // Connect mode launches nothing locally, so there is no local executable to
+    // answer for: the card mutes the pill and shows no version line for a probe
+    // the host cannot run.
+    if (flagsSkipCheck(state.runningFlags)) {
+        state.entry.chromeVersion = "";
+        return "";
+    }
+    if (state.runningChromePath === "") {
+        state.entry.chromeVersion = "";
+        return "";
+    }
+    try {
+        const version = await checkChrome({ ...controller.config, extraFlags: state.runningFlags, chromePath: state.runningChromePath }, state.runningFlags, controller.blockedForPlatform);
+        state.entry.chromeVersion = version;
+        if (version !== "") {
+            state.entry.lastError = "";
+            state.entry.chromeMissing = false;
+        }
+        return version;
+    }
+    catch (error) {
+        state.entry.lastError = firstLine(error instanceof Error ? error.message : String(error));
+        // A failed probe says nothing about the version: keep no stale answer
+        // behind the error.
+        state.entry.chromeVersion = "";
+        state.entry.chromeMissing = isChromeMissing(state.entry.lastError);
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): executable probe failed: ${state.entry.lastError}`);
+        return "";
+    }
+}
+/**
+ * Restart the bridge connection with a different executable selected — the argv
+ * tail carries `--executablePath=<path>`, so unlike a flag change this one is
+ * what the card's pill claims is running. `rerun` schedules the scan+probe that
+ * follows a selection change; a caller that is already inside that run (the
+ * seeding branch above) passes `false`.
+ */
+export function applyChromePath(controller, path, nextSource, rerun = true) {
+    const { state } = controller;
+    state.runningChromePath = path;
+    state.runningChromeSource = nextSource;
+    noteSelection(controller);
+    controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): executable → "${path || "(none)"}" (restarting the bridge connection)`);
+    const built = bridgeConfig(configForBridge(controller, state.runningFlags), state.runningFlags, state.runningStderrMode);
+    noteStderr(controller, built);
+    restartBridge(controller, built, "executable update failed");
+    // A different executable reads a different machine: refresh the list and
+    // probe what is now selected, so the pill's version is the new one's.
+    if (rerun)
+        queue(controller, "probe");
+}
+/**
+ * Serialize one unit of work: a rows-only refresh, a run that also re-probes
+ * what is selected, or the Windows Chrome launch. Windows runs share this chain
+ * because the invariant is "one run at a time" — nothing about it interacts with
+ * the local probe.
+ */
+export function queue(controller, kind) {
+    const { state } = controller;
+    state.runs = state.runs
+        .then(async () => {
+        if (kind === "windows") {
+            await runWindowsChrome(controller);
+        }
+        else {
+            await runExecutableDiscovery(controller);
+            if (kind === "probe")
+                await probeSelection(controller);
+        }
+        state.entry.executableDiscoveryRevision += 1;
+    })
+        .catch(() => { });
+    return state.runs;
+}
+/**
+ * One Windows Chrome run on demand: queued on the same chain as the button (one
+ * run at a time), resolved once it settled. The answer is the base-layer mirror
+ * read after the run — the tool surface says what `windowsChromeStatus` says,
+ * never more than the run answered.
+ */
+export async function prelaunchWindowsChrome(controller) {
+    const { state } = controller;
+    await queue(controller, "windows");
+    const status = state.entry.windowsChromeStatus;
+    if (status.state === "connected" && status.port > 0) {
+        return `Windows Chrome connected at ${windowsChromeUrl(status.port)} — the bridge connects to it instead of launching one.`;
+    }
+    if (status.state === "not-applicable") {
+        return "This host is not a WSL instance: there is no Windows-side browser here to drive.";
+    }
+    return `Windows Chrome did not connect (${status.state}): ${status.error}`;
+}
+//# sourceMappingURL=runs.js.map

package/lib/host/controller/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../../src/host/controller/runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMpD,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,CAAmC,EAAE,CAAmC;IAChG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAClF,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAsB;IACnD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,IAAI,KAAK,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC,kBAAkB,CAAC;IAC7D,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,wBAAwB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,kBAAkB,CAAC;IACzD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1C,KAAK,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CACtB,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gFAAgF,CACxK,CAAC;IACN,CAAC;IACD,OAAO,KAAK,CAAC,kBAAkB,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAsB;IAC/D,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC5B,6EAA6E;IAC7E,uDAAuD;IACvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrE,KAAK,CAAC,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,0BAA0B,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpG,IAAI,QAAQ,GAA6B,EAAE,CAAC;IAC5C,IAAI,CAAC;QACD,QAAQ,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,6BAA6B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChI,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IAExC,2EAA2E;IAC3E,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1C,KAAK,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QACvF,IAAI,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,kEAAkE;YAClE,iEAAiE;YACjE,+BAA+B;YAC/B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CACtB,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,sDAAsD,MAAM,CAAC,IAAI,kBAAkB,CACzI,CAAC;YACF,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;YAC/B,KAAK,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,qEAAqE;YACrE,iDAAiD;YACjD,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,IAAI,MAAM,CAAC,OAAO,KAAK,EAAE,CAAC,EAAE,CAAC;YAClJ,8DAA8D;YAC9D,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAC7B,iEAAiE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5F,CAAC;YACF,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;IACD,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAsB;IACvD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,4EAA4E;IAC5E,4EAA4E;IAC5E,uBAAuB;IACvB,IAAI,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,EAAE,CAAC;QACjC,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,WAAW,CAC7B,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,iBAAiB,EAAE,EAC7F,KAAK,CAAC,YAAY,EAClB,UAAU,CAAC,kBAAkB,CAChC,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC;QACpC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACjB,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;YAC3B,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1F,sEAAsE;QACtE,oBAAoB;QACpB,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;QAC/B,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,+BAA+B,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACtI,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAAsB,EAAE,IAAY,EAAE,UAAiC,EAAE,KAAK,GAAG,IAAI;IACjH,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,mBAAmB,GAAG,UAAU,CAAC;IACvC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,oBAAoB,IAAI,IAAI,QAAQ,sCAAsC,CAAC,CAAC;IAC1J,MAAM,KAAK,GAAG,YAAY,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACzH,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9B,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,0BAA0B,CAAC,CAAC;IAC7D,yEAAyE;IACzE,sEAAsE;IACtE,IAAI,KAAK;QAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,UAAsB,EAAE,IAAa;IACvD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;SAClB,IAAI,CAAC,KAAK,IAAI,EAAE;QACb,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,IAAI,KAAK,OAAO;gBAAE,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC,IAAI,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAsB;IAC/D,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,MAAM,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAC/C,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,+BAA+B,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC;IAChI,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;QACpC,OAAO,kFAAkF,CAAC;IAC9F,CAAC;IACD,OAAO,mCAAmC,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Controller internals — the live state + the context every controller method
+ * reads.
+ *
+ * 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`,
+ * `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.
+ */
+import type { BridgeStderrMode, ChromeMcpConfig, ChromeExecutableEntry, EffectiveChromeSource, McpBridge, PluginContext, SettingsResolved, WindowsChromeRun } from "../types/index.js";
+import type { WindowsChromeRunOptions } from "../windows/index.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. */
+    runningFlags: string[];
+    /** Effective bridge stderr mode ("log"/"console"). */
+    runningStderrMode: BridgeStderrMode;
+    /** Executable the bridge actually launches with. */
+    runningChromePath: string;
+    /** Where that executable came from. */
+    runningChromeSource: EffectiveChromeSource;
+    /** The saved rows the last commit served, already normalized. */
+    runningExecutables: ChromeExecutableEntry[];
+    /** Last emitted stderr notice key (keeps the announce silent across churn). */
+    stderrNotice: string;
+    /** Last observed `refreshExecutablesNonce` (undefined until first commit). */
+    lastRefreshNonce: number | undefined;
+    /** Last observed `openWindowsChromeNonce` (undefined until first commit). */
+    lastWindowsNonce: number | undefined;
+    /** The executable this host seeded on the first run ("" = nothing). */
+    seededPath: string;
+    /** Whether the user layer has ever carried a path. */
+    seenUserSelection: boolean;
+    /** Serializes runs so rapid actions never interleave. */
+    runs: Promise<unknown>;
+    /** 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;
+}
+/** Everything a controller method needs: the immutable context + the state. */
+export interface Controller {
+    ctx: PluginContext;
+    config: ChromeMcpConfig;
+    /** True on a WSL host (where the Windows run is the only working path). */
+    wslHost: 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 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 live mutable state. */
+    state: ControllerState;
+}
+//# sourceMappingURL=state.d.ts.map

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

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

package/lib/host/controller/state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state.js.map

package/lib/host/controller/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/host/controller/state.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,9 @@
+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.
+ */
+export declare function runWindowsChrome(controller: Controller): Promise<void>;
+//# sourceMappingURL=windows-run.d.ts.map

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

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

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

@@ -0,0 +1,78 @@
+/**
+ * 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.
+ */
+import { sameFlags } from "../flags.js";
+import { firstLine } from "../status.js";
+import { windowsChromeProjectDir, withBrowserUrlFlag } from "../windows/index.js";
+import { applyFlags } from "./bridge-run.js";
+import { persistExtraFlags } from "./persist.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.
+ */
+export async function runWindowsChrome(controller) {
+    const { state } = controller;
+    if (!controller.wslHost) {
+        state.entry.windowsChromeStatus = { state: "not-applicable", port: 0, error: "" };
+        return;
+    }
+    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());
+    try {
+        result = await controller.windowsChrome({
+            cwd: projectDir,
+            currentFlags
+        });
+    }
+    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 !== "") {
+        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(`chrome-devtools-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`);
+            }
+        }
+        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.entry.lastError = firstLine(result.error);
+    controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): Windows Chrome run did not connect: ${state.entry.lastError}`);
+}
+//# 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,37 @@
+/**
+ * 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.
+ */
+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.
+ */
+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 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".
+ * @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.
+ */
+export declare function chromeExecutableCandidates(entry: Pick<ChromeMcpConfig, "chromePaths">, savedIds?: readonly string[], effectivePath?: 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;;;;;;;;;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"}

package/lib/host/discovery/candidates.js

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+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 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".
+ * @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.
+ */
+export function chromeExecutableCandidates(entry, savedIds = [], effectivePath = "") {
+    const rowPaths = Array.isArray(entry?.chromePaths) ? entry.chromePaths : [];
+    const saved = Array.isArray(savedIds) ? savedIds : [];
+    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 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":"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"}

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

@@ -0,0 +1,18 @@
+/**
+ * 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 { 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,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/lib/host/discovery/index.js

@@ -0,0 +1,18 @@
+/**
+ * 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 { 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,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export declare function probeExecutable(target: string): 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":"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"}