@mind-harness/mh-browser 0.2.5 → 0.2.6

package/lib/typert.host.js

@@ -3,18 +3,62 @@ import { z } from 'zod'
 
 import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
 
+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 ??= z.union([z.literal("chrome"), z.literal("msedge"), 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 ??= z.union([z.object({
+  'found': z.string(),
+}), z.object({
+  'missing': z.array(z.object({
+  'path': z.string(),
+  'reason': 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 ??= 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 ??= z.object({
   'status': z.union([z.literal("revealed"), z.literal("not-handing-over"), 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 ??= z.union([z.literal("chrome"), z.literal("msedge"), 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 ??= z.string())
 
 const $remote = createTypertRemoteInfo({
   package: '@mind-harness/mh-browser',
   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/location#BrowserLocation',
+        create: _mind_harness_mh_browser_mhBrowser_locateFor_result$schema,
+        jsonSchemaError: 'typert tool schema: selected union branches overlap or have no required discriminator',
+      },
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":474,"column":9},
+    },
     'mhBrowser/revealHandover': {
       service: 'mhBrowser',
       description: 'The person asked to see the page this Session handed over.',
@@ -44,7 +88,7 @@ const $remote = createTypertRemoteInfo({
         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},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":734,"column":9},
     },
   },
 }, z)
@@ -172,6 +216,13 @@ export const TYPERT = {
             "name": "[testHooks]",
             "signature": "[testHooks](): TestHooks"
           },
+          {
+            "kind": "method",
+            "name": "locateFor",
+            "signature": "@Remote async locateFor(browser: BrowserName, signal?: AbortSignal): Promise<BrowserLocation>",
+            "summary": "Where `browser` would be launched from when no path is configured.",
+            "jsDoc": "/**\n * Where `browser` would be launched from when no path is configured.\n * The configured path is not consulted: the answer is what an empty path uses.\n */"
+          },
           {
             "kind": "method",
             "name": "act",
@@ -265,7 +316,7 @@ export const TYPERT = {
             "name": "takePersonHandback",
             "signature": "takePersonHandback(owner: string): HandBack | undefined",
             "summary": "The person took over between turns.",
-            "jsDoc": "/**\n * The person took over between turns. The next message they send is the\n * hand-back. A handover that is still waiting on its card is not.\n */"
+            "jsDoc": "/**\n * The person took over between turns. The next message they send is the\n * hand-back. A handover that is still waiting on its card is not.\n * The addresses are read before a waiting restart closes the pages.\n */"
           }
         ],
         "types": [
@@ -273,6 +324,18 @@ export const TYPERT = {
             "name": "ActionResponse",
             "declaration": "export interface ActionResponse {\n    name: string;\n    status?: number;\n    location?: string;\n    mediaType?: string;\n    body?: string;\n    bytes?: number;\n    lost?: boolean;\n}"
           },
+          {
+            "name": "BrowserLocation",
+            "declaration": "export type BrowserLocation = { found: string; } | { missing: BrowserLocationMiss[]; };"
+          },
+          {
+            "name": "BrowserLocationMiss",
+            "declaration": "export interface BrowserLocationMiss {\n    path: string;\n    reason: string;\n}"
+          },
+          {
+            "name": "BrowserName",
+            "declaration": "export type BrowserName = 'chrome' | 'msedge' | 'chromium';"
+          },
           {
             "name": "Dialog",
             "declaration": "export interface Dialog {\n    type: string;\n    message: string;\n}"
@@ -293,6 +356,10 @@ export const TYPERT = {
             "name": "HeldPage",
             "declaration": "export interface HeldPage {\n    url: string;\n    source: PresenceSource;\n    state: 'committed' | 'pending';\n    order: number;\n    seen?: { version?: string; digest: string; observedAt: string; id?: string; } | { absent: string; };\n    title?: string;\n    representation?: 'agent-view' | 'snapshot';\n    body?: string;\n    agentViewError?: string;\n    fragment?: string;\n    requires?: string[];\n    viewUrl?: string;\n}"
           },
+          {
+            "name": "InstalledBrowser",
+            "declaration": "export type InstalledBrowser = Exclude<BrowserName, 'chromium'>;"
+          },
           {
             "name": "InvokeCall",
             "declaration": "export interface InvokeCall {\n    name: string;\n    item?: string;\n    input?: Record<string, unknown>;\n    shown: { url: string; text: string; };\n}"
@@ -301,6 +368,10 @@ export const TYPERT = {
             "name": "InvokeSent",
             "declaration": "export interface InvokeSent {\n    schemaRejected: boolean;\n    response?: ActionResponse;\n    page: PageView | PageError;\n}"
           },
+          {
+            "name": "LocateEnv",
+            "declaration": "export interface LocateEnv {\n    platform: NodeJS.Platform;\n    env: NodeJS.ProcessEnv;\n    home: string;\n    access(path: string): PathAccess;\n    discover(browser: InstalledBrowser, signal?: AbortSignal): Promise<string[]>;\n}"
+          },
           {
             "name": "Modifier",
             "declaration": "export type Modifier = 'Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift';"
@@ -317,6 +388,10 @@ export const TYPERT = {
             "name": "PageView",
             "declaration": "export interface PageView {\n    tab?: TabId;\n    url: string;\n    title: string;\n    observedAt: string;\n    representation: { kind: 'agent-view'; text: string; version?: string; href?: string; } | { kind: 'snapshot'; text: string; agentViewError?: string; agentView?: { version?: string; }; };\n    fragment?: string;\n    status?: number;\n    mediaType?: string;\n    body?: string;\n    inPresence: boolean;\n    headerOnly?: boolean;\n    dialog?: Dialog;\n    incomplete?: { load: boolean; pendingRequests: number; };\n    waited?: { met: 'text' | 'textGone' | 'time' | false; seconds: number; };\n    download?: Download;\n    summary?: string;\n    detail?: string;\n    writes?: { method: string; origin: string; fromCall: boolean; count: number; }[];\n    shot?: { mediaType: 'image/png' | 'image/jpeg' | 'image/webp'; bytes: Uint8Array; };\n}"
           },
+          {
+            "name": "PathAccess",
+            "declaration": "export type PathAccess = 'ok' | { code: string; };"
+          },
           {
             "name": "PendingOp",
             "declaration": "export interface PendingOp {\n    op: 'put' | 'remove';\n    url: string;\n}"
@@ -359,7 +434,7 @@ export const TYPERT = {
           },
           {
             "name": "TestHooks",
-            "declaration": "export interface TestHooks {\n    crash(): Promise<void>;\n    page(owner: string, tab: string): unknown;\n    running(): boolean;\n    pages(): unknown[];\n    pid(): number | undefined;\n}"
+            "declaration": "export interface TestHooks {\n    crash(): Promise<void>;\n    page(owner: string, tab: string): unknown;\n    running(): boolean;\n    pages(): unknown[];\n    pid(): number | undefined;\n    useLocator(env: LocateEnv | undefined): void;\n}"
           },
           {
             "name": "WaitFor",
@@ -372,7 +447,16 @@ export const TYPERT = {
         ]
       }
     ],
-    "events": [],
+    "events": [
+      {
+        "description": "Volatile config was committed on this plugin fiber. Paths are key arrays.",
+        "summary": "Volatile config was committed on this plugin fiber.",
+        "tags": [],
+        "jsDoc": "/** Volatile config was committed on this plugin fiber. Paths are key arrays. */",
+        "name": "loader/volatile-update",
+        "signature": "'loader/volatile-update'(paths: readonly (readonly string[])[]): void"
+      }
+    ],
     "objects": []
   },
 }

package/lib/typert.remote-client.d.ts

@@ -4,12 +4,15 @@ import type {
   TypertRemoteInfo,
   TypertRemoteMethod,
 } from '@deepseek-ai/dsh-typert-protocol'
+import type { BrowserLocation, BrowserName } from '@mind-harness/mh-browser/location'
 
 declare module '@deepseek-ai/dsh-typert-protocol' {
   interface TypertRemoteNamespace$6d6842726f77736572 {
+    locateFor: (browser: BrowserName, signal?: AbortSignal) => Promise<RemoteResult<BrowserLocation>>
     revealHandover: (sessionId: string, signal?: AbortSignal) => Promise<RemoteResult<{ status: 'revealed' | 'not-handing-over' | 'no-tab'; }>>
   }
   interface TypertRemoteMap {
+    'mhBrowser/locateFor': (browser: BrowserName, signal?: AbortSignal) => Promise<RemoteResult<BrowserLocation>>
     'mhBrowser/revealHandover': (sessionId: string, signal?: AbortSignal) => Promise<RemoteResult<{ status: 'revealed' | 'not-handing-over' | 'no-tab'; }>>
   }
   interface TypertRemoteNamespaceMap {
@@ -18,6 +21,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
 }
 
 export declare const TYPERT_REMOTE: TypertRemoteInfo<{
+  readonly 'mhBrowser/locateFor': TypertRemoteMethod<{ readonly 'browser': BrowserName }, BrowserLocation>
   readonly 'mhBrowser/revealHandover': TypertRemoteMethod<{ readonly 'sessionId': string }, { status: 'revealed' | 'not-handing-over' | 'no-tab'; }>
 }>
 export default TYPERT_REMOTE

package/lib/typert.remote-client.js

@@ -3,18 +3,62 @@ import { z } from 'zod'
 
 import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
 
+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 ??= z.union([z.literal("chrome"), z.literal("msedge"), 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 ??= z.union([z.object({
+  'found': z.string(),
+}), z.object({
+  'missing': z.array(z.object({
+  'path': z.string(),
+  'reason': 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 ??= 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 ??= z.object({
   'status': z.union([z.literal("revealed"), z.literal("not-handing-over"), 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 ??= z.union([z.literal("chrome"), z.literal("msedge"), 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 ??= z.string())
 
 export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@mind-harness/mh-browser',
   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/location#BrowserLocation',
+        create: _mind_harness_mh_browser_mhBrowser_locateFor_result$schema,
+        jsonSchemaError: 'typert tool schema: selected union branches overlap or have no required discriminator',
+      },
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":474,"column":9},
+    },
     'mhBrowser/revealHandover': {
       service: 'mhBrowser',
       description: 'The person asked to see the page this Session handed over.',
@@ -44,7 +88,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         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},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":734,"column":9},
     },
   },
 }, z)

package/lib/types/client.d.ts

@@ -2,13 +2,16 @@ import { type ReactElement } from 'react';
 import { type RevealResult } from './card.ts';
 import { type Translate } from './locales.ts';
 import { handoverRowDefinition } from './row.ts';
+import type { SettingsFormScope } from './settings-form.ts';
+import { type LocateFor } from './settings.ts';
 /**
  * Cordis services this client reads. `dsh.client.inject` is package load
  * order, not this list. `remote.mhBrowser` is absent until `$mount`.
  */
-export declare const inject: readonly ["slots", "locale", "remote", "uiConversation"];
+export declare const inject: readonly ["slots", "locale", "remote", "uiConversation", "configForms"];
 export interface MhBrowserRemote {
     revealHandover(sessionId: string, signal?: AbortSignal): Promise<RevealResult>;
+    locateFor: LocateFor;
 }
 interface RemoteCarrier {
     $mount(contribution: object): Promise<() => Promise<void>>;
@@ -31,10 +34,21 @@ export interface ClientHost {
             key: string;
             locale: string;
         }, component: (props: HostRowProps) => ReactElement): () => void;
+        register(options: {
+            name: string;
+            key: string;
+            locale: string;
+        }, component: (props: {
+            t: Translate;
+            view?: 'summary' | 'page';
+        }) => ReactElement | null): () => void;
     };
     locale: {
         register(ns: string, dicts: Record<'zh' | 'en', Record<string, string>>): () => void;
     };
+    configForms: {
+        get<T>(entryId: string): SettingsFormScope<T>;
+    };
     uiConversation: {
         events: {
             register(definition: typeof handoverRowDefinition): () => void;

package/lib/types/config.d.ts

@@ -1,14 +1,27 @@
 import z from '@deepseek-ai/schemastery';
-import type { BrowserName } from './types.ts';
-export interface BrowserConfig {
-    presence: {
-        maxBytes: number;
-    };
-    browser: BrowserName;
-    profileDir?: string;
-    headless: boolean;
-}
-export declare const browserConfig: z<BrowserConfig>;
+export declare const browserConfig: z<Schemastery.ObjectS<NoInfer<{
+    presence: z<Schemastery.ObjectS<NoInfer<{
+        maxBytes: z<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxBytes: z<number, number, "defined">;
+    }>>, "defined">;
+    browser: z<"chrome" | "msedge" | "chromium", "chrome" | "msedge" | "chromium", "volatile-defined">;
+    executablePath: z<string, string, "volatile">;
+    profileDir: z<string, string, "plain">;
+    headless: z<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    presence: z<Schemastery.ObjectS<NoInfer<{
+        maxBytes: z<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxBytes: z<number, number, "defined">;
+    }>>, "defined">;
+    browser: z<"chrome" | "msedge" | "chromium", "chrome" | "msedge" | "chromium", "volatile-defined">;
+    executablePath: z<string, string, "volatile">;
+    profileDir: z<string, string, "plain">;
+    headless: z<boolean, boolean, "defined">;
+}>>, "plain">;
+/** What {@link browserConfig} returns. `browser` and `executablePath` are read with `get()`. */
+export type BrowserConfig = ReturnType<typeof browserConfig>;
 /**
  * Browser profile directory when the configuration names none. Each dsh profile gets its own:
  * a browser profile directory admits one running browser, so two dsh profiles sharing one

package/lib/types/index.d.ts

@@ -1,11 +1,32 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { BrowserConfig } from './config.ts';
+import { browserConfig } from './config.ts';
 import { MhBrowserService } from './service/service.ts';
 export declare const name = "mh-browser";
 export declare const inject: string[];
 export type Config = BrowserConfig;
-export declare const Config: import("@deepseek-ai/schemastery").default<BrowserConfig>;
-export declare function apply(ctx: Context, config: Config): Promise<void>;
+export declare const Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+    presence: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+        maxBytes: import("@deepseek-ai/schemastery").default<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxBytes: import("@deepseek-ai/schemastery").default<number, number, "defined">;
+    }>>, "defined">;
+    browser: import("@deepseek-ai/schemastery").default<"chrome" | "msedge" | "chromium", "chrome" | "msedge" | "chromium", "volatile-defined">;
+    executablePath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+    profileDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+    headless: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    presence: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+        maxBytes: import("@deepseek-ai/schemastery").default<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxBytes: import("@deepseek-ai/schemastery").default<number, number, "defined">;
+    }>>, "defined">;
+    browser: import("@deepseek-ai/schemastery").default<"chrome" | "msedge" | "chromium", "chrome" | "msedge" | "chromium", "volatile-defined">;
+    executablePath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+    profileDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+    headless: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
+}>>, "plain">;
+export declare function apply(ctx: Context, config: Config | NonNullable<Parameters<typeof browserConfig>[0]>): Promise<void>;
 export { MhBrowserService };
 export { readAgentView } from './representation/agent-view.ts';
 export type { AgentViewDoc, AgentViewLink, AgentViewRead } from './representation/agent-view.ts';

package/lib/types/locales.d.ts

@@ -6,6 +6,28 @@ export declare const zh: {
     readonly notHandingOver: "这次交接已经结束";
     readonly noTab: "没有可以去的页面";
     readonly failed: "没能切到浏览器";
+    readonly browserLabel: "浏览器";
+    readonly browserHint: "保存后，浏览器空闲时会关掉再按这个选择打开。已经打开的标签页会关掉。";
+    readonly pathLabel: "浏览器路径";
+    readonly pathHint: "留空就用自动找到的。可以填绝对路径，也可以用 ~。保存后同样在空闲时重启。";
+    readonly pathInvalid: "需要绝对路径，或以 ~ 开头";
+    readonly pathSearching: "正在查找…";
+    readonly pathMissing: "未找到{name}，请填写路径";
+    readonly pathHelp: "说明";
+    readonly pathDoesNotExist: "不存在";
+    readonly pathIsDirectory: "是目录";
+    readonly pathDenied: "没有权限（{code}）";
+    readonly chrome: "Google Chrome";
+    readonly msedge: "Microsoft Edge";
+    readonly chromium: "Chromium";
+    readonly overridden: "已覆盖";
+    readonly reset: "恢复";
+    readonly save: "保存";
+    readonly saving: "保存中";
+    readonly settingsUnavailable: "这个配置现在不可用";
+    readonly settingsReadOnly: "这次启动的配置不能在页面上改";
+    readonly settingsSaveFailed: "没有保存：设置可能在别处改过，或这个值不被接受。修改还在，检查后可以再保存";
+    readonly discard: "放弃修改";
 };
 export type CardKey = keyof typeof zh;
 export declare const en: Record<CardKey, string>;

package/lib/types/location.d.ts

@@ -0,0 +1,12 @@
+/** Where a browser name resolves when no path is configured. */
+export type { BrowserName } from './types.ts';
+export interface BrowserLocationMiss {
+    path: string;
+    reason: string;
+}
+export type BrowserLocation = {
+    found: string;
+} | {
+    missing: BrowserLocationMiss[];
+};
+//# sourceMappingURL=location.d.ts.map

package/lib/types/location.js

@@ -0,0 +1,3 @@
+/** Where a browser name resolves when no path is configured. */
+export {};
+//# sourceMappingURL=location.js.map

package/lib/types/service/browser.d.ts

@@ -1,10 +1,12 @@
 import type { BrowserContext } from 'playwright';
+import type { BrowserLocation } from '../location.ts';
 import type { BrowserName } from '../types.ts';
+import { type LocateEnv } from './locate.ts';
 export interface LaunchOptions {
     browser: BrowserName;
     headless: boolean;
     profileDir: string;
-    /** Test hook: point at a missing executable to exercise the not-found message. */
+    /** Absolute path of the browser to launch. `~` is already expanded. */
     executablePath?: string;
 }
 /**
@@ -15,11 +17,15 @@ export interface LaunchOptions {
  */
 export declare function chromiumSandboxEnabled(browser: BrowserName, platform?: NodeJS.Platform): boolean;
 /**
- * One persistent context for the whole process. `chromium` omits `channel`
- * so Playwright uses its own browser; the others use a local install.
- * A missing browser is reported and not downloaded.
+ * One persistent context for the whole process. An installed browser is located
+ * here and passed as `executablePath`; `channel` names which install that was.
+ * `chromium` omits `channel` so Playwright uses its own browser unless a path
+ * is configured. A missing browser is reported and not downloaded. A launch
+ * that fails after the executable was found is reported as Playwright said.
  */
-export declare function launchBrowser(options: LaunchOptions): Promise<BrowserContext>;
+export declare function launchBrowser(options: LaunchOptions, env?: LocateEnv): Promise<BrowserContext>;
+/** Playwright's own Chromium, or why that file cannot be run. */
+export declare function bundledChromiumLocation(access: LocateEnv['access']): BrowserLocation;
 /**
  * Process id of the browser's main process. Playwright gives none for a
  * persistent context. Asks the browser first; on POSIX the profile's

package/lib/types/service/control.d.ts

@@ -13,6 +13,11 @@ export declare class Control {
     private readonly tabs;
     private readonly since;
     private readonly named;
+    /**
+     * A handover is waiting, or the person holds a tab. The browser is not
+     * restarted out from under either.
+     */
+    busy(): boolean;
     /** Whether the person holds any tab, or a handover is waiting. */
     of(owner: string): 'model' | 'person';
     /** The person holds this tab until they hand it back. */

package/lib/types/service/locate.d.ts

@@ -0,0 +1,65 @@
+import type { BrowserLocation, BrowserLocationMiss } from '../location.ts';
+import type { BrowserName } from '../types.ts';
+/** A browser the person installs. Playwright's Chromium is not located this way. */
+export type InstalledBrowser = Exclude<BrowserName, 'chromium'>;
+/** `ok`, or the errno from checking that the file can be executed. */
+export type PathAccess = 'ok' | {
+    code: string;
+};
+/**
+ * Everything location reads from the machine. Tests pass a stand-in, so a
+ * case does not depend on what that machine has installed.
+ */
+export interface LocateEnv {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    home: string;
+    /** Whether `path` can be executed. */
+    access(path: string): PathAccess;
+    /**
+     * Paths from the platform's own lookup, already resolved. Called only after
+     * every fixed candidate missed. An empty list means the lookup found nothing
+     * or did not run.
+     */
+    discover(browser: InstalledBrowser, signal?: AbortSignal): Promise<string[]>;
+}
+/** The fixed paths checked for `browser` on `env`, in the order they are tried. */
+export declare function candidatePaths(browser: InstalledBrowser, env: LocateEnv): string[];
+/**
+ * `configured` is used as given: a path that cannot be run is a failure, and
+ * nothing else is searched. `~` expands to `env.home`.
+ */
+export declare function checkConfigured(configured: string, env: LocateEnv): {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    path: string;
+    code: string;
+};
+/** Failure for a path the configuration names. */
+export declare function configuredPathError(path: string, code: string): Error;
+/** Failure listing every path that was tried. */
+export declare function browserNotFoundError(browser: InstalledBrowser, missing: BrowserLocationMiss[]): Error;
+/**
+ * The path to launch. A configured path is checked and never replaced.
+ * `chromium` without one returns undefined, so Playwright uses its own build.
+ * An installed browser that cannot be found throws.
+ */
+export declare function resolveExecutable(browser: BrowserName, configured: string | undefined, env: LocateEnv, signal?: AbortSignal): Promise<string | undefined>;
+/**
+ * Where `browser` is installed when the configuration names no path.
+ * Fixed candidates first, then `env.discover`.
+ */
+export declare function locateInstalled(browser: InstalledBrowser, env: LocateEnv, signal?: AbortSignal): Promise<BrowserLocation>;
+/** `path` is Playwright's Chromium. Missing or not executable is `missing`. */
+export declare function locateBundled(path: string, access: LocateEnv['access']): BrowserLocation;
+/** This machine: fixed paths, then Spotlight, App Paths, or `PATH`. */
+export declare function hostLocateEnv(): LocateEnv;
+/** A `.app` bundle path reported by Spotlight, turned into its executable. */
+export declare function executableInApp(reported: string, binary: string): string | undefined;
+/** The default value from `reg query ... /ve` output. */
+export declare function regValue(stdout: string): string | undefined;
+/** Text for an errno from {@link LocateEnv.access}. */
+export declare function reasonForCode(code: string): string;
+//# sourceMappingURL=locate.d.ts.map

package/lib/types/service/service.d.ts

@@ -1,15 +1,20 @@
 import { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { BrowserConfig } from '../config.ts';
+import type { BrowserLocation } from '../location.ts';
 import type { HeldPage, PresenceReceipt, PresenceRecord, PresenceSource } from '../presence/record.ts';
 import type { PendingOp } from '../presence/fold.ts';
-import type { Download, FetchResponseBody, InvokeCall, InvokeSent, PageError, PageOp, PageView, TabInfo, WaitFor } from '../types.ts';
+import type { BrowserName, Download, FetchResponseBody, InvokeCall, InvokeSent, PageError, PageOp, PageView, TabInfo, WaitFor } from '../types.ts';
 import { type Taken } from './control.ts';
 import { testHooks, type TestHooks } from './test-hooks.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         mhBrowser: MhBrowserService;
     }
+    interface Events {
+        /** Volatile config was committed on this plugin fiber. Paths are key arrays. */
+        'loader/volatile-update'(paths: readonly (readonly string[])[]): void;
+    }
 }
 export type WriteTarget = {
     root: string;
@@ -30,13 +35,23 @@ export interface HandBack extends Taken {
  * also has an Agent View.
  */
 export declare class MhBrowserService extends TypertRemoteService {
-    static Config: import("@deepseek-ai/schemastery").default<BrowserConfig>;
     private readonly windows;
-    private readonly launchOptions;
+    private readonly headless;
+    private readonly profileDir;
+    private readonly browserName;
+    private readonly executablePath;
+    /** Tests replace the machine lookup. Unset uses this machine. */
+    private locator;
     private context;
     private readonly pids;
     private ready;
     private closing;
+    /** A browser restart was requested and has not run yet. */
+    private relaunchWanted;
+    /** Counts browser and path changes. A start that sampled the latest one clears the restart. */
+    private configEpoch;
+    /** The running browser is being closed so the new configuration can start. */
+    private replacing;
     /** The browser is not running. The next call that needs a page starts it. */
     private exited;
     private readonly exits;
@@ -112,6 +127,11 @@ export declare class MhBrowserService extends TypertRemoteService {
     /** The person asked for the browser: start it if it exited, past the exit limit. */
     startForPerson(): Promise<void>;
     [testHooks](): TestHooks;
+    /**
+     * 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.
+     */
+    locateFor(browser: BrowserName, signal?: AbortSignal): Promise<BrowserLocation>;
     act(owner: string, tab: string, op: PageOp, signal?: AbortSignal): Promise<PageView>;
     holdHandover(owner: string, tab: string): void;
     releaseHandover(owner: string): void;
@@ -152,6 +172,7 @@ export declare class MhBrowserService extends TypertRemoteService {
     /**
      * The person took over between turns. The next message they send is the
      * hand-back. A handover that is still waiting on its card is not.
+     * The addresses are read before a waiting restart closes the pages.
      */
     takePersonHandback(owner: string): HandBack | undefined;
     /**
@@ -243,5 +264,15 @@ export declare class MhBrowserService extends TypertRemoteService {
     private presenceUrls;
     private snapshotNamed;
     private exclusive;
+    private launchChoice;
+    private locateEnv;
+    private idle;
+    /**
+     * Close and start again when a configuration change is waiting and nothing
+     * is using the browser. A browser that is not running keeps the new values
+     * for the next start. The close is not counted as a crash.
+     */
+    private relaunchIfIdle;
+    private replaceBrowser;
 }
 //# sourceMappingURL=service.d.ts.map

package/lib/types/service/test-hooks.d.ts

@@ -1,3 +1,4 @@
+import type { LocateEnv } from './locate.ts';
 /** Key of the hooks tests use to crash the browser and reach a live page. Not exported by the package. */
 export declare const testHooks: unique symbol;
 export interface TestHooks {
@@ -9,5 +10,7 @@ export interface TestHooks {
     pages(): unknown[];
     /** The main browser process id recorded at start. */
     pid(): number | undefined;
+    /** Use this lookup instead of the machine's. `undefined` restores the machine. */
+    useLocator(env: LocateEnv | undefined): void;
 }
 //# sourceMappingURL=test-hooks.d.ts.map