Struct CacheControlProfile 

pub struct CacheControlProfile {
    pub prompt_caching: bool,
    pub cache_breakpoint_style: String,
    pub min_useful_prefix_tokens: Option<u32>,
    pub ttl_notes: Option<String>,
    pub cache_read_usage_field: String,
    pub cache_write_usage_field: String,
}

Cache-control requirements for a (provider, model) route, derived from the single provider capability path. This is the self-describing capability the issue asks Harn to expose: cache-control strategy, minimum useful prefix, TTL notes, and the usage-field mapping — one source, no per-call-site provider branching.

Fields

prompt_caching: bool

Whether the route reports prompt-cache accounting at all (Capabilities::prompt_caching).

cache_breakpoint_style: String

Request-side cache breakpoint strategy: none, top_level, or last_block (Capabilities::cache_breakpoint_style).

min_useful_prefix_tokens: Option<u32>

Minimum prompt-prefix tokens below which a provider will not create or serve a cache entry, so a zero cache-read on a short prefix is expected rather than a miss. None when the route reports no cache accounting.

ttl_notes: Option<String>

Human-readable cache time-to-live / eviction notes for the route. None when the route reports no cache accounting.

cache_read_usage_field: String

Provider response usage field that carries cache-read (served-from-cache) prompt tokens, in dotted path form. Empty when the route reports none.

cache_write_usage_field: String

Provider response usage field that carries cache-write (cache-creation) prompt tokens, in dotted path form. Empty when the route neither reports nor bills a separate cache-write field (OpenAI-style automatic caching).

Implementations

impl CacheControlProfile

pub fn from_capabilities(caps: &Capabilities) -> Self

Derive the cache-control profile from resolved Capabilities. Minimum prefix, TTL notes, and the usage-field mapping are wire-dialect facts, so they live here keyed off the one capability path rather than duplicated per model row or per call site.

Trait Implementations

impl Clone for CacheControlProfile

fn clone(&self) -> CacheControlProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheControlProfile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheControlProfile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CacheControlProfile

impl PartialEq for CacheControlProfile

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

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 CacheControlProfile