Struct AutomationMemory 

pub struct AutomationMemory {
    pub store: HashMap<String, Value>,
    pub extractions: Vec<Value>,
    pub visited_urls: Vec<String>,
    pub action_history: Vec<String>,
}

In-memory storage for agentic automation sessions.

This provides a key-value store and history tracking that persists across automation rounds, enabling the LLM to maintain context and state without relying on external storage.

Features

• Key-Value Store: Store and retrieve arbitrary JSON values by key
• Extraction History: Accumulate extracted data across pages
• URL History: Track visited URLs for navigation context
• Action Summary: Brief history of executed actions

Example

use spider_agent_types::AutomationMemory;

let mut memory = AutomationMemory::default();
memory.set("user_logged_in", serde_json::json!(true));
memory.set("cart_items", serde_json::json!(["item1", "item2"]));

// Memory is serialized and included in LLM context each round
let context = memory.to_context_string();

Fields

store: HashMap<String, Value>

Key-value store for persistent data across rounds.

extractions: Vec<Value>

History of extracted data from pages (most recent last).

visited_urls: Vec<String>

History of visited URLs (most recent last).

action_history: Vec<String>

Brief summary of recent actions (most recent last, max 50).

Implementations

impl AutomationMemory

pub fn new() -> Self

Create a new empty memory.

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

Store a value by key.

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

Get a value by key.

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

Remove a value by key.

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

Check if a key exists.

pub fn clear_store(&mut self)

Clear all stored data.

pub fn add_extraction(&mut self, data: Value)

Add an extracted value to history.

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

Record a visited URL.

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

Record an action summary (keeps max 50 entries).

pub fn clear_history(&mut self)

Clear all history (extractions, URLs, actions) but keep the store.

pub fn clear_all(&mut self)

Clear everything.

pub fn is_empty(&self) -> bool

Check if memory is empty.

pub fn to_context_string(&self) -> String

Generate a context string for inclusion in LLM prompts.

pub fn apply_operation(&mut self, op: &MemoryOperation)

Apply a memory operation.

pub fn apply_operations(&mut self, ops: &[MemoryOperation])

Apply multiple memory operations.

pub fn increment_level_attempt(&mut self, level_key: &str) -> u32

Increment and return attempt count for a logical level key.

Stored in store["_level_attempts"][level_key].

pub fn reset_level_attempt(&mut self, level_key: &str)

Reset attempt count for a logical level key (e.g., after forced refresh).

pub fn get_level_attempt(&self, level_key: &str) -> u32

Return attempt count for a logical level key.

Trait Implementations

impl Clone for AutomationMemory

fn clone(&self) -> AutomationMemory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AutomationMemory

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

Formats the value using the given formatter.

impl Default for AutomationMemory

fn default() -> AutomationMemory

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AutomationMemory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AutomationMemory

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

where __S: Serializer,

Serialize this value into the given Serde serializer.