Struct KernelConfig 

pub struct KernelConfig {
    pub name: String,
    pub vfs_mode: VfsMountMode,
    pub cwd: PathBuf,
    pub skip_validation: bool,
    pub interactive: bool,
}

Configuration for kernel initialization.

Fields

name: String

Name of this kernel (for identification).

vfs_mode: VfsMountMode

VFS mount mode — controls how local filesystem is exposed.

cwd: PathBuf

Initial working directory (VFS path).

skip_validation: bool

Whether to skip pre-execution validation.

When false (default), scripts are validated before execution to catch errors early. Set to true to skip validation for performance or to allow dynamic/external commands.

interactive: bool

When true, standalone external commands inherit stdio for real-time output.

Set by script runner and REPL for human-visible output. Not set by MCP server (output must be captured for structured responses).

Implementations

impl KernelConfig

pub fn transient() -> Self

Create a transient kernel config (sandboxed, for temporary use).

pub fn named(name: &str) -> Self

Create a kernel config with the given name (sandboxed by default).

pub fn repl() -> Self

Create a REPL config with passthrough filesystem access.

Native paths like /home/user/project work directly. The cwd is set to the actual current working directory.

pub fn mcp() -> Self

Create an MCP server config with sandboxed filesystem access.

Local filesystem is accessible at its real path (e.g., /home/user), but sandboxed to $HOME. Paths outside the sandbox are not accessible.

pub fn mcp_with_root(root: PathBuf) -> Self

Create an MCP server config with a custom sandbox root.

Use this to restrict access to a subdirectory like ~/src.

pub fn isolated() -> Self

Create a config with no local filesystem (memory only).

Useful for tests or pure sandboxed execution.

pub fn with_vfs_mode(self, mode: VfsMountMode) -> Self

Set the VFS mount mode.

pub fn with_cwd(self, cwd: PathBuf) -> Self

Set the initial working directory.

pub fn with_skip_validation(self, skip: bool) -> Self

Skip pre-execution validation.

pub fn with_interactive(self, interactive: bool) -> Self

Enable interactive mode (external commands inherit stdio).

Trait Implementations

impl Clone for KernelConfig

fn clone(&self) -> KernelConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KernelConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for KernelConfig

fn default() -> Self

Returns the “default value” for a type.