Struct RunnerConfig 

pub struct RunnerConfig {
    pub max_iterations: usize,
    pub max_duration: Duration,
    pub compaction_threshold: usize,
    pub compaction_keep_recent: usize,
    pub retry: RetryConfig,
    pub checkpoint_interval: Option<usize>,
    pub emit_events: bool,
    pub observability: ObservabilityConfig,
}

Configuration for the AgentRunner loop.

Controls iteration limits, context compaction, retry behavior, and checkpointing intervals.

Fields

max_iterations: usize

Maximum number of tool-call iterations before the loop terminates. Prevents runaway executions. Default: 25 (zeroclaw uses configurable max_tool_iterations)

max_duration: Duration

Maximum wall-clock duration for the entire run. Default: 10 minutes

compaction_threshold: usize

Number of messages in history before auto-compaction triggers. When exceeded, older messages are summarized into a single context message. Default: 40 messages

compaction_keep_recent: usize

How many messages to keep verbatim after compaction. The rest are summarized. Default: 10 (keep the 10 most recent messages)

retry: RetryConfig

Retry configuration for transient errors.

checkpoint_interval: Option<usize>

Checkpoint every N steps. None disables periodic checkpointing. Default: Some(5)

emit_events: bool

Whether to emit verbose stream events for each iteration. Default: true

observability: ObservabilityConfig

Observability configuration

Implementations

impl RunnerConfig

pub fn interactive() -> Self

Create a config tuned for short, interactive sessions.

pub fn long_running() -> Self

Create a config tuned for long-running background agents.

pub fn with_model(self, model: impl Into<String>) -> Self

Set the model name for cost calculation

pub fn with_debug_logging(self) -> Self

Enable full prompt/response logging (debug mode)

Trait Implementations

impl Clone for RunnerConfig

fn clone(&self) -> RunnerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunnerConfig

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

Formats the value using the given formatter.

impl Default for RunnerConfig

fn default() -> Self

Returns the “default value” for a type.