main: 引入 AgentProvider 流式事件与 OpenAI 兼容适配

- 增加流式事件流支持，Provider 输出 `message.delta` 等事件
- 实现 OpenAI 兼容适配器，包括 RequestBuilder、ApiClient 等模块
- 更新 Agent Run 逻辑，支持流式增量写入与模型完成状态管理
- 扩展配置项 `agent.openai.*`，支持模型、密钥等配置
- 优化文档，完善流式事件与消息类型说明
- 增加单元测试，覆盖 Provider 和 OpenAI 适配相关逻辑
- 更新环境变量与配置示例，支持新功能

README.md

@@ -39,15 +39,23 @@ docker compose exec app php artisan test --testsuite=Feature
 ```
 
 ### Agent Provider 配置（可选）
-`config/agent.php` 读取以下环境变量（默认值已内置）：  
-- `AGENT_PROVIDER_ENDPOINT`  
-- `AGENT_PROVIDER_TIMEOUT`（默认 30）  
-- `AGENT_PROVIDER_CONNECT_TIMEOUT`（默认 5）  
-- `AGENT_PROVIDER_RETRY_TIMES`（默认 1）  
-- `AGENT_PROVIDER_RETRY_BACKOFF_MS`（默认 500）  
-- `AGENT_RUN_JOB_TRIES`（默认 1）  
-- `AGENT_RUN_JOB_BACKOFF`（默认 5）  
-- `AGENT_RUN_JOB_TIMEOUT`（默认 120）
+`config/agent.php` 读取以下环境变量（默认值已内置），用于控制 HTTP 调用、OpenAI 直连以及队列重试：
+- `AGENT_PROVIDER_ENDPOINT`：自定义 HTTP Provider 入口（为空时回退 Dummy 或 OpenAI 适配器）
+- `AGENT_PROVIDER_TIMEOUT`（默认 30）：Provider HTTP 请求超时时间（秒）
+- `AGENT_PROVIDER_CONNECT_TIMEOUT`（默认 5）：Provider 连接超时时间（秒）
+- `AGENT_PROVIDER_RETRY_TIMES`（默认 1）：建立流前的重试次数（仅连接失败/429/5xx 且尚未产出事件时重试）
+- `AGENT_PROVIDER_RETRY_BACKOFF_MS`（默认 500）：重试退避（毫秒，指数退避）
+- `AGENT_OPENAI_BASE_URL`（默认 https://api.openai.com/v1）：OpenAI-compatible Chat Completions 基础地址
+- `AGENT_OPENAI_API_KEY`：OpenAI API Key（为空则使用 DummyProvider）
+- `AGENT_OPENAI_ORGANIZATION`：OpenAI Organization header，可选
+- `AGENT_OPENAI_PROJECT`：OpenAI Project header，可选
+- `AGENT_OPENAI_MODEL`（默认 gpt-4o-mini）：模型名称
+- `AGENT_OPENAI_TEMPERATURE`（默认 0.7）：采样温度
+- `AGENT_OPENAI_TOP_P`（默认 1.0）：Top-p 采样
+- `AGENT_OPENAI_INCLUDE_USAGE`（默认 false）：是否请求流式返回 usage 统计
+- `AGENT_RUN_JOB_TRIES`（默认 1）：AgentRunJob 队列重试次数
+- `AGENT_RUN_JOB_BACKOFF`（默认 3）：AgentRunJob 重试退避秒数
+- `AGENT_RUN_JOB_TIMEOUT`（默认 360）：AgentRunJob 超时时间（秒）
 
 ## 🔑 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）。