From 1b5c4240a5e679a322f636098a4b370cac084875 Mon Sep 17 00:00:00 2001 From: amankumarsingh77 Date: Tue, 28 Jul 2026 22:11:24 +0530 Subject: docs: record the new contract and the two knobs that now work MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ARCHITECTURE.md: the layer map gains domains/cdp-call.ts as the single door and the helper-module/tool-module split; the "cdpCall vs session.call" section is replaced, since snapshot.ts no longer mixes styles — it swallows failures through cdpCall instead of around it. Rule 1 now says tool files export only tools, rule 7 names the enforced scanner rules, and the two 250-line exceptions are recorded as largely settled (snapshot 477 to 256, form 409 to 283). Also notes the one honest gap: session.attach and session.windowId perform CDP calls the rules do not match. README: BU_CDP_WS carries its daemon-restart caveat, BH_DEBUG_CLICKS is documented as the flag's equivalent, and the tool count matches the registry (38 to 40). Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index f85effc..e4e89d7 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Your profile, your logins, your cookies. The agent reads pages as an accessibility tree with stable element handles, fills forms that React won't revert, captures network traffic and console errors, -searches the web, and drops to raw CDP when the tools run out. 38 tools over a single CDP connection — +searches the web, and drops to raw CDP when the tools run out. 40 tools over a single CDP connection — no MCP hop, no second browser, no extra API keys. --- @@ -311,8 +311,9 @@ re-runnable. | Flag / variable | Effect | |---|---| | `--browser-namespace ` | Override the session namespace (default: auto-generated). | -| `--browser-debug-clicks` | Save annotated click screenshots for debugging. | -| `BU_CDP_WS` | Attach to a remote browser by WebSocket URL instead of discovering a local one. | +| `--browser-debug-clicks` | Save annotated click screenshots for debugging. Equivalent to `BH_DEBUG_CLICKS=1`. | +| `BU_CDP_WS` | Attach to a remote browser by WebSocket URL instead of discovering a local one. The daemon reads this when it starts, so stop a running daemon first. | +| `BH_DEBUG_CLICKS` | Same as `--browser-debug-clicks`. | | `BU_CDP_PORTS` | Extra ports to probe during CDP discovery, beyond 9222. | | `BH_SCRIPT_DIR` | Additional directory `browser_run_script` will accept paths from. | -- cgit v1.2.3