Struct SystemCommandsCapability 

pub struct SystemCommandsCapability;

Built-in system commands capability.

Provides session-control commands that execute directly without involving the LLM. These appear in the UI command palette. Commands are added as their handlers are implemented.

Trait Implementations

impl Capability for SystemCommandsCapability

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 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 native_async_tools( &self, _config: &Value, ) -> Option<BTreeMap<String, Option<Value>>>

Explicit native asynchronous tool selection. Providers without support retain the ordinary synchronous definitions and scheduler.

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 metadata(&self) -> Option<Value>

Host-owned annotations that core does not interpret.

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 knowledge/execution/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_contribution<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 SystemPromptContext, ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: '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 delegation_target_with_config( &self, _config: &Value, ) -> Option<DelegationTargetProvider>

Returns a provider for one target of the neutral spawn_agent router.

fn auto_activates_for(&self, _tool_definitions: &[ToolDefinition]) -> bool

Whether this capability should be activated from the tools collected so far. This generic hook supports cross-cutting adapters without teaching core their IDs or deployment ownership.

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 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Returns system prompt contribution adapted to per-capability config.

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

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

User-visible conversation context contributed by this capability.

fn conversation_context_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 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Called during capability collection. Capabilities whose conversation context depends on config override this method.

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) -> BTreeMap<String, ScopedMcpServer>

Returns remote MCP servers contributed by this capability.

fn mcp_servers_with_config( &self, _config: &Value, ) -> BTreeMap<String, ScopedMcpServer>

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 message_filter_config( &self, config: &Value, _compaction_enabled: bool, ) -> Value

Derive the config passed to this capability’s message filter.

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 llm_error_hook(&self) -> Option<Arc<dyn LlmErrorHook>>

Returns an in-process hook invoked when a turn fails with a terminal LLM error (one that will not be retried), before the user-facing error message is emitted. The hook may perform a side effect (e.g. schedule a continuation) and/or return extra fields to augment the user-facing error copy. This is the platform seam for capability-owned error recovery — the same in-process hook family as Self::tool_call_hooks and Self::message_filter_provider; the reason atom invokes it generically and knows nothing about any specific capability’s behavior. See crate::llm_error_hook.

fn tool_search_config(&self, _config: &Value) -> Option<ToolSearchConfig>

Provider-facing deferred tool-loading configuration contributed by this capability. The execution engine consumes this generically and does not match on implementation-owned capability IDs.

fn prompt_cache_config(&self, _config: &Value) -> Option<PromptCacheConfig>

Provider-facing prompt-cache configuration contributed by this capability.

fn driver_options(&self, _config: &Value) -> Vec<(String, Value)>

Driver-namespaced opaque per-call options ("<driver-id>/<option>") requested by this capability. Each entry’s shape is owned by the driver crate named in the key; core transports the values untouched.

fn parallel_tool_calls_preference(&self, _config: &Value) -> Option<bool>

Request-level parallel tool-call preference contributed by this capability. None leaves the runtime/provider default unchanged.

fn error_disclosure(&self, _config: &Value) -> Option<ErrorDisclosure>

User-facing terminal-error disclosure selected by this capability.

fn filter_response_text(&self, text: String, _config: &Value) -> String

Filter assistant text before it is persisted or returned. This is a deterministic, config-aware seam for capability-owned annotations.

fn compaction_policy( &self, _config: &Value, ) -> Option<Arc<dyn CompactionPolicy>>

Context-compaction policy configured by this capability. The reason atom owns orchestration and invokes the returned implementation without matching on a capability ID.

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 finalized_tool_calls_hook( &self, _config: &Value, ) -> Option<Arc<dyn FinalizedToolCallsHook>>

Returns a configured hook over the finalized model tool-call batch. This later seam is suitable for policy that needs all calls plus their final schemas before the assistant message is persisted.

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, AgentLoopError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: '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).

fn post_output_annotation_hooks_with_config( &self, _config: &Value, ) -> Vec<Arc<dyn PostGenerationAnnotationHook>>

Returns end-of-message citation annotation hooks contributed by this capability, adapted to per-agent config.

fn citation_verifier_with_config( &self, _config: &Value, ) -> Option<Arc<dyn CitationVerifier>>

Returns a citation verifier contributed by this capability, if any.