AgentLoopState

Defined in: packages/ai/src/types.ts:1201

State passed to agent loop strategy for determining whether to continue

Properties

finishReason

finishReason: string | null;

finishReason: string | null;

Defined in: packages/ai/src/types.ts:1207

Finish reason from the last response

iterationCount

iterationCount: number;

iterationCount: number;

Defined in: packages/ai/src/types.ts:1203

Current iteration count (0-indexed). One iteration = one model turn.

lastTurnToolCallCount

lastTurnToolCallCount: number;

lastTurnToolCallCount: number;

Defined in: packages/ai/src/types.ts:1219

Tool calls in the most recent batch — a live model turn or a pending/resume batch (0 when the last phase produced no tool calls).

messages

messages: ModelMessage<
  | string
  | ContentPart<unknown, unknown, unknown, unknown, unknown>[]
  | null>[];

messages: ModelMessage<
  | string
  | ContentPart<unknown, unknown, unknown, unknown, unknown>[]
  | null>[];

Defined in: packages/ai/src/types.ts:1205

Current messages array

toolCallCount

toolCallCount: number;

toolCallCount: number;

Defined in: packages/ai/src/types.ts:1214

Cumulative tool calls counted so far in this run (model-emitted during the agent loop, including ones skipped by middleware, and pending tools from the inbound message list when resumed). Not a recount of full message history; not model turns.