vercel/ai · error · InvalidArgumentError

maxRetries must be an integer

Error message

maxRetries must be an integer

What it means

Error "maxRetries must be an integer" thrown in vercel/ai.

Source

Thrown at packages/ai/src/util/prepare-retries.ts:19

import { InvalidArgumentError } from '../error/invalid-argument-error';
import type { RetryFunction } from '@ai-sdk/provider-utils';
import { retryWithExponentialBackoffRespectingRetryHeaders } from '../util/retry-with-exponential-backoff';
/**
 * Validate and prepare retries.
 */
export function prepareRetries({
  maxRetries,
  abortSignal,
}: {
  maxRetries: number | undefined;
  abortSignal: AbortSignal | undefined;
}): {
  maxRetries: number;
  retry: RetryFunction;
} {
  if (maxRetries != null) {
    if (!Number.isInteger(maxRetries)) {
      throw new InvalidArgumentError({
        parameter: 'maxRetries',
        value: maxRetries,
        message: 'maxRetries must be an integer',
      });
    }

    if (maxRetries < 0) {
      throw new InvalidArgumentError({
        parameter: 'maxRetries',
        value: maxRetries,
        message: 'maxRetries must be >= 0',
      });
    }
  }

  const maxRetriesResult = maxRetries ?? 2;

  return {

View on GitHub (pinned to 69428b1f8b)

When it happens

Trigger: Thrown at packages/ai/src/util/prepare-retries.ts:19 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of vercel/ai@69428b1f8b (2026-08-30). Data as JSON: /api/errors/7b7d596e2972f7a2. Report an issue: GitHub.