@mind-harness/mh-browser 0.2.5 → 0.2.6

package/lib/client.cjs

@@ -163,6 +163,17 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/typert.remote-client.js
+		let _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0$schema$value;
+		const _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0$schema = () => _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0$schema$value ??= zod.z.union([
+			zod.z.literal("chrome"),
+			zod.z.literal("msedge"),
+			zod.z.literal("chromium")
+		]);
+		let _mind_harness_mh_browser_mhBrowser_locateFor_result$schema$value;
+		const _mind_harness_mh_browser_mhBrowser_locateFor_result$schema = () => _mind_harness_mh_browser_mhBrowser_locateFor_result$schema$value ??= zod.z.union([zod.z.object({ "found": zod.z.string() }), zod.z.object({ "missing": zod.z.array(zod.z.object({
+			"path": zod.z.string(),
+			"reason": zod.z.string()
+		})) })]);
 		let _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0$schema$value;
 		const _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0$schema = () => _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0$schema$value ??= zod.z.string();
 		let _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema$value;
@@ -171,60 +182,115 @@ window.__ModuleLoader__.load({
 			zod.z.literal("not-handing-over"),
 			zod.z.literal("no-tab")
 		]) });
+		let _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0_strict$schema$value;
+		const _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0_strict$schema = () => _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0_strict$schema$value ??= zod.z.union([
+			zod.z.literal("chrome"),
+			zod.z.literal("msedge"),
+			zod.z.literal("chromium")
+		]);
 		let _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0_strict$schema$value;
 		const _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0_strict$schema = () => _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0_strict$schema$value ??= zod.z.string();
 		const TYPERT_REMOTE = createTypertRemoteInfo({
 			package: "@mind-harness/mh-browser",
-			methods: { "mhBrowser/revealHandover": {
-				service: "mhBrowser",
-				description: "The person asked to see the page this Session handed over.",
-				invocation: { kind: "direct" },
-				parameters: [{
-					name: "sessionId",
-					source: "json",
-					codec: {
+			methods: {
+				"mhBrowser/locateFor": {
+					service: "mhBrowser",
+					description: "Where `browser` would be launched from when no path is configured. The configured path is not consulted: the answer is what an empty path uses.",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "browser",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@mind-harness/mh-browser/location#BrowserName",
+							create: _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0$schema,
+							jsonSchema: {
+								"type": "string",
+								"enum": [
+									"chrome",
+									"msedge",
+									"chromium"
+								]
+							}
+						},
+						strictCodec: {
+							mode: "strict",
+							typeSymbol: "@mind-harness/mh-browser/location#BrowserName",
+							create: _mind_harness_mh_browser_mhBrowser_locateFor_parameter_0_strict$schema,
+							jsonSchema: {
+								"type": "string",
+								"enum": [
+									"chrome",
+									"msedge",
+									"chromium"
+								]
+							}
+						}
+					}],
+					cancellation: { parameter: "signal" },
+					result: {
 						mode: "strict",
-						typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:sessionId",
-						create: _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0$schema,
-						jsonSchema: { "type": "string" }
+						typeSymbol: "@mind-harness/mh-browser/location#BrowserLocation",
+						create: _mind_harness_mh_browser_mhBrowser_locateFor_result$schema,
+						jsonSchemaError: "typert tool schema: selected union branches overlap or have no required discriminator"
 					},
-					strictCodec: {
-						mode: "strict",
-						typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:sessionId",
-						create: _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0_strict$schema,
-						jsonSchema: { "type": "string" }
-					}
-				}],
-				cancellation: { parameter: "signal" },
-				result: {
-					mode: "strict",
-					typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:result",
-					create: _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema,
-					jsonSchema: {
-						"type": "object",
-						"properties": { "status": {
-							"type": "string",
-							"enum": [
-								"revealed",
-								"not-handing-over",
-								"no-tab"
-							]
-						} },
-						"required": ["status"],
-						"additionalProperties": true
+					sourceLocation: {
+						"file": "packages/mh-browser/src/service/service.ts",
+						"line": 474,
+						"column": 9
 					}
 				},
-				sourceLocation: {
-					"file": "packages/mh-browser/src/service/service.ts",
-					"line": 684,
-					"column": 9
+				"mhBrowser/revealHandover": {
+					service: "mhBrowser",
+					description: "The person asked to see the page this Session handed over.",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:sessionId",
+							create: _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0$schema,
+							jsonSchema: { "type": "string" }
+						},
+						strictCodec: {
+							mode: "strict",
+							typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:sessionId",
+							create: _mind_harness_mh_browser_mhBrowser_revealHandover_parameter_0_strict$schema,
+							jsonSchema: { "type": "string" }
+						}
+					}],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@mind-harness/mh-browser#mhBrowser/revealHandover:result",
+						create: _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema,
+						jsonSchema: {
+							"type": "object",
+							"properties": { "status": {
+								"type": "string",
+								"enum": [
+									"revealed",
+									"not-handing-over",
+									"no-tab"
+								]
+							} },
+							"required": ["status"],
+							"additionalProperties": true
+						}
+					},
+					sourceLocation: {
+						"file": "packages/mh-browser/src/service/service.ts",
+						"line": 734,
+						"column": 9
+					}
 				}
-			} }
+			}
 		}, zod.z);
 		//#endregion
 		//#region src/client/card.ts
 		/** Host theme tokens only; the rules unmount with the row. */
-		const STYLE = `
+		const STYLE$1 = `
 .mh-br { display: flex; flex-direction: column; align-items: flex-start; gap: 8px; color: var(--dsw-alias-label-primary); font-size: 14px; line-height: 20px; }
 .mh-br-line { margin: 0; }
 .mh-br-status { margin: 0; color: var(--dsw-alias-label-secondary); }
@@ -233,7 +299,7 @@ window.__ModuleLoader__.load({
 		/** The open handover: the reason and the button that raises its window. */
 		function HandoverRow(props) {
 			const [note, setNote] = (0, react.useState)(void 0);
-			return (0, react.createElement)("section", { className: "mh-br" }, (0, react.createElement)("style", null, STYLE), (0, react.createElement)("p", { className: "mh-br-line" }, props.t("waiting", { reason: props.reason })), (0, react.createElement)("button", {
+			return (0, react.createElement)("section", { className: "mh-br" }, (0, react.createElement)("style", null, STYLE$1), (0, react.createElement)("p", { className: "mh-br-line" }, props.t("waiting", { reason: props.reason })), (0, react.createElement)("button", {
 				type: "button",
 				className: "mh-br-button",
 				onClick: () => {
@@ -260,14 +326,58 @@ window.__ModuleLoader__.load({
 			reveal: "去浏览器",
 			notHandingOver: "这次交接已经结束",
 			noTab: "没有可以去的页面",
-			failed: "没能切到浏览器"
+			failed: "没能切到浏览器",
+			browserLabel: "浏览器",
+			browserHint: "保存后，浏览器空闲时会关掉再按这个选择打开。已经打开的标签页会关掉。",
+			pathLabel: "浏览器路径",
+			pathHint: "留空就用自动找到的。可以填绝对路径，也可以用 ~。保存后同样在空闲时重启。",
+			pathInvalid: "需要绝对路径，或以 ~ 开头",
+			pathSearching: "正在查找…",
+			pathMissing: "未找到{name}，请填写路径",
+			pathHelp: "说明",
+			pathDoesNotExist: "不存在",
+			pathIsDirectory: "是目录",
+			pathDenied: "没有权限（{code}）",
+			chrome: "Google Chrome",
+			msedge: "Microsoft Edge",
+			chromium: "Chromium",
+			overridden: "已覆盖",
+			reset: "恢复",
+			save: "保存",
+			saving: "保存中",
+			settingsUnavailable: "这个配置现在不可用",
+			settingsReadOnly: "这次启动的配置不能在页面上改",
+			settingsSaveFailed: "没有保存：设置可能在别处改过，或这个值不被接受。修改还在，检查后可以再保存",
+			discard: "放弃修改"
 		};
 		const en = {
 			waiting: "The browser is yours: {reason}",
 			reveal: "Go to the browser",
 			notHandingOver: "This handover has already ended",
 			noTab: "There is no page to open",
-			failed: "Could not switch to the browser"
+			failed: "Could not switch to the browser",
+			browserLabel: "Browser",
+			browserHint: "After saving, the browser restarts once it is idle. Tabs that are open will close.",
+			pathLabel: "Browser path",
+			pathHint: "Leave empty to use the browser that was found. An absolute path, or one starting with ~, is accepted. Saving restarts the browser once it is idle.",
+			pathInvalid: "Use an absolute path, or one starting with ~",
+			pathSearching: "Looking…",
+			pathMissing: "{name} was not found. Enter its path",
+			pathHelp: "Details",
+			pathDoesNotExist: "does not exist",
+			pathIsDirectory: "is a directory",
+			pathDenied: "permission denied ({code})",
+			chrome: "Google Chrome",
+			msedge: "Microsoft Edge",
+			chromium: "Chromium",
+			overridden: "Overridden",
+			reset: "Reset",
+			save: "Save",
+			saving: "Saving",
+			settingsUnavailable: "This setting is not available",
+			settingsReadOnly: "This launch keeps the setting read-only",
+			settingsSaveFailed: "Not saved: the setting may have changed elsewhere, or the value was not accepted. Your changes are kept; check them and save again.",
+			discard: "Discard changes"
 		};
 		//#endregion
 		//#region src/client/row.ts
@@ -278,25 +388,25 @@ window.__ModuleLoader__.load({
 		*/
 		const HANDOVER_KIND = "browser-handover";
 		const HANDOVER_TOOL = "browser_handover";
-		function isRecord(value) {
+		function isRecord$1(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		function turnOf(data) {
-			if (!isRecord(data) || typeof data.turn !== "number") return void 0;
+			if (!isRecord$1(data) || typeof data.turn !== "number") return void 0;
 			return data.turn;
 		}
 		function reasonOf(value) {
 			if (typeof value !== "string") return "";
 			try {
 				const parsed = JSON.parse(value);
-				if (!isRecord(parsed) || typeof parsed.reason !== "string") return "";
+				if (!isRecord$1(parsed) || typeof parsed.reason !== "string") return "";
 				return parsed.reason;
 			} catch {
 				return "";
 			}
 		}
 		function callOf(data) {
-			if (!isRecord(data) || typeof data.callId !== "string" || typeof data.name !== "string") return void 0;
+			if (!isRecord$1(data) || typeof data.callId !== "string" || typeof data.name !== "string") return void 0;
 			return {
 				callId: data.callId,
 				name: data.name,
@@ -305,9 +415,9 @@ window.__ModuleLoader__.load({
 		}
 		/** A result names its call on `message.source` and again on `message.toolCallId`. */
 		function callIdOf(data) {
-			if (!isRecord(data) || !isRecord(data.message)) return void 0;
+			if (!isRecord$1(data) || !isRecord$1(data.message)) return void 0;
 			const message = data.message;
-			if (isRecord(message.source) && typeof message.source.callId === "string" && message.source.callId !== "") return message.source.callId;
+			if (isRecord$1(message.source) && typeof message.source.callId === "string" && message.source.callId !== "") return message.source.callId;
 			if (typeof message.toolCallId === "string" && message.toolCallId !== "") return message.toolCallId;
 		}
 		function hidden(current) {
@@ -394,6 +504,615 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region src/client/settings-form.ts
+		/** Drafts over one entry's fields, written together on save. */
+		var StagedForm = class {
+			scope;
+			specs;
+			staged = /* @__PURE__ */ new Map();
+			listeners = /* @__PURE__ */ new Set();
+			baseline;
+			saving = false;
+			failed = false;
+			unsubscribe;
+			constructor(scope, specs) {
+				this.scope = scope;
+				this.specs = new Map(specs.map((spec) => [spec.field, spec]));
+				this.unsubscribe = scope.subscribe(() => {
+					this.publish();
+				});
+			}
+			/** A store over `project`, rebuilt whenever the entry or a draft changes. */
+			bind(project) {
+				let current = project();
+				const subscribers = /* @__PURE__ */ new Set();
+				this.listeners.add(() => {
+					current = project();
+					for (const listener of subscribers) listener();
+				});
+				return {
+					getSnapshot: () => current,
+					subscribe: (listener) => {
+						subscribers.add(listener);
+						return () => {
+							subscribers.delete(listener);
+						};
+					}
+				};
+			}
+			shell() {
+				const snapshot = this.scope.getSnapshot();
+				const plan = this.plan();
+				return {
+					available: snapshot.status === "ready",
+					writable: snapshot.writable,
+					dirty: plan.length > 0,
+					invalid: plan.some((item) => item.op === void 0),
+					saving: this.saving,
+					failed: this.failed
+				};
+			}
+			field(field) {
+				const spec = this.spec(field);
+				const staged = this.staged.get(field);
+				if (staged === void 0) return {
+					text: spec.format(this.read("value", field)),
+					overridden: this.stored(field),
+					invalid: false
+				};
+				const write = staged.clear ? { kind: "clear" } : spec.parse(staged.text);
+				return {
+					text: staged.text,
+					overridden: write?.kind === "set",
+					invalid: write === void 0
+				};
+			}
+			edit(field, text) {
+				this.stage(field, {
+					text,
+					clear: false
+				});
+			}
+			/** Stage removing the field from the user layer. The draft shows what it falls back to. */
+			reset(field) {
+				this.stage(field, {
+					text: this.spec(field).format(this.read("base", field)),
+					clear: true
+				});
+			}
+			discard() {
+				if (this.staged.size === 0 && !this.failed) return;
+				this.staged.clear();
+				this.baseline = void 0;
+				this.failed = false;
+				this.publish();
+			}
+			/**
+			* Write every staged edit. A save the Host refuses keeps the drafts, and the
+			* next save is fenced on what the Host holds now, so trying again can land.
+			*/
+			async save() {
+				const plan = this.plan();
+				if (plan.length === 0 || this.saving || !this.scope.getSnapshot().writable) return;
+				if (plan.some((item) => item.op === void 0)) return;
+				this.saving = true;
+				this.failed = false;
+				this.publish();
+				try {
+					const ops = plan.flatMap((item) => item.op === void 0 ? [] : [item.op]);
+					const landed = ops.length === 0 || await this.scope.mutate(ops, this.baseline?.revision);
+					if (landed) {
+						this.staged.clear();
+						this.baseline = void 0;
+					} else this.baseline = this.scope.getSnapshot();
+					this.failed = !landed;
+				} catch {
+					this.baseline = this.scope.getSnapshot();
+					this.failed = true;
+				} finally {
+					this.saving = false;
+					this.publish();
+				}
+			}
+			dispose() {
+				this.unsubscribe();
+				this.listeners.clear();
+			}
+			plan() {
+				const plan = [];
+				for (const [field, staged] of this.staged) {
+					const spec = this.spec(field);
+					if (staged.clear) {
+						if (this.stored(field)) plan.push({
+							field,
+							op: {
+								op: "unset",
+								path: [field]
+							}
+						});
+						continue;
+					}
+					if (staged.text === spec.format(this.read("value", field))) continue;
+					const write = spec.parse(staged.text);
+					if (write === void 0) plan.push({ field });
+					else if (write.kind === "clear") plan.push({
+						field,
+						op: {
+							op: "unset",
+							path: [field]
+						}
+					});
+					else plan.push({
+						field,
+						op: {
+							op: "set",
+							path: [field],
+							value: write.value
+						}
+					});
+				}
+				return plan;
+			}
+			stage(field, edit) {
+				this.baseline ??= this.scope.getSnapshot();
+				this.staged.set(field, edit);
+				this.failed = false;
+				this.publish();
+			}
+			spec(field) {
+				const spec = this.specs.get(field);
+				if (spec === void 0) throw new Error(`settings form has no field ${field}`);
+				return spec;
+			}
+			read(layer, field) {
+				const section = this.scope.getSnapshot()[layer];
+				return isRecord(section) ? section[field] : void 0;
+			}
+			stored(field) {
+				const user = this.scope.getSnapshot().user;
+				return isRecord(user) && Object.hasOwn(user, field);
+			}
+			publish() {
+				for (const listener of this.listeners) listener();
+			}
+		};
+		/** Free text. An empty draft clears the field. */
+		function textField(field) {
+			return {
+				field,
+				format: (value) => typeof value === "string" ? value : "",
+				parse: (text) => {
+					const trimmed = text.trim();
+					return trimmed === "" ? { kind: "clear" } : {
+						kind: "set",
+						value: trimmed
+					};
+				}
+			};
+		}
+		const STYLE = `
+.mh-browser-form { display: flex; flex-direction: column; }
+.mh-browser-status { margin: 0 0 12px; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-tertiary); }
+.mh-browser-footer { display: flex; align-items: flex-start; gap: 12px; padding-top: 16px; }
+.mh-browser-save { flex: none; }
+.mh-browser-failure { flex: 1; min-width: 0; display: flex; flex-direction: column; align-items: flex-start; gap: 2px; padding-top: 5px; }
+.mh-browser-failed { margin: 0; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-error); }
+.mh-browser-save { appearance: none; border: 1px solid transparent; border-radius: var(--dsw-radius-md); padding: 5px 14px; font: inherit; font-size: 13px; line-height: 1.5; cursor: pointer; background: var(--dsw-alias-label-primary); color: var(--dsw-alias-bg-layer-3); }
+.mh-browser-save:disabled { opacity: 0.4; cursor: default; }
+.mh-browser-save:focus-visible, .mh-browser-help-button:focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); outline-offset: 1px; }
+.mh-browser-field { display: flex; flex-direction: column; gap: 6px; padding: 12px 0; }
+.mh-browser-field + .mh-browser-field { border-top: 0.5px solid var(--dsw-alias-border-l2); }
+.mh-browser-head { display: flex; align-items: center; gap: 8px; }
+.mh-browser-label-group { display: flex; align-items: center; gap: 4px; flex: 1; min-width: 0; }
+.mh-browser-label { flex: 0 1 auto; min-width: 0; font-size: 13px; font-weight: 500; line-height: 1.5; color: var(--dsw-alias-label-primary); }
+.mh-browser-help-button { display: inline-flex; align-items: center; justify-content: center; flex: none; width: 24px; height: 24px; padding: 0; border: 0; border-radius: var(--dsw-radius-sm); background: none; color: var(--dsw-alias-label-tertiary); cursor: pointer; }
+.mh-browser-help-button[aria-expanded='true'] { background: var(--dsw-alias-bg-layer-4); color: var(--dsw-alias-label-secondary); }
+.mh-browser-help { padding: 10px 0 0; font-size: 12px; line-height: 1.6; color: var(--dsw-alias-label-secondary); white-space: pre-wrap; }
+.mh-browser-badges { display: inline-flex; align-items: center; gap: 8px; }
+.mh-browser-tag { display: inline-flex; align-items: center; border-radius: 999px; padding: 1px 8px; font-size: 11px; line-height: 17px; font-weight: 500; white-space: nowrap; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-secondary); }
+.mh-browser-reset { border: none; background: none; padding: 0; font: inherit; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-secondary); cursor: pointer; }
+.mh-browser-reset:disabled { cursor: default; }
+.mh-browser-input { box-sizing: border-box; width: 100%; height: 34px; padding: 0 12px; border: 0.5px solid var(--dsw-alias-border-l4); border-radius: var(--dsw-radius-md); background: var(--dsw-alias-bg-layer-3); font: inherit; font-size: 13px; line-height: 1.5; color: var(--dsw-alias-label-primary); }
+.mh-browser-input:focus-visible { outline: none; border-color: var(--dsw-alias-state-business-primary); }
+.mh-browser-input:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }
+.mh-browser-input[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }
+.mh-browser-choice { position: relative; display: flex; }
+.mh-browser-choice .mh-browser-input { appearance: none; padding-right: 32px; cursor: pointer; }
+.mh-browser-choice .mh-browser-input:disabled { cursor: default; }
+.mh-browser-choice option { background: var(--dsw-alias-bg-layer-3); color: var(--dsw-alias-label-primary); }
+.mh-browser-chevron { position: absolute; top: 50%; right: 12px; transform: translateY(-50%); color: var(--dsw-alias-label-tertiary); pointer-events: none; }
+.mh-browser-invalid { margin: 0; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-state-error-primary); }
+.mh-browser-hint { margin: 0; font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-tertiary); }
+@media (hover: hover) {
+  .mh-browser-help-button:hover { background: var(--dsw-alias-bg-layer-4); color: var(--dsw-alias-label-secondary); }
+  .mh-browser-reset:hover:not(:disabled) { color: var(--dsw-alias-label-primary); }
+}
+`;
+		/** The page frame: read-only notice, the fields, and Save. Unmounting drops every draft. */
+		function SettingsFrame(props) {
+			const discard = (0, react.useRef)(props.onDiscard);
+			discard.current = props.onDiscard;
+			(0, react.useEffect)(() => () => {
+				discard.current();
+			}, []);
+			const { state, labels } = props;
+			if (!state.available) return (0, react.createElement)("div", null, (0, react.createElement)("style", null, STYLE), (0, react.createElement)("p", {
+				className: "mh-browser-status",
+				role: "status"
+			}, labels.unavailable));
+			const blocked = !state.dirty || state.invalid || state.saving || !state.writable;
+			return (0, react.createElement)("div", { className: "mh-browser-form" }, (0, react.createElement)("style", null, STYLE), state.writable ? null : (0, react.createElement)("p", {
+				className: "mh-browser-status",
+				role: "status"
+			}, labels.readOnly), props.children, (0, react.createElement)("div", { className: "mh-browser-footer" }, (0, react.createElement)("button", {
+				type: "button",
+				className: "mh-browser-save",
+				disabled: blocked,
+				onClick: props.onSave
+			}, state.saving ? labels.saving : labels.save), state.failed ? (0, react.createElement)("div", { className: "mh-browser-failure" }, (0, react.createElement)("p", {
+				className: "mh-browser-failed",
+				role: "status"
+			}, labels.saveFailed), (0, react.createElement)("button", {
+				type: "button",
+				className: "mh-browser-reset",
+				onClick: props.onDiscard
+			}, labels.discard)) : null));
+		}
+		function TextField(props) {
+			return (0, react.createElement)(Field, {
+				...props,
+				control: (describedBy) => (0, react.createElement)("input", {
+					id: props.id,
+					className: "mh-browser-input",
+					type: "text",
+					...props.invalid ? { "aria-invalid": true } : {},
+					"aria-describedby": describedBy,
+					value: props.text,
+					placeholder: props.placeholder ?? "",
+					disabled: props.disabled,
+					onChange: (event) => {
+						props.onEdit(event.target.value);
+					}
+				})
+			});
+		}
+		function ChoiceField(props) {
+			return (0, react.createElement)(Field, {
+				...props,
+				control: (describedBy) => (0, react.createElement)("div", { className: "mh-browser-choice" }, (0, react.createElement)("select", {
+					id: props.id,
+					className: "mh-browser-input",
+					"aria-describedby": describedBy,
+					value: props.text,
+					disabled: props.disabled,
+					onChange: (event) => {
+						props.onEdit(event.target.value);
+					}
+				}, props.options.map((option) => (0, react.createElement)("option", {
+					key: option.value,
+					value: option.value
+				}, option.label))), (0, react.createElement)(Chevron))
+			});
+		}
+		function Field(props) {
+			const [helpOpen, setHelpOpen] = (0, react.useState)(false);
+			const helpId = `${props.id}-help`;
+			const messageId = `${props.id}-message`;
+			const invalid = props.invalid && props.invalidLabel !== void 0;
+			const hasMessage = invalid || props.hint !== void 0 && props.hint !== "";
+			const describedBy = [hasMessage ? messageId : "", helpOpen ? helpId : ""].filter((id) => id !== "").join(" ");
+			return (0, react.createElement)("div", { className: "mh-browser-field" }, (0, react.createElement)("div", { className: "mh-browser-head" }, (0, react.createElement)("div", { className: "mh-browser-label-group" }, (0, react.createElement)("label", {
+				className: "mh-browser-label",
+				htmlFor: props.id
+			}, props.label), props.help === void 0 ? null : (0, react.createElement)("button", {
+				type: "button",
+				className: "mh-browser-help-button",
+				"aria-label": props.help.label,
+				"aria-expanded": helpOpen,
+				"aria-controls": helpId,
+				onClick: () => {
+					setHelpOpen(!helpOpen);
+				}
+			}, (0, react.createElement)(InfoIcon))), props.overridden ? (0, react.createElement)("span", { className: "mh-browser-badges" }, (0, react.createElement)("span", { className: "mh-browser-tag" }, props.overriddenLabel), (0, react.createElement)("button", {
+				type: "button",
+				className: "mh-browser-reset",
+				disabled: props.disabled,
+				onClick: props.onReset
+			}, props.resetLabel)) : null), props.control(describedBy === "" ? void 0 : describedBy), hasMessage ? (0, react.createElement)("p", {
+				id: messageId,
+				className: invalid ? "mh-browser-invalid" : "mh-browser-hint"
+			}, invalid ? props.invalidLabel : props.hint) : null, props.help !== void 0 && helpOpen ? (0, react.createElement)("div", {
+				id: helpId,
+				className: "mh-browser-help",
+				role: "region",
+				"aria-label": props.help.label
+			}, props.help.content) : null);
+		}
+		function InfoIcon() {
+			return (0, react.createElement)("svg", {
+				width: 12,
+				height: 12,
+				viewBox: "0 0 12 12",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1,
+				strokeLinecap: "round",
+				"aria-hidden": true
+			}, (0, react.createElement)("circle", {
+				cx: 6,
+				cy: 6,
+				r: 5
+			}), (0, react.createElement)("path", { d: "M6 5.5v3" }), (0, react.createElement)("circle", {
+				cx: 6,
+				cy: 3.75,
+				r: .5,
+				fill: "currentColor",
+				stroke: "none"
+			}));
+		}
+		function Chevron() {
+			return (0, react.createElement)("svg", {
+				className: "mh-browser-chevron",
+				width: 12,
+				height: 12,
+				viewBox: "0 0 12 12",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: 1.25,
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": true
+			}, (0, react.createElement)("path", { d: "M3 4.5l3 3 3-3" }));
+		}
+		function isRecord(value) {
+			return typeof value === "object" && value !== null;
+		}
+		//#endregion
+		//#region src/client/settings.ts
+		/** Loader row id, and the settings namespace for that row. */
+		const ENTRY_ID = "mh-browser";
+		/** `plugins.row.config` key: the bundle package, then the row id. */
+		const ROW_KEY = "@mind-harness/mh-bundle#mh-browser";
+		const BROWSER_CHOICES = [
+			"chrome",
+			"msedge",
+			"chromium"
+		];
+		const LOADING = { status: "loading" };
+		/** Empty text clears the field. Anything else must be absolute, or start with `~`. */
+		function parseExecutable(text) {
+			const trimmed = text.trim();
+			if (trimmed === "") return { kind: "clear" };
+			if (trimmed === "~" || trimmed.startsWith("~/") || trimmed.startsWith("~\\")) return {
+				kind: "set",
+				value: trimmed
+			};
+			if (trimmed.startsWith("/") || /^[A-Za-z]:[\\/]/.test(trimmed)) return {
+				kind: "set",
+				value: trimmed
+			};
+		}
+		/** Placeholder for an empty path field: the path an empty value would use. */
+		function pathPlaceholder(lookup, browser, t) {
+			if (lookup.status === "loading") return t("pathSearching");
+			if (lookup.status === "found") return lookup.path;
+			if (lookup.status === "missing") return t("pathMissing", { name: t(browser) });
+		}
+		/** The full path, or every place that was tried. Absent while looking or after a failed lookup. */
+		function pathHelpText(lookup, t) {
+			if (lookup.status === "found") return lookup.path;
+			if (lookup.status !== "missing") return void 0;
+			return lookup.tried.map((item) => `${item.path} (${reasonText(item.reason, t)})`).join("\n");
+		}
+		/**
+		* One browser name's lookup, kept until the settings page unmounts.
+		* A newer lookup cancels the one still running.
+		*/
+		var ExecutableLookup = class {
+			locate;
+			cache = /* @__PURE__ */ new Map();
+			inflight;
+			controller;
+			listeners = /* @__PURE__ */ new Set();
+			constructor(locate) {
+				this.locate = locate;
+			}
+			subscribe = (listener) => {
+				this.listeners.add(listener);
+				return () => {
+					this.listeners.delete(listener);
+				};
+			};
+			/** Cached answer for `browser`, or loading when that answer is not in yet. */
+			view(browser) {
+				return this.cache.get(browser) ?? LOADING;
+			}
+			watch(browser) {
+				if (this.cache.has(browser) || this.inflight === browser) return;
+				this.controller?.abort();
+				const controller = new AbortController();
+				this.controller = controller;
+				this.inflight = browser;
+				this.locate(browser, controller.signal).then((result) => {
+					if (controller.signal.aborted) return;
+					if (this.inflight === browser) this.inflight = void 0;
+					this.cache.set(browser, viewOf(result));
+					this.publish();
+				}, () => {
+					if (controller.signal.aborted) return;
+					if (this.inflight === browser) this.inflight = void 0;
+					this.cache.set(browser, { status: "failed" });
+					this.publish();
+				});
+			}
+			dispose() {
+				this.controller?.abort();
+				this.controller = void 0;
+				this.inflight = void 0;
+				this.cache.clear();
+			}
+			publish() {
+				for (const listener of this.listeners) listener();
+			}
+		};
+		/** Staged browser choice and path. A save the host accepts restarts the browser when it is idle. */
+		var BrowserForm = class {
+			form;
+			lookup;
+			state;
+			constructor(scope, locate) {
+				this.form = new StagedForm(scope, [browserField(), executableField()]);
+				this.lookup = new ExecutableLookup(locate);
+				this.state = this.form.bind(() => ({
+					...this.form.shell(),
+					browser: this.form.field("browser"),
+					executablePath: this.form.field("executablePath")
+				}));
+			}
+			edit(field, text) {
+				this.form.edit(field, text);
+			}
+			reset(field) {
+				this.form.reset(field);
+			}
+			save() {
+				this.form.save();
+			}
+			discard() {
+				this.form.discard();
+			}
+			dispose() {
+				this.lookup.dispose();
+				this.form.dispose();
+			}
+		};
+		function registerSettings(ctx) {
+			const form = new BrowserForm(ctx.configForms.get(ENTRY_ID), (browser, signal) => ctx.remote.mhBrowser.locateFor(browser, signal));
+			ctx.effect(() => () => {
+				form.dispose();
+			});
+			ctx.slots.inject("plugins.row.config", () => ctx.slots.register({
+				name: "plugins.row.config",
+				key: ROW_KEY,
+				locale: NS
+			}, (props) => {
+				if (props.view === "summary") return null;
+				return (0, react.createElement)(BrowserSettings, {
+					t: props.t,
+					form
+				});
+			}));
+		}
+		function BrowserSettings(props) {
+			const state = (0, react.useSyncExternalStore)(props.form.state.subscribe, props.form.state.getSnapshot, props.form.state.getSnapshot);
+			const browser = choiceOf(state.browser.text);
+			const lookup = (0, react.useSyncExternalStore)(props.form.lookup.subscribe, () => props.form.lookup.view(browser), () => props.form.lookup.view(browser));
+			(0, react.useEffect)(() => {
+				props.form.lookup.watch(browser);
+			}, [browser, props.form]);
+			(0, react.useEffect)(() => {
+				const lookup = props.form.lookup;
+				return () => {
+					lookup.dispose();
+				};
+			}, [props.form]);
+			const disabled = !state.writable || state.saving;
+			const help = helpOf(lookup, props.t);
+			const placeholder = state.executablePath.text === "" ? pathPlaceholder(lookup, browser, props.t) : void 0;
+			return (0, react.createElement)(SettingsFrame, {
+				labels: formLabels(props.t),
+				state,
+				onSave: () => props.form.save(),
+				onDiscard: () => props.form.discard()
+			}, (0, react.createElement)(ChoiceField, {
+				id: "mh-browser-name",
+				label: props.t("browserLabel"),
+				hint: props.t("browserHint"),
+				...state.browser,
+				text: browser,
+				options: BROWSER_CHOICES.map((name) => ({
+					value: name,
+					label: props.t(name)
+				})),
+				overriddenLabel: props.t("overridden"),
+				resetLabel: props.t("reset"),
+				disabled,
+				onEdit: (value) => props.form.edit("browser", value),
+				onReset: () => props.form.reset("browser")
+			}), (0, react.createElement)(TextField, {
+				id: "mh-browser-path",
+				label: props.t("pathLabel"),
+				hint: props.t("pathHint"),
+				...state.executablePath,
+				overriddenLabel: props.t("overridden"),
+				resetLabel: props.t("reset"),
+				invalidLabel: props.t("pathInvalid"),
+				disabled,
+				...placeholder === void 0 ? {} : { placeholder },
+				...help === void 0 ? {} : { help },
+				onEdit: (text) => props.form.edit("executablePath", text),
+				onReset: () => props.form.reset("executablePath")
+			}));
+		}
+		function browserField() {
+			return {
+				field: "browser",
+				format: (value) => typeof value === "string" && isChoice(value) ? value : "chrome",
+				parse: (text) => isChoice(text) ? {
+					kind: "set",
+					value: text
+				} : void 0
+			};
+		}
+		function executableField() {
+			return {
+				...textField("executablePath"),
+				parse: parseExecutable
+			};
+		}
+		function formLabels(t) {
+			return {
+				unavailable: t("settingsUnavailable"),
+				readOnly: t("settingsReadOnly"),
+				saveFailed: t("settingsSaveFailed"),
+				discard: t("discard"),
+				save: t("save"),
+				saving: t("saving")
+			};
+		}
+		function choiceOf(text) {
+			return isChoice(text) ? text : "chrome";
+		}
+		function isChoice(value) {
+			return BROWSER_CHOICES.includes(value);
+		}
+		function viewOf(result) {
+			if (!result.ok) return { status: "failed" };
+			if ("found" in result.value) return {
+				status: "found",
+				path: result.value.found
+			};
+			return {
+				status: "missing",
+				tried: result.value.missing
+			};
+		}
+		function helpOf(lookup, t) {
+			const text = pathHelpText(lookup, t);
+			if (text === void 0) return void 0;
+			return {
+				label: t("pathHelp"),
+				content: text
+			};
+		}
+		function reasonText(reason, t) {
+			if (reason === "does not exist") return t("pathDoesNotExist");
+			if (reason === "is a directory") return t("pathIsDirectory");
+			const code = /^permission denied: (\S+)$/.exec(reason)?.[1];
+			if (code !== void 0) return t("pathDenied", { code });
+			return reason;
+		}
+		//#endregion
 		//#region src/client/client.ts
 		/**
 		* Cordis services this client reads. `dsh.client.inject` is package load
@@ -403,7 +1122,8 @@ window.__ModuleLoader__.load({
 			"slots",
 			"locale",
 			"remote",
-			"uiConversation"
+			"uiConversation",
+			"configForms"
 		];
 		const namespaceInject = [...inject, "remote.mhBrowser"];
 		async function apply(ctx) {
@@ -411,6 +1131,7 @@ window.__ModuleLoader__.load({
 			let release = () => void 0;
 			await ctx.inject(namespaceInject, (inner) => {
 				release = start(inner);
+				registerSettings(inner);
 			});
 			return async () => {
 				release();