Enum CacheRetention 

pub enum CacheRetention {
    None,
    Short,
    Long,
}

Prompt-cache retention hint. Mirrors pi-ai’s CacheRetention.

Short is the default and matches OpenAI’s ~5-minute prefix cache TTL. Long requests the 24h retention tier (sent to OpenAI as prompt_cache_retention: "24h"). None opts out of provider-side prompt caching where applicable.

Variants

None

Short

Long

Implementations

impl CacheRetention

pub fn resolve(opt: Option<Self>) -> Self

Resolve an optional retention hint into a concrete value.

None falls back to Short. Pure: callers that want to honour the PI_CACHE_RETENTION=long env override should call Self::resolve_with_env instead.

pub fn resolve_with_env(opt: Option<Self>) -> Self

Resolve an optional retention hint, honouring PI_CACHE_RETENTION=long from the environment when opt is None.

Mirrors pi-ai’s resolveCacheRetention helper. An explicit Some(...) always wins over the env var.

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 Debug for CacheRetention

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

Formats the value using the given formatter.

impl Default for CacheRetention

fn default() -> Self

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 PartialEq for CacheRetention

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for CacheRetention

impl Eq for CacheRetention

impl StructuralPartialEq for CacheRetention