pretor/pretor/api/workflow.py

#  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"}