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/**`，「前端能渲染」待前端批）；无真实模型端到端。

internal/runtime/loop/run.go

@@ -23,6 +23,10 @@ import (
 // goroutine 上，因此提取绝不延迟回复），错误记录日志
 // 而非致命。
 //
+// 回合边界发出 turn.start / turn.end 流式帧（design/04 §1.1）：
+// start 在任何工作之前，end 经 defer 覆盖 Run 的每个出口
+// （最终答案 / 安全网终止 / 预算耗尽 / 步骤错误）。
+//
 // 当 turn 带着 Result 落定时，OnTurnEnd 钩子对该
 // turn 调用一次（绝不按步调用），其情绪标签记录在 Result.Mood 上，
 // 使循环外围的分层能推进人格状态并标记持久化的回复。
@@ -46,6 +50,9 @@ func (l *Loop) Run(ctx context.Context, sessionID string, messages []model.Messa
 	ctx = withCapState(ctx, &capStateAccum{state: capacity.StateQuiet})
 	ctx = withLoopSession(ctx, sessionID)
 
+	l.emitTurnBoundary(ctx, model.StreamKindTurnStart)
+	defer l.emitTurnBoundary(ctx, model.StreamKindTurnEnd)
+
 	// 恢复被中断的 run（design §1 durable execution）：该会话有
 	// 可恢复的 checkpoint 时，重建其上下文并从下一步继续，
 	// 而不是从全新对话重启。不同的
@@ -53,7 +60,6 @@ func (l *Loop) Run(ctx context.Context, sessionID string, messages []model.Messa
 	// 全新开始（LoadLatest 未命中，或 stop reason 不可恢复）。
 	msgs, startStep, _ := l.loadCheckpoint(ctx, sessionID, messages)
 	msgs = l.resolveImages(ctx, msgs)
-	toolState := &toolLoopState{prevFP: make(map[string]bool)}
 	res := &Result{}
 	// 分支 Run（子代理）把其 span 并入父会话的实时
 	// 图；只有所属的 Run 开始与结束轮次。没有它，子代理
@@ -62,6 +68,14 @@ func (l *Loop) Run(ctx context.Context, sessionID string, messages []model.Messa
 		l.flow.StartRound(sessionID, lastUserText(msgs))
 		defer func() { l.flow.EndRound(sessionID, res.Text) }()
 	}
+	return l.driveTurn(ctx, sessionID, msgs, startStep, res)
+}
+
+// driveTurn 运行至多 maxRounds 个 step 的主循环：每步组装上下文、
+// 调用模型、执行被请求的工具并回灌。它在任何一种落定路径上返回
+// 已 settle 的 Result；step 或工具批次的错误以 %w 包装返回。
+func (l *Loop) driveTurn(ctx context.Context, sessionID string, msgs []model.Message, startStep int, res *Result) (*Result, error) {
+	toolState := &toolLoopState{prevFP: make(map[string]bool)}
 	for step := startStep; step <= l.maxRounds; step++ {
 		if err := ctx.Err(); err != nil {
 			return nil, fmt.Errorf("loop: run: step %d: %w", step, err)
@@ -88,10 +102,7 @@ func (l *Loop) Run(ctx context.Context, sessionID string, messages []model.Messa
 		if outcome.final {
 			res.Text = outcome.text
 			res.StopReason = outcome.stopReason
-			l.saveCheckpoint(ctx, sessionID, step, msgs, outcome.stopReason)
-			l.extractMemoryAsync(ctx, msgs, step)
-			l.settleTurn(ctx, sessionID, msgs, res)
-			return res, nil
+			return l.settleAndReturn(ctx, sessionID, msgs, step, outcome.stopReason, res)
 		}
 
 		batch, err := l.runToolCalls(rc, msgs, outcome.toolCalls, toolState)
@@ -107,18 +118,22 @@ func (l *Loop) Run(ctx context.Context, sessionID string, messages []model.Messa
 		if batch.terminate {
 			res.Text = criticalToolLoopTerminalReason
 			res.StopReason = StopReasonToolLoopTerminated
-			l.saveCheckpoint(ctx, sessionID, step, msgs, StopReasonToolLoopTerminated)
-			l.extractMemoryAsync(ctx, msgs, step)
-			l.settleTurn(ctx, sessionID, msgs, res)
-			return res, nil
+			return l.settleAndReturn(ctx, sessionID, msgs, step, StopReasonToolLoopTerminated, res)
 		}
 	}
 
 	// 预算耗尽而无最终答案。
 	res.Steps = l.maxRounds
 	res.StopReason = StopReasonMaxRounds
-	l.saveCheckpoint(ctx, sessionID, l.maxRounds, msgs, StopReasonMaxRounds)
-	l.extractMemoryAsync(ctx, msgs, l.maxRounds)
+	return l.settleAndReturn(ctx, sessionID, msgs, l.maxRounds, StopReasonMaxRounds, res)
+}
+
+// settleAndReturn 落定一个已得出 Result 的回合：以该路径的
+// stop reason 持久化终态 checkpoint、触发后台记忆提取、
+// 上报 turn 钩子（情绪标签写回 Result.Mood），然后把结果交还调用方。
+func (l *Loop) settleAndReturn(ctx context.Context, sessionID string, msgs []model.Message, step int, stopReason string, res *Result) (*Result, error) {
+	l.saveCheckpoint(ctx, sessionID, step, msgs, stopReason)
+	l.extractMemoryAsync(ctx, msgs, step)
 	l.settleTurn(ctx, sessionID, msgs, res)
 	return res, nil
 }