Struct CommandContext 

pub struct CommandContext<'a> { /* private fields */ }

Context provided to commands during execution.

Provides controlled access to app functionality through methods rather than exposing internal state directly.

Extension Data

Agents can provide custom extension data that commands can access:

// In agent setup:
agent.set_command_extension(MyContext { api_key: "..." });

// In command execution:
fn execute(&self, args: &str, ctx: &mut CommandContext) -> CommandResult {
    let my_ctx = ctx.extension::<MyContext>().expect("MyContext required");
    // use my_ctx.api_key
}

Implementations

impl<'a> CommandContext<'a>

pub fn session_id(&self) -> i64

Get the current session ID.

pub fn agent_name(&self) -> &str

Get the agent name.

pub fn version(&self) -> &str

Get the agent version.

pub fn commands(&self) -> &[Box<dyn SlashCommand>]

Get all registered commands (useful for /help).

pub fn show_message(&mut self, msg: impl Into<String>)

Display a system message in the conversation.

pub fn clear_conversation(&mut self)

Request to clear the conversation.

This is deferred until after the command returns.

pub fn compact_conversation(&mut self)

Request to compact the conversation history.

This is deferred until after the command returns.

pub fn open_theme_picker(&mut self)

Request to open the theme picker.

This is deferred until after the command returns.

pub fn open_session_picker(&mut self)

Request to open the session picker.

This is deferred until after the command returns.

pub fn request_quit(&mut self)

Request to quit the application.

This is deferred until after the command returns.

pub fn create_new_session(&mut self)

Request to create a new session.

This is deferred until after the command returns.

pub fn send_to_controller(&self, cmd: ControlCmd)

Send a control command to the controller.

This allows commands to interact with the LLM controller, for example to create a new session.

pub fn extension<T: 'static>(&self) -> Option<&T>

Get agent-specific extension data.

Returns None if no extension was provided or if the type doesn’t match.

Example

struct MyContext { api_key: String }

fn execute(&self, args: &str, ctx: &mut CommandContext) -> CommandResult {
    if let Some(my_ctx) = ctx.extension::<MyContext>() {
        // Use my_ctx.api_key
    }
}