use codex_core::protocol::TokenUsage; use crossterm::event::KeyEvent; use ratatui::buffer::Buffer; use ratatui::layout::Alignment; use ratatui::layout::Rect; use ratatui::style::Style; use ratatui::style::Stylize; use ratatui::text::Line; use ratatui::widgets::BorderType; use ratatui::widgets::Borders; use ratatui::widgets::Widget; use ratatui::widgets::WidgetRef; use tui_textarea::Input; use tui_textarea::Key; use tui_textarea::TextArea; use super::chat_composer_history::ChatComposerHistory; use super::command_popup::CommandPopup; use crate::app_event::AppEvent; use crate::app_event_sender::AppEventSender; /// Minimum number of visible text rows inside the textarea. const MIN_TEXTAREA_ROWS: usize = 1; /// Rows consumed by the border. const BORDER_LINES: u16 = 2; const BASE_PLACEHOLDER_TEXT: &str = "send a message"; /// Result returned when the user interacts with the text area. pub enum InputResult { Submitted(String), None, } pub(crate) struct ChatComposer<'a> { textarea: TextArea<'a>, command_popup: Option, app_event_tx: AppEventSender, history: ChatComposerHistory, ctrl_c_quit_hint: bool, } impl ChatComposer<'_> { pub fn new(has_input_focus: bool, app_event_tx: AppEventSender) -> Self { let mut textarea = TextArea::default(); textarea.set_placeholder_text(BASE_PLACEHOLDER_TEXT); textarea.set_cursor_line_style(ratatui::style::Style::default()); let mut this = Self { textarea, command_popup: None, app_event_tx, history: ChatComposerHistory::new(), ctrl_c_quit_hint: false, }; this.update_border(has_input_focus); this } /// Update the cached *context-left* percentage and refresh the placeholder /// text. The UI relies on the placeholder to convey the remaining /// context when the composer is empty. pub(crate) fn set_token_usage( &mut self, token_usage: TokenUsage, model_context_window: Option, ) { let placeholder = match (token_usage.total_tokens, model_context_window) { (total_tokens, Some(context_window)) => { let percent_remaining: u8 = if context_window > 0 { // Calculate the percentage of context left. let percent = 100.0 - (total_tokens as f32 / context_window as f32 * 100.0); percent.clamp(0.0, 100.0) as u8 } else { // If we don't have a context window, we cannot compute the // percentage. 100 }; if percent_remaining > 25 { format!("{BASE_PLACEHOLDER_TEXT} — {percent_remaining}% context left") } else { format!( "{BASE_PLACEHOLDER_TEXT} — {percent_remaining}% context left (consider /compact)" ) } } (total_tokens, None) => { format!("{BASE_PLACEHOLDER_TEXT} — {total_tokens} tokens used") } }; self.textarea.set_placeholder_text(placeholder); } /// Record the history metadata advertised by `SessionConfiguredEvent` so /// that the composer can navigate cross-session history. pub(crate) fn set_history_metadata(&mut self, log_id: u64, entry_count: usize) { self.history.set_metadata(log_id, entry_count); } /// Integrate an asynchronous response to an on-demand history lookup. If /// the entry is present and the offset matches the current cursor we /// immediately populate the textarea. pub(crate) fn on_history_entry_response( &mut self, log_id: u64, offset: usize, entry: Option, ) -> bool { self.history .on_entry_response(log_id, offset, entry, &mut self.textarea) } pub fn set_input_focus(&mut self, has_focus: bool) { self.update_border(has_focus); } pub fn set_ctrl_c_quit_hint(&mut self, show: bool, has_focus: bool) { self.ctrl_c_quit_hint = show; self.update_border(has_focus); } /// Handle a key event coming from the main UI. pub fn handle_key_event(&mut self, key_event: KeyEvent) -> (InputResult, bool) { let result = match self.command_popup { Some(_) => self.handle_key_event_with_popup(key_event), None => self.handle_key_event_without_popup(key_event), }; // Update (or hide/show) popup after processing the key. self.sync_command_popup(); result } /// Handle key event when the slash-command popup is visible. fn handle_key_event_with_popup(&mut self, key_event: KeyEvent) -> (InputResult, bool) { let Some(popup) = self.command_popup.as_mut() else { tracing::error!("handle_key_event_with_popup called without an active popup"); return (InputResult::None, false); }; match key_event.into() { Input { key: Key::Up, .. } => { popup.move_up(); (InputResult::None, true) } Input { key: Key::Down, .. } => { popup.move_down(); (InputResult::None, true) } Input { key: Key::Tab, .. } => { if let Some(cmd) = popup.selected_command() { let first_line = self .textarea .lines() .first() .map(|s| s.as_str()) .unwrap_or(""); let starts_with_cmd = first_line .trim_start() .starts_with(&format!("/{}", cmd.command())); if !starts_with_cmd { self.textarea.select_all(); self.textarea.cut(); let _ = self.textarea.insert_str(format!("/{} ", cmd.command())); } } (InputResult::None, true) } Input { key: Key::Enter, shift: false, alt: false, ctrl: false, } => { if let Some(cmd) = popup.selected_command() { // Send command to the app layer. self.app_event_tx.send(AppEvent::DispatchCommand(*cmd)); // Clear textarea so no residual text remains. self.textarea.select_all(); self.textarea.cut(); // Hide popup since the command has been dispatched. self.command_popup = None; return (InputResult::None, true); } // Fallback to default newline handling if no command selected. self.handle_key_event_without_popup(key_event) } input => self.handle_input_basic(input), } } /// Handle key event when no popup is visible. fn handle_key_event_without_popup(&mut self, key_event: KeyEvent) -> (InputResult, bool) { let input: Input = key_event.into(); match input { // ------------------------------------------------------------- // History navigation (Up / Down) – only when the composer is not // empty or when the cursor is at the correct position, to avoid // interfering with normal cursor movement. // ------------------------------------------------------------- Input { key: Key::Up, .. } => { if self.history.should_handle_navigation(&self.textarea) { let consumed = self .history .navigate_up(&mut self.textarea, &self.app_event_tx); if consumed { return (InputResult::None, true); } } self.handle_input_basic(input) } Input { key: Key::Down, .. } => { if self.history.should_handle_navigation(&self.textarea) { let consumed = self .history .navigate_down(&mut self.textarea, &self.app_event_tx); if consumed { return (InputResult::None, true); } } self.handle_input_basic(input) } Input { key: Key::Enter, shift: false, alt: false, ctrl: false, } => { let text = self.textarea.lines().join("\n"); self.textarea.select_all(); self.textarea.cut(); if text.is_empty() { (InputResult::None, true) } else { self.history.record_local_submission(&text); (InputResult::Submitted(text), true) } } Input { key: Key::Enter, .. } | Input { key: Key::Char('j'), ctrl: true, alt: false, shift: false, } => { self.textarea.insert_newline(); (InputResult::None, true) } input => self.handle_input_basic(input), } } /// Handle generic Input events that modify the textarea content. fn handle_input_basic(&mut self, input: Input) -> (InputResult, bool) { self.textarea.input(input); (InputResult::None, true) } /// Synchronize `self.command_popup` with the current text in the /// textarea. This must be called after every modification that can change /// the text so the popup is shown/updated/hidden as appropriate. fn sync_command_popup(&mut self) { // Inspect only the first line to decide whether to show the popup. In // the common case (no leading slash) we avoid copying the entire // textarea contents. let first_line = self .textarea .lines() .first() .map(|s| s.as_str()) .unwrap_or(""); if first_line.starts_with('/') { // Create popup lazily when the user starts a slash command. let popup = self.command_popup.get_or_insert_with(CommandPopup::new); // Forward *only* the first line since `CommandPopup` only needs // the command token. popup.on_composer_text_change(first_line.to_string()); } else if self.command_popup.is_some() { // Remove popup when '/' is no longer the first character. self.command_popup = None; } } pub fn calculate_required_height(&self, area: &Rect) -> u16 { let rows = self.textarea.lines().len().max(MIN_TEXTAREA_ROWS); let num_popup_rows = if let Some(popup) = &self.command_popup { popup.calculate_required_height(area) } else { 0 }; rows as u16 + BORDER_LINES + num_popup_rows } fn update_border(&mut self, has_focus: bool) { struct BlockState { right_title: Line<'static>, border_style: Style, } let bs = if has_focus { if self.ctrl_c_quit_hint { BlockState { right_title: Line::from("Ctrl+C to quit").alignment(Alignment::Right), border_style: Style::default(), } } else { BlockState { right_title: Line::from("Enter to send | Ctrl+D to quit | Ctrl+J for newline") .alignment(Alignment::Right), border_style: Style::default(), } } } else { BlockState { right_title: Line::from(""), border_style: Style::default().dim(), } }; self.textarea.set_block( ratatui::widgets::Block::default() .title_bottom(bs.right_title) .borders(Borders::ALL) .border_type(BorderType::Rounded) .border_style(bs.border_style), ); } pub(crate) fn is_command_popup_visible(&self) -> bool { self.command_popup.is_some() } } impl WidgetRef for &ChatComposer<'_> { fn render_ref(&self, area: Rect, buf: &mut Buffer) { if let Some(popup) = &self.command_popup { let popup_height = popup.calculate_required_height(&area); // Split the provided rect so that the popup is rendered at the // *top* and the textarea occupies the remaining space below. let popup_rect = Rect { x: area.x, y: area.y, width: area.width, height: popup_height.min(area.height), }; let textarea_rect = Rect { x: area.x, y: area.y + popup_rect.height, width: area.width, height: area.height.saturating_sub(popup_rect.height), }; popup.render(popup_rect, buf); self.textarea.render(textarea_rect, buf); } else { self.textarea.render(area, buf); } } }