opencrabs 0.3.45

The autonomous, self-improving AI agent. Single Rust binary. Every channel. Install with: cargo install opencrabs
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

//! Error types and error codes for OpenCrabs.

use thiserror::Error;

#[derive(Error, Debug)]
pub enum OpenCrabsError {
    #[error("Database error: {0}")]
    Database(#[from] rusqlite::Error),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Configuration error: {message}")]
    Config { message: String, code: ErrorCode },

    #[error("LLM provider error: {provider} - {message}")]
    Provider {
        provider: String,
        message: String,
        code: ErrorCode,
    },

    #[error("Tool execution error: {tool} - {message}")]
    ToolExecution {
        tool: String,
        message: String,
        code: ErrorCode,
    },

    #[error("Permission denied: {0}")]
    PermissionDenied(String),
}

#[derive(Debug, Clone, Copy)]
pub enum ErrorCode {
    // Configuration errors (1000-1999)
    ConfigNotFound = 1000,
    ConfigInvalid = 1001,
    ConfigMergeError = 1002,

    // Provider errors (2000-2999)
    ProviderNotFound = 2000,
    ProviderAuthFailed = 2001,
    ProviderRateLimit = 2002,
    ProviderTimeout = 2003,

    // Tool errors (3000-3999)
    ToolNotFound = 3000,
    ToolExecutionFailed = 3001,
    ToolTimeout = 3002,

    // Permission errors (4000-4999)
    PermissionDenied = 4000,
    PermissionNotGranted = 4001,
}

impl OpenCrabsError {
    pub fn code(&self) -> Option<ErrorCode> {
        match self {
            Self::Config { code, .. } => Some(*code),
            Self::Provider { code, .. } => Some(*code),
            Self::ToolExecution { code, .. } => Some(*code),
            _ => None,
        }
    }

    pub fn user_message(&self) -> String {
        match self {
            Self::Config { message, .. } => {
                format!(
                    "Configuration error: {}\nPlease check your opencrabs.json file.",
                    message
                )
            }
            Self::Provider {
                provider, message, ..
            } => {
                format!(
                    "Error with {} provider: {}\nPlease verify your API key.",
                    provider, message
                )
            }
            Self::ToolExecution { tool, message, .. } => {
                format!("Tool '{}' failed: {}", tool, message)
            }
            Self::PermissionDenied(tool) => {
                format!(
                    "Permission denied for tool '{}'. Grant permission or add to whitelist.",
                    tool
                )
            }
            _ => self.to_string(),
        }
    }
}