@browserbridge/bbx 1.7.2 → 1.7.3

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

@@ -27,7 +27,7 @@ The table below includes the legacy capability bucket for each method so agents
 - `-` means the method is global/system-scoped and was never gated by a former capability bucket.
 - Capability names are descriptive coverage labels only. Browser Bridge access is window-scoped now; there are no capability-scoped sessions.
 
-## All Methods (59)
+## All Methods (65)
 
 | #   | Method                             | Tab? | CDP? | Group       | Capability           | Notes                                                                   |
 | --- | ---------------------------------- | ---- | ---- | ----------- | -------------------- | ----------------------------------------------------------------------- |
@@ -44,7 +44,7 @@ The table below includes the legacy capability bucket for each method so agents
 | 11  | `page.get_state`                   | Yes  | -    | page        | `page.read`          | URL, readiness, focus, scroll, viewport                                 |
 | 12  | `page.evaluate`                    | Yes  | CDP  | page        | `page.evaluate`      | JS expression in page context; last resort                              |
 | 13  | `page.get_console`                 | Yes  | -    | page        | `page.read`          | Buffered console messages; filter by `level`, `limit`                   |
-| 14  | `page.wait_for_load_state`         | Yes  | -    | wait        | `page.read`          | Block until tab `complete`; `timeoutMs` capped 30 s                     |
+| 14  | `page.wait_for_load_state`         | Yes  | -    | wait        | `page.read`          | Block until tab `complete`; `timeoutMs` range 0.5-120 s                 |
 | 15  | `page.get_storage`                 | Yes  | -    | page        | `page.read`          | `localStorage`/`sessionStorage`; optional `keys`                        |
 | 16  | `page.get_text`                    | Yes  | -    | page        | `page.read`          | Full page text; `textBudget` limits size                                |
 | 17  | `page.get_network`                 | Yes  | -    | page        | `network.read`       | Intercepted fetch/XHR; `limit` entries                                  |
@@ -141,6 +141,8 @@ bbx call page.evaluate '{"expression":"await fetch(\"/api/health\").then(r=>r.js
 
 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.
 
+To capture a reproduction reliably, call it once with `clear: true` before triggering the event. This installs the interceptor and removes older entries. Reproduce the issue, then read again without `clear`.
+
 ```bash
 bbx console                    # all levels
 bbx console error              # errors only
@@ -285,6 +287,8 @@ bbx call page.get_text '{"textBudget":2000}'
 
 ### page.get_network
 
+The fetch/XHR interceptor is installed on the first call. Before reproducing a network issue, call `page.get_network` with `clear: true`, trigger the action, then read the buffer again without `clear` so the relevant request is not missed or erased.
+
 Read intercepted fetch/XHR requests. The interceptor is auto-installed on first call (via MAIN world script). Returns `{entries, count}` sorted newest-first.
 
 ```bash

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

@@ -125,7 +125,7 @@ bbx network              # recent fetch/XHR entries
 bbx network 50           # last 50 entries
 ```
 
-The interceptor auto-installs on first call. Each entry shows `method`, `url`, `status`, `duration`. Use `clear: true` to reset the buffer.
+The interceptor auto-installs on first call. Before reproducing an event, call `page.get_network` once with `clear: true` to install capture and remove old entries. Trigger the action, then read again without `clear`. Each entry shows `method`, `url`, `status`, `duration`.
 
 ## Accessibility Tree for Semantic Discovery
 
@@ -151,12 +151,13 @@ bbx find-role navigation  # semantic, works regardless of classes
 
 ## HMR-Aware Waiting
 
-After modifying source code, the dev server hot-reloads. Always wait before inspecting:
+After modifying source code, the dev server hot-reloads. Wait for evidence of the change, not `attached` on a selector that already exists:
 
 ```bash
-bbx wait '[data-component="Header"]' 5000   # wait for component re-mount
+bbx call dom.wait_for '{"selector":"[data-component=\"Header\"][data-version=\"new\"]","state":"attached","timeoutMs":5000}'
+bbx call dom.wait_for '{"selector":"[data-component=\"Header\"]","text":"Expected new heading","timeoutMs":5000}'
+# For a known remount, wait for detached and then attached states.
 bbx console error                            # check for HMR errors
-bbx eval 'module.hot?.status?.()'            # check HMR status (webpack)
 ```
 
 ## Parent-Agent Response Policy

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

@@ -9,7 +9,7 @@ Use when a dev server is already running and you want to prove a fix rendered.
 3. `styles.get_computed` or `layout.get_box_model`
 4. `patch.apply_styles` to prove the visual fix
 5. Edit source files
-6. `dom.wait_for` on the component selector
+6. `dom.wait_for` for expected new text, a selector matching a changed attribute, or a detach/attach remount; do not wait for `attached` on an unchanged selector
 7. `page.get_console`
 8. `patch.rollback`
 
@@ -23,12 +23,14 @@ Acceptance:
 
 Use when a submission flow fails silently or the UI state is inconsistent.
 
-1. `dom.find_by_role` for the form control
-2. `input.type` / `input.click`
-3. `page.get_network`
-4. `page.get_console`
-5. `dom.wait_for` for success or error state
-6. `dom.query` on the resulting panel or message
+1. `page.get_console` with `clear: true` to install and clear console capture
+2. `page.get_network` with `clear: true` to install and clear network capture
+3. `dom.find_by_role` for the form control
+4. `input.type` / `input.click` to reproduce the issue
+5. `page.get_network` without `clear`
+6. `page.get_console` without `clear`
+7. `dom.wait_for` for success or error state
+8. `dom.query` on the resulting panel or message
 
 Acceptance:
 
@@ -60,7 +62,7 @@ Use when a component only breaks at a specific breakpoint.
 
 1. `page.get_state`
 2. `viewport.resize`
-3. `dom.wait_for`
+3. `dom.wait_for` for the expected responsive text, attribute selector, visibility change, or remount
 4. `layout.get_box_model`
 5. `styles.get_computed`
 6. `page.get_console`
@@ -87,7 +89,7 @@ Drag:
 
 1. `dom.query` for source and destination
 2. `input.drag`
-3. `dom.wait_for`
+3. `dom.wait_for` for expected changed text, attribute selector, or a detach/attach remount
 4. `dom.query` to verify order or placement
 
 Acceptance: