Skip to content

AgentRunBudgets

Defined in: packages/engine/src/lib/agent-session/agent-run.ts:15

Caps on one Agent Run. A run that reaches any cap stops with BUDGET_CLOSING_MESSAGE and a budget AgentRunFinished. The values are frozen for the run and never reach a prompt or tool arguments. A zero or NaN cap refuses the run before any model call.

readonly maxElapsedMs: number

Defined in: packages/engine/src/lib/agent-session/agent-run.ts:19

Longest wall-clock duration of the run, in milliseconds, measured on AgentRunClock.


readonly maxTokens: number

Defined in: packages/engine/src/lib/agent-session/agent-run.ts:25

Most input plus output tokens the run may spend, summed over every provider call. Infinity disables the cap, so unknown usage no longer blocks tools.


readonly maxToolCalls: number

Defined in: packages/engine/src/lib/agent-session/agent-run.ts:27

Most tool calls the run may make across all turns.


readonly maxTurns: number

Defined in: packages/engine/src/lib/agent-session/agent-run.ts:17

Most model turns the run may take.