@rayadesu/dsh-llm-billing 0.2.3 → 0.2.4

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: 471bb8364f6229ce3a6c48287fe660a92ead0281
-README.zh.md: 9346896747a389b4aaf80400b19df8e0ff12961e
+README.md: 9fc18328397e8824803ad7ed5335ee4b8a1063fe
+README.zh.md: 330b3ae531177a9b934137b4c2d1e32f949c16e0

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(force?)` (every session's billed cost on the current Beijing-time calendar day; `force` bypasses the host-side cache, for the badge's manual refresh). 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.
+The plugin registers the `billing` Remote with five methods: `getBalance()` (the parsed `/user/balance` snapshot), `getSessionSpend(sessionId)` (one session's billed cost), `getTodaySpend(force?)` (every session's billed cost on the current Beijing-time calendar day; `force` bypasses the host-side cache, for the badge's manual refresh), `getTodaySessionsSpend(force?)` (today's billed cost per session, sorted by cost descending, each row carrying the session's durable title), and `getTurnSpend(sessionId, messageId)` (one completed turn's billed cost, located by its closing assistant message id). 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. A turn is the `turn/start`..`turn/end` range holding the closing message; the ranking folds each session's title from its latest `session/title` event (last-wins, so a rename is reflected as soon as its event commits and the session is re-read).
 
 ### Today-spend read path (no full scans per message)
 

package/README.zh.md

@@ -16,7 +16,7 @@
     # baseURL: https://api.deepseek.com
 ```
 
-插件注册 `billing` Remote，含三个方法：`getBalance()`（解析后的 `/user/balance` 快照）、`getSessionSpend(sessionId)`（单个会话的计费花费）与 `getTodaySpend(force?)`（当前北京时间自然日内所有会话的计费花费合计；`force` 绕过宿主侧缓存，供徽标手动刷新使用）。会话花费把每条 `assistant/message` 事件的计费 token（缓存命中输入、含缓存写入的未命中输入、含推理的输出）按事件自身发生时刻（北京时间）所在的峰/谷单价计价——高峰窗口仅周一至周五适用，周末全天按低谷价——再按模型汇总。
+插件注册 `billing` Remote，含五个方法：`getBalance()`（解析后的 `/user/balance` 快照）、`getSessionSpend(sessionId)`（单个会话的计费花费）、`getTodaySpend(force?)`（当前北京时间自然日内所有会话的计费花费合计；`force` 绕过宿主侧缓存，供徽标手动刷新使用）、`getTodaySessionsSpend(force?)`（今日按会话的计费花费，按花费从高到低排序，每行带会话的持久标题）与 `getTurnSpend(sessionId, messageId)`（单个已完成回合的计费花费，按收尾助手消息 id 定位）。会话花费把每条 `assistant/message` 事件的计费 token（缓存命中输入、含缓存写入的未命中输入、含推理的输出）按事件自身发生时刻（北京时间）所在的峰/谷单价计价——高峰窗口仅周一至周五适用，周末全天按低谷价——再按模型汇总。一个回合即收尾消息所在的 `turn/start`..`turn/end` 区间；排行从每个会话日志里最后一条 `session/title` 事件折叠标题（last-wins，重命名事件一旦提交、会话被重新读取即反映新名字）。
 
 ### 今日花费读取路径（消息触发不再全量扫描）
 

package/lib/index.js

@@ -135,12 +135,16 @@ let DeepSeekBalanceGateway = (() => {
 	let _getBalance_decorators;
 	let _getSessionSpend_decorators;
 	let _getTodaySpend_decorators;
+	let _getTodaySessionsSpend_decorators;
+	let _getTurnSpend_decorators;
 	return class DeepSeekBalanceGateway extends _classSuper {
 		static {
 			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
 			_getBalance_decorators = [Remote("getBalance")];
 			_getSessionSpend_decorators = [Remote("getSessionSpend")];
 			_getTodaySpend_decorators = [Remote("getTodaySpend")];
+			_getTodaySessionsSpend_decorators = [Remote("getTodaySessionsSpend")];
+			_getTurnSpend_decorators = [Remote("getTurnSpend")];
 			__esDecorate(this, null, _getBalance_decorators, {
 				kind: "method",
 				name: "getBalance",
@@ -174,6 +178,28 @@ let DeepSeekBalanceGateway = (() => {
 				},
 				metadata: _metadata
 			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _getTodaySessionsSpend_decorators, {
+				kind: "method",
+				name: "getTodaySessionsSpend",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "getTodaySessionsSpend" in obj,
+					get: (obj) => obj.getTodaySessionsSpend
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _getTurnSpend_decorators, {
+				kind: "method",
+				name: "getTurnSpend",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "getTurnSpend" in obj,
+					get: (obj) => obj.getTurnSpend
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
 			if (_metadata) Object.defineProperty(this, Symbol.metadata, {
 				enumerable: true,
 				configurable: true,
@@ -218,6 +244,29 @@ let DeepSeekBalanceGateway = (() => {
 		getTodaySpend(force) {
 			return this.options.fetchTodaySpend(force ?? false);
 		}
+		/**
+		* Read today's billed spend per session, priced per event by its
+		* Beijing-time calendar day, hour, and weekday (weekends are always
+		* off-peak). Rows carry the session's durable title and sort by cost
+		* descending; sessions with no priced usage on the day are omitted.
+		* @param force - bypass the host-side 60s cache (manual refresh); omitted
+		*   means a cached read.
+		* @returns today's per-session rows, highest first.
+		*/
+		getTodaySessionsSpend(force) {
+			return this.options.fetchTodaySessionsSpend(force ?? false);
+		}
+		/**
+		* Read one completed Turn's billed spend, priced per event by its
+		* Beijing-time hour and weekday (weekends are always off-peak).
+		* @param sessionId - the session owning the Turn.
+		* @param messageId - the closing assistant message's durable id, which
+		*   locates the Turn in the session log.
+		* @returns the Turn's total cost in CNY.
+		*/
+		getTurnSpend(sessionId, messageId) {
+			return this.options.fetchTurnSpend(sessionId, messageId);
+		}
 	};
 })();
 //#endregion
@@ -527,6 +576,44 @@ function computeSessionSpend(events, billing, catalog) {
 	return priceEvents(events, billing, new Map(catalog.map((model) => [model.id, model.name])));
 }
 /**
+* Price one completed Turn's billed usage at the official per-model rates,
+* identified by its closing assistant message id. The turn's events are those
+* between its `turn/start` and `turn/end` (both matched by the message's own
+* turn coordinate); each priced event applies the peak/off-peak table by its
+* Beijing-time hour and weekday. A message that cannot be located, a turn
+* without bracketing `turn/start` / `turn/end` events (for example after
+* compaction), or a session with no priced usage prices to zero.
+* @param events - one session's complete event log.
+* @param billing - resolved pricing with peak-hour windows.
+* @param catalog - model display rows, in presentation order.
+* @param messageId - the closing assistant message's durable id.
+* @returns the turn's total cost in CNY.
+*/
+function computeTurnSpend(events, billing, catalog, messageId) {
+	const names = new Map(catalog.map((model) => [model.id, model.name]));
+	let turn;
+	for (const event of events) {
+		if (event.type !== "assistant/message") continue;
+		if (event.data.message.id !== messageId) continue;
+		turn = event.data.turn;
+		break;
+	}
+	if (turn === void 0) return { total: 0 };
+	const accumulator = new SpendAccumulator();
+	let active = false;
+	for (const event of events) {
+		if (event.type === "turn/start" && event.data.turn === turn) {
+			active = true;
+			continue;
+		}
+		if (event.type === "turn/end" && event.data.turn === turn) break;
+		if (!active) continue;
+		const priced = priceEvent(event, billing, names);
+		if (priced !== void 0) accumulator.add(priced);
+	}
+	return { total: accumulator.finish().total };
+}
+/**
 * Price every event whose Beijing-time calendar day is the day of `now`,
 * aggregating across every session's event log. Events from other Beijing
 * days are ignored, so a caller passes the concatenated logs of all sessions.
@@ -653,6 +740,23 @@ function foldBillingUnit(unit, events) {
 * @module @rayadesu/dsh-llm-billing/today-spend
 */
 /**
+* Fold one session's durable display title: the latest `session/title`
+* event's text (last-wins, matching the `title` projection), or `null` before
+* the first title lands. The fold runs over the complete log, so an explicit
+* user rename is picked up as soon as its event commits.
+* @param events - one session's complete event log.
+* @returns the session's current title, or `null` when untitled.
+*/
+function foldSessionTitle(events) {
+	for (let index = events.length - 1; index >= 0; index--) {
+		const event = events[index];
+		if (event.type !== "session/title") continue;
+		const data = event.data;
+		return typeof data.title === "string" ? data.title : null;
+	}
+	return null;
+}
+/**
 * Bounded parallel fan-out: run `run` over `items` with at most `limit` in
 * flight. A shared index counter hands each worker its next job, so the
 * dispatch is O(n) overall (array `shift()` would be O(n) per pop).
@@ -672,6 +776,8 @@ async function withConcurrency(items, limit, run) {
 * coalesces concurrent misses, and a `force` bypass for the manual refresh
 * path. Cross-day invalidation is automatic (the day key changes); a failed
 * scan leaves the previous value in place and retries on the next call.
+* @typeParam T - the cached aggregate's value shape (the spend or its
+*   per-session breakdown).
 */
 var TodaySpendCache = class {
 	scan;
@@ -682,9 +788,9 @@ var TodaySpendCache = class {
 	cachedAt = 0;
 	inFlight;
 	/**
+	* @param scan - the aggregate computation behind a miss.
 	* @param ttlMs - time window in milliseconds (default 60 000).
 	* @param now - clock source (injectable for tests).
-	* @param scan - the aggregate computation behind a miss.
 	*/
 	constructor(scan, ttlMs = 6e4, now = () => /* @__PURE__ */ new Date()) {
 		this.scan = scan;
@@ -725,7 +831,7 @@ var TodaySpendCache = class {
 */
 var TodaySpendScanner = class {
 	deps;
-	/** Cold sessions resolved on the projection path: id → revision + unit state. */
+	/** Cold sessions resolved on the projection path: id → revision + unit state + title. */
 	coldResolved = /* @__PURE__ */ new Map();
 	/** Cold sessions resolved on the events path: id → revision (events were collected). */
 	lastEventsScan;
@@ -742,11 +848,56 @@ var TodaySpendScanner = class {
 		this.deps.ensureUnit?.();
 		return this.scanProjections(dayKey);
 	}
+	/**
+	* Compute today's per-session spend for one Beijing day, sorted by cost
+	* descending. Sessions with no priced usage on the day are omitted; each
+	* row carries the session's durable title folded from its log.
+	* @param dayKey - the Beijing-time calendar-day key to aggregate.
+	* @returns today's per-session rows, highest first.
+	*/
+	async scanSessions(dayKey) {
+		const rows = this.deps.projections?.() === void 0 ? await this.scanSessionsEvents(dayKey) : await this.scanSessionsProjections(dayKey);
+		rows.sort((left, right) => right.total - left.total);
+		return { sessions: rows };
+	}
+	/**
+	* Resolve one cold session's billing unit state and display title through
+	* the projection-cache ladder (cached row first, then a detached local
+	* fold over a full inspect). A cache-served value carries no title (the
+	* ladder only stores projection values), so such rows report `title: null`
+	* until the session is inspected again.
+	* @param id - the cold session's id.
+	* @returns the resolved state and title, or `undefined` when unreadable.
+	*/
+	async resolveCold(id) {
+		const { persistence, projectionCache, unit, logger } = this.deps;
+		const cache = projectionCache?.();
+		if (cache !== void 0) try {
+			const value = (await cache.coldSnapshot(id)).values[BILLING_UNIT_KEY];
+			if (value !== void 0) return {
+				value,
+				title: null
+			};
+		} catch (error) {
+			logger.warn(`llm-billing: projection cold read for session ${id} failed: ${String(error)}`);
+		}
+		const persistenceService = persistence?.();
+		if (persistenceService === void 0) return void 0;
+		try {
+			const inspection = await persistenceService.inspect(id);
+			return {
+				value: foldBillingUnit(unit, inspection.events),
+				title: foldSessionTitle(inspection.events)
+			};
+		} catch (error) {
+			logger.warn(`llm-billing: skipping unreadable session ${id}: ${String(error)}`);
+			return;
+		}
+	}
 	/** Projection path: eager cells for live sessions, revision-gated cold ladder for the rest. */
 	async scanProjections(dayKey) {
-		const { sessions, persistence, projections, projectionCache, unit, logger } = this.deps;
+		const { sessions, persistence, projections } = this.deps;
 		const projectionsService = projections?.();
-		const cache = projectionCache?.();
 		let total = emptyTodaySpend();
 		const liveIds = /* @__PURE__ */ new Set();
 		if (sessions !== void 0) {
@@ -774,21 +925,10 @@ var TodaySpendScanner = class {
 			});
 		}
 		await withConcurrency(pending, 8, async ({ id, revision }) => {
-			let value;
-			if (cache !== void 0) try {
-				value = (await cache.coldSnapshot(id)).values[BILLING_UNIT_KEY];
-			} catch (error) {
-				logger.warn(`llm-billing: projection cold read for session ${id} failed: ${String(error)}`);
-			}
-			if (value === void 0) try {
-				const inspection = await persistenceService.inspect(id);
-				value = foldBillingUnit(unit, inspection.events);
-			} catch (error) {
-				logger.warn(`llm-billing: skipping unreadable session ${id}: ${String(error)}`);
-			}
-			if (value !== void 0) this.coldResolved.set(id, {
+			const resolved = await this.resolveCold(id);
+			if (resolved !== void 0) this.coldResolved.set(id, {
 				revision,
-				value
+				...resolved
 			});
 		});
 		for (const { id } of pending) {
@@ -846,6 +986,134 @@ var TodaySpendScanner = class {
 		if (truncated) logger.warn(`llm-billing: today's events exceeded ${maxEvents}; result truncated`);
 		return accumulator.finish();
 	}
+	/**
+	* Projection-path per-session scan: eager cells for live sessions (title
+	* folded from the live log, so a rename is reflected immediately),
+	* revision-gated cold ladder for the rest (title resolved on inspect,
+	* `null` when served from the projection cache).
+	* @param dayKey - the Beijing-time calendar-day key to aggregate.
+	* @returns unsorted per-session rows for the day.
+	*/
+	async scanSessionsProjections(dayKey) {
+		const { sessions, persistence, projections } = this.deps;
+		const projectionsService = projections?.();
+		const rows = /* @__PURE__ */ new Map();
+		const liveIds = /* @__PURE__ */ new Set();
+		if (sessions !== void 0) {
+			const store = sessions();
+			if (store !== void 0) for (const session of store.list()) {
+				liveIds.add(session.id);
+				const state = projectionsService?.stateOf(session, BILLING_UNIT_KEY);
+				if (state !== void 0 && state.dayKey === dayKey) rows.set(session.id, {
+					sessionId: session.id,
+					title: foldSessionTitle(session.events),
+					total: state.spend.total
+				});
+			}
+		}
+		const persistenceService = persistence?.();
+		if (persistenceService === void 0) return [...rows.values()];
+		const snapshots = await persistenceService.listSnapshots();
+		const pending = [];
+		for (const { header, revision } of snapshots) {
+			if (liveIds.has(header.id)) continue;
+			const resolved = this.coldResolved.get(header.id);
+			if (resolved !== void 0 && resolved.revision === revision) {
+				if (resolved.value.dayKey === dayKey) rows.set(header.id, {
+					sessionId: header.id,
+					title: resolved.title,
+					total: resolved.value.spend.total
+				});
+				continue;
+			}
+			pending.push({
+				id: header.id,
+				revision
+			});
+		}
+		await withConcurrency(pending, 8, async ({ id, revision }) => {
+			const resolved = await this.resolveCold(id);
+			if (resolved !== void 0) this.coldResolved.set(id, {
+				revision,
+				...resolved
+			});
+		});
+		for (const { id } of pending) {
+			const resolved = this.coldResolved.get(id);
+			if (resolved !== void 0 && resolved.value.dayKey === dayKey) rows.set(id, {
+				sessionId: id,
+				title: resolved.title,
+				total: resolved.value.spend.total
+			});
+		}
+		return [...rows.values()];
+	}
+	/**
+	* Events-path per-session scan: price today's events in a single pass,
+	* accumulating per session (per-event Beijing-day filter during collection,
+	* hard cap), gated by revisions. Titles fold from each session's complete
+	* log — a `session/title` event can predate today — so a rename is reflected
+	* as soon as the session's log is re-read.
+	* @param dayKey - the Beijing-time calendar-day key to aggregate.
+	* @returns unsorted per-session rows for the day.
+	*/
+	async scanSessionsEvents(dayKey) {
+		const { sessions, persistence, maxEvents, logger, billing, catalog } = this.deps;
+		const names = new Map(catalog.map((model) => [model.id, model.name]));
+		const rows = /* @__PURE__ */ new Map();
+		const liveIds = /* @__PURE__ */ new Set();
+		let collected = 0;
+		let truncated = false;
+		const collect = (id, events) => {
+			let row = rows.get(id);
+			if (row === void 0) {
+				row = {
+					title: foldSessionTitle(events),
+					total: 0
+				};
+				rows.set(id, row);
+			}
+			for (const event of events) {
+				if (beijingDayKey(new Date(event.time)) !== dayKey) continue;
+				collected += 1;
+				if (collected > maxEvents) {
+					truncated = true;
+					return;
+				}
+				const priced = priceEvent(event, billing, names);
+				if (priced !== void 0) row.total += priced.cost;
+			}
+		};
+		if (sessions !== void 0) {
+			const store = sessions();
+			if (store !== void 0) for (const session of store.list()) {
+				liveIds.add(session.id);
+				collect(session.id, session.events);
+				if (truncated) break;
+			}
+		}
+		const persistenceService = persistence?.();
+		if (!truncated && persistenceService !== void 0) {
+			const snapshots = await persistenceService.listSnapshots();
+			for (const { header, revision } of snapshots) {
+				if (liveIds.has(header.id)) continue;
+				if (this.lastEventsScan?.get(header.id) === revision) continue;
+				try {
+					collect(header.id, (await persistenceService.inspect(header.id)).events);
+				} catch (error) {
+					logger.warn(`llm-billing: skipping unreadable session ${header.id}: ${String(error)}`);
+				}
+				if (truncated) break;
+			}
+			if (!truncated) this.lastEventsScan = new Map(snapshots.map((snapshot) => [snapshot.header.id, snapshot.revision]));
+		}
+		if (truncated) logger.warn(`llm-billing: today's events exceeded ${maxEvents}; result truncated`);
+		return [...rows.entries()].filter(([, row]) => row.total > 0).map(([sessionId, row]) => ({
+			sessionId,
+			title: row.title,
+			total: row.total
+		}));
+	}
 };
 //#endregion
 //#region lib/types/index.js
@@ -1011,12 +1279,19 @@ function apply(ctx, config) {
 		catalog
 	});
 	const todayCache = new TodaySpendCache((dayKey) => scanner.scan(dayKey), TODAY_SPEND_CACHE_MS);
+	const todaySessionsCache = new TodaySpendCache((dayKey) => scanner.scanSessions(dayKey), TODAY_SPEND_CACHE_MS);
 	const fetchTodaySpend = async (force = false) => todayCache.get(force);
+	const fetchTodaySessionsSpend = async (force = false) => todaySessionsCache.get(force);
+	const fetchTurnSpend = async (sessionId, messageId) => {
+		return computeTurnSpend(await sessionEvents(ctx, sessionId), billing, catalog, messageId);
+	};
 	new DeepSeekBalanceGateway(ctx, {
 		fetchBalance,
 		fetchSessionSpend,
-		fetchTodaySpend
+		fetchTodaySpend,
+		fetchTodaySessionsSpend,
+		fetchTurnSpend
 	});
 }
 //#endregion
-export { BILLING_UNIT_KEY, Config, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, DeepSeekBalanceGateway, PUBLIC_BASE_URL, SpendAccumulator, TODAY_SPEND_CACHE_MS, TODAY_SPEND_MAX_EVENTS, TodaySpendCache, TodaySpendScanner, addEventContribution, apply, beijingDayKey, billingTodaySpendDefinition, computeSessionSpend, computeTodaySpend, emptyTodaySpend, fetchDeepSeekBalance, foldBillingUnit, isPeak, mergeTodaySpend, name, parseDeepSeekBalance, priceEvent, resolveBilling };
+export { BILLING_UNIT_KEY, Config, DEFAULT_MODEL_PRICING, DEFAULT_PEAK_HOURS, DeepSeekBalanceGateway, PUBLIC_BASE_URL, SpendAccumulator, TODAY_SPEND_CACHE_MS, TODAY_SPEND_MAX_EVENTS, TodaySpendCache, TodaySpendScanner, addEventContribution, apply, beijingDayKey, billingTodaySpendDefinition, computeSessionSpend, computeTodaySpend, computeTurnSpend, emptyTodaySpend, fetchDeepSeekBalance, foldBillingUnit, foldSessionTitle, isPeak, mergeTodaySpend, name, parseDeepSeekBalance, priceEvent, resolveBilling };

package/lib/typert.host.js

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

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

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