Struct RunConfig 

pub struct RunConfig {
    pub streaming_mode: StreamingMode,
    pub tool_confirmation_decisions: HashMap<String, ToolConfirmationDecision>,
    pub cached_content: Option<String>,
    pub transfer_targets: Vec<String>,
    pub parent_agent: Option<String>,
    pub auto_cache: bool,
    pub history_max_events: Option<usize>,
    pub max_tool_concurrency: Option<usize>,
    pub record_payloads: bool,
    pub trace_payload_max_bytes: usize,
}

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

Fields

streaming_mode: StreamingMode

tool_confirmation_decisions: HashMap<String, ToolConfirmationDecision>

Optional per-tool confirmation decisions for the current run. Keys are tool names.

cached_content: Option<String>

Optional cached content name for automatic prompt caching. When set by the runner’s cache lifecycle manager, agents should attach this name to their GenerateContentConfig so the LLM provider can reuse cached system instructions and tool definitions.

transfer_targets: Vec<String>

Valid agent names this agent can transfer to (parent, peers, children). Set by the runner when invoking agents in a multi-agent tree. When non-empty, the transfer_to_agent tool is injected and validation uses this list instead of only checking sub_agents.

parent_agent: Option<String>

The name of the parent agent, if this agent was invoked via transfer. Used by the agent to apply disallow_transfer_to_parent filtering.

auto_cache: bool

Enable automatic prompt caching for all providers that support it.

When true (the default), the runner enables provider-level caching:

• Anthropic: sets prompt_caching = true on the config
• Bedrock: sets prompt_caching = Some(BedrockCacheConfig::default())
• OpenAI / DeepSeek: no action needed (caching is automatic)
• Gemini: handled separately via ContextCacheConfig

history_max_events: Option<usize>

Maximum number of recent persisted events to load at the start of a run.

None preserves the previous behavior and loads the full session history. Set this for chat surfaces that already summarize older turns and need predictable startup latency.

max_tool_concurrency: Option<usize>

Maximum number of tool calls to execute concurrently for parallel/auto tool dispatch. None allows all eligible tool calls to run together.

record_payloads: bool

Whether tracing spans may include full request, response, and tool payloads when the record-payloads crate feature is enabled.

trace_payload_max_bytes: usize

Maximum serialized bytes recorded for tracing payload fields when full payload recording is disabled.

Trait Implementations

impl Clone for RunConfig

fn clone(&self) -> RunConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunConfig

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

Formats the value using the given formatter.

impl Default for RunConfig

fn default() -> RunConfig

Returns the “default value” for a type.