@rayadesu/dsh-client-ui-billing 0.1.0 → 0.2.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: c29d9a4ee0ff5a52e184f6ac6fa512b4bf932733
-README.zh.md: 8bfeb0333533b20c386fb3f29039742249ed0165
+README.md: 0856ee1b93e49f34da5f534ce189568b8157d157
+README.zh.md: 80a4334b4eaf79636fbdad0ce9484f07dfb1f8e0

package/README.md

@@ -12,9 +12,9 @@ The badge is account-level even though the slot is session-scoped: the header ut
 
 The spends follow the conversation and the balance stays a manual snapshot:
 
-- **Spends follow new messages** — the component subscribes to the current session's message count through the framework `useSession` seat. When a new message lands, it recomputes this session's spend (`billing/getSessionSpend`) and today's spend (`billing/getTodaySpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation.
+- **Spends follow settled turns, debounced** — the component subscribes to the current session's running flag through the framework `useSession` seat. When a prompt turn settles (the flag flips back to idle), it recomputes this session's spend (`billing/getSessionSpend`) and today's spend (`billing/getTodaySpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation. The recompute is debounced for two seconds, so a burst of turns (an agent continuing across turns) prices once instead of once per turn; the host-side cache (see `dsh-llm-billing`) then serves the first miss for the rest of the minute.
 - **Balance is manual** — the account balance is fetched on mount, on session switch, and on the explicit refresh action (`billing/getBalance`). There is no polling and no automatic refetch: the balance line only changes when one of those events happens.
-- **Refresh keeps the last values** — an in-flight refresh leaves the previous values on screen, and a failed refresh retains the last good value instead of blanking it.
+- **Refresh keeps the last values** — an in-flight refresh leaves the previous values on screen, and a failed refresh retains the last good value instead of blanking it. The refresh action calls `billing/getTodaySpend(true)`, which bypasses the host-side cache; the turn-triggered recompute and the mount/session-switch read use the cached path.
 
 ## Model Experience
 

package/README.zh.md

@@ -12,9 +12,9 @@ Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡
 
 花费跟随会话、额度保持手动快照：
 
-- **花费随新消息自动更新** —— 组件通过框架 `useSession` 座位订阅当前会话的消息数。每到达一条新消息，就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。
+- **花费随回合结束自动更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的「运行中」标志。每当一轮 prompt 回合结束（标志翻回空闲），就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。重算有 2 秒去抖，回合突发（agent 连续多轮）只计价一次；宿主侧缓存（见 `dsh-llm-billing`）随后在一分钟内服务首次未命中。
 - **额度保持手动** —— 账户余额在挂载、切换会话、点刷新按钮时拉取（`billing/getBalance`）。**没有轮询、不会自动重拉**：余额行只在这几个时机变化。
-- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。
+- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getTodaySpend(true)`，绕过宿主侧缓存；回合结束触发的重算与挂载/切换会话的读取走缓存路径。
 
 ## 模型体验
 

package/lib/client.js

@@ -4,10 +4,10 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/core.js
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 		var _a$1;
 		function $constructor(name, initializer, params) {
 			function init(inst, def) {
@@ -66,7 +66,7 @@ window.__ModuleLoader__.load({
 			return globalConfig;
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/util.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/util.js
 		function getEnumValues(entries) {
 			const numericValues = Object.values(entries).filter((v) => typeof v === "number");
 			return Object.entries(entries).filter(([k, _]) => numericValues.indexOf(+k) === -1).map(([_, v]) => v);
@@ -378,7 +378,7 @@ window.__ModuleLoader__.load({
 			return { ...iss };
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/errors.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/errors.js
 		const initializer$1 = (inst, def) => {
 			inst.name = "$ZodError";
 			Object.defineProperty(inst, "_zod", {
@@ -438,7 +438,7 @@ window.__ModuleLoader__.load({
 			return fieldErrors;
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/parse.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/parse.js
 		const _parse = (_Err) => (schema, value, _ctx, _params) => {
 			const ctx = _ctx ? {
 				..._ctx,
@@ -552,7 +552,7 @@ window.__ModuleLoader__.load({
 			return _safeParseAsync(_Err)(schema, value, _ctx);
 		};
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/regexes.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/regexes.js
 		/**
 		* @deprecated CUID v1 is deprecated by its authors due to information leakage
 		* (timestamps embedded in the id). Use {@link cuid2} instead.
@@ -616,7 +616,7 @@ window.__ModuleLoader__.load({
 		const lowercase = /^[^A-Z]*$/;
 		const uppercase = /^[^a-z]*$/;
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/checks.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/checks.js
 		const $ZodCheck = /*@__PURE__*/ $constructor("$ZodCheck", (inst, def) => {
 			var _a;
 			inst._zod ?? (inst._zod = {});
@@ -974,7 +974,7 @@ window.__ModuleLoader__.load({
 			};
 		});
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/doc.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/doc.js
 		var Doc = class {
 			constructor(args = []) {
 				this.content = [];
@@ -1005,14 +1005,14 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/versions.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/versions.js
 		const version = {
 			major: 4,
 			minor: 4,
 			patch: 3
 		};
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/schemas.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/schemas.js
 		const $ZodType = /*@__PURE__*/ $constructor("$ZodType", (inst, def) => {
 			var _a;
 			inst ?? (inst = {});
@@ -2115,7 +2115,7 @@ window.__ModuleLoader__.load({
 			}
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/registries.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/registries.js
 		var _a;
 		var $ZodRegistry = class {
 			constructor() {
@@ -2162,7 +2162,7 @@ window.__ModuleLoader__.load({
 		(_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
 		const globalRegistry = globalThis.__zod_globalRegistry;
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/api.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/api.js
 		// @__NO_SIDE_EFFECTS__
 		function _string(Class, params) {
 			return new Class({
@@ -2667,7 +2667,7 @@ window.__ModuleLoader__.load({
 			return ch;
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/to-json-schema.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/to-json-schema.js
 		function initializeContext(params) {
 			let target = params?.target ?? "draft-2020-12";
 			if (target === "draft-4") target = "draft-04";
@@ -2960,7 +2960,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return finalize(ctx, schema);
 		};
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/core/json-schema-processors.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/json-schema-processors.js
 		const formatMap = {
 			guid: "uuid",
 			url: "uri",
@@ -3168,7 +3168,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			seen.ref = def.innerType;
 		};
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/classic/iso.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/iso.js
 		const ZodISODateTime = /*@__PURE__*/ $constructor("ZodISODateTime", (inst, def) => {
 			$ZodISODateTime.init(inst, def);
 			ZodStringFormat.init(inst, def);
@@ -3198,7 +3198,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return /* @__PURE__ */ _isoDuration(ZodISODuration, params);
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/classic/errors.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/errors.js
 		const initializer = (inst, issues) => {
 			$ZodError.init(inst, issues);
 			inst.name = "ZodError";
@@ -3220,7 +3220,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		};
 		const ZodRealError = /*@__PURE__*/ $constructor("ZodError", initializer, { Parent: Error });
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/classic/parse.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/parse.js
 		const parse = /* @__PURE__ */ _parse(ZodRealError);
 		const parseAsync = /* @__PURE__ */ _parseAsync(ZodRealError);
 		const safeParse = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -3234,7 +3234,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const safeEncodeAsync = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 		const safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/node_modules/zod/v4/classic/schemas.js
+		//#region ../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/schemas.js
 		const _installedGroups = /* @__PURE__ */ new WeakMap();
 		function _installLazyMethods(inst, group, methods) {
 			const proto = Object.getPrototypeOf(inst);
@@ -3989,7 +3989,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return /* @__PURE__ */ _superRefine(fn, params);
 		}
 		//#endregion
-		//#region node_modules/@rayadesu/dsh-llm-billing/lib/typert.remote-client.js
+		//#region ../../llm/llm-billing/lib/typert.remote-client.js
 		const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = object({
 			"isAvailable": boolean(),
 			"lines": array(object({
@@ -4033,10 +4033,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}))
 		});
 		const TYPERT_REMOTE = {
-			package: "@rayadesu/dsh-llm-billing",
+			package: "@deepseek-ai/dsh-llm-billing",
 			descriptors: [
 				{
-					id: "@rayadesu/dsh-llm-billing#billing/getBalance",
+					id: "@deepseek-ai/dsh-llm-billing#billing/getBalance",
 					service: "billing",
 					namespace: "billing",
 					method: "getBalance",
@@ -4044,7 +4044,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					parameters: [],
 					result: {
 						mode: "strict",
-						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekBalance",
+						typeSymbol: "@deepseek-ai/dsh-llm-billing/types#DeepSeekBalance",
 						schema: _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema
 					},
 					sourceLocation: {
@@ -4054,7 +4054,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}
 				},
 				{
-					id: "@rayadesu/dsh-llm-billing#billing/getSessionSpend",
+					id: "@deepseek-ai/dsh-llm-billing#billing/getSessionSpend",
 					service: "billing",
 					namespace: "billing",
 					method: "getSessionSpend",
@@ -4071,7 +4071,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}],
 					result: {
 						mode: "strict",
-						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend",
+						typeSymbol: "@deepseek-ai/dsh-llm-billing/types#DeepSeekSessionSpend",
 						schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema
 					},
 					sourceLocation: {
@@ -4081,7 +4081,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}
 				},
 				{
-					id: "@rayadesu/dsh-llm-billing#billing/getTodaySpend",
+					id: "@deepseek-ai/dsh-llm-billing#billing/getTodaySpend",
 					service: "billing",
 					namespace: "billing",
 					method: "getTodaySpend",
@@ -4089,7 +4089,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					parameters: [],
 					result: {
 						mode: "strict",
-						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend",
+						typeSymbol: "@deepseek-ai/dsh-llm-billing/types#DeepSeekTodaySpend",
 						schema: _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema
 					},
 					sourceLocation: {
@@ -4101,8 +4101,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			]
 		};
 		//#endregion
-		//#region \0dsh-css:D:\code\deepseek-harness\packages\client\ui-billing\src\client\BalanceBadge.module.css.mjs
-		const css = ".YAT53G_root{position:relative}.YAT53G_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}.YAT53G_trigger:hover,.YAT53G_trigger:focus-visible{color:var(--dsw-alias-label-primary)}.YAT53G_trigger svg{transition:transform .12s}.YAT53G_chevronOpen{transform:rotate(180deg)}.YAT53G_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}.YAT53G_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}.YAT53G_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}.YAT53G_unavailable{color:var(--dsw-alias-label-tertiary)}.YAT53G_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}.YAT53G_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite YAT53G_spin}@keyframes YAT53G_spin{to{transform:rotate(360deg)}}.YAT53G_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}.YAT53G_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.YAT53G_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}.YAT53G_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.YAT53G_costRow{align-items:center;padding:2px 8px 6px;display:flex}.YAT53G_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}.YAT53G_amountActions{align-items:center;gap:2px;display:inline-flex}.YAT53G_infoButton,.YAT53G_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.YAT53G_infoButton:hover,.YAT53G_infoButton:focus-visible,.YAT53G_refreshButton:hover,.YAT53G_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}.YAT53G_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}.YAT53G_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}.YAT53G_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}";
+		//#region \0dsh-css:/Users/raya/Developer/deepseek-harness/packages/client/ui-billing/src/client/BalanceBadge.module.css.mjs
+		const css = ".EFxmGG_root{position:relative}.EFxmGG_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}.EFxmGG_trigger:hover,.EFxmGG_trigger:focus-visible{color:var(--dsw-alias-label-primary)}.EFxmGG_trigger svg{transition:transform .12s}.EFxmGG_chevronOpen{transform:rotate(180deg)}.EFxmGG_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}.EFxmGG_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}.EFxmGG_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}.EFxmGG_unavailable{color:var(--dsw-alias-label-tertiary)}.EFxmGG_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}.EFxmGG_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite EFxmGG_spin}@keyframes EFxmGG_spin{to{transform:rotate(360deg)}}.EFxmGG_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}.EFxmGG_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.EFxmGG_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}.EFxmGG_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.EFxmGG_costRow{align-items:center;padding:2px 8px 6px;display:flex}.EFxmGG_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}.EFxmGG_amountActions{align-items:center;gap:2px;display:inline-flex}.EFxmGG_infoButton,.EFxmGG_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.EFxmGG_infoButton:hover,.EFxmGG_infoButton:focus-visible,.EFxmGG_refreshButton:hover,.EFxmGG_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}.EFxmGG_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}.EFxmGG_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}.EFxmGG_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}";
 		const tagId = "@rayadesu/dsh-client-ui-billing/BalanceBadge.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4112,31 +4112,31 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			document.head.appendChild(tag);
 		}
 		var BalanceBadge_module_css_default = {
-			"amountActions": "YAT53G_amountActions",
-			"amountLabel": "YAT53G_amountLabel",
-			"amountRow": "YAT53G_amountRow",
-			"chevronOpen": "YAT53G_chevronOpen",
-			"costBreakdown": "YAT53G_costBreakdown",
-			"costRow": "YAT53G_costRow",
-			"infoButton": "YAT53G_infoButton",
-			"inlineIcon": "YAT53G_inlineIcon",
-			"linePrimary": "YAT53G_linePrimary",
-			"lineSecondary": "YAT53G_lineSecondary",
-			"modelName": "YAT53G_modelName",
-			"modelRow": "YAT53G_modelRow",
-			"panel": "YAT53G_panel",
-			"refreshButton": "YAT53G_refreshButton",
-			"root": "YAT53G_root",
-			"spendRow": "YAT53G_spendRow",
-			"spin": "YAT53G_spin",
-			"spinning": "YAT53G_spinning",
-			"tasks": "YAT53G_tasks",
-			"trigger": "YAT53G_trigger",
-			"triggerLines": "YAT53G_triggerLines",
-			"unavailable": "YAT53G_unavailable"
+			"amountActions": "EFxmGG_amountActions",
+			"amountLabel": "EFxmGG_amountLabel",
+			"amountRow": "EFxmGG_amountRow",
+			"chevronOpen": "EFxmGG_chevronOpen",
+			"costBreakdown": "EFxmGG_costBreakdown",
+			"costRow": "EFxmGG_costRow",
+			"infoButton": "EFxmGG_infoButton",
+			"inlineIcon": "EFxmGG_inlineIcon",
+			"linePrimary": "EFxmGG_linePrimary",
+			"lineSecondary": "EFxmGG_lineSecondary",
+			"modelName": "EFxmGG_modelName",
+			"modelRow": "EFxmGG_modelRow",
+			"panel": "EFxmGG_panel",
+			"refreshButton": "EFxmGG_refreshButton",
+			"root": "EFxmGG_root",
+			"spendRow": "EFxmGG_spendRow",
+			"spin": "EFxmGG_spin",
+			"spinning": "EFxmGG_spinning",
+			"tasks": "EFxmGG_tasks",
+			"trigger": "EFxmGG_trigger",
+			"triggerLines": "EFxmGG_triggerLines",
+			"unavailable": "EFxmGG_unavailable"
 		};
 		//#endregion
-		//#region lib/types/client/BalanceBadge.js
+		//#region src/client/BalanceBadge.tsx
 		/** Session-header billing badge: balance plus the current conversation's billed spend. */
 		/** Currency prefix for one balance line; unknown codes render as a literal prefix. */
 		function currencySymbol(currency) {
@@ -4165,10 +4165,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* every session, a refresh action, and a spend disclaimer. Refreshing keeps
 		* the last values visible rather than blanking them.
 		*
-		* The spend follows the conversation: a new message in the current session
-		* recomputes only the (local, network-free) session spend and today's spend
-		* through `getSessionSpend` / `getTodaySpend`; the balance stays a
-		* manual-refresh snapshot and is never refetched on its own.
+		* The spend follows the conversation: when a prompt turn settles in the
+		* current session, the badge recomputes only the (local, network-free)
+		* session spend and today's spend through `getSessionSpend` /
+		* `getTodaySpend`; the balance stays a manual-refresh snapshot and is never
+		* refetched on its own.
 		* @param props - Remote face, locale, and the standard session-header runtime share.
 		* @returns the badge, or null until the first balance fetch settles.
 		*/
@@ -4181,8 +4182,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const [open, setOpen] = (0, react.useState)(false);
 			const [request, setRequest] = (0, react.useState)(0);
 			const rootRef = (0, react.useRef)(null);
-			const messageCount = useSession((snapshot) => snapshot.chat.order.length);
-			const pricedMessageCountRef = (0, react.useRef)(messageCount);
+			const running = useSession((snapshot) => snapshot.running);
+			const pricedRunningRef = (0, react.useRef)(running);
 			(0, react.useEffect)(() => {
 				let current = true;
 				setRefreshing(balance !== null);
@@ -4199,7 +4200,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						if (!current) return;
 						setSpend(value);
 					}, () => {});
-					const todaySpendRequest = Promise.resolve().then(getTodaySpend).then((value) => {
+					const todaySpendRequest = Promise.resolve().then(() => getTodaySpend(request > 0)).then((value) => {
 						if (!current) return;
 						setTodaySpend(value);
 					}, () => {});
@@ -4222,27 +4223,31 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				request
 			]);
 			(0, react.useEffect)(() => {
-				if (messageCount === pricedMessageCountRef.current) return;
-				pricedMessageCountRef.current = messageCount;
+				if (running === pricedRunningRef.current) return;
+				pricedRunningRef.current = running;
+				if (running) return;
 				let current = true;
-				Promise.resolve().then(() => {
-					Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
-						if (!current) return;
-						setSpend(value);
-					}, () => {});
-					Promise.resolve().then(getTodaySpend).then((value) => {
-						if (!current) return;
-						setTodaySpend(value);
-					}, () => {});
-				});
+				const timer = setTimeout(() => {
+					Promise.resolve().then(() => {
+						Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
+							if (!current) return;
+							setSpend(value);
+						}, () => {});
+						Promise.resolve().then(() => getTodaySpend()).then((value) => {
+							if (!current) return;
+							setTodaySpend(value);
+						}, () => {});
+					});
+				}, 2e3);
 				return () => {
+					clearTimeout(timer);
 					current = false;
 				};
 			}, [
 				getSessionSpend,
 				getTodaySpend,
 				sessionId,
-				messageCount
+				running
 			]);
 			(0, react.useEffect)(() => {
 				if (!open) return;
@@ -4256,20 +4261,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}, [open]);
 			if (balance === null) {
 				if (error === null) return null;
-				return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 					label: error,
 					delayMs: 500,
-					children: (0, react_jsx_runtime.jsxs)("button", {
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 						type: "button",
 						className: BalanceBadge_module_css_default.trigger,
 						onClick: () => {
 							setRequest((value) => value + 1);
 						},
 						"aria-label": t("action.refresh"),
-						children: [(0, react_jsx_runtime.jsx)("span", {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: BalanceBadge_module_css_default.unavailable,
 							children: t("state.unavailable")
-						}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline14, { className: BalanceBadge_module_css_default.inlineIcon })]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline14, { className: BalanceBadge_module_css_default.inlineIcon })]
 					})
 				});
 			}
@@ -4279,10 +4284,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const line = primaryLine(balance);
 			const amount = line === void 0 ? "—" : `${line.symbol}${line.total}`;
 			const spendLine = spend !== null && spend.models.length > 0 ? t("trigger.conversationSpend", { amount: formatSpend(spend.total) }) : void 0;
-			return (0, react_jsx_runtime.jsxs)("div", {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				ref: rootRef,
 				className: BalanceBadge_module_css_default.root,
-				children: [(0, react_jsx_runtime.jsxs)("button", {
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 					type: "button",
 					className: BalanceBadge_module_css_default.trigger,
 					"aria-expanded": open,
@@ -4290,70 +4295,70 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					onClick: () => {
 						setOpen((value) => !value);
 					},
-					children: [(0, react_jsx_runtime.jsxs)("span", {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 						className: BalanceBadge_module_css_default.triggerLines,
-						children: [(0, react_jsx_runtime.jsx)("span", {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: BalanceBadge_module_css_default.linePrimary,
 							children: t("trigger.balance", { amount })
-						}), spendLine !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+						}), spendLine !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: BalanceBadge_module_css_default.lineSecondary,
 							children: spendLine
 						})]
-					}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: open ? BalanceBadge_module_css_default.chevronOpen : void 0 })]
-				}), open ? (0, react_jsx_runtime.jsxs)("div", {
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: open ? BalanceBadge_module_css_default.chevronOpen : void 0 })]
+				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: BalanceBadge_module_css_default.panel,
 					role: "dialog",
 					"aria-label": t("panel.aria"),
 					children: [
-						(0, react_jsx_runtime.jsxs)("div", {
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: BalanceBadge_module_css_default.amountRow,
-							children: [(0, react_jsx_runtime.jsx)("span", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.amountLabel,
 								children: t("label.amount", { amount })
-							}), (0, react_jsx_runtime.jsxs)("span", {
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 								className: BalanceBadge_module_css_default.amountActions,
-								children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 									label: t("info.hint"),
 									delayMs: 200,
 									maxWidth: 340,
-									children: (0, react_jsx_runtime.jsx)("button", {
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
 										className: BalanceBadge_module_css_default.infoButton,
 										"aria-label": t("info.aria"),
-										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconQuestionOutline14, { className: BalanceBadge_module_css_default.inlineIcon })
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconQuestionOutline14, { className: BalanceBadge_module_css_default.inlineIcon })
 									})
-								}), (0, react_jsx_runtime.jsx)("button", {
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: BalanceBadge_module_css_default.refreshButton,
 									onClick: refresh,
 									"aria-label": t("action.refresh"),
 									"data-refreshing": refreshing || void 0,
-									children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline14, { className: refreshing ? BalanceBadge_module_css_default.spinning : BalanceBadge_module_css_default.inlineIcon })
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline14, { className: refreshing ? BalanceBadge_module_css_default.spinning : BalanceBadge_module_css_default.inlineIcon })
 								})]
 							})]
 						}),
-						(0, react_jsx_runtime.jsxs)("div", {
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: BalanceBadge_module_css_default.spendRow,
-							children: [(0, react_jsx_runtime.jsx)("span", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.amountLabel,
 								children: t("label.sessionSpend", { amount: spend === null ? "—" : spend.models.length === 0 ? t("stat.none") : formatSpend(spend.total) })
-							}), (0, react_jsx_runtime.jsx)("span", {
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.amountLabel,
 								children: t("label.todaySpend", { amount: todaySpend === null ? "—" : todaySpend.models.length === 0 ? t("stat.none") : formatSpend(todaySpend.total) })
 							})]
 						}),
-						spend?.models.map((model) => (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [(0, react_jsx_runtime.jsxs)("div", {
+						spend?.models.map((model) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: BalanceBadge_module_css_default.modelRow,
-							children: [(0, react_jsx_runtime.jsx)("span", {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.modelName,
 								children: model.displayName
-							}), (0, react_jsx_runtime.jsx)("span", {
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.tasks,
 								children: formatSpend(model.cost)
 							})]
-						}), (0, react_jsx_runtime.jsx)("div", {
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: BalanceBadge_module_css_default.costRow,
-							children: (0, react_jsx_runtime.jsxs)("span", {
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 								className: BalanceBadge_module_css_default.costBreakdown,
 								children: [
 									t("label.cost.hit", { amount: formatSpend(model.cacheHitInputCost) }),
@@ -4369,7 +4374,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			});
 		}
 		//#endregion
-		//#region lib/types/client/locales.js
+		//#region src/client/locales.ts
 		/** `billing` namespace dictionaries. */
 		/** Dictionary namespace owned by this plugin. */
 		const NS = "billing";
@@ -4410,8 +4415,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"panel.aria": "DeepSeek balance details"
 		};
 		//#endregion
-		//#region lib/types/client/index.js
-		/** DeepSeek account-balance badge, browser half: one session-header utility entry. */
+		//#region src/client/index.ts
 		/** Services required for locale registration, the Remote face, and the header slot. */
 		const inject = [
 			"slots",
@@ -4442,8 +4446,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					if (!result.ok) throw new Error(`billing.getSessionSpend failed: ${result.error.code}: ${result.error.message}`);
 					return result.value;
 				},
-				getTodaySpend: async () => {
-					const result = await billing.getTodaySpend();
+				getTodaySpend: async (force) => {
+					const result = await billing.getTodaySpend(force);
 					if (!result.ok) throw new Error(`billing.getTodaySpend failed: ${result.error.code}: ${result.error.message}`);
 					return result.value;
 				}

package/lib/invariant.js

@@ -1,9 +1,9 @@
 //#region lib/types/invariant.js
 /**
-* Package-owned invariant companion for `@rayadesu/dsh-client-ui-billing`.
-* @module @rayadesu/dsh-client-ui-billing/invariant
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-billing`.
+* @module @deepseek-ai/dsh-client-ui-billing/invariant
 */
-const PACKAGE_NAME = "@rayadesu/dsh-client-ui-billing";
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-billing";
 /** Cordis companion plugin name. */
 const name = "client-ui-billing-invariant";
 /** Service required before the companion can reserve package ownership. */

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

@@ -1,5 +1,5 @@
 /** Session-header billing badge: balance plus the current conversation's billed spend. */
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@deepseek-ai/dsh-llm-billing/types';
 import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from './locales.ts';
@@ -27,7 +27,7 @@ export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilit
  * through `getSessionSpend` / `getTodaySpend`; the balance stays a
  * manual-refresh snapshot and is never refetched on its own.
  * @param props - Remote face, locale, and the standard session-header runtime share.
- * @returns the badge, or null until the first balance fetch settles.
+ * @returns the badge, or null while the first fetch is in flight.
  */
 export declare function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, sessionId, useSession, t }: BalanceBadgeProps): import("react").JSX.Element | null;
 //# sourceMappingURL=BalanceBadge.d.ts.map

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

@@ -15,7 +15,7 @@ export declare const zh: {
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
-    readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费率按 8 月 17 日实行的标准，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费。";
+    readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费用按 8 月 17 日实行的标准。";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
 };

package/lib/types/invariant.d.ts

@@ -1,6 +1,6 @@
 /**
- * Package-owned invariant companion for `@rayadesu/dsh-client-ui-billing`.
- * @module @rayadesu/dsh-client-ui-billing/invariant
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-billing`.
+ * @module @deepseek-ai/dsh-client-ui-billing/invariant
  */
 import type { Context } from '@deepseek-ai/cordis';
 /** Cordis companion plugin name. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rayadesu/dsh-client-ui-billing",
   "description": "Session-header DeepSeek account-balance and conversation-spend badge over the billing Remote",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.1.0",
+    "@rayadesu/dsh-llm-billing": "^0.2.1",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
@@ -54,7 +54,7 @@
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.1.0",
+    "@rayadesu/dsh-llm-billing": "^0.2.1",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.8",