SessionHistoryTransactionAwareSession
此内容尚不支持你的语言。
Optional session capability for atomic, idempotent history changes.
Implementations must persist the operation identifier and history change atomically. Repeating an operation identifier with the same transaction must succeed without applying the transaction again. Reusing an operation identifier with a different transaction, or attempting to replace a suffix that does not match, must fail without changing history.
Implementations may reject item metadata that cannot be snapshotted and compared deterministically, but must do so before changing history or recording the operation identifier.
Extends
Section titled “Extends”Methods
Section titled “Methods”addItems()
Section titled “addItems()”addItems(items): Promise<void>;Append new items to the conversation history.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
|
|
Items to add to the session history. |
Returns
Section titled “Returns”Promise<void>
Inherited from
Section titled “Inherited from”applyHistoryTransaction()
Section titled “applyHistoryTransaction()”applyHistoryTransaction(args, runContext?): void | Promise<void>;Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
|
|
|
Returns
Section titled “Returns”void | Promise<void>
clearSession()
Section titled “clearSession()”clearSession(): Promise<void>;Remove all items that belong to the session and reset its state.
Returns
Section titled “Returns”Promise<void>
Inherited from
Section titled “Inherited from”getItems()
Section titled “getItems()”getItems(limit?): Promise<AgentInputItem[]>;Retrieve items from the conversation history.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
|
|
|
The maximum number of items to return. When provided the most recent limit items should be returned in chronological order. |
Returns
Section titled “Returns”Promise<AgentInputItem[]>
Inherited from
Section titled “Inherited from”getSessionId()
Section titled “getSessionId()”getSessionId(): Promise<string>;Ensure and return the identifier for this session.
Returns
Section titled “Returns”Promise<string>
Inherited from
Section titled “Inherited from”popItem()
Section titled “popItem()”popItem(): Promise< | AgentInputItem| undefined>;Remove and return the most recent item from the conversation history if it exists.
Returns
Section titled “Returns”Promise<
| AgentInputItem
| undefined>
Inherited from
Section titled “Inherited from”prepareHistoryItemForModelInput()?
Section titled “prepareHistoryItemForModelInput()?”optional prepareHistoryItemForModelInput(item): AgentInputItem;Optionally rewrite a stored history item before it is sent back to the model.
Session implementations can use this to strip provider-managed replay metadata while
preserving their public getItems() shape for UI and deletion workflows.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
Returns
Section titled “Returns”Inherited from
Section titled “Inherited from”Session.prepareHistoryItemForModelInput
prepareHistoryItemsForPersistenceComparison()?
Section titled “prepareHistoryItemsForPersistenceComparison()?”optional prepareHistoryItemsForPersistenceComparison(items): AgentInputItem[];Optionally normalize stored and expected history before persistence reconciliation compares them.
Session implementations can use this to remove backend-assigned metadata while preserving
their public getItems() shape.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
Returns
Section titled “Returns”Inherited from
Section titled “Inherited from”Session.prepareHistoryItemsForPersistenceComparison
preserveReasoningItemIdsForPersistence()?
Section titled “preserveReasoningItemIdsForPersistence()?”optional preserveReasoningItemIdsForPersistence(): boolean;Optionally preserve reasoning item IDs when persisting generated output.
Some remote session stores require provider-assigned reasoning identities to accept stored reasoning items, even when model replay should omit those IDs.
Returns
Section titled “Returns”boolean
Inherited from
Section titled “Inherited from”Session.preserveReasoningItemIdsForPersistence
replaceHistoryWithCompaction()?
Section titled “replaceHistoryWithCompaction()?”optional replaceHistoryWithCompaction(items): Promise<void>;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.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
Returns
Section titled “Returns”Promise<void>