main: 扩展 Agent Run 调度与队列功能

- 增加 Agent Run MVP-0，包括 RunDispatcher 和 AgentRunJob
- 优化队列配置，支持 Redis 队列驱动，添加 Horizon 容器
- 更新 Docker 配置，细化角色分工，新增 Horizon 配置
- 增加测试任务 `TestJob`，扩展队列使用示例
- 更新 OpenAPI 规范，添加 Agent Run 相关接口及示例
- 编写文档，详细描述 Agent Run 流程与 MVP-0 功能
- 优化相关服务与文档，支持队列与异步运行

app/Services/RunLoop.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Services;
+
+use App\Services\Agent\AgentProviderInterface;
+use App\Services\Agent\DummyAgentProvider;
+
+class RunLoop
+{
+    public function __construct(
+        private readonly ContextBuilder $contextBuilder,
+        private readonly AgentProviderInterface $provider,
+        private readonly OutputSink $outputSink,
+        private readonly CancelChecker $cancelChecker,
+    ) {
+    }
+
+    public function run(string $sessionId, string $runId): void
+    {
+        if ($this->cancelChecker->isCanceled($sessionId, $runId)) {
+            $this->outputSink->appendRunStatus($sessionId, $runId, 'CANCELED', [
+                'dedupe_key' => "run:{$runId}:status:CANCELED",
+            ]);
+            return;
+        }
+
+        $context = $this->contextBuilder->build($sessionId, $runId);
+
+        if ($this->cancelChecker->isCanceled($sessionId, $runId)) {
+            $this->outputSink->appendRunStatus($sessionId, $runId, 'CANCELED', [
+                'dedupe_key' => "run:{$runId}:status:CANCELED",
+            ]);
+            return;
+        }
+
+        $reply = $this->provider->generate($context);
+
+        if ($this->cancelChecker->isCanceled($sessionId, $runId)) {
+            $this->outputSink->appendRunStatus($sessionId, $runId, 'CANCELED', [
+                'dedupe_key' => "run:{$runId}:status:CANCELED",
+            ]);
+            return;
+        }
+
+        $this->outputSink->appendAgentMessage($sessionId, $runId, $reply, [
+            'provider' => $this->provider instanceof DummyAgentProvider ? 'dummy' : get_class($this->provider),
+        ]);
+        $this->outputSink->appendRunStatus($sessionId, $runId, 'DONE', [
+            'dedupe_key' => "run:{$runId}:status:DONE",
+        ]);
+    }
+}