@browserbridge/bbx 1.0.0 → 1.1.0

package/skills/browser-bridge/references/protocol.md

@@ -29,65 +29,66 @@ The table below includes the legacy capability bucket for each method so agents
 
 ## All Methods (57)
 
-| # | Method | Tab? | CDP? | Group | Capability | Notes |
-|---|--------|------|------|-------|------------|-------|
-| 1 | `access.request` | No | - | system | `-` | Request window access; surfaces Enable prompt in extension UI |
-| 2 | `tabs.list` | No | - | tabs | `-` | Discover available tabs |
-| 3 | `tabs.create` | No | - | tabs | `tabs.manage` | Open a new tab; optional `url` and `active` |
-| 4 | `tabs.close` | No | - | tabs | `tabs.manage` | Close a tab by `tabId` |
-| 5 | `skill.get_runtime_context` | No | - | system | `-` | Live budget presets + method groups |
-| 6 | `setup.get_status` | No | - | system | `-` | Global MCP config + CLI skill install status |
-| 7 | `setup.install` | No | - | system | `-` | Install or uninstall MCP/skill integration targets |
-| 8 | `health.ping` | No | - | system | `-` | Connectivity check + access routing state |
-| 9 | `log.tail` | No | - | system | `-` | Recent bridge logs |
-| 10 | `page.get_state` | Yes | - | page | `page.read` | URL, readiness, focus, scroll, viewport |
-| 11 | `page.evaluate` | Yes | CDP | page | `page.evaluate` | JS expression in page context; last resort |
-| 12 | `page.get_console` | Yes | - | page | `page.read` | Buffered console messages; filter by `level`, `limit` |
-| 13 | `page.wait_for_load_state` | Yes | - | wait | `page.read` | Block until tab `complete`; `timeoutMs` capped 30 s |
-| 14 | `page.get_storage` | Yes | - | page | `page.read` | `localStorage`/`sessionStorage`; optional `keys` |
-| 15 | `page.get_text` | Yes | - | page | `page.read` | Full page text; `textBudget` limits size |
-| 16 | `page.get_network` | Yes | - | page | `network.read` | Intercepted fetch/XHR; `limit` entries |
-| 17 | `navigation.navigate` | Yes | - | navigate | `navigation.control` | Go to URL; `waitForLoad` default true |
-| 18 | `navigation.reload` | Yes | - | navigate | `navigation.control` | Reload; `waitForLoad` default true |
-| 19 | `navigation.go_back` | Yes | - | navigate | `navigation.control` | History back |
-| 20 | `navigation.go_forward` | Yes | - | navigate | `navigation.control` | History forward |
-| 21 | `dom.query` | Yes | - | inspect | `dom.read` | Query subtree with budget constraints |
-| 22 | `dom.describe` | Yes | - | inspect | `dom.read` | Single element details via `elementRef` |
-| 23 | `dom.get_text` | Yes | - | inspect | `dom.read` | Text content with `textBudget` |
-| 24 | `dom.get_attributes` | Yes | - | inspect | `dom.read` | Targeted attribute read |
-| 25 | `dom.wait_for` | Yes | - | wait | `dom.read` | Wait for DOM condition; MutationObserver + polling |
-| 26 | `dom.find_by_text` | Yes | - | inspect | `dom.read` | Find by visible text; returns `{nodes, count}` |
-| 27 | `dom.find_by_role` | Yes | - | inspect | `dom.read` | Find by ARIA role; optional `name` filter |
-| 28 | `dom.get_html` | Yes | - | inspect | `dom.read` | `innerHTML`/`outerHTML`; `maxLength` truncation |
-| 29 | `dom.get_accessibility_tree` | Yes | CDP | inspect | `dom.read` | Full a11y tree; `maxNodes`/`maxDepth` limits |
-| 30 | `layout.get_box_model` | Yes | - | inspect | `layout.read` | Element geometry (no budget needed) |
-| 31 | `layout.hit_test` | Yes | - | inspect | `layout.read` | Element at viewport point |
-| 32 | `styles.get_computed` | Yes | - | inspect | `styles.read` | Computed CSS; always set `properties` |
-| 33 | `styles.get_matched_rules` | Yes | - | inspect | `styles.read` | Matching CSS rules |
-| 34 | `viewport.scroll` | Yes | - | navigate | `viewport.control` | Window or element scroll |
-| 35 | `viewport.resize` | Yes | CDP | navigate | `viewport.control` | Set viewport via device emulation; `reset: true` |
-| 36 | `input.click` | Yes | - | interact | `automation.input` | DOM-level click |
-| 37 | `input.focus` | Yes | - | interact | `automation.input` | Focus element |
-| 38 | `input.type` | Yes | - | interact | `automation.input` | Type into input/textarea/contenteditable |
-| 39 | `input.press_key` | Yes | - | interact | `automation.input` | Single key event |
-| 40 | `input.set_checked` | Yes | - | interact | `automation.input` | Checkbox/radio toggle |
-| 41 | `input.select_option` | Yes | - | interact | `automation.input` | Native select by value/label/index |
-| 42 | `input.hover` | Yes | - | interact | `automation.input` | mouseenter/mouseover/mousemove; optional `duration` |
-| 43 | `input.drag` | Yes | - | interact | `automation.input` | Full drag-and-drop event sequence |
-| 44 | `input.scroll_into_view` | Yes | - | interact | `automation.input` | Explicitly scroll target into view before inspect/capture |
-| 45 | `screenshot.capture_element` | Yes | CDP | capture | `screenshot.partial` | Cropped element screenshot |
-| 46 | `screenshot.capture_region` | Yes | CDP | capture | `screenshot.partial` | Cropped viewport region |
-| 47 | `screenshot.capture_full_page` | Yes | CDP | capture | `screenshot.partial` | Full document screenshot; use only when page-level context is necessary |
-| 48 | `patch.apply_styles` | Yes | - | patch | `patch.styles` | Reversible CSS patch; `verify` returns computed result |
-| 49 | `patch.apply_dom` | Yes | - | patch | `patch.dom` | Reversible DOM mutation; `verify` returns result |
-| 50 | `patch.list` | Yes | - | patch | `patch.dom` | Active patches |
-| 51 | `patch.rollback` | Yes | - | patch | `patch.dom` | Revert one patch |
-| 52 | `patch.commit_session_baseline` | Yes | - | patch | `patch.dom` | Accept current state as baseline |
-| 53 | `performance.get_metrics` | Yes | CDP | performance | `performance.read` | Chrome performance counters |
-| 54 | `cdp.get_document` | Yes | CDP | cdp | `cdp.dom_snapshot` | DevTools document tree |
-| 55 | `cdp.get_dom_snapshot` | Yes | CDP | cdp | `cdp.dom_snapshot` | DevTools DOM snapshot |
-| 56 | `cdp.get_box_model` | Yes | CDP | cdp | `cdp.box_model` | DevTools-backed element geometry |
-| 57 | `cdp.get_computed_styles_for_node` | Yes | CDP | cdp | `cdp.styles` | DevTools-backed computed styles |
+| #   | Method                             | Tab? | CDP? | Group       | Capability           | Notes                                                                   |
+| --- | ---------------------------------- | ---- | ---- | ----------- | -------------------- | ----------------------------------------------------------------------- |
+| 1   | `access.request`                   | No   | -    | system      | `-`                  | Request window access; surfaces Enable prompt in extension UI           |
+| 2   | `tabs.list`                        | No   | -    | tabs        | `-`                  | Discover available tabs                                                 |
+| 3   | `tabs.create`                      | No   | -    | tabs        | `tabs.manage`        | Open a new tab; optional `url` and `active`                             |
+| 4   | `tabs.close`                       | No   | -    | tabs        | `tabs.manage`        | Close a tab by `tabId`                                                  |
+| 5   | `skill.get_runtime_context`        | No   | -    | system      | `-`                  | Live budget presets + method groups                                     |
+| 6   | `setup.get_status`                 | No   | -    | system      | `-`                  | Global MCP config + CLI skill install status                            |
+| 7   | `setup.install`                    | No   | -    | system      | `-`                  | Install or uninstall MCP/skill integration targets                      |
+| 8   | `health.ping`                      | No   | -    | system      | `-`                  | Connectivity check + access routing state                               |
+| 9   | `log.tail`                         | No   | -    | system      | `-`                  | Recent bridge logs                                                      |
+| 10  | `page.get_state`                   | Yes  | -    | page        | `page.read`          | URL, readiness, focus, scroll, viewport                                 |
+| 11  | `page.evaluate`                    | Yes  | CDP  | page        | `page.evaluate`      | JS expression in page context; last resort                              |
+| 12  | `page.get_console`                 | Yes  | -    | page        | `page.read`          | Buffered console messages; filter by `level`, `limit`                   |
+| 13  | `page.wait_for_load_state`         | Yes  | -    | wait        | `page.read`          | Block until tab `complete`; `timeoutMs` capped 30 s                     |
+| 14  | `page.get_storage`                 | Yes  | -    | page        | `page.read`          | `localStorage`/`sessionStorage`; optional `keys`                        |
+| 15  | `page.get_text`                    | Yes  | -    | page        | `page.read`          | Full page text; `textBudget` limits size                                |
+| 16  | `page.get_network`                 | Yes  | -    | page        | `network.read`       | Intercepted fetch/XHR; `limit` entries                                  |
+| 17  | `navigation.navigate`              | Yes  | -    | navigate    | `navigation.control` | Go to URL; `waitForLoad` default true                                   |
+| 18  | `navigation.reload`                | Yes  | -    | navigate    | `navigation.control` | Reload; `waitForLoad` default true                                      |
+| 19  | `navigation.go_back`               | Yes  | -    | navigate    | `navigation.control` | History back                                                            |
+| 20  | `navigation.go_forward`            | Yes  | -    | navigate    | `navigation.control` | History forward                                                         |
+| 21  | `dom.query`                        | Yes  | -    | inspect     | `dom.read`           | Query subtree with budget constraints                                   |
+| 22  | `dom.describe`                     | Yes  | -    | inspect     | `dom.read`           | Single element details via `elementRef`                                 |
+| 23  | `dom.get_text`                     | Yes  | -    | inspect     | `dom.read`           | Text content with `textBudget`                                          |
+| 24  | `dom.get_attributes`               | Yes  | -    | inspect     | `dom.read`           | Targeted attribute read                                                 |
+| 25  | `dom.wait_for`                     | Yes  | -    | wait        | `dom.read`           | Wait for DOM condition; MutationObserver + polling                      |
+| 26  | `dom.find_by_text`                 | Yes  | -    | inspect     | `dom.read`           | Find by visible text; returns `{nodes, count}`                          |
+| 27  | `dom.find_by_role`                 | Yes  | -    | inspect     | `dom.read`           | Find by ARIA role; optional `name` filter                               |
+| 28  | `dom.get_html`                     | Yes  | -    | inspect     | `dom.read`           | `innerHTML`/`outerHTML`; `maxLength` truncation                         |
+| 29  | `dom.get_accessibility_tree`       | Yes  | CDP  | inspect     | `dom.read`           | Full a11y tree; `maxNodes`/`maxDepth` limits                            |
+| 30  | `layout.get_box_model`             | Yes  | -    | inspect     | `layout.read`        | Element geometry (no budget needed)                                     |
+| 31  | `layout.hit_test`                  | Yes  | -    | inspect     | `layout.read`        | Element at viewport point                                               |
+| 32  | `styles.get_computed`              | Yes  | -    | inspect     | `styles.read`        | Computed CSS; always set `properties`                                   |
+| 33  | `styles.get_matched_rules`         | Yes  | -    | inspect     | `styles.read`        | Matching CSS rules                                                      |
+| 34  | `viewport.scroll`                  | Yes  | -    | navigate    | `viewport.control`   | Window or element scroll                                                |
+| 35  | `viewport.resize`                  | Yes  | CDP  | navigate    | `viewport.control`   | Set viewport via device emulation; `reset: true`                        |
+| 36  | `input.click`                      | Yes  | -    | interact    | `automation.input`   | DOM-level click                                                         |
+| 37  | `input.focus`                      | Yes  | -    | interact    | `automation.input`   | Focus element                                                           |
+| 38  | `input.type`                       | Yes  | -    | interact    | `automation.input`   | Type into input/textarea/contenteditable                                |
+| 39  | `input.press_key`                  | Yes  | -    | interact    | `automation.input`   | Single key event                                                        |
+| 40  | `input.set_checked`                | Yes  | -    | interact    | `automation.input`   | Checkbox/radio toggle                                                   |
+| 41  | `input.select_option`              | Yes  | -    | interact    | `automation.input`   | Native select by value/label/index                                      |
+| 42  | `input.hover`                      | Yes  | -    | interact    | `automation.input`   | mouseenter/mouseover/mousemove; optional `duration`                     |
+| 43  | `input.drag`                       | Yes  | -    | interact    | `automation.input`   | Full drag-and-drop event sequence                                       |
+| 44  | `input.scroll_into_view`           | Yes  | -    | interact    | `automation.input`   | Explicitly scroll target into view before inspect/capture               |
+| 45  | `screenshot.capture_element`       | Yes  | CDP  | capture     | `screenshot.partial` | Cropped element screenshot                                              |
+| 46  | `screenshot.capture_region`        | Yes  | CDP  | capture     | `screenshot.partial` | Cropped viewport region                                                 |
+| 47  | `screenshot.capture_full_page`     | Yes  | CDP  | capture     | `screenshot.partial` | Full document screenshot; use only when page-level context is necessary |
+| 48  | `patch.apply_styles`               | Yes  | -    | patch       | `patch.styles`       | Reversible CSS patch; `verify` returns computed result                  |
+| 49  | `patch.apply_dom`                  | Yes  | -    | patch       | `patch.dom`          | Reversible DOM mutation; `verify` returns result                        |
+| 50  | `patch.list`                       | Yes  | -    | patch       | `patch.dom`          | Active patches                                                          |
+| 51  | `patch.rollback`                   | Yes  | -    | patch       | `patch.dom`          | Revert one patch                                                        |
+| 52  | `patch.commit_session_baseline`    | Yes  | -    | patch       | `patch.dom`          | Accept current state as baseline                                        |
+| 53  | `performance.get_metrics`          | Yes  | CDP  | performance | `performance.read`   | Chrome performance counters                                             |
+| 54  | `cdp.get_document`                 | Yes  | CDP  | cdp         | `cdp.dom_snapshot`   | DevTools document tree                                                  |
+| 55  | `cdp.get_dom_snapshot`             | Yes  | CDP  | cdp         | `cdp.dom_snapshot`   | DevTools DOM snapshot                                                   |
+| 56  | `cdp.get_box_model`                | Yes  | CDP  | cdp         | `cdp.box_model`      | DevTools-backed element geometry                                        |
+| 57  | `cdp.get_computed_styles_for_node` | Yes  | CDP  | cdp         | `cdp.styles`         | DevTools-backed computed styles                                         |
+| 58  | `cdp.dispatch_key_event`           | Yes  | CDP  | cdp         | `cdp.input`          | DevTools keyDown/keyUp without foreground focus                         |
 
 ## CLI
 
@@ -98,26 +99,31 @@ bbx call --tab 123 <method> '{...}'         # explicit tab target inside enabled
 bbx batch '[{"method":"...","params":{}}]'  # parallel calls
 ```
 
-**Convenience shortcuts:** `access-request`, `dom-query`, `describe`, `text`, `styles`, `box`, `click`, `focus`, `type`, `press-key`, `patch-style`, `patch-text`, `patches`, `rollback`, `screenshot`, `eval`, `console`, `wait`, `find`, `find-role`, `html`, `hover`, `navigate`, `storage`, `tab-create`, `tab-close`, `page-text`, `network`, `a11y-tree`, `perf`, `resize`, `reload`, `back`, `forward`, `attrs`, `matched-rules`
+**Convenience shortcuts:** `access-request`, `dom-query`, `describe`, `text`, `styles`, `box`, `click`, `focus`, `type`, `press-key`, `cdp-press-key`, `patch-style`, `patch-text`, `patches`, `rollback`, `screenshot`, `eval`, `console`, `wait`, `find`, `find-role`, `html`, `hover`, `navigate`, `storage`, `tab-create`, `tab-close`, `page-text`, `network`, `a11y-tree`, `perf`, `resize`, `reload`, `back`, `forward`, `attrs`, `matched-rules`
 
 Newer bridge methods such as `input.scroll_into_view` and `screenshot.capture_full_page` currently use the raw path: `bbx call <method> '{...}'`.
 
 ## Method Details
 
 ### access.request
+
 Request Browser Bridge access for the focused browser window. Surfaces an Enable prompt in the extension popup or side panel so the user can grant access. Does not require an existing session.
+
 ```bash
 bbx access-request
 bbx call access.request
 ```
+
 If a tab-bound call returns `ACCESS_DENIED`, it also surfaces the Enable prompt automatically — so explicit `access.request` is optional but useful for proactive setup.
 
 If access is already pending for a window, do not call `access.request` again. Ask the user to click `Enable` for the requested window and wait for confirmation before continuing.
 
 ### page.evaluate
+
 Run a JS expression in the page context via CDP `Runtime.evaluate`. Expression is evaluated as a statement and the return value is serialized. Supports `awaitPromise` for async expressions.
 
 Use only when non-debugger reads are insufficient. Prefer `page.get_storage`, `page.get_text`, `page.get_console`, `page.get_network`, or DOM methods first.
+
 ```bash
 bbx eval 'document.title'
 bbx eval 'window.__NEXT_DATA__.props'
@@ -125,22 +131,29 @@ bbx call page.evaluate '{"expression":"await fetch(\"/api/health\").then(r=>r.js
 ```
 
 ### page.get_console
+
 Read buffered console output. The console interceptor is auto-installed on first call. Captures `log`, `warn`, `error`, `info`, `debug` plus uncaught exceptions and unhandled rejections.
+
 ```bash
 bbx console                    # all levels
 bbx console error              # errors only
 bbx call page.get_console '{"level":"error","limit":20,"clear":true}'
 ```
+
 Responses include `dropped` when older buffered entries were discarded on noisy pages.
 
 ### page.wait_for_load_state
+
 Block until the tab reaches `complete` status. Useful after `input.click` on a navigation link.
+
 ```bash
 bbx call page.wait_for_load_state '{"timeoutMs":10000}'
 ```
 
 ### page.get_storage
+
 Read `localStorage` or `sessionStorage` entries. Values truncated at 500 chars each.
+
 ```bash
 bbx storage                        # all localStorage
 bbx storage session token,user     # specific sessionStorage keys
@@ -148,67 +161,87 @@ bbx call page.get_storage '{"type":"session","keys":["token"]}'
 ```
 
 ### dom.query
+
 Run a bounded breadth-first DOM summary rooted at a selector or existing ref. Returns `{nodes, revision, truncated, registrySize}` and may also include `_registryPruned: true` when the element registry evicted older refs.
+
 ```bash
 bbx dom-query main
 bbx call dom.query '{"selector":"main","maxNodes":10,"attributeAllowlist":["class","data-testid"]}'
 ```
+
 If `_registryPruned` is true, refresh previously cached refs before reusing them.
 
 ### dom.wait_for
+
 Wait for a DOM condition using MutationObserver + 250 ms polling fallback. Returns `{found, elementRef, duration}`.
+
 - `state`: `attached` (default), `detached`, `visible`, `hidden`
 - `text`: optional text content filter
 - `timeoutMs`: 100–30000 (default 5000)
+
 ```bash
 bbx wait '.toast-success' 5000
 bbx call dom.wait_for '{"selector":".modal","state":"visible","timeoutMs":10000}'
 ```
 
 ### dom.find_by_text
+
 Find elements matching visible text content. Like Playwright's `getByText`.
+
 ```bash
 bbx find 'Submit Order'
 bbx call dom.find_by_text '{"text":"Submit","scope":"button","exact":false}'
 ```
 
 ### dom.find_by_role
+
 Find elements by ARIA role (explicit `role` attribute or implicit from HTML tag). Covers 25+ implicit role mappings.
+
 ```bash
 bbx find-role button 'Save'
 bbx call dom.find_by_role '{"role":"navigation"}'
 ```
 
 ### dom.get_html
+
 Get raw HTML of an element. Defaults to `innerHTML`; set `outer: true` for `outerHTML`.
+
 ```bash
 bbx html el_abc123
 bbx call dom.get_html '{"elementRef":"el_abc123","outer":true,"maxLength":2000}'
 ```
 
 ### input.hover
+
 Trigger CSS `:hover` state by dispatching `mouseenter`, `mouseover`, `mousemove`. Optional `duration` to hold hover before auto-releasing.
+
 ```bash
 bbx hover el_abc123
 bbx call input.hover '{"target":{"elementRef":"el_abc123"},"duration":1000}'
 ```
 
 ### input.drag
+
 Full drag-and-drop sequence: `mousedown → dragstart → drag → dragenter → dragover → drop → dragend → mouseup`. Accepts source target, destination target, and optional pixel offsets.
+
 ```bash
 bbx call input.drag '{"source":{"elementRef":"el_src"},"destination":{"elementRef":"el_dst"}}'
 bbx call input.drag '{"source":{"elementRef":"el_src"},"destination":{"elementRef":"el_dst"},"sourceOffset":{"x":10,"y":10}}'
 ```
 
 ### input.scroll_into_view
+
 Explicitly scroll an element into the visible viewport before inspecting, hovering, or capturing it.
+
 ```bash
 bbx call input.scroll_into_view '{"target":{"elementRef":"el_abc123"}}'
 bbx call input.scroll_into_view '{"target":{"selector":"[data-testid=\\"checkout-summary\\"]"}}'
 ```
 
 ### tabs.create
+
 Open a new browser tab. Optional `url` (defaults to `about:blank`) and `active` flag (defaults to `true`). Does not require a session.
+
 ```bash
 bbx tab-create https://example.com
 bbx call tabs.create '{"url":"https://example.com","active":false}'
@@ -217,20 +250,26 @@ bbx call tabs.create '{"url":"https://example.com","active":false}'
 The `bbx tab-create` shortcut intentionally covers the common case. Use `bbx call tabs.create ...` when you need advanced fields such as `active:false`.
 
 ### setup.get_status
+
 Inspect the host-side Browser Bridge setup. Returns global MCP config status for supported clients and global CLI skill install status for supported targets.
+
 ```bash
 bbx call setup.get_status
 ```
 
 ### tabs.close
+
 Close a tab by its `tabId`. Does not require a session.
+
 ```bash
 bbx tab-close 12345
 bbx call tabs.close '{"tabId":12345}'
 ```
 
 ### page.get_text
+
 Extract the full visible text content of the page (`document.body.innerText`). Truncated to `textBudget` (default 8000 chars). Lighter than `dom.query` on `body` when you only need text.
+
 ```bash
 bbx page-text
 bbx page-text 8000
@@ -238,18 +277,23 @@ bbx call page.get_text '{"textBudget":2000}'
 ```
 
 ### page.get_network
+
 Read intercepted fetch/XHR requests. The interceptor is auto-installed on first call (via MAIN world script). Returns `{entries, count}` sorted newest-first.
+
 ```bash
 bbx network
 bbx network 50
 bbx call page.get_network '{"limit":20,"clear":true}'
 ```
+
 Each entry: `{method, url, status, duration, initiator}`. Responses include `dropped` when older buffered entries were discarded.
 
 ### dom.get_accessibility_tree
+
 Retrieve the page's accessibility tree via CDP `Accessibility.getFullAXTree`. Each node is simplified to: `role`, `name`, `description`, `value`, `focused`, `required`, `checked`, `disabled`, `interactive`, `childIds`. Use `maxNodes` and `maxDepth` to control size.
 
 This is debugger-backed. Prefer `dom.find_by_role`, `dom.find_by_text`, and targeted `dom.query`/`dom.describe` first.
+
 ```bash
 bbx a11y-tree
 bbx a11y-tree 50 3
@@ -257,9 +301,11 @@ bbx call dom.get_accessibility_tree '{"maxNodes":100,"maxDepth":5}'
 ```
 
 ### viewport.resize
+
 Set the browser viewport to specific dimensions using CDP device emulation. Pass `reset: true` to clear the override.
 
 Debugger-backed. Use only when an exact viewport override is required for responsive verification.
+
 ```bash
 bbx resize 375 812
 bbx call viewport.resize '{"width":1024,"height":768}'
@@ -267,16 +313,20 @@ bbx call viewport.resize '{"reset":true}'
 ```
 
 ### performance.get_metrics
+
 Read Chrome performance counters via CDP `Performance.getMetrics`. Returns a flat `{metrics}` object with keys like `JSHeapUsedSize`, `LayoutCount`, `TaskDuration`, etc.
 
 Debugger-backed. Use after lighter reads fail to explain a performance symptom.
+
 ```bash
 bbx perf
 bbx call performance.get_metrics
 ```
 
 ### screenshot.capture_full_page
+
 Capture a full-document screenshot beyond the current viewport. Use only when element or tight region captures cannot express the issue. Chrome capture limits still apply on very large pages.
+
 ```bash
 bbx call screenshot.capture_full_page '{}'
 ```
@@ -284,21 +334,27 @@ bbx call screenshot.capture_full_page '{}'
 ## Request Envelope
 
 ```json
-{"id":"req_1","tab_id":123,"method":"dom.query","params":{},"meta":{"protocol_version":"1.0","token_budget":1200}}
+{
+  "id": "req_1",
+  "tab_id": 123,
+  "method": "dom.query",
+  "params": {},
+  "meta": { "protocol_version": "1.0", "token_budget": 1200 }
+}
 ```
 
 ## Error Codes
 
-| Code | Action | Recovery |
-|------|--------|----------|
-| `ACCESS_DENIED` | Turn on Browser Bridge for the target window | `retry: false` |
-| `TAB_MISMATCH` | Explicit `tabId` is missing, closed, or outside enabled window | `retry: false`, use `tabs.list` |
-| `ELEMENT_STALE` | Re-query DOM for fresh `elementRef` | `retry: false`, use `dom.query` |
-| `CONTENT_SCRIPT_UNAVAILABLE` | Page is restricted (chrome://, extensions, etc.) | `retry: false` |
-| `NATIVE_HOST_UNAVAILABLE` | Check daemon: `bbx status` | `retry: false` |
-| `EXTENSION_DISCONNECTED` | Extension not connected to daemon | `retry: true` after 3 s, check `health.ping` |
-| `TIMEOUT` | Wait/evaluate exceeded `timeoutMs` | `retry: true` after 1 s |
-| `RATE_LIMITED` | Too many requests | `retry: true` after 2 s |
+| Code                         | Action                                                         | Recovery                                     |
+| ---------------------------- | -------------------------------------------------------------- | -------------------------------------------- |
+| `ACCESS_DENIED`              | Turn on Browser Bridge for the target window                   | `retry: false`                               |
+| `TAB_MISMATCH`               | Explicit `tabId` is missing, closed, or outside enabled window | `retry: false`, use `tabs.list`              |
+| `ELEMENT_STALE`              | Re-query DOM for fresh `elementRef`                            | `retry: false`, use `dom.query`              |
+| `CONTENT_SCRIPT_UNAVAILABLE` | Page is restricted (chrome://, extensions, etc.)               | `retry: false`                               |
+| `NATIVE_HOST_UNAVAILABLE`    | Check daemon: `bbx status`                                     | `retry: false`                               |
+| `EXTENSION_DISCONNECTED`     | Extension not connected to daemon                              | `retry: true` after 3 s, check `health.ping` |
+| `TIMEOUT`                    | Wait/evaluate exceeded `timeoutMs`                             | `retry: true` after 1 s                      |
+| `RATE_LIMITED`               | Too many requests                                              | `retry: true` after 2 s                      |
 
 Timeout on content-script request → use narrower `dom.query` or CDP fallback.
 Timeout on navigation → increase `timeoutMs`, set `waitForLoad:false`, or check `page.get_state`.

package/skills/browser-bridge/references/tailwind.md

@@ -6,11 +6,11 @@
 
 Tailwind arbitrary-value classes use `[]` which are invalid in CSS selectors:
 
-| Class in HTML | ❌ Raw selector | ✅ Escaped selector |
-|---|---|---|
-| `top-[30px]` | `.top-[30px]` | `.top-\[30px\]` |
-| `bg-[#f00]` | `.bg-[#f00]` | `.bg-\[\#f00\]` |
-| `w-[calc(100%-2rem)]` | crashes | `.w-\[calc\(100\%-2rem\)\]` |
+| Class in HTML         | ❌ Raw selector | ✅ Escaped selector         |
+| --------------------- | --------------- | --------------------------- |
+| `top-[30px]`          | `.top-[30px]`   | `.top-\[30px\]`             |
+| `bg-[#f00]`           | `.bg-[#f00]`    | `.bg-\[\#f00\]`             |
+| `w-[calc(100%-2rem)]` | crashes         | `.w-\[calc\(100\%-2rem\)\]` |
 
 **Bridge auto-escapes** Tailwind brackets in `dom.query` selectors. But for `page.evaluate` or `dom.wait_for`, escape manually or avoid class-based selectors entirely.
 
@@ -37,6 +37,7 @@ bbx styles el_abc 'display,align-items,gap,padding,background-color,border-radiu
 ```
 
 Key patterns:
+
 - **Layout**: `styles.get_computed` with `display, flex-direction, gap, grid-template-columns`
 - **Spacing**: `layout.get_box_model` - gives padding/margin/border as numbers
 - **Colors**: `styles.get_computed` with `background-color, color, border-color`
@@ -75,9 +76,9 @@ Default Tailwind breakpoints: `sm: 640px`, `md: 768px`, `lg: 1024px`, `xl: 1280p
 
 ## Common Tailwind Anti-Patterns
 
-| Anti-pattern | Cost | Fix |
-|---|---|---|
-| Selecting by Tailwind class `.flex.items-center` | Fragile, breaks on refactor | `dom.find_by_role` or `dom.find_by_text` |
-| Parsing class string to infer styles | ~500 tok wasted | `styles.get_computed` with property list |
-| Patching by adding Tailwind classes | Won't work (classes need build) | `patch.apply_styles` with CSS properties |
-| Using `!important` in patches | Unnecessary | Inline styles already beat utilities |
+| Anti-pattern                                     | Cost                            | Fix                                      |
+| ------------------------------------------------ | ------------------------------- | ---------------------------------------- |
+| Selecting by Tailwind class `.flex.items-center` | Fragile, breaks on refactor     | `dom.find_by_role` or `dom.find_by_text` |
+| Parsing class string to infer styles             | ~500 tok wasted                 | `styles.get_computed` with property list |
+| Patching by adding Tailwind classes              | Won't work (classes need build) | `patch.apply_styles` with CSS properties |
+| Using `!important` in patches                    | Unnecessary                     | Inline styles already beat utilities     |

package/skills/browser-bridge/references/token-efficiency.md

@@ -2,11 +2,11 @@
 
 ## Budget Presets
 
-| Preset | maxNodes | maxDepth | textBudget | Use When |
-|--------|----------|----------|------------|----------|
-| quick | 5 | 2 | 300 | Checking one element or confirming state |
-| normal | 25 | 4 | 600 | General inspection (default) |
-| deep | 100 | 8 | 2000 | Complex nested components |
+| Preset | maxNodes | maxDepth | textBudget | Use When                                 |
+| ------ | -------- | -------- | ---------- | ---------------------------------------- |
+| quick  | 5        | 2        | 300        | Checking one element or confirming state |
+| normal | 25       | 4        | 600        | General inspection (default)             |
+| deep   | 100      | 8        | 2000       | Complex nested components                |
 
 Always start at **quick** or **normal**; widen only if the result indicates truncation.
 
@@ -51,23 +51,23 @@ Omitting allowlists or leaving the text budget wide open often returns 3–5× t
 
 ## Anti-Patterns (Token Waste)
 
-| Pattern | Cost | Fix |
-|---------|------|-----|
-| `dom.query` on `body` with no budget | ~2000 tok | Use specific selector + quick budget |
-| Screenshot before structured read | ~1500 tok wasted | Always `dom.query` or `styles.get_computed` first |
-| Re-querying DOM for same element | ~500 tok/call | Reuse `elementRef` from prior result |
-| Full-page screenshot | ~3000 tok | Use `screenshot.capture_element`, or `screenshot.capture_region` with a tight rect |
-| Requesting all computed styles | ~800 tok | Set `properties` list (usually 3–8 props) |
-| Multiple CLI calls for independent reads | overhead/call | Use `batch` command |
-| Guessing selectors for known labels | ~300 tok wasted/try | Use `dom.find_by_text` or `dom.find_by_role` |
-| Polling page state with repeated queries | ~500 tok/poll | Use `dom.wait_for` (single call, waits async) |
-| Inspecting DOM to read app state | ~800 tok | Use `page.evaluate` to read JS directly |
-| Re-querying after HMR without waiting | ~500 tok stale | `dom.wait_for` first, then query |
-| Separate call to verify a patch | ~500 tok wasted | Set `verify: true` on `patch.apply_styles` / `patch.apply_dom` to get computed result inline |
-| `dom.query` on body for page text | ~2000 tok | Use `page.get_text` (extracts innerText directly) |
-| Guessing interactive elements from DOM | ~600 tok/try | Use `dom.get_accessibility_tree` for semantic roles |
-| Fetching network via evaluate hacks | ~400 tok | Use `page.get_network` (auto-interceptor) |
-| Full a11y tree with no limits | ~3000 tok | Set `maxNodes` ≤ 50, `maxDepth` ≤ 4 |
+| Pattern                                  | Cost                | Fix                                                                                          |
+| ---------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------- |
+| `dom.query` on `body` with no budget     | ~2000 tok           | Use specific selector + quick budget                                                         |
+| Screenshot before structured read        | ~1500 tok wasted    | Always `dom.query` or `styles.get_computed` first                                            |
+| Re-querying DOM for same element         | ~500 tok/call       | Reuse `elementRef` from prior result                                                         |
+| Full-page screenshot                     | ~3000 tok           | Use `screenshot.capture_element`, or `screenshot.capture_region` with a tight rect           |
+| Requesting all computed styles           | ~800 tok            | Set `properties` list (usually 3–8 props)                                                    |
+| Multiple CLI calls for independent reads | overhead/call       | Use `batch` command                                                                          |
+| Guessing selectors for known labels      | ~300 tok wasted/try | Use `dom.find_by_text` or `dom.find_by_role`                                                 |
+| Polling page state with repeated queries | ~500 tok/poll       | Use `dom.wait_for` (single call, waits async)                                                |
+| Inspecting DOM to read app state         | ~800 tok            | Use `page.evaluate` to read JS directly                                                      |
+| Re-querying after HMR without waiting    | ~500 tok stale      | `dom.wait_for` first, then query                                                             |
+| Separate call to verify a patch          | ~500 tok wasted     | Set `verify: true` on `patch.apply_styles` / `patch.apply_dom` to get computed result inline |
+| `dom.query` on body for page text        | ~2000 tok           | Use `page.get_text` (extracts innerText directly)                                            |
+| Guessing interactive elements from DOM   | ~600 tok/try        | Use `dom.get_accessibility_tree` for semantic roles                                          |
+| Fetching network via evaluate hacks      | ~400 tok            | Use `page.get_network` (auto-interceptor)                                                    |
+| Full a11y tree with no limits            | ~3000 tok           | Set `maxNodes` ≤ 50, `maxDepth` ≤ 4                                                          |
 
 ## Efficient Loop
 
@@ -162,6 +162,7 @@ bbx eval 'module.hot?.status?.()'            # check HMR status (webpack)
 ## Parent-Agent Response Policy
 
 The subagent should return:
+
 - What was inspected (selector or elementRef)
 - What changed (if patching)
 - Whether it answers the question

package/skills/browser-bridge/references/ui-workflows.md

@@ -14,6 +14,7 @@ Use when a dev server is already running and you want to prove a fix rendered.
 8. `patch.rollback`
 
 Acceptance:
+
 - target element renders with expected layout or styles
 - no new console errors after HMR
 - temporary patch is rolled back
@@ -30,6 +31,7 @@ Use when a submission flow fails silently or the UI state is inconsistent.
 6. `dom.query` on the resulting panel or message
 
 Acceptance:
+
 - request status and failing endpoint are identified
 - visible error or success state matches the network result
 - console exceptions are ruled in or out
@@ -47,6 +49,7 @@ Use when comparing the live UI to an expected layout or visual spec.
 7. `patch.rollback`
 
 Acceptance:
+
 - the live patch proves the intended fix
 - source implementation matches the validated patch
 - no patch is left active
@@ -64,6 +67,7 @@ Use when a component only breaks at a specific breakpoint.
 7. `viewport.resize` with `reset: true`
 
 Acceptance:
+
 - the target breakpoint is reproduced
 - geometry and style regressions are confirmed without a full screenshot
 - viewport override is reset
@@ -73,18 +77,21 @@ Acceptance:
 Use when transient states matter.
 
 Hover:
+
 1. `dom.find_by_text` or `dom.find_by_role`
 2. `input.hover`
 3. `dom.query` for tooltip or menu
 4. `styles.get_computed`
 
 Drag:
+
 1. `dom.query` for source and destination
 2. `input.drag`
 3. `dom.wait_for`
 4. `dom.query` to verify order or placement
 
 Acceptance:
+
 - transient state appears while the interaction is active
 - DOM and layout confirm the intended state change
 
@@ -97,6 +104,7 @@ Use when semantic navigation matters more than CSS selectors.
 3. `dom.get_accessibility_tree` only if role discovery is insufficient
 
 Acceptance:
+
 - expected interactive roles are present
 - accessible names match the UI copy
 - the full accessibility tree is only used when lighter reads fail