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

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: 8672854e338576b027810cbfe8bf1a976ffa0824
+README.zh.md: 6c7e0cbd95094d437535def3f2d5d01d5bc98f6c

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 new messages, debounced** — 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. The recompute is debounced for two seconds, so a burst of messages (a streaming agent turn) prices once instead of once per message; 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 message-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` 座位订阅当前会话的消息数。每到达一条新消息，就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。重算有 2 秒去抖，消息突发（流式 agent 回合）只计价一次；宿主侧缓存（见 `dsh-llm-billing`）随后在一分钟内服务首次未命中。
 - **额度保持手动** —— 账户余额在挂载、切换会话、点刷新按钮时拉取（`billing/getBalance`）。**没有轮询、不会自动重拉**：余额行只在这几个时机变化。
-- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。
+- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getTodaySpend(true)`，绕过宿主侧缓存；消息触发的重算与挂载/切换会话的读取走缓存路径。
 
 ## 模型体验
 

package/lib/client.js

@@ -7,7 +7,7 @@ window.__ModuleLoader__.load({
 		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
+		//#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.
@@ -613,10 +613,11 @@ window.__ModuleLoader__.load({
 		const integer = /^-?\d+$/;
 		const number$1 = /^-?\d+(?:\.\d+)?$/;
 		const boolean$1 = /^(?:true|false)$/i;
+		const _undefined$2 = /^undefined$/i;
 		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 +975,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 +1006,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 = {});
@@ -1425,6 +1426,22 @@ window.__ModuleLoader__.load({
 				return payload;
 			};
 		});
+		const $ZodUndefined = /*@__PURE__*/ $constructor("$ZodUndefined", (inst, def) => {
+			$ZodType.init(inst, def);
+			inst._zod.pattern = _undefined$2;
+			inst._zod.values = new Set([void 0]);
+			inst._zod.parse = (payload, _ctx) => {
+				const input = payload.value;
+				if (typeof input === "undefined") return payload;
+				payload.issues.push({
+					expected: "undefined",
+					code: "invalid_type",
+					input,
+					inst
+				});
+				return payload;
+			};
+		});
 		const $ZodUnknown = /*@__PURE__*/ $constructor("$ZodUnknown", (inst, def) => {
 			$ZodType.init(inst, def);
 			inst._zod.parse = (payload) => payload;
@@ -1886,6 +1903,24 @@ window.__ModuleLoader__.load({
 				return payload;
 			};
 		});
+		const $ZodLiteral = /*@__PURE__*/ $constructor("$ZodLiteral", (inst, def) => {
+			$ZodType.init(inst, def);
+			if (def.values.length === 0) throw new Error("Cannot create literal schema with no valid values");
+			const values = new Set(def.values);
+			inst._zod.values = values;
+			inst._zod.pattern = new RegExp(`^(${def.values.map((o) => typeof o === "string" ? escapeRegex(o) : o ? escapeRegex(o.toString()) : String(o)).join("|")})$`);
+			inst._zod.parse = (payload, _ctx) => {
+				const input = payload.value;
+				if (values.has(input)) return payload;
+				payload.issues.push({
+					code: "invalid_value",
+					values: def.values,
+					input,
+					inst
+				});
+				return payload;
+			};
+		});
 		const $ZodTransform = /*@__PURE__*/ $constructor("$ZodTransform", (inst, def) => {
 			$ZodType.init(inst, def);
 			inst._zod.optin = "optional";
@@ -2115,7 +2150,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 +2197,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({
@@ -2464,6 +2499,13 @@ window.__ModuleLoader__.load({
 			});
 		}
 		// @__NO_SIDE_EFFECTS__
+		function _undefined$1(Class, params) {
+			return new Class({
+				type: "undefined",
+				...normalizeParams(params)
+			});
+		}
+		// @__NO_SIDE_EFFECTS__
 		function _unknown(Class) {
 			return new Class({ type: "unknown" });
 		}
@@ -2667,7 +2709,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 +3002,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",
@@ -3012,6 +3054,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const booleanProcessor = (_schema, _ctx, json, _params) => {
 			json.type = "boolean";
 		};
+		const undefinedProcessor = (_schema, ctx, _json, _params) => {
+			if (ctx.unrepresentable === "throw") throw new Error("Undefined cannot be represented in JSON Schema");
+		};
 		const neverProcessor = (_schema, _ctx, json, _params) => {
 			json.not = {};
 		};
@@ -3022,6 +3067,27 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			if (values.every((v) => typeof v === "string")) json.type = "string";
 			json.enum = values;
 		};
+		const literalProcessor = (schema, ctx, json, _params) => {
+			const def = schema._zod.def;
+			const vals = [];
+			for (const val of def.values) if (val === void 0) {
+				if (ctx.unrepresentable === "throw") throw new Error("Literal `undefined` cannot be represented in JSON Schema");
+			} else if (typeof val === "bigint") if (ctx.unrepresentable === "throw") throw new Error("BigInt literals cannot be represented in JSON Schema");
+			else vals.push(Number(val));
+			else vals.push(val);
+			if (vals.length === 0) {} else if (vals.length === 1) {
+				const val = vals[0];
+				json.type = val === null ? "null" : typeof val;
+				if (ctx.target === "draft-04" || ctx.target === "openapi-3.0") json.enum = [val];
+				else json.const = val;
+			} else {
+				if (vals.every((v) => typeof v === "number")) json.type = "number";
+				if (vals.every((v) => typeof v === "string")) json.type = "string";
+				if (vals.every((v) => typeof v === "boolean")) json.type = "boolean";
+				if (vals.every((v) => v === null)) json.type = "null";
+				json.enum = vals;
+			}
+		};
 		const customProcessor = (_schema, ctx, _json, _params) => {
 			if (ctx.unrepresentable === "throw") throw new Error("Custom types cannot be represented in JSON Schema");
 		};
@@ -3168,7 +3234,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 +3264,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 +3286,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 +3300,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);
@@ -3648,6 +3714,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function boolean(params) {
 			return /* @__PURE__ */ _boolean(ZodBoolean, params);
 		}
+		const ZodUndefined = /*@__PURE__*/ $constructor("ZodUndefined", (inst, def) => {
+			$ZodUndefined.init(inst, def);
+			ZodType.init(inst, def);
+			inst._zod.processJSONSchema = (ctx, json, params) => undefinedProcessor(inst, ctx, json, params);
+		});
+		function _undefined(params) {
+			return /* @__PURE__ */ _undefined$1(ZodUndefined, params);
+		}
 		const ZodUnknown = /*@__PURE__*/ $constructor("ZodUnknown", (inst, def) => {
 			$ZodUnknown.init(inst, def);
 			ZodType.init(inst, def);
@@ -3823,6 +3897,23 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				...normalizeParams(params)
 			});
 		}
+		const ZodLiteral = /*@__PURE__*/ $constructor("ZodLiteral", (inst, def) => {
+			$ZodLiteral.init(inst, def);
+			ZodType.init(inst, def);
+			inst._zod.processJSONSchema = (ctx, json, params) => literalProcessor(inst, ctx, json, params);
+			inst.values = new Set(def.values);
+			Object.defineProperty(inst, "value", { get() {
+				if (def.values.length > 1) throw new Error("This schema contains multiple valid literal values. Use `.values` instead.");
+				return def.values[0];
+			} });
+		});
+		function literal(value, params) {
+			return new ZodLiteral({
+				type: "literal",
+				values: Array.isArray(value) ? value : [value],
+				...normalizeParams(params)
+			});
+		}
 		const ZodTransform = /*@__PURE__*/ $constructor("ZodTransform", (inst, def) => {
 			$ZodTransform.init(inst, def);
 			ZodType.init(inst, def);
@@ -3989,8 +4080,8 @@ 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
-		const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = object({
+		//#region ../../llm/llm-billing/lib/typert.remote-client.js
+		const _rayadesu_dsh_llm_billing_billing_getBalance_result$schema = object({
 			"isAvailable": boolean(),
 			"lines": array(object({
 				"currency": string(),
@@ -3999,8 +4090,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"toppedUp": string()
 			}))
 		});
-		const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = intersection(string(), unknown());
-		const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = object({
+		const _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = intersection(string(), unknown());
+		const _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema = object({
 			"total": number(),
 			"models": array(object({
 				"model": string(),
@@ -4016,7 +4107,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"outputCost": number()
 			}))
 		});
-		const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = object({
+		const _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema = union([
+			_undefined(),
+			literal(false),
+			literal(true)
+		]);
+		const _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema = object({
 			"total": number(),
 			"models": array(object({
 				"model": string(),
@@ -4045,11 +4141,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekBalance",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getBalance_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 139,
+						"line": 143,
 						"column": 3
 					}
 				},
@@ -4066,17 +4162,17 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						codec: {
 							mode: "strict",
 							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
-							schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema
+							schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema
 						}
 					}],
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 149,
+						"line": 154,
 						"column": 3
 					}
 				},
@@ -4086,23 +4182,33 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					namespace: "billing",
 					method: "getTodaySpend",
 					invocation: { kind: "direct" },
-					parameters: [],
+					parameters: [{
+						name: "force",
+						wire: "force",
+						source: "json",
+						acceptsUndefined: true,
+						codec: {
+							mode: "strict",
+							typeSymbol: "@rayadesu/dsh-llm-billing#billing/getTodaySpend:force",
+							schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema
+						}
+					}],
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 159,
+						"line": 167,
 						"column": 3
 					}
 				}
 			]
 		};
 		//#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:C:\Users\admin\Desktop\me\code\deepseek-harness\packages\client\ui-billing\src\client\BalanceBadge.module.css.mjs
+		const css = ".v_-kjq_root{position:relative}.v_-kjq_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}.v_-kjq_trigger:hover,.v_-kjq_trigger:focus-visible{color:var(--dsw-alias-label-primary)}.v_-kjq_trigger svg{transition:transform .12s}.v_-kjq_chevronOpen{transform:rotate(180deg)}.v_-kjq_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}.v_-kjq_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}.v_-kjq_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}.v_-kjq_unavailable{color:var(--dsw-alias-label-tertiary)}.v_-kjq_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}.v_-kjq_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite v_-kjq_spin}@keyframes v_-kjq_spin{to{transform:rotate(360deg)}}.v_-kjq_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}.v_-kjq_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.v_-kjq_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}.v_-kjq_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}.v_-kjq_costRow{align-items:center;padding:2px 8px 6px;display:flex}.v_-kjq_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}.v_-kjq_amountActions{align-items:center;gap:2px;display:inline-flex}.v_-kjq_infoButton,.v_-kjq_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}.v_-kjq_infoButton:hover,.v_-kjq_infoButton:focus-visible,.v_-kjq_refreshButton:hover,.v_-kjq_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}.v_-kjq_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}.v_-kjq_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}.v_-kjq_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,28 +4218,28 @@ 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": "v_-kjq_amountActions",
+			"amountLabel": "v_-kjq_amountLabel",
+			"amountRow": "v_-kjq_amountRow",
+			"chevronOpen": "v_-kjq_chevronOpen",
+			"costBreakdown": "v_-kjq_costBreakdown",
+			"costRow": "v_-kjq_costRow",
+			"infoButton": "v_-kjq_infoButton",
+			"inlineIcon": "v_-kjq_inlineIcon",
+			"linePrimary": "v_-kjq_linePrimary",
+			"lineSecondary": "v_-kjq_lineSecondary",
+			"modelName": "v_-kjq_modelName",
+			"modelRow": "v_-kjq_modelRow",
+			"panel": "v_-kjq_panel",
+			"refreshButton": "v_-kjq_refreshButton",
+			"root": "v_-kjq_root",
+			"spendRow": "v_-kjq_spendRow",
+			"spin": "v_-kjq_spin",
+			"spinning": "v_-kjq_spinning",
+			"tasks": "v_-kjq_tasks",
+			"trigger": "v_-kjq_trigger",
+			"triggerLines": "v_-kjq_triggerLines",
+			"unavailable": "v_-kjq_unavailable"
 		};
 		//#endregion
 		//#region lib/types/client/BalanceBadge.js
@@ -4199,7 +4305,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);
 					}, () => {});
@@ -4225,17 +4331,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				if (messageCount === pricedMessageCountRef.current) return;
 				pricedMessageCountRef.current = messageCount;
 				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;
 				};
 			}, [
@@ -4442,8 +4551,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/types/client/BalanceBadge.d.ts

@@ -9,8 +9,12 @@ export interface BalanceBadgeInjected {
     getBalance: () => Promise<DeepSeekBalance>;
     /** Read one session's billed spend; rejects with the Remote error message. */
     getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
-    /** Read today's billed spend across every session; rejects with the Remote error message. */
-    getTodaySpend: () => Promise<DeepSeekTodaySpend>;
+    /**
+     * Read today's billed spend across every session; rejects with the Remote
+     * error message. `force` bypasses the host-side cache — the manual refresh
+     * passes it, the message-triggered recompute does not.
+     */
+    getTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
 }
 /** Full props assembled by the header utilities slot renderer. */
 export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<BalanceBadgeInjected> & PropsLocale<typeof NS>;

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.0",
   "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.0",
     "@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.0",
     "@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",