From fba87d8ccb92ae47e50f8934e7bc169ed96905aa Mon Sep 17 00:00:00 2001
From: mateo <mateo@berri.ai>
Date: Tue, 3 Nov 2026 22:13:43 +0000
Subject: [PATCH] fix(proxy): cap in-flight Codex catalog fetches and bound the
 download while it streams

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
 .../common_utils/codex_catalog_source.py      | 13 ++++-
 .../common_utils/test_codex_catalog_source.py | 53 ++++++++++++++++++-
 2 files changed, 63 insertions(+), 3 deletions(-)

diff --git a/litellm/proxy/common_utils/codex_catalog_source.py b/litellm/proxy/common_utils/codex_catalog_source.py
index 8c2f1513658..75526454d66 100644
--- a/litellm/proxy/common_utils/codex_catalog_source.py
+++ b/litellm/proxy/common_utils/codex_catalog_source.py
@@ -56,6 +56,7 @@ class _AsyncGetClient(Protocol):
         *,
         headers: dict[str, str] | None = None,  # mutable-ok: httpx's own get signature
         timeout: float | None = None,
+        max_response_bytes: int | None = None,
     ) -> Awaitable[httpx.Response]: ...
 
 
@@ -145,6 +146,14 @@ class CodexCatalogSource:
         pending: Final = self._pending.get(tag)
         if pending is not None:
             return await asyncio.shield(pending)
+        if len(self._pending) >= self._cached_versions:
+            verbose_proxy_logger.warning(
+                "Codex catalog %s not fetched, %d fetches already in flight, serving the %s one",
+                tag,
+                len(self._pending),
+                vendored_codex_stock().source,
+            )
+            return vendored_codex_stock()
         task: Final = asyncio.ensure_future(self._resolve(tag, client_version, openai_api_key))
         self._pending[tag] = task
         task.add_done_callback(lambda _: self._pending.pop(tag, None))
@@ -231,7 +240,9 @@ class CodexCatalogSource:
     ) -> bytes | _FetchFailed:
         client: Final = self._client if self._client is not None else _default_client()
         try:
-            response: Final = await client.get(url, headers=headers, timeout=self._timeout)
+            response: Final = await client.get(
+                url, headers=headers, timeout=self._timeout, max_response_bytes=CODEX_CATALOG_MAX_BYTES
+            )
         except httpx.HTTPError as error:
             return _FetchFailed(reason=f"{type(error).__name__} fetching {url}")
         if response.status_code != 200:
diff --git a/tests/unit/proxy/common_utils/test_codex_catalog_source.py b/tests/unit/proxy/common_utils/test_codex_catalog_source.py
index de1363b31cc..966d0b00a10 100644
--- a/tests/unit/proxy/common_utils/test_codex_catalog_source.py
+++ b/tests/unit/proxy/common_utils/test_codex_catalog_source.py
@@ -9,6 +9,7 @@ from pydantic import JsonValue, TypeAdapter
 
 from litellm.proxy.common_utils.codex_catalog_source import (
     CODEX_CATALOG_BASE_URL,
+    CODEX_CATALOG_MAX_BYTES,
     CODEX_CATALOG_OPENAI_URL,
     CodexCatalogSource,
     codex_release_tag,
@@ -46,12 +47,19 @@ class _RawTree:
         self.replies = replies
         self.calls: list[str] = []
         self.headers: list[dict[str, str] | None] = []
+        self.byte_limits: list[int | None] = []
 
     async def get(
-        self, url: str, *, headers: dict[str, str] | None = None, timeout: float | None = None
+        self,
+        url: str,
+        *,
+        headers: dict[str, str] | None = None,
+        timeout: float | None = None,
+        max_response_bytes: int | None = None,
     ) -> httpx.Response:
         self.calls.append(url)
         self.headers.append(headers)
+        self.byte_limits.append(max_response_bytes)
         status, body = self.replies.get(url, (404, b"404: Not Found"))
         return httpx.Response(status, content=body)
 
@@ -158,7 +166,12 @@ def test_a_release_whose_pair_does_not_parse_serves_the_vendored_pair(replies: M
 def test_a_transport_error_serves_the_vendored_pair() -> None:
     class _Down:
         async def get(
-            self, url: str, *, headers: dict[str, str] | None = None, timeout: float | None = None
+            self,
+            url: str,
+            *,
+            headers: dict[str, str] | None = None,
+            timeout: float | None = None,
+            max_response_bytes: int | None = None,
         ) -> httpx.Response:
             raise httpx.ConnectError("offline", request=httpx.Request("GET", url))
 
@@ -251,3 +264,39 @@ def test_without_an_openai_key_openai_is_never_asked() -> None:
     stock = asyncio.run(_source(tree).stock(RELEASE))
     assert stock.source == f"github rust-v{RELEASE}"
     assert _openai_url(RELEASE) not in tree.calls and tree.headers == [None, None], tree.calls
+
+
+def test_every_fetch_caps_the_download_at_the_catalog_byte_limit_while_it_streams() -> None:
+    tree = _RawTree(_tree(RELEASE))
+    asyncio.run(_source(tree).stock(RELEASE))
+    assert tree.byte_limits == [CODEX_CATALOG_MAX_BYTES] * len(tree.calls) and tree.calls, tree.byte_limits
+
+
+def test_a_release_asked_for_while_the_in_flight_fetches_are_at_the_cap_gets_the_vendored_pair_without_a_fetch() -> (
+    None
+):
+    class _Hanging(_RawTree):
+        async def get(
+            self,
+            url: str,
+            *,
+            headers: dict[str, str] | None = None,
+            timeout: float | None = None,
+            max_response_bytes: int | None = None,
+        ) -> httpx.Response:
+            self.calls.append(url)
+            await asyncio.Event().wait()
+            raise AssertionError("unreachable")
+
+    async def scenario() -> tuple[str, list[str]]:
+        tree = _Hanging({})
+        source = _source(tree, cached_versions=2)
+        hung = [asyncio.ensure_future(source.stock(f"0.{n}.0")) for n in (150, 151)]
+        await asyncio.sleep(0)
+        over_cap = await source.stock("0.152.0")
+        for task in hung:
+            task.cancel()
+        return over_cap.source, list(tree.calls)
+
+    source_label, calls = asyncio.run(scenario())
+    assert source_label == vendored_codex_stock().source and not any("0.152.0" in url for url in calls), calls