nexus-prime 7.9.21 → 7.9.22

package/dist/agents/adapters/mcp/handlers/memory.js

@@ -11,6 +11,35 @@ import { requireRuntime } from '../util/require-runtime.js';
 import { nxlResult } from '../../../../nxl/index.js';
 import { consolidateMemory } from '../../../../engines/memory-consolidator.js';
 import { recordFirstMemory } from '../../../../engines/telemetry.js';
+function memoryScopeForTags(tags) {
+    return tags.some((tag) => tag.startsWith('#project')) ? 'project' : 'session';
+}
+function memoryStatusSummary(hctx) {
+    try {
+        const stats = hctx.nexusRef.getMemoryStats?.();
+        const health = typeof hctx.nexusRef.getMemoryHealth === 'function'
+            ? hctx.nexusRef.getMemoryHealth()
+            : null;
+        const healthText = health
+            ? `${health.active} active, ${health.quarantined} quarantined, ${health.shared} shared`
+            : null;
+        const topTags = Array.isArray(stats?.topTags) && stats.topTags.length
+            ? stats.topTags.slice(0, 4).join(', ')
+            : 'none yet';
+        const tierText = stats
+            ? `${stats.prefrontal} working, ${stats.hippocampus} episodic, ${stats.cortex} semantic`
+            : null;
+        return [
+            'Memory status:',
+            tierText,
+            healthText,
+            `top tags ${topTags}`,
+        ].filter(Boolean).join(' ');
+    }
+    catch {
+        return null;
+    }
+}
 export async function handleMemoryGroup(toolName, hctx, request, args, ctx) {
     const runtimeError = requireRuntime(hctx);
     if (runtimeError)
@@ -28,8 +57,10 @@ export async function handleMemoryGroup(toolName, hctx, request, args, ctx) {
             void recordFirstMemory().catch(() => { });
             hctx.sessionDNA.recordMemoryStore();
             const nudge = hctx.telemetry.planningNudge('store', { priority });
+            const scope = memoryScopeForTags(tags);
+            const status = memoryStatusSummary(hctx);
             if (ctx) {
-                ctx.meta.memoryScope = tags.some((tag) => tag.startsWith('#project')) ? 'project' : 'session';
+                ctx.meta.memoryScope = scope;
             }
             // Console ASCII UI
             hctx.box('🧠 CORTEX MEMORY STORED', [
@@ -41,6 +72,8 @@ export async function handleMemoryGroup(toolName, hctx, request, args, ctx) {
                         type: 'text',
                         text: [
                             'Memory stored. ID: ' + id,
+                            `Memory link: ${scope} scope, priority ${priority.toFixed(2)}, ${tags.length} tag(s).`,
+                            status,
                             nudge,
                         ].filter(Boolean).join('\n\n'),
                     }],
@@ -52,13 +85,15 @@ export async function handleMemoryGroup(toolName, hctx, request, args, ctx) {
             const fmt = String(request.params.arguments?.format ?? 'text');
             const crossClient = Boolean(request.params.arguments?.cross_client ?? false);
             const memories = await hctx.nexusRef.recallMemory(query, k, crossClient ? undefined : hctx.getToolProfile());
-            nexusEventBus.emit('memory.recall', { query, count: memories.length });
+            const preview = memories.slice(0, 3).map((m) => String(m ?? '').replace(/\s+/g, ' ').slice(0, 96));
+            nexusEventBus.emit('memory.recall', { query, count: memories.length, k, crossClient, format: fmt, preview });
             hctx.telemetry.recordRecall(memories.length);
             hctx.sessionDNA.recordMemoryRecall();
             if (ctx) {
                 ctx.meta.memoryRecallCount = memories.length;
             }
             const nudge = hctx.telemetry.planningNudge('recall', { count: memories.length });
+            const status = memoryStatusSummary(hctx);
             // Console ASCII UI
             hctx.box('🔍 CORTEX MEMORY RECALL', [
                 `Query: ${query.replace(/\n/g, ' ').substring(0, 57).padEnd(59, ' ')}`,
@@ -80,9 +115,13 @@ export async function handleMemoryGroup(toolName, hctx, request, args, ctx) {
             return {
                 content: [{
                         type: 'text',
-                        text: (memories.length > 0
-                            ? `🧠 ${memories.length} memories recalled for "${query}":\n\n${formatted}`
-                            : `No memories found for "${query}". Fresh session or new topic.`) + '\n\n' + nudge,
+                        text: [
+                            memories.length > 0
+                                ? `Memory recall connected ${memories.length} item(s) for "${query}".\n\n${formatted}`
+                                : `No memories found for "${query}". Fresh session or new topic.`,
+                            status,
+                            nudge,
+                        ].filter(Boolean).join('\n\n'),
                     }],
             };
         }

package/dist/dashboard/app/styles/runtime.css

@@ -20,6 +20,25 @@
   border-radius: 8px;
   padding: 14px 18px;
   min-width: 0;
+  text-align: left;
+}
+
+.rt-kpi-action {
+  cursor: pointer;
+  color: inherit;
+  font: inherit;
+  transition: border-color 0.15s, background 0.15s, transform 0.15s;
+}
+
+.rt-kpi-action:hover,
+.rt-kpi-action[aria-expanded="true"] {
+  border-color: var(--accent);
+  background: oklch(87% 0.19 152 / 7%);
+}
+
+.rt-kpi-action:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
 }
 
 .rt-kpi-val {
@@ -234,6 +253,135 @@
   min-height: 0;
 }
 
+/* ── Token telemetry flyout ─────────────────────────────────────────────────── */
+.rt-token-flyout-slot {
+  position: relative;
+}
+
+.rt-token-flyout {
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--surface);
+  padding: 14px;
+  box-shadow: 0 18px 45px oklch(0% 0 0 / 35%);
+  animation: rt-ev-in 0.12s ease;
+}
+
+.rt-token-head {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 12px;
+}
+
+.rt-token-title {
+  font: 700 14px ui-sans-serif, system-ui, sans-serif;
+  color: var(--text);
+}
+
+.rt-token-sub {
+  margin-top: 3px;
+  font-size: 12px;
+  color: var(--text-muted);
+}
+
+.rt-token-error { color: var(--bad, #ef4444); }
+
+.rt-token-close {
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  background: transparent;
+  color: var(--text-muted);
+  padding: 4px 9px;
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.rt-token-close:hover {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.rt-token-grid {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 8px;
+  margin-bottom: 12px;
+}
+
+.rt-token-stat {
+  border: 1px solid var(--border);
+  border-radius: 7px;
+  padding: 10px;
+  background: var(--bg-panel, transparent);
+}
+
+.rt-token-stat span,
+.rt-token-row span {
+  color: var(--text-muted);
+  font-size: 11px;
+}
+
+.rt-token-stat strong {
+  display: block;
+  margin-top: 5px;
+  font: 700 20px/1 var(--font-mono, ui-monospace, monospace);
+  color: var(--accent);
+}
+
+.rt-token-columns {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 12px;
+}
+
+.rt-token-section-title {
+  color: var(--text-muted);
+  font: 700 11px var(--font-mono, ui-monospace, monospace);
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  margin-bottom: 6px;
+}
+
+.rt-token-row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto auto;
+  gap: 8px;
+  align-items: center;
+  border-top: 1px solid var(--border);
+  padding: 6px 0;
+  min-width: 0;
+}
+
+.rt-token-row strong {
+  color: var(--text);
+  font: 700 12px var(--font-mono, ui-monospace, monospace);
+}
+
+.rt-token-row span:first-child {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.rt-token-muted {
+  color: var(--text-muted);
+  font-size: 12px;
+  padding: 8px 0;
+}
+
+@media (max-width: 900px) {
+  .runtime-kpis,
+  .rt-token-grid,
+  .rt-token-columns {
+    grid-template-columns: 1fr;
+  }
+  .runtime-kpis {
+    display: grid;
+  }
+}
+
 .rt-mcp-strip-inner {
   display: flex;
   flex-wrap: wrap;

package/dist/dashboard/app/styles/workforce.css

@@ -101,6 +101,34 @@
 }
 .dtags { display: flex; flex-wrap: wrap; gap: 4px; }
 
+.dispatch-strip {
+    margin-top: 10px;
+    padding: 10px;
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    background: var(--bg-panel);
+}
+.ds-stages { display: flex; flex-wrap: wrap; align-items: center; gap: 4px; margin-bottom: 7px; }
+.ds-stage {
+    font: 0.68rem var(--font-mono);
+    padding: 2px 6px;
+    border: 1px solid var(--border);
+    border-radius: 999px;
+    color: var(--text-dim);
+}
+.ds-stage.ds-done { color: var(--accent); border-color: rgba(0,255,136,0.28); }
+.ds-stage.ds-active { color: var(--secondary); border-color: rgba(0,212,255,0.35); }
+.ds-sep { color: var(--text-dim); font-size: 0.68rem; }
+.ds-stdout, .ds-summary {
+    font-size: 0.74rem;
+    color: var(--text-muted);
+    line-height: 1.45;
+    margin-top: 5px;
+}
+.ds-meta { display: flex; flex-wrap: wrap; gap: 8px; color: var(--text-dim); font: 0.68rem var(--font-mono); }
+.ds-error { margin-top: 6px; color: var(--warning); font-size: 0.74rem; }
+.ds-stop-btn { margin-top: 8px; }
+
 /* ── Unified workforce kanban ── */
 .workforce-kanban { padding: 0; background: transparent; border: none !important; }
 .kanban-meta { font-size: 0.75rem; color: var(--text-dim); margin-bottom: 8px; padding: 0 4px; }

package/dist/dashboard/app/views/runtime.js

@@ -30,6 +30,10 @@ let _settledToolTimes = new Map();
 let _pulseTimer = null;
 // toast queue
 let _toastTimer = null;
+let _tokenFlyoutOpen = false;
+let _tokenFlyoutLoading = false;
+let _tokenFlyoutError = '';
+let _tokenTelemetry = null;
 
 /* ── Category metadata ──────────────────────────────────────────────────────── */
 const CATEGORY_META = {
@@ -65,6 +69,27 @@ function humanMs(ms) {
   return `${(ms / 1000).toFixed(1)}s`;
 }
 
+function fmtTokens(n) {
+  const v = Number(n ?? 0);
+  if (!Number.isFinite(v) || v <= 0) return '0';
+  if (v >= 1_000_000) return `${(v / 1_000_000).toFixed(1)}M`;
+  if (v >= 10_000) return `${Math.round(v / 1000)}k`;
+  if (v >= 1000) return `${(v / 1000).toFixed(1)}k`;
+  return Math.round(v).toLocaleString();
+}
+
+function fmtPct(n) {
+  const v = Number(n ?? 0);
+  if (!Number.isFinite(v)) return '0%';
+  return `${Math.round(v)}%`;
+}
+
+function fmtTime(ts) {
+  const n = Number(ts ?? 0);
+  if (!Number.isFinite(n) || n <= 0) return 'recent';
+  return new Date(n).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+}
+
 function toolNameFromPayload(payload) {
   return String(payload.toolName ?? payload.tool ?? payload.name ?? '').trim();
 }
@@ -159,10 +184,10 @@ function mount() {
           <div class="rt-kpi-val" id="rt-toolcalls">0</div>
           <div class="rt-kpi-lbl">Tool Calls</div>
         </div>
-        <div class="rt-kpi" id="rt-kpi-saved">
+        <button class="rt-kpi rt-kpi-action" id="rt-kpi-saved" type="button" aria-expanded="false" aria-controls="rt-token-flyout" title="Open token telemetry">
           <div class="rt-kpi-val" id="rt-tokens-saved">0</div>
           <div class="rt-kpi-lbl">Tokens Saved</div>
-        </div>
+        </button>
         <div class="rt-kpi">
           <div class="rt-kpi-val" id="rt-active-count">0</div>
           <div class="rt-kpi-lbl">Active Now</div>
@@ -170,6 +195,7 @@ function mount() {
       </div>
 
       <div class="rt-mcp-strip" id="rt-mcp-strip"></div>
+      <div class="rt-token-flyout-slot" id="rt-token-flyout-slot"></div>
 
       <div class="rt-filter-bar">
         <button class="rt-filter-btn active" data-filter="all">All</button>
@@ -212,6 +238,14 @@ function mount() {
     renderAll();
   });
 
+  $('rt-kpi-saved')?.addEventListener('click', () => {
+    _tokenFlyoutOpen = !_tokenFlyoutOpen;
+    renderTokenFlyout();
+    if (_tokenFlyoutOpen && !_tokenTelemetry && !_tokenFlyoutLoading) {
+      void loadTokenTelemetry();
+    }
+  });
+
   _mounted = true;
   renderAll();
 }
@@ -220,6 +254,7 @@ function mount() {
 function renderAll() {
   expireStaleActiveTools();
   renderKPIs();
+  renderTokenFlyout();
   renderMcpStrip();
   renderFeed();
 }
@@ -233,6 +268,96 @@ function renderKPIs() {
     ? (_totalTokensSaved >= 1000 ? `${(_totalTokensSaved / 1000).toFixed(1)}k` : String(_totalTokensSaved))
     : '0';
   if (activeEl) activeEl.textContent = String(_activeTools.size);
+  const tokenBtn = $('rt-kpi-saved');
+  if (tokenBtn) tokenBtn.setAttribute('aria-expanded', _tokenFlyoutOpen ? 'true' : 'false');
+}
+
+async function loadTokenTelemetry() {
+  _tokenFlyoutLoading = true;
+  _tokenFlyoutError = '';
+  renderTokenFlyout();
+  try {
+    const [summary, lifetimeRaw, bySource, timeline] = await Promise.all([
+      api('/api/tokens/summary', 0),
+      api('/api/tokens/lifetime', 0),
+      api('/api/tokens/by-source', 0),
+      api('/api/tokens/timeline?limit=8', 0),
+    ]);
+    _tokenTelemetry = {
+      summary: summary ?? {},
+      lifetime: lifetimeRaw?.data ?? lifetimeRaw ?? {},
+      bySource: bySource ?? {},
+      timeline: Array.isArray(timeline) ? timeline : [],
+    };
+  } catch (err) {
+    _tokenFlyoutError = err?.message || String(err);
+  } finally {
+    _tokenFlyoutLoading = false;
+    renderTokenFlyout();
+  }
+}
+
+function renderTokenFlyout() {
+  const slot = $('rt-token-flyout-slot');
+  if (!slot) return;
+  const btn = $('rt-kpi-saved');
+  if (btn) btn.setAttribute('aria-expanded', _tokenFlyoutOpen ? 'true' : 'false');
+  if (!_tokenFlyoutOpen) {
+    slot.innerHTML = '';
+    return;
+  }
+
+  if (_tokenFlyoutLoading && !_tokenTelemetry) {
+    slot.innerHTML = `<div class="rt-token-flyout" id="rt-token-flyout">
+      <div class="rt-token-head"><div><div class="rt-token-title">Token telemetry</div><div class="rt-token-sub">Loading current runtime ledger...</div></div><button class="rt-token-close" id="rt-token-close" type="button">Close</button></div>
+    </div>`;
+  } else if (_tokenFlyoutError) {
+    slot.innerHTML = `<div class="rt-token-flyout" id="rt-token-flyout">
+      <div class="rt-token-head"><div><div class="rt-token-title">Token telemetry</div><div class="rt-token-sub rt-token-error">${esc(_tokenFlyoutError)}</div></div><button class="rt-token-close" id="rt-token-close" type="button">Close</button></div>
+    </div>`;
+  } else {
+    const data = _tokenTelemetry ?? {};
+    const summary = data.summary ?? {};
+    const lifetime = data.lifetime ?? {};
+    const bySource = data.bySource ?? {};
+    const timeline = Array.isArray(data.timeline) ? data.timeline : [];
+    const sourceRows = Object.entries(bySource).slice(0, 5).map(([source, value]) => {
+      const item = typeof value === 'object' && value ? value : { savedTokens: Number(value ?? 0) };
+      const saved = item.savedTokens ?? item.tokensSaved ?? item.saved ?? 0;
+      const gross = item.grossInputTokens ?? item.tokensOptimized ?? item.gross ?? 0;
+      return `<div class="rt-token-row"><span>${esc(source)}</span><strong>${fmtTokens(saved)}</strong><span>${fmtTokens(gross)} gross</span></div>`;
+    }).join('') || '<div class="rt-token-muted">No source ledger yet.</div>';
+    const timelineRows = timeline.slice(0, 6).map((item) => {
+      const saved = item.savedTokens ?? item.tokensSaved ?? item.saved ?? 0;
+      const run = item.runId ?? item.sessionId ?? item.source ?? 'runtime';
+      return `<div class="rt-token-row"><span>${esc(String(run).slice(0, 18))}</span><strong>${fmtTokens(saved)}</strong><span>${fmtTime(item.timestamp ?? item.ts ?? item.time)}</span></div>`;
+    }).join('') || '<div class="rt-token-muted">No recent token events yet.</div>';
+    slot.innerHTML = `<div class="rt-token-flyout" id="rt-token-flyout">
+      <div class="rt-token-head">
+        <div>
+          <div class="rt-token-title">Token telemetry</div>
+          <div class="rt-token-sub">Runtime ledger, lifetime savings, and live SSE savings for this tab.</div>
+        </div>
+        <button class="rt-token-close" id="rt-token-close" type="button">Close</button>
+      </div>
+      <div class="rt-token-grid">
+        <div class="rt-token-stat"><span>Recent saved</span><strong>${fmtTokens(summary.savedTokens ?? summary.saved)}</strong></div>
+        <div class="rt-token-stat"><span>Recent compression</span><strong>${fmtPct(summary.compressionPct)}</strong></div>
+        <div class="rt-token-stat"><span>Lifetime saved</span><strong>${fmtTokens(lifetime.savedTokens ?? lifetime.totalSaved)}</strong></div>
+        <div class="rt-token-stat"><span>Live tab saved</span><strong>${fmtTokens(_totalTokensSaved)}</strong></div>
+      </div>
+      <div class="rt-token-columns">
+        <div><div class="rt-token-section-title">By source</div>${sourceRows}</div>
+        <div><div class="rt-token-section-title">Recent runs</div>${timelineRows}</div>
+      </div>
+    </div>`;
+  }
+
+  $('rt-token-close')?.addEventListener('click', () => {
+    _tokenFlyoutOpen = false;
+    renderTokenFlyout();
+    renderKPIs();
+  });
 }
 
 function renderMcpStrip() {
@@ -421,11 +546,20 @@ export function ingestEvent(evt) {
       break;
     case 'memory.store':
       label = 'memory · store';
-      detail = String(payload.key ?? payload.content ?? '').slice(0, 80);
+      detail = [
+        payload.id ? `id ${String(payload.id).slice(0, 12)}` : null,
+        payload.tier ? `tier ${payload.tier}` : null,
+        payload.priority != null ? `priority ${Number(payload.priority).toFixed(2)}` : null,
+        Array.isArray(payload.tags) && payload.tags.length ? `tags ${payload.tags.slice(0, 3).join(', ')}` : null,
+      ].filter(Boolean).join(' · ') || String(payload.key ?? payload.content ?? '').slice(0, 80);
       break;
     case 'memory.recall':
       label = 'memory · recall';
-      detail = String(payload.query ?? '').slice(0, 80);
+      detail = [
+        `${Number(payload.count ?? 0)} recalled`,
+        payload.crossClient ? 'cross-client' : null,
+        String(payload.query ?? '').slice(0, 60),
+      ].filter(Boolean).join(' · ');
       break;
     case 'tokens.optimized': {
       const src = payload.source ? ` · ${payload.source}` : '';

package/dist/dashboard/app/views/workforce.js

@@ -45,6 +45,7 @@ export function handleDispatchEvent(evt) {
     const type = evt.type ?? '';
 
     if (type === 'dispatch.started') {
+        if (oid) _dispatches.delete(`__warmup__:${oid}`);
         run.status    = 'spawning';
         run.invoker   = p.invokerId ?? '';
     } else if (type === 'dispatch.event') {
@@ -117,18 +118,20 @@ function _buildDispatchStrip(run) {
     }).join('<span class="ds-sep">→</span>');
 
     const isFinal = ['complete','failed','cancelled'].includes(run.status);
+    const isPendingAdapter = run.pendingAdapter === true;
 
     return `<div class="dispatch-strip" data-run-id="${esc(run.runId)}">
         <div class="ds-stages">${stageHtml}</div>
         ${run.messages.length ? `<div class="ds-stdout">${esc(run.messages[run.messages.length - 1])}</div>` : ''}
         <div class="ds-meta">
+            ${run.invoker ? `<span>${esc(run.invoker)}</span>` : ''}
             ${run.tokens ? `<span>${run.tokens.toLocaleString()} tokens</span>` : ''}
             ${run.costUsd ? `<span>$${run.costUsd.toFixed(4)}</span>` : ''}
             ${run.filesChanged.length ? `<span>${run.filesChanged.length} file(s)</span>` : ''}
         </div>
         ${run.summary ? `<div class="ds-summary">${esc(String(run.summary).slice(0, 160))}</div>` : ''}
         ${run.error   ? `<div class="ds-error">${esc(run.error)}</div>` : ''}
-        ${!isFinal ? `<button class="btn btn-sm ds-stop-btn" data-stop-run="${esc(run.runId)}">Stop</button>` : ''}
+        ${!isFinal && !isPendingAdapter ? `<button class="btn btn-sm ds-stop-btn" data-stop-run="${esc(run.runId)}">Stop</button>` : ''}
     </div>`;
 }
 
@@ -560,14 +563,18 @@ function _showHireSheet(specialistId, name) {
                             stripDiv.setAttribute('data-dispatch-strip', '');
                             drawerBody.appendChild(stripDiv);
                         }
-                        const warmupRun = { runId: '__warmup__', operativeId, status: 'queued', tokens: 0, costUsd: 0, messages: ['Warm-up dispatching…'], filesChanged: [] };
-                        _dispatches.set('__warmup__', warmupRun);
+                        const warmupKey = `__warmup__:${operativeId}`;
+                        const warmupRun = { runId: warmupKey, operativeId, status: 'queued', tokens: 0, costUsd: 0, messages: ['Adapter pending; waiting for dispatch.started…'], filesChanged: [], pendingAdapter: true };
+                        _dispatches.set(warmupKey, warmupRun);
                         stripDiv.innerHTML = _buildDispatchStrip(warmupRun);
                     }
                     const fd = real.data?.firstDispatch;
-                    _dispatches.delete('__warmup__');
                     if (fd?.runId) {
+                        _dispatches.delete(`__warmup__:${operativeId}`);
                         _dispatches.set(fd.runId, { runId: fd.runId, operativeId, status: 'queued', tokens: 0, costUsd: 0, messages: [], filesChanged: [] });
+                    } else if (fd?.queued) {
+                        const pending = _dispatches.get(`__warmup__:${operativeId}`);
+                        if (pending) pending.messages = ['First sortie queued; adapter start will stream here.'];
                     }
                     _refreshDrawerForOp(operativeId);
                 }

package/dist/engines/event-bus.d.ts

@@ -24,6 +24,10 @@ export interface NexusEventPayloads {
     'memory.recall': {
         query: string;
         count: number;
+        k?: number;
+        crossClient?: boolean;
+        format?: string;
+        preview?: string[];
     };
     'memory.flushed': {
         count: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.9.21",
+  "version": "7.9.22",
   "description": "Local-first MCP control plane for coding agents with bootstrap-orchestrate execution, memory fabric, token budgeting, and worktree-backed swarms",
   "type": "module",
   "main": "dist/index.js",