跳转到内容

SessionHistoryRewriteAwareSession

此内容尚不支持你的语言。

Interface representing a persistent session store for conversation history.

addItems(items): Promise<void>;

Append new items to the conversation history.

Parameter Type Description

items

AgentInputItem[]

Items to add to the session history.

Promise<void>

Session.addItems


applyHistoryMutations(args): void | Promise<void>;
Parameter Type

args

SessionHistoryRewriteArgs

void | Promise<void>


clearSession(): Promise<void>;

Remove all items that belong to the session and reset its state.

Promise<void>

Session.clearSession


getItems(limit?): Promise<AgentInputItem[]>;

Retrieve items from the conversation history.

Parameter Type Description

limit?

number

The maximum number of items to return. When provided the most recent limit items should be returned in chronological order.

Promise<AgentInputItem[]>

Session.getItems


getSessionId(): Promise<string>;

Ensure and return the identifier for this session.

Promise<string>

Session.getSessionId


popItem(): Promise<
| AgentInputItem
| undefined>;

Remove and return the most recent item from the conversation history if it exists.

Promise< | AgentInputItem | undefined>

Session.popItem


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.

Parameter Type

item

AgentInputItem

AgentInputItem

Session.prepareHistoryItemForModelInput