mslxdff 0.1.199 → 0.1.203

package/src/routes/chat/broadband-handler.js

@@ -1,72 +1,72 @@
-import { relay, SLOW_TOTAL_MS, STREAM_TIMEOUT_MS, STALL_TIMEOUT_MS, SCORE_STALL_MS } from "../stream.js";
-import { buildFallbackInfo } from "../fallback.js";
-import { createRelayPipeline } from "./relay-pipeline.js";
-import { tryBroadbandRelay } from "../relay-queue.js";
-
-/** 薄适配：broadband 两种形态合一经由 pipeline */
-export async function handleBroadbandRelay({
-  model,
-  body,
-  hops,
-  lastErr,
-  requested,
-  useAuto,
-  lockModel,
-  auto,
-  groups,
-  token,
-  bus,
-  logs,
-  handlerCtx,
-  evt,
-  mark,
-  perf0,
-  attemptStartMs,
-  stages,
-  res,
-  startedAt,
-  plugins,
-  deps = {},
-}) {
-  const { createPipeline = createRelayPipeline, tryBroadbandRelay: tryRelay = tryBroadbandRelay } = deps;
-  const bb = await tryRelay({ groups, token, model, body, hops, bus, logs, reqId: handlerCtx.reqId, evt, res, mark, perf0, stages });
-  if (!bb) {
-    evt("relay-miss", { reqId: handlerCtx.reqId, model });
-    return { handled: false };
-  }
-  const pipeline = createPipeline({
-    relay,
-    buildFallbackInfo,
-    auto,
-    plugins,
-    evt,
-    mark,
-    logCall: () => {},
-    logError: () => {},
-    constants: { STREAM_TIMEOUT_MS, SLOW_TOTAL_MS, STALL_TIMEOUT_MS, SCORE_STALL_MS },
-    startedAt,
-    stages,
-  });
-  const isResponse = bb.result && typeof bb.result.status === "number" && typeof bb.result.headers?.get === "function";
-  if (isResponse) {
-    const r = await pipeline.execute({ res, upRes: bb.result, body, requested, actual: model, lastErr, via: "broadband", lockModel, useAuto, handlerCtx, mark, perf0, attemptStartMs, stages, startedAt });
-    if (!r.handled) return { handled: false, upRes: null, lastErr: r.lastErr };
-    return { handled: true };
-  }
-  if (bb.result && typeof bb.result.status === "number") {
-    const b = bb.result.body || "";
-    const str = typeof b === "string" ? b : JSON.stringify(b);
-    const isSSE = bb.result.headers?.["Content-Type"]?.includes("text/event-stream");
-    const fakeRes = {
-      status: bb.result.status,
-      headers: { get: (k) => bb.result.headers?.[k] || bb.result.headers?.[k.toLowerCase()] || null },
-      text: async () => str,
-      body: isSSE ? (async function* () { yield Buffer.from(str); })() : null,
-    };
-    const r = await pipeline.execute({ res, upRes: fakeRes, body, requested, actual: model, lastErr, via: "broadband-local", lockModel, useAuto, handlerCtx, mark, perf0, attemptStartMs, stages, startedAt });
-    if (!r.handled) return { handled: false, upRes: null, lastErr: r.lastErr };
-    return { handled: true };
-  }
-  evt("relay-miss", { reqId: handlerCtx.reqId, model });
-  return { handled: false };
-}
+import { relay, SLOW_TOTAL_MS, STREAM_TIMEOUT_MS, STALL_TIMEOUT_MS, SCORE_STALL_MS } from "../stream.js";
+import { buildFallbackInfo } from "../fallback.js";
+import { createRelayPipeline } from "./relay-pipeline.js";
+import { tryBroadbandRelay } from "../relay-queue.js";
+
+/** 薄适配：broadband 两种形态合一经由 pipeline */
+export async function handleBroadbandRelay({
+  model,
+  body,
+  hops,
+  lastErr,
+  requested,
+  useAuto,
+  lockModel,
+  auto,
+  groups,
+  token,
+  bus,
+  logs,
+  handlerCtx,
+  evt,
+  mark,
+  perf0,
+  attemptStartMs,
+  stages,
+  res,
+  startedAt,
+  plugins,
+  deps = {},
+}) {
+  const { createPipeline = createRelayPipeline, tryBroadbandRelay: tryRelay = tryBroadbandRelay } = deps;
+  const bb = await tryRelay({ groups, token, model, body, hops, bus, logs, reqId: handlerCtx.reqId, evt, res, mark, perf0, stages });
+  if (!bb) {
+    evt("relay-miss", { reqId: handlerCtx.reqId, model });
+    return { handled: false };
+  }
+  const pipeline = createPipeline({
+    relay,
+    buildFallbackInfo,
+    auto,
+    plugins,
+    evt,
+    mark,
+    logCall: () => {},
+    logError: () => {},
+    constants: { STREAM_TIMEOUT_MS, SLOW_TOTAL_MS, STALL_TIMEOUT_MS, SCORE_STALL_MS },
+    startedAt,
+    stages,
+  });
+  const isResponse = bb.result && typeof bb.result.status === "number" && typeof bb.result.headers?.get === "function";
+  if (isResponse) {
+    const r = await pipeline.execute({ res, upRes: bb.result, body, requested, actual: model, lastErr, via: "broadband", lockModel, useAuto, handlerCtx, mark, perf0, attemptStartMs, stages, startedAt });
+    if (!r.handled) return { handled: false, upRes: null, lastErr: r.lastErr };
+    return { handled: true };
+  }
+  if (bb.result && typeof bb.result.status === "number") {
+    const b = bb.result.body || "";
+    const str = typeof b === "string" ? b : JSON.stringify(b);
+    const isSSE = bb.result.headers?.["Content-Type"]?.includes("text/event-stream");
+    const fakeRes = {
+      status: bb.result.status,
+      headers: { get: (k) => bb.result.headers?.[k] || bb.result.headers?.[k.toLowerCase()] || null },
+      text: async () => str,
+      body: isSSE ? (async function* () { yield Buffer.from(str); })() : null,
+    };
+    const r = await pipeline.execute({ res, upRes: fakeRes, body, requested, actual: model, lastErr, via: "broadband-local", lockModel, useAuto, handlerCtx, mark, perf0, attemptStartMs, stages, startedAt });
+    if (!r.handled) return { handled: false, upRes: null, lastErr: r.lastErr };
+    return { handled: true };
+  }
+  evt("relay-miss", { reqId: handlerCtx.reqId, model });
+  return { handled: false };
+}

package/src/routes/chat/empty-turn-report.js

@@ -1,31 +1,31 @@
-// 空转 200 的收场记账（从 relay-pipeline.js 抽出：那儿是 20KB 硬门的存量超标文件，先拆后写）。
-// 只做「把这一轮判成空转后该记什么、该把 lastErr 造成什么形状」，不碰网络/闸门/响应体。
-// 判据本身不在这里：单一真相是 stream-scan.js 的 isEmptyTurnDetail（relay 侧「要不要封口」与
-// 这里「要不要重拉」必须同源，否则会出现留了口却不再救、或已终结却仍重拉的错拍）。
-import { upstreamEcho } from "../../model-trace.js";
-
-/**
- * 空转 200 收场：记 errors.log + upstream-error/fallback 事件，返回交给 serial-trial 的 lastErr。
- * @param {{ out: object, actual: string, reqId: string, upRes: object, logError: Function, evt: Function }} p
- * @returns {{ handled: false, upRes: null, lastErr: object }}
- */
-export function reportEmptyTurn({ out, actual, reqId, upRes, logError, evt }) {
-  const d = out.detail || {};
-  const why = d.sawFinishReason ? ` (finish_reason=${d.sawFinishReason})` : " (no content, no tool calls)";
-  // 错误包络暂扣后下游不再直观看到上游原文：把摘要带进最终报错（截断 200 字），排障不断线。
-  const err = d.upstreamErrorText ? ` upstream=${String(d.upstreamErrorText).slice(0, 200)}` : "";
-  // 零正文的成因直接写进报错（不只给现象）：finish_reason=length + 大量思考 = 额度被 reasoning 吃光
-  // （实测 cline-free deepseek reasoningChars=28151、completion_tokens=8192=max_tokens、chars=0）。
-  // 同参重拉必复现，故 serial-trial 的空转重试会顺手把 max_tokens 抬一档（见 emptyRaiseCap）。
-  const lenCapped = d.sawFinishReason === "length";
-  const hint = lenCapped && (Number(d.reasoningChars) || 0) > 0
-    ? ` [思考 ${Number(d.reasoningChars) || 0} 字刷满 max_tokens，正文 0 字]`
-    : "";
-  try { logError(actual, 502, `empty turn${why}${err}${hint}`); } catch {}
-  evt("upstream-error", { reqId, model: actual, status: 502, message: "empty turn", timing: null, finish: d.sawFinishReason || null, reasoningChars: Number(d.reasoningChars) || 0, wroteFrames: Number(d.wroteChunks) || 0, heldOpen: out.heldOpen === true, ...upstreamEcho(upRes) });
-  evt("fallback", { reqId, from: actual, to: null, reason: "empty turn" });
-  let errMsg = `EMPTY_MODEL_RESPONSE: upstream returned 200 with no content${why}${err}${hint} — retry or rephrase`;
-  // 上游报了 retryAfterSeconds：原样透出（客户端等得起），别被我们的包装话术盖掉。
-  if (d.upstreamErrorText && d.upstreamErrorText.includes("retryAfterSeconds")) errMsg = d.upstreamErrorText;
-  return { handled: false, upRes: null, lastErr: { model: actual, upstream: null, status: 502, message: errMsg, emptyTurn: true, heldOpen: out.heldOpen === true } };
-}
+// 空转 200 的收场记账（从 relay-pipeline.js 抽出：那儿是 20KB 硬门的存量超标文件，先拆后写）。
+// 只做「把这一轮判成空转后该记什么、该把 lastErr 造成什么形状」，不碰网络/闸门/响应体。
+// 判据本身不在这里：单一真相是 stream-scan.js 的 isEmptyTurnDetail（relay 侧「要不要封口」与
+// 这里「要不要重拉」必须同源，否则会出现留了口却不再救、或已终结却仍重拉的错拍）。
+import { upstreamEcho } from "../../model-trace.js";
+
+/**
+ * 空转 200 收场：记 errors.log + upstream-error/fallback 事件，返回交给 serial-trial 的 lastErr。
+ * @param {{ out: object, actual: string, reqId: string, upRes: object, logError: Function, evt: Function }} p
+ * @returns {{ handled: false, upRes: null, lastErr: object }}
+ */
+export function reportEmptyTurn({ out, actual, reqId, upRes, logError, evt }) {
+  const d = out.detail || {};
+  const why = d.sawFinishReason ? ` (finish_reason=${d.sawFinishReason})` : " (no content, no tool calls)";
+  // 错误包络暂扣后下游不再直观看到上游原文：把摘要带进最终报错（截断 200 字），排障不断线。
+  const err = d.upstreamErrorText ? ` upstream=${String(d.upstreamErrorText).slice(0, 200)}` : "";
+  // 零正文的成因直接写进报错（不只给现象）：finish_reason=length + 大量思考 = 额度被 reasoning 吃光
+  // （实测 cline-free deepseek reasoningChars=28151、completion_tokens=8192=max_tokens、chars=0）。
+  // 同参重拉必复现，故 serial-trial 的空转重试会顺手把 max_tokens 抬一档（见 emptyRaiseCap）。
+  const lenCapped = d.sawFinishReason === "length";
+  const hint = lenCapped && (Number(d.reasoningChars) || 0) > 0
+    ? ` [思考 ${Number(d.reasoningChars) || 0} 字刷满 max_tokens，正文 0 字]`
+    : "";
+  try { logError(actual, 502, `empty turn${why}${err}${hint}`); } catch {}
+  evt("upstream-error", { reqId, model: actual, status: 502, message: "empty turn", timing: null, finish: d.sawFinishReason || null, reasoningChars: Number(d.reasoningChars) || 0, wroteFrames: Number(d.wroteChunks) || 0, heldOpen: out.heldOpen === true, ...upstreamEcho(upRes) });
+  evt("fallback", { reqId, from: actual, to: null, reason: "empty turn" });
+  let errMsg = `EMPTY_MODEL_RESPONSE: upstream returned 200 with no content${why}${err}${hint} — retry or rephrase`;
+  // 上游报了 retryAfterSeconds：原样透出（客户端等得起），别被我们的包装话术盖掉。
+  if (d.upstreamErrorText && d.upstreamErrorText.includes("retryAfterSeconds")) errMsg = d.upstreamErrorText;
+  return { handled: false, upRes: null, lastErr: { model: actual, upstream: null, status: 502, message: errMsg, emptyTurn: true, heldOpen: out.heldOpen === true } };
+}

package/src/routes/chat/exhausted-handler.js

@@ -1,87 +1,87 @@
-// Note: 失败收尾四分支在 result 后补 client-response，与成功路径对账口径一致（result 条数 == client-response 条数）— 见 .agents/notes/implemented/bug-fix/2026-09-25-sdk-headers-timeout-and-failure-client-response.md
-import { relay } from "../stream.js";
-import { endHeldFailure } from "../stream-hold.js"; // 终局收场出口（502 JSON 或 SSE 错误帧 + [DONE]）
-import { json } from "../helpers.js";
-import { performance } from "node:perf_hooks";
-import { recordRelayTalk } from "../../talk-log.js"; // 环形对话日志：exhausted 收尾直连 relay，落盘点必须自己补一份
-import { recordAgentLoop } from "../../talk-full.js"; // agent 回路全量语料（talk/full）：与 talk.log 并排各调一次，见 openspec add-agent-loop-capture D1
-import { captureTalkFlush } from "../stream-scan.js"; // 收场回收缺尾换行的末行，record* 读桶前调用（openspec fix-talk-capture-frame-loss D4）
-
-// 最后一站的收场：relay 的「不写响应」路径（超时 / 空轮延后封口）都汇到这里，没有上层 failover 了，
-// 必须把响应「恰好一次」地关掉。形状由 endHeldFailure 按 headers 是否已 flush 决定
-// （未 flush → 502 JSON；已 flush 的 SSE → 错误帧 + [DONE]），这里不再自己 json() 打已 flush 的流。
-function terminal(res, message) {
-  endHeldFailure(res, message || "all auto models failed");
-}
-
-export async function handleExhaustedLocal({ res, body, lastErr, order, handlerCtx, evt, logCall, mark, perf0, stages, done, requested, useAuto, deps = {} }) {
-  const { relay: relayImpl = relay } = deps;
-  const model = lastErr?.model ?? handlerCtx.model;
-  evt("exhausted-local", { reqId: handlerCtx.reqId, lastModel: lastErr?.model ?? model, lastStatus: lastErr?.status ?? 502, order });
-  logCall(lastErr?.model ?? model, lastErr?.status ?? 502);
-  if (lastErr?.upstream) {
-    evt("relay-start", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-exhausted", isStream: Boolean(body.stream) });
-    const out = await relayImpl(res, lastErr.upstream, body, {
-      onFirstChunk: (d) => mark(`ttf-${lastErr.model}`),
-      onDownstreamAbort: () => evt("client-abort", { reqId: handlerCtx.reqId, model: lastErr.model, totalMs: Math.round(performance.now() - perf0), stages: [...stages] }),
-    });
-    // 收场回收（须在 relay-done 事件快照 detail 之前，review P2-6）：flush 缺尾换行的末行，语料与线上字节对齐（fix-talk-capture-frame-loss D4）
-    try { captureTalkFlush(out?.detail?.talk); } catch {}
-    evt("relay-done", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-exhausted", status: out.status, ttfMs: out.ttfMs, totalMs: out.totalMs, aborted: out.aborted, interrupted: out.interrupted ?? false, detail: out.detail ?? null });
-    // 绕过 relay-pipeline 的最后一站：对话日志照常落盘（正文只进 talk/*.log，不进 events.log）
-    // 本收尾点没有 attemptStartMs 可取（绕过 relay-pipeline 直连 relay）→ 不传 attemptMs，按回退路径走：
-    // elapsed=relay 内部计时（与 relayMs 同值，spec 降级 scenario）；finishReason 传 out.detail.sawFinishReason 与 3.3 同源。
-    try { recordRelayTalk({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-exhausted", body, out, finishReason: out.detail?.sawFinishReason }); } catch {}
-    // 回路语料另起一条独立 try：talk.log 是人读环形稿、capture 是机读全量语料，两者生死独立。
-    // hops 走 handlerCtx.hops（serial-trial 以 {...handlerCtx} 展开传进来，与 reqId 同源）；缺值时不兜 0 ——
-    // 交给 talk-full 落 null（「hops 未知」在语料里看得见，比伪造成 0 诚实），组员流量拦截靠真值。
-    try { recordAgentLoop({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-exhausted", hops: handlerCtx?.hops, body, out, sessionKey: handlerCtx?.sessionId, clientIp: handlerCtx?.clientIp }); } catch {} // attemptMs 缺省 → 回退 out.totalMs；缺 echo 的既有形状本期不补（tasks 3.4）
-    evt("result", { reqId: handlerCtx.reqId, model: lastErr.model, status: out.status, via: "local", timing: lastErr.upstream._t ?? null, ttfMs: out.ttfMs, totalMs: out.totalMs, detail: out.detail ?? null });
-    evt("client-response", { requested, actual: lastErr.model, via: "local", fallback: false, status: out.status, reqId: handlerCtx.reqId });
-    // 最后一站：relay 超时/空轮留口路径都不写响应，这里没有上层，必须自己收尾
-    if (out.timedOut || out.heldOpen) {
-      terminal(res, out.detail?.exitReason === "empty-turn-hold"
-        ? "EMPTY_MODEL_RESPONSE: 空轮重拉与换候选全部用尽，仍无正文"
-        : out.detail?.upstreamError ? `upstream error: ${out.detail.upstreamError}` : `stream timed out after ${out.totalMs}ms`);
-    }
-    return true;
-  }
-  evt("result", { reqId: handlerCtx.reqId, model, status: lastErr?.status ?? 502, via: "none", timing: null });
-  evt("client-response", { requested, actual: model, via: "none", fallback: false, status: lastErr?.status ?? 502, reqId: handlerCtx.reqId });
-  done({ via: "none", status: lastErr?.status ?? 502, error: lastErr?.message || "all auto models failed" });
-  terminal(res, lastErr?.message);
-  return true;
-}
-
-export async function handleExhaustedAll({ res, body, lastErr, order, requested, handlerCtx, evt, logCall, mark, perf0, stages, deps = {} }) {
-  const { relay: relayImpl = relay } = deps;
-  evt("exhausted-all", { reqId: handlerCtx.reqId, lastModel: lastErr?.model ?? requested, lastStatus: lastErr?.status ?? 502, order });
-  logCall(lastErr?.model ?? requested, lastErr?.status ?? 502);
-  if (lastErr?.upstream) {
-    evt("relay-start", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-final", isStream: Boolean(body.stream) });
-    const out = await relayImpl(res, lastErr.upstream, body, {
-      onFirstChunk: (d) => mark(`ttf-${lastErr.model}`),
-      onDownstreamAbort: () => evt("client-abort", { reqId: handlerCtx.reqId, model: lastErr.model, totalMs: Math.round(performance.now() - perf0), stages: [...stages] }),
-    });
-    // 收场回收：与 local-exhausted 同理，须在 relay-done 事件快照 detail 之前（fix-talk-capture-frame-loss D4 / review P2-6）
-    try { captureTalkFlush(out?.detail?.talk); } catch {}
-    evt("relay-done", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-final", status: out.status, ttfMs: out.ttfMs, totalMs: out.totalMs, aborted: out.aborted, interrupted: out.interrupted ?? false, detail: out.detail ?? null });
-    // 同上：全链耗尽的最终转发也要留下问答原文
-    // 同上：本收尾点没有 attemptStartMs 可取（relay 直连、无尝试起点）→ 不传 attemptMs，
-    // recordRelayTalk/recordAgentLoop 内部按回退路径走 elapsed=relay 计时（与 relayMs 同值，spec 降级 scenario）；finishReason 同源传 out.detail.sawFinishReason。
-    try { recordRelayTalk({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-final", body, out, finishReason: out.detail?.sawFinishReason }); } catch {}
-    // 同上：全链耗尽的最终转发也要进语料（这条往往是「客户端只看到 502」时唯一的现场材料）
-    try { recordAgentLoop({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-final", hops: handlerCtx?.hops, body, out, sessionKey: handlerCtx?.sessionId, clientIp: handlerCtx?.clientIp }); } catch {} // attemptMs 缺省 → 回退 out.totalMs（见上行注释；缺 echo 的形状本期不补）
-    evt("result", { reqId: handlerCtx.reqId, model: lastErr.model, status: out.status, via: "local", timing: lastErr.upstream._t ?? null, ttfMs: out.ttfMs, totalMs: out.totalMs, detail: out.detail ?? null });
-    evt("client-response", { requested, actual: lastErr.model, via: "local", fallback: false, status: out.status, reqId: handlerCtx.reqId });
-    // 最后一站：relay 超时/空轮留口路径不写响应，这里没有上层 failover，必须自己收尾
-    if (out.timedOut || out.heldOpen) {
-      terminal(res, out.detail?.upstreamError ? `upstream error: ${out.detail.upstreamError}` : `stream timed out after ${out.totalMs}ms`);
-    }
-    return true;
-  }
-  evt("result", { reqId: handlerCtx.reqId, model: lastErr?.model ?? requested, status: lastErr?.status ?? 502, via: "none", timing: null });
-  evt("client-response", { requested, actual: lastErr?.model ?? requested, via: "none", fallback: false, status: lastErr?.status ?? 502, reqId: handlerCtx.reqId });
-  terminal(res, lastErr?.message);
-  return true;
-}
+// Note: 失败收尾四分支在 result 后补 client-response，与成功路径对账口径一致（result 条数 == client-response 条数）— 见 .agents/notes/implemented/bug-fix/2026-09-25-sdk-headers-timeout-and-failure-client-response.md
+import { relay } from "../stream.js";
+import { endHeldFailure } from "../stream-hold.js"; // 终局收场出口（502 JSON 或 SSE 错误帧 + [DONE]）
+import { json } from "../helpers.js";
+import { performance } from "node:perf_hooks";
+import { recordRelayTalk } from "../../talk-log.js"; // 环形对话日志：exhausted 收尾直连 relay，落盘点必须自己补一份
+import { recordAgentLoop } from "../../talk-full.js"; // agent 回路全量语料（talk/full）：与 talk.log 并排各调一次，见 openspec add-agent-loop-capture D1
+import { captureTalkFlush } from "../stream-scan.js"; // 收场回收缺尾换行的末行，record* 读桶前调用（openspec fix-talk-capture-frame-loss D4）
+
+// 最后一站的收场：relay 的「不写响应」路径（超时 / 空轮延后封口）都汇到这里，没有上层 failover 了，
+// 必须把响应「恰好一次」地关掉。形状由 endHeldFailure 按 headers 是否已 flush 决定
+// （未 flush → 502 JSON；已 flush 的 SSE → 错误帧 + [DONE]），这里不再自己 json() 打已 flush 的流。
+function terminal(res, message) {
+  endHeldFailure(res, message || "all auto models failed");
+}
+
+export async function handleExhaustedLocal({ res, body, lastErr, order, handlerCtx, evt, logCall, mark, perf0, stages, done, requested, useAuto, deps = {} }) {
+  const { relay: relayImpl = relay } = deps;
+  const model = lastErr?.model ?? handlerCtx.model;
+  evt("exhausted-local", { reqId: handlerCtx.reqId, lastModel: lastErr?.model ?? model, lastStatus: lastErr?.status ?? 502, order });
+  logCall(lastErr?.model ?? model, lastErr?.status ?? 502);
+  if (lastErr?.upstream) {
+    evt("relay-start", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-exhausted", isStream: Boolean(body.stream) });
+    const out = await relayImpl(res, lastErr.upstream, body, {
+      onFirstChunk: (d) => mark(`ttf-${lastErr.model}`),
+      onDownstreamAbort: () => evt("client-abort", { reqId: handlerCtx.reqId, model: lastErr.model, totalMs: Math.round(performance.now() - perf0), stages: [...stages] }),
+    });
+    // 收场回收（须在 relay-done 事件快照 detail 之前，review P2-6）：flush 缺尾换行的末行，语料与线上字节对齐（fix-talk-capture-frame-loss D4）
+    try { captureTalkFlush(out?.detail?.talk); } catch {}
+    evt("relay-done", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-exhausted", status: out.status, ttfMs: out.ttfMs, totalMs: out.totalMs, aborted: out.aborted, interrupted: out.interrupted ?? false, detail: out.detail ?? null });
+    // 绕过 relay-pipeline 的最后一站：对话日志照常落盘（正文只进 talk/*.log，不进 events.log）
+    // 本收尾点没有 attemptStartMs 可取（绕过 relay-pipeline 直连 relay）→ 不传 attemptMs，按回退路径走：
+    // elapsed=relay 内部计时（与 relayMs 同值，spec 降级 scenario）；finishReason 传 out.detail.sawFinishReason 与 3.3 同源。
+    try { recordRelayTalk({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-exhausted", body, out, finishReason: out.detail?.sawFinishReason }); } catch {}
+    // 回路语料另起一条独立 try：talk.log 是人读环形稿、capture 是机读全量语料，两者生死独立。
+    // hops 走 handlerCtx.hops（serial-trial 以 {...handlerCtx} 展开传进来，与 reqId 同源）；缺值时不兜 0 ——
+    // 交给 talk-full 落 null（「hops 未知」在语料里看得见，比伪造成 0 诚实），组员流量拦截靠真值。
+    try { recordAgentLoop({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-exhausted", hops: handlerCtx?.hops, body, out, sessionKey: handlerCtx?.sessionId, clientIp: handlerCtx?.clientIp }); } catch {} // attemptMs 缺省 → 回退 out.totalMs；缺 echo 的既有形状本期不补（tasks 3.4）
+    evt("result", { reqId: handlerCtx.reqId, model: lastErr.model, status: out.status, via: "local", timing: lastErr.upstream._t ?? null, ttfMs: out.ttfMs, totalMs: out.totalMs, detail: out.detail ?? null });
+    evt("client-response", { requested, actual: lastErr.model, via: "local", fallback: false, status: out.status, reqId: handlerCtx.reqId });
+    // 最后一站：relay 超时/空轮留口路径都不写响应，这里没有上层，必须自己收尾
+    if (out.timedOut || out.heldOpen) {
+      terminal(res, out.detail?.exitReason === "empty-turn-hold"
+        ? "EMPTY_MODEL_RESPONSE: 空轮重拉与换候选全部用尽，仍无正文"
+        : out.detail?.upstreamError ? `upstream error: ${out.detail.upstreamError}` : `stream timed out after ${out.totalMs}ms`);
+    }
+    return true;
+  }
+  evt("result", { reqId: handlerCtx.reqId, model, status: lastErr?.status ?? 502, via: "none", timing: null });
+  evt("client-response", { requested, actual: model, via: "none", fallback: false, status: lastErr?.status ?? 502, reqId: handlerCtx.reqId });
+  done({ via: "none", status: lastErr?.status ?? 502, error: lastErr?.message || "all auto models failed" });
+  terminal(res, lastErr?.message);
+  return true;
+}
+
+export async function handleExhaustedAll({ res, body, lastErr, order, requested, handlerCtx, evt, logCall, mark, perf0, stages, deps = {} }) {
+  const { relay: relayImpl = relay } = deps;
+  evt("exhausted-all", { reqId: handlerCtx.reqId, lastModel: lastErr?.model ?? requested, lastStatus: lastErr?.status ?? 502, order });
+  logCall(lastErr?.model ?? requested, lastErr?.status ?? 502);
+  if (lastErr?.upstream) {
+    evt("relay-start", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-final", isStream: Boolean(body.stream) });
+    const out = await relayImpl(res, lastErr.upstream, body, {
+      onFirstChunk: (d) => mark(`ttf-${lastErr.model}`),
+      onDownstreamAbort: () => evt("client-abort", { reqId: handlerCtx.reqId, model: lastErr.model, totalMs: Math.round(performance.now() - perf0), stages: [...stages] }),
+    });
+    // 收场回收：与 local-exhausted 同理，须在 relay-done 事件快照 detail 之前（fix-talk-capture-frame-loss D4 / review P2-6）
+    try { captureTalkFlush(out?.detail?.talk); } catch {}
+    evt("relay-done", { reqId: handlerCtx.reqId, model: lastErr.model, via: "local-final", status: out.status, ttfMs: out.ttfMs, totalMs: out.totalMs, aborted: out.aborted, interrupted: out.interrupted ?? false, detail: out.detail ?? null });
+    // 同上：全链耗尽的最终转发也要留下问答原文
+    // 同上：本收尾点没有 attemptStartMs 可取（relay 直连、无尝试起点）→ 不传 attemptMs，
+    // recordRelayTalk/recordAgentLoop 内部按回退路径走 elapsed=relay 计时（与 relayMs 同值，spec 降级 scenario）；finishReason 同源传 out.detail.sawFinishReason。
+    try { recordRelayTalk({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-final", body, out, finishReason: out.detail?.sawFinishReason }); } catch {}
+    // 同上：全链耗尽的最终转发也要进语料（这条往往是「客户端只看到 502」时唯一的现场材料）
+    try { recordAgentLoop({ reqId: handlerCtx.reqId, api: handlerCtx?.api, model: lastErr.model, via: "local-final", hops: handlerCtx?.hops, body, out, sessionKey: handlerCtx?.sessionId, clientIp: handlerCtx?.clientIp }); } catch {} // attemptMs 缺省 → 回退 out.totalMs（见上行注释；缺 echo 的形状本期不补）
+    evt("result", { reqId: handlerCtx.reqId, model: lastErr.model, status: out.status, via: "local", timing: lastErr.upstream._t ?? null, ttfMs: out.ttfMs, totalMs: out.totalMs, detail: out.detail ?? null });
+    evt("client-response", { requested, actual: lastErr.model, via: "local", fallback: false, status: out.status, reqId: handlerCtx.reqId });
+    // 最后一站：relay 超时/空轮留口路径不写响应，这里没有上层 failover，必须自己收尾
+    if (out.timedOut || out.heldOpen) {
+      terminal(res, out.detail?.upstreamError ? `upstream error: ${out.detail.upstreamError}` : `stream timed out after ${out.totalMs}ms`);
+    }
+    return true;
+  }
+  evt("result", { reqId: handlerCtx.reqId, model: lastErr?.model ?? requested, status: lastErr?.status ?? 502, via: "none", timing: null });
+  evt("client-response", { requested, actual: lastErr?.model ?? requested, via: "none", fallback: false, status: lastErr?.status ?? 502, reqId: handlerCtx.reqId });
+  terminal(res, lastErr?.message);
+  return true;
+}