75 Commits

• feat(claude-executor): add ZSTD decoding support for Claude executor responses

  - Integrated ZSTD decompression via `github.com/klauspost/compress` for responses with "zstd" content-encoding.
  - Added helper `hasZSTDEcoding` to detect ZSTD-encoded responses.
  - Updated response handling logic to initialize and use a ZSTD decoder when necessary.
  
  refactor(api-handlers): split streaming and non-streaming response handling
  
  - Introduced `handleNonStreamingResponse` for processing non-streaming requests in `ClaudeCodeAPIHandler`.
  - Improved code clarity by separating streaming and non-streaming logic.
  
  fix(service): remove redundant token refresh interval assignment logic in `cliproxy` service.

  Luis Pater · 2025-09-23 12:44:44 +08:00
  11b0efc38f
• fix(auth): address index logic bug and remove redundant conditions

  - Updated loop iteration in `AuthSelector` to correct index management for selecting candidates.
  - Fixed cursor index reset condition for large values to prevent overflow.
  - Removed unnecessary conditional reassignment of `allowRemote` in management handler for clarity and correctness.

  Luis Pater · 2025-09-23 10:21:45 +08:00
  5bf7a9575c
• feat(executor): add CountTokens support across all executors

  - Introduced `CountTokens` method to Codex, Claude, Gemini, Qwen, OpenAI-compatible, and other executors.
  - Implemented `ExecuteCount` in `AuthManager` for token counting via provider round-robin.
  - Updated handlers to leverage `ExecuteCountWithAuthManager` for streamlined token counting.
  - Added fallback and error handling logic for token counting requests.

  Luis Pater · 2025-09-23 02:27:51 +08:00
  ac59023abb
• feat(auth): standardize last_refresh metadata handling across executors

  - Added `last_refresh` timestamp to metadata for Codex, Claude, Qwen, and Gemini executors.
  - Implemented `extractLastRefreshTimestamp` utility for parsing diverse timestamp formats in management handlers.
  - Ensured consistent update and preservation of `last_refresh` in file-based auth handling.

  Luis Pater · 2025-09-22 23:23:31 +08:00
  2e836cee88
• feat(logging): integrate logrus with custom Gin middleware for enhanced request logging and recovery

  - Added `GinLogrusLogger` for structured request logging using Logrus.
  - Implemented `GinLogrusRecovery` to handle panics and log stack traces.
  - Configured log rotation using Lumberjack for efficient log management.
  - Replaced Gin's default logger and recovery middleware with the custom implementations.

  Luis Pater · 2025-09-22 22:17:12 +08:00
  f1c4caf14a
• feat(auth): introduce auth.providers for flexible authentication configuration

  - Replaced legacy `api-keys` field with `auth.providers` in configuration, supporting multiple authentication providers including `config-api-key`.
  - Added synchronization to maintain compatibility with legacy `api-keys`.
  - Updated core components like request handling and middleware to use the new provider system.
  - Enhanced management API endpoints for seamless integration with `auth.providers`.

  Luis Pater · 2025-09-22 17:36:31 +08:00
  4008be19f4
• refactor: standardize constant naming and improve file-based auth handling

  - Renamed constants from uppercase to CamelCase for consistency.
  - Replaced redundant file-based auth handling logic with the new `util.CountAuthFiles` helper.
  - Fixed various error-handling inconsistencies and enhanced robustness in file operations.
  - Streamlined auth client reload logic in server and watcher components.
  - Applied minor code readability improvements across multiple packages.

  Luis Pater · 2025-09-22 02:56:45 +08:00
  d9ad65622a
• v6 version first commit
  Luis Pater · 2025-09-22 01:40:24 +08:00
  4999fce7f4
• feat: add client availability tracking and error handling improvements

  - Introduced `IsAvailable` and `SetUnavailable` methods to clients for availability tracking.
  - Integrated availability checks in client selection logic to skip unavailable clients.
  - Enhanced error handling by marking clients unavailable on specific error codes (e.g., 401, 402).
  - Removed redundant quota verification logs in client reordering logic.

  Luis Pater · 2025-09-19 01:53:38 +08:00
  df66046b14
• feat(gemini-web): squash all features and fixes for gemini-web
  hkfires · 2025-09-17 20:24:23 +08:00
  e4dd22b260
• feat: add graceful shutdown for streaming response handling

  - Introduced `streamDone` channel to signal the completion of streaming goroutines.
  - Updated `processStreamingChunks` to incorporate proper cleanup and defer close operations.
  - Ensured `streamWriter` and associated resources are released when streaming completes.

  Luis Pater · 2025-09-17 19:46:57 +08:00
  172f282e9e
• Add support for forcing GPT-5 Codex model configuration

  - Introduced a new `ForceGPT5Codex` configuration option in settings.
  - Added relevant API endpoints for managing `ForceGPT5Codex`.
  - Enhanced Codex client to handle GPT-5 Codex-specific logic and mapping.
  - Updated example configuration file to include the new option.
  
  Add GPT-5 Codex model support and configuration options in documentation

  Luis Pater · 2025-09-16 04:40:19 +08:00
  b84cbee77a
• Update internal module imports to use v5 package path

  - Updated all `github.com/luispater/CLIProxyAPI/internal/...` imports to point to `github.com/luispater/CLIProxyAPI/v5/internal/...`.
  - Adjusted `go.mod` to specify `module github.com/luispater/CLIProxyAPI/v5`.

  Luis Pater · 2025-09-13 23:34:32 +08:00
  9fce13fe03
• Resolve logsDir path relative to configuration directory in FileRequestLogger
  Luis Pater · 2025-09-12 15:28:07 +08:00
  4375822cbb
• Implement IP-based rate limiting and ban mechanism for management API

  - Introduced a new `attemptInfo` structure to track failed login attempts per IP.
  - Added logic to temporarily ban IPs exceeding the allowed number of failures.
  - Enhanced middleware to reset failed attempt counters on successful authentication.
  - Updated `Handler` to include a `failedAttempts` map with thread-safe access.

  Luis Pater · 2025-09-12 03:00:37 +08:00
  1c92034191
• Filter OpenAI models response to include only essential fields (id, object, created, owned_by).
  Luis Pater · 2025-09-10 17:50:33 +08:00
  74bae32c83
• Enhance OAuth handling for Anthropic, Codex, Gemini, and Qwen tokens

  - Transitioned OAuth callback handling from temporary servers to predefined persistent endpoints.
  - Simplified token retrieval by replacing in-memory handling with state-file-based persistence.
  - Introduced unified `oauthStatus` map for tracking flow progress and errors.
  - Added new `/auth/*/callback` routes, streamlining code and state management for OAuth flows.
  - Improved error handling and logging in token exchange and callback flows.

  Luis Pater · 2025-09-10 02:34:22 +08:00
  0449fefa60
• Restrict management key validation to non-localhost requests only
  Luis Pater · 2025-09-09 23:28:16 +08:00
  156e3b017d
• Add OAuth support for Gemini CLI, Claude, Codex, and Qwen authentication

  - Implemented new handlers (`RequestGeminiCLIToken`, `RequestAnthropicToken`, `RequestCodexToken`, `RequestQwenToken`) for initiating OAuth flows.
  - Added endpoints for authorization URLs in management API.
  - Extracted `GenerateRandomState` to a reusable utility in `misc` package.
  - Refactored related logic in `openai_login.go` and `anthropic_login.go` for consistency.
  
  Add endpoints for initiating OAuth flows in management API documentation
  
  - Documented new endpoints for Anthropic, Codex, Gemini CLI, and Qwen login URLs.
  - Provided request and response examples for each endpoint in both English and Chinese versions.

  Luis Pater · 2025-09-09 02:54:06 +08:00
  545dff8b64
• Fix bug: #38 about lobechat cors policy

  Relax CORS policy by allowing all headers in API responses

  Luis Pater · 2025-09-08 23:36:43 +08:00
  7353bc0b2b
• Add dynamic log level adjustment and "type" field to auth files response

  - Introduced `SetLogLevel` utility function for unified log level management.
  - Updated dynamic log level handling across server and watcher components.
  - Extended auth files response by extracting and including the `type` field from file content.
  - Updated management API documentation with the new `type` field in auth files response.

  Luis Pater · 2025-09-08 01:09:39 +08:00
  c875088be2
• Add JSON annotations to configuration structs and new /config management endpoint

  - Added JSON annotations across all configuration structs in `config.go`.
  - Introduced `/config` management API endpoint to fetch complete configuration.
  - Updated management API documentation (`MANAGEMENT_API.md`, `MANAGEMENT_API_CN.md`) with `/config` usage.
  - Implemented `GetConfig` handler in `config_basic.go`.

  Luis Pater · 2025-09-06 20:45:51 +08:00
  6164f5c35b
• feat(api): implement granular client type metrics in server updates
  hkfires · 2025-09-05 19:26:57 +08:00
  28218ec550
• Add reverse mappings for original tool names and improve error logging

  - Introduced reverse mapping logic for tool names in translators to restore original names when shortened.
  - Enhanced error handling by logging API response errors consistently across handlers.
  - Refactored request and response loggers to include API error details, improving debugging capabilities.
  - Integrated robust tool name shortening and uniqueness mechanisms for OpenAI, Gemini, and Claude requests.
  - Improved handler retry logic to properly capture and respond to errors.

  Luis Pater · 2025-09-04 02:39:56 +08:00
  ad943b2d4d
• Refactor cliCancel calls to remove unused resp argument across handlers.
  Luis Pater · 2025-09-03 21:13:22 +08:00
  70e916942e
• feat(watcher): implement incremental client hot-reloading
  hkfires · 2025-09-03 20:47:43 +08:00
  f60ef0b2e7
• Add support for Codex API key authentication

  - Introduced functionality to handle Codex API keys, including initialization and management via new endpoints in the management API.
  - Updated Codex client to support both OAuth and API key authentication.
  - Documented Codex API key configuration in both English and Chinese README files.
  - Enhanced logging to distinguish between API key and OAuth usage scenarios.

  Luis Pater · 2025-09-03 03:36:56 +08:00
  c4a42eb1f0
• Refactor translator packages for OpenAI Chat Completions

  - Renamed `openai` packages to `chat_completions` across translator modules.
  - Introduced `openai_responses_handlers` with handlers for `/v1/models` and OpenAI-compatible chat completions endpoints.
  - Updated constants and registry identifiers for OpenAI response type.
  - Simplified request/response conversions and added detailed retry/error handling.
  - Added `golang.org/x/crypto` for additional cryptographic functions.

  Luis Pater · 2025-09-01 11:00:47 +08:00
  e11637dc62
• Refactor translator packages for OpenAI Chat Completions

  - Renamed `openai` packages to `chat_completions` across translator modules.
  - Introduced `openai_responses_handlers` with handlers for `/v1/models` and OpenAI-compatible chat completions endpoints.
  - Updated constants and registry identifiers for OpenAI response type.
  - Simplified request/response conversions and added detailed retry/error handling.
  - Added `golang.org/x/crypto` for additional cryptographic functions.

  Luis Pater · 2025-09-01 08:18:59 +08:00
  e3994ace33
• Add management API handlers for config and auth file management

  - Implemented CRUD operations for authentication files.
  - Added endpoints for managing API keys, quotas, proxy settings, and other configurations.
  - Enhanced management access with robust validation, remote access control, and persistence support.
  - Updated README with new configuration details.
  
  Fixed OpenAI Chat Completions for codex

  Luis Pater · 2025-08-31 14:29:23 +08:00
  db43930b98
• Add token refresh handling for 401 responses across clients

  - Implemented `RefreshTokens` method in client interfaces and Gemini clients.
  - Updated handlers to call `RefreshTokens` on 401 responses and retry requests if token refresh succeeds.
  - Enhanced error handling and retry logic to accommodate token refresh flow.

  Luis Pater · 2025-08-30 16:10:56 +08:00
  512c8b600a
• Update README documentation to clarify auth-dir configuration for Windows users

  - Added a note for setting `auth-dir` on Windows systems in both English and Chinese README files.
  - Improved descriptions for existing configuration options.
  
  Address Qwen3 tool injection issue to prevent random token insertions
  
  - Modify Qwen client to insert a placeholder tool when none is defined, avoiding erratic behavior in streaming responses.

  Luis Pater · 2025-08-29 17:28:55 +08:00
  f1d9364ef4
• Unlock mutex before returning error in handlers.go to prevent deadlocks
  Luis Pater · 2025-08-29 09:46:12 +08:00
  09b9d3b3fa
• Fix some bugs.
  Luis Pater · 2025-08-29 04:05:08 +08:00
  e9e0016a63
• Add nil-check for GetRequestMutex across handlers to prevent potential panics

  - Updated all handlers to safely unlock the request mutex only if it's non-nil.
  - Enhanced mutex locking and unlocking logic to avoid runtime errors.
  - Improved robustness of resource cleanup across clients.
  
  Add `GetRequestMutex` method for synchronization across clients
  
  - Introduced a new `GetRequestMutex` method in OpenAICompatibilityClient, CodexClient, GeminiCLIClient, GeminiClient, and QwenClient for request synchronization.
  - Ensures only one request is processed at a time to manage quotas effectively.

  Luis Pater · 2025-08-29 00:23:37 +08:00
  3704dae342
• Add /v1/completions endpoint with OpenAI compatibility

  - Implemented `/v1/completions` endpoint mirroring OpenAI's completions API specification.
  - Added conversion functions to translate between completions and chat completions formats.
  - Introduced streaming and non-streaming response handling for completions requests.
  - Updated `server.go` to register the new endpoint and include it in the API's metadata.

  Luis Pater · 2025-08-28 00:30:46 +08:00
  bea5f97cbf
• Suppress debug logs for model routing and ignore empty tools arrays

  - Comment out verbose routing logs in the API server to reduce noise.
  - Remove the `tools` field from Qwen client requests when it is an empty array.
  - Add guards in Claude, Codex, Gemini‑CLI, and Gemini translators to skip tool conversion when the `tools` array is empty, preventing unnecessary payload modifications.

  Luis Pater · 2025-08-27 22:29:08 +08:00
  7a6adfa97e
• Add support for localhost unauthenticated requests

  - Introduced `AllowLocalhostUnauthenticated` flag allowing unauthenticated requests from localhost.
  - Updated authentication middleware to bypass checks for localhost when enabled.
  
  Add new Gemini CLI models and update model registry function
  
  - Introduced `GetGeminiCLIModels` for updated Gemini CLI model definitions.
  - Added new models: "Gemini 2.5 Flash Lite" and "Gemini 2.5 Pro".
  - Updated `RegisterModels` to use `GetGeminiCLIModels` in Gemini client initialization.

  Luis Pater · 2025-08-27 21:20:25 +08:00
  1c4183d943
• Improved the /v1/models endpoint
  Luis Pater · 2025-08-27 21:01:37 +08:00
  dff31a7a4c
• Add OpenAI compatibility support and improve resource cleanup

  - Introduced OpenAI compatibility configurations for external providers, enabling model alias routing via the OpenAI API format.
  - Enhanced provider logic in `GetProviderName` to handle OpenAI aliases and added new helper functions for compatibility checks.
  - Updated API handlers and client initialization to support OpenAI compatibility models.
  - Improved resource cleanup across clients by closing response bodies and streams using deferred functions.

  Luis Pater · 2025-08-26 03:33:46 +08:00
  ed8873fbb0
• Refactor API handlers to implement retry mechanism with configurable limits and improved error handling

  - Introduced retry counter with a configurable ` RequestRetry ` limit in all handlers.
  - Enhanced error handling with specific HTTP status codes for switching clients.
  - Standardized response forwarding for non-retriable errors.
  - Improved logging for quota and client switch scenarios.

  Luis Pater · 2025-08-25 23:43:49 +08:00
  9102ff031d
• Refactor codebase
  Luis Pater · 2025-08-25 16:58:16 +08:00
  8c555c4e69
• Add Qwen support
  Luis Pater · 2025-08-21 15:22:53 +08:00
  aa2f37d54d
• Add claude code support
  Luis Pater · 2025-08-21 02:53:28 +08:00
  d58cc55cb2
• Refactor error handling and variable declarations in browser and logging modules

  - Simplified variable initialization in `browser.go` for readability.
  - Updated error handling in `request_logger.go` with better resource cleanup using deferred anonymous functions.
  
  Refactor API handlers to use `GetContextWithCancel` for streamlined context creation and response handling
  
  - Replaced redundant `context.WithCancel` and `context.WithValue` logic with the new `GetContextWithCancel` utility in all handlers.
  - Centralized API response storage in the given context during cancellation.
  - Updated associated cancellation calls for consistency and improved resource management.
  
  - Replaced `apiResponseData` with `AddAPIResponseData` for centralized response recording.
  - Simplified cancellation logic by switching to a boolean-based `cliCancel` method.
  - Removed unused `apiResponseData` slices across handlers to reduce memory usage.
  - Updated `handlers.go` to support unified response data storage per request context.

  Luis Pater · 2025-08-17 20:13:45 +08:00
  c5cc238308
• Refactor Gemini API handlers to standardize response field names and improve model descriptions
  Luis Pater · 2025-08-17 00:28:13 +08:00
  6bbdf67f96
• Add request logging capabilities to API handlers and update .gitignore

  Enhance API response handling by storing responses in context and updating request logger to include API responses

  Luis Pater · 2025-08-16 06:09:04 +08:00
  fcadf08921
• Add openai codex support
  Luis Pater · 2025-08-16 01:22:33 +08:00
  de7b8501cc
• Refactor API handlers organization and simplify error response handling

  - Modularized handlers into dedicated packages (`gemini`, `claude`, `cli`) for better structure.
  - Centralized `ErrorResponse` and `ErrorDetail` types under `handlers` package for reuse.
  - Updated all handlers to utilize the shared `ErrorResponse` model.
  - Introduced specialization of handler structs (`GeminiAPIHandlers`, `ClaudeCodeAPIHandlers`, `GeminiCLIAPIHandlers`) for improved clarity and separation of concerns.
  - Refactored `getClient` logic with additional properties and better state management.
  
  Refactor `translator` package by modularizing code for `claude` and `gemini`
  
  - Moved Claude-specific logic (`PrepareClaudeRequest`, `ConvertCliToClaude`) to `translator/claude/code`.
  - Moved Gemini-specific logic (`FixCLIToolResponse`) to `translator/gemini/cli` for better package structure.
  - Updated affected handler imports and method references.
  
  Add comprehensive package-level documentation across key modules
  
  - Introduced detailed package-level documentation for core modules: `auth`, `client`, `cmd`, `handlers`, `util`, `watcher`, `config`, `translator`, and `api`.
  - Enhanced code readability and maintainability by clarifying the purpose and functionality of each package.
  - Aligned documentation style and tone with existing codebase conventions.
  
  Refactor API handlers and translator modules for improved clarity and consistency
  
  - Standardized handler struct names (`GeminiAPIHandlers`, `ClaudeCodeAPIHandlers`, `GeminiCLIAPIHandlers`, `OpenAIAPIHandlers`) and updated related comments.
  - Fixed unnecessary `else` blocks in streaming logic for cleaner error handling.
  - Renamed variables for better readability (`responseIdResult` to `responseIDResult`, `activationUrl` to `activationURL`, etc.).
  - Addressed minor inconsistencies in API handler comments and SSE header initialization.
  - Improved modularization of `claude` and `gemini` translator components.
  
  Standardize configuration field naming for consistency across modules
  
  - Renamed `ProxyUrl` to `ProxyURL`, `ApiKeys` to `APIKeys`, and `ConfigQuotaExceeded` to `QuotaExceeded`.
  - Updated all relevant references and comments in `config`, `auth`, `api`, `util`, and `watcher`.
  - Ensured consistent casing for `GlAPIKey` debug logs.

  Luis Pater · 2025-08-05 23:11:31 +08:00
  1483c31c73
• Enhance Gemini request handling for contents support and improve error logging

  - Added conditional logic to process `contents` in Gemini request templates, ensuring fallback behavior.
  - Introduced detailed debug logs for quota errors and request issues.
  - Updated handling of `rawJson` to construct templates more dynamically.

  Luis Pater · 2025-08-04 02:51:00 +08:00
  00f33f5f3a