@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/host/status.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAkB,GAAG,MAAM,CAKxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAQtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUzG"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/host/status.ts"],"names":[],"mappings":"AAUA,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAkB,GAAG,MAAM,CAKxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAQtD;AAED;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC"}

package/lib/host/status.js

@@ -2,7 +2,7 @@
  * Error classification and status notes — the human-readable half.
  *
  * Every capture path (check failure, bridge log line, tool-call result) ends
- * in one capped line written to the base layer's `lastError`; `isChromeMissing`
+ * in one capped line written to the live mirror's `lastError`; `isChromeMissing`
  * decides whether that line is the known, developer-actionable "no Chrome
  * executable detected" state (`chromeMissing`) or a generic failure.
  */
@@ -34,27 +34,12 @@ export function isChromeMissing(text) {
         /failed to launch the browser process/iu.test(message));
 }
 /**
- * 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.
+ * Summarize one chrome-tool call result for the card's status line — the rule
+ * is ancestros' (`host/status.toolResultNote`): failed calls answer
+ * "<tool> failed: <first text line>", successes `null` (the caller clears the
+ * stored error). Tool-level errors (browser unreachable, "Target closed", …)
+ * are returned to the calling agent and never reach a bridge line, so the
+ * tool-call capture is the only place they surface.
  */
-export function toolResultNote(toolName, result) {
-    if (!result || result.isError !== true)
-        return null;
-    const blocks = Array.isArray(result.content) ? result.content : [];
-    let text = blocks
-        .filter((block) => block && block.type === "text" && typeof block.text === "string")
-        .map((block) => block.text)
-        .join(" ");
-    if (text === "" && result.error && typeof result.error.message === "string")
-        text = result.error.message;
-    if (text === "")
-        text = result.error === void 0 ? "unknown error" : String(result.error);
-    return firstLine(`${toolName.split("__").pop()} failed: ${text}`);
-}
+export { toolResultNote } from "@comecaramelos/dsh-ancesters/host";
 //# sourceMappingURL=status.js.map

package/lib/host/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/host/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,oDAAoD;AACpD,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,MAAc,SAAS;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;SAC1B,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACnC,OAAO,CACH,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7C,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC;QACnE,0DAA0D,CAAC,IAAI,CAAC,OAAO,CAAC;QACxE,wCAAwC,CAAC,IAAI,CAAC,OAAO,CAAC,CACzD,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,MAAyC;IACtF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,IAAI,GAAG,MAAM;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;SACnF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACzG,IAAI,IAAI,KAAK,EAAE;QAAE,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzF,OAAO,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/host/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,oDAAoD;AACpD,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,MAAc,SAAS;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;SAC1B,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACnC,OAAO,CACH,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7C,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC;QACnE,0DAA0D,CAAC,IAAI,CAAC,OAAO,CAAC;QACxE,wCAAwC,CAAC,IAAI,CAAC,OAAO,CAAC,CACzD,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC"}

package/lib/host/tool.d.ts

@@ -1,19 +1,25 @@
 /**
  * Host half — the **prelaunch_windows_chrome** tool.
  *
- * The second trigger of the same Windows Chrome run the card button drives:
- * the run itself lives in ./windows/, the queueing + state mirror in the
+ * The second trigger of the same Windows Chrome run the card button drives: the
+ * run itself lives in ./windows/, the queueing + state mirror in the
  * controller, and registering the tool is plain wiring — the definition adds
  * no logic of its own, it just hands the model the button's action (the run
  * answers through `windowsChromeStatus`, exactly like a click does).
  *
+ * With the component model the run feeds connections, not a bridge this row
+ * owns: live `chrome-windows` connections are refreshed against the run
+ * (idempotent — the live URL rides into the run's `currentFlags`), and a run
+ * that connected without one says what would drive it.
+ *
  * The two registration rules this module keeps:
  *
- * - The tools service is injected **at mount time**, not statically: our own
- *   nested mcp-client row is what publishes the bridge's tools, so a static
- *   `inject: ["tools"]` on this plugin would risk the same load-order cycle
- *   the tool-result listener bullet warns about. `ctx.inject` resolves the
- *   service lazily, which is what the listener idiom already relies on.
+ * - The tools service is injected **at mount time**, not statically: the
+ *   connections' nested mcp-client fibers are what publish the bridge's tools,
+ *   so a static `inject: ["tools"]` on this plugin would risk the same
+ *   load-order cycle the tool-result listener bullet warns about. `ctx.inject`
+ *   resolves the service lazily, which is what the listener idiom already
+ *   relies on.
  * - The registration lives on one fiber effect. An HMR reload disposes the
  *   old instance's effect first, so the tool re-registers cleanly instead of
  *   colliding with a still-held global registration; the effect body guards

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/host/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAExE,8EAA8E;AAC9E,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD;;;;GAIG;AACH,UAAU,kBAAkB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE;QACJ,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;KACxD,CAAC;IACF,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxC;AAKD,sEAAsE;AACtE,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,mBAAmB,GAAG,kBAAkB,CAoBpG;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAgB3G"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/host/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAExE,8EAA8E;AAC9E,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD;;;;GAIG;AACH,UAAU,kBAAkB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE;QACJ,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;KACxD,CAAC;IACF,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxC;AAKD,sEAAsE;AACtE,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,mBAAmB,GAAG,kBAAkB,CAqBpG;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAgB3G"}

package/lib/host/tool.js

@@ -4,11 +4,12 @@ export const PRELAUNCH_WINDOWS_CHROME_NAME = "prelaunch_windows_chrome";
 export function prelaunchWindowsChromeDefinition(controller) {
     return {
         name: PRELAUNCH_WINDOWS_CHROME_NAME,
-        description: "Open the Windows-side Chrome on WSL and switch the Chrome bridge to connect mode — the same run the card's Prelaunch Windows Chrome button drives. " +
-            "Takes no arguments: the host locates the Windows browser, checks that the Windows loopback is reachable from this WSL host " +
+        description: "Open the Windows-side Chrome on WSL — the same run the card's Prelaunch Windows Chrome button drives. " +
+            "Takes no arguments: the host launches the Windows executable the picker selected when that selection is a Windows one (otherwise it locates one), " +
+            "checks that the Windows loopback is reachable from this WSL host " +
             "(networkingMode=mirrored is a manual Windows-side setting it only reads), picks the first free debugging port, launches with a " +
             "Windows-side profile under LOCALAPPDATA linked into the workspace as .chrome, opens a packaged page in that window explaining " +
-            "that it was opened by the plugin so the agent can drive it from WSL, and connects on the port's address. On a non-WSL host it answers \"not applicable\". " +
+            "that it was opened by the plugin so the agent can drive it from WSL, and reports the debugging URL. Live Windows Chrome connections, if any stand, refresh against the run instead of launching a second browser. On a non-WSL host it answers \"not applicable\". " +
             "The browser it started is never closed by the plugin.",
         parameters: { type: "object", properties: {}, additionalProperties: false },
         output: {

package/lib/host/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/host/tool.ts"],"names":[],"mappings":"AAwBA,gEAAgE;AAChE,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAwBxE,sEAAsE;AACtE,MAAM,UAAU,gCAAgC,CAAC,UAA+B;IAC5E,OAAO;QACH,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACP,qJAAqJ;YACrJ,6HAA6H;YAC7H,iIAAiI;YACjI,gIAAgI;YAChI,4JAA4J;YAC5J,uDAAuD;QAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC3E,MAAM,EAAE;YACJ,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE;YACrH,MAAM,CAAC,KAAc,EAAE,KAAc;gBACjC,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,KAA4B,CAAC,IAAI,CAAC;gBACnG,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1E,CAAC;SACJ;QACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,sBAAsB,EAAE,EAAE,CAAC;KAC7E,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,GAAkB,EAAE,UAA+B;IACjG,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QACZ,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,UAAoC,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,KAAoB,EAAE,EAAE;YAC3C,IAAI,UAAU;gBAAE,OAAO;YACvB,MAAM,KAAK,GAAI,KAAsC,CAAC,KAAK,CAAC;YAC5D,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,UAAU,GAAG,IAAI,CAAC;YAClB,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,gCAAgC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACR,IAAI,UAAU;gBAAE,UAAU,EAAE,CAAC;YAC7B,UAAU,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;IACN,CAAC,EAAE,2CAA2C,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/host/tool.ts"],"names":[],"mappings":"AA8BA,gEAAgE;AAChE,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAwBxE,sEAAsE;AACtE,MAAM,UAAU,gCAAgC,CAAC,UAA+B;IAC5E,OAAO;QACH,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACP,wGAAwG;YACxG,oJAAoJ;YACpJ,mEAAmE;YACnE,iIAAiI;YACjI,gIAAgI;YAChI,qQAAqQ;YACrQ,uDAAuD;QAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC3E,MAAM,EAAE;YACJ,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE;YACrH,MAAM,CAAC,KAAc,EAAE,KAAc;gBACjC,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,KAA4B,CAAC,IAAI,CAAC;gBACnG,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1E,CAAC;SACJ;QACD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,sBAAsB,EAAE,EAAE,CAAC;KAC7E,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAAC,GAAkB,EAAE,UAA+B;IACjG,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QACZ,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,UAAoC,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,KAAoB,EAAE,EAAE;YAC3C,IAAI,UAAU;gBAAE,OAAO;YACvB,MAAM,KAAK,GAAI,KAAsC,CAAC,KAAK,CAAC;YAC5D,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,UAAU,GAAG,IAAI,CAAC;YAClB,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,gCAAgC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACR,IAAI,UAAU;gBAAE,UAAU,EAAE,CAAC;YAC7B,UAAU,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;IACN,CAAC,EAAE,2CAA2C,CAAC,CAAC;AACpD,CAAC"}

package/lib/host/types/config.d.ts

@@ -1,36 +1,90 @@
 /**
- * Types — the validated row config and the plugin context.
+ * Types — the config `apply` receives, and the plugin context.
  *
- * The config a cordis plugin row carries (every field defaulting through the
- * zod schema in ./schema.ts) and the narrow service/fiber views this host half
- * actually calls. Split out of the single `types.ts`. Structural views stay
- * narrow: only what the host half calls, widened no further than that.
+ * One `Config` (./../schema.ts) carries everything: the ordinary row-config
+ * fields the card only reads, the user-authored fields the card edits, and the
+ * live answers the Host publishes. What matters to every consumer here is the
+ * *shape at runtime*: dsh 0.2.0 hands `apply` a reference for every
+ * `.volatile()` field and a plain value for every ordinary one, so reading a
+ * volatile field's type is not reading what it holds (see ./values.ts
+ * `readConfigField`). The two halves are typed apart for exactly that reason.
  */
 import type { Context } from "@deepseek-ai/cordis";
 import type { BridgeStderrMode } from "./stderr.js";
+import type { ChromeExecutableEntry, ChromeExecutableStatus, EffectiveChromeSource } from "./executable.js";
+import type { WindowsChromeStatus } from "./windows.js";
+/** A `.volatile()` field as `apply` hands it: a stable reference the fiber
+ * resolves live, or — the shape a hand-built config (or a test) hands — the plain
+ * value itself. Read it through `readConfigField` (./values.ts). */
+export type ConfigField<T> = T | {
+    get(): T;
+};
 /**
- * A validated row config (every field carries a schema default).
- * Mirrors the zod schema shape for typed access in apply().
+ * The validated row config as `apply` sees it: every ordinary field resolved to
+ * its final shape (the card reads them, it never edits them), every `.volatile()`
+ * field as a reference. This is the one config type the host half passes around —
+ * `buildServerArgs`, `checkChrome` and the bridge config all read ordinary
+ * fields directly and take the volatile ones through `readConfigField` or an
+ * explicit argument.
  */
 export type ChromeMcpConfig = {
     serverName: string;
     command: string;
     package: string;
-    extraFlags: string[];
-    chromePath: string;
     chromePaths: string[];
     env: Record<string, string>;
     cwd: string;
     toolCallTimeoutMs: number;
+    /** Ceiling for the bridge's server instructions, in UTF-8 bytes (attribution
+     * included). A verbatim passthrough to the nested `dsh-mcp-client` row; a
+     * server whose instructions exceed it never connects. */
+    maxInstructionBytes: number;
     failOnStartupError: boolean;
     reconnect: ReconnectConfig;
     /** Bridge console-output routing: "log" (default) redirects the child's
      * stderr into a log file; "console" echoes it. The card's "Reduce log
-     * output" toggle (the persisted `stderrMode`) overrides this. */
+     * output" toggle (`stderrMode`) overrides this. */
     bridgeStderr: BridgeStderrMode;
-    /** Optional absolute path for the stderr log ("" → the per-spawn
-     * `<tmpdir>/dsh-chrome-mcp-<serverName>-bridge-<pid>.log` default). */
+    /** Optional absolute path for the stderr log ("" → the private per-process
+     * directory created by `mkdtemp`, holding `<serverName>-bridge.log`). */
     bridgeStderrLog: string;
+    extraFlags: ConfigField<string[]>;
+    /** The executable the bridge launches with: a saved row's path the picker
+     * wrote, or one the Host seeded once. "" = nothing resolved yet. */
+    chromePath: ConfigField<string>;
+    /** The picker's saved rows, `{ id: path, name: label }`. */
+    executables: ConfigField<ChromeExecutableEntry[]>;
+    /** The ids of saved rows the user dropped — Host-authored, consulted by
+     * every merge step so a deleted row never comes back. */
+    droppedExecutables: ConfigField<string[]>;
+    /** **Legacy** MRU of hand-typed executables — read once, never written. */
+    chromeCustomPaths: ConfigField<string[]>;
+    /** The card's stderr toggle: "log"/"console"/"" (follow `bridgeStderr`). */
+    stderrMode: ConfigField<"" | BridgeStderrMode>;
+    /** The card's **Fetch executables** trigger. */
+    refreshExecutablesNonce: ConfigField<number>;
+    /** The card's **Prelaunch Windows Chrome** trigger. */
+    openWindowsChromeNonce: ConfigField<number>;
+    lastError: ConfigField<string>;
+    chromeMissing: ConfigField<boolean>;
+    executableDiscoveryRevision: ConfigField<number>;
+    chromeVersion: ConfigField<string>;
+    executableStatus: ConfigField<ChromeExecutableStatus[]>;
+    effectiveChromePath: ConfigField<string>;
+    effectiveSource: ConfigField<EffectiveChromeSource>;
+    stderrEffective: ConfigField<BridgeStderrMode>;
+    defaultExtraFlags: ConfigField<string[]>;
+    wslExtraFlags: ConfigField<string[]>;
+    wslWindowsExecutable: ConfigField<boolean>;
+    windowsChromeStatus: ConfigField<WindowsChromeStatus>;
+    carriesConnectionMode: ConfigField<boolean>;
+    /** The flags the live connection actually launches with (mirrored from the
+     * last resolve). */
+    runningFlags: ConfigField<string[]>;
+    /** The note the live connection answered with. */
+    runningNote: ConfigField<string>;
+    /** Whether the standalone-config translation was turned down (D4). */
+    migrationDismissed: ConfigField<boolean>;
 };
 /** Reconnect policy, mirroring the `dsh-mcp-client` bridge config. */
 export type ReconnectConfig = {

package/lib/host/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/host/types/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,eAAe,CAAC;IAC3B;;qEAEiE;IACjE,YAAY,EAAE,gBAAgB,CAAC;IAC/B;2EACuE;IACvE,eAAe,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/host/types/config.ts"],"names":[],"mappings":"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"}

package/lib/host/types/executable.d.ts

@@ -16,14 +16,19 @@ export type ChromeExecutableEntry = {
 };
 /**
  * What one saved row answered with, keyed by its id: the `--version` line
- * (`""` when the probe answered nothing) and the failure that makes the row not
- * runnable (`""` when it runs). Base-layer status, never persisted — the row
- * itself lives in the user layer.
+ * (`""` when the probe answered nothing), the failure that makes the row not
+ * runnable (`""` when it runs), and the **note** that explains an executable
+ * this host offers without probing it. A note is not a failure: the path is
+ * there and usable, only not launchable *as a local executable* from here — the
+ * one case is a Windows `chrome.exe` on a WSL host, which the **Prelaunch
+ * Windows Chrome** run drives in connect mode. Base-layer status, never
+ * persisted — the rows themselves live in the user layer.
  */
 export type ChromeExecutableStatus = {
     path: string;
     version: string;
     error: string;
+    note: string;
 };
 /** Where the effective executable came from (`effectiveSource`). */
 export type EffectiveChromeSource = "selected" | "row-config" | "";

package/lib/host/types/executable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../../../src/host/types/executable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC"}
+{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../../../src/host/types/executable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC"}

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

@@ -6,18 +6,19 @@
  * names all of it:
  *
  *   ./stderr.ts     where the bridge console goes + the stderr-wrapper shapes
- *   ./config.ts     the validated row config + reconnect + PluginContext
+ *   ./config.ts     the config `apply` receives + reconnect + PluginContext
  *   ./executable.ts the saved-executable rows + source tag
  *   ./windows.ts    the Prelaunch Windows Chrome run's states + outcome
- *   ./settings.ts   the persisted section, base layer, resolved value, service
+ *   ./settings.ts   the configuration form's layers, the live mirror, the service
  *   ./plugin.ts     the bridge fiber + the tool-call captures
  *
  * Structural views stay narrow: only what the host half actually calls.
  */
 export type { BridgeStderrMode, BridgeStderrNotice, BridgeSpawnTarget, BridgeSpawnOptions, BridgeSpawnResult, BridgeStderrLogPathOptions } from "./stderr.js";
-export type { ChromeMcpConfig, ReconnectConfig, PluginContext } from "./config.js";
+export type { ChromeMcpConfig, ConfigField, ReconnectConfig, PluginContext } from "./config.js";
 export type { ChromeExecutableEntry, ChromeExecutableStatus, EffectiveChromeSource } from "./executable.js";
 export type { WindowsChromeState, WindowsChromeStatus, WindowsChromeLinkAnswer, WindowsChromeRun } from "./windows.js";
-export type { SettingsUserFields, SettingsBaseLayer, SettingsResolved, ValidatedSettings, SettingsOp, SettingsService } from "./settings.js";
+export type { ConfigUserFields, ConfigLiveFields, ConfigLayerFields, ConfigLayers, SettingsForms, SettingsFormRow, SettingsPathOp, ChromeMcpForm } from "./settings.js";
 export type { McpBridge, ToolCallExecution, ToolCallResult } from "./plugin.js";
+export type { CommandDefinition, CommandInvocation, CommandResult } from "./services.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9J,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5G,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvH,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7I,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9J,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChG,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5G,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvH,YAAY,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/lib/host/types/services.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Structural views of the host services this half registers onto but does not
+ * own. The slash-command shapes come from the `commands` service — the headless
+ * mirror surface the card's two executable actions get; the service may be
+ * mounted after `apply` returns (hence the lazy injection) and may not be
+ * mounted at all on a host with no commands plane.
+ */
+/** One slash-command invocation: the raw text after the command name. */
+export type CommandInvocation = {
+    rawInput: string;
+};
+/** What a slash-command handler answers with — never thrown, always shown. */
+export type CommandResult = {
+    kind: "success" | "error";
+    text: string;
+};
+/** The `commands` service definition shape, registered by name. */
+export type CommandDefinition = {
+    name: string;
+    description: string;
+    input?: {
+        hint?: string;
+    };
+    handler: (invocation: CommandInvocation) => CommandResult | Promise<CommandResult>;
+};
+//# sourceMappingURL=services.d.ts.map

package/lib/host/types/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/host/types/services.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,OAAO,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACtF,CAAC"}

package/lib/host/types/services.js

@@ -0,0 +1,9 @@
+/**
+ * Structural views of the host services this half registers onto but does not
+ * own. The slash-command shapes come from the `commands` service — the headless
+ * mirror surface the card's two executable actions get; the service may be
+ * mounted after `apply` returns (hence the lazy injection) and may not be
+ * mounted at all on a host with no commands plane.
+ */
+export {};
+//# sourceMappingURL=services.js.map

package/lib/host/types/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../src/host/types/services.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -1,39 +1,48 @@
 /**
- * Types — the persisted settings section and its composition layers.
+ * Types — the configuration form's layers, the live mirror, and the settings
+ * service surface the Host reads and writes through.
  *
- * What the user edits (and only that persists), the in-memory base layer served
- * alongside it, the resolved value the client card reads, and the `settings`
- * service surface this host half installs the section into. Split out of the
- * single `types.ts`.
+ * Since dsh 0.2.0 there is one `Config` (./../schema.ts) and one form per profile
+ * row: the card edits the row's volatile fields, and every live answer the Host
+ * has to serve rides the very same references. So there is no separate persisted
+ * section and no base layer to publish over — what the Host reads for the fields
+ * it edits is one read of the row's two layers, and what it serves is one
+ * volatile commit of the mirror.
  */
 import type { BridgeStderrMode } from "./stderr.js";
 import type { ChromeExecutableEntry, ChromeExecutableStatus, EffectiveChromeSource } from "./executable.js";
 import type { WindowsChromeStatus } from "./windows.js";
 /**
- * User-authored settings fields — the only keys that persist.
+ * The fields the card edits — the fields the Host persists, and the only ones
+ * whose commits the Host routes (a commit touching nothing here changes nothing
+ * the bridge runs with).
  */
-export type SettingsUserFields = {
+export type ConfigUserFields = {
     extraFlags: string[];
-    /** Written by the card's **Search executables** action: one host run that
+    /** Written by the card's **Fetch executables** action: one host run that
      * re-probes the saved rows and folds what it finds back into them. */
     refreshExecutablesNonce: number;
     /** Written by the card's **Prelaunch Windows Chrome** button: one host run that
      * locates the Windows Chrome, proves the mirrored-loopback prereq, launches
      * it with a debugging port and leaves the bridge in connect mode. Same
-     * trigger idiom as `refreshExecutablesNonce` — there is no push channel, so
-     * an action travels as one write that the host reacts to. */
+     * trigger idiom as `refreshExecutablesNonce` — an action travels as one write
+     * the Host reacts to, never a push channel. */
     openWindowsChromeNonce: number;
     /** The executable the bridge launches with: picked in the picker (a saved
      * row's path), or seeded once by the host; "" = nothing resolved yet. There
      * is no "auto" state to fall back to. */
     chromePath: string;
     /** The saved-executables rows: `{ id: path, name: label }`, the dropdown's
-     * catalog (see ./catalog.ts). Persisted, user-authored; a scan merges what it
-     * finds into them without dropping a name the user chose. */
+     * catalog (see ./catalog.ts). User-authored; a scan merges what it finds
+     * into them without dropping a name the user chose. */
     executables: ChromeExecutableEntry[];
+    /** The ids of saved rows the user dropped — Host-authored, never edited by
+     * the card, and read by every merge step so a deleted row is never folded
+     * back in (see ../controller/runs.ts). */
+    droppedExecutables: string[];
     /** **Legacy** MRU of hand-typed executables (oldest drops off past
      * `CUSTOM_PATHS_CAP`). Nothing writes it any more: the saved rows replace it,
-     * and a host whose settings still carry it folds its paths into the rows on
+     * and a host whose profile still carries it folds its paths into the rows on
      * the first run (see ./catalog.ts). */
     chromeCustomPaths: string[];
     /** The card's "Reduce log output" toggle: "log" captures the bridge's
@@ -42,86 +51,130 @@ export type SettingsUserFields = {
     stderrMode: "" | BridgeStderrMode;
 };
 /**
- * In-memory composition base layer served alongside the user layer.
+ * The live mirror: what the Host answers through the same volatile references
+ * the card edits, and never persists. Every field here is a volatile field of the
+ * single `Config`, published by one commit per change batch.
  */
-export type SettingsBaseLayer = {
+export type ConfigLiveFields = {
+    /** Last check/connection failure, human-readable; "" when healthy. */
     lastError: string;
+    /** The last failure was "no Chrome executable detected". */
     chromeMissing: boolean;
     /** Completion signal of one executable run (a merged scan, and the probe of
      * what is selected that follows it). The one counter every executable action
-     * waits on — the reference plugin names it
-     * `executableDiscoveryRevision` for the same job. */
+     * waits on. */
     executableDiscoveryRevision: number;
     /** The `--version` line the selected executable answered with; "" when
      * nothing answered (nothing selected, a connect mode, a blocked path). */
     chromeVersion: string;
-    /** Per-row probe status, keyed by path: the version a row answered with, and
-     * the failure for a row that is present but not runnable (or blocked). Base
-     * layer, never persisted — the *rows* themselves are user-authored and live
-     * in the persisted layer. */
+    /** Per-row probe status, keyed by path. Never persisted — the *rows*
+     * themselves are user-authored. */
     executableStatus: ChromeExecutableStatus[];
     /** Executable the bridge actually launches with; "" when nothing is fixed. */
     effectiveChromePath: string;
     /** Where `effectiveChromePath` came from. */
     effectiveSource: EffectiveChromeSource;
-    /** True while the running host is WSL **and** the effective executable is a
-     * Windows binary: it cannot be launched across the interop boundary, so the
-     * card shows the static notice that spells out the configuration a Windows
-     * browser does need. Base layer, never persisted. */
-    wslWindowsExecutable: boolean;
-    /** Row-config `bridgeStderr` in effect (static base-layer mirror; never
-     * persisted) — the fallback when the user `stderrMode` is "". */
-    rowStderr: BridgeStderrMode;
-    /** The canonical default extra-flags list (static base-layer mirror of
-     * `DEFAULT_EXTRA_FLAGS`; never persisted) — what the card's Restore
-     * defaults action appends, keeping whatever the user already has. */
+    /** The mode the bridge actually routes console output through — what the
+     * card's toggle is checked against, so it never reads a phantom state. */
+    stderrEffective: BridgeStderrMode;
+    /** The canonical default extra-flags list — what the card's Restore defaults
+     * action appends, keeping whatever the rows already carry. */
     defaultExtraFlags: string[];
-    /** The recommended WSL ↔ Windows extra-flags list (static base-layer
-     * mirror of `WSL_EXTRA_FLAGS`; never persisted) — what the card's **Flags
-     * WSL** action appends, missing entries only, keeping everything the rows
-     * already carry. */
+    /** The recommended WSL ↔ Windows extra-flags list — what the card's **Flags
+     * WSL** action appends, missing entries only. */
     wslExtraFlags: string[];
-    /** What the **Prelaunch Windows Chrome** run is doing right now (base layer;
-     * never persisted). The whole Windows path lives host-side — locate,
-     * prereq, launch, port — so the card renders this one field and carries
-     * no list of Windows paths or of reachability rules. */
+    /** True while this Host runs under WSL **and** the effective executable is a
+     * Windows binary (see ./platform.ts) — the state the card's notice explains. */
+    wslWindowsExecutable: boolean;
+    /** What the **Prelaunch Windows Chrome** run is doing right now. The whole
+     * Windows path lives host-side, so the card renders this one field and
+     * carries no list of Windows paths or reachability rules. */
     windowsChromeStatus: WindowsChromeStatus;
     /** True while the bridge launches with a connect-mode flag
      * (`--browserUrl` / `--wsEndpoint`): there is then no local executable to
-     * launch or probe, so the card mutes the picker instead of claiming a
-     * local selection the bridge is not running. */
+     * launch or probe, so the card mutes the picker instead of claiming a local
+     * selection the bridge is not running. */
     carriesConnectionMode: boolean;
+    /** The flags the live connection actually launches with (mirrored from the
+     * last resolve) — what the machine page states as running, not what the
+     * layers were last configured with. Empty while nothing resolves. */
+    runningFlags: string[];
+    /** The note the live connection answered with — where its console output
+     * goes, or the debugging URL the Windows run connected to. */
+    runningNote: string;
+};
+/** One layer's answers: a field is absent when that layer said nothing. */
+export type ConfigLayerFields = {
+    [K in keyof ConfigUserFields]?: ConfigUserFields[K];
 };
 /**
- * Resolved value served to the client card.
+ * One read of the form: what runs now (the references resolve the user layer over
+ * the row config, which is exactly what the bridge launches with) plus the two
+ * layers the distinction "did the user edit this, or does the row config say it"
+ * reads. Before the form is attached the references answer for both layers, so
+ * the first commit settles the distinction.
  */
-export type SettingsResolved = SettingsUserFields & SettingsBaseLayer;
+export type ConfigLayers = {
+    value: ConfigUserFields;
+    user: ConfigLayerFields;
+    base: ConfigLayerFields;
+};
 /**
- * Validated settings section as consumed by the validate hook.
+ * Surface of the `settings` service (`SettingsForms`) as consumed here. Typed
+ * structurally the way `tool.ts` types the tools service: the service lives in
+ * the loader's module table, and the Host only reads a described row, writes a
+ * patch and turns the generated page off. The patch row is keyed by the
+ * **profile entry id**, never by a namespace of the Host's own.
  */
-export type ValidatedSettings = {
-    extraFlags: string[];
-    stderrMode: "" | BridgeStderrMode;
-    chromePath: string;
-    executables: ChromeExecutableEntry[];
-};
-/** One `settings.mutate` operation: `set` a path, or `unset` it. */
-export type SettingsOp = {
+/**
+ * One ordered edit a write carries through `mutate`: a `set` names a field with
+ * a value; an `unset` returns the field to whatever the row config answers (an
+ * unset of a path no layer answers drops out of the stored row entirely — this
+ * is exactly how the Host clears its live-only fields back to their row-config
+ * answers; see ./values.ts `liveMirrorKeys`).
+ */
+export type SettingsPathOp = {
     op: "set";
-    path: string[];
-    value?: unknown;
+    path: readonly string[];
+    value: unknown;
 } | {
     op: "unset";
-    path: string[];
+    path: readonly string[];
 };
-/** Surface of the `settings` service as consumed here. */
-export interface SettingsService {
-    document?: Record<string, Record<string, any> | undefined> | undefined;
-    mutate(ns: string, ops: SettingsOp[]): Promise<unknown> | unknown;
-    installSection(ctx: unknown, ns: string, schema: unknown, base: Partial<SettingsResolved>, hooks: {
-        setSource?: (source: () => SettingsResolved) => void;
-        validate?: (value: SettingsResolved) => void;
-        onChange?: () => void;
-    }): void;
+export interface SettingsForms {
+    describe(options?: unknown): SettingsFormRow[];
+    /** Write one user-authored field into the row's own patch layer (the store
+     * dsh 0.2.0 uses instead of `settings.yaml`). Never called with a live field. */
+    update(entryId: string, patch: Record<string, unknown>, expectedRevision?: number): Promise<unknown> | unknown;
+    /** One ordered field edit; every edit addresses a volatile field, and an
+     * `unset` falls back to the row-config answer. The Host's write-backs go
+     * through this channel, carrying the live-only fields' clear alongside the
+     * one user field they write, so a live answer can never ride a write back
+     * into the stored layer (see ./values.ts). */
+    mutate(entryId: string, ops: readonly SettingsPathOp[], expectedRevision?: number): Promise<unknown> | unknown;
+    /** `auto: false` keeps the generated page off while the card owns the row's
+     * page. Disposable, and calling it twice for one fiber throws. */
+    configure(presentation: {
+        auto?: boolean;
+    }, owner?: unknown): () => void;
+}
+/** One described settings row (dsh-ancesters `readFormRow`), narrowed to what the Host consults. */
+export interface SettingsFormRow {
+    /** The profile entry id this row is keyed by. */
+    ns: string;
+    /** Live effective value, Host live commits included. */
+    value?: unknown;
+    /** Composition base — what the row config carries under the user layer. */
+    base?: unknown;
+    /** What the profile patch carries (`{}` when it carries nothing). */
+    user?: unknown;
+}
+/** Everything the Host keeps about the form once it attaches. */
+export interface ChromeMcpForm {
+    /** The row's profile entry id — the key every read and write goes through. */
+    entryId: string;
+    /** The form service itself (undefined on the cold path, where only the
+     * references answer). */
+    settings?: SettingsForms;
 }
 //# sourceMappingURL=settings.d.ts.map