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.
- package/CHANGELOG.md +82 -0
- package/README.md +53 -52
- package/dist/events.d.ts +16 -0
- package/dist/events.d.ts.map +1 -0
- package/dist/events.js +31 -0
- package/dist/events.js.map +1 -0
- package/dist/index.js +31 -13
- package/dist/index.js.map +1 -1
- package/dist/knowledge/analyze.d.ts.map +1 -1
- package/dist/knowledge/analyze.js +18 -11
- package/dist/knowledge/analyze.js.map +1 -1
- package/dist/knowledge/consolidate.d.ts +2 -2
- package/dist/knowledge/consolidate.js +2 -2
- package/dist/knowledge/distill.d.ts.map +1 -1
- package/dist/knowledge/distill.js +28 -16
- package/dist/knowledge/distill.js.map +1 -1
- package/dist/knowledge/freshness.js +1 -1
- package/dist/knowledge/freshness.js.map +1 -1
- package/dist/knowledge/git.d.ts +3 -4
- package/dist/knowledge/git.d.ts.map +1 -1
- package/dist/knowledge/git.js +62 -49
- package/dist/knowledge/git.js.map +1 -1
- package/dist/knowledge/graph.d.ts +2 -0
- package/dist/knowledge/graph.d.ts.map +1 -1
- package/dist/knowledge/graph.js +8 -0
- package/dist/knowledge/graph.js.map +1 -1
- package/dist/knowledge/ingest-freshness.d.ts +22 -0
- package/dist/knowledge/ingest-freshness.d.ts.map +1 -0
- package/dist/knowledge/ingest-freshness.js +93 -0
- package/dist/knowledge/ingest-freshness.js.map +1 -0
- package/dist/knowledge/promote.js +1 -1
- package/dist/knowledge/promote.js.map +1 -1
- package/dist/knowledge/reflect.js +2 -2
- package/dist/knowledge/reflect.js.map +1 -1
- package/dist/knowledge/remove.d.ts +11 -0
- package/dist/knowledge/remove.d.ts.map +1 -0
- package/dist/knowledge/remove.js +24 -0
- package/dist/knowledge/remove.js.map +1 -0
- package/dist/knowledge/search.d.ts +76 -4
- package/dist/knowledge/search.d.ts.map +1 -1
- package/dist/knowledge/search.js +364 -37
- package/dist/knowledge/search.js.map +1 -1
- package/dist/knowledge/similar.d.ts +7 -0
- package/dist/knowledge/similar.d.ts.map +1 -0
- package/dist/knowledge/similar.js +51 -0
- package/dist/knowledge/similar.js.map +1 -0
- package/dist/knowledge/store.d.ts +20 -1
- package/dist/knowledge/store.d.ts.map +1 -1
- package/dist/knowledge/store.js +119 -84
- package/dist/knowledge/store.js.map +1 -1
- package/dist/lib.d.ts +1 -1
- package/dist/lib.d.ts.map +1 -1
- package/dist/lib.js.map +1 -1
- package/dist/package-meta.d.ts +4 -1
- package/dist/package-meta.d.ts.map +1 -1
- package/dist/package-meta.js +18 -9
- package/dist/package-meta.js.map +1 -1
- package/dist/rest-server.d.ts +31 -0
- package/dist/rest-server.d.ts.map +1 -0
- package/dist/rest-server.js +142 -0
- package/dist/rest-server.js.map +1 -0
- package/dist/search/bm25.d.ts +8 -0
- package/dist/search/bm25.d.ts.map +1 -1
- package/dist/search/bm25.js +32 -20
- package/dist/search/bm25.js.map +1 -1
- package/dist/search/excerpt.d.ts +1 -1
- package/dist/search/excerpt.d.ts.map +1 -1
- package/dist/search/excerpt.js +19 -1
- package/dist/search/excerpt.js.map +1 -1
- package/dist/search/lexicon.d.ts +37 -0
- package/dist/search/lexicon.d.ts.map +1 -0
- package/dist/search/lexicon.js +83 -0
- package/dist/search/lexicon.js.map +1 -0
- package/dist/search/mmr.d.ts +9 -3
- package/dist/search/mmr.d.ts.map +1 -1
- package/dist/search/mmr.js +21 -7
- package/dist/search/mmr.js.map +1 -1
- package/dist/search/types.d.ts +2 -0
- package/dist/search/types.d.ts.map +1 -1
- package/dist/server.d.ts +1 -5
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +1 -13
- package/dist/server.js.map +1 -1
- package/dist/sessions/human.d.ts +12 -0
- package/dist/sessions/human.d.ts.map +1 -0
- package/dist/sessions/human.js +52 -0
- package/dist/sessions/human.js.map +1 -0
- package/dist/sessions/indexer.d.ts +4 -0
- package/dist/sessions/indexer.d.ts.map +1 -1
- package/dist/sessions/indexer.js +6 -1
- package/dist/sessions/indexer.js.map +1 -1
- package/dist/sessions/parser.d.ts +39 -0
- package/dist/sessions/parser.d.ts.map +1 -1
- package/dist/sessions/parser.js +169 -15
- package/dist/sessions/parser.js.map +1 -1
- package/dist/sessions/search.d.ts +2 -0
- package/dist/sessions/search.d.ts.map +1 -1
- package/dist/sessions/search.js +147 -67
- package/dist/sessions/search.js.map +1 -1
- package/dist/sessions/snapshot.d.ts +19 -0
- package/dist/sessions/snapshot.d.ts.map +1 -0
- package/dist/sessions/snapshot.js +118 -0
- package/dist/sessions/snapshot.js.map +1 -0
- package/dist/sessions/summary.d.ts +24 -5
- package/dist/sessions/summary.d.ts.map +1 -1
- package/dist/sessions/summary.js +122 -146
- package/dist/sessions/summary.js.map +1 -1
- package/dist/slice.d.ts +5 -0
- package/dist/slice.d.ts.map +1 -0
- package/dist/slice.js +28 -0
- package/dist/slice.js.map +1 -0
- package/dist/text.d.ts +9 -0
- package/dist/text.d.ts.map +1 -0
- package/dist/text.js +16 -0
- package/dist/text.js.map +1 -0
- package/dist/tool-handlers.d.ts.map +1 -1
- package/dist/tool-handlers.js +6 -10
- package/dist/tool-handlers.js.map +1 -1
- package/dist/transport/guard.d.ts +5 -0
- package/dist/transport/guard.d.ts.map +1 -0
- package/dist/transport/guard.js +51 -0
- package/dist/transport/guard.js.map +1 -0
- package/dist/transport/http.d.ts +17 -0
- package/dist/transport/http.d.ts.map +1 -0
- package/dist/transport/http.js +97 -0
- package/dist/transport/http.js.map +1 -0
- package/dist/transport/rest.d.ts +4 -0
- package/dist/transport/rest.d.ts.map +1 -0
- package/dist/transport/rest.js +424 -0
- package/dist/transport/rest.js.map +1 -0
- package/dist/vectorstore/store.d.ts +9 -0
- package/dist/vectorstore/store.d.ts.map +1 -1
- package/dist/vectorstore/store.js +23 -0
- package/dist/vectorstore/store.js.map +1 -1
- package/dist/wakeup.d.ts +5 -0
- package/dist/wakeup.d.ts.map +1 -1
- package/dist/wakeup.js +10 -1
- package/dist/wakeup.js.map +1 -1
- package/docs/ARCHITECTURE.md +25 -39
- package/docs/HOOKS.md +138 -237
- package/docs/INGEST.md +1 -1
- package/docs/SETUP.md +87 -143
- package/docs/USER-MANUAL.md +169 -100
- package/package.json +20 -17
- package/{skills → plugin/skills}/knowledge-ingest/SKILL.md +1 -1
- package/{skills → plugin/skills}/knowledge-ingest/scripts/validate.mjs +2 -2
- package/scripts/plugins/opencode/agent-knowledge.ts +37 -86
- package/scripts/setup.js +80 -146
- package/scripts/source-walk.d.mts +12 -0
- package/scripts/source-walk.mjs +94 -0
- package/scripts/tree-sitter-extract.mjs +10 -76
- package/.claude-plugin/marketplace.json +0 -19
- package/.claude-plugin/plugin.json +0 -12
- package/.mcp.json +0 -8
- package/agent-desk-plugin.json +0 -20
- package/dist/dashboard.d.ts +0 -5
- package/dist/dashboard.d.ts.map +0 -1
- package/dist/dashboard.js +0 -666
- package/dist/dashboard.js.map +0 -1
- package/dist/ui/app.js +0 -1013
- package/dist/ui/index.html +0 -460
- package/dist/ui/morphdom.min.js +0 -1
- package/dist/ui/render-graph.js +0 -482
- package/dist/ui/render-knowledge.js +0 -288
- package/dist/ui/render-panel.js +0 -475
- package/dist/ui/render-search.js +0 -105
- package/dist/ui/render-sessions.js +0 -237
- package/dist/ui/styles.css +0 -2322
- package/dist/ui/template.js +0 -173
- package/dist/ui/ui-utils.js +0 -217
- package/dist/ui/vis-network.min.js +0 -34
- package/docs/DASHBOARD.md +0 -191
- package/scripts/copy-ui.js +0 -14
- package/scripts/hooks/first-prompt-inject.mjs +0 -242
- package/scripts/hooks/precompact-distill.mjs +0 -105
- package/scripts/hooks/precompact-flush.mjs +0 -192
- package/scripts/hooks/session-start-ingest.mjs +0 -238
- package/scripts/hooks/session-start.js +0 -212
- 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
|
-
});
|