<?php

namespace App\Services\Tool;

use App\Services\Tool\Tools\GetTimeTool;

/**
 * Tool 注册表：管理已注册工具与 OpenAI 兼容的声明。
 */
class ToolRegistry
{
    /**
     * @var array<string, Tool>
     */
    private array $tools;

    /**
     * @param array<int, Tool>|null $tools
     */
    public function __construct(?array $tools = null)
    {
        $tools = $tools ?? [
            new GetTimeTool(),
        ];

        $this->tools = [];

        foreach ($tools as $tool) {
            $this->tools[$tool->name()] = $tool;
        }
    }

    public function get(string $name): ?Tool
    {
        return $this->tools[$name] ?? null;
    }

    /**
     * @return array<int, Tool>
     */
    public function all(): array
    {
        return array_values($this->tools);
    }

    /**
     * 返回 OpenAI-compatible tools 描述。
     *
     * @return array<int, array<string, mixed>>
     */
    public function openAiToolsSpec(): array
    {
        return array_map(function (Tool $tool) {
            return [
                'type' => 'function',
                'function' => [
                    'name' => $tool->name(),
                    'description' => $tool->description(),
                    'parameters' => $tool->parameters(),
                ],
            ];
        }, $this->all());
    }
}