# Copyright 2026 zhaoxi826 # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from pretor.utils.ray_hook import ray_actor_hook from fastapi import APIRouter, Request, HTTPException from fastapi.responses import StreamingResponse import asyncio workflow_router = APIRouter(prefix="/api/v1/workflow", tags=["workflow"]) @workflow_router.get("/list") async def get_workflow_list(): """处理针对 get workflow list 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Returns: : 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_workflow_manager = ray_actor_hook( "global_workflow_manager" ).global_workflow_manager events = await global_workflow_manager.list_events.remote() return events @workflow_router.get("/{trace_id}") async def get_workflow_detail(trace_id: str): """处理针对 get workflow detail 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID),用于在数据库表或缓存结构中精准匹配该 trace 实例。 Returns: : 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_workflow_manager = ray_actor_hook( "global_workflow_manager" ).global_workflow_manager event = await global_workflow_manager.get_event.remote(trace_id) if not event: raise HTTPException(status_code=404, detail="Workflow not found") workflow = event.workflow if not workflow: return { "event_id": trace_id, "workflow_title": None, "status": "waiting", "user_name": event.user_name, "message": event.message, "create_time": event.create_time, "steps": [], } steps = [] for step in workflow.work_link: steps.append( { "step": step.step, "name": step.name, "node": step.node, "action": step.action, "desc": step.desc, "status": step.status, "agent_id": step.agent_id, } ) return { "event_id": trace_id, "workflow_title": workflow.title, "status": workflow.status.status, "command": workflow.command, "current_step": workflow.status.step, "user_name": event.user_name, "message": event.message, "create_time": event.create_time, "steps": steps, } @workflow_router.get("/sse/{trace_id}") async def get_workflow_sse(trace_id: str, request: Request): """处理针对 get workflow sse 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID),用于在数据库表或缓存结构中精准匹配该 trace 实例。 request (Request): FastAPI 框架注入的原生 HTTP 请求对象,包含了完整的 Header 标头、查询参数和正文流。 Returns: : 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_workflow_manager = ray_actor_hook( "global_workflow_manager" ).global_workflow_manager async def event_generator(): """执行与 event generator 相关的核心业务流转操作。 该方法封装了具体的算法策略或状态控制逻辑,确保操作能够在事务上下文中被原子且一致地执行。""" try: while True: if await request.is_disconnected(): break # You might also want to send the workflow state periodically or when updated # Here we just wait for pending messages and send them message = await global_workflow_manager.get_pending.remote(trace_id) # Ensure the message is formatted as SSE yield f"data: {message}\n\n" except asyncio.CancelledError: pass return StreamingResponse(event_generator(), media_type="text/event-stream") @workflow_router.post("/reply/{trace_id}") async def post_workflow_reply(trace_id: str, request: Request): """处理针对 post workflow reply 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: trace_id (str): 目标对象的唯一全局标识符 (UUID/ULID),用于在数据库表或缓存结构中精准匹配该 trace 实例。 request (Request): FastAPI 框架注入的原生 HTTP 请求对象,包含了完整的 Header 标头、查询参数和正文流。 Returns: : 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" data = await request.json() reply_msg = data.get("message", "") global_workflow_manager = ray_actor_hook( "global_workflow_manager" ).global_workflow_manager await global_workflow_manager.put_received.remote(trace_id, reply_msg) return {"status": "ok"}