Struct AgentMemory 

pub struct AgentMemory { /* private fields */ }

Session memory for storing state across operations.

Uses DashMap internally for lock-free concurrent reads and writes. This is optimal for high-concurrency scenarios.

Example

use spider_agent::AgentMemory;

let memory = AgentMemory::new();

// Key-value storage
memory.set("user_id", serde_json::json!("12345"));

// URL tracking
memory.add_visited_url("https://example.com");

// Action history
memory.add_action("Searched for 'rust frameworks'");

// Extraction history
memory.add_extraction(serde_json::json!({"title": "Example"}));

// Generate context for LLM
let context = memory.to_context_string();

Implementations

impl AgentMemory

pub fn new() -> Self

Create a new empty memory.

pub fn with_capacity(capacity: usize) -> Self

Create memory with pre-allocated capacity.

pub fn get(&self, key: &str) -> Option<Value>

Get a value from memory.

Returns a clone of the value to avoid holding refs across await points.

pub fn set(&self, key: impl Into<String>, value: Value)

Set a value in memory.

pub fn remove(&self, key: &str) -> Option<Value>

Remove a value from memory.

pub fn clear(&self)

Clear all key-value data.

pub fn contains(&self, key: &str) -> bool

Check if memory contains a key.

pub fn len(&self) -> usize

Get number of key-value entries.

pub fn is_empty(&self) -> bool

Check if key-value store is empty.

pub fn get_as<T: for<'de> Deserialize<'de>>(&self, key: &str) -> Option<T>

Get a typed value from memory.

pub fn set_value<T: Serialize>(&self, key: impl Into<String>, value: &T)

Set a typed value in memory.

pub fn update<F>(&self, key: impl Into<String>, f: F)

where F: FnOnce(Option<&Value>) -> Value,

Update a value atomically using a closure.

The closure receives the current value (if any) and returns the new value.

pub fn get_or_insert(&self, key: impl Into<String>, default: Value) -> Value

Get or insert a value.

pub fn add_visited_url(&self, url: impl Into<String>)

Record a visited URL.

Keeps the most recent URLs up to the limit.

pub fn visited_urls(&self) -> Vec<String>

Get the list of visited URLs.

pub fn recent_urls(&self, n: usize) -> Vec<String>

Get the last N visited URLs.

pub fn has_visited(&self, url: &str) -> bool

Check if a URL has been visited.

pub fn clear_urls(&self)

Clear URL history.

pub fn add_action(&self, action: impl Into<String>)

Record an action summary.

Keeps the most recent actions up to the limit.

pub fn action_history(&self) -> Vec<String>

Get the list of actions.

pub fn recent_actions(&self, n: usize) -> Vec<String>

Get the last N actions.

pub fn clear_actions(&self)

Clear action history.

pub fn add_extraction(&self, data: Value)

Add an extracted value to history.

Keeps the most recent extractions up to the limit.

pub fn extractions(&self) -> Vec<Value>

Get all extractions.

pub fn recent_extractions(&self, n: usize) -> Vec<Value>

Get the last N extractions.

pub fn clear_extractions(&self)

Clear extraction history.

pub fn clear_history(&self)

Clear all history (URLs, actions, extractions) but keep key-value store.

pub fn clear_all(&self)

Clear everything including key-value store and all history.

pub fn is_all_empty(&self) -> bool

Check if all memory is empty (store + all history).

pub fn to_context_string(&self) -> String

Generate a context string for inclusion in LLM prompts.

This provides the LLM with session context including:

• Key-value store contents
• Recent URLs visited
• Recent actions taken
• Recent extractions

Trait Implementations

impl Clone for AgentMemory

fn clone(&self) -> AgentMemory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentMemory

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

Formats the value using the given formatter.

impl Default for AgentMemory

fn default() -> AgentMemory

Returns the “default value” for a type.