Struct EventLoopConfig 

pub struct EventLoopConfig {

    pub prompt: Option<String>,
    pub prompt_file: String,
    pub completion_promise: String,
    pub max_iterations: u32,
    pub max_runtime_seconds: u64,
    pub max_cost_usd: Option<f64>,
    pub max_consecutive_failures: u32,
    pub cooldown_delay_seconds: u64,
    pub starting_hat: Option<String>,
    pub starting_event: Option<String>,
    pub mutation_score_warn_threshold: Option<f64>,
    pub persistent: bool,
    pub required_events: Vec<String>,
    pub cancellation_promise: String,
    pub enforce_hat_scope: bool,
}

Event loop configuration.

Fields

prompt: Option<String>

Inline prompt text (mutually exclusive with prompt_file).

prompt_file: String

Path to the prompt file.

completion_promise: String

Event topic that signals loop completion (must be emitted via ralph emit).

max_iterations: u32

Maximum number of iterations before timeout.

max_runtime_seconds: u64

Maximum runtime in seconds.

max_cost_usd: Option<f64>

Maximum cost in USD before stopping.

max_consecutive_failures: u32

Stop after this many consecutive failures.

cooldown_delay_seconds: u64

Delay in seconds before starting the next iteration. Skipped when the next iteration is triggered by a human event.

starting_hat: Option<String>

Starting hat for multi-hat mode (deprecated, use starting_event instead).

starting_event: Option<String>

Event to publish after Ralph completes initial coordination.

When custom hats are defined, Ralph handles task.start to do gap analysis and planning, then publishes this event to delegate to the first hat.

Example: starting_event: "tdd.start" for TDD workflow.

If not specified and hats are defined, Ralph will determine the appropriate event from the hat topology.

mutation_score_warn_threshold: Option<f64>

Warn when mutation testing score drops below this percentage (0-100).

Warning-only: build.done is still accepted even if below threshold.

persistent: bool

When true, LOOP_COMPLETE does not terminate the loop.

Instead of exiting, the loop injects a task.resume event and continues idling until new work arrives (human guidance, Telegram commands, etc.). The loop will only terminate on hard limits (max_iterations, max_runtime, max_cost), consecutive failures, or explicit interrupt/stop.

required_events: Vec<String>

Event topics that must have been seen before LOOP_COMPLETE is accepted. If any required event has not been seen during the loop’s lifetime, completion is rejected and a task.resume event is injected.

cancellation_promise: String

Event topic that triggers graceful early termination WITHOUT chain validation. Use this for human rejection, timeout escalation, or other abort paths. Defaults to “” (disabled). Set to “loop.cancel” to enable.

enforce_hat_scope: bool

When true, events emitted by a hat are validated against its declared publishes list. Out-of-scope events are dropped and replaced with {hat_id}.scope_violation diagnostic events. Defaults to false (permissive).

Trait Implementations

impl Clone for EventLoopConfig

fn clone(&self) -> EventLoopConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventLoopConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EventLoopConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventLoopConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventLoopConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.