@divebell/agent-browser 0.33.2-divebell.6 → 0.33.2-divebell.7

package/README.md

@@ -111,7 +111,7 @@ agent-browser find role button click --name "Submit"
 
 ```bash
 agent-browser open                    # Launch browser (no navigation); stays on about:blank
-agent-browser open <url>              # Launch + navigate to URL (aliases: goto, navigate)
+agent-browser open <url> [--timeout <ms>] # Launch + navigate to URL (aliases: goto, navigate)
 agent-browser read [url]              # Fetch agent-readable text, or read rendered active-tab DOM
 agent-browser click <sel>             # Click element (--new-tab to open in new tab)
 agent-browser dblclick <sel>          # Double-click element
@@ -513,6 +513,7 @@ Heap snapshots and allocation profiles can contain page text, application data,
 ### Navigation
 
 ```bash
+agent-browser open <url> --timeout 40000 # Wait up to 40s for the page load lifecycle event
 agent-browser back                    # Go back
 agent-browser forward                 # Go forward
 agent-browser reload                  # Reload page
@@ -1200,7 +1201,9 @@ Auto-discovered config files that are missing are silently ignored. If `--config
 
 ## Default Timeout
 
-The default timeout for standard operations (clicks, waits, fills, etc.) is 25 seconds. This is intentionally below the CLI's 30-second IPC read timeout so that the daemon returns a proper error instead of the CLI timing out with EAGAIN.
+The default timeout for standard operations (clicks, waits, fills, etc.) is 25 seconds. This is intentionally below the CLI's 30-second IPC read timeout so that the daemon returns a proper error instead of the CLI timing out with EAGAIN. Navigation commands (`open`, `goto`, and `navigate`) wait up to 60 seconds by default and receive a matching command transport budget.
+
+Pass `--timeout <ms>` to `open`, `goto`, or `navigate` to override the navigation lifecycle timeout for one command. `AGENT_BROWSER_DEFAULT_TIMEOUT` also overrides the navigation default. The effective navigation timeout is forwarded to the command transport with an additional response margin.
 
 Override the default timeout via environment variable:
 
@@ -1209,7 +1212,7 @@ Override the default timeout via environment variable:
 export AGENT_BROWSER_DEFAULT_TIMEOUT=45000
 ```
 
-> **Note:** Setting this above 30000 (30s) may cause EAGAIN errors on slow operations because the CLI's read timeout will expire before the daemon responds. The CLI retries transient errors automatically, but response times will increase.
+> **Note:** Navigation commands receive a transport budget that matches their effective timeout. For other slow operations, setting the environment variable above 30000 (30s) may still cause EAGAIN because their CLI read timeout can expire before the daemon responds.
 
 | Variable                        | Description                              |
 | ------------------------------- | ---------------------------------------- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divebell/agent-browser",
-  "version": "0.33.2-divebell.6",
+  "version": "0.33.2-divebell.7",
   "description": "Browser automation CLI for AI agents with Divebell memory diagnostics",
   "type": "module",
   "engines": {

package/skill-data/core/references/commands.md

@@ -8,7 +8,10 @@ Complete reference for all agent-browser commands. For quick start and common pa
 agent-browser open            # Launch browser (no navigation); stays on about:blank.
                               # Pair with `network route`, `cookies set --curl`, or
                               # `addinitscript` to stage state before the first navigation.
-agent-browser open <url>      # Launch + navigate (aliases: goto, navigate)
+agent-browser open <url> [--timeout <ms>]
+                              # Launch + navigate (aliases: goto, navigate)
+                              # Waits for the page load lifecycle event for 60s by default;
+                              # --timeout overrides that navigation wait for one command
                               # Supports: https://, http://, file://, about:, data://
                               # Auto-prepends https:// if no protocol given
 agent-browser read [url]      # Fetch agent-readable text, or read rendered active-tab DOM