Struct Vm 

pub struct Vm { /* private fields */ }

The Harn bytecode virtual machine.

Implementations

impl Vm

pub fn format_runtime_error(&self, error: &VmError) -> String

impl Vm

pub fn new() -> Self

pub fn set_bridge(&mut self, bridge: Rc<HostBridge>)

Set the bridge for delegating unknown builtins in bridge mode.

pub fn set_denied_builtins(&mut self, denied: HashSet<String>)

Set builtins that are denied in sandbox mode. When called, the given builtin names will produce a permission error.

pub fn set_source_info(&mut self, file: &str, text: &str)

Set source info for error reporting (file path and source text).

pub fn set_breakpoints(&mut self, lines: Vec<usize>)

Set breakpoints by source line number.

pub fn set_step_mode(&mut self, step: bool)

Enable step mode (stop at next line).

pub fn set_step_over(&mut self)

Enable step-over mode (stop at next line at same or lower frame depth).

pub fn set_step_out(&mut self)

Enable step-out mode (stop when returning from current frame).

pub fn is_stopped(&self) -> bool

Check if the VM is stopped at a debug point.

pub fn debug_state(&self) -> DebugState

Get the current debug state (variables, line, etc.).

pub fn debug_stack_frames(&self) -> Vec<(String, usize)>

Get all stack frames for the debugger.

pub async fn step_execute(&mut self) -> Result<Option<(VmValue, bool)>, VmError>

Execute one instruction, returning whether to stop (breakpoint/step). Returns Ok(None) to continue, Ok(Some(val)) on program end, Err on error.

pub fn start(&mut self, chunk: &Chunk)

Initialize execution (push the initial frame).

pub fn register_builtin<F>(&mut self, name: &str, f: F)

where F: Fn(&[VmValue], &mut String) -> Result<VmValue, VmError> + 'static,

Register a sync builtin function.

pub fn unregister_builtin(&mut self, name: &str)

Remove a sync builtin (so an async version can take precedence).

pub fn register_async_builtin<F, Fut>(&mut self, name: &str, f: F)

where F: Fn(Vec<VmValue>) -> Fut + 'static, Fut: Future<Output = Result<VmValue, VmError>> + 'static,

Register an async builtin function.

pub fn set_source_dir(&mut self, dir: &Path)

Set the source directory for import resolution and introspection. Also auto-detects the project root if not already set.

pub fn set_project_root(&mut self, root: &Path)

Explicitly set the project root directory. Used by ACP/CLI to override auto-detection.

pub fn project_root(&self) -> Option<&Path>

Get the project root directory, falling back to source_dir.

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

Return all registered builtin names (sync + async).

pub fn set_global(&mut self, name: &str, value: VmValue)

Set a global variable in the VM’s environment. Globals are defined before user code runs, so collisions are not possible.

pub fn output(&self) -> &str

Get the captured output.

pub async fn execute(&mut self, chunk: &Chunk) -> Result<VmValue, VmError>

Execute a compiled chunk.

pub async fn call_closure_pub( &mut self, closure: &VmClosure, args: &[VmValue], functions: &[CompiledFunction], ) -> Result<VmValue, VmError>

Public wrapper for call_closure, used by the MCP server to invoke tool handler closures from outside the VM execution loop.

Trait Implementations

impl Default for Vm

fn default() -> Self

Returns the “default value” for a type.