mslxdff 0.1.203 → 0.1.207

package/src/thinking-effort.js

@@ -1,67 +1,67 @@
-// 思考档位词表的单一来源（change: fix-thinking-effort-passthrough）。
-// 入站翻译层保留档位字段后，各家供应商整形器都从这里读，避免像过去那样五处各写各的映射。
-// 契约：
-//  - effortFromBody(body)：按固定优先级取出客户端声明的档位原始串（不解释语义）。
-//  - isEffortOff(v)：单个值是否表示"关思考"。
-//  - isReasoningEnabled(effort, fallback)：布尔家（qoder/qwenwork 系）的推导。
-//  - effortLevelFromBody(body)：只取「真档位载体」（reasoning_effort ＞ reasoningEffort ＞ effort），不含 thinking.type 开关。
-// 关断值（off/none/disabled，大小写不敏感）**最高优先**：误开思考烧 token 不可逆，误关只是少想一点。
-
-const OFF_VALUES = new Set(["off", "none", "disabled"]);
-
-/** 单个档位值是否表示"关思考"。非字符串/空串/null 一律不算关。 */
-export function isEffortOff(v) {
-  return OFF_VALUES.has(String(v ?? "").trim().toLowerCase());
-}
-
-/** 取对象里的字符串档位值（非字符串返回空串）。 */
-function str(v) {
-  return typeof v === "string" ? v.trim() : v == null ? "" : String(v).trim();
-}
-
-/** 取 thinking 对象的 type（非对象返回空串）。 */
-function thinkingType(th) {
-  return th && typeof th === "object" ? str(th.type) : "";
-}
-
-/**
- * 客户端声明的思考档位，优先级：
- *   extra_body.thinking.type > reasoning_effort > reasoningEffort > effort > thinking.type
- * 任一候选是关断值即返回该值（关断最高优先）；否则返回首个非空候选；全空返回 ""。
- */
-export function effortFromBody(body) {
-  const b = body && typeof body === "object" ? body : {};
-  const candidates = [
-    thinkingType(b.extra_body?.thinking),
-    str(b.reasoning_effort),
-    str(b.reasoningEffort),
-    str(b.effort),
-    thinkingType(b.thinking),
-  ];
-  for (const c of candidates) if (c && isEffortOff(c)) return c;
-  return candidates.find((c) => c) || "";
-}
-
-/**
- * 布尔家推导：有档位时"关断→false、其余→true"；无档位时回退到调用方给的默认（如模型目录结论）。
- */
-export function isReasoningEnabled(effort, fallback = false) {
-  const v = str(effort);
-  if (!v) return fallback === true;
-  return !isEffortOff(v);
-}
-
-const LEVEL_KEYS = ["reasoning_effort", "reasoningEffort", "effort"];
-
-/**
- * 只从「真档位载体」取级别串（不含 `thinking.type` 这类开关载体——它的 "enabled"/"disabled" 不是档位级别，
- * 拿去当 `reasoning_effort` 发上游必被拒）。空串/纯空白一律不算声明。全空返回 ""。
- */
-export function effortLevelFromBody(body) {
-  const b = body && typeof body === "object" ? body : {};
-  for (const k of LEVEL_KEYS) {
-    const v = str(b[k]);
-    if (v) return v;
-  }
-  return "";
-}
+// 思考档位词表的单一来源（change: fix-thinking-effort-passthrough）。
+// 入站翻译层保留档位字段后，各家供应商整形器都从这里读，避免像过去那样五处各写各的映射。
+// 契约：
+//  - effortFromBody(body)：按固定优先级取出客户端声明的档位原始串（不解释语义）。
+//  - isEffortOff(v)：单个值是否表示"关思考"。
+//  - isReasoningEnabled(effort, fallback)：布尔家（qoder/qwenwork 系）的推导。
+//  - effortLevelFromBody(body)：只取「真档位载体」（reasoning_effort ＞ reasoningEffort ＞ effort），不含 thinking.type 开关。
+// 关断值（off/none/disabled，大小写不敏感）**最高优先**：误开思考烧 token 不可逆，误关只是少想一点。
+
+const OFF_VALUES = new Set(["off", "none", "disabled"]);
+
+/** 单个档位值是否表示"关思考"。非字符串/空串/null 一律不算关。 */
+export function isEffortOff(v) {
+  return OFF_VALUES.has(String(v ?? "").trim().toLowerCase());
+}
+
+/** 取对象里的字符串档位值（非字符串返回空串）。 */
+function str(v) {
+  return typeof v === "string" ? v.trim() : v == null ? "" : String(v).trim();
+}
+
+/** 取 thinking 对象的 type（非对象返回空串）。 */
+function thinkingType(th) {
+  return th && typeof th === "object" ? str(th.type) : "";
+}
+
+/**
+ * 客户端声明的思考档位，优先级：
+ *   extra_body.thinking.type > reasoning_effort > reasoningEffort > effort > thinking.type
+ * 任一候选是关断值即返回该值（关断最高优先）；否则返回首个非空候选；全空返回 ""。
+ */
+export function effortFromBody(body) {
+  const b = body && typeof body === "object" ? body : {};
+  const candidates = [
+    thinkingType(b.extra_body?.thinking),
+    str(b.reasoning_effort),
+    str(b.reasoningEffort),
+    str(b.effort),
+    thinkingType(b.thinking),
+  ];
+  for (const c of candidates) if (c && isEffortOff(c)) return c;
+  return candidates.find((c) => c) || "";
+}
+
+/**
+ * 布尔家推导：有档位时"关断→false、其余→true"；无档位时回退到调用方给的默认（如模型目录结论）。
+ */
+export function isReasoningEnabled(effort, fallback = false) {
+  const v = str(effort);
+  if (!v) return fallback === true;
+  return !isEffortOff(v);
+}
+
+const LEVEL_KEYS = ["reasoning_effort", "reasoningEffort", "effort"];
+
+/**
+ * 只从「真档位载体」取级别串（不含 `thinking.type` 这类开关载体——它的 "enabled"/"disabled" 不是档位级别，
+ * 拿去当 `reasoning_effort` 发上游必被拒）。空串/纯空白一律不算声明。全空返回 ""。
+ */
+export function effortLevelFromBody(body) {
+  const b = body && typeof body === "object" ? body : {};
+  for (const k of LEVEL_KEYS) {
+    const v = str(b[k]);
+    if (v) return v;
+  }
+  return "";
+}

package/src/time.js

@@ -1,106 +1,106 @@
-import { loadTimezone } from "./state/schemas/timezone.js";
-
-const DEFAULT_TZ = "Asia/Shanghai";
-
-function getTimezone() {
-  try { return loadTimezone() || DEFAULT_TZ; } catch { return DEFAULT_TZ; }
-}
-
-function tzParts(d, tz) {
-  const zone = tz || getTimezone();
-  const date = d instanceof Date ? d : new Date(d);
-  try {
-    const fmt = new Intl.DateTimeFormat("en-GB", {
-      timeZone: zone,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      hour: "2-digit",
-      minute: "2-digit",
-      second: "2-digit",
-      hour12: false,
-    });
-    const parts = fmt.formatToParts(date);
-    const m = {};
-    for (const p of parts) m[p.type] = p.value;
-    return m; // {year, month, day, hour, minute, second}
-  } catch {
-    // 回退上海
-    const fmt = new Intl.DateTimeFormat("en-GB", {
-      timeZone: DEFAULT_TZ,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      hour: "2-digit",
-      minute: "2-digit",
-      second: "2-digit",
-      hour12: false,
-    });
-    const parts = fmt.formatToParts(date);
-    const m = {};
-    for (const p of parts) m[p.type] = p.value;
-    return m;
-  }
-}
-
-function shanghaiParts(d) { return tzParts(d, getTimezone()); }
-
-// "MM-DD HH:mm:ss" e.g. "08-27 15:07:14"
-export function fmtShanghai(isoOrTs) {
-  if (isoOrTs == null) return "-";
-  try {
-    const p = shanghaiParts(isoOrTs);
-    return `${p.month}-${p.day} ${p.hour}:${p.minute}:${p.second}`;
-  } catch {
-    return "-";
-  }
-}
-
-// "YYYY-MM-DD HH:mm" e.g. "2026-08-27 15:07"
-export function fmtShanghaiYMDHM(isoOrTs) {
-  if (isoOrTs == null) return "-";
-  try {
-    const p = shanghaiParts(isoOrTs);
-    return `${p.year}-${p.month}-${p.day} ${p.hour}:${p.minute}`;
-  } catch {
-    return "-";
-  }
-}
-
-// "YYYY-MM-DD HH:mm:ss" e.g. "2026-08-27 15:07:14"
-export function fmtShanghaiYMDHMS(isoOrTs) {
-  if (isoOrTs == null) return "-";
-  try {
-    const p = shanghaiParts(isoOrTs);
-    return `${p.year}-${p.month}-${p.day} ${p.hour}:${p.minute}:${p.second}`;
-  } catch {
-    return "-";
-  }
-}
-
-// "HH:mm:ss" e.g. "15:07:14"
-export function fmtShanghaiHMS(isoOrTs) {
-  if (isoOrTs == null) return "--:--:--";
-  try {
-    const p = shanghaiParts(isoOrTs);
-    return `${p.hour}:${p.minute}:${p.second}`;
-  } catch {
-    return "--:--:--";
-  }
-}
-
-// 当前上海时间 "YYYY-MM-DD HH:mm" 用于 prompt
-export function nowShanghaiYMDHM() {
-  return fmtShanghaiYMDHM(new Date());
-}
-
-// 兼容：传入 Date 或 ts 或 ISO，都返回 "MM-DD HH:mm:ss"
-export function fmtTsShanghai(iso) {
-  return fmtShanghai(iso);
-}
-
-export { getTimezone };
-// 通用别名（实际已可配置，不再仅限上海）
-export const fmtYMDHMS = fmtShanghaiYMDHMS;
-export const fmtYMDHM = fmtShanghaiYMDHM;
-export const fmtHMS = fmtShanghaiHMS;
+import { loadTimezone } from "./state/schemas/timezone.js";
+
+const DEFAULT_TZ = "Asia/Shanghai";
+
+function getTimezone() {
+  try { return loadTimezone() || DEFAULT_TZ; } catch { return DEFAULT_TZ; }
+}
+
+function tzParts(d, tz) {
+  const zone = tz || getTimezone();
+  const date = d instanceof Date ? d : new Date(d);
+  try {
+    const fmt = new Intl.DateTimeFormat("en-GB", {
+      timeZone: zone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false,
+    });
+    const parts = fmt.formatToParts(date);
+    const m = {};
+    for (const p of parts) m[p.type] = p.value;
+    return m; // {year, month, day, hour, minute, second}
+  } catch {
+    // 回退上海
+    const fmt = new Intl.DateTimeFormat("en-GB", {
+      timeZone: DEFAULT_TZ,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false,
+    });
+    const parts = fmt.formatToParts(date);
+    const m = {};
+    for (const p of parts) m[p.type] = p.value;
+    return m;
+  }
+}
+
+function shanghaiParts(d) { return tzParts(d, getTimezone()); }
+
+// "MM-DD HH:mm:ss" e.g. "08-27 15:07:14"
+export function fmtShanghai(isoOrTs) {
+  if (isoOrTs == null) return "-";
+  try {
+    const p = shanghaiParts(isoOrTs);
+    return `${p.month}-${p.day} ${p.hour}:${p.minute}:${p.second}`;
+  } catch {
+    return "-";
+  }
+}
+
+// "YYYY-MM-DD HH:mm" e.g. "2026-08-27 15:07"
+export function fmtShanghaiYMDHM(isoOrTs) {
+  if (isoOrTs == null) return "-";
+  try {
+    const p = shanghaiParts(isoOrTs);
+    return `${p.year}-${p.month}-${p.day} ${p.hour}:${p.minute}`;
+  } catch {
+    return "-";
+  }
+}
+
+// "YYYY-MM-DD HH:mm:ss" e.g. "2026-08-27 15:07:14"
+export function fmtShanghaiYMDHMS(isoOrTs) {
+  if (isoOrTs == null) return "-";
+  try {
+    const p = shanghaiParts(isoOrTs);
+    return `${p.year}-${p.month}-${p.day} ${p.hour}:${p.minute}:${p.second}`;
+  } catch {
+    return "-";
+  }
+}
+
+// "HH:mm:ss" e.g. "15:07:14"
+export function fmtShanghaiHMS(isoOrTs) {
+  if (isoOrTs == null) return "--:--:--";
+  try {
+    const p = shanghaiParts(isoOrTs);
+    return `${p.hour}:${p.minute}:${p.second}`;
+  } catch {
+    return "--:--:--";
+  }
+}
+
+// 当前上海时间 "YYYY-MM-DD HH:mm" 用于 prompt
+export function nowShanghaiYMDHM() {
+  return fmtShanghaiYMDHM(new Date());
+}
+
+// 兼容：传入 Date 或 ts 或 ISO，都返回 "MM-DD HH:mm:ss"
+export function fmtTsShanghai(iso) {
+  return fmtShanghai(iso);
+}
+
+export { getTimezone };
+// 通用别名（实际已可配置，不再仅限上海）
+export const fmtYMDHMS = fmtShanghaiYMDHMS;
+export const fmtYMDHM = fmtShanghaiYMDHM;
+export const fmtHMS = fmtShanghaiHMS;

package/src/timeline.js

@@ -1,26 +1,26 @@
-// 人读请求时间线：只输出状态/耗时/出口，不输出 prompt、响应正文或凭据。
-// Note: 渲染口径与失败路径 client-response 对账（result 与 client-response 条数须相等）— 见 .agents/notes/implemented/feature/2026-09-25-model-trace-log.md
-function hostPort(value) {
-  try { const u = new URL(String(value)); return u.port ? `${u.hostname}:${u.port}` : u.hostname; } catch { return String(value || "-").slice(0, 80); }
-}
-function short(value, n = 90) {
-  const s = String(value ?? "").replace(/\s+/g, " ").trim();
-  return !s ? "-" : s.length > n ? `${s.slice(0, n - 1)}…` : s;
-}
-function outcome(status, reason) {
-  if (status == null) return reason ? `- ${short(reason)}` : "-";
-  return `${status}${reason ? ` ${short(reason)}` : ""}`;
-}
-
- export function formatTimeline({ reqId, model, direct = [], peers = [], retries = 0, retryResult = null, result = null, totalMs = 0 } = {}) {
-  const d = direct.length ? direct[direct.length - 1] : null;
-  const ps = peers.map((p) => `[peer=${hostPort(p.peer)} ${p.ok ? "win" : "fail"} ${p.latencyMs != null ? `${p.latencyMs}ms` : "timing-"} ${short(p.message || p.status || "", 70)}]`);
-  const r = result || {};
-  const detail = r.detail || {};
-  const res = r.status == null ? "-" : `${r.status}${detail.sawFinishReason ? ` ${detail.sawFinishReason}` : ""}${detail.toolCalls ? ` tools=${detail.toolCalls}` : ""}${detail.chars != null ? ` chars=${detail.chars}` : ""}${detail.interrupted ? " interrupted=1" : ""}${detail.timedOut ? " timedOut=1" : ""}`;
-  const directText = d ? outcome(d.status, d.reason) : "-";
-  // retry= 次数（保持既有 token 可 grep）；win=1 重试后救回，lost=1 重试用尽仍零正文。
-  const _rc = retryResult === "ok" ? " [retry_win=1]" : retryResult === "lost" ? " [retry_lost=1]" : "";
-  const retryTag = (retries || retryResult) ? ` [retry=${retries || 0}]${_rc}` : "";
-  return `[req=${reqId || "-"}] [model=${model || "-"}] [direct=${directText}]${ps.length ? ` ${ps.join(" ")}` : ""}${retryTag} [result=${res}] [total=${Math.max(0, Math.round(Number(totalMs) || 0))}ms]`;
-}
+// 人读请求时间线：只输出状态/耗时/出口，不输出 prompt、响应正文或凭据。
+// Note: 渲染口径与失败路径 client-response 对账（result 与 client-response 条数须相等）— 见 .agents/notes/implemented/feature/2026-09-25-model-trace-log.md
+function hostPort(value) {
+  try { const u = new URL(String(value)); return u.port ? `${u.hostname}:${u.port}` : u.hostname; } catch { return String(value || "-").slice(0, 80); }
+}
+function short(value, n = 90) {
+  const s = String(value ?? "").replace(/\s+/g, " ").trim();
+  return !s ? "-" : s.length > n ? `${s.slice(0, n - 1)}…` : s;
+}
+function outcome(status, reason) {
+  if (status == null) return reason ? `- ${short(reason)}` : "-";
+  return `${status}${reason ? ` ${short(reason)}` : ""}`;
+}
+
+ export function formatTimeline({ reqId, model, direct = [], peers = [], retries = 0, retryResult = null, result = null, totalMs = 0 } = {}) {
+  const d = direct.length ? direct[direct.length - 1] : null;
+  const ps = peers.map((p) => `[peer=${hostPort(p.peer)} ${p.ok ? "win" : "fail"} ${p.latencyMs != null ? `${p.latencyMs}ms` : "timing-"} ${short(p.message || p.status || "", 70)}]`);
+  const r = result || {};
+  const detail = r.detail || {};
+  const res = r.status == null ? "-" : `${r.status}${detail.sawFinishReason ? ` ${detail.sawFinishReason}` : ""}${detail.toolCalls ? ` tools=${detail.toolCalls}` : ""}${detail.chars != null ? ` chars=${detail.chars}` : ""}${detail.interrupted ? " interrupted=1" : ""}${detail.timedOut ? " timedOut=1" : ""}`;
+  const directText = d ? outcome(d.status, d.reason) : "-";
+  // retry= 次数（保持既有 token 可 grep）；win=1 重试后救回，lost=1 重试用尽仍零正文。
+  const _rc = retryResult === "ok" ? " [retry_win=1]" : retryResult === "lost" ? " [retry_lost=1]" : "";
+  const retryTag = (retries || retryResult) ? ` [retry=${retries || 0}]${_rc}` : "";
+  return `[req=${reqId || "-"}] [model=${model || "-"}] [direct=${directText}]${ps.length ? ` ${ps.join(" ")}` : ""}${retryTag} [result=${res}] [total=${Math.max(0, Math.round(Number(totalMs) || 0))}ms]`;
+}

package/src/transport/index.js

@@ -4,7 +4,7 @@ import { createSseParser } from "./sse.js";
 import { createPool } from "./pool.js";
 import { compatFetch, getUndici } from "../compat.js";
 
-const UndiciFetch = getUndici().fetch;
+const UndiciFetch = getUndici().fetch;
 
 const DEFAULT_RETRY = {
   network: { attempts: 2, delayMs: 300 },

package/src/upstream-engine/index.js

@@ -1,74 +1,74 @@
-// 上游引擎选择（ADR-0017）：sdk=AI SDK wire 层（缺省），legacy=原实现（显式指定或 SDK 装载失败回退）。
-// Note: 缺省即 sdk；chat 类走 /chat/completions（@ai-sdk/openai-compatible），
-// responses 类（muse-spark*）走 /responses（@ai-sdk/openai）；非流式与 anon 重试委派 legacy，
-// SDK 不可用自动回退并告警一次 — 见 .scratch/ai-sdk-upstream/{SPEC.md,SPEC-p4-turnon.md,SPEC-p3-responses.md} 与 docs/adr/0017
-import { createUpstreamClient, createOpencodeHeaderBuilder } from "../upstream.js";
-import { isResponsesModel } from "../upstream-responses.js";
-import { isFreeModel } from "../models.js";
-import { ensureFreeLaneShape } from "../free-lane.js";
-import { createSdkChat } from "./sdk/chat.js";
-import { createSdkResponses } from "./sdk/responses.js";
-import { dispatcherFetch } from "./sdk/attempt.js";
-import { resolveEngineMode } from "./mode.js";
-
-export { resolveEngineMode };
-
-export function createUpstreamEngine(opts = {}) {
-  const legacy = createUpstreamClient(opts);
-  const env = opts.env ?? process.env;
-  if (resolveEngineMode(env) !== "sdk") return legacy;
-
-  const baseUrl = opts.baseUrl || process.env.UPSTREAM_BASE_URL || "https://opencode.ai";
-  const sdkFactory = opts.sdkFactory ?? createSdkChat;
-  const responsesFactory = opts.responsesFactory ?? createSdkResponses;
-  const { buildHeaders, anonFirst } = createOpencodeHeaderBuilder({
-    authToken: opts.authToken || process.env.UPSTREAM_AUTH_TOKEN || "public",
-  });
-  const dispatcher = legacy.dispatcher;
-  const fetchImpl = dispatcher ? dispatcherFetch(dispatcher) : undefined;
-  const sdk = sdkFactory({ baseUrl, buildHeaders, providerName: "opencode", fetchImpl });
-  const responses = responsesFactory({ baseUrl, buildHeaders, providerName: "opencode", fetchImpl });
-
-  let sdkDown = false;
-  let logged = false;
-
-  async function chat(body) {
-    // zen 免费层 agent 形状门禁（2026-09-18）：SDK 流式通道不经 legacy.chat，必须在这里补形状。
-    // 非流式先委派 legacy（它在自己内部注入并把 SSE 聚合回 JSON，避免这里先改 stream 导致误判）。
-    const wantsStream = body?.stream !== false;
-    if (sdkDown || !wantsStream) return legacy.chat(body);
-    if (isFreeModel(body?.model)) ensureFreeLaneShape(body);
-    const useResponses = isResponsesModel(body?.model);
-    try {
-      const res = useResponses ? await responses.chat(body) : await sdk.chat(body);
-      if (!logged) {
-        logged = true;
-        const via = useResponses ? "@ai-sdk/openai · responses" : "@ai-sdk/openai-compatible · chat";
-        try { console.error(`[upstream-engine] sdk 引擎生效（${via}）`); } catch {}
-      }
-      // 保留 legacy 的匿名重试语义（仅 !anonFirst 配置下存在）；G1a 起 free-429 的**请求内 v6 换出口**
-      // 也走这条委派——重试环在 legacy.chat 里，SDK 通道撞 429 不委派就等于把换出口的额度白白留给下一发。
-      // 无 rotateFor 的 dispatcher（直连/WARP）且 anonFirst 时维持旧行为（不重复打流量）。
-      if (res.status === 429 && isFreeModel(body?.model) && (!anonFirst || typeof dispatcher?.rotateFor === "function")) return legacy.chat(body);
-      return res;
-    } catch (e) {
-      if (e && e._sdkLoadFailed) {
-        sdkDown = true;
-        try { console.error(`[upstream-engine] ${e.message} — 回退 legacy 引擎`); } catch {}
-        return legacy.chat(body);
-      }
-      throw e;
-    }
-  }
-
-  return {
-    chat,
-    preheat: (args) => legacy.preheat(args),
-    close: () => legacy.close(),
-    headers: legacy.headers,
-    buildHeaders: legacy.buildHeaders,
-    get dispatcher() { return legacy.dispatcher; },
-    get agent() { return legacy.agent; },
-    [Symbol.asyncDispose]: () => legacy.close(),
-  };
-}
+// 上游引擎选择（ADR-0017）：sdk=AI SDK wire 层（缺省），legacy=原实现（显式指定或 SDK 装载失败回退）。
+// Note: 缺省即 sdk；chat 类走 /chat/completions（@ai-sdk/openai-compatible），
+// responses 类（muse-spark*）走 /responses（@ai-sdk/openai）；非流式与 anon 重试委派 legacy，
+// SDK 不可用自动回退并告警一次 — 见 .scratch/ai-sdk-upstream/{SPEC.md,SPEC-p4-turnon.md,SPEC-p3-responses.md} 与 docs/adr/0017
+import { createUpstreamClient, createOpencodeHeaderBuilder } from "../upstream.js";
+import { isResponsesModel } from "../upstream-responses.js";
+import { isFreeModel } from "../models.js";
+import { ensureFreeLaneShape } from "../free-lane.js";
+import { createSdkChat } from "./sdk/chat.js";
+import { createSdkResponses } from "./sdk/responses.js";
+import { dispatcherFetch } from "./sdk/attempt.js";
+import { resolveEngineMode } from "./mode.js";
+
+export { resolveEngineMode };
+
+export function createUpstreamEngine(opts = {}) {
+  const legacy = createUpstreamClient(opts);
+  const env = opts.env ?? process.env;
+  if (resolveEngineMode(env) !== "sdk") return legacy;
+
+  const baseUrl = opts.baseUrl || process.env.UPSTREAM_BASE_URL || "https://opencode.ai";
+  const sdkFactory = opts.sdkFactory ?? createSdkChat;
+  const responsesFactory = opts.responsesFactory ?? createSdkResponses;
+  const { buildHeaders, anonFirst } = createOpencodeHeaderBuilder({
+    authToken: opts.authToken || process.env.UPSTREAM_AUTH_TOKEN || "public",
+  });
+  const dispatcher = legacy.dispatcher;
+  const fetchImpl = dispatcher ? dispatcherFetch(dispatcher) : undefined;
+  const sdk = sdkFactory({ baseUrl, buildHeaders, providerName: "opencode", fetchImpl });
+  const responses = responsesFactory({ baseUrl, buildHeaders, providerName: "opencode", fetchImpl });
+
+  let sdkDown = false;
+  let logged = false;
+
+  async function chat(body) {
+    // zen 免费层 agent 形状门禁（2026-09-18）：SDK 流式通道不经 legacy.chat，必须在这里补形状。
+    // 非流式先委派 legacy（它在自己内部注入并把 SSE 聚合回 JSON，避免这里先改 stream 导致误判）。
+    const wantsStream = body?.stream !== false;
+    if (sdkDown || !wantsStream) return legacy.chat(body);
+    if (isFreeModel(body?.model)) ensureFreeLaneShape(body);
+    const useResponses = isResponsesModel(body?.model);
+    try {
+      const res = useResponses ? await responses.chat(body) : await sdk.chat(body);
+      if (!logged) {
+        logged = true;
+        const via = useResponses ? "@ai-sdk/openai · responses" : "@ai-sdk/openai-compatible · chat";
+        try { console.error(`[upstream-engine] sdk 引擎生效（${via}）`); } catch {}
+      }
+      // 保留 legacy 的匿名重试语义（仅 !anonFirst 配置下存在）；G1a 起 free-429 的**请求内 v6 换出口**
+      // 也走这条委派——重试环在 legacy.chat 里，SDK 通道撞 429 不委派就等于把换出口的额度白白留给下一发。
+      // 无 rotateFor 的 dispatcher（直连/WARP）且 anonFirst 时维持旧行为（不重复打流量）。
+      if (res.status === 429 && isFreeModel(body?.model) && (!anonFirst || typeof dispatcher?.rotateFor === "function")) return legacy.chat(body);
+      return res;
+    } catch (e) {
+      if (e && e._sdkLoadFailed) {
+        sdkDown = true;
+        try { console.error(`[upstream-engine] ${e.message} — 回退 legacy 引擎`); } catch {}
+        return legacy.chat(body);
+      }
+      throw e;
+    }
+  }
+
+  return {
+    chat,
+    preheat: (args) => legacy.preheat(args),
+    close: () => legacy.close(),
+    headers: legacy.headers,
+    buildHeaders: legacy.buildHeaders,
+    get dispatcher() { return legacy.dispatcher; },
+    get agent() { return legacy.agent; },
+    [Symbol.asyncDispose]: () => legacy.close(),
+  };
+}

package/src/upstream-engine/mode.js

@@ -1,15 +1,15 @@
-// 引擎模式解析（纯函数，零依赖）：缺省 sdk，legacy/关闭词回退原实现。
-// 供应商级开关未设置时继承全局总闸，使 MSLXDFF_UPSTREAM_ENGINE=legacy 成为一键熔断。
-// defaultMode：调用方可自定缺省（一般无需传，保持 sdk）；显式 env（供应商级或全局）始终优先。
-// 供 upstream-engine/index.js（opencode 上游）与 providers/workbuddy/chat.js 共用。
-// 见 docs/adr/0017。
-const ENGINE_OFF_WORDS = new Set(["0", "off", "false", "no", "disable", "disabled"]);
-
-export function resolveEngineMode(env = process.env, varName = "MSLXDFF_UPSTREAM_ENGINE", defaultMode = "sdk") {
-  const pick = (name) => String(env?.[name] ?? "").trim().toLowerCase();
-  let raw = pick(varName);
-  if (!raw && varName !== "MSLXDFF_UPSTREAM_ENGINE") raw = pick("MSLXDFF_UPSTREAM_ENGINE");
-  if (raw === "legacy" || ENGINE_OFF_WORDS.has(raw)) return "legacy";
-  if (raw) return "sdk";
-  return defaultMode === "legacy" ? "legacy" : "sdk";
-}
+// 引擎模式解析（纯函数，零依赖）：缺省 sdk，legacy/关闭词回退原实现。
+// 供应商级开关未设置时继承全局总闸，使 MSLXDFF_UPSTREAM_ENGINE=legacy 成为一键熔断。
+// defaultMode：调用方可自定缺省（一般无需传，保持 sdk）；显式 env（供应商级或全局）始终优先。
+// 供 upstream-engine/index.js（opencode 上游）与 providers/workbuddy/chat.js 共用。
+// 见 docs/adr/0017。
+const ENGINE_OFF_WORDS = new Set(["0", "off", "false", "no", "disable", "disabled"]);
+
+export function resolveEngineMode(env = process.env, varName = "MSLXDFF_UPSTREAM_ENGINE", defaultMode = "sdk") {
+  const pick = (name) => String(env?.[name] ?? "").trim().toLowerCase();
+  let raw = pick(varName);
+  if (!raw && varName !== "MSLXDFF_UPSTREAM_ENGINE") raw = pick("MSLXDFF_UPSTREAM_ENGINE");
+  if (raw === "legacy" || ENGINE_OFF_WORDS.has(raw)) return "legacy";
+  if (raw) return "sdk";
+  return defaultMode === "legacy" ? "legacy" : "sdk";
+}