ralph-coder 0.2.1

An agentic code generation CLI powered by multiple LLM backends
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

use thiserror::Error;

#[derive(Error, Debug)]
pub enum RalphError {
    // Config & startup
    #[error("Missing API key: {env_var} must be set to use --{provider}")]
    MissingApiKey { env_var: String, provider: String },

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

    #[error("No provider specified. Use --anthropic, --openai, --deepseek, or --gemini")]
    NoProvider,

    // Provider / LLM
    #[error("LLM API error ({provider}): {message}")]
    LlmApi { provider: String, message: String },

    #[error("LLM rate limited ({provider}). Retried {attempts} times.")]
    LlmRateLimit { provider: String, attempts: u32 },

    #[error("LLM authentication failed ({provider}). Check your API key.")]
    LlmAuth { provider: String },

    #[error("LLM returned malformed tool call: {0}")]
    MalformedToolCall(String),

    #[error("LLM response was empty or unparseable: {0}")]
    LlmResponseParse(String),

    // Tools
    #[error("Tool '{tool}' failed: {message}")]
    ToolFailed { tool: String, message: String },

    #[error("Path is outside the workspace: {0}")]
    PathEscape(String),

    #[error("File not found: {0}")]
    FileNotFound(String),

    #[error("Edit failed: old_string not found in {path}")]
    EditNotFound { path: String },

    #[error("Command blocked by guardrail: {0}")]
    BlockedCommand(String),

    #[error("Secret detected in generated content — refusing to write")]
    SecretDetected,

    // Session
    #[error("Session not found: {0}")]
    SessionNotFound(String),

    #[error("Session file is corrupt: {0}")]
    SessionCorrupt(String),

    // Checkpoint
    #[error("Checkpoint not found: {0}")]
    CheckpointNotFound(String),

    #[error("Checkpoint revert failed: {0}")]
    CheckpointRevertFailed(String),

    // Loop
    #[error("Max turns ({0}) reached without completing the task")]
    MaxTurnsReached(u32),

    #[error("Task interrupted by user")]
    Interrupted,

    #[error("Guardrail violation: {0}")]
    GuardrailViolation(String),

    #[error("Task aborted by user")]
    UserAborted,

    // Search
    #[error("Web search failed: {0}")]
    SearchFailed(String),

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

    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),
}

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