From 033fad99e1e5ec6bcf07b50a8f213b3b6355640e Mon Sep 17 00:00:00 2001 From: Ander Date: Wed, 7 Oct 2026 14:36:27 +0200 Subject: [PATCH 1/2] docs(fetch): --wait and --wait-for need --manual --js-render; auto mode ignores them Co-Authored-By: Claude Opus 5.5 --- skills/trace-debug/SKILL.md | 7 ++++--- src/cli/commands/fetch.ts | 4 ++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/skills/trace-debug/SKILL.md b/skills/trace-debug/SKILL.md index 93ab4c2..d5fa50c 100644 --- a/skills/trace-debug/SKILL.md +++ b/skills/trace-debug/SKILL.md @@ -20,9 +20,10 @@ zenrows trace export # JSON for sharing ## Failure → action map - `FETCH_FAILED` / empty content → first retry in auto mode (`mode=auto`), which - escalates for you and bills only for what succeeds. For slow pages add - `--wait-for `. Only when auto mode has failed on its own, take - manual control with `--manual --js-render`, then `--premium-proxy`. Each step + escalates for you and bills only for what succeeds. Only when auto mode has + failed on its own, take manual control with `--manual --js-render`, then + `--premium-proxy`. For slow pages, add `--wait-for ` to a + `--manual --js-render` run; auto mode ignores it. Each step multiplies the cost of the request, and both together are the most expensive configuration available ([[cost-control]]). - `REQUEST_TIMEOUT` → the CLI stopped waiting; the API was reached. Raise diff --git a/src/cli/commands/fetch.ts b/src/cli/commands/fetch.ts index 5d555f6..182bb02 100644 --- a/src/cli/commands/fetch.ts +++ b/src/cli/commands/fetch.ts @@ -27,8 +27,8 @@ export const fetch_: Command = { " --js-render render JavaScript (manual mode only)", " --premium-proxy use residential IPs (manual mode only)", " --proxy-country geo-target (auto mode; in manual mode needs --premium-proxy)", - " --wait fixed wait after load", - " --wait-for wait for a CSS selector", + " --wait fixed wait after load (needs --manual --js-render; auto mode ignores it)", + " --wait-for wait for a CSS selector (needs --manual --js-render; auto mode ignores it)", " --js-instructions JSON instructions to run on the page", " --session-id keep the same IP across requests", " --original-status return the target's original HTTP status", From 84a8716759421bc3fe7f8b30fd99a9ef67146182 Mon Sep 17 00:00:00 2001 From: Ander Date: Wed, 7 Oct 2026 14:45:44 +0200 Subject: [PATCH 2/2] docs(fetch): auto mode may ignore --wait/--wait-for, not always Co-Authored-By: Claude Opus 5.5 --- skills/trace-debug/SKILL.md | 2 +- src/cli/commands/fetch.ts | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/skills/trace-debug/SKILL.md b/skills/trace-debug/SKILL.md index d5fa50c..11d0b01 100644 --- a/skills/trace-debug/SKILL.md +++ b/skills/trace-debug/SKILL.md @@ -23,7 +23,7 @@ zenrows trace export # JSON for sharing escalates for you and bills only for what succeeds. Only when auto mode has failed on its own, take manual control with `--manual --js-render`, then `--premium-proxy`. For slow pages, add `--wait-for ` to a - `--manual --js-render` run; auto mode ignores it. Each step + `--manual --js-render` run; auto mode may ignore it. Each step multiplies the cost of the request, and both together are the most expensive configuration available ([[cost-control]]). - `REQUEST_TIMEOUT` → the CLI stopped waiting; the API was reached. Raise diff --git a/src/cli/commands/fetch.ts b/src/cli/commands/fetch.ts index 182bb02..73ae447 100644 --- a/src/cli/commands/fetch.ts +++ b/src/cli/commands/fetch.ts @@ -27,8 +27,8 @@ export const fetch_: Command = { " --js-render render JavaScript (manual mode only)", " --premium-proxy use residential IPs (manual mode only)", " --proxy-country geo-target (auto mode; in manual mode needs --premium-proxy)", - " --wait fixed wait after load (needs --manual --js-render; auto mode ignores it)", - " --wait-for wait for a CSS selector (needs --manual --js-render; auto mode ignores it)", + " --wait fixed wait after load (needs --manual --js-render; auto mode may ignore it)", + " --wait-for wait for a CSS selector (needs --manual --js-render; auto mode may ignore it)", " --js-instructions JSON instructions to run on the page", " --session-id keep the same IP across requests", " --original-status return the target's original HTTP status",