Enum BrokerError 

#[non_exhaustive]
pub enum BrokerError {
    UnknownProvider(String),
    RegistrationRequired {
        provider: String,
        remediation: String,
    },
    NotConfigured(String),
    Unauthorized,
    Denied(String),
    UnsupportedCapability {
        provider: String,
        capability: String,
    },
    Transport(String),
    Credential(String),
    UnknownAccount {
        provider: String,
        label: String,
    },
    UnsupportedAccount {
        provider: String,
        label: String,
    },
    InvalidAccount(String),
    NoAccountAvailable {
        provider: String,
        reason: String,
        failure: Option<SelectionFailure>,
    },
    BrokerTooOld(String),
    Refresh(RefreshFailure),
}

Broker failures. Messages never contain credential values. Non-exhaustive: new failure kinds are added as brokers gain operations.

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.

UnknownProvider(String)

The named provider is not in any broker registry.

RegistrationRequired

A required public-client registration is not configured.

Fields

provider: String

remediation: String

NotConfigured(String)

The provider is known but has no credential configured.

Unauthorized

The caller failed broker (machine) authentication.

Denied(String)

The request was rejected by broker policy (e.g. malformed proxy path).

UnsupportedCapability

The route honestly lacks a capability the request needs (e.g. tools on a text-only cloud route). Raised pre-flight, before credentials/network.

Fields

provider: String

capability: String

Transport(String)

Transport-level failure talking to the broker or the provider.

Credential(String)

Credential storage/refresh failure (message is already secret-free).

UnknownAccount

An explicitly requested account slot does not exist. Never a fallback.

Fields

provider: String

label: String

UnsupportedAccount

This broker implementation cannot address named account slots.

Fields

provider: String

label: String

InvalidAccount(String)

An account label failed validation (CLI/env/config/HTTP boundary).

NoAccountAvailable

Automatic selection found no account with proven capacity. failure is the typed explanation (top-level kind plus every account’s kind and HTTP status) when the broker knows it; reason its text.

Fields

provider: String

reason: String

failure: Option<SelectionFailure>

BrokerTooOld(String)

The remote broker predates an operation this client needs; the payload names what is unavailable. Upgrade the broker host.

Refresh(RefreshFailure)

A locked token refresh failed; the kind tells a per-account cooldown, a busy refresh lock or a transient network/provider failure apart from an unusable login. Message is secret-free.

Trait Implementations

impl Clone for BrokerError

fn clone(&self) -> BrokerError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrokerError

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

Formats the value using the given formatter.

impl Display for BrokerError

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

Formats the value using the given formatter.

impl Eq for BrokerError

impl Error for BrokerError

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.

impl From<BrokerError> for SetupError

fn from(err: BrokerError) -> SetupError

Converts to this type from the input type.

impl From<BrokerError> for StreamError

fn from(source: BrokerError) -> StreamError

Converts to this type from the input type.

impl PartialEq for BrokerError

fn eq(&self, other: &BrokerError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BrokerError