Class InMemoryStore

Default in-process store implementing both tiers. Data lives for the lifetime of the process; it is the on-ramp for local development, testing, and small single-instance agents. Swap in Redis/Qdrant adapters for durability + scale.

Implements

Index

Constructors

constructor

Methods

appendTurn getRecentTurns turnCount clearSession getSessionMetadata tryAcquireSummaryLock upsert search delete deleteAgentMemories

Constructors

constructor

new InMemoryStore(maxSessionTurns?: number): InMemoryStore
Parameters
- maxSessionTurns: number = 50
Returns InMemoryStore
- Defined in src/store.ts:97

Methods

appendTurn

appendTurn(agentId: string, sessionId: string, turn: Turn): Promise<void>
Parameters
- agentId: string
- sessionId: string
- turn: Turn
Returns Promise<void>
Implementation of L1Store.appendTurn
- Defined in src/store.ts:103

getRecentTurns

getRecentTurns(agentId: string, sessionId: string, n?: number): Promise<Turn[]>
Recent turns, oldest → newest, capped at n (defaults to all retained).
Parameters
- agentId: string
- sessionId: string
- Optionaln: number
Returns Promise<Turn[]>
Implementation of L1Store.getRecentTurns
- Defined in src/store.ts:113

turnCount

turnCount(agentId: string, sessionId: string): Promise<number>
Parameters
- agentId: string
- sessionId: string
Returns Promise<number>
Implementation of L1Store.turnCount
- Defined in src/store.ts:119

clearSession

clearSession(agentId: string, sessionId: string): Promise<void>
Parameters
- agentId: string
- sessionId: string
Returns Promise<void>
Implementation of L1Store.clearSession
- Defined in src/store.ts:123

getSessionMetadata

getSessionMetadata(
agentId: string,
sessionId: string,
): Promise<SessionMetadata | null>
Parameters
- agentId: string
- sessionId: string
Returns Promise<SessionMetadata | null>
Implementation of L1Store.getSessionMetadata
- Defined in src/store.ts:130

tryAcquireSummaryLock

tryAcquireSummaryLock(
    agentId: string,
    sessionId: string,
    ttlSeconds: number,
): Promise<boolean>
SET-NX-EX equivalent: true for the first caller inside a TTL window.

Process-local, like the Python in-memory store, because an in-process backend is single-instance by definition. Use the Redis or Postgres adapter for a fleet-wide lock.
Parameters
- agentId: string
- sessionId: string
- ttlSeconds: number
Returns Promise<boolean>
Implementation of L1Store.tryAcquireSummaryLock
- Defined in src/store.ts:154

upsert

upsert(entry: MemoryEntry): Promise<void>
Parameters
- entry: MemoryEntry
Returns Promise<void>
Implementation of L2Store.upsert
- Defined in src/store.ts:169

search

search(params: L2SearchParams): Promise<MemoryEntry[]>
Parameters
- params: L2SearchParams
Returns Promise<MemoryEntry[]>
Implementation of L2Store.search
- Defined in src/store.ts:177

delete

delete(memoryId: string): Promise<void>
Parameters
- memoryId: string
Returns Promise<void>
Implementation of L2Store.delete
- Defined in src/store.ts:195

deleteAgentMemories

deleteAgentMemories(agentId: string): Promise<void>
Delete every memory for an agent (local right-to-erasure).
Parameters
- agentId: string
Returns Promise<void>
Implementation of L2Store.deleteAgentMemories
- Defined in src/store.ts:207

Class InMemoryStore

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns InMemoryStore

Methods

appendTurn

Parameters

Returns Promise<void>

getRecentTurns

Parameters

Returns Promise<Turn[]>

turnCount

Parameters

Returns Promise<number>

clearSession

Parameters

Returns Promise<void>

getSessionMetadata

Parameters

Returns Promise<SessionMetadata | null>

tryAcquireSummaryLock

Parameters

Returns Promise<boolean>

upsert

Parameters

Returns Promise<void>

search

Parameters

Returns Promise<MemoryEntry[]>

delete

Parameters

Returns Promise<void>

deleteAgentMemories

Parameters

Returns Promise<void>

Settings

On This Page