Aether/crates/aether-provider/pool/src/providers/codex.rs

use std::collections::BTreeMap;

use aether_data_contracts::repository::provider_catalog::StoredProviderCatalogEndpoint;
use aether_pool_core::PoolSchedulingPreset;
use serde_json::{Map, Value};

use crate::capability::ProviderPoolCapabilities;
use crate::provider::{
    provider_pool_endpoint_format_matches, provider_pool_matching_endpoint, ProviderPoolAdapter,
    ProviderPoolMemberInput,
};
use crate::quota::{
    provider_pool_current_unix_secs, provider_pool_json_bool, provider_pool_json_f64,
    provider_pool_member_quota_snapshot, provider_pool_metadata_bucket,
    provider_pool_model_quota_exhausted, provider_pool_quota_snapshot_exhausted_decision,
    provider_pool_reset_deadline_elapsed, provider_pool_timestamp_unix_secs,
};
use crate::quota_refresh::ProviderPoolQuotaRequestSpec;

pub const CODEX_WHAM_USAGE_URL: &str = "https://chatgpt.com/backend-api/wham/usage";
pub const CODEX_WHAM_RESET_CREDITS_URL: &str =
    "https://chatgpt.com/backend-api/wham/rate-limit-reset-credits";
pub const CODEX_WHAM_RESET_CREDITS_CONSUME_URL: &str =
    "https://chatgpt.com/backend-api/wham/rate-limit-reset-credits/consume";
const PLACEHOLDER_API_KEY: &str = "__placeholder__";

#[derive(Debug, Clone, Default)]
pub struct CodexProviderPoolAdapter;

impl ProviderPoolAdapter for CodexProviderPoolAdapter {
    fn provider_type(&self) -> &'static str {
        "codex"
    }

    fn capabilities(&self) -> ProviderPoolCapabilities {
        ProviderPoolCapabilities {
            plan_tier: true,
            quota_reset: true,
            quota_refresh: true,
        }
    }

    fn default_scheduling_presets(&self) -> Vec<PoolSchedulingPreset> {
        vec![PoolSchedulingPreset {
            preset: "recent_refresh".to_string(),
            enabled: true,
            mode: None,
        }]
    }

    fn quota_exhausted(&self, input: &ProviderPoolMemberInput<'_>) -> bool {
        if let Some(exhausted) = input.provider_model_name.and_then(|model| {
            provider_pool_model_quota_exhausted(input.key, input.provider_type, model)
        }) {
            return exhausted;
        }
        if let Some(quota_snapshot) =
            provider_pool_member_quota_snapshot(input.key, input.provider_type)
        {
            let explicitly_exhausted = provider_pool_json_bool(quota_snapshot.get("allowed"))
                == Some(false)
                || provider_pool_json_bool(quota_snapshot.get("limit_reached")) == Some(true);
            if explicitly_exhausted {
                let observed_at = provider_pool_timestamp_unix_secs(
                    quota_snapshot
                        .get("observed_at")
                        .or_else(|| quota_snapshot.get("updated_at")),
                );
                return !provider_pool_current_unix_secs().is_some_and(|now_unix_secs| {
                    provider_pool_reset_deadline_elapsed(quota_snapshot, observed_at, now_unix_secs)
                });
            }
        }
        if let Some(exhausted) =
            provider_pool_quota_snapshot_exhausted_decision(input.key, input.provider_type)
        {
            return exhausted;
        }
        provider_pool_metadata_bucket(input.key.upstream_metadata.as_ref(), input.provider_type)
            .is_some_and(quota_exhausted_from_bucket)
    }

    fn quota_hard_blocked(&self, input: &ProviderPoolMemberInput<'_>) -> bool {
        if input.provider_model_name.is_some_and(|model| {
            provider_pool_model_quota_exhausted(input.key, input.provider_type, model).is_some()
        }) {
            return false;
        }
        codex_explicit_quota_block_active(input.key, input.provider_type)
    }

    fn quota_refresh_endpoint(
        &self,
        endpoints: &[StoredProviderCatalogEndpoint],
        include_inactive: bool,
    ) -> Option<StoredProviderCatalogEndpoint> {
        provider_pool_matching_endpoint(endpoints, include_inactive, |endpoint| {
            provider_pool_endpoint_format_matches(endpoint, "openai:responses")
        })
    }

    fn quota_refresh_missing_endpoint_message(&self) -> String {
        "找不到有效的 openai:responses 端点".to_string()
    }
}

fn codex_explicit_quota_block_active(
    key: &aether_data_contracts::repository::provider_catalog::StoredProviderCatalogKey,
    provider_type: &str,
) -> bool {
    let Some(quota_snapshot) = provider_pool_member_quota_snapshot(key, provider_type) else {
        return provider_pool_metadata_bucket(key.upstream_metadata.as_ref(), provider_type)
            .is_some_and(|bucket| {
                (provider_pool_json_bool(bucket.get("allowed")) == Some(false)
                    || provider_pool_json_bool(bucket.get("limit_reached")) == Some(true))
                    && !["primary", "secondary"]
                        .into_iter()
                        .any(|prefix| codex_window_reset_elapsed(bucket, prefix))
            });
    };
    let explicitly_blocked = provider_pool_json_bool(quota_snapshot.get("allowed")) == Some(false)
        || provider_pool_json_bool(quota_snapshot.get("limit_reached")) == Some(true);
    if !explicitly_blocked {
        return false;
    }
    let observed_at = provider_pool_timestamp_unix_secs(
        quota_snapshot
            .get("observed_at")
            .or_else(|| quota_snapshot.get("updated_at")),
    );
    !provider_pool_current_unix_secs().is_some_and(|now_unix_secs| {
        provider_pool_reset_deadline_elapsed(quota_snapshot, observed_at, now_unix_secs)
    })
}

fn build_codex_wham_headers(
    resolved_oauth_auth: Option<(String, String)>,
    decrypted_api_key: Option<&str>,
    auth_config: Option<&Value>,
) -> Result<BTreeMap<String, String>, String> {
    let mut headers = BTreeMap::new();
    headers.insert("accept".to_string(), "application/json".to_string());
    let auth_config_headers = auth_config
        .and_then(|value| value.get("headers"))
        .and_then(Value::as_object);
    let auth_config_authorization = auth_config_headers
        .and_then(|headers| {
            headers
                .get("authorization")
                .or_else(|| headers.get("Authorization"))
        })
        .and_then(Value::as_str)
        .map(str::trim)
        .filter(|value| !value.is_empty());

    let is_agent_identity = auth_config
        .is_some_and(aether_provider_transport::is_codex_agent_identity_auth_config_value);

    if is_agent_identity {
        let Some((name, value)) = resolved_oauth_auth else {
            return Err("缺少 Agent Identity 认证信息，请先注册任务".to_string());
        };
        headers.insert(name.to_ascii_lowercase(), value);
    } else if let Some(authorization) = auth_config_authorization {
        headers.insert("authorization".to_string(), authorization.to_string());
    } else if let Some((name, value)) = resolved_oauth_auth {
        headers.insert(name.to_ascii_lowercase(), value);
    } else {
        let decrypted_key = decrypted_api_key.unwrap_or_default().trim();
        if decrypted_key.is_empty() || decrypted_key == PLACEHOLDER_API_KEY {
            return Err("缺少 OAuth 认证信息，请先授权/刷新 Token".to_string());
        }
        headers.insert(
            "authorization".to_string(),
            format!("Bearer {decrypted_key}"),
        );
    }

    let oauth_plan_type = auth_config
        .and_then(|value| value.get("plan_type"))
        .and_then(Value::as_str)
        .and_then(|value| crate::plan::normalize_provider_plan_tier(value, "codex"));
    let oauth_account_id = auth_config
        .and_then(|value| value.get("account_id"))
        .and_then(Value::as_str)
        .map(str::trim)
        .filter(|value| !value.is_empty());
    if oauth_account_id.is_some() && oauth_plan_type.as_deref() != Some("free") {
        headers.insert(
            "chatgpt-account-id".to_string(),
            oauth_account_id.unwrap_or_default().to_string(),
        );
    }

    Ok(headers)
}

pub fn build_codex_pool_quota_request(
    key_id: &str,
    resolved_oauth_auth: Option<(String, String)>,
    decrypted_api_key: Option<&str>,
    auth_config: Option<&Value>,
) -> Result<ProviderPoolQuotaRequestSpec, String> {
    let headers = build_codex_wham_headers(resolved_oauth_auth, decrypted_api_key, auth_config)?;

    Ok(ProviderPoolQuotaRequestSpec {
        request_id: format!("codex-quota:{key_id}"),
        provider_name: "codex".to_string(),
        quota_kind: "codex".to_string(),
        method: "GET".to_string(),
        url: CODEX_WHAM_USAGE_URL.to_string(),
        headers,
        content_type: None,
        json_body: None,
        client_api_format: "openai:responses".to_string(),
        provider_api_format: "openai:responses".to_string(),
        model_name: Some("codex-wham-usage".to_string()),
    })
}

pub fn build_codex_pool_reset_credits_request(
    key_id: &str,
    resolved_oauth_auth: Option<(String, String)>,
    decrypted_api_key: Option<&str>,
    auth_config: Option<&Value>,
) -> Result<ProviderPoolQuotaRequestSpec, String> {
    let headers = build_codex_wham_headers(resolved_oauth_auth, decrypted_api_key, auth_config)?;

    Ok(ProviderPoolQuotaRequestSpec {
        request_id: format!("codex-reset-credits:{key_id}"),
        provider_name: "codex".to_string(),
        quota_kind: "codex_reset_credits".to_string(),
        method: "GET".to_string(),
        url: CODEX_WHAM_RESET_CREDITS_URL.to_string(),
        headers,
        content_type: None,
        json_body: None,
        client_api_format: "openai:responses".to_string(),
        provider_api_format: "openai:responses".to_string(),
        model_name: Some("codex-wham-reset-credits".to_string()),
    })
}

pub fn build_codex_pool_reset_credit_consume_request(
    key_id: &str,
    resolved_oauth_auth: Option<(String, String)>,
    decrypted_api_key: Option<&str>,
    auth_config: Option<&Value>,
    redeem_request_id: &str,
) -> Result<ProviderPoolQuotaRequestSpec, String> {
    let redeem_request_id = redeem_request_id.trim();
    if redeem_request_id.is_empty() {
        return Err("缺少 Codex reset credit 幂等请求 ID".to_string());
    }

    let mut headers =
        build_codex_wham_headers(resolved_oauth_auth, decrypted_api_key, auth_config)?;
    headers.insert("content-type".to_string(), "application/json".to_string());

    Ok(ProviderPoolQuotaRequestSpec {
        request_id: format!("codex-reset-credit-consume:{key_id}:{redeem_request_id}"),
        provider_name: "codex".to_string(),
        quota_kind: "codex_reset_credit_consume".to_string(),
        method: "POST".to_string(),
        url: CODEX_WHAM_RESET_CREDITS_CONSUME_URL.to_string(),
        headers,
        content_type: Some("application/json".to_string()),
        json_body: Some(serde_json::json!({
            "redeem_request_id": redeem_request_id,
        })),
        client_api_format: "openai:responses".to_string(),
        provider_api_format: "openai:responses".to_string(),
        model_name: Some("codex-wham-reset-credit-consume".to_string()),
    })
}

fn codex_window_reset_elapsed(bucket: &Map<String, Value>, prefix: &str) -> bool {
    let Some(now_unix_secs) = provider_pool_current_unix_secs() else {
        return false;
    };
    let mut window = Map::new();
    for (target, source) in [
        ("reset_at", format!("{prefix}_reset_at")),
        ("next_reset_at", format!("{prefix}_next_reset_at")),
        ("reset_seconds", format!("{prefix}_reset_seconds")),
        (
            "reset_after_seconds",
            format!("{prefix}_reset_after_seconds"),
        ),
    ] {
        if let Some(value) = bucket.get(source.as_str()) {
            window.insert(target.to_string(), value.clone());
        }
    }
    provider_pool_reset_deadline_elapsed(
        &window,
        provider_pool_timestamp_unix_secs(bucket.get("updated_at")),
        now_unix_secs,
    )
}

fn codex_window_used_percent_exhausted(bucket: &Map<String, Value>, prefix: &str) -> bool {
    let used_percent_key = format!("{prefix}_used_percent");
    provider_pool_json_f64(bucket.get(used_percent_key.as_str()))
        .is_some_and(|value| value >= 100.0 && !codex_window_reset_elapsed(bucket, prefix))
}

pub(crate) fn quota_exhausted_from_bucket(bucket: &Map<String, Value>) -> bool {
    let allowed = provider_pool_json_bool(bucket.get("allowed"));
    let limit_reached = provider_pool_json_bool(bucket.get("limit_reached"));
    if allowed == Some(false) || limit_reached == Some(true) {
        let reset_elapsed = ["primary", "secondary"]
            .into_iter()
            .any(|prefix| codex_window_reset_elapsed(bucket, prefix));
        if !reset_elapsed {
            return true;
        }
    }
    if allowed == Some(true) || limit_reached == Some(false) {
        return false;
    }
    if provider_pool_json_bool(bucket.get("credits_unlimited")) == Some(true) {
        return false;
    }
    let has_window_data = provider_pool_json_f64(bucket.get("primary_used_percent")).is_some()
        || provider_pool_json_f64(bucket.get("secondary_used_percent")).is_some();
    if !has_window_data && provider_pool_json_bool(bucket.get("has_credits")) == Some(false) {
        return true;
    }
    codex_window_used_percent_exhausted(bucket, "primary")
        || codex_window_used_percent_exhausted(bucket, "secondary")
}