From 3c551fd36f8960fafc571e04304a4becabfb8bb9 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Sat, 20 Dec 2025 09:47:21 +0000 Subject: [PATCH] docs(browser): update hook timeouts --- docs/browser.md | 2 +- docs/refactor/browser-control-simplification.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/browser.md b/docs/browser.md index a43a4a7b7..738e3bf7e 100644 --- a/docs/browser.md +++ b/docs/browser.md @@ -189,7 +189,7 @@ Actions: Notes: - `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog. -- The arm default timeout is **2 minutes**; pass `timeoutMs` if you need longer. +- The arm default timeout is **2 minutes** (clamped to max 2 minutes); pass `timeoutMs` if you need shorter. - `snapshot --format ai` returns AI snapshot markup used for ref-based actions. ## Security & privacy notes diff --git a/docs/refactor/browser-control-simplification.md b/docs/refactor/browser-control-simplification.md index dc76cdba8..834ac03b8 100644 --- a/docs/refactor/browser-control-simplification.md +++ b/docs/refactor/browser-control-simplification.md @@ -27,7 +27,7 @@ Goal: make the browser-control surface **small, stable, and agent-oriented**, an - `POST /navigate` `{ url, targetId? }` - `POST /act` `{ kind, targetId?, ... }` where `kind` is one of: - `click`, `type`, `press`, `hover`, `drag`, `select`, `fill`, `wait`, `resize`, `close`, `evaluate` -- `POST /screenshot` `{ targetId?, fullPage?, ref?, element?, type?, filename? }` +- `POST /screenshot` `{ targetId?, fullPage?, ref?, element?, type? }` - `GET /snapshot` `?format=ai|aria&targetId?&limit?` - `GET /console` `?level?&targetId?` - `POST /pdf` `{ targetId? }` @@ -37,7 +37,7 @@ Goal: make the browser-control surface **small, stable, and agent-oriented**, an - `POST /hooks/dialog` `{ targetId?, accept, promptText?, timeoutMs? }` Semantics: -- Hook endpoints **arm** the next matching event within `timeoutMs` (default 10s). +- Hook endpoints **arm** the next matching event within `timeoutMs` (default 2 minutes, clamped to max 2 minutes). - Last arm wins per page (new arm replaces previous). ## Work checklist