Struct HostState 

pub struct HostState {
    pub stdout: Vec<u8>,
    pub stderr: Vec<u8>,
    pub output: Vec<u8>,
    pub input: Vec<u8>,
    pub input_pos: usize,
    pub capabilities: Vec<Capability>,
    pub memory_peak: usize,
}

Mutable state shared between the host and WASM guest via host functions.

Each sandbox execution gets its own HostState that accumulates output written by the guest and provides the input buffer for reading.

Fields

stdout: Vec<u8>

Bytes written by the guest to stdout.

stderr: Vec<u8>

Bytes written by the guest to stderr.

output: Vec<u8>

Bytes written by the guest to the structured output channel.

input: Vec<u8>

Input buffer supplied by the host before execution.

input_pos: usize

Current read position within input.

capabilities: Vec<Capability>

Capabilities granted to this sandbox execution.

memory_peak: usize

Peak linear memory usage observed (in bytes).

Implementations

impl HostState

pub fn new(input: Vec<u8>, capabilities: Vec<Capability>) -> Self

Create a new HostState with the given input buffer and capabilities.

pub fn has_capability(&self, cap: &Capability) -> bool

Check whether this host state includes the given capability.

For simple capabilities like Capability::Stdout and Capability::Stderr, an exact variant match is performed. For path-based capabilities like Capability::FileRead, the check succeeds if any allowed path is a prefix of (or equal to) the requested path.

pub fn track_memory(&mut self, current_bytes: usize)

Track peak memory usage. If current_bytes exceeds the previous peak the peak is updated.