Struct MemoryItem 

pub struct MemoryItem {
    pub id: MemoryId,
    pub agent_id: AgentId,
    pub content: String,
    pub importance: f32,
    pub timestamp: DateTime<Utc>,
    pub tags: Vec<String>,
    pub recall_count: u64,
}

A single memory record stored for an agent.

Fields

id: MemoryId

Unique identifier for this memory.

agent_id: AgentId

The agent this memory belongs to.

content: String

Textual content of the memory.

importance: f32

Importance score in [0.0, 1.0]. Higher = more important.

timestamp: DateTime<Utc>

UTC timestamp when this memory was recorded.

tags: Vec<String>

Searchable tags attached to this memory.

recall_count: u64

Number of times this memory has been recalled. Updated in-place by recall.

Implementations

impl MemoryItem

pub fn new( agent_id: AgentId, content: impl Into<String>, importance: f32, tags: Vec<String>, ) -> Self

Construct a new MemoryItem with the current timestamp and a random ID.

pub fn age_hours(&self) -> f64

Return the age of this memory in fractional hours since it was recorded.

Returns 0.0 if the current time is somehow before timestamp.

pub fn has_tag(&self, tag: &str) -> bool

Return true if this memory item has the given tag.

pub fn word_count(&self) -> usize

Return the approximate number of whitespace-separated words in the content.

pub fn content_len(&self) -> usize

Return the byte length of the content string.

pub fn tag_count(&self) -> usize

Return the number of tags attached to this memory item.

pub fn add_tag(&mut self, tag: impl Into<String>) -> bool

Add tag to this memory item if it is not already present.

Returns true if the tag was newly added, false if it was already present.

pub fn remove_tag(&mut self, tag: &str) -> bool

Remove tag from this memory item.

Returns true if the tag was found and removed, false if it was not present.

pub fn is_high_importance(&self, threshold: f32) -> bool

Return true if this item’s importance score is strictly above threshold.

Useful for filtering a collection to retain only high-value memories:

let important: Vec<_> = items.iter().filter(|m| m.is_high_importance(0.7)).collect();

Trait Implementations

impl Clone for MemoryItem

fn clone(&self) -> MemoryItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MemoryItem

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

Formats the value using the given formatter.

impl Serialize for MemoryItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.