@eddyskywalker/dsh-chatgpt-subscription 0.17.1 → 0.19.0

package/lib/types/host/glm-coding-plan/mapper-anthropic.d.ts

@@ -0,0 +1,308 @@
+/**
+ * GLM（ZCode 账号）线路的 **Anthropic Messages 面**映射。
+ *
+ * 端点形状（证据等级 A）：请求打 `{apiBaseForRegion(region)}{CHAT_PATH_ANTHROPIC}/v1/messages`，
+ * 例如国际区 `https://api.z.ai/api/anthropic/v1/messages`，国区 `https://open.bigmodel.cn/api/anthropic/v1/messages`。
+ * 两者逐字来自计划 `3.3 的模型面表（`zcode.z.ai/en/docs/qa` 第 6 条）与 `./types.ts` 的
+ * `CHAT_PATH_ANTHROPIC`。
+ *
+ * 一、认证是**双头**，这是本文件第一个必须做对的事
+ *
+ * 官方源码注释逐字写着「Anthropic 兼容网关会同时读取 x-api-key 和 Bearer Authorization」
+ * （`apps/zcode-cli/packages/adapters/src/model/model-execution.ts:425-437`，计划 `3.3）。
+ * 同值各发一份，见 {@link glmAnthropicHeaders}。少发任何一个都会得到 401，而错误正文
+ * 说的是「凭据没出现在头部里」（`ERROR_CODE.AUTH_MISSING` = 1001），排查方向会被带偏。
+ *
+ * 注意这与配额面**正好相反**：`/api/monitor/usage/quota/limit` 要的是裸 Key、
+ * **不可**加 Bearer 前缀（`./types.ts` 的 `QUOTA_PATH` 注释）。两处不能互相抄。
+ *
+ * 二、思考档位必须**跨两套词汇表**收敛
+ *
+ * DSH 的档位词汇比上游宽（`minimal` / `medium` / `xhigh` 在别的线路上都存在），
+ * 而 GLM-5.x 在 Coding Plan 上只接受 `low` / `high` / `max`，其余取值上游直接报错。
+ * 因此每个值都要先落到**模型真实梯子**上，见 {@link glmEffortForLadder} 与
+ * `./types.ts` 的 `convergeGlmEffort()`。
+ *
+ * 只排上游那三档会踩本仓库记录过的 bug：`minimal` 属于「未识别」，未识别一律落在中档，
+ * 于是 `minimal` 被发成 `high`——模型想得比用户要求的长得多，**更慢而且多计费**。
+ *
+ * 三、本文件**不伪造模型名**
+ *
+ * `GenerateOptions.model` 是调用方（模型目录）给的 id，逐字下发。本线路两区模型 id
+ * 不一致（计划 R8），任何按前缀猜测或「顺手换成官方名」的改写都会把请求打到上游
+ * 不认识的 id 上（`ERROR_CODE.UNKNOWN_MODEL` = 1211）。
+ *
+ * 四、分块语义照兄弟线路的 Anthropic 面，不另发明
+ *
+ * 思考 / 文本 / 工具调用是三个独立的 DSH 块：思考文本走 `reasoning-delta`，正文走
+ * `text-delta`，工具参数逐字拼接后交给 `tool-call` 块的 `arguments` 字符串
+ * （DSH 协议义务：参数保持模型产出的原始 JSON 串）。
+ * 参考实现是 `../minimax-code/mapper.ts`（同为 Anthropic 面）与 `../claude/mapper.ts`。
+ *
+ * 五、思考块的**回放**本文件不做
+ *
+ * Claude / minimax 两条线会把签名的 thinking 块原样存进 replayState 再回传。本线路
+ * 没有这个需求的证据：GLM 的 Anthropic 兼容面是否要求回放签名块，没有任何实测样本。
+ * 历史同族实现 `7e40fce` 的 `src/host/zhipu/mapper.ts` 选择「reasoning 块从不回放」。
+ * 本文件沿用那一条并在 {@link anthropicAssistantContent} 注明；**未验证**：改成
+ * 「回放」是否会被本面接受（需要一条真实多轮会话样本）。
+ *
+ * 未验证清单（本文件内逐条标注）：
+ *
+ * 1. `reasoning_effort` 出现在 Anthropic 面上。等级 A 的证据只覆盖 OpenAI 面的
+ *    `/api/coding/paas/v4`；本面是同一平台的兼容网关，但它是否读顶层
+ *    `reasoning_effort` 没有实测样本。用 `buildGlmAnthropicRequest` 的
+ *    `sendReasoningEffort` 开关可整段关掉。
+ * 2. `anthropic-version` 头网关是否强制要求。缺一条缺头的 4xx 样本。
+ * 3. 网关在 Anthropic 面上发思考增量的词汇。本文件同时认 `thinking_delta` 与
+ *    `reasoning_content`，两种都收。
+ * 4. 历史里 reasoning 块不回放是否被本面接受（见第五节）。
+ */
+import { LlmError, type ContentBlock, type GenerateOptions, type OutboundContentBlock, type StreamChunk } from '../common/llm-compat.ts';
+import { type ResolvedRequestImages } from '../common/request-images.ts';
+import type { GlmReasoningEffort, GlmRegion } from '../../shared/glm-coding-plan-contracts.ts';
+/**
+ * Anthropic Messages 协议版本头。
+ *
+ * 取值来自 Anthropic 公开协议常量，兄弟线路同值（`../kimi-code/client.ts:129` 的
+ * `'anthropic-version': '2023-06-01'`）。本线路网关是否**强制**要求这个头没有任何实测
+ * 样本（**未验证**，缺一条缺头的 4xx 样本），但发一个正确版本号的成本是零，所以照发。
+ */
+export declare const GLM_ANTHROPIC_VERSION = "2023-06-01";
+/**
+ * 本线路「这个选项在 Anthropic 面上送不出去」的稳定错误码。
+ *
+ * 语义与 harness 的 `HarnessError.code` 一致：稳定的机器可路由码，不要去解析 message。
+ * 存在的理由是**不许静默忽略**——一个送不出去的选项如果被悄悄丢掉，用户看到的是一个
+ * 「按默认设置跑」的回合，而不是一次能指认到具体选项的失败。
+ * 这条码不在任何线路的重试集合里（各线路 `retryableCodes` 只含 RATE_LIMIT / SERVER /
+ * TIMEOUT / TRANSPORT 等），所以抛出后不会被重试策略放大。
+ */
+export declare const UNSUPPORTED_OPTION_CODE = "UNSUPPORTED_OPTION";
+/**
+ * Anthropic 面的完整 URL：`{模型面 base}{CHAT_PATH_ANTHROPIC}/v1/messages`。
+ *
+ * base 取 `./types.ts` 的 `apiBaseForRegion`（国际区 `https://api.z.ai`、
+ * 国区 `https://open.bigmodel.cn`，都受 `DSH_GLM_*_API_HOST` 覆盖），路径前缀取同文件
+ * 的 `CHAT_PATH_ANTHROPIC`。区域是**凭据的属性**（计划 `1、`3.3），所以调用方必须把
+ * 账号的区域传进来，而不是让这里去猜——猜错的代价是拿另一区的主机去验一把本区 Key，
+ * 得到的是明确鉴权失败。
+ *
+ * @param region - 账号所属部署。
+ * @param env - 环境变量表，默认 `process.env`（覆盖值在调用时读取，便于测试注入）。
+ */
+export declare function glmAnthropicUrl(region: GlmRegion, env?: NodeJS.ProcessEnv): string;
+/**
+ * Anthropic 面请求头，认证是**双头**且同值。
+ *
+ * `x-api-key` 与 `Authorization: Bearer <key>` 各发一份：官方源码逐字写明这个兼容网关
+ * 同时读取两者（`model/model-execution.ts:425-437`，计划 `3.3）。只发一个的后果是
+ * 401 `AUTH_MISSING`(1001)，而那一条正文说的是「凭据没出现在头部里」，会把排查引向
+ * 凭据存储而不是认证头。
+ *
+ * `extra` 覆盖不了认证三件套（两个认证头 + 协议版本头）：它们不是「调用方想改就改」的
+ * 普通头，而是本面必须成对出现的协议事实，让一个 `extra` 把双头拆成不同值或只留一个，
+ * 造出来的故障比不带 extra 更难查。
+ *
+ * @param apiKey - Coding Plan Key（兑换链拼出的 `{apiKey}.{secretKey}`）。空白即抛 AUTH。
+ * @param extra - 追加请求头（调试、代理）。不能改写认证三件套。
+ */
+export declare function glmAnthropicHeaders(apiKey: string, extra?: Record<string, string>): Record<string, string>;
+/**
+ * 把 DSH 的档位收敛到该模型真实接受的梯子上。
+ *
+ * 跨两套词汇表排名（`none`/`minimal`/`low`/`medium`/`high`/`xhigh`/`max` 与上游的三档
+ * 一起排）之后取最近一档，平手向上取——与本仓库其余各线路的收敛一致，宁可多想一点，
+ * 也不要少想。排名表在 `./types.ts` 的 `convergeGlmEffort()` 内，本文件不复制一份。
+ *
+ * 三个返回值含义不同，都不是「猜」：
+ *
+ * - `ladder` 为空 → `null`：该模型不接受思考档位，调用方据此**不发**任何档位字段，
+ *   而不是发一个模型不认的值。
+ * - 调用方没指定档位 → `null`：模型的服务端默认生效，映射层不代它选。
+ * - 其余 → 模型梯子上真实存在的那一档。
+ *
+ * @param ladder - 模型目录为该模型声明的真实梯子（`GlmModelOption.reasoningEfforts`）。
+ * @param requested - 调用方给的档位（DSH 的 `ReasoningEffortId`，可为空）。
+ */
+export declare function glmEffortForLadder(ladder: readonly string[], requested: string | undefined | null): GlmReasoningEffort | null;
+/** 一次请求的思考控制。 */
+export interface GlmThinkingControl {
+    /** 要写进请求体的字段；为空表示这条请求不带任何思考控制。 */
+    fields: Record<string, unknown>;
+    /** 模型这次会不会思考。用于判断与思考互斥的选项（例如 temperature）。 */
+    thinking: boolean;
+}
+/**
+ * 请求体里的思考控制字段。
+ *
+ * `thinking: { type: 'enabled' }` 是**恒常发出**的一半：历史同族实现逐字记过
+ * 「`thinking` 的默认是 enabled，GLM-5.3 / GLM-5.3-FLASH / GLM-4.7 把
+ * `thinking.type: "disabled"` 当错误拒绝」（`7e40fce` 的 `src/host/zhipu/mapper.ts`
+ * 头注释），所以本线路任何模型都不发关闭值。
+ *
+ * `reasoning_effort` 是选深度的一半，取 {@link glmEffortForLadder} 的收敛结果。
+ *
+ * **未验证**：`reasoning_effort` 落在 Anthropic 面上。等级 A 的证据（计划 `3.3、
+ * `9ad8a53` 的 `CODING_EFFORTS`）只覆盖 OpenAI 面 `/api/coding/paas/v4`；本面是同一个
+ * 平台的兼容网关，但它是否读顶层 `reasoning_effort` 没有实测样本，缺一次真实请求。
+ * 之所以仍然默认发：另一个候选（Anthropic 原生的 `thinking.budget_tokens`）表达不了
+ * 三档梯子，而 `sendReasoningEffort: false` 是一个出口而不是修复。
+ *
+ * @param ladder - 模型真实梯子。
+ * @param requested - 调用方给的档位。
+ * @param sendReasoningEffort - 是否把收敛后的档位发成顶层字段，默认 true。
+ */
+export declare function glmThinkingControl(ladder: readonly string[], requested: string | undefined | null, sendReasoningEffort?: boolean): GlmThinkingControl;
+/** 本面这一次请求的构建选项。 */
+export interface GlmAnthropicRequestOptions {
+    /** 模型目录为该模型声明的真实思考梯子。空数组 = 该模型不接受思考档位。 */
+    ladder?: readonly string[];
+    /** 这次请求读到的图片（`resolveRequestImages` 的产物）。 */
+    images?: ResolvedRequestImages;
+    /** 是否把收敛后的档位发成顶层 `reasoning_effort`，默认 true。见 {@link glmThinkingControl}。 */
+    sendReasoningEffort?: boolean;
+    /** 调用方不指定输出上限时用的值，默认 `./types.ts` 的 `DEFAULT_MAX_TOKENS`。 */
+    defaultMaxTokens?: number;
+}
+/**
+ * 构造一个 Anthropic Messages 请求体。
+ *
+ * 字段顺序对服务端无意义，只是读起来顺。
+ *
+ * @param options - harness 归一化后的会话（`normalizeGenerateOptions` 的产物）。
+ * @param request - 该模型的档位梯子与已读图片。
+ */
+export declare function buildGlmAnthropicRequest(options: GenerateOptions, request?: GlmAnthropicRequestOptions): Record<string, unknown>;
+/** 一个跨多个 content-block 增量累积的工具调用。 */
+interface PendingToolCall {
+    /** 这个调用占的 DSH 块下标。 */
+    index: number;
+    id: string;
+    name: string;
+    /** 逐字拼接的 partial_json 片段。 */
+    arguments: string;
+}
+/** 一个正在接收增量的思考块。 */
+interface PendingThinking {
+    index: number;
+    kind: 'thinking' | 'redacted_thinking';
+    text: string;
+    signature: string;
+    data: string;
+}
+/** 一个 Messages 响应的累积状态。 */
+export interface GlmAnthropicStreamState {
+    /** 按 DSH 下标排列的已发块；块一开就占位。 */
+    blocks: OutboundContentBlock[];
+    /** wire content index -> 正在接收文本的那个块。 */
+    openText: Map<number, {
+        index: number;
+        text: string;
+    }>;
+    /** wire content index -> 累积中的工具调用。 */
+    toolCalls: Map<number, PendingToolCall>;
+    /** wire content index -> 打开着的思考块。 */
+    pending: Map<number, PendingThinking>;
+    hasContent: boolean;
+    hasToolCall: boolean;
+    /** wire 的 `stop_reason`，逐字保留。 */
+    finishReason: string | null;
+    /** 带内 `error` 事件的原始对象，记下来供适配层判断此刻还能不能安全重试。 */
+    streamError?: Record<string, unknown>;
+    sawMessageStart: boolean;
+    sawMessageStop: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    /** 结束之前是否真的见过 usage；没见过就不发 usage 块（零值 usage 是谎报）。 */
+    sawUsage: boolean;
+    finished: boolean;
+}
+/** 新的一次响应的流状态。 */
+export declare function createGlmAnthropicStreamState(): GlmAnthropicStreamState;
+/**
+ * 冲掉所有打开的块，然后发 usage，最后发终止的 finish。
+ *
+ * 顺序是协议义务：**usage 必须在 finish 之前，finish 之后不得再有任何块**
+ * （DSH 的 `StreamChunk` 文档逐字这么写）。所以本函数把 usage 排在 finish 前一行，
+ * 而 {@link processGlmAnthropicStreamLine} 一旦 `finished` 为真就返回空数组——
+ * 迟到的增量不会变成 finish 之后的块。
+ *
+ * 幂等：`message_stop` 已经关过流，适配层在响应体结束后再调一次是空操作而不是第二个 finish。
+ * 本函数**不**判断流是否完整，那是 {@link assertGlmStreamComplete} 的事。
+ */
+export declare function closeGlmAnthropicStream(state: GlmAnthropicStreamState): StreamChunk[];
+/**
+ * 流没有走到终止事件 = 被截断的回复，不是完整答案。
+ *
+ * 已经发出的内容只是模型没说完那句话的前缀，把它冲成一个干净 stop 就是把一次截断
+ * 报成一次成功——这正是这条检查存在的理由。
+ */
+export declare function assertGlmStreamComplete(state: GlmAnthropicStreamState): void;
+/** 这一路流有没有带出任何内容。 */
+export declare function glmStreamHasContent(state: GlmAnthropicStreamState): boolean;
+/**
+ * 把一条 Messages SSE 行喂进状态，返回这一行该发出的 DSH 块。
+ *
+ * 忽略不携带内容的行：SSE 注释（心跳）、`event:` 名字行（载荷自带的 `type` 才是权威）、
+ * 空行与本构建不认识的事件类型。`error` 事件**抛错**：回复已经结束，
+ * 继续把它冲成一个干净 stop 等于把错误答案报成成功答案。
+ *
+ * @param line - 一行 SSE 文本（不要求带换行）。
+ * @param state - 本次响应的累积状态。
+ */
+export declare function processGlmAnthropicStreamLine(line: string, state: GlmAnthropicStreamState): StreamChunk[];
+/** 一次上游失败的机器可读判读结果。 */
+export interface GlmUpstreamErrorVerdict {
+    /** 该转成哪一个 `LlmError.code`（重试策略按它判读）。 */
+    llmCode: string;
+    /**
+     * 这一类失败值不值得重试。
+     *
+     * 判据来自 `./types.ts` 的 `ERROR_CODE` 注释：可重试的只有 `RATE_LIMITED`（退避后重试，
+     * 号池可换账号）与 `OVERLOADED`（瞬时过载）；其余全部不可重试——重试一次确定的失败
+     * 只会把它拖成多次，并在额度类错误上多烧一次额度。
+     * `USAGE_LIMIT` / `PLAN_LIMIT` 带重置时刻，正确处置是等窗口重置而不是立刻重试。
+     */
+    retryable: boolean;
+    /** 正文给出的业务码；没有则是 null。 */
+    businessCode: number | null;
+    /** HTTP 状态；调用方没给则是 null。 */
+    status: number | null;
+    /** 面向人的处置说明。 */
+    disposition: string;
+}
+/**
+ * 把一次上游失败判读成机器可路由的结论。
+ *
+ * 分类**不能停在状态行**：多个真实条件共用同一个 HTTP 状态（表里 429 有六条，
+ * 401 有三条），所以正文里的业务码才是判据，状态行只在本面没给出业务码时兜底。
+ *
+ * 两个兜底方向都是有意选的：
+ *
+ * - 未知 5xx → 可重试（传输面故障，语义上与 OVERLOADED 同族）。
+ * - 未知 429 → **不可重试**。本表里六条 429 里有五条是额度类，立即重试只会继续失败，
+ *   还会多烧一次额度；宁可让调用方等一下也不要把它变成重试风暴。
+ *
+ * @param input - HTTP 状态（可选）与上游正文（可选）。
+ */
+export declare function classifyGlmUpstreamError(input: {
+    status?: number | undefined;
+    body?: unknown;
+}): GlmUpstreamErrorVerdict;
+/**
+ * 构造一次上游失败（不抛，交给调用方决定抛点）。
+ *
+ * 让调用方（适配层）既拿到 `LlmError` 的稳定 code，又拿到「这次到底该不该重试」的
+ * 判读结果——两者不是一回事：code 决定路由，retryable 决定重试策略。
+ *
+ * @param input - HTTP 状态（可选）与上游正文（可选）。
+ */
+export declare function glmUpstreamError(input: {
+    status?: number | undefined;
+    body?: unknown;
+}): LlmError;
+export type { ContentBlock };
+//# sourceMappingURL=mapper-anthropic.d.ts.map

package/lib/types/host/glm-coding-plan/mapper-anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper-anthropic.d.ts","sourceRoot":"","sources":["../../../../src/host/glm-coding-plan/mapper-anthropic.ts"],"names":[],"mappings":"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"}

package/lib/types/host/glm-coding-plan/mapper-openai.d.ts

@@ -0,0 +1,213 @@
+/**
+ * GLM（ZCode 账号）线路的 **OpenAI 兼容面**（协议 B）线映射。
+ *
+ * 上游面是 Coding Plan 专用的 OpenAI Chat Completions 形状，地址为
+ * `{apiBaseForRegion(region)}` + `CHAT_PATH_OPENAI`（= `/api/coding/paas/v4`），
+ * 实际调用 `/api/coding/paas/v4/chat/completions` 与 `/api/coding/paas/v4/models`。
+ *
+ * **刻意不是 `/api/paas/v4`**：那是通用开放平台面，官方文档的 Common mistakes 段写明
+ * 走那个面套餐额度不会正确生效（计划 §3.3，证据等级 A）。也就是说发错前缀不会报错，
+ * 用户只会看到「明明买了套餐却在扣余额」，所以前缀由 `./types.ts` 的常量固定，不在此处拼。
+ *
+ * 本文件吸收的四处与 OpenAI 默认形状不同的地方，每一处都有来源：
+ *
+ * 1. **思考在 `delta.reasoning_content`**，不是 OpenAI 的 `reasoning_summary`，
+ *    落到 DSH 的 reasoning block。逐字来源：本仓库历史提交 `9ad8a53` 的
+ *    `src/host/zhipu/mapper.ts` 实测转录。
+ * 2. **`reasoning_effort` 只接受模型自己的梯子**（GLM-5.x 为 `low`/`high`/`max`），
+ *    别的取值上游直接报错（业务码 1214 INVALID_PARAM，见 `ERROR_CODE` 表）。
+ *    DSH 的档位词汇更宽（`minimal`/`medium`/`xhigh` 在别的线路上都存在），
+ *    因此每个取值先经 `convergeGlmEffort()` 落到梯子上再发。该函数跨两套词汇表排名，
+ *    `none`/`minimal` 也有位置可落——只排三档会把 `minimal` 误升成 `high`，
+ *    那正是本仓库历史记录过的 bug（见 `./types.ts` 的 `convergeGlmEffort` 注释）。
+ * 3. **不发 `thinking.type`**。`thinking` 的默认是 enabled，而 GLM-5.3 /
+ *    GLM-5.3-FLASH / GLM-4.7 把 `thinking.type: "disabled"` 当**错误**，
+ *    所以本线路任何模型都不发关闭值，直接省略该字段（同上，历史 mapper 注释）。
+ * 4. **不发 `stream_options`**。上游的流式文档里 usage 对象是随末帧到的，
+ *    该字段也不在文档化的请求 schema 里；给这个 API 发一个未文档化的字段，
+ *    代价可能只是一个毫无收益的 400（同上，历史 mapper 注释）。
+ *
+ * **未验证**：以上第 1-4 条全部来自 `9ad8a53` 的历史实测转录，本轮**没有实机账号**
+ * （计划 D9、R1），因此没有一次 live 复核。缺的是一份真实 SSE 帧样本与一份真实 400 响应样本。
+ * 结构性的部分（字段名、认证头形状）证据等级 A；行为性的部分（哪些取值会被拒）
+ * 只到「历史实测记录」这一层。
+ */
+import { LlmError, type GenerateOptions, type OutboundContentBlock, type StreamChunk } from '../common/llm-compat.ts';
+import type { GlmRegion } from '../../shared/glm-coding-plan-contracts.ts';
+import type { AttachmentStore } from '@deepseek-ai/dsh-attachment';
+/**
+ * 本文件自己用的失败码：调用方要求了一件这个面做不到的事。
+ *
+ * 与上游那张业务码表不是一回事——`ERROR_CODE` 说的是上游说了什么，
+ * 这一个说的是本线路在发请求之前就知道做不到。处置因此不同：后者不该重试，
+ * 也不该让用户以为「上游出问题了」，而是换模型或换调用方式。
+ *
+ * 取值是 harness 的**通用码** `UNSUPPORTED_OPTION`，不是本线路自造的：harness 自己的
+ * provider 就在用同一个串（`packages/llm/llm-pi-ai/src/adapter.ts:335` 抛的是
+ * `new LlmError('llm-pi-ai does not support GenerateOptions.stop', 'UNSUPPORTED_OPTION')`），
+ * 本线路的 Anthropic 面（`mapper-anthropic.ts`）也用同一个串。
+ *
+ * 所以两个面共用一个码：装配层要判断「这个面做不到这件事」时，只有一个词要认，
+ * 而不是先问是哪个面。自造一个带线路前缀的码会让调用方多学一个词，
+ * 也会让同一个线路的两面出现两个说法。
+ */
+export declare const UNSUPPORTED_OPTION_CODE = "UNSUPPORTED_OPTION";
+/** 上游 Chat Completions 路径，接在 `CHAT_PATH_OPENAI` 之后。 */
+export declare const CHAT_COMPLETIONS_SEGMENT = "/chat/completions";
+/** 上游模型清单路径，接在同一个 `CHAT_PATH_OPENAI` 之后。 */
+export declare const MODELS_SEGMENT = "/models";
+/** 本面一个完整请求的 URL：`{apiBase}{CHAT_PATH_OPENAI}/chat/completions`。 */
+export declare function chatCompletionsUrl(region: GlmRegion, env?: NodeJS.ProcessEnv): string;
+/** 本面模型清单的 URL：`{apiBase}{CHAT_PATH_OPENAI}/models`。 */
+export declare function modelsUrl(region: GlmRegion, env?: NodeJS.ProcessEnv): string;
+/**
+ * OpenAI 兼容面的请求头。
+ *
+ * 认证是 `Authorization: Bearer {credential}`，credential 是兑换链换出来的
+ * `{id}.{secret}` Coding Plan Key（计划 §3.2、§3.3）。
+ *
+ * **刻意不发 `x-api-key`**：双头是 **Anthropic 兼容面**的性质，官方源码注释逐字写着
+ * 「Anthropic 兼容网关会同时读取 x-api-key 和 Bearer Authorization」
+ * （`model/model-execution.ts:425-437`，计划 §3.3）。本面只读 Bearer，
+ * 多发一个头不会更好，只会让日后复审误以为两面共用一套认证。
+ *
+ * 配额接口则**反过来**用裸 Key、不加 Bearer（见 `./types.ts` 的 `QUOTA_PATH` 注释），
+ * 那是另一条路，不归本文件管。
+ */
+export declare function glmOpenAiHeaders(credential: string, extra?: Record<string, string>): Record<string, string>;
+/**
+ * 调用方（适配器）交给本映射的**逐模型**能力声明。
+ *
+ * 存在的原因是一条硬规则：**能力不得从模型名推断**（计划 §1、§7）——
+ * 历史草案记录过 `glm-5.3-flash` 收图而 `glm-5.3` 不收、`glm-5.2` 两个档位而
+ * `glm-5.3` 三个。所以本文件只读声明，绝不看 `options.model` 里的字符串。
+ */
+export interface GlmOpenAiModelRoute {
+    /**
+     * 该模型真实接受的思考档位梯子（目录逐行给出）。
+     *
+     * 空数组表示它不接受 `reasoning_effort`，此时本文件**不发**该字段：
+     * `convergeGlmEffort` 对空梯子返回 null，调用方据此不发，而不是发一个模型不认的值。
+     */
+    readonly reasoningEfforts: readonly string[];
+    /** 是否接受 image 输入。 */
+    readonly supportsImages: boolean;
+    /**
+     * 调用方未给 `maxTokens` 时本线路请求的输出上限。
+     *
+     * 缺省取 `DEFAULT_MAX_TOKENS`，那个常量在 `./types.ts` 里已标注**未验证**
+     * （它不是任何 GLM-5.x 模型的官方上限，只是历史兜底值）。
+     */
+    readonly defaultMaxTokens?: number;
+}
+/**
+ * 目录尚未落地时使用的保守声明。
+ *
+ * 两项都取「什么都不发」的一侧：梯子为空 → 不发 `reasoning_effort`（让上游用自己的默认），
+ * 不认图 → 请求里的图片按「读不出来」明说，而不是发一个上游会拒的 `image_url`。
+ * 这不是对能力的判断，是「没有声明就不主张」。
+ */
+export declare const UNDECLARED_MODEL_ROUTE: GlmOpenAiModelRoute;
+/** 本面需要的附件接缝：一个持久图片的已验证字节。 */
+export type AttachmentImageReader = Pick<AttachmentStore, 'readImage'>;
+/** 一个请求内已解析的持久图片，或「已证明读不出来」。 */
+export type ResolvedRequestImage = {
+    readonly kind: 'inline';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly kind: 'unavailable';
+};
+/** 按持久附件 id 索引的图片；由一次请求构建消费。 */
+export type ResolvedRequestImages = ReadonlyMap<string, ResolvedRequestImage>;
+/**
+ * 一次请求允许携带的 base64 图片上限：12 MB。
+ *
+ * 取本仓库其余 OpenAI 形状线路的同一个值（`workbuddy` / `zhipu` 的同名常量），
+ * 理由是让图文与工具 schema 留在同一个 body 里。
+ *
+ * **未验证**：GLM Coding Plan 这个面对单请求图片字节的真实上限没有实测样本，
+ * 缺一份超限请求的真实响应。W5 的客户端一旦拿到真实 413/1214 响应即可调整此值。
+ */
+export declare const MAX_REQUEST_IMAGE_BYTES: number;
+/**
+ * 一次请求的图片字节超出 {@link MAX_REQUEST_IMAGE_BYTES} 时，把最老的内联图片换成占位文本。
+ *
+ * 持久历史不动，只改即将发出的那一份请求。
+ */
+export declare function offloadOldestRequestImages(options: GenerateOptions): GenerateOptions;
+/**
+ * 读出一次请求携带的每一个 `{ type: 'image', attachment }` 块。
+ *
+ * 读不出来的图片解析成 `unavailable` 而不是凭空消失，这样模型被明确告知图没了，
+ * 而不是对着空白作答。
+ */
+export declare function resolveRequestImages(options: GenerateOptions, attachments: AttachmentImageReader | undefined, signal?: AbortSignal): Promise<ResolvedRequestImages>;
+/** 去掉上游网关会拒或会忽略的 JSON-Schema 元关键字。 */
+export declare function stripMetaSchema(schema: unknown): Record<string, unknown>;
+/**
+ * 构造一份 `/api/coding/paas/v4/chat/completions` 的 body。
+ *
+ * `reasoning_effort` 先经 `convergeGlmEffort()` 收敛到目录声明的梯子上：
+ * DSH 的词汇比上游宽，而上游收到不认识的档位会直接报 1214。
+ * 梯子为空时**不发**该字段，而不是发一个模型不认的值。
+ *
+ * `thinking` 与 `stream_options` 一律**不发**，理由见文件头第 3、4 条。
+ */
+export declare function buildChatRequest(options: GenerateOptions, images?: ResolvedRequestImages, route?: GlmOpenAiModelRoute): Record<string, unknown>;
+/**
+ * 从一份响应正文里读出平台自己的数字业务码。
+ *
+ * 分类**不能停在状态行**：同一个 429 覆盖了已用尽的窗口、失效的套餐和
+ * 单模型授权缺口（见 `./types.ts` 的 `ERROR_CODE` 表注释），它们要不同的处置。
+ */
+export declare function readGlmErrorCode(detail: string): number | null;
+export declare function classifyGlmOpenAiFailure(status: number, detail: string, headers?: Headers): LlmError;
+interface PendingToolCall {
+    blockIndex: number;
+    id: string;
+    name: string;
+    arguments: string;
+    started: boolean;
+}
+/** 一次流式响应的累积状态。 */
+export interface GlmOpenAiStreamState {
+    blocks: OutboundContentBlock[];
+    current: {
+        index: number;
+        type: 'text' | 'reasoning';
+        text: string;
+    } | null;
+    /** 线上工具下标 -> 累积中的调用。 */
+    toolCalls: Map<number, PendingToolCall>;
+    hasContent: boolean;
+    hasToolCall: boolean;
+    finishReason: string | null;
+    /** `[DONE]` 哨兵到了。 */
+    done: boolean;
+    /** 终止块已经发出过。 */
+    finished: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    reasoningTokens: number;
+    sawUsage: boolean;
+}
+export declare function createStreamState(): GlmOpenAiStreamState;
+/** 喂进来一条 `/chat/completions` 的 SSE 行。 */
+export declare function processStreamLine(line: string, state: GlmOpenAiStreamState): StreamChunk[];
+/**
+ * 冲掉所有打开的块，然后**先发 usage、再发 finish**。
+ *
+ * 顺序是硬要求：DSH 的执行器按 finish 结算一次调用，usage 排在它后面就来不及入账。
+ */
+export declare function closeStream(state: GlmOpenAiStreamState): StreamChunk[];
+/**
+ * 一条流在没有终局事件的情况下结束，那是**被截断**，不是答完了。
+ *
+ * 这个端点总是以 `finish_reason` 或 `[DONE]` 收尾，所以两者都没有意味着
+ * 连接在答案中途断了，半截文本不能当成完成的回复呈现。
+ */
+export declare function assertStreamComplete(state: GlmOpenAiStreamState): void;
+export {};
+//# sourceMappingURL=mapper-openai.d.ts.map

package/lib/types/host/glm-coding-plan/mapper-openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper-openai.d.ts","sourceRoot":"","sources":["../../../../src/host/glm-coding-plan/mapper-openai.ts"],"names":[],"mappings":"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"}