[Bug/Docs] 官方 Messages API 以 422 拒绝 toolUpdate: in-history 生成的 tool_removal

[kazari-qwp]

问题

在独立的原生 Harness SDK 最小测试中，显式为 deepseek-flash 声明 toolUpdate: in-history 后，SDK 会按文档发送 tool_removal，但官方 Messages 端点返回 HTTP 422，明确表示不认识该内容块。

我理解默认 Flash 模型条目采用 addition-only，也理解“允许在 SDK 中声明能力”不一定代表每个服务端已经支持。本反馈希望确认官方服务的实际支持范围，并建议在文档中明确说明这个限制，避免插件开发者启用该模式后直接遇到服务端协议错误。

环境

• Windows；已安装的官方 SDK 包 @deepseek-ai/dsh-llm、dsh-llm-deepseek、dsh-session 版本均为 0.2.0-rc.2。
• Provider：deepseek-account，正常的官方账户登录通道。
• 实际 URL：https://api.deepseek.com/anthropic/v1/messages。
• 模型：deepseek-flash；thinking off；每请求 max_tokens: 64；禁用 SDK 自动重试。
• 复测日期：2026-10-17（北京时间）。
• 通过原生 LlmRuntime + DeepSeekAdapter + Session.toolHistory() 独立测试，不经过第三方应用的工具保留、权限拦截或消息队列逻辑。

文档依据

• DeepSeek provider README，端点与协议格式：介绍 toolUpdate: addition-only / in-history，以及原生工具更新内容块和 beta 请求头。
• Dynamic tool updates 架构说明：说明 in-history 模式保留历史声明及 removal 更新，并由 DeepSeek 适配器转换为线协议内容块。

模型目录中启用的相关配置：

models:
  - id: deepseek-flash
    systemPromptUpdate: in-history
    toolUpdate: in-history

resolveModelInfo() 确实返回了 toolUpdate: "in-history"。线协议请求也确实包含 removal，排除了配置没有生效的情况。

最小复现

1. 初始有效工具为 retained_probe 和 removed_probe，发送一个要求回复 READY 的普通请求，得到 HTTP 200 / READY。
2. 将当前有效工具改为仅 retained_probe，在 Session 中记录移除 removed_probe 的 tool-registry developer 更新。
3. 用同一个会话及 Session.toolHistory() 发起下一次原生 SDK 请求。

SDK 自动附带的相关请求头为：

Content-Type: application/json
Accept: text/event-stream
anthropic-version: 2023-06-01
anthropic-beta: mid-conversation-tool-changes-2026-07-01

使用官方账户鉴权头，鉴权值不公开。下面是捕获到的实际请求正文（只有测试用文本与空参数工具，不含账户数据）：

{
  "model": "deepseek-flash",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Reply exactly READY."
        }
      ]
    },
    {
      "role": "assistant",
      "content": [
        {
          "type": "text",
          "text": "READY"
        }
      ]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "The temporary tool is removed. Reply exactly REMOVAL_ACK."
        }
      ]
    },
    {
      "role": "system",
      "content": [
        {
          "type": "tool_removal",
          "tool": {
            "type": "tool_reference",
            "name": "removed_probe"
          }
        }
      ]
    }
  ],
  "max_tokens": 64,
  "thinking": {
    "type": "disabled"
  },
  "system": "Reply with the exact requested acknowledgment. Do not call tools.",
  "tools": [
    {
      "name": "retained_probe",
      "description": "Control tool; do not call it.",
      "input_schema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "name": "removed_probe",
      "description": "Temporary tool; do not call it.",
      "input_schema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  ]
}

保留两个工具声明、再用历史 removal 表示其中一个失效，是 in-history 模式的原生投影行为；这里并不是忘记从当前有效工具清单中移除它。

实际结果

HTTP 422。原生 SDK 归类为 INVALID_REQUEST：

Failed to deserialize the JSON body into the target type: messages[3].content: unknown variant `tool_removal`, expected one of `text`, `image`, `document`, `thinking`, `server_tool_use`, `tool_use`, `tool_result`, `web_search_tool_result`, `tool_addition` at line 1 column 410 (request_id: 19536f42-32e5-4eec-8798-4ca0f71c34c3)

错误列出的允许类型包含 tool_addition，但不包含 tool_removal。

对照结果：

请求	结果
普通两工具基线	HTTP 200 / READY
in-history removal（带 SDK beta 头）	HTTP 422 / unknown variant tool_removal
原生 surface replacement 后建立新声明系列，只保留当前有效工具	HTTP 200 / COMPACT_ACK

最后一项仅用原生 Session replacement 模拟摘要提交后的投影边界，没有额外执行摘要模型。它表明同一鉴权与端点正常工作，失败集中在 removal 协议块。

希望确认

1. 官方 deepseek-account / Flash Messages 端点目前是否支持 in-history 工具移除？是否还需要其他开关、版本或不同 beta 头？
2. 如果当前官方服务只支持 addition-only，能否在 provider 文档中明确列出“客户端已实现、官方端点尚不支持 removal”的边界？
3. 若 in-history 只供其他兼容网关使用，能否明确注明，或对官方端点的显式不支持配置给出更早、更清晰的提示？

暂时可以保留定义并禁用执行，再在新的声明系列中清理停用工具；但这与真正的历史内 removal 是不同的能力。感谢帮忙确认。