Enum UpstreamError 

pub enum UpstreamError {
    ConnectFailed(String),
    Timeout(Duration),
    StatusError {
        status: u16,
        body: String,
    },
    StreamError(String),
    BadResponse(String),
    SerializationError(String),
    AllProvidersFailed(String),
}

Errors returned by the LLM upstream adapter.

Variants

ConnectFailed(String)

Timeout(Duration)

StatusError

Fields

status: u16

body: String

StreamError(String)

BadResponse(String)

Upstream returned a 2xx body that the adapter could not parse (non-JSON or malformed). Distinct from SerializationError (which is an SMOS-side request-encoding bug) so the HTTP layer can map it to 502 (upstream’s fault) rather than 500 (our fault).

SerializationError(String)

AllProvidersFailed(String)

Returned by ReqwestUpstreamRouter::complete when the named provider is missing from the [[providers]] map. Should be unreachable in practice (the routing layer validates the person → provider reference at startup), but is retained for defensive depth: a hot config edit could otherwise produce a confusing 404-from-the-upstream instead of a clear 502.

Historically this variant was constructed by the round-robin / failover pool’s failover path when every configured provider failed; the new per-person router does not exercise that path, so the variant is now produced only by the unknown-provider branch above. Kept (rather than removed) because the HTTP error mapper still classifies it as 502 and the type is part of the public API surface (pub enum).

Trait Implementations

impl Debug for UpstreamError

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

Formats the value using the given formatter.

impl Display for UpstreamError

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

Formats the value using the given formatter.

impl Error for UpstreamError

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<UpstreamError> for UseCaseError

fn from(source: UpstreamError) -> Self

Converts to this type from the input type.