TurnResult

Defined in: src/types.ts:290

The compact, read-only, immutable representation of an entire turn.

Properties

endedAt

readonly endedAt: number

Defined in: src/types.ts:311

Epoch ms when this turn ended.

---

error

readonly error: { details?: unknown; errorType: ErrorType; message: string; retryability: Retryability; } | null

Defined in: src/types.ts:302

Non-null if the turn ended in an unrecoverable error.

---

id

readonly id: string

Defined in: src/types.ts:292

Unique turn ID (same as the one in TurnStart).

---

metadata

readonly metadata: TurnMetadata

Defined in: src/types.ts:300

End-of-turn metadata.

---

prompt

readonly prompt: string

Defined in: src/types.ts:294

The prompt that initiated this turn.

---

startedAt

readonly startedAt: number

Defined in: src/types.ts:309

Epoch ms when this turn started.

---

steps

readonly steps: readonly Step[]

Defined in: src/types.ts:296

Ordered sequence of everything the agent did in this turn.

---

usage

readonly usage: TokenUsage

Defined in: src/types.ts:298

Token usage totals across all iterations.