@rayadesu/dsh-llm-billing 0.1.0-rc.8 → 0.1.0

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: 655288ebdb37cee4ecd3edfad8b3953e3a4e87ee
-README.zh.md: e8ac4a2716ffe57200bb9757e1f0c6dabaf77c2f
+README.md: c51e3f984ce4eca27bc3998068c6a068e5c8e617
+README.zh.md: bf1385e6414657c262e153c805ced50c04a2575a

package/README.md

@@ -16,7 +16,7 @@ Add the plugin to a composition (a `cordis.yml` row) and give it a credential. I
     # baseURL: https://api.deepseek.com
 ```
 
-The plugin registers the `billing` Remote with three methods: `getBalance()` (the parsed `/user/balance` snapshot), `getSessionSpend(sessionId)` (one session's billed cost), and `getTodaySpend()` (every session's billed cost on the current Beijing-time calendar day). The spend prices each `assistant/message` event's billed tokens (cache-hit input, cache-miss input including cache writes, and output including reasoning) at the official rate of the event's own Beijing-time peak/off-peak hour, then sums per model.
+The plugin registers the `billing` Remote with three methods: `getBalance()` (the parsed `/user/balance` snapshot), `getSessionSpend(sessionId)` (one session's billed cost), and `getTodaySpend()` (every session's billed cost on the current Beijing-time calendar day). The spend prices each `assistant/message` event's billed tokens (cache-hit input, cache-miss input including cache writes, and output including reasoning) at the official rate of the event's own Beijing-time peak/off-peak classification — peak windows apply weekdays (Monday–Friday) only, and weekends are always off-peak — then sums per model.
 
 ## Configuration
 
@@ -25,7 +25,7 @@ The plugin registers the `billing` Remote with three methods: `getBalance()` (th
 | `apiKeyEnv` | `DEEPSEEK_API_KEY` | Credential-reference (environment-variable) name resolved per call. |
 | `baseURL` | `$DEEPSEEK_BASE_URL` then `https://api.deepseek.com` | Endpoint base; `/user/balance` is appended. |
 | `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | Advisory display rows, in presentation order. |
-| `billing.peakHours` | 09:00–12:00, 14:00–18:00 (Beijing) | Peak-hour windows; all other hours are off-peak. |
+| `billing.peakHours` | 09:00–12:00, 14:00–18:00 (Beijing, weekdays) | Peak-hour windows, applied weekdays (Mon–Fri) only; weekends and all other hours are off-peak. |
 | `billing.models` | Published V4 rates | Per-model peak/off-peak price rows (`cacheHitInput`, `cacheMissInput`, `output`, in CNY per 1M tokens). |
 
 Override one model without dropping the others by supplying a non-empty `billing.models` list; an empty or omitted list falls back to the published defaults.

package/README.zh.md

@@ -16,7 +16,7 @@
     # baseURL: https://api.deepseek.com
 ```
 
-插件注册 `billing` Remote，含三个方法：`getBalance()`（解析后的 `/user/balance` 快照）、`getSessionSpend(sessionId)`（单个会话的计费花费）与 `getTodaySpend()`（当前北京时间自然日内所有会话的计费花费合计）。会话花费把每条 `assistant/message` 事件的计费 token（缓存命中输入、含缓存写入的未命中输入、含推理的输出）按事件自身发生时刻（北京时间）所在的峰/谷单价计价，再按模型汇总。
+插件注册 `billing` Remote，含三个方法：`getBalance()`（解析后的 `/user/balance` 快照）、`getSessionSpend(sessionId)`（单个会话的计费花费）与 `getTodaySpend()`（当前北京时间自然日内所有会话的计费花费合计）。会话花费把每条 `assistant/message` 事件的计费 token（缓存命中输入、含缓存写入的未命中输入、含推理的输出）按事件自身发生时刻（北京时间）所在的峰/谷单价计价——高峰窗口仅周一至周五适用，周末全天按低谷价——再按模型汇总。
 
 ## 配置
 
@@ -25,7 +25,7 @@
 | `apiKeyEnv` | `DEEPSEEK_API_KEY` | 每次调用时解析的凭据引用（环境变量）名。 |
 | `baseURL` | `$DEEPSEEK_BASE_URL`，其次 `https://api.deepseek.com` | 端点基础地址；会追加 `/user/balance`。 |
 | `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | 展示用的模型行，按展示顺序。 |
-| `billing.peakHours` | 09:00–12:00、14:00–18:00（北京） | 高峰时段窗口；其余时段为低谷。 |
+| `billing.peakHours` | 09:00–12:00、14:00–18:00（北京，仅工作日） | 高峰时段窗口，仅周一至周五适用；周末与其余时段均为低谷。 |
 | `billing.models` | 官方 V4 费率 | 每个模型的峰/谷单价行（`cacheHitInput`、`cacheMissInput`、`output`，单位：元/百万 token）。 |
 
 只想覆盖某个模型而不丢其它，就提供一个非空的 `billing.models` 列表；空或省略则回退到官方默认费率。

package/lib/index.js

@@ -3,7 +3,7 @@ import { LlmError, assertUsableApiKey } from "@deepseek-ai/dsh-llm";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-//#region lib/types/balance.js
+//#region ../../../../DeepSeek-Harness-chat-billing/packages/llm-billing/lib/types/balance.js
 /**
 * DeepSeek account-balance capability: the `GET /user/balance` transport and
 * the Remote gateway that exposes one snapshot to trusted clients. The fetch
@@ -196,7 +196,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.
 		*/
@@ -205,7 +206,7 @@ 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).
 		* @returns today's total cost plus one row per priced model.
 		*/
 		getTodaySpend() {
@@ -214,7 +215,7 @@ let DeepSeekBalanceGateway = (() => {
 	};
 })();
 //#endregion
-//#region lib/types/billing.js
+//#region ../../../../DeepSeek-Harness-chat-billing/packages/llm-billing/lib/types/billing.js
 /**
 * 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
@@ -222,7 +223,11 @@ let DeepSeekBalanceGateway = (() => {
 * a key.
 * @module @rayadesu/dsh-llm-billing/billing
 */
-/** 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).
+*/
 const DEFAULT_PEAK_HOURS = [{
 	start: 9,
 	end: 12
@@ -298,23 +303,35 @@ function resolveBilling(config) {
 function beijingHour(now) {
 	return new Date(now.getTime() + 8 * 36e5).getUTCHours();
 }
+/**
+* The Beijing (Asia/Shanghai, UTC+8, no DST) weekday of a timestamp, as
+* `getUTCDay()`: `0` is Sunday, `6` is Saturday.
+*/
+function beijingWeekday(now) {
+	return new Date(now.getTime() + 8 * 36e5).getUTCDay();
+}
 /** The Beijing (Asia/Shanghai, UTC+8, no DST) calendar-day key of a timestamp. */
 function beijingDayKey(now) {
 	return new Date(now.getTime() + 8 * 36e5).toISOString().slice(0, 10);
 }
 /**
-* 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.
 */
 function isPeak(billing, now) {
+	const weekday = beijingWeekday(now);
+	if (weekday === 0 || weekday === 6) return false;
 	const hour = beijingHour(now);
 	return billing.peakHours.some(({ start, end }) => hour >= start && hour < end);
 }
 /**
 * 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
+* peak/off-peak table per event 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, with the three component costs
@@ -412,7 +429,7 @@ function computeTodaySpend(events, billing, catalog, now = /* @__PURE__ */ new D
 	return priceEvents(events.filter((event) => beijingDayKey(new Date(event.time)) === day), billing, catalog);
 }
 //#endregion
-//#region lib/types/index.js
+//#region ../../../../DeepSeek-Harness-chat-billing/packages/llm-billing/lib/types/index.js
 /**
 * DeepSeek account balance and session-spend provider, as a standalone host
 * plugin. It resolves the DeepSeek endpoint and API key from its own config and

package/lib/invariant.js

@@ -1,4 +1,4 @@
-//#region lib/types/invariant.js
+//#region ../../../../DeepSeek-Harness-chat-billing/packages/llm-billing/lib/types/invariant.js
 /**
 * Package-owned invariant companion for `@rayadesu/dsh-llm-billing`.
 * @module @rayadesu/dsh-llm-billing/invariant

package/lib/types/balance.d.ts

@@ -55,14 +55,15 @@ 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).
      * @returns today's total cost plus one row per priced model.
      */
     getTodaySpend(): Promise<DeepSeekTodaySpend>;

package/lib/types/balance.js

@@ -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,7 +175,7 @@ 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).
          * @returns today's total cost plus one row per priced model.
          */
         getTodaySpend() {

package/lib/types/billing.d.ts

@@ -32,7 +32,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 +41,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;
@@ -72,10 +79,12 @@ export interface ResolvedBilling {
  */
 export declare function resolveBilling(config: BillingConfig | undefined): ResolvedBilling;
 /**
- * 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;
 /**

package/lib/types/billing.js

@@ -5,7 +5,11 @@
  * a key.
  * @module @rayadesu/dsh-llm-billing/billing
  */
-/** 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 const DEFAULT_PEAK_HOURS = [
     { start: 9, end: 12 },
     { start: 14, end: 18 },
@@ -22,6 +26,13 @@ export const DEFAULT_MODEL_PRICING = [
         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 },
+    },
 ];
 /**
  * Resolve optional configuration to a pricing table, defaulting omitted or
@@ -48,23 +59,36 @@ export function resolveBilling(config) {
 function beijingHour(now) {
     return new Date(now.getTime() + 8 * 3_600_000).getUTCHours();
 }
+/**
+ * The Beijing (Asia/Shanghai, UTC+8, no DST) weekday of a timestamp, as
+ * `getUTCDay()`: `0` is Sunday, `6` is Saturday.
+ */
+function beijingWeekday(now) {
+    return new Date(now.getTime() + 8 * 3_600_000).getUTCDay();
+}
 /** The Beijing (Asia/Shanghai, UTC+8, no DST) calendar-day key of a timestamp. */
 function beijingDayKey(now) {
     return new Date(now.getTime() + 8 * 3_600_000).toISOString().slice(0, 10);
 }
 /**
- * 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 function isPeak(billing, now) {
+    const weekday = beijingWeekday(now);
+    if (weekday === 0 || weekday === 6)
+        return false;
     const hour = beijingHour(now);
     return billing.peakHours.some(({ start, end }) => hour >= start && hour < end);
 }
 /**
  * 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
+ * peak/off-peak table per event 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, with the three component costs

package/lib/types/index.d.ts

@@ -34,9 +34,9 @@ export interface Config {
     apiKeyEnv?: string;
     /** Endpoint base; defaults to `$DEEPSEEK_BASE_URL`, then `https://api.deepseek.com`. */
     baseURL?: string;
-    /** Advisory display rows, in presentation order; defaults to V4 Flash and V4 Pro. */
+    /** Advisory display rows, in presentation order; defaults to V4 Flash, V4 Pro, and V4 Flash Vision Exp. */
     models?: BillingModel[];
-    /** Pricing table and peak-hour windows; omission uses the published defaults. */
+    /** Pricing table and peak-hour windows; omission uses the published defaults. Peak windows apply weekdays (Monday–Friday) only; weekends are always off-peak. */
     billing?: BillingConfig;
 }
 export declare const Config: z<Config>;

package/lib/types/index.js

@@ -22,6 +22,7 @@ export const PUBLIC_BASE_URL = 'https://api.deepseek.com';
 const DEFAULT_MODELS = [
     { id: 'deepseek-v4-flash', name: 'DeepSeek-V4-Flash' },
     { id: 'deepseek-v4-pro', name: 'DeepSeek-V4-Pro' },
+    { id: 'deepseek-v4-flash-vision-exp', name: 'DeepSeek-V4-Flash-Vision-Exp' },
 ];
 const billingModel = z.object({
     id: z.string().required(),

package/lib/types/types.d.ts

@@ -46,14 +46,14 @@ export interface DeepSeekSessionSpendModel {
     /** Billed cost of output tokens (reasoning included) in CNY. */
     outputCost: number;
 }
-/** The billed spend of one session, priced per event by its Beijing-time peak/off-peak hour. */
+/** The billed spend of one session, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
 export interface DeepSeekSessionSpend {
     /** Total billed cost in CNY across every priced model. */
     total: number;
     /** One row per model that reported usage AND has a pricing row; empty when the session has no priced usage. */
     models: readonly DeepSeekSessionSpendModel[];
 }
-/** The billed spend of every session on one Beijing-time calendar day, priced per event by its peak/off-peak hour. */
+/** The billed spend of every session on one Beijing-time calendar day, priced per event by its Beijing-time hour and weekday (peak hours apply Monday–Friday only; weekends are off-peak). */
 export interface DeepSeekTodaySpend {
     /** Total billed cost in CNY across every priced model and every session. */
     total: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "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",
+  "version": "0.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -72,4 +72,4 @@
     "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8",
     "@deepseek-ai/cordis": "^4.0.1"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 WilliamLIiii
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/lib/types/types/balance.d.ts

@@ -1,71 +0,0 @@
-/**
- * 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 type { SessionId } from '@deepseek-ai/dsh-session';
-import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from './types.ts';
-/**
- * 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 declare function parseDeepSeekBalance(body: unknown): DeepSeekBalance;
-/**
- * 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 declare function fetchDeepSeekBalance(baseURL: string, apiKey: string, signal?: AbortSignal): Promise<DeepSeekBalance>;
-/** 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 declare class DeepSeekBalanceGateway extends TypertRemoteService {
-    private readonly options;
-    /**
-     * 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);
-    /**
-     * Read the current DeepSeek account balance.
-     * @returns the validated balance snapshot.
-     */
-    getBalance(): Promise<DeepSeekBalance>;
-    /**
-     * 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.
-     */
-    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.
-     * @returns today's total cost plus one row per priced model.
-     */
-    getTodaySpend(): Promise<DeepSeekTodaySpend>;
-}
-export default DeepSeekBalanceGateway;
-//# sourceMappingURL=balance.d.ts.map

package/lib/types/types/balance.js

@@ -1,187 +0,0 @@
-/**
- * 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
- */
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-import { LlmError } from '@deepseek-ai/dsh-llm';
-import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-/** Map a balance HTTP status to a stable LlmError code. */
-function httpErrorCode(status) {
-    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) {
-    if (typeof body !== 'object' || body === null || Array.isArray(body)) {
-        throw new LlmError('DeepSeek balance response was not a JSON object', 'TRANSPORT');
-    }
-    const response = body;
-    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 = 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;
-        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, apiKey, signal) {
-    let response;
-    try {
-        response = await fetch(`${baseURL}/user/balance`, {
-            method: 'GET',
-            headers: {
-                'authorization': `Bearer ${apiKey}`,
-                'accept': 'application/json',
-            },
-            ...(signal === undefined ? {} : { signal }),
-        });
-    }
-    catch (error) {
-        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;
-    try {
-        body = await response.json();
-    }
-    catch (error) {
-        throw new LlmError('DeepSeek balance response was not valid JSON', 'TRANSPORT', { cause: error });
-    }
-    return parseDeepSeekBalance(body);
-}
-/**
- * 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.
- */
-let DeepSeekBalanceGateway = (() => {
-    let _classSuper = TypertRemoteService;
-    let _instanceExtraInitializers = [];
-    let _getBalance_decorators;
-    let _getSessionSpend_decorators;
-    let _getTodaySpend_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')];
-            __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);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        options = __runInitializers(this, _instanceExtraInitializers);
-        /**
-         * 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, options) {
-            super(ctx, 'billing');
-            this.options = options;
-        }
-        /**
-         * Read the current DeepSeek account balance.
-         * @returns the validated balance snapshot.
-         */
-        getBalance() {
-            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.
-         */
-        getSessionSpend(sessionId) {
-            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.
-         */
-        getTodaySpend() {
-            return this.options.fetchTodaySpend();
-        }
-    };
-})();
-export { DeepSeekBalanceGateway };
-export default DeepSeekBalanceGateway;
-//# sourceMappingURL=balance.js.map

package/lib/types/types/billing.d.ts

@@ -1,106 +0,0 @@
-/**
- * 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 declare const DEFAULT_PEAK_HOURS: {
-    start: number;
-    end: number;
-}[];
-/** Official peak/off-peak rates (CNY per 1M tokens), effective 2026-08-17. */
-export declare const DEFAULT_MODEL_PRICING: BillingConfigModel[];
-/** 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 declare function resolveBilling(config: BillingConfig | undefined): ResolvedBilling;
-/**
- * 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 declare function isPeak(billing: ResolvedBilling, now: Date): boolean;
-/**
- * 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 declare function computeSessionSpend(events: readonly SessionEvent[], billing: ResolvedBilling, catalog: readonly {
-    id: string;
-    name: string;
-}[]): DeepSeekSessionSpend;
-/**
- * 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 declare function computeTodaySpend(events: readonly SessionEvent[], billing: ResolvedBilling, catalog: readonly {
-    id: string;
-    name: string;
-}[], now?: Date): DeepSeekTodaySpend;
-//# sourceMappingURL=billing.d.ts.map

package/lib/types/types/billing.js

@@ -1,170 +0,0 @@
-/**
- * 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
- */
-/** Published peak-hour windows (Beijing time): 09:00–12:00 and 14:00–18:00. */
-export const DEFAULT_PEAK_HOURS = [
-    { 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 = [
-    {
-        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 },
-    },
-];
-/**
- * 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) {
-    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();
-    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) {
-    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) {
-    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, now) {
-    const hour = beijingHour(now);
-    return billing.peakHours.some(({ start, end }) => hour >= start && hour < end);
-}
-/**
- * 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, billing, catalog) {
-    const names = new Map(catalog.map(model => [model.id, model.name]));
-    const rows = new Map();
-    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, billing, catalog) {
-    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, billing, catalog, now = new Date()) {
-    const day = beijingDayKey(now);
-    return priceEvents(events.filter(event => beijingDayKey(new Date(event.time)) === day), billing, catalog);
-}
-//# sourceMappingURL=billing.js.map

package/lib/types/types/index.d.ts

@@ -1,49 +0,0 @@
-/**
- * DeepSeek account balance and session-spend provider, as a standalone host
- * plugin. It resolves the DeepSeek endpoint and API key from its own config and
- * the credential/environment seams, prices each session's billed usage with the
- * peak/off-peak table, and exposes the `billing` Remote (`getBalance`, the
- * per-session `getSessionSpend`, and the all-sessions `getTodaySpend`).
- * @module @rayadesu/dsh-llm-billing
- */
-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 { computeSessionSpend, computeTodaySpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, isPeak, resolveBilling, } from './billing.ts';
-export type { BillingConfig, BillingConfigModel, DeepSeekModelPricing, DeepSeekTokenPrice, PeakHourWindow, ResolvedBilling, } from './billing.ts';
-export type * from './types.ts';
-export declare const name = "llm-billing";
-/** Public API default; deployments may point elsewhere via $DEEPSEEK_BASE_URL. */
-export declare const PUBLIC_BASE_URL = "https://api.deepseek.com";
-/** One advisory display row; requests are never restricted to this list. */
-export interface BillingModel {
-    /** Wire model id, e.g. `deepseek-v4-flash`. */
-    id: string;
-    /** Selector label; defaults to {@link id}. */
-    name?: string;
-}
-/**
- * Plugin config. Every field is optional: the API key resolves per call from
- * {@link Config.apiKeyEnv} (credentials seam, then environment), the endpoint
- * falls back to `$DEEPSEEK_BASE_URL` then the public API, and the pricing
- * table and peak-hour windows fall back to the published DeepSeek rates.
- */
-export interface Config {
-    /** Credential reference (environment-variable name); defaults to `DEEPSEEK_API_KEY`. */
-    apiKeyEnv?: string;
-    /** Endpoint base; defaults to `$DEEPSEEK_BASE_URL`, then `https://api.deepseek.com`. */
-    baseURL?: string;
-    /** Advisory display rows, in presentation order; defaults to V4 Flash, V4 Pro, and V4 Flash Vision Exp. */
-    models?: BillingModel[];
-    /** Pricing table and peak-hour windows; omission uses the published defaults. */
-    billing?: BillingConfig;
-}
-export declare const Config: z<Config>;
-/**
- * Register the `billing` Remote under the `billing` namespace.
- * @param ctx - owning plugin context.
- * @param config - validated plugin config.
- */
-export declare function apply(ctx: Context, config: Config): void;
-//# sourceMappingURL=index.d.ts.map

package/lib/types/types/index.js

@@ -1,156 +0,0 @@
-/**
- * DeepSeek account balance and session-spend provider, as a standalone host
- * plugin. It resolves the DeepSeek endpoint and API key from its own config and
- * the credential/environment seams, prices each session's billed usage with the
- * peak/off-peak table, and exposes the `billing` Remote (`getBalance`, the
- * per-session `getSessionSpend`, and the all-sessions `getTodaySpend`).
- * @module @rayadesu/dsh-llm-billing
- */
-import z from '@deepseek-ai/schemastery';
-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, computeTodaySpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, resolveBilling, } from "./billing.js";
-export { DeepSeekBalanceGateway, fetchDeepSeekBalance, parseDeepSeekBalance } from "./balance.js";
-export { computeSessionSpend, computeTodaySpend, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, isPeak, resolveBilling, } from "./billing.js";
-export const name = 'llm-billing';
-const DEFAULT_API_KEY_ENV = 'DEEPSEEK_API_KEY';
-const BASE_URL_ENV = 'DEEPSEEK_BASE_URL';
-/** Public API default; deployments may point elsewhere via $DEEPSEEK_BASE_URL. */
-export const PUBLIC_BASE_URL = 'https://api.deepseek.com';
-const DEFAULT_MODELS = [
-    { id: 'deepseek-v4-flash', name: 'DeepSeek-V4-Flash' },
-    { id: 'deepseek-v4-pro', name: 'DeepSeek-V4-Pro' },
-    { id: 'deepseek-v4-flash-vision-exp', name: 'DeepSeek-V4-Flash-Vision-Exp' },
-];
-const billingModel = z.object({
-    id: z.string().required(),
-    name: z.string(),
-});
-const tokenPrice = z.object({
-    cacheHitInput: z.number().min(0),
-    cacheMissInput: z.number().min(0),
-    output: z.number().min(0),
-});
-const billingConfig = z.object({
-    peakHours: z.array(z.object({
-        start: z.number().step(1).min(0).max(23),
-        end: z.number().step(1).min(0).max(24),
-    })).default(DEFAULT_PEAK_HOURS),
-    models: z.array(z.object({
-        model: z.string().required(),
-        peak: tokenPrice,
-        offPeak: tokenPrice,
-    })).default(DEFAULT_MODEL_PRICING),
-});
-export const Config = z.object({
-    apiKeyEnv: z.string().role('credential-ref').default(DEFAULT_API_KEY_ENV),
-    baseURL: z.string(),
-    models: z.array(billingModel).default(DEFAULT_MODELS),
-    billing: billingConfig,
-});
-/**
- * Read one session's event log: the live SessionStore first, then the
- * persistence backend for a flushed session.
- * @param ctx - plugin context carrying the SessionStore and optional persistence.
- * @param sessionId - the session to read.
- * @returns the session's complete event log.
- * @throws {@link LlmError} with code `NOT_FOUND` when the session is unknown.
- */
-async function sessionEvents(ctx, sessionId) {
-    const sessions = ctx.get('sessions');
-    const live = sessions?.get(sessionId);
-    if (live !== undefined)
-        return live.events;
-    const persistence = ctx.get('sessionPersistence');
-    if (persistence !== undefined) {
-        for (const header of await persistence.list()) {
-            if (header.id !== sessionId)
-                continue;
-            const inspection = await persistence.inspect(sessionId);
-            return inspection.events;
-        }
-    }
-    throw new LlmError(`llm-billing: session ${sessionId} not found`, 'NOT_FOUND');
-}
-/**
- * Read every session's event log, concatenated: each live SessionStore
- * session first (its log may hold events not yet flushed), then each persisted
- * session that is not live, so no event is counted twice. Events are appended
- * one at a time: spreading a very large log into `push(...)` exceeds the
- * engine's argument limit and throws a stack RangeError.
- * @param ctx - plugin context carrying the SessionStore and optional persistence.
- * @returns every session's complete event log, concatenated.
- */
-async function allSessionEvents(ctx) {
-    const events = [];
-    const sessions = ctx.get('sessions');
-    const liveIds = new Set();
-    if (sessions !== undefined) {
-        for (const session of sessions.list()) {
-            liveIds.add(session.id);
-            for (const event of session.events)
-                events.push(event);
-        }
-    }
-    const persistence = ctx.get('sessionPersistence');
-    if (persistence !== undefined) {
-        for (const header of await persistence.list()) {
-            if (liveIds.has(header.id))
-                continue;
-            try {
-                const inspection = await persistence.inspect(header.id);
-                for (const event of inspection.events)
-                    events.push(event);
-            }
-            catch (error) {
-                // One unreadable session must not blank the whole-day aggregate.
-                ctx.logger.warn(`llm-billing: skipping unreadable session ${header.id}: ${String(error)}`);
-            }
-        }
-    }
-    return events;
-}
-/**
- * Register the `billing` Remote under the `billing` namespace.
- * @param ctx - owning plugin context.
- * @param config - validated plugin config.
- */
-export function apply(ctx, config) {
-    const baseURL = () => config.baseURL
-        ?? launchEnvironmentOf(ctx).get(BASE_URL_ENV)?.value
-        ?? PUBLIC_BASE_URL;
-    const apiKeyRef = credentialRef(config.apiKeyEnv ?? DEFAULT_API_KEY_ENV);
-    const resolveApiKey = async () => {
-        const credentials = ctx.get('credentials');
-        if (credentials !== undefined) {
-            const hit = await credentials.resolve(apiKeyRef);
-            if (hit !== undefined)
-                return assertUsableApiKey(hit.value, 'llm-billing', apiKeyRef);
-        }
-        else {
-            const ambient = launchEnvironmentOf(ctx).get(apiKeyRef);
-            if (ambient !== undefined && ambient.value.length > 0) {
-                return assertUsableApiKey(ambient.value, 'llm-billing', apiKeyRef);
-            }
-        }
-        throw new LlmError(`llm-billing: no API key; store ${apiKeyRef} through the credentials service or export it`, 'MISSING_CREDENTIAL');
-    };
-    const fetchBalance = async () => {
-        const apiKey = await resolveApiKey();
-        return fetchDeepSeekBalance(baseURL(), apiKey);
-    };
-    const fetchSessionSpend = async (sessionId) => {
-        const billing = resolveBilling(config.billing);
-        const catalog = (config.models ?? DEFAULT_MODELS).map(model => ({ id: model.id, name: model.name ?? model.id }));
-        return computeSessionSpend(await sessionEvents(ctx, sessionId), billing, catalog);
-    };
-    const fetchTodaySpend = async () => {
-        const billing = resolveBilling(config.billing);
-        const catalog = (config.models ?? DEFAULT_MODELS).map(model => ({ id: model.id, name: model.name ?? model.id }));
-        return computeTodaySpend(await allSessionEvents(ctx), billing, catalog);
-    };
-    new DeepSeekBalanceGateway(ctx, { fetchBalance, fetchSessionSpend, fetchTodaySpend });
-}
-//# sourceMappingURL=index.js.map

package/lib/types/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@rayadesu/dsh-llm-billing`.
- * @module @rayadesu/dsh-llm-billing/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "llm-billing-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map

package/lib/types/types/invariant.js

@@ -1,22 +0,0 @@
-/**
- * Package-owned invariant companion for `@rayadesu/dsh-llm-billing`.
- * @module @rayadesu/dsh-llm-billing/invariant
- */
-const PACKAGE_NAME = '@rayadesu/dsh-llm-billing';
-/** Cordis companion plugin name. */
-export const name = 'llm-billing-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * No runtime invariant: this package is a read-only Remote projection over the
- * provider balance and session logs, and owns no cross-plugin mutable state.
- */
-const install = () => { };
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-/* jscpd:ignore-end */
-//# sourceMappingURL=invariant.js.map

package/lib/types/types/types.d.ts

@@ -1,63 +0,0 @@
-/**
- * Client-safe balance and spend vocabulary shared by the `billing` Remote,
- * its generated artifacts, and the web UI.
- * @module @rayadesu/dsh-llm-billing/types
- */
-/** One currency line of the account balance returned by `GET /user/balance`. */
-export interface DeepSeekBalanceLine {
-    /** Currency code, e.g. `CNY` or `USD`. */
-    currency: string;
-    /** Total available balance (granted plus topped up). */
-    total: string;
-    /** Non-expired granted (free) balance. */
-    granted: string;
-    /** Topped-up (paid) balance. */
-    toppedUp: string;
-}
-/** DeepSeek account balance returned by `GET /user/balance`. */
-export interface DeepSeekBalance {
-    /** Whether the account has any balance available for API calls. */
-    isAvailable: boolean;
-    /** Balance lines, one per currency; empty when the provider reports none. */
-    lines: readonly DeepSeekBalanceLine[];
-}
-/** One model's billed spend within one session, priced by the peak/off-peak table. */
-export interface DeepSeekSessionSpendModel {
-    /** Wire model id, e.g. `deepseek-v4-flash`. */
-    model: string;
-    /** Selector label, e.g. `DeepSeek-V4-Flash`. */
-    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;
-}
-/** The billed spend of one session, priced per event by its Beijing-time peak/off-peak hour. */
-export interface DeepSeekSessionSpend {
-    /** Total billed cost in CNY across every priced model. */
-    total: number;
-    /** One row per model that reported usage AND has a pricing row; empty when the session has no priced usage. */
-    models: readonly DeepSeekSessionSpendModel[];
-}
-/** The billed spend of every session on one Beijing-time calendar day, priced per event by its peak/off-peak hour. */
-export interface DeepSeekTodaySpend {
-    /** Total billed cost in CNY across every priced model and every session. */
-    total: number;
-    /** One row per model that reported usage AND has a pricing row; empty when today has no priced usage. */
-    models: readonly DeepSeekSessionSpendModel[];
-}
-//# sourceMappingURL=types.d.ts.map

package/lib/types/types/types.js

@@ -1,7 +0,0 @@
-/**
- * Client-safe balance and spend vocabulary shared by the `billing` Remote,
- * its generated artifacts, and the web UI.
- * @module @rayadesu/dsh-llm-billing/types
- */
-export {};
-//# sourceMappingURL=types.js.map