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,198 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- // =============================================================================
4
- // agent-knowledge SessionEnd distill hook
5
- //
6
- // Dumps a final session summary (turn counts, tool uses, first 20 user
7
- // prompts) into the knowledge base when the host ends the conversation.
8
- // Lightweight heuristic snapshot — the richer distillation happens via
9
- // the library on next agent-knowledge startup.
10
- //
11
- // Emits a top-level `systemMessage` so the user can see the hook actually
12
- // fired (receipt of what was distilled, or reason for skipping). Also
13
- // appends a one-line breadcrumb to `~/agent-knowledge/sessions/index.md`
14
- // so the receipt is durable even if the host tears the transcript down
15
- // before painting the message.
16
- //
17
- // Fail-open.
18
- // =============================================================================
19
-
20
- import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync } from 'fs';
21
- import { join } from 'path';
22
- import { homedir } from 'os';
23
- import { request } from 'http';
24
-
25
- process.on('uncaughtException', (err) => {
26
- process.stderr.write(`[sessionend-distill] fatal: ${err.message}\n`);
27
- emit();
28
- process.exit(0);
29
- });
30
-
31
- const MEMORY_DIR = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
32
-
33
- function emit(systemMessage) {
34
- const payload = systemMessage ? { systemMessage } : {};
35
- process.stdout.write(JSON.stringify(payload) + '\n');
36
- }
37
-
38
- function appendBreadcrumb(line) {
39
- try {
40
- const dir = join(MEMORY_DIR, 'sessions');
41
- mkdirSync(dir, { recursive: true });
42
- const file = join(dir, 'index.md');
43
- const header = existsSync(file) ? '' : '# Session flushes\n';
44
- appendFileSync(file, header + line + '\n', 'utf8');
45
- } catch {
46
- // ignore — breadcrumb is best-effort
47
- }
48
- }
49
-
50
- // Best-effort POST to the agent-knowledge dashboard so a live toast appears
51
- // in the UI when the session ends. Silently drops on any failure (dashboard
52
- // not running, network error, timeout) — the disk receipts are authoritative.
53
- function postDashboardEvent(kind, message) {
54
- return new Promise((resolve) => {
55
- if (process.env.AGENT_KNOWLEDGE_DASHBOARD_EVENTS === '0') {
56
- resolve();
57
- return;
58
- }
59
- const port = Number(process.env.AGENT_KNOWLEDGE_PORT || 3423);
60
- if (!Number.isFinite(port) || port <= 0 || port > 65535) {
61
- resolve();
62
- return;
63
- }
64
- const payload = JSON.stringify({ kind, message });
65
- const req = request(
66
- {
67
- host: '127.0.0.1',
68
- port,
69
- path: '/api/events',
70
- method: 'POST',
71
- headers: {
72
- 'Content-Type': 'application/json',
73
- 'Content-Length': Buffer.byteLength(payload),
74
- },
75
- timeout: 1500,
76
- },
77
- (res) => {
78
- res.on('data', () => {});
79
- res.on('end', resolve);
80
- },
81
- );
82
- req.on('timeout', () => {
83
- req.destroy();
84
- resolve();
85
- });
86
- req.on('error', () => resolve());
87
- req.write(payload);
88
- req.end();
89
- });
90
- }
91
-
92
- async function main() {
93
- let input = '';
94
- for await (const chunk of process.stdin) input += chunk;
95
-
96
- let hookData = {};
97
- try {
98
- hookData = JSON.parse(input);
99
- } catch {
100
- // ignore
101
- }
102
-
103
- const transcriptPath = hookData?.transcript_path;
104
- const sessionId = hookData?.session_id || 'unknown';
105
- const cwd = hookData?.workspace?.current_dir || process.cwd();
106
-
107
- if (!transcriptPath || !existsSync(transcriptPath)) {
108
- emit('knowledge: SessionEnd skipped — transcript unavailable');
109
- return;
110
- }
111
-
112
- let raw = '';
113
- try {
114
- raw = readFileSync(transcriptPath, 'utf8');
115
- } catch {
116
- // ignore
117
- }
118
-
119
- const lines = raw.split(/\r?\n/).filter(Boolean);
120
- let userTurns = 0;
121
- let assistantTurns = 0;
122
- let toolUses = 0;
123
- const userMsgs = [];
124
- for (const line of lines) {
125
- try {
126
- const obj = JSON.parse(line);
127
- if (obj?.type === 'user') {
128
- userTurns++;
129
- if (typeof obj.message?.content === 'string') {
130
- userMsgs.push(obj.message.content.slice(0, 300));
131
- }
132
- } else if (obj?.type === 'assistant') {
133
- assistantTurns++;
134
- const content = obj.message?.content;
135
- if (Array.isArray(content)) {
136
- toolUses += content.filter((c) => c.type === 'tool_use').length;
137
- }
138
- }
139
- } catch {
140
- // ignore non-JSON lines
141
- }
142
- }
143
-
144
- const memDir = join(MEMORY_DIR, 'projects');
145
- try {
146
- mkdirSync(memDir, { recursive: true });
147
- } catch {
148
- // ignore
149
- }
150
-
151
- const slug = cwd.replace(/[^a-zA-Z0-9]+/g, '-').slice(0, 64);
152
- const file = join(memDir, `session-${slug}-${sessionId.slice(0, 8)}.md`);
153
- const endedAt = new Date().toISOString();
154
- const body = `---
155
- type: session-end
156
- session: ${sessionId}
157
- cwd: ${cwd}
158
- ended: ${endedAt}
159
- turns: ${userTurns}u/${assistantTurns}a
160
- tool_uses: ${toolUses}
161
- ---
162
-
163
- # Session ${sessionId.slice(0, 8)}
164
-
165
- **cwd**: ${cwd}
166
- **Turns**: ${userTurns} user / ${assistantTurns} assistant
167
- **Tool uses**: ${toolUses}
168
-
169
- ## User prompts (first 20)
170
-
171
- ${userMsgs
172
- .slice(0, 20)
173
- .map((m, i) => `${i + 1}. ${m}`)
174
- .join('\n')}
175
- `;
176
-
177
- let wrote = false;
178
- try {
179
- writeFileSync(file, body, 'utf8');
180
- wrote = true;
181
- } catch (err) {
182
- process.stderr.write(`[sessionend-distill] write failed: ${err?.message || err}\n`);
183
- }
184
-
185
- if (wrote) {
186
- appendBreadcrumb(`- SessionEnd ${endedAt} ${sessionId} → ${file}`);
187
- const receipt = `${userTurns}u/${assistantTurns}a turns, ${toolUses} tool uses → ${file}`;
188
- await postDashboardEvent('session-end', receipt);
189
- emit(`knowledge: SessionEnd — ${receipt}`);
190
- } else {
191
- emit(`knowledge: SessionEnd — write failed for ${file}`);
192
- }
193
- }
194
-
195
- main().catch((err) => {
196
- process.stderr.write(`[sessionend-distill] ${err.message}\n`);
197
- emit('knowledge: SessionEnd — hook crashed (fail-open)');
198
- });