@kage-core/kage-graph-mcp 2.0.2 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "Local-first repo memory, code graph, and recall MCP server for coding agents",
   "main": "dist/index.js",
   "files": [

package/viewer/console.js

@@ -780,4 +780,65 @@
     fitView();
     cancelAnimationFrame(G.raf); tick();
   }
+
+  // ---- live feed (SSE from the local viewer daemon) ----
+  // Connects to /kage/events when this page is served by `kage viewer`. The
+  // hosted demo on GitHub Pages has no daemon: the stream never opens, so the
+  // panel stays hidden and the dashboard is otherwise unchanged.
+  var LIVE_CAP = 30;
+  var LIVE_LABEL = {
+    packet_written: ["＋", "Memory written"],
+    packet_updated: ["✎", "Memory updated"],
+    recall_served: ["✓", "Recall served"],
+    stale_withheld: ["⊘", "Stale memory withheld"],
+    caller_answered: ["◆", "Graph answer served"],
+    stale_caught: ["⊘", "Stale memory caught"],
+  };
+  function liveRow(e) {
+    var kind = e.type === "value_event" ? ((e.event && e.event.kind) || "value_event") : e.type;
+    var meta = LIVE_LABEL[kind] || ["•", String(kind).replace(/_/g, " ")];
+    var row = el("div", "vev fresh " + kind);
+    row.appendChild(el("span", "vi", meta[0]));
+    var mid = el("div", "vt");
+    mid.appendChild(document.createTextNode(meta[1]));
+    if (kind === "recall_served" && e.event && e.event.tokens_saved > 0) {
+      mid.appendChild(document.createTextNode(" — saved "));
+      mid.appendChild(el("b", null, "~" + fmt(e.event.tokens_saved) + " tokens"));
+    } else if (e.title) {
+      mid.appendChild(document.createTextNode(" — "));
+      mid.appendChild(el("b", null, e.title));
+    }
+    row.appendChild(mid);
+    row.appendChild(el("span", "when", relTime(e.ts) || "just now"));
+    return row;
+  }
+  function initLive() {
+    if (typeof window.EventSource === "undefined") return;
+    var panel = document.getElementById("livePanel"), feed = document.getElementById("liveFeed");
+    if (!panel || !feed) return;
+    var es;
+    try { es = new EventSource("/kage/events"); } catch (err) { return; }
+    var opened = false;
+    es.onopen = function () {
+      opened = true;
+      panel.hidden = false;
+      if (!feed.childNodes.length) feed.appendChild(el("div", "empty", "Connected. New memories and value events stream in here live."));
+    };
+    es.onerror = function () {
+      // Never connected (no daemon behind this page): close and hide quietly.
+      // After a successful open, EventSource reconnects on its own — keep the panel.
+      if (!opened) { es.close(); panel.hidden = true; }
+    };
+    es.onmessage = function (msg) {
+      var e;
+      try { e = JSON.parse(msg.data); } catch (err) { return; }
+      if (!e || !e.type) return;
+      var placeholder = feed.querySelector(".empty");
+      if (placeholder) feed.removeChild(placeholder);
+      feed.className = "vfeed";
+      feed.insertBefore(liveRow(e), feed.firstChild);
+      while (feed.childNodes.length > LIVE_CAP) feed.removeChild(feed.lastChild);
+    };
+  }
+  initLive();
 })();

package/viewer/index.html

@@ -95,6 +95,14 @@
       .receipt .r-line b.warn { color: var(--warn); } .receipt .r-line b.gain { color: var(--gain); }
       .receipt .r-foot { border-top: 1px dashed var(--line-strong); padding: 11px 24px; color: var(--faint); font: 400 11px/1.5 var(--mono); }
 
+      /* live feed (SSE from the local daemon; hidden on the hosted demo) */
+      .livedot { display: inline-block; width: 8px; height: 8px; border-radius: 99px; background: var(--gain); margin-right: 9px; animation: livepulse 2s ease infinite; }
+      @keyframes livepulse { 0%, 100% { box-shadow: 0 0 0 0 var(--gain-soft); } 50% { box-shadow: 0 0 0 6px var(--gain-soft); } }
+      .vev.fresh { animation: levin 1.2s ease; }
+      @keyframes levin { from { background: var(--gain-soft); } to { background: transparent; } }
+      .vev.packet_written .vi, .vev.packet_updated .vi { color: var(--memory); }
+      .vev.stale_caught .vi { color: var(--warn); }
+
       /* gains timeline */
       .vfeed { display: grid; }
       .vev { display: grid; grid-template-columns: 20px 1fr auto; gap: 0 13px; align-items: baseline; padding: 11px 4px; border-top: 1px solid var(--line); }
@@ -298,6 +306,7 @@
           <section class="section active" id="section-gains">
             <div class="receipt" id="gainsHero"></div>
             <div class="tiles" id="gainsTiles"></div>
+            <div class="panel" id="livePanel" hidden><h2><span class="livedot" aria-hidden="true"></span>Live <span class="sub">— memories and value events as they happen</span></h2><div id="liveFeed"></div></div>
             <div class="panel"><h2>Value timeline <span class="sub">— every saved recall and withheld stale memory, as it happened</span></h2><div id="gainsTimeline"></div></div>
           </section>
 
@@ -361,6 +370,6 @@
     </div>
     <div class="drawer-backdrop" id="detailBackdrop"></div>
     <aside class="drawer" id="detail" aria-hidden="true"></aside>
-    <script src="./console.js?v=16"></script>
+    <script src="./console.js?v=17"></script>
   </body>
 </html>