false`. */ class AIClientFactory { /** * The provider ids the plugin supports. */ const PROVIDERS = array( 'openai', 'gemini', 'claude', 'openrouter' ); /** * Local default AI parameters per provider. * * These values replace the remote parameter-optimization lookup removed * when the plugin became BYOK-only (it previously fetched tuning from * api.aiforwoo.com). They are identical to the defaults free-plan users * already received, so behavior is unchanged. * * Claude defense-in-depth: temperature ONLY, never top_p. Anthropic 400s * when temperature and top_p are sent together, so Claude must not inherit * the OpenAI fallback (which carries top_p 1.0). The authoritative guard is * ClaudeClient's body builder, which never emits top_p regardless. */ private static array $default_params = [ 'openai' => [ 'temperature' => 0.7, 'top_p' => 1.0, 'frequency_penalty' => 0.0, 'presence_penalty' => 0.0 ], 'gemini' => [ 'temperature' => 0.7, 'top_p' => 0.95, 'top_k' => 40 ], 'openrouter' => [ 'temperature' => 0.7, 'top_p' => 1.0 ], 'claude' => [ 'temperature' => 0.7 ] ]; /** * @param string|null $api_provider AIPT provider id; '' or null uses the saved provider. * @param array $options `guard` (bool, default true): wrap the client in ProviderCallGuard. * The content structure engine passes false because it applies its own policy. * @return \AIPT\Api\AIClientInterface * @throws ProviderCallException For an unsupported provider, AI turned off on the site, or no saved key. */ public static function create($api_provider, $options = []) { $api_provider = strtolower( trim( (string) $api_provider ) ); if ( '' === $api_provider ) { $api_provider = strtolower( trim( (string) get_option( 'aipt_api_provider', 'openai' ) ) ); } if ( ! in_array( $api_provider, self::PROVIDERS, true ) ) { throw ProviderCallException::unsupportedProvider( $api_provider ); } $ai_gate = \AIPT\Core\Services\AiSupportGate::guard(); if ( $ai_gate instanceof \WP_Error ) { throw ProviderCallException::aiDisabled( $ai_gate, $api_provider ); } $resolver = CredentialResolver::instance(); $api_key = $resolver->getKey($api_provider); if ( ! is_string( $api_key ) || '' === $api_key ) { throw ProviderCallException::keyMissing( $api_provider, $resolver->getSourceLabel( $api_provider ) ); } if ($api_provider === 'gemini') { $client = new GeminiClient($api_key); } elseif ($api_provider === 'openrouter') { $client = new OpenRouterClient($api_key); } elseif ($api_provider === 'claude') { $client = new ClaudeClient($api_key, null, (string) get_option('aipt_claude_workspace_id', '')); } else { $client = new OpenAIClient($api_key); } self::applyParameterOptimization($client, $api_provider, $options); if ( false === ( $options['guard'] ?? true ) ) { return $client; } return new ProviderCallGuard( $client, $api_provider, ProviderCircuit::scope( $api_provider, $api_key ) ); } /** * AI istemcisine optimum parametreleri uygular * * @param object $client AI istemcisi (OpenAIClient veya GeminiClient) * @param string $provider API sağlayıcı (openai, gemini) * @param array $options İstemci oluşturma seçenekleri * @return void */ private static function applyParameterOptimization($client, $provider, $options = []) { try { $optimizedParams = self::$default_params[$provider] ?? self::$default_params['openai']; if (empty($optimizedParams) || !is_array($optimizedParams)) { return; } if (isset($optimizedParams['max_tokens'])) { unset($optimizedParams['max_tokens']); } $validParams = []; if ($provider === 'openai' || $provider === 'openrouter') { if (isset($optimizedParams['temperature']) && is_numeric($optimizedParams['temperature'])) { $temp = floatval($optimizedParams['temperature']); if ($temp >= 0.0 && $temp <= 2.0) { $validParams['temperature'] = $temp; } } if (isset($optimizedParams['top_p']) && is_numeric($optimizedParams['top_p'])) { $topP = floatval($optimizedParams['top_p']); if ($topP >= 0.0 && $topP <= 1.0) { $validParams['top_p'] = $topP; } } if (isset($optimizedParams['frequency_penalty']) && is_numeric($optimizedParams['frequency_penalty'])) { $freq = floatval($optimizedParams['frequency_penalty']); if ($freq >= -2.0 && $freq <= 2.0) { $validParams['frequency_penalty'] = $freq; } } if (isset($optimizedParams['presence_penalty']) && is_numeric($optimizedParams['presence_penalty'])) { $pres = floatval($optimizedParams['presence_penalty']); if ($pres >= -2.0 && $pres <= 2.0) { $validParams['presence_penalty'] = $pres; } } } else if ($provider === 'gemini') { if (isset($optimizedParams['temperature']) && is_numeric($optimizedParams['temperature'])) { $temp = floatval($optimizedParams['temperature']); if ($temp >= 0.0 && $temp <= 1.0) { $validParams['temperature'] = $temp; } } if (isset($optimizedParams['top_p']) && is_numeric($optimizedParams['top_p'])) { $topP = floatval($optimizedParams['top_p']); if ($topP >= 0.0 && $topP <= 1.0) { $validParams['top_p'] = $topP; } } if (isset($optimizedParams['top_k']) && is_numeric($optimizedParams['top_k'])) { $topK = intval($optimizedParams['top_k']); if ($topK >= 1 && $topK <= 40) { $validParams['top_k'] = $topK; } } } else if ($provider === 'claude') { if (isset($optimizedParams['temperature']) && is_numeric($optimizedParams['temperature'])) { $temp = floatval($optimizedParams['temperature']); if ($temp >= 0.0 && $temp <= 1.0) { $validParams['temperature'] = $temp; } } if (isset($optimizedParams['top_p']) && is_numeric($optimizedParams['top_p'])) { $topP = floatval($optimizedParams['top_p']); if ($topP >= 0.0 && $topP <= 1.0) { $validParams['top_p'] = $topP; } } } if (!empty($validParams) && method_exists($client, 'setParameters')) { $client->setParameters($validParams); } else { } } catch (\Exception $e) { } catch (\Error $e) { } } }