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

declare(strict_types=1);

namespace Aisentic\Integrations\Pointics;

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 Pointics-specific AI tools via WordPress filter hooks.
 *
 * No mention resolvers yet: resolvers expand @-mentioned entities (a
 * reservation, an event) that a tool result surfaced first. The Pointics
 * reward/channel/member tools return shaped entities, so a resolver could
 * back them later; add_mention_resolvers() is intentionally omitted until a
 * later slice needs one.
 */
class Pointics_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_filter( 'aisentic_common_system_prompts', [ $this, 'add_active_integrations' ], 10, 1 );
		add_action( 'pointics_aisentic_register_site', [ $this, 'handle_pointics_register' ], 10, 3 );
	}

	/**
	 * Handle the Pointics registration handshake.
	 *
	 * Pointics fires `pointics_aisentic_register_site` only after the merchant
	 * opts in (onboarding interview or dashboard banner), passing the account
	 * identity it collected. We register the site, which stores the api key
	 * and fires `aisentic/site_registered`, then mark the Pointics integration
	 * connected so its tools start loading.
	 *
	 * Pointics 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     Merchant/account name.
	 * @param string $email    Merchant/account email.
	 * @param string $site_url Site URL to register.
	 * @return void
	 */
	public function handle_pointics_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 Pointics.
			}
		}

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

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

	/**
	 * Add Pointics tools to the admin assistant tool pool.
	 *
	 * All Pointics tools are added regardless of the current page so the agent
	 * can discover and use them from any admin screen via tool_search. The
	 * twenty tools cover rewards (list/get/create/update/delete/stats/
	 * redemption methods), channels (list/get/create/update/delete/trigger/
	 * building blocks), and members & analytics (find member, overview,
	 * activity, redemption types, top customers, top rules), all wired to the
	 * Pointics services via the container.
	 *
	 * @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_pointics_connected() ) {
			return $tools;
		}

		// Rewards.
		$tools[] = new Pointics_List_Rewards_Tool();
		$tools[] = new Pointics_Get_Reward_Tool();
		$tools[] = new Pointics_Create_Reward_Tool();
		$tools[] = new Pointics_Update_Reward_Tool();
		$tools[] = new Pointics_Delete_Reward_Tool();
		$tools[] = new Pointics_Get_Reward_Stats_Tool();
		$tools[] = new Pointics_List_Redemption_Methods_Tool();

		// Channels.
		$tools[] = new Pointics_List_Channels_Tool();
		$tools[] = new Pointics_Get_Channel_Tool();
		$tools[] = new Pointics_Create_Channel_Tool();
		$tools[] = new Pointics_Update_Channel_Tool();
		$tools[] = new Pointics_Delete_Channel_Tool();
		$tools[] = new Pointics_Trigger_Channel_Tool();
		$tools[] = new Pointics_List_Channel_Building_Blocks_Tool();

		// Members & analytics.
		$tools[] = new Pointics_Find_Member_Tool();
		$tools[] = new Pointics_Get_Analytics_Overview_Tool();
		$tools[] = new Pointics_Get_Activity_Tool();
		$tools[] = new Pointics_Get_Redemption_Types_Tool();
		$tools[] = new Pointics_Get_Top_Customers_Tool();
		$tools[] = new Pointics_Get_Top_Rules_Tool();

		return $tools;
	}

	/**
	 * Tell the agent which Pointics integrations this site actually has.
	 *
	 * The admin-page sitemap is written once per plugin and describes every
	 * integration Pointics can support, so a search for "which order statuses
	 * award points" returns the WooCommerce settings whether or not WooCommerce
	 * is installed. On a site running only Eventin that answer is confidently
	 * wrong, and it points the merchant at a screen that is not there.
	 *
	 * Pointics already knows the answer: the trigger registry filters providers
	 * by is_available(). Passing that list in costs one short line and lets the
	 * agent name the right integration, or say the plugin is missing.
	 *
	 * @param string $prompt The system prompt built so far.
	 * @return string
	 */
	public function add_active_integrations( string $prompt ): string {
		if ( ! $this->is_pointics_connected() || ! function_exists( 'pointics_container' ) ) {
			return $prompt;
		}

		$labels = $this->active_integration_labels();

		if ( [] === $labels ) {
			return $prompt;
		}

		$prompt .= "\n## Pointics on this site\n";
		$prompt .= 'Integrations installed and active: ' . implode( ', ', $labels ) . ".\n";
		$prompt .= "That is the complete list. An admin-page search covers every integration Pointics can support, so it returns settings for ones this site does not have. Before naming a settings screen, check it belongs to an integration above. If the closest match belongs to one that is absent, say so and give the equivalent for an integration that is present, or state that the missing plugin would be needed.\n";

		$locked = $this->locked_features();

		if ( [] !== $locked ) {
			$prompt .= 'Pointics Pro is NOT installed, so these are unavailable: ' . implode( ', ', $locked ) . ".\n";
			$prompt .= "Free registers no admin route for them, so any link to one lands on a 404 — never offer one. When asked about these, say plainly that the feature needs Pointics Pro, describe what it would do, and point at the \"Free vs Pro\" item at the bottom of the Pointics menu (https://themewinter.com/pointics/#pricing).\n";
		}

		return $prompt;
	}

	/**
	 * What this site cannot do because Pointics Pro is absent.
	 *
	 * Read from Pointics' own feature registry rather than guessed. Free
	 * registers these gates false and pro re-registers them true, so a false
	 * one is exactly "pro would unlock this". Only the keys named here are
	 * reported: free leaves `referrals`, `expiration` and `visual_rules` ON, so
	 * treating every false flag as a pro feature would invent restrictions.
	 *
	 * `pro` is not a capability but the answer to "did the add-on boot", so it
	 * short-circuits the whole paragraph instead of appearing inside it.
	 *
	 * Never fatal: a chat turn must not die because the registry moved.
	 *
	 * @return array<int, string>
	 */
	private function locked_features(): array {
		$pro_only = [
			'tiers_unlimited'   => 'creating and deleting loyalty levels',
			'white_label'       => 'hiding the Pointics attribution on the widget',
			'analytics_history' => 'analytics history beyond 30 days',
			'advanced_rules'    => 'advanced earning rules',
		];

		try {
			$features = pointics_container()->make( \Pointics\Support\Features::class );

			if ( ! is_object( $features ) || ! method_exists( $features, 'all' ) ) {
				return [];
			}

			$flags = $features->all();

			if ( ! empty( $flags['pro'] ) ) {
				return [];
			}

			$locked = [];

			foreach ( $pro_only as $key => $label ) {
				if ( array_key_exists( $key, $flags ) && ! $flags[ $key ] ) {
					$locked[] = $label;
				}
			}

			return $locked;
		} catch ( \Throwable $e ) {
			return [];
		}
	}

	/**
	 * Labels of the integrations whose platform plugin is present.
	 *
	 * Never fatal: a chat turn must not die because the registry moved.
	 *
	 * @return array<int, string>
	 */
	private function active_integration_labels(): array {
		try {
			$registry = pointics_container()->make( \Pointics\Integrations\Trigger_Registry::class );

			if ( ! is_object( $registry ) || ! method_exists( $registry, 'available' ) ) {
				return [];
			}

			$labels = [];

			foreach ( $registry->available() as $provider ) {
				if ( is_object( $provider ) && method_exists( $provider, 'label' ) ) {
					$label = (string) $provider->label();

					if ( '' !== $label ) {
						$labels[] = $label;
					}
				}
			}

			return array_values( array_unique( $labels ) );
		} catch ( \Throwable $e ) {
			return [];
		}
	}

	/**
	 * Check whether Pointics is active and connected via Aisentic settings.
	 *
	 * Protected rather than private so a test can model a connected site without
	 * declaring pointics(): two other tests in this suite assert that function
	 * stays undefined, and a global declaration cannot be undone.
	 *
	 * @return bool
	 */
	protected function is_pointics_connected(): bool {
		if ( ! function_exists( 'pointics' ) ) {
			return false;
		}
		$saved  = get_option( Integration_Controller::OPTION_KEY, [] );
		$status = $saved['pointics']['status'] ?? '';
		return 'connected' === $status;
	}
}