@kenz1117/dsh-ui-usage-billing 0.6.0 → 0.8.0

package/lib/index.js

@@ -4,9 +4,168 @@ import { join } from "node:path";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
+//#region lib/types/client/plan-knowledge.js
+/**
+* Plan-knowledge reference (adapted from dsh-spend's `knowledge.js`, MIT):
+* billing-plan shape (code = subscription, token = usage) for known providers,
+* plus official token rates as a pricing fallback for providers whose models
+* are not covered by the built-in catalog or models.dev.
+*
+* The cost model follows dsh-spend's dual-basis:
+* - `code` plan (OpenCode Go, Coding/Token plans, etc.): the monthly cost is
+*   the subscription fee, counted into the projected month total.
+* - `token` plan (pay-as-you-go API providers): cost = tokens × unit price.
+*
+* We keep our own live-pricing path (models.dev + OpenRouter) for token plans;
+* this table only fills the subscription amount, the plan type, and a fallback
+* rate for the few models those live sources may miss.
+*/
+/**
+* 订阅/计划 provider id → plan 知识（引用 dsh-spend 的 code/token 双口径）。
+* 覆盖我们实际会识别到的订阅通道；其余按量 API 不计入此表（默认 token）。
+*/
+const PLAN_KNOWLEDGE = {
+	"opencode-go": {
+		type: "code",
+		subscriptionCny: 70
+	},
+	opencode: {
+		type: "code",
+		subscriptionCny: 70
+	},
+	"kimi-coding": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"zai-coding-cn": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"zai-coding": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"qwen-token-plan": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"qwen-token-plan-cn": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"xiaomi-token-plan-ams": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"xiaomi-token-plan-cn": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"xiaomi-token-plan-sgp": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"volcengine-token-plan": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"ark-token-plan": {
+		type: "code",
+		subscriptionCny: 0
+	},
+	"doubao-token-plan": {
+		type: "code",
+		subscriptionCny: 0
+	}
+};
+/** provider id（llm-pi-ai 设置键）→ plan 知识；未命中默认 token。 */
+function planTypeOf(providerId) {
+	return PLAN_KNOWLEDGE[providerId]?.type ?? "token";
+}
+/** 订阅月费（人民币元）；非 code 或未配置时为 0。 */
+function subscriptionCnyOf(providerId) {
+	const entry = PLAN_KNOWLEDGE[providerId];
+	return entry?.type === "code" ? entry.subscriptionCny ?? 0 : 0;
+}
+const FALLBACK_RATES = [
+	{
+		key: "deepseek-v4-flash",
+		input: .14,
+		cacheHit: .0028,
+		output: .28
+	},
+	{
+		key: "deepseek-v4-pro",
+		input: .435,
+		cacheHit: .003625,
+		output: .87
+	},
+	{
+		key: "gpt-5.6-sol",
+		input: 5,
+		cacheHit: .5,
+		output: 30
+	},
+	{
+		key: "gpt-5.6-terra",
+		input: 2,
+		cacheHit: .2,
+		output: 12
+	},
+	{
+		key: "gpt-5.6-luna",
+		input: .2,
+		cacheHit: .02,
+		output: 1.2
+	},
+	{
+		key: "glm-5.2",
+		input: 1.4,
+		cacheHit: .26,
+		output: 4.4
+	},
+	{
+		key: "qwen3.8-max",
+		input: 2,
+		cacheHit: .21,
+		output: 6
+	},
+	{
+		key: "kimi-k3",
+		input: 2.82,
+		cacheHit: .28,
+		output: 14.08
+	},
+	{
+		key: "grok-4.6",
+		input: 2,
+		cacheHit: .5,
+		output: 6
+	},
+	{
+		key: "gemini-2.5-pro",
+		input: 1.25,
+		cacheHit: .125,
+		output: 10
+	}
+];
+/** 运行时实时覆盖：undefined = 用内置目录与内置汇率（默认值降级）。 */
+let liveRate;
+let livePrices;
+let liveExtraModels;
+/**
+* Apply the node half's live pricing snapshot. Absent fields keep the
+* built-in catalog and rate; callers never fabricate values.
+* @param pricing - the `/api/billing/pricing` response.
+*/
+function applyLivePricing(pricing) {
+	liveRate = pricing.rate;
+	livePrices = pricing.prices;
+	liveExtraModels = pricing.extraModels;
+}
 /** 当前汇率：实时覆盖优先，缺省回退内置固定值。 */
 function currentRate() {
-	return 6.79;
+	return liveRate ?? 6.79;
 }
 /** Default share of traffic assumed to fall in the peak band (0..1). */
 const DEFAULT_PEAK_SHARE = .5;
@@ -271,11 +430,22 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-green-400",
 		price: {
 			currency: "CNY",
-			input: 4,
-			cacheHit: .4,
-			output: 12
-		},
-		estimated: true
+			input: 1,
+			cacheHit: .02,
+			output: 2
+		}
+	},
+	{
+		key: "mimo-v2.5-pro",
+		name: "MiMo V2.5 Pro",
+		provider: "小米",
+		colorVar: "dsw-static-green-400",
+		price: {
+			currency: "CNY",
+			input: 3,
+			cacheHit: .025,
+			output: 6
+		}
 	},
 	{
 		key: "minimax",
@@ -541,14 +711,65 @@ const MODEL_KEY_ALIASES = {
 	"k3": "kimi-k3",
 	"kimi-k3": "kimi-k3"
 };
+/** 取一个计费键的实时单价（实时覆盖 > dsh-spend 官方价兜底）。 */
+function livePriceOf(key) {
+	const resolved = MODEL_KEY_ALIASES[key] ?? key;
+	const live = livePrices?.[resolved];
+	if (live !== void 0) return live;
+	const fallback = FALLBACK_RATES.find((rate) => rate.key.toLowerCase() === resolved.toLowerCase());
+	if (fallback === void 0) return void 0;
+	return {
+		input: fallback.input,
+		cacheHit: fallback.cacheHit,
+		output: fallback.output
+	};
+}
 /** Lookup a model by its stats key; falls back to the generic `other` entry. */
 function modelOf(key) {
 	const resolved = MODEL_KEY_ALIASES[key] ?? key;
-	return MODEL_CATALOG.find((entry) => entry.key === resolved) ?? (() => {
+	const found = MODEL_CATALOG.find((entry) => entry.key === resolved);
+	const extra = liveExtraModels?.find((item) => item.key === resolved);
+	const base = found ?? (extra !== void 0 ? extraEntryOf(extra) : (() => {
 		const fallback = MODEL_CATALOG.at(-1);
 		if (fallback !== void 0) return fallback;
 		throw new Error("MODEL_CATALOG must not be empty");
-	})();
+	})());
+	const live = livePriceOf(resolved);
+	if (live === void 0) return base;
+	return {
+		...base,
+		price: {
+			currency: "USD",
+			input: live.input,
+			cacheHit: live.cacheHit,
+			output: live.output
+		}
+	};
+}
+/** models.dev 补充条目转为目录条目：USD 直价（走汇率换算），无峰谷分档。 */
+function extraEntryOf(extra) {
+	return {
+		key: extra.key,
+		name: extra.name,
+		provider: extra.provider,
+		colorVar: "dsw-static-neutral-400",
+		price: {
+			currency: "USD",
+			input: extra.price.input,
+			cacheHit: extra.price.cacheHit,
+			output: extra.price.output
+		}
+	};
+}
+/**
+* 模型是否可计价：内置目录、models.dev 补充、或 dsh-spend 官方价兜底命中。
+* 聚合层的计价闸门（目录外模型不产生费用，避免兜底档误估）。
+*/
+function isPriced(key) {
+	const resolved = MODEL_KEY_ALIASES[key] ?? key;
+	if (MODEL_CATALOG.some((entry) => entry.key === resolved)) return true;
+	if ((liveExtraModels ?? []).some((item) => item.key === resolved)) return true;
+	return FALLBACK_RATES.some((rate) => rate.key.toLowerCase() === resolved.toLowerCase());
 }
 /**
 * Price one band's token usage in CNY. The stats `input` field is the TOTAL
@@ -681,7 +902,7 @@ function foldUsage(acc, usage, key, subscription, timeMs) {
 	acc.output += usage.outputTokens;
 	acc.cacheHit += cacheHit;
 	acc.cacheMiss += cacheMiss;
-	if (!subscription && MODEL_CATALOG.some((entry) => entry.key === key)) acc.cost += computeCostAt(modelOf(key), {
+	if (!subscription && isPriced(key)) acc.cost += computeCostAt(modelOf(key), {
 		input: cacheHit + cacheMiss,
 		cacheHit,
 		cacheMiss,
@@ -824,7 +1045,7 @@ function foldSession(events, subscriptionProviders) {
 		state.output += usage.outputTokens;
 		state.cacheHit += usage.cacheReadTokens ?? 0;
 		state.cacheMiss += usage.inputTokens + (usage.cacheWriteTokens ?? 0);
-		if (!subscription && MODEL_CATALOG.some((entry) => entry.key === modelKey)) {
+		if (!subscription && isPriced(modelKey)) {
 			const buckets = {
 				input: (usage.cacheReadTokens ?? 0) + usage.inputTokens + (usage.cacheWriteTokens ?? 0),
 				cacheHit: usage.cacheReadTokens ?? 0,
@@ -1198,6 +1419,125 @@ async function queryBalances(ctx, providers) {
 		return querier(ctx, env);
 	}));
 }
+/** 点路径取值：`data.total_available` → 逐层下钻；任一缺失返回 undefined。 */
+function getPath(data, path) {
+	let cursor = data;
+	for (const segment of path.split(".")) {
+		if (cursor === null || typeof cursor !== "object") return void 0;
+		cursor = cursor[segment];
+	}
+	return cursor;
+}
+/**
+* 按 extract 规则从响应 JSON 求值。导出供测试：纯函数。
+* @param rule - 提取规则（const / path / add / subtract / divide）。
+* @param data - 响应 JSON。
+* @returns 数值；取不到或结果非有限数返回 undefined。
+*/
+function evalExtract(rule, data) {
+	if (typeof rule.const === "number" && Number.isFinite(rule.const)) return rule.const;
+	if (rule.op === "add" || rule.op === "subtract") {
+		const paths = rule.paths ?? [];
+		if (paths.length === 0) return void 0;
+		let total;
+		for (const path of paths) {
+			const value = toNumber(getPath(data, path));
+			if (value === void 0) return void 0;
+			total = total === void 0 ? value : rule.op === "add" ? total + value : total - value;
+		}
+		return total;
+	}
+	const base = typeof rule.path === "string" ? toNumber(getPath(data, rule.path)) : void 0;
+	if (base === void 0) return void 0;
+	if (rule.op === "divide") {
+		const by = rule.by;
+		if (typeof by !== "number" || !Number.isFinite(by) || by === 0) return void 0;
+		return base / by;
+	}
+	return base;
+}
+/** 请求头占位符解析：`{{ENV_NAME}}` 经凭据 seam 替换；解析失败返回 null。 */
+async function resolveHeaders(ctx, headers) {
+	const resolved = {};
+	for (const [key, value] of Object.entries(headers)) {
+		const match = /^\{\{([A-Z0-9_]+)\}\}$/i.exec(value.trim());
+		if (match === null) {
+			resolved[key] = value;
+			continue;
+		}
+		const hit = await ctx.credentials.resolve(credentialRef(match[1] ?? ""));
+		if (hit === void 0 || hit.value === "") return null;
+		resolved[key] = value.replace(match[0], hit.value);
+	}
+	return resolved;
+}
+/**
+* 查询自定义 Provider 余额（插件 config 的 `customBalances`）。每个条目独立
+* 成败：占位符凭据缺失 → unconfigured；401/403 → unauthorized；网络或提取
+* 失败 → unreachable。
+* @param ctx - host context carrying the credentials seam.
+* @param configs - 自定义余额配置列表。
+* @returns 每个配置一行的余额结果。
+*/
+async function queryCustomBalances(ctx, configs) {
+	return await Promise.all(configs.map(async (config) => {
+		const provider = `custom:${config.label}`;
+		const displayName = config.label;
+		if (typeof config.url !== "string" || config.url === "") return {
+			provider,
+			displayName,
+			error: "unconfigured"
+		};
+		const headers = await resolveHeaders(ctx, config.headers ?? {});
+		if (headers === null) return {
+			provider,
+			displayName,
+			error: "unconfigured"
+		};
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$1);
+		try {
+			const response = await fetch(config.url, {
+				method: config.method ?? "GET",
+				headers: {
+					accept: "application/json",
+					...headers
+				},
+				signal: controller.signal
+			});
+			if (response.status === 401 || response.status === 403) return {
+				provider,
+				displayName,
+				error: "unauthorized"
+			};
+			if (!response.ok) return {
+				provider,
+				displayName,
+				error: "unreachable"
+			};
+			const remaining = evalExtract(config.extract.remaining, await response.json());
+			if (remaining === void 0) return {
+				provider,
+				displayName,
+				error: "unreachable"
+			};
+			return {
+				provider,
+				displayName,
+				currency: config.unit ?? "CNY",
+				totalBalance: remaining
+			};
+		} catch {
+			return {
+				provider,
+				displayName,
+				error: "unreachable"
+			};
+		} finally {
+			clearTimeout(timer);
+		}
+	}));
+}
 //#endregion
 //#region lib/types/pricing-fetch.js
 /**
@@ -1235,6 +1575,41 @@ const RATE_SOURCES = [{
 }];
 /** OpenRouter's public model list: per-token USD prices, no key needed. */
 const ROUTER_URL = "https://openrouter.ai/api/v1/models";
+/** models.dev 公开目录：pi-ai 预制提供方的上游数据源（USD / 1M tokens）。
+* 接入它即与宿主「系统设置里预制的提供方模型」对齐——预制条目来自同一份数据。 */
+const MODELS_DEV_URL = "https://models.dev/api.json";
+/**
+* models.dev provider id → 仪表盘厂商显示名。探测到的模型若其厂商显示名与此
+* 映射命中则用之；未命中的回退为探活模型自带的厂商名（系统配置里的显示名）。
+* 不作为过滤条件——只用于给 models.dev 条目补一个可读的厂商名。
+*/
+const MODELS_DEV_PROVIDERS = {
+	deepseek: "DeepSeek",
+	zhipu: "智谱 AI",
+	zhipuai: "智谱 AI",
+	zai: "智谱 AI",
+	qwen: "阿里通义",
+	alibaba: "阿里通义",
+	moonshot: "月之暗面",
+	moonshotai: "月之暗面",
+	volcengine: "字节豆包",
+	doubao: "字节豆包",
+	minimax: "MiniMax",
+	baidu: "百度文心",
+	tencent: "腾讯混元",
+	hunyuan: "腾讯混元",
+	stepfun: "阶跃星辰",
+	iflytek: "科大讯飞",
+	sensetime: "商汤",
+	baichuan: "百川智能",
+	"01.ai": "零一万物",
+	openai: "OpenAI",
+	google: "Google",
+	xai: "xAI",
+	meta: "Meta",
+	anthropic: "Anthropic",
+	mistral: "Mistral"
+};
 /**
 * Built-in catalog key → OpenRouter model-id candidates. Matching prefers an
 * exact id, then a single strong substring hit (the router id contains the
@@ -1335,19 +1710,70 @@ function buildPrices(models) {
 	}
 	return Object.keys(result).length > 0 ? result : void 0;
 }
+/** 有限正数收窄（models.dev cost 字段的 durable 边界）。 */
+function asPrice(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+/**
+* models.dev 响应 → 目录外补充条目。不再按厂商白名单过滤：凡是有有效
+* cost 的模型都纳入（探活模型可能来自任何预制厂商，白名单会漏掉）。厂商
+* 显示名优先取映射，未命中用 provider id。导出供测试：纯函数。
+* @param data - `https://models.dev/api.json` 的响应体。
+* @returns 补充条目（按 provider 顺序稳定；仅含可计价的模型）。
+*/
+function buildExtraModels(data) {
+	if (data === null || typeof data !== "object") return [];
+	const catalogKeys = new Set([...MODEL_CATALOG.map((entry) => entry.key.toLowerCase()), ...Object.keys(MODEL_KEY_ALIASES).map((key) => MODEL_KEY_ALIASES[key]?.toLowerCase() ?? key.toLowerCase())]);
+	const extras = [];
+	for (const [providerId, providerDoc] of Object.entries(data)) {
+		if (providerDoc === null || typeof providerDoc !== "object") continue;
+		const models = providerDoc.models;
+		if (models === null || typeof models !== "object") continue;
+		for (const [modelId, modelDoc] of Object.entries(models)) {
+			const catalogKey = (MODEL_KEY_ALIASES[modelId] ?? modelId).toLowerCase();
+			if (catalogKeys.has(catalogKey)) continue;
+			const key = catalogKey;
+			if (modelDoc === null || typeof modelDoc !== "object") continue;
+			const cost = modelDoc.cost;
+			if (cost === null || typeof cost !== "object") continue;
+			const input = asPrice(cost.input);
+			const output = asPrice(cost.output);
+			if (input === void 0 || output === void 0) continue;
+			const cacheRead = asPrice(cost.cache_read) ?? input * .1;
+			const name = modelDoc.name;
+			extras.push({
+				key,
+				name: typeof name === "string" && name !== "" ? name : modelId,
+				provider: MODELS_DEV_PROVIDERS[providerId.toLowerCase()] ?? providerId,
+				price: {
+					input,
+					cacheHit: cacheRead,
+					output
+				}
+			});
+		}
+	}
+	return extras;
+}
 /**
 * Fetch the live pricing once at boot. Both upstreams run in parallel; a
 * failure in either degrades independently to the built-in value.
 * @returns the live pricing snapshot (builtin when everything failed).
 */
 async function fetchLivePricing() {
-	const [rate, models] = await Promise.all([fetchRate(), fetchRouterModels()]);
+	const [rate, models, modelsDev] = await Promise.all([
+		fetchRate(),
+		fetchRouterModels(),
+		fetchJson(MODELS_DEV_URL)
+	]);
 	const prices = models === void 0 ? void 0 : buildPrices(models);
-	if (rate === void 0 && prices === void 0) return { source: "builtin" };
+	const extraModels = modelsDev === null ? void 0 : buildExtraModels(modelsDev);
+	if (rate === void 0 && prices === void 0 && (extraModels === void 0 || extraModels.length === 0)) return { source: "builtin" };
 	return {
 		source: "live",
 		...rate !== void 0 ? { rate } : {},
-		...prices !== void 0 ? { prices } : {}
+		...prices !== void 0 ? { prices } : {},
+		...extraModels !== void 0 && extraModels.length > 0 ? { extraModels } : {}
 	};
 }
 //#endregion
@@ -1485,14 +1911,20 @@ function kimiWindow(value, kind) {
 	const record = value;
 	const limit = numberOrNull(record.limit ?? record.total);
 	const remaining = numberOrNull(record.remaining);
-	if (limit === null || remaining === null || limit <= 0) return null;
-	const usedPercent = round1(clampPercent((limit - remaining) / limit * 100) ?? 0);
+	if (remaining === null && limit === null && numberOrNull(record.percentage ?? record.usedPercent ?? record.used_percent) === null) return null;
+	const hasLimit = limit !== null && limit > 0;
+	let usedPercent;
+	if (hasLimit) usedPercent = round1(clampPercent((limit - (remaining ?? 0)) / limit * 100) ?? 0);
+	else {
+		const percent = numberOrNull(record.percentage ?? record.usedPercent ?? record.used_percent);
+		usedPercent = percent !== null ? round1(clampPercent(percent) ?? 0) : remaining === null || remaining <= 0 ? 100 : 0;
+	}
 	const resetsAt = toIso(record.resetTime ?? record.reset_time ?? record.resetsAt);
 	return {
 		kind,
 		usedPercent,
 		remainingPercent: round1(100 - usedPercent),
-		remaining,
+		...remaining !== null ? { remaining } : {},
 		...resetsAt === null ? {} : { resetsAt }
 	};
 }
@@ -1999,6 +2431,7 @@ function apply(ctx, config = {}) {
 	let live = { source: "builtin" };
 	const refreshPricing = async () => {
 		live = await fetchLivePricing();
+		applyLivePricing(live);
 	};
 	refreshPricing();
 	ctx.effect(() => {
@@ -2025,7 +2458,8 @@ function apply(ctx, config = {}) {
 			const providers = { ...await readPiAiProviders(ctx.settings) };
 			if (providers["deepseek"] === void 0) providers["deepseek"] = { apiKeyEnv: config.balanceApiKeyEnv ?? DEFAULT_BALANCE_API_KEY_ENV };
 			const balances = await queryBalances(ctx, providers);
-			res.end(JSON.stringify({ balances }));
+			const custom = await queryCustomBalances(ctx, config.customBalances ?? []);
+			res.end(JSON.stringify({ balances: [...balances, ...custom] }));
 		}
 	}), "usage-billing: balance route");
 	let quotaCache = {
@@ -2037,12 +2471,21 @@ function apply(ctx, config = {}) {
 		const rows = [...await collectSubscriptions(keys, identified.filter((item) => item.adapter).map((item) => ({
 			provider: item.provider,
 			...item.region === void 0 ? {} : { region: item.region }
-		})))];
+		})))].map((row) => {
+			const planType = planTypeOf(row.provider);
+			const subscriptionAmount = subscriptionCnyOf(row.provider);
+			return {
+				...row,
+				planType,
+				...planType === "code" && subscriptionAmount > 0 ? { subscriptionAmount } : {}
+			};
+		});
 		for (const item of identified) if (!item.adapter) rows.push({
 			provider: item.provider,
 			displayName: item.displayName,
 			status: "ok",
-			windows: []
+			windows: [],
+			planType: planTypeOf(item.provider)
 		});
 		quotaCache = {
 			at: Date.now(),

package/lib/types/balance.d.ts

@@ -14,7 +14,7 @@
  * provider's key once and every surface reuses it.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { ProviderBalance } from './pricing-shared.ts';
+import type { CustomBalanceConfig, CustomBalanceExtract, ProviderBalance } from './pricing-shared.ts';
 /**
  * Query every configured provider's account balance. A provider is queried only
  * when its llm-pi-ai route has an `apiKeyEnv`; absent routes answer
@@ -26,4 +26,20 @@ import type { ProviderBalance } from './pricing-shared.ts';
 export declare function queryBalances(ctx: Context, providers: Readonly<Record<string, {
     apiKeyEnv?: string;
 }>>): Promise<readonly ProviderBalance[]>;
+/**
+ * 按 extract 规则从响应 JSON 求值。导出供测试：纯函数。
+ * @param rule - 提取规则（const / path / add / subtract / divide）。
+ * @param data - 响应 JSON。
+ * @returns 数值；取不到或结果非有限数返回 undefined。
+ */
+export declare function evalExtract(rule: CustomBalanceExtract, data: unknown): number | undefined;
+/**
+ * 查询自定义 Provider 余额（插件 config 的 `customBalances`）。每个条目独立
+ * 成败：占位符凭据缺失 → unconfigured；401/403 → unauthorized；网络或提取
+ * 失败 → unreachable。
+ * @param ctx - host context carrying the credentials seam.
+ * @param configs - 自定义余额配置列表。
+ * @returns 每个配置一行的余额结果。
+ */
+export declare function queryCustomBalances(ctx: Context, configs: readonly CustomBalanceConfig[]): Promise<readonly ProviderBalance[]>;
 //# sourceMappingURL=balance.d.ts.map

package/lib/types/client/UsageBilling.d.ts

@@ -12,6 +12,7 @@
 import type { InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SidebarFooterActionOwnerProps } from '@deepseek-ai/dsh-client-ui-sidebar/client';
 import type { createBillingBudgetStore } from './budget-store.ts';
+import { type CatalogModel } from './pricing.ts';
 import { NS, type UsageBillingKey } from './locales.ts';
 /** Model-connectivity health reported by the host model directory probe. */
 export interface ModelHealth {
@@ -27,6 +28,8 @@ export interface ModelHealth {
     okProviders: readonly string[];
     /** Display names of providers whose catalog probe failed. */
     badProviders: readonly string[];
+    /** 探活得到的模型清单（系统里实际配置/预制的模型；无价格，费率表据此对标）。 */
+    catalog?: readonly CatalogModel[];
 }
 /** 仪表盘分区 Tab id。 */
 export type DashboardTab = 'overview' | 'trends' | 'providers' | 'details' | 'pricing';

package/lib/types/client/budget-store.d.ts

@@ -16,6 +16,8 @@ export interface BudgetPrefsState {
     tierAlertDays: Record<string, string>;
     /** 最近一次余额不足通知的日期戳（YYYY-MM-DD）：余额告警同样每天最多一次。 */
     lastBalanceAlertDay: string;
+    /** 最近一次峰谷切换提醒的切换点时刻（毫秒）：同一切换点只提醒一次。 */
+    lastTierSwitchAt: number;
 }
 /** 预算偏好的完整写面（组件只能经这些 action 写入）；type 别名以兼容 ActionsDecl 的索引签名约束。 */
 export type BudgetPrefsActions = {
@@ -23,6 +25,7 @@ export type BudgetPrefsActions = {
     setAmount: (d: BudgetPrefsState, value: number) => void;
     markTierAlerted: (d: BudgetPrefsState, tiers: readonly number[], day: string) => void;
     markBalanceAlerted: (d: BudgetPrefsState, day: string) => void;
+    markTierSwitchAlerted: (d: BudgetPrefsState, at: number) => void;
 };
 /**
  * Declare the budget-preferences store handle.