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

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

app/Services/OutputSink.php

@@ -13,21 +13,24 @@ class OutputSink
     /**
      * @param array<string, mixed> $meta
      */
-    public function appendAgentMessage(string $sessionId, string $runId, string $content, array $meta = []): Message
+    public function appendAgentMessage(string $sessionId, string $runId, string $content, array $meta = [], ?string $dedupeKey = null): Message
     {
+        $dedupeKey = $dedupeKey ?? "run:{$runId}:agent:message";
+
         return $this->chatService->appendMessage([
             'session_id' => $sessionId,
             'role' => Message::ROLE_AGENT,
             'type' => 'agent.message',
             'content' => $content,
             'payload' => array_merge($meta, ['run_id' => $runId]),
+            'dedupe_key' => $dedupeKey,
         ]);
     }
 
     /**
      * @param array<string, mixed> $meta
      */
-    public function appendRunStatus(string $sessionId, string $runId, string $status, array $meta = []): Message
+    public function appendRunStatus(string $sessionId, string $runId, string $status, array $meta = [], ?bool &$wasDeduped = null): Message
     {
         $dedupeKey = $meta['dedupe_key'] ?? null;
         unset($meta['dedupe_key']);
@@ -36,18 +39,19 @@ class OutputSink
             'session_id' => $sessionId,
             'role' => Message::ROLE_SYSTEM,
             'type' => 'run.status',
+            'content' => null,
             'payload' => array_merge($meta, [
                 'run_id' => $runId,
                 'status' => $status,
             ]),
             'dedupe_key' => $dedupeKey,
-        ]);
+        ], $wasDeduped);
     }
 
     /**
      * @param array<string, mixed> $meta
      */
-    public function appendError(string $sessionId, string $runId, string $code, string $message, array $meta = []): Message
+    public function appendError(string $sessionId, string $runId, string $code, string $message, array $meta = [], ?string $dedupeKey = null): Message
     {
         return $this->chatService->appendMessage([
             'session_id' => $sessionId,
@@ -58,6 +62,7 @@ class OutputSink
                 'run_id' => $runId,
                 'message' => $message,
             ]),
+            'dedupe_key' => $dedupeKey,
         ]);
     }
 }