@gamegeek-saikel/dsh-cost-meter 0.1.0

package/lib/types/client/SessionCostPill.js

@@ -0,0 +1,123 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Session header pill (right-aligned utility): the conversation's anchored
+ * total cost, or — while the assistant is replying — a live estimate of the
+ * TOTAL once the running reply settles (`预计 ¥x.xx（进行中）`): the already
+ * anchored ledger total plus the running reply's estimated input/output.
+ * Clicking the pill toggles a detail panel: totals by category, model, and
+ * the anchored price snapshot; the panel dismisses on outside clicks or
+ * Escape.
+ *
+ * The estimate is explicitly labeled 估算/estimate: input is priced at the
+ * projected context size weighted by the newest completed step's cache
+ * ratio (conservative all-uncached without history), output at the
+ * character heuristic — both at CURRENT snapshot prices.
+ */
+import { memo, useEffect, useMemo, useRef, useState } from 'react';
+import { bandForTime, blocksOutputTokens, bucketAt, cacheReadRatioOf, combineTotals, estimateCost, peakOffPeakMultiplier, subagentSpend } from "./cost-math.js";
+import { currencySymbol, displayCurrency, formatMoney, formatMultiplier, formatTime } from "./format.js";
+import { ENDPOINT, REFRESH_MS } from "./SessionCostLine.js";
+import css from './SessionCostPill.module.css';
+/** Read the conversation's running flag (the pill's estimate gate). */
+function runningOf(snapshot) {
+    return snapshot.running;
+}
+/** Close the popover on outside clicks or Escape (product detail-panel posture). */
+function useDismissOutside(open, onDismiss, anchor) {
+    useEffect(() => {
+        if (!open)
+            return;
+        const onPointerDown = (event) => {
+            const target = event.target;
+            if (anchor.current !== null && target !== null && !anchor.current.contains(target))
+                onDismiss();
+        };
+        const onKeyDown = (event) => {
+            if (event.key === 'Escape')
+                onDismiss();
+        };
+        document.addEventListener('mousedown', onPointerDown);
+        document.addEventListener('touchstart', onPointerDown);
+        document.addEventListener('keydown', onKeyDown);
+        return () => {
+            document.removeEventListener('mousedown', onPointerDown);
+            document.removeEventListener('touchstart', onPointerDown);
+            document.removeEventListener('keydown', onKeyDown);
+        };
+    }, [open, onDismiss, anchor]);
+}
+export const SessionCostPill = memo(function SessionCostPill({ useSession, useProjection, sessionId, t }) {
+    const currency = displayCurrency(t);
+    const projectionKey = currency === 'USD' ? 'sessionCostUsd' : 'sessionCost';
+    const cost = useProjection(projectionKey);
+    const pressure = useProjection('contextPressure');
+    const running = useSession(runningOf);
+    const partial = useSession(snapshot => snapshot.partial);
+    const [open, setOpen] = useState(false);
+    const [response, setResponse] = useState(null);
+    const wrapRef = useRef(null);
+    useDismissOutside(open, () => setOpen(false), wrapRef);
+    useEffect(() => {
+        let alive = true;
+        let timer;
+        const endpoint = `${ENDPOINT}?session=${encodeURIComponent(sessionId)}&currency=${currency}`;
+        const load = () => {
+            void fetch(endpoint, { cache: 'no-store' })
+                .then(res => (res.ok ? res.json() : null))
+                .then((data) => {
+                if (!alive || data === null)
+                    return;
+                setResponse(data);
+            })
+                .catch(() => { });
+        };
+        load();
+        timer = window.setInterval(load, REFRESH_MS);
+        return () => {
+            alive = false;
+            if (timer !== undefined)
+                window.clearInterval(timer);
+        };
+    }, [sessionId, currency]);
+    const projection = cost;
+    const model = projection?.model ?? null;
+    const snapshot = response?.pricebook.current ?? null;
+    const subagents = response?.subagents;
+    const combined = combineTotals(projection?.totals, subagents);
+    const subSpend = subagentSpend(subagents);
+    const symbol = currencySymbol(currency);
+    // The estimate projects the TOTAL once the running reply settles: the
+    // already-anchored ledger total (main + subagents) plus this reply's
+    // estimated input/output (subagent replies cannot be projected live).
+    const estimate = useMemo(() => {
+        if (!running || projection === undefined)
+            return null;
+        const bucket = bucketAt(snapshot ?? undefined, model?.provider, model?.model ?? 'unknown', Date.now());
+        if (bucket === undefined)
+            return null;
+        const inputTokens = pressure?.projectedTokens ?? pressure?.pressureTokens ?? 0;
+        const cachedRatio = cacheReadRatioOf(projection.steps);
+        const outputTokens = blocksOutputTokens(partial?.blocks);
+        const stepEstimate = estimateCost(bucket, inputTokens, cachedRatio, outputTokens);
+        return (combined?.cost ?? 0) + stepEstimate;
+    }, [running, projection, combined, snapshot, model, pressure, partial, currency]);
+    if (projection === undefined && estimate === null)
+        return null;
+    const total = combined?.cost ?? 0;
+    const label = estimate !== null
+        ? t('pill.estimate', { amount: `${symbol}${formatMoney(estimate)}` })
+        : t('pill.label', { amount: `${symbol}${formatMoney(total)}` });
+    const last = projection?.steps.length !== undefined && projection.steps.length > 0
+        ? projection.steps[projection.steps.length - 1]
+        : undefined;
+    const sourceKey = snapshot?.source ?? null;
+    const source = sourceKey === null ? t('source.none') : t(`source.${sourceKey}`);
+    const band = bandForTime(Date.now());
+    const peakRatio = peakOffPeakMultiplier(snapshot ?? undefined, model?.provider, model?.model ?? 'unknown');
+    const bandLabel = band === 'peak'
+        ? peakRatio === null ? t('band.peak') : t('price.peakRatio', { multiplier: formatMultiplier(peakRatio) })
+        : band === 'offPeak'
+            ? peakRatio === null ? t('band.offPeak') : t('price.offPeakRatio', { multiplier: formatMultiplier(1 / peakRatio) })
+            : null;
+    return (_jsxs("div", { className: css.wrap, ref: wrapRef, children: [_jsxs("button", { type: "button", className: css.pill, "data-testid": "cost-pill", "data-running": estimate !== null, "data-band": band === 'single' ? undefined : band, onClick: () => setOpen(prev => !prev), "aria-expanded": open, children: [label, bandLabel !== null && _jsx("span", { className: css.bandBadge, "data-testid": "cost-pill-band", children: bandLabel }), estimate !== null && _jsxs("span", { className: css.estimateNote, children: ["\u00B7 ", t('pill.estimateNote')] })] }), open && (_jsxs("div", { className: css.detail, "data-testid": "cost-pill-detail", children: [_jsx("div", { className: css.detailRow + ' ' + css.detailTotal, children: t('pill.detail.total', { amount: `${symbol}${formatMoney(total)}` }) }), bandLabel !== null && (_jsx("div", { className: css.detailRow + ' ' + css.detailRowSecondary, "data-testid": "cost-pill-detail-band", children: bandLabel })), combined !== undefined && combined.pricedSteps > 0 && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.detailRow + ' ' + css.detailRowSecondary, children: [t('view.uncached'), ": ", symbol, formatMoney(combined.uncachedCost)] }), _jsxs("div", { className: css.detailRow + ' ' + css.detailRowSecondary, children: [t('view.cacheRead'), ": ", symbol, formatMoney(combined.cacheReadCost)] }), _jsxs("div", { className: css.detailRow + ' ' + css.detailRowSecondary, children: [t('view.output'), ": ", symbol, formatMoney(combined.outputCost)] })] })), subSpend > 0 && (_jsx("div", { className: css.detailRow + ' ' + css.detailRowMuted, children: t('line.subagent', { amount: `${symbol}${formatMoney(subSpend)}` }) })), model !== null && (_jsx("div", { className: css.detailRow + ' ' + css.detailRowSecondary, children: t('pill.detail.model', { model: model.model }) })), last !== undefined && last.snapshotVersion !== null && (_jsxs("div", { className: css.detailRow + ' ' + css.detailRowMuted, children: [t('pill.detail.snapshot', { time: formatTime(last.snapshotEffectiveAt ?? last.time) }), last.band !== null && ` · ${t(`band.${last.band}`)}`] })), _jsx("div", { className: css.detailRow + ' ' + css.detailRowMuted, children: t('pill.detail.source', { source }) }), projection !== undefined && projection.totals.unpricedSteps > 0 && (_jsx("div", { className: css.detailRow + ' ' + css.detailRowMuted, children: t('view.unpriced', { count: String(projection.totals.unpricedSteps) }) })), estimate !== null && (_jsx("div", { className: css.detailRow + ' ' + css.detailRowMuted, children: t('pill.estimateNote') }))] }))] }));
+});

package/lib/types/client/cost-math.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Client-side price lookup and streaming-estimate helpers.
+ *
+ * The authoritative anchored ledger arrives through the `sessionCost`
+ * projection; this module only mirrors the host pricebook math for display
+ * and for the live estimate (which by nature uses CURRENT prices and is
+ * labeled 估算/estimate). The lookup logic intentionally mirrors
+ * `src/pricebook.ts` — keep the two in sync.
+ *
+ * @module @gamegeek-saikel/dsh-cost-meter/client/cost-math
+ */
+import type { ModelPrice, PriceBand, PriceBucket, PricebookSnapshot, SessionCostStep, SessionCostTotals, SubagentCost } from '../types.ts';
+/** Sum totals (this module's mirror of the host `sumTotals`). */
+export declare function sumTotals(totals: readonly SessionCostTotals[]): SessionCostTotals;
+/** Total spend of every subagent (CNY); 0 without subagents. */
+export declare function subagentSpend(subagents: readonly SubagentCost[] | undefined): number;
+/**
+ * The conversation-wide totals: the main session's ledger plus every
+ * subagent's ledger (host-aggregated). Undefined while the main ledger is
+ * absent; identical to the main totals without subagents.
+ * @param main - the main session's projection totals.
+ * @param subagents - the host-aggregated subagent totals.
+ * @returns the combined totals, or undefined.
+ */
+export declare function combineTotals(main: SessionCostTotals | undefined, subagents: readonly SubagentCost[] | undefined): SessionCostTotals | undefined;
+/** The price band in effect at one instant (mirror of the host helper). */
+export declare function bandForTime(time: number): PriceBand;
+/** The bucket of one model's entry for one band (mirror of the host helper). */
+export declare function bucketOf(modelPrice: ModelPrice, band: PriceBand): PriceBucket | undefined;
+/** Map a model id to its official pricing key (mirror of the host helper). */
+export declare function pricingKeyOfModel(model: string): 'pro' | 'flash';
+/** Candidate canonical price keys for one model (mirror of the host helper). */
+export declare function modelKeys(provider: string | undefined, model: string): string[];
+/** Pick the snapshot effective at `time` (newest ≤ time, else earliest). */
+export declare function snapshotAt(snapshots: readonly PricebookSnapshot[], time: number): PricebookSnapshot | undefined;
+/** Resolve one model's price entry in a snapshot through the key chain. */
+export declare function modelPriceOf(snapshot: PricebookSnapshot | null | undefined, provider: string | undefined, model: string): ModelPrice | undefined;
+/** Resolve one model's bucket at one instant from a snapshot. */
+export declare function bucketAt(snapshot: PricebookSnapshot | undefined, provider: string | undefined, model: string, time: number): PriceBucket | undefined;
+/**
+ * The peak-to-off-peak price multiplier for one model's entry, when the
+ * entry carries both bands. The multiplier is the ratio of the summed peak
+ * bucket rates to the summed off-peak bucket rates; official DeepSeek prices
+ * scale all buckets by the same factor, so this is a stable “peak is N× the
+ * off-peak price” display value.
+ * @param snapshot - the pricebook snapshot to read.
+ * @param provider - the provider route, when known.
+ * @param model - the model id.
+ * @returns the peak/off-peak multiplier, or null when either band is absent.
+ */
+export declare function peakOffPeakMultiplier(snapshot: PricebookSnapshot | null | undefined, provider: string | undefined, model: string): number | null;
+/**
+ * Heuristic character→token estimate: CJK ÷ 1.5, everything else ÷ 4
+ * (the streaming estimate's output side).
+ * @param text - the accumulated text.
+ * @returns the estimated token count.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Tokens of the streamed text/reasoning blocks of a partial assistant.
+ * @param blocks - the partial's content blocks (text/reasoning carry `text`).
+ * @returns the estimated token count.
+ */
+export declare function blocksOutputTokens(blocks: readonly {
+    kind?: string;
+    text?: string;
+}[] | undefined): number;
+/**
+ * The cache-read ratio of the newest completed step (input side of the
+ * estimate). Absent history conservatively prices all input as uncached
+ * (upper bound).
+ * @param steps - the projection's step ledger.
+ * @returns the ratio in [0, 1].
+ */
+export declare function cacheReadRatioOf(steps: readonly SessionCostStep[]): number;
+/**
+ * The live estimate of the running reply: input at the projected context
+ * size (weighted by the cache ratio) plus output at the streamed-token
+ * heuristic, both at CURRENT prices. Always labeled 估算/estimate — it is
+ * replaced by the projection's exact anchored value once the step settles.
+ * @param bucket - the current price bucket of the session model.
+ * @param inputTokens - the projected prompt size for the next request.
+ * @param cachedRatio - the cache-read ratio from recent completed steps.
+ * @param outputTokens - the streamed output tokens so far.
+ * @returns the estimated CNY cost.
+ */
+export declare function estimateCost(bucket: PriceBucket, inputTokens: number, cachedRatio: number, outputTokens: number): number;
+//# sourceMappingURL=cost-math.d.ts.map

package/lib/types/client/cost-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-math.d.ts","sourceRoot":"","sources":["../../../src/client/cost-math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,aAAa,CAAA;AAEpB,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,CAoBjF;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,GAAG,MAAM,CAGpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,GAAG,SAAS,EACnC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,GAC7C,iBAAiB,GAAG,SAAS,CAI/B;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAGnD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAIzF;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAGhE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/E;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAO/G;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,GACZ,UAAU,GAAG,SAAS,CAOxB;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAIzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAUf;AAKD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,GAAG,MAAM,CAQ1G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAO1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR"}

package/lib/types/client/cost-math.js

@@ -0,0 +1,199 @@
+/**
+ * Client-side price lookup and streaming-estimate helpers.
+ *
+ * The authoritative anchored ledger arrives through the `sessionCost`
+ * projection; this module only mirrors the host pricebook math for display
+ * and for the live estimate (which by nature uses CURRENT prices and is
+ * labeled 估算/estimate). The lookup logic intentionally mirrors
+ * `src/pricebook.ts` — keep the two in sync.
+ *
+ * @module @gamegeek-saikel/dsh-cost-meter/client/cost-math
+ */
+import { isPeakHour, PEAK_PRICING_START_MS } from "../pricing.js";
+/** Sum totals (this module's mirror of the host `sumTotals`). */
+export function sumTotals(totals) {
+    const sum = {
+        uncachedCost: 0,
+        cacheReadCost: 0,
+        outputCost: 0,
+        cost: 0,
+        pricedSteps: 0,
+        unpricedSteps: 0,
+        steps: 0,
+    };
+    for (const entry of totals) {
+        sum.uncachedCost += entry.uncachedCost;
+        sum.cacheReadCost += entry.cacheReadCost;
+        sum.outputCost += entry.outputCost;
+        sum.cost += entry.cost;
+        sum.pricedSteps += entry.pricedSteps;
+        sum.unpricedSteps += entry.unpricedSteps;
+        sum.steps += entry.steps;
+    }
+    return sum;
+}
+/** Total spend of every subagent (CNY); 0 without subagents. */
+export function subagentSpend(subagents) {
+    if (subagents === undefined || subagents.length === 0)
+        return 0;
+    return sumTotals(subagents.map(entry => entry.totals)).cost;
+}
+/**
+ * The conversation-wide totals: the main session's ledger plus every
+ * subagent's ledger (host-aggregated). Undefined while the main ledger is
+ * absent; identical to the main totals without subagents.
+ * @param main - the main session's projection totals.
+ * @param subagents - the host-aggregated subagent totals.
+ * @returns the combined totals, or undefined.
+ */
+export function combineTotals(main, subagents) {
+    if (main === undefined)
+        return undefined;
+    if (subagents === undefined || subagents.length === 0)
+        return main;
+    return sumTotals([main, ...subagents.map(entry => entry.totals)]);
+}
+/** The price band in effect at one instant (mirror of the host helper). */
+export function bandForTime(time) {
+    if (time < PEAK_PRICING_START_MS)
+        return 'single';
+    return isPeakHour(new Date(time)) ? 'peak' : 'offPeak';
+}
+/** The bucket of one model's entry for one band (mirror of the host helper). */
+export function bucketOf(modelPrice, band) {
+    if (band === 'single')
+        return modelPrice.single ?? modelPrice.offPeak ?? modelPrice.peak;
+    if (band === 'peak')
+        return modelPrice.peak ?? modelPrice.offPeak ?? modelPrice.single;
+    return modelPrice.offPeak ?? modelPrice.peak ?? modelPrice.single;
+}
+/** Map a model id to its official pricing key (mirror of the host helper). */
+export function pricingKeyOfModel(model) {
+    const lower = model.toLowerCase();
+    return lower.includes('pro') ? 'pro' : 'flash';
+}
+/** Candidate canonical price keys for one model (mirror of the host helper). */
+export function modelKeys(provider, model) {
+    const keys = [];
+    if (provider !== undefined && provider.length > 0)
+        keys.push(`${provider}/${model}`);
+    keys.push(model);
+    const lower = model.toLowerCase();
+    const deepseekish = lower.includes('deepseek')
+        || (provider !== undefined && provider.toLowerCase().includes('deepseek'));
+    if (deepseekish)
+        keys.push(pricingKeyOfModel(model));
+    return keys;
+}
+/** Pick the snapshot effective at `time` (newest ≤ time, else earliest). */
+export function snapshotAt(snapshots, time) {
+    let best;
+    for (const snapshot of snapshots) {
+        // `>=` keeps the NEWER snapshot (later in the array) on an effectiveAt tie.
+        if (snapshot.effectiveAt <= time && (best === undefined || snapshot.effectiveAt >= best.effectiveAt))
+            best = snapshot;
+    }
+    return best ?? (snapshots.length > 0 ? snapshots[0] : undefined);
+}
+/** Resolve one model's price entry in a snapshot through the key chain. */
+export function modelPriceOf(snapshot, provider, model) {
+    if (snapshot === undefined || snapshot === null)
+        return undefined;
+    for (const key of modelKeys(provider, model)) {
+        const entry = snapshot.prices[key];
+        if (entry !== undefined)
+            return entry;
+    }
+    return undefined;
+}
+/** Resolve one model's bucket at one instant from a snapshot. */
+export function bucketAt(snapshot, provider, model, time) {
+    const entry = modelPriceOf(snapshot, provider, model);
+    if (entry === undefined)
+        return undefined;
+    return bucketOf(entry, bandForTime(time));
+}
+/**
+ * The peak-to-off-peak price multiplier for one model's entry, when the
+ * entry carries both bands. The multiplier is the ratio of the summed peak
+ * bucket rates to the summed off-peak bucket rates; official DeepSeek prices
+ * scale all buckets by the same factor, so this is a stable “peak is N× the
+ * off-peak price” display value.
+ * @param snapshot - the pricebook snapshot to read.
+ * @param provider - the provider route, when known.
+ * @param model - the model id.
+ * @returns the peak/off-peak multiplier, or null when either band is absent.
+ */
+export function peakOffPeakMultiplier(snapshot, provider, model) {
+    const entry = modelPriceOf(snapshot, provider, model);
+    if (entry === undefined)
+        return null;
+    const peak = entry.peak;
+    const offPeak = entry.offPeak;
+    if (peak === undefined || offPeak === undefined)
+        return null;
+    const offPeakTotal = offPeak.cacheReadPerMillion + offPeak.inputPerMillion + offPeak.outputPerMillion;
+    if (offPeakTotal === 0)
+        return null;
+    const peakTotal = peak.cacheReadPerMillion + peak.inputPerMillion + peak.outputPerMillion;
+    return peakTotal / offPeakTotal;
+}
+/** CJK characters (the /1.5 density class). */
+const CJK_RE = /[\u3400-\u4dbf\u4e00-\u9fff]/g;
+/**
+ * Heuristic character→token estimate: CJK ÷ 1.5, everything else ÷ 4
+ * (the streaming estimate's output side).
+ * @param text - the accumulated text.
+ * @returns the estimated token count.
+ */
+export function estimateTokens(text) {
+    const cjk = (text.match(CJK_RE) ?? []).length;
+    return Math.ceil(cjk / 1.5 + (text.length - cjk) / 4);
+}
+/**
+ * Tokens of the streamed text/reasoning blocks of a partial assistant.
+ * @param blocks - the partial's content blocks (text/reasoning carry `text`).
+ * @returns the estimated token count.
+ */
+export function blocksOutputTokens(blocks) {
+    let tokens = 0;
+    for (const block of blocks ?? []) {
+        if ((block.kind === 'text' || block.kind === 'reasoning') && typeof block.text === 'string' && block.text.length > 0) {
+            tokens += estimateTokens(block.text);
+        }
+    }
+    return tokens;
+}
+/**
+ * The cache-read ratio of the newest completed step (input side of the
+ * estimate). Absent history conservatively prices all input as uncached
+ * (upper bound).
+ * @param steps - the projection's step ledger.
+ * @returns the ratio in [0, 1].
+ */
+export function cacheReadRatioOf(steps) {
+    for (let i = steps.length - 1; i >= 0; i -= 1) {
+        const step = steps[i];
+        const total = step.uncachedInputTokens + step.cacheReadTokens + step.cacheWriteTokens;
+        if (step.priced && total > 0)
+            return step.cacheReadTokens / total;
+    }
+    return 0;
+}
+/**
+ * The live estimate of the running reply: input at the projected context
+ * size (weighted by the cache ratio) plus output at the streamed-token
+ * heuristic, both at CURRENT prices. Always labeled 估算/estimate — it is
+ * replaced by the projection's exact anchored value once the step settles.
+ * @param bucket - the current price bucket of the session model.
+ * @param inputTokens - the projected prompt size for the next request.
+ * @param cachedRatio - the cache-read ratio from recent completed steps.
+ * @param outputTokens - the streamed output tokens so far.
+ * @returns the estimated CNY cost.
+ */
+export function estimateCost(bucket, inputTokens, cachedRatio, outputTokens) {
+    const inputCost = inputTokens / 1_000_000
+        * (bucket.cacheReadPerMillion * cachedRatio + bucket.inputPerMillion * (1 - cachedRatio));
+    const outputCost = outputTokens / 1_000_000 * bucket.outputPerMillion;
+    return inputCost + outputCost;
+}

package/lib/types/client/format.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared display formatting for amounts and timestamps.
+ *
+ * @module @gamegeek-saikel/dsh-cost-meter/client/format
+ */
+/**
+ * Common currency symbols; unknown currencies render as a bare code.
+ * @param currency - ISO 4217 code.
+ * @returns the display symbol.
+ */
+export declare function currencySymbol(currency: string): string;
+/** Detect the display currency from the active locale dictionary. */
+export declare function displayCurrency(t: (key: string, params?: Record<string, string>) => string): 'CNY' | 'USD';
+/**
+ * Compact money: two decimals above 1, four down to 0.01, six below.
+ * Costs are CNY 元 with 4-decimal display precision; zero renders as 0.00.
+ * @param value - the amount.
+ * @returns the fixed-width display string.
+ */
+export declare function formatMoney(value: number): string;
+/** Time formatting for snapshot stamps and step rows. */
+export declare function formatTime(epochMs: number): string;
+/**
+ * Compact price multiplier, e.g. `2.0×` or `0.5×`.
+ * @param multiplier - the ratio to display.
+ * @returns the fixed one-decimal multiplier string.
+ */
+export declare function formatMultiplier(multiplier: number): string;
+/**
+ * Compact percentage, e.g. `50%`.
+ * @param fraction - the ratio in [0, 1].
+ * @returns the whole-percent string.
+ */
+export declare function formatPercent(fraction: number): string;
+//# sourceMappingURL=format.d.ts.map

package/lib/types/client/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/client/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,CAE1G;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AACD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/lib/types/client/format.js

@@ -0,0 +1,61 @@
+/**
+ * Shared display formatting for amounts and timestamps.
+ *
+ * @module @gamegeek-saikel/dsh-cost-meter/client/format
+ */
+/**
+ * Common currency symbols; unknown currencies render as a bare code.
+ * @param currency - ISO 4217 code.
+ * @returns the display symbol.
+ */
+export function currencySymbol(currency) {
+    switch (currency) {
+        case 'CNY':
+            return '¥';
+        case 'USD':
+            return '$';
+        case 'EUR':
+            return '€';
+        default:
+            return `${currency} `;
+    }
+}
+/** Detect the display currency from the active locale dictionary. */
+export function displayCurrency(t) {
+    return t('view.cost') === 'Cost' ? 'USD' : 'CNY';
+}
+/**
+ * Compact money: two decimals above 1, four down to 0.01, six below.
+ * Costs are CNY 元 with 4-decimal display precision; zero renders as 0.00.
+ * @param value - the amount.
+ * @returns the fixed-width display string.
+ */
+export function formatMoney(value) {
+    if (value === 0)
+        return '0.00';
+    if (value >= 1)
+        return value.toFixed(2);
+    if (value >= 0.01)
+        return value.toFixed(4);
+    return value.toFixed(6);
+}
+/** Time formatting for snapshot stamps and step rows. */
+export function formatTime(epochMs) {
+    return new Date(epochMs).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' });
+}
+/**
+ * Compact price multiplier, e.g. `2.0×` or `0.5×`.
+ * @param multiplier - the ratio to display.
+ * @returns the fixed one-decimal multiplier string.
+ */
+export function formatMultiplier(multiplier) {
+    return `${multiplier.toFixed(1)}×`;
+}
+/**
+ * Compact percentage, e.g. `50%`.
+ * @param fraction - the ratio in [0, 1].
+ * @returns the whole-percent string.
+ */
+export function formatPercent(fraction) {
+    return `${Math.round(fraction * 100)}%`;
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Cost-meter plugin, browser half: contributes the cost surfaces —
+ * the composer-dock readout (anchored session spend + account balance), the
+ * Cost view tab, the per-reply cost chip, the header pill with the live
+ * streaming estimate, and the plugin configuration card (设置 → 插件). The
+ * anchored ledger arrives through the `sessionCost` projection; the balance
+ * and the pricebook arrive over the trust-fenced host `/cost-meter`
+ * route; the editable configuration binds the `cost-meter` settings
+ * namespace through the standard settings scope.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type ConversationCostKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Cost meter and account balance copy. */
+        'cost-meter': ConversationCostKey;
+    }
+}
+/** The settings namespace this plugin owns (mirrors the host registration). */
+export declare const SETTINGS_NAMESPACE = "cost-meter";
+/** Required services for locale registration, slot contributions, and the settings scope. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries and the five slot entries.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAS3E,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAOnE,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,2CAA2C;QAC3C,YAAY,EAAE,mBAAmB,CAAA;KAClC;CACF;AAED,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,eAAe,CAAA;AAE9C,6FAA6F;AAC7F,eAAO,MAAM,MAAM,UAAmD,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAgE9C"}

package/lib/types/client/index.js

@@ -0,0 +1,59 @@
+import { en, NS, zh } from "./locales.js";
+import { SessionCostLine } from "./SessionCostLine.js";
+import { CostView } from "./CostView.js";
+import { AssistantCostChip } from "./AssistantCostChip.js";
+import { SessionCostPill } from "./SessionCostPill.js";
+import { CostPluginCard } from "./CostPluginCard.js";
+/** The settings namespace this plugin owns (mirrors the host registration). */
+export const SETTINGS_NAMESPACE = 'cost-meter';
+/** Required services for locale registration, slot contributions, and the settings scope. */
+export const inject = ['sessions', 'slots', 'locale', 'settingsScope'];
+/**
+ * Client plugin body: register the dictionaries and the five slot entries.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-cost-meter: dictionaries');
+    const t = ctx.locale.bind(NS);
+    const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+    // Composer-dock readout: anchored session spend + balance (after the
+    // shipped stats line, order 0).
+    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+        name: 'conversation.composer.dock',
+        id: 'cost-meter',
+        order: 1,
+        locale: NS,
+    }, SessionCostLine));
+    // Cost view tab (after trajectory at order 10).
+    ctx.slots.inject('conversation.view', () => ctx.slots.register({
+        name: 'conversation.view',
+        id: 'cost',
+        order: 20,
+        locale: NS,
+        label: () => t('view.cost'),
+    }, CostView));
+    // Per-reply cost chip (after the feedback action at order 10).
+    ctx.slots.inject('conversation.chat.assistant-actions', () => ctx.slots.register({
+        name: 'conversation.chat.assistant-actions',
+        id: 'cost',
+        order: 20,
+        locale: NS,
+    }, AssistantCostChip));
+    // Header pill: total / live estimate with the expandable detail.
+    // Negative order keeps it left of the built-in Session log utility.
+    ctx.slots.inject('conversation.session.header.utilities', () => ctx.slots.register({
+        name: 'conversation.session.header.utilities',
+        id: 'cost-meter',
+        order: -10,
+        locale: NS,
+    }, SessionCostPill));
+    // Plugin configuration card (设置 → 插件), standard plugin-card shape over
+    // the `cost-meter` settings namespace.
+    ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({
+        name: 'settings.plugin.item',
+        id: 'cost-meter',
+        order: 30,
+        locale: NS,
+        inject: () => ({ scope }),
+    }, CostPluginCard));
+}