superlocalmemory 3.5.8 → 3.6.0

package/src/superlocalmemory/ui/js/ng-shell.js

@@ -29,7 +29,8 @@
     {
       label: 'Config',
       items: [
-        { id: 'settings-pane', icon: 'bi-gear', text: 'Settings' }
+        { id: 'settings-pane', icon: 'bi-gear', text: 'Settings' },
+        { id: 'optimize-pane', icon: 'bi-speedometer', text: 'Optimize' }
       ]
     }
   ];

package/src/superlocalmemory/ui/js/optimize.js

@@ -0,0 +1,173 @@
+// SuperLocalMemory V3 — Optimize Tab
+// Part of Qualixar | https://superlocalmemory.com
+
+(function() {
+  'use strict';
+
+  var _pollTimer = null;
+
+  window.initOptimizeTab = function() {
+    _loadOptimizeConfig();
+    _loadSavings();
+    _startSavingsPolling();
+  };
+
+  function _startSavingsPolling() {
+    if (_pollTimer) clearInterval(_pollTimer);
+    _pollTimer = setInterval(_loadSavings, 10000);
+  }
+
+  async function _loadOptimizeConfig() {
+    try {
+      var resp = await fetch('/api/optimize/config');
+      if (!resp.ok) return;
+      var cfg = await resp.json();
+      _setToggle('opt-enabled', cfg.enabled);
+      _setToggle('opt-cache-enabled', cfg.cache_enabled);
+      _setToggle('opt-semantic-enabled', cfg.semantic_enabled);
+      _setToggle('opt-compress-enabled', cfg.compress_enabled);
+      _setSelect('opt-compress-mode', cfg.compress_mode);
+      _setToggle('opt-compress-code', cfg.compress_code);
+      _setToggle('opt-compress-prose', cfg.compress_prose);
+      _setToggle('opt-compress-ccr', cfg.compress_ccr);
+      _setToggle('opt-compress-align', cfg.compress_align);
+      var verEl = document.getElementById('opt-config-version');
+      if (verEl) verEl.textContent = cfg.config_version || '-';
+    } catch (e) {
+      console.log('Optimize config load error:', e);
+    }
+  }
+
+  async function _loadSavings() {
+    try {
+      var resp = await fetch('/api/optimize/savings');
+      if (!resp.ok) return;
+      var data = await resp.json();
+      var tokensSaved = (data.tokens_saved_input || 0) + (data.tokens_saved_output || 0) + (data.tokens_saved_compress || 0);
+      _setText('opt-tokens-saved', tokensSaved.toLocaleString());
+      var costSaved = data.cost_saved || {};
+      _setText('opt-usd-saved', '$' + (costSaved.usd || 0).toFixed(4));
+      _setText('opt-inr-saved', '\u20B9' + (costSaved.inr || 0).toFixed(2));
+      _setText('opt-hit-rate', ((data.hit_rate || 0) * 100).toFixed(1) + '%');
+      _setText('opt-cache-entries', data.entries || 0);
+      _setText('opt-cache-size', _formatBytes(data.cache_bytes || 0));
+      if (data.compress_ratio !== null && data.compress_ratio !== undefined) {
+        _setText('opt-compression-ratio', data.compress_ratio.toFixed(2));
+      }
+      _setText('opt-pricing-date', data.pricing_date || '-');
+      if (data.is_stale) {
+        _setText('opt-stale-warning', 'Pricing data may be outdated');
+      }
+    } catch (e) {
+      console.log('Savings load error:', e);
+    }
+  }
+
+  // Toggle handlers
+  document.addEventListener('change', function(e) {
+    var id = e.target.id;
+    if (!id || !id.startsWith('opt-')) return;
+    var val = e.target.checked;
+
+    var fieldMap = {
+      'opt-enabled': 'enabled',
+      'opt-cache-enabled': 'cache_enabled',
+      'opt-semantic-enabled': 'semantic_enabled',
+      'opt-compress-enabled': 'compress_enabled',
+      'opt-compress-code': 'compress_code',
+      'opt-compress-prose': 'compress_prose',
+      'opt-compress-ccr': 'compress_ccr',
+      'opt-compress-align': 'compress_align'
+    };
+
+    if (id === 'opt-compress-mode') {
+      var mode = e.target.value;
+      if (mode === 'aggressive') {
+        // M-03: Bootstrap modal replaces browser confirm() for aggressive warning
+        var modalEl = document.getElementById('optimizeAggressiveModal');
+        if (modalEl && typeof bootstrap !== 'undefined') {
+          var modal = bootstrap.Modal.getOrCreateInstance(modalEl);
+          modal.show();
+          var confirmBtn = document.getElementById('optimize-aggressive-confirm');
+          var cancelBtn = document.getElementById('optimize-aggressive-cancel');
+          if (confirmBtn) confirmBtn.onclick = function() { modal.hide(); _putConfig({compress_mode: 'aggressive'}); };
+          if (cancelBtn) cancelBtn.onclick = function() { modal.hide(); e.target.value = 'safe'; };
+          return;
+        }
+        // Fallback for environments without Bootstrap
+        if (!confirm('WARNING: Aggressive mode may reduce output fidelity.\n\nDo NOT use for: code generation, legal text, exact-output tasks, math.\nSafe for: summarization, brainstorming, open-ended chat.\n\nContinue?')) {
+          e.target.value = 'safe';
+          return;
+        }
+      }
+      _putConfig({compress_mode: mode});
+      return;
+    }
+
+    var field = fieldMap[id];
+    if (field) {
+      var body = {};
+      body[field] = val;
+      _putConfig(body);
+    }
+  });
+
+  async function _putConfig(body) {
+    try {
+      await fetch('/api/optimize/config', {
+        method: 'PUT',
+        headers: {'Content-Type': 'application/json'},
+        body: JSON.stringify(body)
+      });
+    } catch (e) {
+      console.log('Config update error:', e);
+    }
+  }
+
+  // Copy proxy URL to clipboard
+  document.addEventListener('click', function(e) {
+    if (e.target && e.target.id === 'opt-copy-url') {
+      var url = 'http://localhost:8765';
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        navigator.clipboard.writeText(url).catch(function() {
+          _fallbackCopy(url);
+        });
+      } else {
+        _fallbackCopy(url);
+      }
+      e.target.textContent = 'Copied!';
+      setTimeout(function() { e.target.textContent = 'Copy URL'; }, 2000);
+    }
+  });
+
+  function _fallbackCopy(text) {
+    var ta = document.createElement('textarea');
+    ta.value = text;
+    ta.style.position = 'fixed';
+    ta.style.left = '-9999px';
+    document.body.appendChild(ta);
+    ta.select();
+    try { document.execCommand('copy'); } catch (e) {}
+    document.body.removeChild(ta);
+  }
+
+  function _setToggle(id, val) {
+    var el = document.getElementById(id);
+    if (el) el.checked = !!val;
+  }
+  function _setSelect(id, val) {
+    var el = document.getElementById(id);
+    if (el) el.value = val || 'safe';
+  }
+  function _setText(id, val) {
+    var el = document.getElementById(id);
+    if (el) el.textContent = val;
+  }
+  function _formatBytes(bytes) {
+    if (bytes === 0) return '0 B';
+    var k = 1024;
+    var sizes = ['B', 'KB', 'MB', 'GB'];
+    var i = Math.floor(Math.log(bytes) / Math.log(k));
+    return (bytes / Math.pow(k, i)).toFixed(1) + ' ' + sizes[i];
+  }
+})();

package/src/superlocalmemory.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.5.8
+Version: 3.6.0
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -49,6 +49,7 @@ Requires-Dist: watchdog==5.0.3
 Requires-Dist: psutil==7.2.2
 Requires-Dist: structlog==25.5.0
 Requires-Dist: portalocker==3.2.0
+Requires-Dist: cryptography==45.0.2
 Requires-Dist: sentence-transformers==5.3.0
 Requires-Dist: optimum==2.1.0
 Requires-Dist: onnxruntime==1.24.4

package/src/superlocalmemory.egg-info/SOURCES.txt

@@ -15,18 +15,24 @@ src/superlocalmemory/attribution/mathematical_dna.py
 src/superlocalmemory/attribution/signer.py
 src/superlocalmemory/attribution/watermark.py
 src/superlocalmemory/cli/__init__.py
+src/superlocalmemory/cli/cache_cmd.py
 src/superlocalmemory/cli/commands.py
+src/superlocalmemory/cli/compress_cmd.py
 src/superlocalmemory/cli/context_commands.py
 src/superlocalmemory/cli/daemon.py
 src/superlocalmemory/cli/db_migrate.py
 src/superlocalmemory/cli/doctor_cmd.py
 src/superlocalmemory/cli/escape_hatch.py
+src/superlocalmemory/cli/help_cmd.py
 src/superlocalmemory/cli/ingest_cmd.py
 src/superlocalmemory/cli/json_output.py
 src/superlocalmemory/cli/main.py
 src/superlocalmemory/cli/migrate_cmd.py
+src/superlocalmemory/cli/optimize_cmd.py
+src/superlocalmemory/cli/optimize_constants.py
 src/superlocalmemory/cli/pending_store.py
 src/superlocalmemory/cli/post_install.py
+src/superlocalmemory/cli/proxy_cmd.py
 src/superlocalmemory/cli/service_installer.py
 src/superlocalmemory/cli/setup_wizard.py
 src/superlocalmemory/cli/version_banner.py
@@ -90,6 +96,7 @@ src/superlocalmemory/core/injection.py
 src/superlocalmemory/core/loop_watchdog.py
 src/superlocalmemory/core/maintenance.py
 src/superlocalmemory/core/maintenance_scheduler.py
+src/superlocalmemory/core/mcp_embedder_proxy.py
 src/superlocalmemory/core/modes.py
 src/superlocalmemory/core/ollama_embedder.py
 src/superlocalmemory/core/platform_utils.py
@@ -280,6 +287,48 @@ src/superlocalmemory/mesh/broker.py
 src/superlocalmemory/mesh/remote_sync.py
 src/superlocalmemory/migrations/__init__.py
 src/superlocalmemory/migrations/v3_4_25_to_v3_4_26.py
+src/superlocalmemory/optimize/__init__.py
+src/superlocalmemory/optimize/adapters/__init__.py
+src/superlocalmemory/optimize/adapters/_agent_registry.py
+src/superlocalmemory/optimize/adapters/anthropic_adapter.py
+src/superlocalmemory/optimize/adapters/openai_adapter.py
+src/superlocalmemory/optimize/adapters/wrap.py
+src/superlocalmemory/optimize/cache/__init__.py
+src/superlocalmemory/optimize/cache/boundary_store.py
+src/superlocalmemory/optimize/cache/centroid_store.py
+src/superlocalmemory/optimize/cache/context_key.py
+src/superlocalmemory/optimize/cache/exact.py
+src/superlocalmemory/optimize/cache/invalidation.py
+src/superlocalmemory/optimize/cache/key_builder.py
+src/superlocalmemory/optimize/cache/manager.py
+src/superlocalmemory/optimize/cache/semantic.py
+src/superlocalmemory/optimize/cache/stampede.py
+src/superlocalmemory/optimize/compress/__init__.py
+src/superlocalmemory/optimize/compress/align.py
+src/superlocalmemory/optimize/compress/ccr.py
+src/superlocalmemory/optimize/compress/extractive_code.py
+src/superlocalmemory/optimize/compress/extractive_json.py
+src/superlocalmemory/optimize/compress/prose_llmlingua.py
+src/superlocalmemory/optimize/compress/router.py
+src/superlocalmemory/optimize/config/__init__.py
+src/superlocalmemory/optimize/config/defaults.py
+src/superlocalmemory/optimize/config/schema.py
+src/superlocalmemory/optimize/config/store.py
+src/superlocalmemory/optimize/metrics/__init__.py
+src/superlocalmemory/optimize/metrics/counters.py
+src/superlocalmemory/optimize/metrics/estimator.py
+src/superlocalmemory/optimize/metrics/exporters.py
+src/superlocalmemory/optimize/metrics/persistence.py
+src/superlocalmemory/optimize/proxy/__init__.py
+src/superlocalmemory/optimize/proxy/_helpers.py
+src/superlocalmemory/optimize/proxy/anthropic_surface.py
+src/superlocalmemory/optimize/proxy/gemini_surface.py
+src/superlocalmemory/optimize/proxy/lifecycle.py
+src/superlocalmemory/optimize/proxy/openai_surface.py
+src/superlocalmemory/optimize/proxy/server.py
+src/superlocalmemory/optimize/storage/__init__.py
+src/superlocalmemory/optimize/storage/db.py
+src/superlocalmemory/optimize/storage/schema.py
 src/superlocalmemory/parameterization/__init__.py
 src/superlocalmemory/parameterization/pattern_extractor.py
 src/superlocalmemory/parameterization/pii_filter.py
@@ -332,6 +381,7 @@ src/superlocalmemory/server/routes/learning.py
 src/superlocalmemory/server/routes/lifecycle.py
 src/superlocalmemory/server/routes/memories.py
 src/superlocalmemory/server/routes/mesh.py
+src/superlocalmemory/server/routes/optimize.py
 src/superlocalmemory/server/routes/prewarm.py
 src/superlocalmemory/server/routes/profiles.py
 src/superlocalmemory/server/routes/stats.py
@@ -418,6 +468,7 @@ src/superlocalmemory/ui/js/ng-ingestion.js
 src/superlocalmemory/ui/js/ng-mesh.js
 src/superlocalmemory/ui/js/ng-shell.js
 src/superlocalmemory/ui/js/ng-skills.js
+src/superlocalmemory/ui/js/optimize.js
 src/superlocalmemory/ui/js/profiles.js
 src/superlocalmemory/ui/js/quick-actions.js
 src/superlocalmemory/ui/js/recall-lab.js

package/src/superlocalmemory.egg-info/requires.txt

@@ -20,6 +20,7 @@ watchdog==5.0.3
 psutil==7.2.2
 structlog==25.5.0
 portalocker==3.2.0
+cryptography==45.0.2
 sentence-transformers==5.3.0
 optimum==2.1.0
 onnxruntime==1.24.4