Skip to content
Developer Preview

TurnEntry

A turn as the fold has observed it.

Property Type Stability Presence Description
commandId string optional The submitting command, when an event carried it.
error TurnError optional Present iff the terminal was "failed".
foregroundCompleted TurnForegroundCompletedParams optional The latest foreground-completed notice; non-terminal. Tells a renderer the answer is done while blockingAgents hold the turn; clears on the turn’s terminal.
modelAttemptStarted TurnModelAttemptStartedParams optional The latest model attempt start, recorded before the provider dials; non-terminal. It stays set through tool runs and retry backoffs until the turn’s terminal, so it is not a live “model is working” flag.
modelRetryScheduled TurnModelRetryScheduledParams optional The latest scheduled provider-backoff retry; non-terminal. The model-attempt twin of retryScheduled: a failing model attempt’s backoff is waiting out its delay. Clears on the turn’s terminal.
retryScheduled TurnRetryScheduledParams optional The latest scheduled model retry; non-terminal.
state TurnState required
terminal TurnTerminal optional The server’s terminal, verbatim. Absent unless turn/completed folded.
turnId string required
Source

clients/sdk-ts/src/fold/session-fold.ts:333

{
"kind": "Interface",
"canonicalPath": "TurnEntry"
}