clawculator 2.6.1 → 2.8.0

package/skills/clawculator/snapshotCard.js

@@ -0,0 +1,324 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Generate a shareable cost snapshot card.
+ * Square format — works on Twitter, Instagram, TikTok, Discord.
+ * Shows grade, cost range, setup complexity — no exact dollars or session names.
+ */
+function generateSnapshotCard(analysis, outputDir) {
+  const s = analysis.summary;
+
+  // ── Compute grade ──────────────────────────────────────
+  const criticals = s.critical || 0;
+  const highs = s.high || 0;
+  const mediums = s.medium || 0;
+  const totalFindings = criticals + highs + mediums;
+
+  let grade, gradeColor, gradeGlow, gradeEmoji;
+  if (criticals === 0 && highs === 0 && mediums === 0) {
+    grade = 'A+'; gradeColor = '#22c55e'; gradeGlow = 'rgba(34,197,94,0.3)'; gradeEmoji = '🏆';
+  } else if (criticals === 0 && highs <= 1) {
+    grade = 'A'; gradeColor = '#22c55e'; gradeGlow = 'rgba(34,197,94,0.2)'; gradeEmoji = '✅';
+  } else if (criticals <= 1 && highs <= 2) {
+    grade = 'B'; gradeColor = '#f59e0b'; gradeGlow = 'rgba(245,158,11,0.2)'; gradeEmoji = '👍';
+  } else if (criticals <= 2) {
+    grade = 'C'; gradeColor = '#f97316'; gradeGlow = 'rgba(249,115,22,0.2)'; gradeEmoji = '⚠️';
+  } else {
+    grade = 'D'; gradeColor = '#ef4444'; gradeGlow = 'rgba(239,68,68,0.2)'; gradeEmoji = '🔥';
+  }
+
+  // ── Cost range (bucketed, not exact) ───────────────────
+  const todayCost = s.todayCost || 0;
+  let costRange, costEmoji;
+  if (todayCost === 0)       { costRange = 'Free tier';     costEmoji = '🆓'; }
+  else if (todayCost < 0.50) { costRange = 'Under $0.50/day'; costEmoji = '💲'; }
+  else if (todayCost < 1)    { costRange = 'Under $1/day';  costEmoji = '💲'; }
+  else if (todayCost < 5)    { costRange = '$1–5/day';      costEmoji = '💵'; }
+  else if (todayCost < 10)   { costRange = '$5–10/day';     costEmoji = '💰'; }
+  else if (todayCost < 25)   { costRange = '$10–25/day';    costEmoji = '💰'; }
+  else if (todayCost < 50)   { costRange = '$25–50/day';    costEmoji = '🔥'; }
+  else                       { costRange = '$50+/day';      costEmoji = '🚨'; }
+
+  // ── Setup complexity from config ───────────────────────
+  const config = analysis.config || {};
+
+  const channels = [];
+  if (config.channels?.whatsapp) channels.push('WhatsApp');
+  if (config.channels?.telegram) channels.push('Telegram');
+  if (config.channels?.discord)  channels.push('Discord');
+  if (config.channels?.signal)   channels.push('Signal');
+  if (config.channels?.slack)    channels.push('Slack');
+  if (config.webchat || config.channels?.webchat) channels.push('Webchat');
+
+  const skillCount = config.skills ? Object.keys(config.skills).length : 0;
+  const cronCount = config.cron ? Object.keys(config.cron).length : 0;
+  const hookCount = config.hooks ? Object.keys(config.hooks).length : 0;
+  const agentCount = config.agents?.list ? Object.keys(config.agents.list).length : 1;
+  const sessionCount = s.sessionsAnalyzed || 0;
+
+  const modelSet = new Set();
+  for (const sess of (analysis.sessions || [])) {
+    if (sess.model || sess.modelLabel) modelSet.add(sess.modelLabel || sess.model);
+  }
+  const modelCount = modelSet.size || 1;
+
+  const totalTokens = s.totalTokensFound || 1;
+  const cacheEfficiency = Math.round((s.totalCacheRead || 0) / totalTokens * 100);
+
+  // ── Build stat pills ──────────────────────────────────
+  const pills = [];
+  if (channels.length > 0)  pills.push({ icon: '📱', label: `${channels.length} channel${channels.length>1?'s':''}` });
+  if (skillCount > 0)       pills.push({ icon: '🔧', label: `${skillCount} skill${skillCount>1?'s':''}` });
+  if (cronCount > 0)        pills.push({ icon: '⏰', label: `${cronCount} cron${cronCount>1?'s':''}` });
+  if (hookCount > 0)        pills.push({ icon: '🪝', label: `${hookCount} hook${hookCount>1?'s':''}` });
+  if (agentCount > 1)       pills.push({ icon: '🤖', label: `${agentCount} agents` });
+  if (sessionCount > 0)     pills.push({ icon: '💬', label: `${sessionCount} sessions` });
+  pills.push({ icon: '🧠', label: `${modelCount} model${modelCount>1?'s':''}` });
+  if (cacheEfficiency > 0)  pills.push({ icon: '⚡', label: `${cacheEfficiency}% cache` });
+
+  // ── Findings summary ──────────────────────────────────
+  const findingSummary = [];
+  if (criticals > 0) findingSummary.push(`🔴 ${criticals} critical`);
+  if (highs > 0)     findingSummary.push(`🟠 ${highs} high`);
+  if (mediums > 0)   findingSummary.push(`🟡 ${mediums} medium`);
+
+  const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Clawculator Snapshot</title>
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700;800&family=Outfit:wght@400;500;600;700;800;900&display=swap');
+
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+
+  html, body {
+    min-height: 100vh;
+    font-family: 'Outfit', sans-serif;
+    background: #020408;
+    color: #e2e8f0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  .card {
+    width: 480px; max-width: 96vw;
+    background: #05080f;
+    border-radius: 24px;
+    border: 1px solid #1a2744;
+    padding: 32px 28px 24px;
+    display: flex; flex-direction: column;
+    align-items: center;
+    position: relative;
+    overflow: hidden;
+    box-shadow: 0 0 80px rgba(34,211,238,0.04), 0 20px 60px rgba(0,0,0,0.5);
+  }
+
+  /* Grid bg */
+  .card::before {
+    content: '';
+    position: absolute; top: 0; left: 0; right: 0; bottom: 0;
+    background:
+      linear-gradient(rgba(34,211,238,0.02) 1px, transparent 1px),
+      linear-gradient(90deg, rgba(34,211,238,0.02) 1px, transparent 1px);
+    background-size: 32px 32px;
+    pointer-events: none;
+  }
+
+  .card > * { position: relative; z-index: 1; }
+
+  /* Header */
+  .header {
+    display: flex; align-items: center; gap: 10px;
+    margin-bottom: 20px;
+  }
+  .logo-claw { font-size: 28px; }
+  .logo-text {
+    font-family: 'JetBrains Mono', monospace;
+    font-weight: 800; font-size: 18px; letter-spacing: -0.5px;
+    background: linear-gradient(135deg, #22d3ee, #818cf8);
+    -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+  }
+
+  /* Grade */
+  .grade-container {
+    display: flex; flex-direction: column; align-items: center;
+    margin-bottom: 16px;
+  }
+  .grade-ring {
+    width: 120px; height: 120px;
+    border-radius: 50%;
+    border: 3px solid ${gradeColor}44;
+    display: flex; align-items: center; justify-content: center;
+    box-shadow: 0 0 40px ${gradeGlow}, inset 0 0 20px ${gradeGlow};
+    position: relative;
+  }
+  .grade-ring::before {
+    content: '';
+    position: absolute; inset: -2px;
+    border-radius: 50%;
+    border: 2px solid ${gradeColor};
+    opacity: 0.5;
+  }
+  .grade-letter {
+    font-family: 'JetBrains Mono', monospace;
+    font-weight: 900; font-size: 52px;
+    color: ${gradeColor};
+    text-shadow: 0 0 20px ${gradeGlow};
+    line-height: 1;
+  }
+  .grade-label {
+    font-size: 11px; font-weight: 600; color: #64748b;
+    text-transform: uppercase; letter-spacing: 1.5px;
+    margin-top: 8px;
+  }
+
+  /* Cost */
+  .cost-range {
+    font-family: 'JetBrains Mono', monospace;
+    font-weight: 700; font-size: 22px;
+    color: #e2e8f0;
+    margin-bottom: 14px;
+    text-align: center;
+  }
+
+  /* Divider */
+  .divider {
+    width: 60px; height: 1px;
+    background: linear-gradient(90deg, transparent, #1e3a5f, transparent);
+    margin-bottom: 14px;
+  }
+
+  /* Pills */
+  .pills {
+    display: flex; flex-wrap: wrap; justify-content: center;
+    gap: 6px;
+    margin-bottom: 14px;
+    max-width: 400px;
+  }
+  .pill {
+    display: flex; align-items: center; gap: 4px;
+    background: #0b1120;
+    border: 1px solid #1a2744;
+    border-radius: 14px;
+    padding: 5px 12px;
+    font-size: 12px; font-weight: 500;
+    color: #94a3b8;
+  }
+
+  /* Findings */
+  .findings {
+    text-align: center;
+    margin-bottom: 14px;
+  }
+  .findings-badges {
+    display: flex; justify-content: center; gap: 8px;
+    flex-wrap: wrap;
+  }
+  .findings-badge {
+    font-family: 'JetBrains Mono', monospace;
+    font-size: 12px; font-weight: 600;
+    padding: 4px 10px; border-radius: 6px;
+  }
+  .findings-clean {
+    font-size: 14px; color: #22c55e; font-weight: 600;
+  }
+
+  /* CTA */
+  .cta {
+    margin-top: auto;
+    text-align: center;
+    width: 100%;
+  }
+  .cta-divider {
+    width: 100%; height: 1px;
+    background: linear-gradient(90deg, transparent, #1a2744, transparent);
+    margin-bottom: 14px;
+  }
+  .cta-prompt {
+    font-size: 13px; color: #64748b;
+    margin-bottom: 8px;
+  }
+  .cta-command {
+    font-family: 'JetBrains Mono', monospace;
+    font-size: 14px; font-weight: 700;
+    color: #22d3ee;
+    background: #0b1120;
+    border: 1px solid #1a2744;
+    border-radius: 8px;
+    padding: 10px 18px;
+    display: inline-block;
+    margin-bottom: 6px;
+  }
+  .cta-sub {
+    font-size: 10px; color: #334155;
+  }
+</style>
+</head>
+<body>
+<div class="card">
+
+  <div class="header">
+    <div class="logo-claw">🦞</div>
+    <div class="logo-text">CLAWCULATOR</div>
+  </div>
+
+  <div class="grade-container">
+    <div class="grade-ring">
+      <div class="grade-letter">${grade}</div>
+    </div>
+    <div class="grade-label">${gradeEmoji} cost health</div>
+  </div>
+
+  <div class="cost-range">${costEmoji} ${costRange}</div>
+
+  <div class="divider"></div>
+
+  <div class="pills">
+    ${pills.map(p => `<div class="pill"><span>${p.icon}</span>${p.label}</div>`).join('\n    ')}
+  </div>
+
+  <div class="findings">
+    ${findingSummary.length > 0 ?
+      `<div class="findings-badges">${findingSummary.map(f => {
+        const c = f.startsWith('🔴') ? '#ef4444' : f.startsWith('🟠') ? '#f97316' : '#eab308';
+        return `<div class="findings-badge" style="background:${c}18;color:${c}">${f}</div>`;
+      }).join('')}</div>` :
+      `<div class="findings-clean">✅ No issues found</div>`
+    }
+  </div>
+
+  <div class="cta">
+    <div class="cta-divider"></div>
+    <div class="cta-prompt">Get your OpenClaw cost grade</div>
+    <div class="cta-command">npx clawculator --snapshot</div>
+    <div class="cta-sub">100% offline · your data never leaves your machine</div>
+  </div>
+
+</div>
+</body>
+</html>`;
+
+  const htmlPath = path.join(outputDir, 'clawculator-snapshot.html');
+  fs.writeFileSync(htmlPath, html, 'utf8');
+
+  // Terminal summary
+  console.log(`\n  ${gradeEmoji} Grade: \x1b[1m${grade}\x1b[0m`);
+  console.log(`  ${costEmoji} Cost:  ${costRange}`);
+  console.log(`  📦 Setup: ${pills.map(p => p.label).join(' · ')}`);
+  if (findingSummary.length > 0) {
+    console.log(`  🔍 ${findingSummary.join(' · ')}`);
+  } else {
+    console.log(`  ✅ Clean — no issues`);
+  }
+  console.log('');
+
+  return { htmlPath, grade, costRange };
+}
+
+module.exports = { generateSnapshotCard };

package/skills/clawculator/webDashboard.js

@@ -18,7 +18,13 @@ function initDB(dbPath) {
   try {
     Database = require('better-sqlite3');
   } catch {
-    console.error('\x1b[31mError:\x1b[0m better-sqlite3 not installed. Run: npm install better-sqlite3');
+    console.error('\n\x1b[31m  ✗ better-sqlite3 is required for --web\x1b[0m\n');
+    console.error('  Install it with:\n');
+    console.error('    \x1b[36mnpm install -g better-sqlite3\x1b[0m');
+    console.error('    \x1b[90m# or, if installed locally:\x1b[0m');
+    console.error('    \x1b[36mcd $(npm root -g)/clawculator && npm install better-sqlite3\x1b[0m\n');
+    console.error('  \x1b[90mThis is a native module that compiles on install.\x1b[0m');
+    console.error('  \x1b[90mRequires: Node.js 18+, Python 3, and a C++ compiler (Xcode CLI tools on macOS).\x1b[0m\n');
     process.exit(1);
   }
 

package/src/analyzer.js

@@ -5,6 +5,10 @@ const path = require('path');
 const os   = require('os');
 
 // ── Model pricing (per million tokens, input/output) ─────────────
+// Last updated: 2026-02-28 — Update when Anthropic/OpenAI/Google change pricing
+const PRICING_UPDATED = '2026-02-28';
+const PRICING_STALE_DAYS = 60;
+
 const MODEL_PRICING = {
   'claude-opus-4-6':              { input: 5.00,  output: 25.00, label: 'Claude Opus 4.6' },
   'claude-opus-4-5':              { input: 5.00,  output: 25.00, label: 'Claude Opus 4.5' },
@@ -109,6 +113,10 @@ const FIXES = {
     fix: 'Lower imageMaxDimensionPx to reduce vision token costs — default 1200px is expensive',
     command: 'openclaw config set agents.defaults.imageMaxDimensionPx 800',
   },
+  PRICING_STALE: {
+    fix: 'Update clawculator to get the latest model pricing data',
+    command: 'npm update -g clawculator',
+  },
   MULTI_AGENT_PAID: (agentId) => ({
     fix: `Agent "${agentId}" has its own expensive model config — each agent bills independently`,
     command: `Review agents.list[${agentId}].model config and apply same cost rules as primary agent`,
@@ -503,6 +511,10 @@ function analyzeConfig(configPath) {
 
 /**
  * Parse a .jsonl session transcript file and sum up real usage/cost data.
+ * Version-aware: handles multiple OpenClaw schema formats:
+ *   - v2026.2.x+: entry.message.usage (standard)
+ *   - v2026.1.x:  entry.usage (legacy)
+ *   - Anthropic raw: usage.cache_creation_input_tokens / usage.cache_read_input_tokens
  * Returns { input, output, cacheRead, cacheWrite, totalTokens, totalCost, messageCount, model, firstTs, lastTs }
  */
 function parseTranscript(jsonlPath) {
@@ -512,6 +524,7 @@ function parseTranscript(jsonlPath) {
 
     let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, totalTokens = 0, totalCost = 0;
     let messageCount = 0, model = null, firstTs = null, lastTs = null;
+    let schemaDetected = null; // track which schema we're seeing
 
     for (const line of content.split('\n')) {
       if (!line.trim()) continue;
@@ -527,23 +540,29 @@ function parseTranscript(jsonlPath) {
       }
 
       // Only assistant messages with usage blocks have cost data
-      if (entry.type !== 'message') continue;
+      // Some schemas use entry.type === 'message', others use entry.role === 'assistant'
+      if (entry.type !== 'message' && entry.role !== 'assistant') continue;
 
-      // Usage can be at entry.usage (some formats) or entry.message.usage (standard format)
-      const u = entry.usage || entry.message?.usage;
+      // Usage can be in multiple locations depending on OpenClaw version
+      const u = entry.usage || entry.message?.usage || entry.response?.usage;
       if (!u) continue;
 
+      if (!schemaDetected) {
+        schemaDetected = entry.usage ? 'legacy' : entry.message?.usage ? 'standard' : 'response';
+      }
+
       messageCount++;
 
-      // Model can be at entry.model or entry.message.model
-      const entryModel = entry.model || entry.message?.model;
+      // Model can be at multiple locations
+      const entryModel = entry.model || entry.message?.model || entry.response?.model;
       if (entryModel && !model) model = entryModel;
 
-      input       += u.input       || 0;
-      output      += u.output      || 0;
-      cacheRead   += u.cacheRead   || 0;
-      cacheWrite  += u.cacheWrite  || 0;
-      totalTokens += u.totalTokens || 0;
+      // Token fields: handle both camelCase (OpenClaw) and snake_case (raw Anthropic API)
+      input       += u.input       || u.input_tokens               || 0;
+      output      += u.output      || u.output_tokens              || 0;
+      cacheRead   += u.cacheRead   || u.cache_read_input_tokens    || 0;
+      cacheWrite  += u.cacheWrite  || u.cache_creation_input_tokens || 0;
+      totalTokens += u.totalTokens || ((u.input || u.input_tokens || 0) + (u.output || u.output_tokens || 0)) || 0;
 
       // Prefer API-reported cost (already accounts for cache pricing)
       if (u.cost) {
@@ -557,7 +576,7 @@ function parseTranscript(jsonlPath) {
 
     if (messageCount === 0) return null;
 
-    return { input, output, cacheRead, cacheWrite, totalTokens, totalCost, messageCount, model, firstTs, lastTs };
+    return { input, output, cacheRead, cacheWrite, totalTokens, totalCost, messageCount, model, firstTs, lastTs, schemaDetected };
   } catch {
     return null;
   }
@@ -916,6 +935,19 @@ async function runAnalysis({ configPath, sessionsPath, logsDir }) {
 
   const realCost = sessionResult.totalRealCost || 0;
 
+  // Check pricing staleness — only affects cost estimates for config findings
+  // (actual transcript costs use API-reported cost.total, not the pricing table)
+  const pricingAge = Math.floor((Date.now() - new Date(PRICING_UPDATED).getTime()) / 86400000);
+  if (pricingAge > PRICING_STALE_DAYS) {
+    allFindings.push({
+      severity: 'low',
+      source: 'pricing',
+      title: `Model pricing table is ${pricingAge} days old`,
+      detail: `Pricing was last updated ${PRICING_UPDATED}. Actual costs from transcripts are unaffected (they use API-reported totals). Config-based cost estimates (heartbeat bleed, cron projections) may be slightly off. Update: npm update -g clawculator`,
+      ...FIXES.PRICING_STALE,
+    });
+  }
+
   return {
     scannedAt:    new Date().toISOString(),
     configPath,