mslxdff 0.1.118 → 0.1.120

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.118",
+  "version": "0.1.120",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {

package/src/providers/workbuddy/chat.js

@@ -5,6 +5,7 @@ import { createTransport } from "../../transport/index.js";
 import { reshapeWorkbuddySse } from "./reshape.js";
 import { attemptOnceSdk } from "./sdk-chat.js";
 import { sanitizeToolSequence } from "./sanitize-tools.js";
+import { rewriteWorkbuddyPayload } from "./payload.js";
 import { resolveEngineMode } from "../../upstream-engine/mode.js";
 
 function buildAuthHeaders(key, auth) {
@@ -99,12 +100,16 @@ export function createChatService({
   // （局部 MSLXDFF_WORKBUDDY_SDK，未设则继承全局 MSLXDFF_UPSTREAM_ENGINE）回退原生 transport；
   // 不可用（Node16/未安装）自动回退并告警一次。上层轮换/刷新/reshape 全链复用。
   // Note: 为什么默认 SDK、翻译层代价与回退语义 — 见 .agents/notes/implemented/feature/2026-09-12-workbuddy-sdk-channel.md
-  const engineMode = resolveEngineMode(process.env, "MSLXDFF_WORKBUDDY_SDK");
+  // 上游非标字段（thinking / reasoning_effort / reasoning_content / tool_choice 字符串）不依赖 SDK 白名单：
+  // payload.js 前置语义改写 + AI SDK providerOptions 透传（非白名单 key 原样 spread 进 body，2.0.41 实测）。
+  // 序列化/流式/错误映射仍全部交 AI SDK；原生 transport 仅作 SDK 不可用时的回退。v0.1.120 实测见 .scratch/probe-sdk-body.mjs。
+  const engineMode = resolveEngineMode(process.env, "MSLXDFF_WORKBUDDY_SDK", "sdk");
   let sdkFallbackLogged = false;
   async function fetchOnce(url, body, key, auth) {
+    const payload = rewriteWorkbuddyPayload(body);
     if (engineMode === "sdk") {
       try {
-        return await attemptOnceSdk({ url, body, key, auth, buildHeaders: buildAuthHeaders });
+        return await attemptOnceSdk({ url, body: payload, key, auth, buildHeaders: buildAuthHeaders });
       } catch (e) {
         if (!e || !e._sdkLoadFailed) throw e;
         if (!sdkFallbackLogged) {
@@ -113,7 +118,7 @@ export function createChatService({
         }
       }
     }
-    return transport.request({ url, headers: buildAuthHeaders(key, auth), body: { ...body, stream: true }, stream: true });
+    return transport.request({ url, headers: buildAuthHeaders(key, auth), body: { ...payload, stream: true }, stream: true });
   }
 
   async function withRefresh(url, body, key, auth) {

package/src/providers/workbuddy/payload.js

@@ -0,0 +1,98 @@
+// workbuddy 出站 payload 改写（逆向官方客户端行为，参考 Sliverkiss/workbuddy2api 的 payload.go/thinking.go）：
+//  1. developer → system：上游 role 白名单不含 developer（命中 400 code=11128）
+//  2. tool_choice 归一：上游该字段是 string 类型，对象形式 400 code=11101（none 连带删 tools/functions）
+//  3. DeepSeek thinking 注入：必须显式 thinking.type=enabled + 有 effort 档位，否则上游按不思考应答；
+//     显式 disabled 尊重并删 effort；缺档补默认 "high"
+//  4. DeepSeek reasoning_content 回填：会话内任一 assistant 带 reasoning 痕迹时，
+//     所有 assistant 必须带 reasoning_content（string，可空串）——requiresReasoningContentOnAssistantMessages
+const DEEPSEEK_PREFIX = "deepseek";
+const DEFAULT_DEEPSEEK_EFFORT = "high";
+
+export function isDeepSeekModel(model) {
+  return String(model || "").trim().toLowerCase().startsWith(DEEPSEEK_PREFIX);
+}
+
+export function normalizeRoles(obj) {
+  const msgs = obj?.messages;
+  if (!Array.isArray(msgs)) return obj;
+  for (const m of msgs) {
+    if (m && typeof m === "object" && typeof m.role === "string" && m.role.trim().toLowerCase() === "developer") {
+      m.role = "system";
+    }
+  }
+  return obj;
+}
+
+export function normalizeToolChoice(obj) {
+  const tc = obj?.tool_choice;
+  if (tc === undefined || tc === null) return obj;
+  const dropTools = () => { delete obj.tools; delete obj.functions; };
+  if (typeof tc === "string") {
+    if (tc.trim().toLowerCase() === "none") { delete obj.tool_choice; dropTools(); }
+    return obj;
+  }
+  if (typeof tc === "object") {
+    const type = String(tc.type || "").trim().toLowerCase();
+    if (type === "none") { delete obj.tool_choice; dropTools(); }
+    else if (type === "auto" || type === "required") obj.tool_choice = type;
+    else if (type === "function") {
+      const name = String(tc?.function?.name || tc?.name || "").trim();
+      obj.tool_choice = name || "auto";
+    } else delete obj.tool_choice;
+    return obj;
+  }
+  delete obj.tool_choice;
+  return obj;
+}
+
+export function injectThinking(obj) {
+  if (!isDeepSeekModel(obj?.model)) return obj;
+  const th = obj.thinking && typeof obj.thinking === "object" ? obj.thinking : null;
+  const type = th ? String(th.type || "").trim() : "";
+  if (type && type.toLowerCase() === "disabled") {
+    delete obj.reasoning_effort;
+    delete obj.reasoningEffort;
+    return obj;
+  }
+  if (!type) {
+    if (th) th.type = "enabled";
+    else obj.thinking = { type: "enabled" };
+  }
+  if (!("reasoning_effort" in obj) && !("reasoningEffort" in obj)) obj.reasoning_effort = DEFAULT_DEEPSEEK_EFFORT;
+  return obj;
+}
+
+export function backfillReasoningContent(obj) {
+  if (!isDeepSeekModel(obj?.model)) return obj;
+  const msgs = obj.messages;
+  if (!Array.isArray(msgs) || !msgs.length) return obj;
+  let hasTrace = false;
+  for (const m of msgs) {
+    if (!m || typeof m !== "object") continue;
+    if (typeof m.reasoning === "string" && m.reasoning) { hasTrace = true; break; }
+    if ("reasoning_content" in m) { hasTrace = true; break; }
+  }
+  if (!hasTrace) return obj;
+  for (const m of msgs) {
+    if (!m || m.role !== "assistant") continue;
+    if ("reasoning_content" in m) continue;
+    m.reasoning_content = typeof m.reasoning === "string" ? m.reasoning : "";
+  }
+  return obj;
+}
+
+// 入口：输入 chat body（OpenAI 格式），返回改写后的新对象（messages 浅拷贝，避免污染调用方）。
+export function rewriteWorkbuddyPayload(body) {
+  if (!body || typeof body !== "object") return body;
+  const obj = { ...body };
+  obj.messages = Array.isArray(body.messages)
+    ? body.messages.map((m) => (m && typeof m === "object" ? { ...m } : m))
+    : body.messages;
+  normalizeRoles(obj);
+  normalizeToolChoice(obj);
+  if (isDeepSeekModel(obj.model)) {
+    injectThinking(obj);
+    backfillReasoningContent(obj);
+  }
+  return obj;
+}

package/src/upstream-engine/mode.js

@@ -1,13 +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") {
+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";
-  return "sdk";
+  if (raw) return "sdk";
+  return defaultMode === "legacy" ? "legacy" : "sdk";
 }

package/src/upstream-engine/sdk/convert.js

@@ -52,8 +52,9 @@ export function toModelPrompt(messages) {
       const parts = [];
       const text = textOf(m.content);
       if (text) parts.push({ type: "text", text });
-      // 带加密态的 reasoning items（responses 通道思考跨轮）：AI SDK 会转成上游要的 encrypted reasoning item。
       // 无加密态时才退回纯文本 reasoning（chat 通道的 reasoning_content）。
+      // 空串是 payload 回填的有意标记（requiresReasoningContentOnAssistantMessages）：所有 assistant
+      // 必须带该字段——AI SDK 以 length>0 判定是否输出，故用 " " 占位而非 ""。
       const items = Array.isArray(m.reasoning_items) ? m.reasoning_items : [];
       let pushedEncrypted = false;
       for (const r of items) {
@@ -66,7 +67,9 @@ export function toModelPrompt(messages) {
         });
         pushedEncrypted = true;
       }
-      if (!pushedEncrypted && m.reasoning_content) parts.push({ type: "reasoning", text: String(m.reasoning_content) });
+      const rc = typeof m.reasoning_content === "string" ? m.reasoning_content
+        : (typeof m.reasoning === "string" ? m.reasoning : null);
+      if (!pushedEncrypted && rc !== null) parts.push({ type: "reasoning", text: rc || " " });
       for (const tc of Array.isArray(m.tool_calls) ? m.tool_calls : []) {
         if (!tc || typeof tc !== "object") continue;
         parts.push({