@agentmemory/agentmemory 0.9.30 → 0.9.32

package/dist/viewer/index.html

@@ -1005,8 +1005,8 @@
     .cb-open { border-color: var(--accent); color: var(--accent); }
     .cb-half-open { border-color: var(--yellow); color: var(--yellow); }
 
-    .worker-row { display: flex; align-items: center; gap: 8px; padding: 4px 0; font-size: 12px; font-family: var(--font-ui); }
-    .worker-dot { width: 8px; height: 8px; }
+    .worker-row { display: flex; align-items: center; flex-wrap: wrap; overflow-wrap: anywhere; gap: 8px; padding: 4px 0; font-size: 12px; font-family: var(--font-ui); }
+    .worker-dot { width: 8px; height: 8px; flex-shrink: 0; background: var(--ink-faint); }
     .worker-dot.running { background: var(--green); }
     .worker-dot.stopped { background: var(--accent); }
     .worker-dot.starting { background: var(--yellow); }
@@ -1521,28 +1521,17 @@
     var params = new URLSearchParams(window.location.search);
     var paramPort = params.get('port');
     var locPort = window.location.port;
-    var wsProto = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
-    var REST, WS_URL, WS_DIRECT_URL, wsPort;
+    var REST;
     if (paramPort) {
       var resolvedPort = parseInt(paramPort) === 3111 ? '3113' : paramPort;
       REST = window.location.protocol + '//' + window.location.hostname + ':' + resolvedPort;
-      wsPort = params.get('wsPort') || String(parseInt(resolvedPort) - 1);
-      WS_URL = wsProto + '//' + window.location.hostname + ':' + wsPort;
-      WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
     } else if (locPort) {
       var resolvedPort = parseInt(locPort) === 3111 ? '3113' : locPort;
       REST = window.location.protocol + '//' + window.location.hostname + ':' + resolvedPort;
-      wsPort = params.get('wsPort') || String(parseInt(resolvedPort) - 1);
-      WS_URL = wsProto + '//' + window.location.hostname + ':' + wsPort;
-      WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
     } else {
       REST = window.location.origin;
-      wsPort = params.get('wsPort');
-      WS_URL = wsPort
-        ? wsProto + '//' + window.location.hostname + ':' + wsPort
-        : wsProto + '//' + window.location.host;
-      WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
     }
+    var LIVE_EVENTS_URL = REST + '/agentmemory/viewer/events';
 
     var dateEl = document.getElementById('dateline');
     if (dateEl) dateEl.textContent = new Date().toLocaleDateString('en-US', { weekday: 'short', year: 'numeric', month: 'short', day: 'numeric' });
@@ -1654,12 +1643,12 @@
       eventLoop: { term: 'Event loop delay', text: 'How far behind the worker is in handling work. Under 20 ms is healthy; a large value means it is busy or blocked.' },
       uptime: { term: 'Uptime', text: 'How long the agentmemory worker has been running since it last started.' },
       health: { term: 'Health status', text: 'Healthy means everything is normal. Degraded means something needs attention but memory still works. Critical means a core part is failing.' },
-      stateBackend: { term: 'State store', text: 'Where the engine keeps every record: file (local files on this machine, the default) or redis (a Redis server set by AGENTMEMORY_STATE_BACKEND and AGENTMEMORY_REDIS_URL). ok means a test write and read just succeeded; the number is how long it took.' },
-      engineConnection: { term: 'Engine connection', text: 'Whether the agentmemory worker is connected to the iii engine that stores its data and runs its functions.' },
-      live: { term: 'Live updates', text: 'The viewer keeps one streaming connection open and updates every page the moment data changes. Nothing is refreshed on a timer.' },
+      stateBackend: { term: 'State store', text: 'Where the state worker keeps every record: file (local files on this machine, the default) or redis (a Redis server set by AGENTMEMORY_STATE_BACKEND and AGENTMEMORY_REDIS_URL). ok means a test write and read just succeeded; the number is how long it took.' },
+      engineConnection: { term: 'Engine connection', text: 'Whether the agentmemory worker is connected to the iii engine that routes calls between workers.' },
+      live: { term: 'Live updates', text: 'The viewer keeps one SSE connection open and updates every page the moment data changes. Nothing is refreshed on a timer.' },
       flags: { term: 'Feature flags', text: 'Optional features that are on or off in this install. Off features leave some pages empty; each one lists the setting that turns it on.' },
       audit: { term: 'Audit log', text: 'A record of every change agentmemory made to stored data: saves, deletes, imports, consolidation runs. Use it to see who changed what and when.' },
-      workers: { term: 'Workers', text: 'Processes connected to the iii engine. agentmemory runs as one worker.' },
+      workers: { term: 'Workers', text: 'Application workers provide memory, storage and HTTP. Engine details lists the coordinator and internal runtime services; available means a service is registered, not that an optional feature is enabled.' },
       latency: { term: 'Average latency', text: 'Average time one call of the function took to finish.' },
       failureRate: { term: 'Failure rate', text: 'Share of calls that failed. Functions that need an LLM show as off, not failing, when no LLM provider is set.' },
       replay: { term: 'Replay', text: 'Plays back a past session step by step: prompts, responses and tool calls in the order they happened, with their real timing. Works for any session agentmemory recorded, from any connected agent.' },
@@ -1670,20 +1659,19 @@
     var state = {
       activeTab: 'dashboard',
       dashboard: { loaded: false },
-      graph: { loaded: false, loading: false, dirty: false, nodeMap: {}, edgeMap: {}, degrees: {}, rev: 0, localDegree: null, localDegreeRev: -1, stats: null, hidden: {}, search: '', searchOpen: false, searchIndex: 0, selectedId: null, detail: null, queryError: null, disabledInfo: null, warning: '', truncated: false, totalNodes: 0, totalEdges: 0, requestSeq: 0, fetches: 0, patches: 0, lastPatchAt: 0, fresh: {}, simStale: false, rebuildResult: '' },
+      graph: { loaded: false, loading: false, dirty: false, nodeMap: {}, edgeMap: {}, degrees: {}, rev: 0, localDegree: null, localDegreeRev: -1, stats: null, hidden: {}, search: '', searchOpen: false, searchIndex: 0, selectedId: null, detail: null, queryError: null, disabledInfo: null, warning: '', truncated: false, totalNodes: 0, totalEdges: 0, requestSeq: 0, searchRequestSeq: 0, resetSeq: 0, generation: undefined, fetches: 0, patches: 0, lastPatchAt: 0, fresh: {}, simStale: false, rebuildResult: '' },
       memories: { search: '', typeFilter: '', projectFilter: '', agentFilter: '', selectedId: null, nextCursor: null, loadingMore: false, searchIds: null, searchMode: '', searching: false, query: null, facets: null, checked: {}, editing: null, saving: false, pendingId: null, fetches: {}, diffId: null, error: '' },
       sessions: { selectedId: null, autoSelected: false, closed: false, nextCursor: null, loadingMore: false, filters: { q: '', project: '', agent: '', status: '' }, query: null, facets: null, detail: null, pendingObs: null, notice: null, summarizing: '' },
       audit: { opFilter: '', selectedIdx: null, from: '', to: '', q: '', query: null, loadingMore: false, exhausted: {}, fresh: {} },
       activity: { loaded: false, observations: [], sessionCount: 0, typeFilter: '', fileFilter: '', day: '' },
       lessons: { search: '', selectedId: null, projectFilter: '', notice: null, busy: '' },
-      actions: { frontier: [], statusFilter: '', search: '', selectedId: null, notice: null, busy: '' },
+      actions: { frontier: [], statusFilter: '', search: '', selectedId: null, notice: null, busy: '', detailLoading: '', detailAttemptedId: '', detailRequestFailedId: '', loadError: false },
       crystals: { search: '', selectedId: null },
       profile: { loaded: false, selectedProject: '', data: null, dataProject: '', userPicked: false, notice: null },
-      health: { error: null, checking: false, consolidating: false, reveal: '' },
+      health: { error: null, checking: false, consolidating: false, reveal: '', engineDetailsOpen: false },
       replay: { loaded: false, selectedId: '', timeline: null, cursor: 0, playing: false, speed: 1, timer: null, startAt: 0, offsetAt: 0, loadingTimeline: false, loadError: '', importPath: '', importing: false, importOpen: false, importStatus: null },
       flagsOpen: false,
       freshRows: {},
-      ws: null
     };
 
     var store = {
@@ -1714,7 +1702,7 @@
       memory: { path: 'memories?latest=true&limit=100&facets=true', key: 'memories' },
       session: { path: 'sessions?limit=100&facets=true', key: 'sessions' },
       lesson: { path: 'lessons', key: 'lessons' },
-      action: { path: 'actions', key: 'actions' },
+      action: { path: 'actions', key: 'actions', allPages: true },
       crystal: { path: 'crystals', key: 'crystals' },
       semantic: { path: 'semantic', key: 'facts', fallbackKey: 'semantic' },
       procedural: { path: 'procedural', key: 'procedures', fallbackKey: 'procedural' },
@@ -2314,6 +2302,20 @@
       store.entities[kind] = bucket;
     }
 
+    async function loadAllPages(spec, apiGet) {
+      var rows = [];
+      var cursor = null;
+      var result;
+      do {
+        var path = spec.path + '?limit=500' + (cursor ? '&cursor=' + encodeURIComponent(cursor) : '');
+        result = await apiGet(path);
+        if (result === null) return null;
+        rows.push.apply(rows, listOr([], result, spec.key, spec.fallbackKey));
+        cursor = result.nextCursor || null;
+      } while (cursor);
+      return Object.assign({}, result, { [spec.key]: rows });
+    }
+
     async function ensureLoaded(kind) {
       if (store.loaded[kind]) return;
       if (store.loading[kind]) return store.loading[kind];
@@ -2323,8 +2325,16 @@
         try {
           await bootGate;
           var seqAtStart = eventSeq;
-          var result = await apiGet(spec.path);
-          if (result === null) return;
+          var result;
+          if (spec.allPages) {
+            result = await loadAllPages(spec, apiGet);
+          } else {
+            result = await apiGet(spec.path);
+          }
+          if (result === null) {
+            if (kind === 'action') state.actions.loadError = true;
+            return;
+          }
           replaceBucket(kind, listOr([], result, spec.key, spec.fallbackKey));
           if (kind === 'memory') {
             state.memories.nextCursor = result.nextCursor || null;
@@ -2343,6 +2353,9 @@
           }
           replayEventsSince(seqAtStart, kind);
           store.loaded[kind] = true;
+          if (kind === 'action') state.actions.loadError = false;
+        } catch {
+          if (kind === 'action') state.actions.loadError = true;
         } finally {
           store.loading[kind] = null;
         }
@@ -2358,11 +2371,14 @@
       });
     }
 
-    async function loadSnapshot() {
+    async function loadSnapshot(retried) {
+      var resetSeq = state.graph.resetSeq;
       var snap = await apiGet('viewer/snapshot');
+      if (resetSeq !== state.graph.resetSeq) return retried ? false : loadSnapshot(true);
       if (!snap) return false;
       var graphBefore = store.graph && store.graph.updatedAt;
       var reconnect = !!store.snapshotAt;
+      noteGraphGeneration(snap.graph);
       applySnapshot(store, snap);
       renderFlagsChip();
       renderFlagsPanel();
@@ -2612,7 +2628,7 @@
 
       html += renderMemoryLayers(store.consolidationStatus, entityList('semantic'), entityList('procedural'));
 
-      html += '<details class="card" style="margin-top:16px;"><summary class="card-title" style="cursor:pointer;margin-bottom:0;border-bottom:none;">Function metrics and workers ' + help('functionCalls') + '</summary>';
+      html += '<details class="card" style="margin-top:16px;"><summary class="card-title" style="cursor:pointer;margin-bottom:0;border-bottom:none;">Function metrics ' + help('functionCalls') + '</summary>';
       if (fMetrics.length > 0) {
         var sorted = fMetrics.slice().sort(function(a, b) { return (b.totalCalls || 0) - (a.totalCalls || 0); });
         html += '<div class="table-wrap" style="margin-top:10px;"><table class="metric-table"><tr><th>Function</th><th style="text-align:right">Calls</th><th style="text-align:right">Failed</th><th style="text-align:right">Avg latency ' + help('latency') + '</th></tr>';
@@ -2627,14 +2643,7 @@
       } else {
         html += '<p style="font-size:12px;color:var(--ink-muted);margin-top:10px;">No function has run since the worker started. Calls appear here as agents observe, search and save.</p>';
       }
-      var workers = snap.workers || [];
-      if (workers.length > 0) {
-        html += '<div style="margin-top:12px;font-family:var(--font-ui);font-size:10px;letter-spacing:0.12em;text-transform:uppercase;color:var(--ink-muted);font-weight:700;">Workers ' + help('workers') + '</div>';
-        workers.forEach(function(w) {
-          var statusClass = w.status === 'running' ? 'running' : w.status === 'starting' ? 'starting' : 'stopped';
-          html += '<div class="worker-row"><span class="worker-dot ' + statusClass + '"></span><span style="color:var(--ink);font-weight:600;">' + esc(w.name) + '</span><span class="badge ' + (w.status === 'running' ? 'badge-green' : 'badge-muted') + '">' + esc(w.status) + '</span></div>';
-        });
-      }
+      html += '<p class="hnote"><a href="#health">Worker status and engine details &rarr;</a></p>';
       html += '</details>';
 
       setViewHtml(el, html);
@@ -2806,8 +2815,54 @@
       return graphNodeList().filter(function(n) { return !deg[n.id]; }).length;
     }
 
+    function clearGraphView() {
+      var g = state.graph;
+      g.resetSeq++;
+      g.requestSeq++;
+      g.searchRequestSeq++;
+      g.selectedId = null;
+      g.detail = null;
+      g.nodeMap = {};
+      g.edgeMap = {};
+      g.degrees = {};
+      g.fresh = {};
+      g.stats = null;
+      g.totalNodes = 0;
+      g.totalEdges = 0;
+      g.truncated = false;
+      g.loading = false;
+      g.loaded = false;
+      g.dirty = false;
+      g.queryError = null;
+      g.disabledInfo = null;
+      g.warning = '';
+      g.searchOpen = false;
+      g.rev++;
+      g.simStale = true;
+      if (graphReloadTimer) clearTimeout(graphReloadTimer);
+      graphReloadTimer = null;
+      graphSim.hoverId = null;
+      graphSim.drag = null;
+      graphSim.nodes = [];
+      graphSim.byId = {};
+      graphSim.edges = [];
+      graphSim.isolatedBox = null;
+      setRouteEntity('graph', '');
+      renderGraphDetail();
+      requestGraphDraw();
+    }
+
+    function noteGraphGeneration(data) {
+      if (!data) return;
+      var g = state.graph;
+      if (data.reset === true && data.source === 'items') store.graph = null;
+      if (data.reset === true || ('generation' in data && g.generation !== undefined && g.generation !== data.generation)) clearGraphView();
+      if ('generation' in data) g.generation = data.generation;
+    }
+
     function setGraphData(result) {
       var g = state.graph;
+      if (!(result.nodes || []).length && !result.truncated && !result.totalNodes && (g.selectedId || g.detail || Object.keys(g.nodeMap).length)) clearGraphView();
       var nodeMap = {};
       var edgeMap = {};
       (result.nodes || []).forEach(function(n) { if (n && n.id) nodeMap[n.id] = n; });
@@ -2841,6 +2896,7 @@
       g.loading = false;
       if (result === null) {
         var stats = await api('graph/stats', { readErrorBody: true });
+        if (seq !== g.requestSeq) return;
         if (stats && stats.error && stats.flag) {
           g.disabledInfo = stats;
           g.queryError = null;
@@ -2865,8 +2921,9 @@
 
     function applyGraphDelta(delta) {
       var g = state.graph;
-      if (!g.loaded || !delta) return false;
+      if (!delta || (!g.loaded && !delta.full)) return false;
       if (delta.full) {
+        if (!(delta.nodes || []).length && (g.selectedId || g.detail || Object.keys(g.nodeMap).length)) clearGraphView();
         var keepNodes = {};
         (delta.nodes || []).forEach(function(n) { keepNodes[n.id] = true; });
         Object.keys(g.nodeMap).forEach(function(id) { if (!keepNodes[id] && id !== g.selectedId) delete g.nodeMap[id]; });
@@ -2893,13 +2950,14 @@
       g.lastPatchAt = Date.now();
       Object.keys(touched).forEach(function(id) { g.fresh[id] = Date.now(); });
       if (g.selectedId && touched[g.selectedId] && g.detail && g.detail.id === g.selectedId) g.detail.stale = true;
+      g.loaded = true;
       return true;
     }
 
     function handleGraphChange(data) {
       var g = state.graph;
       if (!data) return;
-      if (!g.loaded) { g.dirty = true; return; }
+      noteGraphGeneration(data);
       if (data.source === 'snapshot') {
         if (data.delta && applyGraphDelta(data.delta)) {
           if (graphSim.canvas && state.activeTab === 'graph') { syncGraphSim(false); requestGraphDraw(); setTimeout(requestGraphDraw, 4200); }
@@ -2925,10 +2983,10 @@
 
     async function fetchGraphDetail(id) {
       var g = state.graph;
-      g.detail = { id: id, loading: true, data: null, error: '', stale: false };
+      var detail = g.detail = { id: id, loading: true, data: null, error: '', stale: false };
       renderGraphDetail();
       var res = await api('graph/node?id=' + encodeURIComponent(id), { readErrorBody: true });
-      if (!g.detail || g.detail.id !== id) return;
+      if (g.detail !== detail) return;
       if (!res || res.error) {
         g.detail = { id: id, loading: false, data: null, error: res && res.error ? res.error : 'request failed', stale: false };
       } else {
@@ -3584,7 +3642,7 @@
           title: 'The knowledge graph is off',
           what: 'Entities and relations agentmemory pulls out of what agents do.',
           why: esc(g.disabledInfo.enableHow || 'Graph extraction is disabled on this server.'),
-          steps: [{ label: 'Turn it on and restart:', cmd: 'export GRAPH_EXTRACTION_ENABLED=true\nexport ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory' }],
+          steps: [{ label: 'Turn it on and restart:', cmd: 'export GRAPH_EXTRACTION_ENABLED=true\nexport AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory' }],
           link: g.disabledInfo.docsHref ? { href: g.disabledInfo.docsHref, text: 'Knowledge graph docs' } : null
         });
       } else if (g.queryError) {
@@ -3604,7 +3662,7 @@
           steps: [
             { label: 'Build it now from every stored observation (spends LLM tokens when extraction is on):', cmd: curlPost('graph/build', {}) },
             { label: 'Or import a structural code graph made by graphify (no LLM needed):', cmd: curlPost('graph/import-graphify', { cwd: '/path/to/repo' }) },
-            { label: 'For typed entities and relations, turn on LLM extraction and restart:', cmd: 'export GRAPH_EXTRACTION_ENABLED=true\nexport ANTHROPIC_API_KEY=sk-ant-...' }
+            { label: 'For typed entities and relations, turn on LLM extraction and restart:', cmd: 'export GRAPH_EXTRACTION_ENABLED=true\nexport AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...' }
           ]
         }) + '<div class="graph-msg-actions"><button type="button" class="btn btn-primary" data-action="rebuild-graph">Build from observations</button></div>';
       }
@@ -3671,7 +3729,7 @@
       html += copyBtn('memory_graph_query { "startNodeId": ' + JSON.stringify(id) + ', "maxDepth": 1 }', 'MCP call').replace('>copy<', '>copy MCP call<');
       html += copyBtn(curlGet('graph/node?id=' + encodeURIComponent(id)), 'curl command').replace('>copy<', '>copy curl<');
       html += '</div>';
-      if (d && d.stale) html += '<div class="mem-note">This node changed on the live stream. <button type="button" class="linkish" data-action="graph-refresh-detail" data-node-id="' + esc(id) + '">Reload sources</button></div>';
+      if (d && d.stale) html += '<div class="mem-note">This node changed on the SSE feed. <button type="button" class="linkish" data-action="graph-refresh-detail" data-node-id="' + esc(id) + '">Reload sources</button></div>';
 
       var rels = graphDetailRelations(id);
       var relTotal = data && typeof data.relationsTotal === 'number' ? Math.max(data.relationsTotal, rels.length) : rels.length;
@@ -3761,7 +3819,7 @@
       html += '<div class="go-intro"><strong>Knowledge graph</strong> ' + help('graph') + ' The files, functions, concepts and decisions agents worked with, and how they relate. Click a node to see its relations and the observations it came from.</div>';
       html += '<div class="go-stats"><div><b>' + fmtNum(t.nodes) + '</b><span>nodes ' + help('graphNode') + '</span></div><div><b>' + fmtNum(t.edges) + '</b><span>relations ' + help('graphEdge') + '</span></div><div><b>' + fmtNum(iso) + '</b><span>unlinked ' + help('graphIsolated') + '</span></div></div>';
       if (shown >= 3 && (iso / shown > 0.4 || t.edges < shown / 2)) {
-        html += '<div class="mem-note go-sparse"><b>Sparse graph.</b> ' + fmtNum(iso) + ' of ' + fmtNum(shown) + ' nodes have no relations yet. ' + esc(graphLlmNote()) + (graphLlmMode() !== 'llm' ? cmdBlock('export GRAPH_EXTRACTION_ENABLED=true\nexport ANTHROPIC_API_KEY=sk-ant-...') : '') + '</div>';
+        html += '<div class="mem-note go-sparse"><b>Sparse graph.</b> ' + fmtNum(iso) + ' of ' + fmtNum(shown) + ' nodes have no relations yet. ' + esc(graphLlmNote()) + (graphLlmMode() !== 'llm' ? cmdBlock('export GRAPH_EXTRACTION_ENABLED=true\nexport AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...') : '') + '</div>';
       }
       if (g.truncated && shown < t.nodes) html += '<div class="mem-note">Showing the ' + fmtNum(shown) + ' most connected of ' + fmtNum(t.nodes) + ' nodes. Search finds the rest on the server.</div>';
       if (g.warning) html += '<div class="mem-note">' + esc(g.warning) + '</div>';
@@ -3796,7 +3854,7 @@
       html += '<div class="empty-step-label" style="margin-top:8px;">Query it from an agent:</div>' + cmdBlock('memory_graph_query { "query": "checkout" }');
       html += '</div>';
       if (g.rebuildResult) html += '<div class="mem-note">' + esc(g.rebuildResult) + '</div>';
-      html += '<div class="go-live">' + (g.patches ? 'Patched ' + fmtNum(g.patches) + ' time' + (g.patches === 1 ? '' : 's') + ' from the live stream, last ' + relTime(new Date(g.lastPatchAt).toISOString()) + '.' : 'Updates arrive on the live stream; nothing refreshes on a timer.') + ' ' + help('live') + '</div>';
+      html += '<div class="go-live">' + (g.patches ? 'Patched ' + fmtNum(g.patches) + ' time' + (g.patches === 1 ? '' : 's') + ' from the SSE feed, last ' + relTime(new Date(g.lastPatchAt).toISOString()) + '.' : 'Updates arrive on the SSE feed; nothing refreshes on a timer.') + ' ' + help('live') + '</div>';
       html += '</div>';
       setViewHtml(host, html);
     }
@@ -4021,9 +4079,11 @@
 
     async function searchGraphRemote(q) {
       var g = state.graph;
+      var seq = ++g.searchRequestSeq;
       var box = document.getElementById('graph-search-results');
       if (box) { box.hidden = false; box.innerHTML = '<div class="gs-empty">Searching all nodes…</div>'; }
       var res = await apiPost('graph/query', { query: q, limit: 50 });
+      if (seq !== g.searchRequestSeq) return;
       if (!res) {
         if (box) box.innerHTML = '<div class="gs-empty">The server search failed.</div>';
         return;
@@ -4097,7 +4157,7 @@
       try {
         var result = await apiPost('graph/build', {});
         g.rebuildResult = result && result.success
-          ? 'Rebuilt from ' + (result.sessions || 0) + ' sessions: ' + (result.nodes || 0) + ' nodes and ' + (result.edges || 0) + ' relations extracted. New ones arrive on the live stream.'
+          ? 'Rebuilt from ' + (result.sessions || 0) + ' sessions: ' + (result.nodes || 0) + ' nodes and ' + (result.edges || 0) + ' relations extracted. New ones arrive on the SSE feed.'
           : 'The rebuild failed. Check the server log.';
       } finally {
         graphRebuilding = false;
@@ -4505,7 +4565,7 @@
       var mem = store.entities.memory[id];
       if (!mem) {
         if (m.pendingId === id) {
-          setViewHtml(panel, '<div class="detail-panel mem-detail"><div class="mem-detail-head"><span>Saving the new version</span>' + memoryCloseBtn() + '</div><div class="mem-note">Saved. Waiting for the new version to arrive on the live stream…</div>' + skeleton(4) + '</div>');
+          setViewHtml(panel, '<div class="detail-panel mem-detail"><div class="mem-detail-head"><span>Saving the new version</span>' + memoryCloseBtn() + '</div><div class="mem-note">Saved. Waiting for the new version to arrive on the SSE feed…</div>' + skeleton(4) + '</div>');
           return;
         }
         if (!m.fetches[id]) fetchMemoryVersion(id);
@@ -6144,7 +6204,7 @@
       var body = '<h3>Summarize this session?</h3>' +
         '<p>An LLM reads the observations of <b>' + esc(sessionDisplayName(s)) + '</b> (' + fmtNum(s.observationCount || 0) + ') and writes a short summary: a title, what happened and the key decisions. The summary is shown here and in the session list, and later feeds consolidation into facts and procedures. Running it again replaces the old summary.</p>';
       if (!llm) {
-        body += '<div class="mem-note err">No LLM provider is configured, so Summarize would do nothing. Set a key and restart agentmemory:</div>' + cmdBlock('export ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory');
+        body += '<div class="mem-note err">No LLM provider is configured, so Summarize would do nothing. Set a key and restart agentmemory:</div>' + cmdBlock('export AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory');
         body += '<div class="modal-actions" style="margin-top:14px;"><button class="btn" data-action="close-modal">Close</button></div>';
       } else {
         body += '<p style="font-size:11px;">Same call from a terminal: <code>' + esc(curlPost('summarize', { sessionId: id }).replace(/\s*\\\n\s*/g, ' ')) + '</code></p>';
@@ -6404,7 +6464,7 @@
       var res = await apiPost('lessons/strengthen', { lessonId: id });
       l.busy = '';
       l.notice = res && res.success !== false
-        ? { id: id, html: 'Recorded one more use. Confidence and uses update here from the live stream.' }
+        ? { id: id, html: 'Recorded one more use. Confidence and uses update here from the SSE feed.' }
         : { id: id, err: true, html: 'Strengthen failed' + (res && res.error ? ': ' + esc(res.error) : '. Check that agentmemory is running.') };
       renderLessons();
     }
@@ -6497,12 +6557,15 @@
     function renderActions() {
       var el = document.getElementById('view-actions');
       var a = state.actions;
-      if (!store.loaded.action) {
+      var all = entityList('action');
+      if (!store.loaded.action && !all.length) {
         listDetailShell(el, 'actions', '');
-        setViewHtml(document.getElementById('actions-list'), skeleton(8));
+        setViewHtml(document.getElementById('actions-list'), a.loadError
+          ? '<div class="empty-state compact"><div class="empty-title">Could not load actions</div><div class="empty-what">Check that agentmemory is running, then try again.</div><button type="button" class="btn" data-action="action-list-retry">Retry</button></div>'
+          : skeleton(8));
+        renderActionDetail({});
         return;
       }
-      var all = entityList('action');
       var rows = actionRows();
       var frontierIds = {};
       (a.frontier || []).forEach(function(f) {
@@ -6560,24 +6623,82 @@
         html += '</tbody></table></div>';
         if (all.length < 8) html += usageCard('action');
       }
+      if (a.loadError) {
+        html = '<div class="inline-note"><strong>Could not refresh actions.</strong> Showing previously loaded actions. <button type="button" class="btn" data-action="action-list-retry">Retry</button></div>' + html;
+      }
       setViewHtml(document.getElementById('actions-list'), html);
+      renderActionDetail(frontierIds);
+    }
+
+    function renderActionDetail(frontierIds) {
+      var a = state.actions;
       var detail = document.getElementById('actions-detail');
       var sel = a.selectedId ? store.entities.action[a.selectedId] : null;
       if (a.selectedId && !sel) {
-        setViewHtml(detail, '<div id="action-detail" class="detail-panel mem-detail"><div class="mem-detail-head"><span>Action</span><button type="button" class="icon-btn icon-close" data-action="action-close" aria-label="Close action details">close</button></div>' + emptyState({
+        ensureActionById(a.selectedId);
+        var loadingAction = a.detailLoading === a.selectedId;
+        var actionBody = loadingAction ? '<div class="empty-state compact"><div class="empty-title">Loading action…</div></div>' : a.detailRequestFailedId === a.selectedId
+          ? '<div class="empty-state compact"><div class="empty-title">Could not load action</div><div class="empty-what">Check that agentmemory is running, then try again.</div><button type="button" class="btn" data-action="action-retry">Retry</button></div>'
+          : emptyState({
           compact: true,
           icon: '&#128269;',
           title: 'Action not found',
           what: 'Action links anywhere in the viewer open this panel by id.',
           why: 'No action has the id <code>' + esc(a.selectedId) + '</code>. It was removed, or the link comes from another install.',
           steps: [{ label: 'Check from a terminal:', cmd: curlGet('actions/get?actionId=' + encodeURIComponent(a.selectedId)) }]
-        }) + '</div>');
+        });
+        setViewHtml(detail, '<div id="action-detail" class="detail-panel mem-detail"><div class="mem-detail-head"><span>Action</span><button type="button" class="icon-btn icon-close" data-action="action-close" aria-label="Close action details">close</button></div>' + actionBody + '</div>');
       } else {
         setViewHtml(detail, sel ? actionDetailHtml(sel, !!frontierIds[sel.id]) : '');
       }
       document.getElementById('actions-layout').classList.toggle('has-detail', !!detail.firstElementChild);
     }
 
+    async function ensureActionById(id) {
+      var a = state.actions;
+      if (!id || store.entities.action[id] || a.detailLoading === id || a.detailAttemptedId === id) return;
+      a.detailAttemptedId = id;
+      a.detailLoading = id;
+      try {
+        var result = await apiGet('actions/get?actionId=' + encodeURIComponent(id));
+        if (result && result.success && result.action && result.action.id) {
+          store.entities.action[result.action.id] = result.action;
+          a.detailRequestFailedId = '';
+          renderActions();
+        } else if (result === null) {
+          a.detailRequestFailedId = id;
+        }
+      } catch (_) {
+        a.detailRequestFailedId = id;
+      } finally {
+        if (a.detailLoading === id) {
+          a.detailLoading = '';
+          if (!store.entities.action[id]) renderActions();
+        }
+      }
+    }
+
+    function retryActionById(id) {
+      var a = state.actions;
+      if (a.detailLoading === id) return;
+      a.detailAttemptedId = '';
+      a.detailRequestFailedId = '';
+      return ensureActionById(id);
+    }
+
+    async function retryActionList() {
+      if (store.loading.action) return store.loading.action;
+      state.actions.loadError = false;
+      store.loaded.action = false;
+      renderActions();
+      await ensureLoaded('action');
+      if (state.actions.selectedId && !store.entities.action[state.actions.selectedId]) {
+        state.actions.detailAttemptedId = '';
+        state.actions.detailRequestFailedId = '';
+      }
+      renderActions();
+    }
+
     async function setActionStatus(id, status) {
       var a = state.actions;
       a.busy = id;
@@ -6585,7 +6706,7 @@
       var res = await apiPost('actions/update', { actionId: id, status: status });
       a.busy = '';
       a.notice = res && res.success !== false
-        ? { id: id, html: 'Status set to <b>' + esc(status) + '</b>. Ready markers update from the live stream.' }
+        ? { id: id, html: 'Status set to <b>' + esc(status) + '</b>. Ready markers update from the SSE feed.' }
         : { id: id, err: true, html: 'Update failed' + (res && res.error ? ': ' + esc(res.error) : '. Check that agentmemory is running.') };
       renderActions();
     }
@@ -6615,7 +6736,7 @@
             { label: 'Crystallize every finished action now:', cmd: curlPost('crystals/auto', {}) },
             { label: 'Or from an agent, for specific actions:', cmd: 'memory_crystallize { "actionIds": ["act_..."] }' }
           ] : [
-            { label: 'Set an LLM key and restart agentmemory:', cmd: 'export ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory' },
+            { label: 'Set an LLM key and restart agentmemory:', cmd: 'export AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...\nnpx @agentmemory/agentmemory' },
             { label: 'Then crystallize finished actions:', cmd: curlPost('crystals/auto', {}) }
           ],
           link: { href: 'https://github.com/rohitg00/agentmemory#crystals', text: 'How crystals are built' }
@@ -6679,6 +6800,8 @@
         return true;
       }
       if (action === 'action-close') { state.actions.selectedId = null; setRouteEntity('actions', ''); renderActions(); return true; }
+      if (action === 'action-retry') { retryActionById(state.actions.selectedId); return true; }
+      if (action === 'action-list-retry') { retryActionList(); return true; }
       if (action === 'action-set-status') { setActionStatus(target.getAttribute('data-action-id'), target.getAttribute('data-status')); return true; }
       if (action === 'action-clear-filters') { state.actions.search = ''; state.actions.statusFilter = ''; var ai = document.getElementById('actions-search'); if (ai) ai.value = ''; renderActions(); return true; }
       if (action === 'activity-type' || action === 'activity-file' || action === 'activity-day' || action === 'activity-clear') { handleActivityAction(action, target); return true; }
@@ -7051,7 +7174,7 @@
     }
 
     var BM25_EXPLAINER = 'The keyword index holds observations, memories and lessons, so its total is larger than the observation count.';
-    var LLM_KEY_FIX = 'Add one LLM provider key (for example ANTHROPIC_API_KEY or OPENAI_API_KEY) to ~/.agentmemory/.env and restart.';
+    var LLM_KEY_FIX = 'Set AGENTMEMORY_LLM_PROVIDER and that provider\'s key (for example AGENTMEMORY_LLM_PROVIDER=anthropic and ANTHROPIC_API_KEY) in ~/.agentmemory/.env and restart.';
 
     function hrow(label, valueHtml, helpKey, note) {
       return '<div class="detail-row"><div class="dl">' + esc(label) + (helpKey ? ' ' + help(helpKey) : '') + '</div><div class="dv">' + valueHtml + (note ? '<div class="hnote">' + note + '</div>' : '') + '</div></div>';
@@ -7079,7 +7202,7 @@
       }
       if (store.lastHealthAt && Date.now() - store.lastHealthAt > HEALTH_STALE_MS) {
         var secs = Math.round((Date.now() - store.lastHealthAt) / 1000);
-        return '<div class="hstale" id="health-live-state"><strong>Stale: no health report for ' + secs + 's.</strong> Reports normally arrive every 30 seconds. The stream is connected, so the worker is busy or the iii engine is paused' + (r && r.service && r.service.stateBackend === 'redis' ? ', or Redis restarted: the engine stops relaying live events after a Redis restart until agentmemory restarts' : '') + '. The numbers below are from ' + esc(last) + '.' +
+        return '<div class="hstale" id="health-live-state"><strong>Stale: no health report for ' + secs + 's.</strong> Reports normally arrive every 30 seconds. The SSE feed is connected, but the worker may be busy or unable to publish a health report. The numbers below are from ' + esc(last) + '.' +
           '<div style="margin-top:6px;">Fix: wait a minute; if it stays stale, press Re-check now for the full report, check the server log and restart agentmemory.</div></div>';
       }
       return '';
@@ -7105,7 +7228,7 @@
       }
       html += '<div class="verdict"><span class="verdict-badge ' + esc(level) + '">' + esc(badgeText) + '</span><div style="min-width:0;flex:1;">' +
         '<div class="verdict-text">' + esc(text) + '</div>' +
-        '<div class="verdict-meta">' + (r ? 'Report ' + relTime(r.checkedAt) + ' · ' : '') + 'updates every 30 s over the live stream, no refresh needed ' + help('live') + '</div></div></div>';
+        '<div class="verdict-meta">' + (r ? 'Report ' + relTime(r.checkedAt) + ' · ' : '') + 'updates every 30 s over SSE, no refresh needed ' + help('live') + '</div></div></div>';
       html += healthStaleHtml(r);
       if (state.health.error) html += '<div class="mem-note err" style="margin-top:10px;">' + esc(state.health.error) + '</div>';
       if (r && r.problems.length) {
@@ -7120,20 +7243,45 @@
       return html + '</div>';
     }
 
+    function workerRowHtml(w) {
+      var status = w.status || 'unknown';
+      var statusClass = status === 'running' || status === 'connected' ? 'running' :
+        status === 'starting' || status === 'reconnecting' ? 'starting' :
+        ['stopped', 'disconnected', 'failed', 'error'].indexOf(status) !== -1 ? 'stopped' : 'unknown';
+      var badge = statusClass === 'running' ? 'badge-green' : statusClass === 'starting' ? 'badge-yellow' : statusClass === 'stopped' ? 'badge-red' : 'badge-muted';
+      return '<div class="worker-row"><span class="worker-dot ' + statusClass + '" aria-hidden="true"></span><strong>' + esc(w.name || w.id || 'Unnamed worker') + '</strong><span class="badge ' + badge + '">' + esc(status) + '</span></div>';
+    }
+
+    function workersHtml(workers, expanded) {
+      if (!workers || !workers.length) return '';
+      var application = [], internal = [];
+      workers.forEach(function(w) {
+        var engine = w.runtime === 'engine' || w.isolation === 'in-process' || w.name === 'compose';
+        (engine ? internal : application).push(w);
+      });
+      var html = '<div style="margin-top:16px;"><div class="card-title">Workers ' + help('workers') + '</div>';
+      html += application.map(workerRowHtml).join('');
+      if (internal.length) {
+        html += '<details id="health-engine-details"' + (expanded ? ' open' : '') + ' style="margin-top:12px;"><summary style="cursor:pointer;">Engine details (' + internal.length + ')</summary>' +
+          '<p class="hnote">Runtime coordination and internal services. Available means registered; it does not indicate whether an optional feature such as telemetry is enabled.</p>' +
+          internal.map(workerRowHtml).join('') + '</details>';
+      }
+      return html + '</div>';
+    }
+
     function engineCardHtml(r, snap) {
       var ports = (r && r.service && r.service.ports) || {};
       var kv = snap.kvConnectivity;
       var backend = r && r.service ? r.service.stateBackend : null;
       var streamText = conn.state === 'live' ? 'live' : conn.state;
       return '<div class="card"><div class="card-title">Engine and connection ' + help('engineConnection') + '</div>' +
-        hrow('Engine connection', esc(snap.connectionState || 'unknown'), 'engineConnection', 'The worker\'s link to the iii engine, which stores the data and runs the functions.') +
-        ((kv || backend) ? hrow('State store', esc((backend ? backend + (kv ? ' · ' : '') : '') + (kv ? kv.status + (kv.latencyMs !== undefined ? ' · ' + kv.latencyMs + ' ms' : '') + (kv.error ? ' · ' + kv.error : '') : '')), 'stateBackend', backend === 'redis' ? 'Stored in Redis (AGENTMEMORY_STATE_BACKEND=redis). If Redis restarts, restart agentmemory so the live stream resumes.' : 'Stored in the engine\'s local files (the default). Set AGENTMEMORY_STATE_BACKEND=redis to use Redis.') : '') +
-        hrow('Viewer stream', esc(streamText), 'live', 'This page\'s own connection. Offline means the numbers here stop changing.') +
-        (snap.streamRelay ? hrow('Redis event relay', esc(snap.streamRelay), 'live', snap.streamRelay === 'down' ? 'The engine stopped relaying live events through Redis, usually after Redis restarted. Data is still saved. Restart agentmemory to resume live updates.' : 'A test event sent through Redis every 30 seconds came back to the worker.') : '') +
+        hrow('Engine connection', esc(snap.connectionState || 'unknown'), 'engineConnection', 'The worker\'s link to the iii engine, which routes calls between workers.') +
+        ((kv || backend) ? hrow('State store', esc((backend ? backend + (kv ? ' · ' : '') : '') + (kv ? kv.status + (kv.latencyMs !== undefined ? ' · ' + kv.latencyMs + ' ms' : '') + (kv.error ? ' · ' + kv.error : '') : '')), 'stateBackend', backend === 'redis' ? 'The state worker stores records in Redis (AGENTMEMORY_STATE_BACKEND=redis).' : 'The state worker stores records in local files (the default). Set AGENTMEMORY_STATE_BACKEND=redis to use Redis.') : '') +
+        hrow('Viewer feed', esc(streamText), 'live', 'This page\'s own connection. Offline means the numbers here stop changing.') +
         hrow('Uptime', esc(formatUptime(snap.uptimeSeconds)), 'uptime') +
-        hrow('Version', esc('v' + (store.version || (r && r.service.version) || '?') + (r ? ' · engine ' + r.service.engineVersion : ''))) +
-        hrow('Ports', esc('REST ' + (ports.rest || '?') + ' · streams ' + (ports.streams || '?') + ' · viewer ' + (ports.viewer || 'off'))) +
-        '</div>';
+        hrow('Version', esc('v' + (store.version || (r && r.service.version) || '?') + (r ? ' · engine pinned ' + r.service.enginePinnedVersion : ''))) +
+        hrow('Ports', esc('REST ' + (ports.rest || '?') + ' · viewer ' + (ports.viewer || 'off'))) +
+        workersHtml(snap.workers, state.health.engineDetailsOpen) + '</div>';
     }
 
     function legText(leg) {
@@ -7152,7 +7300,7 @@
       html += hrow('Keyword index', esc(fmtNum(idx.bm25Documents) + ' documents'), 'bm25',
         (b ? esc(fmtNum(b.observations) + ' observations + ' + fmtNum(b.memories) + ' memories + ' + fmtNum(b.lessons) + ' lessons. ') : '') + esc(BM25_EXPLAINER));
       html += hrow('Vector index', hasVectors ? esc(fmtNum(idx.vectorDocuments) + ' vectors') : 'off', 'vector',
-        hasVectors ? 'Meaning-based search. Each vector is one embedded record.' : 'No embedding provider, so search is keyword only. Set an embedding provider key (for example OPENAI_API_KEY) and restart.');
+        hasVectors ? 'Meaning-based search. Each vector is one embedded record.' : 'No embedding provider, so search is keyword only. Set EMBEDDING_PROVIDER (local runs on-device; openai, voyage, cohere, gemini or openrouter also need that provider\'s key) and restart.');
       var bfState = ri.vectorBackfillState;
       var bfNote = bfState === 'paused' ? 'Paused because the embedding provider did not return vectors. Retried on the next start.' :
         bfState === 'waiting-for-opt-in' ? 'Waiting for AGENTMEMORY_VECTOR_BACKFILL=all and a restart.' :
@@ -7168,17 +7316,18 @@
             'New and removed vectors are written here right away and replayed after a crash, so nothing is embedded twice. Each save empties it.');
         }
       }
-      html += hrow('Graph', esc(fmtNum(c.graphNodes) + ' nodes · ' + fmtNum(c.graphEdges) + ' edges'), 'graph', store.graph && store.graph.updatedAt ? 'Snapshot rebuilt ' + esc(timeAgo(store.graph.updatedAt)) + '.' : '');
+      html += hrow('Graph', esc(fmtNum(c.graphNodes) + ' nodes · ' + fmtNum(c.graphEdges) + ' edges'), 'graph', store.graph && store.graph.updatedAt ? 'Graph index updated ' + esc(timeAgo(store.graph.updatedAt)) + '.' : '');
       if (r && r.graphCompaction) html += graphCompactionRowHtml(r.graphCompaction);
       return html + '</div>';
     }
 
     function graphCompactionRowHtml(g) {
       var where = g.phase === 'snapshot' || g.total === null || g.total === undefined ? (g.phase || 'nodes') : g.phase + ' ' + fmtNum(g.processed || 0) + ' of ' + fmtNum(g.total);
-      var text = g.state === 'off' ? 'off' : g.state === 'pending' ? 'pending' : g.state === 'running' ? 'running, ' + where : g.state === 'failed' ? 'failed at ' + where : 'done';
+      var text = g.state === 'off' ? 'off' : g.state === 'pending' ? 'pending' : g.state === 'deferred' ? 'deferred' : g.state === 'running' ? 'running, ' + where : g.state === 'failed' ? 'failed at ' + where : 'done';
       var note = 'A one-time pass that trims each graph node and edge to its newest 32 source observations, so stores from older versions stop slowing graph search.';
       if (g.state === 'done') note = fmtNum(g.trimmed || 0) + ' records trimmed, ' + fmtNum(g.idsRemoved || 0) + ' ids removed' + (g.completedAt ? ', finished ' + timeAgo(g.completedAt) : '') + '. It does not run again.';
       else if (g.state === 'running') note += ' It runs in the background, resumes after a restart and stops by itself.';
+      else if (g.state === 'deferred') note = 'Compaction is deferred because it reads complete legacy graph scopes. Run it only during explicit maintenance.';
       else if (g.state === 'off') note = 'Turned off with AGENTMEMORY_GRAPH_COMPACT_ON_BOOT=false. Run it by hand if graph search is slow:';
       else if (g.state === 'failed') note = esc(g.error || 'unknown error') + '. It resumes on the next start. To run it now:';
       var cmd = g.state === 'off' || g.state === 'failed' ? cmdBlock(curlPost('graph/compact', {})) : '';
@@ -7193,7 +7342,7 @@
       html += hrow('LLM provider', noLlm ? '<span class="badge badge-muted">none</span>' : '<span class="badge badge-green">configured</span>', null,
         noLlm ? 'Capture, keyword and vector search, saved memories, lessons and the structural graph all work without one.' : 'Used for summaries, consolidation, typed graph extraction and optional compression.');
       if (noLlm && off.length) {
-        html += hrow('Off without an LLM', esc(off.join(', ')), null, esc(LLM_KEY_FIX) + cmdBlock("echo 'ANTHROPIC_API_KEY=sk-ant-...' >> ~/.agentmemory/.env"));
+        html += hrow('Off without an LLM', esc(off.join(', ')), null, esc(LLM_KEY_FIX) + cmdBlock("printf 'AGENTMEMORY_LLM_PROVIDER=anthropic\\nANTHROPIC_API_KEY=sk-ant-...\\n' >> ~/.agentmemory/.env"));
       }
       var emb = (r && r.provider.embeddings) || store.embeddingProvider || 'none';
       html += hrow('Embeddings', esc(emb === 'none' ? 'none (keyword search only)' : emb), 'vector', emb === 'none' ? 'Meaning-based search is off.' : 'The number in brackets is the vector size (dimensions) the provider returns.');
@@ -7312,7 +7461,7 @@
     }
 
     function consolidationWhyEmpty(cs, c) {
-      if (!cs.llmConfigured) return { text: 'No LLM provider is configured on this instance, so no session summaries are written and consolidation never runs. Semantic facts and procedures stay at zero.', cmd: "echo 'ANTHROPIC_API_KEY=sk-ant-...' >> ~/.agentmemory/.env" };
+      if (!cs.llmConfigured) return { text: 'No LLM provider is configured on this instance, so no session summaries are written and consolidation never runs. Semantic facts and procedures stay at zero.', cmd: "printf 'AGENTMEMORY_LLM_PROVIDER=anthropic\\nANTHROPIC_API_KEY=sk-ant-...\\n' >> ~/.agentmemory/.env" };
       if (!cs.enabled) return { text: 'CONSOLIDATION_ENABLED is set to false, so consolidation is switched off even though an LLM key exists. Remove that line from ~/.agentmemory/.env (or set it to true) and restart. Find it with:', cmd: 'grep -n CONSOLIDATION_ENABLED ~/.agentmemory/.env' };
       var t = cs.thresholds || {};
       if ((c.semantic || 0) === 0 && cs.summaries < (t.semanticMinSummaries || 5)) return { text: 'Not enough finished sessions yet: semantic facts need ' + (t.semanticMinSummaries || 5) + ' session summaries and there are ' + cs.summaries + '. End sessions normally (the Stop hook does it) so each one gets a summary.', cmd: curlPost('session/end', { sessionId: 'ses_...' }) };
@@ -7401,12 +7550,14 @@
       var snap = store.health || {};
       var idx = store.indexes || {};
       var c = store.counts || {};
-      var html = '<div class="inline-note"><strong>Health</strong> ' + help('health') + ' is the live version of the <a class="empty-link" href="' + esc(REST) + '/agentmemory/status" target="_blank" rel="noopener">/agentmemory/status</a> page: the same checks and verdict, pushed over the stream every 30 seconds. Every problem says what to do. Scroll down for how consolidation works.</div>';
+      var html = '<div class="inline-note"><strong>Health</strong> ' + help('health') + ' is the live version of the <a class="empty-link" href="' + esc(REST) + '/agentmemory/status" target="_blank" rel="noopener">/agentmemory/status</a> page: the same checks and verdict, pushed over SSE every 30 seconds. Every problem says what to do. Scroll down for how consolidation works.</div>';
       html += healthVerdictHtml(r);
       html += '<div class="hgrid">' + engineCardHtml(r, snap) + indexCardHtml(r, idx, c) + captureCardHtml(r) + llmCardHtml(r) + flagsCardHtml(r) + processCardHtml(snap) + recordsCardHtml(c) + '</div>';
       html += consolidationPanelHtml(store.consolidationStatus, c);
       html += functionsCardHtml(r);
       setViewHtml(el, html);
+      var details = document.getElementById('health-engine-details');
+      if (details) details.ontoggle = function() { state.health.engineDetailsOpen = details.open; };
       var reveal = state.health.reveal && document.getElementById('health-' + state.health.reveal);
       if (reveal) {
         state.health.reveal = '';
@@ -7611,14 +7762,12 @@
 
     var wsReconnectTimer = null;
     var wsRetries = 0;
-    var directFailed = true;
-    var directFailures = 0;
     var wsHasConnected = false;
     var wsOpenedAt = null;
-    var DIRECT_FAILURE_THRESHOLD = 2;
     var OFFLINE_AFTER_RETRIES = 3;
     var HEALTH_STALE_MS = 90000;
     var conn = { state: 'connecting', nextRetryAt: 0, lostAt: 0 };
+    var liveAbortController = null;
 
     function reconnectDelay(attempt) {
       var n = Math.max(1, attempt || 1);
@@ -7704,90 +7853,110 @@
     function reconnectNow() {
       if (wsReconnectTimer) clearTimeout(wsReconnectTimer);
       wsReconnectTimer = null;
-      directFailures = 0;
-      directFailed = true;
       conn.nextRetryAt = 0;
-      var ws = state.ws;
-      if (ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)) return;
+      if (liveAbortController) {
+        liveAbortController.abort();
+        liveAbortController = null;
+      }
       connectWs();
     }
 
-    var WS_CONNECT_TIMEOUT_MS = 5000;
+    function parseSseFrame(frame) {
+      var id = '';
+      var type = '';
+      var data = [];
+      frame.split(/\r?\n/).forEach(function(line) {
+        if (!line || line.charAt(0) === ':') return;
+        var colon = line.indexOf(':');
+        var field = colon < 0 ? line : line.slice(0, colon);
+        var value = colon < 0 ? '' : line.slice(colon + 1).replace(/^ /, '');
+        if (field === 'id') id = value;
+        else if (field === 'event') type = value;
+        else if (field === 'data') data.push(value);
+      });
+      if (!type || !data.length) return null;
+      try { return { id: id, type: type, data: JSON.parse(data.join('\n')) }; } catch (_) { return null; }
+    }
+
+    function consumeSseChunk(buffer, chunk) {
+      buffer += chunk;
+      var frames = [];
+      var match;
+      while ((match = /\r?\n\r?\n/.exec(buffer))) {
+        var frame = buffer.slice(0, match.index);
+        buffer = buffer.slice(match.index + match[0].length);
+        var parsed = parseSseFrame(frame);
+        if (parsed) frames.push(parsed);
+      }
+      return { buffer: buffer, frames: frames };
+    }
 
-    function connectWs() {
+    async function connectWs() {
       wsReconnectTimer = null;
       conn.nextRetryAt = 0;
-      var useDirect = !directFailed;
-      var ws;
+      var controller = new AbortController();
+      liveAbortController = controller;
       try {
-        ws = new WebSocket(useDirect ? WS_DIRECT_URL : WS_URL);
-        ws.__direct = useDirect;
-      } catch (_) {
-        scheduleReconnect();
-        return;
-      }
-      var connectTimer = setTimeout(function() {
-        if (ws.readyState === WebSocket.CONNECTING) {
-          try { ws.close(); } catch {}
+        var headers = { 'Cache-Control': 'no-cache', Accept: 'text/event-stream' };
+        var viewerToken = getViewerToken();
+        if (viewerToken) headers.Authorization = 'Bearer ' + viewerToken;
+        var response = await fetch(LIVE_EVENTS_URL, { headers: headers, signal: controller.signal });
+        if (!response.ok || !response.body) {
+          if (response.status === 401) showViewerAuthPrompt();
+          throw new Error('SSE request failed: ' + response.status);
         }
-      }, WS_CONNECT_TIMEOUT_MS);
-      ws.onopen = function() {
-        clearTimeout(connectTimer);
-        if (state.ws !== ws) return;
+        hideViewerAuthPrompt();
         wsRetries = 0;
-        if (!ws.__direct) {
-          ws.send(JSON.stringify({
-            type: 'join',
-            data: {
-              subscriptionId: 'viewer-' + Date.now(),
-              streamName: 'mem-live',
-              groupId: 'viewer'
-            }
-          }));
-        }
         var firstConnect = !wsHasConnected;
         wsHasConnected = true;
         wsOpenedAt = Date.now();
         setConnection('live');
         updateFooter();
-        resyncAfterConnect(firstConnect);
-      };
-      ws.onmessage = function(e) {
-        if (state.ws !== ws) return;
-        if (!ws.__usable) {
-          ws.__usable = true;
-          directFailures = 0;
+        await resyncAfterConnect(firstConnect);
+        var reader = response.body.getReader();
+        var decoder = new TextDecoder();
+        var buffer = '';
+        while (true) {
+          var result = await reader.read();
+          if (result.done) break;
+          buffer += decoder.decode(result.value, { stream: true });
+          var parsed = consumeSseChunk(buffer, '');
+          buffer = parsed.buffer;
+          parsed.frames.forEach(function(frame) {
+            store.lastEventAt = Date.now();
+            if (frame.type === 'raw_observation') {
+              var obs = frame.data && frame.data.data && (frame.data.data.observation || frame.data.data);
+              if (looksLikeObservation(obs)) routeWsMessage({ observation: obs, fresh: true });
+            } else if (frame.type === 'compressed_observation') {
+              var compressed = frame.data && frame.data.data && (frame.data.data.observation || frame.data.data);
+              if (looksLikeObservation(compressed)) routeWsMessage({ observation: compressed, fresh: true });
+            } else {
+              handleLiveEvent(frame.type, frame.data && frame.data.data || {});
+            }
+          });
         }
-        store.lastEventAt = Date.now();
-        try {
-          var msg = JSON.parse(e.data);
-          if (msg.type === 'stream' && msg.event) {
-            handleStreamEvent(msg);
-          } else if (msg.event_type && msg.data) {
-            handleStreamEvent({ event: { type: 'create', data: msg.data, event_type: msg.event_type } });
-          }
-        } catch {}
-      };
-      ws.onclose = function() {
-        clearTimeout(connectTimer);
-        if (state.ws !== ws) return;
-        wsOpenedAt = null;
-        updateFooter();
-        directFailures += 1;
-        if (directFailures >= DIRECT_FAILURE_THRESHOLD) {
-          directFailed = ws.__direct;
-          directFailures = 0;
+        if (!controller.signal.aborted) throw new Error('SSE stream ended');
+      } catch (err) {
+        if (!controller.signal.aborted) console.warn('[viewer] SSE connection failed:', err);
+      } finally {
+        if (liveAbortController === controller) liveAbortController = null;
+        if (!controller.signal.aborted) {
+          wsOpenedAt = null;
+          updateFooter();
+          scheduleReconnect();
         }
-        scheduleReconnect();
-      };
-      ws.onerror = function() {
-        if (state.ws !== ws) return;
-        try { ws.close(); } catch {}
-      };
-      state.ws = ws;
+      }
     }
 
     var resyncing = null;
+    function resetLoadedKindForReload(kind) {
+      store.loaded[kind] = false;
+      if (kind === 'action') {
+        state.actions.detailAttemptedId = '';
+        state.actions.detailRequestFailedId = '';
+      }
+    }
+
     async function resyncAfterConnect(firstConnect) {
       openBootGate();
       if (resyncing) return resyncing;
@@ -7795,9 +7964,10 @@
       resyncing = (async function() {
         try {
           await loadSnapshot();
+          await loadRecentObservations();
           scheduleHealthStaleCheck();
           if (!firstConnect || reloadKinds.length) {
-            reloadKinds.forEach(function(k) { store.loaded[k] = false; });
+            reloadKinds.forEach(resetLoadedKindForReload);
             await Promise.all(reloadKinds.map(ensureLoaded));
             state.graph.dirty = state.graph.loaded;
             state.activity.loaded = false;
@@ -7814,6 +7984,24 @@
     }
 
     var LIVE_BUFFER_MAX = 200;
+    var ACTIVITY_SESSIONS = 10;
+    async function loadRecentObservations() {
+      var sessionResult = await apiGet('sessions?limit=' + ACTIVITY_SESSIONS);
+      var sessions = sortByTimeDesc((sessionResult && sessionResult.sessions) || [], ['startedAt']).filter(function(x) { return sessionId(x); }).slice(0, ACTIVITY_SESSIONS);
+      mergeSessionRows(sessions);
+      var results = await Promise.all(sessions.map(function(x) {
+        return apiGet('observations?sessionId=' + encodeURIComponent(sessionId(x)) + '&limit=100');
+      }));
+      var seen = {};
+      results.forEach(function(result) {
+        ((result && result.observations) || []).slice(-LIVE_BUFFER_MAX).forEach(function(observation) {
+          if (!observation || !observation.id || seen[observation.id]) return;
+          seen[observation.id] = true;
+          routeWsMessage({ observation: observation });
+        });
+      });
+    }
+
 
     function looksLikeObservation(obj) {
       return !!(obj && typeof obj === 'object' && obj.id && obj.timestamp);
@@ -8055,15 +8243,6 @@
         if (looksLikeObservation(observation)) {
           routeWsMessage({ observation: observation, fresh: true });
         }
-      } else if (evt.type === 'sync') {
-        var items = Array.isArray(evt.data) ? evt.data.slice(-LIVE_BUFFER_MAX) : [];
-        items.forEach(function(item) {
-          var payload = item.data || item;
-          observation = payload.observation || payload;
-          if (looksLikeObservation(observation)) {
-            routeWsMessage({ observation: observation });
-          }
-        });
       }
     }
 
@@ -8159,9 +8338,9 @@
         items.push({
           on: false,
           title: 'No LLM provider',
-          key: 'ANTHROPIC_API_KEY',
-          desc: 'Compression, summaries, consolidation and graph extraction stay off until an LLM key is set. Memories, search and sessions still work.',
-          enable: 'export ANTHROPIC_API_KEY=sk-ant-...\n# then restart: npx @agentmemory/agentmemory',
+          key: 'AGENTMEMORY_LLM_PROVIDER',
+          desc: 'Compression, summaries, consolidation and graph extraction stay off until you choose an LLM provider. Memories, search and sessions still work.',
+          enable: 'export AGENTMEMORY_LLM_PROVIDER=anthropic\nexport ANTHROPIC_API_KEY=sk-ant-...\n# then restart: npx @agentmemory/agentmemory',
           affects: ['Overview', 'Graph', 'Crystals']
         });
       }
@@ -8169,9 +8348,9 @@
         items.push({
           on: false,
           title: 'No embedding provider',
-          key: 'OPENAI_API_KEY',
+          key: 'EMBEDDING_PROVIDER',
           desc: 'Search matches exact keywords only. With embeddings it also finds memories by meaning.',
-          enable: 'export OPENAI_API_KEY=sk-...\n# or VOYAGE_API_KEY, COHERE_API_KEY, OLLAMA_HOST',
+          enable: 'export EMBEDDING_PROVIDER=local\n# or EMBEDDING_PROVIDER=openai with OPENAI_API_KEY (also voyage, cohere, gemini, openrouter)',
           affects: ['Memories', 'Health']
         });
       }
@@ -8226,7 +8405,7 @@
       var sync = document.getElementById('footer-sync');
       if (sync) {
         var syncText = store.snapshotAt ? 'full sync ' + new Date(store.snapshotAt).toLocaleTimeString() : 'waiting for first sync';
-        if (store.snapshotAt) syncText += wsOpenedAt ? ', streaming since ' + new Date(wsOpenedAt).toLocaleTimeString() : ', stream reconnecting';
+        if (store.snapshotAt) syncText += wsOpenedAt ? ', live via SSE since ' + new Date(wsOpenedAt).toLocaleTimeString() : ', SSE reconnecting';
         sync.textContent = syncText;
       }
       var fbEl = document.getElementById('footer-feedback');
@@ -8323,7 +8502,7 @@
       var modal = document.getElementById('modal');
       var overlay = document.getElementById('modal-overlay');
       var html = '<h3>How to read this viewer</h3>';
-      html += '<p style="margin-bottom:8px;">Everything on these pages updates live over one streaming connection; nothing refreshes on a timer. Click any <span class="help" style="cursor:default;">?</span> for a short explanation, or use the keys below.</p>';
+      html += '<p style="margin-bottom:8px;">Everything on these pages updates live over one SSE connection; nothing refreshes on a timer. Click any <span class="help" style="cursor:default;">?</span> for a short explanation, or use the keys below.</p>';
       html += '<div class="kbd-list">' +
         '<div><kbd>/</kbd> focus search on this page</div>' +
         '<div><kbd>?</kbd> open this help</div>' +
@@ -8894,16 +9073,7 @@
 
     var bootRoute = parseRoute(window.location.hash);
     switchTab(bootRoute.tab, { replaceRoute: true, skipRoute: !!bootRoute.obs && !bootRoute.redirect, id: bootRoute.id, obs: bootRoute.obs });
-    (async function initWs() {
-      try {
-        var live = await api('livez', { signal: AbortSignal.timeout(5000) });
-        if (live && typeof live.streamsPort === 'number' && live.streamsPort > 0) {
-          WS_URL = wsProto + '//' + window.location.hostname + ':' + live.streamsPort;
-          WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
-        }
-      } catch (_) {}
-      connectWs();
-    })();
+    connectWs();
     setTimeout(function() {
       if (wsHasConnected) return;
       openBootGate();
@@ -8913,8 +9083,7 @@
 
     document.addEventListener('visibilitychange', function() {
       if (document.visibilityState !== 'visible') return;
-      var ws = state.ws;
-      if (ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)) return;
+      if (liveAbortController) return;
       wsRetries = 0;
       reconnectNow();
     });