Struct ToolsConfig 

pub struct ToolsConfig {

    pub profile: ToolProfile,
    pub default_policy: ToolPolicy,
    pub policies: IndexMap<String, ToolPolicy>,
    pub max_tool_loops: usize,
    pub max_repeated_tool_calls: usize,
    pub max_consecutive_blocked_tool_calls_per_turn: usize,
    pub max_total_blocked_tool_calls_per_turn: Option<usize>,
    pub blocked_tool_thresholds: IndexMap<String, usize>,
    pub max_tool_rate_per_second: Option<usize>,
    pub max_sequential_spool_chunk_reads: usize,
    pub web_fetch: WebFetchConfig,
    pub web_search: WebSearchConfig,
    pub plugins: PluginRuntimeConfig,
    pub editor: EditorToolConfig,
    pub loop_thresholds: IndexMap<String, usize>,
    pub client_tool_search: bool,
}

Tools configuration

Fields

profile: ToolProfile

Model-facing tool profile.

default_policy: ToolPolicy

Default policy for tools not explicitly listed

policies: IndexMap<String, ToolPolicy>

Specific tool policies

max_tool_loops: usize

Maximum inner tool-call loops per user turn. Set to 0 to disable the limit.

Prevents infinite tool-calling cycles in interactive chat. This limits how many back-and-forths the agent will perform executing tools and re-asking the model before returning a final answer.

max_repeated_tool_calls: usize

Maximum number of times the same tool invocation can be retried with the identical arguments within a single turn.

max_consecutive_blocked_tool_calls_per_turn: usize

Maximum consecutive blocked tool calls allowed per turn before forcing a turn break. The total fuse is 2x this value in normal mode, 4x in Plan Mode, and this value in recovery mode, unless overridden by max_total_blocked_tool_calls_per_turn.

max_total_blocked_tool_calls_per_turn: Option<usize>

Optional explicit cap for total blocked tool calls per turn. When unset, the runtime derives it from the consecutive cap (2x normal, 4x plan, 1x recovery) so existing configs keep their behavior.

blocked_tool_thresholds: IndexMap<String, usize>

Per-tool consecutive blocked-call cap overrides keyed by tool name. Allows read-only tools (e.g. code_search) to tolerate more denies than mutating tools (e.g. exec_command) before tripping the fuse.

max_tool_rate_per_second: Option<usize>

Optional per-second rate limit for tool calls to smooth bursty retries. When unset, the runtime defaults apply.

max_sequential_spool_chunk_reads: usize

Maximum sequential spool-chunk read_file calls allowed per turn before nudging the agent to switch to targeted extraction/summarization.

web_fetch: WebFetchConfig

Web Fetch tool security configuration

web_search: WebSearchConfig

Web Search tool configuration (provider selection, result caps, timeouts).

plugins: PluginRuntimeConfig

Dynamic plugin runtime configuration

editor: EditorToolConfig

External editor integration settings used by /edit and keyboard shortcuts

loop_thresholds: IndexMap<String, usize>

Tool-specific loop thresholds (Adaptive Loop Detection) Allows setting higher loop limits for read-only tools (e.g., ls, grep) and lower limits for mutating tools.

client_tool_search: bool

Enables client-local deferred tool loading for providers without a hosted tool search (e.g. Gemini). When enabled, tools flagged defer_loading: true are omitted from the request payload instead of being sent eagerly, and a compact summary of what is discoverable is appended to the system prompt; the model loads them via the local MCP discovery tools. Enabled by default because eager MCP schemas are the dominant source of token inflation.

Implementations

impl ToolsConfig

pub fn tool_call_delay(&self) -> Option<Duration>

Trait Implementations

impl Clone for ToolsConfig

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 ToolsConfig

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

Formats the value using the given formatter.

impl Default for ToolsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ToolsConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ToolsConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ToolsConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.