Class: MemoryStore

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:149

Constructors

Constructor

new MemoryStore(config): MemoryStore

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:168

Parameters

config

MemoryStoreConfig

Returns

MemoryStore

Methods

getActiveTraceCount()

getActiveTraceCount(): number

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:682

Get active trace count.

Returns

number

---

getBrain()

getBrain(): Brain | null

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:189

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/memory/retrieval/store/MemoryStore.ts:590

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

MemoryScope

scopeId

string

type?

MemoryType

Returns

Promise<MemoryTrace[]>

---

getTrace()

getTrace(traceId): MemoryTrace | undefined

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:668

Get a trace by ID.

Parameters

traceId

string

Returns

MemoryTrace | undefined

---

getTraceCount()

getTraceCount(): number

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:675

Get trace count.

Returns

number

---

listTraces()

listTraces(options?): MemoryTrace[]

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:693

List cached traces for diagnostics and tooling.

Parameters

options?

activeOnly?

boolean

scope?

MemoryScope

scopeId?

string

type?

MemoryType

Returns

MemoryTrace[]

---

query()

query(queryText, currentMood, options?): Promise<{ partial: PartiallyRetrievedTrace[]; scored: ScoredMemoryTrace[]; timings: { scoringMs: number; vectorSearchMs: number; }; }>

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:326

Query memory traces with cognitive scoring.

Parameters

queryText

string

currentMood

PADState

options?

CognitiveRetrievalOptions = {}

Returns

Promise<{ partial: PartiallyRetrievedTrace[]; scored: ScoredMemoryTrace[]; timings: { scoringMs: number; vectorSearchMs: number; }; }>

---

recordAccess()

recordAccess(traceId): Promise<RetrievalUpdateResult | null>

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:513

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/memory/retrieval/store/MemoryStore.ts:181

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

Brain instance (already initialized with schema)

Returns

void

---

softDelete()

softDelete(traceId): Promise<void>

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:648

Soft-delete a trace.

Parameters

traceId

string

Returns

Promise<void>

---

store()

store(trace): Promise<void>

Defined in: packages/agentos/src/memory/retrieval/store/MemoryStore.ts:201

Store a new memory trace: embed content, upsert into vector store, and record as episodic memory in the knowledge graph.

Parameters

trace

MemoryTrace

Returns

Promise<void>