@goodandready/dsh-cost-meter 0.8.20 → 0.8.21

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,9 @@ 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',
     }
 
     const zh = {
@@ -180,6 +183,9 @@ window.__ModuleLoader__.load({
       'tz.invalid': '无效的 IANA 时区标识',
       'sparkline.title': '步骤动态',
       'sparkline.steps': '步',
+      'projection.burn_rate': '消耗速率：',
+      'projection.projected': '预估总计：',
+      'projection.per_hour': '/小时',
     }
 
     function makeT(dict, fallback) {
@@ -299,9 +305,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
@@ -1052,6 +1062,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

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'
@@ -104,6 +105,8 @@ export function registerRoutes(ctx, options) {
             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.21",
   "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",