Run Module

接口

GET /runs/{runId}

查询 run 状态。关键字段：parentRunId、triggerType、status、agentName、effectiveAgentName、switchCount、heartbeatAt、errorCode、errorMessage。

POST /runs/{runId}/cancel

请求取消 run。返回 runId、status=cancellation_requested。

取消是异步操作，最终结果以后续 run 状态和 SSE 事件为准。

GET /runs/{runId}/steps

查询步骤级审计：model_call、tool_call、agent_switch、agent_delegate、hook。返回 items、nextCursor。

状态

queued → running → waiting_tool → completed / failed / cancelled / timed_out

设计说明

• run 内允许 agent.switch（切换 agent）和 agent.delegate（创建 subagent）
• child run 通过 parentRunId 关联父 run
• worker 异常退出时，后续 worker 基于 heartbeatAt 回收 stale run 为失败态