<?php

namespace App\Services\Tool\Tools;

use App\Services\Tool\Tool;
use Illuminate\Support\Carbon;

class GetTimeTool implements Tool
{
    public function name(): string
    {
        return 'get_time';
    }

    public function description(): string
    {
        return '返回服务器当前时间，可指定 PHP 日期格式。';
    }

    /**
     * @return array<string, mixed>
     */
    public function parameters(): array
    {
        return [
            'type' => 'object',
            'properties' => [
                'format' => [
                    'type' => 'string',
                    'description' => '可选的日期格式，默认为 RFC3339。',
                ],
            ],
            'required' => [],
        ];
    }

    /**
     * @param array<string, mixed> $arguments
     * @return array<string, mixed>
     */
    public function execute(array $arguments): array
    {
        $format = is_string($arguments['format'] ?? null) && $arguments['format'] !== ''
            ? $arguments['format']
            : Carbon::RFC3339_EXTENDED;

        return [
            'now' => Carbon::now()->format($format),
        ];
    }
}