@comecaramelos/dsh-chrome-mcp 0.0.1 → 1.0.0

package/lib/host/controller/controller.js

@@ -0,0 +1,167 @@
+/**
+ * Host half — live state: `createChromeMcpController`.
+ *
+ * One controller per apply(): the composition base layer (`entry`), the live
+ * resolved settings source, the nested bridge, the serialized executable runs,
+ * and the two capture paths — bridge log lines and tool-call results. Every
+ * base-layer mutation happens here; settings commits route in through the
+ * controller methods, never the other way round.
+ *
+ * The executable state follows the reference plugin's picker shape and the rule
+ * that there is no auto mode: the saved **rows** (`{ id: path, name: label }`)
+ * are what the card's dropdown lists, the *selection* is what the bridge
+ * launches with, and a run refreshes both — it probes every candidate the rows
+ * and the row config carry, merges what it finds into the rows (names kept), and
+ * seeds a never-configured host exactly once. A fixed path that later breaks
+ * stays fixed and reads broken instead of being re-resolved.
+ *
+ * This file is only the assembly: it resolves the config-derived pieces, builds
+ * the base layer, makes the initial bridge connection, and wires the public
+ * methods to the behavior modules that sit alongside it (see ./index.ts for the
+ * layout). Everything that actually *does* something lives there, not here.
+ */
+import * as McpClient from "@deepseek-ai/dsh-mcp-client";
+import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
+import { bridgeConfig, captureLogger } from "../bridge.js";
+import { DEFAULT_EXTRA_FLAGS, FLAGS_ENV_VAR, WSL_EXTRA_FLAGS, WSL_WINDOWS_LAUNCH_ERROR } from "../constants.js";
+import { extractExecutablePathFlag, flagsSkipCheck, stripExecutablePathFlags } from "../flags.js";
+import { isWindowsExecutablePath, isWindowsSubsystemForLinux } from "../platform.js";
+import { runWindowsChromeConnect } from "../windows/index.js";
+import { readPersistedChromePath, readPersistedFlags, readPersistedStderrMode, resolveEnvFlags, resolveStderrMode } from "../values.js";
+import { configForBridge } from "./bridge-run.js";
+import { noteBridgeLog, registerToolCapture } from "./captures.js";
+import { onSettingsChange } from "./commits.js";
+import { noteSelection, noteStderr } from "./notes.js";
+import { prelaunchWindowsChrome, queue } from "./runs.js";
+/**
+ * Build the live state for one bridge + card pairing.
+ * @param ctx - plugin context.
+ * @param config - validated row config.
+ * @param deps - optional host overrides (tests replace the Windows run;
+ * everything else resolves from this process).
+ */
+export function createChromeMcpController(ctx, config, deps = {}) {
+    // The Windows run half — injectable for wiring tests, default is the real
+    // one (TCP samples + the interop launch).
+    const windowsChrome = typeof deps.runWindowsChrome === "function" ? deps.runWindowsChrome : runWindowsChromeConnect;
+    const launchEnvironment = launchEnvironmentOf(ctx);
+    const envValue = launchEnvironment.get(FLAGS_ENV_VAR)?.value;
+    // Where the plugin runs: a WSL host plus a Windows executable is a selection
+    // the bridge can never launch (its debug pipes do not cross the interop
+    // boundary, and its debugging port stays on the Windows loopback). The launch
+    // environment is authoritative inside a host, so the answer is deterministic;
+    // a bare call falls back to the interop marker.
+    const wslHost = isWindowsSubsystemForLinux({ env: (name) => launchEnvironment.get(name)?.value });
+    // A path this host must never exec. There is only one: a Windows
+    // `chrome.exe` selected on a WSL host. Its `--version` probe answers (so the
+    // selection looks healthy) but answering attaches to the Windows browser
+    // session, and that **starts a browser instance** no tool call could drive —
+    // see WSL_WINDOWS_LAUNCH_ERROR. The run keeps such an entry visible carrying
+    // this reason; the probe answers nothing instead of paying for it.
+    const blockedForPlatform = (candidate) => wslHost && isWindowsExecutablePath(candidate) ? WSL_WINDOWS_LAUNCH_ERROR : "";
+    // A row-level `--executablePath` used to be the only way to pin an
+    // executable. The picker owns it now, so the flag is read out of the row
+    // flags here — it becomes the row-config source of the selection, and the
+    // flag itself never reaches argv as a second source of truth.
+    const rowChromePath = config.chromePath.trim() !== "" ? config.chromePath.trim() : extractExecutablePathFlag(config.extraFlags);
+    const rowFlags = stripExecutablePathFlags(config.extraFlags);
+    if (rowChromePath !== "" && config.chromePath.trim() === "" && extractExecutablePathFlag(config.extraFlags) !== "") {
+        ctx.logger.warn(`chrome-devtools-mcp(${config.serverName}): an extraFlags "--executablePath" in the row config is now the \`chromePath\` source ("${rowChromePath}"); the flag itself is dropped from the bridge argv`);
+    }
+    const baseFlags = resolveEnvFlags(rowFlags, envValue);
+    if (typeof envValue === "string" && envValue.trim() !== "" && baseFlags === rowFlags) {
+        ctx.logger.warn(`chrome-devtools-mcp(${config.serverName}): ignoring ${FLAGS_ENV_VAR} — invalid flags list; using row config`);
+    }
+    // The persisted UI selection wins over env/row config: seed the first bridge
+    // spawn with it. When the settings service is not up yet this yields the base
+    // flags, and the installSection initial onChange below switches the bridge to
+    // the persisted selection in place right after.
+    const initialFlags = readPersistedFlags(ctx) ?? baseFlags;
+    // The initial selection: persisted `chromePath` → row config → nothing.
+    // Nothing here consults discovery: the first run does, and only seeds if both
+    // layers are silent.
+    const persistedChromePath = readPersistedChromePath(ctx);
+    const runningChromePath = persistedChromePath !== "" ? persistedChromePath : rowChromePath;
+    const runningChromeSource = persistedChromePath !== "" ? "selected" : rowChromePath !== "" ? "row-config" : "";
+    // The effective bridge stderr mode: the persisted UI toggle when set, else the
+    // row-config `bridgeStderr`. Every spawn reads it, and a UI write hot-switches
+    // it (restarting the connection).
+    const runningStderrMode = resolveStderrMode(readPersistedStderrMode(ctx), config.bridgeStderr);
+    // Composition base layer: part of the resolved value served to the client but
+    // never persisted. See ./types/index.ts (SettingsBaseLayer) for the whole
+    // shape; the static `defaultExtraFlags`/`wslExtraFlags` mirrors feed the card's
+    // Restore defaults / Flags WSL actions, and `windowsChromeStatus` reads off
+    // this host from the start (the Windows path simply does not exist off WSL).
+    const entry = {
+        extraFlags: initialFlags,
+        refreshExecutablesNonce: 0,
+        openWindowsChromeNonce: 0,
+        chromePath: "",
+        executables: [],
+        chromeCustomPaths: [],
+        stderrMode: "",
+        lastError: "",
+        chromeMissing: false,
+        executableDiscoveryRevision: 0,
+        chromeVersion: "",
+        executableStatus: [],
+        effectiveChromePath: runningChromePath,
+        effectiveSource: runningChromeSource,
+        wslWindowsExecutable: wslHost && isWindowsExecutablePath(runningChromePath),
+        rowStderr: config.bridgeStderr === "console" ? "console" : "log",
+        defaultExtraFlags: [...DEFAULT_EXTRA_FLAGS],
+        wslExtraFlags: [...WSL_EXTRA_FLAGS],
+        windowsChromeStatus: { state: wslHost ? "off" : "not-applicable", port: 0, error: "" },
+        carriesConnectionMode: flagsSkipCheck(initialFlags)
+    };
+    const state = {
+        entry,
+        source: () => entry,
+        runningFlags: initialFlags,
+        runningStderrMode,
+        runningChromePath,
+        runningChromeSource,
+        runningExecutables: [],
+        stderrNotice: "",
+        lastRefreshNonce: void 0,
+        lastWindowsNonce: void 0,
+        seededPath: "",
+        seenUserSelection: false,
+        runs: Promise.resolve(),
+        wslNoticeShown: false,
+        profileLinkKeptShown: false,
+        legacyPathsMerged: false
+    };
+    const controller = {
+        ctx,
+        config,
+        wslHost,
+        blockedForPlatform,
+        rowChromePath,
+        rowFlags,
+        windowsChrome,
+        bridge: undefined,
+        state
+    };
+    // Initial connection with the resolved flags + the resolved selection. The
+    // bridge-log capture rides only on the bridge scope: our own logs bypass it,
+    // so our own warns never masquerade as connection errors.
+    const bridgeScope = ctx.extend({ logger: captureLogger(ctx.logger, (level, args) => noteBridgeLog(controller, level, args)) });
+    const initial = bridgeConfig(configForBridge(controller, initialFlags), initialFlags, runningStderrMode);
+    noteStderr(controller, initial);
+    controller.bridge = bridgeScope.plugin(McpClient, initial.config);
+    noteSelection(controller);
+    // Tool-level status: browser-level failures are returned to the calling agent
+    // and never reach the bridge logger.
+    registerToolCapture(controller);
+    return {
+        entry,
+        setSource: (next) => {
+            state.source = next;
+        },
+        run: () => queue(controller, "refresh"),
+        prelaunchWindowsChrome: () => prelaunchWindowsChrome(controller),
+        onSettingsChange: () => onSettingsChange(controller)
+    };
+}
+//# sourceMappingURL=controller.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Host half — the controller's live state + behavior.
+ *
+ * One controller per apply(): the composition base layer, the nested bridge, the
+ * serialized executable runs, and the two capture paths. The public surface is
+ * `createChromeMcpController` and its config; everything behind it is split into
+ * concern modules:
+ *
+ *   ./controller.ts   the assembly: resolve config, build the base layer, make
+ *                     the initial bridge connection, wire the public methods
+ *   ./state.ts        the live state + context every helper shares (internal)
+ *   ./notes.ts        base-layer announcements (selection, stderr)
+ *   ./bridge-run.ts   the bridge switches (config build, restart, flags, stderr)
+ *   ./runs.ts         the executable run + serialization + the Windows trigger
+ *   ./windows-run.ts  the one **Prelaunch Windows Chrome** run
+ *   ./persist.ts      settings writes a run makes (seed, rows, connect flag)
+ *   ./captures.ts     bridge-log + tool-call-result captures
+ *   ./commits.ts      settings-commit routing (`onSettingsChange`)
+ *
+ * The one rule that must survive the split: read the live settings value through
+ * `state.source()` at commit time, never capture it, and keep every base-layer
+ * mutation in these modules — settings commits route in, never out.
+ */
+export { createChromeMcpController } from "./controller.js";
+export type { ChromeMcpController, ChromeMcpControllerDeps } from "./controller.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/host/controller/index.js

@@ -0,0 +1,25 @@
+/**
+ * Host half — the controller's live state + behavior.
+ *
+ * One controller per apply(): the composition base layer, the nested bridge, the
+ * serialized executable runs, and the two capture paths. The public surface is
+ * `createChromeMcpController` and its config; everything behind it is split into
+ * concern modules:
+ *
+ *   ./controller.ts   the assembly: resolve config, build the base layer, make
+ *                     the initial bridge connection, wire the public methods
+ *   ./state.ts        the live state + context every helper shares (internal)
+ *   ./notes.ts        base-layer announcements (selection, stderr)
+ *   ./bridge-run.ts   the bridge switches (config build, restart, flags, stderr)
+ *   ./runs.ts         the executable run + serialization + the Windows trigger
+ *   ./windows-run.ts  the one **Prelaunch Windows Chrome** run
+ *   ./persist.ts      settings writes a run makes (seed, rows, connect flag)
+ *   ./captures.ts     bridge-log + tool-call-result captures
+ *   ./commits.ts      settings-commit routing (`onSettingsChange`)
+ *
+ * The one rule that must survive the split: read the live settings value through
+ * `state.source()` at commit time, never capture it, and keep every base-layer
+ * mutation in these modules — settings commits route in, never out.
+ */
+export { createChromeMcpController } from "./controller.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Controller — base-layer announcements.
+ *
+ * The two notes the base layer carries that a client can only learn from here:
+ * the resolved selection (with the static WSL + Windows-executable state, keyed
+ * on the *selection*, not a probe), and where the bridge console output goes.
+ */
+import type { BridgeStderrNotice } from "../types/index.js";
+import type { Controller } from "./state.js";
+/**
+ * Publish the resolved selection into the base layer — with the one state the
+ * client can only learn from here, and with the static notice that goes with it.
+ * The Windows-executable state is keyed on the *selection*, not on any probe: a
+ * Windows binary answers `--version` just fine across the interop boundary, so a
+ * healthy-looking pill is exactly what a broken Windows selection looks like
+ * until the first tool call fails.
+ */
+export declare function noteSelection(controller: Controller): void;
+/**
+ * Announce where the bridge's console output goes — one line per change of
+ * state, keyed on what actually happened, so neither the "log" capture nor
+ * a switch to console echo is silent. An unavailable redirect (no POSIX shell)
+ * warns with the reason so the fallback is not mysterious.
+ */
+export declare function noteStderr(controller: Controller, built: BridgeStderrNotice): void;
+//# sourceMappingURL=notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/host/controller/notes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAK5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAc1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAclF"}

package/lib/host/controller/notes.js

@@ -0,0 +1,49 @@
+import { flagsSkipCheck } from "../flags.js";
+import { isWindowsExecutablePath } from "../platform.js";
+/**
+ * Publish the resolved selection into the base layer — with the one state the
+ * client can only learn from here, and with the static notice that goes with it.
+ * The Windows-executable state is keyed on the *selection*, not on any probe: a
+ * Windows binary answers `--version` just fine across the interop boundary, so a
+ * healthy-looking pill is exactly what a broken Windows selection looks like
+ * until the first tool call fails.
+ */
+export function noteSelection(controller) {
+    const { state } = controller;
+    state.entry.effectiveChromePath = state.runningChromePath;
+    state.entry.effectiveSource = state.runningChromeSource;
+    const windowsUnderWsl = !flagsSkipCheck(state.runningFlags) && controller.wslHost && isWindowsExecutablePath(state.runningChromePath);
+    state.entry.wslWindowsExecutable = windowsUnderWsl;
+    // The card has the full recipe; the log only needs the pointer, since a
+    // headless host never sees the notice.
+    if (windowsUnderWsl && !state.wslNoticeShown) {
+        state.wslNoticeShown = true;
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): running under WSL with a Windows executable selected ("${state.runningChromePath}") — that binary cannot be launched from here; drive the Windows browser in connect mode instead (see the card's Windows executable notice)`);
+    }
+}
+/**
+ * Announce where the bridge's console output goes — one line per change of
+ * state, keyed on what actually happened, so neither the "log" capture nor
+ * a switch to console echo is silent. An unavailable redirect (no POSIX shell)
+ * warns with the reason so the fallback is not mysterious.
+ */
+export function noteStderr(controller, built) {
+    const { state } = controller;
+    const key = built.redirect !== "" ? `file:${built.redirect}` : built.fallback !== "" ? `fallback:${built.fallback}` : "console";
+    if (state.stderrNotice === key)
+        return;
+    state.stderrNotice = key;
+    if (built.fallback === "platform") {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): bridgeStderr="log" is unavailable on this platform (no POSIX shell wrapper) — bridge logs keep going to the console`);
+    }
+    else if (built.fallback === "shell") {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): bridgeStderr="log" is unavailable (no /bin/sh was found) — bridge logs keep going to the console`);
+    }
+    else if (built.redirect !== "") {
+        controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): bridge stderr → ${built.redirect}`);
+    }
+    else {
+        controller.ctx.logger.info(`chrome-devtools-mcp(${controller.config.serverName}): bridge stderr → console (echo)`);
+    }
+}
+//# sourceMappingURL=notes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/host/controller/notes.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAIzD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAAsB;IAChD,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,KAAK,CAAC,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC1D,KAAK,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,mBAAmB,CAAC;IACxD,MAAM,eAAe,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,OAAO,IAAI,uBAAuB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACtI,KAAK,CAAC,KAAK,CAAC,oBAAoB,GAAG,eAAe,CAAC;IACnD,wEAAwE;IACxE,uCAAuC;IACvC,IAAI,eAAe,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CACtB,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,6DAA6D,KAAK,CAAC,iBAAiB,6IAA6I,CACvR,CAAC;IACN,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,UAAsB,EAAE,KAAyB;IACxE,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChI,IAAI,KAAK,CAAC,YAAY,KAAK,GAAG;QAAE,OAAO;IACvC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC;IACzB,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAChC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,wHAAwH,CAAC,CAAC;IAC5M,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACpC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,qGAAqG,CAAC,CAAC;IACzL,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC/B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,sBAAsB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1H,CAAC;SAAM,CAAC;QACJ,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,mCAAmC,CAAC,CAAC;IACvH,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ChromeExecutableEntry } from "../types/index.js";
+import type { Controller } from "./state.js";
+/** Persist one seeded/executable write through the settings service. */
+export declare function persistChromePath(controller: Controller, path: string): Promise<void>;
+/** Persist the saved-executables rows a run merged into. */
+export declare function persistExecutables(controller: Controller, entries: ChromeExecutableEntry[]): Promise<void>;
+/** Persist the saved flags list a Windows connect run composed. */
+export declare function persistExtraFlags(controller: Controller, flags: string[]): Promise<void>;
+//# sourceMappingURL=persist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/host/controller/persist.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7C,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3F;AAED,4DAA4D;AAC5D,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhH;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9F"}

package/lib/host/controller/persist.js

@@ -0,0 +1,51 @@
+/**
+ * Controller — settings persistence.
+ *
+ * The three writes a run may need to make back into the persisted settings
+ * section: the seeded executable, the saved rows a merged scan folded in, and
+ * the connect-mode flag a Windows run composed. All three follow the same rule —
+ * never throw out of a run, because the base layer is what the card reads and a
+ * failed write must not break an otherwise successful run.
+ */
+import { SETTINGS_NAMESPACE } from "../constants.js";
+/** Read the `settings` service surface as consumed here (`mutate` only). */
+function settingsService(controller) {
+    return controller.ctx.get("settings");
+}
+/** Persist one seeded/executable write through the settings service. */
+export async function persistChromePath(controller, path) {
+    try {
+        const settings = settingsService(controller);
+        if (!settings || typeof settings.mutate !== "function")
+            return;
+        await Promise.resolve(settings.mutate(SETTINGS_NAMESPACE, [{ op: "set", path: ["chromePath"], value: path }]));
+    }
+    catch (error) {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): failed to persist the seeded chromePath: ${String(error)}`);
+    }
+}
+/** Persist the saved-executables rows a run merged into. */
+export async function persistExecutables(controller, entries) {
+    try {
+        const settings = settingsService(controller);
+        if (!settings || typeof settings.mutate !== "function")
+            return;
+        await Promise.resolve(settings.mutate(SETTINGS_NAMESPACE, [{ op: "set", path: ["executables"], value: entries }]));
+    }
+    catch (error) {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): failed to persist the executable rows: ${String(error)}`);
+    }
+}
+/** Persist the saved flags list a Windows connect run composed. */
+export async function persistExtraFlags(controller, flags) {
+    try {
+        const settings = settingsService(controller);
+        if (!settings || typeof settings.mutate !== "function")
+            return;
+        await Promise.resolve(settings.mutate(SETTINGS_NAMESPACE, [{ op: "set", path: ["extraFlags"], value: flags }]));
+    }
+    catch (error) {
+        controller.ctx.logger.warn(`chrome-devtools-mcp(${controller.config.serverName}): failed to persist the connect-mode flag: ${String(error)}`);
+    }
+}
+//# sourceMappingURL=persist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","sourceRoot":"","sources":["../../../src/host/controller/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAKrD,4EAA4E;AAC5E,SAAS,eAAe,CAAC,UAAsB;IAC3C,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAqE,CAAC;AAC9G,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAsB,EAAE,IAAY;IACxE,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO;QAC/D,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,+CAA+C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClJ,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAsB,EAAE,OAAgC;IAC7F,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO;QAC/D,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,6CAA6C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChJ,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAsB,EAAE,KAAe;IAC3E,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO;QAC/D,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,CAAC,MAAM,CAAC,UAAU,+CAA+C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClJ,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,56 @@
+import type { ChromeExecutableEntry, ChromeExecutableStatus, EffectiveChromeSource } from "../types/index.js";
+import type { Controller } from "./state.js";
+/** The serialized units one controller may queue. */
+export type RunKind = "refresh" | "probe" | "windows";
+/** Element-wise equality of two saved-row lists (order is the dropdown order). */
+export declare function sameEntries(a: readonly ChromeExecutableEntry[], b: readonly ChromeExecutableEntry[]): boolean;
+/**
+ * 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 declare function mergeLegacyPaths(controller: Controller): ChromeExecutableEntry[];
+/**
+ * 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 declare function runExecutableDiscovery(controller: Controller): Promise<ChromeExecutableStatus[]>;
+/**
+ * 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 declare function probeSelection(controller: Controller): Promise<string>;
+/**
+ * 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 declare function applyChromePath(controller: Controller, path: string, nextSource: EffectiveChromeSource, rerun?: boolean): void;
+/**
+ * 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 declare function queue(controller: Controller, kind: RunKind): Promise<unknown>;
+/**
+ * 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 declare function prelaunchWindowsChrome(controller: Controller): Promise<string>;
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../../src/host/controller/runs.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAO9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qDAAqD;AACrD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtD,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,qBAAqB,EAAE,EAAE,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,OAAO,CAG7G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,qBAAqB,EAAE,CAehF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmDtG;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,EAAE,KAAK,UAAO,GAAG,IAAI,CAY3H;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAc7E;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAWpF"}