qq-cli 0.1.0

A modular Rust QQ task interface for coding agents
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

use crate::core::contracts::{action::NextAction, failure::Details, write::Outcome};
use serde::Serialize;

pub type Result<T> = std::result::Result<T, AppError>;

/// Error messages are curated; raw backend/library errors never enter default output.
#[derive(Debug, Clone, Serialize, schemars::JsonSchema)]
#[serde(rename_all = "camelCase", deny_unknown_fields)]
pub struct AppError {
    pub code: &'static str,
    pub message: &'static str,
    pub retry_safe: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    #[schemars(with = "Outcome")]
    pub outcome: Option<Outcome>,
    #[serde(skip_serializing_if = "Option::is_none")]
    #[schemars(with = "String")]
    pub request_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    #[schemars(with = "NextAction")]
    pub next_action: Option<Box<NextAction>>,
    #[serde(skip_serializing_if = "Option::is_none")]
    #[schemars(with = "Details")]
    pub details: Option<Box<Details>>,
    #[serde(skip)]
    pub scope: Option<Box<crate::core::domain::Scope>>,
    #[serde(skip)]
    pub exit_code: u8,
}

impl AppError {
    pub fn new(code: &'static str, message: &'static str, exit_code: u8) -> Self {
        Self {
            code,
            message,
            retry_safe: false,
            outcome: None,
            request_id: None,
            next_action: None,
            details: None,
            scope: None,
            exit_code,
        }
    }
    pub fn invalid() -> Self {
        Self::new(
            "INVALID_ARGUMENTS",
            "Invalid arguments; inspect this command with --help.",
            2,
        )
    }
    pub fn storage() -> Self {
        Self::new(
            "STATE_IO",
            "Private local state could not be read or persisted.",
            6,
        )
    }
    pub fn protocol() -> Self {
        Self::new(
            "BACKEND_PROTOCOL",
            "Backend response does not match the supported contract.",
            3,
        )
    }
    pub fn with_details(mut self, details: Details) -> Self {
        self.details = Some(Box::new(details));
        self
    }
    pub fn safe_to_retry(mut self) -> Self {
        self.retry_safe = true;
        self
    }
    pub fn with_scope(mut self, scope: crate::core::domain::Scope) -> Self {
        self.scope = Some(Box::new(scope));
        self
    }
}