Session Persist Failed Input • AI Agent SDK

SessionPersistFailedInput: Input for SESSION_PERSIST_FAILED hooks (a durable session write failed).

SessionPersistFailedInput

Defined in the events module.

Input for SESSION_PERSIST_FAILED hooks (a durable session write failed).

Fired by the session store when an `add_message/set_chat_history write cannot be persisted (disk-full, SQLite/FTS corruption, permission / OSError). Instead of losing the already-produced turn silently, the store spills it to an atomic fallback file and fires this hook so operators can observe/route the failure (metrics, alerting, forensics) — mirroring the MESSAGE_UNDELIVERED` posture on the outbound side (Issue #3597).

`spilled reports whether the last-resort fallback write itself succeeded; spill_path` is the file the turn was salvaged to (when any).

Properties

Source

Related Documentation