agent-knowledge 1.2.0 → 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 (78) hide show
  1. package/CHANGELOG.md +86 -13
  2. package/README.md +51 -34
  3. package/dist/dashboard.d.ts +1 -0
  4. package/dist/dashboard.d.ts.map +1 -1
  5. package/dist/dashboard.js +76 -23
  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.map +1 -1
  24. package/dist/knowledge/graph.js +2 -1
  25. package/dist/knowledge/graph.js.map +1 -1
  26. package/dist/knowledge/reflect.d.ts +33 -0
  27. package/dist/knowledge/reflect.d.ts.map +1 -0
  28. package/dist/knowledge/reflect.js +115 -0
  29. package/dist/knowledge/reflect.js.map +1 -0
  30. package/dist/knowledge/scoring.d.ts.map +1 -1
  31. package/dist/knowledge/scoring.js +2 -1
  32. package/dist/knowledge/scoring.js.map +1 -1
  33. package/dist/knowledge/search.d.ts.map +1 -1
  34. package/dist/knowledge/search.js +4 -7
  35. package/dist/knowledge/search.js.map +1 -1
  36. package/dist/knowledge/store.d.ts.map +1 -1
  37. package/dist/knowledge/store.js +4 -3
  38. package/dist/knowledge/store.js.map +1 -1
  39. package/dist/search/excerpt.d.ts.map +1 -1
  40. package/dist/search/excerpt.js +2 -1
  41. package/dist/search/excerpt.js.map +1 -1
  42. package/dist/search/tfidf.d.ts +1 -0
  43. package/dist/search/tfidf.d.ts.map +1 -1
  44. package/dist/search/tfidf.js +38 -3
  45. package/dist/search/tfidf.js.map +1 -1
  46. package/dist/server.d.ts.map +1 -1
  47. package/dist/server.js +103 -534
  48. package/dist/server.js.map +1 -1
  49. package/dist/sessions/parser.d.ts.map +1 -1
  50. package/dist/sessions/parser.js +12 -10
  51. package/dist/sessions/parser.js.map +1 -1
  52. package/dist/sessions/search.js +17 -3
  53. package/dist/sessions/search.js.map +1 -1
  54. package/dist/sessions/summary.d.ts.map +1 -1
  55. package/dist/sessions/summary.js +6 -3
  56. package/dist/sessions/summary.js.map +1 -1
  57. package/dist/tool-handlers.d.ts +42 -0
  58. package/dist/tool-handlers.d.ts.map +1 -0
  59. package/dist/tool-handlers.js +425 -0
  60. package/dist/tool-handlers.js.map +1 -0
  61. package/dist/types.d.ts.map +1 -1
  62. package/dist/types.js +6 -4
  63. package/dist/types.js.map +1 -1
  64. package/dist/ui/app.js +86 -847
  65. package/dist/ui/index.html +17 -0
  66. package/dist/ui/render-knowledge.js +233 -0
  67. package/dist/ui/render-panel.js +350 -0
  68. package/dist/ui/render-search.js +109 -0
  69. package/dist/ui/render-sessions.js +234 -0
  70. package/dist/ui/styles.css +91 -0
  71. package/dist/ui/ui-utils.js +196 -0
  72. package/dist/vectorstore/store.d.ts +25 -44
  73. package/dist/vectorstore/store.d.ts.map +1 -1
  74. package/dist/vectorstore/store.js +167 -167
  75. package/dist/vectorstore/store.js.map +1 -1
  76. package/docs/ARCHITECTURE.md +29 -1
  77. package/docs/DASHBOARD.md +7 -0
  78. package/package.json +1 -1
@@ -0,0 +1,109 @@
1
+ /* agent-knowledge — search tab rendering */
2
+ (function () {
3
+ 'use strict';
4
+
5
+ const K = window.Knowledge;
6
+
7
+ // ── Create debounced search ───────────────────────────────────────────────
8
+
9
+ function createSearch(state, el) {
10
+ return K.debounce(async () => {
11
+ const q = state.search.query.trim();
12
+ if (!q) {
13
+ state.search.results = [];
14
+ renderSearchResults(state, el);
15
+ return;
16
+ }
17
+ state.search.loading = true;
18
+ renderSearchResults(state, el);
19
+ try {
20
+ const params = new URLSearchParams({ q });
21
+ let endpoint;
22
+ if (state.search.scope !== 'all') {
23
+ params.set('scope', state.search.scope);
24
+ params.set('semantic', state.search.semantic);
25
+ endpoint = `/sessions/recall?${params}`;
26
+ } else {
27
+ if (state.search.role !== 'all') params.set('role', state.search.role);
28
+ params.set('ranked', state.search.ranked);
29
+ params.set('semantic', state.search.semantic);
30
+ endpoint = `/sessions/search?${params}`;
31
+ }
32
+ const data = await K.api(endpoint);
33
+ state.search.results = Array.isArray(data) ? data : data.results || [];
34
+ } catch (err) {
35
+ K.toast(`Search failed: ${err.message}`, 'error');
36
+ state.search.results = [];
37
+ }
38
+ state.search.loading = false;
39
+ renderSearchResults(state, el);
40
+ }, 300);
41
+ }
42
+
43
+ // ── Render search results ─────────────────────────────────────────────────
44
+
45
+ function renderSearchResults(state, el) {
46
+ const { results, loading, query } = state.search;
47
+
48
+ if (loading) {
49
+ el.searchResults.innerHTML =
50
+ '<div class="loading-inline"><div class="loading-spinner small"></div><span>Searching...</span></div>';
51
+ el.searchEmpty.classList.add('hidden');
52
+ return;
53
+ }
54
+
55
+ if (!query.trim()) {
56
+ el.searchResults.innerHTML = '';
57
+ el.searchEmpty.classList.remove('hidden');
58
+ return;
59
+ }
60
+
61
+ if (results.length === 0) {
62
+ el.searchResults.innerHTML = '';
63
+ el.searchEmpty.querySelector('.empty-text').textContent = 'No results found';
64
+ el.searchEmpty.querySelector('.empty-hint').textContent = `No matches for "${query}"`;
65
+ el.searchEmpty.classList.remove('hidden');
66
+ return;
67
+ }
68
+
69
+ el.searchEmpty.classList.add('hidden');
70
+ el.searchResults.innerHTML = results
71
+ .map((r) => {
72
+ const sessionId = r.id || r.sessionId || r.session_id || '';
73
+ const excerpt = r.excerpt || r.text || r.content || '';
74
+ const role = r.role || '';
75
+ const score = r.score;
76
+ const meta = r.metadata;
77
+ const project = r.project || '';
78
+ const time = K.relativeTime(r.timestamp || r.date);
79
+ const roleIcon = role === 'user' ? 'person' : role === 'assistant' ? 'smart_toy' : 'chat';
80
+
81
+ return `<div class="result-item" data-session-id="${K.esc(sessionId)}" data-excerpt="${K.esc(excerpt)}" tabindex="0" role="button">
82
+ <div class="result-meta">
83
+ <span class="role-badge" data-role="${K.esc(role)}"><span class="material-symbols-outlined" style="font-size:12px">${roleIcon}</span> ${K.esc(role)}</span>
84
+ ${project ? `<span class="result-project">${K.esc(project)}</span>` : ''}
85
+ ${time ? `<span class="result-date">${time}</span>` : ''}
86
+ ${score != null ? `<span class="score-container">${K.formatScore(score, meta)}</span>` : ''}
87
+ </div>
88
+ <div class="result-excerpt">${K.highlightExcerpt(excerpt, query)}</div>
89
+ </div>`;
90
+ })
91
+ .join('');
92
+
93
+ el.searchResults.querySelectorAll('.result-item').forEach((card) => {
94
+ card.addEventListener('click', () =>
95
+ K.openSessionPanel(card.dataset.sessionId, card.dataset.excerpt),
96
+ );
97
+ card.addEventListener('keydown', (e) => {
98
+ if (e.key === 'Enter') K.openSessionPanel(card.dataset.sessionId, card.dataset.excerpt);
99
+ });
100
+ });
101
+ }
102
+
103
+ // ── Export ──────────────────────────────────────────────────────────────────
104
+
105
+ Object.assign(K, {
106
+ createSearch,
107
+ renderSearchResults,
108
+ });
109
+ })();
@@ -0,0 +1,234 @@
1
+ /* agent-knowledge — sessions tab rendering */
2
+ (function () {
3
+ 'use strict';
4
+
5
+ const K = window.Knowledge;
6
+
7
+ const PAGE_SIZE = 30;
8
+
9
+ // ── Load sessions from API (paginated) ────────────────────────────────────
10
+
11
+ async function loadSessions(state, el) {
12
+ if (state.sessions.loading) return;
13
+ if (state.sessions.allLoaded) return;
14
+ state.sessions.loading = true;
15
+ const offset = state.sessions.offset || 0;
16
+ const isFirstPage = offset === 0;
17
+ showLoadingIndicator(el, true);
18
+ try {
19
+ const filter = state.sessions.projectFilter;
20
+ let url = `/sessions?limit=${PAGE_SIZE}&offset=${offset}`;
21
+ if (filter) url += `&project=${encodeURIComponent(filter)}`;
22
+ const data = await K.api(url);
23
+ const page = Array.isArray(data) ? data : data.sessions || [];
24
+
25
+ if (isFirstPage) {
26
+ state.sessions.list = page;
27
+ } else {
28
+ state.sessions.list = state.sessions.list.concat(page);
29
+ }
30
+
31
+ state.sessions.offset = offset + page.length;
32
+ state.sessions.allLoaded = page.length < PAGE_SIZE;
33
+ state.stats.sessionCount = state.sessions.list.length;
34
+ K.updateStats(state, el);
35
+ updateProjectFilter(state.sessions.list, el);
36
+ renderSessions(state, el);
37
+ } catch (err) {
38
+ K.toast(`Failed to load sessions: ${err.message}`, 'error');
39
+ }
40
+ state.sessions.loading = false;
41
+ showLoadingIndicator(el, false);
42
+ }
43
+
44
+ function resetSessionPagination(state) {
45
+ state.sessions.list = [];
46
+ state.sessions.offset = 0;
47
+ state.sessions.allLoaded = false;
48
+ }
49
+
50
+ // ── Loading indicator ─────────────────────────────────────────────────────
51
+
52
+ function showLoadingIndicator(el, show) {
53
+ let indicator = document.getElementById('sessions-load-more');
54
+ if (show) {
55
+ if (!indicator) {
56
+ indicator = document.createElement('div');
57
+ indicator.id = 'sessions-load-more';
58
+ indicator.className = 'sessions-load-more';
59
+ indicator.innerHTML =
60
+ '<span class="sessions-spinner"></span><span>Loading more\u2026</span>';
61
+ el.sessionsList.parentNode.insertBefore(indicator, el.sessionsEmpty);
62
+ }
63
+ indicator.classList.remove('hidden');
64
+ } else if (indicator) {
65
+ indicator.classList.add('hidden');
66
+ }
67
+ }
68
+
69
+ // ── Scroll-based pagination ───────────────────────────────────────────────
70
+
71
+ function initSessionScroll(state, el) {
72
+ const content = document.getElementById('content');
73
+ if (!content) return;
74
+ content.addEventListener('scroll', () => {
75
+ if (state.sessions.loading || state.sessions.allLoaded) return;
76
+ const nearBottom = content.scrollHeight - content.scrollTop - content.clientHeight < 200;
77
+ if (nearBottom) loadSessions(state, el);
78
+ });
79
+ }
80
+
81
+ // ── Populate project filter dropdown ──────────────────────────────────────
82
+
83
+ function updateProjectFilter(sessions, el) {
84
+ const projects = [...new Set(sessions.map((s) => s.project).filter(Boolean))].sort();
85
+ const sel = el.sessionProjectFilter;
86
+ const current = sel.value;
87
+ sel.innerHTML =
88
+ '<option value="">All projects</option>' +
89
+ projects.map((p) => `<option value="${K.esc(p)}">${K.esc(p)}</option>`).join('');
90
+ sel.value = current;
91
+ }
92
+
93
+ // ── Render session list ───────────────────────────────────────────────────
94
+
95
+ function renderSessions(state, el) {
96
+ const filter = state.sessions.projectFilter;
97
+ const list = filter
98
+ ? state.sessions.list.filter((s) => s.project === filter)
99
+ : state.sessions.list;
100
+
101
+ if (list.length === 0) {
102
+ el.sessionsList.innerHTML = '';
103
+ el.sessionsEmpty.classList.remove('hidden');
104
+ return;
105
+ }
106
+
107
+ el.sessionsEmpty.classList.add('hidden');
108
+ el.sessionsList.innerHTML = list
109
+ .map((s) => {
110
+ const id = s.sessionId || s.id || '';
111
+ const project = s.project || '';
112
+ const branch = s.branch || s.gitBranch || s.git_branch || '';
113
+ const count = s.messageCount || s.message_count || s.count || 0;
114
+ const date = s.startTime || s.date || s.created || s.startedAt || '';
115
+ const preview = s.preview || '';
116
+ const time = K.relativeTime(date);
117
+ const dateStr = date
118
+ ? new Date(date).toLocaleDateString(undefined, {
119
+ month: 'short',
120
+ day: 'numeric',
121
+ year: 'numeric',
122
+ })
123
+ : '';
124
+
125
+ const title = preview
126
+ ? preview.length > 80
127
+ ? preview.slice(0, 80) + '\u2026'
128
+ : preview
129
+ : id.slice(0, 8);
130
+
131
+ return `<div class="session-card" data-session-id="${K.esc(id)}" tabindex="0" role="button">
132
+ <div class="session-header">
133
+ <span class="session-title">${K.esc(title)}</span>
134
+ <span class="session-date">${dateStr || time || ''}</span>
135
+ </div>
136
+ <div class="session-meta">
137
+ <span class="session-meta-item"><span class="material-symbols-outlined">folder</span>${K.esc(project)}</span>
138
+ ${branch ? `<span class="session-meta-item"><span class="material-symbols-outlined">alt_route</span>${K.esc(branch)}</span>` : ''}
139
+ <span class="session-meta-item"><span class="material-symbols-outlined">chat</span>${count} messages</span>
140
+ <span class="session-meta-item"><span class="material-symbols-outlined">tag</span>${K.esc(id.slice(0, 8))}</span>
141
+ </div>
142
+ </div>`;
143
+ })
144
+ .join('');
145
+
146
+ el.sessionsList.querySelectorAll('.session-card').forEach((card) => {
147
+ card.addEventListener('click', () => K.openSessionPanel(card.dataset.sessionId));
148
+ card.addEventListener('keydown', (e) => {
149
+ if (e.key === 'Enter') K.openSessionPanel(card.dataset.sessionId);
150
+ });
151
+ });
152
+ }
153
+
154
+ // ── Open session in side panel ────────────────────────────────────────────
155
+
156
+ async function openSessionPanel(sessionId, searchExcerpt) {
157
+ if (!sessionId) return;
158
+ try {
159
+ const [session, summary] = await Promise.allSettled([
160
+ K.api(`/sessions/${encodeURIComponent(sessionId)}`),
161
+ K.api(`/sessions/${encodeURIComponent(sessionId)}/summary`),
162
+ ]);
163
+ const sData = session.status === 'fulfilled' ? session.value : {};
164
+ const sumData = summary.status === 'fulfilled' ? summary.value : null;
165
+ K.openPanel('session', { session: sData, summary: sumData, sessionId, searchExcerpt });
166
+ } catch (err) {
167
+ K.toast(`Failed to load session: ${err.message}`, 'error');
168
+ }
169
+ }
170
+
171
+ // ── Embeddings ────────────────────────────────────────────────────────────
172
+
173
+ async function loadEmbeddingStats(state, el) {
174
+ try {
175
+ const data = await K.api('/index-status');
176
+ state.embeddings.stats = data;
177
+ renderEmbeddingStats(state, el);
178
+ el.statVectors.querySelector('.stat-value').textContent = data.totalEntries || 0;
179
+ } catch {
180
+ state.embeddings.stats = null;
181
+ renderEmbeddingStats(state, el);
182
+ }
183
+ }
184
+
185
+ function renderEmbeddingStats(state, el) {
186
+ const stats = state.embeddings.stats;
187
+ if (!stats || !stats.totalEntries) {
188
+ el.embeddingsStatsGrid.innerHTML = '';
189
+ el.embeddingsStatus.style.display = 'none';
190
+ el.embeddingsEmpty.classList.remove('hidden');
191
+ return;
192
+ }
193
+
194
+ el.embeddingsEmpty.classList.add('hidden');
195
+ el.embeddingsStatus.style.display = '';
196
+
197
+ const cards = [
198
+ { label: 'Provider', value: stats.provider || 'Not configured', detail: '' },
199
+ { label: 'Dimensions', value: stats.dimensions || 0, detail: 'vector size' },
200
+ { label: 'Total Chunks', value: stats.totalEntries || 0, detail: 'indexed chunks' },
201
+ { label: 'Knowledge', value: stats.knowledgeEntries || 0, detail: 'knowledge chunks' },
202
+ {
203
+ label: 'Sessions',
204
+ value: stats.uniqueSessions || 0,
205
+ detail: `${stats.sessionEntries || 0} chunks`,
206
+ },
207
+ { label: 'DB Size', value: (stats.dbSizeMB || 0).toFixed(1) + ' MB', detail: 'on disk' },
208
+ ];
209
+
210
+ el.embeddingsStatsGrid.innerHTML = cards
211
+ .map(
212
+ (c) => `
213
+ <div class="embedding-stat-card">
214
+ <span class="stat-label">${K.esc(c.label)}</span>
215
+ <span class="stat-number">${K.esc(String(c.value))}</span>
216
+ ${c.detail ? `<span class="stat-detail">${K.esc(c.detail)}</span>` : ''}
217
+ </div>
218
+ `,
219
+ )
220
+ .join('');
221
+ }
222
+
223
+ // ── Export ──────────────────────────────────────────────────────────────────
224
+
225
+ Object.assign(K, {
226
+ loadSessions,
227
+ renderSessions,
228
+ resetSessionPagination,
229
+ initSessionScroll,
230
+ openSessionPanel,
231
+ loadEmbeddingStats,
232
+ renderEmbeddingStats,
233
+ });
234
+ })();
@@ -42,6 +42,8 @@
42
42
  --purple-dim: rgba(110, 120, 168, 0.12);
43
43
  --blue: #0969da;
44
44
  --blue-dim: rgba(9, 105, 218, 0.12);
45
+ --warning: #9a6700;
46
+ --warning-dim: rgba(154, 103, 0, 0.12);
45
47
  --radius: 12px;
46
48
  --radius-sm: 8px;
47
49
  --radius-lg: 16px;
@@ -89,6 +91,8 @@
89
91
  --purple-dim: rgba(142, 154, 208, 0.15);
90
92
  --blue: #58a6ff;
91
93
  --blue-dim: rgba(88, 166, 255, 0.15);
94
+ --warning: #d29922;
95
+ --warning-dim: rgba(210, 153, 34, 0.15);
92
96
  --shadow-1: 0px 1px 2px 0px rgba(0, 0, 0, 0.6), 0px 1px 3px 1px rgba(0, 0, 0, 0.3);
93
97
  --shadow-2: 0px 1px 2px 0px rgba(0, 0, 0, 0.6), 0px 2px 6px 2px rgba(0, 0, 0, 0.3);
94
98
  --shadow-3: 0px 1px 3px 0px rgba(0, 0, 0, 0.6), 0px 4px 8px 3px rgba(0, 0, 0, 0.3);
@@ -851,6 +855,33 @@ h1 {
851
855
  white-space: nowrap;
852
856
  }
853
857
 
858
+ /* ── Sessions Load More ───────────────────────────────────────────────── */
859
+ .sessions-load-more {
860
+ display: flex;
861
+ align-items: center;
862
+ justify-content: center;
863
+ gap: 8px;
864
+ padding: 16px;
865
+ color: var(--text-muted);
866
+ font-size: 13px;
867
+ }
868
+ .sessions-load-more.hidden {
869
+ display: none;
870
+ }
871
+ .sessions-spinner {
872
+ width: 16px;
873
+ height: 16px;
874
+ border: 2px solid var(--border);
875
+ border-top-color: var(--accent);
876
+ border-radius: 50%;
877
+ animation: spin 0.6s linear infinite;
878
+ }
879
+ @keyframes spin {
880
+ to {
881
+ transform: rotate(360deg);
882
+ }
883
+ }
884
+
854
885
  /* ── Filter Select ─────────────────────────────────────────────────────── */
855
886
  .filter-select {
856
887
  height: 32px;
@@ -1052,6 +1083,26 @@ h1 {
1052
1083
  animation: highlight-fade 4s ease-out forwards;
1053
1084
  }
1054
1085
 
1086
+ /* Don't override user message background — white text becomes unreadable */
1087
+ .chat-msg.user.chat-msg-highlight {
1088
+ animation: highlight-outline-fade 4s ease-out forwards;
1089
+ }
1090
+
1091
+ @keyframes highlight-outline-fade {
1092
+ 0% {
1093
+ outline-color: var(--accent);
1094
+ box-shadow: 0 0 8px var(--accent);
1095
+ }
1096
+ 70% {
1097
+ outline-color: var(--accent);
1098
+ box-shadow: 0 0 8px var(--accent);
1099
+ }
1100
+ 100% {
1101
+ outline-color: transparent;
1102
+ box-shadow: none;
1103
+ }
1104
+ }
1105
+
1055
1106
  @keyframes highlight-fade {
1056
1107
  0% {
1057
1108
  background: color-mix(in srgb, var(--accent) 20%, transparent);
@@ -1732,3 +1783,43 @@ h1 {
1732
1783
  background: var(--accent-dim);
1733
1784
  color: var(--text);
1734
1785
  }
1786
+
1787
+ /* ── Header Action Buttons ────────────────────────────────────────────── */
1788
+ .header-action-btn {
1789
+ display: inline-flex;
1790
+ align-items: center;
1791
+ gap: 4px;
1792
+ padding: 5px 12px;
1793
+ font-size: 12px;
1794
+ font-family: var(--font-sans);
1795
+ font-weight: 500;
1796
+ color: var(--text-secondary);
1797
+ background: var(--bg-elevated);
1798
+ border: 1px solid var(--border-light);
1799
+ border-radius: var(--radius-sm);
1800
+ cursor: pointer;
1801
+ transition:
1802
+ background var(--transition),
1803
+ color var(--transition),
1804
+ border-color var(--transition);
1805
+ }
1806
+
1807
+ .header-action-btn:hover {
1808
+ background: var(--bg-hover);
1809
+ color: var(--accent);
1810
+ border-color: var(--accent-dim);
1811
+ }
1812
+
1813
+ .header-action-btn .material-symbols-outlined {
1814
+ font-size: 16px;
1815
+ }
1816
+
1817
+ /* ── Duplicate Warning ────────────────────────────────────────────────── */
1818
+ .knowledge-card.has-duplicates {
1819
+ border-color: var(--warning);
1820
+ box-shadow: 0 0 0 1px var(--warning-dim);
1821
+ }
1822
+
1823
+ .duplicate-warn {
1824
+ cursor: help;
1825
+ }
@@ -0,0 +1,196 @@
1
+ /* agent-knowledge — shared UI utilities */
2
+ (function () {
3
+ 'use strict';
4
+
5
+ window.Knowledge = window.Knowledge || {};
6
+
7
+ // ── DOM helper ──────────────────────────────────────────────────────────────
8
+
9
+ const $ = (id) => document.getElementById(id);
10
+
11
+ // ── Escape HTML ─────────────────────────────────────────────────────────────
12
+
13
+ function esc(str) {
14
+ const d = document.createElement('div');
15
+ d.textContent = str;
16
+ return d.innerHTML;
17
+ }
18
+
19
+ // ── Debounce ────────────────────────────────────────────────────────────────
20
+
21
+ function debounce(fn, ms) {
22
+ let t;
23
+ return (...args) => {
24
+ clearTimeout(t);
25
+ t = setTimeout(() => fn(...args), ms);
26
+ };
27
+ }
28
+
29
+ // ── Relative time ───────────────────────────────────────────────────────────
30
+
31
+ function relativeTime(dateStr) {
32
+ if (!dateStr) return '';
33
+ const now = Date.now();
34
+ const then = new Date(dateStr).getTime();
35
+ const diff = now - then;
36
+ if (diff < 0) return 'just now';
37
+ const secs = Math.floor(diff / 1000);
38
+ if (secs < 60) return 'just now';
39
+ const mins = Math.floor(secs / 60);
40
+ if (mins < 60) return `${mins}m ago`;
41
+ const hrs = Math.floor(mins / 60);
42
+ if (hrs < 24) return `${hrs}h ago`;
43
+ const days = Math.floor(hrs / 24);
44
+ if (days < 30) return `${days}d ago`;
45
+ const months = Math.floor(days / 30);
46
+ if (months < 12) return `${months}mo ago`;
47
+ return `${Math.floor(months / 12)}y ago`;
48
+ }
49
+
50
+ // ── Markdown rendering ──────────────────────────────────────────────────────
51
+
52
+ function renderMd(raw) {
53
+ if (!raw) return '';
54
+ try {
55
+ const html = marked.parse(raw, { breaks: true, gfm: true });
56
+ const clean = DOMPurify.sanitize(html, { ADD_TAGS: ['pre', 'code'] });
57
+ const wrapper = document.createElement('div');
58
+ wrapper.innerHTML = clean;
59
+ wrapper.querySelectorAll('pre code').forEach((block) => {
60
+ try {
61
+ hljs.highlightElement(block);
62
+ } catch (_) {
63
+ /* noop */
64
+ }
65
+ });
66
+ return wrapper.innerHTML;
67
+ } catch {
68
+ return esc(raw);
69
+ }
70
+ }
71
+
72
+ // ── Highlight search excerpts ───────────────────────────────────────────────
73
+
74
+ function highlightExcerpt(text, query) {
75
+ if (!text || !query) return esc(text || '');
76
+ try {
77
+ const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
78
+ const re = new RegExp(`(${escaped})`, 'gi');
79
+ return esc(text).replace(re, '<mark>$1</mark>');
80
+ } catch {
81
+ return esc(text);
82
+ }
83
+ }
84
+
85
+ // ── Score bar rendering ─────────────────────────────────────────────────────
86
+
87
+ function formatScore(score, metadata) {
88
+ if (score == null) return '';
89
+ const pct = Math.min(Math.max(score * 100, 0), 100);
90
+ const tfidf = metadata?.tfidfScore;
91
+ const semantic = metadata?.semanticScore;
92
+ const recency = metadata?.recencyMultiplier;
93
+ const alpha = metadata?.blendAlpha;
94
+
95
+ let tooltip = `Score: ${score.toFixed(3)}`;
96
+ if (tfidf != null && semantic != null) {
97
+ 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)}%)`;
98
+ }
99
+ if (recency != null) tooltip += ` \u00d7 recency ${(recency * 100).toFixed(0)}%`;
100
+
101
+ const recencyTag =
102
+ recency != null && recency < 0.95
103
+ ? `<span class="recency-tag" title="Recency: ${(recency * 100).toFixed(0)}%">${(recency * 100).toFixed(0)}%</span>`
104
+ : '';
105
+ const scoreType =
106
+ tfidf != null && semantic != null
107
+ ? '<span class="score-type hybrid">hybrid</span>'
108
+ : tfidf != null
109
+ ? '<span class="score-type tfidf">tf-idf</span>'
110
+ : '';
111
+ return `<div class="score-bar" title="${tooltip}">
112
+ <div class="score-fill" style="width:${pct}%"></div>
113
+ <span class="score-label">${score.toFixed(2)}${recencyTag}${scoreType}</span>
114
+ </div>`;
115
+ }
116
+
117
+ // ── Toast notifications ─────────────────────────────────────────────────────
118
+
119
+ function toast(msg, type = 'info', duration = 4000) {
120
+ const container = $('toast-container');
121
+ const t = document.createElement('div');
122
+ t.className = `toast toast-${type}`;
123
+ const icons = { info: 'info', success: 'check_circle', error: 'error', warning: 'warning' };
124
+ t.innerHTML = `<span class="material-symbols-outlined toast-icon">${icons[type] || 'info'}</span>
125
+ <span class="toast-msg">${esc(msg)}</span>`;
126
+ container.appendChild(t);
127
+ requestAnimationFrame(() => t.classList.add('show'));
128
+ setTimeout(() => {
129
+ t.classList.remove('show');
130
+ t.addEventListener('transitionend', () => t.remove());
131
+ }, duration);
132
+ }
133
+
134
+ // ── API helper ──────────────────────────────────────────────────────────────
135
+
136
+ async function api(path) {
137
+ const res = await fetch(`/api${path}`);
138
+ if (!res.ok) throw new Error(`API ${res.status}: ${res.statusText}`);
139
+ return res.json();
140
+ }
141
+
142
+ // ── Theme ───────────────────────────────────────────────────────────────────
143
+
144
+ function initTheme() {
145
+ const saved = localStorage.getItem('agent-knowledge-theme');
146
+ const theme = saved || (matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
147
+ applyTheme(theme);
148
+ }
149
+
150
+ function applyTheme(theme) {
151
+ document.documentElement.setAttribute('data-theme', theme);
152
+ localStorage.setItem('agent-knowledge-theme', theme);
153
+ const icon = $('theme-toggle')?.querySelector('.theme-icon');
154
+ if (icon) icon.textContent = theme === 'dark' ? 'light_mode' : 'dark_mode';
155
+ }
156
+
157
+ function toggleTheme() {
158
+ const cur = document.documentElement.getAttribute('data-theme') || 'light';
159
+ applyTheme(cur === 'dark' ? 'light' : 'dark');
160
+ }
161
+
162
+ // ── Strip frontmatter ───────────────────────────────────────────────────────
163
+
164
+ function stripFrontmatter(content) {
165
+ const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
166
+ return match ? match[1].trim() : content;
167
+ }
168
+
169
+ // ── Check if input is focused ───────────────────────────────────────────────
170
+
171
+ function isInputFocused() {
172
+ const active = document.activeElement;
173
+ if (!active) return false;
174
+ const tag = active.tagName.toLowerCase();
175
+ return tag === 'input' || tag === 'textarea' || tag === 'select' || active.isContentEditable;
176
+ }
177
+
178
+ // ── Export ──────────────────────────────────────────────────────────────────
179
+
180
+ Object.assign(window.Knowledge, {
181
+ $,
182
+ esc,
183
+ debounce,
184
+ relativeTime,
185
+ renderMd,
186
+ highlightExcerpt,
187
+ formatScore,
188
+ toast,
189
+ api,
190
+ initTheme,
191
+ applyTheme,
192
+ toggleTheme,
193
+ stripFrontmatter,
194
+ isInputFocused,
195
+ });
196
+ })();