@goodandready/dsh-cost-meter 0.8.20 → 0.8.22

package/lib/analytics.js

@@ -0,0 +1,93 @@
+// dsh-cost-meter — burn rate calculation and cost projection.
+
+/**
+ * Calculates burn rate ($/hour) and projected total session cost ($)
+ * from recorded turns and current session cost.
+ *
+ * @param {Array<{ turn: number, step?: number, tokens: number, costDeltaUsd?: number, timestamp: number }>} turns
+ * @param {number} totalCostUsd Current total cost of session in USD
+ * @param {object} [options]
+ * @param {number} [options.now] Current timestamp (ms)
+ * @param {number} [options.windowMs] Recent window (default 10 mins = 600,000ms)
+ * @returns {{ burnRatePerHourUsd: number, projectedCostUsd: number, confidence: 'low' | 'medium' | 'high' }}
+ */
+export function calculateBurnRateAndProjection(turns, totalCostUsd, options = {}) {
+  const currentTotal = Number(totalCostUsd) > 0 ? Number(totalCostUsd) : 0
+  if (!Array.isArray(turns) || turns.length < 2) {
+    return {
+      burnRatePerHourUsd: 0,
+      projectedCostUsd: currentTotal,
+      confidence: 'low',
+    }
+  }
+
+  const now = typeof options.now === 'number' && Number.isFinite(options.now) ? options.now : Date.now()
+  const windowMs = typeof options.windowMs === 'number' && options.windowMs > 0 ? options.windowMs : 10 * 60 * 1000
+
+  // Filter or take recent turns
+  const sorted = turns
+    .filter((t) => t && typeof t.timestamp === 'number' && Number.isFinite(t.timestamp))
+    .sort((a, b) => a.timestamp - b.timestamp)
+
+  if (sorted.length < 2) {
+    return {
+      burnRatePerHourUsd: 0,
+      projectedCostUsd: currentTotal,
+      confidence: 'low',
+    }
+  }
+
+  // Pick turns in window or last N turns
+  let sample = sorted.filter((t) => t.timestamp >= now - windowMs)
+  if (sample.length < 2) {
+    sample = sorted.slice(-Math.min(sorted.length, 10))
+  }
+
+  const firstTime = sample[0].timestamp
+  const lastTime = sample[sample.length - 1].timestamp
+  const durationMs = lastTime - firstTime
+
+  // Guard against near-zero time duration (< 5 seconds) to avoid division by zero
+  if (durationMs < 5000) {
+    return {
+      burnRatePerHourUsd: 0,
+      projectedCostUsd: currentTotal,
+      confidence: 'low',
+    }
+  }
+
+  // Cost incurred in sample window
+  let costInSample = sample.reduce((acc, t) => acc + (Number(t.costDeltaUsd) || 0), 0)
+  // If individual turns don't have costDeltaUsd, proportion cost by tokens
+  if (costInSample <= 0 && currentTotal > 0) {
+    const totalTokens = sorted.reduce((acc, t) => acc + (Number(t.tokens) || 0), 0)
+    const sampleTokens = sample.reduce((acc, t) => acc + (Number(t.tokens) || 0), 0)
+    costInSample = totalTokens > 0 ? (sampleTokens / totalTokens) * currentTotal : currentTotal
+  }
+
+  const hours = durationMs / (1000 * 60 * 60)
+  let rawBurnRate = hours > 0 ? (costInSample / hours) : 0
+
+  // Sanitize burn rate
+  if (!Number.isFinite(rawBurnRate) || rawBurnRate < 0) rawBurnRate = 0
+  const burnRatePerHourUsd = Math.round(rawBurnRate * 10000) / 10000
+
+  // Project final cost based on trend and remaining steps
+  const stepCount = sorted.length
+  const avgCostPerStep = currentTotal / stepCount
+
+  // Estimate extra cost based on burn rate and step trend
+  const projectedExtra = Math.min(
+    currentTotal * 2, // at most 2x current cost added
+    Math.max(avgCostPerStep * 3, burnRatePerHourUsd * 0.25),
+  )
+
+  const projectedCostUsd = Math.round((currentTotal + (projectedExtra > 0 ? projectedExtra : 0)) * 10000) / 10000
+  const confidence = stepCount >= 10 ? 'high' : (stepCount >= 5 ? 'medium' : 'low')
+
+  return {
+    burnRatePerHourUsd,
+    projectedCostUsd,
+    confidence,
+  }
+}

package/lib/client.js

@@ -100,6 +100,14 @@ window.__ModuleLoader__.load({
       'tz.invalid': 'Invalid IANA time zone identifier',
       'sparkline.title': 'Turn dynamics',
       'sparkline.steps': 'steps',
+      'projection.burn_rate': 'Burn rate:',
+      'projection.projected': 'Projected:',
+      'projection.per_hour': '/hr',
+      'field.displayMode': 'Display mode',
+      'hint.displayMode': 'Widget display mode: auto (collapses on mobile <= 768px), full, or always compact.',
+      'mode.auto': 'Auto (responsive)',
+      'mode.full': 'Full',
+      'mode.compact': 'Compact pill',
     }
 
     const zh = {
@@ -180,6 +188,14 @@ window.__ModuleLoader__.load({
       'tz.invalid': '无效的 IANA 时区标识',
       'sparkline.title': '步骤动态',
       'sparkline.steps': '步',
+      'projection.burn_rate': '消耗速率：',
+      'projection.projected': '预估总计：',
+      'projection.per_hour': '/小时',
+      'field.displayMode': '显示模式',
+      'hint.displayMode': '计量器外观模式：自动（<=768px 移动端自适应折叠）、完整或始终紧凑。',
+      'mode.auto': '自动自适应',
+      'mode.full': '完整显示',
+      'mode.compact': '紧凑药丸',
     }
 
     function makeT(dict, fallback) {
@@ -269,9 +285,11 @@ window.__ModuleLoader__.load({
 .dcm-dot-idle { background: var(--dsw-alias-label-tertiary); }
 
 .dcm-chip-timer { opacity: 0.72; font-size: 11px; padding-left: 2px; border-left: 1px solid var(--dsw-alias-border-l2); }
-@media (max-width: 680px) {
+@media (max-width: 768px) {
   .dcm-chip-timer { display: none; }
+  .dcm-panel { width: min(320px, calc(100vw - 32px)); right: 0; }
 }
+.dcm-chip-compact .dcm-chip-timer { display: none !important; }
 
 @keyframes dcm-pulse { 0%, 100% { opacity: 1; transform: scale(1); } 50% { opacity: 0.4; transform: scale(0.85); } }
 
@@ -299,9 +317,13 @@ window.__ModuleLoader__.load({
 .dcm-spark-bar { fill: color-mix(in srgb, var(--dsw-alias-state-brand-primary) 45%, transparent); transition: fill .15s ease; cursor: pointer; }
 .dcm-spark-bar:hover { fill: var(--dsw-alias-state-brand-primary); }
 .dcm-spark-peak { fill: var(--dsw-alias-state-brand-primary); }
+.dcm-proj-box { margin: 6px 0; padding: 6px 10px; border-radius: 6px; background: color-mix(in srgb, var(--dsw-alias-state-brand-primary) 6%, transparent); display: flex; justify-content: space-between; align-items: center; font-size: 11px; }
+.dcm-proj-item { display: inline-flex; align-items: center; gap: 4px; }
+.dcm-proj-val { font-weight: 600; color: var(--dsw-alias-label-primary); font-variant-numeric: tabular-nums; }
 `
 
 
+
     function ensureStyles() {
       if (typeof document === 'undefined') return
       if (document.getElementById('dsh-cost-meter-unified-css')) return
@@ -630,6 +652,10 @@ window.__ModuleLoader__.load({
         setSaving(true); setErr(''); setSaved(false)
         const broken = []
 
+        try {
+          await scope.set('displayMode', (draft.displayMode === 'compact' || draft.displayMode === 'full') ? draft.displayMode : 'auto')
+        } catch (e) { broken.push('displayMode: ' + (e && e.message || String(e))) }
+
         try {
           await scope.set('currency', String(draft.currency || '$'))
         } catch (e) { broken.push('currency: ' + (e && e.message || String(e))) }
@@ -809,6 +835,19 @@ window.__ModuleLoader__.load({
                         ),
                       ),
                     ),
+                    React.createElement('div', { className: 'dcm-field', style: { marginTop: 6 } },
+                      React.createElement('label', { className: 'dcm-label' }, t('field.displayMode')),
+                      React.createElement('select', {
+                        className: 'dcm-input',
+                        value: (draft && draft.displayMode) || 'auto',
+                        onChange: (e) => setDraft({ ...draft, displayMode: e.target.value }),
+                      }, [
+                        React.createElement('option', { key: 'auto', value: 'auto' }, t('mode.auto')),
+                        React.createElement('option', { key: 'full', value: 'full' }, t('mode.full')),
+                        React.createElement('option', { key: 'compact', value: 'compact' }, t('mode.compact')),
+                      ]),
+                      React.createElement('span', { className: 'dcm-hint' }, t('hint.displayMode')),
+                    ),
                   ),
 
                   // Section 2: OpenRouter Pricing Catalog
@@ -1052,6 +1091,36 @@ window.__ModuleLoader__.load({
     }
 
 
+    
+    function calculateBurnRateAndProjection(turns, totalCostUsd, options = {}) {
+      const currentTotal = Number(totalCostUsd) > 0 ? Number(totalCostUsd) : 0
+      if (!Array.isArray(turns) || turns.length < 2) {
+        return { burnRatePerHourUsd: 0, projectedCostUsd: currentTotal, confidence: 'low' }
+      }
+      const now = typeof options.now === 'number' ? options.now : Date.now()
+      const windowMs = 10 * 60 * 1000
+      const sorted = turns.filter((t) => t && typeof t.timestamp === 'number').sort((a, b) => a.timestamp - b.timestamp)
+      if (sorted.length < 2) return { burnRatePerHourUsd: 0, projectedCostUsd: currentTotal, confidence: 'low' }
+      let sample = sorted.filter((t) => t.timestamp >= now - windowMs)
+      if (sample.length < 2) sample = sorted.slice(-Math.min(sorted.length, 10))
+      const durationMs = sample[sample.length - 1].timestamp - sample[0].timestamp
+      if (durationMs < 5000) return { burnRatePerHourUsd: 0, projectedCostUsd: currentTotal, confidence: 'low' }
+      let costInSample = sample.reduce((acc, t) => acc + (Number(t.costDeltaUsd) || 0), 0)
+      if (costInSample <= 0 && currentTotal > 0) {
+        const totalTokens = sorted.reduce((acc, t) => acc + (Number(t.tokens) || 0), 0)
+        const sampleTokens = sample.reduce((acc, t) => acc + (Number(t.tokens) || 0), 0)
+        costInSample = totalTokens > 0 ? (sampleTokens / totalTokens) * currentTotal : currentTotal
+      }
+      const hours = durationMs / (1000 * 60 * 60)
+      const rawBurnRate = hours > 0 ? (costInSample / hours) : 0
+      const burnRatePerHourUsd = (Number.isFinite(rawBurnRate) && rawBurnRate >= 0) ? Math.round(rawBurnRate * 10000) / 10000 : 0
+      const stepCount = sorted.length
+      const avgCostPerStep = currentTotal / stepCount
+      const projectedExtra = Math.min(currentTotal * 2, Math.max(avgCostPerStep * 3, burnRatePerHourUsd * 0.25))
+      const projectedCostUsd = Math.round((currentTotal + (projectedExtra > 0 ? projectedExtra : 0)) * 10000) / 10000
+      return { burnRatePerHourUsd, projectedCostUsd }
+    }
+
     function renderSparkline(turns, options) {
       if (!Array.isArray(turns) || turns.length === 0) return null
       const { h, currency, fx, activeRate, t } = options
@@ -1185,6 +1254,7 @@ window.__ModuleLoader__.load({
       const currency = stored.currency !== undefined ? String(stored.currency) : (state.currency || '$')
       const fx = stored.usdRate !== undefined && !isNaN(Number(stored.usdRate)) ? Number(stored.usdRate) : (Number(state.usdRate) || 1)
       const budgetThreshold = stored.budgetThreshold !== undefined ? Number(stored.budgetThreshold) : (Number(state.budgetThreshold) || 0)
+      const displayMode = stored.displayMode !== undefined ? stored.displayMode : (state.displayMode || 'auto')
       const schedule = state.schedule
       const hasUsage = usage !== undefined && usage !== null
       const minute = now.getUTCHours() * 60 + now.getUTCMinutes()
@@ -1193,7 +1263,7 @@ window.__ModuleLoader__.load({
         return h('div', { ref: box, style: { position: 'relative' } }, [
           h('button', {
             key: 'chip', type: 'button',
-            className: 'dcm-chip',
+            className: 'dcm-chip' + (displayMode === 'compact' ? ' dcm-chip-compact' : ''),
             onClick: () => setOpen((v) => !v), title: t('chipUnknown'),
           }, [
             h('span', { key: 'dot', className: 'dcm-dot dcm-dot-idle' }),
@@ -1362,7 +1432,7 @@ window.__ModuleLoader__.load({
       return h('div', { ref: box, style: { position: 'relative' } }, [
         h('button', {
           key: 'chip', type: 'button',
-          className: 'dcm-chip',
+          className: 'dcm-chip' + (displayMode === 'compact' ? ' dcm-chip-compact' : ''),
           onClick: () => setOpen((v) => !v),
           title: (budgetExceeded
             ? t('budget.exceeded', { limit: money(budgetThreshold * fx, currency) })
@@ -1599,4 +1669,4 @@ window.__ModuleLoader__.load({
     return module.exports
   },
 })
-
+

package/lib/index.js

@@ -124,6 +124,7 @@ export function normalizeConfig(raw) {
     usdRate: getFxRate(currency, u.usdRate, autoFx),
     displayTimeZone: typeof u.displayTimeZone === 'string' && u.displayTimeZone ? u.displayTimeZone : 'Europe/Moscow',
     budgetThreshold: Number(u.budgetThreshold) || 0,
+    displayMode: (u.displayMode === 'compact' || u.displayMode === 'full') ? u.displayMode : 'auto',
     useOpenRouter: u.useOpenRouter !== false,
     refreshHours: Number(u.refreshHours) || 24,
     deepseekPeakPrices: u.deepseekPeakPrices || {},
@@ -151,6 +152,7 @@ export const Config = z.object({
   usdRate: z.number().description('Units of `currency` per USD. 1 keeps everything in USD.').default(1).volatile(),
   displayTimeZone: z.string().description('IANA zone the widget shows tariff hours in.').default('Europe/Moscow').volatile(),
   budgetThreshold: z.number().description('Optional session budget threshold in USD. 0 disables threshold warnings.').default(0).volatile(),
+  displayMode: z.union(['auto', 'full', 'compact']).description('Widget display mode: auto, full, or compact.').default('auto').volatile(),
   deepseekPeakPrices: z.dict(PriceRow).description('Override the built-in DeepSeek peak rates, by model id.').default({}).volatile(),
   useOpenRouter: z.boolean().description('Pull rates and discount windows from the public OpenRouter catalog.').default(true).volatile(),
   refreshHours: z.number().description('How often to refetch the catalog.').default(24).volatile(),
@@ -296,5 +298,5 @@ export function apply(ctx, config) {
     getCatalog: () => catalog,
   })
 }
-
-
+
+

package/lib/routes.js

@@ -2,6 +2,7 @@
 import { createHash } from 'node:crypto'
 import { registerPluginUpdater } from './updater.js'
 import { getLastTurns } from './projection.js'
+import { calculateBurnRateAndProjection } from './analytics.js'
 
 export const STATE_PATH = '/dsh-cost-meter/state'
 export const REFRESH_PATH = '/dsh-cost-meter/refresh'
@@ -99,11 +100,14 @@ export function registerRoutes(ctx, options) {
             usdRate: Number(cfg?.usdRate) > 0 ? Number(cfg.usdRate) : 1,
             displayTimeZone: typeof cfg?.displayTimeZone === 'string' && cfg.displayTimeZone ? cfg.displayTimeZone : 'Europe/Moscow',
             budgetThreshold: Number(cfg?.budgetThreshold) || 0,
+            displayMode: cfg?.displayMode || 'auto',
             route,
             source: own.source,
             matchedId: own.matchedId,
             schedules,
             turns: getLastTurns(),
+            burnRatePerHourUsd: calculateBurnRateAndProjection(getLastTurns(), 0).burnRatePerHourUsd,
+            projectedCostUsd: calculateBurnRateAndProjection(getLastTurns(), 0).projectedCostUsd,
             fetchedAt: catalog.fetchedAt || null,
             catalogError: catalog.error,
             catalogModelsCount: Object.keys((catalog.index && catalog.index.byId) || {}).length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-cost-meter",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "description": "DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.",
   "type": "module",
   "main": "lib/index.js",