Enum CacheHint 

pub enum CacheHint {
    Always,
    UntilChanged,
    RecentlyChanged,
    SlidingPrefix {
        stable_fraction: f32,
    },
    Never,
}

Cache hint for a region or message boundary.

Variants

Always

Always cache - content never changes (pinned, system, tools, compact history).

UntilChanged

Cache until content hash changes (compacting regions between compaction events).

RecentlyChanged

Same cacheability as CacheHint::UntilChanged, and additionally marks the start of the most recently changed stretch of that tier.

A provider that spends one cache breakpoint per run of same-hint blocks sees the change of hint as a run boundary, so the blocks ahead of the mutation end up in a cache entry of their own instead of sharing one with the block that just changed. Nothing else about the block differs: assembly sorts it to the same position as UntilChanged, and its text is untouched.

SlidingPrefix

Cache the stable prefix of a sliding window. stable_fraction is 0.0..1.0 (default 0.75 = oldest 75% of messages are stable).

Fields

stable_fraction: f32

How much of the window counts as stable, in 0.0..1.0. The oldest that fraction is cached; the newest tail is not, because it is what changes every turn and would invalidate the whole prefix with it.

Never

Never cache (temporary, clearable, new messages).

Trait Implementations

impl Clone for CacheHint

fn clone(&self) -> CacheHint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheHint

impl Debug for CacheHint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheHint

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CacheHint

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CacheHint

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CacheHint