agent-knowledge 1.9.8 → 2.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 (98) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +39 -41
  3. package/dist/events.d.ts +10 -0
  4. package/dist/events.d.ts.map +1 -0
  5. package/dist/events.js +23 -0
  6. package/dist/events.js.map +1 -0
  7. package/dist/index.js +19 -13
  8. package/dist/index.js.map +1 -1
  9. package/dist/knowledge/consolidate.d.ts +2 -2
  10. package/dist/knowledge/consolidate.js +2 -2
  11. package/dist/knowledge/freshness.js +1 -1
  12. package/dist/knowledge/freshness.js.map +1 -1
  13. package/dist/knowledge/git.d.ts.map +1 -1
  14. package/dist/knowledge/git.js +2 -3
  15. package/dist/knowledge/git.js.map +1 -1
  16. package/dist/knowledge/promote.js +1 -1
  17. package/dist/knowledge/promote.js.map +1 -1
  18. package/dist/knowledge/reflect.js +2 -2
  19. package/dist/knowledge/reflect.js.map +1 -1
  20. package/dist/knowledge/search.d.ts +6 -0
  21. package/dist/knowledge/search.d.ts.map +1 -1
  22. package/dist/knowledge/search.js +49 -3
  23. package/dist/knowledge/search.js.map +1 -1
  24. package/dist/knowledge/store.d.ts +3 -1
  25. package/dist/knowledge/store.d.ts.map +1 -1
  26. package/dist/knowledge/store.js +2 -5
  27. package/dist/knowledge/store.js.map +1 -1
  28. package/dist/lib.d.ts +1 -1
  29. package/dist/lib.d.ts.map +1 -1
  30. package/dist/lib.js.map +1 -1
  31. package/dist/package-meta.d.ts +4 -1
  32. package/dist/package-meta.d.ts.map +1 -1
  33. package/dist/package-meta.js +18 -9
  34. package/dist/package-meta.js.map +1 -1
  35. package/dist/rest-server.d.ts +21 -0
  36. package/dist/rest-server.d.ts.map +1 -0
  37. package/dist/rest-server.js +77 -0
  38. package/dist/rest-server.js.map +1 -0
  39. package/dist/server.d.ts +1 -5
  40. package/dist/server.d.ts.map +1 -1
  41. package/dist/server.js +1 -8
  42. package/dist/server.js.map +1 -1
  43. package/dist/sessions/indexer.d.ts +4 -0
  44. package/dist/sessions/indexer.d.ts.map +1 -1
  45. package/dist/sessions/indexer.js +6 -1
  46. package/dist/sessions/indexer.js.map +1 -1
  47. package/dist/sessions/parser.d.ts.map +1 -1
  48. package/dist/sessions/parser.js +32 -2
  49. package/dist/sessions/parser.js.map +1 -1
  50. package/dist/sessions/summary.d.ts.map +1 -1
  51. package/dist/sessions/summary.js +16 -1
  52. package/dist/sessions/summary.js.map +1 -1
  53. package/dist/transport/guard.d.ts +5 -0
  54. package/dist/transport/guard.d.ts.map +1 -0
  55. package/dist/transport/guard.js +51 -0
  56. package/dist/transport/guard.js.map +1 -0
  57. package/dist/transport/http.d.ts +17 -0
  58. package/dist/transport/http.d.ts.map +1 -0
  59. package/dist/transport/http.js +97 -0
  60. package/dist/transport/http.js.map +1 -0
  61. package/dist/transport/rest.d.ts +4 -0
  62. package/dist/transport/rest.d.ts.map +1 -0
  63. package/dist/transport/rest.js +307 -0
  64. package/dist/transport/rest.js.map +1 -0
  65. package/docs/ARCHITECTURE.md +23 -34
  66. package/docs/HOOKS.md +16 -16
  67. package/docs/INGEST.md +1 -1
  68. package/docs/SETUP.md +31 -26
  69. package/docs/USER-MANUAL.md +150 -89
  70. package/package.json +17 -14
  71. package/{skills → plugin/skills}/knowledge-ingest/SKILL.md +1 -1
  72. package/scripts/hooks/session-start.js +6 -7
  73. package/scripts/hooks/sessionend-distill.mjs +5 -5
  74. package/scripts/plugins/opencode/agent-knowledge.ts +6 -6
  75. package/scripts/setup.js +8 -7
  76. package/.claude-plugin/marketplace.json +0 -19
  77. package/.claude-plugin/plugin.json +0 -12
  78. package/.mcp.json +0 -8
  79. package/agent-desk-plugin.json +0 -20
  80. package/dist/dashboard.d.ts +0 -5
  81. package/dist/dashboard.d.ts.map +0 -1
  82. package/dist/dashboard.js +0 -666
  83. package/dist/dashboard.js.map +0 -1
  84. package/dist/ui/app.js +0 -1013
  85. package/dist/ui/index.html +0 -460
  86. package/dist/ui/morphdom.min.js +0 -1
  87. package/dist/ui/render-graph.js +0 -482
  88. package/dist/ui/render-knowledge.js +0 -288
  89. package/dist/ui/render-panel.js +0 -475
  90. package/dist/ui/render-search.js +0 -105
  91. package/dist/ui/render-sessions.js +0 -237
  92. package/dist/ui/styles.css +0 -2322
  93. package/dist/ui/template.js +0 -173
  94. package/dist/ui/ui-utils.js +0 -217
  95. package/dist/ui/vis-network.min.js +0 -34
  96. package/docs/DASHBOARD.md +0 -191
  97. package/scripts/copy-ui.js +0 -14
  98. /package/{skills → plugin/skills}/knowledge-ingest/scripts/validate.mjs +0 -0
package/dist/dashboard.js DELETED
@@ -1,666 +0,0 @@
1
- // =============================================================================
2
- // agent-knowledge dashboard
3
- //
4
- // HTTP + WebSocket plumbing is delegated to agent-common (startDashboard with
5
- // its 127.0.0.1 bind + request guard, createRouter, json, serveStatic,
6
- // setupWebSocket). Only the knowledge-specific routes, the per-endpoint heavy
7
- // rate limiter, and the state snapshot live here.
8
- // =============================================================================
9
- import fs from 'fs';
10
- import path from 'path';
11
- import { createRouter, json, readBody, serveStatic, setupWebSocket, startDashboard as startKitDashboard, } from 'agent-common';
12
- function createRateLimiter(opts) {
13
- const buckets = new Map();
14
- return {
15
- check(req, windowName = 'default') {
16
- const win = opts.windows[windowName] ?? opts.windows.default;
17
- if (!win)
18
- return { allowed: true, limit: Infinity, resetAt: Date.now() };
19
- const ip = req.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
20
- req.socket.remoteAddress ||
21
- 'unknown';
22
- const key = `${windowName}:${ip}`;
23
- const now = Date.now();
24
- let entry = buckets.get(key);
25
- if (!entry || entry.resetAt <= now) {
26
- entry = { count: 0, resetAt: now + win.windowMs };
27
- buckets.set(key, entry);
28
- }
29
- entry.count += 1;
30
- return {
31
- allowed: entry.count <= win.max,
32
- limit: win.max,
33
- resetAt: entry.resetAt,
34
- };
35
- },
36
- };
37
- }
38
- import { listEntries, readEntry, writeEntry } from './knowledge/store.js';
39
- import { searchKnowledge, invalidateKnowledgeIndexCache } from './knowledge/search.js';
40
- import { getEntryScoring, decayFactor, maturityMultiplier } from './knowledge/scoring.js';
41
- import { getKnowledgeGraph } from './knowledge/graph.js';
42
- import { consolidate } from './knowledge/consolidate.js';
43
- import { reflect } from './knowledge/reflect.js';
44
- import { godNodes, bridges, gaps, generateBrief, invalidateBriefCache, } from './knowledge/analyze.js';
45
- import { gitPull, gitPush } from './knowledge/git.js';
46
- import { indexKnowledgeEntry } from './sessions/indexer.js';
47
- import { checkDuplicates } from './knowledge/consolidate.js';
48
- import { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './sessions/parser.js';
49
- import { searchSessions } from './sessions/search.js';
50
- import { listSessions, getSessionSummary } from './sessions/summary.js';
51
- import { scopedSearch } from './sessions/scopes.js';
52
- import { VectorStore } from './vectorstore/index.js';
53
- import { getConfig } from './types.js';
54
- import { getVersion } from './version.js';
55
- const VERSION = getVersion();
56
- const DEFAULT_PORT = 3423;
57
- // ── Per-endpoint rate limiter ────────────────────────────────────────────────
58
- // Default bucket for all /api/ requests, plus a stricter "heavy" bucket for
59
- // embedding-backed endpoints. Both buckets share one rateLimiter instance
60
- // from agent-common.
61
- const rateLimiter = createRateLimiter({
62
- windows: {
63
- default: { max: 100, windowMs: 60_000 },
64
- heavy: { max: 20, windowMs: 60_000 },
65
- },
66
- });
67
- const HEAVY_ENDPOINTS = new Set([
68
- '/api/knowledge/search',
69
- '/api/knowledge/consolidate',
70
- '/api/knowledge/reflect',
71
- '/api/knowledge/god-nodes',
72
- '/api/knowledge/bridges',
73
- '/api/knowledge/gaps',
74
- '/api/knowledge/brief',
75
- '/api/sessions/search',
76
- '/api/sessions/recall',
77
- ]);
78
- function rateLimit(req, res, pathname) {
79
- if (!pathname.startsWith('/api/'))
80
- return false;
81
- const general = rateLimiter.check(req);
82
- if (!general.allowed) {
83
- res.writeHead(429, {
84
- 'Content-Type': 'application/json',
85
- 'Retry-After': String(Math.ceil((general.resetAt - Date.now()) / 1000)),
86
- 'X-RateLimit-Limit': String(general.limit),
87
- 'X-RateLimit-Remaining': '0',
88
- });
89
- res.end(JSON.stringify({ error: 'Too many requests' }));
90
- return true;
91
- }
92
- if (HEAVY_ENDPOINTS.has(pathname)) {
93
- const heavy = rateLimiter.check(req, 'heavy');
94
- if (!heavy.allowed) {
95
- res.writeHead(429, {
96
- 'Content-Type': 'application/json',
97
- 'Retry-After': String(Math.ceil((heavy.resetAt - Date.now()) / 1000)),
98
- 'X-RateLimit-Limit': String(heavy.limit),
99
- 'X-RateLimit-Remaining': '0',
100
- });
101
- res.end(JSON.stringify({ error: 'Too many requests (rate limit for search/analyze)' }));
102
- return true;
103
- }
104
- }
105
- return false;
106
- }
107
- // ── UI dir resolution ────────────────────────────────────────────────────────
108
- function resolveUiDir() {
109
- const moduleUrl = new URL(import.meta.url);
110
- let moduleDir = process.platform === 'win32'
111
- ? moduleUrl.pathname.replace(/^\/([a-zA-Z]:)/, '$1')
112
- : moduleUrl.pathname;
113
- moduleDir = path.dirname(moduleDir);
114
- const srcUi = path.resolve(moduleDir, 'ui');
115
- if (fs.existsSync(srcUi))
116
- return srcUi;
117
- const distUi = path.resolve(moduleDir, '..', 'dist', 'ui');
118
- if (fs.existsSync(distUi))
119
- return distUi;
120
- return srcUi;
121
- }
122
- const EVENT_RING_MAX = 10;
123
- const eventRing = [];
124
- let nextEventId = 1;
125
- function recordEvent(kind, message) {
126
- const evt = { id: nextEventId++, kind, message, ts: Date.now() };
127
- eventRing.push(evt);
128
- while (eventRing.length > EVENT_RING_MAX)
129
- eventRing.shift();
130
- return evt;
131
- }
132
- function getRecentEvents() {
133
- return eventRing.slice();
134
- }
135
- function eventHeadId() {
136
- return eventRing.length > 0 ? eventRing[eventRing.length - 1].id : 0;
137
- }
138
- let snapshotCache = null;
139
- const SNAPSHOT_TTL = 30_000;
140
- function buildSnapshot() {
141
- const now = Date.now();
142
- if (snapshotCache && now - snapshotCache.builtAt < SNAPSHOT_TTL)
143
- return snapshotCache;
144
- const config = getConfig();
145
- let knowledge = [];
146
- let sessionCount = 0;
147
- let vectorCount = snapshotCache?.vectorCount ?? 0;
148
- try {
149
- knowledge = listEntries(config.memoryDir);
150
- for (const proj of getProjectDirs())
151
- sessionCount += getSessionFiles(proj.path).length;
152
- if (!snapshotCache) {
153
- try {
154
- vectorCount = new VectorStore().stats().totalEntries;
155
- }
156
- catch (err) {
157
- console.error('[knowledge] vector stats:', err instanceof Error ? err.message : err);
158
- }
159
- }
160
- }
161
- catch (err) {
162
- console.error('[knowledge] snapshot:', err instanceof Error ? err.message : err);
163
- }
164
- snapshotCache = { knowledge, sessionCount, vectorCount, builtAt: now };
165
- return snapshotCache;
166
- }
167
- function fullState() {
168
- const s = buildSnapshot();
169
- // Enrich with live scoring so the WS-delivered state carries the same
170
- // last_accessed / maturity / access_count shape the REST route returns.
171
- // Enrichment lives here (not buildSnapshot) because scoring changes on every
172
- // read while the entry list itself only changes on file mutation.
173
- let knowledge = s.knowledge;
174
- try {
175
- const scoring = getEntryScoring();
176
- const scores = scoring.getScores(s.knowledge.map((e) => e.path));
177
- knowledge = s.knowledge.map((e) => {
178
- const score = scores.get(e.path);
179
- return {
180
- ...e,
181
- evergreen: e.evergreen === true,
182
- author: e.author ?? null,
183
- maturity: score?.maturity ?? 'candidate',
184
- access_count: score?.access_count ?? 0,
185
- last_accessed: score?.last_accessed ?? null,
186
- };
187
- });
188
- }
189
- catch (err) {
190
- console.error('[knowledge] ws enrichment:', err instanceof Error ? err.message : err);
191
- }
192
- return {
193
- knowledge,
194
- events: getRecentEvents(),
195
- stats: {
196
- knowledge_entries: s.knowledge.length,
197
- session_count: s.sessionCount,
198
- vector_count: s.vectorCount,
199
- uptime: process.uptime(),
200
- version: VERSION,
201
- },
202
- };
203
- }
204
- // ── Routes ───────────────────────────────────────────────────────────────────
205
- function urlOf(req) {
206
- return new URL(req.url ?? '/', `http://${req.headers.host || 'localhost'}`);
207
- }
208
- const healthRoute = (_req, res) => {
209
- const config = getConfig();
210
- const entries = listEntries(config.memoryDir);
211
- json(res, {
212
- status: 'ok',
213
- version: VERSION,
214
- uptime: process.uptime(),
215
- knowledge_entries: entries.length,
216
- });
217
- };
218
- const indexStatusRoute = (_req, res) => {
219
- try {
220
- json(res, new VectorStore().stats());
221
- }
222
- catch (err) {
223
- console.error('[knowledge] index-status:', err instanceof Error ? err.message : err);
224
- json(res, {
225
- totalEntries: 0,
226
- knowledgeEntries: 0,
227
- sessionEntries: 0,
228
- uniqueSessions: 0,
229
- dbSizeMB: 0,
230
- provider: null,
231
- dimensions: 0,
232
- });
233
- }
234
- };
235
- const knowledgeSearchRoute = (req, res) => {
236
- const memoryDir = getConfig().memoryDir;
237
- const url = urlOf(req);
238
- const q = url.searchParams.get('q') || '';
239
- const category = url.searchParams.get('category') || undefined;
240
- const maxResults = url.searchParams.get('max_results');
241
- const results = searchKnowledge(memoryDir, q, {
242
- category,
243
- maxResults: maxResults ? parseInt(maxResults, 10) : undefined,
244
- });
245
- try {
246
- const scoring = getEntryScoring();
247
- const scores = scoring.getScores(results.map((r) => r.entry.path));
248
- const enriched = results.map((r) => {
249
- const score = scores.get(r.entry.path);
250
- return {
251
- ...r,
252
- maturity: score?.maturity ?? 'candidate',
253
- access_count: score?.access_count ?? 0,
254
- decay_factor: score?.last_accessed ? decayFactor(score.last_accessed) : 1,
255
- maturity_multiplier: maturityMultiplier(score?.maturity ?? 'candidate'),
256
- };
257
- });
258
- json(res, enriched);
259
- }
260
- catch (err) {
261
- console.error('[knowledge] search enrichment:', err instanceof Error ? err.message : err);
262
- json(res, results);
263
- }
264
- };
265
- const consolidateRoute = (req, res) => {
266
- const url = urlOf(req);
267
- const category = url.searchParams.get('category') || undefined;
268
- const thresholdParam = url.searchParams.get('threshold');
269
- const threshold = thresholdParam ? parseFloat(thresholdParam) : 0.5;
270
- json(res, consolidate(getConfig().memoryDir, category, threshold));
271
- };
272
- const reflectRoute = (req, res) => {
273
- const url = urlOf(req);
274
- const category = url.searchParams.get('category') || undefined;
275
- const maxParam = url.searchParams.get('max_entries');
276
- const maxEntries = maxParam ? parseInt(maxParam, 10) : 20;
277
- json(res, reflect(getConfig().memoryDir, category, maxEntries));
278
- };
279
- const godNodesRoute = (req, res) => {
280
- const url = urlOf(req);
281
- const topNParam = url.searchParams.get('top_n');
282
- const topN = topNParam ? parseInt(topNParam, 10) : 10;
283
- json(res, godNodes(getConfig().memoryDir, topN));
284
- };
285
- const bridgesRoute = (req, res) => {
286
- const url = urlOf(req);
287
- const topNParam = url.searchParams.get('top_n');
288
- const topN = topNParam ? parseInt(topNParam, 10) : 5;
289
- json(res, bridges(getConfig().memoryDir, topN));
290
- };
291
- const gapsRoute = (req, res) => {
292
- const url = urlOf(req);
293
- const maxParam = url.searchParams.get('max_entries');
294
- const maxEntries = maxParam ? parseInt(maxParam, 10) : 30;
295
- json(res, gaps(getConfig().memoryDir, maxEntries));
296
- };
297
- const briefRoute = (_req, res) => {
298
- json(res, generateBrief(getConfig().memoryDir));
299
- };
300
- const graphDataRoute = (_req, res) => {
301
- try {
302
- const entries = listEntries(getConfig().memoryDir);
303
- const allEdges = getKnowledgeGraph().links();
304
- const scoring = getEntryScoring();
305
- const scores = scoring.getScores(entries.map((e) => e.path));
306
- const categoryColors = {
307
- projects: '#5d8da8',
308
- decisions: '#c2885c',
309
- notes: '#7a9a6d',
310
- workflows: '#9b7db8',
311
- people: '#b85c5c',
312
- };
313
- const nodes = entries.map((e) => {
314
- const cat = e.path.split('/')[0] || 'notes';
315
- const score = scores.get(e.path);
316
- const degree = allEdges.filter((ed) => ed.source === e.path || ed.target === e.path).length;
317
- return {
318
- id: e.path,
319
- label: (e.title || e.path.split('/').pop()?.replace('.md', '') || e.path).slice(0, 40),
320
- title: `${e.path}\nCategory: ${cat}\nEdges: ${degree}\nMaturity: ${score?.maturity ?? 'candidate'}`,
321
- group: cat,
322
- color: categoryColors[cat] || '#888',
323
- size: Math.max(4, Math.min(16, 4 + degree * 2)),
324
- maturity: score?.maturity ?? 'candidate',
325
- };
326
- });
327
- const edges = allEdges.map((e) => ({
328
- from: e.source,
329
- to: e.target,
330
- title: `${e.rel_type.replace(/_/g, ' ')} (strength: ${e.strength ?? 0.5})`,
331
- rel_type: e.rel_type,
332
- strength: e.strength ?? 0.5,
333
- origin: e.origin ?? 'manual',
334
- }));
335
- json(res, { nodes, edges });
336
- }
337
- catch (err) {
338
- console.error('[knowledge] graph-data:', err instanceof Error ? err.message : err);
339
- json(res, { nodes: [], edges: [] });
340
- }
341
- };
342
- const knowledgeListRoute = (req, res) => {
343
- const url = urlOf(req);
344
- const category = url.searchParams.get('category') || undefined;
345
- const tag = url.searchParams.get('tag') || undefined;
346
- const entries = listEntries(getConfig().memoryDir, category, tag);
347
- try {
348
- const scoring = getEntryScoring();
349
- const scores = scoring.getScores(entries.map((e) => e.path));
350
- const enriched = entries.map((e) => {
351
- const score = scores.get(e.path);
352
- return {
353
- // `...e` carries through `evergreen` and `author` from the store
354
- // when they are present in frontmatter; both are optional.
355
- ...e,
356
- evergreen: e.evergreen === true,
357
- author: e.author ?? null,
358
- maturity: score?.maturity ?? 'candidate',
359
- access_count: score?.access_count ?? 0,
360
- last_accessed: score?.last_accessed ?? null,
361
- };
362
- });
363
- json(res, enriched);
364
- }
365
- catch (err) {
366
- console.error('[knowledge] entries enrichment:', err instanceof Error ? err.message : err);
367
- json(res, entries);
368
- }
369
- };
370
- const knowledgeLinksRoute = (_req, res, params) => {
371
- try {
372
- json(res, getKnowledgeGraph().links(params.entryPath));
373
- }
374
- catch (err) {
375
- console.error('[knowledge] links:', err instanceof Error ? err.message : err);
376
- json(res, []);
377
- }
378
- };
379
- const knowledgeEntryRoute = (_req, res, params) => {
380
- const entryPath = params.entryPath;
381
- const entry = readEntry(getConfig().memoryDir, entryPath);
382
- try {
383
- const score = getEntryScoring().getScore(entryPath);
384
- json(res, {
385
- ...entry,
386
- maturity: score?.maturity ?? 'candidate',
387
- access_count: score?.access_count ?? 0,
388
- last_accessed: score?.last_accessed ?? null,
389
- decay_factor: score?.last_accessed ? decayFactor(score.last_accessed) : 1,
390
- maturity_multiplier: maturityMultiplier(score?.maturity ?? 'candidate'),
391
- });
392
- }
393
- catch (err) {
394
- console.error('[knowledge] entry enrichment:', err instanceof Error ? err.message : err);
395
- json(res, entry);
396
- }
397
- };
398
- const sessionsSearchRoute = async (req, res) => {
399
- const url = urlOf(req);
400
- const q = url.searchParams.get('q') || '';
401
- const role = (url.searchParams.get('role') || 'all');
402
- const maxResults = url.searchParams.get('max_results');
403
- const ranked = url.searchParams.get('ranked') !== 'false';
404
- const project = url.searchParams.get('project') || undefined;
405
- const semantic = url.searchParams.get('semantic') === 'true';
406
- json(res, await searchSessions(q, {
407
- role,
408
- maxResults: maxResults ? parseInt(maxResults, 10) : 20,
409
- ranked,
410
- semantic,
411
- project,
412
- }));
413
- };
414
- const sessionsRecallRoute = async (req, res) => {
415
- const url = urlOf(req);
416
- const scope = (url.searchParams.get('scope') || 'all');
417
- const q = url.searchParams.get('q') || '';
418
- const maxResults = url.searchParams.get('max_results');
419
- const project = url.searchParams.get('project') || undefined;
420
- json(res, await scopedSearch(scope, q, {
421
- maxResults: maxResults ? parseInt(maxResults, 10) : 20,
422
- project,
423
- }));
424
- };
425
- const sessionsListRoute = (req, res) => {
426
- const url = urlOf(req);
427
- const project = url.searchParams.get('project') || undefined;
428
- const limitParam = url.searchParams.get('limit');
429
- const offsetParam = url.searchParams.get('offset');
430
- const limit = limitParam ? Math.min(parseInt(limitParam, 10), 500) : undefined;
431
- const offset = offsetParam ? parseInt(offsetParam, 10) : 0;
432
- const all = listSessions(project);
433
- const total = all.length;
434
- let sessions = all;
435
- if (offset > 0)
436
- sessions = sessions.slice(offset);
437
- if (limit !== undefined)
438
- sessions = sessions.slice(0, limit);
439
- if (limitParam !== null || offsetParam !== null) {
440
- json(res, { sessions, total });
441
- }
442
- else {
443
- json(res, sessions);
444
- }
445
- };
446
- const sessionSummaryRoute = (req, res, params) => {
447
- const project = urlOf(req).searchParams.get('project') || undefined;
448
- const summary = getSessionSummary(params.sessionId, project);
449
- if (!summary)
450
- json(res, { error: `Session ${params.sessionId} not found` }, 404);
451
- else
452
- json(res, summary);
453
- };
454
- const sessionDetailRoute = (req, res, params) => {
455
- const url = urlOf(req);
456
- const sessionId = params.sessionId;
457
- const project = url.searchParams.get('project') || undefined;
458
- const includeTools = url.searchParams.get('include_tools') === 'true';
459
- const tailParam = url.searchParams.get('tail');
460
- const tail = tailParam ? parseInt(tailParam, 10) : undefined;
461
- const projects = getProjectDirs().filter((p) => !project || p.name.toLowerCase().includes(project.toLowerCase()));
462
- for (const proj of projects) {
463
- const sessions = getSessionFiles(proj.path);
464
- const match = sessions.find((s) => s.id === sessionId);
465
- if (match) {
466
- const entries = parseSessionFile(match.file);
467
- let messages = extractMessages(entries);
468
- if (!includeTools)
469
- messages = messages.filter((m) => m.role === 'user' || m.role === 'assistant');
470
- if (tail && tail > 0)
471
- messages = messages.slice(-tail);
472
- json(res, { meta: getSessionMeta(entries), messages });
473
- return;
474
- }
475
- }
476
- json(res, { error: `Session ${sessionId} not found` }, 404);
477
- };
478
- // ── Events endpoint ────────────────────────────────────────────────────────
479
- // POST /api/events { kind, message } — records a live event in the ring so
480
- // the UI can render a toast. Fire-and-forget from hooks (fail-open caller
481
- // side). Kind is a short category tag ("session-end", "distill", …) and
482
- // message is a short human-readable line. No auth, same-origin assumption
483
- // matching the rest of the dashboard.
484
- const eventsRoute = async (req, res) => {
485
- let body;
486
- try {
487
- body = await readBody(req, 4_096);
488
- }
489
- catch (e) {
490
- json(res, { error: e instanceof Error ? e.message : 'Bad request' }, 400);
491
- return;
492
- }
493
- const kind = typeof body.kind === 'string' ? body.kind.trim() : '';
494
- const message = typeof body.message === 'string' ? body.message.trim() : '';
495
- if (!kind || !message) {
496
- json(res, { error: 'Required fields: kind, message' }, 422);
497
- return;
498
- }
499
- if (kind.length > 64 || message.length > 512) {
500
- json(res, { error: 'kind <= 64 chars, message <= 512 chars' }, 422);
501
- return;
502
- }
503
- const evt = recordEvent(kind, message);
504
- json(res, { id: evt.id, ts: evt.ts }, 201);
505
- };
506
- // ── Write endpoint ──────────────────────────────────────────────────────────
507
- // POST /api/knowledge — mirrors the MCP knowledge(action=write) pipeline:
508
- // writeEntry → index → auto-link → git push. Used by agent-tasks
509
- // KnowledgeBridge and other services that need HTTP-based writes.
510
- const knowledgeWriteRoute = async (req, res) => {
511
- const config = getConfig();
512
- let body;
513
- try {
514
- body = await readBody(req, 1_048_576);
515
- }
516
- catch (e) {
517
- json(res, { error: e instanceof Error ? e.message : 'Bad request' }, 400);
518
- return;
519
- }
520
- const category = typeof body.category === 'string' ? body.category.trim() : '';
521
- const filename = typeof body.filename === 'string' ? body.filename.trim() : '';
522
- const content = typeof body.content === 'string' ? body.content : '';
523
- if (!category || !filename || !content) {
524
- json(res, { error: 'Required fields: category, filename, content' }, 422);
525
- return;
526
- }
527
- const CATEGORIES = new Set(['projects', 'people', 'decisions', 'workflows', 'notes']);
528
- if (!CATEGORIES.has(category)) {
529
- json(res, { error: `Invalid category. Must be one of: ${[...CATEGORIES].join(', ')}` }, 422);
530
- return;
531
- }
532
- try {
533
- await gitPull(config.memoryDir);
534
- const filePath = writeEntry(config.memoryDir, category, filename, content);
535
- invalidateKnowledgeIndexCache();
536
- invalidateBriefCache();
537
- const pushResult = await gitPush(config.memoryDir);
538
- const autoLinks = [];
539
- try {
540
- await indexKnowledgeEntry(filePath, content);
541
- const { getEmbeddingProvider } = await import('./embeddings/index.js');
542
- const provider = await getEmbeddingProvider();
543
- if (provider) {
544
- const queryVector = await provider.embedOne(content.slice(0, 2000));
545
- const vecStore = new VectorStore();
546
- const similar = vecStore.searchBySource(queryVector, 'knowledge', 4);
547
- const graphStore = getKnowledgeGraph();
548
- for (const hit of similar) {
549
- if (hit.sourceId === filePath)
550
- continue;
551
- if (hit.score > 0.7) {
552
- graphStore.link(filePath, hit.sourceId, 'related_to', hit.score, null, null, 'auto-link');
553
- autoLinks.push({ target: hit.sourceId, similarity: Math.round(hit.score * 100) / 100 });
554
- }
555
- if (autoLinks.length >= 3)
556
- break;
557
- }
558
- }
559
- }
560
- catch (linkErr) {
561
- console.error('[knowledge] Auto-link failed:', linkErr);
562
- }
563
- let duplicateWarnings = [];
564
- try {
565
- duplicateWarnings = checkDuplicates(config.memoryDir, filePath, content);
566
- }
567
- catch (dupErr) {
568
- console.error('[knowledge] Duplicate check failed:', dupErr);
569
- }
570
- const response = { path: filePath, git: pushResult };
571
- if (autoLinks.length > 0)
572
- response.autoLinks = autoLinks;
573
- if (duplicateWarnings.length > 0)
574
- response.duplicateWarnings = duplicateWarnings;
575
- json(res, response, 201);
576
- }
577
- catch (e) {
578
- json(res, { error: e instanceof Error ? e.message : 'Write failed' }, 500);
579
- }
580
- };
581
- // ── Server bootstrap ─────────────────────────────────────────────────────────
582
- export function startDashboard(port) {
583
- const listenPort = port ?? DEFAULT_PORT;
584
- const uiDir = resolveUiDir();
585
- const router = createRouter({ staticDir: uiDir });
586
- router.route('GET', '/health', healthRoute);
587
- router.route('GET', '/api/index-status', indexStatusRoute);
588
- router.route('GET', '/api/knowledge/search', knowledgeSearchRoute);
589
- router.route('GET', '/api/knowledge/consolidate', consolidateRoute);
590
- router.route('GET', '/api/knowledge/reflect', reflectRoute);
591
- router.route('GET', '/api/knowledge/god-nodes', godNodesRoute);
592
- router.route('GET', '/api/knowledge/bridges', bridgesRoute);
593
- router.route('GET', '/api/knowledge/gaps', gapsRoute);
594
- router.route('GET', '/api/knowledge/brief', briefRoute);
595
- router.route('GET', '/api/knowledge/graph-data', graphDataRoute);
596
- router.route('GET', '/api/knowledge', knowledgeListRoute);
597
- router.route('GET', '/api/knowledge/:entryPath/links', knowledgeLinksRoute);
598
- router.route('GET', '/api/knowledge/:entryPath', knowledgeEntryRoute);
599
- router.route('GET', '/api/sessions/search', sessionsSearchRoute);
600
- router.route('GET', '/api/sessions/recall', sessionsRecallRoute);
601
- router.route('GET', '/api/sessions', sessionsListRoute);
602
- router.route('GET', '/api/sessions/:sessionId/summary', sessionSummaryRoute);
603
- router.route('GET', '/api/sessions/:sessionId', sessionDetailRoute);
604
- router.route('POST', '/api/knowledge', knowledgeWriteRoute);
605
- router.route('POST', '/api/events', eventsRoute);
606
- return startKitDashboard({
607
- port: listenPort,
608
- host: process.env.AGENT_KNOWLEDGE_HOST,
609
- handler: async (req, res) => {
610
- const isPost = req.method === 'POST';
611
- if (req.method !== 'GET' && !isPost) {
612
- json(res, { error: 'Method not allowed' }, 405);
613
- return;
614
- }
615
- if (isPost && !req.url?.startsWith('/api/')) {
616
- json(res, { error: 'Method not allowed' }, 405);
617
- return;
618
- }
619
- let pathname;
620
- try {
621
- pathname = new URL(req.url ?? '/', `http://${req.headers.host || 'localhost'}`).pathname;
622
- }
623
- catch {
624
- json(res, { error: 'Bad request' }, 400);
625
- return;
626
- }
627
- if (rateLimit(req, res, pathname))
628
- return;
629
- await router.handle(req, res);
630
- },
631
- onListen: (server) => {
632
- setupWebSocket({
633
- httpServer: server,
634
- getFingerprints: () => {
635
- const s = buildSnapshot();
636
- return {
637
- v: `${s.builtAt}:${s.knowledge.length}:${s.sessionCount}`,
638
- events: String(eventHeadId()),
639
- };
640
- },
641
- getCategoryData: () => fullState(),
642
- getFullState: () => fullState(),
643
- pollIntervalMs: 5_000,
644
- });
645
- // ── File watcher (UI live reload via fs.watch) ───────────────────────
646
- let fileWatcher = null;
647
- try {
648
- if (fs.existsSync(uiDir)) {
649
- fileWatcher = fs.watch(uiDir, { recursive: true }, () => {
650
- // Best-effort: clients pick up changes on the next WS poll cycle.
651
- });
652
- }
653
- }
654
- catch (err) {
655
- console.error('[knowledge] file watcher:', err instanceof Error ? err.message : err);
656
- }
657
- server.on('close', () => {
658
- if (fileWatcher)
659
- fileWatcher.close();
660
- });
661
- },
662
- banner: (p) => `Dashboard: http://localhost:${p}`,
663
- }).then((dashboard) => dashboard.httpServer);
664
- }
665
- export { serveStatic };
666
- //# sourceMappingURL=dashboard.js.map