@comecaramelos/dsh-chrome-mcp 0.0.1 → 1.0.0

package/lib/host/plugin-meta.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Host-half plugin identity.
+ *
+ * `name` is what the cordis loader reports for diagnostics and `inject` is the
+ * list of host services this half needs of its own; the nested mcp-client row
+ * declares the tools, so nothing is injected here.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "chrome-devtools-mcp";
+/** No host services of our own: the nested bridge declares `tools`. */
+export declare const inject: string[];
+//# sourceMappingURL=plugin-meta.d.ts.map

package/lib/host/plugin-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-meta.d.ts","sourceRoot":"","sources":["../../src/host/plugin-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAE1C,uEAAuE;AACvE,eAAO,MAAM,MAAM,EAAE,MAAM,EAAO,CAAC"}

package/lib/host/plugin-meta.js

@@ -0,0 +1,12 @@
+/**
+ * Host-half plugin identity.
+ *
+ * `name` is what the cordis loader reports for diagnostics and `inject` is the
+ * list of host services this half needs of its own; the nested mcp-client row
+ * declares the tools, so nothing is injected here.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export const name = "chrome-devtools-mcp";
+/** No host services of our own: the nested bridge declares `tools`. */
+export const inject = [];
+//# sourceMappingURL=plugin-meta.js.map

package/lib/host/plugin-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-meta.js","sourceRoot":"","sources":["../../src/host/plugin-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAC;AAE1C,uEAAuE;AACvE,MAAM,CAAC,MAAM,MAAM,GAAa,EAAE,CAAC"}

package/lib/host/schema.d.ts

@@ -0,0 +1,307 @@
+/**
+ * The two zod schemas: the cordis row config and the settings section.
+ *
+ * The row config validates what lives in the profile (one row per plugin
+ * instance); the settings schema describes the namespace the Web GUI card
+ * edits — the persisted user layer (flags, the executable selection, the saved
+ * executable rows, the stderr toggle and the one action trigger) plus the
+ * base-layer status fields served alongside it.
+ */
+import z from "@deepseek-ai/schemastery";
+export declare const Config: z<Schemastery.ObjectS<{
+    serverName: z<string, string>;
+    command: z<string, string>;
+    package: z<string, string>;
+    extraFlags: z<string[], string[]>;
+    chromePath: z<string, string>;
+    chromePaths: z<string[], string[]>;
+    env: z<import("@deepseek-ai/cosmokit").Dict<string, string>, import("@deepseek-ai/cosmokit").Dict<string, string>>;
+    cwd: z<string, string>;
+    toolCallTimeoutMs: z<number, number>;
+    failOnStartupError: z<boolean, boolean>;
+    reconnect: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        initialDelayMs: z<number, number>;
+        maxDelayMs: z<number, number>;
+        maxAttempts: z<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        initialDelayMs: z<number, number>;
+        maxDelayMs: z<number, number>;
+        maxAttempts: z<number, number>;
+    }>>;
+    /** Bridge console-output routing: "log" (default) redirects the spawned
+     * npx child's inherited stderr into a per-spawn log file so its progress
+     * / startup lines stay out of the dsh console; "console" inherits it
+     * (debug). The card's "Reduce log output" toggle (`stderrMode`) overrides
+     * this. See {@link buildBridgeSpawn}. */
+    bridgeStderr: z<"log" | "console", "log" | "console">;
+    /** Log path override for "log" mode; "" = auto (see
+     * {@link bridgeStderrLogPath}). Absolute paths only. */
+    bridgeStderrLog: z<string, string>;
+}>, Schemastery.ObjectT<{
+    serverName: z<string, string>;
+    command: z<string, string>;
+    package: z<string, string>;
+    extraFlags: z<string[], string[]>;
+    chromePath: z<string, string>;
+    chromePaths: z<string[], string[]>;
+    env: z<import("@deepseek-ai/cosmokit").Dict<string, string>, import("@deepseek-ai/cosmokit").Dict<string, string>>;
+    cwd: z<string, string>;
+    toolCallTimeoutMs: z<number, number>;
+    failOnStartupError: z<boolean, boolean>;
+    reconnect: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        initialDelayMs: z<number, number>;
+        maxDelayMs: z<number, number>;
+        maxAttempts: z<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        initialDelayMs: z<number, number>;
+        maxDelayMs: z<number, number>;
+        maxAttempts: z<number, number>;
+    }>>;
+    /** Bridge console-output routing: "log" (default) redirects the spawned
+     * npx child's inherited stderr into a per-spawn log file so its progress
+     * / startup lines stay out of the dsh console; "console" inherits it
+     * (debug). The card's "Reduce log output" toggle (`stderrMode`) overrides
+     * this. See {@link buildBridgeSpawn}. */
+    bridgeStderr: z<"log" | "console", "log" | "console">;
+    /** Log path override for "log" mode; "" = auto (see
+     * {@link bridgeStderrLogPath}). Absolute paths only. */
+    bridgeStderrLog: z<string, string>;
+}>>;
+/**
+ * User-settings section served to the Web GUI card.
+ *
+ * Persisted (user layer in `$DSH_HOME/settings.yaml`): `extraFlags`,
+ * `chromePath` (the executable the picker selected — or that the host seeded
+ * once), `executables` (the saved-executables rows: `id` = path, `name` = UI
+ * label), `refreshExecutablesNonce` (the card's **Search executables**
+ * trigger), `openWindowsChromeNonce` (the card's **Prelaunch Windows Chrome**
+ * trigger), `chromeCustomPaths` (the **legacy** hand-typed MRU: folded into the
+ * rows once by the first scan, never written again) and `stderrMode` (the
+ * "Reduce log output" toggle: "log" captures the bridge's stderr into a
+ * per-spawn log file, "console" echoes it, "" follows the row-config
+ * `bridgeStderr`).
+ * Served but never persisted (composition base layer held in memory by the
+ * host): `lastError`, `executableDiscoveryRevision`, `chromeVersion`,
+ * `executableStatus`, `chromeMissing`, `effectiveChromePath`,
+ * `effectiveSource`, `wslWindowsExecutable`, `windowsChromeStatus`,
+ * `carriesConnectionMode`, the static `rowStderr` mirror, the static
+ * `defaultExtraFlags` mirror (the canonical defaults list the card's
+ * **Restore defaults** control appends) and the static `wslExtraFlags` mirror
+ * (the recommended WSL ↔ Windows flags the card's **Flags WSL** control
+ * appends) — the client's polls stop when the served revision advances past its
+ * action-time value.
+ */
+export declare const SettingsSchema: z<Schemastery.ObjectS<{
+    /** Flags appended after `npx -y <package>`; persisted last UI edit. An
+     * executable-pinning flag is rejected: the executable is picked below. */
+    extraFlags: z<string[], string[]>;
+    /** Written by the UI **Search executables** button; the host reacts to it by
+     * re-probing the saved rows and merging what it finds back into them. */
+    refreshExecutablesNonce: z<number, number>;
+    /** Written by the UI **Prelaunch Windows Chrome** button; the host reacts to it
+     * by running the Windows launch: locate the Windows Chrome, prove the
+     * mirrored-loopback prereq, launch it with a debugging port, and write the
+     * `--browserUrl` connect entry that leaves the bridge in connect mode. */
+    openWindowsChromeNonce: z<number, number>;
+    /**
+     * The executable the bridge launches with: picked in the picker (a saved
+     * row's `id`) or seeded once by the host's first scan. "" = nothing resolved
+     * yet — there is no auto state to fall back to.
+     */
+    chromePath: z<string, string>;
+    /** The picker's saved rows — `{ id: path, name: label }`, user-authored. The
+     * host re-normalizes (trim, dedupe, caps) on every read, and a scan merges
+     * what it discovers into them without dropping a name the user chose. */
+    executables: z<({
+        id?: string | null | undefined;
+        name?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+        id: z<string, string>;
+        name: z<string, string>;
+    }>[]>;
+    /**
+     * **Legacy** MRU of hand-typed executables, newest first. The saved rows
+     * replace it: a host whose settings still carry it folds its paths into the
+     * rows during the first scan (see ./catalog.ts `mergeEntries`), so the field
+     * is read once and never written again.
+     */
+    chromeCustomPaths: z<string[], string[]>;
+    /**
+     * Persisted UI "Reduce log output" toggle: "log" captures the bridge's
+     * stderr into the log file, "console" echoes it (debug). "" follows the
+     * row-config `bridgeStderr` (mirrored into `rowStderr`).
+     */
+    stderrMode: z<string, string>;
+    /** Last check/connection failure, human-readable; empty when healthy. */
+    lastError: z<string, string>;
+    /** Known error: the last failure was "no Chrome executable detected". */
+    chromeMissing: z<boolean, boolean>;
+    /** Executable-run counter (success or failure); completion signal for every
+     * executable action the card can take. */
+    executableDiscoveryRevision: z<number, number>;
+    /** The version the **selected** executable answered with; "" when nothing
+     * answered — nothing picked, a connect mode, or a blocked path. */
+    chromeVersion: z<string, string>;
+    /** Per-row probe status keyed by path: the version the row answered with,
+     * and the failure for a row that is present but not runnable (or blocked).
+     * Base layer, never persisted — the rows themselves live in the user
+     * layer. */
+    executableStatus: z<({
+        path?: string | null | undefined;
+        version?: string | null | undefined;
+        error?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+        path: z<string, string>;
+        version: z<string, string>;
+        error: z<string, string>;
+    }>[]>;
+    /** The path the bridge actually launches with ("" when nothing is fixed).
+     * Base layer, never persisted. */
+    effectiveChromePath: z<string, string>;
+    /** Where `effectiveChromePath` came from — picked (`"selected"`), row config
+     * (`"row-config"`) or nothing yet (""). Base layer, never persisted. */
+    effectiveSource: z<string, string>;
+    /** Row-config `bridgeStderr` in effect (static base layer; never
+     * persisted) — the fallback when `stderrMode` is "". */
+    rowStderr: z<"log" | "console", "log" | "console">;
+    /** The canonical default extra-flags list (static base layer; never
+     * persisted) — the list the card's **Restore defaults** control appends to
+     * what the editor holds. Mirror of `DEFAULT_EXTRA_FLAGS`. */
+    defaultExtraFlags: z<string[], string[]>;
+    /** The recommended WSL ↔ Windows extra-flags list (static base layer;
+     * never persisted) — the list the card's **Flags WSL** control appends to
+     * what the editor holds, missing entries only. Mirror of
+     * `WSL_EXTRA_FLAGS`. */
+    wslExtraFlags: z<string[], string[]>;
+    /** True while this host runs under WSL and the selected executable is a
+     * Windows binary — the state the card's notice explains. Base layer, never
+     * persisted (see ./platform.ts). */
+    wslWindowsExecutable: z<boolean, boolean>;
+    /** What the **Prelaunch Windows Chrome** run is doing (base layer; never
+     * persisted) — the single field the card derives the button's state, its
+     * disabled reason and the pill's connect-mode muting from. The locate,
+     * prereq, launch and port answers all live host-side (./windows/), so
+     * the card never carries a list of Windows paths or reachability rules. */
+    windowsChromeStatus: z<Schemastery.ObjectS<{
+        state: z<string, string>;
+        port: z<number, number>;
+        error: z<string, string>;
+    }>, Schemastery.ObjectT<{
+        state: z<string, string>;
+        port: z<number, number>;
+        error: z<string, string>;
+    }>>;
+    /** True while the bridge launches with a connect-mode flag
+     * (`--browserUrl` / `--wsEndpoint`): no local executable is then launched
+     * or probed, so the card mutes the picker. Base layer, never persisted. */
+    carriesConnectionMode: z<boolean, boolean>;
+}>, Schemastery.ObjectT<{
+    /** Flags appended after `npx -y <package>`; persisted last UI edit. An
+     * executable-pinning flag is rejected: the executable is picked below. */
+    extraFlags: z<string[], string[]>;
+    /** Written by the UI **Search executables** button; the host reacts to it by
+     * re-probing the saved rows and merging what it finds back into them. */
+    refreshExecutablesNonce: z<number, number>;
+    /** Written by the UI **Prelaunch Windows Chrome** button; the host reacts to it
+     * by running the Windows launch: locate the Windows Chrome, prove the
+     * mirrored-loopback prereq, launch it with a debugging port, and write the
+     * `--browserUrl` connect entry that leaves the bridge in connect mode. */
+    openWindowsChromeNonce: z<number, number>;
+    /**
+     * The executable the bridge launches with: picked in the picker (a saved
+     * row's `id`) or seeded once by the host's first scan. "" = nothing resolved
+     * yet — there is no auto state to fall back to.
+     */
+    chromePath: z<string, string>;
+    /** The picker's saved rows — `{ id: path, name: label }`, user-authored. The
+     * host re-normalizes (trim, dedupe, caps) on every read, and a scan merges
+     * what it discovers into them without dropping a name the user chose. */
+    executables: z<({
+        id?: string | null | undefined;
+        name?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+        id: z<string, string>;
+        name: z<string, string>;
+    }>[]>;
+    /**
+     * **Legacy** MRU of hand-typed executables, newest first. The saved rows
+     * replace it: a host whose settings still carry it folds its paths into the
+     * rows during the first scan (see ./catalog.ts `mergeEntries`), so the field
+     * is read once and never written again.
+     */
+    chromeCustomPaths: z<string[], string[]>;
+    /**
+     * Persisted UI "Reduce log output" toggle: "log" captures the bridge's
+     * stderr into the log file, "console" echoes it (debug). "" follows the
+     * row-config `bridgeStderr` (mirrored into `rowStderr`).
+     */
+    stderrMode: z<string, string>;
+    /** Last check/connection failure, human-readable; empty when healthy. */
+    lastError: z<string, string>;
+    /** Known error: the last failure was "no Chrome executable detected". */
+    chromeMissing: z<boolean, boolean>;
+    /** Executable-run counter (success or failure); completion signal for every
+     * executable action the card can take. */
+    executableDiscoveryRevision: z<number, number>;
+    /** The version the **selected** executable answered with; "" when nothing
+     * answered — nothing picked, a connect mode, or a blocked path. */
+    chromeVersion: z<string, string>;
+    /** Per-row probe status keyed by path: the version the row answered with,
+     * and the failure for a row that is present but not runnable (or blocked).
+     * Base layer, never persisted — the rows themselves live in the user
+     * layer. */
+    executableStatus: z<({
+        path?: string | null | undefined;
+        version?: string | null | undefined;
+        error?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<{
+        path: z<string, string>;
+        version: z<string, string>;
+        error: z<string, string>;
+    }>[]>;
+    /** The path the bridge actually launches with ("" when nothing is fixed).
+     * Base layer, never persisted. */
+    effectiveChromePath: z<string, string>;
+    /** Where `effectiveChromePath` came from — picked (`"selected"`), row config
+     * (`"row-config"`) or nothing yet (""). Base layer, never persisted. */
+    effectiveSource: z<string, string>;
+    /** Row-config `bridgeStderr` in effect (static base layer; never
+     * persisted) — the fallback when `stderrMode` is "". */
+    rowStderr: z<"log" | "console", "log" | "console">;
+    /** The canonical default extra-flags list (static base layer; never
+     * persisted) — the list the card's **Restore defaults** control appends to
+     * what the editor holds. Mirror of `DEFAULT_EXTRA_FLAGS`. */
+    defaultExtraFlags: z<string[], string[]>;
+    /** The recommended WSL ↔ Windows extra-flags list (static base layer;
+     * never persisted) — the list the card's **Flags WSL** control appends to
+     * what the editor holds, missing entries only. Mirror of
+     * `WSL_EXTRA_FLAGS`. */
+    wslExtraFlags: z<string[], string[]>;
+    /** True while this host runs under WSL and the selected executable is a
+     * Windows binary — the state the card's notice explains. Base layer, never
+     * persisted (see ./platform.ts). */
+    wslWindowsExecutable: z<boolean, boolean>;
+    /** What the **Prelaunch Windows Chrome** run is doing (base layer; never
+     * persisted) — the single field the card derives the button's state, its
+     * disabled reason and the pill's connect-mode muting from. The locate,
+     * prereq, launch and port answers all live host-side (./windows/), so
+     * the card never carries a list of Windows paths or reachability rules. */
+    windowsChromeStatus: z<Schemastery.ObjectS<{
+        state: z<string, string>;
+        port: z<number, number>;
+        error: z<string, string>;
+    }>, Schemastery.ObjectT<{
+        state: z<string, string>;
+        port: z<number, number>;
+        error: z<string, string>;
+    }>>;
+    /** True while the bridge launches with a connect-mode flag
+     * (`--browserUrl` / `--wsEndpoint`): no local executable is then launched
+     * or probed, so the card mutes the picker. Base layer, never persisted. */
+    carriesConnectionMode: z<boolean, boolean>;
+}>>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/host/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAqBzC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;IAYf;;;;6CAIyC;;IAEzC;4DACwD;;;;;;;;;;;;;;;;;;;;;;;;IAPxD;;;;6CAIyC;;IAEzC;4DACwD;;GAE1D,CAAC;AA2BH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc;IACvB;8EAC0E;;IAE1E;6EACyE;;IAEzE;;;8EAG0E;;IAE1E;;;;OAIG;;IAEH;;6EAEyE;;;;;;;;IAEzE;;;;;OAKG;;IAEH;;;;OAIG;;IAEH,yEAAyE;;IAEzE,yEAAyE;;IAEzE;8CAC0C;;IAE1C;uEACmE;;IAEnE;;;gBAGY;;;;;;;;;;IAEZ;sCACkC;;IAElC;4EACwE;;IAExE;4DACwD;;IAExD;;iEAE6D;;IAE7D;;;4BAGwB;;IAExB;;wCAEoC;;IAEpC;;;;+EAI2E;;;;;;;;;;IAE3E;;+EAE2E;;;IA/E3E;8EAC0E;;IAE1E;6EACyE;;IAEzE;;;8EAG0E;;IAE1E;;;;OAIG;;IAEH;;6EAEyE;;;;;;;;IAEzE;;;;;OAKG;;IAEH;;;;OAIG;;IAEH,yEAAyE;;IAEzE,yEAAyE;;IAEzE;8CAC0C;;IAE1C;uEACmE;;IAEnE;;;gBAGY;;;;;;;;;;IAEZ;sCACkC;;IAElC;4EACwE;;IAExE;4DACwD;;IAExD;;iEAE6D;;IAE7D;;;4BAGwB;;IAExB;;wCAEoC;;IAEpC;;;;+EAI2E;;;;;;;;;;IAE3E;;+EAE2E;;GAE7E,CAAC"}

package/lib/host/schema.js

@@ -0,0 +1,171 @@
+/**
+ * The two zod schemas: the cordis row config and the settings section.
+ *
+ * The row config validates what lives in the profile (one row per plugin
+ * instance); the settings schema describes the namespace the Web GUI card
+ * edits — the persisted user layer (flags, the executable selection, the saved
+ * executable rows, the stderr toggle and the one action trigger) plus the
+ * base-layer status fields served alongside it.
+ */
+import z from "@deepseek-ai/schemastery";
+import { CHROME_PATH_PATTERN, DEFAULT_EXTRA_FLAGS, EFFECTIVE_SOURCE_PATTERN, OPTIONAL_PATH_PATTERN, STDERR_MODE_FIELD_PATTERN, WINDOWS_CHROME_STATE_PATTERN, WSL_EXTRA_FLAGS } from "./constants.js";
+import { defaultChromePaths } from "./discovery/index.js";
+/** Reconnect policy passthrough; mirrors dsh-mcp-client's schema. */
+const Reconnect = z.object({
+    enabled: z.boolean().default(true),
+    initialDelayMs: z.number().min(1).max(600000).default(500),
+    maxDelayMs: z.number().min(1).max(600000).default(30000),
+    maxAttempts: z.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER).default(10)
+});
+export const Config = z.object({
+    serverName: z.string().pattern(/^[A-Za-z0-9_-]{1,32}$/).default("chrome"),
+    command: z.string().default("npx"),
+    package: z.string().min(1).default("chrome-devtools-mcp@latest"),
+    extraFlags: z.array(String).default(DEFAULT_EXTRA_FLAGS),
+    chromePath: z.string().default(""),
+    chromePaths: z.array(String).default(defaultChromePaths()),
+    env: z.dict(String).default({}),
+    cwd: z.string().default(""),
+    toolCallTimeoutMs: z.number().default(60000),
+    failOnStartupError: z.boolean().default(false),
+    reconnect: Reconnect,
+    /** Bridge console-output routing: "log" (default) redirects the spawned
+     * npx child's inherited stderr into a per-spawn log file so its progress
+     * / startup lines stay out of the dsh console; "console" inherits it
+     * (debug). The card's "Reduce log output" toggle (`stderrMode`) overrides
+     * this. See {@link buildBridgeSpawn}. */
+    bridgeStderr: z.union([z.const("log"), z.const("console")]).default("log"),
+    /** Log path override for "log" mode; "" = auto (see
+     * {@link bridgeStderrLogPath}). Absolute paths only. */
+    bridgeStderrLog: z.string().default("").pattern(OPTIONAL_PATH_PATTERN)
+});
+/** One saved-executable catalog row: `id` is the path that goes on the wire
+ * (`--executablePath=<id>`), `name` the label the user chose for the UI
+ * ("" = render the path). Persisted. */
+const ExecutableEntrySchema = z.object({
+    id: z.string().default("").pattern(CHROME_PATH_PATTERN),
+    name: z.string().default("")
+});
+/** What one saved row's probe answered with, keyed by its id (`path`): the
+ * `--version` line, and the failure that makes it not runnable. Base layer. */
+const ExecutableStatusSchema = z.object({
+    path: z.string().default("").pattern(CHROME_PATH_PATTERN),
+    version: z.string().default(""),
+    error: z.string().default("")
+});
+/** The served Windows-Chrome state: what the **Prelaunch Windows Chrome** run is
+ * doing, the debugging port it settled on (0 = none) and the failure line.
+ * Base layer. */
+const WindowsChromeStatusSchema = z.object({
+    state: z.string().pattern(WINDOWS_CHROME_STATE_PATTERN).default("off"),
+    port: z.number().default(0),
+    error: z.string().default("")
+});
+/**
+ * User-settings section served to the Web GUI card.
+ *
+ * Persisted (user layer in `$DSH_HOME/settings.yaml`): `extraFlags`,
+ * `chromePath` (the executable the picker selected — or that the host seeded
+ * once), `executables` (the saved-executables rows: `id` = path, `name` = UI
+ * label), `refreshExecutablesNonce` (the card's **Search executables**
+ * trigger), `openWindowsChromeNonce` (the card's **Prelaunch Windows Chrome**
+ * trigger), `chromeCustomPaths` (the **legacy** hand-typed MRU: folded into the
+ * rows once by the first scan, never written again) and `stderrMode` (the
+ * "Reduce log output" toggle: "log" captures the bridge's stderr into a
+ * per-spawn log file, "console" echoes it, "" follows the row-config
+ * `bridgeStderr`).
+ * Served but never persisted (composition base layer held in memory by the
+ * host): `lastError`, `executableDiscoveryRevision`, `chromeVersion`,
+ * `executableStatus`, `chromeMissing`, `effectiveChromePath`,
+ * `effectiveSource`, `wslWindowsExecutable`, `windowsChromeStatus`,
+ * `carriesConnectionMode`, the static `rowStderr` mirror, the static
+ * `defaultExtraFlags` mirror (the canonical defaults list the card's
+ * **Restore defaults** control appends) and the static `wslExtraFlags` mirror
+ * (the recommended WSL ↔ Windows flags the card's **Flags WSL** control
+ * appends) — the client's polls stop when the served revision advances past its
+ * action-time value.
+ */
+export const SettingsSchema = z.object({
+    /** Flags appended after `npx -y <package>`; persisted last UI edit. An
+     * executable-pinning flag is rejected: the executable is picked below. */
+    extraFlags: z.array(String).default(DEFAULT_EXTRA_FLAGS),
+    /** Written by the UI **Search executables** button; the host reacts to it by
+     * re-probing the saved rows and merging what it finds back into them. */
+    refreshExecutablesNonce: z.number().default(0),
+    /** Written by the UI **Prelaunch Windows Chrome** button; the host reacts to it
+     * by running the Windows launch: locate the Windows Chrome, prove the
+     * mirrored-loopback prereq, launch it with a debugging port, and write the
+     * `--browserUrl` connect entry that leaves the bridge in connect mode. */
+    openWindowsChromeNonce: z.number().default(0),
+    /**
+     * The executable the bridge launches with: picked in the picker (a saved
+     * row's `id`) or seeded once by the host's first scan. "" = nothing resolved
+     * yet — there is no auto state to fall back to.
+     */
+    chromePath: z.string().default("").pattern(CHROME_PATH_PATTERN),
+    /** The picker's saved rows — `{ id: path, name: label }`, user-authored. The
+     * host re-normalizes (trim, dedupe, caps) on every read, and a scan merges
+     * what it discovers into them without dropping a name the user chose. */
+    executables: z.array(ExecutableEntrySchema).default([]),
+    /**
+     * **Legacy** MRU of hand-typed executables, newest first. The saved rows
+     * replace it: a host whose settings still carry it folds its paths into the
+     * rows during the first scan (see ./catalog.ts `mergeEntries`), so the field
+     * is read once and never written again.
+     */
+    chromeCustomPaths: z.array(z.string().default("").pattern(CHROME_PATH_PATTERN)).default([]),
+    /**
+     * Persisted UI "Reduce log output" toggle: "log" captures the bridge's
+     * stderr into the log file, "console" echoes it (debug). "" follows the
+     * row-config `bridgeStderr` (mirrored into `rowStderr`).
+     */
+    stderrMode: z.string().default("").pattern(STDERR_MODE_FIELD_PATTERN),
+    /** Last check/connection failure, human-readable; empty when healthy. */
+    lastError: z.string().default(""),
+    /** Known error: the last failure was "no Chrome executable detected". */
+    chromeMissing: z.boolean().default(false),
+    /** Executable-run counter (success or failure); completion signal for every
+     * executable action the card can take. */
+    executableDiscoveryRevision: z.number().default(0),
+    /** The version the **selected** executable answered with; "" when nothing
+     * answered — nothing picked, a connect mode, or a blocked path. */
+    chromeVersion: z.string().default(""),
+    /** Per-row probe status keyed by path: the version the row answered with,
+     * and the failure for a row that is present but not runnable (or blocked).
+     * Base layer, never persisted — the rows themselves live in the user
+     * layer. */
+    executableStatus: z.array(ExecutableStatusSchema).default([]),
+    /** The path the bridge actually launches with ("" when nothing is fixed).
+     * Base layer, never persisted. */
+    effectiveChromePath: z.string().default("").pattern(CHROME_PATH_PATTERN),
+    /** Where `effectiveChromePath` came from — picked (`"selected"`), row config
+     * (`"row-config"`) or nothing yet (""). Base layer, never persisted. */
+    effectiveSource: z.string().default("").pattern(EFFECTIVE_SOURCE_PATTERN),
+    /** Row-config `bridgeStderr` in effect (static base layer; never
+     * persisted) — the fallback when `stderrMode` is "". */
+    rowStderr: z.union([z.const("log"), z.const("console")]).default("log"),
+    /** The canonical default extra-flags list (static base layer; never
+     * persisted) — the list the card's **Restore defaults** control appends to
+     * what the editor holds. Mirror of `DEFAULT_EXTRA_FLAGS`. */
+    defaultExtraFlags: z.array(String).default(DEFAULT_EXTRA_FLAGS),
+    /** The recommended WSL ↔ Windows extra-flags list (static base layer;
+     * never persisted) — the list the card's **Flags WSL** control appends to
+     * what the editor holds, missing entries only. Mirror of
+     * `WSL_EXTRA_FLAGS`. */
+    wslExtraFlags: z.array(String).default(WSL_EXTRA_FLAGS),
+    /** True while this host runs under WSL and the selected executable is a
+     * Windows binary — the state the card's notice explains. Base layer, never
+     * persisted (see ./platform.ts). */
+    wslWindowsExecutable: z.boolean().default(false),
+    /** What the **Prelaunch Windows Chrome** run is doing (base layer; never
+     * persisted) — the single field the card derives the button's state, its
+     * disabled reason and the pill's connect-mode muting from. The locate,
+     * prereq, launch and port answers all live host-side (./windows/), so
+     * the card never carries a list of Windows paths or reachability rules. */
+    windowsChromeStatus: WindowsChromeStatusSchema.default({ state: "off", port: 0, error: "" }),
+    /** True while the bridge launches with a connect-mode flag
+     * (`--browserUrl` / `--wsEndpoint`): no local executable is then launched
+     * or probed, so the card mutes the picker. Base layer, never persisted. */
+    carriesConnectionMode: z.boolean().default(false)
+});
+//# sourceMappingURL=schema.js.map

package/lib/host/schema.js.map

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

package/lib/host/settings.d.ts

@@ -0,0 +1,9 @@
+import type { ChromeMcpController } from "./controller/index.js";
+import type { PluginContext } from "./types/index.js";
+/**
+ * Install the settings namespace and wire its hooks into the controller.
+ * @param ctx - plugin context.
+ * @param controller - the live state created by `apply`.
+ */
+export declare function installChromeMcpSection(ctx: PluginContext, controller: ChromeMcpController): void;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/host/settings.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,kBAAkB,CAAC;AAEzF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAuCjG"}

package/lib/host/settings.js

@@ -0,0 +1,70 @@
+/**
+ * Host half — the `chrome-mcp` settings section.
+ *
+ * Installs the namespace the Web GUI card edits and routes every commit into
+ * the controller. Two contract details decide the shape of this module:
+ *
+ * - `installSection` runs `hooks.onChange()` synchronously at registration,
+ *   which is how a persisted `extraFlags` selection lands on the FIRST
+ *   connection when the settings service is already up (the cold path is
+ *   `readPersistedFlags` in ./values.ts).
+ * - The `validate` hook is the UI write gate: an invalid flags list throws
+ *   inside `installSection` (surfaced on the card), it never reaches the
+ *   running bridge. The executable fields are gated the same way — a path
+ *   carrying control characters can never become a selection nor a saved-row
+ *   id — and `--executablePath` in the flags list is rejected outright,
+ *   because the picker owns that one flag (see ./flags.ts).
+ */
+import { CHROME_PATH_PATTERN, CUSTOM_PATHS_CAP, SETTINGS_NAMESPACE } from "./constants.js";
+import { isValidEntryId } from "./catalog.js";
+import { SettingsSchema } from "./schema.js";
+import { validateExtraFlags } from "./flags.js";
+import { normalizeCustomPaths } from "./values.js";
+/**
+ * Install the settings namespace and wire its hooks into the controller.
+ * @param ctx - plugin context.
+ * @param controller - the live state created by `apply`.
+ */
+export function installChromeMcpSection(ctx, controller) {
+    ctx.inject(["settings"], (inner) => {
+        const settings = inner.settings;
+        if (!settings)
+            return;
+        settings.installSection(inner, SETTINGS_NAMESPACE, SettingsSchema, controller.entry, {
+            setSource: (next) => {
+                controller.setSource(next);
+            },
+            validate: (value) => {
+                try {
+                    validateExtraFlags(value.extraFlags);
+                }
+                catch (error) {
+                    const msg = error instanceof Error ? String(error.message ?? error) : String(error);
+                    throw new Error(`settings "${SETTINGS_NAMESPACE}": ${msg}`);
+                }
+                if (value.stderrMode !== "" && value.stderrMode !== "log" && value.stderrMode !== "console") {
+                    throw new Error(`settings "${SETTINGS_NAMESPACE}": stderrMode must be "log", "console" or empty (row-config default)`);
+                }
+                for (const path of [value.chromePath, ...normalizeCustomPaths(value.chromeCustomPaths, CUSTOM_PATHS_CAP)]) {
+                    if (typeof path !== "string" || path === "" || CHROME_PATH_PATTERN.test(path))
+                        continue;
+                    throw new Error(`settings "${SETTINGS_NAMESPACE}": chromePath "${path}" must be a path without control characters`);
+                }
+                // The saved rows go on the wire the same way the selection does,
+                // so the gate that rejects a control-character path rejects a
+                // control-character row id — a bad row never reaches a scan, and
+                // never reaches argv as `--executablePath=<id>`.
+                for (const row of Array.isArray(value.executables) ? value.executables : []) {
+                    const id = row === null || typeof row !== "object" ? "" : row.id;
+                    if (isValidEntryId(id))
+                        continue;
+                    throw new Error(`settings "${SETTINGS_NAMESPACE}": executable row "${String(id ?? "")}" must carry a path without control characters`);
+                }
+            },
+            onChange: () => {
+                controller.onSettingsChange();
+            }
+        });
+    });
+}
+//# sourceMappingURL=settings.js.map

package/lib/host/settings.js.map

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

package/lib/host/status.d.ts

@@ -0,0 +1,28 @@
+import type { ToolCallResult } from "./types/index.js";
+/** First non-empty line of a text block, capped. */
+export declare function firstLine(text: unknown, cap?: number): string;
+/**
+ * Recognizes the known, developer-actionable error "no Chrome executable was
+ * detected": our own ENOENT/discovery lines, the upstream executable-discovery
+ * failures ("Could not find Google Chrome executable for channel 'stable'
+ * at:", puppeteer's configured-path miss), and the umbrella launch failure
+ * chrome-devtools-mcp surfaces when it cannot start a browser binary. Upstream
+ * starts the browser lazily (on the first tool call), so the check probe is
+ * what surfaces the state without any tool call. Anything else is a generic
+ * check or connection error.
+ * @param text - an error message (or first line thereof).
+ * @returns true when the failure is the known executable-missing state.
+ */
+export declare function isChromeMissing(text: unknown): boolean;
+/**
+ * Summarize one chrome-tool call result for the card's status line. Failed
+ * calls return "<tool> failed: <first text line>" — tool-level errors
+ * (browser unreachable, "Target closed", …) are returned to the calling
+ * agent and never route through the bridge logger, so this is the only
+ * capture point. Successes return null: the caller clears the stored error.
+ * @param toolName - fully qualified registered name (`mcp__<server>__<tool>`).
+ * @param result - settled tools-service execution result.
+ * @returns the note, or null when the call did not fail.
+ */
+export declare function toolResultNote(toolName: string, result: ToolCallResult | null | undefined): string | null;
+//# sourceMappingURL=status.d.ts.map