main: 增强工具调用与消息流程

- 支持 tool.call 和 tool.result 消息类型处理
- 引入 Tool 调度与执行逻辑，支持超时与结果截断
- 增加 ToolRegistry 和 ToolExecutor 管理工具定义与执行
- 更新上下文构建与消息映射逻辑，适配工具闭环处理
- 扩展配置与环境变量，支持 Tool 调用相关选项
- 增强单元测试覆盖工具调用与执行情景
- 更新文档和 OpenAPI，新增工具相关说明与模型定义

app/Services/Tool/Tool.php

@@ -0,0 +1,23 @@
+<?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;
+}