@rayadesu/dsh-llm-billing 0.2.1 → 0.2.2

package/lib/invariant.js

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

package/lib/typert.host.js

@@ -1,7 +1,7 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getBalance_result$schema = z.object({
   'isAvailable': z.boolean(),
   'lines': z.array(z.object({
   'currency': z.string(),
@@ -10,8 +10,8 @@ const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = z.object({
   'toppedUp': z.string(),
 })),
 })
-const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema = z.object({
   'total': z.number(),
   'models': z.array(z.object({
   'model': z.string(),
@@ -27,7 +27,8 @@ const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = z.obj
   'outputCost': z.number(),
 })),
 })
-const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema = z.union([z.undefined(), z.literal(false), z.literal(true)])
+const _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema = z.object({
   'total': z.number(),
   'models': z.array(z.object({
   'model': z.string(),
@@ -45,13 +46,13 @@ const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = z.objec
 })
 
 export const TYPERT = {
-  package: '@deepseek-ai/dsh-llm-billing',
+  package: '@rayadesu/dsh-llm-billing',
   face: 'host',
   schemas: [
   ],
   invocations: [
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getBalance',
+      id: '@rayadesu/dsh-llm-billing#billing/getBalance',
       service: 'billing',
       namespace: 'billing',
       method: 'getBalance',
@@ -60,13 +61,13 @@ export const TYPERT = {
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@deepseek-ai/dsh-llm-billing/types#DeepSeekBalance',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekBalance',
+        schema: _rayadesu_dsh_llm_billing_billing_getBalance_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":139,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":143,"column":3},
     },
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getSessionSpend',
+      id: '@rayadesu/dsh-llm-billing#billing/getSessionSpend',
       service: 'billing',
       namespace: 'billing',
       method: 'getSessionSpend',
@@ -78,32 +79,43 @@ export const TYPERT = {
           source: 'json',
           codec: {
             mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema,
+            typeSymbol: '@rayadesu/dsh-llm-billing#billing/getSessionSpend:sessionId',
+            schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@deepseek-ai/dsh-llm-billing/types#DeepSeekSessionSpend',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":149,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":154,"column":3},
     },
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getTodaySpend',
+      id: '@rayadesu/dsh-llm-billing#billing/getTodaySpend',
       service: 'billing',
       namespace: 'billing',
       method: 'getTodaySpend',
       invocation: { kind: 'direct' },
       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: '@deepseek-ai/dsh-llm-billing/types#DeepSeekTodaySpend',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":159,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":167,"column":3},
     },
   ],
   model: {

package/lib/typert.remote-client.d.ts

@@ -3,19 +3,18 @@ import type {
   RemoteResult,
   TypertRemoteContribution,
 } from '@deepseek-ai/dsh-typert-protocol'
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@deepseek-ai/dsh-llm-billing/types'
-import type { SessionId } from '@deepseek-ai/dsh-session/types'
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types'
 
 declare module '@deepseek-ai/dsh-typert-protocol' {
   interface TypertRemoteNamespace$62696c6c696e67 {
     getBalance: () => Promise<RemoteResult<DeepSeekBalance>>
     getSessionSpend: (sessionId: SessionId) => Promise<RemoteResult<DeepSeekSessionSpend>>
-    getTodaySpend: () => Promise<RemoteResult<DeepSeekTodaySpend>>
+    getTodaySpend: (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySpend>>
   }
   interface TypertRemoteMap {
     'billing/getBalance': () => Promise<RemoteResult<DeepSeekBalance>>
     'billing/getSessionSpend': (sessionId: SessionId) => Promise<RemoteResult<DeepSeekSessionSpend>>
-    'billing/getTodaySpend': () => Promise<RemoteResult<DeepSeekTodaySpend>>
+    'billing/getTodaySpend': (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySpend>>
   }
   interface TypertRemoteNamespaceMap {
     'billing': TypertRemoteNamespace$62696c6c696e67

package/lib/typert.remote-client.js

@@ -1,7 +1,7 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getBalance_result$schema = z.object({
   'isAvailable': z.boolean(),
   'lines': z.array(z.object({
   'currency': z.string(),
@@ -10,8 +10,8 @@ const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = z.object({
   'toppedUp': z.string(),
 })),
 })
-const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = z.intersection(z.string(), z.unknown())
-const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema = z.object({
   'total': z.number(),
   'models': z.array(z.object({
   'model': z.string(),
@@ -27,7 +27,8 @@ const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = z.obj
   'outputCost': z.number(),
 })),
 })
-const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = z.object({
+const _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema = z.union([z.undefined(), z.literal(false), z.literal(true)])
+const _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema = z.object({
   'total': z.number(),
   'models': z.array(z.object({
   'model': z.string(),
@@ -45,10 +46,10 @@ const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = z.objec
 })
 
 export const TYPERT_REMOTE = {
-  package: '@deepseek-ai/dsh-llm-billing',
+  package: '@rayadesu/dsh-llm-billing',
   descriptors: [
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getBalance',
+      id: '@rayadesu/dsh-llm-billing#billing/getBalance',
       service: 'billing',
       namespace: 'billing',
       method: 'getBalance',
@@ -57,13 +58,13 @@ export const TYPERT_REMOTE = {
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@deepseek-ai/dsh-llm-billing/types#DeepSeekBalance',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekBalance',
+        schema: _rayadesu_dsh_llm_billing_billing_getBalance_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":139,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":143,"column":3},
     },
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getSessionSpend',
+      id: '@rayadesu/dsh-llm-billing#billing/getSessionSpend',
       service: 'billing',
       namespace: 'billing',
       method: 'getSessionSpend',
@@ -75,32 +76,43 @@ export const TYPERT_REMOTE = {
           source: 'json',
           codec: {
             mode: 'strict',
-            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
-            schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema,
+            typeSymbol: '@rayadesu/dsh-llm-billing#billing/getSessionSpend:sessionId',
+            schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema,
           },
         },
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@deepseek-ai/dsh-llm-billing/types#DeepSeekSessionSpend',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":149,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":154,"column":3},
     },
     {
-      id: '@deepseek-ai/dsh-llm-billing#billing/getTodaySpend',
+      id: '@rayadesu/dsh-llm-billing#billing/getTodaySpend',
       service: 'billing',
       namespace: 'billing',
       method: 'getTodaySpend',
       invocation: { kind: 'direct' },
       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: '@deepseek-ai/dsh-llm-billing/types#DeepSeekTodaySpend',
-        schema: _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema,
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm-billing/src/balance.ts","line":159,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":167,"column":3},
     },
   ],
 }

package/lib/types/balance.d.ts

@@ -4,7 +4,7 @@
  * takes an already-resolved endpoint and bearer token so the registering
  * plugin stays the one owner of credential policy; the gateway carries only a
  * `fetchBalance` thunk for the same reason.
- * @module @deepseek-ai/dsh-llm-billing/balance
+ * @module @rayadesu/dsh-llm-billing/balance
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session';
@@ -32,8 +32,12 @@ export interface DeepSeekBalanceGatewayOptions {
     fetchBalance: () => Promise<DeepSeekBalance>;
     /** Compute one session's billed spend through the plugin's resolved facts. */
     fetchSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
-    /** Compute today's billed spend across every session through the plugin's resolved facts. */
-    fetchTodaySpend: () => Promise<DeepSeekTodaySpend>;
+    /**
+     * Compute today's billed spend across every session through the plugin's
+     * resolved facts. `force` bypasses the host-side time window (the manual
+     * refresh path); a `force` miss still reuses revision-gated increments.
+     */
+    fetchTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
 }
 /**
  * Remote-only service exposing the DeepSeek account balance and session spend.
@@ -55,17 +59,21 @@ export declare class DeepSeekBalanceGateway extends TypertRemoteService {
      */
     getBalance(): Promise<DeepSeekBalance>;
     /**
-     * Read one session's billed spend, priced per event by its peak/off-peak hour.
+     * Read one session's billed spend, priced per event by its Beijing-time
+     * peak/off-peak hour and weekday (weekends are always off-peak).
      * @param sessionId - the session whose spend to compute.
      * @returns the session's total cost plus one row per priced model.
      */
     getSessionSpend(sessionId: SessionId): Promise<DeepSeekSessionSpend>;
     /**
      * Read today's billed spend across every session, priced per event by its
-     * Beijing-time calendar day and peak/off-peak hour.
+     * Beijing-time calendar day, hour, and weekday (weekends are always off-peak).
+     * @param force - bypass the host-side 60s cache (manual refresh); omitted
+     *   means a cached read. Remote parameters cannot carry default values, so
+     *   the thunk receives `undefined` for an omitted argument.
      * @returns today's total cost plus one row per priced model.
      */
-    getTodaySpend(): Promise<DeepSeekTodaySpend>;
+    getTodaySpend(force?: boolean): Promise<DeepSeekTodaySpend>;
 }
 export default DeepSeekBalanceGateway;
 //# sourceMappingURL=balance.d.ts.map

package/lib/types/balance.js

@@ -4,7 +4,7 @@
  * takes an already-resolved endpoint and bearer token so the registering
  * plugin stays the one owner of credential policy; the gateway carries only a
  * `fetchBalance` thunk for the same reason.
- * @module @deepseek-ai/dsh-llm-billing/balance
+ * @module @rayadesu/dsh-llm-billing/balance
  */
 var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
     var useValue = arguments.length > 2;
@@ -165,7 +165,8 @@ let DeepSeekBalanceGateway = (() => {
             return this.options.fetchBalance();
         }
         /**
-         * Read one session's billed spend, priced per event by its peak/off-peak hour.
+         * Read one session's billed spend, priced per event by its Beijing-time
+         * peak/off-peak hour and weekday (weekends are always off-peak).
          * @param sessionId - the session whose spend to compute.
          * @returns the session's total cost plus one row per priced model.
          */
@@ -174,11 +175,14 @@ let DeepSeekBalanceGateway = (() => {
         }
         /**
          * Read today's billed spend across every session, priced per event by its
-         * Beijing-time calendar day and peak/off-peak hour.
+         * Beijing-time calendar day, hour, and weekday (weekends are always off-peak).
+         * @param force - bypass the host-side 60s cache (manual refresh); omitted
+         *   means a cached read. Remote parameters cannot carry default values, so
+         *   the thunk receives `undefined` for an omitted argument.
          * @returns today's total cost plus one row per priced model.
          */
-        getTodaySpend() {
-            return this.options.fetchTodaySpend();
+        getTodaySpend(force) {
+            return this.options.fetchTodaySpend(force ?? false);
         }
     };
 })();

package/lib/types/billing.d.ts

@@ -3,7 +3,13 @@
  * pricing. Pure functions over session events and the pricing table, so the
  * Remote gateway stays transport-free and the whole spend is testable without
  * a key.
- * @module @deepseek-ai/dsh-llm-billing/billing
+ *
+ * The per-event pricing lives in {@link priceEvent}, the one shared fold
+ * primitive: the events-scan paths ({@link computeSessionSpend},
+ * {@link computeTodaySpend}) and the session-projection unit
+ * (`billingTodaySpend` in projection.ts) all fold the same contribution, so a
+ * pricing-table change cannot drift one path from the others.
+ * @module @rayadesu/dsh-llm-billing/billing
  */
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
 import type { DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts';
@@ -32,7 +38,7 @@ export interface BillingConfigModel {
     /** Off-peak price. */
     offPeak: DeepSeekTokenPrice;
 }
-/** One peak-hour window on a 24h Beijing-time clock. */
+/** One peak-hour window on a 24h Beijing-time clock, applied weekdays only. */
 export interface PeakHourWindow {
     /** Inclusive start hour, `0`–`23`. */
     start: number;
@@ -41,12 +47,19 @@ export interface PeakHourWindow {
 }
 /** Optional billing configuration; omission uses the published defaults. */
 export interface BillingConfig {
-    /** Peak-hour windows in Beijing time. */
+    /**
+     * Peak-hour windows in Beijing time, applied on weekdays (Monday–Friday)
+     * only; weekends (Saturday and Sunday) are always off-peak.
+     */
     peakHours?: PeakHourWindow[];
-    /** Per-model pricing rows; omission uses the V4 Flash and V4 Pro defaults. */
+    /** Per-model pricing rows; omission uses the V4 Flash, V4 Pro, and V4 Flash Vision defaults. */
     models?: BillingConfigModel[];
 }
-/** Published peak-hour windows (Beijing time): 09:00–12:00 and 14:00–18:00. */
+/**
+ * Published peak-hour windows (Beijing time): 09:00–12:00 and 14:00–18:00,
+ * applied on weekdays (Monday–Friday) only — weekends are always off-peak
+ * (effective 2026-08-23).
+ */
 export declare const DEFAULT_PEAK_HOURS: {
     start: number;
     end: number;
@@ -71,13 +84,81 @@ export interface ResolvedBilling {
  * @returns the resolved table and peak-hour windows.
  */
 export declare function resolveBilling(config: BillingConfig | undefined): ResolvedBilling;
+/** The Beijing (Asia/Shanghai, UTC+8, no DST) calendar-day key of a timestamp. */
+export declare function beijingDayKey(now: Date): string;
 /**
- * Whether a timestamp falls inside any peak-hour window (Beijing time).
+ * Whether a timestamp falls inside any peak-hour window (Beijing time,
+ * weekdays Monday–Friday only). Weekends (Saturday and Sunday) are always
+ * off-peak, matching the published peak-hours rule.
  * @param billing - resolved pricing with peak-hour windows.
  * @param now - the moment to classify.
- * @returns true during peak hours.
+ * @returns true during a weekday peak hour.
  */
 export declare function isPeak(billing: ResolvedBilling, now: Date): boolean;
+/**
+ * One priced billed event's contribution: the model row plus the Beijing
+ * calendar day its timestamp falls on. `undefined` when the event carries no
+ * priced usage (not an `assistant/message`, no usage report, or a model
+ * without a pricing row).
+ */
+export interface BillingEventContribution {
+    /** Beijing-time calendar-day key of the event's timestamp. */
+    dayKey: string;
+    /** Wire model id, e.g. `deepseek-v4-flash`. */
+    model: string;
+    /** Selector label for the model. */
+    displayName: string;
+    /** Billed cost in CNY (peak plus off-peak portions). */
+    cost: number;
+    /** Cost portion billed at peak rates. */
+    peakCost: number;
+    /** Cost portion billed at off-peak rates. */
+    offPeakCost: number;
+    /** Cache-hit input tokens billed at the hit rate. */
+    cacheHitInputTokens: number;
+    /** Cache-miss input tokens (uncached input plus cache writes), billed at the miss rate. */
+    cacheMissInputTokens: number;
+    /** Output tokens (reasoning included), billed at the output rate. */
+    outputTokens: number;
+    /** Billed cost of cache-hit input tokens in CNY. */
+    cacheHitInputCost: number;
+    /** Billed cost of cache-miss input tokens (uncached input plus cache writes) in CNY. */
+    cacheMissInputCost: number;
+    /** Billed cost of output tokens (reasoning included) in CNY. */
+    outputCost: number;
+}
+/**
+ * Price one event at the official per-model rates, applying the peak/off-peak
+ * table by its Beijing-time hour and weekday (peak windows apply Monday–Friday
+ * only; weekends are off-peak). Each `assistant/message` event with usage
+ * contributes cache-hit input, cache-miss input (uncached input plus cache
+ * writes), and output (reasoning included) tokens at the rate of its own
+ * timestamp; a model with usage but no pricing row contributes nothing (the
+ * published table prices only the two V4 rows).
+ * @param event - the event to price.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param names - model id → display label.
+ * @returns the priced contribution, or `undefined` when the event has no priced usage.
+ */
+export declare function priceEvent(event: SessionEvent, billing: ResolvedBilling, names: ReadonlyMap<string, string>): BillingEventContribution | undefined;
+/** A spend with no priced usage. */
+export declare function emptyTodaySpend(): DeepSeekTodaySpend;
+/**
+ * Merge one priced event's contribution into an accumulator spend (pure:
+ * returns a new spend, never mutates its input).
+ * @param spend - the accumulator (per session and day, or across sessions).
+ * @param priced - the priced contribution to add.
+ * @returns the merged spend.
+ */
+export declare function addEventContribution(spend: DeepSeekTodaySpend, priced: BillingEventContribution): DeepSeekTodaySpend;
+/**
+ * Sum two spends (per session and day, or across sessions) into one (pure:
+ * returns a new spend, never mutates its inputs).
+ * @param target - the accumulator spend.
+ * @param source - the spend to add.
+ * @returns the summed spend.
+ */
+export declare function mergeTodaySpend(target: DeepSeekTodaySpend, source: DeepSeekTodaySpend): DeepSeekTodaySpend;
 /**
  * Price one session's complete event log at the official per-model rates.
  * @param events - one session's complete event log.