Struct AgentLoopConfig 

pub struct AgentLoopConfig {
    pub max_iterations: usize,
    pub enable_tools: bool,
    pub require_approval: bool,
    pub prompt_injection_protection: bool,
    pub token_lifetime_secs: u64,
    pub no_final_required: bool,
    pub fallback_chain: Option<Arc<Mutex<ProviderFallbackChain>>>,
    pub token_budget: Option<Arc<Mutex<TokenBudget>>>,
    pub ravenfabric: Option<RavenFabricClient>,
    pub checkpoint_dir: Option<PathBuf>,
    pub session_id: Option<String>,
    pub metrics_callback: Option<Box<dyn Fn(u64, u64) + Send + Sync>>,
}

Agent loop configuration

Note: Debug and Clone are implemented manually because metrics_callback is a boxed closure that doesn’t implement either trait.

Fields

max_iterations: usize

Maximum iterations before forcing completion

enable_tools: bool

Whether to enable tool calling

require_approval: bool

Require human approval for tool calls

prompt_injection_protection: bool

Enable prompt-injection defense on LLM responses

token_lifetime_secs: u64

Maximum session lifetime in seconds (0 = unlimited) When non-zero, the agent loop will stop after this duration to enforce credential/session expiry.

no_final_required: bool

When true, treat any non-tool-call response as completion (no FINAL: required)

fallback_chain: Option<Arc<Mutex<ProviderFallbackChain>>>

Optional provider fallback chain — tries providers in order on failure

token_budget: Option<Arc<Mutex<TokenBudget>>>

Optional token budget — limits total tokens used per session

ravenfabric: Option<RavenFabricClient>

Optional RavenFabric client — reports agent status and results to mesh

checkpoint_dir: Option<PathBuf>

Optional checkpoint directory for durable execution. When set, the agent loop saves state after each iteration and can resume from the latest checkpoint if interrupted.

session_id: Option<String>

Unique session ID for checkpointing. If not set but checkpoint_dir is set, a UUID is generated automatically.

metrics_callback: Option<Box<dyn Fn(u64, u64) + Send + Sync>>

Optional callback for recording metrics (token usage, tool calls). Called with (tokens_used, tool_calls_count) after each iteration. This allows the HTTP server to wire ServerMetrics without coupling agent.rs to server.rs.

Trait Implementations

impl Clone for AgentLoopConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentLoopConfig

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

Formats the value using the given formatter.

impl Default for AgentLoopConfig

fn default() -> Self

Returns the “default value” for a type.