gflow_auth_status
Probe Flow session status before generation to detect expired auth early without launching an interactive login.
Instructions
Non-interactive, credit-free Flow session probe (#497). Call this BEFORE a generation tool to fail fast on expired auth, before a long blocking generation call. Never starts an interactive login flow. May boot a short-lived headless browser, which on flow.google.com is the usual path, and may take up to ~2 min on a slow network. Every session result also carries wire: {status, build}, the health of the direct (browser-free) credits read, probed first with one GET and one POST to flow.google.com unless the direct read is off. wire.status is accepted (the saved cookies work), signed_out_shell or http_401 (Flow refused the saved session), store_unreadable (the profile's cookies could not be read: Chrome has it open, or it has no saved session), disabled (GFLOW_CLI_WIRE_READS=0 or the macOS default), proxy_configured, throttled, no_chrome_version, network, redirect, http_400, http_error, unparseable or unexpected. With accepted, credit reads need no browser; any other status means they use the browser instead and does not change status, except throttled: Flow is rate-limiting the account, so the browser probe is skipped and the result is status: throttled with a retryable 429 error carrying retry_after seconds. build is Flow's build label when read, else null.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "gflow_auth_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile | No | default |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||