Struct OrcsApp 

pub struct OrcsApp { /* private fields */ }

ORCS Application.

Integrates the engine with HIL, input handling, and output display.

Implementations

impl OrcsApp

pub fn builder(resolver: impl ConfigResolver + 'static) -> OrcsAppBuilder

Creates a new builder for OrcsApp.

The resolver is required and controls how configuration is loaded. The application retains the resolver for hot-reload support.

pub fn engine(&self) -> &OrcsEngine

Returns a reference to the engine.

pub fn engine_mut(&mut self) -> &mut OrcsEngine

Returns a mutable reference to the engine.

pub fn config(&self) -> &OrcsConfig

Returns a reference to the loaded configuration.

pub fn reload_config(&mut self) -> Result<(), AppError>

Re-resolves configuration from all sources (hot-reload).

Calls the retained ConfigResolver::resolve() to get a fresh config reflecting any file/env changes since last resolution.

Errors

Returns AppError::Config if resolution fails.

pub fn renderer(&self) -> &ConsoleRenderer

Returns the console renderer.

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

Returns the pending approval ID.

pub fn session_id(&self) -> &str

Returns the current session ID.

pub fn is_resumed(&self) -> bool

Returns whether this session was resumed from storage.

pub fn restored_count(&self) -> usize

Returns the number of components restored (if resumed).

pub async fn save_session(&mut self) -> Result<(), AppError>

Saves the current session to storage.

Transfers component snapshots from the engine into the session asset, then persists to the store.

Errors

Returns AppError::Storage if saving fails.

pub async fn load_session(&mut self, session_id: &str) -> Result<(), AppError>

Loads a session from storage.

Arguments

• session_id - The session ID to load

Errors

Returns AppError::Storage if loading fails.

pub async fn run_command(&mut self, command: &str) -> Result<i32, AppError>

Runs the application in non-interactive command mode.

Sends a single command, collects output until idle, and exits. Unlike interactive mode, raw text is sent directly without interactive command parsing (q/y/n are sent as-is).

Output routing

• Normal/Info/Success/Debug → stdout
• Warn/Error → stderr

Returns

Exit code: 0 for success, 1 if errors occurred.

Errors

Returns AppError::Io on communication errors.

pub async fn run_interactive(&mut self) -> Result<(), AppError>

Runs the application in interactive mode.

Uses a dedicated OS thread for rustyline (prompt, history, line editing) and communicates with the async main loop via channels.

All terminal output during the loop goes through ExternalPrinter to avoid corrupting rustyline’s raw-mode terminal state.

Errors

Returns AppError::Io on stdin read errors.