Struct WorkingMemory 

pub struct WorkingMemory { /* private fields */ }

A bounded, key-value working memory for transient agent state.

When capacity is exceeded, the oldest entry (by insertion order) is evicted.

Guarantees

• Thread-safe via Arc<Mutex<_>>
• Bounded: never exceeds capacity entries
• Deterministic eviction: LRU (oldest insertion first)

Implementations

impl WorkingMemory

pub fn new(capacity: usize) -> Result<Self, AgentRuntimeError>

Create a new WorkingMemory with the given capacity.

Returns

• Ok(WorkingMemory) — on success
• Err(AgentRuntimeError::Memory) — if capacity == 0

pub fn set( &self, key: impl Into<String> + Debug, value: impl Into<String> + Debug, ) -> Result<(), AgentRuntimeError>

Insert or update a key-value pair, evicting the oldest entry if over capacity.

pub fn get(&self, key: &str) -> Result<Option<String>, AgentRuntimeError>

Retrieve a value by key.

Returns

• Some(value) — if the key exists
• None — if not found

pub fn clear(&self) -> Result<(), AgentRuntimeError>

Remove all entries from working memory.

pub fn len(&self) -> Result<usize, AgentRuntimeError>

Return the current number of entries.

pub fn is_empty(&self) -> Result<bool, AgentRuntimeError>

Return true if no entries are stored.

pub fn iter(&self) -> Result<Vec<(String, String)>, AgentRuntimeError>

Iterate over all key-value pairs in insertion order.

Equivalent to entries; provided as a more idiomatic name for for-loop patterns.

pub fn entries(&self) -> Result<Vec<(String, String)>, AgentRuntimeError>

Return all key-value pairs in insertion order.

Trait Implementations

impl Clone for WorkingMemory

fn clone(&self) -> WorkingMemory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkingMemory

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

Formats the value using the given formatter.