agent-knowledge 1.9.8 → 3.0.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 (179) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/README.md +53 -52
  3. package/dist/events.d.ts +16 -0
  4. package/dist/events.d.ts.map +1 -0
  5. package/dist/events.js +31 -0
  6. package/dist/events.js.map +1 -0
  7. package/dist/index.js +31 -13
  8. package/dist/index.js.map +1 -1
  9. package/dist/knowledge/analyze.d.ts.map +1 -1
  10. package/dist/knowledge/analyze.js +18 -11
  11. package/dist/knowledge/analyze.js.map +1 -1
  12. package/dist/knowledge/consolidate.d.ts +2 -2
  13. package/dist/knowledge/consolidate.js +2 -2
  14. package/dist/knowledge/distill.d.ts.map +1 -1
  15. package/dist/knowledge/distill.js +28 -16
  16. package/dist/knowledge/distill.js.map +1 -1
  17. package/dist/knowledge/freshness.js +1 -1
  18. package/dist/knowledge/freshness.js.map +1 -1
  19. package/dist/knowledge/git.d.ts +3 -4
  20. package/dist/knowledge/git.d.ts.map +1 -1
  21. package/dist/knowledge/git.js +62 -49
  22. package/dist/knowledge/git.js.map +1 -1
  23. package/dist/knowledge/graph.d.ts +2 -0
  24. package/dist/knowledge/graph.d.ts.map +1 -1
  25. package/dist/knowledge/graph.js +8 -0
  26. package/dist/knowledge/graph.js.map +1 -1
  27. package/dist/knowledge/ingest-freshness.d.ts +22 -0
  28. package/dist/knowledge/ingest-freshness.d.ts.map +1 -0
  29. package/dist/knowledge/ingest-freshness.js +93 -0
  30. package/dist/knowledge/ingest-freshness.js.map +1 -0
  31. package/dist/knowledge/promote.js +1 -1
  32. package/dist/knowledge/promote.js.map +1 -1
  33. package/dist/knowledge/reflect.js +2 -2
  34. package/dist/knowledge/reflect.js.map +1 -1
  35. package/dist/knowledge/remove.d.ts +11 -0
  36. package/dist/knowledge/remove.d.ts.map +1 -0
  37. package/dist/knowledge/remove.js +24 -0
  38. package/dist/knowledge/remove.js.map +1 -0
  39. package/dist/knowledge/search.d.ts +76 -4
  40. package/dist/knowledge/search.d.ts.map +1 -1
  41. package/dist/knowledge/search.js +364 -37
  42. package/dist/knowledge/search.js.map +1 -1
  43. package/dist/knowledge/similar.d.ts +7 -0
  44. package/dist/knowledge/similar.d.ts.map +1 -0
  45. package/dist/knowledge/similar.js +51 -0
  46. package/dist/knowledge/similar.js.map +1 -0
  47. package/dist/knowledge/store.d.ts +20 -1
  48. package/dist/knowledge/store.d.ts.map +1 -1
  49. package/dist/knowledge/store.js +119 -84
  50. package/dist/knowledge/store.js.map +1 -1
  51. package/dist/lib.d.ts +1 -1
  52. package/dist/lib.d.ts.map +1 -1
  53. package/dist/lib.js.map +1 -1
  54. package/dist/package-meta.d.ts +4 -1
  55. package/dist/package-meta.d.ts.map +1 -1
  56. package/dist/package-meta.js +18 -9
  57. package/dist/package-meta.js.map +1 -1
  58. package/dist/rest-server.d.ts +31 -0
  59. package/dist/rest-server.d.ts.map +1 -0
  60. package/dist/rest-server.js +142 -0
  61. package/dist/rest-server.js.map +1 -0
  62. package/dist/search/bm25.d.ts +8 -0
  63. package/dist/search/bm25.d.ts.map +1 -1
  64. package/dist/search/bm25.js +32 -20
  65. package/dist/search/bm25.js.map +1 -1
  66. package/dist/search/excerpt.d.ts +1 -1
  67. package/dist/search/excerpt.d.ts.map +1 -1
  68. package/dist/search/excerpt.js +19 -1
  69. package/dist/search/excerpt.js.map +1 -1
  70. package/dist/search/lexicon.d.ts +37 -0
  71. package/dist/search/lexicon.d.ts.map +1 -0
  72. package/dist/search/lexicon.js +83 -0
  73. package/dist/search/lexicon.js.map +1 -0
  74. package/dist/search/mmr.d.ts +9 -3
  75. package/dist/search/mmr.d.ts.map +1 -1
  76. package/dist/search/mmr.js +21 -7
  77. package/dist/search/mmr.js.map +1 -1
  78. package/dist/search/types.d.ts +2 -0
  79. package/dist/search/types.d.ts.map +1 -1
  80. package/dist/server.d.ts +1 -5
  81. package/dist/server.d.ts.map +1 -1
  82. package/dist/server.js +1 -13
  83. package/dist/server.js.map +1 -1
  84. package/dist/sessions/human.d.ts +12 -0
  85. package/dist/sessions/human.d.ts.map +1 -0
  86. package/dist/sessions/human.js +52 -0
  87. package/dist/sessions/human.js.map +1 -0
  88. package/dist/sessions/indexer.d.ts +4 -0
  89. package/dist/sessions/indexer.d.ts.map +1 -1
  90. package/dist/sessions/indexer.js +6 -1
  91. package/dist/sessions/indexer.js.map +1 -1
  92. package/dist/sessions/parser.d.ts +39 -0
  93. package/dist/sessions/parser.d.ts.map +1 -1
  94. package/dist/sessions/parser.js +169 -15
  95. package/dist/sessions/parser.js.map +1 -1
  96. package/dist/sessions/search.d.ts +2 -0
  97. package/dist/sessions/search.d.ts.map +1 -1
  98. package/dist/sessions/search.js +147 -67
  99. package/dist/sessions/search.js.map +1 -1
  100. package/dist/sessions/snapshot.d.ts +19 -0
  101. package/dist/sessions/snapshot.d.ts.map +1 -0
  102. package/dist/sessions/snapshot.js +118 -0
  103. package/dist/sessions/snapshot.js.map +1 -0
  104. package/dist/sessions/summary.d.ts +24 -5
  105. package/dist/sessions/summary.d.ts.map +1 -1
  106. package/dist/sessions/summary.js +122 -146
  107. package/dist/sessions/summary.js.map +1 -1
  108. package/dist/slice.d.ts +5 -0
  109. package/dist/slice.d.ts.map +1 -0
  110. package/dist/slice.js +28 -0
  111. package/dist/slice.js.map +1 -0
  112. package/dist/text.d.ts +9 -0
  113. package/dist/text.d.ts.map +1 -0
  114. package/dist/text.js +16 -0
  115. package/dist/text.js.map +1 -0
  116. package/dist/tool-handlers.d.ts.map +1 -1
  117. package/dist/tool-handlers.js +6 -10
  118. package/dist/tool-handlers.js.map +1 -1
  119. package/dist/transport/guard.d.ts +5 -0
  120. package/dist/transport/guard.d.ts.map +1 -0
  121. package/dist/transport/guard.js +51 -0
  122. package/dist/transport/guard.js.map +1 -0
  123. package/dist/transport/http.d.ts +17 -0
  124. package/dist/transport/http.d.ts.map +1 -0
  125. package/dist/transport/http.js +97 -0
  126. package/dist/transport/http.js.map +1 -0
  127. package/dist/transport/rest.d.ts +4 -0
  128. package/dist/transport/rest.d.ts.map +1 -0
  129. package/dist/transport/rest.js +424 -0
  130. package/dist/transport/rest.js.map +1 -0
  131. package/dist/vectorstore/store.d.ts +9 -0
  132. package/dist/vectorstore/store.d.ts.map +1 -1
  133. package/dist/vectorstore/store.js +23 -0
  134. package/dist/vectorstore/store.js.map +1 -1
  135. package/dist/wakeup.d.ts +5 -0
  136. package/dist/wakeup.d.ts.map +1 -1
  137. package/dist/wakeup.js +10 -1
  138. package/dist/wakeup.js.map +1 -1
  139. package/docs/ARCHITECTURE.md +25 -39
  140. package/docs/HOOKS.md +138 -237
  141. package/docs/INGEST.md +1 -1
  142. package/docs/SETUP.md +87 -143
  143. package/docs/USER-MANUAL.md +169 -100
  144. package/package.json +20 -17
  145. package/{skills → plugin/skills}/knowledge-ingest/SKILL.md +1 -1
  146. package/{skills → plugin/skills}/knowledge-ingest/scripts/validate.mjs +2 -2
  147. package/scripts/plugins/opencode/agent-knowledge.ts +37 -86
  148. package/scripts/setup.js +80 -146
  149. package/scripts/source-walk.d.mts +12 -0
  150. package/scripts/source-walk.mjs +94 -0
  151. package/scripts/tree-sitter-extract.mjs +10 -76
  152. package/.claude-plugin/marketplace.json +0 -19
  153. package/.claude-plugin/plugin.json +0 -12
  154. package/.mcp.json +0 -8
  155. package/agent-desk-plugin.json +0 -20
  156. package/dist/dashboard.d.ts +0 -5
  157. package/dist/dashboard.d.ts.map +0 -1
  158. package/dist/dashboard.js +0 -666
  159. package/dist/dashboard.js.map +0 -1
  160. package/dist/ui/app.js +0 -1013
  161. package/dist/ui/index.html +0 -460
  162. package/dist/ui/morphdom.min.js +0 -1
  163. package/dist/ui/render-graph.js +0 -482
  164. package/dist/ui/render-knowledge.js +0 -288
  165. package/dist/ui/render-panel.js +0 -475
  166. package/dist/ui/render-search.js +0 -105
  167. package/dist/ui/render-sessions.js +0 -237
  168. package/dist/ui/styles.css +0 -2322
  169. package/dist/ui/template.js +0 -173
  170. package/dist/ui/ui-utils.js +0 -217
  171. package/dist/ui/vis-network.min.js +0 -34
  172. package/docs/DASHBOARD.md +0 -191
  173. package/scripts/copy-ui.js +0 -14
  174. package/scripts/hooks/first-prompt-inject.mjs +0 -242
  175. package/scripts/hooks/precompact-distill.mjs +0 -105
  176. package/scripts/hooks/precompact-flush.mjs +0 -192
  177. package/scripts/hooks/session-start-ingest.mjs +0 -238
  178. package/scripts/hooks/session-start.js +0 -212
  179. package/scripts/hooks/sessionend-distill.mjs +0 -198
@@ -1,173 +0,0 @@
1
- /* agent-knowledge — HTML template for plugin mount */
2
- (function () {
3
- 'use strict';
4
-
5
- var K = window.Knowledge;
6
-
7
- K._template = function () {
8
- return (
9
- '<header role="banner">' +
10
- '<div class="header-left">' +
11
- '<span class="material-symbols-outlined brand-icon">psychology</span>' +
12
- '<h1>agent-knowledge</h1>' +
13
- '<span class="version" id="version">v1.0.0</span>' +
14
- '<span id="connection-status" class="status-badge disconnected" role="status" aria-live="polite">Connecting</span>' +
15
- '</div>' +
16
- '<div class="header-right">' +
17
- '<div class="stats" id="stats" aria-live="polite" aria-atomic="true">' +
18
- '<span class="stat-badge" id="stat-knowledge" title="Knowledge entries">' +
19
- '<span class="material-symbols-outlined stat-icon">folder</span>' +
20
- '<span class="stat-value">0</span>' +
21
- '</span>' +
22
- '<span class="stat-badge" id="stat-sessions" title="Sessions">' +
23
- '<span class="material-symbols-outlined stat-icon">history</span>' +
24
- '<span class="stat-value">0</span>' +
25
- '</span>' +
26
- '<span class="stat-badge" id="stat-vectors" title="Vector embeddings">' +
27
- '<span class="material-symbols-outlined stat-icon">neurology</span>' +
28
- '<span class="stat-value">0</span>' +
29
- '</span>' +
30
- '</div>' +
31
- '<button id="theme-toggle" class="icon-btn" title="Toggle theme" aria-label="Toggle theme">' +
32
- '<span class="material-symbols-outlined theme-icon">dark_mode</span>' +
33
- '</button>' +
34
- '</div>' +
35
- '</header>' +
36
- '<nav class="tab-bar" role="tablist" aria-label="Main navigation">' +
37
- '<button id="tab-knowledge" class="tab active" role="tab" aria-selected="true" aria-controls="view-knowledge" data-view="knowledge">' +
38
- '<span class="material-symbols-outlined tab-icon">folder</span> Knowledge' +
39
- '</button>' +
40
- '<button id="tab-search" class="tab" role="tab" aria-selected="false" aria-controls="view-search" data-view="search">' +
41
- '<span class="material-symbols-outlined tab-icon">search</span> Search' +
42
- '</button>' +
43
- '<button id="tab-sessions" class="tab" role="tab" aria-selected="false" aria-controls="view-sessions" data-view="sessions">' +
44
- '<span class="material-symbols-outlined tab-icon">history</span> Sessions' +
45
- '</button>' +
46
- '<button id="tab-embeddings" class="tab" role="tab" aria-selected="false" aria-controls="view-embeddings" data-view="embeddings">' +
47
- '<span class="material-symbols-outlined tab-icon">neurology</span> Embeddings' +
48
- '</button>' +
49
- '</nav>' +
50
- '<div class="content-wrapper" id="content-wrapper">' +
51
- '<main id="content">' +
52
- '<section id="view-knowledge" class="view active" role="tabpanel" aria-labelledby="tab-knowledge">' +
53
- '<div class="view-header">' +
54
- '<h2><span class="material-symbols-outlined view-icon">folder</span>Knowledge Base</h2>' +
55
- '<div class="view-actions">' +
56
- '<button id="btn-consolidate" class="header-action-btn" title="Scan for duplicate entries">' +
57
- '<span class="material-symbols-outlined">content_copy</span>Duplicates' +
58
- '</button>' +
59
- '<button id="btn-reflect" class="header-action-btn" title="Find unconnected entries">' +
60
- '<span class="material-symbols-outlined">psychology</span>Reflect' +
61
- '</button>' +
62
- '</div>' +
63
- '</div>' +
64
- '<div class="filter-chips" id="knowledge-categories" role="group" aria-label="Filter by category">' +
65
- '<button class="chip active" data-category="all"><span class="material-symbols-outlined chip-icon">select_all</span>All</button>' +
66
- '<button class="chip" data-category="projects"><span class="material-symbols-outlined chip-icon">code</span>Projects</button>' +
67
- '<button class="chip" data-category="people"><span class="material-symbols-outlined chip-icon">group</span>People</button>' +
68
- '<button class="chip" data-category="decisions"><span class="material-symbols-outlined chip-icon">gavel</span>Decisions</button>' +
69
- '<button class="chip" data-category="workflows"><span class="material-symbols-outlined chip-icon">account_tree</span>Workflows</button>' +
70
- '<button class="chip" data-category="notes"><span class="material-symbols-outlined chip-icon">sticky_note_2</span>Notes</button>' +
71
- '</div>' +
72
- '<div class="search-bar knowledge-search-bar">' +
73
- '<span class="material-symbols-outlined search-input-icon">search</span>' +
74
- '<input type="search" id="knowledge-search-input" class="search-input" placeholder="Search knowledge entries..." autocomplete="off" aria-label="Search knowledge entries" />' +
75
- '</div>' +
76
- '<div id="knowledge-search-results" class="results-list" style="display:none"></div>' +
77
- '<div id="knowledge-grid" class="card-grid"></div>' +
78
- '<div id="knowledge-empty" class="empty-state hidden">' +
79
- '<span class="material-symbols-outlined empty-icon">folder_off</span>' +
80
- '<div class="empty-text">No knowledge entries found</div>' +
81
- '<div class="empty-hint">Entries will appear here when added via the knowledge MCP tools</div>' +
82
- '</div>' +
83
- '</section>' +
84
- '<section id="view-search" class="view" role="tabpanel" aria-labelledby="tab-search" hidden>' +
85
- '<div class="view-header">' +
86
- '<h2><span class="material-symbols-outlined view-icon">search</span>Search Sessions</h2>' +
87
- '</div>' +
88
- '<div class="search-bar">' +
89
- '<span class="material-symbols-outlined search-input-icon">search</span>' +
90
- '<input type="search" id="search-input" class="search-input" placeholder="Search sessions..." autocomplete="off" aria-label="Search sessions" />' +
91
- '</div>' +
92
- '<div class="search-controls">' +
93
- '<div class="filter-chips" id="search-role-filters" role="group" aria-label="Filter by role">' +
94
- '<button class="chip active" data-role="all">All</button>' +
95
- '<button class="chip" data-role="user"><span class="material-symbols-outlined chip-icon">person</span>User</button>' +
96
- '<button class="chip" data-role="assistant"><span class="material-symbols-outlined chip-icon">smart_toy</span>Assistant</button>' +
97
- '</div>' +
98
- '<div class="mode-toggle" role="group" aria-label="Search mode">' +
99
- '<button class="mode-btn active" id="mode-ranked" data-mode="ranked" title="TF-IDF ranked search">' +
100
- '<span class="material-symbols-outlined">sort</span>Ranked' +
101
- '</button>' +
102
- '<button class="mode-btn" id="mode-semantic" data-mode="semantic" title="Hybrid semantic + TF-IDF search">' +
103
- '<span class="material-symbols-outlined">neurology</span>Semantic' +
104
- '</button>' +
105
- '<button class="mode-btn" id="mode-regex" data-mode="regex" title="Regular expression search">' +
106
- '<span class="material-symbols-outlined">code</span>Regex' +
107
- '</button>' +
108
- '</div>' +
109
- '<div class="filter-chips" id="search-scopes" role="group" aria-label="Filter by scope">' +
110
- '<button class="chip active" data-scope="all">All</button>' +
111
- '<button class="chip" data-scope="errors"><span class="material-symbols-outlined chip-icon">error</span>Errors</button>' +
112
- '<button class="chip" data-scope="plans"><span class="material-symbols-outlined chip-icon">checklist</span>Plans</button>' +
113
- '<button class="chip" data-scope="configs"><span class="material-symbols-outlined chip-icon">settings</span>Configs</button>' +
114
- '<button class="chip" data-scope="tools"><span class="material-symbols-outlined chip-icon">build</span>Tools</button>' +
115
- '<button class="chip" data-scope="files"><span class="material-symbols-outlined chip-icon">description</span>Files</button>' +
116
- '<button class="chip" data-scope="decisions"><span class="material-symbols-outlined chip-icon">gavel</span>Decisions</button>' +
117
- '</div>' +
118
- '</div>' +
119
- '<div id="search-results" class="results-list"></div>' +
120
- '<div id="search-empty" class="empty-state">' +
121
- '<span class="material-symbols-outlined empty-icon">manage_search</span>' +
122
- '<div class="empty-text">Search across session transcripts</div>' +
123
- '<div class="empty-hint">Enter a query above to find matching messages</div>' +
124
- '</div>' +
125
- '</section>' +
126
- '<section id="view-sessions" class="view" role="tabpanel" aria-labelledby="tab-sessions" hidden>' +
127
- '<div class="view-header">' +
128
- '<h2><span class="material-symbols-outlined view-icon">history</span>Sessions</h2>' +
129
- '<div class="view-actions">' +
130
- '<select id="session-project-filter" class="filter-select" aria-label="Filter by project">' +
131
- '<option value="">All projects</option>' +
132
- '</select>' +
133
- '</div>' +
134
- '</div>' +
135
- '<div id="sessions-list" class="sessions-list"></div>' +
136
- '<div id="sessions-empty" class="empty-state hidden">' +
137
- '<span class="material-symbols-outlined empty-icon">event_busy</span>' +
138
- '<div class="empty-text">No sessions found</div>' +
139
- '<div class="empty-hint">Sessions will appear here once indexed</div>' +
140
- '</div>' +
141
- '</section>' +
142
- '<section id="view-embeddings" class="view" role="tabpanel" aria-labelledby="tab-embeddings" hidden>' +
143
- '<div class="view-header">' +
144
- '<h2><span class="material-symbols-outlined view-icon">neurology</span>Embeddings</h2>' +
145
- '</div>' +
146
- '<div id="embeddings-status" class="embeddings-dashboard">' +
147
- '<div class="embedding-stats-grid" id="embedding-stats-grid"></div>' +
148
- '</div>' +
149
- '<div id="embeddings-empty" class="empty-state">' +
150
- '<span class="material-symbols-outlined empty-icon">neurology</span>' +
151
- '<div class="empty-text">Vector index not initialized</div>' +
152
- '<div class="empty-hint">Embeddings are generated automatically on server startup</div>' +
153
- '</div>' +
154
- '</section>' +
155
- '</main>' +
156
- '<aside id="side-panel" class="side-panel" role="complementary" aria-label="Detail view" hidden>' +
157
- '<div class="panel-header">' +
158
- '<div class="panel-title" id="panel-title"></div>' +
159
- '<button id="panel-close" class="icon-btn" title="Close panel" aria-label="Close panel">' +
160
- '<span class="material-symbols-outlined">close</span>' +
161
- '</button>' +
162
- '</div>' +
163
- '<div class="panel-body" id="panel-body"></div>' +
164
- '</aside>' +
165
- '</div>' +
166
- '<div id="loading-overlay" class="loading-overlay" aria-label="Loading">' +
167
- '<div class="loading-spinner"></div>' +
168
- '<div class="loading-text">Connecting to agent-knowledge...</div>' +
169
- '</div>' +
170
- '<div id="toast-container" class="toast-container" aria-live="polite"></div>'
171
- );
172
- };
173
- })();
@@ -1,217 +0,0 @@
1
- /* agent-knowledge — shared UI utilities */
2
- (function () {
3
- 'use strict';
4
-
5
- window.Knowledge = window.Knowledge || {};
6
- window.Knowledge._baseUrl = '';
7
- window.Knowledge._wsUrl = null;
8
- window.Knowledge._root = document;
9
-
10
- // ── DOM helper ──────────────────────────────────────────────────────────────
11
-
12
- const $ = (id) => window.Knowledge._root.getElementById(id);
13
-
14
- // ── Escape HTML ─────────────────────────────────────────────────────────────
15
-
16
- function esc(str) {
17
- if (str === null || str === undefined) return '';
18
- const d = document.createElement('div');
19
- d.textContent = String(str);
20
- return d.innerHTML;
21
- }
22
-
23
- function escAttr(str) {
24
- return esc(str).replace(/"/g, '&quot;');
25
- }
26
-
27
- // ── Debounce ────────────────────────────────────────────────────────────────
28
-
29
- function debounce(fn, ms) {
30
- let t;
31
- return (...args) => {
32
- clearTimeout(t);
33
- t = setTimeout(() => fn(...args), ms);
34
- };
35
- }
36
-
37
- // ── Relative time ───────────────────────────────────────────────────────────
38
-
39
- function relativeTime(dateStr) {
40
- if (!dateStr) return '';
41
- const now = Date.now();
42
- const then = new Date(dateStr).getTime();
43
- const diff = now - then;
44
- if (diff < 0) return 'just now';
45
- const secs = Math.floor(diff / 1000);
46
- if (secs < 60) return 'just now';
47
- const mins = Math.floor(secs / 60);
48
- if (mins < 60) return `${mins}m ago`;
49
- const hrs = Math.floor(mins / 60);
50
- if (hrs < 24) return `${hrs}h ago`;
51
- const days = Math.floor(hrs / 24);
52
- if (days < 30) return `${days}d ago`;
53
- const months = Math.floor(days / 30);
54
- if (months < 12) return `${months}mo ago`;
55
- return `${Math.floor(months / 12)}y ago`;
56
- }
57
-
58
- // ── Markdown rendering ──────────────────────────────────────────────────────
59
-
60
- function renderMd(raw) {
61
- if (!raw) return '';
62
- try {
63
- const html = marked.parse(raw, { breaks: true, gfm: true });
64
- const clean = DOMPurify.sanitize(html, { ADD_TAGS: ['pre', 'code'] });
65
- const wrapper = document.createElement('div');
66
- wrapper.innerHTML = clean;
67
- wrapper.querySelectorAll('pre code').forEach((block) => {
68
- try {
69
- hljs.highlightElement(block);
70
- } catch (_) {
71
- /* noop */
72
- }
73
- });
74
- return wrapper.innerHTML;
75
- } catch {
76
- return esc(raw);
77
- }
78
- }
79
-
80
- // ── Highlight search excerpts ───────────────────────────────────────────────
81
-
82
- function highlightExcerpt(text, query) {
83
- if (!text || !query) return esc(text || '');
84
- try {
85
- const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
86
- const re = new RegExp(`(${escaped})`, 'gi');
87
- return esc(text).replace(re, '<mark>$1</mark>');
88
- } catch {
89
- return esc(text);
90
- }
91
- }
92
-
93
- // ── Score bar rendering ─────────────────────────────────────────────────────
94
-
95
- function formatScore(score, metadata) {
96
- if (score == null) return '';
97
- const pct = Math.min(Math.max(score * 100, 0), 100);
98
- const tfidf = metadata?.tfidfScore;
99
- const semantic = metadata?.semanticScore;
100
- const recency = metadata?.recencyMultiplier;
101
- const alpha = metadata?.blendAlpha;
102
-
103
- let tooltip = `Score: ${score.toFixed(3)}`;
104
- if (tfidf != null && semantic != null) {
105
- 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)}%)`;
106
- }
107
- if (recency != null) tooltip += ` \u00d7 recency ${(recency * 100).toFixed(0)}%`;
108
-
109
- const recencyTag =
110
- recency != null && recency < 0.95
111
- ? `<span class="recency-tag" title="Recency: ${(recency * 100).toFixed(0)}%">${(recency * 100).toFixed(0)}%</span>`
112
- : '';
113
- const scoreType =
114
- tfidf != null && semantic != null
115
- ? '<span class="score-type hybrid">hybrid</span>'
116
- : tfidf != null
117
- ? '<span class="score-type tfidf">tf-idf</span>'
118
- : '';
119
- return `<div class="score-bar" title="${tooltip}">
120
- <div class="score-fill" style="width:${pct}%"></div>
121
- <span class="score-label">${score.toFixed(2)}${recencyTag}${scoreType}</span>
122
- </div>`;
123
- }
124
-
125
- // ── Toast notifications ─────────────────────────────────────────────────────
126
-
127
- function toast(msg, type = 'info', duration = 4000) {
128
- const container = $('toast-container');
129
- const t = document.createElement('div');
130
- t.className = `toast toast-${type}`;
131
- const icons = { info: 'info', success: 'check_circle', error: 'error', warning: 'warning' };
132
- t.innerHTML = `<span class="material-symbols-outlined toast-icon">${icons[type] || 'info'}</span>
133
- <span class="toast-msg">${esc(msg)}</span>`;
134
- container.appendChild(t);
135
- setTimeout(() => {
136
- t.classList.add('fade-out');
137
- t.addEventListener('animationend', () => t.remove());
138
- // Fallback removal if animationend doesn't fire
139
- setTimeout(() => {
140
- if (t.parentNode) t.remove();
141
- }, 500);
142
- }, duration);
143
- }
144
-
145
- // ── API helper ──────────────────────────────────────────────────────────────
146
-
147
- async function api(path) {
148
- const res = await fetch(`${window.Knowledge._baseUrl}/api${path}`);
149
- if (!res.ok) throw new Error(`API ${res.status}: ${res.statusText}`);
150
- return res.json();
151
- }
152
-
153
- // ── Theme ───────────────────────────────────────────────────────────────────
154
-
155
- function initTheme() {
156
- const saved = localStorage.getItem('agent-knowledge-theme');
157
- const theme = saved || (matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
158
- applyTheme(theme);
159
- }
160
-
161
- function applyTheme(theme) {
162
- document.documentElement.setAttribute('data-theme', theme);
163
- localStorage.setItem('agent-knowledge-theme', theme);
164
- const icon = $('theme-toggle')?.querySelector('.theme-icon');
165
- if (icon) icon.textContent = theme === 'dark' ? 'light_mode' : 'dark_mode';
166
- }
167
-
168
- function toggleTheme() {
169
- const cur = document.documentElement.getAttribute('data-theme') || 'light';
170
- applyTheme(cur === 'dark' ? 'light' : 'dark');
171
- }
172
-
173
- // ── Strip frontmatter ───────────────────────────────────────────────────────
174
-
175
- function stripFrontmatter(content) {
176
- const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
177
- return match ? match[1].trim() : content;
178
- }
179
-
180
- // ── Check if input is focused ───────────────────────────────────────────────
181
-
182
- function isInputFocused() {
183
- const active = document.activeElement;
184
- if (!active) return false;
185
- const tag = active.tagName.toLowerCase();
186
- return tag === 'input' || tag === 'textarea' || tag === 'select' || active.isContentEditable;
187
- }
188
-
189
- // ── Morphdom wrapper ────────────────────────────────────────────────────────
190
-
191
- function morph(el, newInnerHTML) {
192
- var wrap = document.createElement(el.tagName);
193
- wrap.innerHTML = newInnerHTML;
194
- morphdom(el, wrap, { childrenOnly: true });
195
- }
196
-
197
- // ── Export ──────────────────────────────────────────────────────────────────
198
-
199
- Object.assign(window.Knowledge, {
200
- $,
201
- esc,
202
- escAttr,
203
- debounce,
204
- relativeTime,
205
- renderMd,
206
- highlightExcerpt,
207
- formatScore,
208
- toast,
209
- api,
210
- initTheme,
211
- applyTheme,
212
- toggleTheme,
213
- stripFrontmatter,
214
- isInputFocused,
215
- morph,
216
- });
217
- })();