Scout

wiki/decisions/2026-06-12-embedded-live-browser-direction.md

2026-06-12 — Embedded Live Browser via CDP screencast (direction)

Status: Direction agreed with Arijit; formal ADR to be written in repo during Phase B.

Context: Scout's Capture Workbench shows static screenshots; blocked sites require escalating to the user's real Chrome. Arijit asked for a built-in browser inside Scout to open, navigate, crawl, and screenshot blocked sites inline.

Decision: Stream Scout's existing server-side Playwright Chromium into the UI using CDP Page.startScreencast over a WebSocket, forwarding mouse/keyboard back via CDP Input.dispatch* (the Browserless/Steel embedded-view pattern). "Crawl from this session" reuses the authenticated browser context. Iframing target sites is impossible (X-Frame-Options/CSP).

Caveat: Still automated Chromium — hardened WAFs (Akamai-class) may fingerprint it. Slots between scout-browser and user-browser in the escalation ladder; the user's real Chrome remains the final escape hatch.

Build plan: Phase B mockup centerpiece; Phase C slice C0.6 (after SSE infra, C0.3).