noos 0.4.1

Reliability layer for Rust LLM agents: scope drift, cost circuit breaks, and procedural correction memory as event-driven Decisions.
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

//! Noos error types — structured errors with context (P5: fail-open ≠ swallow).
//!
//! Every fallible function returns `Result<T, NoosError>`. Callers can
//! `.unwrap_or_default()` for fail-open, or `.inspect_err()` for monitoring.

use thiserror::Error;

/// Top-level error type for all Noos operations.
#[derive(Debug, Error)]
pub enum NoosError {
    /// AI provider returned an error (HTTP, timeout, auth).
    #[error("AI provider error: {provider} — {message}")]
    Provider {
        provider: String,
        message: String,
        status: Option<u16>,
    },

    /// Plugin lifecycle error (init, destroy, enrich).
    #[error("Plugin error: {plugin_id} — {message}")]
    Plugin { plugin_id: String, message: String },

    /// Pipeline execution error.
    #[error("Pipeline error: {composition_id} step {step} — {message}")]
    Pipeline {
        composition_id: String,
        step: usize,
        message: String,
    },

    /// Serialization/deserialization error.
    #[error("Serialization error: {0}")]
    Serialization(String),

    /// Memory/persistence error.
    #[error("Storage error: {0}")]
    Storage(String),

    /// Operation cancelled (via abort signal).
    #[error("Operation cancelled")]
    Cancelled,

    /// Intervention not supported at the required depth.
    /// The model doesn't support the requested intervention level.
    #[error("Unsupported intervention: {0}")]
    UnsupportedIntervention(String),

    /// Generic internal error.
    #[error("Internal error: {0}")]
    Internal(String),
}

impl From<serde_json::Error> for NoosError {
    fn from(e: serde_json::Error) -> Self {
        Self::Serialization(e.to_string())
    }
}

/// Convenience type alias.
pub type NoosResult<T> = Result<T, NoosError>;