@mind-harness/mh-browser 0.1.6 → 0.2.1

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

package/lib/types/index.d.ts

@@ -5,7 +5,7 @@ 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): void;
+export declare function apply(ctx: Context, config: Config): Promise<void>;
 export { MhBrowserService };
 export { readAgentView } from './representation/agent-view.ts';
 export type { AgentViewDoc, AgentViewLink, AgentViewRead } from './representation/agent-view.ts';

package/lib/types/presence/register.d.ts

@@ -1,6 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { Agent, PreStepDecision } from '@deepseek-ai/dsh-agent';
 import { type UserMessage } from '@deepseek-ai/dsh-llm';
+import type { LogReader } from '../projections.ts';
 import type { MhBrowserService } from '../service/service.ts';
 import { type PresenceLogState } from './fold.ts';
 import './source.ts';
@@ -9,7 +10,7 @@ import './source.ts';
  * the reminder after the claimed input. `await next()` runs first, so a
  * caller that puts pages and then returns `next()` is folded into this step.
  */
-export declare function registerPresence(ctx: Context): void;
+export declare function registerPresence(ctx: Context, reader: LogReader): void;
 /**
  * The reminder this step should carry. A set the log has but this process has
  * not checked (a resumed session) is re-read; one whose reminder a canceled

package/lib/types/projections.d.ts

@@ -4,22 +4,12 @@ import { type PresenceLogState } from './presence/fold.ts';
 import { type AttachmentState } from './tools/attachments.ts';
 import { type DeliveryState } from './tools/delivery.ts';
 import { type TabLogState } from './tools/tab-log.ts';
-declare module '@deepseek-ai/dsh-session-projection/types' {
-    interface SessionProjectionStateMap {
-        mhBrowserDeliveries: DeliveryState;
-        mhBrowserPresence: PresenceLogState;
-        mhBrowserAttachments: AttachmentState;
-        mhBrowserTabs: TabLogState;
-    }
-}
-/** Host-only folds over the session log; every read of what the log says goes through these. */
-export declare function registerProjections(ctx: Context): void;
 export interface LogReader {
     deliveries(session: Session): DeliveryState;
     presence(session: Session): PresenceLogState;
     attachments(session: Session): AttachmentState;
     tabs(session: Session): TabLogState;
 }
-/** Fails closed when the registry or a unit is not active. */
-export declare function logReader(ctx: Context): LogReader;
+/** Host-only folds over the session log; every read of what the log says goes through these. */
+export declare function registerProjections(ctx: Context): Promise<LogReader>;
 //# sourceMappingURL=projections.d.ts.map

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

@@ -36,7 +36,7 @@ export declare class MhBrowserService extends TypertRemoteService {
     private context;
     private ready;
     private closing;
-    /** The browser exited. The next call that needs a page starts it again. */
+    /** The browser is not running. The next call that needs a page starts it. */
     private exited;
     private readonly exits;
     /** One queue per owner: a slow wait in one Session does not hold up another. */
@@ -170,6 +170,8 @@ export declare class MhBrowserService extends TypertRemoteService {
      * ends the read without falling back to a tab.
      */
     private readKnown;
+    /** Keep the newest Agent Views. A dropped one is read in full the next time. */
+    private rememberDocument;
     /** One page from a document, with no tab. */
     private pageOfShown;
     /**
@@ -225,12 +227,14 @@ export declare class MhBrowserService extends TypertRemoteService {
     /** No window opens on exit: the person may have quit it. Calls on old tabs find none. */
     private onExit;
     /**
-     * The browser for a call that needs a page. One that exited starts again
-     * here. The exit limit stops unattended restarts; a person's request is
-     * one start per click and skips it.
+     * The browser for a call that needs a page. One that is not running starts
+     * again here. The exit limit stops unattended restarts; a person's request
+     * is one start per click and skips it.
      */
     private up;
     private stop;
+    /** Close a context the service is done with, and kill it if close stalls. */
+    private closeContext;
     private refuseIfPerson;
     private takenOver;
     private presenceUrls;

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-export declare function browserDownloadTool(ctx: Context): ToolDefinition;
+import type { LogReader } from '../projections.ts';
+export declare function browserDownloadTool(ctx: Context, reader: LogReader): ToolDefinition;
 //# sourceMappingURL=download.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-export declare function browserHandoverTool(ctx: Context): ToolDefinition;
+import type { LogReader } from '../projections.ts';
+export declare function browserHandoverTool(ctx: Context, reader: LogReader): ToolDefinition;
 //# sourceMappingURL=handover.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-export declare function browserInvokeTool(ctx: Context): ToolDefinition;
+import type { LogReader } from '../projections.ts';
+export declare function browserInvokeTool(ctx: Context, reader: LogReader): ToolDefinition;
 //# sourceMappingURL=invoke.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-export declare function browserOpenTool(ctx: Context): ToolDefinition;
+import type { LogReader } from '../projections.ts';
+export declare function browserOpenTool(ctx: Context, reader: LogReader): ToolDefinition;
 //# sourceMappingURL=open.d.ts.map

package/lib/types/tools/page-ops.d.ts

@@ -1,6 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import type { LogReader } from '../projections.ts';
 export declare const PAGE_OPERATION_NAMES: readonly ["browser_click", "browser_hover", "browser_select_option", "browser_drag", "browser_type", "browser_fill_form", "browser_press_key", "browser_file_upload", "browser_handle_dialog", "browser_navigate_back", "browser_wait_for", "browser_snapshot", "browser_find", "browser_take_screenshot", "browser_evaluate"];
-export declare function pageOperationTools(ctx: Context): ToolDefinition[];
-export declare function pageOperationTool(ctx: Context, name: string): ToolDefinition;
+export declare function pageOperationTools(ctx: Context, reader: LogReader): ToolDefinition[];
+export declare function pageOperationTool(ctx: Context, reader: LogReader, name: string): ToolDefinition;
 //# sourceMappingURL=page-ops.d.ts.map

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-export declare function browserPresenceTool(ctx: Context): ToolDefinition;
+import type { LogReader } from '../projections.ts';
+export declare function browserPresenceTool(ctx: Context, reader: LogReader): ToolDefinition;
 //# sourceMappingURL=presence.d.ts.map

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

@@ -1,3 +1,4 @@
 import type { Context } from '@deepseek-ai/cordis';
-export declare function registerBrowserTools(ctx: Context): void;
+import type { LogReader } from '../projections.ts';
+export declare function registerBrowserTools(ctx: Context, reader: LogReader): void;
 //# sourceMappingURL=register.d.ts.map

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

@@ -3,10 +3,12 @@ import { HarnessError } from '@deepseek-ai/dsh-llm';
 import type { Session } from '@deepseek-ai/dsh-session';
 import type { ToolRunContext } from '@deepseek-ai/dsh-tools';
 import type { WriteTarget } from '../service/service.ts';
+import { type BrowserCode } from '../types.ts';
 /** dsh shows the model only the message, so the message starts with the code. */
 export declare class BrowserToolError extends HarnessError {
+    readonly code: BrowserCode;
     readonly reason: string;
-    constructor(code: string, reason: string);
+    constructor(code: BrowserCode, reason: string);
 }
 export declare const NO_WORKSPACE_REASON = "this session has no working directory";
 export interface ToolSession {

package/lib/types/types.d.ts

@@ -175,22 +175,25 @@ export interface TabInfo {
     inPresence: boolean;
     mayHaveChanged: boolean;
 }
+/** Every code this package reports. The values are the model-facing contract. */
+export declare const BROWSER_CODES: readonly ["AUTHORITY_MISMATCH", "BROWSER_UNAVAILABLE", "INTERRUPTED", "INVALID_ARGS", "INVALID_INPUT", "ITEM_REFUSED", "MODAL_STATE", "NO_SESSION", "NO_WORKSPACE", "NOT_DECLARED", "NOT_DELIVERED", "OUTSIDE_WORKSPACE", "PERSON_IN_CONTROL", "SANDBOX_DENIED", "STALE_REF", "TAKEN_OVER", "UNKNOWN_TAB"];
+export type BrowserCode = (typeof BROWSER_CODES)[number];
 export declare class MhBrowserError extends Error {
-    readonly code: string;
+    readonly code: BrowserCode;
     readonly page?: PageView;
-    constructor(code: string, message: string, page?: PageView);
+    constructor(code: BrowserCode, message: string, page?: PageView);
 }
 /** Owner of the person's own window. It belongs to no Session. */
 export declare const PERSON_OWNER = "person";
-export declare const UNKNOWN_TAB = "UNKNOWN_TAB";
+export declare const UNKNOWN_TAB: BrowserCode;
 export declare const UNKNOWN_TAB_REASON = "no such tab in this session";
 /**
  * Internal: a wait ended because its signal aborted. A tool never reports it:
  * a stopped call ends as the tool runtime's abort, a takeover as `TAKEN_OVER`.
  */
-export declare const INTERRUPTED = "INTERRUPTED";
+export declare const INTERRUPTED: BrowserCode;
 /** The browser did not start or could not be restarted. */
-export declare const BROWSER_UNAVAILABLE = "BROWSER_UNAVAILABLE";
+export declare const BROWSER_UNAVAILABLE: BrowserCode;
 export declare function unknownTab(): PageError;
 export type Download = {
     kind: 'saved';

package/lib/types/words.d.ts

@@ -0,0 +1,7 @@
+/** Shown on a session's tab group while a handover is waiting. */
+export declare const WAITING_TITLE = "\u7B49\u4F60\uFF1A";
+/** The question on the handover card. `reason` is the sentence the model gave. */
+export declare function handoverQuestion(reason: string): string;
+/** The option that hands the browser back. */
+export declare const HAND_BACK = "\u4EA4\u56DE";
+//# sourceMappingURL=words.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mind-harness/mh-browser",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "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": [
@@ -48,33 +48,36 @@
     "zod": "^4.6.6"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-agent": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-agent-loop": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-attachment": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-browser-use": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-home-paths": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-llm": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-llm-mock-server": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-session": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-session-projection": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-tools": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-typert-protocol": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-user-questions": "^0.2.1-rc.3",
-    "@deepseek-ai/schemastery": "~3.18.5"
+    "@deepseek-ai/cordis": "~4.1.0",
+    "@deepseek-ai/dsh-agent": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-browser-use": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-llm-mock-server": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.2.2-rc.1",
+    "@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"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-home-paths": ">=0.2.1-rc.3 <0.3.0",
-    "@deepseek-ai/dsh-llm": ">=0.2.1-rc.3 <0.3.0",
-    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.3 <0.3.0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.2.1-rc.3 <0.3.0",
-    "@deepseek-ai/dsh-user-questions": ">=0.2.1-rc.3 <0.3.0",
-    "@deepseek-ai/schemastery": "~3.18.5"
+    "@deepseek-ai/cordis": "^4.1.0",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-rc.1 <0.2.3-0",
+    "@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"
   },
   "icon": "./icon.svg",
+  "engines": {
+    "dsh": ">=0.2.2-rc.1 <0.2.3-0"
+  },
   "scripts": {
     "version": "node ../../scripts/mh/sync-extension-version.ts"
   }