ralph-agent-loop 0.3.1

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
99
100
101
102
103
104
105
106

//! Built-in plugin metadata regression coverage.
//!
//! Responsibilities:
//! - Verify built-in plugin identity, metadata, resume support, and session rules.
//! - Lock down invariants shared across the built-in runner catalog.
//!
//! Does not handle:
//! - Command-building argument coverage.
//! - Response parsing or executor dispatch behavior.
//!
//! Assumptions/invariants:
//! - Built-in plugin ordering stays stable across the seven supported runners.
//! - Kimi alone requires managed session IDs among built-ins.

use super::*;

// =============================================================================
// BuiltInRunnerPlugin Tests
// =============================================================================

#[test]
fn all_built_in_plugins_have_correct_runner_mapping() {
    assert_eq!(BuiltInRunnerPlugin::Codex.runner(), Runner::Codex);
    assert_eq!(BuiltInRunnerPlugin::Opencode.runner(), Runner::Opencode);
    assert_eq!(BuiltInRunnerPlugin::Gemini.runner(), Runner::Gemini);
    assert_eq!(BuiltInRunnerPlugin::Claude.runner(), Runner::Claude);
    assert_eq!(BuiltInRunnerPlugin::Kimi.runner(), Runner::Kimi);
    assert_eq!(BuiltInRunnerPlugin::Pi.runner(), Runner::Pi);
    assert_eq!(BuiltInRunnerPlugin::Cursor.runner(), Runner::Cursor);
}

#[test]
fn all_built_in_plugins_have_correct_id() {
    assert_eq!(BuiltInRunnerPlugin::Codex.id(), "codex");
    assert_eq!(BuiltInRunnerPlugin::Opencode.id(), "opencode");
    assert_eq!(BuiltInRunnerPlugin::Gemini.id(), "gemini");
    assert_eq!(BuiltInRunnerPlugin::Claude.id(), "claude");
    assert_eq!(BuiltInRunnerPlugin::Kimi.id(), "kimi");
    assert_eq!(BuiltInRunnerPlugin::Pi.id(), "pi");
    assert_eq!(BuiltInRunnerPlugin::Cursor.id(), "cursor");
}

#[test]
fn all_built_in_plugins_have_metadata() {
    let plugins: [BuiltInRunnerPlugin; 7] = [
        BuiltInRunnerPlugin::Codex,
        BuiltInRunnerPlugin::Opencode,
        BuiltInRunnerPlugin::Gemini,
        BuiltInRunnerPlugin::Claude,
        BuiltInRunnerPlugin::Kimi,
        BuiltInRunnerPlugin::Pi,
        BuiltInRunnerPlugin::Cursor,
    ];

    for plugin in &plugins {
        let metadata: RunnerMetadata = plugin.metadata();
        assert!(
            !metadata.id.is_empty(),
            "Plugin {:?} missing id",
            plugin.runner()
        );
        assert!(
            !metadata.name.is_empty(),
            "Plugin {:?} missing name",
            plugin.runner()
        );
        assert_eq!(metadata.id, plugin.id());
    }
}

#[test]
fn all_built_in_plugins_support_resume() {
    let plugins: [BuiltInRunnerPlugin; 7] = [
        BuiltInRunnerPlugin::Codex,
        BuiltInRunnerPlugin::Opencode,
        BuiltInRunnerPlugin::Gemini,
        BuiltInRunnerPlugin::Claude,
        BuiltInRunnerPlugin::Kimi,
        BuiltInRunnerPlugin::Pi,
        BuiltInRunnerPlugin::Cursor,
    ];

    for plugin in &plugins {
        let metadata: RunnerMetadata = plugin.metadata();
        assert!(
            metadata.supports_resume,
            "Plugin {:?} should support resume",
            plugin.runner()
        );
    }
}

#[test]
fn kimi_requires_managed_session_id() {
    assert!(BuiltInRunnerPlugin::Kimi.requires_managed_session_id());
}

#[test]
fn other_plugins_do_not_require_managed_session_id() {
    assert!(!BuiltInRunnerPlugin::Codex.requires_managed_session_id());
    assert!(!BuiltInRunnerPlugin::Opencode.requires_managed_session_id());
    assert!(!BuiltInRunnerPlugin::Gemini.requires_managed_session_id());
    assert!(!BuiltInRunnerPlugin::Claude.requires_managed_session_id());
    assert!(!BuiltInRunnerPlugin::Pi.requires_managed_session_id());
    assert!(!BuiltInRunnerPlugin::Cursor.requires_managed_session_id());
}