ralph-workflow 0.7.18

PROMPT-driven multi-agent orchestrator for git repos
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Truncation limits for verbosity levels.
//!
//! This module defines the character limits for different content types
//! at each verbosity level. These limits control how much output is displayed
//! in the terminal to balance usability with information density.
//!
//! # Content Types
//!
//! - `text`: Assistant text output
//! - `tool_result`: Tool execution results
//! - `tool_input`: Tool input parameters
//! - `user`: User messages
//! - `result`: Final result summaries
//! - `command`: Command execution strings
//! - `agent_msg`: Agent messages/thinking

/// Maximum number of lines to show for multi-line tool output.
pub const MAX_OUTPUT_LINES: usize = 5;

/// Truncation limits for Quiet verbosity mode.
///
/// Quiet mode uses aggressive truncation to minimize output noise.
pub mod quiet {
    pub const TEXT: usize = 80;
    pub const TOOL_RESULT: usize = 60;
    pub const TOOL_INPUT: usize = 40;
    pub const USER: usize = 40;
    pub const RESULT: usize = 300;
    pub const COMMAND: usize = 60;
    pub const AGENT_MSG: usize = 80;
    pub const DEFAULT: usize = 60;
}

/// Truncation limits for Normal verbosity mode.
///
/// Normal mode provides balanced output with moderate truncation
/// for better usability while still keeping output manageable.
pub mod normal {
    pub const TEXT: usize = 1000;
    pub const TOOL_RESULT: usize = 500;
    pub const TOOL_INPUT: usize = 300;
    pub const USER: usize = 200;
    pub const RESULT: usize = 3000;
    pub const COMMAND: usize = 400;
    pub const AGENT_MSG: usize = 1000;
    pub const DEFAULT: usize = 500;
}

/// Truncation limits for Verbose verbosity mode.
///
/// Verbose is the default mode, providing reasonable limits to help
/// users understand agent behavior without overwhelming output.
pub mod verbose {
    pub const TEXT: usize = 2000;
    pub const TOOL_RESULT: usize = 500;
    pub const TOOL_INPUT: usize = 300;
    pub const USER: usize = 400;
    pub const RESULT: usize = 5000;
    pub const COMMAND: usize = 400;
    pub const AGENT_MSG: usize = 2000;
    pub const DEFAULT: usize = 1000;
}

/// Effectively unlimited output for Full/Debug modes.
pub const UNLIMITED: usize = 999_999;

/// Returns the truncation limit for a content type at a given verbosity level.
///
/// # Arguments
///
/// * `level` - The verbosity level (0=Quiet, 1=Normal, 2=Verbose, 3+=Full/Debug)
/// * `content_type` - The type of content being truncated
///
/// # Returns
///
/// The maximum number of characters to display for the given content type.
#[must_use]
pub fn get_limit(level: u8, content_type: &str) -> usize {
    match level {
        0 => match content_type {
            "text" => quiet::TEXT,
            "tool_result" => quiet::TOOL_RESULT,
            "tool_input" => quiet::TOOL_INPUT,
            "user" => quiet::USER,
            "result" => quiet::RESULT,
            "command" => quiet::COMMAND,
            "agent_msg" => quiet::AGENT_MSG,
            _ => quiet::DEFAULT,
        },
        1 => match content_type {
            "text" => normal::TEXT,
            "tool_result" => normal::TOOL_RESULT,
            "tool_input" => normal::TOOL_INPUT,
            "user" => normal::USER,
            "result" => normal::RESULT,
            "command" => normal::COMMAND,
            "agent_msg" => normal::AGENT_MSG,
            _ => normal::DEFAULT,
        },
        2 => match content_type {
            "text" => verbose::TEXT,
            "tool_result" => verbose::TOOL_RESULT,
            "tool_input" => verbose::TOOL_INPUT,
            "user" => verbose::USER,
            "result" => verbose::RESULT,
            "command" => verbose::COMMAND,
            "agent_msg" => verbose::AGENT_MSG,
            _ => verbose::DEFAULT,
        },
        _ => UNLIMITED,
    }
}