release: publish 0.4.1

Author: neriousy

.github/workflows/publish.yml

@@ -0,0 +1,71 @@
+name: Publish package
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+          package-manager-cache: false
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: "1.3.14"
+
+      - name: Verify release tag
+        run: |
+          package_version="$(node -p "require('./package.json').version")"
+          test "${GITHUB_REF_NAME}" = "v${package_version}"
+          test "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)"
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run release checks
+        run: bun run check
+
+      - name: Check out compatible OpenCode host
+        uses: actions/checkout@v6
+        with:
+          repository: neriousy/opencode
+          ref: 06e26d89ad0b06663fc4b34241f8661d170c2450
+          path: .release/opencode
+          persist-credentials: false
+
+      - name: Install OpenCode host dependencies
+        working-directory: .release/opencode
+        run: bun install --frozen-lockfile
+
+      - name: Verify packed package
+        run: bun run test:packed
+        env:
+          OPENCODE_REPO: ${{ github.workspace }}/.release/opencode
+
+      - name: Remove compatible OpenCode host
+        run: rm -rf "${GITHUB_WORKSPACE}/.release"
+
+      - name: Publish to npm
+        run: npm publish

CONTEXT.md

@@ -56,7 +56,12 @@ generation ID so stale disconnects and late work cannot mutate a newer generatio
 
 Browser Session owns explicit page lifecycle through Host Chrome and Browser Control. It observes pages created through
 the shared runtime API, but it does not implement popup adoption. New windows requested by page content are not a second
-tab-creation policy; use Browser Session or the controller's `new_tab` operation.
+tab-creation policy. Browser Control uses `open` for ordinary navigation and reserves `new_tab` for additional pages.
+Browser Control and Host Chrome new-tab actions are both append-only.
+
+Closing the final tracked page closes Host Chrome while Browser Session prepares a hidden replacement welcome page.
+Presentation code renders that internal page as **New tab** with an empty address and never displays its data URL in
+Host Chrome. Browser Control and DevTools may still report the underlying runtime URL.
 
 ## Runtime And Presentation
 

README.md

@@ -107,7 +107,8 @@ behavior there; `Cmd-W` still closes the page.
 
 Returning to OpenCode hides the browser without closing Electron or its pages, so reopening is fast. **Remove browser
 tabs from strip** also hides every browser page item while keeping the runtime ready; `/browser` restores them.
-Closing the final tracked page creates a fresh welcome page.
+Closing the final tracked page closes the browser workspace. The session prepares an internal welcome page so reopening
+stays fast; Host Chrome presents it as **New tab** with an empty address instead of exposing its internal data URL.
 
 Popup windows are deliberately denied. Use `+` or the controller's `new_tab` tool when a new tracked page is
 required.
@@ -139,10 +140,11 @@ The control server exposes eight tools: `show`, `open`, `new_tab`, `list_tabs`,
 
 For reliable agent automation:
 
-1. Use `list_tabs`, `new_tab`, or `open` to select the intended tracked page.
-2. Read its stable logical `tabId`, current CDP `targetId`, URL, and title.
-3. Call Chrome DevTools MCP `list_pages` and match the live page by URL/title.
-4. Use Chrome DevTools MCP's numeric `pageId` for page-scoped DevTools operations.
+1. Use `open` for an ordinary single-page request; it reuses the selected tab, including the initial welcome tab.
+2. Use `new_tab` only when the user requests an additional tab or the task must keep multiple pages open concurrently.
+3. Read its stable logical `tabId`, current CDP `targetId`, URL, and title.
+4. Call Chrome DevTools MCP `list_pages` and match the live page by URL/title.
+5. Use Chrome DevTools MCP's numeric `pageId` for page-scoped DevTools operations.
 
 `tabId`, `targetId`, and Chrome DevTools MCP's `pageId` are different identities:
 
@@ -272,5 +274,7 @@ Release verification:
 bun run check
 bun run test:packed
 bun run test:mcp
-npm publish --access public
 ```
+
+Publishing is tag-driven through `.github/workflows/publish.yml`. Set the package version, push `main`, then push the
+matching `v<version>` tag. GitHub reruns `check` and `test:packed` before publishing through npm trusted publishing.

bun.lock

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@neriousy/opencode-browser",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "An Electron browser surface for the OpenCode v2 TUI",
   "keywords": [
     "opencode",
@@ -65,7 +65,7 @@
     "@opentui/solid": "0.4.5",
     "@types/bun": "latest",
     "@types/node": "^24.0.0",
-    "opentui-browser": "0.3.0",
+    "opentui-browser": "0.3.1",
     "oxfmt": "0.41.0",
     "solid-js": "1.9.12",
     "typescript": "^5"

package.json

@@ -4,6 +4,7 @@ import { useTerminalDimensions } from "@opentui/solid"
 import { For, Show, createMemo, createSignal } from "solid-js"
 import type { BrowserSession } from "./browser-session.js"
 import type { BrowserTabController, BrowserTabState } from "./browser-tab.js"
+import { browserTabLabel } from "./browser-ui.js"
 
 type BrowserTabItem =
   | {
@@ -28,17 +29,6 @@ type BrowserTabItem =
       readonly close: () => void
     }
 
-function browserPageLabel(title: string, url: string): string {
-  const cleanTitle = title.replace(/[\u0000-\u001f\u007f]/gu, " ").trim()
-  if (cleanTitle) return cleanTitle
-  try {
-    const parsed = new URL(url)
-    return parsed.hostname || "New tab"
-  } catch {
-    return "New tab"
-  }
-}
-
 export function BrowserTabStrip(props: {
   readonly context: Context
   readonly tab: BrowserTabState
@@ -108,7 +98,7 @@ export function BrowserTabStrip(props: {
       ? props.sessionSnapshot().tabs.map((item) => ({
           type: "browser",
           id: `browser:${item.tabId}`,
-          title: browserPageLabel(item.title, item.url),
+          title: browserTabLabel(item.title, item.url),
           active: props.snapshot().active && item.tabId === props.sessionSnapshot().selectedTabId,
           busy: item.loading || (props.snapshot().loading && item.tabId === props.sessionSnapshot().selectedTabId),
           attention: false,

src/browser-tab-strip.tsx

@@ -106,39 +106,40 @@ export function createBrowserTabController(
     if (!tabId || !page) throw new Error("No browser tab is selected")
     return { tabId, page }
   }
-
-  return {
-    show() {
-      tab.show()
-      return status()
-    },
-    async open(url) {
-      const normalized = normalizeBrowserUrl(url, ["http:", "https:"])
-      tab.show()
-      tab.setLoading(true)
-      const page = session.selectedPage()
-      if (!page) {
-        try {
-          const created = await session.newTab(normalized)
-          expectedUrls.set(created.tabId, normalized)
-          tab.setLoading(created.page.loading)
-          return status()
-        } catch (error) {
-          tab.setLoading(false)
-          throw error
-        }
-      }
-      const tabId = session.snapshot().selectedTabId
-      if (!tabId) throw new Error("No browser tab is selected")
-      expectedUrls.set(tabId, normalized)
+  const open = async (url: string) => {
+    const normalized = normalizeBrowserUrl(url, ["http:", "https:"])
+    tab.show()
+    tab.setLoading(true)
+    const page = session.selectedPage()
+    if (!page) {
       try {
-        await page.goto(normalized)
+        const created = await session.newTab(normalized)
+        expectedUrls.set(created.tabId, normalized)
+        tab.setLoading(created.page.loading)
         return status()
       } catch (error) {
         tab.setLoading(false)
         throw error
       }
+    }
+    const tabId = session.snapshot().selectedTabId
+    if (!tabId) throw new Error("No browser tab is selected")
+    expectedUrls.set(tabId, normalized)
+    try {
+      await page.goto(normalized)
+      return status()
+    } catch (error) {
+      tab.setLoading(false)
+      throw error
+    }
+  }
+
+  return {
+    show() {
+      tab.show()
+      return status()
     },
+    open: (url) => open(url),
     async newTab(url) {
       const normalized = url === undefined ? initialUrl : normalizeBrowserUrl(url, ["http:", "https:"])
       tab.show()
@@ -168,7 +169,28 @@ export function createBrowserTabController(
       return status()
     },
     async closeTab(tabId) {
-      if (!(await session.closeTab(tabId))) throw new Error(`Browser tab not found: ${tabId ?? "selected"}`)
+      const before = session.snapshot()
+      const previousTab = tab.snapshot()
+      const closingTabId = tabId ?? before.selectedTabId
+      const closingFinalTab = before.tabs.length === 1 && before.tabs[0]?.tabId === closingTabId
+      const closedTab = closingFinalTab ? tab.close() : undefined
+      const restoreTab = () => {
+        if (!closedTab || tab.snapshot() !== closedTab || !previousTab.open) return
+        tab.show()
+        if (!previousTab.active) tab.hide()
+        if (previousTab.loading) tab.setLoading(true)
+      }
+      let closed: boolean
+      try {
+        closed = await session.closeTab(tabId)
+      } catch (error) {
+        restoreTab()
+        throw error
+      }
+      if (!closed) {
+        restoreTab()
+        throw new Error(`Browser tab not found: ${tabId ?? "selected"}`)
+      }
       await session.settle()
       return status()
     },

src/browser-tab.ts

@@ -3,6 +3,7 @@ import { CliRenderEvents, InputRenderable, type Renderable } from "@opentui/core
 import { createEffect, createSignal, onCleanup } from "solid-js"
 import type { BrowserSessionPage } from "./browser-session.js"
 import type { BrowserTabController } from "./browser-tab.js"
+import { browserAddressValue } from "./browser-ui.js"
 
 export function BrowserToolbar(props: {
   readonly context: Context
@@ -11,7 +12,7 @@ export function BrowserToolbar(props: {
   readonly focusBrowserSurface: () => void
   readonly registerAddressInput: (input: InputRenderable) => () => void
 }) {
-  const [address, setAddress] = createSignal(props.state().url)
+  const [address, setAddress] = createSignal(browserAddressValue(props.state().url))
   const [editing, setEditing] = createSignal(false)
   let input: InputRenderable | undefined
   let releaseInput: (() => void) | undefined
@@ -35,7 +36,7 @@ export function BrowserToolbar(props: {
     try {
       const status = await props.controller.open(value)
       if (generation !== submissionGeneration || input?.isDestroyed) return
-      setAddress(status.currentUrl)
+      setAddress(browserAddressValue(status.currentUrl))
       input?.blur()
       props.focusBrowserSurface()
     } catch (error) {
@@ -47,7 +48,7 @@ export function BrowserToolbar(props: {
   }
 
   createEffect(() => {
-    const current = props.state().url
+    const current = browserAddressValue(props.state().url)
     if (!editing() && current !== address()) setAddress(current)
   })
   const onFocusedRenderable = (current: Renderable | null) => setEditing(current === input)

src/browser-toolbar.tsx

@@ -1 +1,19 @@
+import { DEFAULT_BROWSER_URL } from "./constants.js"
+
 export const BROWSER_IDLE_FOOTER = " ctrl+l location · ctrl+shift+b back "
+
+export function browserAddressValue(url: string): string {
+  return url === DEFAULT_BROWSER_URL ? "" : url
+}
+
+export function browserTabLabel(title: string, url: string): string {
+  if (url === DEFAULT_BROWSER_URL) return "New tab"
+  const cleanTitle = title.replace(/[\u0000-\u001f\u007f]/gu, " ").trim()
+  if (cleanTitle) return cleanTitle
+  try {
+    const parsed = new URL(url)
+    return parsed.hostname || "New tab"
+  } catch {
+    return "New tab"
+  }
+}

src/browser-ui.ts

@@ -8,6 +8,7 @@ import { BrowserSurface } from "./browser-surface.js"
 import { BrowserTabStrip } from "./browser-tab-strip.js"
 import type { BrowserTabController, BrowserTabState } from "./browser-tab.js"
 import { BrowserToolbar } from "./browser-toolbar.js"
+import { browserAddressValue } from "./browser-ui.js"
 import { BROWSER_MODE } from "./constants.js"
 import { createBrowserPresentationTransitions } from "./presentation.js"
 
@@ -59,7 +60,7 @@ export function BrowserWorkspace(props: {
   const focusAddress = () => {
     const input = currentAddressInput()
     if (!input || input.isDestroyed) return false
-    input.value = selectedPageState()?.url ?? props.controller.status().currentUrl
+    input.value = browserAddressValue(selectedPageState()?.url ?? props.controller.status().currentUrl)
     input.focus()
     input.selectAll()
     return true
@@ -71,7 +72,7 @@ export function BrowserWorkspace(props: {
   const cancelAddress = () => {
     const input = currentAddressInput()
     if (!input?.focused) return false
-    input.value = selectedPageState()?.url ?? props.controller.status().currentUrl
+    input.value = browserAddressValue(selectedPageState()?.url ?? props.controller.status().currentUrl)
     input.blur()
     focusBrowserSurface()
     return true