@rayadesu/dsh-llm-billing 0.2.2 → 0.2.4

package/lib/typert.host.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 = {
   package: '@rayadesu/dsh-llm-billing',
@@ -64,7 +77,7 @@ export const TYPERT = {
         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',
@@ -89,7 +102,33 @@ export const TYPERT = {
         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',
@@ -115,7 +154,42 @@ export const TYPERT = {
         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},
     },
   ],
   model: {

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

@@ -3,18 +3,22 @@ import type {
   RemoteResult,
   TypertRemoteContribution,
 } from '@deepseek-ai/dsh-typert-protocol'
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types'
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend, DeepSeekTurnSpend } 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>>
+    getTodaySessionsSpend: (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySessionsSpend>>
     getTodaySpend: (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySpend>>
+    getTurnSpend: (sessionId: SessionId, messageId: string) => Promise<RemoteResult<DeepSeekTurnSpend>>
   }
   interface TypertRemoteMap {
     'billing/getBalance': () => Promise<RemoteResult<DeepSeekBalance>>
     'billing/getSessionSpend': (sessionId: SessionId) => Promise<RemoteResult<DeepSeekSessionSpend>>
+    'billing/getTodaySessionsSpend': (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySessionsSpend>>
     'billing/getTodaySpend': (force?: boolean) => Promise<RemoteResult<DeepSeekTodaySpend>>
+    'billing/getTurnSpend': (sessionId: SessionId, messageId: string) => Promise<RemoteResult<DeepSeekTurnSpend>>
   }
   interface TypertRemoteNamespaceMap {
     'billing': TypertRemoteNamespace$62696c6c696e67

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

@@ -4,15 +4,16 @@
  * Remote gateway stays transport-free and the whole spend is testable without
  * a key.
  *
- * 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.
+ * The per-event pricing lives in {@link priceEvent} and the fold in the
+ * {@link SpendAccumulator}: the events-scan paths ({@link computeSessionSpend},
+ * {@link computeTodaySpend}), the session-projection unit (`billingTodaySpend`
+ * in projection.ts), and the scanner's single-pass events path all price
+ * through the same primitives, 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';
+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. */
@@ -143,6 +144,22 @@ export interface BillingEventContribution {
 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;
+/**
+ * Mutable model-row accumulator behind every spend fold. Rows keep first-seen
+ * model order — the same shape a pure `addEventContribution` chain produces —
+ * so the single-pass scan path and the pure public paths cannot diverge. One
+ * `Map` lookup per contribution instead of a per-event array copy: the huge
+ * event-log folds allocate one row object per model, not one intermediate
+ * array per event.
+ */
+export declare class SpendAccumulator {
+    private readonly rows;
+    private total;
+    /** Add one priced contribution. */
+    add(priced: BillingEventContribution): void;
+    /** The folded spend; the accumulator stays usable afterwards. */
+    finish(): DeepSeekTodaySpend;
+}
 /**
  * Merge one priced event's contribution into an accumulator spend (pure:
  * returns a new spend, never mutates its input).
@@ -170,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