@krtclcdy/tersio 2.18.0 → 2.19.0

package/extensions/shared/usage-store.js

@@ -0,0 +1,294 @@
+// extensions/shared/usage-store.ts — tersio-owned usage.db.
+// Persists the same per-message rows importSessionTokens derives live (model,
+// tokens, cache, cost input, timing, status, tools), so top models, costing,
+// cache, CO2 inputs, and activity survive session-file rotation. Sync is
+// incremental: a files ledger (mtime+size) skips unchanged transcripts, and
+// every read applies the current reset watermark — the store is a cache,
+// never a fork. Missing sqlite3 CLI → sync false / read null, callers fall
+// back to the live path. Never touches RTK's history.db or host transcripts.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { RECENT_LIMIT, canonicalModelId, classifySessionLine, codexSessionsDir, costOf, durOf, ingestSessionRow, newSessionAccum, sessionsDir, walkJsonl, } from './usage-ledger.js';
+export function usageDbPath() {
+    const override = process.env.TERSIO_USAGE_DB;
+    if (override)
+        return override;
+    return path.join(os.homedir(), '.omp', 'plugins', 'tersio-usage.db');
+}
+function esc(v) {
+    return `'${v.replace(/'/g, "''")}'`;
+}
+function intOf(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0;
+}
+function nullNum(v) {
+    return v === undefined ? 'NULL' : String(v);
+}
+function nullStr(v) {
+    return v === undefined ? 'NULL' : esc(v);
+}
+function run(db, sql) {
+    execFileSync('sqlite3', [db, sql], { stdio: ['ignore', 'ignore', 'ignore'], timeout: 30000 });
+}
+function query(db, sql) {
+    const out = execFileSync('sqlite3', ['-separator', '\t', db, sql], {
+        encoding: 'utf8',
+        timeout: 30000,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return out
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => line.split('\t'));
+}
+function ensureSchema(db) {
+    fs.mkdirSync(path.dirname(db), { recursive: true });
+    run(db, `CREATE TABLE IF NOT EXISTS meta (k TEXT PRIMARY KEY, v TEXT NOT NULL);` +
+        `CREATE TABLE IF NOT EXISTS files (path TEXT PRIMARY KEY, mtime REAL NOT NULL, size INTEGER NOT NULL);` +
+        `CREATE TABLE IF NOT EXISTS messages (file TEXT NOT NULL, t REAL, model TEXT NOT NULL,` +
+        ` i INTEGER NOT NULL, o INTEGER NOT NULL, d REAL, cr INTEGER NOT NULL, cw INTEGER NOT NULL,` +
+        ` usd REAL, st TEXT NOT NULL, code REAL, note TEXT, tools TEXT NOT NULL DEFAULT '[]');` +
+        `CREATE INDEX IF NOT EXISTS idx_messages_file ON messages(file);`);
+}
+function readFiles(db) {
+    const known = {};
+    try {
+        for (const [p, mtime, size] of query(db, `SELECT path, mtime, size FROM files;`)) {
+            known[p] = { mtime: Number(mtime) || 0, size: Number(size) || 0 };
+        }
+    }
+    catch { /* fresh db */ }
+    return known;
+}
+function parseFile(text) {
+    const rows = [];
+    let codexProvider = null;
+    for (const line of text.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const row = JSON.parse(line);
+            const parsed = classifySessionLine(row);
+            if (parsed.kind === 'codex_provider') {
+                if (parsed.provider)
+                    codexProvider = parsed.provider;
+                continue;
+            }
+            const ts = row.timestamp;
+            const ms = ts === undefined ? NaN : typeof ts === 'number' ? ts : Date.parse(ts);
+            const t = Number.isFinite(ms) ? ms : null;
+            if (parsed.kind === 'token_row') {
+                const provider = parsed.provider ?? codexProvider;
+                const usage = parsed.usage ?? {};
+                rows.push({
+                    t,
+                    model: canonicalModelId(provider ? `codex/${provider}` : 'codex'),
+                    i: intOf(usage.input),
+                    o: intOf(usage.output),
+                    d: undefined,
+                    cr: intOf(usage.cacheRead),
+                    cw: intOf(usage.cacheWrite),
+                    usd: costOf(usage),
+                    st: 'completed',
+                    code: undefined,
+                    note: undefined,
+                    tools: [],
+                });
+                continue;
+            }
+            if (parsed.kind !== 'assistant_row' || !parsed.model || !parsed.usage)
+                continue;
+            const usage = parsed.usage;
+            const dur = durOf(parsed.durMs);
+            const run = parsed.run ?? { st: 'completed' };
+            const note = run.note?.replace(/[\t\n\r]/g, ' ').slice(0, 180);
+            rows.push({
+                t,
+                model: canonicalModelId(parsed.model),
+                i: intOf(usage.input),
+                o: intOf(usage.output),
+                d: dur,
+                cr: intOf(usage.cacheRead),
+                cw: intOf(usage.cacheWrite),
+                usd: costOf(usage),
+                st: run.st,
+                code: run.code,
+                note,
+                tools: parsed.tools ?? [],
+            });
+        }
+        catch { /* skip corrupt lines */ }
+    }
+    return rows;
+}
+function insertSql(file, r) {
+    return `INSERT INTO messages (file, t, model, i, o, d, cr, cw, usd, st, code, note, tools) VALUES (` +
+        `${esc(file)},${r.t === null ? 'NULL' : String(r.t)},${esc(r.model)},${r.i},${r.o},` +
+        `${nullNum(r.d)},${r.cr},${r.cw},${nullNum(r.usd)},${esc(r.st)},` +
+        `${nullNum(r.code)},${nullStr(r.note)},${esc(JSON.stringify(r.tools))});`;
+}
+// Incremental sync: unchanged transcripts are skipped via mtime+size, changed
+// ones are deleted and re-inserted, removed ones are dropped. True on success
+// (including nothing-to-do), false when sqlite3 or disk is unavailable.
+export function syncUsageDb() {
+    let db;
+    try {
+        db = usageDbPath();
+        ensureSchema(db);
+    }
+    catch {
+        return false;
+    }
+    const files = [];
+    try {
+        walkJsonl(sessionsDir(), files, 2000);
+        if (process.env.TERSIO_SESSIONS_DIR === undefined || process.env.TERSIO_CODEX_DIR !== undefined) {
+            walkJsonl(codexSessionsDir(), files, 2000);
+        }
+    }
+    catch {
+        return false;
+    }
+    const known = readFiles(db);
+    const current = {};
+    const changed = [];
+    for (const file of files) {
+        let st;
+        try {
+            st = fs.statSync(file);
+        }
+        catch {
+            continue;
+        }
+        const entry = { mtime: st.mtimeMs, size: st.size };
+        current[file] = entry;
+        const prev = known[file];
+        if (!prev || prev.mtime !== entry.mtime || prev.size !== entry.size)
+            changed.push(file);
+    }
+    const removed = Object.keys(known).filter((p) => current[p] === undefined);
+    if (!changed.length && !removed.length)
+        return true;
+    const chunks = [];
+    let chunkBytes = 0;
+    const flush = () => {
+        if (!chunks.length)
+            return true;
+        try {
+            run(db, `BEGIN;${chunks.join('')}COMMIT;`);
+        }
+        catch {
+            return false;
+        }
+        chunks.length = 0;
+        chunkBytes = 0;
+        return true;
+    };
+    const push = (sql) => {
+        chunks.push(sql);
+        chunkBytes += sql.length;
+        if (chunkBytes < 400_000)
+            return true;
+        return flush();
+    };
+    for (const file of [...changed, ...removed]) {
+        if (!push(`DELETE FROM messages WHERE file=${esc(file)};DELETE FROM files WHERE path=${esc(file)};`))
+            return false;
+    }
+    try {
+        for (const file of changed) {
+            const entry = current[file];
+            const text = fs.readFileSync(file, 'utf8');
+            for (const r of parseFile(text)) {
+                if (!push(insertSql(file, r)))
+                    return false;
+            }
+            if (!push(`INSERT OR REPLACE INTO files (path, mtime, size) VALUES (${esc(file)},${entry.mtime},${entry.size});`))
+                return false;
+        }
+    }
+    catch {
+        return false;
+    }
+    if (!push(`INSERT OR REPLACE INTO meta (k, v) VALUES ('last_sync',${esc(String(Date.now()))});`))
+        return false;
+    return flush();
+}
+export function readUsageDb() {
+    const db = usageDbPath();
+    try {
+        if (!fs.existsSync(db))
+            return null;
+    }
+    catch {
+        return null;
+    }
+    let rows;
+    try {
+        rows = query(db, `SELECT t, model, i, o, d, cr, cw, usd, st, code, note, tools FROM messages;`);
+    }
+    catch {
+        return null;
+    }
+    const accum = newSessionAccum();
+    for (const [t, model, i, o, d, cr, cw, usd, st, code, note, tools] of rows) {
+        const ts = t === '' ? undefined : Number(t);
+        let toolNames = [];
+        try {
+            const parsed = JSON.parse(tools || '[]');
+            if (Array.isArray(parsed))
+                toolNames = parsed.filter((x) => typeof x === 'string');
+        }
+        catch { /* keep empty */ }
+        const usage = {
+            input: Number(i) || 0,
+            output: Number(o) || 0,
+            cacheRead: Number(cr) || 0,
+            cacheWrite: Number(cw) || 0,
+        };
+        if (usd !== '') {
+            const measured = Number(usd);
+            if (Number.isFinite(measured))
+                usage.cost = measured;
+        }
+        ingestSessionRow(accum, model || 'unknown', usage, Number.isFinite(ts) ? ts : undefined, d === '' ? undefined : Number(d), {
+            st: st === 'error' || st === 'aborted' ? st : 'completed',
+            code: code === '' ? undefined : Number(code),
+            note: note === '' ? undefined : note,
+        }, toolNames);
+    }
+    accum.recent.sort((a, b) => b.t - a.t);
+    let syncedAt = 0;
+    try {
+        const meta = query(db, `SELECT v FROM meta WHERE k='last_sync';`);
+        if (meta.length)
+            syncedAt = Number(meta[0][0]) || 0;
+    }
+    catch { /* keep 0 */ }
+    return {
+        tokens: {
+            messages: accum.messages,
+            totals: accum.totals,
+            byModel: accum.byModel,
+            byDay: accum.byDay,
+            byDayModel: accum.byDayModel,
+            byTool: accum.byTool,
+            byModelMessages: accum.byModelMessages,
+            costMeasured: accum.costMeasured,
+            recent: accum.recent.slice(0, RECENT_LIMIT),
+        },
+        syncedAt,
+    };
+}
+// Delete the store file. Returns 1 when removed, 0 when already absent.
+export function clearUsageDb() {
+    try {
+        fs.unlinkSync(usageDbPath());
+        return 1;
+    }
+    catch {
+        return 0;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krtclcdy/tersio",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "description": "✂️ Token-saving OMP add-ons: terse Caveman replies, compact RTK shell output, lean Ponytail code calls — one-command combo presets.",
   "keywords": [
     "omp",
@@ -109,6 +109,23 @@
           "review"
         ],
         "default": "off"
+      },
+      "currency": {
+        "type": "enum",
+        "description": "Display currency for usage/gain reports (--currency overrides per run)",
+        "values": [
+          "USD",
+          "PHP",
+          "EUR",
+          "GBP",
+          "JPY",
+          "KRW",
+          "SGD",
+          "AUD",
+          "CAD",
+          "INR"
+        ],
+        "default": "USD"
       }
     }
   },

package/tersio.js

@@ -2,7 +2,7 @@
 // tersio.ts — Install Tersio (caveman/rtk/ponytail) add-ons on any OMP device.
 // Usage: node tersio.js [install|update|reinstall|doctor|uninstall|version|help] [options]
 // Requires: node/npm and omp CLI
-import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, gain, dashboardExport, dashboardOpen, dashboardPort, doctor, reset, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
+import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, gain, dashboardExport, dashboardOpen, dashboardPort, doctor, reset, settings, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
 import { closeRL } from './cli/interactive.js';
 import { runInstall } from './cli/install.js';
 import { runDoctor } from './cli/doctor.js';
@@ -10,6 +10,7 @@ import { runLatestUpdate } from './cli/update.js';
 import { runUninstall } from './cli/uninstall.js';
 import { runUsage } from './cli/usage.js';
 import { runReset } from './cli/reset.js';
+import { runSettings } from './cli/settings.js';
 import { runDashboard } from './cli/dashboard.js';
 function printHelp() {
     console.log(`Usage: ${PACKAGE_BIN} [command] [options]
@@ -22,6 +23,7 @@ Commands:
   usage        Ledger-backed usage + savings report
   gain         Open the gain dashboard (localhost only)
   reset        Clear tersio statistics (usage ledger)
+  settings     View/change session-start defaults (combo, caveman, rtk, ponytail)
   uninstall    Remove the managed extensions
   version      Print the package version
   help         Show this help
@@ -40,6 +42,7 @@ Options:
   --port <n> (gain: pin port, default ephemeral)
   --open (gain: open browser)
   --export <file> (gain: write HTML file instead of serving)
+  --currency <code> (usage|gain: display currency; flag wins, then tersio settings default, then USD)
   --version, -v
   --help, -h`);
 }
@@ -86,6 +89,10 @@ async function main() {
         closeRL();
         return;
     }
+    if (settings) {
+        await runSettings();
+        return;
+    }
     if (uninstall) {
         await runUninstall();
         closeRL();