AI: Update php-ai-client to 1.3.0.

Updates the bundled `php-ai-client` library to version 1.3.0 and aligns the WordPress-specific prompt builder (`WP_AI_Client_Prompt_Builder`) with the upstream changes.

Key changes in php-ai-client 1.3.0:
* Adds video generation model interfaces.
* Enhances `PromptBuilder` with additional configuration methods.
* Improves `TokenUsage` and `ProviderMetadata` DTOs.
* Updates `MessagePart` DTO.

See release: https://github.com/WordPress/php-ai-client/releases/tag/1.3.0

Developed in WordPress#11219

Props flixos90.
See #64591.




git-svn-id: https://develop.svn.wordpress.org/trunk@61942 602fd350-edb4-49c9-b593-d223f7449a82

Author: gziolo

src/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php

@@ -10,6 +10,7 @@
 use WordPress\AiClient\Builders\PromptBuilder;
 use WordPress\AiClient\Files\DTO\File;
 use WordPress\AiClient\Files\Enums\FileTypeEnum;
+use WordPress\AiClient\Files\Enums\MediaOrientationEnum;
 use WordPress\AiClient\Messages\DTO\Message;
 use WordPress\AiClient\Messages\DTO\MessagePart;
 use WordPress\AiClient\Messages\Enums\ModalityEnum;
@@ -66,6 +67,9 @@
  * @method self as_output_schema(array<string, mixed> $schema) Sets the output schema.
  * @method self as_output_modalities(ModalityEnum ...$modalities) Sets the output modalities.
  * @method self as_output_file_type(FileTypeEnum $fileType) Sets the output file type.
+ * @method self as_output_media_orientation(MediaOrientationEnum $orientation) Sets the output media orientation.
+ * @method self as_output_media_aspect_ratio(string $aspectRatio) Sets the output media aspect ratio.
+ * @method self as_output_speech_voice(string $voice) Sets the output speech voice.
  * @method self as_json_response(?array<string, mixed> $schema = null) Configures the prompt for JSON response output.
  * @method bool|WP_Error is_supported(?CapabilityEnum $capability = null) Checks if the prompt is supported for the given capability.
  * @method bool is_supported_for_text_generation() Checks if the prompt is supported for text generation.
@@ -80,6 +84,7 @@
  * @method GenerativeAiResult|WP_Error generate_image_result() Generates an image result from the prompt.
  * @method GenerativeAiResult|WP_Error generate_speech_result() Generates a speech result from the prompt.
  * @method GenerativeAiResult|WP_Error convert_text_to_speech_result() Converts text to speech and returns the result.
+ * @method GenerativeAiResult|WP_Error generate_video_result() Generates a video result from the prompt.
  * @method string|WP_Error generate_text() Generates text from the prompt.
  * @method list<string>|WP_Error generate_texts(?int $candidateCount = null) Generates multiple text candidates from the prompt.
  * @method File|WP_Error generate_image() Generates an image from the prompt.
@@ -88,6 +93,8 @@
  * @method list<File>|WP_Error convert_text_to_speeches(?int $candidateCount = null) Converts text to multiple speech outputs.
  * @method File|WP_Error generate_speech() Generates speech from the prompt.
  * @method list<File>|WP_Error generate_speeches(?int $candidateCount = null) Generates multiple speech outputs from the prompt.
+ * @method File|WP_Error generate_video() Generates a video from the prompt.
+ * @method list<File>|WP_Error generate_videos(?int $candidateCount = null) Generates multiple videos from the prompt.
  */
 class WP_AI_Client_Prompt_Builder {
 
@@ -121,6 +128,7 @@ class WP_AI_Client_Prompt_Builder {
 		'generate_image_result'         => true,
 		'generate_speech_result'        => true,
 		'convert_text_to_speech_result' => true,
+		'generate_video_result'         => true,
 		'generate_text'                 => true,
 		'generate_texts'                => true,
 		'generate_image'                => true,
@@ -129,6 +137,8 @@ class WP_AI_Client_Prompt_Builder {
 		'convert_text_to_speeches'      => true,
 		'generate_speech'               => true,
 		'generate_speeches'             => true,
+		'generate_video'                => true,
+		'generate_videos'               => true,
 	);
 
 	/**

src/wp-includes/php-ai-client/src/AiClient.php

@@ -84,7 +84,7 @@ class AiClient
     /**
      * @var string The version of the AI Client.
      */
-    public const VERSION = '1.2.1';
+    public const VERSION = '1.3.0';
     /**
      * @var ProviderRegistry|null The default provider registry instance.
      */
@@ -314,6 +314,26 @@ public static function generateSpeechResult($prompt, $modelOrConfig = null, ?Pro
         self::validateModelOrConfigParameter($modelOrConfig);
         return self::getConfiguredPromptBuilder($prompt, $modelOrConfig, $registry)->generateSpeechResult();
     }
+    /**
+     * Generates a video using the traditional API approach.
+     *
+     * @since 1.3.0
+     *
+     * @param Prompt $prompt The prompt content.
+     * @param ModelInterface|ModelConfig|null $modelOrConfig Optional specific model to use,
+     *                                                        or model configuration for auto-discovery,
+     *                                                        or null for defaults.
+     * @param ProviderRegistry|null $registry Optional custom registry. If null, uses default.
+     * @return GenerativeAiResult The generation result.
+     *
+     * @throws \InvalidArgumentException If the prompt format is invalid.
+     * @throws \RuntimeException If no suitable model is found.
+     */
+    public static function generateVideoResult($prompt, $modelOrConfig = null, ?ProviderRegistry $registry = null): GenerativeAiResult
+    {
+        self::validateModelOrConfigParameter($modelOrConfig);
+        return self::getConfiguredPromptBuilder($prompt, $modelOrConfig, $registry)->generateVideoResult();
+    }
     /**
      * Creates a new message builder for fluent API usage.
      *

src/wp-includes/php-ai-client/src/Builders/PromptBuilder.php

@@ -10,6 +10,7 @@
 use WordPress\AiClient\Events\BeforeGenerateResultEvent;
 use WordPress\AiClient\Files\DTO\File;
 use WordPress\AiClient\Files\Enums\FileTypeEnum;
+use WordPress\AiClient\Files\Enums\MediaOrientationEnum;
 use WordPress\AiClient\Messages\DTO\Message;
 use WordPress\AiClient\Messages\DTO\MessagePart;
 use WordPress\AiClient\Messages\DTO\UserMessage;
@@ -26,6 +27,7 @@
 use WordPress\AiClient\Providers\Models\SpeechGeneration\Contracts\SpeechGenerationModelInterface;
 use WordPress\AiClient\Providers\Models\TextGeneration\Contracts\TextGenerationModelInterface;
 use WordPress\AiClient\Providers\Models\TextToSpeechConversion\Contracts\TextToSpeechConversionModelInterface;
+use WordPress\AiClient\Providers\Models\VideoGeneration\Contracts\VideoGenerationModelInterface;
 use WordPress\AiClient\Providers\ProviderRegistry;
 use WordPress\AiClient\Results\DTO\GenerativeAiResult;
 use WordPress\AiClient\Tools\DTO\FunctionDeclaration;
@@ -398,7 +400,7 @@ public function usingTopK(int $topK): self
      */
     public function usingStopSequences(string ...$stopSequences): self
     {
-        $this->modelConfig->setCustomOption('stopSequences', $stopSequences);
+        $this->modelConfig->setStopSequences($stopSequences);
         return $this;
     }
     /**
@@ -552,6 +554,48 @@ public function asOutputFileType(FileTypeEnum $fileType): self
         $this->modelConfig->setOutputFileType($fileType);
         return $this;
     }
+    /**
+     * Sets the output media orientation.
+     *
+     * @since 1.3.0
+     *
+     * @param MediaOrientationEnum $orientation The output media orientation.
+     * @return self
+     */
+    public function asOutputMediaOrientation(MediaOrientationEnum $orientation): self
+    {
+        $this->modelConfig->setOutputMediaOrientation($orientation);
+        return $this;
+    }
+    /**
+     * Sets the output media aspect ratio.
+     *
+     * If set, this supersedes the output media orientation, as it is a more
+     * specific configuration.
+     *
+     * @since 1.3.0
+     *
+     * @param string $aspectRatio The aspect ratio (e.g. "16:9", "3:2").
+     * @return self
+     */
+    public function asOutputMediaAspectRatio(string $aspectRatio): self
+    {
+        $this->modelConfig->setOutputMediaAspectRatio($aspectRatio);
+        return $this;
+    }
+    /**
+     * Sets the output speech voice.
+     *
+     * @since 1.3.0
+     *
+     * @param string $voice The output speech voice.
+     * @return self
+     */
+    public function asOutputSpeechVoice(string $voice): self
+    {
+        $this->modelConfig->setOutputSpeechVoice($voice);
+        return $this;
+    }
     /**
      * Configures the prompt for JSON response output.
      *
@@ -627,6 +671,9 @@ private function inferCapabilityFromModelInterfaces(ModelInterface $model): ?Cap
         if ($model instanceof SpeechGenerationModelInterface) {
             return CapabilityEnum::speechGeneration();
         }
+        if ($model instanceof VideoGenerationModelInterface) {
+            return CapabilityEnum::videoGeneration();
+        }
         // No supported interface found
         return null;
     }
@@ -825,9 +872,11 @@ private function executeModelGeneration(ModelInterface $model, CapabilityEnum $c
             }
             return $model->generateSpeechResult($messages);
         }
-        // Video generation is not yet implemented
         if ($capability->isVideoGeneration()) {
-            throw new RuntimeException('Output modality "video" is not yet supported.');
+            if (!$model instanceof VideoGenerationModelInterface) {
+                throw new RuntimeException(sprintf('Model "%s" does not support video generation.', $model->metadata()->getId()));
+            }
+            return $model->generateVideoResult($messages);
         }
         // TODO: Add support for other capabilities when interfaces are available
         throw new RuntimeException(sprintf('Capability "%s" is not yet supported for generation.', $capability->value));
@@ -896,6 +945,22 @@ public function convertTextToSpeechResult(): GenerativeAiResult
         // Generate and return the result with text-to-speech conversion capability
         return $this->generateResult(CapabilityEnum::textToSpeechConversion());
     }
+    /**
+     * Generates a video result from the prompt.
+     *
+     * @since 1.3.0
+     *
+     * @return GenerativeAiResult The generated result containing video candidates.
+     * @throws InvalidArgumentException If the prompt or model validation fails.
+     * @throws RuntimeException If the model doesn't support video generation.
+     */
+    public function generateVideoResult(): GenerativeAiResult
+    {
+        // Include video in output modalities
+        $this->includeOutputModalities(ModalityEnum::video());
+        // Generate and return the result with video generation capability
+        return $this->generateResult(CapabilityEnum::videoGeneration());
+    }
     /**
      * Generates text from the prompt.
      *
@@ -1015,6 +1080,36 @@ public function generateSpeeches(?int $candidateCount = null): array
         }
         return $this->generateSpeechResult()->toFiles();
     }
+    /**
+     * Generates a video from the prompt.
+     *
+     * @since 1.3.0
+     *
+     * @return File The generated video file.
+     * @throws InvalidArgumentException If the prompt or model validation fails.
+     * @throws RuntimeException If no video is generated.
+     */
+    public function generateVideo(): File
+    {
+        return $this->generateVideoResult()->toFile();
+    }
+    /**
+     * Generates multiple videos from the prompt.
+     *
+     * @since 1.3.0
+     *
+     * @param int|null $candidateCount The number of videos to generate.
+     * @return list<File> The generated video files.
+     * @throws InvalidArgumentException If the prompt or model validation fails.
+     * @throws RuntimeException If no videos are generated.
+     */
+    public function generateVideos(?int $candidateCount = null): array
+    {
+        if ($candidateCount !== null) {
+            $this->usingCandidateCount($candidateCount);
+        }
+        return $this->generateVideoResult()->toFiles();
+    }
     /**
      * Appends a MessagePart to the messages array.
      *

src/wp-includes/php-ai-client/src/Messages/DTO/MessagePart.php

@@ -26,6 +26,7 @@
  * @phpstan-type MessagePartArrayShape array{
  *     channel: string,
  *     type: string,
+ *     thoughtSignature?: string,
  *     text?: string,
  *     file?: FileArrayShape,
  *     functionCall?: FunctionCallArrayShape,
@@ -38,6 +39,7 @@ class MessagePart extends AbstractDataTransferObject
 {
     public const KEY_CHANNEL = 'channel';
     public const KEY_TYPE = 'type';
+    public const KEY_THOUGHT_SIGNATURE = 'thoughtSignature';
     public const KEY_TEXT = 'text';
     public const KEY_FILE = 'file';
     public const KEY_FUNCTION_CALL = 'functionCall';
@@ -50,6 +52,10 @@ class MessagePart extends AbstractDataTransferObject
      * @var MessagePartTypeEnum The type of this message part.
      */
     private MessagePartTypeEnum $type;
+    /**
+     * @var string|null Thought signature for extended thinking.
+     */
+    private ?string $thoughtSignature = null;
     /**
      * @var string|null Text content (when type is TEXT).
      */
@@ -73,11 +79,13 @@ class MessagePart extends AbstractDataTransferObject
      *
      * @param mixed $content The content of this message part.
      * @param MessagePartChannelEnum|null $channel The channel this part belongs to. Defaults to CONTENT.
+     * @param string|null $thoughtSignature Optional thought signature for extended thinking.
      * @throws InvalidArgumentException If an unsupported content type is provided.
      */
-    public function __construct($content, ?MessagePartChannelEnum $channel = null)
+    public function __construct($content, ?MessagePartChannelEnum $channel = null, ?string $thoughtSignature = null)
     {
         $this->channel = $channel ?? MessagePartChannelEnum::content();
+        $this->thoughtSignature = $thoughtSignature;
         if (is_string($content)) {
             $this->type = MessagePartTypeEnum::text();
             $this->text = $content;
@@ -117,6 +125,17 @@ public function getType(): MessagePartTypeEnum
     {
         return $this->type;
     }
+    /**
+     * Gets the thought signature.
+     *
+     * @since 1.3.0
+     *
+     * @return string|null The thought signature or null if not set.
+     */
+    public function getThoughtSignature(): ?string
+    {
+        return $this->thoughtSignature;
+    }
     /**
      * Gets the text content.
      *
@@ -169,7 +188,8 @@ public function getFunctionResponse(): ?FunctionResponse
     public static function getJsonSchema(): array
     {
         $channelSchema = ['type' => 'string', 'enum' => MessagePartChannelEnum::getValues(), 'description' => 'The channel this message part belongs to.'];
-        return ['oneOf' => [['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::text()->value], self::KEY_TEXT => ['type' => 'string', 'description' => 'Text content.']], 'required' => [self::KEY_TYPE, self::KEY_TEXT], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::file()->value], self::KEY_FILE => File::getJsonSchema()], 'required' => [self::KEY_TYPE, self::KEY_FILE], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::functionCall()->value], self::KEY_FUNCTION_CALL => FunctionCall::getJsonSchema()], 'required' => [self::KEY_TYPE, self::KEY_FUNCTION_CALL], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::functionResponse()->value], self::KEY_FUNCTION_RESPONSE => FunctionResponse::getJsonSchema()], 'required' => [self::KEY_TYPE, self::KEY_FUNCTION_RESPONSE], 'additionalProperties' => \false]]];
+        $thoughtSignatureSchema = ['type' => 'string', 'description' => 'Thought signature for extended thinking.'];
+        return ['oneOf' => [['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::text()->value], self::KEY_TEXT => ['type' => 'string', 'description' => 'Text content.'], self::KEY_THOUGHT_SIGNATURE => $thoughtSignatureSchema], 'required' => [self::KEY_TYPE, self::KEY_TEXT], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::file()->value], self::KEY_FILE => File::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE => $thoughtSignatureSchema], 'required' => [self::KEY_TYPE, self::KEY_FILE], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::functionCall()->value], self::KEY_FUNCTION_CALL => FunctionCall::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE => $thoughtSignatureSchema], 'required' => [self::KEY_TYPE, self::KEY_FUNCTION_CALL], 'additionalProperties' => \false], ['type' => 'object', 'properties' => [self::KEY_CHANNEL => $channelSchema, self::KEY_TYPE => ['type' => 'string', 'const' => MessagePartTypeEnum::functionResponse()->value], self::KEY_FUNCTION_RESPONSE => FunctionResponse::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE => $thoughtSignatureSchema], 'required' => [self::KEY_TYPE, self::KEY_FUNCTION_RESPONSE], 'additionalProperties' => \false]]];
     }
     /**
      * {@inheritDoc}
@@ -192,6 +212,9 @@ public function toArray(): array
         } else {
             throw new RuntimeException('MessagePart requires one of: text, file, functionCall, or functionResponse. ' . 'This should not be a possible condition.');
         }
+        if ($this->thoughtSignature !== null) {
+            $data[self::KEY_THOUGHT_SIGNATURE] = $this->thoughtSignature;
+        }
         return $data;
     }
     /**
@@ -206,15 +229,16 @@ public static function fromArray(array $array): self
         } else {
             $channel = null;
         }
+        $thoughtSignature = $array[self::KEY_THOUGHT_SIGNATURE] ?? null;
         // Check which properties are set to determine how to construct the MessagePart
         if (isset($array[self::KEY_TEXT])) {
-            return new self($array[self::KEY_TEXT], $channel);
+            return new self($array[self::KEY_TEXT], $channel, $thoughtSignature);
         } elseif (isset($array[self::KEY_FILE])) {
-            return new self(File::fromArray($array[self::KEY_FILE]), $channel);
+            return new self(File::fromArray($array[self::KEY_FILE]), $channel, $thoughtSignature);
         } elseif (isset($array[self::KEY_FUNCTION_CALL])) {
-            return new self(FunctionCall::fromArray($array[self::KEY_FUNCTION_CALL]), $channel);
+            return new self(FunctionCall::fromArray($array[self::KEY_FUNCTION_CALL]), $channel, $thoughtSignature);
         } elseif (isset($array[self::KEY_FUNCTION_RESPONSE])) {
-            return new self(FunctionResponse::fromArray($array[self::KEY_FUNCTION_RESPONSE]), $channel);
+            return new self(FunctionResponse::fromArray($array[self::KEY_FUNCTION_RESPONSE]), $channel, $thoughtSignature);
         } else {
             throw new InvalidArgumentException('MessagePart requires one of: text, file, functionCall, or functionResponse.');
         }