Struct LoginSession 

pub struct LoginSession { /* private fields */ }

In-flight OAuth session. Returned by start_login(). The caller drives the flow:

1. Display session.url() and (best-effort) open_browser().
2. Loop poll_once() until Authorized, sleeping between calls AT THE CALLER’S CADENCE — this lets the TUI interleave UI events (ESC for cancel) and the CLI use a simple thread::sleep.
3. Call finish() to exchange state → token.

Implementations

impl LoginSession

pub fn url(&self) -> &str

Authorization URL the user must visit. Stable for the lifetime of the session — safe to show once and reuse.

pub fn open_browser_best_effort(&self)

Best-effort browser launch. Always silent — failures are expected on Linux/WSL where the URL on screen is the user’s actual path.

pub fn poll_once(&self) -> Result<PollOutcome>

One non-blocking HTTP check against /auth/check. Returns Pending until the user finishes the browser flow, then Authorized. Errors only on transport/parse failures; a “not yet” answer is Ok(Pending), never Err.

pub fn finish(self, tel: Option<&Arc<Telemetry>>) -> Result<AuthInfo>

Final step: /auth/token exchange + LoginSuccess telemetry. Consumes the session — only call after poll_once returned Authorized.