from __future__ import annotations import time import uuid from enum import StrEnum from typing import Any from pydantic import BaseModel, Field class EventType(StrEnum): """前端与后端之间的实时协议。画布高亮、时间线、token 流全部基于这套事件。""" # run 级 RUN_STARTED = "run.started" RUN_FINISHED = "run.finished" RUN_FAILED = "run.failed" RUN_CANCELLED = "run.cancelled" RUN_INTERRUPTED = "run.interrupted" # 等待人工介入 RUN_RESUMED = "run.resumed" # 节点级 NODE_STARTED = "node.started" NODE_FINISHED = "node.finished" NODE_FAILED = "node.failed" NODE_SKIPPED = "node.skipped" EDGE_TAKEN = "edge.taken" # 条件分支实际走了哪条边 # 模型级 LLM_START = "llm.start" LLM_TOKEN = "llm.token" # 思考的流式增量:只推给画布做实时显示,不落库 LLM_THINKING_DELTA = "llm.thinking.delta" # 一次完整思考:调用结束时落一条,这才是进轨迹的事件 LLM_THINKING = "llm.thinking" LLM_END = "llm.end" # 工具 / 沙箱 TOOL_START = "tool.start" TOOL_END = "tool.end" TOOL_ERROR = "tool.error" # 知识检索。以前只发一条 info 日志,于是"这句结论依据的是哪份文档的哪一段" # 在轨迹里查不到——而 SQL 取数那条路早就有工件快照可以下钻 RETRIEVE_END = "retrieve.end" # 记忆读写。以前发的是 info 日志,而解码器丢弃所有 info——于是往长期记忆里 # 写东西这件事在界面上是隐形的。让 Copilot 主动记之后,这条不可接受 MEMORY_END = "memory.end" SANDBOX_START = "sandbox.start" SANDBOX_END = "sandbox.end" # 多 agent 协作中的单个 agent 步骤 AGENT_STEP_START = "agent.step.start" AGENT_STEP_END = "agent.step.end" # 调度者的一次决策。它是一次结构化模型调用,常常占掉团队节点大半的时间; # 以前前后都没有事件,界面上那几十秒是黑盒 AGENT_ROUTE_START = "agent.route.start" AGENT_ROUTE_END = "agent.route.end" # 人工介入 HUMAN_REQUESTED = "human.requested" HUMAN_RESOLVED = "human.resolved" # 出具与口径治理 ISSUANCE = "issuance" # 出具契约的判定结果(档位 / 缺数据 / 未回指数字) CALIBER_UPGRADE = "caliber.upgrade" # 钉住的方法卡有新版本,按声明的策略处置 # 其他 LOG = "log" USAGE = "usage" # token / 成本累计 class RunEventModel(BaseModel): id: str = Field(default_factory=lambda: uuid.uuid4().hex) run_id: str seq: int = 0 type: EventType node_id: str | None = None ts: float = Field(default_factory=time.time) data: dict[str, Any] = Field(default_factory=dict) def to_wire(self) -> dict[str, Any]: return self.model_dump(mode="json")