<?php

/**
 * Eventin Get Schedule Tool
 *
 * @package Aisentic\Integrations\Eventin
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Eventin;

use Aisentic\Integrations\Eventin\Eventin_Base_Tool;
use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;
use Aisentic\Util\Log;
use Aisentic\Contracts\Read_Only_Tool_Contract;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to retrieve a single Eventin schedule by ID.
 */
class Eventin_Get_Schedule_Tool extends Eventin_Base_Tool implements Read_Only_Tool_Contract {

	/**
	 * Constructor
	 */
	public function __construct() {
		parent::__construct(
			'eventin-get-schedule',
			'Get or retrieve details of a specific Eventin schedule, session, or agenda item by ID.'
		);
	}

	/**
	 * Define tool properties
	 *
	 * @return array
	 */
	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'schedule_id',
				type: PropertyType::NUMBER,
				description: 'The numeric ID of the schedule to retrieve.',
				required: true
			),
		];
	}

	/**
	 * Execute the tool
	 *
	 * @param int $schedule_id Schedule post ID.
	 * @return array
	 */
	public function __invoke( int $schedule_id ): array {
		$check = $this->guard( 'etn_manage_schedule' );
		if ( $check ) {
			return $check;
		}

		try {
			if ( $schedule_id <= 0 ) {
				return [ 'error' => 'schedule_id must be a positive integer.' ];
			}

			$post = get_post( $schedule_id );
			if ( ! $post || 'etn-schedule' !== $post->post_type ) {
				return [ 'error' => "No Eventin schedule found with ID {$schedule_id}." ];
			}

			$request = new \WP_REST_Request( 'GET' );
			$request->set_param( 'id', $schedule_id );

			$response = ( new \Eventin\Schedule\Api\ScheduleController() )->get_item( $request );

			if ( is_wp_error( $response ) ) {
				return [ 'error' => $response->get_error_message() ];
			}

			$schedule = $response->get_data();

			return [ 'schedule' => $schedule ];
			// \Throwable, not \Exception: a missing ScheduleController class raises \Error.
		} catch ( \Throwable $e ) {
			Log::error( 'Eventin_Get_Schedule_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to retrieve schedule: ' . $e->getMessage() ];
		}
	}
}