@plainconceptsplatform/agent-harness 3.9.0-alpha.1 → 3.10.0

package/README.md

@@ -89,7 +89,7 @@ Reach for individual steps when you want something narrower:
 
 > **Upgrading from `opencode-onboard` v1?** v2 renamed the config files and the skill prefix (`ob-` became `pc-`), and it does not migrate v1 projects. The CLI detects one and refuses to run rather than half-patching it. Re-onboard on a clean branch: remove `.opencode/` and `.agents/skills/ob-*`, then run the wizard again.
 
-> **Browser tooling changed in v2.5.** `agent-browser` (which launched its own isolated Chrome for Testing) was replaced by [`browse`](https://opencode.ai/product/browse), the OpenCode MCP server that drives the user's real Chrome-family browser with their logins, tabs, cookies, and extensions. Agent tabs open in the background in collapsed groups; when only a person can proceed (login, 2FA, captcha, payment), browse hands the tab back and continues once the user clicks Continue. Running `update` replaces the `agent-browser` MCP server entry with `browse`, installs the new CLI, and runs `browse install` which opens the Chrome Web Store for the extension and pairs it. Skills you wrote that call `agent-browser` CLI commands or `agent_browser_*` MCP tools must switch to the `browse` CLI or the `browse.execute` / `browse.session_*` MCP tools. Backlog-browser users: browse uses your real browser, so work-item pages behind your own login are already authenticated — no separate login session is needed.
+> **Browser tooling changed in v3.10.** `agent-browser` (which launched its own isolated Chrome for Testing) was replaced by [`browse`](https://opencode.ai/product/browse), the OpenCode MCP server that drives the user's real Chrome-family browser with their logins, tabs, cookies, and extensions. Agent tabs open in the background in collapsed groups; when only a person can proceed (login, 2FA, captcha, payment), browse hands the tab back and continues once the user clicks Continue. Running `update` replaces the `agent-browser` MCP server entry with `browse`, installs the new CLI, and runs `browse install` which opens the Chrome Web Store for the extension and pairs it. Skills you wrote that call `agent-browser` CLI commands or `agent_browser_*` MCP tools must switch to the `browse` CLI or the `browse.execute` / `browse.session_*` MCP tools. Backlog-browser users: browse uses your real browser, so work-item pages behind your own login are already authenticated — no separate login session is needed.
 
 ---
 

package/cli/steps/copy/opencode-json.js

@@ -166,6 +166,40 @@ function migrateMcp(obj) {
   return true
 }
 
+// Stale MCP server entries that browse replaced. The V2 @different-ai/opencode-browser
+// plugin (and its Chrome extension) was replaced by agent-browser in v2.4, then by browse
+// in v3.10. Both old entries are stripped and the current browse entry is ensured.
+const BROWSE_MCP_SERVER = {
+  type: 'local',
+  command: ['browse', 'mcp'],
+  environment: { OPENCODE_BROWSER_RUNTIME: 'auto-update' },
+  disabled: false,
+}
+const STALE_MCP_SERVER_NAMES = ['agent-browser', 'opencode-browser', '@different-ai/opencode-browser']
+
+function migrateBrowserMcp(obj) {
+  if (!obj.mcp?.servers || typeof obj.mcp.servers !== 'object') return false
+  let changed = false
+  for (const name of STALE_MCP_SERVER_NAMES) {
+    if (name in obj.mcp.servers) {
+      delete obj.mcp.servers[name]
+      changed = true
+    }
+  }
+  const current = obj.mcp.servers['browse']
+  if (!current) {
+    obj.mcp.servers['browse'] = { ...BROWSE_MCP_SERVER }
+    changed = true
+  } else if (JSON.stringify(current.command) !== JSON.stringify(BROWSE_MCP_SERVER.command)) {
+    obj.mcp.servers['browse'] = { ...current, ...BROWSE_MCP_SERVER, environment: current.environment ?? BROWSE_MCP_SERVER.environment }
+    changed = true
+  } else if (!current.environment?.OPENCODE_BROWSER_RUNTIME) {
+    obj.mcp.servers['browse'] = { ...current, environment: { ...(current.environment ?? {}), OPENCODE_BROWSER_RUNTIME: 'auto-update' } }
+    changed = true
+  }
+  return changed
+}
+
 /** Mutate `obj` in place to the native V2 shape; returns true when it changed. */
 function migrateToV2(obj) {
   let changed = false
@@ -246,6 +280,7 @@ function migrateToV2(obj) {
 
   if (migrateAgents(obj)) changed = true
   if (migrateMcp(obj)) changed = true
+  if (migrateBrowserMcp(obj)) changed = true
   if (migratePluginArray(obj)) changed = true
 
   // A session starts read-only: fullstack-engineer is a subagent now, so a

package/harness/opencode.jsonc

@@ -5,6 +5,7 @@
       "browse": {
         "type": "local",
         "command": ["browse", "mcp"],
+        "environment": { "OPENCODE_BROWSER_RUNTIME": "auto-update" },
         "disabled": false
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plainconceptsplatform/agent-harness",
-  "version": "3.9.0-alpha.1",
+  "version": "3.10.0",
   "description": "Installs the Plain Concepts Platform Harness into any codebase, and keeps it up to date. Wires OpenCode, OpenSpec, codegraph, and agentmemory into a multi-agent workflow that runs on native parallel subagents.",
   "keywords": [
     "opencode",