Struct AgentRunConfig 

pub struct AgentRunConfig {
    pub root: PathBuf,
    pub model: String,
    pub search_mode: WebSearchMode,
    pub search_url: Option<String>,
    pub reasoning_effort: ReasoningEffort,
    pub reasoning_summary: ReasoningSummary,
    pub max_tool_iterations: usize,
    pub mcp_manager: Option<Arc<McpManager>>,
    pub process_registry: Option<ProcessRegistry>,
    pub accounting_turn_id: Option<String>,
    pub accounting_context: Vec<ContextItemSnapshot>,
}

Configuration for an agent run, shared by the fake and Umans providers.

Fields

root: PathBuf

Workspace root for tool containment and file reads.

model: String

Selected model name.

search_mode: WebSearchMode

Web search mode.

search_url: Option<String>

Optional SearXNG base URL used by the application-owned web search tool.

reasoning_effort: ReasoningEffort

Reasoning effort requested for supporting provider models.

TODO: Route this through every provider/model family that supports reasoning-effort controls.

reasoning_summary: ReasoningSummary

Whether supporting providers should return reasoning summaries.

TODO: Route this through every provider/model family that supports reasoning-summary controls.

max_tool_iterations: usize

Maximum tool-call iterations per turn.

mcp_manager: Option<Arc<McpManager>>

Optional MCP manager used to extend the built-in tool registry.

process_registry: Option<ProcessRegistry>

Shared application owner for background shell processes.

accounting_turn_id: Option<String>

Turn id associated with request accounting.

accounting_context: Vec<ContextItemSnapshot>

Context candidates captured before the first provider request.

Implementations

impl AgentRunConfig

pub fn new(root: PathBuf, model: String, search_mode: WebSearchMode) -> Self

pub fn with_reasoning( self, effort: ReasoningEffort, summary: ReasoningSummary, ) -> Self

Apply the resolved reasoning settings for this run.

pub fn with_search_url(self, search_url: Option<String>) -> Self

Apply the configured SearXNG base URL for this run.

pub fn search_config(&self) -> SearchConfig

Build the application-owned search configuration for this run.

pub fn with_mcp_manager(self, manager: Arc<McpManager>) -> Self

Attach an MCP manager to this run.

pub fn with_process_registry(self, registry: ProcessRegistry) -> Self

Attach the application-owned registry used for background shell tools.

pub fn with_request_context( self, turn_id: impl Into<String>, ledger: &ContextLedger, ) -> Self

Attach the immutable context snapshot used by provider request accounting.

Trait Implementations

impl Clone for AgentRunConfig

fn clone(&self) -> AgentRunConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRunConfig

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

Formats the value using the given formatter.