Enum CacheControl 

#[non_exhaustive]
pub enum CacheControl {
    Ephemeral,
    EphemeralWithTtl(Duration),
}

Cache breakpoint placed on a content block, system prompt block, or tool definition. Providers that support prompt caching (Anthropic today) read these to decide which prefix is cacheable and at what TTL; providers without explicit caching ignore the field. The presence of cache_control only declares intent — the actual cache hit/miss is reported via crate::Usage::cached_input_tokens and the cache-creation counters.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Ephemeral

Ephemeral cache with the provider’s default TTL (5 minutes on Anthropic). Equivalent to omitting ttl on the wire.

EphemeralWithTtl(Duration)

Ephemeral cache with an explicit TTL. Anthropic accepts only 5m and 1h; the adapter rounds to the nearest supported value and warns if neither fits cleanly.

Trait Implementations

impl Clone for CacheControl

fn clone(&self) -> CacheControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheControl

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

Formats the value using the given formatter.

impl PartialEq for CacheControl

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

impl StructuralPartialEq for CacheControl