Struct ToolsConfig 

pub struct ToolsConfig {
    pub builtin: Vec<String>,
    pub dynamic: Vec<DynamicToolFactory>,
    pub mcp: Vec<McpToolConfig>,
    pub external: Option<Vec<String>>,
    pub delivery_mode: ToolDeliveryMode,
    pub deferred_threshold: Option<usize>,
    pub always_full_schema: Vec<String>,
}

Fields

builtin: Vec<String>

Built-in tools to include (e.g., [“final”, “transfer_to_agent”])

dynamic: Vec<DynamicToolFactory>

Dynamic tool factories — each creates a named tool at runtime.

mcp: Vec<McpToolConfig>

MCP server tool configurations

external: Option<Vec<String>>

External tools to include from client

delivery_mode: ToolDeliveryMode

How tools are delivered to the model. Defaults to Full. When set to Deferred, only core tools get full schemas; others appear as name+description and must be fetched via tool_search.

deferred_threshold: Option<usize>

Tool count threshold for automatic deferral. When delivery_mode is Deferred and total tools exceed this, non-core tools are deferred. Default: 15.

always_full_schema: Vec<String>

Additional tool names to always include with full schemas (beyond CORE_TOOLS). Useful for agent-specific tools that should never be deferred.

Implementations

impl ToolsConfig

pub fn invalid_builtin_tools(&self) -> Vec<String>

Validate that all builtin tool names are recognized. Returns a list of invalid tool names, or empty if all are valid.

pub fn is_core_tool(&self, name: &str) -> bool

Whether a tool should always get a full schema (never deferred).

pub fn effective_threshold(&self) -> usize

Effective threshold for automatic tool deferral.

pub fn effective_delivery_mode(&self, _total_tools: usize) -> ToolDeliveryMode

Determine the effective delivery mode given the total tool count. If mode is Full but tool count exceeds threshold, stays Full Deferred always stays Deferred — context efficiency is the default.

impl ToolsConfig

pub fn builtin_only(tools: Vec<&str>) -> Self

Create a simple configuration with just built-in tools

pub fn mcp_all(server: &str) -> Self

Create a configuration that includes all tools from an MCP server

pub fn mcp_filtered( server: &str, include: Vec<&str>, exclude: Vec<&str>, ) -> Self

Create a configuration with specific MCP tool patterns

Trait Implementations

impl Clone for ToolsConfig

fn clone(&self) -> ToolsConfig

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() -> ToolsConfig

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.