Struct AuthStatus 

#[non_exhaustive]
pub struct AuthStatus {
    pub agent: Agent,
    pub state: AuthState,
    pub method: Option<String>,
    pub account: Option<String>,
    pub plan: Option<String>,
    pub detail: String,
    pub login_hint: &'static str,
}

What an agent reported about its credentials.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

agent: Agent

The agent asked.

state: AuthState

What it said.

method: Option<String>

How it is authenticated, in its own words: claude.ai, ChatGPT, an API key. None when it did not say.

account: Option<String>

The account, where the agent reports one. Claude gives an email.

plan: Option<String>

The plan or subscription, where reported.

detail: String

The CLI’s own output, or an explanation when it could not be asked.

login_hint: &'static str

The command that resolves a missing login.

Implementations

impl AuthStatus

pub async fn check(agent: Agent) -> Result<AuthStatus>

Ask agent’s default binary.

Errors

Error::NotInstalled if the binary is missing, Error::Spawn if it cannot be run. A CLI that answers “logged out” is a successful check, not an error.

pub async fn check_bin(agent: Agent, bin: &str) -> Result<AuthStatus>

Ask a specific binary, for a caller overriding the path with crate::Request::bin.

Errors

Error::NotInstalled if the binary is missing, Error::Spawn if it cannot be run.

pub fn is_logged_in(&self) -> bool

Whether the agent confirmed it is logged in.

False for AuthState::Unknown, so a caller that gates on this is conservative. Check state directly to distinguish “no” from “cannot tell”.

pub fn needs_login(&self) -> bool

Whether the answer means someone has to log in.

Only a confirmed logout. An agent that cannot be asked is not evidence of a problem.

pub fn summary(&self) -> String

One line fit to show in a settings screen.

Trait Implementations

impl Clone for AuthStatus

fn clone(&self) -> AuthStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AuthStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.