Auth Automation

What this guide covers

Operate safely in logged-in sessions using extension relay controls and explicit cookie policy behavior.

Mode selection

Use extension mode for real profiles. Choose cookie policy off|auto|required per run based on auth requirements.

Recommended run sequence

• Start in extension mode and verify relay + handshake readiness.
• Optionally import cookies or inspect active cookies before navigation.
• Run actions/workflows with --cookie-policy and --use-cookies settings that match the task.
• Handle auth_required failures deterministically and re-run after session correction.

Verification checkpoints

• Auth-required workflows fail fast with reasonCode=auth_required when policy is required.
• Cookie diagnostics expose injected/rejected/verified session details.
• No-auth runs keep cookie injection disabled for deterministic behavior.

Related surfaces

• status, cookie-import, cookie-list
• research run, shopping run, product-video run with cookie overrides
• workflow metrics: cookie_diagnostics / cookieDiagnostics