Struct App 

pub struct App {
    pub should_quit: bool,
    pub waiting_for_response: bool,
    pub widgets: HashMap<&'static str, Box<dyn Widget>>,
    pub widget_priority_order: Vec<&'static str>,
    pub filtered_commands: Vec<&'static SlashCommand>,
    /* private fields */
}

Fields

should_quit: bool

waiting_for_response: bool

Whether we’re waiting for a response (set immediately on submit, before streaming starts)

widgets: HashMap<&'static str, Box<dyn Widget>>

Registered widgets (keyed by ID)

widget_priority_order: Vec<&'static str>

Cached sorted priority order for key event handling

filtered_commands: Vec<&'static SlashCommand>

Filtered slash commands for the popup (used by SlashPopup widget)

Implementations

impl App

pub fn new() -> Self

pub fn with_config(config: AppConfig) -> Self

pub fn register_widget<W: Widget>(&mut self, widget: W)

Register a widget with the app

The widget will be stored and used for key handling and rendering. Widgets are identified by their ID and stored in a priority order.

pub fn rebuild_priority_order(&mut self)

Rebuild the priority order cache after widget registration

pub fn widget<W: Widget + 'static>(&self, id: &str) -> Option<&W>

Get a widget by ID

pub fn widget_mut<W: Widget + 'static>(&mut self, id: &str) -> Option<&mut W>

Get a widget by ID (mutable)

pub fn has_widget(&self, id: &str) -> bool

Check if a widget is registered

pub fn agent_name(&self) -> &str

Get the agent name

pub fn version(&self) -> &str

Get the agent version

pub fn set_to_controller(&mut self, tx: ToControllerTx)

Set the channel for sending messages to the controller

pub fn set_from_controller(&mut self, rx: FromControllerRx)

Set the channel for receiving messages from the controller

pub fn set_controller(&mut self, controller: Arc<LLMController>)

Set the controller reference for session management

pub fn set_llm_registry(&mut self, registry: LLMRegistry)

Set the LLM provider registry

pub fn set_runtime_handle(&mut self, handle: Handle)

Set the tokio runtime handle

pub fn set_user_interaction_registry( &mut self, registry: Arc<UserInteractionRegistry>, )

Set the user interaction registry

pub fn set_permission_registry(&mut self, registry: Arc<PermissionRegistry>)

Set the permission registry

pub fn set_session_id(&mut self, id: i64)

Set the session ID

pub fn set_model_name(&mut self, name: impl Into<String>)

Set the model name

pub fn set_context_limit(&mut self, limit: i32)

Set the context limit

pub fn set_layout(&mut self, template: LayoutTemplate)

Set the layout template

pub fn set_key_handler<H: KeyHandler>(&mut self, handler: H)

Set a custom key handler.

This allows full control over key handling behavior. For simpler customization, use [set_key_bindings] instead.

pub fn set_key_handler_boxed(&mut self, handler: Box<dyn KeyHandler>)

Set a boxed key handler directly.

This is useful when you have a Box<dyn KeyHandler> already.

pub fn set_key_bindings(&mut self, bindings: KeyBindings)

Set custom key bindings using the default handler.

This is a simpler alternative to [set_key_handler] when you only need to change which keys trigger which actions.

pub fn set_exit_handler<H: ExitHandler>(&mut self, handler: H)

Set an exit handler for cleanup before quitting.

The exit handler’s on_exit() method is called when the user confirms exit. If it returns false, the exit is cancelled.

pub fn set_exit_handler_boxed(&mut self, handler: Box<dyn ExitHandler>)

Set a boxed exit handler directly.

pub fn submit_message(&mut self)

pub fn interrupt_request(&mut self)

Interrupt the current LLM request

pub fn switch_session(&mut self, session_id: i64)

Switch to a different session by ID

pub fn add_session(&mut self, info: SessionInfo)

Add a session to the sessions list

pub fn scroll_up(&mut self)

pub fn scroll_down(&mut self)

pub fn run(&mut self) -> Result<()>

Trait Implementations

impl Default for App

fn default() -> Self

Returns the “default value” for a type.