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

//! Shared helpers for runner invocations with consistent error handling.
//!
//! Responsibilities:
//! - Provide a single "runutil" surface for runner execution helpers and revert/abort utilities.
//! - Re-export cohesive submodules so call sites keep using `crate::runutil::{...}`.
//!
//! Not handled here:
//! - Prompt template rendering, queue/task persistence, or runner selection logic.
//!
//! Invariants/assumptions:
//! - Submodules remain cohesive (execution vs revert vs abort vs ci-gate vs retry).
//! - Re-exports preserve the existing public and `pub(crate)` API surface.

mod abort;
mod ci_gate;
mod execution;
mod process_groups;
mod process_wait;
mod retry;
mod revert;
mod shell;

#[cfg(test)]
mod tests;

// --- Public API (unchanged call-site paths) ----------------------------------

pub use revert::{
    RevertDecision, RevertOutcome, RevertPromptContext, RevertPromptHandler, RevertSource,
    apply_git_revert_mode, apply_git_revert_mode_with_context, format_revert_failure_message,
    parse_revert_response, prompt_revert_choice_with_io,
};

// --- Crate-private API (unchanged call-site paths) ---------------------------

pub(crate) use abort::{
    RunAbort, RunAbortReason, abort_reason, is_dirty_repo_error, is_queue_validation_error,
};
pub(crate) use ci_gate::execute_ci_gate;
pub(crate) use process_groups::isolate_child_process_group;
pub(crate) use process_wait::{
    ChildTerminationReason, ChildWaitOptions, wait_for_child_with_callbacks,
};

pub(crate) use execution::{
    RunnerErrorMessages, RunnerExecutionContext, RunnerFailureHandling, RunnerInvocation,
    RunnerRetryState, RunnerSettings, run_prompt_with_handling, should_fallback_to_fresh_continue,
};

pub(crate) use retry::{
    FixedBackoffSchedule, RunnerRetryPolicy, SeededRng, compute_backoff, format_duration,
};
pub(crate) use shell::{
    ManagedCommand, TimeoutClass, execute_checked_command, execute_managed_command,
    sleep_with_cancellation,
};

#[cfg(test)]
pub(crate) use execution::{
    RunnerBackend, RunnerBackendResumeSession, RunnerBackendRunPrompt,
    run_prompt_with_handling_backend,
};