@qjp88995/provider-client 0.0.0-stage → 0.1.1

package/src/vendors/zhipu.adapter.ts

@@ -0,0 +1,169 @@
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import type { LanguageModel } from 'ai';
+
+import type { LlmProtocol } from '../types.js';
+import {
+  COMPATIBLE_RESPONSES_OPTIONS,
+  createResponsesModel,
+} from './openai-responses.js';
+import { withReasoningTextResponsesShim } from './responses-reasoning-text-shim.js';
+import {
+  type CreateModelInput,
+  LlmVendorAdapter,
+  type ProviderOptions,
+  type ReasoningEffort,
+  unsupportedProtocol,
+} from './vendor-adapter.js';
+
+/**
+ * 工厂 `name`。它同时决定 provider id（`zhipu.chat`）与 providerOptions 的
+ * 命名空间 key（SDK 认 `name` 与 `toCamelCase(name)`，单词无连字符两者相同），
+ * 恰好等于我们的 `kind`，故基类默认的 `optionsKey` 直接可用。
+ */
+const FACTORY_NAME = 'zhipu';
+
+/**
+ * 智谱的推理开关是**模型级**的两种形态（2026-08-27 用真实 API 探针钉住，
+ * 文档见 <https://docs.bigmodel.cn/cn/guide/capabilities/thinking-mode.md>）：
+ *
+ *   - `forced`：glm-5.3 / glm-5.3-flash。**思考关不掉**——发 `thinking:{type:'disabled'}`
+ *     直接 400（code 1210「该模型始终思考，不支持关闭思考；请使用 low、high 或 max」），
+ *     只认 `reasoning_effort`。
+ *   - `toggle`：glm-5.2 及更早的推理模型（5.1 / 5 / 4.7 / 4.6 / 4.5）。`thinking` 的
+ *     `enabled`/`disabled` 都合法，且**默认是 enabled**（不发 = 开着推理，探针
+ *     `reasoning_tokens: 62`），档位同样走 `reasoning_effort`（4.7、5.2 实测都收）。
+ *
+ * 模型名换了就改这一个函数。没有推理能力的老模型（glm-4-flash 那批）走不到这里
+ * ——resolver 只对标了 `reasoning` 能力的模型问推理选项。
+ */
+type ThinkingStyle = 'forced' | 'toggle';
+
+export function zhipuThinkingStyle(modelId: string): ThinkingStyle {
+  const id = modelId.toLowerCase();
+  if (id.startsWith('glm-5.3')) return 'forced';
+  return 'toggle';
+}
+
+/**
+ * 智谱 BigModel（GLM 系）。
+ *
+ * 承载包是 `@ai-sdk/openai-compatible`，**不是**社区的 `zhipu-ai-provider`（维护
+ * 停滞、跟不上 AI SDK 大版本）。选它的依据是一条实测过的 SDK 行为：它把
+ * `providerOptions[name]` 里**不在自己 schema 里的键原样展开进请求体**
+ * （dist 里 `...Object.fromEntries(Object.entries(providerOptions[...]).filter(...))`），
+ * 所以智谱私有的 `thinking` 参数不必写一整套 LanguageModel 就能下发；
+ * `reasoningEffort` 则在 schema 里、由 SDK 翻成 `reasoning_effort`。响应侧
+ * `reasoning_content`（非流式 message 与流式 delta 都是这个字段名）也正是
+ * 该包原生读取的字段——同目录 `zhipu.sdk-contract.spec.ts` 跑真实 SDK 钉这两条。
+ *
+ * 接入面：文档的「HTTP 原生」与「OpenAI 兼容」是**同一个端点**
+ * `/api/paas/v4/chat/completions`，前者只是多了几个私有参数，合为 chat-completions
+ * 一个分支；Responses 端点（`/api/v1/responses`）**没有任何文档页**，只在模型页的
+ * 接入方式表与 Codex 接入指南里各出现一次，全部判据来自 2026-08-27 的探针（见
+ * `reasoning()` 注释与 providers.md）；Anthropic 兼容面（`/api/anthropic`）本仓
+ * 尚无 `anthropic-messages` 分支，用户拍板先不做。
+ *
+ * Responses 面的两条运维事实：① GLM-5.3 模型页接入表下的 `<Note>` 原文——「如果您
+ * 有订阅过 GLM Coding Plan（含已过期），那么**暂时**您只能通过 OpenAI Chat Completion
+ * 协议调用模型 API，我们将在近期迭代优化」，是临时限制，那种账号在 responses 端点
+ * 失败时先想到它；② 探针约 30 次调用里有 3 次非流式请求挂到超时（重打即成功），
+ * 是厂商侧偶发，不是形状问题。
+ *
+ * **`temperature` 只收 `[0,1]`**（超出直接 400「temperature参数非法」，实测），
+ * 与 OpenAI 的 `[0,2]` 不同；`sampling` 只有「发不发」的粒度，这条限制目前靠
+ * 运营录参数时自觉，未做钳位。
+ */
+export class ZhipuAdapter extends LlmVendorAdapter {
+  readonly kind = 'zhipu' as const;
+
+  override readonly supportedProtocols: readonly LlmProtocol[] = [
+    'openai-chat-completions',
+    'openai-responses',
+  ];
+
+  /**
+   * responses 走 `@ai-sdk/openai` + 与 DeepSeek 共用的响应侧垫片：智谱的推理正文
+   * 同样以 reasoning item 的 `content[{reasoning_text}]` 返回、流式事件同样是
+   * `response.reasoning_text.delta`（探针逐字段核对过），不垫就是推理整段消失。
+   * 请求侧不动：四种回传形状（原样 output / 只回 function_call / `item_reference`
+   * / 流式）全部 200；与 DeepSeek 不同的是它**会消费**发回去的 reasoning item
+   * （input_tokens 恰好多出上一轮的 reasoning_tokens），SDK 默认发什么就发什么。
+   */
+  createModel(input: CreateModelInput): LanguageModel {
+    switch (input.protocol) {
+      case 'openai-chat-completions': {
+        const { baseUrl, apiKey, modelId, fetch } = input;
+        return createOpenAICompatible({
+          name: FACTORY_NAME,
+          baseURL: baseUrl,
+          apiKey,
+          fetch,
+        })(modelId);
+      }
+      case 'openai-responses':
+        return createResponsesModel(
+          input,
+          withReasoningTextResponsesShim(input.fetch)
+        );
+      default:
+        throw unsupportedProtocol(this, input.protocol);
+    }
+  }
+
+  /**
+   * **chat-completions**：`off` 在 toggle 模型上必须发**显式的**
+   * `thinking:{type:'disabled'}`——它默认开着推理，「不发 ≠ 关闭」在这家再次成立；
+   * forced 模型没有关闭开关，off 只能不发（如实反映厂商限制，不是漏了关闭指令）。
+   * 非 off 一律 `thinking:enabled` + `reasoning_effort`：厂商原生三档 `low/high/max`
+   * （glm-5.3 默认 `max`），我们的五档压进去；`max` 直通。`medium` 实测 5.2 也收，
+   * 但 5.3 的 400 文案只认三档，统一映射不赌宽容度。
+   *
+   * **responses**：只有 `reasoning.effort` 一个开关，且**这个面上推理关不掉**——
+   * 探针在 glm-5.2 上把 `effort:'none'`、体内 `thinking:{type:'disabled'}`、两者同发
+   * 全试过，reasoning_tokens 纹丝不动（100）；glm-5.3 系收到 `none` 则直接 400
+   * 「该模型始终思考」。所以 `off` 在 responses 下**不发**：发 `none` 在 5.2 上
+   * 是无效指令、在 5.3 上是错误，两边都不是「关闭」。这是本协议面的已知限制，
+   * 要真关推理请给模型只声明 chat-completions。档位 key 随承载包换成 `openai`，
+   * 并带 `COMPATIBLE_RESPONSES_OPTIONS`（否则 SDK 按模型名判成非推理模型、
+   * `reasoning` 整个不发；`developer` 角色实测也收，但只保证 `system`）。
+   */
+  override reasoning(
+    modelId: string,
+    effort: ReasoningEffort,
+    protocol: LlmProtocol
+  ): ProviderOptions | undefined {
+    switch (protocol) {
+      case 'openai-chat-completions': {
+        const style = zhipuThinkingStyle(modelId);
+        if (effort === 'off') {
+          if (style === 'forced') return undefined;
+          return { [this.optionsKey]: { thinking: { type: 'disabled' } } };
+        }
+        return {
+          [this.optionsKey]: {
+            thinking: { type: 'enabled' },
+            reasoningEffort: toZhipuEffort(effort),
+          },
+        };
+      }
+      case 'openai-responses': {
+        if (effort === 'off') return undefined;
+        return {
+          openai: {
+            reasoningEffort: toZhipuEffort(effort),
+            ...COMPATIBLE_RESPONSES_OPTIONS,
+          },
+        };
+      }
+      default:
+        throw unsupportedProtocol(this, protocol);
+    }
+  }
+}
+
+/** 我们的档位 → 智谱原生三档 `low/high/max`。`max` 直通——用户选了最高档就该拿到最高档。 */
+function toZhipuEffort(effort: ReasoningEffort): string {
+  if (effort === 'minimal' || effort === 'low') return 'low';
+  if (effort === 'max') return 'max';
+  return 'high';
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.