codex-lb 0.3.0__tar.gz → 0.4.0__tar.gz

codex_lb-0.4.0/.all-contributorsrc

@@ -0,0 +1,71 @@
+{
+  "projectName": "codex-lb",
+  "projectOwner": "Soju06",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": true,
+  "commitConvention": "angular",
+  "contributors": [
+    {
+      "login": "Soju06",
+      "name": "Soju06",
+      "avatar_url": "https://avatars.githubusercontent.com/u/34199905?v=4",
+      "profile": "https://github.com/Soju06",
+      "contributions": [
+        "code",
+        "test",
+        "maintenance",
+        "infra"
+      ]
+    },
+    {
+      "login": "JKamsker",
+      "name": "Jonas Kamsker",
+      "avatar_url": "https://avatars.githubusercontent.com/u/11245306?v=4",
+      "profile": "http://jonas.kamsker.at/",
+      "contributions": [
+        "code",
+        "bug",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "Quack6765",
+      "name": "Quack",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5446230?v=4",
+      "profile": "https://github.com/Quack6765",
+      "contributions": [
+        "code",
+        "bug",
+        "maintenance",
+        "design"
+      ]
+    },
+    {
+      "login": "hhsw2015",
+      "name": "Jill Kok, San Mou",
+      "avatar_url": "https://avatars.githubusercontent.com/u/103614420?v=4",
+      "profile": "https://github.com/hhsw2015",
+      "contributions": [
+        "code",
+        "test"
+      ]
+    },
+    {
+      "login": "pcy06",
+      "name": "PARK CHANYOUNG",
+      "avatar_url": "https://avatars.githubusercontent.com/u/44970486?v=4",
+      "profile": "https://github.com/pcy06",
+      "contributions": [
+        "doc"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "linkToUsage": false,
+  "commitType": "docs"
+}

codex_lb-0.4.0/.github/release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.0"
+}

{codex_lb-0.3.0 → codex_lb-0.4.0}/.github/workflows/ci.yml

@@ -30,6 +30,26 @@ jobs:
       - name: Ruff format (check)
         run: uvx ruff format --check .
 
+  typecheck:
+    name: Type check (ty)
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --dev --frozen
+
+      - name: Ty check
+        run: uv run ty check
+
   test:
     name: Tests (pytest)
     runs-on: ubuntu-24.04

{codex_lb-0.3.0 → codex_lb-0.4.0}/AGENTS.md

@@ -1,16 +1,26 @@
 # AGENTS
 
 ## Environment
+
 - Python: .venv/bin/python (uv, CPython 3.13.3)
 
 ## Code Conventions (Typing & Data Contracts)
+
 - Prefer strict typing end-to-end. Avoid `dict`, `Mapping[str, object]`, and `object` in app/service/repository layers when the shape is known.
 - Use explicit dataclasses or Pydantic models for internal payloads; convert to response schemas at the edge.
 - ORM models should be passed through services instead of generic containers; avoid `getattr`/`[]` access on ORM results.
 - Expose time values in dashboard APIs as ISO 8601 strings (`datetime` in schemas), not epoch numbers.
 - If a test depends on a contract change (field name/type), update the test to match the new typed schema.
 
+## Code Conventions (Anti-Patterns to Avoid)
+
+- **No Speculative Fallbacks**: Do not use multiple keys for the same configuration (e.g., `os.getenv("A") or os.getenv("B")`). Pick one canonical name and stick to it.
+- **Single Source of Truth**: Do not create redundant fields in data models (JSON/DB) that represent the same state. Calculate derived values dynamically.
+- **Fail Fast**: Do not clutter code with excessive `None` checks or fallback defaults for critical configurations. Raise explicit errors for missing or invalid configuration.
+- **Refactor over Duplicate**: Do not duplicate logic to avoid touching existing code. Refactor the existing code to support the new requirement.
+
 ## Code Conventions (Structure & Responsibilities)
+
 - Keep domain boundaries clear: `core/` for reusable logic, `modules/*` for API-facing features, `db/` for persistence, `static/` for dashboard assets.
 - Follow module layout conventions in `app/modules/<feature>/`: `api.py` (routes), `service.py` (business logic), `repository.py` (DB access), `schemas.py` (Pydantic I/O models).
 - Prefer small, focused files; split when a file grows beyond a single responsibility or mixes layers.
@@ -20,6 +30,7 @@
 - Validate inputs early and fail fast with clear errors; never silently coerce invalid types.
 
 ## Code Conventions (Testing / TC)
+
 - Add or update tests whenever contracts change (field names/types, response formats, default values).
 - Keep unit tests under `tests/unit` and integration tests under `tests/integration` using existing markers.
 - Tests should assert public behavior (API responses, service outputs) rather than internal implementation details.
@@ -27,6 +38,7 @@
 - Prefer deterministic inputs (fixed timestamps, explicit payloads) to avoid flaky tests.
 
 ## Code Conventions (DI & Context)
+
 - Use FastAPI `Depends` providers in `app/dependencies.py` to construct per-request contexts (`*Context` dataclasses).
 - Contexts should hold only the session, repositories, and service for a single module; avoid cross-module service coupling.
 - Repositories must be constructed with the request-scoped `AsyncSession` from `get_session`; no global sessions.
@@ -35,6 +47,7 @@
 - When adding a new module, define `api.py` endpoints that depend on a module-specific context provider.
 
 ## Git Workflow & Contribution
+
 1. **Important**: Create branches, commits, or PRs **only upon explicit user request**. Implicit actions are not allowed.
 2. **Branch Naming**: Use prefixes like `feature/`, `fix/`, `chore/` (e.g., `feature/add-login`).
 3. **Commit Messages**: Follow [Conventional Commits](https://www.conventionalcommits.org/).
@@ -42,6 +55,7 @@
    - Types: `feat`, `fix`, `docs`, `refactor`, `chore`, `test`
    - Example: `feat(api): add auth endpoint`
 4. **Workflow**:
+
    ```bash
    git checkout -b feature/add-login
    git commit -m "feat(api): add auth endpoint"
@@ -49,4 +63,5 @@
    git push -u origin feature/add-login
    gh pr create --title "feat(api): add auth" --body "..."
    ```
+
 5. **Best Practices**: Commit often in small units. Do not commit directly to `main`. Always check `git diff` before pushing.

{codex_lb-0.3.0 → codex_lb-0.4.0}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.4.0](https://github.com/Soju06/codex-lb/compare/v0.3.1...v0.4.0) (2026-01-26)
+
+
+### Features
+
+* **proxy:** add v1 responses compatibility for OpenCode ([#28](https://github.com/Soju06/codex-lb/issues/28)) ([04d58d2](https://github.com/Soju06/codex-lb/commit/04d58d2430e4ba88f28e9e811f08b628e9a4674c))
+
+
+### Bug Fixes
+
+* **dashboard:** remove rounding in avgPerHour calculation ([#29](https://github.com/Soju06/codex-lb/issues/29)) ([b432939](https://github.com/Soju06/codex-lb/commit/b432939d6ea832d917658dfdbcb935f88f9e08a6)), closes [#26](https://github.com/Soju06/codex-lb/issues/26)
+
+
+### Documentation
+
+* add hhsw2015 as a contributor for code, and test ([#31](https://github.com/Soju06/codex-lb/issues/31)) ([a1f0e79](https://github.com/Soju06/codex-lb/commit/a1f0e796e45862e520953f60716d2b5eaab3a0d9))
+* add opencode setup guide ([#32](https://github.com/Soju06/codex-lb/issues/32)) ([9330619](https://github.com/Soju06/codex-lb/commit/93306198902e558e6bce89719d7cd6b1e797ddc5))
+* add pcy06 as a contributor for doc ([#34](https://github.com/Soju06/codex-lb/issues/34)) ([506b7b1](https://github.com/Soju06/codex-lb/commit/506b7b160b11b558533fafb39793870ceefd9131))
+
+## [0.3.1](https://github.com/Soju06/codex-lb/compare/v0.3.0...v0.3.1) (2026-01-22)
+
+
+### Documentation
+
+* add Quack6765 as a contributor for design ([7a5ec08](https://github.com/Soju06/codex-lb/commit/7a5ec084b9a8d32c844127739f826a5f83bf1440))
+* update .all-contributorsrc ([14ea9da](https://github.com/Soju06/codex-lb/commit/14ea9da361a978a56c4d1f7facefe789193c7b91))
+* update README.md ([f283d60](https://github.com/Soju06/codex-lb/commit/f283d60ae359585cd128a965ca6fba2a14249a11))
+
 ## [0.3.0](https://github.com/Soju06/codex-lb/compare/v0.2.0...v0.3.0) (2026-01-21)
 
 

codex_lb-0.4.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: codex-lb
+Version: 0.4.0
+Summary: Codex load balancer and proxy for ChatGPT accounts with usage dashboard
+Author-email: Soju06 <qlskssk@gmail.com>
+Maintainer-email: Soju06 <qlskssk@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Soju06
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: chatgpt,codex,dashboard,fastapi,load-balancer,proxy,rate-limit,usage
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: Proxy Servers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.13
+Requires-Dist: aiohttp-retry>=2.9.1
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: cryptography>=46.0.3
+Requires-Dist: fastapi[standard]>=0.128.0
+Requires-Dist: greenlet>=3.3.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: python-multipart>=0.0.21
+Requires-Dist: sqlalchemy>=2.0.45
+Description-Content-Type: text/markdown
+
+<!--
+About
+Codex/ChatGPT account load balancer & proxy with usage tracking, dashboard, and OpenCode-compatible endpoints
+
+Topics
+python oauth sqlalchemy dashboard load-balancer openai rate-limit api-proxy codex fastapi usage-tracking chatgpt opencode
+
+Resources
+-->
+
+# codex-lb
+
+Load balancer for ChatGPT accounts. Pool multiple accounts, track usage, view everything in a dashboard.
+
+## Screenshots
+
+### Main Dashboard View
+
+![main dashboard view](docs/screenshots/dashboard.jpg)
+
+### Accounts View
+
+![Accounts list and details](docs/screenshots/accounts.jpg)
+
+## Quick Start
+
+### Docker
+
+```bash
+docker run -d --name codex-lb \
+  -p 2455:2455 -p 1455:1455 \
+  -v ~/.codex-lb:/var/lib/codex-lb \
+  ghcr.io/soju06/codex-lb:latest
+```
+
+### uvx
+
+```bash
+uvx codex-lb
+```
+
+Open [localhost:2455](http://localhost:2455) → Add account → Done.
+
+## Codex CLI & Extension Setup
+
+Add to `~/.codex/config.toml`:
+
+```toml
+model = "gpt-5.2-codex"
+model_reasoning_effort = "xhigh"
+model_provider = "codex-lb"
+
+[model_providers.codex-lb]
+name = "OpenAI"  # MUST be "OpenAI" - enables /compact endpoint
+base_url = "http://127.0.0.1:2455/backend-api/codex"
+wire_api = "responses"
+chatgpt_base_url = "http://127.0.0.1:2455"
+requires_openai_auth = true  # Required: enables model selection in Codex IDE extension
+```
+
+## OpenCode Setup
+
+Run:
+
+```bash
+opencode auth login
+```
+
+Then select `OpenAI` -> `Manually enter API Key` and enter any value.
+
+Add the following to `~/.config/opencode/opencode.json`:
+
+```jsonc
+{
+  ...
+  "provider": {
+    "openai": {
+      "options": {
+        "baseURL": "http://127.0.0.1:2455/v1"
+      }
+    },
+    ...
+  }
+}
+```
+
+## Data
+
+All data stored in `~/.codex-lb/`:
+
+- `store.db` – accounts, usage logs
+- `encryption.key` – encrypts tokens (auto-generated)
+
+Backup this directory to preserve your accounts.
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Soju06"><img src="https://avatars.githubusercontent.com/u/34199905?v=4?s=100" width="100px;" alt="Soju06"/><br /><sub><b>Soju06</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Tests">⚠️</a> <a href="#maintenance-Soju06" title="Maintenance">🚧</a> <a href="#infra-Soju06" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://jonas.kamsker.at/"><img src="https://avatars.githubusercontent.com/u/11245306?v=4?s=100" width="100px;" alt="Jonas Kamsker"/><br /><sub><b>Jonas Kamsker</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=JKamsker" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AJKamsker" title="Bug reports">🐛</a> <a href="#maintenance-JKamsker" title="Maintenance">🚧</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Quack6765"><img src="https://avatars.githubusercontent.com/u/5446230?v=4?s=100" width="100px;" alt="Quack"/><br /><sub><b>Quack</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Quack6765" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AQuack6765" title="Bug reports">🐛</a> <a href="#maintenance-Quack6765" title="Maintenance">🚧</a> <a href="#design-Quack6765" title="Design">🎨</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hhsw2015"><img src="https://avatars.githubusercontent.com/u/103614420?v=4?s=100" width="100px;" alt="Jill Kok, San Mou"/><br /><sub><b>Jill Kok, San Mou</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=hhsw2015" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/commits?author=hhsw2015" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/pcy06"><img src="https://avatars.githubusercontent.com/u/44970486?v=4?s=100" width="100px;" alt="PARK CHANYOUNG"/><br /><sub><b>PARK CHANYOUNG</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=pcy06" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

codex_lb-0.4.0/README.md

@@ -0,0 +1,119 @@
+<!--
+About
+Codex/ChatGPT account load balancer & proxy with usage tracking, dashboard, and OpenCode-compatible endpoints
+
+Topics
+python oauth sqlalchemy dashboard load-balancer openai rate-limit api-proxy codex fastapi usage-tracking chatgpt opencode
+
+Resources
+-->
+
+# codex-lb
+
+Load balancer for ChatGPT accounts. Pool multiple accounts, track usage, view everything in a dashboard.
+
+## Screenshots
+
+### Main Dashboard View
+
+![main dashboard view](docs/screenshots/dashboard.jpg)
+
+### Accounts View
+
+![Accounts list and details](docs/screenshots/accounts.jpg)
+
+## Quick Start
+
+### Docker
+
+```bash
+docker run -d --name codex-lb \
+  -p 2455:2455 -p 1455:1455 \
+  -v ~/.codex-lb:/var/lib/codex-lb \
+  ghcr.io/soju06/codex-lb:latest
+```
+
+### uvx
+
+```bash
+uvx codex-lb
+```
+
+Open [localhost:2455](http://localhost:2455) → Add account → Done.
+
+## Codex CLI & Extension Setup
+
+Add to `~/.codex/config.toml`:
+
+```toml
+model = "gpt-5.2-codex"
+model_reasoning_effort = "xhigh"
+model_provider = "codex-lb"
+
+[model_providers.codex-lb]
+name = "OpenAI"  # MUST be "OpenAI" - enables /compact endpoint
+base_url = "http://127.0.0.1:2455/backend-api/codex"
+wire_api = "responses"
+chatgpt_base_url = "http://127.0.0.1:2455"
+requires_openai_auth = true  # Required: enables model selection in Codex IDE extension
+```
+
+## OpenCode Setup
+
+Run:
+
+```bash
+opencode auth login
+```
+
+Then select `OpenAI` -> `Manually enter API Key` and enter any value.
+
+Add the following to `~/.config/opencode/opencode.json`:
+
+```jsonc
+{
+  ...
+  "provider": {
+    "openai": {
+      "options": {
+        "baseURL": "http://127.0.0.1:2455/v1"
+      }
+    },
+    ...
+  }
+}
+```
+
+## Data
+
+All data stored in `~/.codex-lb/`:
+
+- `store.db` – accounts, usage logs
+- `encryption.key` – encrypts tokens (auto-generated)
+
+Backup this directory to preserve your accounts.
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Soju06"><img src="https://avatars.githubusercontent.com/u/34199905?v=4?s=100" width="100px;" alt="Soju06"/><br /><sub><b>Soju06</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/commits?author=Soju06" title="Tests">⚠️</a> <a href="#maintenance-Soju06" title="Maintenance">🚧</a> <a href="#infra-Soju06" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://jonas.kamsker.at/"><img src="https://avatars.githubusercontent.com/u/11245306?v=4?s=100" width="100px;" alt="Jonas Kamsker"/><br /><sub><b>Jonas Kamsker</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=JKamsker" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AJKamsker" title="Bug reports">🐛</a> <a href="#maintenance-JKamsker" title="Maintenance">🚧</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Quack6765"><img src="https://avatars.githubusercontent.com/u/5446230?v=4?s=100" width="100px;" alt="Quack"/><br /><sub><b>Quack</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=Quack6765" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/issues?q=author%3AQuack6765" title="Bug reports">🐛</a> <a href="#maintenance-Quack6765" title="Maintenance">🚧</a> <a href="#design-Quack6765" title="Design">🎨</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hhsw2015"><img src="https://avatars.githubusercontent.com/u/103614420?v=4?s=100" width="100px;" alt="Jill Kok, San Mou"/><br /><sub><b>Jill Kok, San Mou</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=hhsw2015" title="Code">💻</a> <a href="https://github.com/Soju06/codex-lb/commits?author=hhsw2015" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/pcy06"><img src="https://avatars.githubusercontent.com/u/44970486?v=4?s=100" width="100px;" alt="PARK CHANYOUNG"/><br /><sub><b>PARK CHANYOUNG</b></sub></a><br /><a href="https://github.com/Soju06/codex-lb/commits?author=pcy06" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

{codex_lb-0.3.0 → codex_lb-0.4.0}/app/core/clients/proxy.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import asyncio
-from typing import AsyncIterator, Mapping
+from typing import AsyncIterator, Mapping, Protocol, TypeAlias
 
 import aiohttp
 
@@ -28,6 +28,18 @@ class StreamIdleTimeoutError(Exception):
     pass
 
 
+class ErrorResponseProtocol(Protocol):
+    status: int
+    reason: str | None
+
+    async def json(self, *, content_type: str | None = None) -> object: ...
+
+    async def text(self, *, encoding: str | None = None, errors: str = "strict") -> str: ...
+
+
+ErrorResponse: TypeAlias = aiohttp.ClientResponse | ErrorResponseProtocol
+
+
 class ProxyResponseError(Exception):
     def __init__(self, status_code: int, payload: OpenAIErrorEnvelope) -> None:
         super().__init__(f"Proxy response error ({status_code})")
@@ -88,8 +100,10 @@ async def _iter_sse_lines(
         yield line
 
 
-async def _error_event_from_response(resp: aiohttp.ClientResponse) -> ResponseFailedEvent:
+async def _error_event_from_response(resp: ErrorResponse) -> ResponseFailedEvent:
     fallback_message = f"Upstream error: HTTP {resp.status}"
+    if resp.reason:
+        fallback_message += f" {resp.reason}"
     try:
         data = await resp.json(content_type=None)
     except Exception:
@@ -112,11 +126,16 @@ async def _error_event_from_response(resp: aiohttp.ClientResponse) -> ResponseFa
                 if key in payload:
                     event["response"]["error"][key] = payload[key]
             return event
+        message = _extract_upstream_message(data)
+        if message:
+            return response_failed_event("upstream_error", message, response_id=get_request_id())
     return response_failed_event("upstream_error", fallback_message, response_id=get_request_id())
 
 
-async def _error_payload_from_response(resp: aiohttp.ClientResponse) -> OpenAIErrorEnvelope:
+async def _error_payload_from_response(resp: ErrorResponse) -> OpenAIErrorEnvelope:
     fallback_message = f"Upstream error: HTTP {resp.status}"
+    if resp.reason:
+        fallback_message += f" {resp.reason}"
     try:
         data = await resp.json(content_type=None)
     except Exception:
@@ -128,9 +147,20 @@ async def _error_payload_from_response(resp: aiohttp.ClientResponse) -> OpenAIEr
         error = parse_error_payload(data)
         if error:
             return {"error": error.model_dump(exclude_none=True)}
+        message = _extract_upstream_message(data)
+        if message:
+            return openai_error("upstream_error", message)
     return openai_error("upstream_error", fallback_message)
 
 
+def _extract_upstream_message(data: dict) -> str | None:
+    for key in ("message", "detail", "error"):
+        value = data.get(key)
+        if isinstance(value, str) and value.strip():
+            return value
+    return None
+
+
 async def stream_responses(
     payload: ResponsesRequest,
     headers: Mapping[str, str],

{codex_lb-0.3.0 → codex_lb-0.4.0}/app/core/config/settings.py

@@ -42,6 +42,7 @@ class Settings(BaseSettings):
     database_migrations_fail_fast: bool = True
     log_proxy_request_shape: bool = False
     log_proxy_request_shape_raw_cache_key: bool = False
+    log_proxy_request_payload: bool = False
 
     @field_validator("database_url")
     @classmethod

{codex_lb-0.3.0 → codex_lb-0.4.0}/app/core/openai/requests.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 from app.core.types import JsonObject, JsonValue
 
@@ -44,8 +44,16 @@ class ResponsesRequest(BaseModel):
     prompt_cache_key: str | None = None
     text: ResponsesTextControls | None = None
 
+    @field_validator("store")
+    @classmethod
+    def _ensure_store_false(cls, value: bool | None) -> bool | None:
+        if value is True:
+            raise ValueError("store must be false")
+        return value
+
     def to_payload(self) -> JsonObject:
-        return self.model_dump(mode="json", exclude_none=True)
+        payload = self.model_dump(mode="json", exclude_none=True)
+        return _strip_unsupported_fields(payload)
 
 
 class ResponsesCompactRequest(BaseModel):
@@ -56,4 +64,14 @@ class ResponsesCompactRequest(BaseModel):
     input: list[JsonValue]
 
     def to_payload(self) -> JsonObject:
-        return self.model_dump(mode="json", exclude_none=True)
+        payload = self.model_dump(mode="json", exclude_none=True)
+        return _strip_unsupported_fields(payload)
+
+
+_UNSUPPORTED_UPSTREAM_FIELDS = {"max_output_tokens"}
+
+
+def _strip_unsupported_fields(payload: dict[str, JsonValue]) -> dict[str, JsonValue]:
+    for key in _UNSUPPORTED_UPSTREAM_FIELDS:
+        payload.pop(key, None)
+    return payload