| @@ -964,31 +964,8 @@ | ||
| 964 | 964 | * @param string $prompt The prompt to send. |
| 965 | 965 | * @return array{ai_text:string,tokens:int} |
| 966 | 966 | */ |
| 967 | 967 | /** |
| 968 | - * Public plain-text completion against the configured provider. | |
| 969 | - * | |
| 970 | - * Thin gate over request_completion() for callers that need a free-form | |
| 971 | - * answer rather than a structured SEO artifact (e.g. the brand-visibility | |
| 972 | - * checker, which asks the model a user-style question and inspects the | |
| 973 | - * reply). Provider differences are already normalized inside. | |
| 974 | - * | |
| 975 | - * @since 1.27.0 | |
| 976 | - * | |
| 977 | - * @param string $prompt Prompt to send. | |
| 978 | - * @param int $max_tokens Output token ceiling. | |
| 979 | - * @return array{ai_text:string,tokens:int} | |
| 980 | - * @throws \Exception When no AI client is configured/available. | |
| 981 | - */ | |
| 982 | - public function answer_prompt(string $prompt, int $max_tokens = 1024, array $options = []): array { | |
| 983 | - if (!$this->client) { | |
| 984 | - throw new \Exception(wp_kses_post($this->get_client_unavailable_message())); | |
| 985 | - } | |
| 986 | - | |
| 987 | - return $this->request_completion($prompt, $max_tokens, $options); | |
| 988 | - } | |
| 989 | - | |
| 990 | - /** | |
| 991 | 968 | * Detect a provider-side refusal or content-policy block and fail with |
| 992 | 969 | * the real reason. Each provider signals these differently, and none of |
| 993 | 970 | * the signals set the content field the extraction chain looks for — left |
| 994 | 971 | * unchecked they read as an empty/unusable result with no explanation of |
| @@ -1070,10 +1047,10 @@ | ||
| 1070 | 1047 | $tokens = $response['usage']['total_tokens'] |
| 1071 | 1048 | ?? $response['usage']['output_tokens'] |
| 1072 | 1049 | ?? ($response['usageMetadata']['totalTokenCount'] ?? 0); |
| 1073 | 1050 | |
| 1074 | - // Diagnostics for callers that must explain an empty answer (e.g. the | |
| 1075 | - // brand-visibility probe): why generation stopped, and how much of the | |
| 1051 | + // Diagnostics for callers that must explain an empty answer: why | |
| 1052 | + // generation stopped, and how much of the | |
| 1076 | 1053 | // completion budget hidden reasoning consumed (OpenAI reasoning models). |
| 1077 | 1054 | // All three provider shapes are read — Gemini reports the stop reason |
| 1078 | 1055 | // per candidate, so without that arm the diagnostic was always blank |
| 1079 | 1056 | // for exactly the provider whose truncation it exists to explain. |
