@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/host/values.d.ts

@@ -0,0 +1,204 @@
+import type { BridgeStderrMode, ChromeExecutableEntry, ChromeMcpConfig, ConfigField, ConfigLayers, ConfigLiveFields, SettingsFormRow, SettingsForms } from "./types/index.js";
+/**
+ * Environment variable that seeds the launch flags for one dsh run: a
+ * whitespace-separated extraFlags list, e.g.
+ * `DSH_CHROME_MCP_FLAGS="--headless --isolated"`.
+ */
+export { FLAGS_ENV_VAR } from "./constants.js";
+/**
+ * Read one config field. A `.volatile()` field arrives as a reference the fiber
+ * resolves live (dsh 0.2.0: `apply` hands references, ordinary fields plain
+ * values), so reading the field's type is not enough — this is the one way every
+ * volatile read answers, whether what it holds is a reference or, on the cold
+ * path of a hand-built config, the plain value itself.
+ *
+ * A reference hands a snapshot, so arrays come back copied: the running state
+ * holds values, never the reference's own object.
+ * @param field - what the config carries for that field.
+ * @param fallback - what to answer when it holds nothing.
+ */
+export declare function readConfigField<T>(field: ConfigField<T> | undefined, fallback: T): T;
+/**
+ * The canonical default extra-flags list — the live mirror's answer for the
+ * card's **Restore defaults** control (the card carries no copy of it).
+ */
+export declare function readDefaultExtraFlags(): string[];
+/**
+ * The recommended WSL ↔ Windows extra-flags list — the live mirror's answer for
+ * the card's **Flags WSL** control (a fixed recommendation, never persisted).
+ */
+export declare function readWslExtraFlags(): string[];
+/**
+ * Parse a whitespace-separated flags list from the environment.
+ * @param configured - what the row config answers.
+ * @param envValue - `DSH_CHROME_MCP_FLAGS` as seen in the launch env.
+ * @returns the env flags when the value is a non-empty string whose every
+ * entry is valid, else `configured` (the caller decides on warnings).
+ */
+export declare function resolveEnvFlags(configured: string[], envValue: unknown): string[];
+/**
+ * One read of the configuration form's layers. `value` answers what runs now —
+ * the references resolve the user layer over the row config, which is exactly
+ * what the bridge launches with. `user` answers "did the user edit this?" (the
+ * selection source, and where the launch environment sits in the flags
+ * precedence), `base` "what does the row config say?", and both stay undefined
+ * until the form answers.
+ *
+ * The live-only volatile fields are not consulted here: they are Host answers,
+ * held in the controller's mirror and published, not read.
+ * @param config - the config `apply` received (references included).
+ * @param row - the described form row, when the service is already up.
+ */
+export declare function readConfigLayers(config: ChromeMcpConfig, row?: SettingsFormRow): ConfigLayers;
+/**
+ * The effective launch flags for one read of the layers (highest first: the
+ * user layer, `DSH_CHROME_MCP_FLAGS`, the row config, the schema default).
+ * Before the layers answer the references stand in, exactly the way the old cold
+ * path did. The executable-pinning flag never reaches argv — the picker owns
+ * that flag, so a layer that still carries one is answered as the selection
+ * source instead (see ./flags.ts), never as a second source of truth.
+ * @param layers - the last read of the form's layers.
+ * @param envValue - the launch environment's `DSH_CHROME_MCP_FLAGS` value.
+ */
+export declare function resolveLaunchFlags(layers: ConfigLayers, envValue: unknown): string[];
+/**
+ * The effective executable selection for one read of the layers: the user layer
+ * (the card's pick, or the host's one seed) wins, then the row config — its
+ * legacy `--executablePath` folded in — and, before either answers, nothing.
+ * There is no auto source and nothing is re-resolved here: a path that breaks
+ * keeps breaking so what the pill claims keeps being what the bridge runs.
+ */
+export declare function resolveSelection(layers: ConfigLayers): {
+    path: string;
+    source: "" | "selected" | "row-config";
+    pinned: boolean;
+};
+/**
+ * Resolve the effective bridge stderr mode. The user layer's toggle
+ * (`stderrMode`) wins when it states one; otherwise the row config's
+ * `bridgeStderr`. An invalid/empty override falls back to the row config.
+ * @param override - the persisted `stderrMode` value, or "".
+ * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
+ * @returns "log" | "console".
+ */
+export declare function resolveStderrMode(override: unknown, rowDefault: unknown): BridgeStderrMode;
+/**
+ * The effective bridge stderr mode from one read of the form's layers, in the
+ * precedence every other layer-resolved field follows: what the user layer says
+ * wins, the **row config** answers under it, and what the references resolved at
+ * boot sits under that again (the references answer both layers before the form
+ * attaches, so the cold path keeps answering).
+ *
+ * The `base` step is what keeps the answer single. The references can resolve an
+ * empty `stderrMode` for a row that states one — no user layer ever wrote it —
+ * while the described row still serves it, and then the card states one mode
+ * while the bridge runs the other. A control that diffs its own flip against
+ * what is *effective* drops every flip as "already served" against a stale
+ * mirror, which is exactly the dead toggle: the profile that configures the
+ * switch in its own row is the profile that can never switch it. Reading the
+ * row-config layer here makes the Host state the same mode the card states, and
+ * the mirror it publishes then stays honest on its own.
+ * @param layers - the last read of the form's layers.
+ * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
+ * @returns "log" | "console".
+ */
+export declare function resolveStderrModeFromLayers(layers: ConfigLayers, rowDefault: unknown): BridgeStderrMode;
+/**
+ * The effective Chrome executable path (highest first):
+ *
+ * 1. the `chromePath` the user picked in the card — or that the host seeded
+ *    once during the first scan, which is written into the same field,
+ * 2. the row-config `chromePath` (a legacy row-level `--executablePath` flag
+ *    folded into it before this call),
+ * 3. `""` — nothing resolved yet, which is not a runnable executable and is
+ *    reported as such.
+ *
+ * Nothing here consults the scan list: a fixed path stays fixed even when it
+ * breaks, because re-resolving would be an auto mode in disguise.
+ *
+ * @param userLayer - the persisted `chromePath` value ("" when unset).
+ * @param rowConfig - validated row-config `chromePath` value.
+ * @returns the trimmed effective path, possibly "".
+ */
+export declare function resolveEffectiveChromePath(userLayer: unknown, rowConfig: unknown): string;
+/**
+ * The persisted user-layer `extraFlags` list (undefined = the user never said
+ * anything, so the launch environment answers instead).
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readPersistedFlags(layers: ConfigLayers): string[] | undefined;
+/**
+ * The last UI-seeded (or host-seeded) `chromePath` from the user layer ("" means
+ * "nothing picked yet" → fall back to the row config).
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readPersistedChromePath(layers: ConfigLayers): string;
+/**
+ * The last persisted "Reduce log output" mode from the user layer.
+ * Empty/absent/invalid means "follow the row config".
+ * @param layers - the last read of the form's layers.
+ * @returns "log" | "console" when explicitly set, "" otherwise.
+ */
+export declare function readPersistedStderrMode(layers: ConfigLayers): "" | BridgeStderrMode;
+/**
+ * The persisted custom-executable MRU from the user layer — a **legacy** field
+ * nothing writes any more, read once to fold the older hand-typed paths into
+ * the rows. Invalid entries (non-string, empty, control characters) are dropped
+ * rather than poisoning the candidate list.
+ * @param layers - the last read of the form's layers.
+ * @returns the stored paths, trimmed and deduplicated ("" list when absent).
+ */
+export declare function readPersistedCustomPaths(layers: ConfigLayers): string[];
+/**
+ * Normalized form of a **legacy** custom-path list: trimmed, empty entries
+ * dropped, control characters dropped, duplicates folded (first spelling wins),
+ * capped most-recent-first so the list stays bounded. Nothing writes this list
+ * any more (the saved executable rows replace it) — it is only ever read, once,
+ * to fold the older hand-typed paths into the rows.
+ * @param value - candidate list (any shape).
+ * @param cap - entry cap (default `CUSTOM_PATHS_CAP`).
+ */
+export declare function normalizeCustomPaths(value: unknown, cap?: number): string[];
+/**
+ * The saved executable rows the picker shows: re-normalized on every read, since
+ * what a form write hands may carry any shape.
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readSavedExecutables(layers: ConfigLayers): ChromeExecutableEntry[];
+/**
+ * The ids of rows the user has dropped — the ids every merge step must skip so a
+ * deletion outlives the run behind the write that made it (see ./schema.ts
+ * `droppedExecutables`). Deduped; a malformed entry drops out exactly like a
+ * malformed row id.
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readDroppedExecutables(layers: ConfigLayers): string[];
+/**
+ * The live mirror's field names — the fields the Host answers through the
+ * volatile references and never authors by hand. Every write that lands in the
+ * stored row carries this list as **unset** ops: each unset returns the field to
+ * the answer beneath its own patch layer — what the row config says — so what
+ * only the live references stand drops out of what the write lands instead of
+ * riding the write into the file. This is what keeps the persistence boundary
+ * from the inside: a live commit answers, a persisted write clears (measured
+ * live 2026-10-12: booting the plugin with no user write at all filled the row
+ * with the whole live mirror; with the clear riding the write the row stays
+ * clean, and a row that already carries leaked live keys is healed by its first
+ * write).
+ */
+export declare function liveMirrorKeys(): readonly string[];
+/**
+ * The mirror the Host publishes: what every live field answers when nothing has
+ * run yet. The whole point of starting from the defaults is that a card reads
+ * exactly what a Host with no answers would serve, never a hole.
+ */
+export declare function createLiveMirror(): ConfigLiveFields;
+/**
+ * Read the row's two layers through the settings service. Undefined when the
+ * service (or this entry) is not described yet — the cold path, where only the
+ * references answer.
+ * @param settings - the settings service (`SettingsForms`), when resolved.
+ * @param entryId - the profile entry id this row is keyed by.
+ */
+export declare function readConfigForm(settings: SettingsForms | undefined, entryId: string): SettingsFormRow | undefined;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/host/values.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACR,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,YAAY,EAEZ,gBAAgB,EAEhB,eAAe,EACf,aAAa,EAChB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CASpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CASjF;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,YAAY,CA2C7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAMpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,YAAY,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAQhI;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAG1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAEvG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAIzF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,SAAS,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,EAAE,GAAG,gBAAgB,CAGnF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAIvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAyB,GAAG,MAAM,EAAE,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,EAAE,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAarE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,SAAS,MAAM,EAAE,CAElD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAkBnD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGhH"}

package/lib/host/values.js

@@ -0,0 +1,404 @@
+/**
+ * Precedence resolution + the configuration form's answers.
+ *
+ * Two levers resolve upward. The launch flags come from one of four sources
+ * (highest first): the user layer (the card's last edit), the launch environment
+ * (`DSH_CHROME_MCP_FLAGS`, read through `launchEnvironmentOf`), the row-config
+ * `extraFlags`, and the schema default. The executable comes from three (highest
+ * first): the `chromePath` the card picked or the host seeded once, the row
+ * config (a legacy row-level `--executablePath` folded in — see ./flags.ts), and
+ * nothing. There is no auto resolution: nothing is inferred on every start, and
+ * nothing is re-inferred when the chosen path breaks.
+ *
+ * The reads are one `readConfigLayers` wide: since dsh 0.2.0 the *references*
+ * apply() handed answer the effective value (they resolve the user layer over the
+ * row config), while the two layers the distinction needs ride the described settings row (`readFormRow`)
+ * — `user` is what the profile patch carries (presence is the answer), `base` what
+ * the row config carries under it. Before the form attaches only the references
+ * answer, so the first commit settles the distinction.
+ */
+import { readFormRow } from "@comecaramelos/dsh-ancesters/host";
+import { CUSTOM_PATHS_CAP, DEFAULT_EXTRA_FLAGS, WSL_EXTRA_FLAGS } from "./constants.js";
+import { extractExecutablePathFlag, stripExecutablePathFlags, validateExtraFlags } from "./flags.js";
+import { normalizeEntries } from "./catalog.js";
+/**
+ * Environment variable that seeds the launch flags for one dsh run: a
+ * whitespace-separated extraFlags list, e.g.
+ * `DSH_CHROME_MCP_FLAGS="--headless --isolated"`.
+ */
+export { FLAGS_ENV_VAR } from "./constants.js";
+/**
+ * Read one config field. A `.volatile()` field arrives as a reference the fiber
+ * resolves live (dsh 0.2.0: `apply` hands references, ordinary fields plain
+ * values), so reading the field's type is not enough — this is the one way every
+ * volatile read answers, whether what it holds is a reference or, on the cold
+ * path of a hand-built config, the plain value itself.
+ *
+ * A reference hands a snapshot, so arrays come back copied: the running state
+ * holds values, never the reference's own object.
+ * @param field - what the config carries for that field.
+ * @param fallback - what to answer when it holds nothing.
+ */
+export function readConfigField(field, fallback) {
+    const holder = field;
+    if (typeof holder?.get === "function") {
+        const value = holder.get();
+        if (value === void 0)
+            return fallback;
+        return Array.isArray(value) ? value.slice() : value;
+    }
+    if (field === void 0 || field === null)
+        return fallback;
+    return Array.isArray(field) ? field.slice() : field;
+}
+/**
+ * The canonical default extra-flags list — the live mirror's answer for the
+ * card's **Restore defaults** control (the card carries no copy of it).
+ */
+export function readDefaultExtraFlags() {
+    return [...DEFAULT_EXTRA_FLAGS];
+}
+/**
+ * The recommended WSL ↔ Windows extra-flags list — the live mirror's answer for
+ * the card's **Flags WSL** control (a fixed recommendation, never persisted).
+ */
+export function readWslExtraFlags() {
+    return [...WSL_EXTRA_FLAGS];
+}
+/**
+ * Parse a whitespace-separated flags list from the environment.
+ * @param configured - what the row config answers.
+ * @param envValue - `DSH_CHROME_MCP_FLAGS` as seen in the launch env.
+ * @returns the env flags when the value is a non-empty string whose every
+ * entry is valid, else `configured` (the caller decides on warnings).
+ */
+export function resolveEnvFlags(configured, envValue) {
+    if (typeof envValue !== "string" || envValue.trim() === "")
+        return configured;
+    const flags = envValue.split(/\s+/u).filter((flag) => flag !== "");
+    try {
+        validateExtraFlags(flags);
+    }
+    catch {
+        return configured;
+    }
+    return flags;
+}
+/** Normalize one layer's `extraFlags` answer (undefined = the layer is silent). */
+function readLayerFlags(value) {
+    if (!Array.isArray(value))
+        return void 0;
+    if (!value.every((flag) => typeof flag === "string" && flag !== ""))
+        return void 0;
+    return value;
+}
+/** Normalize one layer's `chromePath` answer ("" when absent or unusable). */
+function readLayerChromePath(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+/**
+ * One read of the configuration form's layers. `value` answers what runs now —
+ * the references resolve the user layer over the row config, which is exactly
+ * what the bridge launches with. `user` answers "did the user edit this?" (the
+ * selection source, and where the launch environment sits in the flags
+ * precedence), `base` "what does the row config say?", and both stay undefined
+ * until the form answers.
+ *
+ * The live-only volatile fields are not consulted here: they are Host answers,
+ * held in the controller's mirror and published, not read.
+ * @param config - the config `apply` received (references included).
+ * @param row - the described form row, when the service is already up.
+ */
+export function readConfigLayers(config, row) {
+    const described = (row === null || typeof row !== "object" ? {} : row);
+    const describedLayer = (layer) => {
+        const source = layer === null || typeof layer !== "object" || Array.isArray(layer) ? {} : layer;
+        const flags = readLayerFlags(source.extraFlags);
+        const executables = Array.isArray(source.executables) ? normalizeEntries(source.executables) : void 0;
+        const paths = Array.isArray(source.chromeCustomPaths) ? normalizeCustomPaths(source.chromeCustomPaths) : void 0;
+        const stderrMode = source.stderrMode === "log" || source.stderrMode === "console" ? source.stderrMode : void 0;
+        const chromePath = typeof source.chromePath === "string" ? source.chromePath.trim() : void 0;
+        const dropped = Array.isArray(source.droppedExecutables)
+            ? source.droppedExecutables.filter((item) => typeof item === "string")
+            : void 0;
+        return {
+            ...(flags === void 0 ? {} : { extraFlags: flags }),
+            ...(chromePath === void 0 || chromePath === "" ? {} : { chromePath }),
+            ...(executables === void 0 ? {} : { executables }),
+            ...(dropped === void 0 ? {} : { droppedExecutables: dropped }),
+            ...(paths === void 0 ? {} : { chromeCustomPaths: paths }),
+            ...(stderrMode === void 0 ? {} : { stderrMode }),
+            ...(typeof source.refreshExecutablesNonce === "number" ? { refreshExecutablesNonce: source.refreshExecutablesNonce } : {}),
+            ...(typeof source.openWindowsChromeNonce === "number" ? { openWindowsChromeNonce: source.openWindowsChromeNonce } : {})
+        };
+    };
+    const value = {
+        extraFlags: readConfigField(config.extraFlags, [...DEFAULT_EXTRA_FLAGS]),
+        chromePath: readConfigField(config.chromePath, "").trim(),
+        executables: normalizeEntries(readConfigField(config.executables, [])),
+        droppedExecutables: readConfigField(config.droppedExecutables, []).filter((item) => typeof item === "string"),
+        chromeCustomPaths: normalizeCustomPaths(readConfigField(config.chromeCustomPaths, [])),
+        stderrMode: readConfigField(config.stderrMode, ""),
+        refreshExecutablesNonce: readConfigField(config.refreshExecutablesNonce, 0),
+        openWindowsChromeNonce: readConfigField(config.openWindowsChromeNonce, 0)
+    };
+    const base = describedLayer(described.base);
+    const hasLayers = described.user !== void 0 || described.base !== void 0;
+    return {
+        value,
+        // Before the form attaches nothing distinguishes the layers, so the
+        // references answer for the row config as well; the first commit reads the
+        // real layers and settles the distinction.
+        user: hasLayers ? describedLayer(described.user) : {},
+        base: hasLayers ? base : { ...value }
+    };
+}
+/**
+ * The effective launch flags for one read of the layers (highest first: the
+ * user layer, `DSH_CHROME_MCP_FLAGS`, the row config, the schema default).
+ * Before the layers answer the references stand in, exactly the way the old cold
+ * path did. The executable-pinning flag never reaches argv — the picker owns
+ * that flag, so a layer that still carries one is answered as the selection
+ * source instead (see ./flags.ts), never as a second source of truth.
+ * @param layers - the last read of the form's layers.
+ * @param envValue - the launch environment's `DSH_CHROME_MCP_FLAGS` value.
+ */
+export function resolveLaunchFlags(layers, envValue) {
+    const user = readLayerFlags(layers.user.extraFlags);
+    if (user !== void 0)
+        return stripExecutablePathFlags(user);
+    const row = readLayerFlags(layers.base.extraFlags) ?? layers.value.extraFlags;
+    const fromEnv = resolveEnvFlags(row, envValue);
+    return stripExecutablePathFlags(fromEnv);
+}
+/**
+ * The effective executable selection for one read of the layers: the user layer
+ * (the card's pick, or the host's one seed) wins, then the row config — its
+ * legacy `--executablePath` folded in — and, before either answers, nothing.
+ * There is no auto source and nothing is re-resolved here: a path that breaks
+ * keeps breaking so what the pill claims keeps being what the bridge runs.
+ */
+export function resolveSelection(layers) {
+    const userPath = readLayerChromePath(layers.user.chromePath);
+    if (userPath !== "")
+        return { path: userPath, source: "selected", pinned: false };
+    const baseChromePath = readLayerChromePath(layers.base.chromePath);
+    if (baseChromePath !== "")
+        return { path: baseChromePath, source: "row-config", pinned: false };
+    const pinned = extractExecutablePathFlag(readLayerFlags(layers.base.extraFlags) ?? []);
+    if (pinned !== "")
+        return { path: pinned, source: "row-config", pinned: true };
+    return { path: "", source: "", pinned: false };
+}
+/**
+ * Resolve the effective bridge stderr mode. The user layer's toggle
+ * (`stderrMode`) wins when it states one; otherwise the row config's
+ * `bridgeStderr`. An invalid/empty override falls back to the row config.
+ * @param override - the persisted `stderrMode` value, or "".
+ * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
+ * @returns "log" | "console".
+ */
+export function resolveStderrMode(override, rowDefault) {
+    if (override === "log" || override === "console")
+        return override;
+    return rowDefault === "console" ? "console" : "log";
+}
+/**
+ * The effective bridge stderr mode from one read of the form's layers, in the
+ * precedence every other layer-resolved field follows: what the user layer says
+ * wins, the **row config** answers under it, and what the references resolved at
+ * boot sits under that again (the references answer both layers before the form
+ * attaches, so the cold path keeps answering).
+ *
+ * The `base` step is what keeps the answer single. The references can resolve an
+ * empty `stderrMode` for a row that states one — no user layer ever wrote it —
+ * while the described row still serves it, and then the card states one mode
+ * while the bridge runs the other. A control that diffs its own flip against
+ * what is *effective* drops every flip as "already served" against a stale
+ * mirror, which is exactly the dead toggle: the profile that configures the
+ * switch in its own row is the profile that can never switch it. Reading the
+ * row-config layer here makes the Host state the same mode the card states, and
+ * the mirror it publishes then stays honest on its own.
+ * @param layers - the last read of the form's layers.
+ * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
+ * @returns "log" | "console".
+ */
+export function resolveStderrModeFromLayers(layers, rowDefault) {
+    return resolveStderrMode(layers.user.stderrMode ?? layers.base.stderrMode ?? layers.value.stderrMode, rowDefault);
+}
+/**
+ * The effective Chrome executable path (highest first):
+ *
+ * 1. the `chromePath` the user picked in the card — or that the host seeded
+ *    once during the first scan, which is written into the same field,
+ * 2. the row-config `chromePath` (a legacy row-level `--executablePath` flag
+ *    folded into it before this call),
+ * 3. `""` — nothing resolved yet, which is not a runnable executable and is
+ *    reported as such.
+ *
+ * Nothing here consults the scan list: a fixed path stays fixed even when it
+ * breaks, because re-resolving would be an auto mode in disguise.
+ *
+ * @param userLayer - the persisted `chromePath` value ("" when unset).
+ * @param rowConfig - validated row-config `chromePath` value.
+ * @returns the trimmed effective path, possibly "".
+ */
+export function resolveEffectiveChromePath(userLayer, rowConfig) {
+    const user = typeof userLayer === "string" ? userLayer.trim() : "";
+    if (user !== "")
+        return user;
+    return typeof rowConfig === "string" ? rowConfig.trim() : "";
+}
+/**
+ * The persisted user-layer `extraFlags` list (undefined = the user never said
+ * anything, so the launch environment answers instead).
+ * @param layers - the last read of the form's layers.
+ */
+export function readPersistedFlags(layers) {
+    return readLayerFlags(layers.user.extraFlags);
+}
+/**
+ * The last UI-seeded (or host-seeded) `chromePath` from the user layer ("" means
+ * "nothing picked yet" → fall back to the row config).
+ * @param layers - the last read of the form's layers.
+ */
+export function readPersistedChromePath(layers) {
+    return readLayerChromePath(layers.user.chromePath);
+}
+/**
+ * The last persisted "Reduce log output" mode from the user layer.
+ * Empty/absent/invalid means "follow the row config".
+ * @param layers - the last read of the form's layers.
+ * @returns "log" | "console" when explicitly set, "" otherwise.
+ */
+export function readPersistedStderrMode(layers) {
+    const mode = layers.user.stderrMode;
+    return mode === "log" || mode === "console" ? mode : "";
+}
+/**
+ * The persisted custom-executable MRU from the user layer — a **legacy** field
+ * nothing writes any more, read once to fold the older hand-typed paths into
+ * the rows. Invalid entries (non-string, empty, control characters) are dropped
+ * rather than poisoning the candidate list.
+ * @param layers - the last read of the form's layers.
+ * @returns the stored paths, trimmed and deduplicated ("" list when absent).
+ */
+export function readPersistedCustomPaths(layers) {
+    const paths = layers.user.chromeCustomPaths;
+    if (paths === void 0)
+        return normalizeCustomPaths(layers.value.chromeCustomPaths);
+    return normalizeCustomPaths(paths);
+}
+/**
+ * Normalized form of a **legacy** custom-path list: trimmed, empty entries
+ * dropped, control characters dropped, duplicates folded (first spelling wins),
+ * capped most-recent-first so the list stays bounded. Nothing writes this list
+ * any more (the saved executable rows replace it) — it is only ever read, once,
+ * to fold the older hand-typed paths into the rows.
+ * @param value - candidate list (any shape).
+ * @param cap - entry cap (default `CUSTOM_PATHS_CAP`).
+ */
+export function normalizeCustomPaths(value, cap = CUSTOM_PATHS_CAP) {
+    if (!Array.isArray(value))
+        return [];
+    const seen = new Set();
+    const paths = [];
+    for (const entry of value) {
+        if (typeof entry !== "string")
+            continue;
+        const path = entry.trim();
+        if (path === "" || /[\x00-\x1f\x7f]/u.test(path))
+            continue;
+        if (seen.has(path))
+            continue;
+        seen.add(path);
+        paths.push(path);
+    }
+    if (paths.length <= cap)
+        return paths;
+    return paths.slice(0, cap);
+}
+/**
+ * The saved executable rows the picker shows: re-normalized on every read, since
+ * what a form write hands may carry any shape.
+ * @param layers - the last read of the form's layers.
+ */
+export function readSavedExecutables(layers) {
+    return normalizeEntries(layers.user.executables ?? layers.value.executables);
+}
+/**
+ * The ids of rows the user has dropped — the ids every merge step must skip so a
+ * deletion outlives the run behind the write that made it (see ./schema.ts
+ * `droppedExecutables`). Deduped; a malformed entry drops out exactly like a
+ * malformed row id.
+ * @param layers - the last read of the form's layers.
+ */
+export function readDroppedExecutables(layers) {
+    const raw = (layers.user.droppedExecutables ?? layers.value.droppedExecutables);
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const item of raw) {
+        if (typeof item !== "string")
+            continue;
+        const id = item.trim();
+        if (id === "" || seen.has(id))
+            continue;
+        seen.add(id);
+        out.push(id);
+    }
+    return out;
+}
+/**
+ * The live mirror's field names — the fields the Host answers through the
+ * volatile references and never authors by hand. Every write that lands in the
+ * stored row carries this list as **unset** ops: each unset returns the field to
+ * the answer beneath its own patch layer — what the row config says — so what
+ * only the live references stand drops out of what the write lands instead of
+ * riding the write into the file. This is what keeps the persistence boundary
+ * from the inside: a live commit answers, a persisted write clears (measured
+ * live 2026-10-12: booting the plugin with no user write at all filled the row
+ * with the whole live mirror; with the clear riding the write the row stays
+ * clean, and a row that already carries leaked live keys is healed by its first
+ * write).
+ */
+export function liveMirrorKeys() {
+    return Object.keys(createLiveMirror());
+}
+/**
+ * The mirror the Host publishes: what every live field answers when nothing has
+ * run yet. The whole point of starting from the defaults is that a card reads
+ * exactly what a Host with no answers would serve, never a hole.
+ */
+export function createLiveMirror() {
+    return {
+        lastError: "",
+        chromeMissing: false,
+        executableDiscoveryRevision: 0,
+        chromeVersion: "",
+        executableStatus: [],
+        effectiveChromePath: "",
+        effectiveSource: "",
+        stderrEffective: "log",
+        defaultExtraFlags: readDefaultExtraFlags(),
+        wslExtraFlags: readWslExtraFlags(),
+        wslWindowsExecutable: false,
+        windowsChromeStatus: { state: "off", port: 0, error: "" },
+        carriesConnectionMode: false,
+        runningFlags: [],
+        runningNote: ""
+    };
+}
+/**
+ * Read the row's two layers through the settings service. Undefined when the
+ * service (or this entry) is not described yet — the cold path, where only the
+ * references answer.
+ * @param settings - the settings service (`SettingsForms`), when resolved.
+ * @param entryId - the profile entry id this row is keyed by.
+ */
+export function readConfigForm(settings, entryId) {
+    // A service that cannot answer is the same cold path as no service.
+    return readFormRow(settings, entryId);
+}
+//# sourceMappingURL=values.js.map

package/lib/host/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/host/values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAchD;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAI,KAAiC,EAAE,QAAW;IAC7E,MAAM,MAAM,GAAG,KAA6D,CAAC;IAC7E,IAAI,OAAO,MAAM,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAmB,CAAC,KAAK,EAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACxD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAmB,CAAC,KAAK,EAAO,CAAC,CAAC,CAAE,KAAW,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACjC,OAAO,CAAC,GAAG,mBAAmB,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,CAAC,GAAG,eAAe,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAAoB,EAAE,QAAiB;IACnE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,UAAU,CAAC;IAC9E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACD,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,mFAAmF;AACnF,SAAS,cAAc,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC;IACnF,OAAO,KAAiB,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,SAAS,mBAAmB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB,EAAE,GAAqB;IAC3E,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAuC,CAAC;IAC7G,MAAM,cAAc,GAAG,CAAC,KAAc,EAAqB,EAAE;QACzD,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAgC,CAAC;QAC3H,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChH,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/G,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;YACpD,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;YACtF,CAAC,CAAC,KAAK,CAAC,CAAC;QACb,OAAO;YACH,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YAClD,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;YACrE,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YAClD,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC;YAC9D,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;YACzD,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;YAChD,GAAG,CAAC,OAAO,MAAM,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1H,GAAG,CAAC,OAAO,MAAM,CAAC,sBAAsB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1H,CAAC;IACN,CAAC,CAAC;IACF,MAAM,KAAK,GAAqB;QAC5B,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC;QACxE,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;QACzD,WAAW,EAAE,gBAAgB,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACtE,kBAAkB,EAAE,eAAe,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAC7H,iBAAiB,EAAE,oBAAoB,CAAC,eAAe,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QACtF,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAA0B;QAC3E,uBAAuB,EAAE,eAAe,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC;QAC3E,sBAAsB,EAAE,eAAe,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC;KAC5E,CAAC;IACF,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACzE,OAAO;QACH,KAAK;QACL,oEAAoE;QACpE,2EAA2E;QAC3E,2CAA2C;QAC3C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QACrD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE;KACxC,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB,EAAE,QAAiB;IACtE,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;IAC9E,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACjD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAClF,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,IAAI,cAAc,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChG,MAAM,MAAM,GAAG,yBAAyB,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB,EAAE,UAAmB;IACpE,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAClE,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAoB,EAAE,UAAmB;IACjF,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACtH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAkB,EAAE,SAAkB;IAC7E,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACnD,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IACxD,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;IACpC,OAAO,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAoB;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAC5C,IAAI,KAAK,KAAK,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAClF,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,MAAc,gBAAgB;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACrD,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACvD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAY,CAAC;IAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC5B,OAAO;QACH,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,2BAA2B,EAAE,CAAC;QAC9B,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,EAAE;QACpB,mBAAmB,EAAE,EAAE;QACvB,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,qBAAqB,EAAE;QAC1C,aAAa,EAAE,iBAAiB,EAAE;QAClC,oBAAoB,EAAE,KAAK;QAC3B,mBAAmB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACzD,qBAAqB,EAAE,KAAK;QAC5B,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,EAAE;KAClB,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC,EAAE,OAAe;IAC/E,oEAAoE;IACpE,OAAO,WAAW,CAAkB,QAAiB,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC"}

package/lib/host/windows/connect-flags.d.ts

@@ -0,0 +1,27 @@
+/** The connect address one debugging port answers for. */
+export declare function windowsChromeUrl(port: number): string;
+/** The debugging port the live connect entry carries, 0 when the list carries
+ * none. The entry's **spelling** is irrelevant: the port is read through the
+ * very predicate that decides connect mode (`carriesConnectionMode` in
+ * `./flags.ts`), so `--browserUrl=<url>`, `--browserUrl <url>` (the two-entry
+ * form the whitespace-split env source produces), one string carrying its
+ * value after whitespace, and `--wsEndpoint=<url>` all answer with the live
+ * port instead of reading as "no live session". */
+export declare function browserUrlFlagPort(flags: unknown): number;
+/**
+ * Collapse every connect entry the list carries into the run's own address, so
+ * the saved list keeps exactly **one** connect source whatever spelling it was
+ * stored in — the same idempotency rule the saved-executable merge follows for
+ * a repeated id, keyed now on the whole connect-mode predicate rather than one
+ * flag spelling. An entry that carries its value as the *following* entry (the
+ * `--browserUrl <url>` form the whitespace-split env source produces) consumes
+ * that value with it, so no bare URL survives as a stray argv item.
+ *
+ * The one thing that does not survive is a `--user-data-dir` row: connect
+ * carries no local profile to hand the browser, upstream refuses both at once,
+ * so keeping a saved Flags-WSL row would leave the bridge unspawnable
+ * (`Arguments userDataDir and browserUrl are mutually exclusive`, measured live
+ * with chrome-devtools-mcp).
+ */
+export declare function withBrowserUrlFlag(flags: unknown, url: string): string[];
+//# sourceMappingURL=connect-flags.d.ts.map

package/lib/host/windows/connect-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-flags.d.ts","sourceRoot":"","sources":["../../../src/host/windows/connect-flags.ts"],"names":[],"mappings":"AAaA,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;mDAMmD;AACnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBzD;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BxE"}