Enum UarError 

#[non_exhaustive]
pub enum UarError {
    Config {
        code: &'static str,
        message: String,
    },
    Auth {
        code: &'static str,
        message: String,
    },
    Rag {
        code: &'static str,
        message: String,
    },
    Memory {
        code: &'static str,
        message: String,
    },
    Mcp {
        code: &'static str,
        message: String,
    },
    A2a {
        code: &'static str,
        message: String,
    },
    Llm {
        code: &'static str,
        message: String,
    },
    Internal(Error),
}

The crate’s central error type for the public API boundary.

#[non_exhaustive] so new variants are not a breaking change for downstream matches.

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.

Config

Configuration is missing, malformed, or fails validation.

Fields

code: &'static str

Stable error code, e.g. E_CONFIG_MISSING_FIELD.

message: String

Auth

Authentication or authorization failed.

Fields

code: &'static str

Stable error code, e.g. E_AUTH_INVALID_TOKEN.

message: String

Rag

A RAG (retrieval-augmented generation) operation failed.

Fields

code: &'static str

Stable error code, e.g. E_RAG_NO_KB.

message: String

Memory

A memory-subsystem operation failed.

Fields

code: &'static str

Stable error code, e.g. E_MEMORY_NOT_FOUND.

message: String

Mcp

An MCP (Model Context Protocol) operation failed.

Fields

code: &'static str

Stable error code, e.g. E_MCP_TOOL_NOT_FOUND.

message: String

A2a

An A2A (agent-to-agent) operation failed.

Fields

code: &'static str

Stable error code, e.g. E_A2A_AGENT_UNREACHABLE.

message: String

Llm

An LLM provider call failed.

Fields

code: &'static str

Stable error code, e.g. E_LLM_PROVIDER_ERROR.

message: String

Internal(Error)

An internal error not attributable to a specific domain above. Wraps anyhow::Error so call sites using ? compose naturally.

Implementations

impl UarError

pub fn config(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Config variant.

pub fn auth(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Auth variant.

pub fn rag(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Rag variant.

pub fn memory(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Memory variant.

pub fn mcp(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Mcp variant.

pub fn a2a(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::A2a variant.

pub fn llm(code: &'static str, message: impl Into<String>) -> Self

Construct a UarError::Llm variant.

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

The stable, SemVer-significant error code for this error.

pub fn status_code(&self) -> StatusCode

The HTTP status code this error maps to.

Trait Implementations

impl Debug for UarError

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

Formats the value using the given formatter.

impl Display for UarError

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

Formats the value using the given formatter.

impl Error for UarError

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<Error> for UarError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for UarError

Available on crate feature server only.

fn into_response(self) -> Response

Create a response.