Session Config • AI Agent SDK

SessionConfig: Configuration for gateway sessions.

SessionConfig

Defined in the config module.

Configuration for gateway sessions.

Attributes: timeout: Session timeout in seconds (0 = no timeout) max_messages: Maximum messages to keep in history (0 = unlimited) persist: Whether to persist session state. Defaults to True so a gateway started from the out-of-box path remembers conversations across restarts/redeploys via the SQLite transcript store. Set `persist: false in the config to opt into ephemeral, in-memory sessions. persist_path: Path for session persistence store: Persistence backend when persist is set — "sqlite" (default: transcripts in a WAL SQLite DB with concurrent readers and indexed lookups) or "file"` (legacy per-session JSON files) resume_window: How long (seconds) a session stays resumable after disconnect max_inbox: Maximum queued messages per session (0 = unlimited, default 256) metadata: Additional session metadata mirror_runtime_state: Enable runtime state mirroring for native transcript replay (Issue #1943)

Properties

Source

Related Documentation