Struct CliSession 

pub struct CliSession<'a> { /* private fields */ }

Mutably borrowed view used to execute GammaLoop commands.

A session updates its caller-owned State, RunHistory, and effective settings in place. It may also write files according to the selected command. Read-only mode prevents GammaLoop-managed writes into the active state tree, but does not constrain explicit exports or external processes such as the ! shell command.

Implementations

impl<'a> CliSession<'a>

pub fn new( state: &'a mut State, run_history: &'a mut RunHistory, cli_settings: &'a mut CLISettings, default_runtime_settings: &'a mut RuntimeSettings, session_state: &'a mut CliSessionState, ) -> Self

Combine the mutable state and settings that participate in command execution.

This constructor does not initialize GammaLoop, load files, replay history, or execute boot commands. Prefer crate::StateLoadOption::load followed by crate::LoadedState::cli_session unless the caller already owns a consistent bundle.

pub fn execute_command( &mut self, command: CommandHistory, ) -> Result<CommandExecution>

Prepare and execute one command against the borrowed state.

Ordinary successful commands are normalized and appended to the replayable run history; command-block definition controls have specialized recording behavior. A command can mutate the state and settings or write its requested outputs before returning. Inspect both CommandExecution::flow and CommandExecution::output: save/quit requests use ControlFlow::Break, while only evaluation and integration currently return structured output.

Errors include parse/preparation failures, invalid state or settings, unavailable backends, numerical command failures, and forbidden writes into a read-only state tree. An error does not imply that every command-specific external effect was rolled back.

pub fn replay_run_history(&mut self) -> Result<ControlFlow<SaveState>>

Reapply the stored session settings and commands without appending duplicate history.

Replay mutates the current state and can perform the same command-specific effects as normal execution. Callers must honor a returned ControlFlow::Break save/quit request.

pub fn apply_boot_run_history( &mut self, boot_run_history: &RunHistory, effective_boot_run_history: &RunHistory, booted_existing_state: bool, ) -> Result<ControlFlow<SaveState>>

pub fn apply_boot_run_history_with_conflict_resolver<F>( &mut self, boot_run_history: &RunHistory, effective_boot_run_history: &RunHistory, booted_existing_state: bool, resolve_conflicts: F, ) -> Result<ControlFlow<SaveState>>

where F: FnMut(&[String]) -> Result<bool>,

pub fn has_pending_commands_block(&self) -> bool

pub fn pending_commands_block_name(&self) -> Option<String>

pub fn prompt_state_label(&self) -> String

pub fn current_commands_block_names(&self) -> Vec<String>

pub fn current_process_entries(&self) -> Vec<ProcessCompletionEntry>

pub fn current_integrand_detail_entries( &self, ) -> Vec<IntegrandDetailCompletionEntry>

pub fn current_ir_profile_entries(&self) -> Vec<IrProfileCompletionEntry>

pub fn current_model_parameter_entries( &self, ) -> Vec<ModelParameterCompletionEntry>

pub fn current_model_particle_names(&self) -> Vec<String>

pub fn current_model_select_particle_names(&self) -> Vec<String>

pub fn current_model_coupling_names(&self) -> Vec<String>

pub fn current_model_vertices(&self) -> Vec<ModelVertexCompletionEntry>

pub fn run_history_toml(&self) -> Result<String>

pub fn global_settings_toml(&self) -> Result<String>

pub fn active_command_blocks(&self) -> BTreeMap<String, Vec<String>>

pub fn dismiss_pending_commands_block(&mut self, trigger: &str) -> bool