Class: CognitiveMemoryManager

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

Implements

• ICognitiveMemoryManager

Constructors

Constructor

new CognitiveMemoryManager(): CognitiveMemoryManager

Returns

CognitiveMemoryManager

Methods

assembleForPrompt()

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

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

Assemble memory context for prompt injection within a token budget.

Parameters

query

string

tokenBudget

number

mood

PADState

options?

CognitiveRetrievalOptions = {}

Returns

Promise<AssembledMemoryContext>

Implementation of

ICognitiveMemoryManager.assembleForPrompt

---

checkProspective()

checkProspective(context): Promise<ProspectiveMemoryItem[]>

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

Check prospective memory triggers (Batch 2).

Parameters

context

events?

string[]

now?

number

queryEmbedding?

number[]

queryText?

string

Returns

Promise<ProspectiveMemoryItem[]>

Implementation of

ICognitiveMemoryManager.checkProspective

---

compactIfNeeded()

compactIfNeeded(systemPromptTokens, memoryBudgetTokens): Promise<ContextMessage[] | null>

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

Run context window compaction if needed. Call BEFORE assembling the LLM prompt. Returns the (potentially compacted) message list for the conversation. If infinite context is disabled, returns null (caller should use original messages).

Parameters

systemPromptTokens

number

memoryBudgetTokens

number

Returns

Promise<ContextMessage[] | null>

---

encode()

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

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

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>

Implementation of

ICognitiveMemoryManager.encode

---

getCompactionHistory()

getCompactionHistory(): readonly CompactionEntry[]

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

Get compaction history for audit/UI.

Returns

readonly CompactionEntry[]

---

getConfig()

getConfig(): CognitiveMemoryConfig

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

Returns

CognitiveMemoryConfig

---

getContextTransparencyReport()

getContextTransparencyReport(): string | null

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

Get full transparency report (for agent self-inspection or UI).

Returns

string | null

---

getContextWindowManager()

getContextWindowManager(): ContextWindowManager | null

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

Get the context window manager (for advanced usage).

Returns

ContextWindowManager | null

---

getContextWindowStats()

getContextWindowStats(): ContextWindowStats | null

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

Get context window transparency stats.

Returns

ContextWindowStats | null

---

getGraph()

getGraph(): IMemoryGraph | null

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

Returns

IMemoryGraph | null

---

getMemoryHealth()

getMemoryHealth(): Promise<MemoryHealthReport>

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

Get memory health diagnostics.

Returns

Promise<MemoryHealthReport>

Implementation of

ICognitiveMemoryManager.getMemoryHealth

---

getObserver()

getObserver(): MemoryObserver | null

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

Returns

MemoryObserver | null

---

getProspective()

getProspective(): ProspectiveMemoryManager | null

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

Returns

ProspectiveMemoryManager | null

---

getStore()

getStore(): MemoryStore

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

Returns

MemoryStore

---

getSummaryContext()

getSummaryContext(): string

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

Get the rolling summary chain text for prompt injection.

Returns

string

---

getWorkingMemory()

getWorkingMemory(): CognitiveWorkingMemory

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

Returns

CognitiveWorkingMemory

---

initialize()

initialize(config): Promise<void>

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

Parameters

config

CognitiveMemoryConfig

Returns

Promise<void>

Implementation of

ICognitiveMemoryManager.initialize

---

listProspective()

listProspective(): Promise<ProspectiveMemoryItem[]>

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

List active prospective reminders.

Returns

Promise<ProspectiveMemoryItem[]>

Implementation of

ICognitiveMemoryManager.listProspective

---

observe()

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

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

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>

Implementation of

ICognitiveMemoryManager.observe

---

registerProspective()

registerProspective(input): Promise<ProspectiveMemoryItem>

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

Register a new prospective reminder/intention.

Parameters

input

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

Returns

Promise<ProspectiveMemoryItem>

Implementation of

ICognitiveMemoryManager.registerProspective

---

removeProspective()

removeProspective(id): Promise<boolean>

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

Remove a prospective reminder.

Parameters

id

string

Returns

Promise<boolean>

Implementation of

ICognitiveMemoryManager.removeProspective

---

retrieve()

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

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

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

Parameters

query

string

mood

PADState

options?

CognitiveRetrievalOptions = {}

Returns

Promise<CognitiveRetrievalResult>

Implementation of

ICognitiveMemoryManager.retrieve

---

runConsolidation()

runConsolidation(): Promise<ConsolidationResult>

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

Run consolidation cycle (Batch 2).

Returns

Promise<ConsolidationResult>

Implementation of

ICognitiveMemoryManager.runConsolidation

---

searchCompactionHistory()

searchCompactionHistory(keyword): CompactionEntry[]

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

Search compaction history for a keyword.

Parameters

keyword

string

Returns

CompactionEntry[]

---

shutdown()

shutdown(): Promise<void>

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

Shutdown and release resources.

Returns

Promise<void>

Implementation of

ICognitiveMemoryManager.shutdown

---

trackMessage()

trackMessage(role, content): void

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

Track a conversation message for context window management. Call for every user/assistant/system/tool message in the conversation.

Parameters

role

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

content

string

Returns

void