agents 0.3.0

Facade crate for building typed Rust agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

use crate::llm::error::Error as LlmError;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use thiserror::Error;

/// Errors returned while driving an agent.
#[derive(Debug, Error, Clone, Serialize, Deserialize, JsonSchema)]
pub enum AgentError {
    #[error("LLM error: {0}")]
    Llm(#[from] LlmError),

    #[error("Invalid input: {reason}")]
    InvalidInput { reason: String },

    #[error("Invalid response: {reason}")]
    InvalidResponse { reason: String },

    #[error("Tool execution failed: {reason}")]
    ToolExecution { reason: String },

    #[error("Tool result encoding failed: {reason}")]
    ToolResultEncoding { reason: String },

    #[error("Cancelled")]
    Cancelled,

    #[error("Internal error: {message}")]
    Internal { message: String },
}

/// Result type used by agent operations.
pub type AgentResult<T> = Result<T, AgentError>;