data
11 months ago
engines
21 hours ago
exceptions
11 months ago
modules
21 hours ago
query
1 week ago
rest
1 month ago
services
21 hours ago
admin.php
1 month ago
api.php
1 month ago
core.php
5 days ago
discussion.php
11 months ago
event.php
11 months ago
init.php
7 months ago
logging.php
11 months ago
reply.php
3 weeks ago
rest.php
1 month ago
reply.php
367 lines
| 1 | <?php |
| 2 | |
| 3 | class Meow_MWAI_Reply implements JsonSerializable { |
| 4 | public $id = null; |
| 5 | public $result = ''; |
| 6 | public $results = []; |
| 7 | public $usage = [ |
| 8 | 'prompt_tokens' => 0, |
| 9 | 'completion_tokens' => 0, |
| 10 | 'total_tokens' => 0, |
| 11 | 'price' => null, |
| 12 | 'accuracy' => 'none', // 'none', 'estimated', 'tokens', 'price', 'full' |
| 13 | ]; |
| 14 | public $query = null; |
| 15 | public $type = 'text'; |
| 16 | public $model = null; // Actual model used by the API (may differ from query model) |
| 17 | |
| 18 | // Code interpreter code (separate from main content) |
| 19 | public $contentCode = ''; |
| 20 | |
| 21 | // Engine-specific extras kept on the reply during a single request (e.g. Google |
| 22 | // stores generated images, thoughts and grounding metadata here). Declared so PHP |
| 23 | // 8.2+ does not warn about dynamic property creation. |
| 24 | public $extraData = []; |
| 25 | |
| 26 | // This is when models return a message that needs to be executed (functions, tools, etc) |
| 27 | public $needFeedbacks = []; |
| 28 | public $needClientActions = []; |
| 29 | |
| 30 | public function __construct( $query = null ) { |
| 31 | $this->query = $query; |
| 32 | } |
| 33 | |
| 34 | #[\ReturnTypeWillChange] |
| 35 | public function jsonSerialize() { |
| 36 | $isEmbedding = false; |
| 37 | $embeddingsDimensions = null; |
| 38 | $embedddingsMessage = null; |
| 39 | if ( is_array( $this->results ) && count( $this->results ) > 0 ) { |
| 40 | $isEmbedding = is_array( $this->results[0] ); |
| 41 | if ( $isEmbedding ) { |
| 42 | $embeddingsDimensions = count( $this->results[0] ); |
| 43 | $embedddingsMessage = "A $embeddingsDimensions-dimensional embedding was returned."; |
| 44 | } |
| 45 | } |
| 46 | $data = [ |
| 47 | 'result' => $isEmbedding ? $embedddingsMessage : $this->result, |
| 48 | 'results' => $isEmbedding ? [] : $this->results, |
| 49 | 'usage' => $this->usage, |
| 50 | 'system' => [ |
| 51 | 'class' => get_class( $this ), |
| 52 | ] |
| 53 | ]; |
| 54 | if ( !empty( $this->needFeedbacks ) ) { |
| 55 | $data['needFeedbacks'] = $this->needFeedbacks; |
| 56 | } |
| 57 | if ( !empty( $this->needClientActions ) ) { |
| 58 | $data['needClientActions'] = $this->needClientActions; |
| 59 | } |
| 60 | if ( !empty( $this->contentCode ) ) { |
| 61 | $data['contentCode'] = $this->contentCode; |
| 62 | } |
| 63 | return $data; |
| 64 | } |
| 65 | |
| 66 | public function set_usage( $usage ) { |
| 67 | $this->usage = $usage; |
| 68 | } |
| 69 | |
| 70 | public function set_usage_accuracy( $accuracy ) { |
| 71 | $this->usage['accuracy'] = $accuracy; |
| 72 | } |
| 73 | |
| 74 | public function set_id( $id ) { |
| 75 | $this->id = $id; |
| 76 | } |
| 77 | |
| 78 | public function set_type( $type ) { |
| 79 | $this->type = $type; |
| 80 | } |
| 81 | |
| 82 | public function set_model( $model ) { |
| 83 | $this->model = $model; |
| 84 | } |
| 85 | |
| 86 | public function get_total_tokens() { |
| 87 | return isset( $this->usage['total_tokens'] ) ? $this->usage['total_tokens'] : 0; |
| 88 | } |
| 89 | |
| 90 | public function get_in_tokens( $query = null ) { |
| 91 | $in_tokens = isset( $this->usage['prompt_tokens'] ) ? $this->usage['prompt_tokens'] : 0; |
| 92 | if ( empty( $in_tokens ) && $query ) { |
| 93 | $in_tokens = $query->get_in_tokens(); |
| 94 | } |
| 95 | return $in_tokens; |
| 96 | } |
| 97 | |
| 98 | public function get_out_tokens() { |
| 99 | $out_tokens = isset( $this->usage['completion_tokens'] ) ? $this->usage['completion_tokens'] : 0; |
| 100 | if ( empty( $out_tokens ) ) { |
| 101 | // NOTE: Only estimate when result is actually text. Embedding replies hold a |
| 102 | // float vector, image replies hold URLs/arrays, etc. — running estimate_tokens() |
| 103 | // on those JSON-encodes the structure and produces huge bogus counts (a 3072-d |
| 104 | // Gemini embedding estimated as ~13k tokens for a 50-char input). Anything that |
| 105 | // isn't a string has no meaningful "output token" count, so return 0. |
| 106 | if ( !is_string( $this->result ) ) { |
| 107 | return 0; |
| 108 | } |
| 109 | $out_tokens = Meow_MWAI_Core::estimate_tokens( $this->result ); |
| 110 | } |
| 111 | return $out_tokens; |
| 112 | } |
| 113 | |
| 114 | public function get_price() { |
| 115 | // If it's not set return null, but it can be 0 |
| 116 | if ( !isset( $this->usage['price'] ) ) { |
| 117 | return null; |
| 118 | } |
| 119 | return $this->usage['price']; |
| 120 | } |
| 121 | |
| 122 | public function get_usage_accuracy() { |
| 123 | return $this->usage['accuracy'] ?? 'none'; |
| 124 | } |
| 125 | |
| 126 | /** |
| 127 | * Returns the metric count for this reply, preferring tokens. Falls back to |
| 128 | * images or seconds for non-token-billed providers (legacy Imagen/Replicate |
| 129 | * per-image, Whisper, Sora). Equivalent to (and aliased by) get_units(). |
| 130 | */ |
| 131 | public function get_tokens() { |
| 132 | if ( isset( $this->usage['total_tokens'] ) ) { |
| 133 | return $this->usage['total_tokens']; |
| 134 | } |
| 135 | else if ( isset( $this->usage['images'] ) ) { |
| 136 | return $this->usage['images']; |
| 137 | } |
| 138 | else if ( isset( $this->usage['seconds'] ) ) { |
| 139 | return $this->usage['seconds']; |
| 140 | } |
| 141 | return null; |
| 142 | } |
| 143 | |
| 144 | /** |
| 145 | * Legacy alias for get_tokens(). Kept indefinitely — third-party code |
| 146 | * reachable via the mwai_ai_reply filter may call it. |
| 147 | */ |
| 148 | public function get_units() { |
| 149 | return $this->get_tokens(); |
| 150 | } |
| 151 | |
| 152 | public function get_type() { |
| 153 | return $this->type; |
| 154 | } |
| 155 | |
| 156 | public function set_reply( $reply ) { |
| 157 | $this->result = $reply; |
| 158 | $this->results[] = [ $reply ]; |
| 159 | } |
| 160 | |
| 161 | public function replace( $search, $replace ) { |
| 162 | $this->result = str_replace( $search, $replace, $this->result ); |
| 163 | $this->results = array_map( function ( $result ) use ( $search, $replace ) { |
| 164 | return str_replace( $search, $replace, $result ); |
| 165 | }, $this->results ); |
| 166 | } |
| 167 | |
| 168 | private function extract_arguments( $funcArgs ) { |
| 169 | $finalArgs = []; |
| 170 | if ( is_string( $funcArgs ) ) { |
| 171 | $arguments = trim( str_replace( "\n", '', $funcArgs ) ); |
| 172 | if ( substr( $arguments, 0, 1 ) == '{' ) { |
| 173 | $arguments = json_decode( $arguments, true ); |
| 174 | $finalArgs = $arguments; |
| 175 | } |
| 176 | } |
| 177 | else if ( is_array( $funcArgs ) ) { |
| 178 | $finalArgs = $funcArgs; |
| 179 | } |
| 180 | return $finalArgs; |
| 181 | } |
| 182 | |
| 183 | /** |
| 184 | * Set the choices from OpenAI as the results. |
| 185 | * The last (or only) result is set as the result. |
| 186 | * @param array $choices ID of the model to use. |
| 187 | */ |
| 188 | public function set_choices( $choices, $rawMessage = null ) { |
| 189 | $this->results = []; |
| 190 | |
| 191 | // Initialize feedback arrays at the start to accumulate across all choices |
| 192 | // This is important for engines like Google that split multiple function calls |
| 193 | // into separate choices |
| 194 | $this->needFeedbacks = []; |
| 195 | $this->needClientActions = []; |
| 196 | |
| 197 | if ( is_array( $choices ) ) { |
| 198 | foreach ( $choices as $choice ) { |
| 199 | |
| 200 | // It's chat completion |
| 201 | if ( isset( $choice['message'] ) ) { |
| 202 | |
| 203 | // It's text content |
| 204 | if ( isset( $choice['message']['content'] ) ) { |
| 205 | $content = trim( $choice['message']['content'] ); |
| 206 | $this->results[] = $content; |
| 207 | $this->result = $content; |
| 208 | } |
| 209 | |
| 210 | // It's a tool call (OpenAI-style and Anthropic-style) |
| 211 | $toolCalls = []; |
| 212 | if ( isset( $choice['message']['tool_calls'] ) ) { |
| 213 | $tools = $choice['message']['tool_calls']; |
| 214 | foreach ( $tools as $tool ) { |
| 215 | if ( $tool['type'] === 'function' ) { |
| 216 | $toolCall = [ |
| 217 | 'toolId' => $tool['id'], |
| 218 | //'mode' => 'interactive', |
| 219 | 'type' => 'tool_call', |
| 220 | 'name' => trim( $tool['function']['name'] ), |
| 221 | 'arguments' => $this->extract_arguments( $tool['function']['arguments'] ), |
| 222 | // Represent the original message that triggered the function call |
| 223 | 'rawMessage' => $rawMessage ? $rawMessage : ( isset( $choice['_rawMessage'] ) ? $choice['_rawMessage'] : $choice['message'] ), |
| 224 | ]; |
| 225 | $toolCalls[] = $toolCall; |
| 226 | } |
| 227 | } |
| 228 | } |
| 229 | |
| 230 | // If it's a function call (Open-AI style; usually for a final execution) |
| 231 | if ( isset( $choice['message']['function_call'] ) ) { |
| 232 | $content = $choice['message']['function_call']; |
| 233 | $name = trim( $content['name'] ); |
| 234 | $args = $content['arguments'] ?? $content['args'] ?? null; |
| 235 | $toolCalls[] = [ |
| 236 | 'toolId' => null, |
| 237 | 'mode' => 'static', |
| 238 | 'type' => 'function_call', |
| 239 | 'name' => $name, |
| 240 | 'arguments' => $this->extract_arguments( $args ), |
| 241 | 'rawMessage' => $rawMessage ? $rawMessage : ( isset( $choice['_rawMessage'] ) ? $choice['_rawMessage'] : $choice['message'] ), |
| 242 | ]; |
| 243 | } |
| 244 | |
| 245 | // Deep copy tool calls BEFORE adding function references |
| 246 | // This prevents the "Duplicate value for 'tool_call_id'" error |
| 247 | // when the same function is called multiple times |
| 248 | // Note: We need to preserve the toolId for each tool call |
| 249 | if ( !empty( $toolCalls ) ) { |
| 250 | $toolCalls = json_decode( json_encode( $toolCalls ), true ); |
| 251 | } |
| 252 | |
| 253 | // Resolve the original function from the query |
| 254 | if ( !empty( $toolCalls ) ) { |
| 255 | foreach ( $toolCalls as &$toolCall ) { |
| 256 | if ( $toolCall['type'] !== 'function_call' && $toolCall['type'] !== 'tool_call' ) { |
| 257 | continue; |
| 258 | } |
| 259 | foreach ( $this->query->functions as $function ) { |
| 260 | if ( $function->name == $toolCall['name'] ) { |
| 261 | $toolCall['function'] = $function; |
| 262 | break; |
| 263 | } |
| 264 | } |
| 265 | } |
| 266 | // IMPORTANT: Unset the reference to avoid PHP's foreach reference bug |
| 267 | unset( $toolCall ); |
| 268 | } |
| 269 | |
| 270 | // Add tool calls to existing arrays instead of resetting them |
| 271 | // This is crucial for engines like Google that create multiple choices |
| 272 | // for multiple function calls in a single response |
| 273 | foreach ( $toolCalls as $tcIdx => $toolCall ) { |
| 274 | if ( $toolCall['function']->target !== 'js' ) { |
| 275 | $this->needFeedbacks[] = $toolCall; |
| 276 | } |
| 277 | else if ( $toolCall['function']->target === 'js' ) { |
| 278 | $this->needClientActions[] = $toolCall; |
| 279 | } |
| 280 | } |
| 281 | } |
| 282 | |
| 283 | // It's text completion |
| 284 | else if ( isset( $choice['text'] ) ) { |
| 285 | |
| 286 | // TODO: Assistants return an array (so actually not really a text completion) |
| 287 | // We should probably make this clearer and analyze all the outputs from different endpoints. |
| 288 | if ( is_array( $choice['text'] ) ) { |
| 289 | $text = trim( $choice['text']['value'] ); |
| 290 | $this->results[] = $text; |
| 291 | $this->result = $text; |
| 292 | } |
| 293 | else { |
| 294 | $text = trim( $choice['text'] ); |
| 295 | $this->results[] = $text; |
| 296 | $this->result = $text; |
| 297 | } |
| 298 | } |
| 299 | |
| 300 | // It's url/image |
| 301 | else if ( isset( $choice['url'] ) ) { |
| 302 | $url = trim( $choice['url'] ); |
| 303 | $this->results[] = $url; |
| 304 | $this->result = $url; |
| 305 | } |
| 306 | else if ( isset( $choice['b64_json'] ) ) { |
| 307 | // In that case we need to create a temporary file in WordPress to store the image, and return the URL for it. |
| 308 | global $mwai_core; |
| 309 | |
| 310 | // Check if the query has explicitly disabled local download |
| 311 | if ( !empty( $this->query ) && $this->query instanceof Meow_MWAI_Query_Image && $this->query->localDownload === null ) { |
| 312 | // Query explicitly doesn't want local download, save as temporary upload |
| 313 | $localDownload = 'uploads'; |
| 314 | $expiry = 1 * HOUR_IN_SECONDS; // 1 hour for temporary images |
| 315 | } |
| 316 | else { |
| 317 | // Use the user's AI-generated image settings |
| 318 | $localDownload = $mwai_core->get_option( 'image_local_download' ); |
| 319 | $expiry = (int) $mwai_core->get_option( 'image_expires_download' ); |
| 320 | } |
| 321 | |
| 322 | // The expiry is already in seconds |
| 323 | $ttl = $expiry; |
| 324 | |
| 325 | // Use 'library' or 'uploads' based on user settings |
| 326 | $target = ( $localDownload === 'library' ) ? 'library' : 'uploads'; |
| 327 | |
| 328 | // Prepare metadata similar to regular image queries |
| 329 | $metadata = []; |
| 330 | if ( !empty( $this->query ) ) { |
| 331 | $metadata['query_envId'] = $this->query->envId ?? null; |
| 332 | $metadata['query_session'] = $this->query->session ?? null; |
| 333 | $metadata['query_model'] = $this->query->model ?? 'gpt-image-1'; |
| 334 | } |
| 335 | |
| 336 | $url = $mwai_core->files->save_temp_image_from_b64( $choice['b64_json'], 'generated', $ttl, $target, $metadata ); |
| 337 | if ( is_wp_error( $url ) ) { |
| 338 | return $url; |
| 339 | } |
| 340 | $this->results[] = $url; |
| 341 | |
| 342 | // For chatbot display, append image markdown to the result |
| 343 | if ( !empty( $this->result ) ) { |
| 344 | $this->result .= "\n\n"; |
| 345 | } |
| 346 | $this->result .= ""; |
| 347 | } |
| 348 | |
| 349 | // It's embedding |
| 350 | else if ( isset( $choice['embedding'] ) ) { |
| 351 | $content = $choice['embedding']; |
| 352 | $this->results[] = $content; |
| 353 | $this->result = $content; |
| 354 | } |
| 355 | } |
| 356 | } |
| 357 | else { |
| 358 | $this->result = $choices; |
| 359 | $this->results[] = $choices; |
| 360 | } |
| 361 | } |
| 362 | |
| 363 | public function toJson() { |
| 364 | return json_encode( $this ); |
| 365 | } |
| 366 | } |
| 367 |