feat(generation): align validated SSE adapter with backend tasks

[xyh202131]

本次更新

• Generation 类型严格对齐后端：character_image 与 character_action；首帧和完整动画通过 num_frames（1 / 32）区分，不再另造任务类型。
• 创建任务时携带当前认证用户的 user_id，并校验返回任务的用户、项目、任务 ID、类型、状态和终态结果。
• 使用带鉴权的 fetch SSE 接收状态，兼容后端事件字段 task_id 与 id，统一转换成前端 taskId。
• SSE 路由未部署时才回退任务查询；其他错误明确上报，并支持取消订阅和 401 会话恢复。
• 动作结果保留后端帧序号、图片地址与时长，不在前端重新猜测。

依赖说明

当前 main 中已合并的旧 WorkflowController 仍使用旧 Generation 名称。本 PR 保持后端命名，不在适配器内重新引入旧概念；Controller 调用方需按新的 character_image / character_action 契约同步更新。

验证

• Generation、SSE 与统一 API 相关测试：42 条通过。
• TypeScript 类型检查、oxlint、格式检查通过。
• 生产构建通过。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
windup	Ready	Preview	Aug 11, 2026 8:11am

[fennoai]

Review summary: two issues stand out.

Findings without inline locations

• frontend/src/entities/generation/index.ts:102: The complete-animation result type only preserves URLs, but the backend action frame DTO already carries duration_ms and the frontend Frame model can store durationMs. Once this adapter maps the task into GenerationResult, that timing data is gone and downstream character writes will have to invent defaults.

[johnnyzhang-eng]

实测反馈：契约对得上，但终态不关流会无限重连；另外目前零 UI 消费者

在集成分支（main + #117 + #119 + #111 + 本 PR）上验证，并对一台真实部署的后端订阅了一个已完成的任务。

1. 契约是对的，两处可以放心

• 事件名：服务端实际只吐一种事件名 task_update，靠 payload 里的 status 区分状态，payload 五个键 task_id / task_type / status / result / error_message。本 PR 只监听 task_update 是对的。
  ⚠️ 注意另有一份设计文档写的是 status / progress / completed / failed 四个事件名，与线上实际行为不符，别照那份改。
• URL 拼接带了 project_id，与后端强制要求的 query 参数一致。

2. 终态之后 EventSource 会每 3 秒重连一次，需要显式 close

服务端发完终态事件就关流，但响应里带了 retry: 3000。浏览器原生 EventSource 把「连接关闭」当成断线，于是按 retry 间隔重连——实测 45 秒内重连 15 次，每次都重新收到同一条 completed 事件，测试结束时强制 close，readyState 仍停在 CONNECTING。

也就是说：任务早就结束了，前端还在每 3 秒打一次请求，且业务回调会被重复触发。

修法二选一（前者更稳）：

• 前端在收到 status 为终态（completed / failed）时显式 es.close()；
• 或服务端在关流前不下发 retry，改用一个明确的终止事件。

3. 目前全仓没有调用方

搜 createGenerationApis 的调用点，除测试外为 0。要接进界面还差组合根注入四样：baseUrl、userId、transport: { request, stream }（需要把 #117 的 client 与 shared/api/stream.ts 的 subscribeToEventStream 适配进来）、resolveImageSize(projectId)。这一层目前没人认领，本 PR 合了之后界面上仍然摸不到。

[codecov]

Codecov Report

❌ Patch coverage is 83.95722% with 60 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
frontend/src/entities/generation/api.ts	84.27%	13 Missing and 26 partials ⚠️
frontend/src/shared/api/stream.ts	80.21%	8 Missing and 10 partials ⚠️
.../packages/app/src/windup_app/web/api/generation.py	91.17%	3 Missing ⚠️

📢 Thoughts on this report? Let us know!

[xyh202131]

@fennoai 审核评价

[fennoai]

审核完成

已针对固定提交范围 1f47667327e3ad91b152de2c91df1c88cc7d19fb...275b97e89a1ebec15bad33af66c2de509dab213c 完成代码质量、性能、安全与文档审查，并提交了一次非阻塞 PR 评审。

发现 4 个问题：

• SSE 事件仅读取 id，未兼容要求中的 task_id。
• SSE 解析强制要求 project_id/user_id，与同 PR 声明的精简事件契约不一致。
• 完整动画结果丢失后端帧 index 与 duration_ms，类型也无法暴露这些字段。
• SSE 路由返回 404 等不可用错误时没有查询轮询兜底，运行中的任务可能永久卡住。

验证：尝试运行 Generation/SSE 测试与类型检查，但工作区未安装可执行的 vitest/tsc，命令均因 Permission denied 无法启动；未修改代码。

View job run

[fennoai]

发现 4 个需要处理的问题，主要集中在 SSE 事件契约、结果字段保真和 SSE 不可用时的任务收敛。由于工作区未安装可执行的前端依赖，测试与类型检查无法启动。

[huyanxius]

LGTM👍