<?php

/**
 * Booktics Tools Hooks
 *
 * Registers Booktics AI tools via the aisentic_admin_assistant_tool_pool filter
 * when the Booktics integration is active and connected.
 *
 * @package Aisentic\Integrations\Booktics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Booktics;

use Aisentic\Api\Services\Registration_Service;
use Aisentic\Integrations\Integration_Controller;
use Aisentic\Integrations\Integration_Status;
use Aisentic\Providers\Base_Service_Provider;

defined( 'ABSPATH' ) || exit;

/**
 * Registers Booktics-specific AI tools via WordPress filter hooks.
 */
class Booktics_Tools_Hooks extends Base_Service_Provider {

	/**
	 * Register hooks
	 *
	 * @return void
	 */
	public function register(): void {
		parent::register();
		add_filter( 'aisentic_admin_assistant_tool_pool', [ $this, 'add_tools' ], 10, 3 );
		add_action( 'booktics/aisentic/register_site', [ $this, 'handle_booktics_register' ], 10, 3 );
	}

	/**
	 * Handle the Booktics registration handshake.
	 *
	 * Booktics fires `booktics/aisentic/register_site` only after the user opts
	 * in (onboarding checkbox or dashboard banner), passing the identity it
	 * showed them. We register the site, which stores the api key and fires
	 * `aisentic/site_registered`, then mark the Booktics integration connected
	 * so the tools above start loading.
	 *
	 * Booktics activates this plugin in the same request, and Aisentic boots its
	 * providers on include, so this listener is attached before the action runs.
	 *
	 * @param string $name     Account name.
	 * @param string $email    Account email.
	 * @param string $site_url Site URL to register.
	 * @return void
	 */
	public function handle_booktics_register( $name, $email, $site_url ): void {
		// Skip the provider when a key already exists, so re-activating does not
		// re-register. api_key presence is the "registered" marker.
		$existing_key = aisentic_get_option( 'llmProviders.aisentic.apiKey', '' );

		if ( empty( $existing_key ) ) {
			$result = Registration_Service::register( $name, $email, $site_url );

			if ( is_wp_error( $result ) ) {
				return; // Provider error. Stay unconnected, never fatal to Booktics.
			}
		}

		/*
		 * Registration_Service fires `aisentic/site_registered`, not the
		 * underscore variant Integration_Controller auto-connects on, so the
		 * integration has to be marked here. Same as the Timetics handshake.
		 */
		$saved                       = get_option( Integration_Controller::OPTION_KEY, [] );
		$saved['booktics']           = isset( $saved['booktics'] ) ? $saved['booktics'] : [];
		$saved['booktics']['status'] = Integration_Status::CONNECTED;
		update_option( Integration_Controller::OPTION_KEY, $saved );
	}

	/**
	 * Get services
	 *
	 * @return array
	 */
	public function get_services(): array {
		return [];
	}

	/**
	 * Add Booktics tools to the admin assistant tool pool.
	 *
	 * All Booktics tools are added regardless of the current page so the agent
	 * can discover and use them from any admin screen via tool_search. Services
	 * and appointments are core Booktics features (not toggleable modules), so
	 * they are registered whenever the integration is connected.
	 *
	 * @param array  $tools          Current list of tools.
	 * @param object $settings       Settings instance.
	 * @param string $plugin_context Active plugin context (unused; pool is page-agnostic).
	 * @return array
	 */
	public function add_tools( array $tools, $settings, string $plugin_context = '' ): array {
		if ( ! $this->is_booktics_connected() ) {
			return $tools;
		}

		// Services.
		$tools[] = new Booktics_List_Services_Tool();
		$tools[] = new Booktics_Get_Service_Tool();
		$tools[] = new Booktics_Create_Service_Tool();
		$tools[] = new Booktics_Update_Service_Tool();

		// Appointments / bookings.
		$tools[] = new Booktics_List_Appointments_Tool();
		$tools[] = new Booktics_Get_Appointment_Tool();
		$tools[] = new Booktics_Get_Upcoming_Bookings_Tool();
		$tools[] = new Booktics_Create_Appointment_Tool();
		$tools[] = new Booktics_Update_Appointment_Tool();
		$tools[] = new Booktics_Reschedule_Appointment_Tool();
		$tools[] = new Booktics_Cancel_Appointment_Tool();

		// Categories.
		$tools[] = new Booktics_List_Categories_Tool();
		$tools[] = new Booktics_Create_Category_Tool();
		$tools[] = new Booktics_Update_Category_Tool();

		// Team members.
		$tools[] = new Booktics_List_Team_Members_Tool();
		$tools[] = new Booktics_Get_Team_Member_Tool();
		$tools[] = new Booktics_Create_Team_Member_Tool();
		$tools[] = new Booktics_Update_Team_Member_Tool();
		$tools[] = new Booktics_Get_My_Schedule_Tool();

		// Settings, modules, and dashboard (admin-only management).
		$tools[] = new Booktics_Get_Settings_Tool();
		$tools[] = new Booktics_Update_Settings_Tool();
		$tools[] = new Booktics_List_Modules_Tool();
		$tools[] = new Booktics_Toggle_Module_Tool();
		$tools[] = new Booktics_Get_Dashboard_Summary_Tool();

		return $tools;
	}

	/**
	 * Check whether Booktics is active and connected via Aisentic settings.
	 *
	 * @return bool
	 */
	private function is_booktics_connected(): bool {
		if ( ! function_exists( 'booktics' ) ) {
			return false;
		}
		$saved  = get_option( Integration_Controller::OPTION_KEY, [] );
		$status = $saved['booktics']['status'] ?? '';
		return 'connected' === $status;
	}
}