Struct AutoToolSearchCapability 

pub struct AutoToolSearchCapability { /* private fields */ }

Auto Tool Search capability.

Holds the two real tool-search capabilities and dispatches to one of them based on the agent’s model. threshold (minimum number of tools before deferral activates) is shared by both and forwarded at construction.

Implementations

impl AutoToolSearchCapability

pub fn new() -> Self

pub fn with_threshold(threshold: usize) -> Self

Trait Implementations

impl Capability for AutoToolSearchCapability

fn id(&self) -> &str

Returns the unique capability identifier as a string

fn name(&self) -> &str

Returns the display name

fn description(&self) -> &str

Returns a description of what this capability provides

fn status(&self) -> CapabilityStatus

Returns the current status of this capability

fn category(&self) -> Option<&str>

Returns the category for grouping in UI (optional)

fn resolve_for_model(&self, model: Option<&str>) -> Option<&dyn Capability>

Model-adaptive dispatch: delegate this capability’s contributions to a different underlying capability based on the agent’s model.

fn icon(&self) -> Option<&str>

Returns the icon name for UI rendering (optional)

fn system_prompt_addition(&self) -> Option<&str>

Returns static text to prepend to the agent’s system prompt (optional).

fn system_prompt_contribution<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 SystemPromptContext, ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the system prompt contribution for this capability, with access to session context (filesystem, etc.).

fn system_prompt_preview(&self) -> Option<String>

Returns a preview of the system prompt addition for UI display.

fn tools(&self) -> Vec<Box<dyn Tool>>

Returns tool implementations provided by this capability

fn tools_with_config(&self, _config: &Value) -> Vec<Box<dyn Tool>>

Returns tool implementations configured by per-capability config.

fn system_prompt_contribution_with_config<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 SystemPromptContext, _config: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Returns system prompt contribution adapted to per-capability config.

fn tool_definitions(&self) -> Vec<ToolDefinition>

Returns tool definitions for the agent config By default, converts tools() to definitions

fn mounts(&self) -> Vec<MountPoint>

Returns mount points to populate in the session filesystem

fn dependencies(&self) -> Vec<&'static str>

Returns capability IDs that this capability depends on.

fn features(&self) -> Vec<&'static str>

Returns UI feature strings that this capability contributes to.

fn config_schema(&self) -> Option<Value>

Returns the JSON Schema for this capability’s per-agent config.

fn config_ui_schema(&self) -> Option<Value>

Returns UI hints for rendering config_schema.

fn validate_config(&self, _config: &Value) -> Result<(), String>

Validates per-capability config before it is persisted.

fn mcp_servers(&self) -> ScopedMcpServers

Returns remote MCP servers contributed by this capability.

fn mcp_servers_with_config(&self, _config: &Value) -> ScopedMcpServers

Returns config-aware remote MCP server contributions.

fn message_filter_provider(&self) -> Option<Arc<dyn MessageFilterProvider>>

Returns a message filter provider if this capability modifies message retrieval.

fn model_view_provider(&self) -> Option<Arc<dyn ModelViewProvider>>

Returns a provider that can build a prompt-facing model view from lossless stored messages before provider serialization.

fn pre_tool_use_hooks(&self) -> Vec<Arc<dyn PreToolUseHook>>

Returns pre-tool execution hooks provided by this capability.

fn post_tool_exec_hooks(&self) -> Vec<Arc<dyn PostToolExecHook>>

Returns post-tool execution hooks provided by this capability.

fn tool_definition_hooks(&self) -> Vec<Arc<dyn ToolDefinitionHook>>

Returns tool definition hooks provided by this capability.

fn tool_definition_hooks_with_config( &self, _config: &Value, ) -> Vec<Arc<dyn ToolDefinitionHook>>

Returns tool definition hooks adapted to per-capability config.

fn tool_call_hooks(&self) -> Vec<Arc<dyn ToolCallHook>>

Returns tool call hooks provided by this capability.

fn user_hooks(&self) -> Vec<UserHookSpec>

Returns user-defined hook specifications contributed by this capability.

fn user_hooks_with_config(&self, _config: &Value) -> Vec<UserHookSpec>

Returns user-defined hook specifications adapted to per-capability config.

fn risk_level(&self) -> RiskLevel

Returns the risk level of this capability.

fn commands(&self) -> Vec<CommandDescriptor>

Returns system commands this capability provides.

fn execute_command<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, request: &'life1 ExecuteCommandRequest, _ctx: &'life2 CommandExecutionContext, ) -> Pin<Box<dyn Future<Output = Result<CommandResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Execute a system command declared by Self::commands.

fn agent_blueprints(&self) -> Vec<AgentBlueprint>

Returns agent blueprints contributed by this capability.

fn contribute_skills(&self) -> Vec<SkillContribution>

Returns skills contributed by this capability in code.

fn output_guardrails(&self) -> Vec<Arc<dyn OutputGuardrail>>

Returns streaming output guardrails contributed by this capability.

impl Default for AutoToolSearchCapability

fn default() -> Self

Returns the “default value” for a type.