Struct ProcessRegistry 

pub struct ProcessRegistry { /* private fields */ }

Thread-safe in-memory store of tracked processes.

Intended to be wrapped in Arc<tokio::sync::RwLock<ProcessRegistry>> and shared between the sandbox backend (writes) and LLM tools (reads).

Implementations

impl ProcessRegistry

pub fn new(max_tracked: Option<usize>) -> Self

Create an empty registry.

pub fn insert(&mut self, record: ProcessRecord) -> Result<(), SandboxError>

Register a newly-spawned process.

Returns SandboxError::RegistryFull if max_tracked would be exceeded.

pub fn get(&self, pid: u32) -> Option<&ProcessRecord>

Look up a process by PID.

pub fn get_mut(&mut self, pid: u32) -> Option<&mut ProcessRecord>

Mutably look up a process by PID.

pub fn running(&self) -> impl Iterator<Item = &ProcessRecord>

Return all currently-running processes.

pub fn all(&self) -> impl Iterator<Item = &ProcessRecord>

Return all processes (running and exited).

pub fn mark_exited(&mut self, pid: u32, code: i32)

Mark a process as exited.

pub fn mark_signaled(&mut self, pid: u32, signal: i32)

Mark a process as signaled.

pub fn gc(&mut self)

Remove all exited/signaled records. Useful for long-running agents to prevent unbounded growth.

Trait Implementations

impl Debug for ProcessRegistry

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

Formats the value using the given formatter.

impl Default for ProcessRegistry

fn default() -> ProcessRegistry

Returns the “default value” for a type.