40 Commits

• refactor(gemini-web): Remove auto-refresh, auto-close, and caching

  This commit simplifies the Gemini web client by removing several complex, stateful features. The previous implementation for auto-refreshing cookies and auto-closing the client involved background goroutines, timers, and file system caching, which made the client's lifecycle difficult to manage.
  
  The following features have been removed:
  - The cookie auto-refresh mechanism, including the background goroutine (`rotateCookies`) and related configuration fields.
  - The file-based caching for the `__Secure-1PSIDTS` token. The `rotate1PSIDTS` function now fetches a new token on every call.
  - The auto-close functionality, which used timers to close the client after a period of inactivity.
  - Associated configuration options and methods (`WithAccountLabel`, `WithOnCookiesRefreshed`, `Close`, etc.).
  
  By removing this logic, the client becomes more stateless and predictable. The responsibility for managing the client's lifecycle and handling token expiration is now shifted to the caller, leading to a simpler and more robust integration.

  hkfires · 2025-09-23 12:48:30 +08:00
  8e485e5868
• refactor(watcher): Remove unnecessary log separator
  hkfires · 2025-09-23 10:05:59 +08:00
  e8e00d4cb8
• feat(auth): enhance watcher with asynchronous dispatch and buffering

  - Added async dispatch loop to `Watcher` for handling incremental `AuthUpdate` with in-memory buffering.
  - Improved resilience against high-frequency auth changes by coalescing updates and reducing redundant processing.
  - Updated `cliproxy` service to increase auth update queue capacity and optimize backlog consumption.
  - Added detailed SDK integration documentation in English and Chinese (`sdk-watcher.md`, `sdk-watcher_CN.md`).

  Luis Pater · 2025-09-23 04:33:48 +08:00
  6046a8c95b
• feat(auth): implement incremental auth updates with queue integration

  - Added support for incremental auth updates using `AuthUpdate` and `AuthUpdateAction`.
  - Integrated `SetAuthUpdateQueue` to propagate updates through a dedicated channel.
  - Introduced new methods for handling auth add, modify, and delete actions.
  - Updated service to ensure auth update queues are correctly initialized and consumed.
  - Improved auth state synchronization across core and file-based clients with real-time updates.
  - Refactored redundant auth handling logic for better efficiency and maintainability.

  Luis Pater · 2025-09-23 04:16:22 +08:00
  792ec49e5b
• feat(openai-compat): enhance provider key handling and model resolution

  - Introduced dynamic `providerKey` resolution for OpenAI-compatible providers, incorporating attributes like `provider_key` and `compat_name`.
  - Implemented upstream model overrides via `resolveUpstreamModel` and `overrideModel` methods in the OpenAI executor.
  - Updated registry logic to correctly store provider mappings and register clients using normalized keys.
  - Ensured consistency in handling empty or default provider names across components.

  Luis Pater · 2025-09-22 22:54:21 +08:00
  e41d127732
• fix(auth): Improve file-based auth handling and consistency
  hkfires · 2025-09-22 13:03:47 +08:00
  759bb88a90
• 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
• refactor(auth): Centralize auth file reading with snapshot preference

  The logic for reading authentication files, which includes retries and a preference for cookie snapshot files, was previously implemented locally within the `watcher` package. This was done to handle potential file locks during writes.
  
  This change moves this functionality into a shared `ReadAuthFileWithRetry` function in the `util` package to promote code reuse and consistency.
  
  The `watcher` package is updated to use this new centralized function. Additionally, the initial token loading in the `run` command now also uses this logic, making it more resilient to file access issues and consistent with the watcher's behavior.

  hkfires · 2025-09-20 00:14:26 +08:00
  aba719f5fe
• refactor(watcher): Move API key client creation to watcher package
  hkfires · 2025-09-19 11:46:17 +08:00
  4bfafbe3aa
• refactor(auth): Centralize logging for saving credentials

  The logic for logging the path where credentials are saved was duplicated across several client implementations.
  
  This commit refactors this behavior by creating a new centralized function, `misc.LogSavingCredentials`, to handle this logging. The `SaveTokenToFile` method in each authentication token storage struct now calls this new function, ensuring consistent logging and reducing code duplication.
  
  The redundant logging statements in the client-level `SaveTokenToFile` methods have been removed.

  hkfires · 2025-09-19 11:46:17 +08:00
  2274d7488b
• refactor(client): Improve auth file handling and client lifecycle
  hkfires · 2025-09-19 11:46:17 +08:00
  39518ec633
• fix(client): Prevent overwriting auth file on update
  hkfires · 2025-09-19 11:46:16 +08:00
  f17ec7ffd8
• fix(client): Add reason to unregistration to skip persistence
  hkfires · 2025-09-19 11:46:16 +08:00
  d9f8129a32
• refactor(watcher): Filter irrelevant file system events early
  hkfires · 2025-09-19 11:46:16 +08:00
  8f0a345e2a
• feat(gemini-web): squash all features and fixes for gemini-web
  hkfires · 2025-09-17 20:24:23 +08:00
  e4dd22b260
• Fix log key name from gpt-5-codex to force-gpt-5-codex for consistency
  Luis Pater · 2025-09-16 20:03:48 +08:00
  8c2063aeea
• fix(windows): Improve path handling and file read reliability
  hkfires · 2025-09-16 10:01:58 +08:00
  e9037fceb0
• 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
• Default tokenType to an empty string instead of "gemini" in watcher.go and run.go.
  Luis Pater · 2025-09-11 21:09:27 +08:00
  ef8820e4e4
• Avoid unnecessary config.yaml reloads via hash check
  hkfires · 2025-09-09 09:11:57 +08:00
  ebf2a26e72
• Fixed bug #38

  Add support for API key indexing in OpenAI compatibility clients
  
  - Updated `NewOpenAICompatibilityClient` to accept `apiKeyIndex` for managing multiple API keys.
  - Modified client instantiation loops to initialize one client per API key.
  - Adjusted client ID format to include `apiKeyIndex` for unique identification.
  - Removed API key rotation logic within `GetCurrentAPIKey`.
  - Updated `.gitignore` to include `AGENTS.md`.

  Luis Pater · 2025-09-08 22:36:44 +08:00
  99c9f3069c
• 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
• fix(watcher): enhance API key client counting and logging
  hkfires · 2025-09-05 18:02:45 +08:00
  f97954c811
• fix(watcher): improve client reload logic and prevent redundant updates

  - replace debounce timing with content-based change detection using SHA256 hashes
  - skip client reload when auth file content is unchanged
  - handle empty auth files gracefully by ignoring them
  - ensure hash cache is updated only on successful client creation
  - clean up hash cache when clients are removed

  hkfires · 2025-09-05 13:53:15 +08:00
  57484b97bb
• refactor(watcher): restructure client management and API key handling

  - separate file-based and API key-based clients in watcher
  - improve client reloading logic with better locking and error handling
  - add dedicated functions for building API key clients and loading file clients
  - update combined client map generation to include cached API key clients
  - enhance logging and debugging information during client reloads
  - fix potential race conditions in client updates and removals

  hkfires · 2025-09-05 13:25:30 +08:00
  0e0602c553
• Add debounce logic for file events to prevent duplicate reloads
  hkfires · 2025-09-04 10:28:54 +08:00
  5ed79e5aa3
• Refactor client map construction to include all client types and enhance callback updates

  - Added `buildCombinedClientMap` to merge file-based clients with API key and compatibility clients.
  - Updated callbacks to use the combined client map for consistency.
  - Improved error logging and variable naming for clarity in client creation logic.

  Luis Pater · 2025-09-03 22:26:07 +08:00
  7209fa233f
• 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
• 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
• Enhance client reload process with new OpenAI compatibility support

  - Added handling for OpenAI-compatible providers during client reload.
  - Implemented client unregistration for old clients during reload.
  - Improved logging for detailed client reload insights.
  
  Expand `AuthDir` handling to support tilde (`~`) for home directory resolution
  
  - Added logic to replace `~` with the user's home directory in `AuthDir`.
  - Prevents errors when using `~` in configuration paths.

  Luis Pater · 2025-08-31 03:04:46 +08:00
  b1254106ee
• 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
• 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
• Add file watcher for dynamic configuration and client reloading

  - Introduced `Watcher` for monitoring updates to the configuration file and authentication directory.
  - Integrated file watching into `StartService` to handle dynamic changes without restarting.
  - Enhanced API server and handlers to support client and configuration updates.
  - Updated `.gitignore` to include `docs/` directory.
  - Modified go dependencies to include `fsnotify` for the file watcher.

  Luis Pater · 2025-08-02 16:15:56 +08:00
  3c4dc07980