Struct ToolFilterGroup 

pub struct ToolFilterGroup {
    pub mode: ToolFilterGroupMode,
    pub tools: Vec<String>,
    pub keywords: Vec<String>,
}

A named group of MCP tool patterns with an activation mode.

Each group lists glob patterns for MCP tool names and an optional set of keywords that trigger inclusion in dynamic mode. MCP tools are named <server>__<tool> (double-underscore separator, e.g. filesystem__read_file).

Classification is by origin, not name shape: only tools that actually came from the MCP registry are subject to these groups. Built-in tools AND skill tools — which share the <x>__<y> naming convention ({skill}__{tool}) — always pass through and are never affected by tool_filter_groups.

Under [mcp] deferred_loading = true, mode = "always" entries are pre-activated at assembly time so matching tools are live from the first turn without a tool_search round-trip.

Example

[[runtime_profiles.default.tool_filter_groups]]
mode = "always"
tools = ["filesystem__*"]
keywords = []

[[runtime_profiles.default.tool_filter_groups]]
mode = "dynamic"
tools = ["browser__*"]
keywords = ["browse", "website", "url", "search"]

Fields

mode: ToolFilterGroupMode

Activation mode: "always" or "dynamic".

tools: Vec<String>

Glob patterns matching MCP tool names (single * wildcard supported).

keywords: Vec<String>

Keywords that activate this group in dynamic mode (case-insensitive substring). Ignored when mode = "always".

Trait Implementations

impl Clone for ToolFilterGroup

fn clone(&self) -> ToolFilterGroup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolFilterGroup

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolFilterGroup

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolFilterGroup, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ToolFilterGroup

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 ToolFilterGroup

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

where __S: Serializer,

Serialize this value into the given Serde serializer.