@rayadesu/dsh-billing 0.1.0-rc.8

package/packages/llm-billing/lib/types/types/billing.js

@@ -0,0 +1,170 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/billing.ts"],"names":[],"mappings":"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"}

package/packages/llm-billing/lib/types/types/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAcxC,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,cAAc,CAAA;AAGrE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjG,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,EACN,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAA;AACrB,mBAAmB,YAAY,CAAA;AAE/B,eAAO,MAAM,IAAI,gBAAgB,CAAA;AAIjC,kFAAkF;AAClF,eAAO,MAAM,eAAe,6BAA6B,CAAA;AAEzD,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAQD;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2GAA2G;IAC3G,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,iFAAiF;IACjF,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAyBD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAK3B,CAAA;AA4DF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAyCxD"}

package/packages/llm-billing/lib/types/types/index.js

@@ -0,0 +1,156 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/packages/llm-billing/lib/types/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,0BAA0B,CAAA;AAC3C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AAQpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/packages/llm-billing/lib/types/types/invariant.js

@@ -0,0 +1,22 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,6BAA6B,CAAA;AAElD,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,CAAA;AAC3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;GAGG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/packages/llm-billing/lib/types/types/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 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/packages/llm-billing/lib/types/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAA;IACpB,6EAA6E;IAC7E,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACtC;AAED,sFAAsF;AACtF,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,2FAA2F;IAC3F,oBAAoB,EAAE,MAAM,CAAA;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAA;IACzB,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,+GAA+G;IAC/G,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC7C;AAED,sHAAsH;AACtH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,yGAAyG;IACzG,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC7C"}

package/packages/llm-billing/lib/types/types/types.js

@@ -0,0 +1,7 @@
+/**
+ * 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

package/packages/llm-billing/lib/types/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/llm-billing/lib/types/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 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/packages/llm-billing/lib/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAA;IACpB,6EAA6E;IAC7E,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACtC;AAED,sFAAsF;AACtF,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,2FAA2F;IAC3F,oBAAoB,EAAE,MAAM,CAAA;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAA;IACzB,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,+GAA+G;IAC/G,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC7C;AAED,sHAAsH;AACtH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,yGAAyG;IACzG,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC7C"}

package/packages/llm-billing/lib/types/types.js

@@ -0,0 +1,7 @@
+/**
+ * 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

package/packages/llm-billing/lib/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}