Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

3.8 KB
Raw Blame
"""A 429/529 must not be retried when the retry cannot succeed.

Anthropic answers an exhausted subscription or a hard rate limit with a 429 whose
Retry-After points minutes or hours ahead, and marks non-retryable errors with
``x-should-retry: false``. Retrying those after the capped backoff only holds the
client for ``retry_max_attempts * retry_max_delay_ms`` before returning the same
429, and every proxy layer chained in front multiplies that wait.

A Retry-After longer than one capped wait can still be reachable across the
remaining retries (each later 429 carries a shorter hint), so the budget is
``retries_left * retry_max_delay_ms``, not a single wait.
"""

import asyncio
import types

import httpx

from headroom.proxy.helpers import overload_retry_is_futile
from headroom.proxy.server import HeadroomProxy


def _resp(status, headers=None):
    req = httpx.Request("POST", "https://api.anthropic.com/v1/messages")
    return httpx.Response(
        status_code=status, request=req, headers=headers or {}, content=b'{"type":"error"}'
    )


class _FakeClient:
    def __init__(self, response):
        self._responses = response if isinstance(response, list) else None
        self._response = response
        self.calls = 0

    async def post(self, url, content=None, headers=None):
        self.calls += 1
        if self._responses is not None:
            return self._responses[self.calls - 1]
        return self._response


def _call(response, *, retry_max_delay_ms=30_000):
    proxy = HeadroomProxy.__new__(HeadroomProxy)
    client = _FakeClient(response)
    proxy.http_client = client
    proxy.config = types.SimpleNamespace(
        retry_enabled=True,
        retry_max_attempts=3,
        retry_base_delay_ms=1,
        retry_max_delay_ms=retry_max_delay_ms,
    )
    out = asyncio.run(
        proxy._retry_request("POST", "https://api.anthropic.com/v1/messages", {}, {}, stream=False)
    )
    return out, client.calls


def test_retry_after_beyond_cap_is_futile():
    assert overload_retry_is_futile(_resp(429, {"retry-after": "3600"}), 30_000)


def test_retry_after_within_cap_is_not_futile():
    assert not overload_retry_is_futile(_resp(429, {"retry-after": "5"}), 30_000)


def test_retry_after_within_remaining_retry_window_is_not_futile():
    # 31 s > one 30 s wait, but two retries left can still reach the reset.
    response = _resp(429, {"retry-after": "31"})
    assert not overload_retry_is_futile(response, 30_000, retries_left=2)
    assert overload_retry_is_futile(response, 30_000, retries_left=1)
    assert overload_retry_is_futile(_resp(429, {"retry-after": "61"}), 30_000, retries_left=2)


def test_should_retry_false_is_futile():
    assert overload_retry_is_futile(_resp(429, {"x-should-retry": "false"}), 30_000)


def test_no_hint_is_not_futile():
    assert not overload_retry_is_futile(_resp(529), 30_000)


def test_long_retry_after_429_returned_without_retry():
    out, calls = _call(_resp(429, {"retry-after": "3600"}))
    assert out.status_code == 429
    assert out.headers["retry-after"] == "3600"
    assert calls == 1


def test_should_retry_false_429_returned_without_retry():
    out, calls = _call(_resp(429, {"x-should-retry": "false"}))
    assert out.status_code == 429
    assert calls == 1


def test_short_retry_after_429_still_retried():
    out, calls = _call(_resp(429, {"retry-after": "0"}))
    assert out.status_code == 429
    assert calls == 3


def test_retry_after_reachable_across_retries_recovers():
    # Reset 31 ms away with a 20 ms cap: wait 20 ms, the next 429 says 1 ms,
    # wait 1 ms, and the final attempt succeeds.
    out, calls = _call(
        [
            _resp(429, {"retry-after": "0.031"}),
            _resp(429, {"retry-after": "0.001"}),
            _resp(200),
        ],
        retry_max_delay_ms=20,
    )
    assert out.status_code == 200
    assert calls == 3