@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

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

@@ -0,0 +1,37 @@
+export function createChromeRefreshCommand(controller) {
+    return {
+        name: "chrome-refresh",
+        description: "Re-run Chrome executable discovery and merge what exists into the saved rows",
+        input: { hint: "(no arguments)" },
+        async handler() {
+            const live = controller.live;
+            const before = live.executableDiscoveryRevision;
+            try {
+                await controller.run();
+            }
+            catch (error) {
+                return { kind: "error", text: `The executable run failed: ${String(error instanceof Error ? error.message : error)}` };
+            }
+            if (live.executableDiscoveryRevision === before) {
+                return { kind: "error", text: "The executable run did not complete." };
+            }
+            const statuses = live.executableStatus;
+            const found = statuses.filter((status) => status.version !== "");
+            const failed = statuses.filter((status) => status.error !== "");
+            const blocked = statuses.filter((status) => status.note !== "" && status.version === "" && status.error === "");
+            const lines = [`Executable run: ${found.length} runnable, ${failed.length} failed, ${blocked.length} offered-but-never-probed. Found paths merge into the saved rows.`];
+            for (const status of statuses) {
+                const answer = status.version !== "" ? status.version : status.error !== "" ? `failed: ${status.error}` : status.note;
+                lines.push(`  - ${status.path}: ${answer}`);
+            }
+            // A discovery that found nothing runnable is a failed run reported
+            // the way the card reports it — through the error line it carries.
+            if (found.length === 0 && live.lastError !== "")
+                return { kind: "error", text: `${lines.join("\n")}\n${live.lastError}` };
+            if (live.lastError !== "")
+                lines.push(`Note: ${live.lastError}`);
+            return { kind: "success", text: lines.join("\n") };
+        }
+    };
+}
+//# sourceMappingURL=chrome-refresh.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-refresh.js","sourceRoot":"","sources":["../../../src/host/commands/chrome-refresh.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,0BAA0B,CAAC,UAA+B;IACtE,OAAO;QACH,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8EAA8E;QAC3F,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACjC,KAAK,CAAC,OAAO;YACT,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,2BAA2B,CAAC;YAChD,IAAI,CAAC;gBACD,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,8BAA8B,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAC3H,CAAC;YACD,IAAI,IAAI,CAAC,2BAA2B,KAAK,MAAM,EAAE,CAAC;gBAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC;YAC3E,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YAChH,MAAM,KAAK,GAAG,CAAC,mBAAmB,KAAK,CAAC,MAAM,cAAc,MAAM,CAAC,MAAM,YAAY,OAAO,CAAC,MAAM,mEAAmE,CAAC,CAAC;YACxK,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtH,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,mEAAmE;YACnE,mEAAmE;YACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE;gBAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAC1H,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACjE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,CAAC;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Slash commands — the headless mirror of the card's two executable actions.
+ *
+ * The Web card is the primary surface, but a host with no GUI (or a user in an
+ * agent conversation) gets the same two actions: `/chrome-path` picks the
+ * executable and `/chrome-refresh` re-runs the discovery, both writing the SAME
+ * persisted fields through the SAME write-back channel as the card, so the pill,
+ * the command and the default answers never disagree.
+ *
+ * Registration rides the `commands` service lazily for the same reason the
+ * MCP tool avoids a static injection: the service may resolve only after
+ * `apply` returns, and a host without a commands plane simply gets no
+ * registration. Every `register()` disposer is retained so a hot re-apply of
+ * this plugin releases them — the registry throws on a duplicate name.
+ */
+import type { ChromeMcpController } from "../controller/index.js";
+import type { ChromeMcpConfig, PluginContext } from "../types/index.js";
+/**
+ * Register this plugin's commands on the `commands` service.
+ *
+ * @param ctx - plugin context.
+ * @param config - the validated row config (only the log prefix reads it).
+ * @param controller - the live state the commands drive through.
+ */
+export declare function installChromeMcpCommands(ctx: PluginContext, config: ChromeMcpConfig, controller: ChromeMcpController): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAqB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAU3F;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CA0B3H"}

package/lib/host/commands/index.js

@@ -0,0 +1,41 @@
+import { createChromePathCommand } from "./chrome-path.js";
+import { createChromeRefreshCommand } from "./chrome-refresh.js";
+/**
+ * Register this plugin's commands on the `commands` service.
+ *
+ * @param ctx - plugin context.
+ * @param config - the validated row config (only the log prefix reads it).
+ * @param controller - the live state the commands drive through.
+ */
+export function installChromeMcpCommands(ctx, config, controller) {
+    ctx.effect(() => {
+        const commandDisposers = [];
+        let registered = false;
+        ctx.inject(["commands"], (inner) => {
+            if (registered)
+                return;
+            const commands = inner.commands;
+            // A host without a commands plane answers this half with nothing.
+            if (commands === undefined)
+                return;
+            registered = true;
+            for (const definition of [createChromePathCommand(controller), createChromeRefreshCommand(controller)]) {
+                // The registry throws on a duplicate name — a re-apply racing a
+                // still-live registration. The earlier definitions stay live, so
+                // a warning beats breaking `apply`.
+                try {
+                    commandDisposers.push(commands.register(definition));
+                }
+                catch (error) {
+                    ctx.logger.warn(`dsh-chrome-mcp(${config.serverName}): command "${definition.name}" registration skipped: ${String(error)}`);
+                }
+            }
+        });
+        return () => {
+            for (const dispose of commandDisposers.splice(0))
+                dispose();
+            registered = false;
+        };
+    }, "chrome-mcp: slash commands");
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/commands/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAQjE;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAkB,EAAE,MAAuB,EAAE,UAA+B;IACjH,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QACZ,MAAM,gBAAgB,GAAsB,EAAE,CAAC;QAC/C,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,KAAoB,EAAE,EAAE;YAC9C,IAAI,UAAU;gBAAE,OAAO;YACvB,MAAM,QAAQ,GAAI,KAAwC,CAAC,QAAQ,CAAC;YACpE,kEAAkE;YAClE,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO;YACnC,UAAU,GAAG,IAAI,CAAC;YAClB,KAAK,MAAM,UAAU,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBACrG,gEAAgE;gBAChE,iEAAiE;gBACjE,oCAAoC;gBACpC,IAAI,CAAC;oBACD,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;gBACzD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,UAAU,eAAe,UAAU,CAAC,IAAI,2BAA2B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACjI,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACR,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC5D,UAAU,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;IACN,CAAC,EAAE,4BAA4B,CAAC,CAAC;AACrC,CAAC"}

package/lib/host/constants.d.ts

@@ -1,22 +1,42 @@
 /**
  * Host-half fixed identifiers, budgets and validation patterns.
  *
- * The strings are a public contract — the settings namespace is both the
- * persistence key and the Web card's slot key — and the budgets are what the
- * README and the tests quote, so they live here once and every module imports
- * rather than repeats them.
+ * The strings are a public contract — the profile entry id is both the
+ * persistence key and the Web card's configuration-form key — and the budgets
+ * are what the README and the tests quote, so they live here once and every
+ * module imports rather than repeats them.
  */
-/** Fixed settings namespace; also the client card's slot key. */
-export declare const SETTINGS_NAMESPACE = "chrome-mcp";
+/**
+ * The profile entry id the bundle patch inserts (`cordis.patch.yml`), and the
+ * key every read and write of the configuration form goes through. Since dsh
+ * 0.2.0 the card addresses the Host through the **entry id**, not a namespace of
+ * its own, and `serverName` is not part of that identity. The Host reads the
+ * live id off its own fiber (`chromeMcpEntryId`) so a renamed row keeps
+ * working; this constant is what the loud failure and the log lines name.
+ */
+export declare const ENTRY_ID = "mcp-chrome";
 /** Environment variable that seeds the launch flags for one dsh run. */
 export declare const FLAGS_ENV_VAR = "DSH_CHROME_MCP_FLAGS";
 /**
  * Flag entries are appended verbatim to the bridge argv and reach Chrome via
  * a direct execve (no shell), so shell metacharacters cannot execute here.
  * What must never reach argv is control characters (newlines, NULs) — they
- * corrupt the argument framing, so entries may not contain any.
+ * corrupt the argument framing, so entries may not contain any. This is the
+ * `extraFlags` field's own pattern: a form write naming a control character is
+ * refused Host-side, by the schema rather than by a `validate` hook.
  */
 export declare const CONTROL_PATTERN: RegExp;
+/**
+ * One `extraFlags` entry as a form write may land it: non-empty, and no control
+ * character. This is the field's own pattern, so the gate that refuses them is
+ * the **schema**, not a `validate` hook — the write path runs it Host-side, on
+ * every layer (a row config carrying a newline fails to resolve rather than
+ * reaching argv as a corrupt entry). Spaces inside a value stay allowed: a
+ * Windows-style path in a flag value is one argv item, never a shell word (see
+ * ./flags.ts `validateExtraFlags` for what the paths the form never edits —
+ * `DSH_CHROME_MCP_FLAGS`, the row config — still check).
+ */
+export declare const EXTRA_FLAG_PATTERN: RegExp;
 /** Flags every launch carries unless the user overrides them. */
 export declare const DEFAULT_EXTRA_FLAGS: string[];
 /**
@@ -46,17 +66,39 @@ export declare const CONFIGURATION_DOCS_URL = "https://github.com/ChromeDevTools
 /** Timeout for one check subprocess (chrome executable probe). */
 export declare const CHECK_TIMEOUT_MS = 15000;
 /**
- * Why a Windows `chrome.exe` on a WSL host is **never probed**. The exec answers
- * successfully — which is what makes the selection look healthy — but answering
- * means *attaching to the Windows browser session*, and that brings a browser
- * instance up (measured on WSL2 + Google Chrome 153: `chrome.exe --version`
- * spawns the browser process plus its crashpad handler). No tool call could
- * ever drive what it started (the debug pipes do not cross the interop
- * boundary), so the probe buys nothing and costs a running browser: the check
- * answers nothing, and the scan keeps the entry visible as `unavailable` with
- * this reason.
- */
-export declare const WSL_WINDOWS_LAUNCH_ERROR = "Windows chrome.exe cannot be launched from WSL \u2014 use connect mode (--browserUrl / --wsEndpoint) against a Chrome started with --remote-debugging-port";
+ * What a Windows executable answers when no version folder sits beside it. On
+ * Windows a Chromium browser does not answer `--version`: it opens a window
+ * (or hands one to the instance already running), so it is never spawned to
+ * ask — the version is read off the install's own `<major>.<minor>.<build>.<patch>`
+ * folder instead, and an install without one answers this.
+ */
+export declare const WINDOWS_VERSION_UNKNOWN = "version unknown";
+/**
+ * How long a failed executable run waits before its one bounded retry. The
+ * failure this answers is not "nothing is installed here" — it is a host that
+ * is not ready yet at the moment the run fires (a WSL boot whose interop
+ * mount has not been served yet, a drive not yet mounted). Without the retry
+ * that answer would stand until someone fired the run again by hand.
+ */
+export declare const DISCOVERY_RETRY_DELAY_MS = 15000;
+/** How many retries one run chain may arm. Bounded so a machine with nothing
+ * installed is never probed forever — four passes span a boot window, and the
+ * manual trigger stays the answer beyond it. */
+export declare const DISCOVERY_RETRY_MAX = 4;
+/**
+ * Why a Windows `chrome.exe` on a WSL host is **never probed** — and, since the
+ * Windows executables this host carries *are* offered as candidates, what such a
+ * candidate reads as instead of a failure. The exec answers successfully — which
+ * is what makes the selection look healthy — but answering means *attaching to
+ * the Windows browser session*, and that brings a browser instance up (measured
+ * on WSL2 + Google Chrome 153: `chrome.exe --version` spawns the browser process
+ * plus its crashpad handler). No tool call could ever drive what it started (the
+ * debug pipes do not cross the interop boundary), so the probe buys nothing and
+ * costs a running browser: the check answers nothing, and the scan keeps the
+ * entry visible carrying this reason — as its **note**, never as a failure,
+ * because the **Prelaunch Windows Chrome** run drives it in connect mode.
+ */
+export declare const WSL_WINDOWS_LAUNCH_ERROR = "Windows chrome.exe cannot be launched from WSL \u2014 run Prelaunch Windows Chrome to drive it in connect mode";
 /** Max length of a reported error line. */
 export declare const ERROR_CAP = 240;
 /**
@@ -79,17 +121,51 @@ export declare const STDERR_MODE_FIELD_PATTERN: RegExp;
  * POSIX absolute path; nothing else. */
 export declare const OPTIONAL_PATH_PATTERN: RegExp;
 /**
- * Candidate POSIX shells used only to redirect the bridge's stderr (see
- * ./bridge.ts `buildBridgeSpawn`). None found on a bare Windows host → the
- * redirect is impossible and the spawn stays unwrapped with `fallback:
- * "platform"`/`"shell"`.
+ * The connection kinds this component registers with the manager's
+ * `mcpConnections` service. They are the
+ * component: the row stands up no bridge of its own any more, every live bridge
+ * is one of these connections.
+ *
+ * `chrome` — the local `chrome-devtools-mcp` bridge, what the row used to start
+ * for itself. `chrome-windows` — the Windows browser driven through the WSL
+ * interop mount (the run the **Prelaunch Windows Chrome** button answers with),
+ * async to launch. The ids are the contract with `servers` entries; the labels
+ * are what the picker lists. Neither kind caps its entries and neither carries
+ * a composer pill.
+ */
+export declare const KIND_ID_CHROME = "chrome";
+export declare const KIND_ID_WINDOWS = "chrome-windows";
+export declare const KIND_CHROME_LABEL = "Chrome MCP";
+export declare const KIND_CHROME_SUMMARY = "Runs `chrome-devtools-mcp` and launches a local Chrome. The executable and the flags are picked on the connection.";
+export declare const KIND_WINDOWS_LABEL = "Windows Chrome (WSL debug port)";
+export declare const KIND_WINDOWS_SUMMARY = "Opens the Windows Chrome through the WSL interop mount and connects to its debugging port. WSL only.";
+/**
+ * The keys one entry's `extra` carries for these kinds. They are a contract with
+ * the manager's entry editor: what the fields write is exactly what `resolve`
+ * reads back. `extraFlags` is a `lines` field, so its value is one flag per
+ * line joined by newlines (see ./kind.ts `parseFlagLines`).
+ */
+export declare const KIND_FIELDS: {
+    readonly executable: "executable";
+    readonly extraFlags: "extraFlags";
+    readonly stderrMode: "stderrMode";
+};
+/**
+ * Whether the translation of a **standalone** row config has been offered and
+ * turned down. It is a volatile field of this
+ * row — what was refused is this row's configuration, so the dismissal lives
+ * here and nowhere else.
  */
-export declare const SH_PATH_CANDIDATES: readonly ["/bin/sh", "/usr/bin/sh"];
+export declare const MIGRATION_DISMISSED_FIELD = "migrationDismissed";
+/** One entry's extra flag lines joined the way a `lines` field stores them. */
+export declare const FLAG_LINE_SEPARATOR = "\n";
+/** Why the `chrome-windows` kind refuses an entry off WSL (spec §2: not-applicable). */
+export declare const NOT_WSL_ERROR = "This host is not a WSL instance: there is no Windows-side browser to drive \u2014 use the Chrome MCP kind instead";
 /**
  * `chromePath` user layer: a filesystem path or a PATH-resolved name. Nothing
  * travels through a shell here either, so the only hard constraint is that no
  * control character reaches it; the length cap keeps one absurd value out of
- * argv and out of the settings document.
+ * argv and out of the row's own patch layer.
  */
 export declare const CHROME_PATH_PATTERN: RegExp;
 /** Upper bound of the **legacy** UI-authored custom-executable MRU (oldest
@@ -107,12 +183,13 @@ export declare const CATALOG_NAME_MAX_LENGTH = 200;
  * catalog without limit. */
 export declare const CATALOG_MAX_LENGTH = 50;
 /**
- * The Windows-side Chrome/Edge executables the card's **Prelaunch Windows Chrome**
- * button locates through the WSL interop mount. They are NOT local picker
- * candidates — the picker must never offer what cannot be launched from
- * Linux (hard constraint) — the button exists precisely because Windows
- * Chrome is only usable in *connect* mode. The list is host-served logic: the
- * card carries no copy of it.
+ * The Windows-side Chrome/Edge executables this host carries. The
+ * **Prelaunch Windows Chrome** button locates through them, and — on a WSL host
+ * only — the executable run folds the ones this machine actually carries into its
+ * candidate list, so the picker can name the executable the run drives. They are
+ * never *probed* from here (`WSL_WINDOWS_LAUNCH_ERROR`): the run drives them in
+ * *connect* mode, which is the only Windows path ever measured to work. The list
+ * is host-served logic: the card carries no copy of it.
  */
 export declare const WINDOWS_CHROME_CANDIDATES: readonly ["C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe", "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe", "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe", "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe"];
 /** The debugging port every Windows Chrome launch carries first — kept

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/host/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/host/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,wEAAwE;AACxE,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,QAAqB,CAAC;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QAA6B,CAAC;AAE7D,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,UAAqD,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,UAA+C,CAAC;AAE5E,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,0FACwD,CAAC;AAE5F,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C;;gDAEgD;AAChD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,mHAC0E,CAAC;AAEhH,2CAA2C;AAC3C,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAqC,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,UAAU,+DAAgE,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,KAAK,GAAG,SAAS,CAAsB,CAAC;AAExF;kDACkD;AAClD,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAE/D;wCACwC;AACxC,eAAO,MAAM,qBAAqB,QAAgC,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AACvC,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,mBAAmB,uHAAuH,CAAC;AACxJ,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AACpE,eAAO,MAAM,oBAAoB,yGAAyG,CAAC;AAE3I;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,wFAAwF;AACxF,eAAO,MAAM,aAAa,sHACwF,CAAC;AAEnH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAgC,CAAC;AAEjE;;;;oDAIoD;AACpD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;eAEe;AACf,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;4BAE4B;AAC5B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,iRAK5B,CAAC;AAEX;kEACkE;AAClE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;+EAE+E;AAC/E,eAAO,MAAM,wBAAwB,6BAA8B,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,sBAAuB,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C;yEACyE;AACzE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,iEAAiE;AACjE,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAE/D,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,2DAA4D,CAAC;AAExG;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,yCAAyC,CAAC;AAEnF;;yDAEyD;AACzD,eAAO,MAAM,+BAA+B,cAAc,CAAC;AAE3D;;;6EAG6E;AAC7E,eAAO,MAAM,qBAAqB,2GAQxB,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,4BAA4B,QAAsF,CAAC;AAEhI;;;GAGG;AACH,eAAO,MAAM,2BAA2B,mKAC4H,CAAC;AAErK;;iDAEiD;AACjD,eAAO,MAAM,iBAAiB,qCAAsC,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,YAAY,iEAAkE,CAAC;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,wCAAwC,CAAC;AAExE;iDACiD;AACjD,eAAO,MAAM,oBAAoB,QAAoD,CAAC;AAEtF;iFACiF;AACjF,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAE9C,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,QAAgC,CAAC"}

package/lib/host/constants.js

@@ -1,22 +1,42 @@
 /**
  * Host-half fixed identifiers, budgets and validation patterns.
  *
- * The strings are a public contract — the settings namespace is both the
- * persistence key and the Web card's slot key — and the budgets are what the
- * README and the tests quote, so they live here once and every module imports
- * rather than repeats them.
+ * The strings are a public contract — the profile entry id is both the
+ * persistence key and the Web card's configuration-form key — and the budgets
+ * are what the README and the tests quote, so they live here once and every
+ * module imports rather than repeats them.
  */
-/** Fixed settings namespace; also the client card's slot key. */
-export const SETTINGS_NAMESPACE = "chrome-mcp";
+/**
+ * The profile entry id the bundle patch inserts (`cordis.patch.yml`), and the
+ * key every read and write of the configuration form goes through. Since dsh
+ * 0.2.0 the card addresses the Host through the **entry id**, not a namespace of
+ * its own, and `serverName` is not part of that identity. The Host reads the
+ * live id off its own fiber (`chromeMcpEntryId`) so a renamed row keeps
+ * working; this constant is what the loud failure and the log lines name.
+ */
+export const ENTRY_ID = "mcp-chrome";
 /** Environment variable that seeds the launch flags for one dsh run. */
 export const FLAGS_ENV_VAR = "DSH_CHROME_MCP_FLAGS";
 /**
  * Flag entries are appended verbatim to the bridge argv and reach Chrome via
  * a direct execve (no shell), so shell metacharacters cannot execute here.
  * What must never reach argv is control characters (newlines, NULs) — they
- * corrupt the argument framing, so entries may not contain any.
+ * corrupt the argument framing, so entries may not contain any. This is the
+ * `extraFlags` field's own pattern: a form write naming a control character is
+ * refused Host-side, by the schema rather than by a `validate` hook.
  */
 export const CONTROL_PATTERN = /[\x00-\x1f\x7f]/u;
+/**
+ * One `extraFlags` entry as a form write may land it: non-empty, and no control
+ * character. This is the field's own pattern, so the gate that refuses them is
+ * the **schema**, not a `validate` hook — the write path runs it Host-side, on
+ * every layer (a row config carrying a newline fails to resolve rather than
+ * reaching argv as a corrupt entry). Spaces inside a value stay allowed: a
+ * Windows-style path in a flag value is one argv item, never a shell word (see
+ * ./flags.ts `validateExtraFlags` for what the paths the form never edits —
+ * `DSH_CHROME_MCP_FLAGS`, the row config — still check).
+ */
+export const EXTRA_FLAG_PATTERN = /^(?:[^\x00-\x1f\x7f]+)$/u;
 /** Flags every launch carries unless the user overrides them. */
 export const DEFAULT_EXTRA_FLAGS = ["--no-usage-statistics", "--no-performance-crux"];
 /**
@@ -46,17 +66,39 @@ export const CONFIGURATION_DOCS_URL = "https://github.com/ChromeDevTools/chrome-
 /** Timeout for one check subprocess (chrome executable probe). */
 export const CHECK_TIMEOUT_MS = 15000;
 /**
- * Why a Windows `chrome.exe` on a WSL host is **never probed**. The exec answers
- * successfully — which is what makes the selection look healthy — but answering
- * means *attaching to the Windows browser session*, and that brings a browser
- * instance up (measured on WSL2 + Google Chrome 153: `chrome.exe --version`
- * spawns the browser process plus its crashpad handler). No tool call could
- * ever drive what it started (the debug pipes do not cross the interop
- * boundary), so the probe buys nothing and costs a running browser: the check
- * answers nothing, and the scan keeps the entry visible as `unavailable` with
- * this reason.
- */
-export const WSL_WINDOWS_LAUNCH_ERROR = "Windows chrome.exe cannot be launched from WSL — use connect mode (--browserUrl / --wsEndpoint) against a Chrome started with --remote-debugging-port";
+ * What a Windows executable answers when no version folder sits beside it. On
+ * Windows a Chromium browser does not answer `--version`: it opens a window
+ * (or hands one to the instance already running), so it is never spawned to
+ * ask — the version is read off the install's own `<major>.<minor>.<build>.<patch>`
+ * folder instead, and an install without one answers this.
+ */
+export const WINDOWS_VERSION_UNKNOWN = "version unknown";
+/**
+ * How long a failed executable run waits before its one bounded retry. The
+ * failure this answers is not "nothing is installed here" — it is a host that
+ * is not ready yet at the moment the run fires (a WSL boot whose interop
+ * mount has not been served yet, a drive not yet mounted). Without the retry
+ * that answer would stand until someone fired the run again by hand.
+ */
+export const DISCOVERY_RETRY_DELAY_MS = 15000;
+/** How many retries one run chain may arm. Bounded so a machine with nothing
+ * installed is never probed forever — four passes span a boot window, and the
+ * manual trigger stays the answer beyond it. */
+export const DISCOVERY_RETRY_MAX = 4;
+/**
+ * Why a Windows `chrome.exe` on a WSL host is **never probed** — and, since the
+ * Windows executables this host carries *are* offered as candidates, what such a
+ * candidate reads as instead of a failure. The exec answers successfully — which
+ * is what makes the selection look healthy — but answering means *attaching to
+ * the Windows browser session*, and that brings a browser instance up (measured
+ * on WSL2 + Google Chrome 153: `chrome.exe --version` spawns the browser process
+ * plus its crashpad handler). No tool call could ever drive what it started (the
+ * debug pipes do not cross the interop boundary), so the probe buys nothing and
+ * costs a running browser: the check answers nothing, and the scan keeps the
+ * entry visible carrying this reason — as its **note**, never as a failure,
+ * because the **Prelaunch Windows Chrome** run drives it in connect mode.
+ */
+export const WSL_WINDOWS_LAUNCH_ERROR = "Windows chrome.exe cannot be launched from WSL — run Prelaunch Windows Chrome to drive it in connect mode";
 /** Max length of a reported error line. */
 export const ERROR_CAP = 240;
 /**
@@ -79,17 +121,51 @@ export const STDERR_MODE_FIELD_PATTERN = /^(?:log|console)?$/u;
  * POSIX absolute path; nothing else. */
 export const OPTIONAL_PATH_PATTERN = /^(?:\/[^\x00-\x1f\x7f]*|)$/u;
 /**
- * Candidate POSIX shells used only to redirect the bridge's stderr (see
- * ./bridge.ts `buildBridgeSpawn`). None found on a bare Windows host → the
- * redirect is impossible and the spawn stays unwrapped with `fallback:
- * "platform"`/`"shell"`.
+ * The connection kinds this component registers with the manager's
+ * `mcpConnections` service. They are the
+ * component: the row stands up no bridge of its own any more, every live bridge
+ * is one of these connections.
+ *
+ * `chrome` — the local `chrome-devtools-mcp` bridge, what the row used to start
+ * for itself. `chrome-windows` — the Windows browser driven through the WSL
+ * interop mount (the run the **Prelaunch Windows Chrome** button answers with),
+ * async to launch. The ids are the contract with `servers` entries; the labels
+ * are what the picker lists. Neither kind caps its entries and neither carries
+ * a composer pill.
+ */
+export const KIND_ID_CHROME = "chrome";
+export const KIND_ID_WINDOWS = "chrome-windows";
+export const KIND_CHROME_LABEL = "Chrome MCP";
+export const KIND_CHROME_SUMMARY = "Runs `chrome-devtools-mcp` and launches a local Chrome. The executable and the flags are picked on the connection.";
+export const KIND_WINDOWS_LABEL = "Windows Chrome (WSL debug port)";
+export const KIND_WINDOWS_SUMMARY = "Opens the Windows Chrome through the WSL interop mount and connects to its debugging port. WSL only.";
+/**
+ * The keys one entry's `extra` carries for these kinds. They are a contract with
+ * the manager's entry editor: what the fields write is exactly what `resolve`
+ * reads back. `extraFlags` is a `lines` field, so its value is one flag per
+ * line joined by newlines (see ./kind.ts `parseFlagLines`).
+ */
+export const KIND_FIELDS = {
+    executable: "executable",
+    extraFlags: "extraFlags",
+    stderrMode: "stderrMode"
+};
+/**
+ * Whether the translation of a **standalone** row config has been offered and
+ * turned down. It is a volatile field of this
+ * row — what was refused is this row's configuration, so the dismissal lives
+ * here and nowhere else.
  */
-export const SH_PATH_CANDIDATES = ["/bin/sh", "/usr/bin/sh"];
+export const MIGRATION_DISMISSED_FIELD = "migrationDismissed";
+/** One entry's extra flag lines joined the way a `lines` field stores them. */
+export const FLAG_LINE_SEPARATOR = "\n";
+/** Why the `chrome-windows` kind refuses an entry off WSL (spec §2: not-applicable). */
+export const NOT_WSL_ERROR = "This host is not a WSL instance: there is no Windows-side browser to drive — use the Chrome MCP kind instead";
 /**
  * `chromePath` user layer: a filesystem path or a PATH-resolved name. Nothing
  * travels through a shell here either, so the only hard constraint is that no
  * control character reaches it; the length cap keeps one absurd value out of
- * argv and out of the settings document.
+ * argv and out of the row's own patch layer.
  */
 export const CHROME_PATH_PATTERN = /^[^\x00-\x1f\x7f]{0,4096}$/u;
 /** Upper bound of the **legacy** UI-authored custom-executable MRU (oldest
@@ -107,12 +183,13 @@ export const CATALOG_NAME_MAX_LENGTH = 200;
  * catalog without limit. */
 export const CATALOG_MAX_LENGTH = 50;
 /**
- * The Windows-side Chrome/Edge executables the card's **Prelaunch Windows Chrome**
- * button locates through the WSL interop mount. They are NOT local picker
- * candidates — the picker must never offer what cannot be launched from
- * Linux (hard constraint) — the button exists precisely because Windows
- * Chrome is only usable in *connect* mode. The list is host-served logic: the
- * card carries no copy of it.
+ * The Windows-side Chrome/Edge executables this host carries. The
+ * **Prelaunch Windows Chrome** button locates through them, and — on a WSL host
+ * only — the executable run folds the ones this machine actually carries into its
+ * candidate list, so the picker can name the executable the run drives. They are
+ * never *probed* from here (`WSL_WINDOWS_LAUNCH_ERROR`): the run drives them in
+ * *connect* mode, which is the only Windows path ever measured to work. The list
+ * is host-served logic: the card carries no copy of it.
  */
 export const WINDOWS_CHROME_CANDIDATES = [
     "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",

package/lib/host/constants.js.map

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

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

@@ -0,0 +1,3 @@
+/** Trace one event. Never throws: diagnostics must not change behavior. */
+export declare function trace(event: Record<string, unknown>): void;
+//# sourceMappingURL=_trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_trace.d.ts","sourceRoot":"","sources":["../../../src/host/controller/_trace.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM1D"}

package/lib/host/controller/_trace.js

@@ -0,0 +1,14 @@
+// TEMPORARY diagnostic: append one JSON line per traced event to a scratch
+// log so a live reproduction can be inspected without a browser console.
+import { appendFileSync } from "node:fs";
+const PATH = "/tmp/dsh-chrome-home/plugin-trace.log";
+/** Trace one event. Never throws: diagnostics must not change behavior. */
+export function trace(event) {
+    try {
+        appendFileSync(PATH, `${new Date().toISOString()} ${JSON.stringify(event)}\n`);
+    }
+    catch {
+        // Scratch home not writable — nothing to do.
+    }
+}
+//# sourceMappingURL=_trace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_trace.js","sourceRoot":"","sources":["../../../src/host/controller/_trace.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,IAAI,GAAG,uCAAuC,CAAC;AAErD,2EAA2E;AAC3E,MAAM,UAAU,KAAK,CAAC,KAA8B;IAChD,IAAI,CAAC;QACD,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACL,6CAA6C;IACjD,CAAC;AACL,CAAC"}

package/lib/host/controller/bridge-run.d.ts

@@ -10,8 +10,10 @@
 import { bridgeConfig } from "../bridge.js";
 import type { BridgeStderrMode, ChromeMcpConfig } from "../types/index.js";
 import type { Controller } from "./state.js";
-/** The row config as the bridge/config builders see it: effective executable,
- * cleaned row flags. The logical argv shape is unchanged. */
+/** The bridge's own view of one config: the ordinary passthroughs ride along
+ * verbatim, and the two levers the run owns — the flags list and the resolved
+ * selection — are handed in explicitly, so nothing here mistakes a reference for
+ * a value. The logical argv shape is unchanged. */
 export declare function configForBridge(controller: Controller, flags: string[]): ChromeMcpConfig;
 /**
  * Restart the bridge connection with one built config.

package/lib/host/controller/bridge-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-run.d.ts","sourceRoot":"","sources":["../../../src/host/controller/bridge-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;6DAC6D;AAC7D,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAExF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUhH;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAWxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAOpF"}
+{"version":3,"file":"bridge-run.d.ts","sourceRoot":"","sources":["../../../src/host/controller/bridge-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;mDAGmD;AACnD,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAExF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBhH;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAexE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CASpF"}