<?php
/**
 * The AI service connected to WordPress itself (Settings → Connectors, WordPress 7.0+).
 *
 * The site owner connects a provider once for all plugins; Fixlight never sees the key.
 *
 * @package Fixlight
 */

namespace Fixlight;

defined( 'ABSPATH' ) || exit;

/**
 * WordPress AI Client provider.
 */
class Ai_WordPress {

	/**
	 * Whether this WordPress has the AI Client and allows AI.
	 *
	 * @return bool
	 */
	public static function available() {
		return function_exists( 'wp_ai_client_prompt' ) && function_exists( 'wp_supports_ai' ) && wp_supports_ai();
	}

	/**
	 * Asks the connected AI for alt text.
	 *
	 * WordPress picks a connected model that can see images.
	 *
	 * @param array $image   mime, data (base64).
	 * @param array $context language, text.
	 * @return array|\WP_Error alt, decorative, model.
	 */
	public static function describe( array $image, array $context ) {
		if ( ! self::available() ) {
			return new \WP_Error( 'fixlight_wp_ai_missing', __( 'This WordPress has no AI connection. Update to WordPress 7 or choose another option in Fixlight → Settings.', 'fixlight' ), array( 'status' => 400 ) );
		}
		try {
			$builder = wp_ai_client_prompt()
				->using_system_instruction( Ai::system_prompt() )
				->with_file( 'data:' . $image['mime'] . ';base64,' . $image['data'], $image['mime'] )
				->with_text( $context['text'] )
				->using_temperature( 0.2 )
				->using_max_tokens( 300 )
				->as_json_response( Ai::schema() );
			if ( ! $builder->is_supported_for_text_generation() ) {
				return new \WP_Error( 'fixlight_wp_ai_unsupported', __( 'None of the AI services connected in Settings → Connectors can describe images. Connect one that can (for example Google, OpenAI or Anthropic), or choose another option in Fixlight → Settings.', 'fixlight' ), array( 'status' => 400 ) );
			}
			$text = $builder->generate_text();
		} catch ( \Throwable $error ) {
			/* translators: %s: error message. */
			return new \WP_Error( 'fixlight_wp_ai_error', sprintf( __( 'The AI connected to WordPress returned an error: %s', 'fixlight' ), wp_strip_all_tags( substr( $error->getMessage(), 0, 300 ) ) ), array( 'status' => 502 ) );
		}
		if ( is_wp_error( $text ) ) {
			return $text;
		}
		$answer = Ai::parse_answer( (string) $text );
		if ( null === $answer ) {
			return new \WP_Error( 'fixlight_ai_parse', __( 'The AI connected to WordPress returned an answer Fixlight could not read. Try again.', 'fixlight' ), array( 'status' => 502 ) );
		}
		$answer['model'] = 'WordPress';
		return $answer;
	}
}