Struct MemoryCard 

pub struct MemoryCard {

    pub id: u64,
    pub kind: MemoryKind,
    pub entity: String,
    pub slot: String,
    pub value: String,
    pub polarity: Option<Polarity>,
    pub event_date: Option<i64>,
    pub document_date: Option<i64>,
    pub version_key: Option<String>,
    pub version_relation: VersionRelation,
    pub source_frame_id: u64,
    pub source_uri: Option<String>,
    pub source_offset: Option<(usize, usize)>,
    pub engine: String,
    pub engine_version: String,
    pub confidence: Option<f32>,
    pub created_at: i64,
}

Re-exports of the memvid-core memory-card surface that MemvidStore returns from MemvidStore::entity_memories and friends. Re-exported here so callers do not need a direct memvid-core dependency just to name the structured-memory types. A structured memory unit extracted from conversation content.

Memory cards represent atomic facts, preferences, events, or other information extracted from raw text. They support:

• Identity: What entity/slot this card describes
• Value: The actual information
• Temporality: When this was true (event time) vs when recorded (document time)
• Provenance: Which frame/chunk it came from, which engine extracted it
• Versioning: How this card relates to prior knowledge

Fields

id: u64

Unique identifier within this MV2 file.

kind: MemoryKind

What kind of memory this represents.

entity: String

The entity this memory is about (e.g., “user”, “user.team”, “project.memvid”).

slot: String

The attribute/slot being described (e.g., “employer”, “favorite_food”, “location”).

value: String

The actual value (always stored as string, can be JSON for complex values).

polarity: Option<Polarity>

Sentiment/polarity for preferences.

event_date: Option<i64>

When the event/fact occurred (not when it was recorded). For events: the event date. For facts: when this became true (if known).

document_date: Option<i64>

When this information was recorded (from the source document/conversation).

version_key: Option<String>

Versioning: key to group related cards (usually entity:slot).

version_relation: VersionRelation

How this relates to prior versions.

source_frame_id: u64

Reference to the source frame this was extracted from.

source_uri: Option<String>

URI of the source (for provenance).

source_offset: Option<(usize, usize)>

Character offset within source frame (start, end) for highlighting.

engine: String

Which engine produced this card.

engine_version: String

Version of the engine.

confidence: Option<f32>

Confidence score (0.0-1.0) if from probabilistic engine.

created_at: i64

When this card was created (Unix timestamp).

Implementations

impl MemoryCard

pub fn default_version_key(&self) -> String

Generate the default version key from entity and slot.

pub fn supersedes(&self, other: &MemoryCard) -> bool

Check if this card supersedes another based on version relation and timestamps.

pub fn effective_timestamp(&self) -> i64

Get the effective timestamp for temporal ordering.

pub fn is_retracted(&self) -> bool

Check if this card is a retraction.

Trait Implementations

impl Clone for MemoryCard

fn clone(&self) -> MemoryCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryCard

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryCard

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoryCard

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.