tokens-metric 0.4.0 → 0.4.2

package/dist/core/format.js

@@ -53,6 +53,14 @@ export function categoryCostUSD(model, category, tokens) {
                 : p.cacheRead;
     return (tokens * rate) / 1_000_000;
 }
+/**
+ * Returns the context window size in tokens for a given model.
+ * All current Claude models share a 200k window. Falls back to 200k for
+ * unknown models so the bar is always renderable.
+ */
+export function contextWindowSize(_model) {
+    return 200_000;
+}
 export function fmtUSD(n) {
     if (n < 0.01)
         return `$${n.toFixed(4)}`;

package/dist/core/parser.js

@@ -79,6 +79,7 @@ export async function aggregateTranscript(path) {
         totals: EMPTY_USAGE(),
         byModel: {},
         messageCount: 0,
+        lastMsgUsage: null,
     };
     const stream = createReadStream(path, { encoding: 'utf8' });
     const rl = createInterface({ input: stream, crlfDelay: Infinity });
@@ -129,6 +130,8 @@ export function applyLine(stats, line) {
     stats.totals = addUsage(stats.totals, u);
     stats.byModel[model] = addUsage(stats.byModel[model] ?? EMPTY_USAGE(), u);
     stats.messageCount += 1;
+    // Overwrite — we only care about the most recent turn's context footprint.
+    stats.lastMsgUsage = { ...EMPTY_USAGE(), ...u };
 }
 function numberOr0(v) {
     return typeof v === 'number' && Number.isFinite(v) ? v : 0;

package/dist/core/tailer.js

@@ -14,6 +14,7 @@ export async function tailTranscript(path) {
         totals: EMPTY_USAGE(),
         byModel: {},
         messageCount: 0,
+        lastMsgUsage: null,
     };
     const listeners = [];
     const notify = () => listeners.forEach((l) => l(stats));

package/dist/tui/index.js

@@ -2,10 +2,12 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
 import { render, Box, Text, useApp, useInput } from 'ink';
+import { createInterface } from 'node:readline';
+import { spawnSync } from 'node:child_process';
 import { findActiveTranscript, listTranscripts } from '../core/parser.js';
 import { tailTranscript } from '../core/tailer.js';
 import { detectAuth } from '../core/detect.js';
-import { categoryCostUSD, estimateCostUSD, fmtNumber, fmtUSD } from '../core/format.js';
+import { categoryCostUSD, contextWindowSize, estimateCostUSD, fmtNumber, fmtUSD } from '../core/format.js';
 import { buildHistory, bucketCostUSD, bucketTokens, bucketTopModel, getTodaySessions, } from '../core/history.js';
 import { totalTokens } from '../core/types.js';
 import { anonymizePath } from '../core/privacy.js';
@@ -243,7 +245,14 @@ function BreakdownPanel({ stats, series, ratePerSec, }) {
                 const model = stats.lastModel ?? '';
                 const cacheDenom = u.input_tokens + u.cache_read_input_tokens;
                 const hitRatio = cacheDenom > 0 ? u.cache_read_input_tokens / cacheDenom : null;
-                return (_jsxs(Box, { flexDirection: "column", children: [_jsx(BarRow, { label: "Input    ", value: u.input_tokens, max: max, total: total, color: "cyan", cost: categoryCostUSD(model, 'input', u.input_tokens) }), _jsx(BarRow, { label: "Output   ", value: u.output_tokens, max: max, total: total, color: "green", cost: categoryCostUSD(model, 'output', u.output_tokens) }), _jsx(BarRow, { label: "C. write ", value: u.cache_creation_input_tokens, max: max, total: total, color: "yellow", cost: categoryCostUSD(model, 'cacheWrite', u.cache_creation_input_tokens) }), _jsx(BarRow, { label: "C. read  ", value: u.cache_read_input_tokens, max: max, total: total, color: "magenta", cost: categoryCostUSD(model, 'cacheRead', u.cache_read_input_tokens) }), hitRatio !== null && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { bold: true, children: "Cache hit" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsxs(Text, { color: hitRatio > 0.9 ? 'green' : hitRatio > 0.6 ? 'yellow' : 'red', children: [(hitRatio * 100).toFixed(1), "%"] }), _jsx(Text, { color: hitRatio > 0.9 ? 'green' : hitRatio > 0.6 ? 'yellow' : 'red', children: hitRatio > 0.9 ? '  ✓ excellent' : hitRatio > 0.6 ? '  ⚠ degraded' : '  ✗ poor' })] }) })), Object.keys(stats.byModel).length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "By model" }), Object.entries(stats.byModel).map(([m, mu]) => {
+                // Context window fill — based on last message's input footprint
+                const ctxLimit = contextWindowSize(model);
+                const lastMsg = stats.lastMsgUsage;
+                const ctxUsed = lastMsg
+                    ? lastMsg.input_tokens + lastMsg.cache_read_input_tokens + lastMsg.cache_creation_input_tokens
+                    : null;
+                const ctxRatio = ctxUsed !== null ? ctxUsed / ctxLimit : null;
+                return (_jsxs(Box, { flexDirection: "column", children: [ctxRatio !== null && (_jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "Context  " }), _jsx(Text, { color: ctxRatio > 0.9 ? 'red' : ctxRatio > 0.7 ? 'yellow' : 'green', children: ctxWindowBar(ctxRatio, BAR_WIDTH) }), _jsx(Text, { children: '  ' }), _jsx(Text, { bold: true, color: ctxRatio > 0.9 ? 'red' : ctxRatio > 0.7 ? 'yellow' : 'green', children: fmtNumber(ctxUsed) }), _jsxs(Text, { dimColor: true, children: [" / ", fmtNumber(ctxLimit), "  "] }), _jsxs(Text, { color: ctxRatio > 0.9 ? 'red' : ctxRatio > 0.7 ? 'yellow' : 'green', children: [(ctxRatio * 100).toFixed(1), "%"] }), ctxRatio > 0.9 && _jsx(Text, { color: "red", children: "  \u26A0 near limit" })] }), _jsxs(Text, { dimColor: true, children: ["  last turn \u00B7 ", fmtNumber(ctxLimit - ctxUsed), " tokens remaining"] })] })), _jsx(BarRow, { label: "Input    ", value: u.input_tokens, max: max, total: total, color: "cyan", cost: categoryCostUSD(model, 'input', u.input_tokens) }), _jsx(BarRow, { label: "Output   ", value: u.output_tokens, max: max, total: total, color: "green", cost: categoryCostUSD(model, 'output', u.output_tokens) }), _jsx(BarRow, { label: "C. write ", value: u.cache_creation_input_tokens, max: max, total: total, color: "yellow", cost: categoryCostUSD(model, 'cacheWrite', u.cache_creation_input_tokens) }), _jsx(BarRow, { label: "C. read  ", value: u.cache_read_input_tokens, max: max, total: total, color: "magenta", cost: categoryCostUSD(model, 'cacheRead', u.cache_read_input_tokens) }), hitRatio !== null && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { bold: true, children: "Cache hit" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsxs(Text, { color: hitRatio > 0.9 ? 'green' : hitRatio > 0.6 ? 'yellow' : 'red', children: [(hitRatio * 100).toFixed(1), "%"] }), _jsx(Text, { color: hitRatio > 0.9 ? 'green' : hitRatio > 0.6 ? 'yellow' : 'red', children: hitRatio > 0.9 ? '  ✓ excellent' : hitRatio > 0.6 ? '  ⚠ degraded' : '  ✗ poor' })] }) })), Object.keys(stats.byModel).length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "By model" }), Object.entries(stats.byModel).map(([m, mu]) => {
                                     const c = estimateCostUSD(m, mu);
                                     return (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", children: shortModel(m) }), _jsx(Text, { dimColor: true, children: "  \u03A3 " }), _jsx(Text, { children: fmtNumber(totalTokens(mu)) }), c !== null && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "  ~" }), _jsx(Text, { children: fmtUSD(c) })] }))] }, m));
                                 })] }))] }));
@@ -348,6 +357,10 @@ function displayCwd(cwd) {
         return '~ (home)';
     return out;
 }
+function ctxWindowBar(ratio, width) {
+    const filled = Math.round(Math.min(1, ratio) * width);
+    return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
 function intensityColor(ratio) {
     if (ratio <= 0)
         return 'gray';
@@ -380,4 +393,32 @@ function timeAgo(ms) {
         return `${h}h`;
     return `${Math.floor(h / 24)}d`;
 }
+// ── Pre-start update prompt ───────────────────────────────────────────────────
+async function promptForUpdate() {
+    const latest = await checkForUpdate(pkg.version);
+    if (!latest || !process.stdin.isTTY)
+        return;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question(`\n⚡  tokens-metric v${latest} available  (you have v${pkg.version})\n` +
+            `    Install now? [Y/n] `, (ans) => { rl.close(); resolve(ans); });
+    });
+    process.stdout.write('\n');
+    if (answer.trim().toLowerCase() !== 'n') {
+        process.stdout.write('Installing tokens-metric@latest…\n');
+        const result = spawnSync('npm', ['install', '-g', 'tokens-metric'], {
+            stdio: 'inherit',
+            shell: true,
+        });
+        if (result.status === 0) {
+            process.stdout.write(`\n✓ Updated to v${latest} — restarting…\n\n`);
+            spawnSync(process.execPath, process.argv.slice(1), { stdio: 'inherit', shell: false });
+            process.exit(0);
+        }
+        else {
+            process.stdout.write('\n✗ Install failed — starting current version anyway.\n\n');
+        }
+    }
+}
+await promptForUpdate();
 render(_jsx(App, {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-metric",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Real-time token usage meter for Claude Code — statusline + Ink TUI.",
   "type": "module",
   "bin": {