Enum PeriodEnd 

pub enum PeriodEnd {
    NothingCached,
    UncachedInput {
        input: u64,
        prefix: u64,
    },
    BoundReached {
        ledger_usd: f64,
        bound_usd: f64,
    },
    PingTooExpensive {
        worst_usd: f64,
        bound_usd: f64,
    },
    HoursReached(u32),
    Expired {
        age_secs: u64,
    },
    PrefixChanged,
    ContextRollover(String),
    CacheMiss {
        written: u64,
    },
    PartialMiss {
        written: u64,
        prefix: u64,
    },
    Rejected(String),
    TransientExhausted(String),
    CostCap {
        cap: f64,
    },
    TurnStarted,
    Compaction,
    Disabled,
    ParkedByRequest,
    SessionEnding,
    Blocked(&'static str),
}

Why a period ended (or never started). Logged once, shown by /keepwarm status.

Variants

NothingCached

The last request (or a ping) cached nothing: the prefix is below the model’s cache minimum, or caching is off for it.

UncachedInput

A ping paid for a large uncached share of the prefix.

Fields

input: u64

prefix: u64

BoundReached

Ski-rental bound: the next worst-case ping would push the ledger past the rewrite it prevents.

Fields

ledger_usd: f64

bound_usd: f64

PingTooExpensive

Not even one worst-case ping fits the bound (budgeted thinking on a small prefix).

Fields

worst_usd: f64

bound_usd: f64

HoursReached(u32)

<N>h window elapsed.

Expired

The cache is (nearly) expired: the machine slept, or the session went idle too late. A ping now would be a full write.

Fields

age_secs: u64

PrefixChanged

The next turn’s prefix is no longer what is cached.

ContextRollover(String)

The next turn would roll the context over / hard-stop before its first request: what is cached is not what it sends.

CacheMiss

A ping wrote the prefix instead of reading it.

Fields

written: u64

PartialMiss

A ping rewrote a large share of the prefix (partial miss).

Fields

written: u64

prefix: u64

Rejected(String)

4xx / auth / configuration: never retried.

TransientExhausted(String)

Transient errors outlasted the backoff (or the TTL).

CostCap

max_session_cost reached (or the next ping would cross it if it missed the cache and rewrote the whole prefix).

Fields

cap: f64

TurnStarted

Compaction

Disabled

/keepwarm off.

ParkedByRequest

An explicit park request (not the idle auto-park, which waits).

SessionEnding

Blocked(&'static str)

Something else owns the session (driver, queued work, prompt).

Trait Implementations

impl Clone for PeriodEnd

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 PeriodEnd

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

Formats the value using the given formatter.

impl Display for PeriodEnd

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

Formats the value using the given formatter.

impl PartialEq for PeriodEnd

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PeriodEnd