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

//! Prompt abstractions for the AGENTS.md wizard.
//!
//! Responsibilities:
//! - Define the prompt operations required by the init and update wizards.
//! - Provide the dialoguer-backed interactive implementation.
//!
//! Not handled here:
//! - Scripted test prompt playback.
//! - Wizard step orchestration.
//!
//! Invariants/assumptions:
//! - Prompt failures are surfaced with prompt-specific context.
//! - Callers provide already-validated prompt defaults and option lists.

use anyhow::{Context as _, Result};
use dialoguer::{Confirm, Input, MultiSelect, Select};

/// Trait for prompting user input, allowing testable implementations.
pub(crate) trait ContextPrompter {
    /// Select a single item from a list. Returns the index of the selected item.
    fn select(&self, prompt: &str, items: &[String], default: usize) -> Result<usize>;

    /// Select multiple items from a list. Returns indices of selected items.
    fn multi_select(&self, prompt: &str, items: &[String], defaults: &[bool])
    -> Result<Vec<usize>>;

    /// Confirm a yes/no question.
    fn confirm(&self, prompt: &str, default: bool) -> Result<bool>;

    /// Get text input from user.
    fn input(&self, prompt: &str, default: Option<&str>, allow_empty: bool) -> Result<String>;

    /// Edit multi-line text in an editor.
    fn edit(&self, prompt: &str, initial: &str) -> Result<String>;
}

/// Dialoguer-based prompter for interactive terminal use.
pub(crate) struct DialoguerPrompter;

impl ContextPrompter for DialoguerPrompter {
    fn select(&self, prompt: &str, items: &[String], default: usize) -> Result<usize> {
        Select::new()
            .with_prompt(prompt)
            .items(items)
            .default(default)
            .interact()
            .with_context(|| format!("failed to get selection for: {prompt}"))
    }

    fn multi_select(
        &self,
        prompt: &str,
        items: &[String],
        defaults: &[bool],
    ) -> Result<Vec<usize>> {
        MultiSelect::new()
            .with_prompt(prompt)
            .items(items)
            .defaults(defaults)
            .interact()
            .with_context(|| format!("failed to get multi-selection for: {prompt}"))
    }

    fn confirm(&self, prompt: &str, default: bool) -> Result<bool> {
        Confirm::new()
            .with_prompt(prompt)
            .default(default)
            .interact()
            .with_context(|| format!("failed to get confirmation for: {prompt}"))
    }

    fn input(&self, prompt: &str, default: Option<&str>, allow_empty: bool) -> Result<String> {
        let mut input = Input::new();
        input = input.with_prompt(prompt).allow_empty(allow_empty);
        if let Some(default_value) = default {
            input = input.default(default_value.to_string());
        }
        input
            .interact_text()
            .with_context(|| format!("failed to get input for: {prompt}"))
    }

    fn edit(&self, prompt: &str, initial: &str) -> Result<String> {
        dialoguer::Editor::new()
            .edit(initial)
            .with_context(|| format!("failed to edit content for: {prompt}"))?
            .ok_or_else(|| anyhow::anyhow!("Editor was cancelled"))
    }
}