npm - @nxuss/lemma - Versions diffs - 0.5.0 → 0.5.2 - Mend

@nxuss/lemma 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (40) hide show

package/README.md +61 -8
package/dashboard/dist/assets/{index-B4TA31pA.js → index-CIlkFwDs.js} +98 -98
package/dashboard/dist/assets/index-CIlkFwDs.js.map +1 -0
package/dashboard/dist/index.html +1 -1
package/dist/cjs/cli/lemma-proxy.d.ts +2 -0
package/dist/cjs/cli/lemma-proxy.d.ts.map +1 -1
package/dist/cjs/cli/lemma-proxy.js +243 -37
package/dist/cjs/cli/lemma-proxy.js.map +1 -1
package/dist/cjs/mcp/index.js +81 -0
package/dist/cjs/mcp/index.js.map +1 -1
package/dist/cjs/utils/ClipboardWatcher.d.ts.map +1 -1
package/dist/cjs/utils/ClipboardWatcher.js +3 -0
package/dist/cjs/utils/ClipboardWatcher.js.map +1 -1
package/dist/cjs/utils/SavingsLedger.d.ts +52 -0
package/dist/cjs/utils/SavingsLedger.d.ts.map +1 -0
package/dist/cjs/utils/SavingsLedger.js +101 -0
package/dist/cjs/utils/SavingsLedger.js.map +1 -0
package/dist/cjs/utils/reportSavings.d.ts +24 -0
package/dist/cjs/utils/reportSavings.d.ts.map +1 -0
package/dist/cjs/utils/reportSavings.js +53 -0
package/dist/cjs/utils/reportSavings.js.map +1 -0
package/dist/esm/cli/lemma-proxy.d.ts +2 -0
package/dist/esm/cli/lemma-proxy.d.ts.map +1 -1
package/dist/esm/cli/lemma-proxy.js +241 -37
package/dist/esm/cli/lemma-proxy.js.map +1 -1
package/dist/esm/mcp/index.js +81 -0
package/dist/esm/mcp/index.js.map +1 -1
package/dist/esm/utils/ClipboardWatcher.d.ts.map +1 -1
package/dist/esm/utils/ClipboardWatcher.js +3 -0
package/dist/esm/utils/ClipboardWatcher.js.map +1 -1
package/dist/esm/utils/SavingsLedger.d.ts +52 -0
package/dist/esm/utils/SavingsLedger.d.ts.map +1 -0
package/dist/esm/utils/SavingsLedger.js +98 -0
package/dist/esm/utils/SavingsLedger.js.map +1 -0
package/dist/esm/utils/reportSavings.d.ts +24 -0
package/dist/esm/utils/reportSavings.d.ts.map +1 -0
package/dist/esm/utils/reportSavings.js +47 -0
package/dist/esm/utils/reportSavings.js.map +1 -0
package/package.json +2 -2
package/dashboard/dist/assets/index-B4TA31pA.js.map +0 -1

package/dashboard/dist/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>lemma Dashboard - Agent Orchestration Hub</title>
-    <script type="module" crossorigin src="/dashboard/assets/index-B4TA31pA.js"></script>
+    <script type="module" crossorigin src="/dashboard/assets/index-CIlkFwDs.js"></script>
     <link rel="stylesheet" crossorigin href="/dashboard/assets/index-DNqq3gA9.css">
   </head>
   <body>

package/dist/cjs/cli/lemma-proxy.d.ts CHANGED Viewed

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+export declare function autoConfigureAll(projectName?: string): void;
+export declare function startBackgroundClipboardWatcher(): void;
 export declare function performAutoHeal(apply: boolean): Promise<{
     success: boolean;
     message: string;

package/dist/cjs/cli/lemma-proxy.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"lemma-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/lemma-proxy.ts"],"names":[],"mappings":";~~AAw3CA~~,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6KhL"}
1	+ {"version":3,"file":"lemma-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/lemma-proxy.ts"],"names":[],"mappings":";AAoNA,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA0I3D;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAyCtD;AAmsCD,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6KhL"}

package/dist/cjs/cli/lemma-proxy.js CHANGED Viewed

@@ -4,6 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoConfigureAll = autoConfigureAll;
+exports.startBackgroundClipboardWatcher = startBackgroundClipboardWatcher;
 exports.performAutoHeal = performAutoHeal;
 const commander_1 = require("commander");
 const express_1 = __importDefault(require("express"));
@@ -30,7 +32,7 @@ function getVersion() {
             catch { }
         }
     }
-    return '0.4.6';
+    return '0.5.2';
 }
 const VERSION = getVersion();
 const ComplexityRouter_1 = __importDefault(require("../proxy/ComplexityRouter"));
@@ -38,6 +40,7 @@ const SemanticScrubber_1 = __importDefault(require("../security/SemanticScrubber
 const CloudSyncClient_1 = __importDefault(require("../cloud/CloudSyncClient"));
 const ContextSqueezer_1 = require("../utils/ContextSqueezer");
 const AgentMultiplexer_1 = require("../proxy/AgentMultiplexer");
+const SavingsLedger_1 = require("../utils/SavingsLedger");
 const chroma = new chromadb_1.ChromaClient({ host: 'localhost', port: 8000 });
 const dummyEmbeddingFunction = { generate: (texts) => Promise.resolve([]) };
 const complexityRouter = new ComplexityRouter_1.default();
@@ -59,6 +62,13 @@ function logEvent(event) {
     EVENT_LOG.push(ev);
     if (EVENT_LOG.length > MAX_EVENTS)
         EVENT_LOG.shift();
+    // Print a terminal savings summary every 10 events
+    if (EVENT_LOG.length > 0 && EVENT_LOG.length % 10 === 0) {
+        const snap = SavingsLedger_1.savingsLedger.getSnapshot();
+        if (snap.total.tokensSaved > 0) {
+            console.log('\n' + SavingsLedger_1.savingsLedger.getTerminalSummary() + '\n');
+        }
+    }
 }
 const FREE_LIMIT = 500;
 const WARN_PCT = 0.8;
@@ -199,6 +209,182 @@ function ensureGitIgnore() {
     catch { }
     return added;
 }
+const CLIPBOARD_PID_FILE = path_1.default.join(CACHE_DIR, 'clipboard.pid');
+function autoConfigureAll(projectName) {
+    const project = projectName || detectProject();
+    const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+    // 1. Claude Desktop Config
+    try {
+        const isWin = process.platform === 'win32';
+        const claudePath = isWin
+            ? path_1.default.join(process.env.APPDATA || '', 'Claude/claude_desktop_config.json')
+            : path_1.default.join(HOME, 'Library/Application Support/Claude/claude_desktop_config.json');
+        if (fs_1.default.existsSync(path_1.default.dirname(claudePath))) {
+            let config = { mcpServers: {} };
+            if (fs_1.default.existsSync(claudePath)) {
+                try {
+                    config = JSON.parse(fs_1.default.readFileSync(claudePath, 'utf8'));
+                }
+                catch { }
+            }
+            if (!config.mcpServers)
+                config.mcpServers = {};
+            config.mcpServers.lemma = {
+                command: 'npx',
+                args: ['-y', '@nxuss/lemma', 'mcp'],
+                env: { LEMMA_PROJECT: project }
+            };
+            fs_1.default.writeFileSync(claudePath, JSON.stringify(config, null, 2));
+            console.log(`✅ [Claude Desktop] Configured automatically! (Restart Claude to activate)`);
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure Claude Desktop: ${e.message}`);
+    }
+    // 2. Shell Profiles Environment Override
+    try {
+        const profiles = [
+            path_1.default.join(HOME, '.zshrc'),
+            path_1.default.join(HOME, '.bashrc'),
+            path_1.default.join(HOME, '.bash_profile'),
+            path_1.default.join(HOME, '.profile')
+        ];
+        const lines = [
+            '',
+            '# Lemma AI Gateway Overrides',
+            'export OPENAI_BASE_URL="http://localhost:8081/v1"',
+            'export ANTHROPIC_BASE_URL="http://localhost:8081"',
+            'export LEMMA_PROJECT="' + project + '"',
+            ''
+        ].join('\n');
+        for (const profile of profiles) {
+            if (fs_1.default.existsSync(profile)) {
+                try {
+                    const content = fs_1.default.readFileSync(profile, 'utf8');
+                    if (!content.includes('OPENAI_BASE_URL') && !content.includes('LEMMA_PROJECT')) {
+                        fs_1.default.appendFileSync(profile, lines);
+                        console.log(`✅ [Shell Profile] Configured ${path_1.default.basename(profile)} with local redirect variables!`);
+                    }
+                }
+                catch { }
+            }
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure shell profiles: ${e.message}`);
+    }
+    // 3. Cursor & Windsurf settings.json updates
+    try {
+        const isWin = process.platform === 'win32';
+        const isMac = process.platform === 'darwin';
+        const candidates = [];
+        if (isMac) {
+            candidates.push({
+                name: 'Cursor',
+                path: path_1.default.join(HOME, 'Library/Application Support/Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path_1.default.join(HOME, 'Library/Application Support/Windsurf/User/settings.json')
+            });
+        }
+        else if (isWin) {
+            const appData = process.env.APPDATA || '';
+            candidates.push({
+                name: 'Cursor',
+                path: path_1.default.join(appData, 'Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path_1.default.join(appData, 'Windsurf/User/settings.json')
+            });
+        }
+        else {
+            candidates.push({
+                name: 'Cursor',
+                path: path_1.default.join(HOME, '.config/Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path_1.default.join(HOME, '.config/Windsurf/User/settings.json')
+            });
+        }
+        for (const cand of candidates) {
+            const dir = path_1.default.dirname(cand.path);
+            if (fs_1.default.existsSync(dir)) {
+                let settings = {};
+                if (fs_1.default.existsSync(cand.path)) {
+                    try {
+                        settings = JSON.parse(fs_1.default.readFileSync(cand.path, 'utf8'));
+                    }
+                    catch { }
+                }
+                let updated = false;
+                // Settings configuration to route custom openai/anthropic models through the proxy
+                const updates = {
+                    "openai.baseURL": "http://localhost:8081/v1",
+                    "openai.apiKey": "dummy-key-for-lemma",
+                    "anthropic.baseURL": "http://localhost:8081",
+                    "anthropic.apiKey": "dummy-key-for-lemma"
+                };
+                for (const [key, value] of Object.entries(updates)) {
+                    if (settings[key] !== value) {
+                        settings[key] = value;
+                        updated = true;
+                    }
+                }
+                if (updated) {
+                    fs_1.default.writeFileSync(cand.path, JSON.stringify(settings, null, 2));
+                    console.log(`✅ [${cand.name}] Configured editor settings to route via local gateway!`);
+                }
+            }
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure editor settings: ${e.message}`);
+    }
+}
+function startBackgroundClipboardWatcher() {
+    try {
+        if (fs_1.default.existsSync(CLIPBOARD_PID_FILE)) {
+            const oldPid = fs_1.default.readFileSync(CLIPBOARD_PID_FILE, 'utf8');
+            try {
+                process.kill(parseInt(oldPid, 10), 0); // Check if process is still alive
+                console.log(`✅ [Clipboard] Watcher is already running in background (PID: ${oldPid})`);
+                return;
+            }
+            catch {
+                // Process is dead, clean up pid file
+                try {
+                    fs_1.default.unlinkSync(CLIPBOARD_PID_FILE);
+                }
+                catch { }
+            }
+        }
+        console.log(`🔄 Starting Clipboard Watcher in background...`);
+        const { spawn } = require('child_process');
+        // Resolve path of lemma command or script
+        const scriptPath = fs_1.default.existsSync(path_1.default.join(__dirname, 'dist', 'cjs', 'cli', 'lemma-proxy.js'))
+            ? path_1.default.join(__dirname, 'dist', 'cjs', 'cli', 'lemma-proxy.js')
+            : (fs_1.default.existsSync(path_1.default.join(__dirname, 'lemma-proxy.ts')) ? path_1.default.join(__dirname, 'lemma-proxy.ts') : __filename);
+        const isTs = scriptPath.endsWith('.ts');
+        const cmd = isTs ? 'npx' : 'node';
+        const args = isTs ? ['tsx', scriptPath, 'clipboard'] : [scriptPath, 'clipboard'];
+        const cp = spawn(cmd, args, {
+            stdio: 'ignore',
+            detached: true,
+            env: { ...process.env }
+        });
+        cp.unref();
+        if (cp.pid) {
+            fs_1.default.writeFileSync(CLIPBOARD_PID_FILE, String(cp.pid));
+            console.log(`✅ [Clipboard] Watcher has been started (PID: ${cp.pid})`);
+        }
+    }
+    catch (err) {
+        console.error(`❌ Failed to automatically start Clipboard Watcher in background: ${err.message}`);
+    }
+}
 // ── License helpers ────────────────────────────────────────────────────────────
 async function loadLicense() {
     return readJson(LICENSE_FILE, { isPro: false });
@@ -703,6 +889,7 @@ class LemmaServer {
                 const count = CACHE.size;
                 CACHE.clear();
                 EVENT_LOG.length = 0; // Clear live event log
+                SavingsLedger_1.savingsLedger.reset(); // Reset savings counters
                 // Reset and persist statistics for the current project
                 if (this.stats[this.projectName]) {
                     this.stats[this.projectName] = {
@@ -717,6 +904,25 @@ class LemmaServer {
                 }
                 res.json({ success: true, clearedEntries: count });
             });
+            // Savings breakdown by source for the dashboard
+            this.app.get('/api/savings-breakdown', (req, res) => {
+                res.json(SavingsLedger_1.savingsLedger.getSnapshot());
+            });
+            // Cross-process savings reporter — MCP and other processes POST here
+            this.app.post('/api/savings-record', (req, res) => {
+                const { source, charsBefore, charsAfter, tokens } = req.body || {};
+                const validSources = ['clipboard', 'contextSqueeze', 'historyPrune', 'complexityRouting', 'cache'];
+                if (!source || !validSources.includes(source)) {
+                    return res.status(400).json({ error: 'Invalid source' });
+                }
+                if (typeof tokens === 'number' && tokens > 0) {
+                    SavingsLedger_1.savingsLedger.recordTokens(source, tokens);
+                }
+                else if (typeof charsBefore === 'number' && typeof charsAfter === 'number') {
+                    SavingsLedger_1.savingsLedger.record(source, charsBefore, charsAfter);
+                }
+                res.json({ ok: true, snapshot: SavingsLedger_1.savingsLedger.getSnapshot().total });
+            });
             this.app.get('/dashboard/*', (req, res) => res.sendFile(path_1.default.join(this.dashboardPath, 'index.html')));
         }
     }
@@ -744,6 +950,13 @@ class LemmaServer {
         const model = routingDecision.model;
         if (req.body.model)
             req.body.model = model;
+        // Record complexity routing savings when model is downgraded
+        if (routingDecision.complexity === 'low' && model !== originalModel) {
+            // Estimated token savings: cheap model costs ~5x less, so avg prompt of ~800 tokens saves ~640 tokens
+            const estimatedPromptTokens = Math.floor(prompt.length / 4);
+            const routingSavings = Math.floor(estimatedPromptTokens * 0.8); // conservative 80% cost reduction
+            SavingsLedger_1.savingsLedger.recordTokens('complexityRouting', routingSavings);
+        }
         // Apply the Agent Multiplexer to local-verify the prompt in parallel
         const enrichedPrompt = await agentMultiplexer.multiplexPrompt(prompt, model);
         // Resolve conversation session key and retrieve/create the fileHistory map
@@ -766,6 +979,7 @@ class LemmaServer {
         const squeezedPrompt = squeezeResult.squeezed;
         const compressionSavings = squeezeResult.originalSize - squeezeResult.squeezedSize;
         if (compressionSavings > 0) {
+            SavingsLedger_1.savingsLedger.record('contextSqueeze', squeezeResult.originalSize, squeezeResult.squeezedSize);
             console.log(`⚡ [Squeezer] Compressed prompt from ${squeezeResult.originalSize} to ${squeezeResult.squeezedSize} chars (Saved ${(squeezeResult.compressionRatio * 100).toFixed(1)}% context tokens!)`);
         }
         if (provider === 'openai' || provider === 'anthropic') {
@@ -775,6 +989,9 @@ class LemmaServer {
                 const pruneResult = (0, ContextSqueezer_1.pruneHistoryMessages)(req.body.messages);
                 req.body.messages = pruneResult.messages;
                 historyTokensSaved = pruneResult.tokensSavedEstimate + Math.floor(compressionSavings / 4);
+                if (pruneResult.tokensSavedEstimate > 0) {
+                    SavingsLedger_1.savingsLedger.recordTokens('historyPrune', pruneResult.tokensSavedEstimate);
+                }
             }
         }
         else if (provider === 'gemini') {
@@ -787,7 +1004,9 @@ class LemmaServer {
         }
         const hit = cacheGet(provider, prompt);
         if (hit) {
-            await recordStat(this.stats, this.projectName, true, Date.now() - t0, provider, 2000 + historyTokensSaved);
+            const cacheTokensSaved = 2000 + historyTokensSaved;
+            SavingsLedger_1.savingsLedger.recordTokens('cache', cacheTokensSaved);
+            await recordStat(this.stats, this.projectName, true, Date.now() - t0, provider, cacheTokensSaved);
             const unmaskedData = semanticScrubber.unmask(hit.data, tokenMap);
             if (isStream)
                 return simulateHitStream(res, unmaskedData, provider, model, tier, 1.0);
@@ -1052,10 +1271,17 @@ commander_1.program.command('start')
         if (resp.data && resp.data.status === 'ok') {
             console.log(`\n⚠️  Lemma Proxy is already running on port ${port} (Project: ${resp.data.project})`);
             console.log(`💡 Use 'lemma status' for details or 'lemma stop' to restart.\n`);
+            // Keep configurations up to date even if server was already started
+            const runningProject = resp.data.project || detectProject();
+            autoConfigureAll(runningProject);
+            startBackgroundClipboardWatcher();
             process.exit(0);
         }
     }
     catch { }
+    const startProject = opts.project || detectProject();
+    autoConfigureAll(startProject);
+    startBackgroundClipboardWatcher();
     // Automatically enable autopilot if stack is enabled and user is Pro
     const runAutopilot = opts.autopilot || opts.stack;
     if (runAutopilot) {
@@ -1154,6 +1380,19 @@ commander_1.program.command('stop')
     }
     if (fs_1.default.existsSync(PID_FILE))
         fs_1.default.unlinkSync(PID_FILE);
+    // Stop background Clipboard Watcher if active
+    try {
+        if (fs_1.default.existsSync(CLIPBOARD_PID_FILE)) {
+            const cbPid = fs_1.default.readFileSync(CLIPBOARD_PID_FILE, 'utf8');
+            try {
+                process.kill(parseInt(cbPid, 10), 'SIGTERM');
+                console.log(`✅ Stopped background Clipboard Watcher (PID: ${cbPid})`);
+            }
+            catch { }
+            fs_1.default.unlinkSync(CLIPBOARD_PID_FILE);
+        }
+    }
+    catch { }
 });
 commander_1.program.command('status')
     .description('Check proxy status')
@@ -1247,41 +1486,8 @@ commander_1.program.command('init')
         fs_1.default.writeFileSync(envFile, lemmaConfig);
         console.log('✅ Created .env with Lemma configuration');
     }
-    console.log('\n🧠 \x1b[35mAuto-Setup MCP for AI IDEs?\x1b[0m');
-    console.log('   Lemma can automatically configure Claude Desktop and open settings for Cursor/Windsurf.');
-    const { exec } = require('child_process');
-    const isWin = process.platform === 'win32';
-    const claudePath = isWin
-        ? path_1.default.join(process.env.APPDATA || '', 'Claude/claude_desktop_config.json')
-        : path_1.default.join(process.env.HOME || '~', 'Library/Application Support/Claude/claude_desktop_config.json');
-    if (fs_1.default.existsSync(path_1.default.dirname(claudePath))) {
-        try {
-            let config = { mcpServers: {} };
-            if (fs_1.default.existsSync(claudePath)) {
-                config = JSON.parse(fs_1.default.readFileSync(claudePath, 'utf8'));
-            }
-            if (!config.mcpServers)
-                config.mcpServers = {};
-            config.mcpServers.lemma = {
-                command: 'npx',
-                args: ['-y', '@nxuss/lemma', 'mcp'],
-                env: { LEMMA_PROJECT: project }
-            };
-            fs_1.default.writeFileSync(claudePath, JSON.stringify(config, null, 2));
-            console.log(`✅ \x1b[32mClaude Desktop configured automatically!\x1b[0m (Restart Claude to activate)`);
-        }
-        catch (e) {
-            console.log('⚠️  Could not auto-configure Claude Desktop. No worries, you can do it manually.');
-        }
-    }
-    console.log('🚀 Opening IDE configuration pages...');
-    const urls = [
-        'https://docs.anthropic.com/en/docs/agents-and-tools/mcp#using-mcp-in-claude-desktop',
-        'https://cursor.com',
-        'https://codeium.com/windsurf'
-    ];
-    const opener = process.platform === 'darwin' ? 'open' : (process.platform === 'win32' ? 'start' : 'xdg-open');
-    urls.forEach(url => exec(`${opener} ${url}`));
+    console.log('\n🧠 \x1b[35mAuto-Setup MCP and redirection overrides for AI IDEs...\x1b[0m');
+    autoConfigureAll(project);
     console.log('\n✨ Project initialized for the Agentic Era!');
     console.log('🚀 Run "lemma start" to begin.\n');
 });