Append new items to the conversation history.
Items to add to the session history.
Remove all items that belong to the session and reset its state.
Retrieve items from the conversation history.
Optionallimit: number
The maximum number of items to return. When provided the most recent limit items should be returned in chronological order.
Ensure and return the identifier for this session.
Remove and return the most recent item from the conversation history if it exists.
Optionally replace the logical session history with a compaction marker and its retained suffix without resetting the session identity.
Implementations may append the replacement when their backend treats the leading compaction item as the authoritative replay boundary. If this method is absent, the runner falls back to clearing and rebuilding the session with rollback protection.
Durable OpenAI Agents SDK conversation history backed by FerricStore.
Renewable locks reduce contention, while compare-and-swap makes every state commit safe even if a writer's lease expires in flight. History transactions and their operation receipts are persisted in one atomic value, implementing the SDK's retry-safe transaction capability in addition to its base Session contract.