Struct AttachSkillCapability 

pub struct AttachSkillCapability { /* private fields */ }

Attach Skill Virtual Capability.

Mounts a database-registered skill into /.agents/skills/{name}/ in the session VFS. The built-in SkillsCapability then discovers and serves it through its list_skills / activate_skill tools.

This capability does NOT contribute to the system prompt or provide tools.

Implementations

impl AttachSkillCapability

pub fn from_registry( skill_id: Uuid, name: String, description: String, instructions: String, files: Vec<(String, String)>, ) -> Self

Create an attach capability for a registry-based skill.

Reconstructs a valid SKILL.md and prepares mount points so that SkillsCapability can discover the skill from the VFS.

pub fn from_registry_with_invocable( skill_id: Uuid, name: String, description: String, instructions: String, files: Vec<(String, String)>, user_invocable: bool, ) -> Self

pub fn from_registry_with_options( skill_id: Uuid, name: String, description: String, instructions: String, files: Vec<(String, String)>, user_invocable: bool, disable_model_invocation: bool, ) -> Self

pub fn skill_name(&self) -> &str

Get the skill name

pub fn user_invocable(&self) -> bool

Whether this skill is user-invocable as a /slash command

pub fn disable_model_invocation(&self) -> bool

Whether the model is prevented from auto-invoking this skill

Trait Implementations

impl Capability for AttachSkillCapability

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

Returns the icon name for UI rendering (optional)

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

Returns the category for grouping in UI (optional)

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 status(&self) -> CapabilityStatus

Returns the current status of this capability

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 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 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 Clone for AttachSkillCapability

fn clone(&self) -> AttachSkillCapability

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttachSkillCapability

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

Formats the value using the given formatter.