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

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

@@ -0,0 +1,55 @@
+/**
+ * LiveCostBar: the session-scope cost ticker mounted on the composer's dock,
+ * showing the current session's accumulated spend and the latest turn's cost.
+ *
+ * It rides `conversation.composer.dock` (the stats-line family seat under the
+ * composer card, same posture as ui-conversation's own StatsLine), so it stays
+ * visible while working without opening the full dashboard. Data comes from the
+ * same `/api/billing/usage-stats` endpoint the dashboard polls; the bar reads
+ * the current session id off the framework snapshot (`useSession` parent of
+ * `sessionId`) and matches `bySession` (session total) and `byTurn` (latest
+ * turn cost). Rendering is a pure function of the snapshot, never a side effect.
+ */
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ConversationSnapshot } from '@deepseek-ai/dsh-client-runtime/client';
+/** The usage-stats shape the composer bar needs (a thin slice, not the whole doc). */
+export interface LiveStats {
+    bySession?: readonly {
+        id: string;
+        cost: number;
+    }[];
+    byTurn?: readonly {
+        sessionId: string;
+        turn: number;
+        cost: number;
+    }[];
+}
+/**
+ * 当前会话累计费用：bySession 里会话 id 匹配的那行；缺省为 0。
+ * 导出供测试：纯函数。
+ * @param stats - 薄统计切片。
+ * @param sessionId - 当前会话 id。
+ * @returns 该会话累计费用（人民币元）。
+ */
+export declare function sessionCostOf(stats: LiveStats | null, sessionId: string | undefined): number;
+/**
+ * 当前轮费用：byTurn 里该会话最新一轮的 cost；缺省为 0。
+ * byTurn 服务端按起始时间倒序下发，但求 max(turn) 更稳健（不依赖顺序）。
+ * 导出供测试：纯函数。
+ * @param stats - 薄统计切片。
+ * @param sessionId - 当前会话 id。
+ * @returns 最新一轮费用（人民币元）。
+ */
+export declare function turnCostOf(stats: LiveStats | null, sessionId: string | undefined): number;
+/** Props: the session-scope snapshot selector the framework injects. */
+export interface LiveCostBarProps {
+    useSession: SnapshotSelectorHook<ConversationSnapshot>;
+    /** The owning dock's locale seat (bound to the billing NS). */
+    t: (key: 'billing.liveTurn' | 'billing.liveSession') => string;
+}
+/**
+ * Render the live cost ticker for the current session.
+ * @param props - framework session snapshot hook and locale.
+ */
+export declare function LiveCostBar({ useSession, t }: LiveCostBarProps): React.ReactNode;
+//# sourceMappingURL=live-cost.d.ts.map

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

@@ -1,5 +1,5 @@
 /** Locale dictionaries for the usage billing surface. */
-export type UsageBillingKey = 'billing.title' | 'billing.subtitle' | 'billing.cost' | 'billing.todayCost' | 'billing.monthCost' | 'billing.yearCost' | 'billing.totalCost' | 'billing.calls' | 'billing.cacheHitRate' | 'billing.tokens' | 'billing.inputTokens' | 'billing.outputTokens' | 'billing.avgCost' | 'billing.trend' | 'billing.trend7d' | 'billing.trend30d' | 'billing.trendEmpty' | 'billing.budget' | 'billing.sessions' | 'billing.project' | 'billing.lastActive' | 'billing.sessionOverflow' | 'billing.budgetOverBody' | 'billing.models' | 'billing.estimated' | 'billing.actual' | 'billing.pricing' | 'billing.showPricing' | 'billing.hidePricing' | 'billing.pricePerM' | 'billing.input' | 'billing.output' | 'billing.cacheHit' | 'billing.peak' | 'billing.offPeak' | 'billing.flat' | 'billing.peakHours' | 'billing.band' | 'billing.openDashboard' | 'billing.close' | 'billing.lastUpdated' | 'billing.noData' | 'billing.todayRate' | 'billing.rateLive' | 'billing.rateBuiltin' | 'billing.balance' | 'billing.balanceUnconfigured' | 'billing.balanceUnauthorized' | 'billing.balanceUnreachable' | 'billing.uncatalogued' | 'billing.balanceDays' | 'billing.balanceLowBody';
+export type UsageBillingKey = 'billing.title' | 'billing.subtitle' | 'billing.cost' | 'billing.todayCost' | 'billing.monthCost' | 'billing.yearCost' | 'billing.monthProjected' | 'billing.liveTurn' | 'billing.liveSession' | 'billing.totalCost' | 'billing.calls' | 'billing.cacheHitRate' | 'billing.tokens' | 'billing.inputTokens' | 'billing.outputTokens' | 'billing.avgCost' | 'billing.trend' | 'billing.trend7d' | 'billing.trend30d' | 'billing.trendEmpty' | 'billing.budget' | 'billing.sessions' | 'billing.project' | 'billing.lastActive' | 'billing.sessionOverflow' | 'billing.budgetTierBody' | 'billing.models' | 'billing.providerBilling' | 'billing.estimated' | 'billing.actual' | 'billing.pricing' | 'billing.showPricing' | 'billing.hidePricing' | 'billing.pricePerM' | 'billing.input' | 'billing.output' | 'billing.cacheHit' | 'billing.peak' | 'billing.offPeak' | 'billing.flat' | 'billing.peakHours' | 'billing.band' | 'billing.openDashboard' | 'billing.close' | 'billing.lastUpdated' | 'billing.noData' | 'billing.todayRate' | 'billing.rateLive' | 'billing.rateBuiltin' | 'billing.balance' | 'billing.balanceUnconfigured' | 'billing.balanceUnauthorized' | 'billing.balanceUnreachable' | 'billing.uncatalogued' | 'billing.estimatedPricing' | 'billing.balanceDays' | 'billing.balanceLowBody' | 'billing.subscriptions' | 'billing.subscriptionNotConfigured' | 'billing.subscriptionUnauthorized' | 'billing.subscriptionUnavailable' | 'billing.subscriptionInvalid' | 'billing.subscriptionRateLimited' | 'billing.subscriptionSession' | 'billing.subscriptionWeekly' | 'billing.subscriptionMonthly' | 'billing.subscriptionBilling' | 'billing.subscriptionRemaining' | 'billing.subscriptionReset' | 'billing.subscriptionNoApi' | 'billing.heatmapLess' | 'billing.heatmapMore' | 'billing.currency' | 'billing.currencyCny' | 'billing.currencyUsd' | 'billing.heatmap' | 'billing.rounds' | 'billing.anomaly' | 'billing.workspaces' | 'billing.plan' | 'billing.remaining' | 'billing.unknownModel' | 'billing.model' | 'billing.currentRound' | 'billing.costAbbr' | 'billing.tabOverview' | 'billing.tabTrends' | 'billing.tabProviders' | 'billing.tabDetails' | 'billing.tabPricing' | 'billing.export' | 'billing.exportCsvDay' | 'billing.exportCsvSession' | 'billing.exportJson' | 'billing.peakShare' | 'billing.peakShareHint' | 'billing.weekCost' | 'billing.roleCost' | 'billing.roleUser' | 'billing.roleAssistant' | 'billing.roleTool' | 'billing.roleHint';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

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

@@ -95,6 +95,11 @@ export interface ModelEntry {
     price: ModelPrice;
     /** Peak-hour window label for time-of-day priced models. */
     peakHours?: string;
+    /**
+     * 单价为估算价：厂商未公布按量官方单价（公测 / 套餐制），表内价格为估算，
+     * 展示时标注以免误当正式定价；正式定价公布后移除。
+     */
+    estimated?: boolean;
 }
 /**
  * Built-in catalog of current mainstream models as of 2026-08-16, priced from

package/lib/types/client/round-chart.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RoundCostChart: dependency-free per-turn cost bars with spike markers.
+ *
+ * One bar per turn (most recent N, newest last), height scaled to the window
+ * maximum. Turns flagged by {@link flagAnomalies} get a warning outline and a
+ * corner marker; hover shows the turn's model, cost, and window time. Styling
+ * lives in the billing CSS module (`.rounds*`).
+ */
+import type { AnomalyFlag } from './anomaly.ts';
+import { type CostCurrency } from './pricing.ts';
+/** 每轮费用图的一行（TurnUsageRow 的展示子集）。 */
+export interface RoundChartRow {
+    sessionId: string;
+    turn: number;
+    model: string;
+    cost: number;
+    input: number;
+    output: number;
+    cacheHit: number;
+    cacheMiss: number;
+    startedAt: number;
+    endedAt?: number;
+}
+/**
+ * Render the per-turn cost bars.
+ * @param props.rounds - turns, most recent last (ascending startedAt); oldest beyond the limit are dropped.
+ * @param props.flags - spike flags matched by sessionId+turn.
+ * @param props.currency - display currency for the amount labels.
+ * @param props.t - locale function for the model label.
+ */
+export declare function RoundCostChart({ rounds, flags, currency, t }: {
+    rounds: readonly RoundChartRow[];
+    flags: readonly AnomalyFlag[];
+    currency: CostCurrency;
+    t: (key: 'billing.model' | 'billing.costAbbr') => string;
+}): React.ReactNode;
+//# sourceMappingURL=round-chart.d.ts.map

package/lib/types/index.d.ts

@@ -12,7 +12,8 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { CredentialProvider } from '@deepseek-ai/dsh-credentials';
 import type { SettingsProvider } from '@deepseek-ai/dsh-settings';
-import { type IdentifiedSubscriptionPlan, type SubscriptionKeys, type SubscriptionPlanConfig } from './subscriptions.ts';
+import type { SubscriptionPlanConfig } from './pricing-shared.ts';
+import { type IdentifiedSubscriptionPlan, type SubscriptionKeys } from './subscriptions.ts';
 /** Plugin configuration. */
 export interface UsageBillingConfig {
     /** Absolute path to a `.dsh-usage-stats.json` fallback file. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -48,6 +48,7 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/dsh-api-remotes": "*",
+    "@deepseek-ai/dsh-atomic-write": "*",
     "@deepseek-ai/dsh-client-connection": "*",
     "@deepseek-ai/dsh-host-webserver": "*",
     "@deepseek-ai/dsh-client-locale": "*",
@@ -62,6 +63,7 @@
     "@deepseek-ai/dsh-session": "*",
     "@deepseek-ai/dsh-session-persistence": "*",
     "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/dsh-tools": "*",
     "@deepseek-ai/schemastery": "*",
     "@deepseek-ai/cordis": "*",
     "react": "^18.2.0"