ccproxy-api 0.1.5__tar.gz → 0.1.6__tar.gz

{ccproxy_api-0.1.5 → ccproxy_api-0.1.6}/.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 repos:
   # Ruff linting and formatting
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.2
+    rev: v0.12.8
     hooks:
       # Ruff linting (matches: make lint -> uv run ruff check .)
       - id: ruff
@@ -16,7 +16,7 @@ repos:
 
   # MyPy type checking (matches: make typecheck -> uv run mypy .)
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.16.1
+    rev: v1.17.1
     hooks:
       - id: mypy
         name: mypy type check
@@ -58,6 +58,7 @@ repos:
           - textual>=3.7.1
           - aiofiles>=24.1.0
           - types-aiofiles>=24.0.0
+          - pyjwt>=2.10.0
         args: [--config-file=pyproject.toml]
         exclude: ^(docs/|examples/)
 
@@ -81,7 +82,7 @@ repos:
 
   # General file checks
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       # Basic file checks
       - id: trailing-whitespace

{ccproxy_api-0.1.5 → ccproxy_api-0.1.6}/CHANGELOG.md

@@ -5,48 +5,196 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.1.6] - 2025-08-04
+
+## Added OpenAI Codex Provider with Full Proxy Support
+
+### Overview
+
+Implemented comprehensive support for OpenAI Codex CLI integration, enabling users to proxy requests through their OpenAI subscription via the ChatGPT backend API. This feature provides an alternative to the Claude provider while maintaining full compatibility with the existing proxy architecture. The implementation uses the OpenAI Responses API endpoint as documented at https://platform.openai.com/docs/api-reference/responses/get.
+
+### Key Features
+
+**Complete Codex API Proxy**
+
+- Full reverse proxy to `https://chatgpt.com/backend-api/codex`
+- Support for both `/codex/responses` and `/codex/{session_id}/responses` endpoints
+- Compatible with Codex CLI 0.21.0 and authentication flow
+- Implements OpenAI Responses API protocol
+
+**OAuth PKCE Authentication Flow**
+
+- Implements complete OpenAI OAuth 2.0 PKCE flow matching official Codex CLI
+- Local callback server on port 1455 for authorization code exchange
+- Token refresh and credential management with persistent storage
+- Support for `~/.codex/auth.json` configuration file format
+
+**Intelligent Request/Response Handling**
+
+- Automatic detection and injection of Codex CLI instructions field
+- Smart streaming behavior based on user's explicit `stream` parameter
+- Session management with flexible session ID handling (auto-generated, persistent, header-forwarded)
+- Request transformation preserving Codex CLI identity headers
+
+**Advanced Configuration**
+
+- Environment variable support: `CODEX__BASE_URL`
+- Configurable via TOML: `[codex]` section in configuration files
+- Debug logging with request/response capture capabilities
+- Comprehensive error handling with proper HTTP status codes
+- Enabled by default
+
+### Technical Implementation
+
+**New Components Added:**
+
+- `ccproxy/auth/openai.py` - OAuth token management and credential storage
+- `ccproxy/core/codex_transformers.py` - Request/response transformation for Codex format
+- `ccproxy/api/routes/codex.py` - FastAPI routes for Codex endpoints
+- `ccproxy/models/detection.py` - Codex CLI detection and header management
+- `ccproxy/services/codex_detection_service.py` - Runtime detection of Codex CLI requests
+
+**Enhanced Proxy Service:**
+
+- Extended `ProxyService.handle_codex_request()` with full Codex support
+- Intelligent streaming response conversion when user doesn't explicitly request streaming
+- Comprehensive request/response logging for debugging
+- Error handling with proper OpenAI-compatible error responses
+
+### Streaming Behavior Fix
+
+**Problem Resolved:** Fixed issue where requests without explicit `stream` field were incorrectly returning streaming responses.
+
+**Solution Implemented:**
+
+- When `"stream"` field is missing: Inject `"stream": true` for upstream (Codex requirement) but return JSON response to client
+- When `"stream": true` explicitly set: Return streaming response to client
+- When `"stream": false` explicitly set: Return JSON response to client
+- Smart response conversion: collects streaming data and converts to single JSON response when user didn't request streaming
+
+### Usage Examples
+
+**Basic Request (JSON Response):**
+
+```bash
+curl -X POST "http://127.0.0.1:8000/codex/responses" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "input": [{"type": "message", "role": "user", "content": [{"type": "input_text", "text": "Hello!"}]}],
+    "model": "gpt-5",
+    "store": false
+  }'
+```
+
+**Streaming Request:**
+
+```bash
+curl -X POST "http://127.0.0.1:8000/codex/responses" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "input": [{"type": "message", "role": "user", "content": [{"type": "input_text", "text": "Hello!"}]}],
+    "model": "gpt-5",
+    "stream": true,
+    "store": false
+  }'
+```
+
+### Authentication Setup
+
+**Environment Variables:**
+
+```bash
+export CODEX__BASE_URL="https://chatgpt.com/backend-api/codex"
+```
+
+**Configuration File (`~/.ccproxy.toml`):**
+
+```toml
+[codex]
+base_url = "https://chatgpt.com/backend-api/codex"
+```
+
+### Compatibility
+
+- Codex CLI: Full compatibility with `codex-cli 0.21.0`
+- OpenAI OAuth: Complete PKCE flow implementation
+- Session Management: Supports persistent and auto-generated sessions
+- Model Support: All Codex-supported models (`gpt-5`, `gpt-4`, etc.)
+- Streaming: Both streaming and non-streaming responses
+- Error Handling: Proper HTTP status codes and OpenAI-compatible errors
+- API Compliance: Follows OpenAI Responses API specification
+
+### Files Modified/Added
+
+**New Files:**
+
+- `ccproxy/auth/openai.py` - OpenAI authentication management
+- `ccproxy/core/codex_transformers.py` - Codex request/response transformation
+- `ccproxy/api/routes/codex.py` - Codex API endpoints
+- `ccproxy/models/detection.py` - Codex detection models
+- `ccproxy/services/codex_detection_service.py` - Codex CLI detection service
+
+**Modified Files:**
+
+- `ccproxy/services/proxy_service.py` - Added `handle_codex_request()` method
+- `ccproxy/config/settings.py` - Added Codex configuration section
+- `ccproxy/api/app.py` - Integrated Codex routes
+- `ccproxy/api/routes/health.py` - Added Codex health checks
+
+### Breaking Changes
+
+None. This is a purely additive feature that doesn't affect existing Claude provider functionality.
+
+### Migration Notes
+
+For users wanting to use Codex provider:
+
+1. Authenticate: Use existing OpenAI credentials or run Codex CLI login
+2. Update endpoints: Change from `/v1/messages` to `/codex/responses`
+
+This implementation provides a complete, production-ready OpenAI Codex proxy solution that maintains the same standards as the existing Claude provider while offering users choice in their AI provider preferences.
+
+## [0.1.5] - 2025-08-03
 
 ### Added
 
 - **Advanced Session and Pool Management**:
-    - Implemented a robust session-aware pool for persistent Claude SDK connections, significantly improving performance and maintaining conversation continuity.
-    - Introduced a hybrid pooling system that automatically transfers clients from a general pool to the session pool upon receiving a session ID.
-    - Developed a queue-based streaming architecture to efficiently handle and broadcast messages to multiple listeners, improving session management and disconnection handling.
+  - Implemented a robust session-aware pool for persistent Claude SDK connections, significantly improving performance and maintaining conversation continuity.
+  - Introduced a hybrid pooling system that automatically transfers clients from a general pool to the session pool upon receiving a session ID.
+  - Developed a queue-based streaming architecture to efficiently handle and broadcast messages to multiple listeners, improving session management and disconnection handling.
 - **Enhanced Observability and Logging**:
-    - Upgraded logging capabilities to include detailed session metadata, providing deeper insights into session lifecycle and reuse.
-    - Implemented a pool monitoring system to track the health and performance of both general and session-based connection pools.
-    - Reduced logging noise by adjusting log levels for operational SDK messages, focusing on essential access logs, warnings, and errors.
+  - Upgraded logging capabilities to include detailed session metadata, providing deeper insights into session lifecycle and reuse.
+  - Implemented a pool monitoring system to track the health and performance of both general and session-based connection pools.
+  - Reduced logging noise by adjusting log levels for operational SDK messages, focusing on essential access logs, warnings, and errors.
 - **Improved Configuration and Control**:
-    - Introduced a `builtin_permissions` flag to provide granular control over the built-in permission handling infrastructure (MCP and SSE).
-    - Implemented configurable system prompt injection modes (`minimal` and `full`) to customize how the Claude Code identity is presented in requests.
+  - Introduced a `builtin_permissions` flag to provide granular control over the built-in permission handling infrastructure (MCP and SSE).
+  - Implemented configurable system prompt injection modes (`minimal` and `full`) to customize how the Claude Code identity is presented in requests.
 - **Robust Streaming and Header Management**:
-    - Implemented `StreamingResponseWithLogging` for unified and consistent access logging across all streaming endpoints.
-    - Ensured critical upstream headers (e.g., `cf-ray`, `anthropic-ratelimit-*`) are correctly forwarded in SSE streaming responses.
+  - Implemented `StreamingResponseWithLogging` for unified and consistent access logging across all streaming endpoints.
+  - Ensured critical upstream headers (e.g., `cf-ray`, `anthropic-ratelimit-*`) are correctly forwarded in SSE streaming responses.
 
 ### Changed
 
 - **Default Behavior**:
-    - The Claude SDK connection pool is now disabled by default, requiring an explicit opt-in for safer and more predictable behavior.
+  - The Claude SDK connection pool is now disabled by default, requiring an explicit opt-in for safer and more predictable behavior.
 - **Architectural Improvements**:
-    - Refactored the application's startup and shutdown logic into a modular, component-based architecture for better maintainability and testability.
-    - Renamed `SessionContext` to `SessionClient` for improved clarity and consistency in the session pooling implementation.
+  - Refactored the application's startup and shutdown logic into a modular, component-based architecture for better maintainability and testability.
+  - Renamed `SessionContext` to `SessionClient` for improved clarity and consistency in the session pooling implementation.
 - **Testing Infrastructure**:
-    - Reorganized the entire test suite into a hierarchical structure (`unit` and `integration`) to improve navigation and maintainability.
-    - Migrated from legacy test fixtures to a more flexible and maintainable factory pattern for creating test clients and application instances.
+  - Reorganized the entire test suite into a hierarchical structure (`unit` and `integration`) to improve navigation and maintainability.
+  - Migrated from legacy test fixtures to a more flexible and maintainable factory pattern for creating test clients and application instances.
 
 ### Fixed
 
 - **Session and Streaming Stability**:
-    - Eliminated critical race conditions and `AttributeError` exceptions in the session pool and stream handling logic.
-    - Replaced fragile `asyncio.sleep` calls with a robust, event-based synchronization mechanism to prevent timing-related failures.
-    - Implemented a more accurate message-based stale detection mechanism to prevent the incorrect termination of active sessions.
+  - Eliminated critical race conditions and `AttributeError` exceptions in the session pool and stream handling logic.
+  - Replaced fragile `asyncio.sleep` calls with a robust, event-based synchronization mechanism to prevent timing-related failures.
+  - Implemented a more accurate message-based stale detection mechanism to prevent the incorrect termination of active sessions.
 - **Resource Management**:
-    - Corrected several resource leak issues by improving stream interruption handling, ensuring that hanging sessions are properly cleaned up.
+  - Corrected several resource leak issues by improving stream interruption handling, ensuring that hanging sessions are properly cleaned up.
 - **Header and Content Formatting**:
-    - Resolved an issue that prevented the forwarding of upstream headers in SSE streaming responses.
-    - Fixed a formatting bug in the OpenAI adapter that caused message content to be improperly concatenated.
-
+  - Resolved an issue that prevented the forwarding of upstream headers in SSE streaming responses.
+  - Fixed a formatting bug in the OpenAI adapter that caused message content to be improperly concatenated.
 
 ### Added
 

{ccproxy_api-0.1.5 → ccproxy_api-0.1.6}/Makefile

@@ -81,6 +81,14 @@ clean:
 #   - 'unit': Fast unit tests (< 1s each, no external dependencies)
 #   - Tests without 'real_api' marker are considered unit tests by default
 
+# Fix code with unsafe fixes
+fix-hard:
+	uv run ruff check . --fix --unsafe-fixes
+	uv run uv run ruff check . --select F401 --fix --unsafe-fixes # Used variable import
+	uv run uv run ruff check . --select I --fix --unsafe-fixes  # Import order
+	uv run ruff format .
+
+
 fix: format lint-fix
 	ruff check . --fix --unsafe-fixes