Files
codex/codex-rs/tui/src/app_backtrack/browsing.rs
T
Eric Traut 551844b3ef Add compact transcript browsing and prompt navigation to the TUI (#46739)
## What changed

- Make double `Esc` enter compact prompt browsing in the owned transcript view and inline overlay. Use left/right arrows to select prompts, up/down arrows to scroll, `Ctrl+T` to toggle details, and `Enter` to rewind and edit. `Esc` cancels browsing and restores the original reading position and presentation.
- Add a responsive browsing footer, a pinned prompt header for answer context, and contextual composer tips that respect `show_tooltips` and configured shortcuts.
- Load older history as prompt navigation needs it, preserve the selected prompt across pagination, and resolve rewind requests by cell identity. Reject remote prompt restoration when it contains local image paths or command syntax.
- Bound initial owned-transcript history loading to a budget of three screenfuls plus an item scan limit, independently of terminal scrollback settings.

## Testing

Add regression tests and snapshots for browsing, rewind, cancellation after resize and pagination, custom key bindings, search and selection precedence, offline input, prompt headers, composer tips, and history hydration.

GitOrigin-RevId: 1d9ef7b627f47c3def43e7aee7148b5909f6d357
2026-09-20 00:34:38 +00:00

97 lines
3.7 KiB
Rust

//! Browsing lifecycle: retain the origin, load earlier prompts, and cancel without rewinding.
use super::*;
use crate::transcript_view::TranscriptBookmark;
pub(super) enum BrowsingOrigin {
Owned(TranscriptBookmark),
Overlay(TranscriptBookmark),
Inline,
}
impl App {
/// A page can start inside an answer, leaving its oldest prompt far from the viewport edge.
pub(crate) fn browsing_needs_history(&self) -> bool {
self.backtrack.overlay_preview_active
&& matches!(self.backtrack.nth_user_message, 0 | usize::MAX)
&& match &self.overlay {
Some(Overlay::Transcript(overlay)) => !overlay.has_active_interaction(),
_ => !self.transcript_view.has_active_interaction(),
}
}
pub(crate) fn cancel_primed_browsing_for_event(&mut self, event: &TuiEvent) {
let interrupts_escape_pair = match event {
TuiEvent::Key(key) => key.code != KeyCode::Esc && key.kind != KeyEventKind::Release,
TuiEvent::Mouse(mouse) => mouse.kind != crossterm::event::MouseEventKind::Moved,
TuiEvent::Paste(text) => !text.is_empty(),
TuiEvent::Draw
| TuiEvent::Resume
| TuiEvent::Resize(_)
| TuiEvent::FocusGained
| TuiEvent::FocusLost => false,
};
if self.backtrack.primed
&& !self.backtrack.overlay_preview_active
&& self.backtrack.nth_user_message == usize::MAX
&& interrupts_escape_pair
{
self.reset_backtrack_state();
}
}
pub(super) fn remember_browsing_origin(&mut self, tui: &tui::Tui) {
if self.backtrack.origin.is_some() {
return;
}
self.backtrack.origin = Some(match &mut self.overlay {
Some(Overlay::Transcript(overlay)) => BrowsingOrigin::Overlay(overlay.bookmark()),
_ if tui.is_owned_screen() => {
BrowsingOrigin::Owned(self.transcript_view.bookmark(&self.transcript_cells))
}
_ => BrowsingOrigin::Inline,
});
}
pub(crate) fn cancel_transcript_browsing(&mut self, tui: &mut tui::Tui) {
let origin = self.backtrack.origin.take();
self.reset_backtrack_state();
match origin {
Some(BrowsingOrigin::Owned(bookmark)) => {
self.transcript_view.restore_bookmark(bookmark);
}
Some(BrowsingOrigin::Overlay(bookmark)) => {
if let Some(Overlay::Transcript(overlay)) = &mut self.overlay {
overlay.restore_bookmark(bookmark);
}
}
Some(BrowsingOrigin::Inline) => self.close_transcript_overlay(tui),
None => {}
}
tui.frame_requester().schedule_frame();
}
pub(super) fn set_browsing_details(&mut self, detailed: bool) {
let mode = self.chat_widget.history_render_mode();
if let Some(Overlay::Transcript(overlay)) = &mut self.overlay {
overlay.set_presentation(detailed, mode);
} else {
self.transcript_view.set_presentation(detailed, mode);
if let Some(index) =
nth_user_position(&self.transcript_cells, self.backtrack.nth_user_message)
{
self.transcript_view
.jump_to_entry(&self.transcript_cells, index);
}
}
self.apply_backtrack_selection_internal(self.backtrack.nth_user_message);
}
pub(super) fn browsing_details(&self) -> bool {
match &self.overlay {
Some(Overlay::Transcript(overlay)) => overlay.is_detailed(),
_ => self.transcript_view.is_detailed(),
}
}
}