@agentmemory/agentmemory 0.9.30 → 0.9.31

package/dist/viewer/index.html

@@ -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,9 +1643,9 @@
       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.' },
@@ -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: '' },
       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();
@@ -2806,8 +2822,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 +2903,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 +2928,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 +2957,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 +2990,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 {
@@ -3671,7 +3736,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;
@@ -3796,7 +3861,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 +4086,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 +4164,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 +4572,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);
@@ -6404,7 +6471,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 +6564,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 +6630,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 +6713,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();
     }
@@ -6679,6 +6807,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; }
@@ -7079,7 +7209,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 +7235,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) {
@@ -7126,13 +7256,12 @@
       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'))) +
+        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'))) +
         '</div>';
     }
 
@@ -7168,17 +7297,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', {})) : '';
@@ -7401,7 +7531,7 @@
       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);
@@ -7611,14 +7741,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 +7832,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 +7943,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 +7963,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 +8222,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 });
-          }
-        });
       }
     }
 
@@ -8226,7 +8384,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 +8481,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 +9052,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 +9062,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();
     });