Struct SessionRetentionLimits 

pub struct SessionRetentionLimits {
    pub max_runs_retained: Option<usize>,
    pub max_events_per_run: Option<usize>,
    pub max_trace_events: Option<usize>,
    pub max_terminal_subagent_tasks: Option<usize>,
}

Per-session in-memory retention caps. Built via SessionOptions::with_retention_limits or by constructing the struct directly.

Fields

max_runs_retained: Option<usize>

Maximum number of runs retained in InMemoryRunStore.

When a new run is created past this cap, the oldest run (by insertion order) is dropped along with its events. None (default) keeps all runs.

max_events_per_run: Option<usize>

Maximum number of event records retained per run in InMemoryRunStore.

When a run accumulates more events than this, the oldest events are FIFO-dropped. The run snapshot’s event_count is not decremented — it remains the total ever recorded. None (default) keeps all events.

max_trace_events: Option<usize>

Maximum number of events retained in InMemoryTraceSink.

When the sink reaches this cap, the oldest event is dropped on each new write. None (default) keeps all events.

max_terminal_subagent_tasks: Option<usize>

Maximum number of terminal (Completed / Failed / Cancelled) subagent task snapshots retained in InMemorySubagentTaskTracker. Running tasks are never dropped.

When the count of terminal entries exceeds this cap, the oldest terminal entry (by completion time) is dropped. None (default) keeps all terminal entries.

Implementations

impl SessionRetentionLimits

pub fn new() -> Self

Convenience builder.

pub fn with_max_runs(self, n: usize) -> Self

pub fn with_max_events_per_run(self, n: usize) -> Self

pub fn with_max_trace_events(self, n: usize) -> Self

pub fn with_max_terminal_subagent_tasks(self, n: usize) -> Self

Trait Implementations

impl Clone for SessionRetentionLimits

fn clone(&self) -> SessionRetentionLimits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionRetentionLimits

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

Formats the value using the given formatter.

impl Default for SessionRetentionLimits

fn default() -> SessionRetentionLimits

Returns the “default value” for a type.

impl Copy for SessionRetentionLimits