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

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

config/agent.php

@@ -23,4 +23,17 @@ return [
         'backoff_seconds' => env('AGENT_RUN_JOB_BACKOFF', 3),
         'timeout_seconds' => env('AGENT_RUN_JOB_TIMEOUT', 360),
     ],
+    'tools' => [
+        'max_calls_per_run' => env('AGENT_TOOL_MAX_CALLS_PER_RUN', 1),
+        'wait_timeout_ms' => env('AGENT_TOOL_WAIT_TIMEOUT_MS', 15000),
+        'wait_poll_interval_ms' => env('AGENT_TOOL_WAIT_POLL_MS', 200),
+        'timeout_seconds' => env('AGENT_TOOL_TIMEOUT_SECONDS', 15),
+        'result_max_bytes' => env('AGENT_TOOL_RESULT_MAX_BYTES', 4096),
+        'tool_choice' => env('AGENT_TOOL_CHOICE', 'auto'),
+        'job' => [
+            'tries' => env('AGENT_TOOL_JOB_TRIES', 1),
+            'backoff_seconds' => env('AGENT_TOOL_JOB_BACKOFF', 3),
+            'timeout_seconds' => env('AGENT_TOOL_JOB_TIMEOUT', 120),
+        ],
+    ],
 ];