Enum AgentError 

pub enum AgentError {
    ProcessFailed {
        exit_code: i32,
        stderr: String,
    },
    SchemaValidation {
        expected: String,
        got: String,
    },
    PromptTooLarge {
        chars: usize,
        estimated_tokens: usize,
        model_limit: usize,
    },
    Timeout {
        limit: Duration,
    },
}

Error specific to agent (AI provider) invocations.

Returned by AgentProvider::invoke and automatically wrapped into OperationError::Agent when propagated with ?.

Variants

ProcessFailed

The agent process exited with a non-zero status code.

Fields

exit_code: i32

Process exit code, or -1 if spawning failed.

stderr: String

Captured stderr.

SchemaValidation

The agent output did not match the expected schema.

Fields

expected: String

What was expected (e.g. "structured_output field").

got: String

What was actually received.

PromptTooLarge

The prompt exceeds the model’s context window.

Returned before spawning the process when the estimated token count exceeds the model’s known limit.

• chars - number of characters in the combined prompt (system + user).
• estimated_tokens - approximate token count (chars / 4).
• model_limit - the model’s context window in tokens.

Fields

chars: usize

Number of characters in the prompt.

estimated_tokens: usize

Estimated token count (chars / 4 heuristic).

model_limit: usize

Model’s context window in tokens.

Timeout

The agent did not complete within the configured timeout.

Fields

limit: Duration

The Duration that was exceeded.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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<AgentError> for OperationError

fn from(source: AgentError) -> Self

Converts to this type from the input type.