@rayadesu/dsh-llm-billing 0.2.3 → 0.2.4

package/lib/typert.remote-client.js

@@ -27,6 +27,14 @@ const _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema = z.object
   'outputCost': z.number(),
 })),
 })
+const _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_parameter_0$schema = z.union([z.undefined(), z.literal(false), z.literal(true)])
+const _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_result$schema = z.object({
+  'sessions': z.array(z.object({
+  'sessionId': z.intersection(z.string(), z.unknown()),
+  'title': z.union([z.literal(null), z.string()]),
+  'total': z.number(),
+})),
+})
 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(),
@@ -44,6 +52,11 @@ const _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema = z.object({
   'outputCost': z.number(),
 })),
 })
+const _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_1$schema = z.string()
+const _rayadesu_dsh_llm_billing_billing_getTurnSpend_result$schema = z.object({
+  'total': z.number(),
+})
 
 export const TYPERT_REMOTE = {
   package: '@rayadesu/dsh-llm-billing',
@@ -61,7 +74,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekBalance',
         schema: _rayadesu_dsh_llm_billing_billing_getBalance_result$schema,
       },
-      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":143,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":154,"column":3},
     },
     {
       id: '@rayadesu/dsh-llm-billing#billing/getSessionSpend',
@@ -86,7 +99,33 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend',
         schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":154,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":165,"column":3},
+    },
+    {
+      id: '@rayadesu/dsh-llm-billing#billing/getTodaySessionsSpend',
+      service: 'billing',
+      namespace: 'billing',
+      method: 'getTodaySessionsSpend',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'force',
+          wire: 'force',
+          source: 'json',
+          acceptsUndefined: true,
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@rayadesu/dsh-llm-billing#billing/getTodaySessionsSpend:force',
+            schema: _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekTodaySessionsSpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_result$schema,
+      },
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":192,"column":3},
     },
     {
       id: '@rayadesu/dsh-llm-billing#billing/getTodaySpend',
@@ -112,7 +151,42 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend',
         schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema,
       },
-      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":167,"column":3},
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":178,"column":3},
+    },
+    {
+      id: '@rayadesu/dsh-llm-billing#billing/getTurnSpend',
+      service: 'billing',
+      namespace: 'billing',
+      method: 'getTurnSpend',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'sessionId',
+          wire: 'sessionId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@rayadesu/dsh-llm-billing#billing/getTurnSpend:sessionId',
+            schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_0$schema,
+          },
+        },
+        {
+          name: 'messageId',
+          wire: 'messageId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@rayadesu/dsh-llm-billing#billing/getTurnSpend:messageId',
+            schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_1$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@rayadesu/dsh-llm-billing/types#DeepSeekTurnSpend',
+        schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_result$schema,
+      },
+      sourceLocation: {"file":"packages/llm-billing/src/balance.ts","line":205,"column":3},
     },
   ],
 }

package/lib/types/balance.d.ts

@@ -9,7 +9,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts';
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend, DeepSeekTurnSpend } from './types.ts';
 /**
  * Parse and validate the DeepSeek balance response at the wire boundary.
  * @param body - decoded JSON response body.
@@ -38,6 +38,17 @@ export interface DeepSeekBalanceGatewayOptions {
      * refresh path); a `force` miss still reuses revision-gated increments.
      */
     fetchTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
+    /**
+     * Compute today's billed spend per session through the plugin's resolved
+     * facts, sorted by cost descending. `force` bypasses the host-side time
+     * window like {@link fetchTodaySpend}.
+     */
+    fetchTodaySessionsSpend: (force?: boolean) => Promise<DeepSeekTodaySessionsSpend>;
+    /**
+     * Compute one completed Turn's billed spend through the plugin's resolved
+     * facts, identified by its closing assistant message id.
+     */
+    fetchTurnSpend: (sessionId: SessionId, messageId: string) => Promise<DeepSeekTurnSpend>;
 }
 /**
  * Remote-only service exposing the DeepSeek account balance and session spend.
@@ -74,6 +85,25 @@ export declare class DeepSeekBalanceGateway extends TypertRemoteService {
      * @returns today's total cost plus one row per priced model.
      */
     getTodaySpend(force?: boolean): Promise<DeepSeekTodaySpend>;
+    /**
+     * Read today's billed spend per session, priced per event by its
+     * Beijing-time calendar day, hour, and weekday (weekends are always
+     * off-peak). Rows carry the session's durable title and sort by cost
+     * descending; sessions with no priced usage on the day are omitted.
+     * @param force - bypass the host-side 60s cache (manual refresh); omitted
+     *   means a cached read.
+     * @returns today's per-session rows, highest first.
+     */
+    getTodaySessionsSpend(force?: boolean): Promise<DeepSeekTodaySessionsSpend>;
+    /**
+     * Read one completed Turn's billed spend, priced per event by its
+     * Beijing-time hour and weekday (weekends are always off-peak).
+     * @param sessionId - the session owning the Turn.
+     * @param messageId - the closing assistant message's durable id, which
+     *   locates the Turn in the session log.
+     * @returns the Turn's total cost in CNY.
+     */
+    getTurnSpend(sessionId: SessionId, messageId: string): Promise<DeepSeekTurnSpend>;
 }
 export default DeepSeekBalanceGateway;
 //# sourceMappingURL=balance.d.ts.map

package/lib/types/balance.js

@@ -136,15 +136,21 @@ let DeepSeekBalanceGateway = (() => {
     let _getBalance_decorators;
     let _getSessionSpend_decorators;
     let _getTodaySpend_decorators;
+    let _getTodaySessionsSpend_decorators;
+    let _getTurnSpend_decorators;
     return class DeepSeekBalanceGateway extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
             _getBalance_decorators = [Remote('getBalance')];
             _getSessionSpend_decorators = [Remote('getSessionSpend')];
             _getTodaySpend_decorators = [Remote('getTodaySpend')];
+            _getTodaySessionsSpend_decorators = [Remote('getTodaySessionsSpend')];
+            _getTurnSpend_decorators = [Remote('getTurnSpend')];
             __esDecorate(this, null, _getBalance_decorators, { kind: "method", name: "getBalance", static: false, private: false, access: { has: obj => "getBalance" in obj, get: obj => obj.getBalance }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _getSessionSpend_decorators, { kind: "method", name: "getSessionSpend", static: false, private: false, access: { has: obj => "getSessionSpend" in obj, get: obj => obj.getSessionSpend }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _getTodaySpend_decorators, { kind: "method", name: "getTodaySpend", static: false, private: false, access: { has: obj => "getTodaySpend" in obj, get: obj => obj.getTodaySpend }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getTodaySessionsSpend_decorators, { kind: "method", name: "getTodaySessionsSpend", static: false, private: false, access: { has: obj => "getTodaySessionsSpend" in obj, get: obj => obj.getTodaySessionsSpend }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getTurnSpend_decorators, { kind: "method", name: "getTurnSpend", static: false, private: false, access: { has: obj => "getTurnSpend" in obj, get: obj => obj.getTurnSpend }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
         options = __runInitializers(this, _instanceExtraInitializers);
@@ -184,6 +190,29 @@ let DeepSeekBalanceGateway = (() => {
         getTodaySpend(force) {
             return this.options.fetchTodaySpend(force ?? false);
         }
+        /**
+         * Read today's billed spend per session, priced per event by its
+         * Beijing-time calendar day, hour, and weekday (weekends are always
+         * off-peak). Rows carry the session's durable title and sort by cost
+         * descending; sessions with no priced usage on the day are omitted.
+         * @param force - bypass the host-side 60s cache (manual refresh); omitted
+         *   means a cached read.
+         * @returns today's per-session rows, highest first.
+         */
+        getTodaySessionsSpend(force) {
+            return this.options.fetchTodaySessionsSpend(force ?? false);
+        }
+        /**
+         * Read one completed Turn's billed spend, priced per event by its
+         * Beijing-time hour and weekday (weekends are always off-peak).
+         * @param sessionId - the session owning the Turn.
+         * @param messageId - the closing assistant message's durable id, which
+         *   locates the Turn in the session log.
+         * @returns the Turn's total cost in CNY.
+         */
+        getTurnSpend(sessionId, messageId) {
+            return this.options.fetchTurnSpend(sessionId, messageId);
+        }
     };
 })();
 export { DeepSeekBalanceGateway };

package/lib/types/billing.d.ts

@@ -13,7 +13,7 @@
  * @module @rayadesu/dsh-llm-billing/billing
  */
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import type { DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts';
+import type { DeepSeekSessionSpend, DeepSeekTodaySpend, DeepSeekTurnSpend } from './types.ts';
 /** One token price point, in CNY per 1M tokens. */
 export interface DeepSeekTokenPrice {
     /** 1M input cache-hit tokens. */
@@ -187,6 +187,24 @@ export declare function computeSessionSpend(events: readonly SessionEvent[], bil
     id: string;
     name: string;
 }[]): DeepSeekSessionSpend;
+/**
+ * Price one completed Turn's billed usage at the official per-model rates,
+ * identified by its closing assistant message id. The turn's events are those
+ * between its `turn/start` and `turn/end` (both matched by the message's own
+ * turn coordinate); each priced event applies the peak/off-peak table by its
+ * Beijing-time hour and weekday. A message that cannot be located, a turn
+ * without bracketing `turn/start` / `turn/end` events (for example after
+ * compaction), or a session with no priced usage prices to zero.
+ * @param events - one session's complete event log.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param catalog - model display rows, in presentation order.
+ * @param messageId - the closing assistant message's durable id.
+ * @returns the turn's total cost in CNY.
+ */
+export declare function computeTurnSpend(events: readonly SessionEvent[], billing: ResolvedBilling, catalog: readonly {
+    id: string;
+    name: string;
+}[], messageId: string): DeepSeekTurnSpend;
 /**
  * Price every event whose Beijing-time calendar day is the day of `now`,
  * aggregating across every session's event log. Events from other Beijing

package/lib/types/billing.js

@@ -272,6 +272,50 @@ export function computeSessionSpend(events, billing, catalog) {
     const names = new Map(catalog.map(model => [model.id, model.name]));
     return priceEvents(events, billing, names);
 }
+/**
+ * Price one completed Turn's billed usage at the official per-model rates,
+ * identified by its closing assistant message id. The turn's events are those
+ * between its `turn/start` and `turn/end` (both matched by the message's own
+ * turn coordinate); each priced event applies the peak/off-peak table by its
+ * Beijing-time hour and weekday. A message that cannot be located, a turn
+ * without bracketing `turn/start` / `turn/end` events (for example after
+ * compaction), or a session with no priced usage prices to zero.
+ * @param events - one session's complete event log.
+ * @param billing - resolved pricing with peak-hour windows.
+ * @param catalog - model display rows, in presentation order.
+ * @param messageId - the closing assistant message's durable id.
+ * @returns the turn's total cost in CNY.
+ */
+export function computeTurnSpend(events, billing, catalog, messageId) {
+    const names = new Map(catalog.map(model => [model.id, model.name]));
+    let turn;
+    for (const event of events) {
+        if (event.type !== 'assistant/message')
+            continue;
+        if (event.data.message.id !== messageId)
+            continue;
+        turn = event.data.turn;
+        break;
+    }
+    if (turn === undefined)
+        return { total: 0 };
+    const accumulator = new SpendAccumulator();
+    let active = false;
+    for (const event of events) {
+        if (event.type === 'turn/start' && event.data.turn === turn) {
+            active = true;
+            continue;
+        }
+        if (event.type === 'turn/end' && event.data.turn === turn)
+            break;
+        if (!active)
+            continue;
+        const priced = priceEvent(event, billing, names);
+        if (priced !== undefined)
+            accumulator.add(priced);
+    }
+    return { total: accumulator.finish().total };
+}
 /**
  * Price every event whose Beijing-time calendar day is the day of `now`,
  * aggregating across every session's event log. Events from other Beijing

package/lib/types/index.d.ts

@@ -24,12 +24,12 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { BillingConfig } from './billing.ts';
 export { DeepSeekBalanceGateway, fetchDeepSeekBalance, parseDeepSeekBalance } from './balance.ts';
-export { addEventContribution, beijingDayKey, computeSessionSpend, computeTodaySpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, emptyTodaySpend, isPeak, mergeTodaySpend, priceEvent, resolveBilling, SpendAccumulator, } from './billing.ts';
+export { addEventContribution, beijingDayKey, computeSessionSpend, computeTodaySpend, computeTurnSpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, emptyTodaySpend, isPeak, mergeTodaySpend, priceEvent, resolveBilling, SpendAccumulator, } from './billing.ts';
 export type { BillingConfig, BillingConfigModel, BillingEventContribution, DeepSeekModelPricing, DeepSeekTokenPrice, PeakHourWindow, ResolvedBilling, } from './billing.ts';
 export type * from './types.ts';
 export { BILLING_UNIT_KEY, billingTodaySpendDefinition, foldBillingUnit } from './projection.ts';
 export type { BillingUnitState } from './projection.ts';
-export { TodaySpendCache, TodaySpendScanner } from './today-spend.ts';
+export { foldSessionTitle, TodaySpendCache, TodaySpendScanner } from './today-spend.ts';
 export type { ScannerPersistedHeader, ScannerSession, TodaySpendScannerDeps } from './today-spend.ts';
 export declare const name = "llm-billing";
 /** Public API default; deployments may point elsewhere via $DEEPSEEK_BASE_URL. */

package/lib/types/index.js

@@ -25,13 +25,13 @@ import { assertUsableApiKey, LlmError } from '@deepseek-ai/dsh-llm';
 import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { launchEnvironmentOf } from '@deepseek-ai/dsh-launch-environment';
 import { DeepSeekBalanceGateway, fetchDeepSeekBalance } from "./balance.js";
-import { computeSessionSpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, mergeTodaySpend, resolveBilling, } from "./billing.js";
+import { computeSessionSpend, computeTurnSpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, mergeTodaySpend, resolveBilling, } from "./billing.js";
 import { billingTodaySpendDefinition } from "./projection.js";
 import { TodaySpendCache, TodaySpendScanner } from "./today-spend.js";
 export { DeepSeekBalanceGateway, fetchDeepSeekBalance, parseDeepSeekBalance } from "./balance.js";
-export { addEventContribution, beijingDayKey, computeSessionSpend, computeTodaySpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, emptyTodaySpend, isPeak, mergeTodaySpend, priceEvent, resolveBilling, SpendAccumulator, } from "./billing.js";
+export { addEventContribution, beijingDayKey, computeSessionSpend, computeTodaySpend, computeTurnSpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, emptyTodaySpend, isPeak, mergeTodaySpend, priceEvent, resolveBilling, SpendAccumulator, } from "./billing.js";
 export { BILLING_UNIT_KEY, billingTodaySpendDefinition, foldBillingUnit } from "./projection.js";
-export { TodaySpendCache, TodaySpendScanner } from "./today-spend.js";
+export { foldSessionTitle, TodaySpendCache, TodaySpendScanner } from "./today-spend.js";
 export const name = 'llm-billing';
 const DEFAULT_API_KEY_ENV = 'DEEPSEEK_API_KEY';
 const BASE_URL_ENV = 'DEEPSEEK_BASE_URL';
@@ -186,7 +186,13 @@ export function apply(ctx, config) {
         catalog,
     });
     const todayCache = new TodaySpendCache(dayKey => scanner.scan(dayKey), TODAY_SPEND_CACHE_MS);
+    const todaySessionsCache = new TodaySpendCache(dayKey => scanner.scanSessions(dayKey), TODAY_SPEND_CACHE_MS);
     const fetchTodaySpend = async (force = false) => todayCache.get(force);
-    new DeepSeekBalanceGateway(ctx, { fetchBalance, fetchSessionSpend, fetchTodaySpend });
+    const fetchTodaySessionsSpend = async (force = false) => todaySessionsCache.get(force);
+    const fetchTurnSpend = async (sessionId, messageId) => {
+        const events = await sessionEvents(ctx, sessionId);
+        return computeTurnSpend(events, billing, catalog, messageId);
+    };
+    new DeepSeekBalanceGateway(ctx, { fetchBalance, fetchSessionSpend, fetchTodaySpend, fetchTodaySessionsSpend, fetchTurnSpend });
 }
 //# sourceMappingURL=index.js.map

package/lib/types/today-spend.d.ts

@@ -23,9 +23,18 @@
 import type { SessionEvent, SessionId } from '@deepseek-ai/dsh-session';
 import type { SessionPersistenceRevision } from '@deepseek-ai/dsh-session-persistence';
 import type { ResolvedBilling } from './billing.ts';
-import type { DeepSeekTodaySpend } from './types.ts';
+import type { DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from './types.ts';
 import { BILLING_UNIT_KEY, type BillingUnitState } from './projection.ts';
 import type { ProjectionDefinition } from '@deepseek-ai/dsh-session-projection';
+/**
+ * Fold one session's durable display title: the latest `session/title`
+ * event's text (last-wins, matching the `title` projection), or `null` before
+ * the first title lands. The fold runs over the complete log, so an explicit
+ * user rename is picked up as soon as its event commits.
+ * @param events - one session's complete event log.
+ * @returns the session's current title, or `null` when untitled.
+ */
+export declare function foldSessionTitle(events: readonly SessionEvent[]): string | null;
 /** Structural slice of a live session the scanner reads. */
 export interface ScannerSession {
     readonly id: SessionId;
@@ -89,8 +98,10 @@ export interface TodaySpendScannerDeps {
  * coalesces concurrent misses, and a `force` bypass for the manual refresh
  * path. Cross-day invalidation is automatic (the day key changes); a failed
  * scan leaves the previous value in place and retries on the next call.
+ * @typeParam T - the cached aggregate's value shape (the spend or its
+ *   per-session breakdown).
  */
-export declare class TodaySpendCache {
+export declare class TodaySpendCache<T = DeepSeekTodaySpend> {
     private readonly scan;
     private readonly ttlMs;
     private readonly now;
@@ -99,18 +110,18 @@ export declare class TodaySpendCache {
     private cachedAt;
     private inFlight;
     /**
+     * @param scan - the aggregate computation behind a miss.
      * @param ttlMs - time window in milliseconds (default 60 000).
      * @param now - clock source (injectable for tests).
-     * @param scan - the aggregate computation behind a miss.
      */
-    constructor(scan: (dayKey: string) => Promise<DeepSeekTodaySpend>, ttlMs?: number, now?: () => Date);
+    constructor(scan: (dayKey: string) => Promise<T>, ttlMs?: number, now?: () => Date);
     /**
      * Read today's spend, cached per Beijing day within the TTL window.
      * @param force - bypass the time window (manual refresh); the day-key gate
      *   and the in-flight coalescing still apply to non-force callers.
      * @returns today's spend.
      */
-    get(force?: boolean): Promise<DeepSeekTodaySpend>;
+    get(force?: boolean): Promise<T>;
 }
 /**
  * The aggregate computation behind a cache miss. Chooses the projection path
@@ -120,7 +131,7 @@ export declare class TodaySpendCache {
  */
 export declare class TodaySpendScanner {
     private readonly deps;
-    /** Cold sessions resolved on the projection path: id → revision + unit state. */
+    /** Cold sessions resolved on the projection path: id → revision + unit state + title. */
     private readonly coldResolved;
     /** Cold sessions resolved on the events path: id → revision (events were collected). */
     private lastEventsScan;
@@ -131,6 +142,24 @@ export declare class TodaySpendScanner {
      * @returns today's spend across every session.
      */
     scan(dayKey: string): Promise<DeepSeekTodaySpend>;
+    /**
+     * Compute today's per-session spend for one Beijing day, sorted by cost
+     * descending. Sessions with no priced usage on the day are omitted; each
+     * row carries the session's durable title folded from its log.
+     * @param dayKey - the Beijing-time calendar-day key to aggregate.
+     * @returns today's per-session rows, highest first.
+     */
+    scanSessions(dayKey: string): Promise<DeepSeekTodaySessionsSpend>;
+    /**
+     * Resolve one cold session's billing unit state and display title through
+     * the projection-cache ladder (cached row first, then a detached local
+     * fold over a full inspect). A cache-served value carries no title (the
+     * ladder only stores projection values), so such rows report `title: null`
+     * until the session is inspected again.
+     * @param id - the cold session's id.
+     * @returns the resolved state and title, or `undefined` when unreadable.
+     */
+    private resolveCold;
     /** Projection path: eager cells for live sessions, revision-gated cold ladder for the rest. */
     private scanProjections;
     /**
@@ -138,5 +167,24 @@ export declare class TodaySpendScanner {
      * filter during collection, hard cap), gated by revisions.
      */
     private scanEvents;
+    /**
+     * Projection-path per-session scan: eager cells for live sessions (title
+     * folded from the live log, so a rename is reflected immediately),
+     * revision-gated cold ladder for the rest (title resolved on inspect,
+     * `null` when served from the projection cache).
+     * @param dayKey - the Beijing-time calendar-day key to aggregate.
+     * @returns unsorted per-session rows for the day.
+     */
+    private scanSessionsProjections;
+    /**
+     * Events-path per-session scan: price today's events in a single pass,
+     * accumulating per session (per-event Beijing-day filter during collection,
+     * hard cap), gated by revisions. Titles fold from each session's complete
+     * log — a `session/title` event can predate today — so a rename is reflected
+     * as soon as the session's log is re-read.
+     * @param dayKey - the Beijing-time calendar-day key to aggregate.
+     * @returns unsorted per-session rows for the day.
+     */
+    private scanSessionsEvents;
 }
 //# sourceMappingURL=today-spend.d.ts.map