<?php

/**
 * Timetics Get Staff Tool
 *
 * @package Aisentic\Integrations\Timetics
 */

declare(strict_types=1);

namespace Aisentic\Integrations\Timetics;

use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;
use Aisentic\Util\Log;

defined( 'ABSPATH' ) || exit;

/**
 * Tool to get a single Timetics staff member by ID. Administrator only.
 */
class Timetics_Get_Staff_Tool extends Timetics_Base_Tool {

	public function __construct() {
		parent::__construct(
			'timetics-get-staff',
			'Get one Timetics staff member by their ID: name, email, phone, status, and a summary of their ' .
			'weekly availability. Use timetics-list-staff or timetics-search-staff first to find the ID.'
		);
	}

	protected function properties(): array {
		return [
			new ToolProperty(
				name: 'staff_id',
				type: PropertyType::NUMBER,
				description: 'The WP user ID of the staff member to retrieve.',
				required: true
			),
		];
	}

	public function __invoke( int $staff_id ): array {
		$check = $this->guard_admin();
		if ( $check ) {
			return $check;
		}

		if ( $staff_id <= 0 ) {
			return [ 'error' => 'A valid staff_id is required.' ];
		}

		try {
			$request = $this->build_request(
				'GET',
				'/timetics/v1/staffs/' . $staff_id,
				[],
				null,
				[ 'staff_id' => $staff_id ]
			);
			if ( is_array( $request ) ) {
				return $request;
			}

			$controller = \Timetics\Core\Staffs\Api_Staff::instance();
			$data       = $this->extract_response( $controller->get_item( $request ), "Staff #{$staff_id} was not found." );

			if ( isset( $data['error'] ) ) {
				return $data;
			}

			return [ 'staff' => $this->shape_staff( $data ) ];
		} catch ( \Throwable $e ) {
			Log::error( 'Timetics_Get_Staff_Tool error', [ 'error' => $e->getMessage() ] );
			return [ 'error' => 'Failed to get staff: ' . $e->getMessage() ];
		}
	}
}