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

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

app/Services/Tool/ToolResult.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Services\Tool;
+
+/**
+ * Tool 执行结果 DTO，记录结果文本与状态。
+ */
+final class ToolResult
+{
+    public function __construct(
+        public string $runId,
+        public string $parentRunId,
+        public string $toolCallId,
+        public string $name,
+        public string $status,
+        public string $output,
+        public ?string $error = null,
+        public bool $truncated = false,
+    ) {
+    }
+
+    /**
+     * 便于在测试/日志中以数组格式使用。
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'run_id' => $this->runId,
+            'parent_run_id' => $this->parentRunId,
+            'tool_call_id' => $this->toolCallId,
+            'name' => $this->name,
+            'status' => $this->status,
+            'output' => $this->output,
+            'error' => $this->error,
+            'truncated' => $this->truncated,
+        ];
+    }
+}