src-browser-skilllisted

# local-search / src/browser ## Purpose Browser transport and runtime scripts for local signed-in browser control. ## Mental model & key files - `discovery.rs` finds a browser-level CDP websocket from `--cdp`, saved config, `DevToolsActivePort`, or common localhost ports. - `cdp.rs` is a minimal browser-level CDP client using flattened target sessions. - `scripts.rs` stores JavaScript snippets evaluated in the page for snapshots, interactions, extraction, readable content, and in-browser fetch. ## Patterns to follow / invariants - Connect to the browser websocket, then attach to a page target with `Target.attachToTarget` and `flatten: true`. - Keep JavaScript snippets deterministic and return JSON-serializable values. - Resolve `@eN` refs through `data-local-browser-ref`; `snapshot` is what assigns those refs. - Default command discovery should prefer the managed local-search profile unless the user explicitly passes `--cdp`; direct discovery still supports explicit endpoints. ## Common tasks → first action - Add a CDP primitive: implement it on `CdpClient`, then call it from commands. - Add a DOM operation: add a snippet function in `scripts.rs` and JSON-test the output through a real browser page. - Add browser discovery: extend `devtools_files()` or explicit endpoint parsing. ## Gotchas - `/json/version` can return 404 on newer Chrome normal-profile debugging; the `DevToolsActivePort` browser websocket is the reliable path. - `Runtime.evaluate` needs `