@tnnevol/dsh-zcode 0.0.0-stage → 6.0.6

package/lib/catalog-Br2Bp6dD.js

@@ -0,0 +1,685 @@
+import { _ as ZCODE_USER_AGENT, a as ZCODE_ANTHROPIC_BETA, c as ZCODE_CLIENT_CONFIGS_URL, f as ZCODE_FAMILY_LABELS, l as ZCODE_CLIENT_VERSION, n as ZCODE_AGENT_CONFIGS_URL, o as ZCODE_ANTHROPIC_VERSION, p as ZCODE_OAUTH_TOKEN_URL, r as ZCODE_ANTHROPIC_BASE_URL, s as ZCODE_BALANCE_URL } from "./identity-DE3rOYuE.js";
+//#region src/contracts/catalog.ts
+/** pi-ai 的思考等级全集，顺序即选择器展示顺序。 */
+const ZCODE_REASONING_LEVELS = [
+	"off",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+/** 一天的秒数，用于推导额度周期。 */
+const DAY_SECONDS = 86400;
+/**
+* 从窗口时长推导额度周期。
+*
+* 上游的额度条目**没有** `period` 字段，只有 `period_start` / `period_end`
+* 两个 Unix 秒。早期实现读 `period` 得到 undefined，界面上所有额度都显示成
+* "其它"，用户看不出"这条是每日额度、那条是活动额度"——而这正是他判断还能
+* 不能继续用的关键。
+*
+* 判定按"接近某个标准周期"而不是"不超过某个上界"：日额度窗口实测是
+* 86,399 秒（起止都取整点边界，差 1 秒），而某些套餐的额度窗口是"激活时刻
+* 到套餐结束"，实测 168,557 秒（约 1.95 天）。用上界判定会把后者误标成
+* "每周"——那是一条两天后就要重置的额度，标成每周等于给了错误预期。
+* 因此每个周期给一个带宽，落不进任何带宽的标为 `custom`。
+*/
+function deriveBalancePeriod(periodStart, periodEnd) {
+	if (periodStart === void 0 || periodEnd === void 0) return "unknown";
+	const seconds = periodEnd - periodStart;
+	if (!Number.isFinite(seconds) || seconds <= 0) return "unknown";
+	const days = seconds / DAY_SECONDS;
+	if (days >= .9 && days <= 1.1) return "daily";
+	if (days >= 6.5 && days <= 7.5) return "weekly";
+	if (days >= 27 && days <= 32) return "monthly";
+	if (days >= 180) return "one_time";
+	return "custom";
+}
+/**
+* 把 `capability` 还原成模型 id。
+*
+* 上游写法是 `model:<小写 id>`（如 `model:glm-5.3`），而网关接受的模型 id
+* 是官方大小写形态（`GLM-5.3`）。这里只剥前缀并保留原始大小写，大小写归一
+* 交给 {@link normalizeModelId}。
+*/
+function modelIdOfCapability(capability) {
+	const trimmed = capability.trim();
+	if (!trimmed.toLowerCase().startsWith("model:")) return void 0;
+	const id = trimmed.slice(6).trim();
+	return id.length === 0 ? void 0 : id;
+}
+/**
+* 官方模型 id 的大小写映射表。
+*
+* 额度接口给的是小写 id，网关要的是官方拼写；这份表与 ZCode 客户端内置的
+* 归一化表一致，用于把 `glm-5.3` 还原成 `GLM-5.3`，未命中的保持原样。
+*/
+const OFFICIAL_MODEL_IDS = new Map([
+	"GLM-5.3",
+	"GLM-5.3-Flash",
+	"GLM-5V-Turbo",
+	"GLM-5.2",
+	"GLM-5.1",
+	"GLM-5.1-Highspeed",
+	"GLM-5",
+	"GLM-5-Turbo",
+	"GLM-4.7",
+	"GLM-4.7-FlashX",
+	"GLM-4.7-Flash",
+	"GLM-4.6",
+	"GLM-4.5-Air",
+	"GLM-4.5",
+	"GLM-4.6V",
+	"GLM-4.6V-Flash",
+	"GLM-4.6V-FlashX",
+	"GLM-4.1V-Thinking-FlashX",
+	"GLM-4.1V-Thinking-Flash",
+	"GLM-4-FlashX-250414",
+	"GLM-4-Flash-250414",
+	"GLM-4V-Flash"
+].map((id) => [id.toLowerCase(), id]));
+/** 把模型 id 归一成官方大小写；未命中时原样返回。 */
+function normalizeModelId(id) {
+	const trimmed = id.trim();
+	if (trimmed.length === 0) return trimmed;
+	return OFFICIAL_MODEL_IDS.get(trimmed.toLowerCase()) ?? trimmed;
+}
+/** 目录中真正可用的模型（当前全部可对话，保留过滤钩子便于将来扩展）。 */
+function selectableModels(catalog) {
+	return catalog.models;
+}
+/** 按 id 找模型。 */
+function findModel(catalog, id) {
+	return catalog.models.find((model) => model.id === id);
+}
+//#endregion
+//#region src/host/console-client.ts
+/**
+* ZCode 控制面客户端：OAuth 授权码换取、额度、客户端配置。
+*
+* 三个接口共享一套「ZCode 客户端身份头」（{@link zcodeSourceHeaders}）。
+* 这不是可选装饰：额度接口在没有 `X-Device-Mid` 时直接返回
+* `{"code":3001,"msg":"parameter error"}`，而 `X-Device-Mid` 必须是稳定值，
+* 否则同一个账号每次请求都会被当成新设备——额度接口会要求重新授权。
+*
+* 失败一律抛 {@link ZCodeConsoleError}，带上游业务码，让上层能区分
+* 「未登录」「无权益」「被限流」并给出可读提示。
+*
+* @module dsh-zcode/console-client
+*/
+/** 上游业务错误。 */
+var ZCodeConsoleError = class extends Error {
+	code;
+	status;
+	detail;
+	constructor(message, code, status, detail) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.detail = detail;
+		this.name = "ZCodeConsoleError";
+	}
+};
+const DEFAULT_TIMEOUT_MS = 2e4;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pickString(source, key) {
+	const value = source[key];
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function pickNumber(source, key) {
+	const value = source[key];
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/**
+* ZCode 客户端身份头。
+*
+* `x-client-language` / `x-client-timezone` / `x-os-*` 参与网关的来源归因，
+* 固定成稳定值比"跟随运行环境"更可靠：服务端对同一账号看到一致指纹。
+*/
+function zcodeSourceHeaders(deviceMid) {
+	return {
+		"http-referer": "https://zcode.z.ai",
+		"user-agent": ZCODE_USER_AGENT,
+		"x-app-id": "zcode",
+		"x-client-language": "zh-CN",
+		"x-client-timezone": "Asia/Shanghai",
+		"x-client-version": ZCODE_CLIENT_VERSION,
+		"x-device-mid": deviceMid,
+		"x-os-category": process.platform === "darwin" ? "macos" : process.platform === "win32" ? "windows" : "linux",
+		"x-os-version": process.version.replace(/^v/, ""),
+		"x-platform": `${process.platform}-${process.arch}`,
+		"x-release-channel": "production",
+		"x-title": "Z Code@cli",
+		"x-zcode-agent": "glm",
+		"x-zcode-app-version": ZCODE_CLIENT_VERSION
+	};
+}
+/** 推理请求头：在客户端身份头上补 Anthropic 协议头与凭据。 */
+function zcodeModelHeaders(deviceMid, token) {
+	return {
+		...zcodeSourceHeaders(deviceMid),
+		"content-type": "application/json",
+		"anthropic-version": ZCODE_ANTHROPIC_VERSION,
+		"anthropic-beta": ZCODE_ANTHROPIC_BETA,
+		authorization: `Bearer ${token}`,
+		"x-api-key": token
+	};
+}
+/** 把上游 JSON 信封解出 `data`；业务码非 0 时抛出带码错误。 */
+function unwrapEnvelope(payload, status, url) {
+	if (!isRecord(payload)) throw new ZCodeConsoleError(`${url} 返回了非对象响应`, void 0, status);
+	const code = pickNumber(payload, "code");
+	if (code !== void 0 && code !== 0) throw new ZCodeConsoleError(pickString(payload, "msg") ?? `上游业务码 ${code}`, code, status, JSON.stringify(payload).slice(0, 500));
+	return payload.data;
+}
+/** ZCode 控制面客户端。 */
+var ZCodeConsoleClient = class {
+	fetchImpl;
+	timeoutMs;
+	deviceMidFactory;
+	cachedDeviceMid;
+	constructor(options = {}) {
+		this.fetchImpl = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+		this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+		this.deviceMidFactory = options.deviceMid ?? (() => crypto.randomUUID());
+	}
+	/** 当前设备标识；首次调用时生成并缓存，保证同一进程内稳定。 */
+	deviceMid() {
+		this.cachedDeviceMid ??= this.deviceMidFactory();
+		return this.cachedDeviceMid;
+	}
+	/** 注入固定设备标识（从磁盘恢复时使用）。 */
+	setDeviceMid(value) {
+		if (value.trim().length > 0) this.cachedDeviceMid = value.trim();
+	}
+	async request(url, init, what) {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+		timer.unref?.();
+		let response;
+		try {
+			response = await this.fetchImpl(url, {
+				...init,
+				signal: controller.signal
+			});
+		} catch (error) {
+			const aborted = controller.signal.aborted;
+			throw new ZCodeConsoleError(aborted ? `${what} 超时（${this.timeoutMs}ms）` : `${what} 网络请求失败：${String(error)}`, void 0, 0);
+		} finally {
+			clearTimeout(timer);
+		}
+		const text = await response.text();
+		let json;
+		try {
+			json = text.length === 0 ? void 0 : JSON.parse(text);
+		} catch {
+			throw new ZCodeConsoleError(`${what} 返回了非 JSON 响应（HTTP ${response.status}）`, void 0, response.status, text.slice(0, 300));
+		}
+		if (!response.ok) {
+			const message = isRecord(json) ? pickString(json, "msg") : void 0;
+			const code = isRecord(json) ? pickNumber(json, "code") : void 0;
+			throw new ZCodeConsoleError(message ?? `${what} 失败（HTTP ${response.status}）`, code, response.status, text.slice(0, 400));
+		}
+		return {
+			status: response.status,
+			json
+		};
+	}
+	/**
+	* 用桌面端授权码换取凭据。
+	*
+	* 浏览器授权完成后由上游回跳带授权码，这里用 code 换取 `data.token` 与
+	* `data.<family>.access_token`。`redirect_uri` 与 `state` 必须与授权时逐字一致。
+	*/
+	async exchangeDesktopCode(family, code, redirectUri, state) {
+		const { status, json } = await this.request(ZCODE_OAUTH_TOKEN_URL, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				provider: family,
+				code,
+				redirect_uri: redirectUri,
+				state
+			})
+		}, `${ZCODE_FAMILY_LABELS[family]} 授权码换取`);
+		const data = unwrapEnvelope(json, status, ZCODE_OAUTH_TOKEN_URL);
+		if (!isRecord(data)) throw new ZCodeConsoleError("授权码换取响应缺少 data", void 0, status);
+		const zcodeJwt = pickString(data, "token");
+		if (zcodeJwt === void 0 || zcodeJwt.trim().length === 0) throw new ZCodeConsoleError("授权码换取响应缺少 token", void 0, status);
+		const familyNode = isRecord(data[family]) ? data[family] : {};
+		const accessToken = pickString(familyNode, "access_token");
+		const refreshToken = pickString(familyNode, "refresh_token");
+		const userNode = isRecord(data.user) ? data.user : {};
+		return {
+			status: "ready",
+			zcodeJwt,
+			...accessToken === void 0 ? {} : { accessToken },
+			...refreshToken === void 0 ? {} : { refreshToken },
+			user: {
+				userId: pickString(userNode, "user_id"),
+				email: pickString(userNode, "email"),
+				name: pickString(userNode, "name"),
+				avatar: pickString(userNode, "avatar")
+			}
+		};
+	}
+	/**
+	* 读取 Start Plan 额度。
+	*
+	* 这里是目录的真源：`balances[].capabilities` 决定账号此刻能用哪些模型。
+	*/
+	async balance(zcodeJwt) {
+		const url = `${ZCODE_BALANCE_URL}?app_version=${encodeURIComponent(ZCODE_CLIENT_VERSION)}`;
+		const { status, json } = await this.request(url, {
+			method: "GET",
+			headers: {
+				...zcodeSourceHeaders(this.deviceMid()),
+				authorization: zcodeJwt
+			}
+		}, "Start Plan 额度");
+		const data = unwrapEnvelope(json, status, url);
+		if (!isRecord(data)) throw new ZCodeConsoleError("额度响应缺少 data", void 0, status);
+		const rawPlans = Array.isArray(data.plans) ? data.plans : [];
+		const rawBalances = Array.isArray(data.balances) ? data.balances : [];
+		const plans = [];
+		for (const entry of rawPlans) {
+			if (!isRecord(entry)) continue;
+			const planId = pickString(entry, "plan_id");
+			if (planId === void 0) continue;
+			plans.push({
+				planId,
+				...pickString(entry, "name") === void 0 ? {} : { name: pickString(entry, "name") },
+				...pickString(entry, "status") === void 0 ? {} : { status: pickString(entry, "status") },
+				...pickString(entry, "ends_at") === void 0 ? {} : { endsAt: pickString(entry, "ends_at") }
+			});
+		}
+		const balances = [];
+		for (const entry of rawBalances) {
+			if (!isRecord(entry)) continue;
+			const showName = pickString(entry, "show_name") ?? pickString(entry, "entitlement_id");
+			if (showName === void 0) continue;
+			const capability = (Array.isArray(entry.capabilities) ? entry.capabilities : []).find((value) => typeof value === "string");
+			const planId = pickString(entry, "plan_id");
+			balances.push({
+				showName,
+				totalUnits: pickNumber(entry, "total_units") ?? 0,
+				usedUnits: pickNumber(entry, "used_units") ?? 0,
+				remainingUnits: pickNumber(entry, "remaining_units") ?? 0,
+				...capability === void 0 ? {} : { capability },
+				...planId === void 0 ? {} : { planId },
+				...pickNumber(entry, "period_start") === void 0 ? {} : { periodStartSeconds: pickNumber(entry, "period_start") },
+				...pickNumber(entry, "period_end") === void 0 ? {} : { periodEndSeconds: pickNumber(entry, "period_end") },
+				...pickNumber(entry, "expires_at") === void 0 ? {} : { expiresAtSeconds: pickNumber(entry, "expires_at") },
+				...pickNumber(entry, "available_units") === void 0 ? {} : { availableUnits: pickNumber(entry, "available_units") }
+			});
+		}
+		return {
+			plans,
+			balances
+		};
+	}
+	/** 读取客户端配置：模型能力、验证码策略、Start Plan 预览权益。 */
+	async clientConfigs(zcodeJwt) {
+		const url = `${ZCODE_CLIENT_CONFIGS_URL}?app_version=${encodeURIComponent(ZCODE_CLIENT_VERSION)}&platform=${encodeURIComponent(`${process.platform === "darwin" ? "darwin" : process.platform}-${process.arch === "arm64" ? "aarch64" : process.arch}`)}`;
+		const { status, json } = await this.request(url, {
+			method: "GET",
+			headers: {
+				...zcodeSourceHeaders(this.deviceMid()),
+				authorization: zcodeJwt
+			}
+		}, "客户端配置");
+		const data = unwrapEnvelope(json, status, url);
+		if (!isRecord(data)) throw new ZCodeConsoleError("客户端配置缺少 data", void 0, status);
+		const configs = isRecord(data.configs) ? data.configs : {};
+		const models = [];
+		const builtin = Array.isArray(data.builtinModels) ? data.builtinModels : [];
+		for (const entry of builtin) {
+			if (!isRecord(entry)) continue;
+			const modelId = pickString(entry, "modelId");
+			if (modelId === void 0) continue;
+			if (models.some((model) => model.modelId === modelId)) continue;
+			const reasoning = isRecord(entry.reasoning) ? entry.reasoning : {};
+			const levelsNode = isRecord(reasoning.levels) ? reasoning.levels : {};
+			const levels = Object.keys(levelsNode);
+			const capabilities = isRecord(entry.capabilities) ? entry.capabilities : {};
+			models.push({
+				modelId,
+				name: pickString(entry, "name") ?? modelId,
+				...pickNumber(entry, "contextWindow") === void 0 ? {} : { contextWindow: pickNumber(entry, "contextWindow") },
+				...pickNumber(entry, "maxCompletionTokens") === void 0 ? {} : { maxCompletionTokens: pickNumber(entry, "maxCompletionTokens") },
+				...levels.length === 0 ? {} : { reasoningLevels: levels },
+				...pickString(reasoning, "defaultLevel") === void 0 ? {} : { defaultReasoningLevel: pickString(reasoning, "defaultLevel") },
+				...capabilities.vision === true ? { supportsImage: true } : {},
+				...pickString(entry, "description") === void 0 ? {} : { description: pickString(entry, "description") }
+			});
+		}
+		const captchaNode = isRecord(configs.captcha) ? configs.captcha : void 0;
+		const previewNode = isRecord(configs.startPlanPreview) ? configs.startPlanPreview : void 0;
+		const entitlements = previewNode !== void 0 && Array.isArray(previewNode.entitlements) ? previewNode.entitlements.filter(isRecord).map((entry) => ({
+			showName: pickString(entry, "showName") ?? "",
+			grantUnits: pickNumber(entry, "grantUnits") ?? 0
+		})).filter((entry) => entry.showName.length > 0) : void 0;
+		return {
+			models,
+			...captchaNode === void 0 ? {} : { captcha: {
+				enabled: captchaNode.enabled === true,
+				skipModelRequest: captchaNode.skip_model_request === true,
+				...pickString(captchaNode, "region") === void 0 ? {} : { region: pickString(captchaNode, "region") }
+			} },
+			...entitlements === void 0 ? {} : { startPlanEntitlements: entitlements }
+		};
+	}
+	/** 读取 agent 运行时配置（官方客户端的端点改写映射）。 */
+	async agentConfigs(zcodeJwt) {
+		const url = `${ZCODE_AGENT_CONFIGS_URL}?app_version=${encodeURIComponent(ZCODE_CLIENT_VERSION)}&platform=darwin-aarch64`;
+		const { status, json } = await this.request(url, {
+			method: "GET",
+			headers: {
+				...zcodeSourceHeaders(this.deviceMid()),
+				authorization: `Bearer ${zcodeJwt}`
+			}
+		}, "Agent 配置");
+		const data = unwrapEnvelope(json, status, url);
+		if (!isRecord(data)) throw new ZCodeConsoleError("Agent 配置缺少 data", void 0, status);
+		const proxy = isRecord(data.proxyEndpoint) ? data.proxyEndpoint : void 0;
+		const mapping = proxy !== void 0 && Array.isArray(proxy.mapping) ? proxy.mapping : [];
+		const signature = isRecord(data.codingPlanSignature) ? data.codingPlanSignature : void 0;
+		return {
+			proxyMapping: mapping.filter(isRecord).flatMap((entry) => {
+				const from = pickString(entry, "from");
+				const to = pickString(entry, "to");
+				if (from === void 0 || to === void 0) return [];
+				const header = pickString(entry, "zcodeAuthorizationHeader");
+				return [{
+					from,
+					to,
+					...header === void 0 ? {} : { zcodeAuthorizationHeader: header }
+				}];
+			}),
+			...signature === void 0 ? {} : { codingPlanSignatureEnabled: signature.enable === true }
+		};
+	}
+};
+/** 推理端点完整地址。 */
+function zcodeMessagesUrl(baseURL = ZCODE_ANTHROPIC_BASE_URL) {
+	return `${baseURL.replace(/\/+$/u, "")}/v1/messages`;
+}
+//#endregion
+//#region src/host/catalog.ts
+/**
+* 未在 `client/configs` 里描述时的兜底能力。
+*
+* 取 GLM-5 系列的实际取值：40 万上下文、8 万最大输出。宁可保守（更早提示
+* 上下文超限），也不要把上限猜高导致请求被网关拒绝。
+*/
+const ZCODE_FALLBACK_CONTEXT_WINDOW = 4e5;
+const ZCODE_FALLBACK_MAX_TOKENS = 8e4;
+/**
+* 内置兜底模型清单。
+*
+* 与 ZCode 内置 provider 规则的 `builtinModelIds` 一致；只在额度接口不可读时
+* 使用，用于保证未登录状态下的选择器不是空的。
+*/
+const ZCODE_BUILTIN_MODEL_IDS = [
+	"GLM-5.3-Flash",
+	"GLM-5.2",
+	"GLM-5-Turbo"
+];
+/**
+* 思考等级映射。
+*
+* GLM 系列在 Anthropic 协议下用 `thinking` 块表达推理，pi-ai 的等级键与上游
+* 取值不是一一对应：`off` 表示不请求思考，其余按强度映射到上游 `low` /
+* `high` / `max` 三档。上游只认这三档，因此中间等级向上取整而不是透传，
+* 否则会得到 400。
+*/
+function thinkingLevelMapOf(levels) {
+	if (levels === void 0 || levels.length === 0) return {
+		map: {},
+		reasoning: false
+	};
+	const normalized = new Set(levels.map((level) => level.trim().toLowerCase()));
+	const map = {};
+	if (!normalized.has("low") && !normalized.has("medium") && !normalized.has("high") && !normalized.has("max")) return {
+		map: { off: null },
+		reasoning: false
+	};
+	map.off = null;
+	if (normalized.has("low")) map.minimal = "low";
+	if (normalized.has("low")) map.low = "low";
+	if (normalized.has("high")) map.medium = "high";
+	if (normalized.has("high")) map.high = "high";
+	if (normalized.has("max")) map.xhigh = "max";
+	if (normalized.has("max")) map.max = "max";
+	return {
+		map,
+		reasoning: true
+	};
+}
+/**
+* 上游是否因凭据失效而拒绝。
+*
+* ZCode 的账号令牌有有效期，过期后额度接口返回 HTTP 401（无错误信封）。
+* 这个状态与「网络不通」「没有套餐」的处理方式完全不同，必须先分开。
+*/
+function isUnauthorized(error) {
+	return error instanceof ZCodeConsoleError && error.status === 401;
+}
+/** 把一个额度 capability 投影成模型。 */
+function toModel(params) {
+	const { id, capability, clientModel, family } = params;
+	const levels = clientModel?.reasoningLevels;
+	const { map, reasoning } = thinkingLevelMapOf(levels);
+	const supportsImage = clientModel?.supportsImage === true;
+	return {
+		id,
+		name: clientModel?.name ?? id,
+		...clientModel?.description === void 0 ? {} : { description: clientModel.description },
+		family: family === "zai" ? "zai" : "bigmodel",
+		api: "anthropic-messages",
+		baseURL: ZCODE_ANTHROPIC_BASE_URL,
+		reasoning,
+		...reasoning ? { thinkingLevelMap: map } : {},
+		input: supportsImage ? ["text", "image"] : ["text"],
+		contextWindow: clientModel?.contextWindow ?? 4e5,
+		maxTokens: clientModel?.maxCompletionTokens ?? 8e4,
+		tools: true,
+		structuredOutput: true,
+		accountFamily: family,
+		...capability === void 0 ? {} : { capability }
+	};
+}
+/** 从额度条目推导模型 id 列表（保序去重）。 */
+function modelIdsFromBalances(balances) {
+	const ids = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const balance of balances) {
+		const raw = balance.capability === void 0 ? void 0 : modelIdOfCapability(balance.capability);
+		if (raw === void 0) continue;
+		const id = normalizeModelId(raw);
+		if (seen.has(id)) continue;
+		seen.add(id);
+		ids.push(id);
+	}
+	return ids;
+}
+/** Unix 秒 → epoch 毫秒；非法值返回 undefined。 */
+function secondsToMs(value) {
+	if (value === void 0 || !Number.isFinite(value) || value <= 0) return void 0;
+	return value * 1e3;
+}
+/** 把额度条目归一成契约形状（周期由窗口时长推导）。 */
+function toBalanceEntries(balances) {
+	return balances.map((balance) => {
+		const periodStart = secondsToMs(balance.periodStartSeconds);
+		const periodEnd = secondsToMs(balance.periodEndSeconds);
+		return {
+			entitlementId: balance.capability ?? balance.showName,
+			showName: balance.showName,
+			...balance.capability === void 0 ? {} : { capability: balance.capability },
+			totalUnits: balance.totalUnits,
+			usedUnits: balance.usedUnits,
+			remainingUnits: balance.remainingUnits,
+			period: deriveBalancePeriod(balance.periodStartSeconds, balance.periodEndSeconds),
+			...periodStart === void 0 ? {} : { periodStart },
+			...periodEnd === void 0 ? {} : { periodEnd },
+			...secondsToMs(balance.expiresAtSeconds) === void 0 ? {} : { expiresAt: secondsToMs(balance.expiresAtSeconds) },
+			...balance.planId === void 0 ? {} : { planId: balance.planId }
+		};
+	});
+}
+/**
+* 同一模型在多份套餐下会有多条额度，逐条展示会让界面出现重复行。
+*
+* 这里按「模型 + 周期」合并：保留额度最大的那条作为主额度，把其余总量累加。
+* 累加是有意义的——两份套餐的同一模型日额度确实可以叠加使用；但**不合并
+* 不同周期**，否则会掩盖"日额度用完但活动额度还有"。
+*/
+function mergeBalanceEntries(entries) {
+	const merged = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const key = `${entry.capability ?? entry.showName}::${entry.period}`;
+		const existing = merged.get(key);
+		if (existing === void 0) {
+			merged.set(key, entry);
+			continue;
+		}
+		const totalUnits = existing.totalUnits + entry.totalUnits;
+		const usedUnits = existing.usedUnits + entry.usedUnits;
+		const remainingUnits = existing.remainingUnits + entry.remainingUnits;
+		merged.set(key, {
+			...existing,
+			totalUnits,
+			usedUnits,
+			remainingUnits,
+			...earliest(existing.periodEnd, entry.periodEnd) === void 0 ? {} : { periodEnd: earliest(existing.periodEnd, entry.periodEnd) }
+		});
+	}
+	return [...merged.values()];
+}
+/** 两个时间戳中较早且存在的那个。 */
+function earliest(left, right) {
+	if (left === void 0) return right;
+	if (right === void 0) return left;
+	return Math.min(left, right);
+}
+const DEFAULT_STALE_AFTER_MS = 3e5;
+/** 目录服务。 */
+var ZCodeCatalogService = class {
+	current;
+	inflight;
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	get now() {
+		return this.options.now?.() ?? Date.now();
+	}
+	/** 当前快照；从未刷新过时返回 undefined。 */
+	snapshot() {
+		return this.current;
+	}
+	/** 快照是否已过期。 */
+	isStale() {
+		if (this.current === void 0) return true;
+		const staleAfter = this.options.staleAfterMs ?? DEFAULT_STALE_AFTER_MS;
+		return this.now - this.current.fetchedAt >= staleAfter;
+	}
+	/** 失效快照，强制下次刷新走网络。 */
+	invalidate() {
+		this.current = void 0;
+	}
+	/** 已过期才刷新，否则复用。 */
+	async refreshIfStale() {
+		if (this.current !== void 0 && !this.isStale()) return this.current;
+		return this.refresh();
+	}
+	/** 强制刷新；并发调用合并成一次请求。 */
+	async refresh() {
+		this.inflight ??= this.load().finally(() => {
+			this.inflight = void 0;
+		});
+		return this.inflight;
+	}
+	async load() {
+		const token = await this.options.resolveToken();
+		const family = await this.options.resolveFamily();
+		if (token === void 0 || family === void 0) {
+			const builtin = this.builtinCatalog(family ?? "bigmodel", ["尚未登录 ZCode 账号，当前展示内置模型清单；登录后按账号权益刷新"]);
+			this.current = builtin;
+			return builtin;
+		}
+		const warnings = [];
+		let balances = [];
+		let plans = [];
+		let source = "builtin";
+		try {
+			const snapshot = await this.options.client.balance(token);
+			balances = mergeBalanceEntries(toBalanceEntries(snapshot.balances));
+			plans = snapshot.plans.map((plan) => ({
+				planId: plan.planId,
+				...plan.name === void 0 ? {} : { name: plan.name },
+				...plan.status === void 0 ? {} : { status: plan.status },
+				...plan.endsAt === void 0 ? {} : { endsAt: plan.endsAt }
+			}));
+			source = "balance";
+			if (plans.length === 0) warnings.push("额度接口未返回任何套餐记录，账号可能尚未订阅 Start Plan");
+		} catch (error) {
+			if (isUnauthorized(error)) warnings.push("ZCode 账号凭据已失效，请重新登录后刷新模型清单");
+			else warnings.push(`额度接口不可读，暂用内置模型清单：${error instanceof Error ? error.message : String(error)}`);
+			this.options.logger?.warn("dsh-zcode: 读取额度失败", error);
+		}
+		let clientModels = [];
+		try {
+			clientModels = (await this.options.client.clientConfigs(token)).models;
+		} catch (error) {
+			warnings.push("客户端配置不可读，模型能力使用保守默认值");
+			this.options.logger?.warn("dsh-zcode: 读取客户端配置失败", error);
+		}
+		const ids = source === "balance" ? modelIdsFromBalances(balances) : [];
+		const modelIds = ids.length > 0 ? ids : [...ZCODE_BUILTIN_MODEL_IDS];
+		if (source === "balance" && ids.length === 0) {
+			warnings.push("账号权益里没有可用模型，已回落到内置模型清单");
+			source = "builtin";
+		}
+		const models = modelIds.map((id) => {
+			const balance = balances.find((entry) => entry.capability !== void 0 && normalizeModelId(modelIdOfCapability(entry.capability) ?? "") === id);
+			const clientModel = clientModels.find((entry) => normalizeModelId(entry.modelId) === id);
+			return toModel({
+				id,
+				...balance?.capability === void 0 ? {} : { capability: balance.capability },
+				...clientModel === void 0 ? {} : { clientModel },
+				family
+			});
+		});
+		const catalog = {
+			fetchedAt: this.now,
+			source,
+			models,
+			plans,
+			balances: source === "balance" ? balances : [],
+			warnings
+		};
+		this.current = catalog;
+		return catalog;
+	}
+	builtinCatalog(family, warnings) {
+		return {
+			fetchedAt: this.now,
+			source: "builtin",
+			models: ZCODE_BUILTIN_MODEL_IDS.map((id) => toModel({
+				id,
+				family
+			})),
+			plans: [],
+			balances: [],
+			warnings
+		};
+	}
+};
+//#endregion
+export { findModel as _, isUnauthorized as a, selectableModels as b, thinkingLevelMapOf as c, ZCodeConsoleClient as d, ZCodeConsoleError as f, ZCODE_REASONING_LEVELS as g, zcodeSourceHeaders as h, ZCodeCatalogService as i, toBalanceEntries as l, zcodeModelHeaders as m, ZCODE_FALLBACK_CONTEXT_WINDOW as n, mergeBalanceEntries as o, zcodeMessagesUrl as p, ZCODE_FALLBACK_MAX_TOKENS as r, modelIdsFromBalances as s, ZCODE_BUILTIN_MODEL_IDS as t, toModel as u, modelIdOfCapability as v, normalizeModelId as y };