main: 增强 Agent Run 调度可靠性与幂等性

- 默认切换 AgentProvider 为 HttpAgentProvider，增强网络请求的容错和重试机制
- 优化 Run 逻辑，支持多场景去重与并发保护
- 添加 Redis 发布失败的日志记录以提升问题排查效率
- 扩展 OpenAPI 规范，新增 Error 和 Run 状态相关模型
- 增强测试覆盖，验证调度策略和重复请求的幂等性
- 增加数据库索引以优化查询性能
- 更新所有相关文档和配置文件

app/Services/ChatService.php

@@ -56,14 +56,16 @@ class ChatService
      *                                  - payload: 附加信息（可选）
      *                                  - reply_to: 被回复的消息 ID（可选）
      *                                  - dedupe_key: 消息去重键（可选）
+     * @param bool|null $wasDeduped 是否发生了去重（可选，按引用返回）
      * @return Message 返回成功追加的消息实例。如果存在去重键并已存在重复消息，则返回现有的消息。
      */
-    public function appendMessage(array $dto): Message
+    public function appendMessage(array $dto, ?bool &$wasDeduped = null): Message
     {
         $messageRef = null;
         $isNew = false;
+        $wasDeduped = false;
 
-        DB::transaction(function () use ($dto, &$messageRef, &$isNew) {
+        DB::transaction(function () use ($dto, &$messageRef, &$isNew, &$wasDeduped) {
             /** @var ChatSession $session */
             $session = ChatSession::query()
                 ->whereKey($dto['session_id'])
@@ -81,6 +83,7 @@ class ChatService
 
                 if ($existing) {
                     $messageRef = $existing;
+                    $wasDeduped = true;
                     return;
                 }
             }
@@ -112,6 +115,7 @@ class ChatService
 
                     if ($existing) {
                         $messageRef = $existing;
+                        $wasDeduped = true;
                         return;
                     }
                 }
@@ -288,9 +292,11 @@ class ChatService
         try {
             Redis::publish($channel, $message->message_id);
         } catch (\Throwable $e) {
-            if (! app()->runningUnitTests()) {
-                throw $e;
-            }
+            logger()->warning('Redis publish failed', [
+                'session_id' => $message->session_id,
+                'message_id' => $message->message_id,
+                'error' => $e->getMessage(),
+            ]);
         }
     }