Struct UsageLimitConfig 

pub struct UsageLimitConfig {
    pub enabled: bool,
    pub resume_message: String,
    pub max_wait_secs: u64,
    pub default_fallback_secs: u64,
    pub jitter_secs: u64,
    pub max_attempts: u32,
    pub providers: HashMap<String, UsageLimitProviderOverride>,
}

Top-level [usage_limits] config block. Loaded from zag.toml.

Fields

enabled: bool

Master switch. Detection always runs; this gates auto-resume scheduling.

resume_message: String

Message injected into the session when the timer fires. Default "Continue".

max_wait_secs: u64

Hard cap on how long a single wait can be. Default 24h.

default_fallback_secs: u64

Used when the provider didn’t tell us a reset time. Default 1h. On self-retrigger (resume failed because limit still active), the cycle just runs again — eventually the window passes.

jitter_secs: u64

Jitter added on top of the computed reset time, to spread retries. Default 30s.

max_attempts: u32

Maximum auto-resume attempts within a single foreground zag exec or zag spawn invocation. Default 12 — with the default 1h fallback this caps a stuck batch at ~12h. Set to 0 to disable the cap.

providers: HashMap<String, UsageLimitProviderOverride>

Per-provider overrides keyed by provider name.

Implementations

impl UsageLimitConfig

pub fn enabled_for(&self, provider: &str) -> bool

True if auto-resume should be attempted for provider.

pub fn resume_message_for(&self, provider: &str) -> &str

Effective resume message for provider, honoring overrides.

pub fn fallback_secs_for(&self, provider: &str) -> u64

Effective fallback duration (seconds) for provider.

pub fn extra_patterns_for(&self, provider: &str) -> &[String]

User-supplied additional patterns for provider, empty slice if none.

Trait Implementations

impl Clone for UsageLimitConfig

fn clone(&self) -> UsageLimitConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageLimitConfig

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

Formats the value using the given formatter.

impl Default for UsageLimitConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UsageLimitConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UsageLimitConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.