ralph-agent-loop 0.4.0

A Rust CLI for managing AI agent loops with a structured JSON task queue
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

//! Claude-style stream event extraction.
//!
//! Responsibilities:
//! - Render Claude assistant message content, tool use, and terminal error payloads.
//! - Handle `message_end` tool result formatting.
//!
//! Does not handle:
//! - Codex item streams.
//! - OpenCode/Cursor/Gemini/Kimi-specific payloads.

use crate::outpututil;
use serde_json::Value as JsonValue;

use super::super::stream_tool_details::format_tool_details;
use super::common;

pub(super) fn collect_lines(json: &JsonValue, lines: &mut Vec<String>) {
    let Some(event_type) = json.get("type").and_then(|t| t.as_str()) else {
        return;
    };

    if event_type == "assistant"
        && let Some(message) = json.get("message")
        && let Some(content) = message.get("content").and_then(|c| c.as_array())
    {
        for item in content {
            match item.get("type").and_then(|t| t.as_str()) {
                Some("text") => common::push_text(lines, item.get("text").and_then(|t| t.as_str())),
                Some("thinking" | "analysis" | "reasoning") => {
                    common::push_reasoning(lines, item.get("text").and_then(|t| t.as_str()))
                }
                Some("tool_use") => {
                    if let Some(name) = item.get("name").and_then(|n| n.as_str()) {
                        let details = item.get("input").and_then(format_tool_details);
                        lines.push(outpututil::format_tool_call(name, details.as_deref()));
                    }
                }
                _ => {}
            }
        }
    }

    if event_type == "message_end"
        && let Some(message) = json.get("message")
    {
        match message.get("role").and_then(|r| r.as_str()) {
            Some("assistant") => push_message_content(message.get("content"), lines),
            Some("toolResult") => {
                let tool = message
                    .get("toolName")
                    .and_then(|t| t.as_str())
                    .unwrap_or("tool");
                let is_error = message
                    .get("isError")
                    .and_then(|v| v.as_bool())
                    .unwrap_or(false);
                let status = if is_error { "error" } else { "completed" };
                lines.push(outpututil::format_tool_call(
                    tool,
                    Some(&format!("({status})")),
                ));
            }
            _ => {}
        }
    }

    if event_type == "result"
        && json
            .get("is_error")
            .and_then(|flag| flag.as_bool())
            .unwrap_or(false)
    {
        if let Some(errors) = json.get("errors").and_then(|e| e.as_array()) {
            for error in errors {
                common::push_error(lines, error.as_str());
            }
        } else {
            common::push_error(
                lines,
                json.get("error")
                    .and_then(|e| e.get("message"))
                    .and_then(|m| m.as_str()),
            );
        }
    }
}

fn push_message_content(content: Option<&JsonValue>, lines: &mut Vec<String>) {
    match content {
        Some(JsonValue::String(text)) => common::push_text(lines, Some(text)),
        Some(JsonValue::Array(items)) => {
            for item in items {
                common::push_text(lines, item.get("text").and_then(|t| t.as_str()));
            }
        }
        _ => {}
    }
}