@tnnevol/dsh-zcode 0.0.0-stage → 6.0.0

package/lib/catalog-CnI_VsFm.d.ts

@@ -0,0 +1,186 @@
+import { D as ZCodeFamily, i as ZCodeClientModel, o as ZCodeConsoleClient, u as ZCodeRawBalance } from "./console-client-54wUcPDA.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/contracts/catalog.d.ts
+/** 网关承载的协议族；当前只有 Anthropic Messages。 */
+type ZCodeApiKind = 'anthropic-messages';
+/** pi-ai 的思考等级全集，顺序即选择器展示顺序。 */
+declare const ZCODE_REASONING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ZCodeReasoningLevel = typeof ZCODE_REASONING_LEVELS[number];
+/** 思考等级 → 线上取值；`null` 表示该等级不受支持。 */
+type ZCodeThinkingLevelMap = Partial<Record<ZCodeReasoningLevel, string | null>>;
+/** 一个可在 DSH 中使用的 ZCode 模型。 */
+interface ZCodeModel {
+  /** 网关模型 id（如 `GLM-5.3`），发请求时原样使用。 */
+  readonly id: string;
+  /** 选择器显示名。 */
+  readonly name: string;
+  readonly description?: string;
+  readonly family?: string;
+  readonly api: ZCodeApiKind;
+  /** 该协议族的完整请求端点前缀（不含 `/messages`）。 */
+  readonly baseURL: string;
+  readonly reasoning: boolean;
+  readonly thinkingLevelMap?: ZCodeThinkingLevelMap;
+  readonly input: readonly ('text' | 'image')[];
+  readonly contextWindow: number;
+  readonly maxTokens: number;
+  /** 是否支持工具调用。 */
+  readonly tools: boolean;
+  /** 是否支持结构化输出。 */
+  readonly structuredOutput?: boolean;
+  /** 模型归属的账号家族；换家族后同一模型可能不可用。 */
+  readonly accountFamily: ZCodeFamily;
+  /** 该模型在额度接口里的 capability 原文（如 `model:glm-5.3`）。 */
+  readonly capability?: string;
+}
+/** 额度周期：由窗口时长推导，上游没有这个字段。 */
+type ZCodeBalancePeriod = 'daily' | 'weekly' | 'monthly' | 'one_time' |
+/** 窗口不对应任何标准周期（例如「激活到套餐结束」的剩余时段）。 */
+'custom' | 'unknown';
+/** 额度条目：某个模型在某个周期内的用量。 */
+interface ZCodeBalanceEntry {
+  /** 上游额度 id。 */
+  readonly entitlementId: string;
+  /** 展示名（如 `GLM-5.3`）。 */
+  readonly showName: string;
+  /** 对应的 capability（如 `model:glm-5.3`）。 */
+  readonly capability?: string;
+  readonly totalUnits: number;
+  readonly usedUnits: number;
+  readonly remainingUnits: number;
+  /** 周期，由 {@link deriveBalancePeriod} 从窗口时长推导。 */
+  readonly period: ZCodeBalancePeriod;
+  /** 周期与过期时间的 epoch 毫秒；上游返回的是 Unix 秒。 */
+  readonly periodStart?: number | undefined;
+  readonly periodEnd?: number | undefined;
+  readonly expiresAt?: number | undefined;
+  /** 该额度所属套餐 id；同一模型在多份套餐下会有多条额度。 */
+  readonly planId?: string | undefined;
+}
+/** 套餐记录。 */
+interface ZCodePlanEntry {
+  readonly planId: string;
+  readonly name?: string;
+  readonly status?: string;
+  readonly endsAt?: string;
+}
+/** 目录快照。 */
+interface ZCodeCatalog {
+  /** 快照生成时间（epoch ms）。 */
+  readonly fetchedAt: number;
+  /**
+   * `balance`：清单与额度来自账号权益，可信；
+   * `builtin`：额度接口不可读，只用了内置兜底清单。
+   */
+  readonly source: 'balance' | 'builtin';
+  readonly models: readonly ZCodeModel[];
+  /** 账号当前生效的套餐。 */
+  readonly plans: readonly ZCodePlanEntry[];
+  /** 额度条目（可能包含目录里没出现的模型）。 */
+  readonly balances: readonly ZCodeBalanceEntry[];
+  /** 解析期间的降级说明，用于界面提示。 */
+  readonly warnings: readonly string[];
+}
+/**
+ * 把 `capability` 还原成模型 id。
+ *
+ * 上游写法是 `model:<小写 id>`（如 `model:glm-5.3`），而网关接受的模型 id
+ * 是官方大小写形态（`GLM-5.3`）。这里只剥前缀并保留原始大小写，大小写归一
+ * 交给 {@link normalizeModelId}。
+ */
+declare function modelIdOfCapability(capability: string): string | undefined;
+/** 把模型 id 归一成官方大小写；未命中时原样返回。 */
+declare function normalizeModelId(id: string): string;
+/** 目录中真正可用的模型（当前全部可对话，保留过滤钩子便于将来扩展）。 */
+declare function selectableModels(catalog: ZCodeCatalog): readonly ZCodeModel[];
+/** 按 id 找模型。 */
+declare function findModel(catalog: ZCodeCatalog, id: string): ZCodeModel | undefined;
+//#endregion
+//#region src/host/catalog.d.ts
+/**
+ * 未在 `client/configs` 里描述时的兜底能力。
+ *
+ * 取 GLM-5 系列的实际取值：40 万上下文、8 万最大输出。宁可保守（更早提示
+ * 上下文超限），也不要把上限猜高导致请求被网关拒绝。
+ */
+declare const ZCODE_FALLBACK_CONTEXT_WINDOW = 400000;
+declare const ZCODE_FALLBACK_MAX_TOKENS = 80000;
+/**
+ * 内置兜底模型清单。
+ *
+ * 与 ZCode 内置 provider 规则的 `builtinModelIds` 一致；只在额度接口不可读时
+ * 使用，用于保证未登录状态下的选择器不是空的。
+ */
+declare const ZCODE_BUILTIN_MODEL_IDS: readonly string[];
+/**
+ * 思考等级映射。
+ *
+ * GLM 系列在 Anthropic 协议下用 `thinking` 块表达推理，pi-ai 的等级键与上游
+ * 取值不是一一对应：`off` 表示不请求思考，其余按强度映射到上游 `low` /
+ * `high` / `max` 三档。上游只认这三档，因此中间等级向上取整而不是透传，
+ * 否则会得到 400。
+ */
+declare function thinkingLevelMapOf(levels: readonly string[] | undefined): {
+  map: ZCodeThinkingLevelMap;
+  reasoning: boolean;
+};
+/**
+ * 上游是否因凭据失效而拒绝。
+ *
+ * ZCode 的账号令牌有有效期，过期后额度接口返回 HTTP 401（无错误信封）。
+ * 这个状态与「网络不通」「没有套餐」的处理方式完全不同，必须先分开。
+ */
+declare function isUnauthorized(error: unknown): boolean;
+/** 把一个额度 capability 投影成模型。 */
+declare function toModel(params: {
+  readonly id: string;
+  readonly capability?: string;
+  readonly clientModel?: ZCodeClientModel;
+  readonly family: ZCodeFamily;
+}): ZCodeModel;
+/** 从额度条目推导模型 id 列表（保序去重）。 */
+declare function modelIdsFromBalances(balances: readonly ZCodeBalanceEntry[]): string[];
+/** 把额度条目归一成契约形状（周期由窗口时长推导）。 */
+declare function toBalanceEntries(balances: readonly ZCodeRawBalance[]): ZCodeBalanceEntry[];
+/**
+ * 同一模型在多份套餐下会有多条额度，逐条展示会让界面出现重复行。
+ *
+ * 这里按「模型 + 周期」合并：保留额度最大的那条作为主额度，把其余总量累加。
+ * 累加是有意义的——两份套餐的同一模型日额度确实可以叠加使用；但**不合并
+ * 不同周期**，否则会掩盖"日额度用完但活动额度还有"。
+ */
+declare function mergeBalanceEntries(entries: readonly ZCodeBalanceEntry[]): ZCodeBalanceEntry[];
+/** 目录服务依赖。 */
+interface ZCodeCatalogServiceOptions {
+  readonly client: ZCodeConsoleClient;
+  /** 当前账号 JWT；未登录返回 undefined。 */
+  readonly resolveToken: () => Promise<string | undefined>;
+  /** 当前账号家族；未登录时为 undefined。 */
+  readonly resolveFamily: () => Promise<ZCodeFamily | undefined>;
+  readonly logger?: Pick<Context['logger'], 'warn' | 'info'>;
+  /** 快照最短复用时间（毫秒）。 */
+  readonly staleAfterMs?: number;
+  readonly now?: () => number;
+}
+/** 目录服务。 */
+declare class ZCodeCatalogService {
+  private current;
+  private inflight;
+  private readonly options;
+  constructor(options: ZCodeCatalogServiceOptions);
+  private get now();
+  /** 当前快照；从未刷新过时返回 undefined。 */
+  snapshot(): ZCodeCatalog | undefined;
+  /** 快照是否已过期。 */
+  isStale(): boolean;
+  /** 失效快照，强制下次刷新走网络。 */
+  invalidate(): void;
+  /** 已过期才刷新，否则复用。 */
+  refreshIfStale(): Promise<ZCodeCatalog>;
+  /** 强制刷新；并发调用合并成一次请求。 */
+  refresh(): Promise<ZCodeCatalog>;
+  private load;
+  private builtinCatalog;
+}
+//#endregion
+export { selectableModels as C, normalizeModelId as S, ZCodePlanEntry as _, ZCodeCatalogServiceOptions as a, findModel as b, modelIdsFromBalances as c, toModel as d, ZCODE_REASONING_LEVELS as f, ZCodeModel as g, ZCodeCatalog as h, ZCodeCatalogService as i, thinkingLevelMapOf as l, ZCodeBalanceEntry as m, ZCODE_FALLBACK_CONTEXT_WINDOW as n, isUnauthorized as o, ZCodeApiKind as p, ZCODE_FALLBACK_MAX_TOKENS as r, mergeBalanceEntries as s, ZCODE_BUILTIN_MODEL_IDS as t, toBalanceEntries as u, ZCodeReasoningLevel as v, modelIdOfCapability as x, ZCodeThinkingLevelMap as y };

package/lib/catalog.d.ts

@@ -0,0 +1,2 @@
+import { a as ZCodeCatalogServiceOptions, c as modelIdsFromBalances, d as toModel, i as ZCodeCatalogService, l as thinkingLevelMapOf, n as ZCODE_FALLBACK_CONTEXT_WINDOW, o as isUnauthorized, r as ZCODE_FALLBACK_MAX_TOKENS, s as mergeBalanceEntries, t as ZCODE_BUILTIN_MODEL_IDS, u as toBalanceEntries } from "./catalog-CnI_VsFm.js";
+export { ZCODE_BUILTIN_MODEL_IDS, ZCODE_FALLBACK_CONTEXT_WINDOW, ZCODE_FALLBACK_MAX_TOKENS, ZCodeCatalogService, ZCodeCatalogServiceOptions, isUnauthorized, mergeBalanceEntries, modelIdsFromBalances, thinkingLevelMapOf, toBalanceEntries, toModel };

package/lib/catalog.js

@@ -0,0 +1,2 @@
+import { a as isUnauthorized, c as thinkingLevelMapOf, i as ZCodeCatalogService, l as toBalanceEntries, n as ZCODE_FALLBACK_CONTEXT_WINDOW, o as mergeBalanceEntries, r as ZCODE_FALLBACK_MAX_TOKENS, s as modelIdsFromBalances, t as ZCODE_BUILTIN_MODEL_IDS, u as toModel } from "./catalog-Br2Bp6dD.js";
+export { ZCODE_BUILTIN_MODEL_IDS, ZCODE_FALLBACK_CONTEXT_WINDOW, ZCODE_FALLBACK_MAX_TOKENS, ZCodeCatalogService, isUnauthorized, mergeBalanceEntries, modelIdsFromBalances, thinkingLevelMapOf, toBalanceEntries, toModel };