Struct RunConfigBuilder 

pub struct RunConfigBuilder { /* private fields */ }

Core traits and types.

Always available regardless of feature flags. Includes:

• Agent - The fundamental trait for all agents
• Tool / Toolset - For extending agents with capabilities
• Session / State - For managing conversation context
• Event - For streaming agent responses
• AdkError / Result - Unified error handling Builder for RunConfig.

Provides a fluent API for constructing RunConfig instances. All fields start with their default values and can be overridden individually.

Example

use adk_core::{RunConfig, RunConfigBuilder, StreamingMode, ToolConcurrencyConfig};

let config = RunConfigBuilder::default()
    .streaming_mode(StreamingMode::Bidi)
    .history_max_events(Some(50))
    .build();

Implementations

impl RunConfigBuilder

pub fn streaming_mode(self, mode: StreamingMode) -> RunConfigBuilder

Sets the streaming mode for the run.

pub fn tool_confirmation_decisions( self, decisions: HashMap<String, ToolConfirmationDecision>, ) -> RunConfigBuilder

Sets static confirmation decisions for the current run, keyed by function call ID.

The ID is the one carried on ToolConfirmationRequest::function_call_id.

pub fn tool_confirmation_fingerprints( self, fingerprints: HashMap<String, String>, ) -> RunConfigBuilder

Binds confirmation decisions to the arguments they were granted for.

Keys are function call IDs and values are fingerprints from tool_call_fingerprint. A decision whose fingerprint does not match the actual call is ignored and the call is treated as unconfirmed.

pub fn tool_confirmation_handler( self, handler: Arc<dyn ToolConfirmationHandler>, ) -> RunConfigBuilder

Sets an asynchronous tool confirmation handler for the current run.

pub fn runtime_toolset(self, toolset: Arc<dyn Toolset>) -> RunConfigBuilder

Adds a toolset that is resolved only for this runner invocation.

pub fn runtime_toolsets( self, toolsets: impl IntoIterator<Item = Arc<dyn Toolset>>, ) -> RunConfigBuilder

Adds several toolsets that are resolved only for this runner invocation.

pub fn cached_content(self, name: impl Into<String>) -> RunConfigBuilder

Sets the cached content name for automatic prompt caching.

pub fn transfer_targets(self, targets: Vec<String>) -> RunConfigBuilder

Sets the valid agent names this agent can transfer to.

pub fn parent_agent(self, name: impl Into<String>) -> RunConfigBuilder

Sets the parent agent name.

pub fn auto_cache(self, enabled: bool) -> RunConfigBuilder

Enables or disables automatic prompt caching for supported providers.

pub fn history_max_events(self, max: Option<usize>) -> RunConfigBuilder

Sets the maximum number of recent persisted events to load at run start.

pub fn tool_concurrency(self, config: ToolConcurrencyConfig) -> RunConfigBuilder

Sets the tool concurrency configuration.

pub fn record_payloads(self, enabled: bool) -> RunConfigBuilder

Enables or disables full payload recording in tracing spans.

pub fn trace_payload_max_bytes(self, max: usize) -> RunConfigBuilder

Sets the maximum serialized bytes for tracing payload fields.

pub fn max_transfer_depth(self, depth: u32) -> RunConfigBuilder

Sets the maximum number of agent-to-agent transfers allowed in a single run.

Prevents infinite transfer loops. Defaults to 10 when None.

pub fn build(self) -> RunConfig

Consumes the builder and returns the configured RunConfig.

Trait Implementations

impl Clone for RunConfigBuilder

fn clone(&self) -> RunConfigBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunConfigBuilder

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

Formats the value using the given formatter.

impl Default for RunConfigBuilder

fn default() -> RunConfigBuilder

Returns the “default value” for a type.