agent-tools 0.1.0

agent command
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

mod tools;

use std::fmt;
use std::io;

/// Core error struct for the workspace.
/// This hides the internal details of specific errors (like ToolError).
#[derive(Debug)]
pub struct Error {
    inner: Box<ErrorKind>,
}

/// Internal enum representing all possible error variants.
/// This is not exposed publicly, preventing users from matching on internal details.
#[derive(Debug, thiserror::Error)]
enum ErrorKind {
    #[error(transparent)]
    Tools(#[from] tools::ToolError),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{}", self.inner)
    }
}

impl std::error::Error for Error {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        self.inner.source()
    }
}

impl Error {
    /// Creates an IO error associated with tools execution.
    pub fn tool_io(err: io::Error) -> Self {
        Error {
            inner: Box::new(ErrorKind::Tools(tools::ToolError::Io(err))),
        }
    }
    
    /// Creates a command failure error associated with tools execution.
    pub fn tool_cmd_failed(code: i32) -> Self {
        Error {
            inner: Box::new(ErrorKind::Tools(tools::ToolError::CommandFailed(code))),
        }
    }

    /// Creates a timeout error associated with tools execution.
    pub fn tool_timeout() -> Self {
        Error {
            inner: Box::new(ErrorKind::Tools(tools::ToolError::Timeout)),
        }
    }
}

/// Result type alias using the opaque Error.
pub type Result<T> = std::result::Result<T, Error>;