Struct CommandContext 

pub struct CommandContext<'a> {
    pub sink: &'a mut dyn ChannelSink,
    pub debug: &'a mut dyn DebugAccess,
    pub messages: &'a mut dyn MessageAccess,
    pub session: &'a dyn SessionAccess,
    pub agent: &'a mut dyn AgentAccess,
}

Typed access to agent subsystems for slash command handlers.

Each field is a trait object providing access to one subsystem group. Constructed by zeph-core at dispatch time from Agent<C> fields. Handlers receive &mut CommandContext and access only the fields they need.

Lifetimes

The lifetime 'a ties all references to the dispatch scope. A CommandContext must not outlive the &mut Agent<C> it was constructed from.

Fields

sink: &'a mut dyn ChannelSink

I/O channel for sending responses to the user.

debug: &'a mut dyn DebugAccess

Debug/diagnostics state: dump, format, logging config.

messages: &'a mut dyn MessageAccess

Conversation message history and queue operations.

session: &'a dyn SessionAccess

Session and channel properties (e.g., supports_exit).

agent: &'a mut dyn AgentAccess

Broad access to agent subsystems for commands that need multiple agent fields.

Trait Implementations

impl CommandHandler<CommandContext<'_>> for AgentCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for CacheStatsCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ClearCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ClearQueueCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for CompactCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for DebugDumpCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for DumpFormatCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ExitCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ExperimentCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

impl CommandHandler<CommandContext<'_>> for FeedbackCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for FocusCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

impl CommandHandler<CommandContext<'_>> for GraphCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for GuardrailCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

impl CommandHandler<CommandContext<'_>> for GuidelinesCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

impl CommandHandler<CommandContext<'_>> for HelpCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, _ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ImageCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for LogCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for LspCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

impl CommandHandler<CommandContext<'_>> for McpCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for MemoryCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ModelCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for NewConversationCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for PlanCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for PolicyCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

impl CommandHandler<CommandContext<'_>> for ProviderCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for QuitCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for RecapCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for ResetCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for SchedulerCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

impl CommandHandler<CommandContext<'_>> for SideQuestCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

impl CommandHandler<CommandContext<'_>> for SkillCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for SkillsCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.

impl CommandHandler<CommandContext<'_>> for StatusCommand

fn name(&self) -> &'static str

Command name including the leading slash, e.g. "/help".

fn description(&self) -> &'static str

One-line description shown in /help output.

fn category(&self) -> SlashCategory

Category for grouping in /help.

fn handle<'a>( &'a self, ctx: &'a mut CommandContext<'_>, _args: &'a str, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput, CommandError>> + Send + 'a>>

Execute the command.

fn args_hint(&self) -> &'static str

Argument hint shown after the command name in help, e.g. "[path]".

fn feature_gate(&self) -> Option<&'static str>

Feature gate label, if this command is conditionally compiled.