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,237 +0,0 @@
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
- const total = !Array.isArray(data) && typeof data.total === 'number' ? data.total : null;
25
-
26
- if (isFirstPage) {
27
- state.sessions.list = page;
28
- } else {
29
- state.sessions.list = state.sessions.list.concat(page);
30
- }
31
-
32
- state.sessions.offset = offset + page.length;
33
- state.sessions.allLoaded = page.length < PAGE_SIZE;
34
- if (total !== null) state.sessions.total = total;
35
- state.stats.sessionCount = state.sessions.total ?? state.sessions.list.length;
36
- K.updateStats(state, el);
37
- updateProjectFilter(state.sessions.list, el);
38
- renderSessions(state, el);
39
- } catch (err) {
40
- K.toast(`Failed to load sessions: ${err.message}`, 'error');
41
- }
42
- state.sessions.loading = false;
43
- showLoadingIndicator(el, false);
44
- }
45
-
46
- function resetSessionPagination(state) {
47
- state.sessions.list = [];
48
- state.sessions.offset = 0;
49
- state.sessions.allLoaded = false;
50
- }
51
-
52
- // ── Loading indicator ─────────────────────────────────────────────────────
53
-
54
- function showLoadingIndicator(el, show) {
55
- let indicator = K._root.getElementById('sessions-load-more');
56
- if (show) {
57
- if (!indicator) {
58
- indicator = document.createElement('div');
59
- indicator.id = 'sessions-load-more';
60
- indicator.className = 'sessions-load-more';
61
- indicator.innerHTML =
62
- '<span class="sessions-spinner"></span><span>Loading more\u2026</span>';
63
- el.sessionsList.parentNode.insertBefore(indicator, el.sessionsEmpty);
64
- }
65
- indicator.classList.remove('hidden');
66
- } else if (indicator) {
67
- indicator.classList.add('hidden');
68
- }
69
- }
70
-
71
- // ── Scroll-based pagination ───────────────────────────────────────────────
72
-
73
- function initSessionScroll(state, el) {
74
- const content = K._root.getElementById('content');
75
- if (!content) return;
76
- content.addEventListener('scroll', () => {
77
- if (state.sessions.loading || state.sessions.allLoaded) return;
78
- const nearBottom = content.scrollHeight - content.scrollTop - content.clientHeight < 200;
79
- if (nearBottom) loadSessions(state, el);
80
- });
81
- }
82
-
83
- // ── Populate project filter dropdown ──────────────────────────────────────
84
-
85
- function updateProjectFilter(sessions, el) {
86
- const projects = [...new Set(sessions.map((s) => s.project).filter(Boolean))].sort();
87
- const sel = el.sessionProjectFilter;
88
- const current = sel.value;
89
- K.morph(
90
- sel,
91
- '<option value="">All projects</option>' +
92
- projects.map((p) => `<option value="${K.esc(p)}">${K.esc(p)}</option>`).join(''),
93
- );
94
- sel.value = current;
95
- }
96
-
97
- // ── Render session list ───────────────────────────────────────────────────
98
-
99
- function renderSessions(state, el) {
100
- const filter = state.sessions.projectFilter;
101
- const list = filter
102
- ? state.sessions.list.filter((s) => s.project === filter)
103
- : state.sessions.list;
104
-
105
- if (list.length === 0) {
106
- K.morph(el.sessionsList, '');
107
- el.sessionsEmpty.classList.remove('hidden');
108
- return;
109
- }
110
-
111
- el.sessionsEmpty.classList.add('hidden');
112
- K.morph(
113
- el.sessionsList,
114
- list
115
- .map((s) => {
116
- const id = s.sessionId || s.id || '';
117
- const project = s.project || '';
118
- const branch = s.branch || s.gitBranch || s.git_branch || '';
119
- const count = s.messageCount || s.message_count || s.count || 0;
120
- const date = s.startTime || s.date || s.created || s.startedAt || '';
121
- const preview = s.preview || '';
122
- const time = K.relativeTime(date);
123
- const dateStr = date
124
- ? new Date(date).toLocaleDateString(undefined, {
125
- month: 'short',
126
- day: 'numeric',
127
- year: 'numeric',
128
- })
129
- : '';
130
-
131
- const title = preview
132
- ? preview.length > 80
133
- ? preview.slice(0, 80) + '\u2026'
134
- : preview
135
- : id.slice(0, 8);
136
-
137
- return `<div class="session-card" data-session-id="${K.esc(id)}" tabindex="0" role="button">
138
- <div class="session-header">
139
- <span class="session-title">${K.esc(title)}</span>
140
- <span class="session-date">${dateStr || time || ''}</span>
141
- </div>
142
- <div class="session-meta">
143
- <span class="session-meta-item"><span class="material-symbols-outlined">folder</span>${K.esc(project)}</span>
144
- ${branch ? `<span class="session-meta-item"><span class="material-symbols-outlined">alt_route</span>${K.esc(branch)}</span>` : ''}
145
- <span class="session-meta-item"><span class="material-symbols-outlined">chat</span>${count} messages</span>
146
- <span class="session-meta-item"><span class="material-symbols-outlined">tag</span>${K.esc(id.slice(0, 8))}</span>
147
- </div>
148
- </div>`;
149
- })
150
- .join(''),
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
- K.morph(el.embeddingsStatsGrid, '');
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
- K.morph(
211
- el.embeddingsStatsGrid,
212
- cards
213
- .map(
214
- (c) => `
215
- <div class="embedding-stat-card">
216
- <span class="stat-label">${K.esc(c.label)}</span>
217
- <span class="stat-number">${K.esc(String(c.value))}</span>
218
- ${c.detail ? `<span class="stat-detail">${K.esc(c.detail)}</span>` : ''}
219
- </div>
220
- `,
221
- )
222
- .join(''),
223
- );
224
- }
225
-
226
- // ── Export ──────────────────────────────────────────────────────────────────
227
-
228
- Object.assign(K, {
229
- loadSessions,
230
- renderSessions,
231
- resetSessionPagination,
232
- initSessionScroll,
233
- openSessionPanel,
234
- loadEmbeddingStats,
235
- renderEmbeddingStats,
236
- });
237
- })();