<?php
/**
 * Page search tool.
 *
 * @package Aivexa
 */

declare(strict_types=1);

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Search public pages.
 */
class Aivexa_Page_Search_Tool implements Aivexa_Tool_Interface {

	public function get_name(): string {
		return 'page_search';
	}

	public function get_description(): string {
		return 'Search publicly accessible WordPress pages by keyword.';
	}

	public function get_parameters_schema(): array {
		return array(
			'type'       => 'object',
			'properties' => array(
				'query' => array(
					'type'        => 'string',
					'description' => 'Search keywords.',
				),
				'limit' => array(
					'type'        => 'integer',
					'description' => 'Maximum number of results (1-5).',
				),
			),
			'required'   => array( 'query' ),
		);
	}

	public function is_enabled(): bool {
		return (bool) Aivexa_Settings::get( 'enable_page_search', true );
	}

	/**
	 * Execute page search.
	 *
	 * @param array<string, mixed> $arguments Arguments.
	 */
	public function execute( array $arguments ) {
		$query = isset( $arguments['query'] ) ? sanitize_text_field( (string) $arguments['query'] ) : '';
		$limit = isset( $arguments['limit'] ) ? absint( $arguments['limit'] ) : 5;
		$limit = max( 1, min( 5, $limit ) );

		if ( '' === $query ) {
			return new WP_Error( 'aivexa_page_search_empty', __( 'Search query is required.', 'aivexa' ) );
		}

		return array(
			'query'   => $query,
			'results' => Aivexa_Site_Search_Tool::search_content( $query, $limit, array( 'page' ) ),
		);
	}
}