Enum RragError 

pub enum RragError {
    DocumentProcessing {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Embedding {
        content_type: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Storage {
        operation: String,
        source: Box<dyn Error + Send + Sync>,
    },
    RsllmClient {
        operation: String,
        source: Box<dyn Error + Send + Sync>,
    },
    Retrieval {
        query: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    ToolExecution {
        tool: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Configuration {
        field: String,
        expected: String,
        actual: String,
    },
    Network {
        operation: String,
        source: Box<dyn Error + Send + Sync>,
    },
    Serialization {
        data_type: String,
        source: Error,
    },
    Timeout {
        operation: String,
        duration_ms: u64,
    },
    Memory {
        operation: String,
        message: String,
    },
    Stream {
        context: String,
        message: String,
    },
    Agent {
        agent_id: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Validation {
        field: String,
        constraint: String,
        value: String,
    },
}

Main error type for RRAG operations

Designed with Rust’s error handling best practices:

• Uses thiserror for automatic trait implementations
• Provides structured error data for programmatic handling
• Includes source chain for debugging
• Categorizes errors for metrics and logging

Variants

DocumentProcessing

Document processing errors

Fields

message: String

Error message describing what went wrong

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this failure

Embedding

Embedding generation errors

Fields

content_type: String

Type of content that failed to embed (text, image, etc.)

message: String

Error message describing the failure

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this failure

Storage

Vector storage errors

Fields

operation: String

Storage operation that failed (insert, query, delete, etc.)

source: Box<dyn Error + Send + Sync>

Source error from the storage backend

RsllmClient

rsllm client errors

Fields

operation: String

Client operation that failed (request, auth, etc.)

source: Box<dyn Error + Send + Sync>

Source error from the rsllm client

Retrieval

Retrieval/search errors

Fields

query: String

Query that failed to execute

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this failure

ToolExecution

Tool execution errors

Fields

tool: String

Name of the tool that failed

message: String

Error message from the tool execution

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this failure

Configuration

Configuration errors

Fields

field: String

Configuration field that has an invalid value

expected: String

Expected value or format for the field

actual: String

Actual value that was provided

Network

Network/IO errors

Fields

operation: String

Network operation that failed (request, response, etc.)

source: Box<dyn Error + Send + Sync>

Source error from the network operation

Serialization

Serialization/deserialization errors

Fields

data_type: String

Type of data that failed to serialize/deserialize

source: Error

Source error from the serialization library

Timeout

Timeout errors

Fields

operation: String

Operation that timed out

duration_ms: u64

Duration in milliseconds before timeout

Memory

Memory/conversation errors

Fields

operation: String

Memory operation that failed

message: String

Error message describing the failure

Stream

Streaming errors

Fields

context: String

Context where the stream error occurred

message: String

Error message describing the stream failure

Agent

Agent execution errors

Fields

agent_id: String

ID of the agent that encountered the error

message: String

Error message from the agent

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this failure

Validation

Validation errors

Fields

field: String

Field that failed validation

constraint: String

Validation constraint that was violated

value: String

Value that failed validation

Implementations

impl RragError

pub fn document_processing(message: impl Into<String>) -> Self

Create a document processing error

pub fn document_processing_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create a document processing error with source

pub fn embedding( content_type: impl Into<String>, message: impl Into<String>, ) -> Self

Create an embedding error

pub fn storage( operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create a storage error

pub fn rsllm_client( operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create an rsllm client error

pub fn retrieval(query: impl Into<String>) -> Self

Create a retrieval error

pub fn evaluation(message: impl Into<String>) -> Self

Create an evaluation error

pub fn tool_execution( tool: impl Into<String>, message: impl Into<String>, ) -> Self

Create a tool execution error

pub fn config( field: impl Into<String>, expected: impl Into<String>, actual: impl Into<String>, ) -> Self

Create a configuration error

pub fn timeout(operation: impl Into<String>, duration_ms: u64) -> Self

Create a timeout error

pub fn memory(operation: impl Into<String>, message: impl Into<String>) -> Self

Create a memory error

pub fn stream(context: impl Into<String>, message: impl Into<String>) -> Self

Create a stream error

pub fn agent(agent_id: impl Into<String>, message: impl Into<String>) -> Self

Create an agent error

pub fn validation( field: impl Into<String>, constraint: impl Into<String>, value: impl Into<String>, ) -> Self

Create a validation error

pub fn network( operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Create a network error

pub fn configuration(message: impl Into<String>) -> Self

Create a configuration error (shorthand for config method)

pub fn serialization_with_message( data_type: impl Into<String>, message: impl Into<String>, ) -> Self

Create a serialization error with message

pub fn io_error(message: impl Into<String>) -> Self

Create an I/O error

pub fn is_retryable(&self) -> bool

Check if this error suggests a retry might succeed

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

Get error category for metrics and logging

pub fn severity(&self) -> ErrorSeverity

Get error severity level

Trait Implementations

impl Debug for RragError

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

Formats the value using the given formatter.

impl Display for RragError

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

Formats the value using the given formatter.

impl Error for RragError

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<Elapsed> for RragError

fn from(_err: Elapsed) -> Self

Converts to this type from the input type.

impl From<Error> for RragError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RragError

Available on crate feature http only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<GraphError> for RragError

fn from(err: GraphError) -> Self

Converts to this type from the input type.

impl From<RsllmError> for RragError

Available on crate feature rexis-llm-client only.

fn from(err: RsllmError) -> Self

Converts to this type from the input type.