SessionStore
Interface for session persistence backends.
Implement this to store sessions in any storage system.
Built-in adapters: @agent-express/session-sqlite, session-redis, session-postgres.
Methods
Section titled “Methods”add(
sessionId,message):Promise<void>
Append a single message without rewriting the full history.
Parameters
Section titled “Parameters”sessionId
Section titled “sessionId”string
message
Section titled “message”Returns
Section titled “Returns”Promise<void>
delete()
Section titled “delete()”delete(
sessionId):Promise<void>
Delete session.
Parameters
Section titled “Parameters”sessionId
Section titled “sessionId”string
Returns
Section titled “Returns”Promise<void>
list()
Section titled “list()”list(
sessionId,opts?):Promise<Message[]>
Get messages with pagination.
Parameters
Section titled “Parameters”sessionId
Section titled “sessionId”string
limit?
Section titled “limit?”number
Max messages to return.
offset?
Section titled “offset?”number
Skip first N messages.
order?
Section titled “order?”"asc" | "desc"
Sort order. Default: “desc” (newest first).
Returns
Section titled “Returns”Promise<Message[]>
load()
Section titled “load()”load(
sessionId):Promise<SessionData|null>
Load full session (state + history). Returns null if not found.
Parameters
Section titled “Parameters”sessionId
Section titled “sessionId”string
Returns
Section titled “Returns”Promise<SessionData | null>
save()
Section titled “save()”save(
sessionId,data):Promise<void>
Save full session (state + history).
Parameters
Section titled “Parameters”sessionId
Section titled “sessionId”string
Returns
Section titled “Returns”Promise<void>