@mind-harness/mh-browser 0.2.5 → 0.2.7

package/lib/client.cjs

@@ -4,236 +4,92 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let zod = require("zod");
 		let react = require("react");
-		//#region ../../node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.2.2-rc.1_@deepseek-ai+cordis@4.1.0/node_modules/@deepseek-ai/dsh-typert-protocol/lib/types/remote-info.js
-		/** Lazy assembly of generated Remote definitions using caller-supplied Zod; no runtime imports. */
+		//#region src/client/call.ts
+		const PACKAGE = "mh-browser";
 		/**
-		* Retain one generated definition per endpoint without constructing parsers or projections.
-		* The class instance builds its shared descriptor/method index on first access;
-		* input schemas and JSON Schema projections are cached only when requested.
-		* @param spec - compiler-produced method facts and Zod factories.
-		* @param zod - the generated artifact's Zod runtime for named-input parsers.
-		* @returns a lazy, mountable info instance with no registration or transport effects.
+		* `document.baseURI` keeps a mounted page on its prefix. dsh's file upload
+		* resolves the same way.
 		*/
-		function createTypertRemoteInfo(spec, zod) {
-			return new RemoteInfo(spec, zod);
-		}
-		var RemoteInfo = class {
-			spec;
-			zod;
-			index;
-			constructor(spec, zod) {
-				this.spec = spec;
-				this.zod = zod;
-			}
-			get package() {
-				return this.spec.package;
-			}
-			get descriptors() {
-				return this.resolve().descriptors;
-			}
-			get methods() {
-				return this.resolve().methods;
-			}
-			resolve() {
-				if (this.index !== void 0) return this.index;
-				const zod = this.zod;
-				const descriptors = [];
-				const methods = Object.create(null);
-				for (const [endpoint, definition] of Object.entries(this.spec.methods)) {
-					const separator = endpoint.indexOf("/");
-					const namespace = endpoint.slice(0, separator);
-					const method = endpoint.slice(separator + 1);
-					const parameters = definition.parameters.map((parameter) => ({
-						...parameter,
-						wire: parameter.wire ?? parameter.name
-					}));
-					const descriptor = {
-						...definition,
-						id: `${this.spec.package}#${endpoint}`,
-						namespace,
-						method,
-						parameters,
-						result: definition.result.description === void 0 ? definition.result : new ResultValue(definition.result)
-					};
-					if (definition.invocation.kind === "direct") {
-						const inputs = [];
-						methods[endpoint] = Object.assign(descriptor, {
-							input(options) {
-								const strict = options?.strict === true;
-								return inputs[strict ? 1 : 0] ??= new NamedInput(parameters, strict, zod);
-							},
-							invoke(remote, input, signal) {
-								const named = input;
-								const values = parameters.map((parameter) => named[parameter.wire]);
-								if (definition.cancellation !== void 0) values.push(signal);
-								const receiver = Reflect.get(remote, namespace);
-								return Reflect.get(receiver, method).apply(receiver, values);
-							}
-						});
-					}
-					descriptors.push(descriptor);
-				}
-				return this.index = {
-					descriptors,
-					methods
-				};
-			}
-		};
-		function optional(parameter) {
-			return parameter.source === "json" && parameter.acceptsUndefined === true;
-		}
-		var NamedInput = class {
-			parameters;
-			strict;
-			zod;
-			schema;
-			projection;
-			constructor(parameters, strict, zod) {
-				this.parameters = parameters;
-				this.strict = strict;
-				this.zod = zod;
-			}
-			codec(parameter) {
-				return this.strict ? parameter.strictCodec : parameter.codec;
-			}
-			create = () => this.schema ??= this.zod.strictObject(Object.fromEntries(this.parameters.map((parameter) => {
-				const value = this.codec(parameter).create();
-				return [parameter.wire, optional(parameter) ? value.optional() : value.nonoptional()];
-			})));
-			get jsonSchema() {
-				return this.project().jsonSchema;
-			}
-			get jsonSchemaError() {
-				return this.project().jsonSchemaError;
-			}
-			project() {
-				if (this.projection !== void 0) return this.projection;
-				const unavailable = this.parameters.find((parameter) => this.codec(parameter).jsonSchema === void 0);
-				if (unavailable !== void 0) return this.projection = { jsonSchemaError: this.codec(unavailable).jsonSchemaError ?? `No JSON Schema for parameter ${unavailable.wire}` };
-				return this.projection = { jsonSchema: {
-					type: "object",
-					properties: Object.fromEntries(this.parameters.map((parameter) => [parameter.wire, {
-						...this.codec(parameter).jsonSchema,
-						...parameter.description === void 0 ? {} : { description: parameter.description }
-					}])),
-					required: this.parameters.filter((parameter) => !optional(parameter)).map((parameter) => parameter.wire),
-					additionalProperties: false
-				} };
-			}
-		};
-		var ResultValue = class {
-			spec;
-			projection;
-			constructor(spec) {
-				this.spec = spec;
-			}
-			get mode() {
-				return this.spec.mode;
-			}
-			get typeSymbol() {
-				return this.spec.typeSymbol;
-			}
-			get create() {
-				return this.spec.create;
-			}
-			get decode() {
-				return this.spec.decode;
-			}
-			get encode() {
-				return this.spec.encode;
-			}
-			get description() {
-				return this.spec.description;
-			}
-			get jsonSchemaError() {
-				return this.spec.jsonSchemaError;
+		async function call(segment, init, signal) {
+			const url = new URL(`${PACKAGE}/api/${segment}`, document.baseURI);
+			if (init.query !== void 0) for (const [key, value] of Object.entries(init.query)) url.searchParams.set(key, value);
+			const request = {
+				method: init.method,
+				credentials: "same-origin",
+				cache: "no-store"
+			};
+			if (signal !== void 0) request.signal = signal;
+			if (init.method === "POST") {
+				request.headers = { "content-type": "application/json" };
+				request.body = JSON.stringify(init.body ?? {});
 			}
-			get jsonSchema() {
-				if (this.projection === void 0) {
-					const schema = this.spec.jsonSchema;
-					this.projection = { value: schema === void 0 ? void 0 : {
-						...schema,
-						description: this.spec.description
-					} };
-				}
-				return this.projection.value;
+			try {
+				const payload = await (await fetch(url, request)).json();
+				if (isCallResult(payload)) return payload;
+				return fail("unreachable", "response was not understood");
+			} catch (error) {
+				if (signal?.aborted === true) return fail("cancelled", "cancelled");
+				return fail("unreachable", error instanceof Error ? error.message : "request failed");
 			}
-		};
-		//#endregion
-		//#region lib/typert.remote-client.js
-		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;
-		const _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema = () => _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema$value ??= zod.z.object({ "status": zod.z.union([
-			zod.z.literal("revealed"),
-			zod.z.literal("not-handing-over"),
-			zod.z.literal("no-tab")
-		]) });
-		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: {
-						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": 684,
-					"column": 9
+		}
+		function fail(code, message) {
+			return {
+				ok: false,
+				error: {
+					code: `${PACKAGE}/${code}`,
+					message
 				}
-			} }
-		}, zod.z);
+			};
+		}
+		function isCallResult(value) {
+			if (typeof value !== "object" || value === null || !("ok" in value)) return false;
+			if (value.ok === true) return "value" in value;
+			if (value.ok !== false || !("error" in value)) return false;
+			const error = value.error;
+			if (typeof error !== "object" || error === null) return false;
+			return "code" in error && typeof error.code === "string" && "message" in error && typeof error.message === "string";
+		}
 		//#endregion
 		//#region src/client/card.ts
-		/** Host theme tokens only; the rules unmount with the row. */
-		const STYLE = `
+		/**
+		* Host theme tokens only; the rules unmount with the row.
+		* The button copies the host primary control at its default size, and the
+		* right-up outline that control uses for leaving the app. This row loads no
+		* host client package.
+		*/
+		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); }
-.mh-br-button { padding: 4px 10px; border: 0.5px solid var(--dsw-alias-border-l3); border-radius: var(--dsw-radius-md); background: transparent; color: var(--dsw-alias-label-primary); font: inherit; cursor: pointer; }
+.mh-br-button { box-sizing: border-box; display: inline-flex; align-items: center; justify-content: center; gap: 4px; height: 36px; padding: 0 14px; border: none; border-radius: var(--dsw-radius-md); background: var(--dsw-alias-button-primary-fill); color: var(--dsw-alias-label-primary-foreground); font-size: 14px; line-height: 22px; cursor: pointer; }
+@media (hover: hover) { .mh-br-button:hover { background: var(--dsw-alias-button-primary-hover); } }
+.mh-br-icon { display: inline-flex; width: 16px; height: 16px; align-items: center; justify-content: center; }
 `;
-		/** The open handover: the reason and the button that raises its window. */
+		/** Corner of the host right-up outline, 16px viewBox, 1px stroke. */
+		const RIGHT_UP_CORNER = "M11.7256 2.77441C12.5538 2.77469 13.2256 3.44616 13.2256 4.27441V10.1416H12.2256V4.27441C12.2256 3.99844 12.0015 3.77469 11.7256 3.77441H5.7207V2.77441H11.7256Z";
+		/** Stem of the host right-up outline. */
+		const RIGHT_UP_STEM = "M2.77441 13.2255L12.3756 3.62427";
+		function revealIcon() {
+			return (0, react.createElement)("span", { className: "mh-br-icon" }, (0, react.createElement)("svg", {
+				width: 14,
+				height: 14,
+				viewBox: "0 0 16 16",
+				fill: "none",
+				strokeWidth: 1,
+				"aria-hidden": true
+			}, (0, react.createElement)("path", {
+				d: RIGHT_UP_CORNER,
+				fill: "currentColor"
+			}), (0, react.createElement)("path", {
+				d: RIGHT_UP_STEM,
+				stroke: "currentColor"
+			})));
+		}
+		/** The open handover: a short line 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")), (0, react.createElement)("button", {
 				type: "button",
 				className: "mh-br-button",
 				onClick: () => {
@@ -243,7 +99,7 @@ window.__ModuleLoader__.load({
 						setNote(props.t("failed"));
 					});
 				}
-			}, props.t("reveal")), note !== void 0 ? (0, react.createElement)("p", { className: "mh-br-status" }, note) : null);
+			}, revealIcon(), props.t("reveal")), note !== void 0 ? (0, react.createElement)("p", { className: "mh-br-status" }, note) : null);
 		}
 		/** `revealed` adds no status line. */
 		function noteFor(result, t) {
@@ -256,18 +112,70 @@ window.__ModuleLoader__.load({
 		/** Dictionary namespace for the handover row. */
 		const NS = "mh-browser";
 		const zh = {
-			waiting: "浏览器交给你了：{reason}",
-			reveal: "去浏览器",
+			waiting: "这一步要你在浏览器里做",
+			reveal: "打开浏览器里的页面",
 			notHandingOver: "这次交接已经结束",
 			noTab: "没有可以去的页面",
-			failed: "没能切到浏览器"
+			failed: "没能切到浏览器",
+			browserLabel: "浏览器",
+			browserHint: "保存后，浏览器空闲时会关掉再按这个选择打开。已经打开的标签页会关掉。",
+			pathLabel: "浏览器路径",
+			pathHint: "留空就用自动找到的。可以填绝对路径，也可以用 ~。保存后同样在空闲时重启。",
+			pathInvalid: "需要绝对路径，或以 ~ 开头",
+			pathSearching: "正在查找…",
+			pathMissing: "未找到{name}，请填写路径",
+			pathHelp: "说明",
+			pathDoesNotExist: "不存在",
+			pathIsDirectory: "是目录",
+			pathDenied: "没有权限（{code}）",
+			auto: "自动",
+			browserUsing: "当前使用：{name}。",
+			browserNone: "没有找到 Chrome 或 Edge。",
+			installChrome: "安装 Chrome",
+			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",
+			waiting: "This step needs you in the browser",
+			reveal: "Open the page in 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})",
+			auto: "Automatic",
+			browserUsing: "In use: {name}.",
+			browserNone: "Chrome and Edge were not found.",
+			installChrome: "Install Chrome",
+			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,43 +186,33 @@ window.__ModuleLoader__.load({
 		*/
 		const HANDOVER_KIND = "browser-handover";
 		const HANDOVER_TOOL = "browser_handover";
-		function isRecord(value) {
+		const ROW_DATA = {};
+		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 "";
-				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,
-				arguments: data.arguments
+				name: data.name
 			};
 		}
 		/** 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) {
 			return {
 				...current,
 				visibility: "hidden",
-				data: { reason: "" }
+				data: ROW_DATA
 			};
 		}
 		/**
@@ -335,7 +233,7 @@ window.__ModuleLoader__.load({
 				location: context.start?.location ?? { kind: "unresolved" },
 				visibility: open === void 0 ? "hidden" : "visible",
 				groupTree: "turn",
-				data: { reason: open?.reason ?? "" }
+				data: ROW_DATA
 			};
 		}
 		const handoverRowDefinition = {
@@ -373,7 +271,6 @@ window.__ModuleLoader__.load({
 					return {
 						open: {
 							callId: call.callId,
-							reason: reasonOf(call.arguments),
 							seq: event.seq
 						},
 						anchorSeq: event.seq
@@ -394,51 +291,699 @@ 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); }
+.mh-browser-hint a { color: var(--dsw-alias-label-secondary); }
+@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 = [
+			"auto",
+			"chrome",
+			"msedge",
+			"chromium"
+		];
+		/** Google's download page. Edge is not offered: its developer-mode prompt can disable the agent extension. */
+		const CHROME_INSTALL = "https://www.google.com/chrome/";
+		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" && browser !== "auto") return t("pathMissing", { name: t(browser) });
+		}
+		/** The sentence under the browser menu: which browser automatic selection is using. */
+		function browserStatus(lookup, browser, t) {
+			const restart = t("browserHint");
+			if (browser !== "auto") return restart;
+			if (lookup.status === "found" && lookup.browser !== void 0) return `${t("browserUsing", { name: t(lookup.browser) })} ${restart}`;
+			if (lookup.status === "missing") return `${t("browserNone")} ${restart}`;
+			return restart;
+		}
+		/** 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) => call("locate-for", {
+				method: "POST",
+				body: { 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, browser, props.t);
+			const placeholder = state.executablePath.text === "" ? pathPlaceholder(lookup, browser, props.t) : void 0;
+			const offerChrome = browser === "auto" && lookup.status === "missing";
+			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: browserStatus(lookup, browser, props.t),
+				...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")
+			}), offerChrome ? (0, react.createElement)("p", { className: "mh-browser-hint" }, (0, react.createElement)("a", {
+				href: CHROME_INSTALL,
+				target: "_blank",
+				rel: "noopener noreferrer"
+			}, props.t("installChrome"))) : null, (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 : "auto",
+				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 : "auto";
+		}
+		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,
+				...result.value.browser !== void 0 ? { browser: result.value.browser } : {}
+			};
+			return {
+				status: "missing",
+				tried: result.value.missing
+			};
+		}
+		function helpOf(lookup, browser, t) {
+			const text = pathHelpText(lookup, t);
+			if (text === void 0) return void 0;
+			if (browser === "auto" && lookup.status === "missing") return {
+				label: t("pathHelp"),
+				content: (0, react.createElement)("span", null, text, " ", (0, react.createElement)("a", {
+					href: CHROME_INSTALL,
+					target: "_blank",
+					rel: "noopener noreferrer"
+				}, t("installChrome")))
+			};
+			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
-		* order, not this list. `remote.mhBrowser` is absent until `$mount`.
+		* order, not this list.
 		*/
 		const inject = [
 			"slots",
 			"locale",
-			"remote",
-			"uiConversation"
+			"uiConversation",
+			"configForms"
 		];
-		const namespaceInject = [...inject, "remote.mhBrowser"];
+		/** Host calls used by the handover row and the settings lookup. */
+		function browserApi() {
+			return {
+				revealHandover: (sessionId, signal) => call("reveal-handover", {
+					method: "POST",
+					body: { sessionId }
+				}, signal),
+				locateFor: (browser, signal) => call("locate-for", {
+					method: "POST",
+					body: { browser }
+				}, signal)
+			};
+		}
 		async function apply(ctx) {
-			const unmount = await ctx.remote.$mount(TYPERT_REMOTE);
 			let release = () => void 0;
-			await ctx.inject(namespaceInject, (inner) => {
+			await ctx.inject([...inject], (inner) => {
 				release = start(inner);
+				registerSettings(inner);
 			});
 			return async () => {
 				release();
-				await unmount();
 			};
 		}
 		/** Register the handover row. The tool call itself keeps the generic tool row. */
-		function start(ctx) {
+		function start(ctx, api = browserApi()) {
 			ctx.effect(() => ctx.locale.register(NS, {
 				zh,
 				en
 			}));
 			ctx.effect(() => ctx.uiConversation.events.register(handoverRowDefinition));
-			const remote = ctx.remote.mhBrowser;
 			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
 				name: "conversation.chat.node",
 				key: HANDOVER_KIND,
 				locale: NS
 			}, (props) => (0, react.createElement)(HandoverRow, {
 				sessionId: props.sessionId,
-				reason: props.node.data.reason,
 				t: props.t,
-				reveal: (sessionId, signal) => remote.revealHandover(sessionId, signal)
+				reveal: (sessionId, signal) => api.revealHandover(sessionId, signal)
 			})));
 			return () => void 0;
 		}
 		//#endregion
 		exports.apply = apply;
+		exports.browserApi = browserApi;
 		exports.inject = inject;
 		exports.start = start;
 		return module.exports;