agent-knowledge 1.8.1 → 1.9.1
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/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +47 -0
- package/README.md +66 -21
- package/agent-desk-plugin.json +1 -1
- package/dist/embeddings/factory.js +1 -1
- package/dist/embeddings/factory.js.map +1 -1
- package/dist/embeddings/local.js +1 -1
- package/dist/embeddings/local.js.map +1 -1
- package/dist/embeddings/types.d.ts.map +1 -1
- package/dist/embeddings/types.js +8 -6
- package/dist/embeddings/types.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +11 -9
- package/dist/types.js.map +1 -1
- package/docs/ARCHITECTURE.md +15 -3
- package/docs/DASHBOARD.md +6 -0
- package/docs/SETUP.md +38 -38
- package/docs/USER-MANUAL.md +20 -20
- package/docs/hooks.md +7 -7
- package/package.json +1 -1
- package/scripts/hooks/first-prompt-inject.mjs +3 -3
- package/scripts/hooks/precompact-distill.mjs +1 -1
- package/scripts/hooks/precompact-flush.mjs +1 -1
- package/scripts/hooks/sessionend-distill.mjs +1 -1
- package/scripts/setup.js +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
3
|
"description": "Cross-session memory for AI coding agents. Git-synced Markdown knowledge base with hybrid semantic + TF-IDF search, typed knowledge graph, and session auto-distillation with secrets scrubbing.",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.9.1",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "keshrath"
|
|
7
7
|
},
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,52 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.9.1 (2026-04-18) — freshness test flake fix
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- **`tests/freshness.test.ts` "default-path coverage" no longer times out under full-suite I/O pressure.** Previously ran with `sinceDays: 30`, which made the real `listSessions()` + `getSessionSummary()` path iterate every recent session JSONL on the developer's box — on a heavy-corpus machine this hit the 10s timeout when other test files were contending for I/O. Tightened to `sinceDays: 1` (the test pins "default branch returns an array without throwing" — the window size was incidental) and bumped the per-test timeout to 15s for headroom. Full suite now 558/558 green, stable across repeated runs. The failure had silently shipped through v1.8.1 and v1.9.0 labelled "pre-existing flake"; that was wrong and won't recur.
|
|
8
|
+
|
|
9
|
+
### Tests
|
|
10
|
+
|
|
11
|
+
558/558 passing (was 557/558 with the flake counted as pass). No behaviour changes, no source changes outside `tests/`.
|
|
12
|
+
|
|
13
|
+
## 1.9.0 (2026-04-18) — env var naming cleanup (**breaking**)
|
|
14
|
+
|
|
15
|
+
Every env var is now under the canonical `AGENT_KNOWLEDGE_*` prefix per the repo-wide Genericity rule (`AGENT_<NAME>_<RESOURCE>`). The old `KNOWLEDGE_*` prefix and the unscoped `EXTRA_SESSION_ROOTS` are gone — no deprecation shim, no startup warning, just renamed. README and docs table rewritten so no host name (`Claude Code`, `~/.claude`) leaks into descriptions — the adapter registry already auto-detects `.claude`, `.cursor`, `.codex`, `.aider`, `.continue`, and OpenCode without configuration.
|
|
16
|
+
|
|
17
|
+
### Breaking changes
|
|
18
|
+
|
|
19
|
+
All renames are mechanical — rename the env var, nothing else:
|
|
20
|
+
|
|
21
|
+
| Old | New |
|
|
22
|
+
| ---------------------------------- | ---------------------------------------- |
|
|
23
|
+
| `KNOWLEDGE_MEMORY_DIR` | `AGENT_KNOWLEDGE_MEMORY_DIR` |
|
|
24
|
+
| `KNOWLEDGE_DATA_DIR` | `AGENT_KNOWLEDGE_DATA_DIR` |
|
|
25
|
+
| `KNOWLEDGE_GIT_URL` | `AGENT_KNOWLEDGE_GIT_URL` |
|
|
26
|
+
| `KNOWLEDGE_AUTO_DISTILL` | `AGENT_KNOWLEDGE_AUTO_DISTILL` |
|
|
27
|
+
| `KNOWLEDGE_INDEX_VERBATIM` | `AGENT_KNOWLEDGE_INDEX_VERBATIM` |
|
|
28
|
+
| `KNOWLEDGE_PORT` | `AGENT_KNOWLEDGE_PORT` |
|
|
29
|
+
| `KNOWLEDGE_EMBEDDING_PROVIDER` | `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` |
|
|
30
|
+
| `KNOWLEDGE_EMBEDDING_ALPHA` | `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` |
|
|
31
|
+
| `KNOWLEDGE_EMBEDDING_MODEL` | `AGENT_KNOWLEDGE_EMBEDDING_MODEL` |
|
|
32
|
+
| `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` |
|
|
33
|
+
| `KNOWLEDGE_EMBEDDING_THREADS` | `AGENT_KNOWLEDGE_EMBEDDING_THREADS` |
|
|
34
|
+
| `KNOWLEDGE_OPENAI_API_KEY` | `AGENT_KNOWLEDGE_OPENAI_API_KEY` |
|
|
35
|
+
| `KNOWLEDGE_ANTHROPIC_API_KEY` | `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` |
|
|
36
|
+
| `KNOWLEDGE_GEMINI_API_KEY` | `AGENT_KNOWLEDGE_GEMINI_API_KEY` |
|
|
37
|
+
| `EXTRA_SESSION_ROOTS` | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` |
|
|
38
|
+
|
|
39
|
+
Standard third-party keys still work as fallbacks when the scoped form is unset: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`. `OPENCODE_DATA_DIR` (OpenCode's own env) is unchanged — our adapter honors it as-is.
|
|
40
|
+
|
|
41
|
+
### Documented
|
|
42
|
+
|
|
43
|
+
- `AGENT_KNOWLEDGE_INDEX_VERBATIM`, `AGENT_KNOWLEDGE_EMBEDDING_THREADS`, `AGENT_KNOWLEDGE_EMBEDDING_MODEL` — existed but were missing from the README table.
|
|
44
|
+
- `AGENT_KNOWLEDGE_AUTOWAKE`, `AGENT_KNOWLEDGE_WAKEUP_BUDGET`, `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT`, `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET`, `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS`, `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` — hook env vars were in `docs/hooks.md` but not surfaced in the main README table. Fixed.
|
|
45
|
+
|
|
46
|
+
### Fixed
|
|
47
|
+
|
|
48
|
+
- README `AGENT_KNOWLEDGE_DATA_DIR` description no longer says "Claude Code JSONL files" — the adapter registry is multi-host by design and the description now reflects that.
|
|
49
|
+
|
|
3
50
|
## 1.8.1 (2026-04-18) — staleness signal + search-gap log + section-priority context + dashboard polish + access-tracking measurement fix
|
|
4
51
|
|
|
5
52
|
Additive upgrades. Response shapes gain new optional fields (`freshness` on search hits, `evergreen`/`author`/`last_accessed` on `GET /api/knowledge` rows, three new fields on `StalenessSignal`) but no existing fields were removed or reshaped — strict consumers relying on unknown-field tolerance are unaffected. Every new behaviour is automatic or additive — no agent-proactive action required.
|
package/README.md
CHANGED
|
@@ -36,32 +36,37 @@ Sessions from all major AI coding assistants are auto-discovered -- if a tool is
|
|
|
36
36
|
|
|
37
37
|
| Tool | Format | Auto-detected path |
|
|
38
38
|
| ---------------- | -------------- | --------------------------------------------------------------- |
|
|
39
|
-
| **Claude Code** | JSONL |
|
|
39
|
+
| **Claude Code** | JSONL | `~/.claude/projects/` |
|
|
40
40
|
| **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` |
|
|
41
|
-
| **
|
|
42
|
-
| **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` |
|
|
43
|
-
| **Continue.dev** | JSON | `~/.continue/sessions/` |
|
|
41
|
+
| **Codex CLI** | JSONL | `~/.codex/projects/` |
|
|
44
42
|
| **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs |
|
|
43
|
+
| **Continue.dev** | JSON | `~/.continue/projects/` |
|
|
44
|
+
| **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` |
|
|
45
|
+
| **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` (or `$OPENCODE_DATA_DIR`) |
|
|
45
46
|
|
|
46
|
-
No configuration needed. Additional session roots can be added via the `
|
|
47
|
+
No configuration needed. Additional session roots can be added via the `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` env var (comma-separated paths).
|
|
47
48
|
|
|
48
49
|
## Features
|
|
49
50
|
|
|
50
|
-
- **
|
|
51
|
+
- **Host-agnostic session search** -- unified search across every major AI coding assistant (Claude Code, Cursor, Codex CLI, Aider, Continue.dev, Cline, OpenCode). No host name is baked into configuration — the adapter registry probes installed host roots at startup.
|
|
51
52
|
- **Hybrid search** -- semantic vector similarity blended with TF-IDF keyword ranking
|
|
52
53
|
- **Git-synced knowledge base** -- markdown vault with YAML frontmatter, auto commit and push on writes
|
|
54
|
+
- **Automatic staleness detection (v1.8.1)** -- `knowledge_analyze(action: "stale_by_code_activity")` cross-references file paths mentioned in each entry body against `filesModified` in recent session summaries. Pairs with a symbol-presence precision layer: identifiers the entry quotes (inline backticks + fenced blocks) are checked in the touched file; if they still exist, confidence downweights ×0.3. Entries with `evergreen: true` are exempt.
|
|
55
|
+
- **Search-gap tracking (v1.8.1)** -- `knowledge_analyze(action: "search_gaps")` surfaces zero-result queries over the last `since_days`, grouped by token-Jaccard similarity. The clearest signal for "what entries should I write next?".
|
|
56
|
+
- **Section-priority context packer (v1.8.1)** -- `knowledge(action: "wakeup")` assembles a multi-section bundle (`identity` → `active_tasks` → `recent_decisions` → `known_gotchas` → `last_session_summary` → `top_weighted` → `semantic_fallback`) within a token budget. Unused section budget redistributes to later sections.
|
|
53
57
|
- **Scored + gated promoter (v1.8)** -- session insights promoted via a 6-signal weighted scorer with three independent gates (`minScore`, `minRecallCount`, `minUniqueQueries`). Runs automatically in background, on demand via `knowledge_admin(action: "promote")`, or benchable offline via `npm run bench:promote`. Emits an auditable `.dreams/YYYY-MM-DD.md` diary every run. Replaces the regex-only distiller.
|
|
54
58
|
- **Pluggable adapter system** -- add support for new tools by implementing the `SessionAdapter` interface
|
|
55
59
|
- **Embeddings** -- local (Hugging Face), OpenAI, Claude/Voyage, or Gemini providers
|
|
56
60
|
- **Fuzzy matching** -- typo-tolerant search using Levenshtein distance
|
|
57
61
|
- **6 search scopes** -- errors, plans, configs, tools, files, decisions
|
|
58
62
|
- **6 MCP tools** -- consolidated action-based interface (`knowledge`, `knowledge_search`, `knowledge_session`, `knowledge_graph`, `knowledge_analyze`, `knowledge_admin`)
|
|
59
|
-
- **
|
|
63
|
+
- **Evergreen entries (v1.8)** -- `evergreen: true` in frontmatter exempts an entry from decay in ranking AND makes it append-only under promotion. Dashboard renders a push-pin badge on these cards.
|
|
64
|
+
- **Author attribution (v1.8.1)** -- optional `author: <string>` frontmatter surfaces as a muted chip on each card.
|
|
60
65
|
- **Code graph resolution** -- `calls`, `imports`, `inherits` edge types for code structure; directed BFS traversal (`outbound`/`inbound`/`both`); `bulk_link` for efficient ingestion; `unlink_by_origin` for clearing stale code edges before re-ingest; `code:` prefixed node IDs distinguish code from knowledge
|
|
61
66
|
- **Temporal knowledge graph** -- edges support `valid_from` / `valid_to` validity windows; `as_of` queries return point-in-time snapshots; `invalidate` action marks facts as ended without deleting them
|
|
62
67
|
- **Hybrid scoring boosts** -- proper-noun and temporal-proximity boosts on top of TF-IDF + semantic blend, capped at +66.7%, short-circuit when no signals are present
|
|
63
68
|
- **Category as boost (not filter)** -- opt into `category_mode: "boost"` so a wrong category guess down-ranks instead of discarding the right answer
|
|
64
|
-
- **Verbatim session indexing** -- per-message chunks (≥30 chars) embedded into the vector store so raw conversation is retrievable; toggle with `
|
|
69
|
+
- **Verbatim session indexing** -- per-message chunks (≥30 chars) embedded into the vector store so raw conversation is retrievable; toggle with `AGENT_KNOWLEDGE_INDEX_VERBATIM=false`
|
|
65
70
|
- **Configurable git URL** -- `knowledge_admin(action: "config")` for runtime setup, persisted at XDG/AppData location
|
|
66
71
|
- **Cross-machine persistence** -- knowledge syncs via git, sessions read from local storage of each tool
|
|
67
72
|
- **Real-time dashboard** -- browse, search, and manage at `localhost:3423`
|
|
@@ -76,6 +81,9 @@ No configuration needed. Additional session roots can be added via the `EXTRA_SE
|
|
|
76
81
|
- **Knowledge brief** — `knowledge_analyze(action: "brief")` returns a cached ~200 token summary (core concepts, active projects, recent decisions, stale and gap counts) for session-start orientation
|
|
77
82
|
- **Edge provenance** — graph edges track `origin` (manual, auto-link, distill, reflect) so analysis can distinguish user judgment from automated heuristics
|
|
78
83
|
- **Deterministic pre-extraction in distillation** — session summaries now include git commits, error patterns, URLs accessed, and packages changed extracted via regex from bash/tool output (no LLM cost)
|
|
84
|
+
- **Freshness metadata on every search hit (v1.8.1)** — every knowledge result carries `freshness: { body_age_days, last_accessed, access_count, verified_at, verification_age_days, evergreen }`. Agent reads the trust signal and decides; we impose no policy demotion.
|
|
85
|
+
- **Per-category decay windows (v1.8.1)** — the "Unused" filter and bytype chart honor per-category thresholds (projects 180d, people 365d, decisions 90d, workflows 60d, notes 30d) so identity-shaped content doesn't look stale just because it isn't re-read weekly.
|
|
86
|
+
- **Lifecycle hooks** — `SessionStart` auto-wakeup, `UserPromptSubmit` first-prompt targeted injection, `PreCompact` memory-flush nudge. Every hook is fail-open and toggleable via an `AGENT_KNOWLEDGE_*` env var.
|
|
79
87
|
|
|
80
88
|
## Codebase Ingestion
|
|
81
89
|
|
|
@@ -381,19 +389,56 @@ npm run lint # Type-check (tsc --noEmit)
|
|
|
381
389
|
|
|
382
390
|
## Environment Variables
|
|
383
391
|
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
|
389
|
-
|
|
|
390
|
-
| `
|
|
391
|
-
| `
|
|
392
|
-
| `
|
|
393
|
-
| `
|
|
394
|
-
| `
|
|
395
|
-
| `
|
|
396
|
-
| `
|
|
392
|
+
All env vars live under the `AGENT_KNOWLEDGE_*` prefix. No host name is baked in — the adapter registry auto-detects installed AI coding hosts (`.claude`, `.cursor`, `.codex`, `.aider`, `.continue`, OpenCode) without configuration.
|
|
393
|
+
|
|
394
|
+
### Core
|
|
395
|
+
|
|
396
|
+
| Variable | Default | Description |
|
|
397
|
+
| ------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
398
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Git-synced knowledge base directory |
|
|
399
|
+
| `AGENT_KNOWLEDGE_GIT_URL` | -- | Git remote URL (auto-clones if dir missing) |
|
|
400
|
+
| `AGENT_KNOWLEDGE_AUTO_DISTILL` | `true` | Auto-distill session insights into the knowledge base |
|
|
401
|
+
| `AGENT_KNOWLEDGE_INDEX_VERBATIM` | `true` | Index raw session message chunks into the vector store so conversation is retrievable later. Set `false` to save disk at scale. |
|
|
402
|
+
| `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override the primary host data root. Leave unset in the common case — adapters auto-detect every well-known host root under `~/`. |
|
|
403
|
+
| `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | -- | Extra session directories, comma-separated. Added to whatever auto-detection finds. |
|
|
404
|
+
| `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
|
|
405
|
+
|
|
406
|
+
### Embeddings
|
|
407
|
+
|
|
408
|
+
| Variable | Default | Description |
|
|
409
|
+
| ---------------------------------------- | ------- | ------------------------------------------------------------------------ |
|
|
410
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | `local` \| `openai` \| `claude` \| `gemini` |
|
|
411
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` | `0.3` | TF-IDF vs semantic blend weight (`0` = pure semantic, `1` = pure TF-IDF) |
|
|
412
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_MODEL` | -- | Override provider default model |
|
|
413
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | `60` | Seconds before unloading the local model (`0` = keep loaded) |
|
|
414
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_THREADS` | (auto) | ONNX / OMP thread count for the local provider |
|
|
415
|
+
|
|
416
|
+
### API keys
|
|
417
|
+
|
|
418
|
+
Project-scoped overrides win over the standard keys. Set either; the scoped form lets you run agent-knowledge with a different key than the rest of your environment.
|
|
419
|
+
|
|
420
|
+
| Variable | Fallback | Description |
|
|
421
|
+
| ----------------------------------- | ------------------- | -------------------------- |
|
|
422
|
+
| `AGENT_KNOWLEDGE_OPENAI_API_KEY` | `OPENAI_API_KEY` | OpenAI embeddings |
|
|
423
|
+
| `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` | `ANTHROPIC_API_KEY` | Claude / Voyage embeddings |
|
|
424
|
+
| `AGENT_KNOWLEDGE_GEMINI_API_KEY` | `GEMINI_API_KEY` | Gemini embeddings |
|
|
425
|
+
|
|
426
|
+
### Hooks (v1.8 lifecycle integration)
|
|
427
|
+
|
|
428
|
+
| Variable | Default | Description |
|
|
429
|
+
| -------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
430
|
+
| `AGENT_KNOWLEDGE_AUTOWAKE` | `1` | Auto-inject a `knowledge(action: wakeup)` bundle into `SessionStart`. Set `0` to disable. |
|
|
431
|
+
| `AGENT_KNOWLEDGE_WAKEUP_BUDGET` | `800` | Tokens for the wakeup bundle |
|
|
432
|
+
| `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT` | `1` | Run a targeted `knowledge_search` on the first user prompt and inject top hits. `0` / `false` / `off` to disable. |
|
|
433
|
+
| `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET` | `600` | Tokens for first-prompt injection (clamp `[100, 8000]`) |
|
|
434
|
+
| `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS` | `4` | Max knowledge hits attached to the first prompt (clamp `[1, 20]`) |
|
|
435
|
+
| `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` | `1` | Before pre-compaction, nudge the agent to save context via `knowledge(action: write)`. `0` disables the nudge; `off` suppresses both nudge and disk dump. |
|
|
436
|
+
|
|
437
|
+
### External tool overrides
|
|
438
|
+
|
|
439
|
+
| Variable | Default | Description |
|
|
440
|
+
| ------------------- | ------------------------- | --------------------------------------------------------------------------------------- |
|
|
441
|
+
| `OPENCODE_DATA_DIR` | `~/.local/share/opencode` | Override where OpenCode's session DB lives (OpenCode's own env, honored by our adapter) |
|
|
397
442
|
|
|
398
443
|
## Documentation
|
|
399
444
|
|
package/agent-desk-plugin.json
CHANGED
|
@@ -17,7 +17,7 @@ async function createProvider(cfg) {
|
|
|
17
17
|
switch (cfg.provider) {
|
|
18
18
|
case 'local': {
|
|
19
19
|
const { LocalEmbeddingProvider } = await import('./local.js');
|
|
20
|
-
const idleEnv = process.env.
|
|
20
|
+
const idleEnv = process.env.AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT;
|
|
21
21
|
const idleTimeoutMs = idleEnv !== undefined ? parseInt(idleEnv, 10) * 1000 : 60_000;
|
|
22
22
|
const provider = new LocalEmbeddingProvider(cfg.modelOverride, undefined, idleTimeoutMs);
|
|
23
23
|
if (await provider.isAvailable())
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/embeddings/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,IAAI,SAAS,GAA6B,IAAI,CAAC;AAC/C,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAwB;IAExB,MAAM,GAAG,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAC;IAE3C,IAAI,SAAS,IAAI,iBAAiB,KAAK,GAAG,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEtE,SAAS,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,iBAAiB,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAoB;IAChD,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,
|
|
1
|
+
{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/embeddings/factory.ts"],"names":[],"mappings":"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"}
|
package/dist/embeddings/local.js
CHANGED
|
@@ -7,7 +7,7 @@ let _pipeline = null;
|
|
|
7
7
|
let _pipelineLoading = null;
|
|
8
8
|
let _idleTimer = null;
|
|
9
9
|
let _idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
|
|
10
|
-
const _numThreads = parseInt(process.env.
|
|
10
|
+
const _numThreads = parseInt(process.env.AGENT_KNOWLEDGE_EMBEDDING_THREADS ?? String(DEFAULT_NUM_THREADS), 10);
|
|
11
11
|
process.env.ONNX_NUM_THREADS = String(_numThreads);
|
|
12
12
|
process.env.OMP_NUM_THREADS = String(_numThreads);
|
|
13
13
|
async function loadPipeline(model) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAO9B,IAAI,SAAS,GAAsB,IAAI,CAAC;AACxC,IAAI,gBAAgB,GAAsC,IAAI,CAAC;AAC/D,IAAI,UAAU,GAAyC,IAAI,CAAC;AAC5D,IAAI,cAAc,GAAG,uBAAuB,CAAC;AAE7C,MAAM,WAAW,GAAG,QAAQ,CAC1B,OAAO,CAAC,GAAG,CAAC,
|
|
1
|
+
{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,eAAe,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,eAAe,CAWpD"}
|
package/dist/embeddings/types.js
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
/** Read embedding configuration from environment variables. */
|
|
2
2
|
export function getEmbeddingConfig() {
|
|
3
3
|
return {
|
|
4
|
-
provider: process.env.
|
|
5
|
-
alpha: parseFloat(process.env.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
4
|
+
provider: process.env.AGENT_KNOWLEDGE_EMBEDDING_PROVIDER || 'local',
|
|
5
|
+
alpha: parseFloat(process.env.AGENT_KNOWLEDGE_EMBEDDING_ALPHA || '0.3'),
|
|
6
|
+
// Project-scoped overrides for third-party keys win over the standard
|
|
7
|
+
// `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `GEMINI_API_KEY` fallbacks.
|
|
8
|
+
openaiApiKey: process.env.AGENT_KNOWLEDGE_OPENAI_API_KEY || process.env.OPENAI_API_KEY,
|
|
9
|
+
anthropicApiKey: process.env.AGENT_KNOWLEDGE_ANTHROPIC_API_KEY || process.env.ANTHROPIC_API_KEY,
|
|
10
|
+
geminiApiKey: process.env.AGENT_KNOWLEDGE_GEMINI_API_KEY || process.env.GEMINI_API_KEY,
|
|
11
|
+
modelOverride: process.env.AGENT_KNOWLEDGE_EMBEDDING_MODEL,
|
|
10
12
|
};
|
|
11
13
|
}
|
|
12
14
|
//# sourceMappingURL=types.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAuCA,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAuCA,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,kCAAmD,IAAI,OAAO;QACrF,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,KAAK,CAAC;QACvE,sEAAsE;QACtE,uEAAuE;QACvE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QACtF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC/F,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QACtF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,+BAA+B;KAC3D,CAAC;AACJ,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -3,7 +3,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
|
|
|
3
3
|
import { createServer } from './server.js';
|
|
4
4
|
import { startDashboard } from './dashboard.js';
|
|
5
5
|
async function main() {
|
|
6
|
-
const port = parseInt(process.env.
|
|
6
|
+
const port = parseInt(process.env.AGENT_KNOWLEDGE_PORT || '3423', 10);
|
|
7
7
|
let isLeader = false;
|
|
8
8
|
try {
|
|
9
9
|
await startDashboard(port);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAEtE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,IAAI,CAAC,CAAC;QAC9D,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,IAAI,yCAAyC,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CASrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgBtF;AAID,wBAAgB,SAAS,IAAI,eAAe,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CASrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgBtF;AAID,wBAAgB,SAAS,IAAI,eAAe,CAoE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}
|
package/dist/types.js
CHANGED
|
@@ -47,14 +47,16 @@ export function savePersistedConfig(updates) {
|
|
|
47
47
|
// ── Config resolution (env vars > persisted config > defaults) ──────────────
|
|
48
48
|
export function getConfig() {
|
|
49
49
|
const home = homedir();
|
|
50
|
-
//
|
|
51
|
-
|
|
50
|
+
// Primary host data root override — defaults to the platform config dir
|
|
51
|
+
// when unset. Most deployments leave it unset and rely on the adapter
|
|
52
|
+
// registry's multi-host auto-detection instead.
|
|
53
|
+
const dataDir = process.env.AGENT_KNOWLEDGE_DATA_DIR || getConfigDir();
|
|
52
54
|
const persisted = loadPersistedConfig();
|
|
53
|
-
const memoryDir = process.env.
|
|
55
|
+
const memoryDir = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || persisted.memoryDir || join(home, 'agent-knowledge');
|
|
54
56
|
const sessionsDir = join(dataDir, 'projects');
|
|
55
57
|
// Extra session roots: from env var (comma-separated) + auto-detected editors
|
|
56
58
|
const extraSessionRoots = [];
|
|
57
|
-
const envRoots = process.env.
|
|
59
|
+
const envRoots = process.env.AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS;
|
|
58
60
|
if (envRoots) {
|
|
59
61
|
for (const r of envRoots.split(',')) {
|
|
60
62
|
const trimmed = r.trim();
|
|
@@ -77,16 +79,16 @@ export function getConfig() {
|
|
|
77
79
|
extraSessionRoots.push(root);
|
|
78
80
|
}
|
|
79
81
|
}
|
|
80
|
-
const embeddingProvider = process.env.
|
|
82
|
+
const embeddingProvider = process.env.AGENT_KNOWLEDGE_EMBEDDING_PROVIDER ||
|
|
81
83
|
persisted.embeddingProvider ||
|
|
82
84
|
'local';
|
|
83
|
-
const embeddingAlpha = parseFloat(process.env.
|
|
84
|
-
const gitUrl = process.env.
|
|
85
|
-
const autoDistillEnv = process.env.
|
|
85
|
+
const embeddingAlpha = parseFloat(process.env.AGENT_KNOWLEDGE_EMBEDDING_ALPHA || String(persisted.embeddingAlpha ?? 0.3));
|
|
86
|
+
const gitUrl = process.env.AGENT_KNOWLEDGE_GIT_URL || persisted.gitUrl || undefined;
|
|
87
|
+
const autoDistillEnv = process.env.AGENT_KNOWLEDGE_AUTO_DISTILL;
|
|
86
88
|
const autoDistill = autoDistillEnv !== undefined
|
|
87
89
|
? autoDistillEnv.toLowerCase() !== 'false'
|
|
88
90
|
: (persisted.autoDistill ?? true);
|
|
89
|
-
const indexVerbatimEnv = process.env.
|
|
91
|
+
const indexVerbatimEnv = process.env.AGENT_KNOWLEDGE_INDEX_VERBATIM;
|
|
90
92
|
const indexVerbatim = indexVerbatimEnv !== undefined
|
|
91
93
|
? indexVerbatimEnv.toLowerCase() !== 'false'
|
|
92
94
|
: (persisted.indexVerbatim ?? true);
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA8BpD,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACnE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,OAAQ,MAAkC,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACL,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;IACD,aAAa,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,SAAS;IACvB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -230,7 +230,19 @@ finalScore = baseRelevance * 0.5^(daysSinceLastAccess / 90) * maturityMultiplier
|
|
|
230
230
|
| `established` | 5-19 | 1.0x |
|
|
231
231
|
| `proven` | 20+ | 1.5x |
|
|
232
232
|
|
|
233
|
-
Access count increments on `knowledge { action: "read" }
|
|
233
|
+
Access count increments on every path that actually feeds a knowledge entry into the agent's context: `knowledge { action: "read" }`, the session-start `wakeup` bundle (every entry packed in bumps access), and every `knowledge_search` hit on a knowledge entry. Sessions hits don't bump. Maturity transitions happen automatically when thresholds are crossed. Search results from `knowledge_search` apply the decay formula to blend relevance with freshness and confidence.
|
|
234
|
+
|
|
235
|
+
### freshness.ts (v1.8.1)
|
|
236
|
+
|
|
237
|
+
Automatic staleness detector. For each entry, extracts the file paths it mentions and cross-references them against `filesModified` in recent session summaries; an entry whose mentioned file was modified AFTER the entry's body mtime is a candidate.
|
|
238
|
+
|
|
239
|
+
Precision layer: extracts identifiers the entry quotes (inline backticks + fenced blocks, strict-identifier shape, ≥3 chars) and checks whether they still appear in the touched files. Confidence multiplies by `0.3` when every named symbol is still present (entry's concrete claims likely hold), linearly scales for partial matches, keeps full weight when all named symbols are missing. Entries that quote no verifiable identifiers fall through with `symbol_evidence: "not_applicable"`.
|
|
240
|
+
|
|
241
|
+
Entries with `evergreen: true` are exempt from the whole pass.
|
|
242
|
+
|
|
243
|
+
### query-log.ts (v1.8.1)
|
|
244
|
+
|
|
245
|
+
Lightweight `query_log` table inside `knowledge-scores.db`. Every `knowledge_search` call is logged with `{query, project, results_count, created_at}`; obvious-secret patterns (API keys, JWTs, bearer tokens, `.env`-style assignments) are scrubbed via `scrubContent` before insert. `knowledge_analyze(action: "search_gaps")` groups zero-result queries by token-Jaccard similarity (default `0.35`) and returns them ranked by frequency — the strongest signal for "what entries should I write next?".
|
|
234
246
|
|
|
235
247
|
## Memory Consolidation
|
|
236
248
|
|
|
@@ -295,9 +307,9 @@ The `edges` table has an additional `origin TEXT NOT NULL DEFAULT 'manual'` colu
|
|
|
295
307
|
|
|
296
308
|
Sessions are read from multiple AI coding tools through two mechanisms:
|
|
297
309
|
|
|
298
|
-
1. **Direct parsing** -- Claude Code
|
|
310
|
+
1. **Direct parsing** -- JSONL-based hosts (Claude Code, Cursor, Codex CLI, Continue.dev) are read directly by `parser.ts`. The adapter registry probes each known host root under `~/` (`.claude/projects/`, `.cursor/projects/`, `.codex/projects/`, `.aider/…`, `.continue/projects/`) and merges them into the session index. `AGENT_KNOWLEDGE_DATA_DIR` overrides the primary root; `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` adds more.
|
|
299
311
|
|
|
300
|
-
2. **Adapter dispatch** --
|
|
312
|
+
2. **Adapter dispatch** -- Tools with custom storage (OpenCode SQLite, Cline VS Code global storage, Aider markdown/JSONL hybrid) go through the pluggable adapter system in `adapters/`. When `parseSessionFile()` receives a virtual descriptor (e.g. `opencode://session:abc`), it dispatches to the matching adapter.
|
|
301
313
|
|
|
302
314
|
```
|
|
303
315
|
parseSessionFile(path)
|
package/docs/DASHBOARD.md
CHANGED
|
@@ -17,6 +17,8 @@ Card grid of knowledge entries. Each card shows:
|
|
|
17
17
|
|
|
18
18
|
- Category badge with color: projects (blue), people (purple), decisions (orange), workflows (green), notes (yellow)
|
|
19
19
|
- **Maturity badge**: candidate (gray), established (blue), proven (green) — based on access frequency
|
|
20
|
+
- **Pin badge** (Material Symbols `push_pin`) when the entry has `evergreen: true` frontmatter — these entries are exempt from decay in ranking and append-only under promotion.
|
|
21
|
+
- **Author chip** (muted, footer row) when the entry has `author: <string>` frontmatter — surfaces who wrote or owns it.
|
|
20
22
|
- Title and tag pills
|
|
21
23
|
- Last updated date
|
|
22
24
|
|
|
@@ -24,6 +26,10 @@ Card grid of knowledge entries. Each card shows:
|
|
|
24
26
|
|
|
25
27
|
Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes. Search bar for filtering entries by title.
|
|
26
28
|
|
|
29
|
+
**Unused filter chip** (top-right of the header): shows `Unused (N)` where `N` is the count of entries past their per-category staleness threshold. Click to filter the grid to just those entries; click again to clear. Auto-hides when the count is zero.
|
|
30
|
+
|
|
31
|
+
**By Type access chart** (between the tabs and the grid): a horizontal bar per canonical category, row-normalized so each bar fills its own track. Green share = accessed within the per-category recent window, orange = unused. Volume comparison via the right-side `accessed/unused` counts. Per-category thresholds: `projects` 180/365d, `people` 365/730d, `decisions` 90/180d, `workflows` 60/120d, `notes` 30/90d.
|
|
32
|
+
|
|
27
33
|
**Header action buttons:**
|
|
28
34
|
|
|
29
35
|
- **Duplicates** — scans all entries for near-duplicates using TF-IDF similarity. Entries in duplicate clusters get a warning icon on their card. Opens a side panel showing clusters with pairwise similarity scores. Click any entry in a cluster to view it.
|
package/docs/SETUP.md
CHANGED
|
@@ -75,7 +75,7 @@ This detects Claude Code, registers the MCP server in `~/.claude.json`, wires al
|
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
77
|
claude mcp add agent-knowledge -s user \
|
|
78
|
-
-e
|
|
78
|
+
-e AGENT_KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge" \
|
|
79
79
|
-- node /path/to/agent-knowledge/dist/index.js
|
|
80
80
|
```
|
|
81
81
|
|
|
@@ -110,8 +110,8 @@ claude mcp list
|
|
|
110
110
|
"type": "local",
|
|
111
111
|
"command": ["node", "/absolute/path/to/agent-knowledge/dist/index.js"],
|
|
112
112
|
"environment": {
|
|
113
|
-
"
|
|
114
|
-
"
|
|
113
|
+
"AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
|
|
114
|
+
"AGENT_KNOWLEDGE_PORT": "3423"
|
|
115
115
|
}
|
|
116
116
|
}
|
|
117
117
|
}
|
|
@@ -129,8 +129,8 @@ claude mcp list
|
|
|
129
129
|
"command": "node",
|
|
130
130
|
"args": ["/absolute/path/to/agent-knowledge/dist/index.js"],
|
|
131
131
|
"env": {
|
|
132
|
-
"
|
|
133
|
-
"
|
|
132
|
+
"AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
|
|
133
|
+
"AGENT_KNOWLEDGE_PORT": "3423"
|
|
134
134
|
}
|
|
135
135
|
}
|
|
136
136
|
}
|
|
@@ -148,8 +148,8 @@ claude mcp list
|
|
|
148
148
|
"command": "node",
|
|
149
149
|
"args": ["/absolute/path/to/agent-knowledge/dist/index.js"],
|
|
150
150
|
"env": {
|
|
151
|
-
"
|
|
152
|
-
"
|
|
151
|
+
"AGENT_KNOWLEDGE_MEMORY_DIR": "/home/you/agent-knowledge",
|
|
152
|
+
"AGENT_KNOWLEDGE_PORT": "3423"
|
|
153
153
|
}
|
|
154
154
|
}
|
|
155
155
|
}
|
|
@@ -419,34 +419,34 @@ Architecture notes, deployment info, etc.
|
|
|
419
419
|
|
|
420
420
|
## Environment Variables
|
|
421
421
|
|
|
422
|
-
| Variable
|
|
423
|
-
|
|
|
424
|
-
| `
|
|
425
|
-
| `
|
|
426
|
-
| `
|
|
427
|
-
| `OPENCODE_DATA_DIR`
|
|
428
|
-
| `
|
|
429
|
-
| `
|
|
430
|
-
| `
|
|
431
|
-
| `
|
|
432
|
-
| `
|
|
433
|
-
| `
|
|
434
|
-
| `
|
|
435
|
-
| `
|
|
436
|
-
| `
|
|
437
|
-
| `
|
|
438
|
-
| `
|
|
422
|
+
| Variable | Default | Description |
|
|
423
|
+
| --------------------------------------------------------- | ------------------- | ---------------------------------------------------------------- |
|
|
424
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Path to git-synced knowledge base |
|
|
425
|
+
| `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override primary host data root (adapters auto-detect otherwise) |
|
|
426
|
+
| `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | -- | Additional session directories, comma-separated |
|
|
427
|
+
| `OPENCODE_DATA_DIR` | (platform default) | Override OpenCode data dir (default `~/.local/share/opencode`) |
|
|
428
|
+
| `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
|
|
429
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_PROVIDER` | `local` | Embedding provider (local, openai, claude, gemini) |
|
|
430
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_ALPHA` | `0.5` | Blend weight for semantic vs TF-IDF search (0-1) |
|
|
431
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | — | Idle timeout for embedding worker (ms) |
|
|
432
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_THREADS` | — | Number of ONNX threads for local embeddings |
|
|
433
|
+
| `AGENT_KNOWLEDGE_EMBEDDING_MODEL` | — | Model name for embedding provider |
|
|
434
|
+
| `AGENT_KNOWLEDGE_GIT_URL` | — | Remote git URL for knowledge base sync |
|
|
435
|
+
| `AGENT_KNOWLEDGE_AUTO_DISTILL` | — | Enable auto-distillation of sessions (true/false) |
|
|
436
|
+
| `AGENT_KNOWLEDGE_OPENAI_API_KEY` / `OPENAI_API_KEY` | — | API key for OpenAI embeddings |
|
|
437
|
+
| `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` / `ANTHROPIC_API_KEY` | — | API key for Claude/Voyage embeddings |
|
|
438
|
+
| `AGENT_KNOWLEDGE_GEMINI_API_KEY` / `GEMINI_API_KEY` | — | API key for Gemini embeddings |
|
|
439
439
|
|
|
440
440
|
Set in your shell profile or pass via MCP config:
|
|
441
441
|
|
|
442
442
|
```bash
|
|
443
|
-
export
|
|
443
|
+
export AGENT_KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge"
|
|
444
444
|
```
|
|
445
445
|
|
|
446
446
|
On Windows (PowerShell):
|
|
447
447
|
|
|
448
448
|
```powershell
|
|
449
|
-
$env:
|
|
449
|
+
$env:AGENT_KNOWLEDGE_MEMORY_DIR = "$env:USERPROFILE\agent-knowledge"
|
|
450
450
|
```
|
|
451
451
|
|
|
452
452
|
---
|
|
@@ -481,21 +481,21 @@ cd ~/agent-knowledge && git pull && git push # Should work without prompts
|
|
|
481
481
|
|
|
482
482
|
agent-knowledge auto-discovers sessions from all major AI coding assistants. If a tool is installed on your machine, its sessions appear automatically in search results and the dashboard Sessions tab.
|
|
483
483
|
|
|
484
|
-
| Tool | Format | Auto-detected path | Override
|
|
485
|
-
| ---------------- | -------------- | --------------------------------------------------------------- |
|
|
486
|
-
| **Claude Code** | JSONL | `$
|
|
487
|
-
| **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` | `
|
|
488
|
-
| **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` | `OPENCODE_DATA_DIR`
|
|
489
|
-
| **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` | --
|
|
490
|
-
| **Continue.dev** | JSON | `~/.continue/sessions/` | --
|
|
491
|
-
| **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs | --
|
|
484
|
+
| Tool | Format | Auto-detected path | Override |
|
|
485
|
+
| ---------------- | -------------- | --------------------------------------------------------------- | ------------------------------------- |
|
|
486
|
+
| **Claude Code** | JSONL | `$AGENT_KNOWLEDGE_DATA_DIR/projects/` | `AGENT_KNOWLEDGE_DATA_DIR` |
|
|
487
|
+
| **Cursor** | JSONL | `~/.cursor/projects/*/agent-transcripts/` | `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` |
|
|
488
|
+
| **OpenCode** | SQLite | `~/.local/share/opencode/opencode.db` | `OPENCODE_DATA_DIR` |
|
|
489
|
+
| **Cline** | JSON | VS Code globalStorage `saoudrizwan.claude-dev/tasks/` | -- |
|
|
490
|
+
| **Continue.dev** | JSON | `~/.continue/sessions/` | -- |
|
|
491
|
+
| **Aider** | Markdown/JSONL | `.aider.chat.history.md` / `.aider.llm.history` in project dirs | -- |
|
|
492
492
|
|
|
493
493
|
### Adding extra session directories
|
|
494
494
|
|
|
495
|
-
Use the `
|
|
495
|
+
Use the `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` environment variable to add session directories that are not auto-detected:
|
|
496
496
|
|
|
497
497
|
```bash
|
|
498
|
-
export
|
|
498
|
+
export AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS="/path/to/custom/sessions,/another/path"
|
|
499
499
|
```
|
|
500
500
|
|
|
501
501
|
Each path is scanned for JSONL files or Cursor-style `agent-transcripts/` subdirectories.
|
|
@@ -518,7 +518,7 @@ netstat -ano | findstr :3423 # Windows
|
|
|
518
518
|
lsof -i :3423 # Linux/macOS
|
|
519
519
|
|
|
520
520
|
# Use a different port
|
|
521
|
-
export
|
|
521
|
+
export AGENT_KNOWLEDGE_PORT=3424
|
|
522
522
|
```
|
|
523
523
|
|
|
524
524
|
### Git authentication failures
|
|
@@ -563,7 +563,7 @@ ls ~/.continue/sessions/
|
|
|
563
563
|
ls ~/projects/*/.aider.chat.history.md
|
|
564
564
|
```
|
|
565
565
|
|
|
566
|
-
If your session data is in a non-standard location, use `
|
|
566
|
+
If your session data is in a non-standard location, use `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` to point to it.
|
|
567
567
|
|
|
568
568
|
## Client Comparison
|
|
569
569
|
|
package/docs/USER-MANUAL.md
CHANGED
|
@@ -95,14 +95,14 @@ npx agent-knowledge
|
|
|
95
95
|
|
|
96
96
|
### Environment Variables
|
|
97
97
|
|
|
98
|
-
| Variable
|
|
99
|
-
|
|
|
100
|
-
| `
|
|
101
|
-
| `
|
|
102
|
-
| `
|
|
103
|
-
| `
|
|
104
|
-
| `
|
|
105
|
-
| `
|
|
98
|
+
| Variable | Default | Description |
|
|
99
|
+
| ------------------------------------- | ------------------- | ----------------------------------------------- |
|
|
100
|
+
| `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard HTTP/WebSocket port |
|
|
101
|
+
| `AGENT_KNOWLEDGE_DATA_DIR` | (platform config) | Override primary host data root (auto-detected) |
|
|
102
|
+
| `AGENT_KNOWLEDGE_GIT_URL` | (none) | Git remote URL for knowledge base sync |
|
|
103
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Local knowledge base directory |
|
|
104
|
+
| `AGENT_KNOWLEDGE_AUTO_DISTILL` | `true` | Enable/disable session auto-distillation |
|
|
105
|
+
| `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` | (none) | Comma-separated additional session directories |
|
|
106
106
|
|
|
107
107
|
### Claude Code Setup
|
|
108
108
|
|
|
@@ -147,7 +147,7 @@ knowledge_admin with action "config", auto_distill false
|
|
|
147
147
|
|
|
148
148
|
### Accessing the Dashboard
|
|
149
149
|
|
|
150
|
-
The dashboard is available at **http://localhost:3423** (or the port configured via `
|
|
150
|
+
The dashboard is available at **http://localhost:3423** (or the port configured via `AGENT_KNOWLEDGE_PORT`).
|
|
151
151
|
|
|
152
152
|
### Knowledge Tab
|
|
153
153
|
|
|
@@ -901,13 +901,13 @@ On server startup (when `auto_distill` is enabled), past sessions are automatica
|
|
|
901
901
|
|
|
902
902
|
Sessions are auto-discovered from installed AI coding tools:
|
|
903
903
|
|
|
904
|
-
| Tool | Location
|
|
905
|
-
| ----------- |
|
|
906
|
-
| Claude Code | `$
|
|
907
|
-
| Cursor | `~/.cursor/projects/*/agent-transcripts/` (JSONL)
|
|
908
|
-
| OpenCode | `~/.local/share/opencode/opencode.db` (SQLite)
|
|
904
|
+
| Tool | Location |
|
|
905
|
+
| ----------- | --------------------------------------------------- |
|
|
906
|
+
| Claude Code | `$AGENT_KNOWLEDGE_DATA_DIR/projects/` (JSONL files) |
|
|
907
|
+
| Cursor | `~/.cursor/projects/*/agent-transcripts/` (JSONL) |
|
|
908
|
+
| OpenCode | `~/.local/share/opencode/opencode.db` (SQLite) |
|
|
909
909
|
|
|
910
|
-
Additional roots can be added via `
|
|
910
|
+
Additional roots can be added via `AGENT_KNOWLEDGE_EXTRA_SESSION_ROOTS` (comma-separated paths).
|
|
911
911
|
|
|
912
912
|
### Search Modes
|
|
913
913
|
|
|
@@ -956,14 +956,14 @@ If no provider is available, search falls back to pure TF-IDF.
|
|
|
956
956
|
|
|
957
957
|
**Solutions:**
|
|
958
958
|
|
|
959
|
-
1. Set `
|
|
959
|
+
1. Set `AGENT_KNOWLEDGE_PORT=3424` in the MCP config env.
|
|
960
960
|
2. Multiple MCP instances share the same database. Only one serves the dashboard.
|
|
961
961
|
|
|
962
962
|
### Search Returns No Results
|
|
963
963
|
|
|
964
964
|
**Causes and solutions:**
|
|
965
965
|
|
|
966
|
-
- **No sessions found**: Check that `
|
|
966
|
+
- **No sessions found**: Check that `AGENT_KNOWLEDGE_DATA_DIR` points to the correct directory. Verify session files exist.
|
|
967
967
|
- **Embeddings not available**: Semantic search requires an API key. Check the embedding provider configuration.
|
|
968
968
|
- **Index not built**: Background indexing runs 5 seconds after startup. Wait for it to complete. Check stderr for `[knowledge] Background index` messages.
|
|
969
969
|
|
|
@@ -995,7 +995,7 @@ If no provider is available, search falls back to pure TF-IDF.
|
|
|
995
995
|
**Solutions:**
|
|
996
996
|
|
|
997
997
|
- The default directory is `~/agent-knowledge/`. Create it manually or let the git clone create it.
|
|
998
|
-
- Override via `
|
|
998
|
+
- Override via `AGENT_KNOWLEDGE_MEMORY_DIR` or `knowledge_admin(action: "config", memory_dir: "/path")`.
|
|
999
999
|
|
|
1000
1000
|
---
|
|
1001
1001
|
|
|
@@ -1007,7 +1007,7 @@ Yes. agent-knowledge is a standard MCP server. It also auto-discovers sessions f
|
|
|
1007
1007
|
|
|
1008
1008
|
### Where are knowledge entries stored?
|
|
1009
1009
|
|
|
1010
|
-
In `~/agent-knowledge/` by default (configurable via `
|
|
1010
|
+
In `~/agent-knowledge/` by default (configurable via `AGENT_KNOWLEDGE_MEMORY_DIR`). Entries are plain Markdown files with YAML frontmatter, organized in category subdirectories.
|
|
1011
1011
|
|
|
1012
1012
|
### How does git sync work?
|
|
1013
1013
|
|
|
@@ -1040,4 +1040,4 @@ The distillation process applies regex patterns to detect and remove common secr
|
|
|
1040
1040
|
|
|
1041
1041
|
### Can I disable auto-distillation?
|
|
1042
1042
|
|
|
1043
|
-
Yes. Set `
|
|
1043
|
+
Yes. Set `AGENT_KNOWLEDGE_AUTO_DISTILL=false` as an environment variable, or use `knowledge_admin(action: "config", auto_distill: false)`.
|
package/docs/hooks.md
CHANGED
|
@@ -61,7 +61,7 @@ so the user's next real question still gets injection.
|
|
|
61
61
|
| `AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT` | `1` | Set `0` / `false` / `off` to disable |
|
|
62
62
|
| `AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET` | `600` | Max tokens (chars/4 estimate), clamped to `[100, 8000]` |
|
|
63
63
|
| `AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS` | `4` | Max rendered entries, clamped to `[1, 20]` |
|
|
64
|
-
| `
|
|
64
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Knowledge base to search |
|
|
65
65
|
|
|
66
66
|
## precompact-flush.mjs
|
|
67
67
|
|
|
@@ -79,7 +79,7 @@ Called right before the host compacts the transcript. Two jobs:
|
|
|
79
79
|
|
|
80
80
|
| Variable | Default | Description |
|
|
81
81
|
| ---------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------- |
|
|
82
|
-
| `
|
|
82
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Where rich summaries are written |
|
|
83
83
|
| `AGENT_KNOWLEDGE_PRECOMPACT_NUDGE` | `1` | Set `0` / `false` to disable the nudge only. Set `off` to suppress both the nudge AND the disk dump. |
|
|
84
84
|
|
|
85
85
|
## precompact-distill.mjs
|
|
@@ -87,22 +87,22 @@ Called right before the host compacts the transcript. Two jobs:
|
|
|
87
87
|
A simpler heuristic companion to `precompact-flush.mjs`. Reads the last
|
|
88
88
|
~200 KB of the transcript JSONL, extracts the last 10 user prompts, and
|
|
89
89
|
writes them to
|
|
90
|
-
`~/
|
|
90
|
+
`~/agent-knowledge/projects/precompact-<slug>-<session>.md`. This one does
|
|
91
91
|
not require the library to be built, so it still works when `dist/` is
|
|
92
92
|
missing. Running both is fine — they target different files.
|
|
93
93
|
|
|
94
94
|
### Environment variables
|
|
95
95
|
|
|
96
|
-
| Variable
|
|
97
|
-
|
|
|
98
|
-
| `
|
|
96
|
+
| Variable | Default | Description |
|
|
97
|
+
| ---------------------------- | ------------------- | ------------------------------------------------- |
|
|
98
|
+
| `AGENT_KNOWLEDGE_MEMORY_DIR` | `~/agent-knowledge` | Where the snapshot is written (`<dir>/projects/`) |
|
|
99
99
|
|
|
100
100
|
## sessionend-distill.mjs
|
|
101
101
|
|
|
102
102
|
On `SessionEnd`, walks the whole transcript JSONL, counts user / assistant
|
|
103
103
|
turns and `tool_use` blocks, collects the first 20 user prompts, and writes
|
|
104
104
|
a markdown summary to
|
|
105
|
-
`~/
|
|
105
|
+
`~/agent-knowledge/projects/session-<slug>-<session>.md`. Gives
|
|
106
106
|
agent-knowledge a breadcrumb for later session search/recall.
|
|
107
107
|
|
|
108
108
|
## Manual configuration
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.1",
|
|
4
4
|
"description": "Cross-session memory and recall for AI agents — git-synced knowledge base, knowledge graph, confidence scoring, hybrid semantic+TF-IDF search, auto-distillation with secrets scrubbing",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
// AGENT_KNOWLEDGE_FIRSTPROMPT_INJECT (default "1") — set "0" to disable
|
|
24
24
|
// AGENT_KNOWLEDGE_FIRSTPROMPT_BUDGET (default "600") — max chars/4 tokens
|
|
25
25
|
// AGENT_KNOWLEDGE_FIRSTPROMPT_MAX_HITS (default "4") — cap on rendered hits
|
|
26
|
-
//
|
|
26
|
+
// AGENT_KNOWLEDGE_MEMORY_DIR — resolves memory dir (same as core)
|
|
27
27
|
//
|
|
28
28
|
// Fail-open: every error path prints `{}` so the host never blocks on this
|
|
29
29
|
// hook. Log-only stderr for diagnostics.
|
|
@@ -75,11 +75,11 @@ function maxHits() {
|
|
|
75
75
|
}
|
|
76
76
|
|
|
77
77
|
function memoryDir() {
|
|
78
|
-
return process.env.
|
|
78
|
+
return process.env.AGENT_KNOWLEDGE_MEMORY_DIR || path.join(homedir(), 'agent-knowledge');
|
|
79
79
|
}
|
|
80
80
|
|
|
81
81
|
function dataDir() {
|
|
82
|
-
if (process.env.
|
|
82
|
+
if (process.env.AGENT_KNOWLEDGE_DATA_DIR) return process.env.AGENT_KNOWLEDGE_DATA_DIR;
|
|
83
83
|
if (process.platform === 'win32') {
|
|
84
84
|
return path.join(
|
|
85
85
|
process.env.APPDATA || path.join(homedir(), 'AppData', 'Roaming'),
|
|
@@ -23,7 +23,7 @@ process.on('uncaughtException', (err) => {
|
|
|
23
23
|
process.exit(0);
|
|
24
24
|
});
|
|
25
25
|
|
|
26
|
-
const MEMORY_DIR = process.env.
|
|
26
|
+
const MEMORY_DIR = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
|
|
27
27
|
|
|
28
28
|
async function main() {
|
|
29
29
|
let input = '';
|
|
@@ -88,7 +88,7 @@ function slugify(input) {
|
|
|
88
88
|
}
|
|
89
89
|
|
|
90
90
|
function memoryDir() {
|
|
91
|
-
return process.env.
|
|
91
|
+
return process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
|
|
92
92
|
}
|
|
93
93
|
|
|
94
94
|
async function dumpSummaryToDisk({ sessionId, event, cwd, projectSlug }) {
|
|
@@ -21,7 +21,7 @@ process.on('uncaughtException', (err) => {
|
|
|
21
21
|
process.exit(0);
|
|
22
22
|
});
|
|
23
23
|
|
|
24
|
-
const MEMORY_DIR = process.env.
|
|
24
|
+
const MEMORY_DIR = process.env.AGENT_KNOWLEDGE_MEMORY_DIR || join(homedir(), 'agent-knowledge');
|
|
25
25
|
|
|
26
26
|
async function main() {
|
|
27
27
|
let input = '';
|
package/scripts/setup.js
CHANGED
|
@@ -211,7 +211,7 @@ Restart Claude Code to load the new MCP server. Every session will now:
|
|
|
211
211
|
- Dump a final session summary on exit (sessionend-distill)
|
|
212
212
|
|
|
213
213
|
Dashboard: http://localhost:3423 (auto-starts on first MCP connection)
|
|
214
|
-
Knowledge base: ~/
|
|
214
|
+
Knowledge base: ~/agent-knowledge/ (configurable via AGENT_KNOWLEDGE_MEMORY_DIR)
|
|
215
215
|
|
|
216
216
|
See docs/hooks.md for details and docs/SETUP.md for manual configuration.
|
|
217
217
|
`);
|