Struct SemanticEntry 

pub struct SemanticEntry {
    pub id: VectorId,
    pub query: String,
    pub embedding: Embedding,
    pub result: Value,
    pub created_at: Instant,
    pub ttl: Duration,
    pub access_count: u64,
    pub branch_context: Option<BranchContext>,
    pub session_id: Option<String>,
    pub workload: AIWorkloadContext,
    pub tables: Vec<String>,
}

Semantic query entry with branch and session awareness

Fields

id: VectorId

Entry ID

query: String

Original query

embedding: Embedding

Query embedding

result: Value

Cached result

created_at: Instant

Creation time

ttl: Duration

TTL

access_count: u64

Access count

branch_context: Option<BranchContext>

Branch context (for branch-aware caching)

session_id: Option<String>

Session ID (for agent conversation affinity)

workload: AIWorkloadContext

AI workload type

tables: Vec<String>

Tables referenced by this query (for invalidation)

Implementations

impl SemanticEntry

pub fn new( id: VectorId, query: impl Into<String>, embedding: Embedding, result: Value, ) -> Self

Create a new semantic entry

pub fn with_ttl(self, ttl: Duration) -> Self

Set TTL

pub fn with_branch(self, branch: BranchContext) -> Self

Set branch context

pub fn with_session(self, session: impl Into<String>) -> Self

Set session ID for agent affinity

pub fn with_workload(self, workload: AIWorkloadContext) -> Self

Set AI workload context

pub fn with_tables(self, tables: Vec<String>) -> Self

Set referenced tables for invalidation tracking

pub fn workload_ttl(&self) -> Duration

Get workload-adjusted TTL

pub fn is_expired(&self) -> bool

Check if expired (considering workload-adjusted TTL)

pub fn matches_branch(&self, query_branch: &BranchContext) -> bool

Check if entry matches branch context

pub fn matches_session(&self, session: &String) -> bool

Check if entry belongs to session

pub fn size(&self) -> usize

Approximate size in bytes

Trait Implementations

impl Clone for SemanticEntry

fn clone(&self) -> SemanticEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticEntry

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

Formats the value using the given formatter.