@kenz1117/dsh-ui-usage-billing 1.0.20 → 1.1.1

package/lib/index.js

@@ -7,7 +7,6 @@ import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
-import { createHash, createHmac } from "node:crypto";
 //#region lib/types/client/plan-knowledge.js
 /**
 * Plan-knowledge reference (adapted from dsh-spend's `knowledge.js`, MIT):
@@ -1635,31 +1634,24 @@ function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE, nowMs = Dat
 	return peak * peakShare + off * (1 - peakShare);
 }
 /**
-* v1 峰谷档判定（峰谷开闸起、周末全谷分界止）：不豁免周末——该时段官方
-* 高峰时段为每天 9-12 / 14-18（周六日同样计峰）。仅用于历史事件计费；
-* 「当前时刻」的档位（提醒/时段条/费率展示）一律走 {@link tierAt} 现行规则。
-*/
-function tariffV1At(timeMs) {
-	return isPeakHour((new Date(timeMs).getUTCHours() + 8) % 24) ? "peak" : "offPeak";
-}
-/**
 * 按调用时刻精确判定高峰/空闲档并计价（P0-1：替代固定比例混合）。时刻未知
 * （null/NaN，理论不发生在真实事件流）时回退 {@link DEFAULT_PEAK_SHARE} 混合，
 * 保持旧语义不低估。平档模型（无 offPeak）两个时段同价。限时促销与峰谷档
 * 同口径：按事件时刻判定该笔流量当时享受的单价。
-*
-* 历史正确性（按变更节点分段适用规则，不统一套现行价重算历史）：
-* - 早于 {@link PEAK_ERA_START_MS} 的事件按当时官方基础价
-*   （{@link LEGACY_DEEPSEEK_BANDS}）计费；
-* - 峰谷开闸至 {@link WEEKEND_OFFPEAK_START_MS} 之间按 v1 规则（周末不豁免，
-*   周六日 9-12 / 14-18 计峰）；
-* - 周末全谷分界起按现行规则（{@link tierAt}，周六日全天低谷）。
 * @param entry - the catalog entry whose prices apply.
 * @param buckets - token usage counts.
 * @param timeMs - the call's wall-clock time (epoch ms); null falls back to the peak-share mix.
 * @param peakShare - fallback mix used only when `timeMs` is missing.
 * @returns the estimated cost in CNY（USD 计价模型已按当前汇率折算）。
 */
+/**
+* v1 峰谷档判定（峰谷开闸起、周末全谷分界止）：不豁免周末——该时段官方
+* 高峰时段为每天 9-12 / 14-18（周六日同样计峰）。仅用于历史事件计费；
+* 「当前时刻」的档位（提醒/时段条/费率展示）一律走 {@link tierAt} 现行规则。
+*/
+function tariffV1At(timeMs) {
+	return isPeakHour((new Date(timeMs).getUTCHours() + 8) % 24) ? "peak" : "offPeak";
+}
 function computeCostAt(entry, buckets, timeMs, peakShare = DEFAULT_PEAK_SHARE) {
 	if (timeMs === null || timeMs === void 0 || !Number.isFinite(timeMs)) return computeCost(entry, buckets, peakShare);
 	const priced = applyPromo(entry, timeMs);
@@ -2397,7 +2389,7 @@ function createUsageAggregator(persistence, options = {}) {
 						id,
 						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
 						...stamp === null ? {} : { stamp },
-						foldVersion: 6,
+						foldVersion: 5,
 						fold: serializeFold(fold)
 					};
 					const previous = ledger.get(id);
@@ -2421,7 +2413,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 6;
+					const stale = (entry.foldVersion ?? 1) < 5;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -2467,7 +2459,7 @@ function createUsageAggregator(persistence, options = {}) {
 			outputCost: 0
 		};
 		const perfModel = /* @__PURE__ */ new Map();
-		const perfHourModel = /* @__PURE__ */ new Map();
+		const perfHour = /* @__PURE__ */ new Map();
 		for (const { id: sessionId, cwd, fold, staleLedger } of folds) {
 			mergeUsageInto(total, fold.total);
 			roles.userChars += fold.roles.userChars;
@@ -2498,18 +2490,13 @@ function createUsageAggregator(persistence, options = {}) {
 				if (sample.tps !== void 0) modelAccum.tps.push(sample.tps);
 				if (sample.latencyMs !== void 0) modelAccum.latencies.push(sample.latencyMs);
 				if (sample.estimated) modelAccum.estimated += 1;
-				let hourModels = perfHourModel.get(sample.hour);
-				if (hourModels === void 0) {
-					hourModels = /* @__PURE__ */ new Map();
-					perfHourModel.set(sample.hour, hourModels);
-				}
-				let hourAccum = hourModels.get(sample.model);
+				let hourAccum = perfHour.get(sample.hour);
 				if (hourAccum === void 0) {
 					hourAccum = {
 						ttfts: [],
 						tps: []
 					};
-					hourModels.set(sample.model, hourAccum);
+					perfHour.set(sample.hour, hourAccum);
 				}
 				hourAccum.ttfts.push(sample.ttftMs);
 				if (sample.tps !== void 0) hourAccum.tps.push(sample.tps);
@@ -2569,14 +2556,14 @@ function createUsageAggregator(persistence, options = {}) {
 				latencyAvg: acc.latencies.length === 0 ? 0 : mean(acc.latencies),
 				estimatedSamples: acc.estimated
 			}])),
-			byHourModel: Object.fromEntries([...perfHourModel].map(([hour, models]) => [hour, Object.fromEntries([...models].map(([model, acc]) => [model, {
+			byHour: Object.fromEntries([...perfHour].map(([hour, acc]) => [hour, {
 				samples: acc.ttfts.length,
 				ttftAvg: mean(acc.ttfts),
 				...acc.tps.length === 0 ? {} : { tpsAvg: mean(acc.tps) }
-			}]))]))
+			}]))
 		};
 		lastDoc = {
-			version: 4,
+			version: 3,
 			updatedAt: now,
 			source: "session-logs",
 			timezone: hostTimeZone(),
@@ -2975,26 +2962,6 @@ const QUERIERS = [
 		route: "zai-coding-cn",
 		displayName: "智谱 AI",
 		querier: queryZhipu
-	},
-	{
-		route: "tencent-tokenhub",
-		displayName: "腾讯云 TokenHub",
-		querier: queryTencentTokenPlan
-	},
-	{
-		route: "tokenhub",
-		displayName: "腾讯云 TokenHub",
-		querier: queryTencentTokenPlan
-	},
-	{
-		route: "tencent",
-		displayName: "腾讯云 TokenHub",
-		querier: queryTencentTokenPlan
-	},
-	{
-		route: "tencentcloud",
-		displayName: "腾讯云 TokenHub",
-		querier: queryTencentTokenPlan
 	}
 ];
 /**
@@ -3027,200 +2994,6 @@ async function queryBalances(ctx, providers) {
 		return querier(ctx, env);
 	}));
 }
-/** TokenHub 管控面 API 端点（cloud.tencent.cn/document/api/1823/132270）。 */
-const TOKENHUB_HOST = "tokenhub.tencentcloudapi.com";
-/** 云 API 3.0 产品名与版本（签名的 service 段与请求头都必须一致）。 */
-const TOKENHUB_SERVICE = "tokenhub";
-const TOKENHUB_VERSION = "2026-03-22";
-/** 请求地域：管控面对地域不敏感，取默认国内地域（文档地域列表含 ap-guangzhou）。 */
-const TOKENHUB_REGION = "ap-guangzhou";
-/** 腾讯云凭据引用值格式：`<SecretId>:<SecretKey>`（分隔符取首个冒号）。 */
-function parseTencentCredential(value) {
-	const sep = value.indexOf(":");
-	if (sep === -1) return void 0;
-	const secretId = value.slice(0, sep).trim();
-	const secretKey = value.slice(sep + 1).trim();
-	if (secretId === "" || secretKey === "") return void 0;
-	return {
-		secretId,
-		secretKey
-	};
-}
-/**
-* 构造云 API 3.0 TC3-HMAC-SHA256 签名（官方签名方法 v3）。导出供测试：纯函数，
-* 输入确定则签名确定。Action 不参与签名——它走 `X-TC-Action` 请求头。
-* @param secretId - 云 API SecretId。
-* @param secretKey - 云 API SecretKey。
-* @param payload - 已序列化的请求体（含 Action/Version/Region 公共参数）。
-* @param timestamp - 签名时间戳（秒）。
-* @returns Authorization 头的值。
-*/
-function tc3Authorization(secretId, secretKey, payload, timestamp) {
-	const date = (/* @__PURE__ */ new Date(timestamp * 1e3)).toISOString().slice(0, 10);
-	const canonicalRequest = `POST\n/\n\n${`content-type:application/json; charset=utf-8\nhost:${TOKENHUB_HOST}\n`}\ncontent-type;host\n${createHash("sha256").update(payload).digest("hex")}`;
-	const hashedCanonical = createHash("sha256").update(canonicalRequest).digest("hex");
-	const stringToSign = `TC3-HMAC-SHA256\n${String(timestamp)}\n${date}/${TOKENHUB_SERVICE}/tc3_request\n${hashedCanonical}`;
-	return `TC3-HMAC-SHA256 Credential=${secretId}/${date}/${TOKENHUB_SERVICE}/tc3_request, SignedHeaders=content-type;host, Signature=${createHmac("sha256", createHmac("sha256", createHmac("sha256", createHmac("sha256", date).update(secretKey).digest()).update(TOKENHUB_SERVICE).digest()).update("tc3_request").digest()).update(stringToSign).digest("hex")}`;
-}
-/** 调用一次 TokenHub 管控面接口：TC3 签名 + 超时保护，返回响应 JSON 的 `Response`。 */
-async function callTokenHub(secretId, secretKey, action, params) {
-	const payload = JSON.stringify({
-		Action: action,
-		Version: TOKENHUB_VERSION,
-		Region: TOKENHUB_REGION,
-		...params
-	});
-	const timestamp = Math.floor(Date.now() / 1e3);
-	const controller = new AbortController();
-	const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$3);
-	try {
-		const response = await fetch(`https://${TOKENHUB_HOST}/`, {
-			method: "POST",
-			headers: {
-				"content-type": "application/json; charset=utf-8",
-				host: TOKENHUB_HOST,
-				"x-tc-action": action.toLowerCase(),
-				"x-tc-version": TOKENHUB_VERSION,
-				"x-tc-region": TOKENHUB_REGION,
-				"x-tc-timestamp": String(timestamp),
-				authorization: tc3Authorization(secretId, secretKey, payload, timestamp)
-			},
-			body: payload,
-			signal: controller.signal
-		});
-		if (response.status === 401 || response.status === 403) throw Object.assign(/* @__PURE__ */ new Error("unauthorized"), { code: "unauthorized" });
-		if (!response.ok) throw Object.assign(/* @__PURE__ */ new Error(`HTTP ${String(response.status)}`), {
-			httpStatus: response.status,
-			code: "unreachable"
-		});
-		const inner = (await response.json()).Response;
-		if (inner === void 0) throw Object.assign(/* @__PURE__ */ new Error("no Response envelope"), { code: "invalid" });
-		if (inner.Error !== void 0 && inner.Error !== null) {
-			const err = inner.Error;
-			const code = err.Code === "AuthFailure.SignatureFailure" || err.Code === "AuthFailure.SecretIdNotFound" ? "unauthorized" : "unreachable";
-			throw Object.assign(new Error(String(err.Code ?? "api-error")), { code });
-		}
-		return inner;
-	} finally {
-		clearTimeout(timer);
-	}
-}
-/**
-* 在套餐余量对象里防御性提取「剩余额度」：官方 SubPackageBalance/PackageInfo
-* 的字段名未稳定公开（issue #18 调研期），按语义键名扫描——命中 remaining /
-* balance / left 语义键直接用；命中 total 与 used 则相减推导。数字一律经
-* {@link toNumber} 归一化（上游可能给字符串）。
-* 导出供测试：纯函数。
-* @param source - 套餐详情里的余量对象（PackageInfo / SubPackageBalance 等）。
-* @returns 剩余额度（上游单位，通常为 token 数或元）；提取不到返回 undefined。
-*/
-function pickRemainingQuota(source) {
-	if (source === null || typeof source !== "object") return void 0;
-	const numeric = Object.entries(source).filter(([, v]) => v !== null && toNumber$1(v) !== void 0);
-	const byKey = (needles) => {
-		for (const [key, value] of numeric) {
-			const lower = key.toLowerCase();
-			if (needles.some((n) => lower.includes(n))) {
-				const num = toNumber$1(value);
-				if (num !== void 0 && num >= 0) return num;
-			}
-		}
-	};
-	const remaining = byKey([
-		"remain",
-		"balance",
-		"left",
-		"available"
-	]);
-	if (remaining !== void 0) return remaining;
-	const total = byKey(["total"]);
-	const used = byKey(["used", "consume"]);
-	if (total !== void 0 && used !== void 0) return Math.max(0, total - used);
-}
-/** 套餐列表里提取第一个启用套餐的 TeamId：集合字段名做候选兼容。 */
-function firstEnabledTeamId(inner) {
-	const candidates = inner.TeamSet ?? inner.TokenPlanSet ?? inner.PlanSet;
-	if (!Array.isArray(candidates)) return void 0;
-	for (const item of candidates) {
-		if (item === null || typeof item !== "object") continue;
-		const row = item;
-		if (row.TeamId === void 0 && row.PlanId === void 0) continue;
-		if (row.Status !== void 0 && row.Status !== "enable") continue;
-		const id = row.TeamId ?? row.PlanId;
-		if (typeof id === "string" && id !== "") return id;
-	}
-}
-/**
-* 查询腾讯云 TokenHub Token Plan 套餐余量。凭据值格式 `<SecretId>:<SecretKey>`
-* （云 API 密钥，非 TokenHub 推理 key）。链路：套餐列表取 TeamId → 套餐详情读
-* 主额度包余量。管控面字段名未完全稳定，解析按语义键防御提取。
-* @param ctx - host context carrying the credentials seam.
-* @param apiKeyEnv - credential reference resolving the `<SecretId>:<SecretKey>` pair.
-*/
-async function queryTencentTokenPlan(ctx, apiKeyEnv) {
-	const provider = "腾讯云 TokenHub";
-	const hit = await ctx.credentials.resolve(credentialRef(apiKeyEnv));
-	if (hit === void 0) return {
-		provider,
-		displayName: provider,
-		error: "unconfigured"
-	};
-	if (!balanceGate.check(provider)) return {
-		provider,
-		displayName: provider,
-		error: "unreachable"
-	};
-	const credential = parseTencentCredential(hit.value);
-	if (credential === void 0) return {
-		provider,
-		displayName: provider,
-		error: "unauthorized"
-	};
-	const doRequest = async () => {
-		const teamId = firstEnabledTeamId(await callTokenHub(credential.secretId, credential.secretKey, "DescribeTokenPlanList", {}));
-		if (teamId === void 0) return {
-			provider,
-			displayName: provider,
-			error: "invalid"
-		};
-		const detail = await callTokenHub(credential.secretId, credential.secretKey, "DescribeTokenPlan", { TeamId: teamId });
-		const remaining = pickRemainingQuota(detail.PackageInfo) ?? pickRemainingQuota(detail);
-		if (remaining === void 0) {
-			console.warn(`[usage-billing] balance response drifted for ${provider}: no remaining-quota field parsed`);
-			return {
-				provider,
-				displayName: provider,
-				error: "invalid"
-			};
-		}
-		const plan = typeof detail.Name === "string" ? detail.Name : void 0;
-		const exhausted = detail.StopReason === "EXHAUSTED";
-		return {
-			provider,
-			displayName: provider,
-			currency: "CNY",
-			totalBalance: remaining,
-			...plan !== void 0 ? { plan } : {},
-			...exhausted ? { isAvailable: false } : {}
-		};
-	};
-	try {
-		const row = await withRetry(doRequest, {
-			retries: 1,
-			baseDelayMs: 250,
-			maxDelayMs: 2e3
-		});
-		balanceGate.success(provider);
-		return row;
-	} catch (error) {
-		balanceGate.fail(provider);
-		return {
-			provider,
-			displayName: provider,
-			error: error.code === "unauthorized" ? "unauthorized" : "unreachable"
-		};
-	}
-}
 /** 点路径取值：`data.total_available` → 逐层下钻；任一缺失返回 undefined。 */
 function getPath(data, path) {
 	let cursor = data;

package/lib/types/aggregate.d.ts

@@ -220,8 +220,6 @@ export interface UsageStatsDocument {
      * 以 step/start 为起点估算并计 estimated。
      */
     perf?: PerfStats;
-    /** 只存在于账本、且缺 foldVersion 的旧会话数；无旧行时省略。 */
-    staleLedgerSessions?: number;
 }
 /** 按角色费用归因：user / tool 为输入成本的启发式摊分，assistant 为输出成本实测。 */
 export interface RoleCost {
@@ -236,8 +234,8 @@ export interface RoleCost {
 export interface PerfStats {
     /** 按模型聚合（键 = 计费目录键；未收录模型原样保留）。 */
     byModel: Record<string, ModelPerf>;
-    /** 按小时×模型聚合（外键 = {@link hourStamp}，内键 = 模型目录键；北京时间）。 */
-    byHourModel: Record<string, Record<string, HourModelPerf>>;
+    /** 按小时聚合（键 = {@link hourStamp}，北京时间）。 */
+    byHour: Record<string, HourPerf>;
 }
 /** 一个模型的性能统计：首字延时均值 / P50 / P90、生成速度均值、总延迟均值。 */
 export interface ModelPerf {
@@ -260,11 +258,11 @@ export interface ModelPerf {
     /** 以 step/start 估算的样本数（工具续写步骤无独立 request/header）。 */
     estimatedSamples: number;
 }
-/** 一个小时单模型的性能统计（外键 = {@link hourStamp}，内键 = 模型目录键）。 */
-export interface HourModelPerf {
+/** 一个小时的性能统计（键 = {@link hourStamp}）。 */
+export interface HourPerf {
     samples: number;
     ttftAvg: number;
-    /** 平均生成速度（tokens/s）；该小时该模型无可测生成窗口时缺失。 */
+    /** 平均生成速度（tokens/s）；该小时无可测生成窗口时缺失。 */
     tpsAvg?: number;
 }
 /** 会话明细行：仪表盘「会话明细」面板的数据源。 */
@@ -420,13 +418,10 @@ export interface UsageLedgerDocument {
  * 两次 header 之间的用量串到上一个模型，订阅模型首当其冲，issue #14）；v2 =
  * `assistant/message` 自带 source 归账（1.0.7 起）；v3 = 联网搜索请求按次估算
  * 计费（issue #15，1.0.9 起）；v4 = 模型×日期×站点三维桶（issue #16，按 origin
- * 绑定自定义价的显示层重估）——旧行缺该维度，按无 origin 价处理；v5 = 峰谷
- * 时代之前（2026-08-16T16:00Z）的 DeepSeek 事件按当时基础价计费（v4 把全部
- * 历史套现行峰/谷档价，高估约 50%）；v6 = v1 峰谷窗口（至 2026-08-22T16:00Z）
- * 的周末不豁免峰时（v5 错套现行周末全谷规则，低估该窗口周六日的峰时费用）。
+ * 绑定自定义价的显示层重估）——旧行缺该维度，按无 origin 价处理。
  * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 6;
+export declare const FOLD_VERSION = 5;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并
@@ -477,7 +472,7 @@ export declare function messageTextLength(message: unknown): number;
 export declare function foldSession(events: readonly {
     type: string;
     time: number;
-    data: unknown;
+    data: never;
     seq?: number;
 }[], subscriptionProviders: ReadonlySet<string>, officialProviderIds?: ReadonlySet<string>, routes?: Readonly<Record<string, ProviderRouteView>>, searchCallEstimateCny?: number): SessionFold;
 /**

package/lib/types/balance.d.ts

@@ -25,26 +25,6 @@ import type { CustomBalanceConfig, CustomBalanceExtract, ProviderBalance } from
 export declare function queryBalances(ctx: Context, providers: Readonly<Record<string, {
     apiKeyEnv?: string;
 }>>): Promise<readonly ProviderBalance[]>;
-/**
- * 构造云 API 3.0 TC3-HMAC-SHA256 签名（官方签名方法 v3）。导出供测试：纯函数，
- * 输入确定则签名确定。Action 不参与签名——它走 `X-TC-Action` 请求头。
- * @param secretId - 云 API SecretId。
- * @param secretKey - 云 API SecretKey。
- * @param payload - 已序列化的请求体（含 Action/Version/Region 公共参数）。
- * @param timestamp - 签名时间戳（秒）。
- * @returns Authorization 头的值。
- */
-export declare function tc3Authorization(secretId: string, secretKey: string, payload: string, timestamp: number): string;
-/**
- * 在套餐余量对象里防御性提取「剩余额度」：官方 SubPackageBalance/PackageInfo
- * 的字段名未稳定公开（issue #18 调研期），按语义键名扫描——命中 remaining /
- * balance / left 语义键直接用；命中 total 与 used 则相减推导。数字一律经
- * {@link toNumber} 归一化（上游可能给字符串）。
- * 导出供测试：纯函数。
- * @param source - 套餐详情里的余量对象（PackageInfo / SubPackageBalance 等）。
- * @returns 剩余额度（上游单位，通常为 token 数或元）；提取不到返回 undefined。
- */
-export declare function pickRemainingQuota(source: unknown): number | undefined;
 /**
  * 按 extract 规则从响应 JSON 求值。导出供测试：纯函数。
  * @param rule - 提取规则（const / path / add / subtract / divide）。

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

@@ -1,13 +1,12 @@
 /**
- * PerfPanel: per-model latency/perf table + per-hour per-model comparison curve.
+ * PerfPanel: per-model latency/perf table + per-hour TTFT/generation-speed curve.
  *
  * Reads the optional `perf` field of the usage-stats document (aggregated by
  * the host from session logs). Renders a per-model table of TTFT mean/P50/P90,
  * generation speed, total latency and estimated-step count, plus a small
- * dependency-free SVG hourly curve: one colored polyline per lit model with a
- * metric tab (TTFT ms / tok/s) and clickable model chips; hovering snaps to the
- * nearest hour and shows a crosshair + tooltip listing every lit model's value.
- * Absent `perf` renders an empty state; the panel never fabricates samples.
+ * dependency-free SVG twin-series hourly curve (TTFT in ms on the left axis,
+ * tokens/s on the right). Absent `perf` (older snapshot or stream-less logs)
+ * renders an empty state; the panel never fabricates samples.
  */
 import type { TrendSeriesModel } from './TrendChart.tsx';
 import type { UsageBillingKey } from './locales.ts';
@@ -25,8 +24,8 @@ export interface PerfModelData {
     latencyAvg: number;
     estimatedSamples: number;
 }
-/** 小时×模型性能统计（与服务端 `HourModelPerf` 同形）。 */
-export interface PerfHourModelData {
+/** 每小时性能统计（与服务端 `HourPerf` 同形）。 */
+export interface PerfHourData {
     samples: number;
     ttftAvg: number;
     tpsAvg?: number;
@@ -34,13 +33,12 @@ export interface PerfHourModelData {
 /** 性能指标文档（服务端可选 `perf` 字段；旧快照缺失）。 */
 export interface ClientPerf {
     byModel: Record<string, PerfModelData>;
-    /** 小时 → 模型 → 小时统计；旧 host 文档缺失时图表区按空态兜底。 */
-    byHourModel: Record<string, Record<string, PerfHourModelData>>;
+    byHour: Record<string, PerfHourData>;
 }
 /**
  * Render the performance panel.
  * @param props.perf - the optional perf doc; `undefined`/empty renders an empty state.
- * @param props.models - model legend (key/name/color) for the table swatches and curve chips.
+ * @param props.models - model legend (key/name/color) for the table swatches and curve legend.
  * @param props.t - locale function.
  */
 export declare function PerfPanel({ perf, models, t, }: {

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

@@ -1,73 +1,23 @@
 /**
  * TokenPanel: 「Token」分区——把 token 从费用里独立出来洞察。
  * 四个板块 + 导出，全部由 `UsageStats` 派生，服务端零改动：
- *  1. 每日 Token 趋势，双视角切换（7/30 天）：
- *     - 按结构：未命中输入 / 缓存命中 / 输出[含 reasoning] 三桶堆叠；
- *     - 按模型：每天按模型堆叠，段 = 该模型当日「模型总 Token」（输入[含命中] + 输出），
- *       分色复用趋势页 `chartModels`（同模型同色跨页一致）；
- *       旧快照缺 `byDayModels` 时隐藏切换钮，仅保留结构视角。
- *     悬停显示当日精确明细；图例 / 「模型 Token」表格行可点击聚焦单个模型
- *     （目标段保持原色，其余段弱化，y 轴不变）。
- *     归因边界：reasoning 无按日 × 模型明细（`byDayModels` 无该字段），图与导出不含此列。
- *  2. 模型 Token 总量排行 + 占比（行点击 = 聚焦该模型并切到按模型视角）；
+ *  1. 每日 Token 堆叠趋势（未命中输入 / 缓存命中 / 输出[含 reasoning]），7/30 天切换；
+ *  2. 模型 Token 总量排行 + 占比；
  *  3. Token 结构 KPI（缓存命中率 / reasoning 占比 / 输入:输出比 / 峰值日）+ 显式缓存写入；
  *  4. 工具调用排行（byTool 计次；token 无法按工具归因）。
  */
 import type { UsageBillingKey } from './locales.ts';
-import type { TrendSeriesModel } from './TrendChart.tsx';
 import type { UsageStats } from './UsageBilling.tsx';
-/** 每日 token 堆叠图元（按结构视角）。 */
-interface DailyBucket {
-    date: string;
-    miss: number;
-    hit: number;
-    output: number;
-    reasoning: number;
-}
-/** 按模型视角下某模型某日的 token 明细（`byDayModels` 无 reasoning 列）。 */
-interface ModelDayCell {
-    hit: number;
-    miss: number;
-    output: number;
-    /** 命中 + 未命中 + 输出（= 模型总 Token 口径）。 */
-    total: number;
-}
-/** 按模型视角的一天：各模型段 + 当日合计。 */
-interface DayModelsRow {
-    date: string;
-    models: Record<string, ModelDayCell>;
-    total: number;
-}
-/** 模型 token 行。 */
-interface ModelTokenRow {
-    key: string;
-    name: string;
-    input: number;
-    output: number;
-    reasoning: number;
-    calls: number;
-    cacheHit: number;
-    cacheMiss: number;
-    cacheHitRate: number;
-    total: number;
-    /** 占总 token 比例（0..1）。 */
-    share: number;
-}
-/** 导出全量 JSON 文档：按日结构 + 模型排行 + 按日×模型明细 + 总量（无 reasoning 列）。 */
-export declare function tokenDailyJson(days: readonly DailyBucket[], models: readonly ModelTokenRow[], dayModels: readonly DayModelsRow[], total: UsageStats['total']): string;
 /**
  * Token 洞察面板。
- * @param props.stats - usage-stats 文档（byDay/byModel/byDayModels/total）。
+ * @param props.stats - usage-stats 文档（byDay/byModel/total）。
  * @param props.trendDays - 每日 token 窗口（7/30 天）。
  * @param props.onTrendDays - 切换趋势窗口。
- * @param props.models - 趋势页同款模型图例（key/name/色）：按模型视角的分色来源；缺省用兜底灰。
  */
 export declare function TokenPanel(props: {
     stats: UsageStats;
     trendDays: 7 | 30;
     onTrendDays: (d: 7 | 30) => void;
-    models?: readonly TrendSeriesModel[];
     t: (key: UsageBillingKey) => string;
 }): React.ReactNode;
-export {};
 //# sourceMappingURL=TokenPanel.d.ts.map

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

@@ -10,7 +10,7 @@
  *（billing.dashboard.decor）并注册计费指标服务（ctx.billingMetrics），主题
  * 插件主动注入装饰视觉、消费费用数据——billing 不反向依赖任何主题包。
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
 import { type UsageBillingKey } from './locales.ts';
 import { type BillingMetricsService } from './billing-service.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
@@ -45,18 +45,11 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         usageBilling: UsageBillingKey;
     }
 }
-/** Required services for the usage billing surface.
- *
- * `remote.llm` is deliberately NOT injected: the LLM remote namespace only
- * exists on 0.1.2-alpha.1 hosts, and a pending injection blocks the whole
- * web boot on older hosts. `checkModels` probes `ctx.remote.llm` defensively
- * instead — on hosts without it the model health check degrades to the
- * static catalog result (the surrounding try/catch already swallows the
- * undefined access). */
+/** Required services for the usage billing surface. */
 export declare const inject: string[];
 /**
  * Client plugin body: the UsageBilling entry in the sidebar footer.
  * @param ctx - client root context.
  */
-export declare function apply(ctx: Context): void;
+export declare function apply(ctx: ClientContext): void;
 //# sourceMappingURL=apply.d.ts.map

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

@@ -5,7 +5,7 @@
  * store 引擎持久化到 localStorage（persist key 即存储身份），重启后保留。
  * 宿主 Config 的 monthlyBudget 仅作为金额未设置时的默认值，用户输入优先。
  */
-import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client';
 /** 预算偏好状态。 */
 export interface BudgetPrefsState {
     /** 预算条开关：关 = 只显示标题行与开关，不显示进度。 */

package/lib/types/client/completion-notify.d.ts

@@ -5,8 +5,8 @@
  * 可选：跨 tab 只保留一个提醒 leader（Web Locks 优先，降级 localStorage 租约），
  * 避免多窗口同时弹同一条。配置持久化在 localStorage（默认关闭，用户在面板设置开启）。
  */
-import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
-import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-runtime/client';
 /** 配置持久化 key：开启/关闭 + 提醒持续模式（0=常驻，其余=秒后自动关）。 */
 export declare const COMPLETION_NOTIFY_KEY = "dsh-billing-completion-notify-v1";
 export interface CompletionNotifyConfig {

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

@@ -32,6 +32,6 @@ export declare function UsageHeatmap({ days, currency, now, t, range }: {
     currency: CostCurrency;
     now?: Date;
     range?: 'month' | 'year';
-    t: (key: 'costAbbr' | 'noData' | 'heatmapLess' | 'heatmapMore') => string;
+    t: (key: 'billing.costAbbr' | 'billing.noData' | 'billing.heatmapLess' | 'billing.heatmapMore') => string;
 }): React.ReactNode;
 //# sourceMappingURL=heatmap.d.ts.map

package/lib/types/client/live-cost.d.ts

@@ -6,16 +6,17 @@
  * composer card, same posture as ui-conversation's own StatsLine), so it stays
  * visible while working without opening the full dashboard. Data comes from the
  * same `/api/billing/usage-stats` endpoint the dashboard polls; the bar reads
- * the current session id from the session-scope standard kit and matches
- * `bySession` (session total) and `byTurn` (latest turn cost). Rendering is a
- * pure function of props and polled data, never a side effect.
+ * the current session id off the framework snapshot (`useSession` parent of
+ * `sessionId`) and matches `bySession` (session total) and `byTurn` (latest
+ * turn cost). Rendering is a pure function of the snapshot, never a side effect.
  *
  * The bar also carries two ambient signals: the current peak/off-peak pricing
  * tier with a switch countdown (DeepSeek time-of-day pricing), and quota chips
  * for subscription plans running low (≤20% remaining), so cost pressure is
  * visible without opening the dashboard.
  */
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ConversationSnapshot } from '@deepseek-ai/dsh-client-runtime/client';
 import type { UsageBillingKey } from './locales.ts';
 /** The usage-stats shape the composer bar needs (a thin slice, not the whole doc). */
 export interface LiveStats {
@@ -66,16 +67,15 @@ export declare function lowQuotaChips(quotas: readonly QuotaSlice[], threshold?:
     kind: string;
     pct: number;
 }[];
-/** Props: the framework's session identity plus the owning dock's locale seat. */
+/** Props: the session-scope snapshot selector the framework injects. */
 export interface LiveCostBarProps {
-    /** Current Session identity supplied by the session-scope standard kit. */
-    sessionId: SessionId;
+    useSession: SnapshotSelectorHook<ConversationSnapshot>;
     /** The owning dock's locale seat (bound to the billing NS). */
     t: (key: UsageBillingKey) => string;
 }
 /**
  * Render the live cost ticker for the current session.
- * @param props - framework session identity and locale.
+ * @param props - framework session snapshot hook and locale.
  */
-export declare function LiveCostBar({ sessionId, t }: LiveCostBarProps): React.ReactNode;
+export declare function LiveCostBar({ useSession, t }: LiveCostBarProps): React.ReactNode;
 //# sourceMappingURL=live-cost.d.ts.map