Struct GuestRuntimeConfig 

pub struct GuestRuntimeConfig {

    pub virtual_pid: Option<u64>,
    pub virtual_ppid: Option<u64>,
    pub virtual_uid: Option<u64>,
    pub virtual_gid: Option<u64>,
    pub virtual_exec_path: Option<String>,
    pub os_cpu_count: Option<u64>,
    pub os_totalmem: Option<u64>,
    pub os_freemem: Option<u64>,
    pub os_homedir: Option<String>,
    pub os_hostname: Option<String>,
    pub os_tmpdir: Option<String>,
    pub os_type: Option<String>,
    pub os_release: Option<String>,
    pub os_version: Option<String>,
    pub os_machine: Option<String>,
    pub os_shell: Option<String>,
    pub os_user: Option<String>,
    pub high_resolution_time: bool,
    pub snapshot_userland_code: Option<String>,
}

Per-execution guest-runtime config carried as typed fields rather than AGENTOS_* env vars. The sidecar populates these from kernel state (user_profile(), resource_limits()) and CreateVmConfig; the runtime shim interpolates them into a _processConfig object the guest reads, so the guest’s virtual identity no longer rides the ambient env channel. None keeps the guest-runtime default. See the env-vs-wire rule in crates/sidecar/CLAUDE.md.

Fields

virtual_pid: Option<u64>

Virtual process.pid.

virtual_ppid: Option<u64>

Virtual process.ppid.

virtual_uid: Option<u64>

Virtual process.uid / process.euid.

virtual_gid: Option<u64>

Virtual process.gid / process.egid / process.groups.

virtual_exec_path: Option<String>

Virtual process.execPath.

os_cpu_count: Option<u64>

os.cpus().length.

os_totalmem: Option<u64>

os.totalmem() in bytes.

os_freemem: Option<u64>

os.freemem() in bytes.

os_homedir: Option<String>

os.homedir().

os_hostname: Option<String>

os.hostname().

os_tmpdir: Option<String>

os.tmpdir().

os_type: Option<String>

os.type().

os_release: Option<String>

os.release().

os_version: Option<String>

os.version().

os_machine: Option<String>

os.machine().

os_shell: Option<String>

Default login shell.

os_user: Option<String>

os.userInfo().username.

high_resolution_time: bool

Opt-in high-resolution monotonic guest clock. Default false preserves the security-oriented coarse clock.

snapshot_userland_code: Option<String>

Optional agent-SDK bundle (esbuild IIFE) to evaluate into the per-sidecar V8 snapshot alongside the bridge, so the SDK is loaded once per sidecar and reused across sessions instead of re-imported on every execution. None keeps the bridge-only snapshot (unchanged behavior). The runtime caches the snapshot process-wide keyed by sha256(bridge_code + this bundle).

Trait Implementations

impl Clone for GuestRuntimeConfig

fn clone(&self) -> GuestRuntimeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GuestRuntimeConfig

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

Formats the value using the given formatter.

impl Default for GuestRuntimeConfig

fn default() -> GuestRuntimeConfig

Returns the “default value” for a type.

impl Eq for GuestRuntimeConfig

impl PartialEq for GuestRuntimeConfig

fn eq(&self, other: &GuestRuntimeConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GuestRuntimeConfig