Enum CredentialError 

#[non_exhaustive]
pub enum CredentialError {
    NoCredentials,
    SubprocessFailed(Error),
    IoError {
        path: PathBuf,
        cause: Error,
    },
    ParseError {
        path: PathBuf,
        cause: Error,
    },
    MissingField {
        path: PathBuf,
    },
    EmptyToken {
        path: PathBuf,
    },
}

Failure modes for resolve_credentials. Debug and Display deliberately avoid forwarding serde_json::Error’s Display because its context snippet may include token bytes; the raw cause is still reachable via std::error::Error::source for callers who need it.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NoCredentials

No token found in any cascade path.

SubprocessFailed(Error)

security subprocess failed to launch or exited non-zero for non-“not-found” reasons (Keychain locked, permission denied, binary missing).

IoError

Credentials file exists but could not be opened / read (permission denied, truncated read, filesystem error).

Fields

path: PathBuf

cause: Error

ParseError

Credentials file is not valid JSON. Inner cause preserved for std::error::Error::source; neither Display nor Debug forwards its text.

Fields

path: PathBuf

cause: Error

MissingField

Credentials file parsed but the claudeAiOauth section is absent entirely. Typically indicates a stale Claude Code writer or a different tool sharing the path.

Fields

path: PathBuf

EmptyToken

claudeAiOauth is present but accessToken is missing, null, or an empty string — the token slot exists but can’t be used.

Fields

path: PathBuf

Implementations

impl CredentialError

pub fn code(&self) -> &'static str

Short plugin-facing error tag per docs/specs/plugin-api.md §ctx shape exposed to rhai. MissingField and EmptyToken aren’t in plugin-api.md’s enumerated list yet; spec will add them in a v0.2 rev.

Trait Implementations

impl Clone for CredentialError

Lossy Clone: io::Error and serde_json::Error don’t implement Clone, so variants carrying them reconstruct near-equivalents (same kind() + textual message; raw_os_error and serde line numbers are lost). The variant tag — which is what Self::code and segment renderers key off per rate-limit-segments.md §Error message table — round-trips exactly. The crate’s unsafe_code = "forbid" lint forecloses a transmute-based shallow clone, so this is the cheapest way to preserve variant-level detail across Arc<Result<_, Self>> boundaries like the cascade.

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CredentialError

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

Formats the value using the given formatter.

impl Display for CredentialError

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

Formats the value using the given formatter.

impl Error for CredentialError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.