Struct ToolResultCache 

pub struct ToolResultCache { /* private fields */ }

In-memory, session-scoped cache for tool results.

Design

• ttl = None means entries never expire (useful for batch/scripted sessions).
• ttl = Some(d) means entries expire after duration d.
• Lazy eviction: expired entries are removed on get().
• No max-size cap: a session cache is bounded by session duration and interaction rate.
• Not Send + Sync by design — accessed only from the agent’s single-threaded loop.

Implementations

impl ToolResultCache

pub fn new(enabled: bool, ttl: Option<Duration>) -> Self

Create a new cache with the given TTL and enabled state.

ttl = None means entries never expire.

pub fn get(&mut self, key: &CacheKey) -> Option<ToolOutput>

Look up a cached result. Returns None on miss or if expired.

Expired entries are removed lazily on access.

pub fn put(&mut self, key: CacheKey, output: ToolOutput)

Store a tool result in the cache.

pub fn clear(&mut self)

Remove all entries and reset hit/miss counters.

pub fn len(&self) -> usize

Number of entries currently in the cache (including potentially expired ones).

pub fn is_empty(&self) -> bool

Returns true if the cache is empty.

pub fn hits(&self) -> u64

Total cache hits since last clear().

pub fn misses(&self) -> u64

Total cache misses since last clear().

pub fn is_enabled(&self) -> bool

Whether the cache is enabled.

pub fn ttl_secs(&self) -> u64

TTL in seconds for display (0 = never expire).

Trait Implementations

impl Debug for ToolResultCache

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

Formats the value using the given formatter.