Struct AgentsConfig 

pub struct AgentsConfig {
    pub gc_interval_minutes: u64,
    pub presence_ttl_hours: u64,
    pub scratchpad_default_ttl_hours: u64,
    pub logical_session_ttl_seconds: u64,
    pub active_worker_lease_seconds: u64,
    pub serialize_build_commands: bool,
    pub cargo_build_jobs: usize,
    pub shared_cargo_target: bool,
    pub max_scratchpad_entries: usize,
}

Agent lifecycle configuration: TTLs, GC intervals, scratchpad limits.

Maps to [agents] in config.toml. All fields have sane defaults so existing configs without this section continue to work.

Fields

gc_interval_minutes: u64

How often the background reaper runs (minutes). 0 = disabled.

presence_ttl_hours: u64

Presence registry: remove finished agents older than this (hours).

scratchpad_default_ttl_hours: u64

Default TTL for scratchpad messages without explicit expiry (hours).

logical_session_ttl_seconds: u64

Logical session timeout (seconds).

active_worker_lease_seconds: u64

Active worker lease. Missing heartbeats release capacity automatically.

serialize_build_commands: bool

Opt-in: let only one cargo/npm build or test run at a time across all lean-ctx sessions on this machine (ctx_shell waits for the slot). Off by default — it queued every user’s builds behind other sessions.

cargo_build_jobs: usize

Opt-in: CARGO_BUILD_JOBS for builds run through ctx_shell. 0 (default) leaves cargo’s own setting alone.

shared_cargo_target: bool

Opt-in: point builds run through ctx_shell at one machine-wide CARGO_TARGET_DIR (<data dir>/build-cache/cargo-target). Off by default: when on, ./target stops receiving the output, so a binary run from there is stale.

max_scratchpad_entries: usize

Max scratchpad entries before oldest are evicted.

Trait Implementations

impl Clone for AgentsConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentsConfig

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

Formats the value using the given formatter.

impl Default for AgentsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentsConfig

where AgentsConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.