Struct Memory 

pub struct Memory {

    pub id: Option<RecordId>,
    pub content: String,
    pub embedding: Option<Vec<f32>>,
    pub scope: MemoryScope,
    pub memory_type: MemoryType,
    pub user_id: Option<String>,
    pub session_id: Option<String>,
    pub agent_id: Option<String>,
    pub task_stream_id: Option<RecordId>,
    pub categories: Vec<String>,
    pub metadata: Option<Value>,
    pub token_count: Option<u32>,
    pub importance: f32,
    pub access_count: u32,
    pub last_accessed_at: Option<Datetime>,
    pub valid_until: Option<Datetime>,
    pub version: u32,
    pub created_at: Datetime,
    pub updated_at: Datetime,
}

A single memory unit — the core data structure for the mem0-compatible layer. All optional fields default to None for migration safety.

Fields

id: Option<RecordId>

content: String

The raw content of the memory.

embedding: Option<Vec<f32>>

Vector embedding of content using the active embedding provider dimensions.

scope: MemoryScope

Scoping level — determines who can retrieve this memory.

memory_type: MemoryType

Cognitive type — influences search ranking and decay strategy.

user_id: Option<String>

Optional user identifier for user-scoped memories.

session_id: Option<String>

Optional session identifier for session-scoped memories.

agent_id: Option<String>

Optional agent identifier for agent-scoped memories.

task_stream_id: Option<RecordId>

Optional TaskStream this memory belongs to.

categories: Vec<String>

Taxonomy tags — mem0-compatible categories.

metadata: Option<Value>

Arbitrary JSON metadata.

token_count: Option<u32>

Estimated token count of content (used for context budgeting).

importance: f32

Importance score 0.0–1.0. Higher = surfaces first in context windows.

access_count: u32

Number of times this memory has been accessed.

last_accessed_at: Option<Datetime>

Last time this memory was returned in a search result.

valid_until: Option<Datetime>

Optional TTL — memory is considered expired after this timestamp.

version: u32

Incremented on every update; used for history tracking.

created_at: Datetime

updated_at: Datetime

Implementations

impl Memory

pub fn new( content: impl Into<String>, user_id: Option<String>, agent_id: Option<String>, session_id: Option<String>, categories: Vec<String>, ) -> Memory

Trait Implementations

impl Clone for Memory

fn clone(&self) -> Memory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Memory

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Memory

fn deserialize<__D>( __deserializer: __D, ) -> Result<Memory, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Memory

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SurrealValue for Memory

fn into_value(self) -> Value

Converts this type into a SurrealDB value

fn from_value(value: Value) -> Result<Memory, Error>

Attempts to convert a SurrealDB value into this type

fn is_value(value: &Value) -> bool

Checks if the given value can be converted to this type

fn kind_of() -> Kind

Returns the kind that represents this type

impl TryFrom<DbMemory> for Memory

type Error = Error

The type returned in the event of a conversion error.

fn try_from(memory: DbMemory) -> Result<Memory, Error>

Performs the conversion.