Leeminjing/dsh-messages-sanitizer

dsh-messages-sanitizer

⚠️ 已退役 —— dsh ≥ 0.2.0 已在运行时根治本插件要补的问题

本插件的存在前提是：工具调度崩溃会在会话里留下孤儿 tool_calls，导致之后每一轮都被 400 INVALID_REQUEST 拒绝。这个前提在 dsh 0.2.0 已不成立：

• @deepseek-ai/dsh-agent-loop 在 step 抛错时用 ToolCallRecovery 为所有未应答的调用 合成并追加 tool/result 事件（带 TOOL_NOT_STARTED / TOOL_OUTCOME_UNKNOWN 错误码）；
• 会话恢复时 interruptedTurnClosers() 会把修复写进持久日志；
• deriveMessages() 自身就会丢弃空 content 的 assistant 消息。

而且插件的主路径在 0.2.0 上无法实现：agent/pre-step 返回的每条消息都被循环以 session.append("user/message", …) 落盘，而会话校验强制该事件的消息 role 必须是 user——注入 tool 角色的合成结果会直接抛错。其余分层所依赖的 Session#events、 surfaceOp.{start,end}、tool-result 内容块在 0.2.0 也均已移除或改名。

结论：不要安装本插件。直接用 dsh ≥ 0.2.0。 本仓库已归档，仅作历史记录保留； npm 包已标记 deprecated。0.1.1 只对仍停留在 dsh 0.1.x 的用户有意义。

🔧 你在 DeepSeek Harness 里创建 / 加载插件，对话崩了吗？本插件专治这个。

开发或加载本地插件时，一次工具调度崩溃（Cannot read properties of undefined (reading 'prepare')）就会在会话里留下孤儿 tool_calls，之后每一轮都被 400 INVALID_REQUEST 拒绝、重试无效、会话卡死。本插件自动把 messages 数组修回 合法，让对话继续，不再卡死。

💥 Before                                ✅ After (安装本插件后)
插件崩溃                                  插件崩溃
   ↓                                        ↓
留下孤儿 tool_calls                       messages 自动修复
   ↓                                        ↓
400 INVALID_REQUEST 死循环                对话继续
   ↓
对话卡死

DeepSeek Harness 消息数组自动矫正插件：防止一切因 messages 数组不合法导致的聊天崩溃。

背景：你遇到的那个崩溃

OpenAI 兼容协议要求工具调用成对出现，且 tool 消息必须紧邻其 assistant tool_calls 消息（中间不能插入任何 user / assistant 消息）：

assistant  { content: ..., tool_calls: [{ id: "call_A", ... }] }
tool       { tool_call_id: "call_A", ... }   ← 必须紧跟覆盖每个 id

当一次工具调度在「记录 assistant tool_calls / tool/call 之后、产出 tool 结果之前」 崩溃时（例如 ctx.tools[symbol].prepare 抛 Cannot read properties of undefined）， 会话日志会留下一个没有 tool 消息响应的孤儿 tool_calls。下一轮请求把历史拼成：

[..., assistant{tool_calls:[write]}, user{...}]        ← 非法

API 直接返回 400 INVALID_REQUEST，且重试时历史原封不动，反复被拒，会话卡死。 如果崩溃后还有多次失败重试，日志里还会留下多条重复的 user 消息横在孤儿 assistant 与注入点之间，让"补插 tool 消息"也无法满足紧邻约束。

背景（与 DSH 官方讨论对照）

同类故障在 DeepSeek Harness 官方仓库也已被跟踪： Discussion #4843「残缺或孤立的 tool_calls 记录导致 DeepSeek 接口返回 400」 描述了「会话历史中存在无配对 result、或 id/name/arguments 残缺的 tool_calls 时，chat-completions 接口返回 400」， 并从 harness 源码层（agent-loop 剥离、llm-deepseek 合成 fallback id、compaction 的 tool-pairing 按 callId 而非计数） 给出根因修复 patch。