@rayadesu/dsh-client-ui-billing 0.3.12 → 0.3.13

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

@@ -1,11 +1,12 @@
 /**
  * Session-header billing badge: balance plus the current conversation's billed
- * spend. Composition root: the data lifecycle lives in {@link useBillingData},
- * and the trigger / detail panel are pure views. The badge renders null until
- * the first balance fetch settles, and a refresh keeps the last values
- * visible rather than blanking them.
+ * spend, both carrying the detail panel's own labels (`API 剩余金额` /
+ * `本会话花费`). Composition root: the data lifecycle lives in
+ * {@link useBillingData}, and the trigger / detail panel are pure views. The
+ * badge renders null until the first balance fetch settles, and a refresh keeps
+ * the last values visible rather than blanking them.
  */
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { DeepSeekBalance, DeepSeekDelegatedSpend, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from './locales.ts';
@@ -28,6 +29,13 @@ export interface BalanceBadgeInjected {
     getCachedBalance: () => DeepSeekBalance | null;
     /** Read one session's billed spend; rejects with the Remote error message. */
     getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
+    /**
+     * Read the subagent part of one conversation's billed spend: every subagent
+     * session that session delegated, transitively, across every day. The badge
+     * adds it to the live own-session value, so the amount it shows is the whole
+     * conversation's. `force` behaves as in {@link getTodaySpend}.
+     */
+    getDelegatedSpend: (sessionId: SessionId, force?: boolean) => Promise<DeepSeekDelegatedSpend>;
     /**
      * Read today's billed spend across every session; rejects with the Remote
      * error message. `force` bypasses the host-side cache — the manual refresh
@@ -36,7 +44,9 @@ export interface BalanceBadgeInjected {
     getTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
     /**
      * Read today's billed spend per session, sorted by cost descending; rejects
-     * with the Remote error message. `force` behaves as in {@link getTodaySpend}.
+     * with the Remote error message. One row per top-level conversation: the host
+     * merges every subagent session's spend into the row of the session that
+     * delegated it. `force` behaves as in {@link getTodaySpend}.
      */
     getTodaySessionsSpend: (force?: boolean) => Promise<DeepSeekTodaySessionsSpend>;
 }
@@ -50,5 +60,5 @@ export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilit
  * @param props - Remote face, locale, and the standard session-header runtime share.
  * @returns the badge, or null until the first balance fetch settles.
  */
-export declare function BalanceBadge({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, useProjection, t }: BalanceBadgeProps): import("react").JSX.Element | null;
+export declare function BalanceBadge({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, getDelegatedSpend, sessionId, useSession, useProjection, t }: BalanceBadgeProps): import("react").JSX.Element | null;
 //# sourceMappingURL=BalanceBadge.d.ts.map

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

@@ -12,13 +12,18 @@ export interface BalancePanelProps {
     amount: string;
     /** The session this panel belongs to: the row looked up in today's ranking. */
     sessionId: SessionId;
+    /** The WHOLE conversation's billed spend (this session plus the subagents it delegated). */
     spend: DeepSeekSessionSpend | null;
     todaySpend: DeepSeekTodaySpend | null;
     sessionsSpend: DeepSeekTodaySessionsSpend | null;
+    /** Whether this session is itself a delegated subagent child (so it has no ranking row of its own). */
+    isSubagent: boolean;
+    /** Whether this session started on an earlier Beijing day (the only time a today share is shown). */
+    crossedDay: boolean;
     refreshing: boolean;
     onRefresh: () => void;
     t: PropsLocale<typeof NS>['t'];
 }
 /** The detail box opened from the badge trigger. */
-export declare function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
+export declare function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, isSubagent, crossedDay, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
 //# sourceMappingURL=BalancePanel.d.ts.map

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

@@ -1,8 +1,8 @@
 /**
  * Shared display formatting for the billing badges: the balance-line currency
- * prefix, the CNY spend amount renderer, and the token-count renderer. Both the
- * header badge and the per-turn cost label format through these, so the two
- * entries cannot drift apart.
+ * prefix, the CNY spend amount renderer, the token-count renderer, and the
+ * cache-hit percentage. Both the header badge and the per-turn cost label
+ * format through these, so the two entries cannot drift apart.
  */
 import type { DeepSeekBalance } from '@rayadesu/dsh-llm-billing/types';
 /** Currency prefix for one balance line; unknown codes render as a literal prefix. */
@@ -12,8 +12,30 @@ export declare function primaryLine(balance: DeepSeekBalance): {
     symbol: string;
     total: string;
 } | undefined;
-/** CNY amount, up to four decimals with trailing zeros trimmed. */
+/**
+ * CNY amount, up to four decimals with trailing zeros trimmed. The balance line's
+ * renderer; spend figures go through {@link formatSpendSignificant} instead.
+ */
 export declare function formatSpend(amount: number): string;
+/**
+ * CNY spend amount at a fixed number of SIGNIFICANT digits (default three),
+ * trailing zeros trimmed, prefixed with `¥` — and never finer than the panel's
+ * own four-decimal resolution.
+ *
+ * Every spend figure the plugin renders goes through this: the day's own amount
+ * and its three bucket costs, this session's spend and the parenthesized today
+ * share after it, the per-model rows and their bucket breakdowns, the ranking
+ * amounts, and the badge's own spend line. Four decimals are noise at these
+ * magnitudes — their last digits move with every request (`¥0.5068` → `¥0.507`)
+ * — while the four-decimal bound keeps a microscopic amount from growing a long
+ * `¥0.00002` string that would widen its column: an amount that rounds to zero
+ * there reads `¥0`. Only the BALANCE line keeps {@link formatSpend}'s plain four
+ * decimals, because remaining credit is a balance, not a spend measurement.
+ * @param amount - the amount to render.
+ * @param digits - significant digits to keep (default 3).
+ * @returns the rendered amount, e.g. `¥9.58`, `¥0.507`, `¥1230`, `¥0`.
+ */
+export declare function formatSpendSignificant(amount: number, digits?: number): string;
 /**
  * A token count in DSH's own compact notation: `517` / `12.2K` / `517K` / `1.2M`.
  *
@@ -30,6 +52,27 @@ export declare function formatSpend(amount: number): string;
  * @returns the compact count, without the label's own ` tok` suffix.
  */
 export declare function formatTokens(count: number): string;
+/**
+ * The cache-hit share of one prompt, in DSH's own percentage rule.
+ *
+ * Mirrors ui-chat's `formatCacheHitPercent`
+ * (`packages/client/ui-chat/src/client/chat/token-format.ts`) rule for rule, so
+ * one shell never prints the same ratio two ways: an integer percentage by
+ * default, and — because a partial hit must never round up to a full one — just
+ * enough extra decimals to stay below 100 when integer rounding would reach it
+ * (`99`, `99.5`, `99.95`, …). The rounding runs in integer arithmetic with
+ * positive ties going up, so it does not ride on binary-float precision.
+ *
+ * The ratio is over PROMPT-side tokens only (cache read over cache read plus
+ * uncached input, the split DSH's own `billedInputTokens` makes); output tokens
+ * never enter the denominator.
+ * @param cacheReadTokens - exact prompt tokens served from cache.
+ * @param promptTokens - exact aggregate prompt-side tokens.
+ * @param decimalPlaces - ordinary-ratio precision; a partial hit that would
+ * round to 100 automatically uses enough additional precision to stay honest.
+ * @returns percentage text without its `%`, or null when there was no prompt input.
+ */
+export declare function formatCacheHitPercent(cacheReadTokens: number, promptTokens: number, decimalPlaces?: 0 | 1): string | null;
 /** Every billed token bucket of one priced model row. */
 export interface TokenBuckets {
     /** Cache-hit input tokens. */

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

@@ -3,28 +3,28 @@
 export declare const NS = "billing";
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
-    readonly 'trigger.balance': "剩余额度：{amount}";
-    readonly 'trigger.conversationSpend': "本轮对话花费：{amount}";
+    readonly 'trigger.balance': "剩余金额：{amount}";
     readonly 'label.amount': "API 剩余金额：{amount}";
     readonly 'label.sessionSpend': "本会话花费：{amount}";
-    readonly 'label.sessionSpend.today': "（{amount}）";
+    readonly 'label.sessionSpend.today': " {amount}";
     readonly 'label.todaySpend': "今日花费：{amount}";
     readonly 'label.todayTokens': "今日 Token：{count}";
+    readonly 'label.todayTokens.hit': " {percent}%";
     readonly 'unit.tokens': "{count} tok";
     readonly 'label.cost.input': "未缓存输入 {amount}";
     readonly 'label.cost.cacheRead': "缓存读取 {amount}";
     readonly 'label.cost.output': "输出 {amount}";
     readonly 'card.title': "花费金额";
-    readonly 'card.input': "未缓存输入";
-    readonly 'card.cacheRead': "缓存读取";
-    readonly 'card.output': "输出";
     readonly 'card.aria': "本轮对话花费：{amount}";
+    readonly 'label.bucket.input': "未缓存输入";
+    readonly 'label.bucket.cacheRead': "缓存读取";
+    readonly 'label.bucket.output': "输出";
     readonly 'stat.none': "暂无消耗记录";
     readonly 'stat.untitled': "未命名";
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
-    readonly 'info.hint': "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\n括号内为本会话今日花费。\nv{version}";
+    readonly 'info.hint': "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\n金额含本会话委派的子代理会话。\n紧跟的数字为本会话今日花费。\nv{version}";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
     readonly 'label.sessionRanking': "今日会话花费";

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

@@ -35,4 +35,34 @@ export interface SpendBuckets {
 export declare function spendBucketsOf(spend: DeepSeekTodaySpend): SpendBuckets;
 /** Whether a spend has any priced amount to show (a zero card stays hidden). */
 export declare function hasBilledSpend(spend: DeepSeekTodaySpend): boolean;
+/** One spend's three bucket TOKEN counts, in DSH's row order. */
+export interface TokenBucketCounts {
+    /** Uncached (cache-miss) input tokens, cache writes included. */
+    uncachedInput: number;
+    /** Cache-hit (cache-read) input tokens. */
+    cacheRead: number;
+    /** Output tokens, reasoning included. */
+    output: number;
+}
+/**
+ * Fold one spend's model rows into the three bucket TOKEN counts — the token
+ * side of {@link spendBucketsOf}, so a surface that shows both (the panel's
+ * today rows) reads one bucket's tokens and its cost from the same rows.
+ *
+ * No reconciliation is needed here: tokens are integers, so the three counts
+ * always add up to the total the token line shows.
+ * @param spend - the day's (or one session's) priced rows.
+ * @returns the three bucket token counts.
+ */
+export declare function tokenBucketsOf(spend: DeepSeekTodaySpend): TokenBucketCounts;
+/**
+ * The cache-hit share of one spend, in DSH's own percentage rule — the ratio of
+ * the cache-read bucket to every PROMPT-side bucket (uncached input with cache
+ * writes folded in, plus cache read), output excluded, exactly the split DSH's
+ * `billedInputTokens` makes. Rendered by {@link formatCacheHitPercent}, i.e. an
+ * integer percent that grows decimals only to keep a partial hit below 100.
+ * @param spend - the day's priced rows.
+ * @returns the percentage text without its `%`, or null when the spend billed no prompt input.
+ */
+export declare function cacheHitPercentOf(spend: DeepSeekTodaySpend): string | null;
 //# sourceMappingURL=spendBuckets.d.ts.map

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

@@ -0,0 +1,22 @@
+/**
+ * Additive merge of a conversation's two spend halves: the session's OWN billed
+ * spend (live, from the pushed `billingTodaySpend` projection or the
+ * `billing/getSessionSpend` fallback) and the delegated-subagent subtotal
+ * (`billing/getDelegatedSpend`). The panel shows one amount for the whole
+ * conversation, so the two must be summed before rendering — and the per-model
+ * rows must be summed the same way, or the breakdown would no longer add up to
+ * the amount above it.
+ *
+ * Pure addition only: no pricing, no timezone, no fork-boundary knowledge lives
+ * here (the host owns all of that), so this cannot drift from the host's own
+ * sums.
+ */
+import type { DeepSeekSessionSpend } from '@rayadesu/dsh-llm-billing/types';
+/**
+ * Sum one conversation's own spend and its delegated-subagent subtotal.
+ * @param own - the session's own billed spend.
+ * @param delegated - the delegated subtotal from the last `getDelegatedSpend` read.
+ * @returns the merged spend (own model order first, then newly seen models).
+ */
+export declare function sumSpends(own: DeepSeekSessionSpend, delegated: DeepSeekSessionSpend): DeepSeekSessionSpend;
+//# sourceMappingURL=spends.d.ts.map

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

@@ -6,9 +6,24 @@ export declare const TURN_SETTLE_DEBOUNCE_MS = 2000;
 /** The data surface the trigger and the panel render from. */
 export interface BillingData {
     balance: DeepSeekBalance | null;
+    /**
+     * The WHOLE conversation's billed spend: this session's own spend (live, from
+     * the pushed projection or the `getSessionSpend` fallback) plus the subagent
+     * sessions it delegated (the last `getDelegatedSpend` read), so the amount a
+     * user reads is the conversation's, not just its own log's.
+     */
     spend: DeepSeekSessionSpend | null;
     todaySpend: DeepSeekTodaySpend | null;
     sessionsSpend: DeepSeekTodaySessionsSpend | null;
+    /** Whether the current session is itself a delegated subagent child. */
+    isSubagent: boolean;
+    /**
+     * Whether the current session started on an EARLIER Beijing day — the only
+     * case in which the panel's parenthesized today share is meaningful.
+     * `false` until the delegated read settles (an unproven crossing stays
+     * hidden) and for every session created today.
+     */
+    crossedDay: boolean;
     /** Balance fetch failure while no value is present yet. */
     error: string | null;
     refreshing: boolean;
@@ -19,12 +34,14 @@ export interface BillingData {
 }
 /**
  * Start the badge's data lifecycle for one session. The spend follows the
- * conversation: the host-pushed `billingTodaySpend` projection drives the
- * session line live (zero Remote calls), with `getSessionSpend` as the
- * bootstrap/fallback when the projection key is absent; today's spend is
- * recomputed through `getTodaySpend` when a turn settles; the balance stays a
- * manual-refresh snapshot and is never refetched on its own.
+ * conversation: the host-pushed `billingTodaySpend` projection drives this
+ * session's own part live (zero Remote calls), with `getSessionSpend` as the
+ * bootstrap/fallback when the projection key is absent; the delegated-subagent
+ * subtotal comes from `getDelegatedSpend` on mount, on refresh, and when a turn
+ * settles; today's spend is recomputed through `getTodaySpend` on the same
+ * events; the balance stays a manual-refresh snapshot and is never refetched on
+ * its own.
  * @param props - the badge's injected face and session runtime share.
  */
-export declare function useBillingData({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, useProjection, }: Pick<BalanceBadgeProps, 'getBalance' | 'getCachedBalance' | 'getSessionSpend' | 'getTodaySpend' | 'getTodaySessionsSpend' | 'sessionId' | 'useSession' | 'useProjection'>): BillingData;
+export declare function useBillingData({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, getDelegatedSpend, sessionId, useSession, useProjection, }: Pick<BalanceBadgeProps, 'getBalance' | 'getCachedBalance' | 'getSessionSpend' | 'getTodaySpend' | 'getTodaySessionsSpend' | 'getDelegatedSpend' | 'sessionId' | 'useSession' | 'useProjection'>): BillingData;
 //# sourceMappingURL=useBillingData.d.ts.map

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.3.12",
+  "version": "0.3.13",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -47,28 +47,28 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.12",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
+    "@rayadesu/dsh-llm-billing": "^0.3.13",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.12",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
+    "@rayadesu/dsh-llm-billing": "^0.3.13",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "~18.3.1",
@@ -76,10 +76,29 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "use-sync-external-store": "^1.2.0",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
+    "zustand": "~4.4.7",
+    "immer": "^10.1.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@shikijs/langs": "^4.3.1",
+    "anser": "^2.3.5",
+    "clsx": "^2.0.0",
+    "diff": "^9.0.0",
+    "katex": "^0.16.47",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
+    "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
+    "micromark-util-symbol": "^2.0.1",
+    "shiki": "^4.3.1"
   },
   "files": [
     "lib/index.js",