Skip to content

Port from deprecated herdr-browser to terminal-browser - #1

Open
punk-dev-robot wants to merge 1 commit into
plannotator:mainfrom
punk-dev-robot:terminal-browser-port
Open

Port from deprecated herdr-browser to terminal-browser#1
punk-dev-robot wants to merge 1 commit into
plannotator:mainfrom
punk-dev-robot:terminal-browser-port

Conversation

@punk-dev-robot

Copy link
Copy Markdown

What changed

Port from the deprecated herdr-browser plugin to the terminal-browser CLI, which replaced it as Herdr's browser surface.

  • present: terminal-browser open <url> --split right against the requesting pane (HERDR_PANE_ID pinned in the child env), map the opened browser to its Herdr pane via terminal-browser ls --json (retried briefly), best-effort herdr pane zoom --on to keep the previous zoomed presentation
  • dismiss: herdr pane close <paneId>, idempotent on pane_not_found
  • runtime discovery: resolve the terminal-browser executable (env override → cached config → PATH → ~/.local/bin) instead of inspecting the official.browser plugin root
  • deadline: a 13s overall AbortSignal keeps the present flow inside Plannotator's 15s presentation budget even in worst-case timeout stacking
  • doctor: probes the resolved binary with --version instead of only reporting a path
  • integration config schema 2 → 3 (records terminalBrowserBin); re-run configure after upgrading
  • min Herdr 0.8.2 (terminal-browser's own floor; it drives herdr pane split internally)

The presenter stdin protocol is unchanged (protocol 1, present/dismiss, handle={paneId}).

Validation

  • bun test (33) and tsc --noEmit clean
  • Live on Herdr 0.8.2 + terminal-browser 0.6.0: full present → dismiss round trip via bin/herdr-plannotator-present, configure + doctor actions green, pane opens zoomed and closes cleanly

Context

Ready for Plannotator's external presenter support (backnotprop/plannotator#1147) — verified end-to-end against this helper. Interim users can bridge with a BROWSER/PLANNOTATOR_BROWSER wrapper script until that lands (note: backnotprop/plannotator#1391 affects PLANNOTATOR_BROWSER script paths on macOS via the pi extension).

herdr-browser (official.browser) was deprecated in favor of the
terminal-browser CLI, which ships its own thin Herdr plugin. Present now
runs 'terminal-browser open <url> --split right' against the requesting
pane, maps the opened browser to its Herdr pane via 'ls --json', and
zooms it; dismiss closes the pane. The presenter stdin protocol is
unchanged. Runtime discovery resolves the terminal-browser executable
instead of inspecting a plugin root; the integration config schema is
now 3 and records it. A 13-second overall deadline keeps present inside
Plannotator's 15-second budget, and doctor probes the resolved binary
with --version.

Requires Herdr 0.8.2, matching terminal-browser's own floor.
@gwynnnplaine

Copy link
Copy Markdown

@backnotprop pls

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants