@hmharness/agent 0.23.20 → 0.23.22

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { baseTools, readFileTool, writeFileTool, listDirTool, runCommandTool, rememberTool, seeImageTool } from './tools.js';
-export { manifestFor, capabilityReport, authorize, type CapabilityManifest, type CapabilityRisk, type PolicyMode } from './capability.js';
-export { checkpointProject, createProject, findProject, interruptProject, listProjects, loadProject, projectFor, releaseProject, restoreCheckpoint, resumeBundle, transitionProject, attachRun, newProjectId, type CheckpointRef, type DecisionEntry, type ProjectRecord, type ProjectState, } from './project.js';
-export { mechanicalGate, parseVerdict, runPipeline, type PipelineOptions, type PipelineReport, type StageRecord, type StageRole, } from './pipeline.js';
-export { buildSystemPrompt } from './prompt.js';
-export { strings, type Locale, type Strings } from './i18n.js';
-export { makeSpawnTool, MAX_SPAWN_DEPTH, type SpawnBase } from './spawn.js';
-export { withTopologyGovernance, mapRole, liveTopologySnapshot, teamLog } from './topology-live.js';
-export { buildRegistry, contextPack, makeApproval, liveYolo, nativeRegistry, runAgentTask, spawnBase, toServerConfig, type AgentTaskOptions, type RunnerEvents, } from './runner.js';
-export * from './skills-conformance.js';
-export * from './acp.js';
-export * from './topology.js';
-export * from './meta-harness.js';
+export { baseTools, readFileTool, writeFileTool, listDirTool, runCommandTool, rememberTool, seeImageTool } from './tools.ts';
+export { manifestFor, capabilityReport, authorize, type CapabilityManifest, type CapabilityRisk, type PolicyMode } from './capability.ts';
+export { checkpointProject, createProject, findProject, interruptProject, listProjects, loadProject, projectFor, releaseProject, restoreCheckpoint, resumeBundle, transitionProject, attachRun, newProjectId, type CheckpointRef, type DecisionEntry, type ProjectRecord, type ProjectState, } from './project.ts';
+export { mechanicalGate, parseVerdict, runPipeline, type PipelineOptions, type PipelineReport, type StageRecord, type StageRole, } from './pipeline.ts';
+export { buildSystemPrompt } from './prompt.ts';
+export { strings, type Locale, type Strings } from './i18n.ts';
+export { makeSpawnTool, MAX_SPAWN_DEPTH, type SpawnBase } from './spawn.ts';
+export { withTopologyGovernance, mapRole, liveTopologySnapshot, teamLog } from './topology-live.ts';
+export { buildRegistry, contextPack, makeApproval, liveYolo, nativeRegistry, runAgentTask, spawnBase, toServerConfig, type AgentTaskOptions, type RunnerEvents, } from './runner.ts';
+export * from './skills-conformance.ts';
+export * from './acp.ts';
+export * from './topology.ts';
+export * from './meta-harness.ts';

package/dist/runner.d.ts

@@ -8,7 +8,7 @@
 import { Registry, type ChatMessage, type DeltaKind, type HmhConfig, type LoopApproval, type LoopResult, type McpClient, type McpServerConfig, type McpServerImport, type ToolContext } from '@hmharness/kernel';
 import { type EmbeddingProvider } from '@hmharness/evolution';
 import * as readline from 'node:readline/promises';
-import { type SpawnBase } from './spawn.js';
+import { type SpawnBase } from './spawn.ts';
 /** Flatten the config.json shape into the runtime discriminated union. */
 export declare function toServerConfig(c: McpServerImport): McpServerConfig;
 /**
@@ -20,6 +20,7 @@ export declare const spawnBase: {
 };
 export declare function nativeRegistry(depth: number, opts?: {
     lsp?: boolean;
+    browser?: boolean;
     workspaceRoot?: string;
 }): Registry;
 export declare function buildRegistry(opts?: {

package/dist/runner.js

@@ -16,6 +16,7 @@ import { appendMemory, listSkills, readInsights, readNotes, retrieveInsights, re
 import { harmonyTools } from '@hmharness/domain-harmony';
 import { opsTools } from '@hmharness/domain-ops';
 import { discoverServers, lspTools } from '@hmharness/lsp';
+import { discoverBrowsers, browserTools } from '@hmharness/browser';
 import * as readline from 'node:readline/promises';
 import { stdin } from 'node:process';
 import { baseTools } from "./tools.js";
@@ -51,6 +52,19 @@ export function nativeRegistry(depth, opts = {}) {
         }
         catch { /* lsp optional: never block tool assembly */ }
     }
+    // BrowserOS browser_* family — same rule: only when a BrowserOS binary
+    // is discoverable + healthy. Trust is enforced at launch time (like lsp
+    // clientFor): an untrusted binary produces an actionable error, not a
+    // dead tool. The user's daily browser is never touched — tools drive a
+    // dedicated instance.
+    if (opts.browser !== false) {
+        try {
+            if (discoverBrowsers().some((b) => b.healthy)) {
+                reg.registerAll(browserTools({ workspaceRoot: opts.workspaceRoot ?? process.cwd(), home: homeDir() }));
+            }
+        }
+        catch { /* browser optional: never block tool assembly */ }
+    }
     if (depth < MAX_SPAWN_DEPTH) {
         // blueprint M10: every spawn_agent is governed by the live topology
         // (role contract + shared budget + immutable multi-agent.jsonl audit);

package/dist/tools.js

@@ -493,7 +493,7 @@ export const desktopTypeTool = {
  */
 export const browserOpenTool = {
     name: 'browser_open',
-    description: 'Open a URL in the user\'s default browser (visible). Then use desktop_screenshot + see_image to see the page, desktop_click/desktop_type to interact. Full workflow: browser_open → desktop_screenshot → see_image (find elements) → desktop_click (click) → desktop_screenshot (verify).',
+    description: 'Open a URL in the user\'s default browser (visible). Then use desktop_screenshot + see_image to see the page, desktop_click/desktop_type to interact. Full workflow: browser_open → desktop_screenshot → see_image (find elements) → desktop_click (click) → desktop_screenshot (verify). When running inside a host browser (BrowserOS ACP), this navigates the host\'s active tab instead of opening a new OS window — pair it with browser_snapshot/browser_read.',
     parameters: {
         type: 'object',
         properties: {
@@ -506,6 +506,26 @@ export const browserOpenTool = {
         const url = String(args.url ?? '').trim();
         if (!/^https?:\/\//i.test(url))
             return { output: 'only http(s) URLs', isError: true };
+        // Under a host browser (acp-serve/BrowserOS): opening the OS default
+        // browser pops a SECOND window per call — the exact bug users see as
+        // "a new browser window on every message". Navigate the host's active
+        // tab instead; the browser_* family reads/verifies from there.
+        const attachPort = Number(process.env.HMH_BROWSER_ATTACH ?? 0);
+        if (Number.isInteger(attachPort) && attachPort > 0) {
+            try {
+                const { CdpBrowser } = await import('@hmharness/browser');
+                const c = new CdpBrowser({ port: attachPort });
+                if (await c.up()) {
+                    const tabs = (await c.tabs()).filter((t) => !t.url.startsWith('chrome-extension://'));
+                    const page = tabs.find((t) => !t.url.startsWith('about:')) ?? tabs[0];
+                    const tid = page?.targetId ?? (await c.openTab('about:blank'));
+                    await c.navigate(tid, url);
+                    const title = String(await c.evaluate(tid, 'document.title').catch(() => ''));
+                    return { output: `navigated the host browser to ${url} (title: ${title || 'loading'}) — use browser_snapshot/browser_read to see the page` };
+                }
+            }
+            catch { /* fall through to the default-browser path if attach fails */ }
+        }
         try {
             if (process.platform === 'win32') {
                 const { execFile } = await import('node:child_process');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.23.20",
+  "version": "0.23.22",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",
@@ -15,14 +15,15 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@hmharness/cognitive": "0.23.20",
-    "@hmharness/domain-harmony": "0.23.20",
-    "@hmharness/domain-ops": "0.23.20",
-    "@hmharness/evolution": "0.23.20",
-    "@hmharness/kernel": "0.23.20",
-    "@hmharness/observability": "0.23.20",
-    "@hmharness/sandbox": "0.23.20",
-    "@hmharness/lsp": "0.23.20"
+    "@hmharness/cognitive": "0.23.22",
+    "@hmharness/domain-harmony": "0.23.22",
+    "@hmharness/domain-ops": "0.23.22",
+    "@hmharness/evolution": "0.23.22",
+    "@hmharness/kernel": "0.23.22",
+    "@hmharness/observability": "0.23.22",
+    "@hmharness/sandbox": "0.23.22",
+    "@hmharness/lsp": "0.23.22",
+    "@hmharness/browser": "0.23.22"
   },
   "files": [
     "dist"