@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/host/apply.d.ts

@@ -0,0 +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";
+/**
+ * @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

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

@@ -0,0 +1,57 @@
+/**
+ * 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 { createChromeMcpController } from "./controller/index.js";
+import { installChromeMcpCommands } from "./commands/index.js";
+import { attachToManager } from "./manager.js";
+import { installChromeMcpForm } from "./settings.js";
+import { installPrelaunchWindowsChromeTool } from "./tool.js";
+/**
+ * @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

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

@@ -0,0 +1,74 @@
+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 — `<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).
+ * A connect-mode flag takes the whole executable out of the argv: with
+ * `--browserUrl` / `--wsEndpoint` present there is nothing local to launch, so
+ * the path is never appended next to it — the bridge connects, it does not
+ * launch.
+ */
+export declare function buildServerArgs(entry: ChromeMcpConfig, extraFlags: string[]): string[];
+/**
+ * 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 declare function bridgeStderrLogPath(serverName: unknown, options?: BridgeStderrLogPathOptions): string;
+/**
+ * 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) 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 - 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;
+/**
+ * stdio config for the nested mcp-client bridge for one flags list + effective
+ * stderr mode. The args keep the user's original logical invocation shape
+ * (`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` describes the wrapper for the
+ * host's own diagnostics.
+ */
+export declare function bridgeConfig(entry: ChromeMcpConfig, extraFlags: string[], stderrMode?: BridgeStderrMode): {
+    config: McpClient.StdioConfig;
+    redirect: 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 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).
+ * @param note - callback invoked for every log level before the original runs.
+ */
+export declare function captureLogger(base: Record<string, (...args: unknown[]) => unknown>, note: (level: string, args: unknown[]) => void): Record<string, (...args: unknown[]) => unknown>;
+//# sourceMappingURL=bridge.d.ts.map

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

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

@@ -0,0 +1,168 @@
+/**
+ * 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 live mirror.
+ *
+ * The bridge's *logical* argv is the public contract the tests and the README
+ * 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
+ * loud. "console" mode spawns the argv unwrapped (inherited stderr, debug).
+ *
+ * The logger wrapper exists because dsh-mcp-client reports connection problems
+ * only through `ctx.logger`: without it the card would never surface a
+ * failed/recovered bridge.
+ */
+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);
+}
+/**
+ * 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).
+ * A connect-mode flag takes the whole executable out of the argv: with
+ * `--browserUrl` / `--wsEndpoint` present there is nothing local to launch, so
+ * the path is never appended next to it — the bridge connects, it does not
+ * launch.
+ */
+export function buildServerArgs(entry, extraFlags) {
+    const flags = Array.isArray(extraFlags) ? extraFlags.filter((flag) => typeof flag === "string") : [];
+    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 — `@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 = {}) {
+    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) 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 - 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 mode = target.stderr === void 0 ? "log" : target.stderr;
+    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
+ * stderr mode. The args keep the user's original logical invocation shape
+ * (`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` describes the wrapper for the
+ * host's own diagnostics.
+ */
+export function bridgeConfig(entry, extraFlags, stderrMode) {
+    const spawned = buildBridgeSpawn({
+        command: serverCommand(entry),
+        args: buildServerArgs(entry, extraFlags),
+        stderr: stderrMode === void 0 ? entry.bridgeStderr : stderrMode,
+        logPath: entry.bridgeStderrLog,
+        serverName: entry.serverName
+    }, {});
+    const config = {
+        serverName: entry.serverName,
+        transport: "stdio",
+        command: spawned.command,
+        args: spawned.args,
+        env: entry.env,
+        cwd: entry.cwd,
+        toolCallTimeoutMs: entry.toolCallTimeoutMs,
+        maxInstructionBytes: entry.maxInstructionBytes,
+        failOnStartupError: entry.failOnStartupError,
+        reconnect: entry.reconnect
+    };
+    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 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).
+ * @param note - callback invoked for every log level before the original runs.
+ */
+export function captureLogger(base, note) {
+    const wrapper = ((...args) => {
+        const callBase = base;
+        return callBase(...args);
+    });
+    Object.setPrototypeOf(wrapper, Object.getPrototypeOf(base));
+    Object.assign(wrapper, base);
+    for (const level of LOG_LEVELS) {
+        wrapper[level] = (...args) => {
+            note(level, args);
+            return base[level]?.(...args);
+        };
+    }
+    return wrapper;
+}
+//# sourceMappingURL=bridge.js.map

package/lib/host/bridge.js.map

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

package/lib/host/catalog.d.ts

@@ -0,0 +1,31 @@
+/** One catalog row: the path on the wire + the custom UI label. */
+export type ChromeExecutableEntry = {
+    id: string;
+    name: string;
+};
+/** Whether one id is usable as an executable row (a path with no control
+ * characters, capped like the `chromePath` it stands for). */
+export declare function isValidEntryId(id: unknown): boolean;
+/** One row label: the custom name when it has one, else the path. */
+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
+ * form write is not, so the row writer is the place that makes it safe.
+ */
+export declare function normalizeEntries(value: unknown): ChromeExecutableEntry[];
+/**
+ * Merge the ids a scan found into the stored rows: rows keep their order and
+ * their custom names, ids that are not represented land last, nameless.
+ * @returns the merged rows, plus `changed` so a caller can skip a no-op write.
+ */
+export declare function mergeEntries(stored: unknown, ids: readonly string[]): {
+    entries: ChromeExecutableEntry[];
+    changed: boolean;
+};
+/** The ids a catalog currently carries, in row order. */
+export declare function entryIds(entries: readonly ChromeExecutableEntry[] | undefined): string[];
+/** One row lookup by id (`undefined` when absent). */
+export declare function findEntry(entries: readonly ChromeExecutableEntry[], id: string): ChromeExecutableEntry | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/host/catalog.ts"],"names":[],"mappings":"AAuBA,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;8DAC8D;AAC9D,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAKnD;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAexE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,SAAS,MAAM,EAAE,GACvB;IAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAYxD;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAExF;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CACrB,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,EAAE,EAAE,MAAM,GACX,qBAAqB,GAAG,SAAS,CAEnC"}

package/lib/host/catalog.js

@@ -0,0 +1,92 @@
+/**
+ * Host half — the named rows behind the executable picker.
+ *
+ * One row is `{ id, name }`: the `id` is what goes on the wire (the path the
+ * bridge launches with, appended as `--executablePath=<id>`), while `name` is
+ * purely the label the user chose for the UI — the same id-is-path / name-is-
+ * label split the reference plugin (`dsh-docker-desktop-mcp`) carries for its
+ * executables catalog, so the card is one widget shape instead of a bespoke
+ * dropdown-plus-text-box.
+ *
+ * Everything here is pure and total: nothing throws on odd input, so the
+ * settings `validate` hook can never stall the settings gate on a malformed
+ * row. The browser half mirrors these rules in `src/client/catalog.ts`
+ * (separate bundle, one source of truth per rule in each half).
+ *
+ * Merge rule (the reference's "Fetch executables" behaviour): keep every stored
+ * row in order with its custom name, append the ids the scan found that are not
+ * represented yet with an empty name. A row the user deleted only comes back if
+ * a later source still reports its id, which is why the legacy `chromeCustomPaths`
+ * MRU folds in exactly once, before the rows are written by anything else.
+ */
+import { CATALOG_MAX_LENGTH, CATALOG_NAME_MAX_LENGTH, CHROME_PATH_PATTERN } from "./constants.js";
+/** Whether one id is usable as an executable row (a path with no control
+ * characters, capped like the `chromePath` it stands for). */
+export function isValidEntryId(id) {
+    if (typeof id !== "string")
+        return false;
+    const path = id.trim();
+    if (path === "" || path.length > 1024)
+        return false;
+    return CHROME_PATH_PATTERN.test(path);
+}
+/** One row label: the custom name when it has one, else the path. */
+export function entryLabel(entry) {
+    const name = entry.name.trim();
+    return name === "" ? entry.id : name;
+}
+/**
+ * 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
+ * form write is not, so the row writer is the place that makes it safe.
+ */
+export function normalizeEntries(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const item of value) {
+        if (out.length === CATALOG_MAX_LENGTH)
+            break;
+        if (item === null || typeof item !== "object" || Array.isArray(item))
+            continue;
+        const raw = item;
+        const id = typeof raw.id === "string" ? raw.id.trim() : "";
+        if (!isValidEntryId(id) || seen.has(id))
+            continue;
+        seen.add(id);
+        const name = typeof raw.name === "string" ? raw.name.trim() : "";
+        out.push({ id, name: name.slice(0, CATALOG_NAME_MAX_LENGTH) });
+    }
+    return out;
+}
+/**
+ * Merge the ids a scan found into the stored rows: rows keep their order and
+ * their custom names, ids that are not represented land last, nameless.
+ * @returns the merged rows, plus `changed` so a caller can skip a no-op write.
+ */
+export function mergeEntries(stored, ids) {
+    const entries = normalizeEntries(stored);
+    const present = new Set(entries.map((entry) => entry.id));
+    const merged = entries.slice();
+    for (const id of ids) {
+        if (merged.length >= CATALOG_MAX_LENGTH)
+            break;
+        const path = typeof id === "string" ? id.trim() : "";
+        if (!isValidEntryId(path) || present.has(path))
+            continue;
+        present.add(path);
+        merged.push({ id: path, name: "" });
+    }
+    return { entries: merged, changed: JSON.stringify(merged) !== JSON.stringify(entries) };
+}
+/** The ids a catalog currently carries, in row order. */
+export function entryIds(entries) {
+    return (entries === void 0 ? [] : entries).map((entry) => entry.id);
+}
+/** One row lookup by id (`undefined` when absent). */
+export function findEntry(entries, id) {
+    return entries.find((entry) => entry.id === id);
+}
+//# sourceMappingURL=catalog.js.map

package/lib/host/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/host/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAKlG;8DAC8D;AAC9D,MAAM,UAAU,cAAc,CAAC,EAAW;IACtC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,KAA4B;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,kBAAkB;YAAE,MAAM;QAC7C,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/E,MAAM,GAAG,GAAG,IAAwC,CAAC;QACrD,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CACxB,MAAe,EACf,GAAsB;IAEtB,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,IAAI,kBAAkB;YAAE,MAAM;QAC/C,MAAM,IAAI,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,OAAqD;IAC1E,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS,CACrB,OAAyC,EACzC,EAAU;IAEV,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC"}

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"}