dsh-opendesign-corouter 0.1.1 → 0.1.2

package/lib/model-discovery.d.ts

@@ -0,0 +1,39 @@
+/**
+ * OpenAI 兼容 `GET /models` 模型发现（与选定推理协议无关）。
+ *
+ * 契约：
+ * - 只请求 OpenAI 兼容 API 的 `/models`；裸网关 origin 自动补 `/v1`，显式前缀保留。使用 `Bearer` 鉴权 + 应用归因头，
+ *   `redirect: 'error'`，20 秒上限，响应体上限 2 MiB。
+ * - 与推理协议解耦：本函数不接受 protocol 参数，也不根据协议挑选路径。
+ * - 归一化只接受 `data[]` 中可用且有界的 id；已知 id 继承 catalog 的分组与能力，
+ *   新 id 一律归 `paid` 且**不**凭名称推断能力（未识别的上游能力字段直接忽略）。
+ * - 媒体输出模型（图像/视频/语音，走 `/api/v1/media/*`）不进对话目录。
+ * - 所有失败折叠为 `ModelDiscoveryError` 的固定分类与固定文字，不回显凭据、
+ *   请求头或响应体。
+ */
+import { type CatalogModel } from './catalog.js';
+/** 发现请求的总时限（毫秒）。 */
+export declare const DISCOVERY_TIMEOUT_MS = 20000;
+/** 响应体上限（字节）；超出即按格式错误拒绝，不解析部分 JSON。 */
+export declare const MAX_DISCOVERY_BODY_BYTES: number;
+/** Failure taxonomy; `status` is the HTTP status when one was received. */
+export type ModelDiscoveryErrorKind = 'url' | 'credential' | 'network' | 'timeout' | 'aborted' | 'auth' | 'permission' | 'rate-limit' | 'server' | 'response';
+/**
+ * Fixed-text discovery failure. The message is one of the constants above, so callers may
+ * log it verbatim: no credential, header, URL or upstream body is ever interpolated.
+ */
+export declare class ModelDiscoveryError extends Error {
+    readonly kind: ModelDiscoveryErrorKind;
+    readonly status?: number | undefined;
+    constructor(kind: ModelDiscoveryErrorKind, status?: number | undefined);
+}
+/**
+ * Discover the chat models an OpenAI-compatible endpoint advertises.
+ *
+ * @param openAiBaseURL Absolute HTTP(S) base URL without credentials/query/fragment.
+ * @param key Bearer credential; trimmed once, never echoed or persisted here.
+ * @param signal Caller cancellation, combined with the internal 20 s deadline.
+ * @param fetcher Optional `fetch` replacement (tests, hosts with a custom transport).
+ * @throws {ModelDiscoveryError} Fixed classification and fixed message for every failure.
+ */
+export declare function fetchModelCatalog(openAiBaseURL: string, key: string, signal?: AbortSignal, fetcher?: typeof fetch): Promise<readonly CatalogModel[]>;

package/lib/model-settings.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 逐模型设置：用户在目录行之上显式覆盖的发送参数与容量。
+ *
+ * 独立于模型发现与推理协议：这里只做形状校验与副本合成，不读凭据、不联网、
+ * 也不判断某个推理协议是否支持这些字段（兼容性由适配器在组装请求时决定）。
+ *
+ * 安全约定：
+ * - 采用字段白名单，任何未知字段一律拒绝，避免 `apiKey`/`headers` 之类秘密或
+ *   不可序列化值借道设置对象进入持久化。
+ * - 拒绝 `__proto__` / `constructor` / `prototype` 作为模型 ID，防原型污染。
+ * - 只返回新对象：不把外部引用（数组、嵌套对象、目录行）交给调用方，也不改入参。
+ * - 错误文字固定，不回显设置值或模型 ID。
+ */
+import type { CatalogModel } from './catalog.js';
+/** One model's optional overrides; every field absent means "inherit the catalog row". */
+export interface ModelSettings {
+    /** 是否出现在模型选择器；缺省视为启用。 */
+    enabled?: boolean;
+    /** 采样温度，0–2。 */
+    temperature?: number;
+    /** 核采样，0–1。 */
+    topP?: number;
+    /** 单次输出上限；覆盖目录行的 maxOutputTokens。 */
+    maxTokens?: number;
+    /** 上下文窗口；覆盖目录行的 contextWindow。 */
+    contextWindow?: number;
+    /** 思考深度；只允许目录同一套档位。 */
+    reasoningEffort?: string;
+}
+/** Model id → settings. Keys are model ids, never provider-scoped. */
+export type ModelSettingsMap = Record<string, ModelSettings>;
+/**
+ * Validate an untrusted settings payload (settings store, credential-free Host state)
+ * into a fresh map. Rejects non-objects, oversized maps, reserved/unsafe ids, unknown
+ * fields and out-of-range values; never returns the input's objects or arrays.
+ */
+export declare function parseModelSettingsMap(value: unknown): ModelSettingsMap;
+/**
+ * Copy a catalog row and apply the user's explicit capacity overrides. The input row and
+ * its arrays are never mutated; other overrides (sampling, effort) belong to the request,
+ * not to the catalog row, so they are not folded in here.
+ */
+export declare function applyModelSettings(row: CatalogModel, settings?: ModelSettings): CatalogModel;
+/** A model is selectable unless the map explicitly disables it; unknown ids and an absent map stay enabled. */
+export declare function isModelEnabled(id: string, settings?: ModelSettingsMap): boolean;

package/lib/protocol-options.d.ts

@@ -0,0 +1,11 @@
+export declare const API_PROTOCOL_IDS: readonly ["chat-completions", "responses", "messages"];
+export type ApiProtocol = typeof API_PROTOCOL_IDS[number];
+/** The public gateway origin and an explicit versioned API base are both accepted. */
+export declare function openAiBaseURL(baseURL: string): string;
+/** Shared by request builders and the settings preview so their paths cannot diverge. */
+export declare function inferenceEndpoint(baseURL: string, protocol: ApiProtocol): string;
+export declare const API_PROTOCOL_OPTIONS: readonly {
+    id: ApiProtocol;
+    name: string;
+    description: string;
+}[];

package/lib/protocols/chat-completions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenAI Chat Completions 协议（既有实现的唯一包装点）。
+ *
+ * 请求投影继续复用 `conversion.ts` 的 chat 消息/工具投影与思考回放规则；
+ * 流式解析继续复用 `stream.ts#consumeSse`，因此该协议的行为与拆分前完全一致。
+ */
+import type { Protocol, ProtocolContext, WireRequest } from './types.js';
+/** 构造 Chat Completions 请求。 */
+export declare function buildChatCompletionsRequest(ctx: ProtocolContext): WireRequest;
+export declare const chatCompletions: Protocol;

package/lib/protocols/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 上游失败的稳定分类。
+ *
+ * 三种协议的信封不同，但对外只暴露固定的中文文字与机器码；上游 `message`、请求头、
+ * 凭据与响应体一律不进入错误文字，避免密钥或第三方内容进入日志与 UI。
+ *
+ * 判定顺序（前者优先）：
+ * 1. 信封内结构化的 `code` / `type`：只认明确的枚举式写法；
+ * 2. 主题明确的 `message`：上下文溢出、额度耗尽、限流、超时、服务端、认证/权限；
+ * 3. HTTP 状态：仅作为补充事实，不覆盖上面更具体的分类；唯一例外是 5xx——
+ *    没有结构化代码时直接按服务端处理（504 仍按超时），不因正文措辞改判。
+ *
+ * 关键取舍：
+ * - 额度分两池：套餐/订阅/账户额度 → `ACCOUNT_QUOTA`；钱包/充值/积分/余额 → `QUOTA`。
+ *   只有“额度不足”而没有池信息时按账户额度处理。
+ * - 普通 401/403 只表达认证或权限语义（`AUTH` / `PERMISSION`），不推断 API Key 无效；
+ *   只有上游明确点名 Key/凭据无效或缺失（结构化 code 或明确文案）才是 `INVALID_CREDENTIAL`。
+ *   结构化只给出认证/权限语义时，点名 Key 的明确文案可以把结论细化为凭据错误。
+ * - `quota` / `context` 单独出现只是背景词；必须同时出现“耗尽/超出”等语义才算数，
+ *   因此 `rate_limit_exceeded` 不会被泛化成额度不足，也不会因为正文提到“上下文缓存”而误判。
+ * - HTTP 状态与结构化错误冲突时以结构化错误为准：典型的 429 + `insufficient_quota`
+ *   归入额度而不是限流，401 + 额度证据归入额度而不是认证。
+ */
+import { LlmError } from '@deepseek-ai/dsh-llm';
+/**
+ * OpenAI 风格信封：`{ error: { code, type, message } }`（Chat Completions 与 Responses 实测一致）。
+ *
+ * @param status 上游 HTTP 状态；流内错误事件没有状态时省略。
+ * @param body 已解析的响应体或流事件。
+ */
+export declare function gatewayError(status: number | undefined, body: unknown): LlmError;
+/**
+ * Anthropic 风格信封：`{ type: "error", error: { type, message } }`（Messages 端点实测）。
+ *
+ * @param status 上游 HTTP 状态；流内错误事件没有状态时省略。
+ * @param body 已解析的响应体或流事件。
+ */
+export declare function anthropicError(status: number | undefined, body: unknown): LlmError;
+/**
+ * 流内错误事件（HTTP 已是 200，错误只能作为事件到达）。
+ *
+ * @param error 事件里的错误对象（两种信封都可）。
+ * @param fallback 无法归类时使用的机器码，默认按格式错误处理。
+ */
+export declare function inBandError(error: unknown, fallback?: string): LlmError;

package/lib/protocols/headers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 三种推理协议共用的请求头。
+ *
+ * 每个上游请求都必须携带应用归因头（`attributionHeaders()`）；鉴权一律走
+ * `Authorization: Bearer`——CoRouter 官方站点对 OpenAI 兼容调用与 Claude Code
+ * （`ANTHROPIC_AUTH_TOKEN`）都使用该头，因此 Messages 协议不额外发送第二个密钥头。
+ */
+/**
+ * 构造流式推理请求头。
+ *
+ * @param apiKey 已由适配器校验可用的凭据；此处只做拼接，不回显、不记录。
+ * @param extra 协议专属头（如 `anthropic-version`）。
+ */
+export declare function streamHeaders(apiKey: string, extra?: Readonly<Record<string, string>>): Record<string, string>;

package/lib/protocols/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 三种线协议的公开入口。
+ *
+ * 模型发现（OpenAI `GET /models`）与推理协议解耦：无论这里选中哪种协议，
+ * 目录拉取始终走 OpenAI 兼容端口，见 `model-discovery.ts`。
+ */
+import type { ApiProtocol } from '../protocol-options.js';
+import type { Protocol } from './types.js';
+/**
+ * 按配置 id 取协议实现。
+ *
+ * @param id 设置里保存的协议 id（来自固定三种）。
+ * @throws {LlmError} 配置里出现未知 id（例如降级安装保留了更新版本的设置）。
+ */
+export declare function protocolFor(id: ApiProtocol): Protocol;
+export type { Protocol, ProtocolContext, WireRequest } from './types.js';
+export { MESSAGES_DEFAULT_MAX_TOKENS, messagesURL } from './messages.js';

package/lib/protocols/messages.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Anthropic Messages 协议。
+ *
+ * 端点：Base URL 可以是网关根（官方 `ANTHROPIC_BASE_URL` 形式）或已带 `/v1` 的推理 Base，
+ * 两种都会补成 `<base>/v1/messages`。鉴权沿用 CoRouter 官方 Claude Code 配置里的
+ * `Authorization: Bearer`，外加标准 `anthropic-version`；不额外发送第二个密钥头。
+ *
+ * 不支持项按显式失败处理，不静默丢弃：
+ * - 请求无 `max_tokens` 时用保守默认 4096（适配器元数据同步该默认值，用户可按模型覆盖）；
+ * - `reasoningEffort` 按现代 Messages 标准投影为 `thinking: {type:'adaptive'}` +
+ *   `output_config.effort`；`none` 投影为 `thinking: {type:'disabled'}`；`minimal`/`ultra`
+ *   等没有对应 effort 的档位抛 UNSUPPORTED_OPTION；
+ * - `temperature`/`top_p` 等采样参数原样透传，其取值限制（只针对特定 Claude 代际）与
+ *   「仅接受 enabled + budget_tokens 的 legacy 模型」能否使用，都由上游按实际模型判定，
+ *   本模块不做本地推断，而是把上游拒绝分类上报；
+ * - 历史 assistant 的 reasoning 块没有 Anthropic 签名，**不回放**（伪造签名会污染上下文），
+ *   只把本轮 `thinking_delta` 映射成 reasoning 输出块。
+ */
+import { type StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { Protocol, ProtocolContext, WireRequest } from './types.js';
+/** 未显式给出 `max_tokens` 时的保守默认值（与适配器元数据一致）。 */
+export declare const MESSAGES_DEFAULT_MAX_TOKENS = 4096;
+/** 网关根或 `/v1` Base 都补成 `/v1/messages`。 */
+export declare function messagesURL(baseURL: string): string;
+/** 构造 Messages 请求。 */
+export declare function buildMessagesRequest(ctx: ProtocolContext): WireRequest;
+/** 把 Messages 的 SSE 事件翻译成 DSH 流式块。 */
+export declare function streamMessages(body: ReadableStream<Uint8Array>, signal: AbortSignal, idleMs: number): AsyncGenerator<StreamChunk>;
+export declare const messages: Protocol;

package/lib/protocols/parts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 消息内容的模态投影（Responses / Messages 共用）。
+ *
+ * 与 Chat Completions 的 `conversion.ts#parts` 保持同一语义：文本直出，可解析的图片变成
+ * 图片 URL，无法解析或已 offload 的图片退化为命名占位文本，原始文件句柄直接拒绝。
+ */
+import { type ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+/** 图片附件 → 请求体可用的 URL（通常是 data URL）。 */
+export type ImageLookup = (ref: ImageAttachmentRef) => string | undefined;
+/** 一段消息投影后的文本与图片。 */
+export interface ProjectedContent {
+    text: string;
+    images: string[];
+}
+/**
+ * 投影一个消息的文本与图片。
+ *
+ * @param blocks 消息内容块。
+ * @param image 图片解析器；未提供时所有图片退化为占位文本。
+ */
+export declare function projectContent(blocks: readonly ContentBlock[], image?: ImageLookup): ProjectedContent;

package/lib/protocols/responses.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenAI Responses 协议（无状态：`store: false` + 每次发送完整 `input`）。
+ *
+ * 为什么坚持无状态：DSH 的请求是会话日志的纯函数，适配器不持久化 `previous_response_id`，
+ * 因此重放、重试与并行分支都不会依赖服务端会话；代价是 reasoning 项无法回放——Responses
+ * 只在带 `encrypted_content` 时允许跨轮重放推理项，本插件不保存该内容，所以历史推理只映射
+ * 为本轮可见的 reasoning 块，再次请求时不会伪装成已签名的上下文。
+ *
+ * 终止语义（官方 `response.completed` / `response.incomplete` / `response.failed`）：
+ * - `completed`：有 `function_call` 项 → tool-calls，否则 stop；
+ * - `incomplete`：`max_tokens`/`max_output_tokens` → max-tokens（截断**不**当成功全文），
+ *   `content_filter` 与其它原因 → 直接失败，绝不产出 finish；
+ * - `failed` 或流内 `error` 事件 → 按固定分类抛错，不回显上游正文。
+ */
+import { type StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { Protocol, ProtocolContext, WireRequest } from './types.js';
+/**
+ * 构造 Responses 请求。
+ *
+ * 消息投影：system/developer 文本进 `instructions`（DSH 未声明 in-history 系统提示更新，
+ * 完整系统提示每轮都在开头，合并后语义不变）；assistant 文本 + `function_call` 项；
+ * tool 结果变 `function_call_output`，其中的图片提升到紧随其后的 user 输入项。
+ */
+export declare function buildResponsesRequest(ctx: ProtocolContext): WireRequest;
+/**
+ * 把 Responses 的 SSE 事件翻译成 DSH 流式块。
+ *
+ * 支持交错输出项（文本 / 工具调用 / 推理），按首次出现顺序分配块索引；
+ * 只出现在终态 `output` 里的项也会补成块，避免“终态才给内容”的网关被误判为空响应。
+ */
+export declare function streamResponses(body: ReadableStream<Uint8Array>, signal: AbortSignal, idleMs: number): AsyncGenerator<StreamChunk>;
+export declare const responses: Protocol;

package/lib/protocols/sse.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 协议无关的 SSE 分帧。
+ *
+ * 只负责传输层：把字节流按 SSE 行协议切成 `event:` + 多行 `data:` 帧，并统一强制
+ * 取消、空闲超时与大小上限。事件语义（JSON 结构、终止、usage）由各协议模块解释。
+ *
+ * 边界与既有 Chat Completions 实现一致，便于回归：
+ * - CRLF 可能被拆到两个传输块之间，保留尾部 CR。
+ * - 单事件累计 `data` 与单行缓冲都不得超过 4 MiB；超限按格式错误拒绝，不截断解析。
+ * - 空闲超过 `idleMs` 抛 TIMEOUT；`signal` 中止时抛出 signal 的原因。
+ * - 无论成功、异常还是消费方提前 `break`，都会 cancel 并释放上游 reader。
+ */
+/** 一帧 SSE 事件：`event:` 名（可选）+ 合并后的 `data` 载荷。 */
+export interface SseFrame {
+    readonly event?: string;
+    readonly data: string;
+}
+/**
+ * 逐帧产出 SSE 事件。
+ *
+ * @param body 上游响应体；结束时由本生成器负责 cancel。
+ * @param signal 调用方取消信号（已与超时合并）。
+ * @param idleMs 两次读到数据之间的最长等待毫秒数。
+ */
+export declare function sseFrames(body: ReadableStream<Uint8Array>, signal: AbortSignal, idleMs: number): AsyncGenerator<SseFrame>;

package/lib/protocols/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 协议模块的公共契约。
+ *
+ * 适配器只负责：选定模型、准备凭据、解析图片、收敛 `maxTokens`、合并每模型默认值，
+ * 然后把一次调用的**全部输入**交给协议模块。协议模块独占三件事：请求 URL/头/体、
+ * 流式事件到 `StreamChunk` 的翻译、以及该协议的错误信封。
+ */
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { CatalogModel } from '../catalog.js';
+import type { ApiProtocol } from '../protocol-options.js';
+/** 一次推理调用的协议无关输入。 */
+export interface ProtocolContext {
+    /** 上游 Base URL（已校验为绝对地址，去尾斜杠）。 */
+    baseURL: string;
+    /** 已校验可用的凭据。 */
+    apiKey: string;
+    /** 本次调用的目录模型（能力、限额来源）。 */
+    model: CatalogModel;
+    /** 已由适配器合并每模型默认值的请求。 */
+    options: GenerateOptions;
+    /** 附件 id → 可直接放进请求体的图片 URL。 */
+    images: ReadonlyMap<string, string>;
+    /** 每模型可选 `top_p`；未设置时不发送。 */
+    topP?: number;
+}
+/** 一个可直接 fetch 的请求。 */
+export interface WireRequest {
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+}
+/** 一种线协议的实现。 */
+export interface Protocol {
+    readonly id: ApiProtocol;
+    /** 把协议无关调用投影成本协议的请求。 */
+    build(ctx: ProtocolContext): WireRequest;
+    /** 把上游 SSE 响应体翻译成 DSH 流式块。 */
+    stream(body: ReadableStream<Uint8Array>, signal: AbortSignal, idleMs: number): AsyncIterable<StreamChunk>;
+}

package/lib/protocols/usage.d.ts

@@ -0,0 +1,34 @@
+/**
+ * usage 归一化：把上游计数折算成 DSH 的**不相交**口径。
+ *
+ * `TokenUsage.inputTokens` 只计未缓存输入；缓存读取/写入单独上报，三者相加才是计费输入。
+ * 两套上游口径不同，必须分开处理：
+ * - OpenAI（Chat / Responses）的输入总数**包含**缓存命中，需要减出来；
+ * - Anthropic Messages 的 `input_tokens` **不含**缓存读取与缓存写入，直接对应。
+ *
+ * 任何非法或自相矛盾的缓存计数都会被丢弃，而不是产生负数或凭空的输入量。
+ */
+import type { TokenUsage } from '@deepseek-ai/dsh-llm';
+/** 上游原始计数（缺省或非法一律视为未知）。 */
+export interface RawUsage {
+    input?: number | undefined;
+    output?: number | undefined;
+    cacheRead?: number | undefined;
+    cacheWrite?: number | undefined;
+    reasoning?: number | undefined;
+    total?: number | undefined;
+}
+/**
+ * OpenAI 口径：`input` 含缓存命中。
+ *
+ * @param raw 上游计数。
+ * @returns 归一化 usage；输入或输出缺失、为负时返回 undefined。
+ */
+export declare function openAiUsage(raw: RawUsage): TokenUsage | undefined;
+/**
+ * Anthropic 口径：`input` 不含缓存，缓存读取/写入是独立计数。
+ *
+ * @param raw 上游计数。
+ * @returns 归一化 usage；输入或输出缺失、为负时返回 undefined。
+ */
+export declare function anthropicUsage(raw: RawUsage): TokenUsage | undefined;

package/lib/quota.d.ts

@@ -14,6 +14,10 @@ export interface QuotaWindow {
     remaining?: number;
     percent: number;
     resetsAt?: string;
+    /** Window start as reported by coding-plan-usage (ISO-8601); never derived from the reset time. */
+    windowStart?: string;
+    /** Service-side window policy (`activity_triggered`, `anchored_recurring`, ...), when reported. */
+    resetMode?: string;
 }
 export interface QuotaSnapshot {
     state: 'ok' | 'partial' | 'need-login' | 'error';
@@ -27,6 +31,20 @@ export interface QuotaSnapshot {
         rechargeUsd?: number;
         totalUsd?: number;
     };
+    /**
+     * Billing-period boundaries of the subscription pool (ISO-8601), from
+     * `billing/summary`'s `subscriptionCurrentPeriodStart/End`. `End` is when the
+     * plan model credits refresh — distinct from a rolling window's `resetsAt`.
+     */
+    subscriptionPeriodStart?: string;
+    subscriptionPeriodEnd?: string;
+    /** Next client-side read, owned by the host cache policy; this module never invents it. */
+    nextRefreshAt?: string;
+    /** A failed non-auth refresh retained the previous successful readings. */
+    stale?: boolean;
+    /** Consecutive failed automatic reads; manual refresh starts a new bounded sequence. */
+    refreshFailures?: number;
+    autoRefreshPaused?: boolean;
     note?: string;
 }
 export declare class ConsoleError extends Error {
@@ -35,6 +53,8 @@ export declare class ConsoleError extends Error {
     constructor(kind: 'auth' | 'permission' | 'network' | 'response' | 'rate-limit', status?: number | undefined);
 }
 export declare function consoleJson(url: string, session: Session, signal?: AbortSignal, fetcher?: typeof fetch): Promise<unknown>;
-export declare function normalizeQuota(body: unknown, summary?: unknown): Pick<QuotaSnapshot, 'windows' | 'balances' | 'tier' | 'eligible'>;
+export declare function normalizeQuota(body: unknown, summary?: unknown): Pick<QuotaSnapshot, 'windows' | 'balances' | 'tier' | 'eligible' | 'subscriptionPeriodStart' | 'subscriptionPeriodEnd'>;
+/** Billing period of the subscription pool; absent fields stay unknown, never derived. */
+export declare function normalizeSubscription(summary: unknown): Pick<QuotaSnapshot, 'subscriptionPeriodStart' | 'subscriptionPeriodEnd'>;
 export declare function normalizeBalances(summary: unknown): QuotaSnapshot['balances'];
 export declare function readQuota(session: Session, signal?: AbortSignal, fetcher?: typeof fetch): Promise<QuotaSnapshot>;

package/lib/remote.d.ts

@@ -1,5 +1,7 @@
 /** Shared JSON value types and allowlist parsers; no credential or opaque Host state is returned. */
 import type { QuotaSnapshot, SessionSource } from './quota.js';
+import { type ApiProtocol } from './protocol-options.js';
+import { type ModelSettingsMap } from './model-settings.js';
 export type { QuotaSnapshot, QuotaWindow, SessionSource } from './quota.js';
 /** npm package that owns the Remote methods; must satisfy typert's segment rules. */
 export declare const REMOTE_PACKAGE = "dsh-opendesign-corouter";
@@ -12,12 +14,21 @@ export interface StatusConfig {
     baseURL: string;
     /** Credential reference name (an env var or a DSH credential ref), never the value. */
     apiKeyEnv: string;
+    apiProtocol?: ApiProtocol;
+    modelSettings?: ModelSettingsMap;
+    requestTimeoutMs?: number;
+    streamIdleTimeoutMs?: number;
+    quotaRefreshSeconds?: number;
 }
 /** One selectable model; `group` selects which of the two Providers owns it. */
 export interface StatusModel {
     id: string;
     name: string;
     group: 'plan' | 'paid';
+    enabled?: boolean;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    reasoningEfforts?: readonly string[];
 }
 /** Terminal-or-in-flight phases a login job may report. */
 export type LoginPhase = 'idle' | 'launching' | 'waiting' | 'verifying' | 'success' | 'cancelled' | 'error';
@@ -41,6 +52,9 @@ export interface Status {
     /** Turns the empty-turn guard actually intercepted since process start. */
     guardedTurns: number;
     models: readonly StatusModel[];
+    modelsSource?: 'builtin' | 'openai';
+    modelsUpdatedAt?: string;
+    modelsError?: string;
 }
 export interface StartLoginRequest {
     expectedRevision: string;

package/lib/stream.d.ts

@@ -1,5 +1,13 @@
-import { LlmError, type StreamChunk, type TokenUsage } from '@deepseek-ai/dsh-llm';
-export declare function gatewayError(status: number | undefined, body: unknown): LlmError;
+/**
+ * Chat Completions 的流式投影与共享错误分类。
+ *
+ * 分帧已抽到 `protocols/sse.ts`（三种协议共用同一套取消/空闲/大小边界），这里只保留
+ * Chat Completions 的事件语义；`gatewayError` 也从 `protocols/errors.ts` 统一提供，
+ * 以保持既有 `import { gatewayError } from './stream.js'` 的调用点不变。
+ */
+import { type StreamChunk, type TokenUsage } from '@deepseek-ai/dsh-llm';
+export { gatewayError } from './protocols/errors.js';
+/** Chat Completions 的 `usage` 折算（`prompt_tokens` 含缓存，按不相交口径减出）。 */
 export declare function tokenUsage(value: Record<string, unknown>): TokenUsage | undefined;
-/** Bounded SSE framing; a broken/truncated response is never reported as success. */
+/** Bounded SSE projection for Chat Completions; a broken/truncated response is never reported as success. */
 export declare function consumeSse(body: ReadableStream<Uint8Array>, signal: AbortSignal, idleMs: number): AsyncGenerator<StreamChunk>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opendesign-corouter",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "OpenDesign CoRouter：套餐赠送与付费模型双 Provider、桌面登录态额度及独立登录",
   "type": "module",
   "license": "MIT",