Struct FixedPointResidentGraphCache 

pub struct FixedPointResidentGraphCache { /* private fields */ }

Backend-resident graph cache keyed by backend identity and normalized graph layout.

Implementations

impl FixedPointResidentGraphCache

pub fn new() -> Self

Create an empty resident graph cache.

pub fn with_max_retained_bytes(max_retained_bytes: usize) -> Self

Create a resident graph cache with a soft upper bound on retained bytes.

The newest graph is always retained so one oversized graph may exceed the limit; older least-recently-used entries are evicted first.

pub fn get_or_upload( &mut self, backend: &dyn VyreBackend, graph: &FixedPointForwardGraph, ) -> Result<&FixedPointResidentGraph, BackendError>

Return a resident graph for graph, uploading it only on a cache miss.

pub fn len(&self) -> usize

Number of resident graph entries retained by the cache.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

pub fn stats(&self) -> FixedPointResidentGraphCacheStats

Return point-in-time resident graph cache counters.

pub fn resident_identities(&self) -> Vec<ResidentGraphCacheIdentity>

Deterministic cache identity snapshot for diagnostics and release evidence.

pub fn miss_reason_for_identity( &self, requested: &ResidentGraphCacheIdentity, ) -> ResidentGraphCacheMissReason

Explain why requested would miss the current resident graph cache.

pub const fn last_miss_reason(&self) -> Option<ResidentGraphCacheMissReason>

Reason attached to the most recent cache miss. Hits clear this field.

pub fn free_all( &mut self, backend: &dyn VyreBackend, ) -> Result<(), BackendError>

Free every resident graph owned by this cache.

Trait Implementations

impl Clone for FixedPointResidentGraphCache

fn clone(&self) -> FixedPointResidentGraphCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FixedPointResidentGraphCache

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

Formats the value using the given formatter.

impl Default for FixedPointResidentGraphCache

fn default() -> FixedPointResidentGraphCache

Returns the “default value” for a type.

impl PartialEq for FixedPointResidentGraphCache

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FixedPointResidentGraphCache