@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

package/lib/host/apply.d.ts

@@ -1,3 +1,40 @@
+/**
+ * Host-half assembly — the wiring file.
+ *
+ * `apply` is deliberately the only host module that knows the parts exist; each
+ * part keeps its own behavior:
+ *
+ *   ./controller/   the live mirror, the executable runs, the Windows run, the
+ *                   capture paths
+ *   ./manager.ts    the `chrome` + `chrome-windows` kinds and the standalone
+ *                   translation — what this component says to the manager
+ *   ./settings.ts   the configuration form's attach + commit routing + id rule
+ *   ./commands/     the two headless-mirror slash commands
+ *   ./tool.ts       the MCP-side `prelaunch_windows_chrome` trigger
+ *
+ * The ordering rule that must survive the split: read the live layers through
+ * `source()` at commit time, never capture them — cordis starts the `settings`
+ * injection callback after `apply` returns, so a captured value would pin every
+ * consumer to the row config and no mid-session GUI edit would ever reach a
+ * live connection.
+ *
+ * What changed with the component model: this row **no longer starts a bridge
+ * of its own**. It answers live `chrome` / `chrome-windows` connections instead,
+ * and answers nothing at all when no manager is mounted. Mounting therefore
+ * stands up the machine half (the mirror, the executable catalog, the runs) and
+ * registers the kinds; whether anything runs is the pool's decision.
+ *
+ * @param ctx - plugin context.
+ * @param config - validated config (every volatile field a reference).
+ */
+import { type ChromeMcpControllerDeps } from "./controller/index.js";
 import type { ChromeMcpConfig, PluginContext } from "./types/index.js";
-export declare function apply(ctx: PluginContext, config: ChromeMcpConfig): void;
+/**
+ * @param deps - the controller's optional host overrides, passed straight
+ * through. Nothing ordinary supplies them — the wiring reaches the machine
+ * through the controller's own defaults, so this parameter is what lets a test
+ * or a diagnostic answer the machine half (the Windows run, the Windows-side
+ * executables the run folds into a candidate list) with a known list.
+ */
+export declare function apply(ctx: PluginContext, config: ChromeMcpConfig, deps?: ChromeMcpControllerDeps): void;
 //# sourceMappingURL=apply.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/host/apply.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAIvE"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/host/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhG,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAE,uBAA4B,GAAG,IAAI,CAc3G"}

package/lib/host/apply.js

@@ -1,31 +1,57 @@
 /**
  * Host-half assembly — the wiring file.
  *
- * `apply` is deliberately the only host module that knows the two parts
- * exist; each part keeps its own behavior:
+ * `apply` is deliberately the only host module that knows the parts exist; each
+ * part keeps its own behavior:
  *
- *   ./controller/   the live bridge state (entry, bridge, checks, captures)
- *   ./settings.ts     the namespace install + commit routing + validation
+ *   ./controller/   the live mirror, the executable runs, the Windows run, the
+ *                   capture paths
+ *   ./manager.ts    the `chrome` + `chrome-windows` kinds and the standalone
+ *                   translation — what this component says to the manager
+ *   ./settings.ts   the configuration form's attach + commit routing + id rule
+ *   ./commands/     the two headless-mirror slash commands
+ *   ./tool.ts       the MCP-side `prelaunch_windows_chrome` trigger
  *
- * The ordering rule that must survive the split: read the live settings value
- * through `source()` at commit time, never capture it — cordis starts the
- * `settings` injection callback after `apply` returns, so a captured value
- * would pin every consumer to the row config and no mid-session GUI edit
- * would ever reach the running bridge.
+ * The ordering rule that must survive the split: read the live layers through
+ * `source()` at commit time, never capture them — cordis starts the `settings`
+ * injection callback after `apply` returns, so a captured value would pin every
+ * consumer to the row config and no mid-session GUI edit would ever reach a
+ * live connection.
  *
- * Mount the DSH Chrome MCP server bridge and its settings-backed card.
- * Flags precedence: settings user layer (UI edit) > FLAGS_ENV_VAR (launch
- * env) > row config `extraFlags` > schema default.
+ * What changed with the component model: this row **no longer starts a bridge
+ * of its own**. It answers live `chrome` / `chrome-windows` connections instead,
+ * and answers nothing at all when no manager is mounted. Mounting therefore
+ * stands up the machine half (the mirror, the executable catalog, the runs) and
+ * registers the kinds; whether anything runs is the pool's decision.
  *
  * @param ctx - plugin context.
- * @param config - validated {@link ChromeMcpConfig}.
+ * @param config - validated config (every volatile field a reference).
  */
 import { createChromeMcpController } from "./controller/index.js";
-import { installChromeMcpSection } from "./settings.js";
+import { installChromeMcpCommands } from "./commands/index.js";
+import { attachToManager } from "./manager.js";
+import { installChromeMcpForm } from "./settings.js";
 import { installPrelaunchWindowsChromeTool } from "./tool.js";
-export function apply(ctx, config) {
-    const controller = createChromeMcpController(ctx, config);
-    installChromeMcpSection(ctx, controller);
+/**
+ * @param deps - the controller's optional host overrides, passed straight
+ * through. Nothing ordinary supplies them — the wiring reaches the machine
+ * through the controller's own defaults, so this parameter is what lets a test
+ * or a diagnostic answer the machine half (the Windows run, the Windows-side
+ * executables the run folds into a candidate list) with a known list.
+ */
+export function apply(ctx, config, deps = {}) {
+    const controller = createChromeMcpController(ctx, config, deps);
+    // Stand the instance down when the mount goes away: a hot re-apply must not
+    // leave the previous instance's late answers (a scheduled retry above all)
+    // firing runs no one asked for.
+    ctx.effect(() => () => {
+        controller.dispose();
+    }, "chrome-mcp: controller teardown");
+    // The kinds come first, before the form: a connection saved under either
+    // kind is answered through them, and a proposal names them by id.
+    attachToManager(ctx, controller);
+    installChromeMcpForm(ctx, controller);
     installPrelaunchWindowsChromeTool(ctx, controller);
+    installChromeMcpCommands(ctx, config, controller);
 }
 //# sourceMappingURL=apply.js.map

package/lib/host/apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/host/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iCAAiC,EAAE,MAAM,WAAW,CAAC;AAG9D,MAAM,UAAU,KAAK,CAAC,GAAkB,EAAE,MAAuB;IAC7D,MAAM,UAAU,GAAG,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1D,uBAAuB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,iCAAiC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/host/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,yBAAyB,EAAgC,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iCAAiC,EAAE,MAAM,WAAW,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,GAAkB,EAAE,MAAuB,EAAE,OAAgC,EAAE;IACjG,MAAM,UAAU,GAAG,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAChE,4EAA4E;IAC5E,2EAA2E;IAC3E,gCAAgC;IAChC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QAClB,UAAU,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC,EAAE,iCAAiC,CAAC,CAAC;IACtC,yEAAyE;IACzE,kEAAkE;IAClE,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACjC,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACtC,iCAAiC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnD,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/lib/host/bridge.d.ts

@@ -1,9 +1,17 @@
 import type * as McpClient from "@deepseek-ai/dsh-mcp-client";
 import type { BridgeSpawnOptions, BridgeSpawnResult, BridgeSpawnTarget, BridgeStderrLogPathOptions, BridgeStderrMode, ChromeMcpConfig } from "./types/index.js";
+/** The CLI of the `chrome-devtools-mcp` this package depends on (pinned). */
+export declare function pinnedServerCli(): string;
+/** Whether a row runs the pinned server: it names no launcher of its own (the
+ * schema defaults, or blanks). */
+export declare function usesPinnedServer(entry: Pick<ChromeMcpConfig, "command" | "package">): boolean;
+/** The executable one row's server runs under: this Node for the pinned
+ * server, the row's own `command` otherwise. */
+export declare function serverCommand(entry: Pick<ChromeMcpConfig, "command" | "package">, execPath?: string): string;
 /**
- * Build the stdio argv tail for one flags list:
- * `-y <package> [extraFlags]`, the argv tail {@link buildBridgeSpawn} runs, so
- * the logical invocation is `npx -y chrome-devtools-mcp@latest [extraFlags]`.
+ * Build the stdio argv tail for one flags list — `<pinned cli> [extraFlags]`
+ * for the pinned server, `-y <package> [extraFlags]` for a row's own launcher;
+ * the argv {@link buildBridgeSpawn} runs after {@link serverCommand}.
  * When `chromePath` is set and the flags do not already carry an executable-path
  * option, `--executablePath=<path>` is appended (upstream option:
  * https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/configuration.md).
@@ -14,10 +22,12 @@ import type { BridgeSpawnOptions, BridgeSpawnResult, BridgeSpawnTarget, BridgeSt
  */
 export declare function buildServerArgs(entry: ChromeMcpConfig, extraFlags: string[]): string[];
 /**
- * Default location of the bridge stderr log:
- * `<tmpdir>/dsh-chrome-mcp-<serverName>-bridge-<pid>.log`. One file per running
- * dsh instance; the wrapper truncates it on every spawn, so it always holds the
- * latest bridge session's output.
+ * Default location of the bridge stderr log — `@comecaramelos/dsh-ancesters`'
+ * private per-host directory (`mkdtemp`, mode `0700`), one
+ * `<serverName>-bridge.log` per bridge, truncated on every spawn. Nothing in it
+ * can be planted by another local principal before the first spawn.
+ *
+ * `options.tmpdir` keeps a flat, deterministic name for tests and diagnostics.
  * @param serverName - the bridge server namespace.
  * @param options - tmpdir/pid overrides for tests and diagnostics.
  */
@@ -25,16 +35,16 @@ export declare function bridgeStderrLogPath(serverName: unknown, options?: Bridg
 /**
  * Build the stdio spawn target for one bridge run, honouring the effective
  * stderr mode. The MCP stdio transport spawns the child with the default
- * `stderr: "inherit"`, so every line it prints lands on the dsh console. "log"
- * (default) wraps the spawn in `sh -c`: stdout keeps flowing as the MCP
- * protocol stream, stderr is redirected into a log file. "console" returns the
- * raw command/args (inherited console output). When no POSIX shell is available
- * the redirect is impossible: the raw command is returned with `fallback` set,
- * and the host's {@link noteStderr} warns once.
+ * `stderr: "inherit"`, so every line it prints lands on the dsh console.
+ * "log" (default) launches the argv through ancestros' Node wrapper (D5:
+ * `process.execPath` + a shipped script, the same route on Linux, WSL and
+ * Windows): stdout keeps flowing as the MCP protocol stream, stderr goes to
+ * the log file, the argv reaches the child verbatim. "console" returns the raw
+ * command/args (inherited console output).
  * @param target - { command, args, stderr?, logPath?, serverName? }.
- * @param options - platform/exists/tmpdir/pid overrides for tests.
- * @returns { command, args, redirect, fallback } — the log file when redirected
- * ("" otherwise) and why not ("" when redirected or console).
+ * @param options - execPath/tmpdir/pid overrides for tests.
+ * @returns { command, args, redirect } — the log file when redirected, "" when
+ * the console echoes. There is no fallback left: Node is always there.
  */
 export declare function buildBridgeSpawn(target: BridgeSpawnTarget, options?: BridgeSpawnOptions): BridgeSpawnResult;
 /**
@@ -43,19 +53,18 @@ export declare function buildBridgeSpawn(target: BridgeSpawnTarget, options?: Br
  * (`npx -y <package> [extraFlags]`, run as `command`), wrapped through
  * {@link buildBridgeSpawn} so the child's stderr lands in a log file instead of
  * the console when the mode is "log". The returned config carries only
- * dsh-mcp-client fields; `redirect`/`fallback` describe the wrapper for the
+ * dsh-mcp-client fields; `redirect` describes the wrapper for the
  * host's own diagnostics.
  */
 export declare function bridgeConfig(entry: ChromeMcpConfig, extraFlags: string[], stderrMode?: BridgeStderrMode): {
     config: McpClient.StdioConfig;
     redirect: string;
-    fallback: string;
 };
 /**
  * Wrap a logger so a callback observes every level call before the
  * original runs. Used to capture the nested bridge's own log lines (the only
  * surface dsh-mcp-client exposes for connection failures — reconnect
- * backoff warnings, spawn failures, give-ups) into the settings base layer.
+ * backoff warnings, spawn failures, give-ups) into the live mirror.
  * The wrapper shares the underlying LoggerService (exporters/buffer included)
  * and only shadows the level methods.
  * @param base - the base logger to wrap (cordis LoggerService).

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

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/host/bridge.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,KAAK,SAAS,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EACR,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EAClB,MAAM,kBAAkB,CAAC;AAiB1B;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQtF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAKzG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA6B/G;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,gBAAgB;;;;EAuBvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACrD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAcjD"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/host/bridge.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,KAAK,SAAS,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EACR,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EAClB,MAAM,kBAAkB,CAAC;AAO1B,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;kCACkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAI7F;AAED;gDACgD;AAChD,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,CAAC,EAAE,QAAQ,GAAE,MAAyB,GAAG,MAAM,CAE9H;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAUtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAEzG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAY/G;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,gBAAgB;;;EAwBvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACrD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAcjD"}

package/lib/host/bridge.js

@@ -1,14 +1,20 @@
 /**
  * The nested `dsh-mcp-client` bridge: its stdio argv + config, the stderr
  * capture wrapper, and the logger wrapper that captures its own log lines into
- * the settings base layer.
+ * the live mirror.
  *
  * The bridge's *logical* argv is the public contract the tests and the README
- * quote — `npx -y <package> [extraFlags]`, with `--executablePath=<chromePath>`
- * appended only when a path is configured and the flags list does not already
- * pin an executable. In the default "log" stderr mode that argv is not spawned
- * raw: {@link buildBridgeSpawn} wraps it in a `sh -c` whose script `exec`s the
- * argv positionally (so the child never sees the wrapper) and redirects only
+ * quote. By default it is the `chrome-devtools-mcp` this package depends on,
+ * pinned, run by the same Node that runs the host —
+ * `<node> <chrome-devtools-mcp cli> [extraFlags]`, the way dsh's own
+ * chrome-devtools provider runs it: no `npx`, no registry on every start, the
+ * same route on Linux, WSL and Windows (breaking in 2.0). A row that names its
+ * own `command` or `package` keeps `<command> -y <package> [extraFlags]`.
+ * `--executablePath=<chromePath>` is appended only when a path is configured
+ * and the flags list does not already pin an executable. In the default "log"
+ * stderr mode that argv is not spawned
+ * raw: {@link buildBridgeSpawn} launches it through ancestros' Node wrapper, which
+ * hands the argv over verbatim (the child never sees the wrapper) and sends only
  * stderr into a per-spawn log file, leaving stdout to carry the MCP protocol
  * stream. Without this wrapper every startup/progress line npx prints would
  * land directly on the dsh console — exactly what makes the connection feel
@@ -18,29 +24,35 @@
  * only through `ctx.logger`: without it the card would never surface a
  * failed/recovered bridge.
  */
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { LOG_LEVELS, SH_PATH_CANDIDATES } from "./constants.js";
+import { fileURLToPath } from "node:url";
+import { buildSpawn, stderrLogPath } from "@comecaramelos/dsh-ancesters/host";
+import { LOG_LEVELS } from "./constants.js";
 import { carriesExecutablePath, flagsSkipCheck } from "./flags.js";
+import { readConfigField } from "./values.js";
+/** The row defaults that mean "the pinned server": a row that never named its
+ * own launcher. */
+const DEFAULT_COMMAND = "npx";
+const DEFAULT_PACKAGE = "chrome-devtools-mcp@latest";
+/** The CLI of the `chrome-devtools-mcp` this package depends on (pinned). */
+export function pinnedServerCli() {
+    return fileURLToPath(import.meta.resolve("chrome-devtools-mcp/build/src/bin/chrome-devtools-mcp.js"));
+}
+/** Whether a row runs the pinned server: it names no launcher of its own (the
+ * schema defaults, or blanks). */
+export function usesPinnedServer(entry) {
+    const command = String(entry.command ?? "").trim();
+    const pkg = String(entry.package ?? "").trim();
+    return (command === "" || command === DEFAULT_COMMAND) && (pkg === "" || pkg === DEFAULT_PACKAGE);
+}
+/** The executable one row's server runs under: this Node for the pinned
+ * server, the row's own `command` otherwise. */
+export function serverCommand(entry, execPath = process.execPath) {
+    return usesPinnedServer(entry) ? execPath : String(entry.command);
+}
 /**
- * The `sh -c` script behind a redirecting bridge spawn: keep stdout as the MCP
- * protocol stream (only stdout carries it), send stderr to the captured log
- * file, and fail with 127 (and a message ON stderr) if the executable is
- * missing — otherwise the transport would report a bare exit code and the
- * reason would be buried in the log file.
- */
-const BRIDGE_STDERR_SHELL_SCRIPT = [
-    'BRIDGE="$1"',
-    'LOG="$2"',
-    "shift 2",
-    'command -v "$BRIDGE" >/dev/null 2>&1 || { echo "chrome-devtools-mcp: bridge executable not found: $BRIDGE" >&2; exit 127; }',
-    'exec "$BRIDGE" "$@" 2>"$LOG"'
-].join("; ");
-/**
- * Build the stdio argv tail for one flags list:
- * `-y <package> [extraFlags]`, the argv tail {@link buildBridgeSpawn} runs, so
- * the logical invocation is `npx -y chrome-devtools-mcp@latest [extraFlags]`.
+ * Build the stdio argv tail for one flags list — `<pinned cli> [extraFlags]`
+ * for the pinned server, `-y <package> [extraFlags]` for a row's own launcher;
+ * the argv {@link buildBridgeSpawn} runs after {@link serverCommand}.
  * When `chromePath` is set and the flags do not already carry an executable-path
  * option, `--executablePath=<path>` is appended (upstream option:
  * https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/configuration.md).
@@ -51,72 +63,51 @@ const BRIDGE_STDERR_SHELL_SCRIPT = [
  */
 export function buildServerArgs(entry, extraFlags) {
     const flags = Array.isArray(extraFlags) ? extraFlags.filter((flag) => typeof flag === "string") : [];
-    const args = ["-y", entry.package, ...flags];
-    const executable = typeof entry.chromePath === "string" ? entry.chromePath.trim() : "";
+    const args = usesPinnedServer(entry) ? [pinnedServerCli(), ...flags] : ["-y", entry.package, ...flags];
+    // `chromePath` is a volatile field, so what it carries is either a reference
+    // or the value a caller handed in explicitly (the resolved selection).
+    const executable = readConfigField(entry.chromePath, "").trim();
     if (executable !== "" && !flags.some((flag) => carriesExecutablePath(flag)) && !flagsSkipCheck(flags)) {
         args.push(`--executablePath=${executable}`);
     }
     return args;
 }
 /**
- * Default location of the bridge stderr log:
- * `<tmpdir>/dsh-chrome-mcp-<serverName>-bridge-<pid>.log`. One file per running
- * dsh instance; the wrapper truncates it on every spawn, so it always holds the
- * latest bridge session's output.
+ * Default location of the bridge stderr log — `@comecaramelos/dsh-ancesters`'
+ * private per-host directory (`mkdtemp`, mode `0700`), one
+ * `<serverName>-bridge.log` per bridge, truncated on every spawn. Nothing in it
+ * can be planted by another local principal before the first spawn.
+ *
+ * `options.tmpdir` keeps a flat, deterministic name for tests and diagnostics.
  * @param serverName - the bridge server namespace.
  * @param options - tmpdir/pid overrides for tests and diagnostics.
  */
 export function bridgeStderrLogPath(serverName, options = {}) {
-    const tmp = typeof options.tmpdir === "string" && options.tmpdir !== "" ? options.tmpdir : os.tmpdir();
-    const pid = options.pid === void 0 ? process.pid : options.pid;
-    const safe = typeof serverName === "string" ? serverName.replace(/[^A-Za-z0-9_-]/gu, "-") : "bridge";
-    return path.join(tmp, `dsh-chrome-mcp-${safe}-bridge-${pid}.log`);
+    return stderrLogPath(serverName, options);
 }
 /**
  * Build the stdio spawn target for one bridge run, honouring the effective
  * stderr mode. The MCP stdio transport spawns the child with the default
- * `stderr: "inherit"`, so every line it prints lands on the dsh console. "log"
- * (default) wraps the spawn in `sh -c`: stdout keeps flowing as the MCP
- * protocol stream, stderr is redirected into a log file. "console" returns the
- * raw command/args (inherited console output). When no POSIX shell is available
- * the redirect is impossible: the raw command is returned with `fallback` set,
- * and the host's {@link noteStderr} warns once.
+ * `stderr: "inherit"`, so every line it prints lands on the dsh console.
+ * "log" (default) launches the argv through ancestros' Node wrapper (D5:
+ * `process.execPath` + a shipped script, the same route on Linux, WSL and
+ * Windows): stdout keeps flowing as the MCP protocol stream, stderr goes to
+ * the log file, the argv reaches the child verbatim. "console" returns the raw
+ * command/args (inherited console output).
  * @param target - { command, args, stderr?, logPath?, serverName? }.
- * @param options - platform/exists/tmpdir/pid overrides for tests.
- * @returns { command, args, redirect, fallback } — the log file when redirected
- * ("" otherwise) and why not ("" when redirected or console).
+ * @param options - execPath/tmpdir/pid overrides for tests.
+ * @returns { command, args, redirect } — the log file when redirected, "" when
+ * the console echoes. There is no fallback left: Node is always there.
  */
 export function buildBridgeSpawn(target, options = {}) {
-    const raw = { command: target.command, args: [...target.args], redirect: "", fallback: "" };
     const mode = target.stderr === void 0 ? "log" : target.stderr;
-    if (mode !== "log")
-        return raw;
-    const platform = options.platform === void 0 ? process.platform : options.platform;
-    if (platform !== "linux" && platform !== "darwin")
-        return { ...raw, fallback: "platform" };
-    const exists = options.exists === void 0
-        ? (candidate) => {
-            try {
-                fs.accessSync(candidate, fs.constants.X_OK);
-                return true;
-            }
-            catch {
-                return false;
-            }
-        }
-        : options.exists;
-    const sh = SH_PATH_CANDIDATES.find((candidate) => exists(candidate));
-    if (sh === void 0)
-        return { ...raw, fallback: "shell" };
-    const logPath = typeof target.logPath === "string" && target.logPath !== ""
-        ? target.logPath
-        : bridgeStderrLogPath(target.serverName ?? "bridge", options);
-    return {
-        command: sh,
-        args: ["-c", BRIDGE_STDERR_SHELL_SCRIPT, "chrome-devtools-mcp", target.command, logPath, ...target.args],
-        redirect: logPath,
-        fallback: ""
-    };
+    return buildSpawn({
+        command: target.command,
+        args: [...target.args],
+        stderr: mode,
+        ...(typeof target.logPath === "string" && target.logPath !== "" ? { logPath: target.logPath } : {}),
+        serverName: target.serverName ?? "bridge"
+    }, options);
 }
 /**
  * stdio config for the nested mcp-client bridge for one flags list + effective
@@ -124,12 +115,12 @@ export function buildBridgeSpawn(target, options = {}) {
  * (`npx -y <package> [extraFlags]`, run as `command`), wrapped through
  * {@link buildBridgeSpawn} so the child's stderr lands in a log file instead of
  * the console when the mode is "log". The returned config carries only
- * dsh-mcp-client fields; `redirect`/`fallback` describe the wrapper for the
+ * dsh-mcp-client fields; `redirect` describes the wrapper for the
  * host's own diagnostics.
  */
 export function bridgeConfig(entry, extraFlags, stderrMode) {
     const spawned = buildBridgeSpawn({
-        command: entry.command,
+        command: serverCommand(entry),
         args: buildServerArgs(entry, extraFlags),
         stderr: stderrMode === void 0 ? entry.bridgeStderr : stderrMode,
         logPath: entry.bridgeStderrLog,
@@ -143,16 +134,17 @@ export function bridgeConfig(entry, extraFlags, stderrMode) {
         env: entry.env,
         cwd: entry.cwd,
         toolCallTimeoutMs: entry.toolCallTimeoutMs,
+        maxInstructionBytes: entry.maxInstructionBytes,
         failOnStartupError: entry.failOnStartupError,
         reconnect: entry.reconnect
     };
-    return { config, redirect: spawned.redirect, fallback: spawned.fallback };
+    return { config, redirect: spawned.redirect };
 }
 /**
  * Wrap a logger so a callback observes every level call before the
  * original runs. Used to capture the nested bridge's own log lines (the only
  * surface dsh-mcp-client exposes for connection failures — reconnect
- * backoff warnings, spawn failures, give-ups) into the settings base layer.
+ * backoff warnings, spawn failures, give-ups) into the live mirror.
  * The wrapper shares the underlying LoggerService (exporters/buffer included)
  * and only shadows the level methods.
  * @param base - the base logger to wrap (cordis LoggerService).

package/lib/host/bridge.js.map

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

package/lib/host/catalog.d.ts

@@ -11,8 +11,8 @@ export declare function entryLabel(entry: ChromeExecutableEntry): string;
 /**
  * Coerce anything into well-formed rows: trim both fields, drop ids that cannot
  * go on the wire, keep the first row per id, cap the name, cap the list (the
- * tail drops off). A served array is already normalized; one read straight from
- * a settings document is not, so the row writer is the place that makes it safe.
+ * tail drops off). A served array is already normalized; one read straight from a
+ * form write is not, so the row writer is the place that makes it safe.
  */
 export declare function normalizeEntries(value: unknown): ChromeExecutableEntry[];
 /**

package/lib/host/catalog.js

@@ -38,8 +38,8 @@ export function entryLabel(entry) {
 /**
  * Coerce anything into well-formed rows: trim both fields, drop ids that cannot
  * go on the wire, keep the first row per id, cap the name, cap the list (the
- * tail drops off). A served array is already normalized; one read straight from
- * a settings document is not, so the row writer is the place that makes it safe.
+ * tail drops off). A served array is already normalized; one read straight from a
+ * form write is not, so the row writer is the place that makes it safe.
  */
 export function normalizeEntries(value) {
     if (!Array.isArray(value))

package/lib/host/commands/chrome-path.d.ts

@@ -0,0 +1,4 @@
+import type { ChromeMcpController } from "../controller/index.js";
+import type { CommandDefinition } from "../types/index.js";
+export declare function createChromePathCommand(controller: ChromeMcpController): CommandDefinition;
+//# sourceMappingURL=chrome-path.d.ts.map

package/lib/host/commands/chrome-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-path.d.ts","sourceRoot":"","sources":["../../../src/host/commands/chrome-path.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,GAAG,iBAAiB,CAgD1F"}

package/lib/host/commands/chrome-path.js

@@ -0,0 +1,65 @@
+/**
+ * `/chrome-path` — the headless mirror of the card's executable picker.
+ *
+ * It answers what the pill states and changes what it changes, reading the saved
+ * rows and the live mirror exactly the way the card reads them, and writing the
+ * one same persisted `chromePath` field through the controller's write-back
+ * channel (`selectChromePath` — `persistChromePath`, i.e. one `settings.mutate`
+ * on the row's entry id, the live clear riding along) — never a route of its
+ * own. `none` clears the user layer back to what the row config carries under
+ * it, which is the same answer a cleared picker reads with. And a path write
+ * answers against the same validation gate a GUI write runs through: the
+ * field's own schema pattern, so control characters are refused here exactly as
+ * they are refused on the card door.
+ */
+import { entryLabel } from "../catalog.js";
+import { CHROME_PATH_PATTERN } from "../constants.js";
+import { readSavedExecutables } from "../values.js";
+const USAGE = "Usage: /chrome-path <path> — select the Chrome executable the row launches by default. Use /chrome-path none to clear the selection back to the row config.";
+export function createChromePathCommand(controller) {
+    return {
+        name: "chrome-path",
+        description: "Show or change the Chrome executable the row launches by default",
+        input: { hint: "[<path>|none]" },
+        async handler(invocation) {
+            const input = invocation.rawInput.trim();
+            // No argument answers the question the pill states, with the saved
+            // rows the picker would offer beneath it.
+            if (input === "") {
+                const live = controller.live;
+                const saved = readSavedExecutables(controller.source());
+                const lines = [
+                    `Current executable: ${live.effectiveChromePath === "" ? "(nothing)" : live.effectiveChromePath}`,
+                    `Source: ${live.effectiveSource === "" ? "nothing selected" : live.effectiveSource}.`
+                ];
+                lines.push(saved.length === 0 ? "Saved executables: (none — /chrome-refresh discovers them)." : `Saved executables:\n${saved.map((entry) => `  - ${entryLabel(entry)}`).join("\n")}`);
+                lines.push(USAGE);
+                return { kind: "success", text: lines.join("\n") };
+            }
+            // The one cleared write: the user layer answers empty again and the
+            // row config's own path stands underneath it.
+            if (input === "none") {
+                if (controller.live.effectiveChromePath === "" && controller.live.effectiveSource === "") {
+                    return { kind: "success", text: "No executable is selected — there is nothing to clear." };
+                }
+                await controller.selectChromePath("");
+                return { kind: "success", text: "Executable selection cleared — the row launches by default with whatever the row config carries." };
+            }
+            // Same gate the field's write runs through (../schema.ts).
+            if (!CHROME_PATH_PATTERN.test(input)) {
+                return { kind: "error", text: "Invalid executable path: control characters (or a length over the path limit) are never valid." };
+            }
+            // Already what the bridge runs with: same write the picker makes on
+            // a no-change pick — nothing lands anywhere new.
+            if (controller.live.effectiveChromePath === input && controller.live.effectiveSource === "selected") {
+                return { kind: "success", text: `The row default already stands at ${input}.` };
+            }
+            await controller.selectChromePath(input);
+            return {
+                kind: "success",
+                text: `Chrome executable selected: ${input} — a default shifts with it: live connections without their own pick re-answer, and the executable run re-runs behind the write.`
+            };
+        }
+    };
+}
+//# sourceMappingURL=chrome-path.js.map

package/lib/host/commands/chrome-path.js.map

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

package/lib/host/commands/chrome-refresh.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `/chrome-refresh` — the headless mirror of the card's **Fetch executables**.
+ *
+ * One executable run on demand: probe every candidate the row config, what this
+ * host carries, the saved rows and the selection carry, and merge what exists
+ * into the saved rows. The merge already stands inside the run (see
+ * ../controller/runs.ts — `runExecutableDiscovery` merges as its own step), so
+ * the headless path needs no merge step of its own: it fires the run and reads
+ * the answers off the live mirror the run publishes, never more than the run
+ * answered. The bump of `executableDiscoveryRevision` around the awaited run is
+ * what tells a reportable run from one that never completed — the statuses on
+ * the mirror could otherwise be from the last run.
+ */
+import type { ChromeMcpController } from "../controller/index.js";
+import type { CommandDefinition } from "../types/index.js";
+export declare function createChromeRefreshCommand(controller: ChromeMcpController): CommandDefinition;
+//# sourceMappingURL=chrome-refresh.d.ts.map

package/lib/host/commands/chrome-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-refresh.d.ts","sourceRoot":"","sources":["../../../src/host/commands/chrome-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,GAAG,iBAAiB,CAgC7F"}