@mind-harness/mh-browser 0.0.0-stage → 0.1.1

package/lib/types/tools/tab-log.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { LogReader } from '../projections.ts';
+import type { ToolSession } from './session.ts';
+/** Tabs an mh-browser result named and no later result reported closed. Plain JSON: a session projection state. */
+export interface TabLogState {
+    open: string[];
+}
+export declare function initTabLog(): TabLogState;
+export declare function applyTabLog(state: TabLogState, event: {
+    type: string;
+    data: unknown;
+}): TabLogState;
+/**
+ * The closed notes for this result: the service's own, then each tab an
+ * earlier result named that is gone without a note, as after a browser restart.
+ */
+export declare function closedNotes(ctx: Context, reader: LogReader, session: ToolSession): string[];
+//# sourceMappingURL=tab-log.d.ts.map

package/lib/types/types.d.ts

@@ -0,0 +1,172 @@
+/** Public browser types. Playwright types stay inside the service. */
+export type BrowserName = 'chrome' | 'msedge' | 'chromium';
+export type OwnerId = string;
+export type TabId = string;
+export interface WaitFor {
+    text?: string;
+    textGone?: string;
+    /** Seconds. Capped at 30. */
+    time?: number;
+}
+export interface FetchResponseBody {
+    kind: 'response';
+    finalUrl: string;
+    status: number;
+    mediaType?: string;
+    etag?: string;
+    link?: string;
+    body: Uint8Array;
+}
+export type FetchResponse = FetchResponseBody | {
+    kind: 'error';
+    reason: string;
+};
+export interface Dialog {
+    type: string;
+    message: string;
+}
+export interface PageView {
+    tab: TabId;
+    url: string;
+    title: string;
+    observedAt: string;
+    representation: {
+        kind: 'agent-view';
+        text: string;
+        version?: string;
+        /** The address the Agent View was read from: the page itself, or its `rel=agent-view`. */
+        href?: string;
+    } | {
+        kind: 'snapshot';
+        text: string;
+        agentViewError?: string;
+        /** Set on an action result when this page also has a readable Agent View. */
+        agentView?: {
+            version?: string;
+        };
+    };
+    fragment?: string;
+    status?: number;
+    mediaType?: string;
+    /** Response text of a textual non-HTML document navigation, shown in place of the snapshot. */
+    body?: string;
+    inPresence: boolean;
+    dialog?: Dialog;
+    incomplete?: {
+        load: boolean;
+        pendingRequests: number;
+    };
+    waited?: {
+        met: 'text' | 'textGone' | 'time' | false;
+        seconds: number;
+    };
+    download?: Download;
+}
+export interface PageError {
+    tab?: TabId;
+    url: string;
+    reason: string;
+}
+export interface TabInfo {
+    tab: TabId;
+    url: string;
+    title: string;
+    occupied: boolean;
+    inPresence: boolean;
+    mayHaveChanged: boolean;
+}
+export type ActAction = {
+    kind: 'click';
+    ref: string;
+    double?: boolean;
+    button?: 'left' | 'right' | 'middle';
+    modifiers?: Array<'Alt' | 'Control' | 'Meta' | 'Shift'>;
+} | {
+    kind: 'select';
+    ref: string;
+    values: string[];
+} | {
+    kind: 'press';
+    key: string;
+    ref?: string;
+} | {
+    kind: 'fill';
+    fields: {
+        ref: string;
+        value: string;
+    }[];
+} | {
+    kind: 'upload';
+    ref: string;
+    files: string[];
+} | {
+    kind: 'dialog';
+    accept: boolean;
+    promptText?: string;
+} | {
+    kind: 'back';
+} | {
+    kind: 'wait';
+    text?: string;
+    textGone?: string;
+    time?: number;
+} | {
+    kind: 'look';
+};
+export declare class MhBrowserError extends Error {
+    readonly code: string;
+    readonly page?: PageView;
+    constructor(code: string, 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_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";
+/** The browser did not start or could not be restarted. */
+export declare const BROWSER_UNAVAILABLE = "BROWSER_UNAVAILABLE";
+export declare function unknownTab(): PageError;
+export type Download = {
+    kind: 'saved';
+    path: string;
+    url: string;
+    mediaType?: string;
+    bytes: number;
+    sha256: string;
+    observed: string;
+} | {
+    kind: 'error';
+    url: string;
+    status?: number;
+    reason: string;
+};
+export interface ActionResponse {
+    name: string;
+    status?: number;
+    location?: string;
+    mediaType?: string;
+    body?: string;
+    bytes?: number;
+    lost?: boolean;
+}
+export interface InvokeCall {
+    name: string;
+    item?: string;
+    input?: Record<string, unknown>;
+    seen: SeenView | 'not-in-context';
+}
+/** The Agent View the model saw last: its declared `version` when it had one, and its digest. */
+export interface SeenView {
+    digest: string;
+    version?: string;
+}
+export interface InvokeSent {
+    schemaRejected: boolean;
+    response?: ActionResponse;
+    page: PageView | PageError;
+}
+//# sourceMappingURL=types.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mind Harness browser",
+    "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."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mind Harness 浏览器",
+    "description": "让智能体在真实浏览器里打开页面，把选定的 Agent View 留在上下文里，需要人时把浏览器交给你。"
+  }
+}

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@mind-harness/mh-browser",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.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": [
+    "lib/index.js",
+    "lib/types/representation/agent-view.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts",
+    "locale/*.json",
+    "icon.svg",
+    "extension/*"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./agent-view": {
+      "types": "./lib/types/representation/agent-view.d.ts",
+      "default": "./lib/types/representation/agent-view.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "playwright": "1.64.1",
+    "yaml": "^2.9.1",
+    "zod": "4.4.3"
+  },
+  "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"
+  },
+  "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"
+  },
+  "icon": "./icon.svg",
+  "scripts": {}
 }