Struct MemoryChunk 

pub struct MemoryChunk {

    pub id: String,
    pub created_at: DateTime<Utc>,
    pub kind: ChunkKind,
    pub tier: MemoryTier,
    pub source: ChunkSource,
    pub session_id: Option<String>,
    pub project_root: Option<String>,
    pub caller_id: String,
    pub content: String,
    pub metadata: Value,
    pub importance: f32,
    pub pinned: bool,
    pub shareable: bool,
    pub superseded_by: Option<String>,
    pub embedding_model: String,
    pub embedding_dim: u32,
}

A persisted memory unit.

Fields

id: String

Time-ordered ID. uuid v7 in v1.

created_at: DateTime<Utc>

When the chunk was written.

kind: ChunkKind

Discriminator for kind-specific handling and retrieval filtering.

tier: MemoryTier

Tier this chunk lives in: working (never persisted, so never seen here), session (recent), or long_term (aged out / summarized).

source: ChunkSource

Where the chunk came from.

session_id: Option<String>

Conversation or delegated-job grouping. None for ambient chunks like observations and rule firings.

project_root: Option<String>

Working directory or project this chunk is scoped to, if known.

caller_id: String

Normalised caller — for example "agent", "mcp:codex", "gateway", "policy", "perception", "system".

content: String

The human-readable text indexed by FTS and embedded.

metadata: Value

Kind-specific structured fields.

importance: f32

Importance score in [0, 1]. Drives eviction priority.

pinned: bool

If true, never auto-evicted regardless of importance or age.

shareable: bool

Cross-caller visibility flag. When true, the chunk surfaces to every caller whose query uses crate::CallerScope::OwnPlusShared (in addition to the writer’s own scope). When false (the default), the chunk is only visible to its writer under Own/OwnPlusShared and to privileged surfaces under Global. See crate::CallerScope for the full visibility model.

superseded_by: Option<String>

If non-None, the ID of a chunk that replaces this one (e.g. a correction supersedes the original mistake).

embedding_model: String

Name of the embedding model used (e.g. "bge-small-en-v1.5"). The v1 BasicMemoryProvider records "none" because it doesn’t embed.

embedding_dim: u32

Dimensionality of the embedding. 0 for the v1 stub.

Trait Implementations

impl Clone for MemoryChunk

fn clone(&self) -> MemoryChunk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryChunk

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryChunk

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MemoryChunk

fn eq(&self, other: &MemoryChunk) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MemoryChunk

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MemoryChunk