Enum AgentError 

pub enum AgentError {
    ProcessFailed {
        exit_code: i32,
        stderr: String,
    },
    SchemaValidation {
        expected: String,
        got: String,
        debug_messages: Vec<DebugMessage>,
        partial_usage: Box<PartialUsage>,
        raw_response: Option<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.

debug_messages: Vec<DebugMessage>

Verbose conversation trace captured before the validation failure.

Populated when the agent ran in verbose (stream-json) mode so that callers can persist the debug trail even on error paths.

partial_usage: Box<PartialUsage>

Partial usage data from the CLI response, available even though structured output extraction failed. Boxed to keep AgentError small on the stack.

raw_response: Option<String>

Raw text response from the agent, truncated to ~4000 bytes.

When structured output extraction fails, the model may still have produced useful text in the result field. This captures it so callers can persist it for debugging (e.g. in the step output).

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.