feat(loop,gateway): 事件批 — tool_execution 三事件 + streamId + turn.start/end(裁决 01.4.1/01.4.2/01.4.3/01.4.5/03.4.4/1.12)
执行方案阶段 2 · P2-3(`DevDocs/audit/_plan.md`)。契约 `Docs/api-client.md` → **v0.50**。
- **01.4.1 `tool_execution` 拆三事件**:`model/stream.go` 删旧 `StreamKindToolExecution`,新增
`tool_execution.start/update/end` + `ToolPhaseRunning/Done/Error`(与 design/19 status 同值);
`StreamEvent` 增 `Tool`/`Phase`;`loop/tools.go` 的 `emitToolExecution` 重写为结构化字段、
**Delta 恒空**(断言锁死),`ID` 复用 provider tool call id(可与 `tool_call.*` 关联)。
⚠️ **诚实边界**:start/end 有真实生产者;`update` 的 wire 映射已实现并单测锁定,但**工具分发器
无中途进度上报源 ⇒ loop 暂不产出 update 帧**(已在 api-client §3.1 如实登记)。
- **03.4.4 phase 驱动图节点状态**:`invokeOne` 用**单一 phase 决策**同时决定 end 帧 phase、
span 的 `phase` prop 与终态;`trace/graph.go` 新增 `FlowStatusForPhase`,`graph_build.go` 的
`AddSpan` 对 tool 节点**优先消费 phase prop**(缺省回落 span 终态 ⇒ 两路不可能矛盾)。
- **01.4.2 `streamId`**:`StreamEvent` 增 `StreamID`;`loop/stream.go` 每次 ChatStream 生成
`stream-<hex>`(crypto/rand,降级时间戳),该流所有帧共享、多步工具轮取新 id;`ws_bridge`
把它并进**模型流帧** `data`(`tool_execution.*`/`turn.*` 不带)。语义区分:`turnId` = 哪轮回答,
`streamId` = 这条流式消息。
- **01.4.3 `turn.start`/`turn.end`**:`loop/run.go` 入口发 start、defer 发 end,**覆盖全部出口**
(最终答案/安全网终止/预算耗尽/步骤错误);帧**无 data 载荷**;静音的内部 run(backthink/子代理)
不发。顺带把 91 行的 `Run` 拆成 `driveTurn` + `settleAndReturn`(清掉一处既有 >80 行违规)。
- **01.4.5**:仅 `Docs/api-client.md` §3.5 补 `graph_update` 三范围(`web`/`web:<uuid>`/`sess-backthink`),
与 `wire_runtime.go` 的 allow 谓词一致,**零代码变更**。
验证:`go build ./...` 绿;本批四包(loop/model/trace/gateway)vet + 测试绿(含 `-count=1`);
linux/amd64 + darwin/arm64 交叉编译绿;本批 16 文件 ≤500 行、函数 ≤80 行。
**真 WS 帧断言 8 条**:帧序 `turn.start → message.delta → tool_execution.start →
tool_execution.end → message.delta → turn.end`(+`stream_end`)、turn 边界无载荷且整轮 turnId 一致、
两条模型流 `streamId` 互异、tool 帧 `{tool,phase,id}` 且无 `delta`/`streamId` 键、
`turn.end` 在步骤出错时也发出、内部静音 run 不发边界帧。
**变异验证**:把 `ev.StreamID = streamID` 改为赋空 → 两条断言 FAIL(`streamId` 为空/两流同空),
还原后复绿(直接删行会先被编译期 `declared and not used` 拦截)。
未验证:前端未消费这些帧(本轮未动 `frontend/**`,「前端能渲染」待前端批);无真实模型端到端。
This commit is contained in:
1 parent
afef75f640
commit
6e7ec56f9a
16 files changed
+982
-126
No files matched your search
@@ -2,7 +2,10 @@ package loop
|
||||
|
||||
import (
|
||||
"context"
|
||||
"crypto/rand"
|
||||
"encoding/hex"
|
||||
"fmt"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/agent"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/model"
|
||||
@@ -36,6 +39,11 @@ func (l *Loop) streamStep(ctx context.Context, messages []model.Message) (*stepO
|
||||
}
|
||||
}
|
||||
|
||||
// 一次模型流(一次 ChatStream 调用)取一个 streamId:该流的
|
||||
// 每一帧共享它,而多步工具轮的后续模型调用取新的 id
|
||||
// (design/04 §1.1)。它与 TurnID 分工:turnId 标记整个回合,
|
||||
// streamId 标记回合内的一条流式消息。
|
||||
streamID := newStreamID()
|
||||
resp, err := adapter.ChatStream(ctx, req, func(ev model.StreamEvent) {
|
||||
// 在循环边界打上 session/turn 身份:适配器运行在
|
||||
// 循环之下,无法知道该流属于哪个会话,
|
||||
@@ -43,6 +51,7 @@ func (l *Loop) streamStep(ctx context.Context, messages []model.Message) (*stepO
|
||||
// 前端便能把增量路由到活跃会话。
|
||||
ev.SessionID = loopSession(ctx)
|
||||
ev.TurnID = loopTurn(ctx)
|
||||
ev.StreamID = streamID
|
||||
// 为内部自主流程(backthink)抑制 UI 广播,
|
||||
// 其中间推理不得泄露进聊天流;当该 turn 的角色
|
||||
// 关闭思考帧时(showToUser: false)也抑制。两处门
|
||||
@@ -95,3 +104,31 @@ func isThinkingKind(kind model.StreamKind) bool {
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
// newStreamID 返回新的随机十六进制标识,用于把一串流帧关联到
|
||||
// 同一次模型流(design/04 §1.1 streamId)。它消耗 crypto/rand 源,
|
||||
// 源不可用时回退到纳秒时间戳,因此总能产出 id(空的 streamId 会
|
||||
// 静默破坏客户端关联)。
|
||||
func newStreamID() string {
|
||||
var b [8]byte
|
||||
if _, err := rand.Read(b[:]); err == nil {
|
||||
return "stream-" + hex.EncodeToString(b[:])
|
||||
}
|
||||
return "stream-" + time.Now().UTC().Format("20060102150405.000000000")
|
||||
}
|
||||
|
||||
// emitTurnBoundary 在循环的回合边界发出 turn.start / turn.end 帧
|
||||
// (design/04 §1.1)。它复用流式路径的广播门:未配置 OnStream 或
|
||||
// 被静音的内部流程(backthink / 子代理)不发出。两帧不带载荷 ——
|
||||
// 帧壳上的 session/turn 身份就是边界信号,回合的终态信息仍由
|
||||
// hub 在 Run 返回后发出的 stream_end 携带。
|
||||
func (l *Loop) emitTurnBoundary(ctx context.Context, kind model.StreamKind) {
|
||||
if l.onStream == nil || isMutedBroadcast(ctx) {
|
||||
return
|
||||
}
|
||||
l.onStream(model.StreamEvent{
|
||||
Kind: kind,
|
||||
SessionID: loopSession(ctx),
|
||||
TurnID: loopTurn(ctx),
|
||||
})
|
||||
}
|
||||
Reference in new issue
Block a user