@rayadesu/dsh-billing 0.1.0-rc.8

package/packages/llm-billing/node_modules/.bin/cordis

@@ -0,0 +1,43 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+basedir_win="$basedir"
+exe=""
+msys=""
+
+case `uname -a` in
+  *CYGWIN*|*MINGW*|*MSYS*)
+    if command -v cygpath > /dev/null 2>&1; then
+      basedir_win=`cygpath -w "$basedir"`
+    fi
+    exe=".exe"
+    msys="true"
+  ;;
+  *WSL2*)
+    if command -v wslpath > /dev/null 2>&1; then
+      basedir_win="$(wslpath -w "$basedir" 2> /dev/null)"
+      if [ $? -ne 0 ] || [ -z "$basedir_win" ]; then
+        basedir_win="$basedir"
+      else
+        exe=".exe"
+      fi
+    fi
+  ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules/@deepseek-ai/cordis/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules/@deepseek-ai/cordis/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -n "$exe" ] && [ -x "$basedir/node.exe" ]; then
+  exec "$basedir/node.exe"  "$basedir_win/../@deepseek-ai/cordis/bin.js" "$@"
+elif [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../@deepseek-ai/cordis/bin.js" "$@"
+elif command -v node >/dev/null 2>&1; then
+  exec node  "$basedir/../@deepseek-ai/cordis/bin.js" "$@"
+elif [ -n "$exe" ] && command -v node.exe >/dev/null 2>&1; then
+  exec node.exe  "$basedir_win/../@deepseek-ai/cordis/bin.js" "$@"
+else
+  exec node  "$basedir/../@deepseek-ai/cordis/bin.js" "$@"
+fi
+# cmd-shim-target=D:/code/DeepSeek-Harness-chat-billing/packages/llm-billing/node_modules/@deepseek-ai/cordis/bin.js

package/packages/llm-billing/node_modules/.bin/cordis.CMD

@@ -0,0 +1,12 @@
+@SETLOCAL
+@IF NOT DEFINED NODE_PATH (
+  @SET "NODE_PATH=D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules\@deepseek-ai\cordis\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\node_modules"
+) ELSE (
+  @SET "NODE_PATH=D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules\@deepseek-ai\cordis\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\node_modules;%NODE_PATH%"
+)
+@IF EXIST "%~dp0\node.exe" (
+  "%~dp0\node.exe"  "%~dp0\..\@deepseek-ai\cordis\bin.js" %*
+) ELSE (
+  @SET PATHEXT=%PATHEXT:;.JS;=;%
+  node  "%~dp0\..\@deepseek-ai\cordis\bin.js" %*
+)

package/packages/llm-billing/node_modules/.bin/cordis.ps1

@@ -0,0 +1,41 @@
+#!/usr/bin/env pwsh
+$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
+
+$exe=""
+$pathsep=":"
+$env_node_path=$env:NODE_PATH
+$new_node_path="D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules\@deepseek-ai\cordis\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e\node_modules;D:\code\DeepSeek-Harness-chat-billing\node_modules\.pnpm\node_modules"
+if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
+  # Fix case when both the Windows and Linux builds of Node
+  # are installed in the same directory
+  $exe=".exe"
+  $pathsep=";"
+} else {
+  $new_node_path="/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules/@deepseek-ai/cordis/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/@deepseek-ai+cordis@4.0.1_@_d53e407b0055a51d18c4da8d739fec0e/node_modules:/mnt/d/code/DeepSeek-Harness-chat-billing/node_modules/.pnpm/node_modules"
+}
+if ([string]::IsNullOrEmpty($env_node_path)) {
+  $env:NODE_PATH=$new_node_path
+} else {
+  $env:NODE_PATH="$new_node_path$pathsep$env_node_path"
+}
+
+$ret=0
+if (Test-Path "$basedir/node$exe") {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "$basedir/node$exe"  "$basedir/../@deepseek-ai/cordis/bin.js" $args
+  } else {
+    & "$basedir/node$exe"  "$basedir/../@deepseek-ai/cordis/bin.js" $args
+  }
+  $ret=$LASTEXITCODE
+} else {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "node$exe"  "$basedir/../@deepseek-ai/cordis/bin.js" $args
+  } else {
+    & "node$exe"  "$basedir/../@deepseek-ai/cordis/bin.js" $args
+  }
+  $ret=$LASTEXITCODE
+}
+$env:NODE_PATH=$env_node_path
+exit $ret

package/packages/llm-billing/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@rayadesu/dsh-llm-billing",
+  "description": "Standalone DeepSeek account-balance and session-spend provider exposed through the billing Remote",
+  "version": "0.1.0-rc.8",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rayadesune/DeepSeek-Harness-chat-billing.git",
+    "directory": "packages/llm-billing"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1"
+  }
+}

package/packages/llm-billing/src/balance.ts

@@ -0,0 +1,164 @@
+/**
+ * DeepSeek account-balance capability: the `GET /user/balance` transport and
+ * the Remote gateway that exposes one snapshot to trusted clients. The fetch
+ * 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 @rayadesu/dsh-llm-billing/balance
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import { LlmError } from '@deepseek-ai/dsh-llm'
+import type { SessionId } from '@deepseek-ai/dsh-session'
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
+// Typert-generated ./typert and ./remote artifacts import Zod at runtime.
+import type {} from 'zod'
+import type { DeepSeekBalance, DeepSeekBalanceLine, DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts'
+
+/** Map a balance HTTP status to a stable LlmError code. */
+function httpErrorCode(status: number): string {
+  if (status === 401 || status === 403) return 'AUTH'
+  if (status === 429) return 'RATE_LIMIT'
+  if (status >= 500) return 'SERVER'
+  return `HTTP_${status}`
+}
+
+/**
+ * Parse and validate the DeepSeek balance response at the wire boundary.
+ * @param body - decoded JSON response body.
+ * @returns the validated, detached balance snapshot.
+ * @throws {@link LlmError} with code `TRANSPORT` when the body is malformed.
+ */
+export function parseDeepSeekBalance(body: unknown): DeepSeekBalance {
+  if (typeof body !== 'object' || body === null || Array.isArray(body)) {
+    throw new LlmError('DeepSeek balance response was not a JSON object', 'TRANSPORT')
+  }
+  const response = body as Record<string, unknown>
+  const isAvailable = response['is_available']
+  const infos = response['balance_infos']
+  if (typeof isAvailable !== 'boolean' || !Array.isArray(infos)) {
+    throw new LlmError('DeepSeek balance response is missing is_available or balance_infos', 'TRANSPORT')
+  }
+  const lines: DeepSeekBalanceLine[] = infos.map((info, index) => {
+    if (typeof info !== 'object' || info === null || Array.isArray(info)) {
+      throw new LlmError(`DeepSeek balance line ${index} is malformed`, 'TRANSPORT')
+    }
+    const line = info as Record<string, unknown>
+    const currency = line['currency']
+    const total = line['total_balance']
+    const granted = line['granted_balance']
+    const toppedUp = line['topped_up_balance']
+    if (typeof currency !== 'string' || currency.length === 0
+      || typeof total !== 'string'
+      || typeof granted !== 'string'
+      || typeof toppedUp !== 'string') {
+      throw new LlmError(`DeepSeek balance line ${index} has missing or invalid fields`, 'TRANSPORT')
+    }
+    return { currency, total, granted, toppedUp }
+  })
+  return { isAvailable, lines }
+}
+
+/**
+ * Fetch one account-balance snapshot from `{baseURL}/user/balance`.
+ * @param baseURL - resolved endpoint base; `/user/balance` is appended.
+ * @param apiKey - resolved bearer token for this endpoint.
+ * @param signal - optional cancellation.
+ * @returns the validated balance snapshot.
+ * @throws {@link LlmError} for transport, HTTP, or malformed-response failures.
+ */
+export async function fetchDeepSeekBalance(
+  baseURL: string,
+  apiKey: string,
+  signal?: AbortSignal,
+): Promise<DeepSeekBalance> {
+  let response: Response
+  try {
+    response = await fetch(`${baseURL}/user/balance`, {
+      method: 'GET',
+      headers: {
+        'authorization': `Bearer ${apiKey}`,
+        'accept': 'application/json',
+      },
+      ...(signal === undefined ? {} : { signal }),
+    })
+  } catch (error: unknown) {
+    if (signal?.aborted) throw new LlmError('DeepSeek balance request aborted by caller', 'ABORTED', { cause: error })
+    throw new LlmError(`DeepSeek balance request to ${baseURL} failed`, 'TRANSPORT', { cause: error })
+  }
+  if (!response.ok) {
+    throw new LlmError(
+      `DeepSeek balance request failed (HTTP ${response.status})`,
+      httpErrorCode(response.status),
+      { status: response.status },
+    )
+  }
+  let body: unknown
+  try {
+    body = await response.json()
+  } catch (error: unknown) {
+    throw new LlmError('DeepSeek balance response was not valid JSON', 'TRANSPORT', { cause: error })
+  }
+  return parseDeepSeekBalance(body)
+}
+
+/** Thunks the plugin binds to its own resolution and history access. */
+export interface DeepSeekBalanceGatewayOptions {
+  /** Fetch one balance snapshot through the plugin's resolved facts. */
+  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>
+}
+
+/**
+ * Remote-only service exposing the DeepSeek account balance and session spend.
+ * The plugin that owns connection, credential, and session-history resolution
+ * constructs it with the matching thunks, so the Remote boundary never sees an
+ * endpoint, key, or the session store.
+ */
+export class DeepSeekBalanceGateway extends TypertRemoteService {
+  private readonly options: DeepSeekBalanceGatewayOptions
+
+  /**
+   * Register the balance Remote under the `billing` namespace.
+   * @param ctx - owning plugin context.
+   * @param options - balance and spend thunks bound to the plugin's facts.
+   */
+  constructor(ctx: Context, options: DeepSeekBalanceGatewayOptions) {
+    super(ctx, 'billing')
+    this.options = options
+  }
+
+  /**
+   * Read the current DeepSeek account balance.
+   * @returns the validated balance snapshot.
+   */
+  @Remote('getBalance')
+  getBalance(): Promise<DeepSeekBalance> {
+    return this.options.fetchBalance()
+  }
+
+  /**
+   * Read one session's billed spend, priced per event by its peak/off-peak hour.
+   * @param sessionId - the session whose spend to compute.
+   * @returns the session's total cost plus one row per priced model.
+   */
+  @Remote('getSessionSpend')
+  getSessionSpend(sessionId: SessionId): Promise<DeepSeekSessionSpend> {
+    return this.options.fetchSessionSpend(sessionId)
+  }
+
+  /**
+   * Read today's billed spend across every session, priced per event by its
+   * Beijing-time calendar day and peak/off-peak hour.
+   * @returns today's total cost plus one row per priced model.
+   */
+  @Remote('getTodaySpend')
+  getTodaySpend(): Promise<DeepSeekTodaySpend> {
+    return this.options.fetchTodaySpend()
+  }
+}
+
+export default DeepSeekBalanceGateway

package/packages/llm-billing/src/billing.ts

@@ -0,0 +1,251 @@
+/**
+ * DeepSeek billing: the peak/off-peak pricing table and the per-session spend
+ * 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 @rayadesu/dsh-llm-billing/billing
+ */
+
+import type { SessionEvent } from '@deepseek-ai/dsh-session'
+import type { DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts'
+
+/** One token price point, in CNY per 1M tokens. */
+export interface DeepSeekTokenPrice {
+  /** 1M input cache-hit tokens. */
+  cacheHitInput: number
+  /** 1M input cache-miss tokens (cache writes bill at this rate too). */
+  cacheMissInput: number
+  /** 1M output tokens. */
+  output: number
+}
+
+/** Peak and off-peak price pair for one model. */
+export interface DeepSeekModelPricing {
+  /** Price during peak hours. */
+  peak: DeepSeekTokenPrice
+  /** Price during off-peak hours. */
+  offPeak: DeepSeekTokenPrice
+}
+
+/** One model's pricing-table row in configuration form. */
+export interface BillingConfigModel {
+  /** Wire model id. */
+  model: string
+  /** Peak-hour price. */
+  peak: DeepSeekTokenPrice
+  /** Off-peak price. */
+  offPeak: DeepSeekTokenPrice
+}
+
+/** One peak-hour window on a 24h Beijing-time clock. */
+export interface PeakHourWindow {
+  /** Inclusive start hour, `0`–`23`. */
+  start: number
+  /** Exclusive end hour, `1`–`24`. */
+  end: number
+}
+
+/** Optional billing configuration; omission uses the published defaults. */
+export interface BillingConfig {
+  /** Peak-hour windows in Beijing time. */
+  peakHours?: PeakHourWindow[]
+  /** 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. */
+export const DEFAULT_PEAK_HOURS: { start: number; end: number }[] = [
+  { start: 9, end: 12 },
+  { start: 14, end: 18 },
+]
+
+/** Official peak/off-peak rates (CNY per 1M tokens), effective 2026-08-17. */
+export const DEFAULT_MODEL_PRICING: BillingConfigModel[] = [
+  {
+    model: 'deepseek-v4-flash',
+    peak: { cacheHitInput: 0.10, cacheMissInput: 3.0, output: 9.0 },
+    offPeak: { cacheHitInput: 0.05, cacheMissInput: 1.5, output: 4.5 },
+  },
+  {
+    model: 'deepseek-v4-pro',
+    peak: { cacheHitInput: 0.30, cacheMissInput: 9.0, output: 27.0 },
+    offPeak: { cacheHitInput: 0.15, cacheMissInput: 4.5, output: 13.5 },
+  },
+  // deepseek-v4-flash-vision-exp bills at the same rates as deepseek-v4-flash;
+  // images are converted to tokens at the same per-token price.
+  {
+    model: 'deepseek-v4-flash-vision-exp',
+    peak: { cacheHitInput: 0.10, cacheMissInput: 3.0, output: 9.0 },
+    offPeak: { cacheHitInput: 0.05, cacheMissInput: 1.5, output: 4.5 },
+  },
+]
+
+/** Resolved billing configuration: a pricing table plus peak-hour windows. */
+export interface ResolvedBilling {
+  peakHours: readonly { start: number; end: number }[]
+  models: ReadonlyMap<string, DeepSeekModelPricing>
+}
+
+/**
+ * Resolve optional configuration to a pricing table, defaulting omitted or
+ * empty rows to the published rates. Schemastery materializes an absent
+ * `z.array` as `[]` rather than `undefined`, so emptiness — not just absence —
+ * selects the defaults. Explicit non-empty rows override the same model; a
+ * supplied non-empty `models` list is authoritative.
+ * @param config - optional raw billing configuration.
+ * @returns the resolved table and peak-hour windows.
+ */
+export function resolveBilling(config: BillingConfig | undefined): ResolvedBilling {
+  const peakHours = config?.peakHours !== undefined && config.peakHours.length > 0
+    ? config.peakHours
+    : DEFAULT_PEAK_HOURS
+  const rows = config?.models !== undefined && config.models.length > 0
+    ? config.models
+    : DEFAULT_MODEL_PRICING
+  const models = new Map<string, DeepSeekModelPricing>()
+  for (const row of rows) models.set(row.model, { peak: row.peak, offPeak: row.offPeak })
+  return { peakHours, models }
+}
+
+/** The Beijing (Asia/Shanghai, UTC+8, no DST) hour of a timestamp. */
+function beijingHour(now: Date): number {
+  return new Date(now.getTime() + 8 * 3_600_000).getUTCHours()
+}
+
+/** The Beijing (Asia/Shanghai, UTC+8, no DST) calendar-day key of a timestamp. */
+function beijingDayKey(now: Date): string {
+  return new Date(now.getTime() + 8 * 3_600_000).toISOString().slice(0, 10)
+}
+
+/**
+ * Whether a timestamp falls inside any peak-hour window (Beijing time).
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param now - the moment to classify.
+ * @returns true during peak hours.
+ */
+export function isPeak(billing: ResolvedBilling, now: Date): boolean {
+  const hour = beijingHour(now)
+  return billing.peakHours.some(({ start, end }) => hour >= start && hour < end)
+}
+
+/** Running per-model spend accumulation for {@link computeSessionSpend}. */
+interface SessionSpendRow {
+  cacheHitInputTokens: number
+  cacheMissInputTokens: number
+  outputTokens: number
+  cost: number
+  peakCost: number
+  offPeakCost: number
+  cacheHitInputCost: number
+  cacheMissInputCost: number
+  outputCost: number
+}
+
+/**
+ * Price a set of billed events at the official per-model rates, applying the
+ * peak/off-peak table per event by its Beijing-time hour. 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, with the three component costs
+ * carried separately; a model with usage but no pricing row is omitted (the
+ * published table prices only the two V4 rows).
+ * @param events - the events to price.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param catalog - model display rows, in presentation order.
+ * @returns the total cost plus one row per priced model.
+ */
+function priceEvents(
+  events: readonly SessionEvent[],
+  billing: ResolvedBilling,
+  catalog: readonly { id: string; name: string }[],
+): DeepSeekSessionSpend {
+  const names = new Map(catalog.map(model => [model.id, model.name]))
+  const rows = new Map<string, SessionSpendRow>()
+  for (const event of events) {
+    if (event.type !== 'assistant/message') continue
+    const reported = event.data.usage
+    if (reported === undefined) continue
+    const model = event.data.message.source.model
+    const pricing = billing.models.get(model)
+    if (pricing === undefined) continue
+    const peak = isPeak(billing, new Date(event.time))
+    const price = peak ? pricing.peak : pricing.offPeak
+    const hit = reported.cacheReadTokens ?? 0
+    const miss = reported.inputTokens + (reported.cacheWriteTokens ?? 0)
+    const output = reported.outputTokens
+    const hitCost = (hit * price.cacheHitInput) / 1_000_000
+    const missCost = (miss * price.cacheMissInput) / 1_000_000
+    const outputCost = (output * price.output) / 1_000_000
+    const cost = hitCost + missCost + outputCost
+    let row = rows.get(model)
+    if (row === undefined) {
+      row = {
+        cacheHitInputTokens: 0, cacheMissInputTokens: 0, outputTokens: 0,
+        cost: 0, peakCost: 0, offPeakCost: 0,
+        cacheHitInputCost: 0, cacheMissInputCost: 0, outputCost: 0,
+      }
+      rows.set(model, row)
+    }
+    row.cacheHitInputTokens += hit
+    row.cacheMissInputTokens += miss
+    row.outputTokens += output
+    row.cost += cost
+    row.cacheHitInputCost += hitCost
+    row.cacheMissInputCost += missCost
+    row.outputCost += outputCost
+    if (peak) row.peakCost += cost
+    else row.offPeakCost += cost
+  }
+  const models = [...rows.entries()].map(([model, row]) => ({
+    model,
+    displayName: names.get(model) ?? model,
+    cost: row.cost,
+    peakCost: row.peakCost,
+    offPeakCost: row.offPeakCost,
+    cacheHitInputTokens: row.cacheHitInputTokens,
+    cacheMissInputTokens: row.cacheMissInputTokens,
+    outputTokens: row.outputTokens,
+    cacheHitInputCost: row.cacheHitInputCost,
+    cacheMissInputCost: row.cacheMissInputCost,
+    outputCost: row.outputCost,
+  }))
+  return {
+    total: models.reduce((sum, model) => sum + model.cost, 0),
+    models,
+  }
+}
+
+/**
+ * Price one session's complete event log at the official per-model rates.
+ * @param events - one session's complete event log.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param catalog - model display rows, in presentation order.
+ * @returns the session's total cost plus one row per priced model.
+ */
+export function computeSessionSpend(
+  events: readonly SessionEvent[],
+  billing: ResolvedBilling,
+  catalog: readonly { id: string; name: string }[],
+): DeepSeekSessionSpend {
+  return priceEvents(events, billing, catalog)
+}
+
+/**
+ * Price every event whose Beijing-time calendar day is the day of `now`,
+ * aggregating across every session's event log. Events from other Beijing
+ * days are ignored, so a caller passes the concatenated logs of all sessions.
+ * @param events - every session's complete event log, concatenated.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param catalog - model display rows, in presentation order.
+ * @param now - the reference moment whose Beijing-time calendar day is "today".
+ * @returns today's total cost plus one row per priced model.
+ */
+export function computeTodaySpend(
+  events: readonly SessionEvent[],
+  billing: ResolvedBilling,
+  catalog: readonly { id: string; name: string }[],
+  now: Date = new Date(),
+): DeepSeekTodaySpend {
+  const day = beijingDayKey(now)
+  return priceEvents(events.filter(event => beijingDayKey(new Date(event.time)) === day), billing, catalog)
+}