AI: Update PHP AI Client to 1.5.0 and introduce WP_AI_Client_Embedding_Builder

src/wp-includes/ai-client.php

@@ -8,6 +8,7 @@
  */
 
 use WordPress\AiClient\AiClient;
+use WordPress\AiClient\Files\DTO\File;
 use WordPress\AiClient\Messages\DTO\Message;
 use WordPress\AiClient\Messages\DTO\MessagePart;
 
@@ -60,3 +61,40 @@ function wp_supports_ai(): bool {
 function wp_ai_client_prompt( $prompt = null ): WP_AI_Client_Prompt_Builder {
 	return new WP_AI_Client_Prompt_Builder( AiClient::defaultRegistry(), $prompt );
 }
+
+/**
+ * Creates a new AI embedding builder using the default provider registry.
+ *
+ * This is the main entry point for generating embeddings in WordPress. It returns
+ * a fluent builder that can be used to configure and generate embedding vectors.
+ *
+ * Each input can be provided as a simple string for basic text inputs, or as more
+ * complex types. Pass multiple arguments, or a single list of inputs, to embed
+ * multiple inputs at once, each producing its own embedding vector.
+ *
+ * A model must be specified on the returned builder via `using_model()` or
+ * `using_provider_model()`. Embedding vectors are only comparable to other
+ * vectors produced by the same model, so no model is selected automatically.
+ *
+ * @since 7.2.0
+ *
+ * @param string|MessagePart|File|array ...$input Optional. Initial input(s) to embed.
+ *                                                A string for simple text inputs,
+ *                                                a MessagePart or File object for
+ *                                                structured content, or an array for
+ *                                                a message part array shape.
+ *                                                Alternatively, a single list of any
+ *                                                of these to embed multiple inputs.
+ * @return WP_AI_Client_Embedding_Builder The embedding builder instance.
+ */
+function wp_ai_client_embedding( ...$input ): WP_AI_Client_Embedding_Builder {
+	/*
+	 * A single list argument is a list of inputs. It cannot be a single input, since
+	 * the only array input is a message part array shape, which is never a list.
+	 */
+	if ( 1 === count( $input ) && isset( $input[0] ) && is_array( $input[0] ) && array_is_list( $input[0] ) ) {
+		$input = $input[0];
+	}
+
+	return new WP_AI_Client_Embedding_Builder( AiClient::defaultRegistry(), array() === $input ? null : $input );
+}

src/wp-includes/ai-client/adapters/class-wp-ai-client-event-dispatcher.php

@@ -48,8 +48,12 @@ public function dispatch( object $event ): object {
 		 *
 		 * - wp_ai_client_before_generate_result
 		 * - wp_ai_client_after_generate_result
+		 * - wp_ai_client_before_generate_embedding
+		 * - wp_ai_client_after_generate_embedding
 		 *
 		 * @since 7.0.0
+		 * @since 7.2.0 Added the `wp_ai_client_before_generate_embedding` and
+		 *              `wp_ai_client_after_generate_embedding` action hooks.
 		 *
 		 * @param object $event The event object.
 		 */