@nxuss/lemma 0.5.1 → 0.5.2

package/dist/esm/utils/SavingsLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SavingsLedger.d.ts","sourceRoot":"","sources":["../../../src/utils/SavingsLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAE5G,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,WAAW,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC;IAC1B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAKD,cAAM,aAAa;IACjB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;;IAa1C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY5E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ9D,wDAAwD;IACxD,WAAW,IAAI,eAAe;IAgB9B,8CAA8C;IAC9C,kBAAkB,IAAI,MAAM;IA+B5B,gDAAgD;IAChD,KAAK,IAAI,IAAI;CAKd;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,eAAsB,CAAC;AACjD,eAAe,aAAa,CAAC"}

package/dist/esm/utils/SavingsLedger.js

@@ -0,0 +1,98 @@
+/**
+ * SavingsLedger — Singleton accumulator for token savings across all Lemma modules.
+ *
+ * Every module (ClipboardWatcher, ContextSqueezer, ComplexityRouter, SemanticCache)
+ * calls `ledger.record(source, charsBefore, charsAfter)` — no one knows about the dashboard.
+ *
+ * The proxy exposes the ledger via GET /api/savings-breakdown for the dashboard to consume.
+ */
+/** Average blended cost per input token across GPT-4o / Claude Sonnet / Gemini Pro */
+const AVG_COST_PER_TOKEN = 0.000008; // $0.008 per 1K tokens
+class SavingsLedger {
+    constructor() {
+        this.sessionStartedAt = new Date().toISOString();
+        this.sources = {
+            clipboard: { events: 0, tokensSaved: 0, costSaved: 0 },
+            contextSqueeze: { events: 0, tokensSaved: 0, costSaved: 0 },
+            historyPrune: { events: 0, tokensSaved: 0, costSaved: 0 },
+            complexityRouting: { events: 0, tokensSaved: 0, costSaved: 0 },
+            cache: { events: 0, tokensSaved: 0, costSaved: 0 },
+        };
+    }
+    /**
+     * Record a savings event by char counts (automatically converts to token estimate).
+     * @param source  Which module recorded the savings
+     * @param charsBefore  Original char count before compression/routing
+     * @param charsAfter   Resulting char count after compression/routing
+     */
+    record(source, charsBefore, charsAfter) {
+        const charsSaved = Math.max(0, charsBefore - charsAfter);
+        if (charsSaved === 0)
+            return;
+        const tokensSaved = Math.floor(charsSaved / 4);
+        const costSaved = tokensSaved * AVG_COST_PER_TOKEN;
+        this.sources[source].events++;
+        this.sources[source].tokensSaved += tokensSaved;
+        this.sources[source].costSaved += costSaved;
+    }
+    /**
+     * Record a savings event directly in tokens (for sources that already know their token count).
+     */
+    recordTokens(source, tokensSaved) {
+        if (tokensSaved <= 0)
+            return;
+        const costSaved = tokensSaved * AVG_COST_PER_TOKEN;
+        this.sources[source].events++;
+        this.sources[source].tokensSaved += tokensSaved;
+        this.sources[source].costSaved += costSaved;
+    }
+    /** Returns a full snapshot including computed totals */
+    getSnapshot() {
+        const total = { events: 0, tokensSaved: 0, costSaved: 0 };
+        for (const src of Object.values(this.sources)) {
+            total.events += src.events;
+            total.tokensSaved += src.tokensSaved;
+            total.costSaved += src.costSaved;
+        }
+        return {
+            ...this.sources,
+            total,
+            sessionStartedAt: this.sessionStartedAt,
+        };
+    }
+    /** Returns a pretty terminal summary block */
+    getTerminalSummary() {
+        const snap = this.getSnapshot();
+        const fmt = (n) => n.toLocaleString('en-US');
+        const fmtUSD = (n) => new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD', minimumFractionDigits: 4 }).format(n);
+        const rows = [
+            ['📋 Clipboard Squeeze', snap.clipboard.tokensSaved, snap.clipboard.costSaved],
+            ['🗜️  Context Squeeze  ', snap.contextSqueeze.tokensSaved, snap.contextSqueeze.costSaved],
+            ['📜 History Prune    ', snap.historyPrune.tokensSaved, snap.historyPrune.costSaved],
+            ['🔀 Model Routing    ', snap.complexityRouting.tokensSaved, snap.complexityRouting.costSaved],
+            ['⚡ Semantic Cache   ', snap.cache.tokensSaved, snap.cache.costSaved],
+        ];
+        const lines = [
+            '┌──────────────────────────────────────────────────────┐',
+            '│          💰 Lemma Savings Report (this session)      │',
+            '├──────────────────────────────────────────────────────┤',
+            ...rows
+                .filter(([, tokens]) => tokens > 0)
+                .map(([label, tokens, cost]) => `│  ${label}   ${fmt(tokens).padStart(7)} tokens   ${fmtUSD(cost).padStart(10)}  │`),
+            '│  ──────────────────────────────────────────────────  │',
+            `│  TOTAL                       ${fmt(snap.total.tokensSaved).padStart(7)} tokens   ${fmtUSD(snap.total.costSaved).padStart(10)}  │`,
+            '└──────────────────────────────────────────────────────┘',
+        ];
+        return lines.join('\n');
+    }
+    /** Reset all counters (e.g., on cache clear) */
+    reset() {
+        for (const key of Object.keys(this.sources)) {
+            this.sources[key] = { events: 0, tokensSaved: 0, costSaved: 0 };
+        }
+    }
+}
+/** Global singleton — import this everywhere */
+export const savingsLedger = new SavingsLedger();
+export default savingsLedger;
+//# sourceMappingURL=SavingsLedger.js.map

package/dist/esm/utils/SavingsLedger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SavingsLedger.js","sourceRoot":"","sources":["../../../src/utils/SavingsLedger.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/reportSavings.d.ts

@@ -0,0 +1,24 @@
+/**
+ * reportSavings — Fire-and-forget helper to report token savings to the proxy's SavingsLedger.
+ *
+ * Used by processes that run separately from the proxy (e.g., MCP server, CLI tools).
+ * The proxy accumulates all savings in its in-memory SavingsLedger and serves them to the dashboard.
+ */
+type SavingsSource = 'clipboard' | 'contextSqueeze' | 'historyPrune' | 'complexityRouting' | 'cache';
+interface ReportByChars {
+    source: SavingsSource;
+    charsBefore: number;
+    charsAfter: number;
+}
+interface ReportByTokens {
+    source: SavingsSource;
+    tokens: number;
+}
+type ReportPayload = ReportByChars | ReportByTokens;
+/**
+ * Report savings to the proxy's SavingsLedger via HTTP POST.
+ * Fire-and-forget — never throws, never blocks.
+ */
+export declare function reportSavings(payload: ReportPayload): void;
+export {};
+//# sourceMappingURL=reportSavings.d.ts.map

package/dist/esm/utils/reportSavings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSavings.d.ts","sourceRoot":"","sources":["../../../src/utils/reportSavings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,KAAK,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAErG,UAAU,aAAa;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;AAapD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAsB1D"}

package/dist/esm/utils/reportSavings.js

@@ -0,0 +1,47 @@
+/**
+ * reportSavings — Fire-and-forget helper to report token savings to the proxy's SavingsLedger.
+ *
+ * Used by processes that run separately from the proxy (e.g., MCP server, CLI tools).
+ * The proxy accumulates all savings in its in-memory SavingsLedger and serves them to the dashboard.
+ */
+import fs from 'fs';
+import path from 'path';
+import http from 'http';
+function getProxyPort() {
+    try {
+        const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+        const portFile = path.join(HOME, '.lemma-cache/proxy.port');
+        if (fs.existsSync(portFile)) {
+            return fs.readFileSync(portFile, 'utf8').trim();
+        }
+    }
+    catch { }
+    return '8081';
+}
+/**
+ * Report savings to the proxy's SavingsLedger via HTTP POST.
+ * Fire-and-forget — never throws, never blocks.
+ */
+export function reportSavings(payload) {
+    try {
+        const port = getProxyPort();
+        const body = JSON.stringify(payload);
+        const req = http.request({
+            hostname: '127.0.0.1',
+            port: parseInt(port),
+            path: '/api/savings-record',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        });
+        req.on('error', () => { }); // Silently ignore if proxy isn't running
+        req.write(body);
+        req.end();
+    }
+    catch {
+        // Never throw — savings reporting is non-critical
+    }
+}
+//# sourceMappingURL=reportSavings.js.map

package/dist/esm/utils/reportSavings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSavings.js","sourceRoot":"","sources":["../../../src/utils/reportSavings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AAiBxB,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC1C;SACF,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,yCAAyC;QACpE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Intelligent AI Gateway for IDEs & Agents — Semantic cache, Privacy Firewall, and Autonomous Cost-Optimization.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -162,7 +162,7 @@
   "dependencies": {
     "@chroma-core/default-embed": "^0.1.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@nxuss/lemma": "^0.5.1",
+    "@nxuss/lemma": "^0.5.2",
     "@types/cors": "^2.8.19",
     "axios": "^1.6.0",
     "commander": "^14.0.3",