@mind-harness/mh-browser 0.1.0 → 0.1.2

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Mind Harness",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "permissions": ["tabGroups"],
   "background": { "service_worker": "sw.js" }
 }

package/lib/index.js

@@ -1,13 +1,13 @@
+import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import z from "@deepseek-ai/schemastery";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { isDeepStrictEqual } from "node:util";
 import { HarnessError, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { z as z$1 } from "zod";
 import { createHash, randomUUID } from "node:crypto";
-import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import { lstat, mkdir, open, readFile, realpath, unlink, writeFile } from "node:fs/promises";
 import { parse } from "yaml";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { chromium } from "playwright";
 import { constants, readFileSync } from "node:fs";
 import { assertSupportedJsonSchema, defineTool, validateJsonSchemaValue } from "@deepseek-ai/dsh-tools";
@@ -21,9 +21,17 @@ const browserConfig = z.object({
 		"msedge",
 		"chromium"
 	]).default("chrome").description("Which installed browser to drive. chromium is the one Playwright downloads."),
-	profileDir: z.string().description("Browser profile directory, kept between runs. Defaults to mh/browser under the dsh home."),
+	profileDir: z.string().description("Browser profile directory, kept between runs. Defaults to mh/profiles/<dsh profile>/browser under the dsh home."),
 	headless: z.boolean().default(false).description("Run the browser without a window.")
 });
+/**
+* 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
+* cannot both start.
+*/
+function defaultProfileDir(profile, home = resolveDshHome()) {
+	return profile === void 0 ? join(home, "mh", "browser") : join(home, "mh", "profiles", profile.name, "browser");
+}
 //#endregion
 //#region lib/types/presence/record.js
 /** Structured presence record carried on a message source. The model sees the rendered text, not this. */
@@ -690,7 +698,13 @@ function latestSeen(state, url) {
 	const latest = matches.filter((item) => item.digest !== void 0).at(-1);
 	if (latest === void 0) return { digest: "" };
 	if (!latest.inContext) return "not-in-context";
-	return { digest: latest.digest ?? "" };
+	return seenOf(latest);
+}
+function seenOf(item) {
+	return {
+		digest: item.digest ?? "",
+		...item.version === void 0 ? {} : { version: item.version }
+	};
 }
 /**
 * The document `page` names: the one shown at that address, else the one whose
@@ -726,7 +740,7 @@ function resolvePage(state, page) {
 	if (chosen === void 0) return void 0;
 	return {
 		url: chosen.url,
-		seen: { digest: chosen.digest ?? "" }
+		seen: seenOf(chosen)
 	};
 }
 function withShown(state, shown) {
@@ -781,6 +795,7 @@ function fromTool(event) {
 		const url = readString(row.url);
 		if (url === void 0) continue;
 		const digest = readString(row.digest);
+		const version = readString(row.version);
 		const id = readString(row.id);
 		deliveries.push({
 			url,
@@ -789,6 +804,7 @@ function fromTool(event) {
 			inContext: true,
 			...callId === void 0 ? {} : { callId },
 			...digest === void 0 ? {} : { digest },
+			...version === void 0 ? {} : { version },
 			...id === void 0 ? {} : { id }
 		});
 	}
@@ -810,6 +826,7 @@ function fromPresence(event) {
 		const url = readString(row.url);
 		if (url === void 0) continue;
 		const digest = readString(row.digest);
+		const version = readString(row.version);
 		const id = readString(row.id);
 		deliveries.push({
 			url,
@@ -817,6 +834,7 @@ function fromPresence(event) {
 			kind: "presence",
 			inContext: true,
 			...digest === void 0 ? {} : { digest },
+			...version === void 0 ? {} : { version },
 			...id === void 0 ? {} : { id }
 		});
 	}
@@ -841,6 +859,7 @@ function attachedPage(seq, data, text, callId) {
 	const header = text.slice(start, end);
 	const url = attrOf(header, "url");
 	const digest = attrOf(header, "digest");
+	const version = attrOf(header, "version");
 	if (url === void 0 || digest === void 0) return void 0;
 	const close = text.indexOf("</page>", end);
 	const id = agentViewId(text.slice(end + 1, close < 0 ? void 0 : close), url);
@@ -850,6 +869,7 @@ function attachedPage(seq, data, text, callId) {
 			seq,
 			kind: "tool",
 			digest,
+			...version === void 0 ? {} : { version },
 			inContext: true,
 			...callId === void 0 ? {} : { callId },
 			...id === void 0 ? {} : { id }
@@ -2425,9 +2445,8 @@ async function runInvoke(host, pageUrl, call) {
 	const view = await host.idleView(pageUrl) ?? await host.open(pageUrl);
 	if (!("representation" in view)) throw new MhBrowserError("NOT_DECLARED", view.reason);
 	const action = declaredAction(view, call.name);
-	const digest = representationDigest(view.representation.text);
 	if (call.seen === "not-in-context") throw new MhBrowserError("STALE_VIEW", "not-in-context", view);
-	if (call.seen.digest !== digest) throw new MhBrowserError("STALE_VIEW", "changed", view);
+	if (viewChanged(call.seen, view)) throw new MhBrowserError("STALE_VIEW", "changed", view);
 	const doc = readableDoc(view);
 	const origin = view.url === "" ? pageUrl : view.url;
 	const plan = planAction(doc, action, origin, call);
@@ -2469,6 +2488,17 @@ async function runInvoke(host, pageUrl, call) {
 		page: reloaded
 	};
 }
+/**
+* A page that declares a `version` changed only when that version did: bytes
+* that are not the resource, such as links to the rest of the site, move
+* without making the model's choice stale. The site's own version precondition
+* in `request` rejects a choice made on an old version.
+*/
+function viewChanged(seen, view) {
+	const version = view.representation.kind === "agent-view" ? view.representation.version : void 0;
+	if (seen.version !== void 0 || version !== void 0) return seen.version !== version;
+	return seen.digest !== representationDigest(view.representation.text);
+}
 function declaredAction(view, name) {
 	if (view.representation.kind !== "agent-view") throw new MhBrowserError("NOT_DECLARED", (view.representation.kind === "snapshot" ? view.representation.agentViewError : void 0) ?? "this page has no readable Agent View", view);
 	const action = readableDoc(view).actions[name];
@@ -3946,7 +3976,7 @@ let MhBrowserService = (() => {
 			this.launchOptions = {
 				browser: config.browser,
 				headless: config.headless,
-				profileDir: config.profileDir ?? join(resolveDshHome(), "mh", "browser")
+				profileDir: config.profileDir ?? defaultProfileDir(ctx.get("profileContext"))
 			};
 			this.windows.setPersonInput((owner, tab) => {
 				const live = tab === void 0 ? void 0 : this.windows.get(owner, tab);

package/lib/typert.host.js

@@ -285,7 +285,7 @@ export const TYPERT = {
           },
           {
             "name": "InvokeCall",
-            "declaration": "export interface InvokeCall {\n    name: string;\n    item?: string;\n    input?: Record<string, unknown>;\n    seen: { digest: string; } | 'not-in-context';\n}"
+            "declaration": "export interface InvokeCall {\n    name: string;\n    item?: string;\n    input?: Record<string, unknown>;\n    seen: SeenView | 'not-in-context';\n}"
           },
           {
             "name": "InvokeSent",
@@ -323,6 +323,10 @@ export const TYPERT = {
             "name": "PresenceSource",
             "declaration": "export type PresenceSource = (typeof PRESENCE_SOURCES)[number];"
           },
+          {
+            "name": "SeenView",
+            "declaration": "export interface SeenView {\n    digest: string;\n    version?: string;\n}"
+          },
           {
             "name": "TabId",
             "declaration": "export type TabId = string;"

package/lib/types/config.d.ts

@@ -9,4 +9,12 @@ export interface BrowserConfig {
     headless: boolean;
 }
 export declare const browserConfig: z<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
+ * cannot both start.
+ */
+export declare function defaultProfileDir(profile: {
+    name: string;
+} | undefined, home?: string): string;
 //# sourceMappingURL=config.d.ts.map

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

@@ -1,8 +1,11 @@
+import type { SeenView } from '../types.ts';
 /** A page the session has shown the model, folded from the session log. */
 export interface Delivery {
     url: string;
     seq: number;
     digest?: string;
+    /** The `version` its Agent View declares, when it declares one. */
+    version?: string;
     /** The `id` its Agent View declares. A log written before it was recorded has none. */
     id?: string;
     callId?: string;
@@ -39,14 +42,10 @@ export declare function foldDeliveries(events: readonly LogEvent[]): DeliverySta
  * The Agent View of this address the model saw last, and whether it is still
  * in context. A page shown only as a snapshot has no Agent View digest.
  */
-export declare function latestSeen(state: DeliveryState, url: string): {
-    digest: string;
-} | 'not-in-context' | undefined;
+export declare function latestSeen(state: DeliveryState, url: string): SeenView | 'not-in-context' | undefined;
 export type ResolvedPage = {
     url: string;
-    seen: {
-        digest: string;
-    } | 'not-in-context';
+    seen: SeenView | 'not-in-context';
 } | {
     ambiguous: string[];
 };

package/lib/types/types.d.ts

@@ -157,9 +157,12 @@ export interface InvokeCall {
     name: string;
     item?: string;
     input?: Record<string, unknown>;
-    seen: {
-        digest: string;
-    } | 'not-in-context';
+    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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mind-harness/mh-browser",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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": [
@@ -43,27 +43,27 @@
     "access": "public"
   },
   "dependencies": {
-    "playwright": "1.64.1",
+    "playwright": "^1.64.1",
     "yaml": "^2.9.1",
-    "zod": "4.4.3"
+    "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.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",