@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

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

@@ -1,25 +1,9 @@
 import { type WindowsChromeRunOptions } from "../windows/index.js";
-import type { ChromeMcpConfig, PluginContext, SettingsResolved, WindowsChromeRun } from "../types/index.js";
-/** The live state one apply() keeps in memory. */
-export interface ChromeMcpController {
-    /** The composition base layer served alongside the user layer. */
-    readonly entry: SettingsResolved;
-    /** Swap the live resolved settings source (installSection hook). */
-    setSource(next: () => SettingsResolved): void;
-    /** Route one settings commit: relaunch on flag or executable drift, and run
-     * one executable refresh on the search trigger. */
-    onSettingsChange(): void;
-    /** Run one executable refresh (probe the candidates, merge what is found
-     * into the saved rows, seed a never-configured host). Runs are serialized so
-     * rapid actions never interleave. */
-    run(): Promise<unknown>;
-    /** Run the Windows Chrome path once (locate, prereq, port, launch, connect)
-     * on the same one-run-at-a-time chain the button drives through, and answer
-     * with what the run stated. This is the MCP-tool surface of the button: the
-     * trigger is the call itself — nothing is persisted, so a booting host never
-     * launches a browser on its own. Resolves after the run settles. */
-    prelaunchWindowsChrome(): Promise<string>;
-}
+import type { ChromeMcpConfig, PluginContext, WindowsChromeRun } from "../types/index.js";
+import type { Controller } from "./state.js";
+/** Public alias: the controller object the form, commands and kinds work
+ * through is the internal `Controller` type itself. */
+export type ChromeMcpController = Controller;
 /**
  * Optional overrides for tests and diagnostics: the Windows Chrome run is the
  * only half that reaches outside the process (it opens TCP sockets and spawns
@@ -28,13 +12,24 @@ export interface ChromeMcpController {
  */
 export type ChromeMcpControllerDeps = {
     runWindowsChrome?: (options: WindowsChromeRunOptions) => Promise<WindowsChromeRun>;
+    /** The Windows-side executables this host carries, in preference order. The
+     * machine half of the candidate fold — the real one locates through the
+     * interop mount; a test supplies the answer list it wants folded. */
+    windowsExecutables?: () => string[];
+    /** The platform the WSL probe reads; defaults to `process.platform`. A test
+     * that simulates a WSL host through its launch environment states `linux`
+     * here too — the environment alone never makes a Windows host WSL. */
+    platform?: NodeJS.Platform;
 };
 /**
- * Build the live state for one bridge + card pairing.
+ * Build the live state for one row page. The controller is also the public
+ * surface (`ChromeMcpController` — the same object the form, the commands and
+ * the kinds work through); what each method does lives in the sibling modules.
  * @param ctx - plugin context.
- * @param config - validated row config.
+ * @param config - the validated config `apply` received: every `.volatile()`
+ * field a reference rather than a value (read them through `readConfigField`).
  * @param deps - optional host overrides (tests replace the Windows run;
  * everything else resolves from this process).
  */
-export declare function createChromeMcpController(ctx: PluginContext, config: ChromeMcpConfig, deps?: ChromeMcpControllerDeps): ChromeMcpController;
+export declare function createChromeMcpController(ctx: PluginContext, config: ChromeMcpConfig, deps?: ChromeMcpControllerDeps): Controller;
 //# sourceMappingURL=controller.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/host/controller/controller.ts"],"names":[],"mappings":"AA6BA,OAAO,EAA2B,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE5F,OAAO,KAAK,EAER,eAAe,EAEf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAS3B,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAC9C;uDACmD;IACnD,gBAAgB,IAAI,IAAI,CAAC;IACzB;;yCAEqC;IACrC,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB;;;;wEAIoE;IACpE,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAE,uBAA4B,GAAG,mBAAmB,CAwI9I"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/host/controller/controller.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAyD,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAY1H,OAAO,KAAK,EACR,eAAe,EAEf,aAAa,EACb,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AAE9D;uDACuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnF;;yEAEqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IACpC;;0EAEsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAE,uBAA4B,GAAG,UAAU,CAgMrI"}

package/lib/host/controller/controller.js

@@ -1,122 +1,137 @@
 /**
  * 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.
+ * One controller per apply(): the live mirror the Host publishes, the serialized
+ * executable runs, the Windows run half, and the capture paths — tool-call
+ * results reaching the live mirror. Every live answer is written into
+ * `state.live` and published through the volatile references (see ./publish.ts);
+ * form 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.
+ * Since the component model, the controller starts nothing: every live bridge is
+ * a connection of the manager's, answered through ./kind.ts. What this half owns
+ * is the machine — the executable catalog and its runs, the Windows run, the
+ * layers, and the mirror — plus the seam the manager reads it through (the
+ * connection service sits on `state.connections`, installed by ../manager.ts).
  *
- * 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.
+ * The executable state keeps the rule that there is no auto mode: the saved
+ * **rows** (`{ id: path, name: label }`) are what every picker lists, the
+ * *selection* is what the default answers run 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, seeds
+ * the live mirror, 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 { existsSync } from "node:fs";
 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 { FLAGS_ENV_VAR, WSL_WINDOWS_LAUNCH_ERROR } from "../constants.js";
+import { flagsSkipCheck } 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";
+import { findWindowsChromeExecutables, runWindowsChromeConnect } from "../windows/index.js";
+import { createLiveMirror, readConfigForm, readConfigLayers, readDefaultExtraFlags, readWslExtraFlags, resolveEnvFlags, resolveLaunchFlags, resolveSelection, resolveStderrModeFromLayers } from "../values.js";
+import { registerToolCapture } from "./captures.js";
+import { noteRunning as mirrorRunning } from "./connections.js";
+import { onFormCommit } from "./commits.js";
+import { noteSelection } from "./notes.js";
+import { dismissMigration, } from "./persist.js";
+import { cancelDiscoveryRetry, prelaunchWindowsChrome, queue, selectChromePath } from "./runs.js";
+import { prelaunchWindowsForConnection } from "./windows-run.js";
 /**
- * Build the live state for one bridge + card pairing.
+ * Build the live state for one row page. The controller is also the public
+ * surface (`ChromeMcpController` — the same object the form, the commands and
+ * the kinds work through); what each method does lives in the sibling modules.
  * @param ctx - plugin context.
- * @param config - validated row config.
+ * @param config - the validated config `apply` received: every `.volatile()`
+ * field a reference rather than a value (read them through `readConfigField`).
  * @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).
+    // The Windows run half — injectable for 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;
+    const launchFlags = 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
+    // the local 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 });
+    const wslHost = isWindowsSubsystemForLinux({ platform: deps.platform, env: (name) => launchEnvironment.get(name)?.value });
+    // The Linux half of the host: the executable candidate list models the
+    // stable-channel installs a Linux host carries, so this is what keys the
+    // executable-missing answer's advice (see runs.ts). WSL is the case with the
+    // Windows-side alternative next to it.
+    const linuxHost = process.platform === "linux";
     // 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
+    // see WSL_WINDOWS_LAUNCH_ERROR. The runs keep 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 Windows-side executables this host carries, located through the interop
+    // mount. An executable run folds them into its candidate list so the picker
+    // can name the Windows browser the **Prelaunch Windows Chrome** run drives
+    // instead of hiding it. Being offered only, they are never spawned (see
+    // `blockedForPlatform`): an entry answers a note, never a version, and never
+    // seeds. Locating them is the machine half of the fold, injected the same way
+    // the run's own `exists` half is — a host off WSL answers nothing, and a
+    // machine that carries none of them answers nothing either.
+    const windowsExecutables = typeof deps.windowsExecutables === "function"
+        ? deps.windowsExecutables
+        : () => (wslHost ? findWindowsChromeExecutables(existsSync) : []);
+    // The configuration form's layers as they answer right now. The references
+    // resolve the user layer over the row config, so every answer here is the
+    // effective one; the two layers the "did the user say this, or is it the row
+    // config" distinction reads only answer once the form attaches, and the first
+    // commit read settles it.
+    const layers = readConfigLayers(config);
+    // Default launch flags (highest first): the user layer,
+    // `DSH_CHROME_MCP_FLAGS`, the row config, the schema default. What a
+    // connection with no own answer is resolved with starts on them.
+    const initialFlags = resolveLaunchFlags(layers, launchFlags);
+    if (typeof launchFlags === "string" && launchFlags.trim() !== "" && resolveEnvFlags([], launchFlags).length === 0) {
+        ctx.logger.warn(`dsh-chrome-mcp(${config.serverName}): ignoring ${FLAGS_ENV_VAR} — invalid flags list; using the resolved configuration`);
     }
-    // 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)
-    };
+    // The initial selection: what the user layer says, else what the row config
+    // says (a legacy row-level `--executablePath` folded in — the picker owns that
+    // flag, so it becomes the row-config source of the selection and never reaches
+    // argv as a second source of truth), else nothing. Nothing here consults
+    // discovery: the first run does, and only seeds when both layers are silent.
+    const selection = resolveSelection(layers);
+    const runningChromePath = selection.path;
+    const runningChromeSource = selection.source;
+    // The effective console-output mode: what the user layer's toggle says, then
+    // what the row config carries, then the row's `bridgeStderr`. Every spawn
+    // wrapper reads it.
+    const runningStderrMode = resolveStderrModeFromLayers(layers, config.bridgeStderr);
+    // The mirror's opening answers: what the default answers would run with, not
+    // what a host with no answers would serve. `windowsChromeStatus` in particular
+    // reads off this host from the start — the Windows path simply does not exist
+    // off WSL.
+    const live = createLiveMirror();
+    live.effectiveChromePath = runningChromePath;
+    live.effectiveSource = runningChromeSource;
+    live.stderrEffective = runningStderrMode;
+    live.wslWindowsExecutable = wslHost && runningChromePath !== "" && isWindowsExecutablePath(runningChromePath);
+    live.carriesConnectionMode = flagsSkipCheck(initialFlags);
+    live.windowsChromeStatus = { state: wslHost ? "off" : "not-applicable", port: 0, error: "" };
+    live.defaultExtraFlags = readDefaultExtraFlags();
+    live.wslExtraFlags = readWslExtraFlags();
     const state = {
-        entry,
-        source: () => entry,
+        live,
+        form: void 0,
+        // The live layers read: the references answer what runs now, and once the
+        // form is described the two layers answer the distinction with it. This is
+        // read live on every commit — cordis starts the `settings` injection
+        // callback after `apply` returns, so nothing may be captured here.
+        source: () => readConfigLayers(config, state.form?.settings ? readConfigForm(state.form.settings, state.form.entryId) : void 0),
         runningFlags: initialFlags,
         runningStderrMode,
         runningChromePath,
@@ -128,40 +143,92 @@ export function createChromeMcpController(ctx, config, deps = {}) {
         seededPath: "",
         seenUserSelection: false,
         runs: Promise.resolve(),
+        retryTimer: void 0,
+        retriesPending: 0,
+        disposed: false,
         wslNoticeShown: false,
         profileLinkKeptShown: false,
-        legacyPathsMerged: false
+        legacyPathsMerged: false,
+        legacyPinAnnounced: false,
+        mirror: void 0,
+        kindsNotifyQueued: false,
+        // The manager seam opens empty: `attachToManager` fills it in once the
+        // service answers. A component without the manager answers its own page
+        // and starts nothing — exactly as a row with no connections should.
+        connections: void 0,
+        notifyKindsChanged: () => void 0
     };
     const controller = {
         ctx,
         config,
         wslHost,
+        linuxHost,
         blockedForPlatform,
-        rowChromePath,
-        rowFlags,
+        launchFlags,
         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;
+        windowsExecutables,
+        state,
+        attachForm(form) {
+            state.form = form;
+            const nowDescribed = form.settings !== void 0;
+            // The first attach is the mount's commit read: no nonce has been
+            // observed yet, so its nonce diff fires the registration run. The step
+            // where the row starts being *described* is routed too, for the one
+            // thing the references cannot answer: which layer a value came from.
+            // Until it answers there, the launch environment sits above whatever
+            // the references carry, so a saved UI edit has to be re-read against
+            // the user layer the moment that layer exists.
+            const first = !routed;
+            const layersArrived = nowDescribed && !described;
+            routed = true;
+            described = nowDescribed;
+            if (!first && !layersArrived)
+                return;
+            onFormCommit(controller);
         },
-        run: () => queue(controller, "refresh"),
+        detachForm() {
+            // Only the described row's layers go away: the references keep
+            // answering, so nothing else has to be undone.
+            state.form = void 0;
+            routed = false;
+            described = false;
+        },
+        onFormCommit: () => onFormCommit(controller),
+        run: () => queue(controller, "probe"),
+        source: () => state.source(),
+        // The live mirror, by reference: controller modules write its fields in
+        // place, publish reads them off `state.live`, and every other surface
+        // (the commands) reads the very same answers out of it.
+        get live() {
+            return state.live;
+        },
+        selectChromePath: (path) => selectChromePath(controller, path),
         prelaunchWindowsChrome: () => prelaunchWindowsChrome(controller),
-        onSettingsChange: () => onSettingsChange(controller)
+        noteRunning(entry, answers) {
+            mirrorRunning(controller, entry.id, answers);
+        },
+        prelaunchForConnection: () => prelaunchWindowsForConnection(controller),
+        dismissMigration: () => dismissMigration(controller),
+        dispose: () => {
+            // Every late answer stands down: the run chain drains on its own (the
+            // chain is per-instance, no shared resource left behind), and the one
+            // timer this instance owns is cancelled.
+            state.disposed = true;
+            cancelDiscoveryRetry(controller);
+        }
     };
+    // Form routing arrives in two steps — the entry id as soon as this fiber knows
+    // its own entry, then the described row once the settings service resolves —
+    // and the layers read live off it either way (the two flags above are what
+    // mark the difference between "never described" and "described before").
+    let routed = false;
+    let described = false;
+    // Tool-level status: browser-level failures are returned to the calling agent
+    // and never reach a line of their own.
+    registerToolCapture(controller);
+    // Seed the mirror before the first snapshot lands (a card that reads before
+    // anything ran still gets the real opening answers, never defaults).
+    noteSelection(controller);
+    return controller;
 }
 //# sourceMappingURL=controller.js.map

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

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

@@ -1,26 +1,30 @@
 /**
  * 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:
+ * One controller per apply(): the live mirror the Host publishes, the serialized
+ * executable runs, the Windows run half, and the tool-call capture path. The
+ * public surface is `createChromeMcpController` (the controller object itself);
+ * 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
+ *   ./controller.ts   the assembly: resolve config, seed the live mirror, 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)
+ *   ./notes.ts        live-mirror announcements (selection, stderr)
+ *   ./connections.ts  the manager seam: what answers reach the live state, and
+ *                     how a default answer change reaches live connections
  *   ./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`)
+ *   ./persist.ts      the form writes a run makes (seed, rows, dismissal)
+ *   ./captures.ts     tool-call-result capture
+ *   ./commits.ts      configuration-form commit routing (`onFormCommit`)
  *
- * 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.
+ * The two rules that must survive the split: read the layers through
+ * `state.source()` at commit time, never capture them, and route every live answer
+ * out through `publishLive` (./publish.ts) — configuration-form commits route in,
+ * never out, and the live mirror is never written by a commit path.
  */
 export { createChromeMcpController } from "./controller.js";
 export type { ChromeMcpController, ChromeMcpControllerDeps } from "./controller.js";
+export type { Controller, ControllerState } from "./state.js";
+export type { RunningAnswers } from "./connections.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/host/controller/index.js

@@ -1,25 +1,27 @@
 /**
  * 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:
+ * One controller per apply(): the live mirror the Host publishes, the serialized
+ * executable runs, the Windows run half, and the tool-call capture path. The
+ * public surface is `createChromeMcpController` (the controller object itself);
+ * 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
+ *   ./controller.ts   the assembly: resolve config, seed the live mirror, 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)
+ *   ./notes.ts        live-mirror announcements (selection, stderr)
+ *   ./connections.ts  the manager seam: what answers reach the live state, and
+ *                     how a default answer change reaches live connections
  *   ./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`)
+ *   ./persist.ts      the form writes a run makes (seed, rows, dismissal)
+ *   ./captures.ts     tool-call-result capture
+ *   ./commits.ts      configuration-form commit routing (`onFormCommit`)
  *
- * 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.
+ * The two rules that must survive the split: read the layers through
+ * `state.source()` at commit time, never capture them, and route every live answer
+ * out through `publishLive` (./publish.ts) — configuration-form commits route in,
+ * never out, and the live mirror is never written by a commit path.
  */
 export { createChromeMcpController } from "./controller.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/controller/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,16 +1,17 @@
 /**
- * Controller — base-layer announcements.
+ * Controller — live-mirror 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.
+ * The two answers the card can only learn from here: the resolved selection
+ * (with the WSL + Windows-executable state, keyed on the *selection*, not a
+ * probe), and where the bridge console output goes. Both land in the live mirror
+ * and reach the card through one volatile commit (see ./publish.ts).
  */
 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
+ * Publish the resolved selection into the mirror — with the one state the card
+ * 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.
@@ -19,8 +20,7 @@ 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.
+ * a switch to console echo is silent.
  */
 export declare function noteStderr(controller: Controller, built: BridgeStderrNotice): void;
 //# sourceMappingURL=notes.d.ts.map