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

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

app/Services/OutputSink.php

@@ -3,6 +3,8 @@
 namespace App\Services;
 
 use App\Models\Message;
+use App\Services\Tool\ToolCall;
+use App\Services\Tool\ToolResult;
 
 class OutputSink
 {
@@ -44,7 +46,7 @@ class OutputSink
                 'delta_index' => $deltaIndex,
             ]),
             'dedupe_key' => $dedupeKey,
-        ],$wasDupe,false);
+        ], $wasDeduped);
     }
 
     /**
@@ -85,4 +87,42 @@ class OutputSink
             'dedupe_key' => $dedupeKey,
         ]);
     }
+
+    public function appendToolCall(string $sessionId, ToolCall $toolCall): Message
+    {
+        return $this->chatService->appendMessage([
+            'session_id' => $sessionId,
+            'role' => Message::ROLE_AGENT,
+            'type' => 'tool.call',
+            'content' => $toolCall->rawArguments ?: json_encode($toolCall->arguments, JSON_UNESCAPED_UNICODE),
+            'payload' => [
+                'run_id' => $toolCall->parentRunId,
+                'tool_run_id' => $toolCall->runId,
+                'tool_call_id' => $toolCall->toolCallId,
+                'name' => $toolCall->name,
+                'arguments' => $toolCall->arguments,
+            ],
+            'dedupe_key' => "run:{$toolCall->parentRunId}:tool_call:{$toolCall->toolCallId}",
+        ]);
+    }
+
+    public function appendToolResult(string $sessionId, ToolResult $result): Message
+    {
+        return $this->chatService->appendMessage([
+            'session_id' => $sessionId,
+            'role' => Message::ROLE_TOOL,
+            'type' => 'tool.result',
+            'content' => $result->output,
+            'payload' => [
+                'run_id' => $result->runId,
+                'parent_run_id' => $result->parentRunId,
+                'tool_call_id' => $result->toolCallId,
+                'name' => $result->name,
+                'status' => $result->status,
+                'error' => $result->error,
+                'truncated' => $result->truncated,
+            ],
+            'dedupe_key' => "run:{$result->runId}:tool_result",
+        ]);
+    }
 }