Struct ClaudeToolSearchCapability 

pub struct ClaudeToolSearchCapability { /* private fields */ }

Claude Tool Search capability.

Adding this capability to an agent/harness enables deferred tool loading for Claude models that support it. The threshold controls the minimum number of tools before tool_search activates (default: DEFAULT_TOOL_SEARCH_THRESHOLD).

Implementations

impl ClaudeToolSearchCapability

pub fn new() -> Self

pub fn with_threshold(threshold: usize) -> Self

pub fn tool_search_config(&self) -> ToolSearchConfig

Returns the ToolSearchConfig for this capability.

The config is provider-agnostic — the same shape openai_tool_search produces. The Anthropic driver renders it into the hosted Messages-API format; the OpenAI Responses driver renders it into the Responses format. Whichever driver handles the request decides the wire shape, so this carries no provider tag.

Trait Implementations

impl Capability for ClaudeToolSearchCapability

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 localizations(&self) -> Vec<CapabilityLocalization>

Returns localization overlays for this capability’s display strings.

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 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 aliases(&self) -> Vec<&'static str>

Returns legacy identifiers that resolve to this capability.

fn localized_name(&self, locale: Option<&str>) -> String

Display name resolved for locale; None or unknown locales fall back to name().

fn localized_description(&self, locale: Option<&str>) -> String

Description resolved for locale; falls back to description().

fn describe_schema(&self, locale: Option<&str>) -> Option<String>

One-line human-readable summary of what this capability’s config controls, resolved for locale. None when the capability exposes no per-agent config.

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

Returns the icon name for UI rendering (optional)

fn is_guardrail(&self) -> bool

Whether this capability is a guardrail — a constraint on agent behavior (content checks, tool restrictions) rather than a grant of new abilities. Structural marker for UI sections and catalog filtering; carries no runtime semantics. See specs/guardrails.md.

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 system_prompt_addition(&self) -> Option<&str>

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

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 facts(&self, _config: &Value, _ctx: &FactsContext) -> Vec<Fact>

Returns key/value Facts this capability contributes to the model.

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

Returns pre-tool execution hooks provided by this capability.

fn pre_tool_use_hooks_with_config( &self, _config: &Value, ) -> Vec<Arc<dyn PreToolUseHook>>

Returns pre-tool execution hooks adapted to per-capability config.

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

Returns post-tool execution hooks provided by this capability.

fn post_tool_exec_hooks_with_config( &self, _config: &Value, ) -> Vec<Arc<dyn PostToolExecHook>>

Returns post-tool execution hooks adapted to per-capability config.

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_definition_hooks_with_context( &self, _ctx: &SystemPromptContext, config: &Value, ) -> Vec<Arc<dyn ToolDefinitionHook>>

Returns tool definition hooks adapted to per-capability config and the collection context (session id, model, …).

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

Returns tool call hooks provided by this capability.

fn narrate( &self, _tool_def: Option<&ToolDefinition>, tool_call: &ToolCall, phase: ToolNarrationPhase, locale: Option<&str>, ctx: ToolNarrationContext<'_>, ) -> Option<String>

Contribute human-readable narration for one of this capability’s tool calls (e.g. “Read AGENTS.md”, “Searched tools: router”).

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.

fn post_output_guardrails_with_config( &self, _config: &Value, ) -> Vec<Arc<dyn PostGenerationOutputGuardrail>>

Async, end-of-message output guardrails (EVE-573).

impl Default for ClaudeToolSearchCapability

fn default() -> Self

Returns the “default value” for a type.