Struct InteractiveRuntime 

pub struct InteractiveRuntime<W: Write, S: SessionHost> { /* private fields */ }

Live interactive runtime.

Owns:

• tui — the sole stdout owner.
• input — the sole stdin owner (crossterm::EventStream).
• editor — the live, stateful editor (preserved across frames).
• view — the ViewState snapshot mutated by events and actions.
• mapper / input_state — pure input dispatch state.
• focus — single-focus manager (used by selectors and overlays).
• events — the bridged session-event channel.
• partial — the partial-assistant watch receiver.
• shutdown — notify for graceful exit.

The caller owns the pi_tui::terminal::guard::TerminalGuard so it can outlive the runtime and write restore bytes on process exit even if the runtime itself panics.

Implementations

impl<W: Write, S: SessionHost> InteractiveRuntime<W, S>

pub fn new( tui: Tui<W>, input: TerminalInput, session: Arc<S>, options: &InteractiveRuntimeOptions, ) -> Self

Construct the runtime around an already-active Tui and TerminalInput.

The caller is responsible for activating the pi_tui::terminal::guard::TerminalGuard before this call and dropping it after the runtime exits.

Panics

Never. Construction is infallible.

pub fn view(&self) -> &ViewState

Borrow the view state (tests / driver seam).

pub fn viewport_bottom_row(&self) -> u16

Last row occupied by the current terminal viewport.

pub fn view_mut(&mut self) -> &mut ViewState

Mutably borrow the view state (tests / driver seam).

pub fn editor(&self) -> &Editor

Borrow the live editor (tests / driver seam).

pub fn editor_mut(&mut self) -> &mut Editor

Mutably borrow the live editor (tests / driver seam).

pub fn input_state(&self) -> &InputState

Borrow the input mapper state (tests).

pub fn last_error(&self) -> Option<&str>

Last recorded session error message, if any.

pub fn request_shutdown(&self)

Signal the runtime to exit at the next loop turn (signal handler hook).

pub fn shutdown_notify(&self) -> Arc<Notify>

Shared shutdown notify (for registering multiple signal sources).

pub fn tui(&self) -> &Tui<W>

Borrow the underlying Tui (for suspend / resume / reprobe).

pub fn tui_mut(&mut self) -> &mut Tui<W>

Mutably borrow the underlying Tui.

pub fn input(&self) -> &TerminalInput

Borrow the input handle (driver seam).

pub fn input_mut(&mut self) -> &mut TerminalInput

Mutably borrow the input handle (driver seam).

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

Run the main event loop until shutdown is requested or stdin closes.

Returns the exit reason; the caller drops the runtime and the pi_tui::terminal::guard::TerminalGuard in that order.

Errors

Returns io::Error only when a terminal write fails irrecoverably.

pub async fn rebind_session_channels(&mut self)

Rebind event/partial subscriptions and reload the transcript after a session replacement. Used by production rebind callback and tests.

pub fn close_selector_for_suspend(&mut self)

Clear selector focus before process suspension.

pub async fn step_ui(&mut self, event: UiEvent) -> Result<()>

Advance one UI event without running the full event loop. Returns the list of dispatch outcomes; the caller may then assert on view state.

This is the test driver seam: a fake TerminalInput can be injected via InteractiveRuntime::new, and tests call step_ui to feed scripted key sequences while observing the view and session host.

Errors

Propagates I/O failures from the underlying Tui::commit.

pub fn step_session_event( &mut self, event: impl Borrow<AgentSessionEvent>, ) -> Ready<Result<()>>

Advance one session event without running the full event loop.

Errors

Propagates I/O failures from the underlying Tui::commit.

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

Force a single paint (tests / driver seam).

Errors

Propagates I/O failures from the underlying Tui::commit.

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

Force a coalesced paint tick (tests). Clears the deadline and commits.

Errors

Propagates I/O failures from the underlying Tui::commit.

pub fn enqueue_settle(&mut self, blocks: Vec<SettledBlock>)

Enqueue a settle transaction for the next loop turn (tests / driver).