Adds AI REST endpoints and JS client

src/js/_enqueues/wp/ai-client/enums.js

@@ -0,0 +1,82 @@
+/**
+ * Constants for PHP AI Client SDK Enums.
+ *
+ * @since 7.0.0
+ *
+ * @package WordPress
+ * @subpackage AI
+ */
+
+export const FileType = {
+	INLINE: 'inline',
+	REMOTE: 'remote',
+};
+
+export const MediaOrientation = {
+	SQUARE: 'square',
+	LANDSCAPE: 'landscape',
+	PORTRAIT: 'portrait',
+};
+
+export const FinishReason = {
+	STOP: 'stop',
+	LENGTH: 'length',
+	CONTENT_FILTER: 'content_filter',
+	TOOL_CALLS: 'tool_calls',
+	ERROR: 'error',
+};
+
+export const OperationState = {
+	STARTING: 'starting',
+	PROCESSING: 'processing',
+	SUCCEEDED: 'succeeded',
+	FAILED: 'failed',
+	CANCELED: 'canceled',
+};
+
+export const ToolType = {
+	FUNCTION_DECLARATIONS: 'function_declarations',
+	WEB_SEARCH: 'web_search',
+};
+
+export const ProviderType = {
+	CLOUD: 'cloud',
+	SERVER: 'server',
+	CLIENT: 'client',
+};
+
+export const MessagePartType = {
+	TEXT: 'text',
+	FILE: 'file',
+	FUNCTION_CALL: 'function_call',
+	FUNCTION_RESPONSE: 'function_response',
+};
+
+export const MessagePartChannel = {
+	CONTENT: 'content',
+	THOUGHT: 'thought',
+};
+
+export const Modality = {
+	TEXT: 'text',
+	DOCUMENT: 'document',
+	IMAGE: 'image',
+	AUDIO: 'audio',
+	VIDEO: 'video',
+};
+
+export const MessageRole = {
+	USER: 'user',
+	MODEL: 'model',
+};
+
+export const Capability = {
+	TEXT_GENERATION: 'text_generation',
+	IMAGE_GENERATION: 'image_generation',
+	TEXT_TO_SPEECH_CONVERSION: 'text_to_speech_conversion',
+	SPEECH_GENERATION: 'speech_generation',
+	MUSIC_GENERATION: 'music_generation',
+	VIDEO_GENERATION: 'video_generation',
+	EMBEDDING_GENERATION: 'embedding_generation',
+	CHAT_HISTORY: 'chat_history',
+};

src/js/_enqueues/wp/ai-client/files/file.js

@@ -0,0 +1,183 @@
+/**
+ * File wrapper for AI client files.
+ *
+ * @since 7.0.0
+ *
+ * @package WordPress
+ * @subpackage AI
+ */
+
+import { FileType } from '../enums';
+
+/**
+ * Represents a file in the AI client.
+ *
+ * @since 7.0.0
+ */
+export class File {
+	/**
+	 * Constructor.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @param {Object} file The raw file object.
+	 */
+	constructor( file ) {
+		this._file = file;
+	}
+
+	/**
+	 * Gets the type of file storage.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {string} The file type.
+	 */
+	get fileType() {
+		return this._file.fileType;
+	}
+
+	/**
+	 * Gets the MIME type of the file.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {string} The MIME type.
+	 */
+	get mimeType() {
+		return this._file.mimeType;
+	}
+
+	/**
+	 * Gets the URL for remote files.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {string|undefined} The URL.
+	 */
+	get url() {
+		return this._file.url;
+	}
+
+	/**
+	 * Gets the base64 data for inline files.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {string|undefined} The base64 data.
+	 */
+	get base64Data() {
+		return this._file.base64Data;
+	}
+
+	/**
+	 * Checks if the file is an inline file.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is inline.
+	 */
+	isInline() {
+		return this.fileType === FileType.INLINE;
+	}
+
+	/**
+	 * Checks if the file is a remote file.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is remote.
+	 */
+	isRemote() {
+		return this.fileType === FileType.REMOTE;
+	}
+
+	/**
+	 * Gets the data as a data URI for inline files.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {string|undefined} The data URI.
+	 */
+	getDataUri() {
+		if ( ! this.base64Data ) {
+			return undefined;
+		}
+
+		return `data:${ this.mimeType };base64,${ this.base64Data }`;
+	}
+
+	/**
+	 * Checks if the file is a video.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is a video.
+	 */
+	isVideo() {
+		return this.mimeType.startsWith( 'video/' );
+	}
+
+	/**
+	 * Checks if the file is an image.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is an image.
+	 */
+	isImage() {
+		return this.mimeType.startsWith( 'image/' );
+	}
+
+	/**
+	 * Checks if the file is audio.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is audio.
+	 */
+	isAudio() {
+		return this.mimeType.startsWith( 'audio/' );
+	}
+
+	/**
+	 * Checks if the file is text.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is text.
+	 */
+	isText() {
+		return this.mimeType.startsWith( 'text/' );
+	}
+
+	/**
+	 * Checks if the file is a document.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @return {boolean} True if the file is a document.
+	 */
+	isDocument() {
+		return (
+			this.mimeType === 'application/pdf' ||
+			this.mimeType.startsWith( 'application/msword' ) ||
+			this.mimeType.startsWith(
+				'application/vnd.openxmlformats-officedocument'
+			) ||
+			this.mimeType.startsWith( 'application/vnd.ms-' )
+		);
+	}
+
+	/**
+	 * Checks if the file is a specific MIME type.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @param {string} type The mime type to check.
+	 * @return {boolean} True if the file is of the specified type.
+	 */
+	isMimeType( type ) {
+		return this.mimeType.startsWith( type + '/' ) || this.mimeType === type;
+	}
+}

src/js/_enqueues/wp/ai-client/index.js

@@ -0,0 +1,60 @@
+/**
+ * WordPress AI Client - Client-side API.
+ *
+ * @since 7.0.0
+ *
+ * @output wp-includes/js/dist/ai-client.js
+ *
+ * @package WordPress
+ * @subpackage AI
+ */
+
+import { PromptBuilder } from './builders/prompt-builder';
+import {
+	getProviders,
+	getProvider,
+	getProviderModels,
+	getProviderModel,
+} from './providers/api';
+import { store } from './providers/store';
+import * as enums from './enums';
+
+/**
+ * Creates a new prompt builder for fluent API usage.
+ *
+ * @since 7.0.0
+ *
+ * @param {string|Object|Array} [promptInput] Optional initial prompt content.
+ * @return {PromptBuilder} The prompt builder instance.
+ */
+export function prompt( promptInput ) {
+	return new PromptBuilder( promptInput );
+}
+
+export {
+	getProviders,
+	getProvider,
+	getProviderModels,
+	getProviderModel,
+	store,
+	enums,
+};
+
+// Expose the API in the global `wp.aiClient` namespace for external use.
+const AiClient = {
+	prompt,
+	getProviders,
+	getProvider,
+	getProviderModels,
+	getProviderModel,
+	store,
+	enums,
+};
+
+if (
+	typeof window !== 'undefined' &&
+	'wp' in window &&
+	typeof window.wp === 'object'
+) {
+	window.wp.aiClient = AiClient;
+}

src/js/_enqueues/wp/ai-client/providers/api.js

@@ -0,0 +1,60 @@
+/**
+ * Provider API functions.
+ *
+ * @since 7.0.0
+ *
+ * @package WordPress
+ * @subpackage AI
+ */
+
+import { resolveSelect } from '@wordpress/data';
+import { store } from './store';
+
+/**
+ * Gets all registered AI providers.
+ *
+ * @since 7.0.0
+ *
+ * @return {Promise<Array>} Promise resolving to array of providers.
+ */
+export async function getProviders() {
+	return await resolveSelect( store ).getProviders();
+}
+
+/**
+ * Gets a specific provider by its ID.
+ *
+ * @since 7.0.0
+ *
+ * @param {string} id Provider ID.
+ * @return {Promise<Object|undefined>} Promise resolving to provider object, or undefined if not found.
+ */
+export async function getProvider( id ) {
+	return await resolveSelect( store ).getProvider( id );
+}
+
+/**
+ * Gets all models for a specific provider.
+ *
+ * @since 7.0.0
+ *
+ * @param {string} providerId Provider ID.
+ * @return {Promise<Array>} Promise resolving to array of models for the provider.
+ */
+export async function getProviderModels( providerId ) {
+	return await resolveSelect( store ).getProviderModels( providerId );
+}
+
+/**
+ * Gets a specific model by its ID for a provider.
+ *
+ * @since 7.0.0
+ *
+ * @param {string} providerId Provider ID.
+ * @param {string} modelId    Model ID.
+ * @return {Promise<Object|undefined>} Promise resolving to model object, or undefined if not found.
+ */
+export async function getProviderModel( providerId, modelId ) {
+	const models = await resolveSelect( store ).getProviderModels( providerId );
+	return models.find( ( model ) => model.id === modelId );
+}