Class RedisL1Store

Redis-backed hot session store (L1). Turns are stored as a per-session list with a sliding TTL and a capped length, mirroring the Python actrone_memory RedisStore.

Implements

L1Store

Index

Constructors

constructor

Methods

tryAcquireSummaryLock appendTurn getRecentTurns turnCount clearSession getSessionMetadata

Constructors

constructor

new RedisL1Store(client: RedisLike, opts?: RedisL1Options): RedisL1Store
Parameters
- client: RedisLike
- opts: RedisL1Options = {}
Returns RedisL1Store
- Defined in src/stores/redis.ts:52

Methods

tryAcquireSummaryLock

tryAcquireSummaryLock(
    agentId: string,
    sessionId: string,
    ttlSeconds: number,
): Promise<boolean>
Claim the right to summarise this session, fleet-wide, via SET key NX EX ttl.

One atomic command, so the check and the claim cannot interleave across processes. The TTL is never released early, which makes it double as a re-summarisation cooldown. Throws if the injected client exposes no set, rather than pretending to hold a lock.
Parameters
- agentId: string
- sessionId: string
- ttlSeconds: number
Returns Promise<boolean>
Implementation of L1Store.tryAcquireSummaryLock
- Defined in src/stores/redis.ts:74

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/stores/redis.ts:104

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/stores/redis.ts:116

turnCount

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

clearSession

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

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/stores/redis.ts:146

Class RedisL1Store

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns RedisL1Store

Methods

tryAcquireSummaryLock

Parameters

Returns Promise<boolean>

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>

Settings

On This Page