<?php

namespace App\Services\Tool;

interface Tool
{
    public function name(): string;

    public function description(): string;

    /**
     * OpenAI function 参数 JSON Schema。
     *
     * @return array<string, mixed>
     */
    public function parameters(): array;

    /**
     * @param array<string, mixed> $arguments
     * @return array<string, mixed>|string
     */
    public function execute(array $arguments): array|string;
}