Struct AgentOsConfig 

pub struct AgentOsConfig {

    pub database: Option<VmSqliteDescriptor>,
    pub user: Option<VmUserConfig>,
    pub software: Vec<SoftwareInput>,
    pub packages: Vec<PackageRef>,
    pub packages_mount_at: Option<String>,
    pub loopback_exempt_ports: Vec<u16>,
    pub allowed_node_builtins: Option<Vec<String>>,
    pub root_filesystem: RootFilesystemConfig,
    pub mounts: Vec<MountConfig>,
    pub additional_instructions: Option<String>,
    pub schedule_driver: Option<Arc<dyn ScheduleDriver>>,
    pub bindings: Vec<Bindings>,
    pub sidecar_js_bridge_callback: Option<SidecarJsBridgeCallback>,
    pub permissions: Option<Permissions>,
    pub limits: Option<AgentOsLimits>,
    pub sidecar: Option<AgentOsSidecarConfig>,
    pub sidecar_binary_path: Option<String>,
}

Resolved client options (= TS AgentOsOptions). All fields optional with documented defaults.

Keep this Rust mirror in sync with packages/core/src/agent-os.ts::AgentOsOptions and packages/core/src/options-schema.ts::agentOsOptionsSchema.

Fields

database: Option<VmSqliteDescriptor>

VM-scoped SQLite backend shared by VFS metadata/storage and AgentOS durable state. Actor deployments inject ActorUds; standalone clients normally provide a SqliteFile descriptor.

user: Option<VmUserConfig>

Initial virtual Linux credentials and account record. Defaults to 1000:1000 (agentos).

software: Vec<SoftwareInput>

Software packages to install (flattened). Default [].

packages: Vec<PackageRef>

Package directories to project into the VM’s /opt/agentos tree (the agentos package projection). Each entry is a host dir containing an agentos-package.json manifest + the package payload. Default [].

packages_mount_at: Option<String>

Guest mount point for the package projection. Default /opt/agentos (agentos’s OPT_AGENTOS_ROOT) when None.

loopback_exempt_ports: Vec<u16>

Loopback ports exempt from the default outbound-to-host block.

allowed_node_builtins: Option<Vec<String>>

Allowed Node.js builtins. Default: the hardened native-bridge set.

root_filesystem: RootFilesystemConfig

Root filesystem configuration. Default: overlay + bundled base snapshot.

mounts: Vec<MountConfig>

Additional mounts.

additional_instructions: Option<String>

Extra OS instructions appended to agent sessions.

schedule_driver: Option<Arc<dyn ScheduleDriver>>

Schedule driver used by the cron manager. Default: TimerScheduleDriver.

bindings: Vec<Bindings>

Binding collections to register.

sidecar_js_bridge_callback: Option<SidecarJsBridgeCallback>

Rust-only sidecar callback handler for js_bridge-style plugin requests.

permissions: Option<Permissions>

Permission policy. Default: allow-all.

limits: Option<AgentOsLimits>

Operator-tunable VM limits. Default: sidecar/kernel built-ins.

sidecar: Option<AgentOsSidecarConfig>

Sidecar placement/config. Default: shared default pool.

sidecar_binary_path: Option<String>

Absolute path to the agentos-sidecar binary, resolved from the npm package on the TypeScript side. Threaded to SidecarProcess::spawn (mirroring rivetkit’s engine_binary_path) instead of relying on the AGENTOS_SIDECAR_BIN env var. None falls back to env, then PATH.

Trait Implementations

impl Default for AgentOsConfig

fn default() -> AgentOsConfig

Returns the “default value” for a type.