Enum CacheRetention 

pub enum CacheRetention {
    None,
    Short,
    Long,
}

Prompt-cache lifetime hint. Providers translate this into their own wire dialect (Anthropic and OpenRouter Claude/Gemini cache_control, OpenAI Responses and Codex prompt_cache_key, and OpenAI prompt_cache_retention). Providers without a cache-control concept, such as direct Google, read the value but emit nothing for it.

Variants

None

Do not emit any prompt-cache hints.

Short

Default Anthropic ephemeral window (5 minutes).

Long

Extend to a 1-hour TTL where the API supports it.

Implementations

impl CacheRetention

pub fn is_default(&self) -> bool

Trait Implementations

impl Clone for CacheRetention

fn clone(&self) -> CacheRetention

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheRetention

impl Debug for CacheRetention

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

Formats the value using the given formatter.

impl Default for CacheRetention

fn default() -> CacheRetention

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CacheRetention

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CacheRetention

impl PartialEq for CacheRetention

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CacheRetention

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 CacheRetention