openai/codex · error · ValueError

max_attempts must be >= 1

Error message

max_attempts must be >= 1

What it means

Error "max_attempts must be >= 1" thrown in openai/codex.

Source

Thrown at sdk/python/src/openai_codex/retry.py:23

from typing import Callable, TypeVar

from .errors import is_retryable_error

T = TypeVar("T")


def retry_on_overload(
    op: Callable[[], T],
    *,
    max_attempts: int = 3,
    initial_delay_s: float = 0.25,
    max_delay_s: float = 2.0,
    jitter_ratio: float = 0.2,
) -> T:
    """Retry helper for transient server-overload errors."""

    if max_attempts < 1:
        raise ValueError("max_attempts must be >= 1")

    delay = initial_delay_s
    attempt = 0
    while True:
        attempt += 1
        try:
            return op()
        except Exception as exc:
            if attempt >= max_attempts:
                raise
            if not is_retryable_error(exc):
                raise

            jitter = delay * jitter_ratio
            sleep_for = min(max_delay_s, delay) + random.uniform(-jitter, jitter)
            if sleep_for > 0:
                time.sleep(sleep_for)
            delay = min(max_delay_s, delay * 2)

View on GitHub (pinned to 339751715c)

Solutions

1. Pass max_attempts of at least 1.

When it happens

Trigger: Thrown at sdk/python/src/openai_codex/retry.py:23 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/09d496bda80fa8e2. Report an issue: GitHub.