Interface: ICognitiveMemoryManager

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:97

Methods

assembleForPrompt()

assembleForPrompt(query, tokenBudget, mood, options?): Promise<AssembledMemoryContext>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:124

Assemble memory context for prompt injection within a token budget.

Parameters

query

string

tokenBudget

number

mood

PADState

options?

CognitiveRetrievalOptions

Returns

Promise<AssembledMemoryContext>

---

checkProspective()?

optional checkProspective(context): Promise<ProspectiveMemoryItem[]>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:139

Check prospective memory triggers (Batch 2).

Parameters

context

events?

string[]

now?

number

queryEmbedding?

number[]

queryText?

string

Returns

Promise<ProspectiveMemoryItem[]>

---

encode()

encode(input, mood, gmiMood, options?): Promise<MemoryTrace>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:101

Encode a new input into a memory trace. Called after each user message.

Parameters

input

string

mood

PADState

gmiMood

string

options?

contentSentiment?

number

entities?

string[]

scope?

MemoryScope

scopeId?

string

sourceType?

MemorySourceType

tags?

string[]

type?

MemoryType

Returns

Promise<MemoryTrace>

---

flushReflection()

flushReflection(mood?, scopeOverride?): Promise<FlushReflectionResult>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:204

Step-8: Force the memory reflector to run over any pending observation notes regardless of accumulated-token threshold. Encoded reflection traces land in the memory store; superseded trace IDs are soft-deleted. Returns the IDs so callers can apply side effects (e.g. BM25 indexing).

Parameters

mood?

PADState

Optional mood override passed to each encoded trace.

scopeOverride?

When set, overrides the scope + scopeId on every reflection-derived trace before encoding. Needed when the caller (e.g. bench adapter) needs all reflection traces to land in the same scope the retrieval path queries, regardless of what the reflector LLM invented.

scope

MemoryScope

scopeId

string

Returns

Promise<FlushReflectionResult>

---

getConfig()

getConfig(): CognitiveMemoryConfig

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:180

Get the resolved cognitive-memory runtime config.

Returns

CognitiveMemoryConfig

---

getContextTransparencyReport()

getContextTransparencyReport(): string | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:233

Get a human-readable compaction/transparency report when enabled.

Returns

string | null

---

getContextWindowStats()

getContextWindowStats(): ContextWindowStats | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:230

Get infinite-context runtime stats when enabled.

Returns

ContextWindowStats | null

---

getGraph()

getGraph(): IMemoryGraph | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:183

Get graph module when enabled.

Returns

IMemoryGraph | null

---

getHydeRetriever()?

optional getHydeRetriever(): HydeRetriever | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:219

Get the HyDE retriever if configured, or null.

Returns

HydeRetriever | null

---

getMemoryHealth()

getMemoryHealth(): Promise<MemoryHealthReport>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:163

Get memory health diagnostics.

Returns

Promise<MemoryHealthReport>

---

getObserver()

getObserver(): MemoryObserver | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:186

Get observer module when enabled.

Returns

MemoryObserver | null

---

getProspective()

getProspective(): ProspectiveMemoryManager | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:210

Get prospective-memory manager when enabled.

Returns

ProspectiveMemoryManager | null

---

getReflector()

getReflector(): MemoryReflector | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:189

Get the memory reflector if configured, or null.

Returns

MemoryReflector | null

---

getRerankerService()?

optional getRerankerService(): RerankerService | null

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:227

Get the attached neural reranker, or null when none is configured. Step 3 uses this so the bench-side HybridRetriever can plumb the manager's reranker into the per-case retriever without bracket-accessing a private field.

Returns

RerankerService | null

---

getStore()

getStore(): MemoryStore

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:166

Access the underlying long-term memory store for diagnostics/devtools.

Returns

MemoryStore

---

getTraceCount()

getTraceCount(): number

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:174

Total number of memory traces currently resident in the manager's in-memory trace cache. Ergonomic passthrough to MemoryStore.getTraceCount; used by agentos-bench for memory-footprint telemetry.

Returns

number

---

getWorkingMemory()

getWorkingMemory(): CognitiveWorkingMemory

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:177

Access the working-memory model for diagnostics/devtools.

Returns

CognitiveWorkingMemory

---

initialize()

initialize(config): Promise<void>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:98

Parameters

config

CognitiveMemoryConfig

Returns

Promise<void>

---

listProspective()?

optional listProspective(): Promise<ProspectiveMemoryItem[]>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:154

List active prospective reminders.

Returns

Promise<ProspectiveMemoryItem[]>

---

observe()?

optional observe(role, content, mood?): Promise<ObservationNote[] | null>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:132

Feed a message to the observer (Batch 2). Returns notes if threshold reached.

Parameters

role

"user" | "tool" | "system" | "assistant"

content

string

mood?

PADState

Returns

Promise<ObservationNote[] | null>

---

registerProspective()?

optional registerProspective(input): Promise<ProspectiveMemoryItem>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:147

Register a new prospective reminder/intention.

Parameters

input

Omit<ProspectiveMemoryItem, "id" | "createdAt" | "triggered" | "cueEmbedding"> & object

Returns

Promise<ProspectiveMemoryItem>

---

rehydrate()?

optional rehydrate(traceId, requestContext?): Promise<string | null>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:244

Return the verbatim content that was archived when this trace was consolidated, or null if the trace is not gisted/archived or the archive is unreachable.

Parameters

traceId

string

The trace id to rehydrate.

requestContext?

string

Optional caller hint for audit.

Returns

Promise<string | null>

The original verbatim content, or null.

---

removeProspective()?

optional removeProspective(id): Promise<boolean>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:157

Remove a prospective reminder.

Parameters

id

string

Returns

Promise<boolean>

---

retrieve()

retrieve(query, mood, options?): Promise<CognitiveRetrievalResult>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:117

Retrieve relevant memories for a query. Called before prompt construction.

Parameters

query

string

mood

PADState

options?

CognitiveRetrievalOptions

Returns

Promise<CognitiveRetrievalResult>

---

runConsolidation()?

optional runConsolidation(): Promise<ConsolidationResult>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:160

Run consolidation cycle (Batch 2).

Returns

Promise<ConsolidationResult>

---

setHydeRetriever()?

optional setHydeRetriever(retriever): void

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:216

Attach a HyDE retriever for hypothesis-driven memory recall. Pass null to disable.

Parameters

retriever

HydeRetriever | null

Returns

void

---

shutdown()

shutdown(): Promise<void>

Defined in: packages/agentos/src/memory/CognitiveMemoryManager.ts:247

Shutdown and release resources.

Returns

Promise<void>