History

王性驊 5507e5b4b5 P4: human browser handoff + product notes		2026-09-13 16:15:27 +08:00
..
README.md	P4: human browser handoff + product notes	2026-09-13 16:15:27 +08:00
browser_helper.mjs	P4: human browser handoff + product notes	2026-09-13 16:15:27 +08:00
package.json	P3: Playwright DOM browser tools (optional)	2026-09-13 15:57:57 +08:00

README.md

GrokBoy Playwright helper (optional)

Thin Node script used by Rust browser_* tools (P3) and human handoff (P4).

Install

cd tools/playwright
npm install
npx playwright install chromium

Protocol

JSONL daemon (default): one JSON request per stdin line → one JSON response on stdout.
One-shot: node browser_helper.mjs --cmd '{"op":"ping"}'
Self-test (no Chromium): npm run self-test

Ops: ping, navigate, snapshot/dom, click, type, eval, close, status, handoff_prepare.

`handoff_prepare`

Ensures a headed (visible) Chromium window and brings it to front. If the daemon was headless, closes and relaunches headed, then navigates back to the last URL when possible.

Note: relaunch uses a new browser context (cookies from the prior headless session are not carried unless storage state is added later). Prefer GROKBOY_BROWSER_HEADED=1 so the first launch is already headed and state survives across handoff within one run.

Env: GROKBOY_BROWSER_HEADED=1 launches headed for normal navigate as well.

Prefer CSS selector or role+name over screenshots.