Struct Vm 

pub struct Vm {
    pub state: ShellState,
    pub steps: u64,
    pub limits: ExecutionLimits,
    pub output_bytes: u64,
    pub budget: BudgetTracker,
    pub diagnostics: Vec<DiagnosticEvent>,
    pub stdout: Vec<u8>,
    pub stderr: Vec<u8>,
    /* private fields */
}

The shell virtual machine.

Fields

state: ShellState

Shell state (variables, params, cwd, etc.).

steps: u64

Number of steps executed so far.

limits: ExecutionLimits

Execution limits.

output_bytes: u64

Bytes of output produced so far.

budget: BudgetTracker

Shared budget accounting and stable stop reasons.

diagnostics: Vec<DiagnosticEvent>

Collected diagnostic events.

stdout: Vec<u8>

Collected stdout output from command execution.

stderr: Vec<u8>

Collected stderr output from command execution.

Implementations

impl Vm

pub fn new(state: ShellState, step_budget: u64) -> Self

Create a new VM with the given state and limits.

pub fn with_limits(state: ShellState, limits: ExecutionLimits) -> Self

Create a VM with full execution limits.

pub fn emit_diagnostic( &mut self, level: DiagLevel, category: DiagCategory, message: String, )

Emit a diagnostic event.

pub fn stop_reason(&self) -> Option<&StopReason>

pub fn track_output(&mut self, bytes: u64) -> bool

Track output bytes and check the limit. Returns true if within limits.

pub fn write_stdout(&mut self, data: &[u8])

Append stdout bytes and update output accounting.

pub fn write_stderr(&mut self, data: &[u8])

Append stderr bytes and update output accounting.

pub fn write_streams(&mut self, stdout: &[u8], stderr: &[u8])

Append both stdout and stderr bytes and update output accounting once.

pub fn check_output_limit(&mut self) -> Result<(), StepResult>

Check whether the accumulated output has exceeded the configured limit.

pub fn begin_step(&mut self) -> Result<(), StepResult>

Consume one execution step using the VM’s shared budget/cancel semantics.

pub fn cancellation_token(&self) -> CancellationToken

Get the cancellation token (can be cloned and shared).

pub fn run(&mut self, program: &IrProgram) -> StepResult

Execute an IR program to completion (or until yield/cancel).

pub fn run_with_executor<E: VmExecutor>( &mut self, program: &IrProgram, executor: &mut E, ) -> StepResult

Trait Implementations

impl Default for Vm

fn default() -> Self

Returns the “default value” for a type.