Struct PreparedMemorySnapshot 

pub struct PreparedMemorySnapshot {
    pub snapshot_id: SnapshotId,
    pub user_memory_revision: u64,
    pub session_overlay_revision: u64,
    pub retrieval_plan_id: Option<PlanId>,
    pub source_turn_id: TurnId,
    pub eligible_from_turn: TurnId,
    pub facts: Arc<[RetrievedMemory]>,
    pub token_count: u16,
    pub cache_key: String,
    pub created_at: DateTime<Utc>,
    pub expires_at: DateTime<Utc>,
}

An immutable, budgeted set of memories prepared for a turn.

Fields

snapshot_id: SnapshotId

Snapshot identity.

user_memory_revision: u64

Canonical repository revision the snapshot was built from.

session_overlay_revision: u64

Session overlay revision the snapshot was built from.

retrieval_plan_id: Option<PlanId>

The plan that produced it.

source_turn_id: TurnId

The turn whose transcript produced it.

eligible_from_turn: TurnId

The first turn it may be served to.

facts: Arc<[RetrievedMemory]>

The memories, in presentation order.

token_count: u16

Total estimated tokens.

cache_key: String

Cache key of the plan that produced it.

created_at: DateTime<Utc>

When it was prepared.

expires_at: DateTime<Utc>

When it stops being usable.

Implementations

impl PreparedMemorySnapshot

pub fn empty(turn_id: TurnId) -> Self

An empty snapshot for a turn.

pub fn is_empty(&self) -> bool

Whether the snapshot holds anything.

pub fn is_fresh(&self, now: DateTime<Utc>) -> bool

Whether the snapshot is still fresh at now.

pub fn satisfies(&self, query: &str, now: DateTime<Utc>) -> bool

Whether this snapshot answers the query the model actually asked with.

A prepared snapshot is speculative: it was built from the transcript, not from the tool arguments. When the model asks something the speculation did not anticipate, the caller falls back to a live search rather than answering the wrong question quickly.

pub fn to_tool_payload(&self) -> Value

The tool payload handed back to the model (§39.2).

Trait Implementations

impl Clone for PreparedMemorySnapshot

fn clone(&self) -> PreparedMemorySnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreparedMemorySnapshot

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

Formats the value using the given formatter.

impl Default for PreparedMemorySnapshot

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PreparedMemorySnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PreparedMemorySnapshot

fn eq(&self, other: &PreparedMemorySnapshot) -> 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 PreparedMemorySnapshot

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 PreparedMemorySnapshot