@dollhousemcp/mcp-server 2.0.0-rc.5 → 2.0.0

package/dist/web/public/sessions.js

@@ -0,0 +1,369 @@
+/**
+ * Session awareness for the unified web console.
+ *
+ * Shows a labeled "N sessions" box in the header. Clicking opens a
+ * dropdown with selectable sessions. Selecting a session filters
+ * logs and metrics to that session only.
+ *
+ * @security-audit-suppress DMCP-SEC-004 Client-side JS — all session data is
+ * pre-normalized server-side via UnicodeValidator. Browser String.normalize('NFC')
+ * is applied as defense-in-depth.
+ *
+ * @since v2.1.0 — Issue #1700
+ */
+(function() {
+  'use strict';
+
+  var SESSION_POLL_INTERVAL = 5000;
+  var sessions = [];
+  var filterSessionId = '';
+  var dropdownBuilt = false;
+  var lastSessionKey = ''; // tracks session list identity to avoid unnecessary rebuilds
+
+  function formatUptime(startedAt) {
+    if (!startedAt) return '';
+    var ms = Date.now() - new Date(startedAt).getTime();
+    if (ms < 0) return '0s';
+    var secs = Math.floor(ms / 1000);
+    if (secs < 60) return secs + 's';
+    var mins = Math.floor(secs / 60);
+    if (mins < 60) return mins + 'm';
+    var hrs = Math.floor(mins / 60);
+    var remainMins = mins % 60;
+    if (hrs < 24) return hrs + 'h ' + remainMins + 'm';
+    var days = Math.floor(hrs / 24);
+    var remainHrs = hrs % 24;
+    return days + 'd ' + remainHrs + 'h';
+  }
+
+  /** NFC-normalize a string safely */
+  function nfc(s) { try { return s.normalize('NFC'); } catch(e) { return s; } }
+
+  function displayName(session) {
+    if (typeof session === 'object' && session.displayName) return nfc(session.displayName);
+    var id = typeof session === 'string' ? nfc(session) : nfc((session && session.sessionId) || '');
+    var parts = id.split('-');
+    return parts.length >= 2 ? parts[1] : id.slice(0, 8);
+  }
+
+  // Build a key from current sessions to detect changes
+  function sessionListKey(list) {
+    return list.map(function(s) { return s.sessionId + ':' + s.status; }).join(',');
+  }
+
+  // Apply session filter and update all UI to reflect it
+  function applyFilter(sessionId) {
+    filterSessionId = sessionId;
+
+    // Sync log viewer select
+    var logSelect = document.getElementById('log-session-filter');
+    if (logSelect) logSelect.value = sessionId;
+
+    // Trigger log re-filter
+    if (window.DollhouseConsole && window.DollhouseConsole.logs && window.DollhouseConsole.logs.refilter) {
+      window.DollhouseConsole.logs.refilter();
+    }
+
+    refreshSelectionState();
+  }
+
+  // Update checkmarks and selected styling without rebuilding DOM
+  function refreshSelectionState() {
+    // Update items
+    var items = document.querySelectorAll('.session-dropdown-item[data-session-id]');
+    for (var i = 0; i < items.length; i++) {
+      var isSelected = items[i].dataset.sessionId === filterSessionId;
+      items[i].classList.toggle('session-dropdown-item--selected', isSelected);
+      var check = items[i].querySelector('.session-dropdown-check');
+      if (check) check.textContent = isSelected ? '\u2713' : '';
+    }
+
+    // Update "All" item
+    var allItem = document.querySelector('.session-dropdown-item--all');
+    if (allItem) {
+      var allSelected = !filterSessionId;
+      allItem.classList.toggle('session-dropdown-item--selected', allSelected);
+      var allCheck = allItem.querySelector('.session-dropdown-check');
+      if (allCheck) allCheck.textContent = allSelected ? '\u2713' : '';
+    }
+
+    // Tick uptimes
+    var uptimes = document.querySelectorAll('.session-dropdown-uptime');
+    for (var j = 0; j < uptimes.length; j++) {
+      uptimes[j].textContent = formatUptime(uptimes[j].dataset.startedAt);
+    }
+
+    // Update box label
+    var countEl = document.querySelector('.session-box-count');
+    var labelEl = document.querySelector('.session-box-label');
+    if (!countEl || !labelEl) return;
+
+    var active = sessions.filter(function(s) { return s.status === 'active'; });
+
+    if (active.length === 1) {
+      countEl.textContent = displayName(active[0]);
+      if (active[0].color) countEl.style.color = active[0].color;
+      labelEl.textContent = formatUptime(active[0].startedAt);
+      return;
+    }
+
+    // Reset color when showing count
+    countEl.style.color = '';
+
+    if (filterSessionId) {
+      var filtered = active.find(function(s) { return s.sessionId === filterSessionId; });
+      if (filtered) {
+        countEl.textContent = displayName(filtered);
+        if (filtered.color) countEl.style.color = filtered.color;
+        labelEl.textContent = '1/' + active.length;
+        return;
+      }
+    }
+    countEl.textContent = String(active.length);
+    labelEl.textContent = active.length === 1 ? 'session' : 'sessions';
+  }
+
+  // Build or rebuild the session indicator — only when session list actually changes
+  function updateSessionIndicator() {
+    var active = sessions.filter(function(s) { return s.status === 'active'; });
+    var key = sessionListKey(active);
+
+    // If sessions haven't changed, just refresh selection state
+    if (key === lastSessionKey && dropdownBuilt) {
+      refreshSelectionState();
+      return;
+    }
+    lastSessionKey = key;
+
+    var indicator = document.getElementById('session-indicator');
+    if (!indicator) return;
+
+    indicator.innerHTML = '';
+    dropdownBuilt = false;
+
+    var count = active.length;
+    if (count === 0) return;
+
+    // Box button
+    var box = document.createElement('button');
+    box.className = 'session-box';
+    box.type = 'button';
+    box.setAttribute('aria-expanded', 'false');
+    box.setAttribute('aria-haspopup', 'listbox');
+
+    var countEl = document.createElement('span');
+    countEl.className = 'session-box-count';
+    var labelEl = document.createElement('span');
+    labelEl.className = 'session-box-label';
+    var arrow = document.createElement('span');
+    arrow.className = 'session-box-arrow';
+    box.appendChild(countEl);
+    box.appendChild(labelEl);
+    box.appendChild(arrow);
+
+    // Dropdown
+    var dropdown = document.createElement('div');
+    dropdown.className = 'session-dropdown';
+    dropdown.setAttribute('role', 'listbox');
+    dropdown.hidden = true;
+
+    // "All Sessions" item
+    var allItem = document.createElement('div');
+    allItem.className = 'session-dropdown-item session-dropdown-item--all';
+    allItem.setAttribute('role', 'option');
+
+    var allCheck = document.createElement('span');
+    allCheck.className = 'session-dropdown-check';
+    allItem.appendChild(allCheck);
+
+    var allName = document.createElement('span');
+    allName.className = 'session-dropdown-name';
+    allName.textContent = 'All Sessions';
+    allItem.appendChild(allName);
+
+    var allCount = document.createElement('span');
+    allCount.className = 'session-dropdown-role';
+    allCount.textContent = count + ' total';
+    allItem.appendChild(allCount);
+
+    allItem.addEventListener('click', function(e) {
+      e.stopPropagation();
+      applyFilter('');
+    });
+    dropdown.appendChild(allItem);
+
+    // Divider
+    var divider = document.createElement('div');
+    divider.className = 'session-dropdown-divider';
+    dropdown.appendChild(divider);
+
+    // Session items — leader first, then followers
+    var sorted = active.slice().sort(function(a, b) {
+      if (a.isLeader && !b.isLeader) return -1;
+      if (!a.isLeader && b.isLeader) return 1;
+      return 0;
+    });
+
+    for (var i = 0; i < sorted.length; i++) {
+      (function(s) {
+        var item = document.createElement('div');
+        item.className = 'session-dropdown-item';
+        item.dataset.sessionId = s.sessionId;
+        item.setAttribute('role', 'option');
+
+        var check = document.createElement('span');
+        check.className = 'session-dropdown-check';
+        item.appendChild(check);
+
+        var dot = document.createElement('span');
+        dot.className = 'session-dot';
+        if (s.color) dot.style.background = s.color;
+        item.appendChild(dot);
+
+        var nameEl = document.createElement('span');
+        nameEl.className = 'session-dropdown-name';
+        nameEl.textContent = displayName(s);
+        if (s.color) nameEl.style.color = s.color;
+        item.appendChild(nameEl);
+
+        var uptimeEl = document.createElement('span');
+        uptimeEl.className = 'session-dropdown-uptime';
+        uptimeEl.dataset.startedAt = s.startedAt;
+        uptimeEl.textContent = formatUptime(s.startedAt);
+        item.appendChild(uptimeEl);
+
+        var killBtn = document.createElement('button');
+        killBtn.className = 'session-kill-btn';
+        killBtn.type = 'button';
+        killBtn.title = 'Stop ' + displayName(s);
+        killBtn.textContent = '\u00D7';
+        killBtn.addEventListener('click', function(e) {
+          e.stopPropagation();
+          if (!confirm('Stop session ' + displayName(s) + '?')) return;
+          fetch('/api/sessions/' + encodeURIComponent(s.sessionId) + '/kill', { method: 'POST' })
+            .then(function() { fetchSessions(); })
+            .catch(function() {});
+        });
+        item.appendChild(killBtn);
+
+        item.addEventListener('click', function(e) {
+          e.stopPropagation();
+          applyFilter(filterSessionId === s.sessionId ? '' : s.sessionId);
+        });
+
+        dropdown.appendChild(item);
+      })(sorted[i]);
+    }
+
+    var wrapper = document.createElement('div');
+    wrapper.className = 'session-indicator-wrapper';
+    wrapper.appendChild(box);
+    wrapper.appendChild(dropdown);
+    indicator.appendChild(wrapper);
+
+    dropdownBuilt = true;
+
+    // Apply current selection state
+    refreshSelectionState();
+
+    // Toggle dropdown — fetch fresh data on open
+    box.addEventListener('click', function(e) {
+      e.stopPropagation();
+      var open = !dropdown.hidden;
+      if (open) {
+        dropdown.hidden = true;
+        box.setAttribute('aria-expanded', 'false');
+      } else {
+        // Fetch fresh session data before showing
+        fetchSessions();
+        dropdown.hidden = false;
+        box.setAttribute('aria-expanded', 'true');
+      }
+    });
+    document.addEventListener('click', function() {
+      dropdown.hidden = true;
+      box.setAttribute('aria-expanded', 'false');
+    });
+  }
+
+  // Inject session filter into log viewer filter bar
+  function injectSessionFilter() {
+    var logPanel = document.getElementById('tab-logs');
+    if (!logPanel) return;
+    if (document.getElementById('log-session-filter')) return;
+
+    var filterBar = logPanel.querySelector('.log-filters');
+    if (!filterBar) return;
+
+    var group = document.createElement('div');
+    group.className = 'log-filter-group';
+    group.innerHTML =
+      '<label for="log-session-filter">Session</label>' +
+      '<select id="log-session-filter" class="log-filter-select">' +
+      '<option value="">All Sessions</option></select>';
+    filterBar.appendChild(group);
+
+    group.querySelector('select').addEventListener('change', function() {
+      applyFilter(this.value);
+    });
+  }
+
+  // Update session filter dropdown options
+  function updateSessionFilterOptions() {
+    var select = document.getElementById('log-session-filter');
+    if (!select) return;
+
+    var current = select.value;
+    var active = sessions.filter(function(s) { return s.status === 'active'; });
+
+    select.innerHTML = '<option value="">All Sessions</option>';
+    for (var i = 0; i < active.length; i++) {
+      var opt = document.createElement('option');
+      opt.value = active[i].sessionId;
+      opt.textContent = displayName(active[i]) + (active[i].isLeader ? ' (leader)' : '');
+      if (active[i].sessionId === current) opt.selected = true;
+      select.appendChild(opt);
+    }
+  }
+
+  // Fetch sessions from the API
+  function fetchSessions() {
+    fetch('/api/sessions').then(function(res) {
+      if (!res.ok) return;
+      return res.json();
+    }).then(function(data) {
+      if (data && data.sessions) {
+        sessions = data.sessions;
+        updateSessionIndicator();
+        updateSessionFilterOptions();
+      }
+    }).catch(function() {});
+  }
+
+  // Expose for logs.js integration
+  window.DollhouseSessions = {
+    getFilterSessionId: function() { return filterSessionId; },
+    displayName: displayName,
+    getSessions: function() { return sessions; },
+  };
+
+  function init() {
+    fetchSessions();
+    setInterval(fetchSessions, SESSION_POLL_INTERVAL);
+
+    var retries = 0;
+    var tryInject = setInterval(function() {
+      injectSessionFilter();
+      retries++;
+      if (document.getElementById('log-session-filter') || retries > 20) {
+        clearInterval(tryInject);
+      }
+    }, 500);
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', init);
+  } else {
+    init();
+  }
+})();

package/dist/web/routes/healthRoutes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Health API route for the unified dev console.
+ *
+ * GET /api/health — Aggregated health: uptime, sink stats, SSE client counts
+ */
+import { Router } from 'express';
+import type { MemoryLogSink } from '../../logging/sinks/MemoryLogSink.js';
+import type { MemoryMetricsSink } from '../../metrics/sinks/MemoryMetricsSink.js';
+export interface HealthRoutesOptions {
+    memorySink: MemoryLogSink;
+    metricsSink?: MemoryMetricsSink;
+    logClientCount: () => number;
+    metricsClientCount: () => number;
+}
+export declare function createHealthRoutes(options: HealthRoutesOptions): Router;
+//# sourceMappingURL=healthRoutes.d.ts.map

package/dist/web/routes/healthRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthRoutes.d.ts","sourceRoot":"","sources":["../../../src/web/routes/healthRoutes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,MAAM,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAyBvE"}

package/dist/web/routes/healthRoutes.js

@@ -0,0 +1,29 @@
+/**
+ * Health API route for the unified dev console.
+ *
+ * GET /api/health — Aggregated health: uptime, sink stats, SSE client counts
+ */
+import { Router } from 'express';
+export function createHealthRoutes(options) {
+    const router = Router();
+    const startTime = Date.now();
+    router.get('/health', (_req, res) => {
+        const health = {
+            status: 'ok',
+            uptime: Math.floor((Date.now() - startTime) / 1000),
+            logs: {
+                stats: options.memorySink.getStats(),
+                sseClients: options.logClientCount(),
+            },
+        };
+        if (options.metricsSink) {
+            health['metrics'] = {
+                stats: options.metricsSink.getStats(),
+                sseClients: options.metricsClientCount(),
+            };
+        }
+        res.json(health);
+    });
+    return router;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVhbHRoUm91dGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3dlYi9yb3V0ZXMvaGVhbHRoUm91dGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFFSCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBWWpDLE1BQU0sVUFBVSxrQkFBa0IsQ0FBQyxPQUE0QjtJQUM3RCxNQUFNLE1BQU0sR0FBRyxNQUFNLEVBQUUsQ0FBQztJQUN4QixNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7SUFFN0IsTUFBTSxDQUFDLEdBQUcsQ0FBQyxTQUFTLEVBQUUsQ0FBQyxJQUFhLEVBQUUsR0FBYSxFQUFFLEVBQUU7UUFDckQsTUFBTSxNQUFNLEdBQTRCO1lBQ3RDLE1BQU0sRUFBRSxJQUFJO1lBQ1osTUFBTSxFQUFFLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsU0FBUyxDQUFDLEdBQUcsSUFBSSxDQUFDO1lBQ25ELElBQUksRUFBRTtnQkFDSixLQUFLLEVBQUUsT0FBTyxDQUFDLFVBQVUsQ0FBQyxRQUFRLEVBQUU7Z0JBQ3BDLFVBQVUsRUFBRSxPQUFPLENBQUMsY0FBYyxFQUFFO2FBQ3JDO1NBQ0YsQ0FBQztRQUVGLElBQUksT0FBTyxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ3hCLE1BQU0sQ0FBQyxTQUFTLENBQUMsR0FBRztnQkFDbEIsS0FBSyxFQUFFLE9BQU8sQ0FBQyxXQUFXLENBQUMsUUFBUSxFQUFFO2dCQUNyQyxVQUFVLEVBQUUsT0FBTyxDQUFDLGtCQUFrQixFQUFFO2FBQ3pDLENBQUM7UUFDSixDQUFDO1FBRUQsR0FBRyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNuQixDQUFDLENBQUMsQ0FBQztJQUVILE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEhlYWx0aCBBUEkgcm91dGUgZm9yIHRoZSB1bmlmaWVkIGRldiBjb25zb2xlLlxuICpcbiAqIEdFVCAvYXBpL2hlYWx0aCDigJQgQWdncmVnYXRlZCBoZWFsdGg6IHVwdGltZSwgc2luayBzdGF0cywgU1NFIGNsaWVudCBjb3VudHNcbiAqL1xuXG5pbXBvcnQgeyBSb3V0ZXIgfSBmcm9tICdleHByZXNzJztcbmltcG9ydCB0eXBlIHsgUmVxdWVzdCwgUmVzcG9uc2UgfSBmcm9tICdleHByZXNzJztcbmltcG9ydCB0eXBlIHsgTWVtb3J5TG9nU2luayB9IGZyb20gJy4uLy4uL2xvZ2dpbmcvc2lua3MvTWVtb3J5TG9nU2luay5qcyc7XG5pbXBvcnQgdHlwZSB7IE1lbW9yeU1ldHJpY3NTaW5rIH0gZnJvbSAnLi4vLi4vbWV0cmljcy9zaW5rcy9NZW1vcnlNZXRyaWNzU2luay5qcyc7XG5cbmV4cG9ydCBpbnRlcmZhY2UgSGVhbHRoUm91dGVzT3B0aW9ucyB7XG4gIG1lbW9yeVNpbms6IE1lbW9yeUxvZ1Npbms7XG4gIG1ldHJpY3NTaW5rPzogTWVtb3J5TWV0cmljc1Npbms7XG4gIGxvZ0NsaWVudENvdW50OiAoKSA9PiBudW1iZXI7XG4gIG1ldHJpY3NDbGllbnRDb3VudDogKCkgPT4gbnVtYmVyO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlSGVhbHRoUm91dGVzKG9wdGlvbnM6IEhlYWx0aFJvdXRlc09wdGlvbnMpOiBSb3V0ZXIge1xuICBjb25zdCByb3V0ZXIgPSBSb3V0ZXIoKTtcbiAgY29uc3Qgc3RhcnRUaW1lID0gRGF0ZS5ub3coKTtcblxuICByb3V0ZXIuZ2V0KCcvaGVhbHRoJywgKF9yZXE6IFJlcXVlc3QsIHJlczogUmVzcG9uc2UpID0+IHtcbiAgICBjb25zdCBoZWFsdGg6IFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0ge1xuICAgICAgc3RhdHVzOiAnb2snLFxuICAgICAgdXB0aW1lOiBNYXRoLmZsb29yKChEYXRlLm5vdygpIC0gc3RhcnRUaW1lKSAvIDEwMDApLFxuICAgICAgbG9nczoge1xuICAgICAgICBzdGF0czogb3B0aW9ucy5tZW1vcnlTaW5rLmdldFN0YXRzKCksXG4gICAgICAgIHNzZUNsaWVudHM6IG9wdGlvbnMubG9nQ2xpZW50Q291bnQoKSxcbiAgICAgIH0sXG4gICAgfTtcblxuICAgIGlmIChvcHRpb25zLm1ldHJpY3NTaW5rKSB7XG4gICAgICBoZWFsdGhbJ21ldHJpY3MnXSA9IHtcbiAgICAgICAgc3RhdHM6IG9wdGlvbnMubWV0cmljc1NpbmsuZ2V0U3RhdHMoKSxcbiAgICAgICAgc3NlQ2xpZW50czogb3B0aW9ucy5tZXRyaWNzQ2xpZW50Q291bnQoKSxcbiAgICAgIH07XG4gICAgfVxuXG4gICAgcmVzLmpzb24oaGVhbHRoKTtcbiAgfSk7XG5cbiAgcmV0dXJuIHJvdXRlcjtcbn1cbiJdfQ==

package/dist/web/routes/logRoutes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Log API routes for the unified dev console.
+ *
+ * Mounts on the existing Express app to provide:
+ * - GET /api/logs       — JSON query (delegates to MemoryLogSink)
+ * - GET /api/logs/stream — SSE real-time stream (supports server-side filtering via query params)
+ * - GET /api/logs/stats  — Queue sizes and capacities
+ */
+import { Router } from 'express';
+import type { MemoryLogSink } from '../../logging/sinks/MemoryLogSink.js';
+import type { UnifiedLogEntry } from '../../logging/types.js';
+export interface LogRoutesResult {
+    router: Router;
+    broadcast: (entry: UnifiedLogEntry) => void;
+    clientCount: () => number;
+}
+export declare function createLogRoutes(memorySink: MemoryLogSink): LogRoutesResult;
+//# sourceMappingURL=logRoutes.d.ts.map

package/dist/web/routes/logRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logRoutes.d.ts","sourceRoot":"","sources":["../../../src/web/routes/logRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,wBAAwB,CAAC;AAgBrF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,MAAM,CAAC;CAC3B;AAuCD,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,eAAe,CA+D1E"}

package/dist/web/routes/logRoutes.js

@@ -0,0 +1,126 @@
+/**
+ * Log API routes for the unified dev console.
+ *
+ * Mounts on the existing Express app to provide:
+ * - GET /api/logs       — JSON query (delegates to MemoryLogSink)
+ * - GET /api/logs/stream — SSE real-time stream (supports server-side filtering via query params)
+ * - GET /api/logs/stats  — Queue sizes and capacities
+ */
+import { Router } from 'express';
+import { LOG_LEVEL_PRIORITY } from '../../logging/types.js';
+function parseLogQueryOptions(query) {
+    const options = {};
+    const stringFields = ['category', 'level', 'source', 'message', 'correlationId', 'since', 'until'];
+    for (const field of stringFields) {
+        if (typeof query[field] === 'string' && query[field]) {
+            options[field] = query[field];
+        }
+    }
+    for (const field of ['limit', 'offset']) {
+        if (typeof query[field] === 'string') {
+            const parsed = Number.parseInt(query[field], 10);
+            if (!Number.isNaN(parsed))
+                options[field] = parsed;
+        }
+    }
+    return options;
+}
+function parseSseFilter(query) {
+    const filter = {};
+    if (typeof query['category'] === 'string' && query['category']) {
+        filter.category = query['category'];
+    }
+    if (typeof query['level'] === 'string' && query['level']) {
+        filter.level = query['level'];
+    }
+    if (typeof query['source'] === 'string' && query['source']) {
+        filter.source = query['source'];
+    }
+    if (typeof query['correlationId'] === 'string' && query['correlationId']) {
+        filter.correlationId = query['correlationId'];
+    }
+    if (typeof query['sessionId'] === 'string' && query['sessionId']) {
+        filter.sessionId = query['sessionId'];
+    }
+    return filter;
+}
+export function createLogRoutes(memorySink) {
+    const router = Router();
+    const clients = new Set();
+    // GET /api/logs — JSON query
+    router.get('/logs', (req, res) => {
+        const result = memorySink.query(parseLogQueryOptions(req.query));
+        res.json(result);
+    });
+    // GET /api/logs/stream — SSE endpoint
+    router.get('/logs/stream', (req, res) => {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        });
+        res.write(':connected\n\n');
+        const filter = parseSseFilter(req.query);
+        const client = { res, filter };
+        clients.add(client);
+        // Backfill recent history (oldest-first for chronological order).
+        // Capped at 500 entries to avoid blocking the event loop on connect.
+        const history = memorySink.query({ category: 'all', limit: 500 });
+        const entries = history.entries.slice().reverse();
+        for (const entry of entries) {
+            if (matchesFilter(entry, filter)) {
+                res.write(`data: ${JSON.stringify(entry)}\n\n`);
+            }
+        }
+        // Keep-alive heartbeat — prevents proxies from closing idle connections
+        const heartbeat = setInterval(() => {
+            res.write(': heartbeat\n\n');
+        }, 30_000);
+        req.on('close', () => {
+            clearInterval(heartbeat);
+            clients.delete(client);
+        });
+    });
+    // GET /api/logs/stats — Queue sizes/capacities
+    router.get('/logs/stats', (_req, res) => {
+        res.json(memorySink.getStats());
+    });
+    function broadcast(entry) {
+        for (const client of clients) {
+            if (client.res.destroyed) {
+                clients.delete(client);
+                continue;
+            }
+            if (matchesFilter(entry, client.filter)) {
+                client.res.write(`data: ${JSON.stringify(entry)}\n\n`);
+            }
+        }
+    }
+    return {
+        router,
+        broadcast,
+        clientCount: () => clients.size,
+    };
+}
+function matchesFilter(entry, filter) {
+    if (filter.category && entry.category !== filter.category) {
+        return false;
+    }
+    if (filter.level && LOG_LEVEL_PRIORITY[entry.level] < LOG_LEVEL_PRIORITY[filter.level]) {
+        return false;
+    }
+    if (filter.source) {
+        const needle = filter.source.toLowerCase();
+        if (!entry.source.toLowerCase().includes(needle)) {
+            return false;
+        }
+    }
+    if (filter.correlationId && entry.correlationId !== filter.correlationId) {
+        return false;
+    }
+    if (filter.sessionId && entry.data?.['_sessionId'] !== filter.sessionId) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nUm91dGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3dlYi9yb3V0ZXMvbG9nUm91dGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7O0dBT0c7QUFFSCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBSWpDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBcUI1RCxTQUFTLG9CQUFvQixDQUFDLEtBQXVCO0lBQ25ELE1BQU0sT0FBTyxHQUE0QixFQUFFLENBQUM7SUFDNUMsTUFBTSxZQUFZLEdBQUcsQ0FBQyxVQUFVLEVBQUUsT0FBTyxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsZUFBZSxFQUFFLE9BQU8sRUFBRSxPQUFPLENBQVUsQ0FBQztJQUM1RyxLQUFLLE1BQU0sS0FBSyxJQUFJLFlBQVksRUFBRSxDQUFDO1FBQ2pDLElBQUksT0FBTyxLQUFLLENBQUMsS0FBSyxDQUFDLEtBQUssUUFBUSxJQUFJLEtBQUssQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQ3JELE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDaEMsQ0FBQztJQUNILENBQUM7SUFDRCxLQUFLLE1BQU0sS0FBSyxJQUFJLENBQUMsT0FBTyxFQUFFLFFBQVEsQ0FBVSxFQUFFLENBQUM7UUFDakQsSUFBSSxPQUFPLEtBQUssQ0FBQyxLQUFLLENBQUMsS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUNyQyxNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztZQUNqRCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUM7Z0JBQUUsT0FBTyxDQUFDLEtBQUssQ0FBQyxHQUFHLE1BQU0sQ0FBQztRQUNyRCxDQUFDO0lBQ0gsQ0FBQztJQUNELE9B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KiBMb2cgQVBJIHJvdXRlcyBmb3IgdGhlIHVuaWZpZWQgZGV2IGNvbnNvbGUuXG4gKlxuICogTW91bnRzIG9uIHRoZSBleGlzdGluZyBFeHByZXNzIGFwcCB0byBwcm92aWRlOlxuICogLSBHRVQgL2FwaS9sb2dzICAgICAgIOKAlCBKU09OIHF1ZXJ5IChkZWxlZ2F0ZXMgdG8gTWVtb3J5TG9nU2luaylcbiAqIC0gR0VUIC9hcGkvbG9ncy9zdHJlYW0g4oCUIFNTRSByZWFsLXRpbWUgc3RyZWFtIChzdXBwb3J0cyBzZXJ2ZXItc2lkZSBmaWx0ZXJpbmcgdmlhIHF1ZXJ5IHBhcmFtcylcbiAqIC0gR0VUIC9hcGkvbG9ncy9zdGF0cyAg4oCUIFF1ZXVlIHNpemVzIGFuZCBjYXBhY2l0aWVzXG4gKi9cblxuaW1wb3J0IHsgUm91dGVyIH0gZnJvbSAnZXhwcmVzcyc7XG5pbXBvcnQgdHlwZSB7IFJlcXVlc3QsIFJlc3BvbnNlIH0gZnJvbSAnZXhwcmVzcyc7XG5pbXBvcnQgdHlwZSB7IE1lbW9yeUxvZ1NpbmsgfSBmcm9tICcuLi8uLi9sb2dnaW5nL3NpbmtzL01lbW9yeUxvZ1NpbmsuanMnO1xuaW1wb3J0IHR5cGUgeyBVbmlmaWVkTG9nRW50cnksIExvZ0NhdGVnb3J5LCBMb2dMZXZlbCB9IGZyb20gJy4uLy4uL2xvZ2dpbmcvdHlwZXMuanMnO1xuaW1wb3J0IHsgTE9HX0xFVkVMX1BSSU9SSVRZIH0gZnJvbSAnLi4vLi4vbG9nZ2luZy90eXBlcy5qcyc7XG5cbmludGVyZmFjZSBTU0VDbGllbnRGaWx0ZXIge1xuICBjYXRlZ29yeT86IExvZ0NhdGVnb3J5O1xuICBsZXZlbD86IExvZ0xldmVsO1xuICBzb3VyY2U/OiBzdHJpbmc7XG4gIGNvcnJlbGF0aW9uSWQ/OiBzdHJpbmc7XG4gIHNlc3Npb25JZD86IHN0cmluZztcbn1cblxuaW50ZXJmYWNlIFNTRUNsaWVudCB7XG4gIHJlczogUmVzcG9uc2U7XG4gIGZpbHRlcjogU1NFQ2xpZW50RmlsdGVyO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIExvZ1JvdXRlc1Jlc3VsdCB7XG4gIHJvdXRlcjogUm91dGVyO1xuICBicm9hZGNhc3Q6IChlbnRyeTogVW5pZmllZExvZ0VudHJ5KSA9PiB2b2lkO1xuICBjbGllbnRDb3VudDogKCkgPT4gbnVtYmVyO1xufVxuXG5mdW5jdGlvbiBwYXJzZUxvZ1F1ZXJ5T3B0aW9ucyhxdWVyeTogUmVxdWVzdFsncXVlcnknXSk6IFJlY29yZDxzdHJpbmcsIHVua25vd24+IHtcbiAgY29uc3Qgb3B0aW9uczogUmVjb3JkPHN0cmluZywgdW5rbm93bj4gPSB7fTtcbiAgY29uc3Qgc3RyaW5nRmllbGRzID0gWydjYXRlZ29yeScsICdsZXZlbCcsICdzb3VyY2UnLCAnbWVzc2FnZScsICdjb3JyZWxhdGlvbklkJywgJ3NpbmNlJywgJ3VudGlsJ10gYXMgY29uc3Q7XG4gIGZvciAoY29uc3QgZmllbGQgb2Ygc3RyaW5nRmllbGRzKSB7XG4gICAgaWYgKHR5cGVvZiBxdWVyeVtmaWVsZF0gPT09ICdzdHJpbmcnICYmIHF1ZXJ5W2ZpZWxkXSkge1xuICAgICAgb3B0aW9uc1tmaWVsZF0gPSBxdWVyeVtmaWVsZF07XG4gICAgfVxuICB9XG4gIGZvciAoY29uc3QgZmllbGQgb2YgWydsaW1pdCcsICdvZmZzZXQnXSBhcyBjb25zdCkge1xuICAgIGlmICh0eXBlb2YgcXVlcnlbZmllbGRdID09PSAnc3RyaW5nJykge1xuICAgICAgY29uc3QgcGFyc2VkID0gTnVtYmVyLnBhcnNlSW50KHF1ZXJ5W2ZpZWxkXSwgMTApO1xuICAgICAgaWYgKCFOdW1iZXIuaXNOYU4ocGFyc2VkKSkgb3B0aW9uc1tmaWVsZF0gPSBwYXJzZWQ7XG4gICAgfVxuICB9XG4gIHJldHVybiBvcHRpb25zO1xufVxuXG5mdW5jdGlvbiBwYXJzZVNzZUZpbHRlcihxdWVyeTogUmVxdWVzdFsncXVlcnknXSk6IFNTRUNsaWVudEZpbHRlciB7XG4gIGNvbnN0IGZpbHRlcjogU1NFQ2xpZW50RmlsdGVyID0ge307XG4gIGlmICh0eXBlb2YgcXVlcnlbJ2NhdGVnb3J5J10gPT09ICdzdHJpbmcnICYmIHF1ZXJ5WydjYXRlZ29yeSddKSB7XG4gICAgZmlsdGVyLmNhdGVnb3J5ID0gcXVlcnlbJ2NhdGVnb3J5J10gYXMgTG9nQ2F0ZWdvcnk7XG4gIH1cbiAgaWYgKHR5cGVvZiBxdWVyeVsnbGV2ZWwnXSA9PT0gJ3N0cmluZycgJiYgcXVlcnlbJ2xldmVsJ10pIHtcbiAgICBmaWx0ZXIubGV2ZWwgPSBxdWVyeVsnbGV2ZWwnXSBhcyBMb2dMZXZlbDtcbiAgfVxuICBpZiAodHlwZW9mIHF1ZXJ5Wydzb3VyY2UnXSA9PT0gJ3N0cmluZycgJiYgcXVlcnlbJ3NvdXJjZSddKSB7XG4gICAgZmlsdGVyLnNvdXJjZSA9IHF1ZXJ5Wydzb3VyY2UnXTtcbiAgfVxuICBpZiAodHlwZW9mIHF1ZXJ5Wydjb3JyZWxhdGlvbklkJ10gPT09ICdzdHJpbmcnICYmIHF1ZXJ5Wydjb3JyZWxhdGlvbklkJ10pIHtcbiAgICBmaWx0ZXIuY29ycmVsYXRpb25JZCA9IHF1ZXJ5Wydjb3JyZWxhdGlvbklkJ107XG4gIH1cbiAgaWYgKHR5cGVvZiBxdWVyeVsnc2Vzc2lvbklkJ10gPT09ICdzdHJpbmcnICYmIHF1ZXJ5WydzZXNzaW9uSWQnXSkge1xuICAgIGZpbHRlci5zZXNzaW9uSWQgPSBxdWVyeVsnc2Vzc2lvbklkJ107XG4gIH1cbiAgcmV0dXJuIGZpbHRlcjtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUxvZ1JvdXRlcyhtZW1vcnlTaW5rOiBNZW1vcnlMb2dTaW5rKTogTG9nUm91dGVzUmVzdWx0IHtcbiAgY29uc3Qgcm91dGVyID0gUm91dGVyKCk7XG4gIGNvbnN0IGNsaWVudHMgPSBuZXcgU2V0PFNTRUNsaWVudD4oKTtcblxuICAvLyBHRVQgL2FwaS9sb2dzIOKAlCBKU09OIHF1ZXJ5XG4gIHJvdXRlci5nZXQoJy9sb2dzJywgKHJlcTogUmVxdWVzdCwgcmVzOiBSZXNwb25zZSkgPT4ge1xuICAgIGNvbnN0IHJlc3VsdCA9IG1lbW9yeVNpbmsucXVlcnkocGFyc2VMb2dRdWVyeU9wdGlvbnMocmVxLnF1ZXJ5KSk7XG4gICAgcmVzLmpzb24ocmVzdWx0KTtcbiAgfSk7XG5cbiAgLy8gR0VUIC9hcGkvbG9ncy9zdHJlYW0g4oCUIFNTRSBlbmRwb2ludFxuICByb3V0ZXIuZ2V0KCcvbG9ncy9zdHJlYW0nLCAocmVxOiBSZXF1ZXN0LCByZXM6IFJlc3BvbnNlKSA9PiB7XG4gICAgcmVzLndyaXRlSGVhZCgyMDAsIHtcbiAgICAgICdDb250ZW50LVR5cGUnOiAndGV4dC9ldmVudC1zdHJlYW0nLFxuICAgICAgJ0NhY2hlLUNvbnRyb2wnOiAnbm8tY2FjaGUnLFxuICAgICAgJ0Nvbm5lY3Rpb24nOiAna2VlcC1hbGl2ZScsXG4gICAgfSk7XG4gICAgcmVzLndyaXRlKCc6Y29ubmVjdGVkXFxuXFxuJyk7XG5cbiAgICBjb25zdCBmaWx0ZXIgPSBwYXJzZVNzZUZpbHRlcihyZXEucXVlcnkpO1xuICAgIGNvbnN0IGNsaWVudDogU1NFQ2xpZW50ID0geyByZXMsIGZpbHRlciB9O1xuICAgIGNsaWVudHMuYWRkKGNsaWVudCk7XG5cbiAgICAvLyBCYWNrZmlsbCByZWNlbnQgaGlzdG9yeSAob2xkZXN0LWZpcnN0IGZvciBjaHJvbm9sb2dpY2FsIG9yZGVyKS5cbiAgICAvLyBDYXBwZWQgYXQgNTAwIGVudHJpZXMgdG8gYXZvaWQgYmxvY2tpbmcgdGhlIGV2ZW50IGxvb3Agb24gY29ubmVjdC5cbiAgICBjb25zdCBoaXN0b3J5ID0gbWVtb3J5U2luay5xdWVyeSh7IGNhdGVnb3J5OiAnYWxsJywgbGltaXQ6IDUwMCB9KTtcbiAgICBjb25zdCBlbnRyaWVzID0gaGlzdG9yeS5lbnRyaWVzLnNsaWNlKCkucmV2ZXJzZSgpO1xuICAgIGZvciAoY29uc3QgZW50cnkgb2YgZW50cmllcykge1xuICAgICAgaWYgKG1hdGNoZXNGaWx0ZXIoZW50cnksIGZpbHRlcikpIHtcbiAgICAgICAgcmVzLndyaXRlKGBkYXRhOiAke0pTT04uc3RyaW5naWZ5KGVudHJ5KX1cXG5cXG5gKTtcbiAgICAgIH1cbiAgICB9XG5cbiAgICAvLyBLZWVwLWFsaXZlIGhlYXJ0YmVhdCDigJQgcHJldmVudHMgcHJveGllcyBmcm9tIGNsb3NpbmcgaWRsZSBjb25uZWN0aW9uc1xuICAgIGNvbnN0IGhlYXJ0YmVhdCA9IHNldEludGVydmFsKCgpID0+IHtcbiAgICAgIHJlcy53cml0ZSgnOiBoZWFydGJlYXRcXG5cXG4nKTtcbiAgICB9LCAzMF8wMDApO1xuXG4gICAgcmVxLm9uKCdjbG9zZScsICgpID0+IHtcbiAgICAgIGNsZWFySW50ZXJ2YWwoaGVhcnRiZWF0KTtcbiAgICAgIGNsaWVudHMuZGVsZXRlKGNsaWVudCk7XG4gICAgfSk7XG4gIH0pO1xuXG4gIC8vIEdFVCAvYXBpL2xvZ3Mvc3RhdHMg4oCUIFF1ZXVlIHNpemVzL2NhcGFjaXRpZXNcbiAgcm91dGVyLmdldCgnL2xvZ3Mvc3RhdHMnLCAoX3JlcTogUmVxdWVzdCwgcmVzOiBSZXNwb25zZSkgPT4ge1xuICAgIHJlcy5qc29uKG1lbW9yeVNpbmsuZ2V0U3RhdHMoKSk7XG4gIH0pO1xuXG4gIGZ1bmN0aW9uIGJyb2FkY2FzdChlbnRyeTogVW5pZmllZExvZ0VudHJ5KTogdm9pZCB7XG4gICAgZm9yIChjb25zdCBjbGllbnQgb2YgY2xpZW50cykge1xuICAgICAgaWYgKGNsaWVudC5yZXMuZGVzdHJveWVkKSB7IGNsaWVudHMuZGVsZXRlKGNsaWVudCk7IGNvbnRpbnVlOyB9XG4gICAgICBpZiAobWF0Y2hlc0ZpbHRlcihlbnRyeSwgY2xpZW50LmZpbHRlcikpIHtcbiAgICAgICAgY2xpZW50LnJlcy53cml0ZShgZGF0YTogJHtKU09OLnN0cmluZ2lmeShlbnRyeSl9XFxuXFxuYCk7XG4gICAgICB9XG4gICAgfVxuICB9XG5cbiAgcmV0dXJuIHtcbiAgICByb3V0ZXIsXG4gICAgYnJvYWRjYXN0LFxuICAgIGNsaWVudENvdW50OiAoKSA9PiBjbGllbnRzLnNpemUsXG4gIH07XG59XG5cbmZ1bmN0aW9uIG1hdGNoZXNGaWx0ZXIoZW50cnk6IFVuaWZpZWRMb2dFbnRyeSwgZmlsdGVyOiBTU0VDbGllbnRGaWx0ZXIpOiBib29sZWFuIHtcbiAgaWYgKGZpbHRlci5jYXRlZ29yeSAmJiBlbnRyeS5jYXRlZ29yeSAhPT0gZmlsdGVyLmNhdGVnb3J5KSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIGlmIChmaWx0ZXIubGV2ZWwgJiYgTE9HX0xFVkVMX1BSSU9SSVRZW2VudHJ5LmxldmVsXSA8IExPR19MRVZFTF9QUklPUklUWVtmaWx0ZXIubGV2ZWxdKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIGlmIChmaWx0ZXIuc291cmNlKSB7XG4gICAgY29uc3QgbmVlZGxlID0gZmlsdGVyLnNvdXJjZS50b0xvd2VyQ2FzZSgpO1xuICAgIGlmICghZW50cnkuc291cmNlLnRvTG93ZXJDYXNlKCkuaW5jbHVkZXMobmVlZGxlKSkge1xuICAgICAgcmV0dXJuIGZhbHNlO1xuICAgIH1cbiAgfVxuICBpZiAoZmlsdGVyLmNvcnJlbGF0aW9uSWQgJiYgZW50cnkuY29ycmVsYXRpb25JZCAhPT0gZmlsdGVyLmNvcnJlbGF0aW9uSWQpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cbiAgaWYgKGZpbHRlci5zZXNzaW9uSWQgJiYgZW50cnkuZGF0YT8uWydfc2Vzc2lvbklkJ10gIT09IGZpbHRlci5zZXNzaW9uSWQpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cbiAgcmV0dXJuIHRydWU7XG59XG4iXX0=

package/dist/web/routes/metricsRoutes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Metrics API routes for the unified dev console.
+ *
+ * Mounts on the existing Express app to provide:
+ * - GET /api/metrics        — JSON query (delegates to MemoryMetricsSink)
+ * - GET /api/metrics/stream — SSE endpoint, pushes each new snapshot
+ */
+import { Router } from 'express';
+import type { MemoryMetricsSink } from '../../metrics/sinks/MemoryMetricsSink.js';
+import type { MetricSnapshot } from '../../metrics/types.js';
+export interface MetricsRoutesResult {
+    router: Router;
+    onSnapshot: (snapshot: MetricSnapshot) => void;
+    clientCount: () => number;
+}
+export declare function createMetricsRoutes(metricsSink: MemoryMetricsSink): MetricsRoutesResult;
+//# sourceMappingURL=metricsRoutes.d.ts.map

package/dist/web/routes/metricsRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsRoutes.d.ts","sourceRoot":"","sources":["../../../src/web/routes/metricsRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,wBAAwB,CAAC;AAOzE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,WAAW,EAAE,MAAM,MAAM,CAAC;CAC3B;AAqCD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,mBAAmB,CAiDvF"}