Function: maxToolCalls()

function maxToolCalls(max): AgentLoopStrategy;

function maxToolCalls(max): AgentLoopStrategy;

Defined in: packages/ai/src/activities/chat/agent-loop-strategies.ts:59

Creates a strategy that continues while toolCallCount < max.

Unlike maxIterations (which counts model turns), this bounds emitted tool calls counted during the run (including ones skipped by maxToolCallsPerTurn). Strategies only run between turns, so the turn that crosses max is not truncated — the final count (and executions, unless maxToolCallsPerTurn is set) may exceed max. Pair with chat({ maxToolCallsPerTurn }) to also cap parallel fan-out inside a single turn.

Parameters

max

number

Maximum cumulative emitted tool calls before stopping further turns

Returns

AgentLoopStrategy

AgentLoopStrategy that returns true while toolCallCount < max

Example

typescript

import { chat, combineStrategies, maxIterations, maxToolCalls } from '@tanstack/ai'

const stream = chat({
  adapter: openaiText('gpt-4o'),
  messages: [...],
  tools: [weatherTool],
  maxToolCallsPerTurn: 10,
  agentLoopStrategy: combineStrategies([
    maxIterations(20),
    maxToolCalls(20),
  ]),
})

import { chat, combineStrategies, maxIterations, maxToolCalls } from '@tanstack/ai'

const stream = chat({
  adapter: openaiText('gpt-4o'),
  messages: [...],
  tools: [weatherTool],
  maxToolCallsPerTurn: 10,
  agentLoopStrategy: combineStrategies([
    maxIterations(20),
    maxToolCalls(20),
  ]),
})

maxToolCalls

Function: maxToolCalls()#

Parameters#

max#

Returns#

Example#

Function: maxToolCalls()

Parameters

max

Returns

Example