Struct AgentLoopConfig 

pub struct AgentLoopConfig {

    pub model_id: String,
    pub system_prompt: Option<String>,
    pub temperature: f32,
    pub max_tokens: u32,
    pub tool_execution: ToolExecutionMode,
    pub compaction_strategy: CompactionStrategy,
    pub context_window: usize,
    pub compaction_instruction: Option<String>,
    pub session_id: Option<String>,
    pub transport: Option<String>,
    pub compact_on_start: bool,
    pub max_retry_delay_ms: Option<u64>,
    pub auto_retry_enabled: bool,
    pub auto_retry_max_attempts: usize,
    pub auto_retry_base_delay_ms: u64,
    pub api_key: Option<String>,
    pub workspace_dir: Option<PathBuf>,
    pub provider_options: Option<ProviderOptions>,
    pub on_compaction: Option<CompactionHook>,
    pub snapshot_store: Option<Arc<dyn SnapshotStore>>,
    pub memory: Option<Arc<dyn MemoryBackend>>,
    pub url_resolver: Option<Arc<dyn UrlResolver>>,
    pub todo: Option<Arc<dyn TodoStateProvider>>,
    pub agent_pool: Option<Arc<dyn AgentPoolProvider>>,
    pub lsp: Option<Arc<dyn LspProvider>>,
    pub ttsr_engine: Option<Arc<TtsrEngine>>,
}

Configuration for an crate::AgentLoop instance.

Fields

model_id: String

Model identifier in provider/model format.

system_prompt: Option<String>

Optional system prompt prepended to every request.

temperature: f32

Sampling temperature (0.0 – 2.0).

max_tokens: u32

Maximum tokens the model may generate per request.

tool_execution: ToolExecutionMode

Whether tool calls run in parallel or sequentially.

compaction_strategy: CompactionStrategy

Compaction strategy for managing context window usage.

context_window: usize

Approximate context window size in tokens.

compaction_instruction: Option<String>

Optional instruction injected into the compaction prompt.

session_id: Option<String>

Optional session identifier for logging and tracing.

transport: Option<String>

Optional transport override (e.g. “sse”, “stdio”).

compact_on_start: bool

Whether to trigger compaction before the first turn.

max_retry_delay_ms: Option<u64>

Optional cap on retry back-off delay (milliseconds).

auto_retry_enabled: bool

Enable automatic retry on retryable assistant errors.

auto_retry_max_attempts: usize

Maximum number of auto-retry attempts.

auto_retry_base_delay_ms: u64

Base delay in milliseconds for auto-retry exponential back-off.

api_key: Option<String>

API key override for the provider.

When set, this is injected into oxi_ai::StreamOptions so the provider uses it instead of an environment variable.

workspace_dir: Option<PathBuf>

Working directory for file tools. Defaults to current directory if None.

provider_options: Option<ProviderOptions>

Per-provider options for fine-grained control.

Passed through to oxi_ai::StreamOptions::provider_options so the provider can read provider-specific settings.

on_compaction: Option<CompactionHook>

Async hook invoked after context compaction completes.

Unlike the Compaction event in the Fn callback, this hook is async and its future is awaited within the agent loop. Errors are logged at WARN level but don’t fail the loop.

Use this for side effects that require async I/O (e.g., persisting compaction summaries to a memory store) without resorting to tokio::spawn fire-and-forget.

snapshot_store: Option<Arc<dyn SnapshotStore>>

Snapshot store for hashline edit mode.

memory: Option<Arc<dyn MemoryBackend>>

Memory backend for memory tools.

url_resolver: Option<Arc<dyn UrlResolver>>

URL resolver for internal protocol schemes.

todo: Option<Arc<dyn TodoStateProvider>>

Todo state provider for the todo tool.

agent_pool: Option<Arc<dyn AgentPoolProvider>>

Agent pool for Hub display.

lsp: Option<Arc<dyn LspProvider>>

LSP provider for the lsp tool.

ttsr_engine: Option<Arc<TtsrEngine>>

TTSR engine for stream rule checking.

Trait Implementations

impl Clone for AgentLoopConfig

fn clone(&self) -> AgentLoopConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for AgentLoopConfig

fn default() -> Self

Returns the “default value” for a type.