ccproxy.plugins.credential_balancer.config¶

ccproxy.plugins.credential_balancer.config ¶

Configuration models for the credential balancer plugin.

RotationStrategy ¶

Bases: str, Enum

Supported credential selection strategies.

CredentialSource ¶

Bases: BaseModel

Base model for credential sources.

resolved_label `property` ¶

resolved_label

Return a non-empty label for this credential source.

CredentialManager ¶

Bases: CredentialSource

Configuration for a manager-based credential source with provider-specific logic.

Specify either manager_key (registry lookup) or manager_class (direct import).

The config dict supports additional options:

Storage options: - enable_backups (bool): Create timestamped backups before overwriting credentials (default: True)

Manager options: - credentials_ttl (float): Seconds to cache credentials before rechecking storage (default: 30.0) - refresh_grace_seconds (float): Seconds before expiry to trigger proactive token refresh (default: 120.0)

Example

{ type = "manager",
  file = "~/.config/ccproxy/codex_pro.json",
  config = {
    enable_backups = true,
    credentials_ttl = 60.0,
    refresh_grace_seconds = 300.0
  }
}

resolved_label `property` ¶

resolved_label

Return a non-empty label for this credential manager.

CredentialPoolConfig ¶

Bases: BaseModel

Configuration for an individual credential pool.

CredentialBalancerSettings ¶

Bases: BaseModel

Top-level plugin settings.

ccproxy.plugins.credential_balancer.config¶