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

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

app/Services/Agent/AgentContext.php

@@ -5,7 +5,7 @@ namespace App\Services\Agent;
 final class AgentContext
 {
     /**
-     * @param array<int, array{message_id: string, role: string, type: string, content: ?string, seq: int}> $messages
+     * @param array<int, array{message_id: string, role: string, type: string, content: ?string, payload: ?array, seq: int}> $messages
      */
     public function __construct(
         public string $runId,