ccsniff 1.0.31 → 1.0.33

package/README.md

@@ -67,6 +67,21 @@ Two formats are supported via `--unsloth-format`:
 
 Sessions with no user/assistant turn pair are skipped (no training value).
 
+## GUI (Observatory)
+
+A turnkey, zero-dep browser observatory ships with the package. It indexes
+every session in `~/.claude/projects` and exposes sessions, projects, tools,
+timeline, errors, subagent tree, live stream, and BM25 full-text search.
+
+```bash
+npx ccsniff gui --open          # auto-open in default browser
+npx ccsniff gui --port 4791     # custom port (default 4791)
+```
+
+Endpoints under `/api/*`: `snapshot`, `sessions`, `projects`, `tools`,
+`timeline`, `stats`, `errors`, `subagents`, `events`, `search`, `stream`
+(SSE).
+
 ## API
 
 ### `watch(projectsDir?)` → `JsonlWatcher`

package/gui/app.js

@@ -1,6 +1,6 @@
 import { mount, components as C, h } from 'anentrypoint-design';
 
-const TABS = ['overview', 'sessions', 'projects', 'tools', 'timeline', 'errors', 'subagents', 'live', 'search'];
+const TABS = ['overview', 'sessions', 'projects', 'tools', 'timeline', 'errors', 'subagents', 'events', 'live', 'search'];
 const state = {
   tab: 'overview',
   data: { snapshot: null, sessions: [], projects: [], tools: [], timeline: [], stats: null, errors: [], subagents: [] },
@@ -8,6 +8,9 @@ const state = {
   searchResults: [],
   searching: false,
   liveLog: [],
+  defaults: { active: 'recent', presets: [] },
+  activePreset: 'recent',
+  events: { total: 0, rows: [], loading: false },
 };
 
 const api = (p) => fetch(p).then(r => r.json());
@@ -144,16 +147,81 @@ function SubagentsView() {
   ) });
 }
 
-function LiveView() {
-  return C.Panel({ head: `live · ${state.liveLog.length} events (last 200)`, children: h('div', { class: 'live' },
-    ...state.liveLog.slice().reverse().map((e, i) => h('div', { key: i, class: 'e' },
-      h('span', { class: 'ts' }, ts(e.ts || Date.now()).slice(11)),
-      h('span', { class: 'k' }, e._kind || 'event'),
-      h('span', {}, fmtLive(e)),
+function PresetChips() {
+  const presets = state.defaults.presets || [];
+  return h('div', { style: 'display:flex;flex-wrap:wrap;gap:6px;padding:8px 12px' },
+    ...presets.map(p => h('span', {
+      class: 'pill' + (p.id === state.activePreset ? ' accent' : ''),
+      style: 'cursor:pointer;user-select:none;' + (p.id === state.activePreset ? 'outline:1px solid currentColor' : ''),
+      onclick: () => { state.activePreset = p.id; loadEvents(); },
+    }, p.label)),
+  );
+}
+
+function currentPresetQuery() {
+  const p = (state.defaults.presets || []).find(x => x.id === state.activePreset);
+  return p?.query || {};
+}
+
+async function loadEvents() {
+  state.events.loading = true; render();
+  const q = currentPresetQuery();
+  const params = new URLSearchParams();
+  for (const [k, v] of Object.entries(q)) if (v !== undefined && v !== null && v !== '') params.set(k, String(v));
+  params.set('limit', '200');
+  const r = await api('/api/events?' + params.toString());
+  state.events = { total: r.total || 0, rows: r.rows || [], loading: false, error: r.error || null };
+  render();
+}
+
+function EventsView() {
+  const rows = state.events.rows;
+  return C.Panel({ head: `events · ${state.events.total} match · showing ${rows.length}`, children: h('div', {},
+    PresetChips(),
+    state.events.error ? h('div', { class: 'err', style: 'padding:8px 12px' }, state.events.error) : null,
+    h('div', { class: 'row-grid', style: 'grid-template-columns:140px 80px 110px 100px 1fr;opacity:.55' },
+      h('span', {}, 'when'), h('span', {}, 'role'), h('span', {}, 'type'), h('span', {}, 'tool'), h('span', {}, 'text')),
+    ...rows.map(e => h('div', { class: 'row-grid', style: 'grid-template-columns:140px 80px 110px 100px 1fr' },
+      h('span', {}, ts(e.ts).slice(5)),
+      h('span', {}, e.role || '—'),
+      h('span', {}, e.type || '—'),
+      h('span', { class: 'accent' }, e.tool || '—'),
+      h('span', { class: 'truncate' + (e.isError ? ' err' : '') },
+        h('span', { class: 'pill' }, e.project || '—'),
+        ' ',
+        (e.text || '').slice(0, 400)),
     )),
   ) });
 }
 
+function liveMatches(e) {
+  const q = currentPresetQuery();
+  if (q.role && e.role !== q.role) return false;
+  if (q.type && e.type !== q.type) return false;
+  if (q.tool && e.tool !== q.tool) return false;
+  if (q.project && e.project !== q.project) return false;
+  if (q.isMeta === true && !e.isMeta) return false;
+  if (q.isMeta === false && e.isMeta) return false;
+  if (q.isSubagent === true && !e.isSubagent) return false;
+  if (q.isSubagent === false && e.isSubagent) return false;
+  if (q.isError === true && !e.isError) return false;
+  return true;
+}
+
+function LiveView() {
+  const filtered = state.liveLog.filter(e => e._kind !== 'event' || liveMatches(e));
+  return C.Panel({ head: `live · ${filtered.length}/${state.liveLog.length} events (preset: ${state.activePreset})`, children: h('div', {},
+    PresetChips(),
+    h('div', { class: 'live' },
+      ...filtered.slice().reverse().map((e, i) => h('div', { key: i, class: 'e' },
+        h('span', { class: 'ts' }, ts(e.ts || Date.now()).slice(11)),
+        h('span', { class: 'k' }, e._kind || 'event'),
+        h('span', {}, fmtLive(e)),
+      )),
+    ),
+  ) });
+}
+
 function fmtLive(e) {
   if (e._kind === 'conversation') return 'new ' + (e.conv?.title || e.conv?.id?.slice(0, 8));
   if (e._kind === 'start' || e._kind === 'complete') return (e.sid || '').slice(0, 8);
@@ -192,7 +260,7 @@ async function doSearch() {
   state.searching = false; render();
 }
 
-const VIEWS = { overview: Overview, sessions: SessionsView, projects: ProjectsView, tools: ToolsView, timeline: TimelineView, errors: ErrorsView, subagents: SubagentsView, live: LiveView, search: SearchView };
+const VIEWS = { overview: Overview, sessions: SessionsView, projects: ProjectsView, tools: ToolsView, timeline: TimelineView, errors: ErrorsView, subagents: SubagentsView, events: EventsView, live: LiveView, search: SearchView };
 
 function App() {
   const s = state.data.snapshot || {};
@@ -201,7 +269,7 @@ function App() {
       brand: '247420', leaf: 'ccsniff',
       items: TABS.map(t => [t, '#/' + t]),
       active: state.tab,
-      onNav: (t) => { state.tab = t; location.hash = '#/' + t; render(); },
+      onNav: (t) => { state.tab = t; location.hash = '#/' + t; render(); if (t === 'events') loadEvents(); },
     }),
     main: h('div', { style: 'padding:16px;display:flex;flex-direction:column;gap:16px' },
       C.Crumb({ trail: ['247420', 'ccsniff'], leaf: state.tab, right: h('span', { class: 'pill' }, n(s.events) + ' events') }),
@@ -224,7 +292,13 @@ render();
 })();
 
 (async function init() {
+  try {
+    const d = await api('/api/defaults');
+    state.defaults = d || state.defaults;
+    state.activePreset = d?.active || state.activePreset;
+  } catch {}
   await loadAll();
+  if (state.tab === 'events') loadEvents();
   setInterval(loadAll, 15_000);
   const sse = new EventSource('/api/stream');
   const push = (kind, data) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccsniff",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "Watch Claude Code JSONL output files and emit structured events as a Node.js EventEmitter",
   "type": "module",
   "main": "./src/index.js",

package/src/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { JsonlReplayer, rollup, vault } from './index.js';
 import { toUnslothMessages, toShareGPT } from './unsloth.js';
+import { parseTime, compileRegexes, buildFilter } from './filters.js';
 import fs from 'fs';
 import path from 'path';
 
@@ -24,8 +25,6 @@ if (process.argv[2] === 'gui') {
   process.stdin.resume();
 } else {
 
-{ const r = vault(); if (r.copied > 0) process.stderr.write(`# vault: ${r.copied} copied → ~/.claude/history-backup\n`); }
-
 const FLAGS = {
   string: ['since', 'until', 'before', 'after', 'grep', 'igrep', 'cwd', 'project', 'role', 'type', 'tool', 'session', 'sid', 'parent', 'rollup', 'format', 'sort', 'unsloth', 'unsloth-format'],
   multi: ['grep', 'igrep', 'role', 'type', 'tool', 'session', 'sid', 'project', 'cwd'],
@@ -71,7 +70,7 @@ TIME (any ISO date, epoch ms, or relative Ns/Nm/Nh/Nd/Nw)
 
 FILTERS (repeatable flags combine as OR within a flag, AND across flags)
   --grep <re>            text regex (case-insensitive); repeat = AND
-  --igrep <re>           inverted text regex; repeat = AND (none must match)
+  --igrep <re>           exclude if regex matches text; repeat = exclude if ANY matches
   --invert               invert the entire filter result
   --cwd <re>             working-dir regex
   --project <name>       basename(cwd) exact match; repeat = OR
@@ -116,21 +115,6 @@ EXAMPLES
 `);
 }
 
-function parseTime(s) {
-  if (!s) return 0;
-  if (/^\d{10,}$/.test(s)) return parseInt(s, 10);
-  const m = /^(\d+)([smhdw])$/.exec(s);
-  if (m) {
-    const n = parseInt(m[1], 10);
-    const mult = { s: 1e3, m: 6e4, h: 36e5, d: 864e5, w: 6048e5 }[m[2]];
-    return Date.now() - n * mult;
-  }
-  const t = Date.parse(s);
-  return Number.isFinite(t) ? t : 0;
-}
-
-function compileRegexes(arr) { return arr.map(s => new RegExp(s, 'i')); }
-
 function blockText(b) {
   if (!b) return '';
   if (typeof b.text === 'string') return b.text;
@@ -140,46 +124,6 @@ function blockText(b) {
   return '';
 }
 
-function buildFilter(opts) {
-  const since = parseTime(opts.since || opts.after);
-  const until = parseTime(opts.until || opts.before);
-  const greps = compileRegexes(opts._multi.grep);
-  const igreps = compileRegexes(opts._multi.igrep);
-  const cwdRes = compileRegexes(opts._multi.cwd);
-  const projects = new Set(opts._multi.project);
-  const roles = new Set(opts._multi.role);
-  const types = new Set(opts._multi.type);
-  const tools = new Set(opts._multi.tool);
-  const sids = opts._multi.session.concat(opts._multi.sid || []);
-  const parent = opts.parent || null;
-
-  return ev => {
-    const conv = ev.conversation || {};
-    const block = ev.block || {};
-    const ts = ev.timestamp || 0;
-    let pass = true;
-    if (since && ts < since) pass = false;
-    else if (until && ts > until) pass = false;
-    else if (cwdRes.length && !cwdRes.every(r => r.test(conv.cwd || ''))) pass = false;
-    else if (projects.size && !projects.has(path.basename(conv.cwd || ''))) pass = false;
-    else if (roles.size && !roles.has(ev.role)) pass = false;
-    else if (types.size && !types.has(block.type)) pass = false;
-    else if (tools.size && !tools.has(block.name)) pass = false;
-    else if (sids.length && !sids.some(s => conv.id?.startsWith(s))) pass = false;
-    else if (parent && conv.parentSid !== parent) pass = false;
-    else if (opts['no-subagents'] && conv.isSubagent) pass = false;
-    else if (opts['only-subagents'] && !conv.isSubagent) pass = false;
-    else if (opts['no-meta'] && block.isMeta) pass = false;
-    else if (opts['only-meta'] && !block.isMeta) pass = false;
-    else {
-      const text = blockText(block);
-      if (greps.length && !greps.every(r => r.test(text))) pass = false;
-      else if (igreps.length && igreps.some(r => r.test(text))) pass = false;
-    }
-    return opts.invert ? !pass : pass;
-  };
-}
-
 function formatRow(ev, opts) {
   const conv = ev.conversation || {};
   const block = ev.block || {};
@@ -242,8 +186,16 @@ function sortRows(rows, key, reverse) {
 const { opts } = parseArgs(process.argv.slice(2));
 if (opts.help || process.argv.length <= 2) { printHelp(); process.exit(0); }
 
-const since = parseTime(opts.since || opts.after);
-const filter = buildFilter(opts);
+{ const r = vault(); if (r.copied > 0) process.stderr.write(`# vault: ${r.copied} copied → ~/.claude/history-backup\n`); }
+
+let since, filter;
+try {
+  since = parseTime(opts.since || opts.after);
+  filter = buildFilter(opts);
+} catch (e) {
+  process.stderr.write(`ccsniff: ${e.message}\n`);
+  process.exit(2);
+}
 
 // ---------- rollup (filtered)
 if (opts.rollup) {

package/src/filters.js

@@ -0,0 +1,89 @@
+// Filter primitives shared by cli.js, gui-server.js, and tests.
+import path from 'path';
+
+export function parseTime(s) {
+  if (s === undefined || s === null || s === '') return 0;
+  if (typeof s === 'number') return Number.isFinite(s) ? s : 0;
+  s = String(s).trim();
+  if (!s) return 0;
+  if (/^\d{10,}$/.test(s)) return parseInt(s, 10);
+  const m = /^(\d+)\s*([smhdw])$/i.exec(s);
+  if (m) {
+    const n = parseInt(m[1], 10);
+    const mult = { s: 1e3, m: 6e4, h: 36e5, d: 864e5, w: 6048e5 }[m[2].toLowerCase()];
+    return Date.now() - n * mult;
+  }
+  const t = Date.parse(s);
+  if (Number.isFinite(t)) return t;
+  throw new Error(`invalid time: ${s} (use ISO date, epoch ms, or Ns/Nm/Nh/Nd/Nw)`);
+}
+
+export function compileRegexes(arr) {
+  return (arr || []).map(s => {
+    try { return new RegExp(s, 'i'); }
+    catch (e) { throw new Error(`invalid regex /${s}/: ${e.message}`); }
+  });
+}
+
+function blockText(b) {
+  if (!b) return '';
+  if (typeof b.text === 'string') return b.text;
+  if (typeof b.content === 'string') return b.content;
+  if (Array.isArray(b.content)) return b.content.map(c => c?.text || '').join('');
+  if (b.input) { try { return JSON.stringify(b.input); } catch { return ''; } }
+  return '';
+}
+
+export function buildFilter(opts) {
+  const m = opts._multi || {};
+  const since = parseTime(opts.since || opts.after);
+  const until = parseTime(opts.until || opts.before);
+  const greps = compileRegexes(m.grep);
+  const igreps = compileRegexes(m.igrep);
+  const cwdRes = compileRegexes(m.cwd);
+  const projects = new Set(m.project || []);
+  const roles = new Set(m.role || []);
+  const types = new Set(m.type || []);
+  const tools = new Set(m.tool || []);
+  const sids = (m.session || []).concat(m.sid || []);
+  const parent = opts.parent || null;
+
+  return ev => {
+    const conv = ev.conversation || {};
+    const block = ev.block || {};
+    const ts = ev.timestamp || 0;
+    let pass = true;
+    if (since && ts < since) pass = false;
+    else if (until && ts > until) pass = false;
+    else if (cwdRes.length && !cwdRes.every(r => r.test(conv.cwd || ''))) pass = false;
+    else if (projects.size && !projects.has(path.basename(conv.cwd || ''))) pass = false;
+    else if (roles.size && !roles.has(ev.role)) pass = false;
+    else if (types.size && !types.has(block.type)) pass = false;
+    else if (tools.size && !tools.has(block.name)) pass = false;
+    else if (sids.length && !sids.some(s => conv.id?.startsWith(s))) pass = false;
+    else if (parent && conv.parentSid !== parent) pass = false;
+    else if (opts['no-subagents'] && conv.isSubagent) pass = false;
+    else if (opts['only-subagents'] && !conv.isSubagent) pass = false;
+    else if (opts['no-meta'] && block.isMeta) pass = false;
+    else if (opts['only-meta'] && !block.isMeta) pass = false;
+    else {
+      const text = blockText(block);
+      if (greps.length && !greps.every(r => r.test(text))) pass = false;
+      else if (igreps.length && igreps.some(r => r.test(text))) pass = false;
+    }
+    return opts.invert ? !pass : pass;
+  };
+}
+
+export const DEFAULT_PRESETS = [
+  { id: 'recent',     label: 'Last 24h',       query: { since: '24h', isMeta: false } },
+  { id: 'week',       label: 'Last 7d',        query: { since: '7d',  isMeta: false } },
+  { id: 'errors',     label: 'Errors',         query: { since: '7d',  isError: true } },
+  { id: 'tools',      label: 'Tool calls',     query: { since: '24h', type: 'tool_use' } },
+  { id: 'user-turns', label: 'User turns',     query: { since: '7d',  role: 'user', type: 'text', isMeta: false } },
+  { id: 'assistant',  label: 'Assistant text', query: { since: '24h', role: 'assistant', type: 'text' } },
+  { id: 'subagents',  label: 'Subagents',      query: { since: '7d',  isSubagent: true } },
+  { id: 'all',        label: 'All time',       query: {} },
+];
+
+export const DEFAULT_ACTIVE = 'recent';

package/src/gui-server.js

@@ -4,9 +4,12 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { JsonlReplayer, JsonlWatcher } from './index.js';
 import { buildIndex, search, snippet, tokenize } from './bm25.js';
+import { DEFAULT_PRESETS, DEFAULT_ACTIVE } from './filters.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const GUI_DIR = path.join(__dirname, '..', 'gui');
+
+export const DEFAULT_FILTERS = { active: DEFAULT_ACTIVE, presets: DEFAULT_PRESETS };
 const MIME = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8', '.json': 'application/json', '.svg': 'image/svg+xml' };
 
 function blockText(b) {
@@ -34,6 +37,7 @@ function flattenEvent(ev, idx) {
     tool: b.name || null,
     text: blockText(b),
     isError: !!b.is_error || ev.role === 'streaming_error',
+    isMeta: !!b.isMeta,
     cost: b.total_cost_usd || null,
     duration: b.duration_ms || null,
     subtype: b.subtype || null,
@@ -223,20 +227,42 @@ class Store {
     return out;
   }
 
-  events_filtered({ role, type, project, sid, tool, since, until, limit = 200, offset = 0, q } = {}) {
+  events_filtered({ role, type, project, sid, tool, since, until, limit = 200, offset = 0, q, grep, igrep, isMeta, isSubagent, isError, parent } = {}) {
     let arr = this.events;
+    let greRe = null, igreRe = null;
+    try {
+      if (grep) greRe = new RegExp(grep, 'i');
+      if (igrep) igreRe = new RegExp(igrep, 'i');
+    } catch (e) {
+      return { total: 0, rows: [], error: `invalid regex: ${e.message}` };
+    }
     if (q) {
-      const tokens = new Set(tokenize(q));
-      arr = arr.filter(e => { const t = tokenize(e.text); return [...tokens].every(x => t.includes(x)); });
+      const tokens = [...new Set(tokenize(q))];
+      if (tokens.length) {
+        arr = arr.filter(e => { const t = tokenize(e.text); return tokens.every(x => t.includes(x)); });
+      } else {
+        // q tokenized to nothing (too short / stopwords) → substring fallback
+        const needle = String(q).toLowerCase();
+        arr = arr.filter(e => (e.text || '').toLowerCase().includes(needle));
+      }
     }
     arr = arr.filter(e => {
       if (role && e.role !== role) return false;
       if (type && e.type !== type) return false;
       if (project && e.project !== project) return false;
       if (sid && !e.sid.startsWith(sid)) return false;
+      if (parent && e.parent !== parent) return false;
       if (tool && e.tool !== tool) return false;
       if (since && e.ts < since) return false;
       if (until && e.ts > until) return false;
+      if (isMeta === true && !e.isMeta) return false;
+      if (isMeta === false && e.isMeta) return false;
+      if (isSubagent === true && !e.isSubagent) return false;
+      if (isSubagent === false && e.isSubagent) return false;
+      if (isError === true && !e.isError) return false;
+      if (isError === false && e.isError) return false;
+      if (greRe && !greRe.test(e.text || '')) return false;
+      if (igreRe && igreRe.test(e.text || '')) return false;
       return true;
     });
     return { total: arr.length, rows: arr.slice(offset, offset + limit) };
@@ -260,14 +286,36 @@ function serveStatic(req, res) {
   });
 }
 
+function parseRelTime(s) {
+  if (s === null || s === undefined || s === '') return 0;
+  const str = String(s).trim();
+  if (/^\d{10,}$/.test(str)) return parseInt(str, 10);
+  const m = /^(\d+)\s*([smhdw])$/i.exec(str);
+  if (m) {
+    const n = parseInt(m[1], 10);
+    const mult = { s: 1e3, m: 6e4, h: 36e5, d: 864e5, w: 6048e5 }[m[2].toLowerCase()];
+    return Date.now() - n * mult;
+  }
+  const t = Date.parse(str);
+  return Number.isFinite(t) ? t : 0;
+}
+function parseBool(v) {
+  if (v === undefined) return undefined;
+  if (v === 'true' || v === '1') return true;
+  if (v === 'false' || v === '0') return false;
+  return undefined;
+}
 function parseQuery(u) {
   const q = {};
   for (const [k, v] of u.searchParams) q[k] = v;
-  if (q.limit) q.limit = parseInt(q.limit, 10);
-  if (q.offset) q.offset = parseInt(q.offset, 10);
-  if (q.since) q.since = parseInt(q.since, 10);
-  if (q.until) q.until = parseInt(q.until, 10);
-  if (q.bucket) q.bucket = parseInt(q.bucket, 10);
+  if (q.limit !== undefined) q.limit = parseInt(q.limit, 10) || 200;
+  if (q.offset !== undefined) q.offset = parseInt(q.offset, 10) || 0;
+  if (q.since !== undefined) q.since = parseRelTime(q.since);
+  if (q.until !== undefined) q.until = parseRelTime(q.until);
+  if (q.bucket !== undefined) q.bucket = parseInt(q.bucket, 10) || 0;
+  for (const k of ['isMeta', 'isSubagent', 'isError']) {
+    if (q[k] !== undefined) q[k] = parseBool(q[k]);
+  }
   return q;
 }
 
@@ -291,6 +339,7 @@ export function createServer({ projectsDir, port = 0, host = '127.0.0.1' } = {})
       if (path === '/api/errors') return send(res, 200, store.errorsList());
       if (path === '/api/subagents') return send(res, 200, store.subagents());
       if (path === '/api/events') return send(res, 200, store.events_filtered(q));
+      if (path === '/api/defaults') return send(res, 200, DEFAULT_FILTERS);
       if (path === '/api/search') return send(res, 200, { query: q.q || '', results: q.q ? store.search(q.q, q) : [] });
       if (path === '/api/reindex') { store.rebuildIndex(); return send(res, 200, { ok: true, at: store.lastBuilt }); }
       if (path === '/api/stream') {

package/src/unsloth.js

@@ -1,8 +1,17 @@
+const SYS_REMINDER = /<system-reminder>[\s\S]*?<\/system-reminder>/gi;
+const CC_ENVELOPE = /<\/?(command-name|command-message|command-args|local-command-stdout|local-command-stderr|user-prompt-submit-hook|stdin)[^>]*>/gi;
+
+function sanitize(s) {
+  if (typeof s !== 'string' || !s) return s || '';
+  return s.replace(SYS_REMINDER, '').replace(CC_ENVELOPE, '').replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+
 function textOf(b) {
-  if (typeof b.text === 'string') return b.text;
-  if (typeof b.content === 'string') return b.content;
-  if (Array.isArray(b.content)) return b.content.map(c => c?.text || '').join('');
-  return '';
+  let raw = '';
+  if (typeof b.text === 'string') raw = b.text;
+  else if (typeof b.content === 'string') raw = b.content;
+  else if (Array.isArray(b.content)) raw = b.content.map(c => c?.text || '').join('');
+  return sanitize(raw);
 }
 
 function groupBySession(events) {