Struct BoxRecord 

pub struct BoxRecord {

    pub id: String,
    pub short_id: String,
    pub name: String,
    pub image: String,
    pub isolation: ExecutionIsolation,
    pub managed_execution: Option<ManagedExecutionMetadata>,
    pub status: String,
    pub pid: Option<u32>,
    pub pid_start_time: Option<u64>,
    pub cpus: u32,
    pub memory_mb: u32,
    pub volumes: Vec<String>,
    pub virtiofs_cache: Option<String>,
    pub env: HashMap<String, String>,
    pub cmd: Vec<String>,
    pub entrypoint: Option<Vec<String>>,
    pub box_dir: PathBuf,
    pub exec_socket_path: PathBuf,
    pub console_log: PathBuf,
    pub created_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub auto_remove: bool,
    pub hostname: Option<String>,
    pub user: Option<String>,
    pub workdir: Option<String>,
    pub restart_policy: String,
    pub port_map: Vec<String>,
    pub labels: HashMap<String, String>,
    pub stopped_by_user: bool,
    pub restart_count: u32,
    pub max_restart_count: u32,
    pub exit_code: Option<i32>,
    pub health_check: Option<HealthCheck>,
    pub healthcheck_disabled: bool,
    pub health_status: String,
    pub health_retries: u32,
    pub health_last_check: Option<DateTime<Utc>>,
    pub network_mode: NetworkMode,
    pub network_name: Option<String>,
    pub volume_names: Vec<String>,
    pub tmpfs: Vec<String>,
    pub anonymous_volumes: Vec<String>,
    pub resource_limits: ResourceLimits,
    pub log_config: LogConfig,
    pub add_host: Vec<String>,
    pub platform: Option<String>,
    pub init: bool,
    pub read_only: bool,
    pub cap_add: Vec<String>,
    pub cap_drop: Vec<String>,
    pub security_opt: Vec<String>,
    pub privileged: bool,
    pub devices: Vec<String>,
    pub gpus: Option<String>,
    pub shm_size: Option<u64>,
    pub stop_signal: Option<String>,
    pub stop_timeout: Option<u64>,
    pub oom_kill_disable: bool,
    pub oom_score_adj: Option<i32>,
}

Metadata record for a single local box execution.

Fields

id: String

Full UUID.

short_id: String

First 12 hex characters of the UUID, without dashes.

name: String

User-assigned or generated name.

image: String

OCI image reference.

isolation: ExecutionIsolation

Requested execution isolation. Records written before this field default to MicroVM.

managed_execution: Option<ManagedExecutionMetadata>

Runtime lifecycle identity and recoverable creation intent.

Legacy CLI-created records omit this field. Managed executions persist it before launch so an operation can be reconciled after a service restart without creating a second execution.

status: String

Persisted lifecycle state.

Legacy records use created, running, paused, stopped, and dead. Managed executions additionally use the durable transition states defined by ManagedExecutionState.

pid: Option<u32>

Shim process PID while the execution is active.

pid_start_time: Option<u64>

Start-time identity token used to reject a reused PID.

cpus: u32

Number of virtual CPUs.

memory_mb: u32

Memory in MiB.

volumes: Vec<String>

Volume mounts encoded as host-to-guest pairs.

virtiofs_cache: Option<String>

virtio-fs cache mode for host directory volumes.

env: HashMap<String, String>

Environment variables.

cmd: Vec<String>

Command override.

entrypoint: Option<Vec<String>>

Entrypoint override.

box_dir: PathBuf

Host-side execution directory.

exec_socket_path: PathBuf

Path to the exec socket.

console_log: PathBuf

Path to the console log.

created_at: DateTime<Utc>

Creation timestamp.

started_at: Option<DateTime<Utc>>

Start timestamp.

auto_remove: bool

Whether the execution is removed automatically after it stops.

hostname: Option<String>

Custom hostname.

user: Option<String>

User inside the workload.

workdir: Option<String>

Working directory inside the workload.

restart_policy: String

Restart policy.

port_map: Vec<String>

Port mappings.

labels: HashMap<String, String>

User-defined labels.

stopped_by_user: bool

Whether the execution was explicitly stopped by a user.

restart_count: u32

Automatic restart count.

max_restart_count: u32

Maximum restart count for a bounded on-failure policy.

exit_code: Option<i32>

Last captured exit code.

health_check: Option<HealthCheck>

Health-check configuration.

healthcheck_disabled: bool

Whether an image-defined health check was disabled explicitly.

health_status: String

Current health state.

health_retries: u32

Consecutive health-check failures.

health_last_check: Option<DateTime<Utc>>

Timestamp of the most recent health check.

network_mode: NetworkMode

Network mode.

network_name: Option<String>

Attached bridge network name.

volume_names: Vec<String>

Attached named volumes.

tmpfs: Vec<String>

tmpfs mounts.

anonymous_volumes: Vec<String>

Anonymous volumes materialized from OCI declarations.

resource_limits: ResourceLimits

Host resource controls.

log_config: LogConfig

Logging configuration.

add_host: Vec<String>

Custom host-to-IP mappings.

platform: Option<String>

Target OCI platform.

init: bool

Whether to run an init process as PID 1.

read_only: bool

Whether the root filesystem is read-only.

cap_add: Vec<String>

Added Linux capabilities.

cap_drop: Vec<String>

Dropped Linux capabilities.

security_opt: Vec<String>

OCI security options.

privileged: bool

Whether extended privileges are enabled.

devices: Vec<String>

Device mappings.

gpus: Option<String>

GPU selection.

shm_size: Option<u64>

Shared-memory size in bytes.

stop_signal: Option<String>

Signal used for graceful stop.

stop_timeout: Option<u64>

Graceful stop timeout in seconds.

oom_kill_disable: bool

Whether the OOM killer is disabled.

oom_score_adj: Option<i32>

Host OOM score adjustment.

Implementations

impl BoxRecord

pub fn make_short_id(id: &str) -> String

Generate the stable short ID used by local CLI and SDK lookup.

pub fn is_active(&self) -> bool

Whether the persisted lifecycle state represents an active execution.

pub fn managed_state(&self) -> Result<Option<ManagedExecutionState>>

Parse the lifecycle state of a managed execution.

Legacy records return None. Unknown managed states fail closed so a runtime service cannot operate on a record written by incompatible code.

pub fn status_summary(&self) -> String

Render a concise lifecycle status with health, exit, and restart annotations.

Trait Implementations

impl Clone for BoxRecord

fn clone(&self) -> BoxRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoxRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BoxRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BoxRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.