codex-proxy 3.1.0__tar.gz

codex_proxy-3.1.0/.dockerignore

@@ -0,0 +1,6 @@
+__pycache__
+*.pyc
+.git
+.venv
+.env
+tests/

codex_proxy-3.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,22 @@
+---
+name: Bug report
+about: Report a problem with codex-proxy
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce:
+1. Configure provider '...'
+2. Send request '...'
+3. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- codex-proxy version:
+- Python version:
+- Provider:
+- OS:

codex_proxy-3.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature request
+about: Suggest a feature for codex-proxy
+---
+
+**Problem**
+What problem does this feature solve?
+
+**Proposed solution**
+Describe the feature you'd like.
+
+**Alternatives considered**
+Any alternative approaches you've thought of.

codex_proxy-3.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+<!-- Brief description of changes -->
+
+## Checklist
+
+- [ ] All tests pass (`pytest tests/ -v`)
+- [ ] No lint errors (`ruff check src/ tests/`)
+- [ ] Type hints on new functions
+- [ ] Docstrings on new classes/public functions

codex_proxy-3.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Lint with ruff
+        run: ruff check src/ tests/
+      - name: Run tests
+        run: pytest tests/ -v --tb=short
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

codex_proxy-3.1.0/.github/workflows/release.yml

@@ -0,0 +1,22 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build
+        run: |
+          pip install build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

codex_proxy-3.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.log
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+codex_prompt.md
+implementation_plan.md

codex_proxy-3.1.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

codex_proxy-3.1.0/CHANGELOG.md

@@ -0,0 +1,74 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+
+## [3.1.0] - 2026-06-01
+
+### Added
+- Dynamic, unified configuration and service reloading across HTTP and TUI (`reload_config_internal`).
+- Instant, non-blocking Unix/macOS keyboard input using `termios`/`tty` cbreak mode.
+
+## [2.0.1] - 2026-05-31
+
+### Fixed
+
+- **Compaction config threading**: `max_messages` and `keep_last` from config.toml
+  are now correctly passed to the compaction engine (were previously hardcoded)
+- **Circuit breaker type annotation**: `AppState.circuit_breaker` now correctly
+  typed as `CircuitBreaker | None`
+- **Circuit breaker coverage**: Now protects streaming HTTP and WebSocket paths
+  (was only protecting non-streaming HTTP)
+- **Config reload**: `/reload` now recreates circuit breaker with new config values
+- **Example config**: `codex-proxy --init` now generates `[circuit_breaker]` and
+  `[compaction]` sections
+
+### Added
+
+- `--print-config` now shows circuit_breaker and compaction settings
+- MIT `LICENSE` file
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-05-31
+
+### Added
+
+- **6 new provider adapters** for broader LLM ecosystem support:
+  - Anthropic — `x-api-key` header and `anthropic-version` handling
+  - Gemini — Google's OpenAI-compatible endpoint
+  - DeepSeek — stream_options stripping
+  - Mistral — OpenAI-compatible with stream_options handling
+  - Cohere — OpenAI-compatible endpoint
+  - NVIDIA — NIM OpenAI-compatible endpoint
+- **Circuit breaker** for upstream resilience — protects against failing providers
+  with configurable failure threshold, recovery timeout, and half-open state
+- **Context compaction** for long conversations — automatically trims message
+  history to fit within limits while preserving system prompts and recent context
+- **CI/CD pipeline** (GitHub Actions) — automated lint, test, and release workflows
+- **Docker Compose** support — one-command containerized deployment with health checks
+- **Pre-commit hooks** — Ruff linting and formatting on every commit
+- **112+ tests** covering translator, config, store, server, providers, circuit
+  breaker, and compaction modules
+- **CONTRIBUTING.md** — development setup, code style, PR process, and commit conventions
+- **CODE_OF_CONDUCT.md** — community guidelines
+- **Issue templates** and **PR template** for structured contributions
+
+## [1.0.0] - 2026-05-19
+
+### Added
+
+- Core **Responses API to Chat Completions** protocol translation
+- **Streaming SSE** support with real-time token delivery
+- **WebSocket** support with full Realtime API envelope handling
+- **Reasoning/thinking token** passthrough from supported models
+- **Tool calls** — full function calling support (definitions + results)
+- **Multi-turn conversations** via `previous_response_id` with in-memory response store
+- **Multi-provider** backend — switch between Z.AI, Groq, Together AI, OpenRouter,
+  Ollama, Fireworks, and more with a single config change
+- **Usage tracking** — captures token counts from streaming responses
+- **Auto-retry** — one retry on 5xx/transport errors for non-streaming requests
+- **TOML configuration** file with env var and CLI flag overrides
+- **FastAPI** server with `/responses`, `/models`, `/health`, `/status`, and `/reload` endpoints
+- **Dockerfile** for containerized deployment
+- **CLI** with `--init`, `--print-config`, `--port`, `--host`, and `--config` options

codex_proxy-3.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,33 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Being respectful of differing viewpoints
+* Giving and gracefully accepting constructive feedback
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* Harassment, insulting comments, or personal attacks
+* Publishing others' private information without permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at zakarinoo@gmail.com.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1.
+
+[homepage]: https://www.contributor-covenant.org

codex_proxy-3.1.0/CONTRIBUTING.md

@@ -0,0 +1,127 @@
+# Contributing to codex-proxy
+
+Thanks for your interest in contributing! This guide covers everything you need to get started.
+
+## Development Setup
+
+1. **Fork** the repository on GitHub
+2. **Clone** your fork locally:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/codex-proxy.git
+   cd codex-proxy
+   ```
+3. **Install** in editable mode with dev dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+4. **Install pre-commit hooks** (optional but recommended):
+   ```bash
+   pre-commit install
+   ```
+
+## Code Style
+
+- **Formatter & Linter**: [Ruff](https://docs.astral.sh/ruff/) — configuration lives in `pyproject.toml`
+- **Target**: Python 3.10+
+- **Line length**: 100 characters (E501 is ignored)
+- **Type hints**: Encouraged on public APIs; `mypy` is available for checking
+- **Data structures**: Use `@dataclass` for structured data (see `circuit_breaker.py` for reference)
+- **Imports**: Sorted with isort via Ruff; first-party imports use `codex_proxy`
+
+### Running the linter
+
+```bash
+ruff check src/ tests/
+ruff format src/ tests/
+```
+
+### Type checking
+
+```bash
+mypy src/
+```
+
+## Running Tests
+
+```bash
+# Run full suite
+pytest tests/ -v
+
+# Run a specific test file
+pytest tests/test_translator.py -v
+
+# Run with coverage
+pytest tests/ -v --tb=short
+```
+
+The test suite uses **pytest** with 112+ tests covering the translator, config, store, server, providers, circuit breaker, and compaction modules.
+
+## Project Structure
+
+```
+codex-proxy/
+  src/codex_proxy/       # Main package
+    __init__.py          # Package init
+    __main__.py          # CLI entry point
+    server.py            # FastAPI app + endpoints
+    translator.py        # Responses API <-> Chat Completions
+    config.py            # TOML config loading
+    store.py             # In-memory response store
+    providers.py         # Provider-specific adapters
+    circuit_breaker.py   # Upstream resilience
+    compaction.py        # Context compaction
+  tests/                 # Test suite
+  .github/workflows/     # CI/CD pipelines
+```
+
+## Pull Request Process
+
+1. **Create a branch** from `main`:
+   ```bash
+   git checkout -b feat/your-feature-name
+   ```
+2. **Make your changes** and add tests for new functionality
+3. **Run checks** before pushing:
+   ```bash
+   ruff check src/ tests/
+   pytest tests/ -v
+   ```
+4. **Push** to your fork:
+   ```bash
+   git push origin feat/your-feature-name
+   ```
+5. **Open a Pull Request** against the `main` branch
+
+### PR Guidelines
+
+- Keep PRs focused — one feature or fix per PR
+- Add tests for any new behavior
+- Update `README.md` if you change user-facing functionality
+- All CI checks must pass (lint + tests)
+
+## Commit Messages
+
+Use [Conventional Commits](https://www.conventionalcommits.org/) style:
+
+```
+feat: add streaming retry with exponential backoff
+fix: correct WebSocket close frame handling
+refactor: extract shared streaming core
+test: add circuit breaker edge case tests
+docs: update provider configuration examples
+chore: bump ruff to v0.9
+```
+
+**Format**: `type: short description`
+
+Common types: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`, `ci`, `perf`
+
+## Reporting Issues
+
+- Use [GitHub Issues](https://github.com/ZakPro/codex-proxy/issues) for bugs and feature requests
+- Include your Python version, OS, and relevant config (redact API keys)
+- For bugs, provide steps to reproduce and any error output
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

codex_proxy-3.1.0/Dockerfile

@@ -0,0 +1,9 @@
+FROM python:3.12-slim
+WORKDIR /app
+COPY pyproject.toml .
+COPY src/ src/
+RUN pip install --no-cache-dir .
+EXPOSE 4242
+ENV CODEX_PROXY_API_KEY=""
+ENV CODEX_PROXY_BASE_URL=""
+CMD ["codex-proxy"]

codex_proxy-3.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZakPro
+
+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.

codex_proxy-3.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: codex-proxy
+Version: 3.1.0
+Summary: Responses API to Chat Completions bridge for OpenAI Codex CLI
+Project-URL: Repository, https://github.com/ZiryaNoov/codex-proxy
+Author-email: ZakPro <zakarinoo@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: chat-completions,codex,glm,openai,proxy,responses-api,z.ai
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: uvicorn>=0.30
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Provides-Extra: tui
+Requires-Dist: rich>=13.0; extra == 'tui'