Sessions API

---

FileSessionManager

from elsai.session import FileSessionManager

Persists sessions to the local filesystem.

FileSessionManager(
    storage_dir="./sessions",
    file_extension=".json",
)

Parameter	Default	Description
storage_dir	"./sessions"	Directory to store session files
file_extension	".json"	File extension for session files

---

S3SessionManager

from elsai.session import S3SessionManager

Persists sessions to Amazon S3.

S3SessionManager(
    bucket_name="my-sessions-bucket",
    prefix="",
    region_name=None,
    boto3_session=None,
)

Parameter	Description
bucket_name	S3 bucket name
prefix	Key prefix (e.g. "sessions/")
region_name	AWS region
boto3_session	Custom boto3 session

---

RepositorySessionManager

from elsai.session import RepositorySessionManager

Generic session manager backed by a SessionRepository.

RepositorySessionManager(repository=my_repository)

---

SessionRepository

from elsai.session import SessionRepository

Abstract base for custom storage backends:

class SessionRepository:
    def save(self, session_id: str, data: dict) -> None: ...
    def load(self, session_id: str) -> dict | None: ...
    def delete(self, session_id: str) -> None: ...
    def exists(self, session_id: str) -> bool: ...

---

Snapshot

from elsai.types._snapshot import Snapshot, SnapshotPreset, SnapshotField

An in-memory snapshot of agent state.

SnapshotPreset

Value	Included fields
"session"	messages, state, conversation_manager_state, interrupt_state

SnapshotField

Valid field names: "messages", "state", "conversation_manager_state", "interrupt_state", "system_prompt"

Taking a snapshot

snapshot = agent.take_snapshot(preset="session")
snapshot = agent.take_snapshot(include=["messages", "state"])
snapshot = agent.take_snapshot(preset="session", exclude=["interrupt_state"])
snapshot = agent.take_snapshot(preset="session", app_data={"version": "1.0"})

Restoring from snapshot

agent.load_snapshot(snapshot)

Serialising

import json

# Serialise
snapshot_dict = snapshot.model_dump()
json_str = json.dumps(snapshot_dict)

# Deserialise
from elsai.types._snapshot import Snapshot
snapshot = Snapshot(**json.loads(json_str))
agent.load_snapshot(snapshot)