@mind-harness/mh-browser 0.2.3 → 0.2.5

package/lib/typert.host.js

@@ -44,7 +44,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":624,"column":9},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":684,"column":9},
     },
   },
 }, z)

package/lib/typert.remote-client.js

@@ -44,7 +44,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":624,"column":9},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":684,"column":9},
     },
   },
 }, z)

package/lib/types/card.d.ts

@@ -0,0 +1,24 @@
+import { type ReactElement } from 'react';
+import { type Translate } from './locales.ts';
+export type RevealStatus = 'revealed' | 'not-handing-over' | 'no-tab';
+export type RevealResult = {
+    ok: true;
+    value: {
+        status: RevealStatus;
+    };
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface HandoverRowProps {
+    sessionId: string;
+    reason: string;
+    t: Translate;
+    reveal: (sessionId: string, signal: AbortSignal) => Promise<RevealResult>;
+}
+/** The open handover: the reason and the button that raises its window. */
+export declare function HandoverRow(props: HandoverRowProps): ReactElement;
+//# sourceMappingURL=card.d.ts.map

package/lib/types/client.d.ts

@@ -0,0 +1,53 @@
+import { type ReactElement } from 'react';
+import { type RevealResult } from './card.ts';
+import { type Translate } from './locales.ts';
+import { handoverRowDefinition } from './row.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 interface MhBrowserRemote {
+    revealHandover(sessionId: string, signal?: AbortSignal): Promise<RevealResult>;
+}
+interface RemoteCarrier {
+    $mount(contribution: object): Promise<() => Promise<void>>;
+}
+/** Props the session-scoped chat-node seat passes in. The session id is that seat's. */
+export interface HostRowProps {
+    sessionId: string;
+    node: {
+        readonly data: {
+            readonly reason: string;
+        };
+    };
+    t: Translate;
+}
+export interface ClientHost {
+    slots: {
+        inject(name: string, register: () => unknown): unknown;
+        register(options: {
+            name: string;
+            key: string;
+            locale: string;
+        }, component: (props: HostRowProps) => ReactElement): () => void;
+    };
+    locale: {
+        register(ns: string, dicts: Record<'zh' | 'en', Record<string, string>>): () => void;
+    };
+    uiConversation: {
+        events: {
+            register(definition: typeof handoverRowDefinition): () => void;
+        };
+    };
+    effect(execute: () => () => void): unknown;
+    remote: RemoteCarrier & {
+        mhBrowser: MhBrowserRemote;
+    };
+    inject(names: readonly string[], apply: (ctx: ClientHost) => void): PromiseLike<unknown>;
+}
+export declare function apply(ctx: ClientHost): Promise<() => Promise<void>>;
+/** Register the handover row. The tool call itself keeps the generic tool row. */
+export declare function start(ctx: ClientHost): () => void;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/lib/types/locales.d.ts

@@ -0,0 +1,15 @@
+/** Dictionary namespace for the handover row. */
+export declare const NS = "mh-browser";
+export declare const zh: {
+    readonly waiting: "浏览器交给你了：{reason}";
+    readonly reveal: "去浏览器";
+    readonly notHandingOver: "这次交接已经结束";
+    readonly noTab: "没有可以去的页面";
+    readonly failed: "没能切到浏览器";
+};
+export type CardKey = keyof typeof zh;
+export declare const en: Record<CardKey, string>;
+export type Translate = (key: CardKey, params?: Record<string, unknown>) => string;
+/** A translator over one dictionary, for rendering outside the host (tests). */
+export declare function translator(dict: Record<CardKey, string>): Translate;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/row.d.ts

@@ -0,0 +1,69 @@
+/**
+ * One chat row for the open `browser_handover` in a turn.
+ * `groupTree: 'turn'` stands outside the process group. A settled call keeps
+ * the same key and hides the row; a hidden row is omitted from group order.
+ */
+export declare const HANDOVER_KIND = "browser-handover";
+export interface HandoverRowData {
+    readonly reason: string;
+}
+interface OpenCall {
+    readonly callId: string;
+    readonly reason: string;
+    readonly seq: number;
+}
+export interface HandoverTurnState {
+    readonly open: OpenCall | undefined;
+    readonly anchorSeq: number | undefined;
+}
+/** A session event this row reads. Other fields are ignored. */
+export interface FoldEvent {
+    readonly type: string;
+    readonly seq: number;
+    readonly data: unknown;
+}
+export interface HandoverMatch {
+    readonly id: string;
+    readonly role: 'start' | 'update';
+}
+export interface HandoverChatNode {
+    readonly key: string;
+    readonly kind: typeof HANDOVER_KIND;
+    readonly id: string;
+    readonly target: 'chat';
+    readonly anchorSeq: number;
+    readonly location: unknown;
+    readonly visibility: 'visible' | 'hidden';
+    readonly groupTree: 'turn';
+    readonly data: HandoverRowData;
+}
+export interface HandoverNodeContext {
+    readonly key: string;
+    readonly id: string;
+    readonly state: HandoverTurnState | undefined;
+    readonly start: {
+        readonly location: unknown;
+    } | undefined;
+    readonly current: {
+        get(target: string): HandoverChatNode | null | undefined;
+    };
+}
+/**
+ * The row for one turn. Absent until a handover in that turn has been seen;
+ * hidden, with the same key, once the open call settles.
+ */
+export declare function buildHandoverView(context: HandoverNodeContext): HandoverChatNode | null;
+export declare const handoverRowDefinition: {
+    kind: string;
+    target: "chat";
+    match(event: FoldEvent): HandoverMatch | null;
+    start(): HandoverTurnState;
+    update(context: {
+        readonly state: HandoverTurnState;
+    }, match: {
+        readonly event: FoldEvent;
+    }): HandoverTurnState;
+    buildViewNode(context: HandoverNodeContext): HandoverChatNode | null;
+};
+export {};
+//# sourceMappingURL=row.d.ts.map

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

@@ -0,0 +1,24 @@
+import { MhBrowserError } from '../types.ts';
+/** A wait ended because its signal aborted, including a deadline synthesized here. */
+export declare function stopped(): MhBrowserError;
+export declare function isInterrupted(error: unknown): boolean;
+/**
+ * `promise`, or a rejection when `signal` aborts. The original promise is
+ * always observed, so abandoning it leaves no unhandled rejection.
+ */
+export declare function untilAborted<T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T>;
+/** `signal`, a deadline of `ms`, or whichever of the two aborts first. */
+export declare function capped(signal: AbortSignal | undefined, ms: number): AbortSignal;
+export interface Queued<T> {
+    /** Rejects as soon as `signal` aborts, including while `previous` is still running. */
+    run: Promise<T>;
+    /** Settles after `previous`, and after `op` when `op` started. Never rejects. */
+    tail: Promise<void>;
+}
+/**
+ * Run `op` once `previous` settles. Aborting `signal` while waiting rejects
+ * `run` and does not call `op`. `tail` still follows `previous`, and `op`
+ * when `op` has started, so a later caller cannot overlap the work.
+ */
+export declare function enqueue<T>(previous: Promise<unknown>, op: () => Promise<T>, signal?: AbortSignal): Queued<T>;
+//# sourceMappingURL=abortable.d.ts.map

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

@@ -17,16 +17,17 @@ export declare class Extension {
     /** Address of a page shipped in the extension directory. */
     pageUrl(name: string): string;
     /** `chrome.tabs.create` in the named window. Returns the extension's tab id. */
-    createTab(windowId: number, url: string): Promise<number>;
-    tabIdsIn(windowId: number): Promise<number[]>;
-    activate(tabId: number): Promise<void>;
+    createTab(windowId: number, url: string, signal?: AbortSignal): Promise<number>;
+    tabIdsIn(windowId: number, signal?: AbortSignal): Promise<number[]>;
+    activate(tabId: number, signal?: AbortSignal): Promise<void>;
     group(tabId: number, target: {
         groupId: number;
     } | {
         windowId: number;
-    }): Promise<number>;
-    styleGroup(groupId: number, title: string, color: 'blue' | 'red'): Promise<void>;
-    ungroup(tabId: number): Promise<void>;
+    }, signal?: AbortSignal): Promise<number>;
+    styleGroup(groupId: number, title: string, color: 'blue' | 'red', signal?: AbortSignal): Promise<void>;
+    ungroup(tabId: number, signal?: AbortSignal): Promise<void>;
+    private answer;
     private worker;
 }
 /** The extension's service worker. Looks once more after the wait times out. */

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

@@ -114,7 +114,7 @@ export declare class Windows {
     /** The tab touched most recently, for raising the window the person asked to see. */
     latest(owner: OwnerId): LiveTab | undefined;
     /** Make this tab the current one in its window. Does not raise the browser. */
-    activate(tab: LiveTab): Promise<void>;
+    activate(tab: LiveTab, signal?: AbortSignal): Promise<void>;
     /** Group title for the person. Empty until a title is known. */
     setTitle(owner: OwnerId, title: string): void;
     /** A handover in progress prefixes the group title and recolors it. */
@@ -126,15 +126,17 @@ export declare class Windows {
      * use the extension. Without a window, later pages use `window.open` from
      * an isolated world so they stay in that window.
      */
-    openBlank(owner: OwnerId): Promise<LiveTab>;
+    openBlank(owner: OwnerId, signal?: AbortSignal): Promise<LiveTab>;
     private createTab;
     private keep;
+    /** The page from a create, or close it when this wait is abandoned. */
+    private claimedPage;
     /**
      * Close one tab. `note` is listed in the next `<tabs>` block. A tab the
      * model was never shown (an Agent View discovered on a new tab) omits it.
      */
     closeTab(tab: LiveTab, note?: string): Promise<void>;
-    closeOwner(owner: OwnerId): Promise<void>;
+    closeOwner(owner: OwnerId, signal?: AbortSignal): Promise<void>;
     private closePage;
     /** A tab leaves the registry. The window closes with its last tab. */
     private forget;
@@ -173,7 +175,13 @@ export declare class Windows {
     private arm;
     private report;
     private waitForTarget;
+    private dropSession;
     private targetIdOf;
     private windowIdOf;
+    private pageSession;
+    private cdp;
+    /** Close a page that may no longer answer. A stall ends at `CLOSE_MS`. */
+    private shutdown;
+    private shutdownSession;
 }
 //# sourceMappingURL=windows.d.ts.map

package/lib/types/tools/given.d.ts

@@ -0,0 +1,5 @@
+/** A string the caller gave. Blank is the same as omitting it; the text itself is kept. */
+export declare function givenString(value: unknown): string | undefined;
+/** Seconds to wait. Zero is the same as omitting it; any other number is kept. */
+export declare function givenTime(value: unknown): number | undefined;
+//# sourceMappingURL=given.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mind-harness/mh-browser",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Opens pages in a real browser for the agent, keeps chosen Agent Views in context, and hands the browser to you when a person is needed.",
   "license": "SEE LICENSE IN LICENSE",
   "files": [
@@ -11,9 +11,11 @@
     "lib/typert.host.d.ts",
     "lib/typert.remote-client.js",
     "lib/typert.remote-client.d.ts",
+    "lib/client.cjs",
     "locale/*.json",
     "icon.svg",
-    "extension/*"
+    "extension/*",
+    "THIRD-PARTY-NOTICES"
   ],
   "type": "module",
   "main": "./lib/index.js",
@@ -35,6 +37,10 @@
       "types": "./lib/typert.remote-client.d.ts",
       "default": "./lib/typert.remote-client.js"
     },
+    "./client": {
+      "types": "./lib/types/client.d.ts",
+      "default": "./lib/client.cjs"
+    },
     "./package.json": "./package.json",
     "./locale/*.json": "./locale/*.json",
     "./icon": "./icon.svg"
@@ -63,7 +69,11 @@
     "@deepseek-ai/dsh-tools": "^0.2.2-rc.1",
     "@deepseek-ai/dsh-typert-protocol": "^0.2.2-rc.1",
     "@deepseek-ai/dsh-user-questions": "^0.2.2-rc.1",
-    "@deepseek-ai/schemastery": "~3.19.0"
+    "@deepseek-ai/schemastery": "~3.19.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.1.0",
@@ -72,12 +82,22 @@
     "@deepseek-ai/dsh-tools": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-user-questions": ">=0.2.2-rc.1 <0.2.3-0",
-    "@deepseek-ai/schemastery": "^3.19.0"
+    "@deepseek-ai/schemastery": "^3.19.0",
+    "react": "^19.2.8"
   },
   "icon": "./icon.svg",
   "engines": {
     "dsh": ">=0.2.2-rc.1 <0.2.3-0"
   },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    }
+  },
   "scripts": {
     "version": "node ../../scripts/mh/sync-extension-version.ts"
   }