@nxuss/lemma 0.4.0 → 0.4.1

package/dist/cjs/api/server.js

@@ -23,7 +23,7 @@ class DashboardAPIServer {
         this.eventLog = [];
         this.cacheStore = null;
         this.server = null;
-        this.port = config.port || 3001;
+        this.port = config.port || 8083;
         this.host = config.host || '0.0.0.0';
         this.app = (0, express_1.default)();
         this.httpServer = http_1.default.createServer(this.app);

package/dist/cjs/cli/stack.d.ts

@@ -0,0 +1,20 @@
+import { WebSocketServer } from '../core/WebSocketServer';
+import { OrchestrationEngine } from '../core/OrchestrationEngine';
+import { SubconsciousEngine } from '../core/SubconsciousEngine';
+import { DashboardAPIServer } from '../api/server';
+/**
+ * Lemma Stack Orchestrator
+ * Starts the Router, Subconscious Engine, and Dashboard API
+ */
+export declare function startStack(options?: {
+    wsPort?: number;
+    apiPort?: number;
+    chromaUrl?: string;
+    ollamaUrl?: string;
+}): Promise<{
+    wsServer: WebSocketServer;
+    subconsciousEngine: SubconsciousEngine;
+    orchestrationEngine: OrchestrationEngine;
+    dashboardAPIServer: DashboardAPIServer;
+}>;
+//# sourceMappingURL=stack.d.ts.map

package/dist/cjs/cli/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/cli/stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf;;;;;GAiFL"}

package/dist/cjs/cli/stack.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startStack = startStack;
+const WebSocketServer_1 = require("../core/WebSocketServer");
+const OrchestrationEngine_1 = require("../core/OrchestrationEngine");
+const SubconsciousEngine_1 = require("../core/SubconsciousEngine");
+const DashboardBroadcaster_1 = require("../core/DashboardBroadcaster");
+const server_1 = require("../api/server");
+/**
+ * Lemma Stack Orchestrator
+ * Starts the Router, Subconscious Engine, and Dashboard API
+ */
+async function startStack(options = {}) {
+    const wsPort = options.wsPort || parseInt(process.env.WS_PORT || '8080');
+    const apiPort = options.apiPort || parseInt(process.env.DASHBOARD_API_PORT || '8083');
+    const chromaUrl = options.chromaUrl || process.env.CHROMA_URL || 'http://localhost:8000';
+    const ollamaUrl = options.ollamaUrl || process.env.OLLAMA_URL || 'http://localhost:11434';
+    console.log('🧠 Starting Lemma Full Stack...');
+    console.log(`  WebSocket Port: ${wsPort}`);
+    console.log(`  Dashboard API: http://localhost:${apiPort}`);
+    console.log(`  ChromaDB URL: ${chromaUrl}`);
+    console.log(`  Ollama URL: ${ollamaUrl}\n`);
+    try {
+        // 1. Initialize WebSocket Server
+        const wsServer = new WebSocketServer_1.WebSocketServer({
+            port: wsPort,
+            heartbeatInterval: 30000,
+            connectionTimeout: 60000,
+            maxConnections: 100,
+        });
+        // 2. Initialize Subconscious Engine
+        const subconsciousEngine = new SubconsciousEngine_1.SubconsciousEngine();
+        // 3. Initialize Orchestration Engine
+        const orchestrationEngine = new OrchestrationEngine_1.OrchestrationEngine(wsServer, subconsciousEngine);
+        // 4. Initialize Dashboard Broadcaster
+        const dashboardBroadcaster = new DashboardBroadcaster_1.DashboardBroadcaster(wsServer, orchestrationEngine);
+        orchestrationEngine.setDashboardBroadcaster(dashboardBroadcaster);
+        // 5. Initialize Dashboard API Server
+        const dashboardAPIServer = new server_1.DashboardAPIServer({
+            port: apiPort,
+        });
+        // Start everything
+        await wsServer.start();
+        await subconsciousEngine.initialize();
+        dashboardAPIServer.setOrchestrationContext(orchestrationEngine, wsServer.getAgentRegistry?.() || { getAgents: () => [] }, subconsciousEngine);
+        await dashboardAPIServer.start();
+        dashboardBroadcaster.start(2000);
+        console.log('\n🚀 Lemma Stack is ready!');
+        // Graceful shutdown
+        const shutdown = async () => {
+            console.log('\n🛑 Shutting down Lemma Stack...');
+            dashboardBroadcaster.stop();
+            await dashboardAPIServer.stop();
+            await wsServer.stop();
+            await subconsciousEngine.shutdown();
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        return {
+            wsServer,
+            subconsciousEngine,
+            orchestrationEngine,
+            dashboardAPIServer
+        };
+    }
+    catch (error) {
+        console.error('❌ Failed to start Lemma Stack:', error);
+        process.exit(1);
+    }
+}
+// If run directly
+if (require.main === module) {
+    startStack();
+}
+//# sourceMappingURL=stack.js.map

package/dist/cjs/cli/stack.js.map

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

package/dist/esm/api/server.js

@@ -17,7 +17,7 @@ export class DashboardAPIServer {
         this.eventLog = [];
         this.cacheStore = null;
         this.server = null;
-        this.port = config.port || 3001;
+        this.port = config.port || 8083;
         this.host = config.host || '0.0.0.0';
         this.app = express();
         this.httpServer = http.createServer(this.app);

package/dist/esm/cli/stack.d.ts

@@ -0,0 +1,20 @@
+import { WebSocketServer } from '../core/WebSocketServer';
+import { OrchestrationEngine } from '../core/OrchestrationEngine';
+import { SubconsciousEngine } from '../core/SubconsciousEngine';
+import { DashboardAPIServer } from '../api/server';
+/**
+ * Lemma Stack Orchestrator
+ * Starts the Router, Subconscious Engine, and Dashboard API
+ */
+export declare function startStack(options?: {
+    wsPort?: number;
+    apiPort?: number;
+    chromaUrl?: string;
+    ollamaUrl?: string;
+}): Promise<{
+    wsServer: WebSocketServer;
+    subconsciousEngine: SubconsciousEngine;
+    orchestrationEngine: OrchestrationEngine;
+    dashboardAPIServer: DashboardAPIServer;
+}>;
+//# sourceMappingURL=stack.d.ts.map

package/dist/esm/cli/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/cli/stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf;;;;;GAiFL"}

package/dist/esm/cli/stack.js

@@ -0,0 +1,73 @@
+import { WebSocketServer } from '../core/WebSocketServer';
+import { OrchestrationEngine } from '../core/OrchestrationEngine';
+import { SubconsciousEngine } from '../core/SubconsciousEngine';
+import { DashboardBroadcaster } from '../core/DashboardBroadcaster';
+import { DashboardAPIServer } from '../api/server';
+/**
+ * Lemma Stack Orchestrator
+ * Starts the Router, Subconscious Engine, and Dashboard API
+ */
+export async function startStack(options = {}) {
+    const wsPort = options.wsPort || parseInt(process.env.WS_PORT || '8080');
+    const apiPort = options.apiPort || parseInt(process.env.DASHBOARD_API_PORT || '8083');
+    const chromaUrl = options.chromaUrl || process.env.CHROMA_URL || 'http://localhost:8000';
+    const ollamaUrl = options.ollamaUrl || process.env.OLLAMA_URL || 'http://localhost:11434';
+    console.log('🧠 Starting Lemma Full Stack...');
+    console.log(`  WebSocket Port: ${wsPort}`);
+    console.log(`  Dashboard API: http://localhost:${apiPort}`);
+    console.log(`  ChromaDB URL: ${chromaUrl}`);
+    console.log(`  Ollama URL: ${ollamaUrl}\n`);
+    try {
+        // 1. Initialize WebSocket Server
+        const wsServer = new WebSocketServer({
+            port: wsPort,
+            heartbeatInterval: 30000,
+            connectionTimeout: 60000,
+            maxConnections: 100,
+        });
+        // 2. Initialize Subconscious Engine
+        const subconsciousEngine = new SubconsciousEngine();
+        // 3. Initialize Orchestration Engine
+        const orchestrationEngine = new OrchestrationEngine(wsServer, subconsciousEngine);
+        // 4. Initialize Dashboard Broadcaster
+        const dashboardBroadcaster = new DashboardBroadcaster(wsServer, orchestrationEngine);
+        orchestrationEngine.setDashboardBroadcaster(dashboardBroadcaster);
+        // 5. Initialize Dashboard API Server
+        const dashboardAPIServer = new DashboardAPIServer({
+            port: apiPort,
+        });
+        // Start everything
+        await wsServer.start();
+        await subconsciousEngine.initialize();
+        dashboardAPIServer.setOrchestrationContext(orchestrationEngine, wsServer.getAgentRegistry?.() || { getAgents: () => [] }, subconsciousEngine);
+        await dashboardAPIServer.start();
+        dashboardBroadcaster.start(2000);
+        console.log('\n🚀 Lemma Stack is ready!');
+        // Graceful shutdown
+        const shutdown = async () => {
+            console.log('\n🛑 Shutting down Lemma Stack...');
+            dashboardBroadcaster.stop();
+            await dashboardAPIServer.stop();
+            await wsServer.stop();
+            await subconsciousEngine.shutdown();
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        return {
+            wsServer,
+            subconsciousEngine,
+            orchestrationEngine,
+            dashboardAPIServer
+        };
+    }
+    catch (error) {
+        console.error('❌ Failed to start Lemma Stack:', error);
+        process.exit(1);
+    }
+}
+// If run directly
+if (require.main === module) {
+    startStack();
+}
+//# sourceMappingURL=stack.js.map

package/dist/esm/cli/stack.js.map

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

package/lemma-proxy.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 /**
- * Lemma Proxy v0.4.0 — Universal AI Cache CLI
+ * Lemma Proxy v0.4.1 — Universal AI Cache CLI
  * Commands: start, stop, stats, status, activate <key>
  */
 
@@ -467,14 +467,14 @@ class LemmaServer {
     server.listen(this.port, () => {
       fs.writeFileSync(PID_FILE, String(process.pid));
       fs.writeFileSync(PORT_FILE, String(this.port));
-      console.log(`\n🚀 Lemma Proxy v0.4.0\n📁 Project : ${this.projectName}\n🔌 Port    : ${this.port}\n`);
+      console.log(`\n🚀 Lemma Proxy v0.4.1\n📁 Project : ${this.projectName}\n🔌 Port    : ${this.port}\n`);
     });
     process.on('SIGTERM', () => server.close());
   }
 }
 
 // ── CLI ────────────────────────────────────────────────────────────────────────
-program.name('lemma').description('Lemma Proxy CLI').version('0.4.0');
+program.name('lemma').description('Lemma Proxy CLI — Intelligent AI Gateway').version('0.4.1');
 
 program.command('start')
   .description('Start the proxy server')
@@ -494,15 +494,28 @@ program.command('start')
       console.log('   ✅ ChromaDB requested');
 
       // 2. Start Dashboard
-      const dash = spawn('npm', ['run', 'dev', '--prefix', 'dashboard', '--', '--port', '3000'], { stdio: 'ignore', detached: true });
+      // Use port 8082 to avoid conflicts
+      const dash = spawn('npm', ['run', 'dev', '--prefix', 'dashboard', '--', '--port', '8082'], { stdio: 'ignore', detached: true });
       dash.unref();
-      console.log('   ✅ Dashboard requested (http://localhost:3000)');
+      console.log('   ✅ Dashboard requested (http://localhost:8082)');
 
-      // 3. Start Router (in the same process to see logs)
+      // 3. Start Router (using internal script)
       console.log('   🚀 Starting Router & Proxy...\n');
-      const router = spawn('npx', ['tsx', 'start-dev.ts'], { 
+      
+      // Fallback for dev/package mode
+      const stackScript = fs.existsSync(path.join(__dirname, 'dist', 'cjs', 'cli', 'stack.js'))
+        ? path.join(__dirname, 'dist', 'cjs', 'cli', 'stack.js')
+        : (fs.existsSync(path.join(__dirname, 'src', 'cli', 'stack.ts')) ? 'src/cli/stack.ts' : null);
+
+      if (!stackScript) {
+        console.error('❌ Error: Could not find Lemma Stack script. Reinstall the package.');
+        process.exit(1);
+      }
+
+      const routerCmd = stackScript.endsWith('.ts') ? ['npx', 'tsx', stackScript] : ['node', stackScript];
+      const router = spawn(routerCmd[0], routerCmd.slice(1), { 
         stdio: 'inherit',
-        env: { ...process.env, PORT: '8080' } 
+        env: { ...process.env, WS_PORT: '8080', DASHBOARD_API_PORT: '8083' } 
       });
 
       // Start Proxy Server alongside
@@ -519,13 +532,98 @@ program.command('start')
     }
   });
 
-program.command('stop').action(() => {
-  try {
-    const pid = fs.readFileSync(PID_FILE, 'utf8');
-    process.kill(parseInt(pid), 'SIGTERM');
-    console.log('✅ Stopped');
-  } catch { console.log('⚠️  Not running'); }
-});
-program.command('status').action(() => console.log(fs.existsSync(PID_FILE) ? '✅ Running' : '❌ Stopped'));
+program.command('stop')
+  .description('Stop the proxy server')
+  .action(() => {
+    try {
+      if (fs.existsSync(PID_FILE)) {
+        const pid = fs.readFileSync(PID_FILE, 'utf8');
+        process.kill(parseInt(pid), 'SIGTERM');
+        console.log('✅ Stopped');
+      } else {
+        console.log('⚠️  No PID file found. Checking for processes...');
+        // Fallback for windows/mac: kill by port or name
+      }
+    } catch { console.log('⚠️  Could not stop process.'); }
+    if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);
+  });
+
+program.command('status')
+  .description('Check proxy status')
+  .action(async () => {
+    const port = fs.existsSync(PORT_FILE) ? fs.readFileSync(PORT_FILE, 'utf8') : '8081';
+    try {
+      const resp = await axios.get(`http://localhost:${port}/health`, { timeout: 1000 });
+      if (resp.data && resp.data.status === 'ok') {
+        console.log(`✅ Running (Project: ${resp.data.project}, Port: ${port})`);
+      } else {
+        console.log('❌ Stopped (Health check failed)');
+      }
+    } catch {
+      console.log('❌ Stopped');
+      if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);
+    }
+  });
+
+program.command('stats')
+  .description('Show usage statistics')
+  .action(() => {
+    const stats = loadStats();
+    const usage = loadUsage();
+    const project = detectProject();
+    const s = stats[project] || { total:0, hits:0, misses:0, totalLatency:0, totalTokensSaved:0 };
+    
+    console.log(`\n📊 Lemma Stats for [${project}]`);
+    console.log(`──────────────────────────────────`);
+    console.log(`Total Requests : ${s.total}`);
+    console.log(`Cache Hits     : ${s.hits} (${((s.hits/s.total||0)*100).toFixed(1)}%)`);
+    console.log(`Tokens Saved   : ${s.totalTokensSaved.toLocaleString()}`);
+    console.log(`Avg Latency    : ${(s.totalLatency/(s.total||1)).toFixed(2)}ms`);
+    console.log(`Tier           : ${isPro() ? 'PRO' : 'FREE'}`);
+    if (!isPro()) console.log(`Free Usage     : ${usage.count}/${FREE_LIMIT} requests`);
+    console.log(`──────────────────────────────────\n`);
+  });
+
+program.command('activate <key>')
+  .description('Activate Pro features with a license key')
+  .action(async (key) => {
+    console.log('🔑 Validating license key...');
+    try {
+      const res = await validateKeyRemote(key);
+      if (res.valid) {
+        writeJson(LICENSE_FILE, { key, isPro: true, activatedAt: new Date().toISOString() });
+        console.log('✅ License activated! Enjoy Pro features.');
+      } else {
+        console.log('❌ Invalid license key.');
+      }
+    } catch (e) {
+      console.error('❌ Error validating key:', e.message);
+    }
+  });
+
+program.command('init')
+  .description('Initialize Lemma in the current project (auto-discovery)')
+  .action(() => {
+    const project = detectProject();
+    console.log(`🛠️  Initializing Lemma for [${project}]...`);
+    
+    const envFile = path.join(process.cwd(), '.env');
+    const lemmaConfig = `\n# Lemma AI Gateway Configuration\nOPENAI_BASE_URL=http://localhost:8081/v1\nLEMMA_PROJECT=${project}\n`;
+    
+    if (fs.existsSync(envFile)) {
+      const content = fs.readFileSync(envFile, 'utf8');
+      if (content.includes('OPENAI_BASE_URL')) {
+        console.log('⚠️  OPENAI_BASE_URL already exists in .env. Please update it manually to: http://localhost:8081/v1');
+      } else {
+        fs.appendFileSync(envFile, lemmaConfig);
+        console.log('✅ Added Lemma configuration to .env');
+      }
+    } else {
+      fs.writeFileSync(envFile, lemmaConfig);
+      console.log('✅ Created .env with Lemma configuration');
+    }
+    
+    console.log('\n🚀 Done! Run "lemma start" to begin.');
+  });
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Intelligent AI Gateway — Semantic cache, Privacy Firewall, and Autonomous Cost-Optimization for AI Agents.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",