Class CognitiveWorkingMemory

constructor

• new CognitiveWorkingMemory(backing, config?): CognitiveWorkingMemory

• Parameters

  • backing: IWorkingMemory
  • Optional config: Partial<CognitiveWorkingMemoryConfig>

  Returns CognitiveWorkingMemory

initialize

• initialize(gmiInstanceId, config?): Promise<void>

• Parameters

  • gmiInstanceId: string
  • Optional config: Record<string, any>

  Returns Promise<void>

set

• set<T>(key, value): Promise<void>

• Type Parameters

  • T = any

  Parameters

  • key: string
  • value: T

  Returns Promise<void>

get

• get<T>(key): Promise<undefined | T>

• Type Parameters

  • T = any

  Parameters

  • key: string

  Returns Promise<undefined | T>

delete

• delete(key): Promise<void>

• Parameters

  • key: string

  Returns Promise<void>

getAll

• getAll(): Promise<Record<string, any>>

• Returns Promise<Record<string, any>>

clear

• clear(): Promise<void>

• Returns Promise<void>

size

• size(): Promise<number>

• Returns Promise<number>

has

• has(key): Promise<boolean>

• Parameters

  • key: string

  Returns Promise<boolean>

close

• close(): Promise<void>

• Returns Promise<void>

getSlotCount

• getSlotCount(): number

• Current number of occupied slots.

  Returns number

getCapacity

• getCapacity(): number

• Maximum slot capacity (personality-modulated).

  Returns number

getSlots

• getSlots(): WorkingMemorySlot[]

• Get all active slots.

  Returns WorkingMemorySlot[]

getSlot

• getSlot(slotId): undefined | WorkingMemorySlot

• Get a specific slot by ID.

  Parameters

  • slotId: string

  Returns undefined | WorkingMemorySlot

focus

• focus(traceId, initialActivation?): Promise<string>

• Focus attention on a trace, adding it to working memory. If at capacity, the lowest-activation slot is evicted first.

  Parameters

  • traceId: string
  • initialActivation: number = 0.8

  Returns Promise<string>

  The slot ID assigned to this trace.

rehearse

• rehearse(slotId): void

• Rehearse a slot (maintenance rehearsal), bumping its activation.

  Parameters

  • slotId: string

  Returns void

decayActivations

• decayActivations(): Promise<string[]>

• Apply per-turn activation decay to all slots. Slots that drop below minActivation become eviction candidates.

  Returns Promise<string[]>

getUtilization

• getUtilization(): number

• Get working memory utilisation (0-1).

  Returns number

formatForPrompt

• formatForPrompt(): string

• Serialise current slots as a formatted string for prompt injection.

  Returns string

Readonly id