ironclaw 0.5.0

Secure personal AI assistant that protects your data and expands its capabilities on the fly
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

//! Error types for WASM channels.

use std::path::PathBuf;

/// Error during WASM channel operations.
#[derive(Debug, thiserror::Error)]
pub enum WasmChannelError {
    #[error("Channel {name} failed to start: {reason}")]
    StartupFailed { name: String, reason: String },

    #[error("Channel {name} callback failed: {reason}")]
    CallbackFailed { name: String, reason: String },

    #[error("Channel {name} WASM execution trapped: {reason}")]
    Trapped { name: String, reason: String },

    #[error("Channel {name} callback '{callback}' timed out")]
    Timeout { name: String, callback: String },

    #[error("Channel {name} execution panicked: {reason}")]
    ExecutionPanicked { name: String, reason: String },

    #[error("Channel {name} emit rate limited")]
    EmitRateLimited { name: String },

    #[error("Channel {name} HTTP path not allowed: {path}")]
    PathNotAllowed { name: String, path: String },

    #[error("Channel {name} polling interval too short: {interval_ms}ms (minimum: {min_ms}ms)")]
    PollIntervalTooShort {
        name: String,
        interval_ms: u32,
        min_ms: u32,
    },

    #[error("Channel {name} workspace path escape attempt: {path}")]
    WorkspaceEscape { name: String, path: String },

    #[error("Channel {name} exhausted fuel limit ({limit})")]
    FuelExhausted { name: String, limit: u64 },

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

    #[error("WASM file not found: {0}")]
    WasmNotFound(PathBuf),

    #[error("Capabilities file not found: {0}")]
    CapabilitiesNotFound(PathBuf),

    #[error("Invalid capabilities JSON: {0}")]
    InvalidCapabilities(String),

    #[error("WASM compilation error: {0}")]
    Compilation(String),

    #[error("WASM instantiation error: {0}")]
    Instantiation(String),

    #[error("Invalid channel name: {0}")]
    InvalidName(String),

    #[error("Channel {name} not found")]
    NotFound { name: String },

    #[error("Channel module missing export: {0}")]
    MissingExport(String),

    #[error("Invalid response from WASM: {0}")]
    InvalidResponse(String),

    #[error("Runtime not initialized")]
    RuntimeNotInitialized,

    #[error("Configuration error: {0}")]
    Config(String),

    #[error("Webhook registration failed for channel {name}: {reason}")]
    WebhookRegistration { name: String, reason: String },

    #[error("HTTP request error: {0}")]
    HttpRequest(String),
}

impl From<crate::tools::wasm::WasmError> for WasmChannelError {
    fn from(err: crate::tools::wasm::WasmError) -> Self {
        WasmChannelError::Compilation(err.to_string())
    }
}