--navigator-stall-escalation

CLI: --navigator-stall-escalation
REST: navigator_stall_escalation

ValueNUMBER

Default10

LicensePro

Sets how many steps a navigator may take on one page before it is judged stalled and escalated. 0 removes the limit.

A navigator with no one to escalate to fails once it takes one action more than this many times in a row. Raise the limit for a page that takes many steps, such as a long form, and set 0 for a task that stays on one page by design.

Example

Run locally

zshot -f pipeline.png \
  --navigator-type "anthropic://YOUR_API_KEY@" \
  --navigator-credential email=success@zshot-app.com \
  --navigator-credential password=password \
  --navigate "Log in and page through every lead" \
  --navigator-stall-escalation 20 \
  https://zshot-cli.com/example_assets/zrm/

{
  "url": "https://zshot-cli.com/example_assets/zrm/",
  "output_type": "png",
  "navigate": "Log in and page through every lead",
  "navigator_stall_escalation": 20,
  "navigator_type": ["anthropic://YOUR_API_KEY@"],
  "navigator_credential": { "email": "success@zshot-app.com", "password": "password" }
}

curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/zrm/","output_type":"png","navigate":"Log in and page through every lead","navigator_stall_escalation":20,"navigator_type":["anthropic://YOUR_API_KEY@"],"navigator_credential":{"email":"success@zshot-app.com","password":"password"}}' \
  -o pipeline.png