Class: MemoryStore
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:238
Constructors
Constructor
new MemoryStore(
config):MemoryStore
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:261
Parameters
config
Returns
MemoryStore
Methods
getActiveTraceCount()
getActiveTraceCount():
number
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:941
Get active trace count.
Returns
number
getBrain()
getBrain():
Brain|null
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:282
Access the attached Brain for export/import operations. Returns null when no brain is attached (in-memory only mode).
Returns
Brain | null
getByScope()
getByScope(
scope,scopeId,type?):Promise<MemoryTrace[]>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:818
Get all traces for a scope (for consolidation pipeline).
Limitation: This primarily returns traces from the in-process cache. Traces that were persisted to the vector store in a prior process lifetime (or by another process) will only be returned if the cache is empty for this scope, in which case we fall back to querying the vector store with a zero-vector and metadata filter. The fallback is approximate (limited by topK) and does not guarantee completeness.
Parameters
scope
scopeId
string
type?
Returns
Promise<MemoryTrace[]>
getTrace()
getTrace(
traceId):MemoryTrace|undefined
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:927
Get a trace by ID.
Parameters
traceId
string
Returns
MemoryTrace | undefined
getTraceCount()
getTraceCount():
number
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:934
Get trace count.
Returns
number
listTraces()
listTraces(
options?):MemoryTrace[]
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:952
List cached traces for diagnostics and tooling.
Parameters
options?
activeOnly?
boolean
scope?
scopeId?
string
type?
Returns
persistTraceMetadata()
persistTraceMetadata(
traceId):Promise<void>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:884
Re-upsert a trace's metadata to the vector store using the cached
embedding. Used by consolidation when a mutation to the in-memory
trace (e.g. provenance.contradictedBy, provenance.lastVerifiedAt)
needs to survive a process restart without paying for re-embedding.
No-ops silently when the trace or its embedding is not cached; the
caller should getTrace first or accept that an uncached trace will
not be durably updated.
Parameters
traceId
string
Returns
Promise<void>
query()
query(
queryText,currentMood,options?):Promise<{partial:PartiallyRetrievedTrace[];scored:ScoredMemoryTrace[];timings: {scoringMs:number;vectorSearchMs:number; }; }>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:530
Query memory traces with cognitive scoring.
Parameters
queryText
string
currentMood
options?
CognitiveRetrievalOptions = {}
Returns
Promise<{ partial: PartiallyRetrievedTrace[]; scored: ScoredMemoryTrace[]; timings: { scoringMs: number; vectorSearchMs: number; }; }>
recordAccess()
recordAccess(
traceId):Promise<RetrievalUpdateResult|null>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:733
Record that a memory was accessed (retrieved). Updates decay parameters via spaced repetition.
Parameters
traceId
string
Returns
Promise<RetrievalUpdateResult | null>
setBrain()
setBrain(
brain):void
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:274
Attach a Brain for durable write-through persistence.
Once attached, all store/softDelete/recordAccess operations also
write to the brain's memory_traces table.
Parameters
brain
Brain instance (already initialized with schema)
Returns
void
softDelete()
softDelete(
traceId):Promise<void>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:907
Soft-delete a trace.
Parameters
traceId
string
Returns
Promise<void>
store()
store(
trace):Promise<void>
Defined in: packages/agentos/src/cognition/memory/retrieval/store/MemoryStore.ts:397
Store a new memory trace: embed content, upsert into vector store, and record as episodic memory in the knowledge graph.
Parameters
trace
Returns
Promise<void>