superlocalmemory 4.0.0 → 4.0.2

package/src/superlocalmemory/ui/js/auto-settings.js

@@ -222,19 +222,20 @@ async function loadModeSettings() {
         // Show provider panel and populate model dropdown
         updateModeUI();
 
-        // v3.6.12 (issue #39/#40): populate the endpoint field from the SAVED
-        // config endpoint. updateProviderUI() above sets the field to the
-        // provider's DEFAULT (e.g. https://api.openai.com/v1), which hides the
-        // user's real custom endpoint (llama.cpp/LM Studio) and makes Test
-        // Connection probe the wrong URL → 401. Override with data.endpoint here.
-        if (data.endpoint) {
-            setTimeout(function() {
-                var epEl = document.getElementById('settings-endpoint');
-                if (epEl) epEl.value = data.endpoint;
-                var epRow = document.getElementById('settings-endpoint-row');
-                if (epRow) epRow.style.display = 'block';
-            }, 0);
-        }
+        // GET /mode deliberately exposes only a redacted endpoint host.
+        // updateProviderUI() sets a provider default as an editable value;
+        // clear it after a reload and expose the redacted host as a hint only.
+        // Otherwise a user who changes nothing can overwrite a full saved URL
+        // with the host-only display value on the next Save.
+        setTimeout(function() {
+            var epEl = document.getElementById('settings-endpoint');
+            if (epEl) {
+                epEl.value = '';
+                epEl.placeholder = data.endpoint || 'Custom endpoint (optional)';
+            }
+            var epRow = document.getElementById('settings-endpoint-row');
+            if (epRow && data.endpoint) epRow.style.display = 'block';
+        }, 0);
 
         // After provider UI updates, set the saved model value
         if (model) {
@@ -432,7 +433,10 @@ async function saveAllSettings() {
     try {
         // V3.4.24: Include embedding params in save payload
         var embParams = getEmbeddingParams();
-        var payload = Object.assign({mode: mode, provider: provider, model: model, api_key: apiKey}, embParams);
+        // Password-style fields reload blank.  Omit blanks so the API can
+        // distinguish "unchanged" from an explicit clear request.
+        var payload = Object.assign({mode: mode, provider: provider, model: model}, embParams);
+        if (apiKey) payload.api_key = apiKey;
         if (endpoint) { payload.base_url = endpoint; payload.endpoint = endpoint; }
         var modeResp = await fetch('/api/v3/mode/set', {
             method: 'POST',

package/src/superlocalmemory/ui/js/brain.js

@@ -825,7 +825,11 @@
   function cardCrossPlatform(cp) {
     const data = cp || {};
     const wrap = EL('section', {className: 'brain-section'});
-    wrap.appendChild(EL('h4', {text: 'Connected clients'}));
+    wrap.appendChild(EL('h4', {text: 'Configured integrations'}));
+    wrap.appendChild(EL('p', {
+      className: 'brain-help',
+      text: 'Installation and sync availability. Recent client activity is shown separately in Living Brain.',
+    }));
 
     const grid = EL('div', {className: 'brain-adapter-grid'});
     const order = [
@@ -1096,6 +1100,7 @@
   function renderAll(brain, behavioral) {
     const b = brain || {};
     const nodes = [
+      cardLivingBrain(b.living_brain),
       cardLearning(b.learning),
     ];
     // Only shows when there are legacy rows pending migration; hidden
@@ -1125,6 +1130,57 @@
     return nodes;
   }
 
+  // --------------------------------------------------------------------
+  // Card: Living Brain — portable evidence, never an automatic control
+  // --------------------------------------------------------------------
+  function cardLivingBrain(snapshot) {
+    const data = snapshot || {};
+    const feedback = data.feedback || {};
+    const clients = (data.connected_clients || {}).clients || [];
+    const quality = data.source_quality || {};
+    const graph = data.graph || {};
+    const wrap = EL('section', {className: 'brain-section'});
+    wrap.appendChild(EL('h4', {text: 'Living Brain'}));
+    wrap.appendChild(EL('p', {
+      className: 'brain-help',
+      text: 'A local evidence view of what SLM has observed. It does not automatically change your model, tools, or memories.',
+    }));
+
+    const clientText = clients.length
+      ? clients.map((client) => {
+        const seconds = Number(client.last_seen_seconds_ago || 0);
+        return String(client.kind || 'other') + ' active ' + seconds + 's ago';
+      }).join(' · ')
+      : 'No client activity in the last 5 minutes';
+    const grid = EL('div', {className: 'brain-stat-grid'});
+    grid.appendChild(statRow('Recent clients', clientText));
+    grid.appendChild(statRow('Explicit feedback', feedback.explicit_signals || 0));
+    grid.appendChild(statRow('Implicit signals', feedback.implicit_signals || 0));
+    grid.appendChild(statRow('Settled outcomes', feedback.settled_outcomes || 0));
+    grid.appendChild(statRow(
+      'Observed source quality',
+      quality.mean_quality == null ? 'No evidence yet' : Number(quality.mean_quality).toFixed(3),
+    ));
+    grid.appendChild(statRow('Sources with evidence', quality.observed_sources || 0));
+    grid.appendChild(statRow('Memory graph nodes', graph.fact_nodes || 0));
+    grid.appendChild(statRow('Memory graph edges', graph.association_edges || 0));
+    wrap.appendChild(grid);
+
+    const byType = feedback.signals_by_type || {};
+    const signalKinds = Object.keys(byType).sort();
+    wrap.appendChild(EL('p', {
+      className: 'brain-help',
+      text: signalKinds.length
+        ? 'Signals: ' + signalKinds.map((kind) => kind + ' (' + Number(byType[kind] || 0) + ')').join(', ')
+        : 'No feedback signals recorded yet. Report outcomes or use memory feedback to start the loop.',
+    }));
+    wrap.appendChild(badge(
+      data.is_real ? 'real' : 'stub',
+      data.source || 'local evidence',
+    ));
+    return wrap;
+  }
+
   // --------------------------------------------------------------------
   // S9-DASH-05: live closed-loop tiles
   // --------------------------------------------------------------------

package/src/superlocalmemory/ui/js/od-brain.js

@@ -32,12 +32,31 @@
       });
   }
 
+  function fetchLivingBrain() {
+    // The canonical Living Brain read model is install-token gated.  The
+    // browser obtains that token only from the local same-origin endpoint;
+    // it is never rendered, stored, or sent to another origin.
+    return apiFetch('/internal/token').then(function (tokenBody) {
+      var token = tokenBody && typeof tokenBody.token === 'string'
+        ? tokenBody.token.trim() : '';
+      if (!token) throw new Error('/internal/token → missing token');
+      return fetch('/api/v3/brain', {
+        credentials: 'same-origin',
+        headers: { 'X-Install-Token': token },
+      }).then(function (r) {
+        if (!r.ok) throw new Error('/api/v3/brain → ' + r.status);
+        return r.json();
+      });
+    });
+  }
+
   function fetchAll() {
     return Promise.all([
       apiFetch('/api/learning/status'),
       apiFetch('/api/behavioral/status'),
       apiFetch('/api/behavioral/assertions?category=skill_performance&limit=50'),
       apiFetch('/api/behavioral/tool-events?limit=500'),
+      fetchLivingBrain(),
     ]);
   }
 
@@ -184,7 +203,7 @@
   // ======================================================================
   // Tab: OVERVIEW
   // ======================================================================
-  function buildOverview(learning, behavioral, dateMap) {
+  function buildOverview(learning, behavioral, dateMap, living) {
     var sec = EL('section', { className: 'tabpane active', 'data-p': 'overview' });
     var stats = (learning && learning.stats) || {};
     var eng = (learning && learning.engagement) || {};
@@ -208,6 +227,9 @@
     var healthColor = healthStatus === 'HEALTHY' ? 'var(--ok)'
       : healthStatus === 'ACTIVE' ? 'var(--cyan)' : undefined;
     var pCount = ((beh.patterns) || []).length;
+    var feedback = (living && living.feedback) || {};
+    var graph = (living && living.graph) || {};
+    var experience = (living && living.agent_experience) || {};
 
     // KPI strip
     var strip = EL('div', { className: 'kpi-strip', style: 'margin-bottom:16px' });
@@ -291,6 +313,13 @@
       ['Models trained',    String(stats.models_trained || 0)],
       ['Verified active models', String(stats.models_active_verified || 0)],
       ['Sources tracked',   String(stats.tracked_sources || 0)],
+      ['Explicit feedback', String(feedback.explicit_signals || 0)],
+      ['Settled outcomes',  String(feedback.settled_outcomes || 0)],
+      ['Claimed evidence authority', String(experience.claimed_evidence_experiences || 0)],
+      ['Cognitive turns', String(experience.turns_total || 0) +
+        ' · ' + String((experience.turns_by_state || {}).finalized || 0) + ' finalized'],
+      ['Graph evidence', String(graph.fact_nodes || 0) + ' nodes · ' +
+        String(graph.association_edges || 0) + ' edges'],
     ].forEach(function (row) {
       var r = EL('div', { className: 'list-row' });
       r.appendChild(EL('span', { className: 'muted', style: 'flex:1', text: row[0] }));
@@ -308,6 +337,35 @@
     grid.appendChild(priv);
     sec.appendChild(grid);
 
+    // Keep evidence distinct from ranking or reward so a non-technical user
+    // can see what SLM observed without inferring an automatic behavior change.
+    var evc = EL('div', { className: 'card', style: 'margin-top:16px' });
+    var evh = EL('div', { className: 'card-head' });
+    evh.appendChild(EL('h3', { text: 'Agent evidence' }));
+    evh.appendChild(EL('span', { className: 'sub', text: 'local receipts · observation only' }));
+    evc.appendChild(evh);
+    var evb = EL('div', { className: 'card-pad' });
+    evb.appendChild(EL('p', {
+      className: 'muted',
+      style: 'margin:0 0 14px;font-size:12px;line-height:1.55',
+      text: 'SLM records completed work when an integration supplies evidence. These records do not change recall, ranking, or model routing by themselves.',
+    }));
+    var evGrid = EL('div', { className: 'kpi-strip', style: 'margin:0' });
+    evGrid.appendChild(kpiCard('fact_check', 'Recorded experiences',
+      fmtNum(experience.experiences_total || 0), 'profile-scoped durable receipts',
+      Number(experience.experiences_total || 0) > 0, undefined, true));
+    evGrid.appendChild(kpiCard('verified', 'Claimed evidence authority',
+      fmtNum(experience.claimed_evidence_experiences || 0), 'declared by the producing host',
+      Number(experience.claimed_evidence_experiences || 0) > 0, undefined, true));
+    evGrid.appendChild(kpiCard('account_tree', 'Cognitive turns',
+      fmtNum(experience.turns_total || 0),
+      fmtNum((experience.turns_by_state || {}).open || 0) + ' open · ' +
+        fmtNum((experience.turns_by_state || {}).finalized || 0) + ' finalized',
+      Number(experience.turns_total || 0) > 0, undefined, true));
+    evb.appendChild(evGrid);
+    evc.appendChild(evb);
+    sec.appendChild(evc);
+
     // Activity heatmap (tool events are activity, never reward labels)
     var hmc = EL('div', { className: 'card', style: 'margin-top:16px' });
     var hmh = EL('div', { className: 'card-head' });
@@ -589,54 +647,54 @@
   // ======================================================================
   // Tab: CONNECTED CLIENTS
   // ======================================================================
-  function buildClients(dateMap) {
+  function buildClients(living, configured) {
     var sec = EL('section', { className: 'tabpane', 'data-p': 'clients' });
+    var clients = ((living && living.connected_clients) || {}).clients || [];
+    var configuredData = configured || {};
 
-    // Sparkline from tool-event activity (last 22 data-points matching design)
+    // Activity is presence reported by host lifecycle hooks, not the old
+    // tool-event proxy.  A configured adapter and a recent client are two
+    // different truths, rendered as separate cards.
     var evc = EL('div', { className: 'card', style: 'margin-bottom:16px' });
     var evh = EL('div', { className: 'card-head' });
-    evh.appendChild(EL('h3', { text: 'Connected-client evolution' }));
-    evh.appendChild(EL('span', { className: 'sub', text: 'tool-event activity over time (proxy metric)' }));
+    evh.appendChild(EL('h3', { text: 'Recent client activity' }));
+    evh.appendChild(EL('span', { className: 'sub', text: 'host lifecycle presence · last 5 minutes' }));
     evc.appendChild(evh);
     var evb = EL('div', { className: 'card-pad' });
-    var today = new Date(); today.setHours(0, 0, 0, 0);
-    var cVals = [];
-    for (var ci = 21; ci >= 0; ci--) {
-      var cd = new Date(today); cd.setDate(today.getDate() - ci);
-      cVals.push((dateMap && dateMap[cd.toISOString().slice(0, 10)]) || 0);
-    }
-    var evSp = EL('div', { id: 'od-brain-sp-clients' });
-    var hasData = cVals.some(function (v) { return v > 0; });
-    if (hasData && typeof window.slmSpark === 'function') {
-      evSp.innerHTML = window.slmSpark(cVals, { w: 600, h: 150, color: 'var(--cyan)' });
-      var sv2 = evSp.querySelector('svg'); if (sv2) sv2.style.height = '150px';
+    if (clients.length === 0) {
+      evb.appendChild(EL('p', { className: 'muted', style: 'padding:16px;text-align:center',
+        text: 'No host activity in the last 5 minutes. This does not mean an integration is uninstalled.',
+      }));
     } else {
-      evSp.appendChild(EL('p', { className: 'muted', style: 'padding:32px;text-align:center',
-        text: 'No event history in this period.' }));
+      clients.forEach(function (client) {
+        var row = EL('div', { className: 'list-row' });
+        row.appendChild(EL('b', { style: 'flex:1', text: String(client.kind || 'other') }));
+        row.appendChild(EL('span', { className: 'muted',
+          text: 'active ' + Number(client.last_seen_seconds_ago || 0) + 's ago',
+        }));
+        evb.appendChild(row);
+      });
     }
-    evb.appendChild(evSp);
-    // TODO: GET /api/clients — no live connected-client session data available via these endpoints.
-    // tool-events captures tool invocations but not distinct client identities or session counts.
-    evb.appendChild(EL('p', {
-      className: 'muted',
-      style: 'margin-top:12px;font-size:13px',
-      text: 'Bars above represent all tool invocations logged to this daemon. ' +
-            'A dedicated client-session endpoint is not yet exposed via the public API.',
-    }));
     evc.appendChild(evb);
     sec.appendChild(evc);
 
-    // Empty-state clients table
+    // Configured integrations are installation/sync state, not client activity.
     var tc = EL('div', { className: 'card' });
     var tch = EL('div', { className: 'card-head' });
-    tch.appendChild(EL('h3', { text: 'Clients' }));
+    tch.appendChild(EL('h3', { text: 'Configured integrations' }));
+    tch.appendChild(EL('span', { className: 'sub', text: 'installation and sync availability' }));
     tc.appendChild(tch);
     var tcb = EL('div', { className: 'card-pad' });
-    tcb.appendChild(EL('p', {
-      className: 'muted',
-      style: 'padding:16px;text-align:center;font-size:13px',
-      text: 'Client details are not yet available via API. Coming in a future daemon release.',
-    }));
+    Object.keys(configuredData).sort().forEach(function (kind) {
+      var state = configuredData[kind] || {};
+      var row = EL('div', { className: 'list-row' });
+      row.appendChild(EL('span', { style: 'flex:1', text: kind.replace(/_/g, ' ') }));
+      row.appendChild(EL('span', {
+        className: 'badge ' + (state.active ? 'ok' : 'warn'),
+        text: state.active ? 'available' : (state.reason || 'not available'),
+      }));
+      tcb.appendChild(row);
+    });
     tc.appendChild(tcb);
     sec.appendChild(tc);
     return sec;
@@ -645,7 +703,7 @@
   // ======================================================================
   // Tab: SOURCE QUALITY
   // ======================================================================
-  function buildSourceQuality(learning) {
+  function buildSourceQuality(learning, living) {
     var sec = EL('section', { className: 'tabpane', 'data-p': 'sources' });
     var scores = (learning && learning.source_scores) || {};
     var entries = Object.keys(scores).sort(function (a, b) {
@@ -657,13 +715,27 @@
     ch.appendChild(EL('span', { className: 'sub', text: 'persisted source-outcome posterior · 0.0–1.0' }));
     card.appendChild(ch);
     var cb = EL('div', { className: 'card-pad' });
-    if (entries.length === 0) {
+    var aggregate = (living && living.source_quality) || {};
+    var observedSources = Number(aggregate.observed_sources || 0);
+    if (observedSources === 0) {
+      cb.appendChild(EL('p', {
+        className: 'muted',
+        style: 'padding:16px;text-align:center;font-size:13px',
+        text: 'No source-quality evidence has settled yet. Recall hits alone do not establish source quality.',
+      }));
+    } else if (entries.length === 0) {
       cb.appendChild(EL('p', {
         className: 'muted',
         style: 'padding:16px;text-align:center;font-size:13px',
-        text: 'No source-quality observations yet. Recall hits alone do not establish source quality.',
+        text: String(observedSources) + ' sources have evidence, but no per-source posterior is available yet.',
       }));
     } else {
+      cb.appendChild(EL('p', {
+        className: 'muted',
+        style: 'font-size:13px;margin-bottom:16px',
+        text: String(observedSources) + ' sources with observed mean quality ' +
+          Number(aggregate.mean_quality).toFixed(3) + '.',
+      }));
       entries.forEach(function (k) {
         var v = Number(scores[k]);
         var row = EL('div', { style: 'margin-bottom:14px' });
@@ -765,6 +837,8 @@
       var learning = results[0] || {};
       var behavioral = results[1] || {};
       var events = ((results[3] && results[3].events) || []);
+      var brain = results[4] || {};
+      var living = brain.living_brain || {};
       var dateMap = buildDateMap(events);
       var pCount = ((behavioral.patterns) || []).length;
 
@@ -778,11 +852,11 @@
       container.replaceChildren(
         head,
         buildTabRow(pCount),
-        buildOverview(learning, behavioral, dateMap),
+        buildOverview(learning, behavioral, dateMap, living),
         buildReward(behavioral),
         buildBehaviour(learning, behavioral),
-        buildClients(dateMap),
-        buildSourceQuality(learning)
+        buildClients(living, brain.cross_platform),
+        buildSourceQuality(learning, living)
       );
       wireTabs(container);
     }).catch(function (err) { showError(container, err); });

package/src/superlocalmemory/ui/js/od-settings.js

@@ -302,7 +302,14 @@
         var mi = q('model'); if (mi) mi.value = d.model || '';
         var k = q('apikey');
         if (k) k.placeholder = d.has_key ? '(key saved — enter new to replace)' : 'sk-...';
-        var ep = q('endpoint'); if (ep) ep.value = d.endpoint || '';
+        // GET /mode deliberately returns only a redacted host.  Showing that
+        // host as the editable value would turn a passive reload + save into a
+        // destructive replacement of the real URL, so it is display-only.
+        var ep = q('endpoint');
+        if (ep) {
+          ep.value = '';
+          ep.placeholder = d.endpoint || 'http://localhost:11434';
+        }
       }).catch(function () {});
   }
   function saveMode() {