<?php

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

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

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 Timetics-specific AI tools via WordPress filter hooks.
 */
class Timetics_Tools_Hooks extends Base_Service_Provider {

	public function register(): void {
		parent::register();
		add_filter( 'aisentic_admin_assistant_tool_pool', [ $this, 'add_tools' ], 10, 3 );
		add_action( 'timetics/aisentic/register_site', [ $this, 'handle_timetics_register' ], 10, 3 );
	}

	public function get_services(): array {
		return [];
	}

	/**
	 * Handle the Timetics registration handshake.
	 *
	 * Timetics fires `timetics/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 Timetics integration connected
	 * so the tools above start loading.
	 *
	 * Timetics 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_timetics_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 Timetics.
			}
		}

		/*
		 * 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 Wp Cafe handshake.
		 */
		$saved                       = get_option( Integration_Controller::OPTION_KEY, [] );
		$saved['timetics']           = isset( $saved['timetics'] ) ? $saved['timetics'] : [];
		$saved['timetics']['status'] = Integration_Status::CONNECTED;
		update_option( Integration_Controller::OPTION_KEY, $saved );
	}

	/**
	 * Add Timetics tools to the admin assistant tool pool.
	 *
	 * All tools are added regardless of the current page so the agent can
	 * discover and use them from any admin screen via tool_search. Reads and the
	 * shortcode helper run immediately; every write tool implements
	 * Approvable_Tool_Contract and is gated behind human approval.
	 *
	 * @param array  $tools          Current list of tools.
	 * @param object $settings       Settings instance.
	 * @param string $plugin_context Active plugin context (unused; pool is page-agnostic).
	 */
	public function add_tools( array $tools, $settings, string $plugin_context = '' ): array {
		if ( ! $this->is_timetics_connected() ) {
			return $tools;
		}

		// Meetings (read).
		$tools[] = new Timetics_List_Meetings_Tool();
		$tools[] = new Timetics_Get_Meeting_Tool();
		$tools[] = new Timetics_Search_Meetings_Tool();

		// Meetings (write — approval-gated).
		$tools[] = new Timetics_Create_Meeting_Tool();
		$tools[] = new Timetics_Update_Meeting_Tool();
		$tools[] = new Timetics_Duplicate_Meeting_Tool();

		// Meeting categories (read).
		$tools[] = new Timetics_List_Categories_Tool();

		// Meeting categories (write — approval-gated).
		$tools[] = new Timetics_Create_Category_Tool();
		$tools[] = new Timetics_Update_Category_Tool();

		// Bookings (read).
		$tools[] = new Timetics_List_Bookings_Tool();
		$tools[] = new Timetics_Get_Booking_Tool();
		$tools[] = new Timetics_Search_Bookings_Tool();
		$tools[] = new Timetics_Get_Available_Slots_Tool();
		$tools[] = new Timetics_List_Payment_Methods_Tool();

		// Bookings (write — approval-gated).
		$tools[] = new Timetics_Create_Booking_Tool();
		$tools[] = new Timetics_Reschedule_Booking_Tool();
		$tools[] = new Timetics_Cancel_Booking_Tool();

		// Staff (read).
		$tools[] = new Timetics_List_Staff_Tool();
		$tools[] = new Timetics_Get_Staff_Tool();
		$tools[] = new Timetics_Search_Staff_Tool();
		$tools[] = new Timetics_Get_Staff_Integrations_Tool();

		// Staff (write — approval-gated).
		$tools[] = new Timetics_Create_Staff_Tool();
		$tools[] = new Timetics_Update_Staff_Tool();
		$tools[] = new Timetics_Reinvite_Staff_Tool();

		// Customers (read).
		$tools[] = new Timetics_List_Customers_Tool();
		$tools[] = new Timetics_Get_Customer_Tool();
		$tools[] = new Timetics_Search_Customers_Tool();
		$tools[] = new Timetics_Get_Customer_Bookings_Tool();

		// Customers (write — approval-gated).
		$tools[] = new Timetics_Create_Customer_Tool();
		$tools[] = new Timetics_Update_Customer_Tool();

		// Settings + reports (read; settings write is a narrow, cosmetic-only whitelist).
		$tools[] = new Timetics_Get_Settings_Tool();
		$tools[] = new Timetics_Update_Settings_Tool();
		$tools[] = new Timetics_Get_Reports_Tool();

		// Shortcodes.
		$tools[] = new Timetics_Get_Shortcodes_Tool();

		return $tools;
	}

	/**
	 * Check whether Timetics is active and connected via Aisentic settings.
	 */
	private function is_timetics_connected(): bool {
		// Not function_exists( 'timetics' ): that helper is namespaced.
		if ( ! class_exists( 'Timetics\Bootstrap' ) ) {
			return false;
		}
		$saved  = get_option( Integration_Controller::OPTION_KEY, [] );
		$status = $saved['timetics']['status'] ?? '';
		return 'connected' === $status;
	}
}