agent-knowledge 1.1.6 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/CHANGELOG.md +115 -5
  2. package/README.md +86 -24
  3. package/dist/dashboard.d.ts +1 -0
  4. package/dist/dashboard.d.ts.map +1 -1
  5. package/dist/dashboard.js +145 -19
  6. package/dist/dashboard.js.map +1 -1
  7. package/dist/embeddings/anthropic.d.ts.map +1 -1
  8. package/dist/embeddings/anthropic.js +2 -1
  9. package/dist/embeddings/anthropic.js.map +1 -1
  10. package/dist/embeddings/gemini.d.ts.map +1 -1
  11. package/dist/embeddings/gemini.js +2 -1
  12. package/dist/embeddings/gemini.js.map +1 -1
  13. package/dist/embeddings/local.d.ts.map +1 -1
  14. package/dist/embeddings/local.js +3 -0
  15. package/dist/embeddings/local.js.map +1 -1
  16. package/dist/knowledge/consolidate.d.ts +46 -0
  17. package/dist/knowledge/consolidate.d.ts.map +1 -0
  18. package/dist/knowledge/consolidate.js +164 -0
  19. package/dist/knowledge/consolidate.js.map +1 -0
  20. package/dist/knowledge/distill.d.ts.map +1 -1
  21. package/dist/knowledge/distill.js +4 -2
  22. package/dist/knowledge/distill.js.map +1 -1
  23. package/dist/knowledge/graph.d.ts +64 -0
  24. package/dist/knowledge/graph.d.ts.map +1 -0
  25. package/dist/knowledge/graph.js +214 -0
  26. package/dist/knowledge/graph.js.map +1 -0
  27. package/dist/knowledge/reflect.d.ts +33 -0
  28. package/dist/knowledge/reflect.d.ts.map +1 -0
  29. package/dist/knowledge/reflect.js +115 -0
  30. package/dist/knowledge/reflect.js.map +1 -0
  31. package/dist/knowledge/scoring.d.ts +57 -0
  32. package/dist/knowledge/scoring.d.ts.map +1 -0
  33. package/dist/knowledge/scoring.js +194 -0
  34. package/dist/knowledge/scoring.js.map +1 -0
  35. package/dist/knowledge/search.d.ts.map +1 -1
  36. package/dist/knowledge/search.js +15 -2
  37. package/dist/knowledge/search.js.map +1 -1
  38. package/dist/knowledge/store.d.ts.map +1 -1
  39. package/dist/knowledge/store.js +4 -3
  40. package/dist/knowledge/store.js.map +1 -1
  41. package/dist/search/excerpt.d.ts.map +1 -1
  42. package/dist/search/excerpt.js +2 -1
  43. package/dist/search/excerpt.js.map +1 -1
  44. package/dist/search/tfidf.d.ts +1 -0
  45. package/dist/search/tfidf.d.ts.map +1 -1
  46. package/dist/search/tfidf.js +38 -3
  47. package/dist/search/tfidf.js.map +1 -1
  48. package/dist/server.d.ts.map +1 -1
  49. package/dist/server.js +117 -381
  50. package/dist/server.js.map +1 -1
  51. package/dist/sessions/parser.d.ts.map +1 -1
  52. package/dist/sessions/parser.js +12 -10
  53. package/dist/sessions/parser.js.map +1 -1
  54. package/dist/sessions/search.js +17 -3
  55. package/dist/sessions/search.js.map +1 -1
  56. package/dist/sessions/summary.d.ts.map +1 -1
  57. package/dist/sessions/summary.js +6 -3
  58. package/dist/sessions/summary.js.map +1 -1
  59. package/dist/tool-handlers.d.ts +42 -0
  60. package/dist/tool-handlers.d.ts.map +1 -0
  61. package/dist/tool-handlers.js +425 -0
  62. package/dist/tool-handlers.js.map +1 -0
  63. package/dist/types.d.ts.map +1 -1
  64. package/dist/types.js +6 -4
  65. package/dist/types.js.map +1 -1
  66. package/dist/ui/app.js +94 -723
  67. package/dist/ui/index.html +29 -0
  68. package/dist/ui/render-knowledge.js +233 -0
  69. package/dist/ui/render-panel.js +350 -0
  70. package/dist/ui/render-search.js +109 -0
  71. package/dist/ui/render-sessions.js +234 -0
  72. package/dist/ui/styles.css +261 -0
  73. package/dist/ui/ui-utils.js +196 -0
  74. package/dist/vectorstore/store.d.ts +25 -44
  75. package/dist/vectorstore/store.d.ts.map +1 -1
  76. package/dist/vectorstore/store.js +167 -167
  77. package/dist/vectorstore/store.js.map +1 -1
  78. package/docs/ARCHITECTURE.md +94 -1
  79. package/docs/DASHBOARD.md +26 -13
  80. package/docs/SETUP.md +17 -3
  81. package/package.json +2 -2
package/dist/ui/app.js CHANGED
@@ -1,11 +1,13 @@
1
- /* agent-knowledge dashboard — vanilla JS SPA */
1
+ /* agent-knowledge dashboard — main entry point */
2
2
  (function () {
3
3
  'use strict';
4
4
 
5
+ const K = window.Knowledge;
6
+
5
7
  // ── State ──────────────────────────────────────────────────────────────────
6
8
  const state = {
7
9
  activeTab: 'knowledge',
8
- knowledge: { entries: [], activeCategory: 'all' },
10
+ knowledge: { entries: [], activeCategory: 'all', duplicateClusters: {} },
9
11
  search: {
10
12
  query: '',
11
13
  results: [],
@@ -15,7 +17,7 @@
15
17
  semantic: false,
16
18
  loading: false,
17
19
  },
18
- sessions: { list: [], projectFilter: '', loading: false },
20
+ sessions: { list: [], projectFilter: '', loading: false, offset: 0, allLoaded: false },
19
21
  embeddings: { stats: null, loading: false },
20
22
  panel: { open: false, type: null, data: null },
21
23
  stats: { knowledgeCount: 0, sessionCount: 0, vectorCount: 0 },
@@ -23,7 +25,7 @@
23
25
  };
24
26
 
25
27
  // ── DOM refs ───────────────────────────────────────────────────────────────
26
- const $ = (id) => document.getElementById(id);
28
+ const $ = K.$;
27
29
  const el = {
28
30
  tabs: {
29
31
  knowledge: $('tab-knowledge'),
@@ -40,6 +42,10 @@
40
42
  knowledgeGrid: $('knowledge-grid'),
41
43
  knowledgeEmpty: $('knowledge-empty'),
42
44
  knowledgeCategories: $('knowledge-categories'),
45
+ knowledgeSearchInput: $('knowledge-search-input'),
46
+ knowledgeSearchResults: $('knowledge-search-results'),
47
+ btnConsolidate: $('btn-consolidate'),
48
+ btnReflect: $('btn-reflect'),
43
49
  searchInput: $('search-input'),
44
50
  searchResults: $('search-results'),
45
51
  searchEmpty: $('search-empty'),
@@ -69,123 +75,24 @@
69
75
  contentWrapper: $('content-wrapper'),
70
76
  };
71
77
 
72
- // ── Utilities ──────────────────────────────────────────────────────────────
73
-
74
- function esc(str) {
75
- const d = document.createElement('div');
76
- d.textContent = str;
77
- return d.innerHTML;
78
- }
79
-
80
- function debounce(fn, ms) {
81
- let t;
82
- return (...args) => {
83
- clearTimeout(t);
84
- t = setTimeout(() => fn(...args), ms);
85
- };
86
- }
87
-
88
- function relativeTime(dateStr) {
89
- if (!dateStr) return '';
90
- const now = Date.now();
91
- const then = new Date(dateStr).getTime();
92
- const diff = now - then;
93
- if (diff < 0) return 'just now';
94
- const secs = Math.floor(diff / 1000);
95
- if (secs < 60) return 'just now';
96
- const mins = Math.floor(secs / 60);
97
- if (mins < 60) return `${mins}m ago`;
98
- const hrs = Math.floor(mins / 60);
99
- if (hrs < 24) return `${hrs}h ago`;
100
- const days = Math.floor(hrs / 24);
101
- if (days < 30) return `${days}d ago`;
102
- const months = Math.floor(days / 30);
103
- if (months < 12) return `${months}mo ago`;
104
- return `${Math.floor(months / 12)}y ago`;
105
- }
78
+ // Expose state and el for module access
79
+ K._state = state;
80
+ K._el = el;
106
81
 
107
- function renderMd(raw) {
108
- if (!raw) return '';
109
- try {
110
- const html = marked.parse(raw, { breaks: true, gfm: true });
111
- const clean = DOMPurify.sanitize(html, { ADD_TAGS: ['pre', 'code'] });
112
- const wrapper = document.createElement('div');
113
- wrapper.innerHTML = clean;
114
- wrapper.querySelectorAll('pre code').forEach((block) => {
115
- try {
116
- hljs.highlightElement(block);
117
- } catch (_) {
118
- /* noop */
119
- }
120
- });
121
- return wrapper.innerHTML;
122
- } catch {
123
- return esc(raw);
124
- }
125
- }
126
-
127
- function highlightExcerpt(text, query) {
128
- if (!text || !query) return esc(text || '');
129
- try {
130
- const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
131
- const re = new RegExp(`(${escaped})`, 'gi');
132
- return esc(text).replace(re, '<mark>$1</mark>');
133
- } catch {
134
- return esc(text);
135
- }
136
- }
137
-
138
- function formatScore(score, metadata) {
139
- if (score == null) return '';
140
- const pct = Math.min(Math.max(score * 100, 0), 100);
141
- const tfidf = metadata?.tfidfScore;
142
- const semantic = metadata?.semanticScore;
143
- const recency = metadata?.recencyMultiplier;
144
- const alpha = metadata?.blendAlpha;
145
-
146
- let tooltip = `Score: ${score.toFixed(3)}`;
147
- if (tfidf != null && semantic != null) {
148
- tooltip += ` (TF-IDF: ${tfidf.toFixed(2)} \u00d7 ${((alpha || 0.3) * 100).toFixed(0)}% + Semantic: ${semantic.toFixed(2)} \u00d7 ${((1 - (alpha || 0.3)) * 100).toFixed(0)}%)`;
149
- }
150
- if (recency != null) tooltip += ` \u00d7 recency ${(recency * 100).toFixed(0)}%`;
151
-
152
- const recencyTag =
153
- recency != null && recency < 0.95
154
- ? `<span class="recency-tag" title="Recency: ${(recency * 100).toFixed(0)}%">${(recency * 100).toFixed(0)}%</span>`
155
- : '';
156
- const scoreType =
157
- tfidf != null && semantic != null
158
- ? '<span class="score-type hybrid">hybrid</span>'
159
- : tfidf != null
160
- ? '<span class="score-type tfidf">tf-idf</span>'
161
- : '';
162
- return `<div class="score-bar" title="${tooltip}">
163
- <div class="score-fill" style="width:${pct}%"></div>
164
- <span class="score-label">${score.toFixed(2)}${recencyTag}${scoreType}</span>
165
- </div>`;
166
- }
82
+ // ── Stats ──────────────────────────────────────────────────────────────────
167
83
 
168
- function toast(msg, type = 'info', duration = 4000) {
169
- const t = document.createElement('div');
170
- t.className = `toast toast-${type}`;
171
- const icons = { info: 'info', success: 'check_circle', error: 'error', warning: 'warning' };
172
- t.innerHTML = `<span class="material-symbols-outlined toast-icon">${icons[type] || 'info'}</span>
173
- <span class="toast-msg">${esc(msg)}</span>`;
174
- el.toastContainer.appendChild(t);
175
- requestAnimationFrame(() => t.classList.add('show'));
176
- setTimeout(() => {
177
- t.classList.remove('show');
178
- t.addEventListener('transitionend', () => t.remove());
179
- }, duration);
84
+ function updateStats() {
85
+ el.statKnowledge.querySelector('.stat-value').textContent = state.stats.knowledgeCount;
86
+ el.statSessions.querySelector('.stat-value').textContent = state.stats.sessionCount;
87
+ el.statVectors.querySelector('.stat-value').textContent = state.stats.vectorCount;
180
88
  }
181
89
 
182
- // ── API ────────────────────────────────────────────────────────────────────
183
-
184
- async function api(path) {
185
- const res = await fetch(`/api${path}`);
186
- if (!res.ok) throw new Error(`API ${res.status}: ${res.statusText}`);
187
- return res.json();
188
- }
90
+ K.updateStats = function (s, e) {
91
+ // Allow modules to call with their own refs, but always use canonical state
92
+ el.statKnowledge.querySelector('.stat-value').textContent = state.stats.knowledgeCount;
93
+ el.statSessions.querySelector('.stat-value').textContent = state.stats.sessionCount;
94
+ el.statVectors.querySelector('.stat-value').textContent = state.stats.vectorCount;
95
+ };
189
96
 
190
97
  // ── WebSocket ──────────────────────────────────────────────────────────────
191
98
 
@@ -243,11 +150,13 @@
243
150
  case 'state':
244
151
  if (msg.knowledge) {
245
152
  state.knowledge.entries = msg.knowledge;
246
- renderKnowledge();
153
+ K.renderKnowledge(state, el);
247
154
  }
248
155
  if (msg.sessions) {
249
156
  state.sessions.list = msg.sessions;
250
- renderSessions();
157
+ state.sessions.offset = msg.sessions.length;
158
+ state.sessions.allLoaded = true;
159
+ K.renderSessions(state, el);
251
160
  }
252
161
  if (msg.stats) {
253
162
  state.stats.knowledgeCount = msg.stats.knowledge_entries || 0;
@@ -260,11 +169,11 @@
260
169
  break;
261
170
  case 'knowledge:update':
262
171
  case 'knowledge:change':
263
- loadKnowledge();
172
+ K.loadKnowledge(state, el);
264
173
  break;
265
174
  case 'session:update':
266
175
  case 'session:new':
267
- loadSessions();
176
+ K.loadSessions(state, el);
268
177
  break;
269
178
  case 'stats':
270
179
  if (msg.data) {
@@ -293,34 +202,6 @@
293
202
  }
294
203
  }
295
204
 
296
- // ── Stats ──────────────────────────────────────────────────────────────────
297
-
298
- function updateStats() {
299
- el.statKnowledge.querySelector('.stat-value').textContent = state.stats.knowledgeCount;
300
- el.statSessions.querySelector('.stat-value').textContent = state.stats.sessionCount;
301
- el.statVectors.querySelector('.stat-value').textContent = state.stats.vectorCount;
302
- }
303
-
304
- // ── Theme ──────────────────────────────────────────────────────────────────
305
-
306
- function initTheme() {
307
- const saved = localStorage.getItem('agent-knowledge-theme');
308
- const theme = saved || (matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
309
- applyTheme(theme);
310
- }
311
-
312
- function applyTheme(theme) {
313
- document.documentElement.setAttribute('data-theme', theme);
314
- localStorage.setItem('agent-knowledge-theme', theme);
315
- const icon = el.themeToggle.querySelector('.theme-icon');
316
- if (icon) icon.textContent = theme === 'dark' ? 'light_mode' : 'dark_mode';
317
- }
318
-
319
- function toggleTheme() {
320
- const cur = document.documentElement.getAttribute('data-theme') || 'light';
321
- applyTheme(cur === 'dark' ? 'light' : 'dark');
322
- }
323
-
324
205
  // ── Tabs ───────────────────────────────────────────────────────────────────
325
206
 
326
207
  function switchTab(name, updateHash = true) {
@@ -341,499 +222,17 @@
341
222
  });
342
223
 
343
224
  // Close side panel on tab switch
344
- if (state.panel.open) closePanel();
345
-
346
- if (name === 'knowledge' && state.knowledge.entries.length === 0) loadKnowledge();
347
- if (name === 'sessions' && state.sessions.list.length === 0) loadSessions();
348
- if (name === 'embeddings') loadEmbeddingStats();
349
- }
350
-
351
- // ── Knowledge ──────────────────────────────────────────────────────────────
352
-
353
- async function loadKnowledge() {
354
- try {
355
- const data = await api('/knowledge');
356
- const entries = Array.isArray(data) ? data : data.entries || [];
357
- state.knowledge.entries = entries;
358
- state.stats.knowledgeCount = entries.length;
359
- updateStats();
360
- renderKnowledge();
361
- } catch (err) {
362
- toast(`Failed to load knowledge: ${err.message}`, 'error');
363
- }
364
- }
365
-
366
- function renderKnowledge() {
367
- const cat = state.knowledge.activeCategory;
368
- const filtered =
369
- cat === 'all'
370
- ? state.knowledge.entries
371
- : state.knowledge.entries.filter((e) => e.category === cat);
372
-
373
- if (filtered.length === 0) {
374
- el.knowledgeGrid.innerHTML = '';
375
- el.knowledgeEmpty.classList.remove('hidden');
376
- return;
377
- }
378
-
379
- el.knowledgeEmpty.classList.add('hidden');
380
- el.knowledgeGrid.innerHTML = filtered
381
- .map((entry) => {
382
- const cat = entry.category || 'notes';
383
- const catIcons = {
384
- projects: 'code',
385
- people: 'group',
386
- decisions: 'gavel',
387
- workflows: 'account_tree',
388
- notes: 'sticky_note_2',
389
- };
390
- const icon = catIcons[cat] || 'article';
391
- const title = entry.title || entry.path || entry.id || 'Untitled';
392
- const preview = entry.preview || entry.excerpt || '';
393
- const tags = (entry.tags || [])
394
- .slice(0, 3)
395
- .map((t) => `<span class="card-tag">${esc(t)}</span>`)
396
- .join('');
397
- const time = relativeTime(entry.updated || entry.created);
398
-
399
- return `<div class="knowledge-card" data-path="${esc(entry.path || entry.id || '')}" tabindex="0" role="button">
400
- <span class="card-category" data-cat="${esc(cat)}">
401
- <span class="material-symbols-outlined" style="font-size:14px">${icon}</span>
402
- ${esc(cat)}
403
- </span>
404
- ${time ? `<span class="card-date">${time}</span>` : ''}
405
- <div class="card-title">${esc(title)}</div>
406
- ${tags ? `<div class="card-tags">${tags}</div>` : ''}
407
- </div>`;
408
- })
409
- .join('');
410
-
411
- el.knowledgeGrid.querySelectorAll('.knowledge-card').forEach((card) => {
412
- card.addEventListener('click', () => openKnowledgePanel(card.dataset.path));
413
- card.addEventListener('keydown', (e) => {
414
- if (e.key === 'Enter') openKnowledgePanel(card.dataset.path);
415
- });
416
- });
417
- }
418
-
419
- async function openKnowledgePanel(path) {
420
- if (!path) return;
421
- try {
422
- const data = await api(`/knowledge/${encodeURIComponent(path)}`);
423
- const title = data.title || data.path || path;
424
- const content = data.content || data.body || '';
425
- openPanel('knowledge', { title, content, meta: data });
426
- } catch (err) {
427
- toast(`Failed to load entry: ${err.message}`, 'error');
428
- }
429
- }
430
-
431
- // ── Search ─────────────────────────────────────────────────────────────────
432
-
433
- const doSearch = debounce(async () => {
434
- const q = state.search.query.trim();
435
- if (!q) {
436
- state.search.results = [];
437
- renderSearchResults();
438
- return;
439
- }
440
- state.search.loading = true;
441
- renderSearchResults();
442
- try {
443
- const params = new URLSearchParams({ q });
444
- let endpoint;
445
- if (state.search.scope !== 'all') {
446
- params.set('scope', state.search.scope);
447
- params.set('semantic', state.search.semantic);
448
- endpoint = `/sessions/recall?${params}`;
449
- } else {
450
- if (state.search.role !== 'all') params.set('role', state.search.role);
451
- params.set('ranked', state.search.ranked);
452
- params.set('semantic', state.search.semantic);
453
- endpoint = `/sessions/search?${params}`;
454
- }
455
- const data = await api(endpoint);
456
- state.search.results = Array.isArray(data) ? data : data.results || [];
457
- } catch (err) {
458
- toast(`Search failed: ${err.message}`, 'error');
459
- state.search.results = [];
460
- }
461
- state.search.loading = false;
462
- renderSearchResults();
463
- }, 300);
464
-
465
- function renderSearchResults() {
466
- const { results, loading, query } = state.search;
467
-
468
- if (loading) {
469
- el.searchResults.innerHTML =
470
- '<div class="loading-inline"><div class="loading-spinner small"></div><span>Searching...</span></div>';
471
- el.searchEmpty.classList.add('hidden');
472
- return;
473
- }
474
-
475
- if (!query.trim()) {
476
- el.searchResults.innerHTML = '';
477
- el.searchEmpty.classList.remove('hidden');
478
- return;
479
- }
480
-
481
- if (results.length === 0) {
482
- el.searchResults.innerHTML = '';
483
- el.searchEmpty.querySelector('.empty-text').textContent = 'No results found';
484
- el.searchEmpty.querySelector('.empty-hint').textContent = `No matches for "${query}"`;
485
- el.searchEmpty.classList.remove('hidden');
486
- return;
487
- }
488
-
489
- el.searchEmpty.classList.add('hidden');
490
- el.searchResults.innerHTML = results
491
- .map((r) => {
492
- const sessionId = r.id || r.sessionId || r.session_id || '';
493
- const excerpt = r.excerpt || r.text || r.content || '';
494
- const role = r.role || '';
495
- const score = r.score;
496
- const meta = r.metadata;
497
- const project = r.project || '';
498
- const time = relativeTime(r.timestamp || r.date);
499
- const roleIcon = role === 'user' ? 'person' : role === 'assistant' ? 'smart_toy' : 'chat';
500
-
501
- return `<div class="result-item" data-session-id="${esc(sessionId)}" data-excerpt="${esc(excerpt)}" tabindex="0" role="button">
502
- <div class="result-meta">
503
- <span class="role-badge" data-role="${esc(role)}"><span class="material-symbols-outlined" style="font-size:12px">${roleIcon}</span> ${esc(role)}</span>
504
- ${project ? `<span class="result-project">${esc(project)}</span>` : ''}
505
- ${time ? `<span class="result-date">${time}</span>` : ''}
506
- ${score != null ? `<span class="score-container">${formatScore(score, meta)}</span>` : ''}
507
- </div>
508
- <div class="result-excerpt">${highlightExcerpt(excerpt, query)}</div>
509
- </div>`;
510
- })
511
- .join('');
512
-
513
- el.searchResults.querySelectorAll('.result-item').forEach((card) => {
514
- card.addEventListener('click', () =>
515
- openSessionPanel(card.dataset.sessionId, card.dataset.excerpt),
516
- );
517
- card.addEventListener('keydown', (e) => {
518
- if (e.key === 'Enter') openSessionPanel(card.dataset.sessionId, card.dataset.excerpt);
519
- });
520
- });
521
- }
522
-
523
- // ── Sessions ───────────────────────────────────────────────────────────────
524
-
525
- async function loadSessions() {
526
- if (state.sessions.loading) return;
527
- state.sessions.loading = true;
528
- try {
529
- const data = await api('/sessions');
530
- const list = Array.isArray(data) ? data : data.sessions || [];
531
- state.sessions.list = list;
532
- state.stats.sessionCount = list.length;
533
- updateStats();
534
- populateProjectFilter(list);
535
- renderSessions();
536
- } catch (err) {
537
- toast(`Failed to load sessions: ${err.message}`, 'error');
538
- }
539
- state.sessions.loading = false;
540
- }
541
-
542
- function populateProjectFilter(sessions) {
543
- const projects = [...new Set(sessions.map((s) => s.project).filter(Boolean))].sort();
544
- const sel = el.sessionProjectFilter;
545
- const current = sel.value;
546
- sel.innerHTML =
547
- '<option value="">All projects</option>' +
548
- projects.map((p) => `<option value="${esc(p)}">${esc(p)}</option>`).join('');
549
- sel.value = current;
550
- }
551
-
552
- function renderSessions() {
553
- const filter = state.sessions.projectFilter;
554
- const list = filter
555
- ? state.sessions.list.filter((s) => s.project === filter)
556
- : state.sessions.list;
557
-
558
- if (list.length === 0) {
559
- el.sessionsList.innerHTML = '';
560
- el.sessionsEmpty.classList.remove('hidden');
561
- return;
562
- }
563
-
564
- el.sessionsEmpty.classList.add('hidden');
565
- el.sessionsList.innerHTML = list
566
- .map((s) => {
567
- const id = s.sessionId || s.id || '';
568
- const project = s.project || '';
569
- const branch = s.branch || s.gitBranch || s.git_branch || '';
570
- const count = s.messageCount || s.message_count || s.count || 0;
571
- const date = s.startTime || s.date || s.created || s.startedAt || '';
572
- const preview = s.preview || '';
573
- const time = relativeTime(date);
574
- const dateStr = date
575
- ? new Date(date).toLocaleDateString(undefined, {
576
- month: 'short',
577
- day: 'numeric',
578
- year: 'numeric',
579
- })
580
- : '';
581
-
582
- const title = preview
583
- ? preview.length > 80
584
- ? preview.slice(0, 80) + '…'
585
- : preview
586
- : id.slice(0, 8);
587
-
588
- return `<div class="session-card" data-session-id="${esc(id)}" tabindex="0" role="button">
589
- <div class="session-header">
590
- <span class="session-title">${esc(title)}</span>
591
- <span class="session-date">${dateStr || time || ''}</span>
592
- </div>
593
- <div class="session-meta">
594
- <span class="session-meta-item"><span class="material-symbols-outlined">folder</span>${esc(project)}</span>
595
- ${branch ? `<span class="session-meta-item"><span class="material-symbols-outlined">alt_route</span>${esc(branch)}</span>` : ''}
596
- <span class="session-meta-item"><span class="material-symbols-outlined">chat</span>${count} messages</span>
597
- <span class="session-meta-item"><span class="material-symbols-outlined">tag</span>${esc(id.slice(0, 8))}</span>
598
- </div>
599
- </div>`;
600
- })
601
- .join('');
602
-
603
- el.sessionsList.querySelectorAll('.session-card').forEach((card) => {
604
- card.addEventListener('click', () => openSessionPanel(card.dataset.sessionId));
605
- card.addEventListener('keydown', (e) => {
606
- if (e.key === 'Enter') openSessionPanel(card.dataset.sessionId);
607
- });
608
- });
609
- }
610
-
611
- async function openSessionPanel(sessionId, searchExcerpt) {
612
- if (!sessionId) return;
613
- try {
614
- const [session, summary] = await Promise.allSettled([
615
- api(`/sessions/${encodeURIComponent(sessionId)}`),
616
- api(`/sessions/${encodeURIComponent(sessionId)}/summary`),
617
- ]);
618
- const sData = session.status === 'fulfilled' ? session.value : {};
619
- const sumData = summary.status === 'fulfilled' ? summary.value : null;
620
- openPanel('session', { session: sData, summary: sumData, sessionId, searchExcerpt });
621
- } catch (err) {
622
- toast(`Failed to load session: ${err.message}`, 'error');
623
- }
624
- }
625
-
626
- // ── Embeddings ─────────────────────────────────────────────────────────────
627
-
628
- async function loadEmbeddingStats() {
629
- try {
630
- const data = await api('/index-status');
631
- state.embeddings.stats = data;
632
- renderEmbeddingStats();
633
- el.statVectors.querySelector('.stat-value').textContent = data.totalEntries || 0;
634
- } catch {
635
- state.embeddings.stats = null;
636
- renderEmbeddingStats();
637
- }
638
- }
639
-
640
- function renderEmbeddingStats() {
641
- const stats = state.embeddings.stats;
642
- if (!stats || !stats.totalEntries) {
643
- el.embeddingsStatsGrid.innerHTML = '';
644
- el.embeddingsStatus.style.display = 'none';
645
- el.embeddingsEmpty.classList.remove('hidden');
646
- return;
647
- }
648
-
649
- el.embeddingsEmpty.classList.add('hidden');
650
- el.embeddingsStatus.style.display = '';
225
+ if (state.panel.open) K.closePanel();
651
226
 
652
- const cards = [
653
- { label: 'Provider', value: stats.provider || 'Not configured', detail: '' },
654
- { label: 'Dimensions', value: stats.dimensions || 0, detail: 'vector size' },
655
- { label: 'Total Chunks', value: stats.totalEntries || 0, detail: 'indexed chunks' },
656
- { label: 'Knowledge', value: stats.knowledgeEntries || 0, detail: 'knowledge chunks' },
657
- {
658
- label: 'Sessions',
659
- value: stats.uniqueSessions || 0,
660
- detail: `${stats.sessionEntries || 0} chunks`,
661
- },
662
- { label: 'DB Size', value: (stats.dbSizeMB || 0).toFixed(1) + ' MB', detail: 'on disk' },
663
- ];
664
-
665
- el.embeddingsStatsGrid.innerHTML = cards
666
- .map(
667
- (c) => `
668
- <div class="embedding-stat-card">
669
- <span class="stat-label">${esc(c.label)}</span>
670
- <span class="stat-number">${esc(String(c.value))}</span>
671
- ${c.detail ? `<span class="stat-detail">${esc(c.detail)}</span>` : ''}
672
- </div>
673
- `,
674
- )
675
- .join('');
676
- }
677
-
678
- // ── Side Panel ─────────────────────────────────────────────────────────────
679
-
680
- function openPanel(type, data) {
681
- state.panel = { open: true, type, data };
682
- el.sidePanel.hidden = false;
683
- requestAnimationFrame(() => el.sidePanel.classList.add('open'));
684
- el.contentWrapper.classList.add('panel-visible');
685
-
686
- if (type === 'knowledge') {
687
- renderKnowledgePanel(data);
688
- } else if (type === 'session') {
689
- renderSessionPanel(data);
690
- }
691
- }
692
-
693
- function closePanel() {
694
- state.panel = { open: false, type: null, data: null };
695
- el.sidePanel.classList.remove('open');
696
- el.contentWrapper.classList.remove('panel-visible');
697
- el.sidePanel.addEventListener(
698
- 'transitionend',
699
- function handler() {
700
- if (!state.panel.open) el.sidePanel.hidden = true;
701
- el.sidePanel.removeEventListener('transitionend', handler);
702
- },
703
- { once: true },
704
- );
705
- // Fallback: hide after 400ms if transitionend doesn't fire
706
- setTimeout(() => {
707
- if (!state.panel.open) el.sidePanel.hidden = true;
708
- }, 400);
227
+ if (name === 'knowledge' && state.knowledge.entries.length === 0) K.loadKnowledge(state, el);
228
+ if (name === 'sessions' && state.sessions.list.length === 0) K.loadSessions(state, el);
229
+ if (name === 'embeddings') K.loadEmbeddingStats(state, el);
709
230
  }
710
231
 
711
- function stripFrontmatter(content) {
712
- const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
713
- return match ? match[1].trim() : content;
714
- }
715
-
716
- function renderKnowledgePanel(data) {
717
- el.panelTitle.innerHTML = `<span class="material-symbols-outlined panel-icon">article</span>${esc(data.title)}`;
718
- const meta = data.meta || {};
719
- const entry = meta.entry || meta;
720
- const category = entry.category || meta.category || '';
721
- const tags = entry.tags || meta.tags || [];
722
- const updated = entry.updated || meta.updated || '';
723
-
724
- let metaHtml = '<div class="panel-meta">';
725
- if (category)
726
- metaHtml += `<span class="card-category" data-cat="${esc(category)}">${esc(category)}</span>`;
727
- if (tags.length)
728
- metaHtml += tags.map((t) => `<span class="card-tag">${esc(t)}</span>`).join('');
729
- if (updated) metaHtml += `<span class="panel-meta-date">${esc(updated)}</span>`;
730
- metaHtml += '</div>';
731
-
732
- const body = stripFrontmatter(data.content);
733
- el.panelBody.innerHTML = metaHtml + `<div class="prose">${renderMd(body)}</div>`;
734
- }
735
-
736
- function renderSessionPanel(data) {
737
- const s = data.session || {};
738
- const summary = data.summary;
739
- const id = data.sessionId || s.id || '';
740
- const meta = s.meta || s;
741
-
742
- el.panelTitle.innerHTML = `<span class="material-symbols-outlined panel-icon">terminal</span>Session ${esc(id.slice(0, 8))}`;
743
-
744
- let html = '<div class="panel-meta">';
745
- if (meta.cwd)
746
- html += `<span class="panel-meta-item"><span class="material-symbols-outlined" style="font-size:14px">folder</span>${esc(meta.cwd)}</span>`;
747
- if (meta.branch)
748
- html += `<span class="panel-meta-item"><span class="material-symbols-outlined" style="font-size:14px">alt_route</span>${esc(meta.branch)}</span>`;
749
- if (meta.startTime && meta.startTime !== 'unknown')
750
- html += `<span class="panel-meta-item"><span class="material-symbols-outlined" style="font-size:14px">schedule</span>${new Date(meta.startTime).toLocaleString()}</span>`;
751
- if (meta.messageCount)
752
- html += `<span class="panel-meta-item"><span class="material-symbols-outlined" style="font-size:14px">chat</span>${meta.messageCount} messages</span>`;
753
- html += '</div>';
754
-
755
- if (summary && summary.topics && summary.topics.length) {
756
- html +=
757
- '<div class="panel-section"><h4 class="panel-section-title">Topics</h4><ul class="panel-topics">';
758
- summary.topics.slice(0, 8).forEach((t) => {
759
- html += `<li>${esc(t.content)}</li>`;
760
- });
761
- html += '</ul></div>';
762
- }
763
-
764
- const messages = s.messages || s.conversation || [];
765
- // Filter out noisy messages (tool JSON, base64, system reminders)
766
- const cleanMessages = messages.filter((m) => {
767
- const t = (m.content || '').trimStart();
768
- if (t.startsWith('[{') || t.startsWith('{"')) return false;
769
- if (t.includes('tool_use_id') || t.includes('tool_result')) return false;
770
- if (t.includes('base64') || t.includes('media_type')) return false;
771
- if (t.includes('<system-reminder>')) return false;
772
- if (t.length < 3) return false;
773
- return true;
774
- });
775
-
776
- if (cleanMessages.length) {
777
- html += '<div class="chat-messages">';
778
- cleanMessages.forEach((m) => {
779
- const role = m.role || 'unknown';
780
- const text = m.content || m.text || '';
781
- const isUser = role === 'user';
782
- const cls = isUser ? 'chat-msg user' : 'chat-msg assistant';
783
- const roleIcon = isUser ? 'person' : 'smart_toy';
784
- const truncated = text.length > 1500 ? text.slice(0, 1500) + '...' : text;
785
- const time = m.timestamp ? relativeTime(m.timestamp) : '';
232
+ // ── Create debounced search functions ─────────────────────────────────────
786
233
 
787
- html += `<div class="${cls}">
788
- <div class="chat-msg-role"><span class="material-symbols-outlined" style="font-size:14px">${roleIcon}</span> ${esc(role)} ${time ? `<span class="chat-msg-time">${time}</span>` : ''}</div>
789
- <div>${isUser ? esc(truncated) : renderMd(truncated)}</div>
790
- </div>`;
791
- });
792
- html += '</div>';
793
- } else {
794
- html +=
795
- '<div class="empty-state"><span class="material-symbols-outlined empty-icon">chat_bubble</span><div class="empty-text">No messages available</div></div>';
796
- }
797
-
798
- el.panelBody.innerHTML = html;
799
-
800
- // Scroll to and highlight matching message from search
801
- if (data.searchExcerpt) {
802
- setTimeout(() => {
803
- const excerpt = data.searchExcerpt.replace(/\s+/g, ' ').trim().toLowerCase();
804
- const msgEls = el.panelBody.querySelectorAll('.chat-msg');
805
- let bestMatch = null;
806
- let bestScore = -1;
807
- msgEls.forEach((msgEl) => {
808
- const text = msgEl.textContent.replace(/\s+/g, ' ').trim().toLowerCase();
809
- // Exact substring match scores highest (2 + length ratio)
810
- if (text.includes(excerpt)) {
811
- const score = 2 + excerpt.length / text.length;
812
- if (score > bestScore) {
813
- bestScore = score;
814
- bestMatch = msgEl;
815
- }
816
- } else {
817
- // Fuzzy: check word overlap
818
- const words = excerpt.split(' ').filter((w) => w.length > 2);
819
- if (words.length > 0) {
820
- const matched = words.filter((w) => text.includes(w)).length;
821
- const ratio = matched / words.length;
822
- if (ratio > 0.5 && ratio > bestScore) {
823
- bestScore = ratio;
824
- bestMatch = msgEl;
825
- }
826
- }
827
- }
828
- });
829
- if (bestMatch) {
830
- bestMatch.classList.add('chat-msg-highlight');
831
- bestMatch.scrollIntoView({ behavior: 'smooth', block: 'center' });
832
- setTimeout(() => bestMatch.classList.remove('chat-msg-highlight'), 4000);
833
- }
834
- }, 300);
835
- }
836
- }
234
+ const doKnowledgeSearch = K.createKnowledgeSearch(state, el);
235
+ const doSearch = K.createSearch(state, el);
837
236
 
838
237
  // ── Event Binding ──────────────────────────────────────────────────────────
839
238
 
@@ -844,10 +243,10 @@
844
243
  });
845
244
 
846
245
  // Theme
847
- el.themeToggle.addEventListener('click', toggleTheme);
246
+ el.themeToggle.addEventListener('click', K.toggleTheme);
848
247
 
849
248
  // Panel close
850
- el.panelClose.addEventListener('click', closePanel);
249
+ el.panelClose.addEventListener('click', K.closePanel);
851
250
 
852
251
  // Knowledge category chips
853
252
  el.knowledgeCategories.addEventListener('click', (e) => {
@@ -856,9 +255,22 @@
856
255
  el.knowledgeCategories.querySelectorAll('.chip').forEach((c) => c.classList.remove('active'));
857
256
  chip.classList.add('active');
858
257
  state.knowledge.activeCategory = chip.dataset.category;
859
- renderKnowledge();
258
+ K.renderKnowledge(state, el);
860
259
  });
861
260
 
261
+ if (el.btnConsolidate) {
262
+ el.btnConsolidate.addEventListener('click', () => K.loadConsolidate(state, el));
263
+ }
264
+ if (el.btnReflect) {
265
+ el.btnReflect.addEventListener('click', () => K.loadReflect());
266
+ }
267
+
268
+ if (el.knowledgeSearchInput) {
269
+ el.knowledgeSearchInput.addEventListener('input', () => {
270
+ doKnowledgeSearch();
271
+ });
272
+ }
273
+
862
274
  // Search input
863
275
  el.searchInput.addEventListener('input', () => {
864
276
  state.search.query = el.searchInput.value;
@@ -891,7 +303,8 @@
891
303
  // Session project filter
892
304
  el.sessionProjectFilter.addEventListener('change', () => {
893
305
  state.sessions.projectFilter = el.sessionProjectFilter.value;
894
- renderSessions();
306
+ K.resetSessionPagination(state);
307
+ K.loadSessions(state, el);
895
308
  });
896
309
 
897
310
  // Search scope chips
@@ -909,12 +322,12 @@
909
322
  // Escape closes panel
910
323
  if (e.key === 'Escape' && state.panel.open) {
911
324
  e.preventDefault();
912
- closePanel();
325
+ K.closePanel();
913
326
  return;
914
327
  }
915
328
 
916
329
  // / or Ctrl+K focuses search
917
- if ((e.key === '/' || (e.ctrlKey && e.key === 'k')) && !isInputFocused()) {
330
+ if ((e.key === '/' || (e.ctrlKey && e.key === 'k')) && !K.isInputFocused()) {
918
331
  e.preventDefault();
919
332
  switchTab('search');
920
333
  el.searchInput.focus();
@@ -929,84 +342,8 @@
929
342
  });
930
343
  }
931
344
 
932
- function isInputFocused() {
933
- const active = document.activeElement;
934
- if (!active) return false;
935
- const tag = active.tagName.toLowerCase();
936
- return tag === 'input' || tag === 'textarea' || tag === 'select' || active.isContentEditable;
937
- }
345
+ // ── Theme sync from parent (agent-desk) ───────────────────────────────────
938
346
 
939
- // ── Init ───────────────────────────────────────────────────────────────────
940
-
941
- async function init() {
942
- initTheme();
943
- bindEvents();
944
- wsConnect();
945
-
946
- // Restore tab from URL hash
947
- const hash = location.hash.replace('#', '');
948
- const validTabs = Object.keys(el.tabs);
949
- if (hash && validTabs.includes(hash)) {
950
- switchTab(hash, false);
951
- }
952
-
953
- // Listen for back/forward navigation
954
- window.addEventListener('hashchange', () => {
955
- const h = location.hash.replace('#', '');
956
- if (h && validTabs.includes(h)) switchTab(h, false);
957
- });
958
-
959
- // Load initial data in parallel
960
- try {
961
- await Promise.allSettled([loadKnowledge(), loadEmbeddingStats()]);
962
- } catch {
963
- // individual loaders handle their own errors
964
- }
965
-
966
- // Hide loading overlay after a short delay if ws hasn't connected
967
- setTimeout(() => {
968
- el.loadingOverlay.classList.add('hidden');
969
- }, 5000);
970
- }
971
-
972
- // Panel resize handle (drag to resize like agent-tasks)
973
- function initPanelResize() {
974
- const panel = document.getElementById('side-panel');
975
- if (!panel) return;
976
- const handle = document.createElement('div');
977
- handle.className = 'panel-resize-handle';
978
- panel.appendChild(handle);
979
-
980
- let isResizing = false;
981
- let startX = 0;
982
- let startWidth = 0;
983
-
984
- handle.addEventListener('mousedown', (e) => {
985
- isResizing = true;
986
- startX = e.clientX;
987
- startWidth = panel.offsetWidth;
988
- document.body.style.cursor = 'col-resize';
989
- document.body.style.userSelect = 'none';
990
- e.preventDefault();
991
- });
992
-
993
- document.addEventListener('mousemove', (e) => {
994
- if (!isResizing) return;
995
- const dx = startX - e.clientX;
996
- const newWidth = Math.max(320, Math.min(startWidth + dx, window.innerWidth * 0.8));
997
- panel.style.width = newWidth + 'px';
998
- panel.style.minWidth = newWidth + 'px';
999
- });
1000
-
1001
- document.addEventListener('mouseup', () => {
1002
- if (!isResizing) return;
1003
- isResizing = false;
1004
- document.body.style.cursor = '';
1005
- document.body.style.userSelect = '';
1006
- });
1007
- }
1008
-
1009
- // Theme sync from parent (agent-desk) via executeJavaScript
1010
347
  window.addEventListener('message', (event) => {
1011
348
  if (!event.data || event.data.type !== 'theme-sync') return;
1012
349
  const colors = event.data.colors;
@@ -1145,14 +482,48 @@
1145
482
  if (el.themeToggle) el.themeToggle.style.display = 'none';
1146
483
  });
1147
484
 
485
+ // ── Init ───────────────────────────────────────────────────────────────────
486
+
487
+ async function init() {
488
+ K.initTheme();
489
+ bindEvents();
490
+ K.initSessionScroll(state, el);
491
+ wsConnect();
492
+
493
+ // Restore tab from URL hash
494
+ const hash = location.hash.replace('#', '');
495
+ const validTabs = Object.keys(el.tabs);
496
+ if (hash && validTabs.includes(hash)) {
497
+ switchTab(hash, false);
498
+ }
499
+
500
+ // Listen for back/forward navigation
501
+ window.addEventListener('hashchange', () => {
502
+ const h = location.hash.replace('#', '');
503
+ if (h && validTabs.includes(h)) switchTab(h, false);
504
+ });
505
+
506
+ // Load initial data in parallel
507
+ try {
508
+ await Promise.allSettled([K.loadKnowledge(state, el), K.loadEmbeddingStats(state, el)]);
509
+ } catch {
510
+ // individual loaders handle their own errors
511
+ }
512
+
513
+ // Hide loading overlay after a short delay if ws hasn't connected
514
+ setTimeout(() => {
515
+ el.loadingOverlay.classList.add('hidden');
516
+ }, 5000);
517
+ }
518
+
1148
519
  // Start
1149
520
  if (document.readyState === 'loading') {
1150
521
  document.addEventListener('DOMContentLoaded', () => {
1151
522
  init();
1152
- initPanelResize();
523
+ K.initPanelResize();
1153
524
  });
1154
525
  } else {
1155
526
  init();
1156
- initPanelResize();
527
+ K.initPanelResize();
1157
528
  }
1158
529
  })();