symfonic.memory.models.entry

entry

MemoryEntry and CandidateNode models.

MemoryEntry is the primary data unit flowing through retrieval and compaction. CandidateNode is the intermediate normalization model used by RetrievalEngine to unify vector and graph results before scoring.

CandidateNode

Bases: BaseModel

Intermediate model normalizing vector and graph results before scoring.

The RetrievalEngine converts all candidate results (whether from vector search or graph traversal) into CandidateNode instances. Hits without a graph node get a synthetic MemoryNode with access_count=0 and graph_proximity=0.0.

MemoryEntry

Bases: BaseModel

A memory entry returned from retrieval or submitted for writing.

Represents a single piece of information from any memory layer, optionally linked to a graph node and carrying a retrieval score.