Struct BestEffortLiveConfig 

#[non_exhaustive]
pub struct BestEffortLiveConfig {
    pub ttl_ms: u32,
    pub maxlen_floor: u32,
    pub maxlen_ceiling: u32,
    pub ema_alpha: f64,
}

Configuration knobs for StreamMode::BestEffortLive — RFC-015 §4.2 dynamic MAXLEN sizing.

Defaults derived from the Phase 0 benchmark + RFC §4.1/§4.3 final design:

• ttl_ms — caller-supplied visibility target.
• maxlen_floor = 64 — RFC §4.1 round-2 default, used for low-rate streams where the EMA formula would under-size.
• maxlen_ceiling = 16_384 — cap on per-stream retained entries (raised from the original §4.2 draft of 2048 after Phase 0 showed 200–4000 Hz LLM-token bursts saturate any lower clamp).
• ema_alpha = 0.2 — RFC §4.3 gate value. Weights the latest per-append instantaneous rate at 20 %, decays prior samples at 80 % each append.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ttl_ms: u32

maxlen_floor: u32

maxlen_ceiling: u32

ema_alpha: f64

Implementations

impl BestEffortLiveConfig

pub fn with_ttl(ttl_ms: u32) -> Self

Construct with the given ttl_ms and defaults for the other knobs. Matches the shorthand used by StreamMode::best_effort_live.

pub fn with_maxlen_floor(self, floor: u32) -> Self

Builder: override Self::maxlen_floor. Chainable.

pub fn with_maxlen_ceiling(self, ceiling: u32) -> Self

Builder: override Self::maxlen_ceiling. Chainable.

pub fn with_ema_alpha(self, alpha: f64) -> Self

Builder: override Self::ema_alpha. Chainable. Callers are expected to keep α in (0.0, 1.0]; the Lua side clamps to that range defensively.

Trait Implementations

impl Clone for BestEffortLiveConfig

fn clone(&self) -> BestEffortLiveConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BestEffortLiveConfig

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

Formats the value using the given formatter.

impl Hash for BestEffortLiveConfig

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BestEffortLiveConfig

fn eq(&self, other: &BestEffortLiveConfig) -> 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 Copy for BestEffortLiveConfig

impl Eq for BestEffortLiveConfig

impl StructuralPartialEq for BestEffortLiveConfig