Struct RenderState 

pub struct RenderState {

    pub composer: TextArea,
    pub transcript: Vec<TranscriptLine>,
    pub scroll_offset: usize,
    pub header_context: InlineHeaderContext,
    pub input_enabled: bool,
    pub footer_left: Option<String>,
    pub footer_right: Option<String>,
    pub prompt_prefix: String,
    pub placeholder: Option<String>,
    pub shutdown_requested: bool,
    pub message_buffer: String,
    pub agent_hub_open: bool,
    pub hub_entries: Vec<(String, HubEntry)>,
    pub pending_quit: bool,
    pub slash_popup: SlashPopup,
    pub reasoning_stage: Option<String>,
    pub thinking_level: String,
    pub context_tokens: Option<usize>,
    pub context_window: usize,
    pub overlay: Option<OverlayState>,
    pub overlay_model_ids: Vec<String>,
    pub overlay_catalog_models: Vec<(String, String)>,
    pub overlay_providers: Vec<String>,
    pub catalog: Option<Arc<dyn ModelCatalog>>,
    pub queued_inputs: Vec<String>,
    pub queue_panel_open: bool,
    pub queue_selected: usize,
    pub shell_mode: bool,
    pub follow_ups: Vec<String>,
    pub todo_items: Vec<(String, TodoStatus)>,
    pub todo_provider: Option<Arc<dyn TodoStateProvider>>,
    pub vim_state: VimState,
    pub vim_clipboard: String,
    pub search: Option<SearchState>,
    pub block_display: HashMap<usize, BlockDisplayMode>,
    pub last_esc_at: Option<Instant>,
    pub multiline_mode: bool,
    pub autonomy_mode: Mode,
    pub prompt_history: Vec<String>,
    pub history_pos: Option<usize>,
    pub next_block_id: usize,
    pub cancel_grace_until: Option<Instant>,
    pub confirmation: Option<ModalConfirmation>,
    pub tip: Option<EphemeralTip>,
    pub cwd: PathBuf,
    pub file_search: Option<FileSearchState>,
    pub seen_tips: HashMap<&'static str, u32>,
    pub file_commands: Vec<FileCommand>,
    pub secure_input_origin: Option<SecureInputOrigin>,
    pub session_swapper: Option<Arc<SessionSwapper>>,
    pub pending_resume: Option<PathBuf>,
    pub session_state: Option<SessionState>,
}

Mutable state the input thread edits (text buffer, scroll, footer) and the main loop reads for rendering.

Fields

composer: TextArea

Editable text in the composer. Source of truth for the prompt line.

transcript: Vec<TranscriptLine>

Transcript lines, in display order.

scroll_offset: usize

Index of the line currently pinned at the top of the viewport. usize::MAX means “follow the tail” (auto-scroll).

header_context: InlineHeaderContext

Header context mirrored from InlineHeaderContext.

input_enabled: bool

Composer enabled state — mirrored from SetInputEnabled.

footer_left: Option<String>

Footer status (left + right) — mirrored from SetInputStatus.

footer_right: Option<String>

prompt_prefix: String

Composer prompt prefix — mirrored from SetPrompt.

placeholder: Option<String>

Composer placeholder — mirrored from SetPlaceholder.

shutdown_requested: bool

Shutdown signal received from the harness.

message_buffer: String

Accumulated text for markdown rendering at message end.

agent_hub_open: bool

Agent Hub overlay open.

hub_entries: Vec<(String, HubEntry)>

Hub entries snapshotted when the overlay was opened (/agents).

pending_quit: bool

First Ctrl+C armed a quit; a second press exits (two-press quit).

slash_popup: SlashPopup

Slash-command autocomplete popup state.

reasoning_stage: Option<String>

Current reasoning/tool stage (e.g. “tool: read”), shown above the composer.

thinking_level: String

Selected reasoning effort, reflected in the composer’s context bar.

context_tokens: Option<usize>

Provider-reported prompt tokens for the most recently completed turn. This is the closest available snapshot of the live context size.

context_window: usize

Context capacity configured for the active agent session.

overlay: Option<OverlayState>

Overlay modal/list state — Some when an overlay is open.

overlay_model_ids: Vec<String>

Model IDs for the /model overlay picker (ordered same as overlay items).

overlay_catalog_models: Vec<(String, String)>

(provider, model_id) pairs backing the /models catalog browser overlay (ordered same as overlay items).

overlay_providers: Vec<String>

Provider names backing the /providers overlay (ordered same as items).

catalog: Option<Arc<dyn ModelCatalog>>

Model catalog port handle, captured once at TUI startup so slash commands (/models, /providers) can browse the full catalog.

queued_inputs: Vec<String>

Queued input prompts (waiting to be processed).

queue_panel_open: bool

Queued input prompts — interactive panel open (Ctrl+; toggles).

queue_selected: usize

Selected index within the queue panel (when interactive).

shell_mode: bool

Shell mode — ! prefix for direct bash commands (grok-build parity).

follow_ups: Vec<String>

Follow-up suggestion chips.

todo_items: Vec<(String, TodoStatus)>

Todo checklist items (text, status) — refreshed from the live provider.

todo_provider: Option<Arc<dyn TodoStateProvider>>

Live todo state provider — the same source the todo agent tool writes to. None when todos are disabled; the pane stays hidden.

vim_state: VimState

Vim editing state (enabled by /vim command).

vim_clipboard: String

Vim clipboard buffer.

search: Option<SearchState>

In-transcript search state — None when no search is active.

block_display: HashMap<usize, BlockDisplayMode>

Per-block display override. An absent entry means the default (`BlockDisplayMode::Truncated).

last_esc_at: Option<Instant>

Last Esc press timestamp (for double-Esc detection).

multiline_mode: bool

Multiline input mode — Enter inserts newline, Shift+Enter sends.

autonomy_mode: Mode

Autonomy mode mirror for display. The authoritative value lives in the shared AskBridge mode atomic (toggled by Shift+Tab); this field is kept in lock-step so the render loop can draw a badge.

prompt_history: Vec<String>

Submitted prompt history (most-recent-first).

history_pos: Option<usize>

Current position in history navigation (None = not navigating).

next_block_id: usize

Next block ID to assign when appending transcript lines.

cancel_grace_until: Option<Instant>

Cancel grace window — Esc pressed within this window after a cancel is ignored (grok-build post-cancel grace, ~1s). Prevents mashing.

confirmation: Option<ModalConfirmation>

Active y/n/x confirmation dialog — Some while a modal confirmation is open. The input thread resolves it; the render loop paints it centered on top of everything else.

tip: Option<EphemeralTip>

Active ephemeral tip banner — Some for a bounded number of render ticks, then auto-dismissed by expiry.

cwd: PathBuf

Workspace root — used by the @ file picker to walk + fuzzy-match.

file_search: Option<FileSearchState>

Active @-file-search dropdown — Some while the picker is open.

seen_tips: HashMap<&'static str, u32>

Per-tip-key show counter — suppresses ambient tips after SEEN_CAP views.

file_commands: Vec<FileCommand>

User-defined slash commands loaded once at startup from .oxicode/commands/ and ~/.oxicode/commands/.

secure_input_origin: Option<SecureInputOrigin>

Provider name and origin for the currently open secure prompt. Set before opening the prompt; cleared on OverlaySubmission::SecureInput after the key is written. None outside the secure-prompt flows (/providers row action, /providers add, programmatic rekey) so a stray SecureInput cannot leak into a different provider.

The SecureInputOrigin variant lets the consumer of the submitted key know whether to greet the user (“just added a provider”) or simply acknowledge (“key replaced”) — both write to the same auth storage slot, but the surrounding UX differs.

session_swapper: Option<Arc<SessionSwapper>>

Live-session swapper. None until the TUI startup wires it. The render loop and the agent worker both call current() per dispatch; the resume tokio::spawn calls swap(new_handle). Option because #[derive(Default)] requires it.

pending_resume: Option<PathBuf>

Some(path) when the slash command wants the event loop to drain a resume job on the next Submitted arm. The Submitted arm calls state.pending_resume.take() and enqueues the resume.

session_state: Option<SessionState>

Some(state) once the TUI startup clones the App’s SessionState into the render state. The resume spawn closure captures it and passes it to AgentSession::resume_from_file. Option because #[derive(Default)] requires it.

Implementations

impl RenderState

pub fn swapper(&self) -> Arc<SessionSwapper>

Get a clone of the live SessionSwapper. Panics if the TUI wasn’t initialized properly (the run_tui startup wires it before any user input is processed, so the panic is unreachable in normal use).

pub fn start_search(&mut self, query: &str)

Start a new transcript search, collecting all matching line indices.

pub fn search_next(&mut self)

Advance to the next search match (wraps around).

pub fn search_prev(&mut self)

Go to the previous search match (wraps around).

pub fn block_mode(&self, block_id: usize) -> BlockDisplayMode

The display mode for a block — explicit override or the Truncated default.

pub fn cycle_block_at_view(&mut self)

Cycle the display mode of the block at (or nearest above) the current scroll offset: Collapsed → Truncated → Expanded → Collapsed.

pub fn expand_all(&mut self)

Expand every block (show every line at full weight).

pub fn fold_all(&mut self)

Collapse every block (first line only).

pub fn truncate_all(&mut self)

Reset every block to the default Truncated mode.

pub fn jump_next_turn(&mut self)

Jump the scroll to the start of the next assistant (Agent) block.

pub fn jump_prev_turn(&mut self)

Jump the scroll to the start of the previous user block.

pub fn drain_queue_head(&mut self)

Drop the head of the queued-input list. Called when a turn ends so the queue pane stops showing the prompt that is now running.

pub fn show_tip( &mut self, key: &'static str, text: &str, ttl: u64, ambient: bool, )

Show an ephemeral tip if the per-session seen-cap hasn’t been reached. Each unique key can show at most SEEN_CAP times per session.

Trait Implementations

impl Default for RenderState

fn default() -> Self

Returns the “default value” for a type.