Expand description
TUI main event loop — connects oxicode’s AgentSession to vtcode-ui’s
InlineSession protocol and a ratatui rendering backend.
Structs§
- Ephemeral
Tip - A short-lived contextual tip banner (grok-build ephemeral tips parity). Shown as one line above the composer for a bounded number of render ticks, then auto-dismissed.
- Modal
Confirmation - A y/n/x confirmation dialog (grok-build
ModalConfirmationparity). Rendered centered on top of everything else; the input thread routesy→ confirm,n→ decline (when offered),x/Esc→ cancel. - Overlay
List Item - One item rendered inside a list overlay. Mirrors
InlineListItembut is a value type owned by the TUI (the input thread reads/writes these fields directly via theparking_lot::Mutex<RenderState>). - Overlay
Search State - Search-bar state for an overlay.
Nonevalue means search is disabled. - Overlay
Secure Input - Secure (masked) single-line input state carried by an overlay.
Only present when the original
OverlayRequest::Modalcarried asecure_prompt. The input thread mutateseditorwhile the overlay is open; onEnterit submitsOverlaySubmission::SecureInputcarrying the editor’s text. The real secret never leaves the editor — the renderer paints the value via aTextElementwhose display is the mask. - Overlay
State - Overlay modal/list state — materialised by
apply_commandwhen anInlineCommand::ShowOverlayarrives. The input thread mutatesselected/searchwhile the overlay is open and reads the same fields when forwardingOverlayEvents. - Render
State - Search
State - In-transcript search state.
- Slash
Popup - Slash-command autocomplete popup state, managed by the input thread and
read by the render loop. The popup is open when the input buffer starts
with
/and contains no space (i.e. the user is still typing the command token, not its arguments). - Slash
Popup Item - One filtered entry in the
/-command autocomplete popup. - Tui
- Terminal wrapper with deterministic enter / exit / Drop semantics.
Enums§
- Confirmation
Action - The action bound to a
ModalConfirmation— dispatched ony/Enter. - Secure
Input Origin - Where a secure prompt came from. The
SecureInputoverlay has just one payload (the text); the origin discriminates the post-commit follow-up so the user gets a contextual flow instead of a generic “saved” line.
Functions§
- run_tui
- Run the new oxicode-vtui powered TUI. Returns once the user exits or the session is shut down.