feat: add task lifecycle management and improve generation reliability

Centralize timeout policies, stall detection, and error classification
for image/video/text generation tasks. Improve ecommerce OSS upload flow
and add script evaluation enhancements.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

src/api/taskSubscription.ts

@@ -1,4 +1,9 @@
 import { aiGenerationClient } from "./aiGenerationClient";
+import {
+  buildLocalTimeoutMessage,
+  getTaskTimeoutPolicy,
+  isTaskLocallyTimedOut,
+} from "../utils/taskLifecycle";
 
 export interface TaskProgressEvent {
   taskId: string;
@@ -12,16 +17,28 @@ export interface WaitForTaskOptions {
   onProgress?: (event: TaskProgressEvent) => void;
   abortRef?: { current: boolean };
   timeoutMs?: number;
+  noProgressTimeoutMs?: number;
+  startedAt?: number;
+  kind?: "image" | "video" | "text";
+  model?: string | null;
+  operation?: string | null;
 }
 
 const POLL_INTERVAL = 3000;
-const DEFAULT_TIMEOUT = 30 * 60 * 1000;
 
 export function waitForTask(
   taskId: string,
   options: WaitForTaskOptions = {},
 ): Promise<string | null> {
-  const { onProgress, abortRef, timeoutMs = DEFAULT_TIMEOUT } = options;
+  const { onProgress, abortRef } = options;
+  const timeoutPolicy = getTaskTimeoutPolicy({
+    kind: options.kind,
+    model: options.model,
+    operation: options.operation,
+  });
+  const timeoutMs = options.timeoutMs ?? timeoutPolicy.maxRuntimeMs;
+  const noProgressTimeoutMs = options.noProgressTimeoutMs ?? timeoutPolicy.noProgressTimeoutMs;
+  const startedAt = options.startedAt ?? Date.now();
 
   return new Promise((resolve, reject) => {
     let settled = false;
@@ -29,6 +46,8 @@ export function waitForTask(
     let timeoutId: ReturnType<typeof setTimeout> | null = null;
     let sseConnected = false;
     let fallbackTimerId: ReturnType<typeof setTimeout> | null = null;
+    let lastProgress = 0;
+    let lastProgressAt = startedAt;
 
     const settle = (fn: () => void) => {
       if (settled) return;
@@ -40,7 +59,7 @@ export function waitForTask(
     };
 
     timeoutId = setTimeout(
-      () => settle(() => reject(new Error("等待任务结果超时，请稍后在任务历史中查看"))),
+      () => settle(() => reject(new Error(buildLocalTimeoutMessage(options.kind || "video")))),
       timeoutMs,
     );
 
@@ -50,6 +69,11 @@ export function waitForTask(
         settle(() => resolve(null));
         return;
       }
+      const progress = Number(event.progress || 0);
+      if (progress > lastProgress || event.status === "completed") {
+        lastProgress = Math.max(lastProgress, progress);
+        lastProgressAt = Date.now();
+      }
       onProgress?.(event);
       if (event.status === "completed") {
         settle(() => resolve(event.resultUrl || null));
@@ -76,6 +100,16 @@ export function waitForTask(
           }
           await new Promise((r) => setTimeout(r, POLL_INTERVAL));
           if (settled || abortRef?.current) return;
+          const timeoutReason = isTaskLocallyTimedOut({
+            startedAt,
+            lastProgressAt,
+            progress: lastProgress,
+            policy: { ...timeoutPolicy, noProgressTimeoutMs },
+          });
+          if (timeoutReason) {
+            settle(() => reject(new Error(buildLocalTimeoutMessage(options.kind || "video"))));
+            return;
+          }
           try {
             const task = await aiGenerationClient.getTaskStatus(taskId);
             handleUpdate({
@@ -90,7 +124,7 @@ export function waitForTask(
           }
         }
       };
-      poll();
+      void poll();
     }
   });
 }