Class: MemoryStore<T, TArgs>

Makaio Framework

---

Makaio Framework / tools-core / MemoryStore

Class: MemoryStore<T, TArgs>

Defined in: ../../../tools/core/src/memory-store.ts:23

Generic memory store for managing working memory instances across sessions.

Provides session-keyed isolation for state when tool instances are singleton in the registry.

Type Parameters:

• T: The working memory class type
• TArgs: Constructor arguments for the working memory class

Example

class MyMemoryStore extends MemoryStore<MyWorkingMemory, [string]> {
  constructor() {
    super((sessionId) => new MyWorkingMemory(sessionId));
  }
}

const store = new MyMemoryStore();
const memory = store.get('session-123');
store.delete('session-123');

Type Parameters

T

T

TArgs

TArgs extends unknown[]

Constructors

Constructor

new MemoryStore<T, TArgs>(factory): MemoryStore<T, TArgs>

Defined in: ../../../tools/core/src/memory-store.ts:30

Creates a new memory store.

Parameters

factory

(sessionId, …args) => T

Factory function to create new memory instances

Returns

MemoryStore<T, TArgs>

Accessors

size

Get Signature

get size(): number

Defined in: ../../../tools/core/src/memory-store.ts:86

Returns the number of sessions with active memory.

Returns

number

Session count

Methods

delete()

delete(sessionId): boolean

Defined in: ../../../tools/core/src/memory-store.ts:62

Deletes session memory (for cleanup on session close).

Parameters

sessionId

string

Session identifier

Returns

boolean

true if deleted, false if not found

---

entries()

entries(): IterableIterator<[string, T]>

Defined in: ../../../tools/core/src/memory-store.ts:70

Iterates over all session memories.

Returns

IterableIterator<[string, T]>

Iterator of [sessionId, memory] pairs

---

get()

get(sessionId, …args): T

Defined in: ../../../tools/core/src/memory-store.ts:39

Gets or creates working memory for a session. Returns the same instance for the same sessionId.

Parameters

sessionId

string

Session identifier

args

…TArgs

Additional arguments passed to the factory

Returns

T

Working memory instance for the session

---

has()

has(sessionId): boolean

Defined in: ../../../tools/core/src/memory-store.ts:53

Checks if a session has working memory.

Parameters

sessionId

string

Session identifier

Returns

boolean

true if session exists

---

sessionIds()

sessionIds(): string[]

Defined in: ../../../tools/core/src/memory-store.ts:78

Returns all session IDs with active memory.

Returns

string[]

Array of session IDs