Class CognitiveMemoryManager

Implements

ICognitiveMemoryManager

Constructors

constructor

new CognitiveMemoryManager(): CognitiveMemoryManager
Returns CognitiveMemoryManager

Methods

initialize

initialize(config): Promise<void>
Parameters
- config: CognitiveMemoryConfig
Returns Promise<void>
Implementation of ICognitiveMemoryManager.initialize
- Defined in src/memory/CognitiveMemoryManager.ts:219

encode

encode(input, mood, gmiMood, options?): Promise<MemoryTrace>
Encode a new input into a memory trace. Called after each user message.
Parameters
- input: string
- mood: PADState
- gmiMood: string
- options: {
      type?: MemoryType;
      scope?: MemoryScope;
      scopeId?: string;
      sourceType?: MemorySourceType;
      contentSentiment?: number;
      tags?: string[];
      entities?: string[];
  } = {}
  - Optional type?: MemoryType
  - Optional scope?: MemoryScope
  - Optional scopeId?: string
  - Optional sourceType?: MemorySourceType
  - Optional contentSentiment?: number
  - Optional tags?: string[]
  - Optional entities?: string[]
Returns Promise<MemoryTrace>
Implementation of ICognitiveMemoryManager.encode
- Defined in src/memory/CognitiveMemoryManager.ts:347

retrieve

retrieve(query, mood, options?): Promise<CognitiveRetrievalResult>
Retrieve relevant memories for a query. Called before prompt construction.
Parameters
- query: string
- mood: PADState
- options: CognitiveRetrievalOptions = {}
Returns Promise<CognitiveRetrievalResult>
Implementation of ICognitiveMemoryManager.retrieve
- Defined in src/memory/CognitiveMemoryManager.ts:443

assembleForPrompt

assembleForPrompt(query, tokenBudget, mood, options?): Promise<AssembledMemoryContext>
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
- Defined in src/memory/CognitiveMemoryManager.ts:553

observe

observe(role, content, mood?): Promise<null | ObservationNote[]>
Feed a message to the observer (Batch 2). Returns notes if threshold reached.
Parameters
- role: "user" | "assistant" | "system" | "tool"
- content: string
- Optional mood: PADState
Returns Promise<null | ObservationNote[]>
Implementation of ICognitiveMemoryManager.observe
- Defined in src/memory/CognitiveMemoryManager.ts:624

checkProspective

checkProspective(context): Promise<ProspectiveMemoryItem[]>
Check prospective memory triggers (Batch 2).
Parameters
- context: {
      now?: number;
      events?: string[];
      queryText?: string;
      queryEmbedding?: number[];
  }
  - Optional now?: number
  - Optional events?: string[]
  - Optional queryText?: string
  - Optional queryEmbedding?: number[]
Returns Promise<ProspectiveMemoryItem[]>
Implementation of ICognitiveMemoryManager.checkProspective
- Defined in src/memory/CognitiveMemoryManager.ts:669

registerProspective

registerProspective(input): Promise<ProspectiveMemoryItem>
Register a new prospective reminder/intention.
Parameters
- input: Omit<ProspectiveMemoryItem, "id" | "createdAt" | "triggered" | "cueEmbedding"> & {
  cueText?: string;
  }
Returns Promise<ProspectiveMemoryItem>
Implementation of ICognitiveMemoryManager.registerProspective
- Defined in src/memory/CognitiveMemoryManager.ts:679

listProspective

listProspective(): Promise<ProspectiveMemoryItem[]>
List active prospective reminders.

Returns Promise<ProspectiveMemoryItem[]>
Implementation of ICognitiveMemoryManager.listProspective
- Defined in src/memory/CognitiveMemoryManager.ts:690

removeProspective

removeProspective(id): Promise<boolean>
Remove a prospective reminder.
Parameters
- id: string
Returns Promise<boolean>
Implementation of ICognitiveMemoryManager.removeProspective
- Defined in src/memory/CognitiveMemoryManager.ts:694

runConsolidation

runConsolidation(): Promise<ConsolidationResult>
Run consolidation cycle (Batch 2).

Returns Promise<ConsolidationResult>
Implementation of ICognitiveMemoryManager.runConsolidation
- Defined in src/memory/CognitiveMemoryManager.ts:702

getMemoryHealth

getMemoryHealth(): Promise<MemoryHealthReport>
Get memory health diagnostics.

Returns Promise<MemoryHealthReport>
Implementation of ICognitiveMemoryManager.getMemoryHealth
- Defined in src/memory/CognitiveMemoryManager.ts:721

trackMessage

trackMessage(role, content): void
Track a conversation message for context window management. Call for every user/assistant/system/tool message in the conversation.
Parameters
- role: "user" | "assistant" | "system" | "tool"
- content: string
Returns void
- Defined in src/memory/CognitiveMemoryManager.ts:777

compactIfNeeded

compactIfNeeded(systemPromptTokens, memoryBudgetTokens): Promise<null | ContextMessage[]>
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<null | ContextMessage[]>
- Defined in src/memory/CognitiveMemoryManager.ts:786

getSummaryContext

getSummaryContext(): string
Get the rolling summary chain text for prompt injection.

Returns string
- Defined in src/memory/CognitiveMemoryManager.ts:804

getContextWindowStats

getContextWindowStats(): null | ContextWindowStats
Get context window transparency stats.

Returns null | ContextWindowStats
Implementation of ICognitiveMemoryManager.getContextWindowStats
- Defined in src/memory/CognitiveMemoryManager.ts:809

getContextTransparencyReport

getContextTransparencyReport(): null | string
Get full transparency report (for agent self-inspection or UI).

Returns null | string
Implementation of ICognitiveMemoryManager.getContextTransparencyReport
- Defined in src/memory/CognitiveMemoryManager.ts:814

getCompactionHistory

getCompactionHistory(): readonly CompactionEntry[]
Get compaction history for audit/UI.

Returns readonly CompactionEntry[]
- Defined in src/memory/CognitiveMemoryManager.ts:819

searchCompactionHistory

searchCompactionHistory(keyword): CompactionEntry[]
Search compaction history for a keyword.
Parameters
- keyword: string
Returns CompactionEntry[]
- Defined in src/memory/CognitiveMemoryManager.ts:824

getContextWindowManager

getContextWindowManager(): null | ContextWindowManager
Get the context window manager (for advanced usage).

Returns null | ContextWindowManager
- Defined in src/memory/CognitiveMemoryManager.ts:829

shutdown

shutdown(): Promise<void>
Shutdown and release resources.

Returns Promise<void>
Implementation of ICognitiveMemoryManager.shutdown
- Defined in src/memory/CognitiveMemoryManager.ts:837

getStore

getStore(): MemoryStore
Access the underlying long-term memory store for diagnostics/devtools.

Returns MemoryStore
Implementation of ICognitiveMemoryManager.getStore
- Defined in src/memory/CognitiveMemoryManager.ts:847

getWorkingMemory

getWorkingMemory(): CognitiveWorkingMemory
Access the working-memory model for diagnostics/devtools.

Returns CognitiveWorkingMemory
Implementation of ICognitiveMemoryManager.getWorkingMemory
- Defined in src/memory/CognitiveMemoryManager.ts:851

getConfig

getConfig(): CognitiveMemoryConfig
Get the resolved cognitive-memory runtime config.

Returns CognitiveMemoryConfig
Implementation of ICognitiveMemoryManager.getConfig
- Defined in src/memory/CognitiveMemoryManager.ts:855

getGraph

getGraph(): null | IMemoryGraph
Get graph module when enabled.

Returns null | IMemoryGraph
Implementation of ICognitiveMemoryManager.getGraph
- Defined in src/memory/CognitiveMemoryManager.ts:859

getObserver

getObserver(): null | MemoryObserver
Get observer module when enabled.

Returns null | MemoryObserver
Implementation of ICognitiveMemoryManager.getObserver
- Defined in src/memory/CognitiveMemoryManager.ts:863

getProspective

getProspective(): null | ProspectiveMemoryManager
Get prospective-memory manager when enabled.

Returns null | ProspectiveMemoryManager
Implementation of ICognitiveMemoryManager.getProspective
- Defined in src/memory/CognitiveMemoryManager.ts:867

setHydeRetriever

setHydeRetriever(retriever): void
Attach a HyDE retriever to enable hypothesis-driven memory recall.

When set, the retrieve() and assembleForPrompt() methods can accept options.hyde = true to generate a hypothetical memory trace before searching. This improves recall for vague or abstract queries by producing embeddings that are semantically closer to stored traces.
Parameters
- retriever: null | HydeRetriever
  A pre-configured HydeRetriever instance, or null to disable HyDE.
Returns void
Example
```
memoryManager.setHydeRetriever(new HydeRetriever({
  llmCaller: myLlmCaller,
  embeddingManager: myEmbeddingManager,
  config: { enabled: true },
}));
```
Implementation of ICognitiveMemoryManager.setHydeRetriever
- Defined in src/memory/CognitiveMemoryManager.ts:891

getHydeRetriever

getHydeRetriever(): null | HydeRetriever
Get the HyDE retriever if configured, or null.

Returns null | HydeRetriever
Implementation of ICognitiveMemoryManager.getHydeRetriever
- Defined in src/memory/CognitiveMemoryManager.ts:896

Class CognitiveMemoryManager

Implements

Index

Constructors

Methods

Constructors

constructor

Returns CognitiveMemoryManager

Methods

initialize

Parameters

Returns Promise<void>

encode

Parameters

Optional type?: MemoryType

Optional scope?: MemoryScope

Optional scopeId?: string

Optional sourceType?: MemorySourceType

Optional contentSentiment?: number

Optional tags?: string[]

Optional entities?: string[]

Returns Promise<MemoryTrace>

retrieve

Parameters

Returns Promise<CognitiveRetrievalResult>

assembleForPrompt

Parameters

Returns Promise<AssembledMemoryContext>

observe

Parameters

Returns Promise<null | ObservationNote[]>

checkProspective

Parameters

Optional now?: number

Optional events?: string[]

Optional queryText?: string

Optional queryEmbedding?: number[]

Returns Promise<ProspectiveMemoryItem[]>

registerProspective

Parameters

Returns Promise<ProspectiveMemoryItem>

listProspective

Returns Promise<ProspectiveMemoryItem[]>

removeProspective

Parameters

Returns Promise<boolean>

runConsolidation

Returns Promise<ConsolidationResult>

getMemoryHealth

Returns Promise<MemoryHealthReport>

trackMessage

Parameters

Returns void

compactIfNeeded

Parameters

Returns Promise<null | ContextMessage[]>

getSummaryContext

Returns string

getContextWindowStats

Returns null | ContextWindowStats

getContextTransparencyReport

Returns null | string

getCompactionHistory

Returns readonly CompactionEntry[]

searchCompactionHistory

Parameters

Returns CompactionEntry[]

getContextWindowManager

Returns null | ContextWindowManager

shutdown

Returns Promise<void>

getStore

Returns MemoryStore

getWorkingMemory

Returns CognitiveWorkingMemory

getConfig

Returns CognitiveMemoryConfig

getGraph

Returns null | IMemoryGraph

getObserver

`Optional` type?: MemoryType

`Optional` scope?: MemoryScope

`Optional` scopeId?: string

`Optional` sourceType?: MemorySourceType

`Optional` contentSentiment?: number

`Optional` tags?: string[]

`Optional` entities?: string[]

`Optional` now?: number

`Optional` events?: string[]

`Optional` queryText?: string

`Optional` queryEmbedding?: number[]