Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

2.3 KB
Raw Blame

Handoff

Mark a tab for human intervention, inspect the handoff state, then resume automation when the manual step is complete.

CLI wrappers are available:

pinchtab tab handoff <tabId> --reason captcha --timeout-ms 120000
pinchtab tab handoff-status <tabId>
pinchtab tab resume <tabId> --status completed

The same commands exist top-level (pinchtab handoff, pinchtab handoff-status, pinchtab resume); each defaults to the current tab when <tabId> is omitted. --reason defaults to manual_handoff.

MCP: pinchtab_handoff (tabId required, reason, timeoutMs), pinchtab_handoff_status (tabId), pinchtab_resume (tabId, status).

API equivalents:

When a tab is in paused_handoff, action execution routes reject with 409 tab_paused_handoff until the tab is resumed or the optional handoff timeout expires.

curl -X POST http://localhost:9867/tabs/<tabId>/handoff \
  -H "Content-Type: application/json" \
  -d '{"reason":"captcha","timeoutMs":120000}'

curl http://localhost:9867/tabs/<tabId>/handoff

curl -X POST http://localhost:9867/tabs/<tabId>/resume \
  -H "Content-Type: application/json" \
  -d '{"status":"completed","resolvedData":{"operator":"human"}}'

Notes:

  • POST /tabs/{id}/handoff sets the tab state to paused_handoff
  • GET /tabs/{id}/handoff returns the current handoff state, or active when no handoff is set
  • when a timeout is set, status also includes expiresAt and timeoutMs
  • POST /tabs/{id}/resume clears the handoff state and can carry resume metadata such as status or resolvedData
  • paused tabs reject mutating routes — /action, /navigate, /back, /forward, /reload, /evaluate, /dialog, /cookies, /storage, /upload, /download, /solve, /emulation/*, /network/route, /fingerprint/rotate, /state/load — with 409 tab_paused_handoff; /actions and /macro answer 200 and report tab_paused_handoff on each step
  • POST /tabs/{id}/handoff returns {tabId, status, reason, timeoutMs, hint, remedy} (plus expiresAt with a timeout); a negative timeoutMs is 400, a tab leased to another owner is 423 tab_locked
  • POST /tabs/{id}/resume returns {tabId, status:"active", resumeStatus, resolvedData}
  • use this for CAPTCHA, 2FA, login approval, or other human-only steps

Related Pages