feat: 实现 Queue Q1 API 和 CLI 骨架

scripts/src/cli.ts

@@ -33,6 +33,13 @@ async function dispatch(args: ParsedArgs): Promise<JsonValue> {
   if (group === "server" && command === "status") return client(args).get("/health/readiness");
   if (group === "backends" && command === "list") return client(args).get("/api/v1/backends");
   if (group === "secrets" && command === "codex" && id === "render") return renderCodexSecret(args);
+  if (group === "queue" && command === "submit") return submitQueueTask(args);
+  if (group === "queue" && command === "list") return listQueueTasks(args);
+  if (group === "queue" && command === "show" && id) return client(args).get(`/api/v1/queue/tasks/${encodeURIComponent(id)}`);
+  if (group === "queue" && command === "stats") return client(args).get(`/api/v1/queue/stats${queueQuery(args)}`);
+  if (group === "queue" && command === "commander") return client(args).get(`/api/v1/queue/commander${queueQuery(args)}`);
+  if (group === "queue" && command === "read" && id) return client(args).post(`/api/v1/queue/tasks/${encodeURIComponent(id)}/read`, { readerId: optionalFlag(args, "reader-id") ?? "cli" });
+  if (group === "queue" && command === "cancel" && id) return client(args).post(`/api/v1/queue/tasks/${encodeURIComponent(id)}/cancel`, cancelBody(args));
   if (group === "runs" && command === "create") return client(args).post("/api/v1/runs", await jsonFile(args));
   if (group === "runs" && command === "show" && id) return client(args).get(`/api/v1/runs/${encodeURIComponent(id)}`);
   if (group === "runs" && command === "events" && id) return client(args).get(`/api/v1/runs/${encodeURIComponent(id)}/events?afterSeq=${flag(args, "after-seq", "0")}&limit=${flag(args, "limit", "100")}`);
@@ -92,6 +99,34 @@ async function listRunnerJobs(args: ParsedArgs): Promise<JsonValue> {
   return client(args).get(`/api/v1/runs/${encodeURIComponent(runId)}/runner-jobs${commandId ? `?commandId=${encodeURIComponent(commandId)}` : ""}`);
 }
 
+async function submitQueueTask(args: ParsedArgs): Promise<JsonValue> {
+  const body = await jsonFile(args);
+  const idempotencyKey = optionalFlag(args, "idempotency-key");
+  if (idempotencyKey) body.idempotencyKey = idempotencyKey;
+  return client(args).post("/api/v1/queue/tasks", body);
+}
+
+async function listQueueTasks(args: ParsedArgs): Promise<JsonValue> {
+  const params = new URLSearchParams();
+  const queue = optionalFlag(args, "queue");
+  const state = optionalFlag(args, "state");
+  const cursor = optionalFlag(args, "cursor");
+  const limit = optionalFlag(args, "limit");
+  const updatedAfter = optionalFlag(args, "updated-after");
+  if (queue) params.set("queue", queue);
+  if (state) params.set("state", state);
+  if (cursor) params.set("cursor", cursor);
+  if (limit) params.set("limit", limit);
+  if (updatedAfter) params.set("updatedAfter", updatedAfter);
+  const query = params.toString();
+  return client(args).get(`/api/v1/queue/tasks${query ? `?${query}` : ""}`);
+}
+
+function queueQuery(args: ParsedArgs): string {
+  const queue = optionalFlag(args, "queue");
+  return queue ? `?queue=${encodeURIComponent(queue)}` : "";
+}
+
 async function showRunnerJobStatus(args: ParsedArgs): Promise<JsonValue> {
   const runId = flag(args, "run-id", "");
   if (!runId) throw new AgentRunError("schema-invalid", "runner job-status requires --run-id", { httpStatus: 2 });
@@ -240,6 +275,13 @@ function help(): JsonRecord {
       "runner job --dry-run --run-id <runId> --command-id <commandId> --image <image>",
       "runner jobs --run-id <runId> [--command-id <commandId>]",
       "runner job-status [runnerJobId] --run-id <runId>",
+      "queue submit --json-file <task.json> [--idempotency-key <key>]",
+      "queue list [--queue <queue>] [--state <state>] [--cursor <cursor>] [--limit <limit>] [--updated-after <version>]",
+      "queue show <taskId>",
+      "queue stats [--queue <queue>]",
+      "queue commander [--queue <queue>]",
+      "queue read <taskId> [--reader-id <reader>]",
+      "queue cancel <taskId> [--reason <text>]",
       "secrets codex render --dry-run [--profile codex|deepseek] [--codex-home <dir>] [--namespace agentrun-v01] [--secret-name <name>]",
       "backends list",
       "server start|status",