@different-ai/opencode-browser 4.5.0 → 4.6.0

package/README.md

@@ -58,6 +58,25 @@ Your `opencode.json` or `opencode.jsonc` should contain:
 bunx @different-ai/opencode-browser@latest update
 ```
 
+## Chrome Web Store maintainer flow
+
+Build a store-ready extension package:
+
+```bash
+bun run build:cws
+```
+
+Outputs:
+
+- `artifacts/chrome-web-store/opencode-browser-cws-v<version>.zip`
+- `artifacts/chrome-web-store/manifest.chrome-web-store.json`
+
+Submission checklist and guidance:
+
+- `CHROME_WEB_STORE.md`
+- `CHROME_WEB_STORE_REQUEST_TEMPLATE.md`
+- `PRIVACY.md`
+
 ## How it works
 
 ```
@@ -111,11 +130,11 @@ export OPENCODE_BROWSER_AGENT_PORT=9833
 
 ## Per-tab ownership
 
-- First time a session touches a tab, the broker **auto-claims** it for that session.
-- Each session tracks a default tab; tools without `tabId` route to it.
-- `browser_open_tab` always works; if another session owns the active tab, the new tab opens in the background.
+- Each session owns its own tabs; tabs are never shared between sessions.
+- If a session has no tab yet, the broker auto-creates a background tab on first tool use.
+- `browser_open_tab` always creates and claims a new tab for the session.
 - Claims expire after inactivity (`OPENCODE_BROWSER_CLAIM_TTL_MS`, default 5 minutes).
-- Use `browser_status` or `browser_list_claims` to inspect claims if needed.
+- Use `browser_status` or `browser_list_claims` for debugging.
 
 ## Available tools
 
@@ -126,6 +145,7 @@ Core primitives:
 - `browser_claim_tab`
 - `browser_release_tab`
 - `browser_open_tab`
+- `browser_close_tab`
 - `browser_navigate`
 - `browser_query` (modes: `text`, `value`, `list`, `exists`, `page_text`; optional `timeoutMs`/`pollMs`)
 - `browser_click` (optional `timeoutMs`/`pollMs`)
@@ -134,6 +154,13 @@ Core primitives:
 - `browser_scroll` (optional `timeoutMs`/`pollMs`)
 - `browser_wait`
 
+Downloads:
+- `browser_download`
+- `browser_list_downloads`
+
+Uploads:
+- `browser_set_file_input` (extension backend supports small files; use agent backend for larger uploads)
+
 Selector helpers (usable in `selector`):
 - `label:Mailing Address: City`
 - `aria:Principal Address: City`
@@ -149,11 +176,11 @@ Diagnostics:
 
 ## Roadmap
 
-- [ ] Add tab management tools (`browser_set_active_tab`, `browser_close_tab`)
+- [ ] Add tab management tools (`browser_set_active_tab`)
 - [ ] Add navigation helpers (`browser_back`, `browser_forward`, `browser_reload`)
 - [ ] Add keyboard input tool (`browser_key`)
-- [ ] Add download support (`browser_download`, `browser_list_downloads`)
-- [ ] Add upload support (`browser_set_file_input`)
+- [x] Add download support (`browser_download`, `browser_list_downloads`)
+- [x] Add upload support (`browser_set_file_input`)
 
 ## Troubleshooting
 
@@ -162,8 +189,9 @@ Diagnostics:
 - If you loaded a custom extension ID, rerun with `--extension-id <id>`
 
 **Tab ownership errors**
-- Use `browser_status` or `browser_list_claims` to see current claims
-- Use `browser_release_tab` or close the other OpenCode session to release ownership
+- Errors usually mean you passed a `tabId` owned by another session
+- Use `browser_open_tab` to create a tab for your session (or omit `tabId` to use your default)
+- Use `browser_status` or `browser_list_claims` for debugging
 
 ## Uninstall
 
@@ -172,3 +200,7 @@ npx @different-ai/opencode-browser uninstall
 ```
 
 Then remove the unpacked extension in `chrome://extensions` and remove the plugin from `opencode.json` or `opencode.jsonc`.
+
+## Privacy
+
+- Privacy policy: `PRIVACY.md`

package/bin/broker.cjs

@@ -53,7 +53,7 @@ function writeJsonLine(socket, msg) {
 }
 
 function wantsTab(toolName) {
-  return !["get_tabs", "get_active_tab", "open_tab"].includes(toolName);
+  return !["get_tabs", "get_active_tab", "open_tab", "list_downloads"].includes(toolName);
 }
 
 // --- State ---
@@ -206,10 +206,13 @@ function callExtension(tool, args, sessionId) {
   });
 }
 
-async function resolveActiveTab(sessionId) {
-  const res = await callExtension("get_active_tab", {}, sessionId);
+async function ensureSessionTab(sessionId) {
+  if (!sessionId) throw new Error("Missing sessionId for tab creation");
+  const res = await callExtension("open_tab", { active: false }, sessionId);
   const tabId = res && typeof res.tabId === "number" ? res.tabId : undefined;
-  if (!tabId) throw new Error("Could not determine active tab");
+  if (!tabId) throw new Error("Failed to create a new tab for this session");
+  touchClaim(tabId, sessionId);
+  setDefaultTab(sessionId, tabId);
   return tabId;
 }
 
@@ -222,13 +225,7 @@ async function handleTool(pluginSocket, req) {
   let tabId = args.tabId;
   const toolArgs = { ...args };
 
-  if (tool === "open_tab" && toolArgs.active !== false) {
-    const activeTabId = await resolveActiveTab(sessionId);
-    const claimCheck = checkClaim(activeTabId, sessionId);
-    if (!claimCheck.ok) {
-      toolArgs.active = false;
-    }
-  }
+  const isCloseTool = tool === "close_tab";
 
   if (wantsTab(tool)) {
     if (typeof tabId !== "number") {
@@ -236,14 +233,10 @@ async function handleTool(pluginSocket, req) {
       const defaultTabId = state && Number.isFinite(state.defaultTabId) ? state.defaultTabId : null;
       if (Number.isFinite(defaultTabId)) {
         tabId = defaultTabId;
+      } else if (!isCloseTool) {
+        tabId = await ensureSessionTab(sessionId);
       } else {
-        const activeTabId = await resolveActiveTab(sessionId);
-        const claimCheck = checkClaim(activeTabId, sessionId);
-        if (!claimCheck.ok) {
-          throw new Error(`${claimCheck.error}. No default tab for session; open a new tab or claim one.`);
-        }
-        tabId = activeTabId;
-        setDefaultTab(sessionId, tabId);
+        throw new Error("No tab owned by this session. Open a new tab first.");
       }
     }
 
@@ -256,8 +249,16 @@ async function handleTool(pluginSocket, req) {
   const usedTabId =
     res && typeof res.tabId === "number" ? res.tabId : typeof tabId === "number" ? tabId : undefined;
   if (typeof usedTabId === "number") {
-    touchClaim(usedTabId, sessionId);
-    setDefaultTab(sessionId, usedTabId);
+    if (isCloseTool) {
+      if (claims.has(usedTabId)) {
+        releaseClaim(usedTabId);
+      } else {
+        clearDefaultTab(sessionId, usedTabId);
+      }
+    } else {
+      touchClaim(usedTabId, sessionId);
+      setDefaultTab(sessionId, usedTabId);
+    }
   }
 
   return res;