TurnResult

Defined in: src/types.ts:212

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

Properties

endedAt

readonly endedAt: number

Defined in: src/types.ts:228

Epoch ms when this turn ended.

---

error

readonly error: { details?: unknown; message: string; } | null

Defined in: src/types.ts:224

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

---

id

readonly id: string

Defined in: src/types.ts:214

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

---

metadata

readonly metadata: TurnMetadata

Defined in: src/types.ts:222

End-of-turn metadata.

---

prompt

readonly prompt: string

Defined in: src/types.ts:216

The prompt that initiated this turn.

---

startedAt

readonly startedAt: number

Defined in: src/types.ts:226

Epoch ms when this turn started.

---

steps

readonly steps: readonly Step[]

Defined in: src/types.ts:218

Ordered sequence of everything the agent did in this turn.

---

usage

readonly usage: TokenUsage

Defined in: src/types.ts:220

Token usage totals across all iterations.