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_for_file(&mut self, file: &str, lines: Vec<usize>)

Replace breakpoints for a single source file. Pass an empty string (or call set_breakpoints for the wildcard equivalent) to install breakpoints that match every file — useful for ad-hoc CLI runs where the embedder doesn’t track per-file source paths.

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

Backwards-compatible wildcard form. Stores all lines under the empty-string key, which matches any source file at the check site. Existing embedders that don’t track file scoping still work.

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_debug_hook<F>(&mut self, hook: F)

where F: FnMut(&DebugState) -> DebugAction + 'static,

Register a debug hook invoked whenever execution advances to a new source line.

pub fn clear_debug_hook(&mut self)

Clear the current debug hook.

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 constant (e.g. pi, e). Stored separately from the environment so user-defined variables can shadow them.

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.