@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/host/controller/runs.js

@@ -0,0 +1,394 @@
+/**
+ * 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.
+ *
+ * Since the component model there is no bridge of this row's own to restart:
+ * an executable or flag change changes what a future `resolve` would answer,
+ * and what is running today keeps running until the manager's pool says
+ * otherwise — so the drift paths re-mirror the default and hand the live
+ * connections that follow it back to the pool (./connections.ts).
+ */
+import { AsyncResource } from "node:async_hooks";
+import { entryIds, mergeEntries } from "../catalog.js";
+import { DISCOVERY_RETRY_DELAY_MS, DISCOVERY_RETRY_MAX, ERROR_CAP, KIND_FIELDS, KIND_ID_WINDOWS } from "../constants.js";
+import { checkChrome, chromeExecutableCandidates, scanChromeExecutables } from "../discovery/index.js";
+import { flagsSkipCheck, flagsSkipProbe } from "../flags.js";
+import { firstLine, isChromeMissing } from "../status.js";
+import { windowsChromeUrl } from "../windows/index.js";
+import { readDroppedExecutables, readPersistedCustomPaths, readSavedExecutables, resolveSelection } from "../values.js";
+import { invalidateOwnedForField } from "./connections.js";
+import { noteSelection } from "./notes.js";
+import { persistChromePath, persistDroppedExecutables, persistExecutables } from "./persist.js";
+import { publishLive } from "./publish.js";
+import { prelaunchWindowsForConnection, runWindowsChrome } from "./windows-run.js";
+/**
+ * The runs answer from a neutral async context, never from the one that
+ * scheduled them. A form commit is a config **write** — and the commit handler
+ * runs synchronously inside the HMR write transaction it opened. A run
+ * scheduled from that handler inherits the transaction's async-local store
+ * through the promise continuation, so every follow-up config write the run
+ * answers — the seeded `chromePath`, the merged executable rows, the
+ * connect-mode flag — reads as a *nested* transaction, which HMR refuses
+ * outright ("HMR transactions cannot be nested", measured live 2026-10-12):
+ * the run settles, the mirror says `connected`, and the write-back silently
+ * never lands. This resource carries no async context of its own, so binding
+ * the run body to it starts the whole chain clean; the same write queues
+ * normally behind the transaction that is no longer open. (The option that drops
+ * the context predates the typed surface of `AsyncResourceOptions`.)
+ */
+const contextlessOptions = { keepAsyncContext: false };
+const runContext = new AsyncResource("dsh-chrome-mcp run", contextlessOptions);
+/** 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, skip) {
+    const { state } = controller;
+    if (state.legacyPathsMerged)
+        return state.runningExecutables;
+    state.legacyPathsMerged = true;
+    const legacy = readPersistedCustomPaths(state.source());
+    if (legacy.length === 0)
+        return state.runningExecutables;
+    const merged = mergeEntries(state.runningExecutables, skip === void 0 ? legacy : legacy.filter((id) => !skip.has(id)));
+    if (merged.changed) {
+        state.runningExecutables = merged.entries;
+        void persistExecutables(controller, merged.entries);
+        controller.ctx.logger.info(`dsh-chrome-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 layers = 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 = readSavedExecutables(layers);
+    // An id the stored list has lost since the last run rode the run that is
+    // reading it now — and a found path re-folds into the rows on every merge
+    // step, so a deleted row would stand straight back up behind its own
+    // deletion (measured live 2026-10-12: the (x86) Windows-executable row read
+    // as a delete that never landed). What stands dropped lives in
+    // `droppedExecutables` and no merge step folds it back; an id the list
+    // carries again clears its record.
+    const storedIds = new Set(entryIds(stored));
+    const deleted = readDroppedExecutables(layers);
+    const skipIds = new Set(deleted);
+    for (const id of entryIds(state.runningExecutables)) {
+        if (!storedIds.has(id))
+            skipIds.add(id);
+    }
+    for (const id of deleted) {
+        if (storedIds.has(id))
+            skipIds.delete(id);
+    }
+    if (skipIds.size !== deleted.length || !deleted.every((id) => skipIds.has(id))) {
+        void persistDroppedExecutables(controller, [...skipIds]);
+    }
+    const storedChanged = !sameEntries(stored, state.runningExecutables);
+    state.runningExecutables = storedChanged ? stored : mergeLegacyPaths(controller, skipIds);
+    const savedIds = entryIds(state.runningExecutables);
+    // What the profile configures, what this host carries (the Windows-side
+    // executables a WSL host reaches through the interop mount — offered, never
+    // probed), what the rows saved, and what the bridge runs.
+    const candidates = chromeExecutableCandidates(controller.config, savedIds, state.runningChromePath, controller.windowsExecutables());
+    let statuses = [];
+    try {
+        statuses = await scanChromeExecutables(candidates, controller.blockedForPlatform);
+    }
+    catch (error) {
+        controller.ctx.logger.warn(`dsh-chrome-mcp(${controller.config.serverName}): executable run failed: ${String(error)}`);
+    }
+    state.live.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. A path the
+    // user dropped answers too (a located Windows executable keeps answering
+    // forever) and must not be folded back.
+    const merged = mergeEntries(state.runningExecutables, statuses.map((status) => status.path).filter((path) => !skipIds.has(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 && !flagsSkipProbe(state.runningFlags)) {
+            // Seeding is a selection change like any other: it follows the same
+            // drift path a pick takes, otherwise the card would claim a path no
+            // answer launches with.
+            controller.ctx.logger.info(`dsh-chrome-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 && !flagsSkipProbe(state.runningFlags) && statuses.every((status) => status.error !== "" || status.version === "")) {
+            // Nothing runnable at all: the known executable-missing state. A
+            // candidate that answered a note instead of a version says why —
+            // the one case is the Windows executable a WSL host cannot launch
+            // but drives through the **Prelaunch Windows Chrome** run — so the
+            // line names what to run instead of leaving a bare "not found".
+            const noted = statuses.find((status) => status.note !== "");
+            const detail = noted === void 0
+                ? `no executable detected (checked: ${candidates.join(", ")})`
+                : `no executable detected for this host (checked: ${candidates.join(", ")}); ${firstLine(noted.note)}`;
+            // The official troubleshooting advice for this state on a Linux
+            // host (docs/troubleshooting.md): nothing local answered, and the
+            // candidate list only knows where a `stable` install of this kernel
+            // lives — the line says what to do about it instead of leaving a
+            // bare "not found". On a WSL host the Windows side joins the answer
+            // as the **run**, never a launch: a Windows `chrome.exe` cannot be
+            // launched from WSL (see AGENTS.md, which is why the run exists).
+            const advice = noted === void 0 && controller.linuxHost
+                ? controller.wslHost
+                    ? "; install Google Chrome inside the Linux environment, or run Prelaunch Windows Chrome to drive the Windows side (connect mode)"
+                    : "; install Google Chrome inside the Linux environment (chrome-devtools-mcp never downloads one)"
+                : "";
+            state.live.lastError = firstLine(`Chrome executable not found: ${detail}${advice}`, ERROR_CAP + advice.length);
+            state.live.chromeMissing = isChromeMissing(state.live.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.live.chromeVersion = "";
+        publishLive(controller);
+        return "";
+    }
+    if (state.runningChromePath === "") {
+        state.live.chromeVersion = "";
+        publishLive(controller);
+        return "";
+    }
+    try {
+        const version = await checkChrome({ ...controller.config, extraFlags: state.runningFlags, chromePath: state.runningChromePath }, state.runningFlags, controller.blockedForPlatform);
+        state.live.chromeVersion = version;
+        if (version !== "") {
+            state.live.lastError = "";
+            state.live.chromeMissing = false;
+        }
+        publishLive(controller);
+        return version;
+    }
+    catch (error) {
+        state.live.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.live.chromeVersion = "";
+        state.live.chromeMissing = isChromeMissing(state.live.lastError);
+        publishLive(controller);
+        controller.ctx.logger.warn(`dsh-chrome-mcp(${controller.config.serverName}): executable probe failed: ${state.live.lastError}`);
+        return "";
+    }
+}
+/**
+ * Write one executable selection through the Host write-back channel — the same
+ * persisted `chromePath` field every other surface reads — and re-fire the run
+ * behind it, the way the card's own selection commit does: a changed selection
+ * shifts the default answers (connections follow, the run re-runs), an
+ * unchanged write just re-probes. This is the command-side mirror of the
+ * picker — pill, command and catalog read and write one field — so a headless
+ * selection lands exactly where a GUI pick would.
+ */
+export function selectChromePath(controller, path) {
+    return persistChromePath(controller, path).then(() => {
+        const { state } = controller;
+        // Layers read *after* the write: what the user layer answers is the
+        // written path — or, on a cleared write ("" = fall back to the row
+        // config), whatever the row config carries under it.
+        const selection = resolveSelection(state.source());
+        const nextChromePath = selection.path;
+        const nextSource = nextChromePath === "" ? "" : selection.source !== "" ? selection.source : "selected";
+        if (nextChromePath !== state.runningChromePath || nextSource !== state.runningChromeSource)
+            applyChromePath(controller, nextChromePath, nextSource);
+        else
+            queue(controller, "probe");
+    });
+}
+/**
+ * Carry a different executable into the live answers — the argv tail carries
+ * `--executablePath=<path>`, so unlike a flags edit this one is what the card's
+ * pill claims is running. What lives stands on is not restarted here: a
+ * connection that follows the row's default is handed back to the pool for a
+ * re-resolve, and one that picked its own executable was never following it.
+ * `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;
+    state.live.runningNote = "";
+    noteSelection(controller);
+    controller.ctx.logger.info(`dsh-chrome-mcp(${controller.config.serverName}): executable → "${path || "(none)"}" (the default answers shift with it)`);
+    invalidateOwnedForField(controller, KIND_FIELDS.executable);
+    // 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");
+}
+/**
+ * The bounded retry of one FAILED executable run.
+ *
+ * The failure this answers is not "Chrome is not installed" — that answer is a
+ * settled result and re-probing it forever would just be churn. It is the
+ * host that is not ready *yet*: on a WSL boot the Windows executables arrive
+ * through the interop mount, and the first run can fire seconds before that
+ * mount answers, so what the run states — `chromeMissing`, the known
+ * executable-missing state — reads "no found" for a machine that is about to
+ * answer. Today nothing re-fires: the card states that answer until someone
+ * presses **Fetch** again. So a run that settles standing failed arms exactly
+ * one retry behind the delay, capped (`DISCOVERY_RETRY_MAX` retries per run
+ * chain, reset the moment a run stops failing), and cancelled with the
+ * instance.
+ *
+ * The rule that decides where the retry sits is the persistence of the known
+ * error: the retry never touches `lastError`/`chromeMissing` — it *re-runs the
+ * same run*, whose own answers already follow the evidence rule (the run clears
+ * those fields only through a probe that answered a version). So the retry
+ * cannot clobber what the user is already being told: either the later run finds
+ * the executable (its probe answers a version, which is exactly the evidence
+ * that clears the state), or it does not (the same answer re-states, still
+ * standing). Nothing else distinguishes them — which is why arming the retry is
+ * safe and why it arms only while the state stands.
+ */
+function noteRunFailure(controller, statuses) {
+    const { state } = controller;
+    // Only a run that settled standing in the known executable-missing state is
+    // failed. And of those, the candidates that answered a platform *note* say
+    // why no run on this host will ever launch them (the one case is the Windows
+    // executable a WSL host drives through **Prelaunch Windows Chrome**) — that
+    // is a settled answer, not a host not ready yet, so a retry would answer the
+    // same note forever and is not armed.
+    const noteOnly = statuses.length > 0 && statuses.every((status) => status.note !== "");
+    if (state.live.chromeMissing !== true || noteOnly) {
+        state.retriesPending = 0;
+        return;
+    }
+    if (state.disposed)
+        return;
+    if (state.retryTimer !== void 0)
+        return;
+    if (state.retriesPending >= DISCOVERY_RETRY_MAX)
+        return;
+    state.retriesPending += 1;
+    state.retryTimer = setTimeout(() => {
+        state.retryTimer = void 0;
+        // Only while the failure still stands: an instance whose later run found
+        // the executable has nothing left to retry.
+        if (state.disposed || state.live.chromeMissing !== true)
+            return;
+        void queue(controller, "probe");
+    }, DISCOVERY_RETRY_DELAY_MS);
+}
+/** Cancel the pending bounded retry — what the instance's dispose calls. */
+export function cancelDiscoveryRetry(controller) {
+    const { state } = controller;
+    if (state.retryTimer !== void 0) {
+        clearTimeout(state.retryTimer);
+        state.retryTimer = void 0;
+    }
+}
+/**
+ * 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. The body answers from a neutral async context (see
+ * `runContext`): a run scheduled from a form commit must not carry that
+ * commit's write transaction, or every write the run answers would be refused
+ * as a nested transaction.
+ */
+export function queue(controller, kind) {
+    const { state } = controller;
+    state.runs = state.runs
+        .then(runContext.bind(async () => {
+        if (kind === "windows") {
+            await runWindowsChrome(controller);
+        }
+        else {
+            const statuses = await runExecutableDiscovery(controller);
+            if (kind === "probe")
+                await probeSelection(controller);
+            // A run that settled standing failed arms one bounded retry; a
+            // run that no longer stands failed resets the retry counter.
+            noteRunFailure(controller, statuses);
+        }
+        state.live.executableDiscoveryRevision += 1;
+        publishLive(controller);
+    }))
+        .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 live mirror read
+ * after the run — the tool surface says what `windowsChromeStatus` says, never
+ * more than the run answered.
+ *
+ * With the manager mounted this is also the surface that keeps the live
+ * `chrome-windows` connections honest: a run that connected while such a
+ * connection stands is a reason to answer that connection again (the run is
+ * idempotent — the live port rides into `currentFlags` — so re-answering is not
+ * a second browser), and a run that connected without one is said to be worth
+ * one.
+ */
+export async function prelaunchWindowsChrome(controller) {
+    const { state } = controller;
+    await prelaunchWindowsForConnection(controller);
+    const status = state.live.windowsChromeStatus;
+    if (status.state === "connected" && status.port > 0) {
+        const url = windowsChromeUrl(status.port);
+        if (state.connections !== void 0) {
+            const windowsEntries = state.connections.entries().filter((entry) => entry.kind === KIND_ID_WINDOWS);
+            if (windowsEntries.length > 0)
+                return `Windows Chrome connected at ${url} — the manager's Windows Chrome connections stand live against it.`;
+            return `Windows Chrome connected at ${url}. No Windows Chrome connection exists yet — add one under the "Windows Chrome (WSL debug port)" kind, or use the Chrome connection kind with a "--browserUrl=${url}" flag.`;
+        }
+        return `Windows Chrome connected at ${url}. Without the MCP manager there is no connection to drive it — install the MCP manager bundle.`;
+    }
+    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":"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"}

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

@@ -0,0 +1,172 @@
+/**
+ * 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`, `connections`,
+ * `runs`, `windows-run`, `persist`, `captures`, `commits`). This file names the
+ * 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, 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 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 console-output mode of the default answer ("log"/"console"). */
+    runningStderrMode: BridgeStderrMode;
+    /** Executable the default answer 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>;
+    /**
+     * 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.
+ * `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 `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 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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/host/controller/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC5B;qEACiE;IACjE,IAAI,EAAE,gBAAgB,CAAC;IACvB;4DACwD;IACxD,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC;qEACiE;IACjE,MAAM,EAAE,MAAM,YAAY,CAAC;IAC3B;;mFAE+E;IAC/E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6EAA6E;IAC7E,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,mDAAmD;IACnD,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;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;IACvC;cACU;IACV,cAAc,EAAE,MAAM,CAAC;IACvB;qDACiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+EAA+E;IAC/E,iBAAiB,EAAE,OAAO,CAAC;IAC3B;kEAC8D;IAC9D,kBAAkB,EAAE,OAAO,CAAC;IAC5B;kBACc;IACd,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;uEAEmE;IACnE,WAAW,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC/C;6CACyC;IACzC,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAClC;AAED;;;gCAGgC;AAChC,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,aAAa,CAAC;IACnB;uEACmE;IACnE,MAAM,EAAE,eAAe,CAAC;IACxB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB;;;iCAG6B;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD;oDACgD;IAChD,WAAW,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,aAAa,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/E;;;;uDAImD;IACnD,kBAAkB,EAAE,MAAM,MAAM,EAAE,CAAC;IACnC,8BAA8B;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB;;mEAE+D;IAC/D,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC;kBACc;IACd,UAAU,IAAI,IAAI,CAAC;IACnB;0DACsD;IACtD,YAAY,IAAI,IAAI,CAAC;IACrB;;;2DAGuD;IACvD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB;;;qBAGiB;IACjB,MAAM,IAAI,YAAY,CAAC;IACvB;;yDAEqD;IACrD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC;;+EAE2E;IAC3E,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;8CAE0C;IAC1C,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C;8CAC0C;IAC1C,WAAW,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAClE;uCACmC;IACnC,sBAAsB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpD;4EACwE;IACxE,gBAAgB,IAAI,IAAI,CAAC;IACzB;;4DAEwD;IACxD,OAAO,IAAI,IAAI,CAAC;CACnB"}

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,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
+ * the settled state is mirrored before the run is returned.
+ */
+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

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