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

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

README.md

@@ -56,6 +56,14 @@ docker compose exec app php artisan test --testsuite=Feature
 - `AGENT_RUN_JOB_TRIES`（默认 1）：AgentRunJob 队列重试次数
 - `AGENT_RUN_JOB_BACKOFF`（默认 3）：AgentRunJob 重试退避秒数
 - `AGENT_RUN_JOB_TIMEOUT`（默认 360）：AgentRunJob 超时时间（秒）
+- 工具调用（子 Run 模式）：
+  - `AGENT_TOOL_MAX_CALLS_PER_RUN`（默认 1）：单个父 Run 允许的工具调用次数上限（超过直接失败）
+  - `AGENT_TOOL_WAIT_TIMEOUT_MS`（默认 15000）：等待子 Run 写入 `tool.result` 的超时时间（毫秒）
+  - `AGENT_TOOL_WAIT_POLL_MS`（默认 200）：等待工具结果时的轮询间隔（毫秒）
+  - `AGENT_TOOL_TIMEOUT_SECONDS`（默认 15）：单个工具执行的预期超时时间（超过会记为 TIMEOUT）
+  - `AGENT_TOOL_RESULT_MAX_BYTES`（默认 4096）：工具结果最大保存字节数（超出会截断）
+  - `AGENT_TOOL_CHOICE`（默认 auto）：OpenAI tool_choice 传参策略
+  - `AGENT_TOOL_JOB_TRIES/AGENT_TOOL_JOB_BACKOFF/AGENT_TOOL_JOB_TIMEOUT`：ToolRunJob 队列重试/退避/超时设置
 
 ## 🔑 API 能力一览（MVP-1.1 + Archive/GetMessage/SSE）
 - 会话：`POST /api/sessions`，`GET /api/sessions`（分页/状态/关键词），`GET /api/sessions/{id}`，`PATCH /api/sessions/{id}`（重命名/状态，CLOSED 不可重开），`POST /api/sessions/{id}/archive`（幂等归档→CLOSED）。