agent-knowledge 1.3.5 → 1.3.7
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/README.md +26 -7
- package/dist/lib.d.ts +36 -0
- package/dist/lib.d.ts.map +1 -0
- package/dist/lib.js +42 -0
- package/dist/lib.js.map +1 -0
- package/package.json +16 -1
package/README.md
CHANGED
|
@@ -65,6 +65,14 @@ No configuration needed. Additional session roots can be added via the `EXTRA_SE
|
|
|
65
65
|
|
|
66
66
|
## Quick Start
|
|
67
67
|
|
|
68
|
+
### Install from npm
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
npm install -g agent-knowledge
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Or clone from source
|
|
75
|
+
|
|
68
76
|
```bash
|
|
69
77
|
git clone https://github.com/keshrath/agent-knowledge.git
|
|
70
78
|
cd agent-knowledge
|
|
@@ -79,20 +87,31 @@ npm install && npm run build
|
|
|
79
87
|
>
|
|
80
88
|
> Then re-run `npm install`. This is only needed when prebuilt binaries aren't available for your Node.js version (e.g. Node 24+).
|
|
81
89
|
|
|
82
|
-
###
|
|
90
|
+
### Option 1: MCP server (for AI agents)
|
|
91
|
+
|
|
92
|
+
Add to your MCP client config (Claude Code, Cline, etc.):
|
|
93
|
+
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"mcpServers": {
|
|
97
|
+
"agent-knowledge": {
|
|
98
|
+
"command": "npx",
|
|
99
|
+
"args": ["agent-knowledge"]
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
The dashboard auto-starts at http://localhost:3423 on the first MCP connection.
|
|
83
106
|
|
|
84
107
|
See [Setup Guide](docs/SETUP.md) for client-specific instructions (Claude Code, Cursor, Windsurf, OpenCode).
|
|
85
108
|
|
|
86
|
-
|
|
109
|
+
### Option 2: Standalone server (for REST/WebSocket clients)
|
|
87
110
|
|
|
88
111
|
```bash
|
|
89
|
-
|
|
90
|
-
-e KNOWLEDGE_MEMORY_DIR="$HOME/agent-knowledge" \
|
|
91
|
-
-- node /path/to/agent-knowledge/dist/index.js
|
|
112
|
+
node dist/server.js --port 3423
|
|
92
113
|
```
|
|
93
114
|
|
|
94
|
-
Dashboard: **http://localhost:3423** (auto-starts with MCP server)
|
|
95
|
-
|
|
96
115
|
## MCP Tools (6)
|
|
97
116
|
|
|
98
117
|
### Knowledge Base
|
package/dist/lib.d.ts
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
export { createServer, type ServerOptions } from './server.js';
|
|
2
|
+
export { getConfig, getConfigLocation, loadPersistedConfig, savePersistedConfig } from './types.js';
|
|
3
|
+
export type { KnowledgeConfig, PersistedConfig } from './types.js';
|
|
4
|
+
export { listEntries, readEntry, writeEntry, deleteEntry, parseFrontmatter, sanitizePath, CATEGORIES, } from './knowledge/store.js';
|
|
5
|
+
export type { KnowledgeEntry, Category } from './knowledge/store.js';
|
|
6
|
+
export { searchKnowledge, invalidateKnowledgeIndexCache } from './knowledge/search.js';
|
|
7
|
+
export type { SearchOptions as KnowledgeSearchOptions, SearchResult as KnowledgeSearchResult, } from './knowledge/search.js';
|
|
8
|
+
export { KnowledgeGraph, getKnowledgeGraph, RELATIONSHIP_TYPES } from './knowledge/graph.js';
|
|
9
|
+
export type { RelationshipType, Edge, GraphNode, GraphResult } from './knowledge/graph.js';
|
|
10
|
+
export { EntryScoring, getEntryScoring, decayFactor, maturityMultiplier, computeFinalScore, } from './knowledge/scoring.js';
|
|
11
|
+
export type { EntryScore, Maturity } from './knowledge/scoring.js';
|
|
12
|
+
export { checkDuplicates, consolidate } from './knowledge/consolidate.js';
|
|
13
|
+
export type { DuplicateWarning, ConsolidationCluster, ConsolidationReport, } from './knowledge/consolidate.js';
|
|
14
|
+
export { reflect } from './knowledge/reflect.js';
|
|
15
|
+
export type { UnconnectedEntry, ReflectionResult } from './knowledge/reflect.js';
|
|
16
|
+
export { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './sessions/parser.js';
|
|
17
|
+
export type { SessionEntry, SessionMessage, SessionMeta } from './sessions/parser.js';
|
|
18
|
+
export { searchSessions } from './sessions/search.js';
|
|
19
|
+
export type { SearchSessionOptions } from './sessions/search.js';
|
|
20
|
+
export { listSessions, getSessionSummary } from './sessions/summary.js';
|
|
21
|
+
export type { SessionSummary } from './sessions/summary.js';
|
|
22
|
+
export { scopedSearch } from './sessions/scopes.js';
|
|
23
|
+
export type { SearchScope, ScopedSearchOptions } from './sessions/scopes.js';
|
|
24
|
+
export { TfIdfIndex, recencyDecay } from './search/tfidf.js';
|
|
25
|
+
export type { SearchResult, SearchOptions } from './search/types.js';
|
|
26
|
+
export type { EmbeddingProvider, EmbeddingConfig, ProviderName } from './embeddings/types.js';
|
|
27
|
+
export { getEmbeddingConfig } from './embeddings/types.js';
|
|
28
|
+
export { getEmbeddingProvider, resetProvider } from './embeddings/factory.js';
|
|
29
|
+
export { VectorStore } from './vectorstore/store.js';
|
|
30
|
+
export type { VectorEntry, VectorSearchResult, VectorStoreStats } from './vectorstore/store.js';
|
|
31
|
+
export { chunkKnowledge, chunkSession } from './vectorstore/chunker.js';
|
|
32
|
+
export type { Chunk, SessionMessage as ChunkSessionMessage } from './vectorstore/chunker.js';
|
|
33
|
+
export { toolHandlers, validateArgs, ok, err, SCOPES } from './tool-handlers.js';
|
|
34
|
+
export type { ToolResult, ToolHandler } from './tool-handlers.js';
|
|
35
|
+
export { ValidationError, requireString, optionalString, optionalNumber, optionalBoolean, requireEnum, optionalEnum, validateFilename, } from './validate.js';
|
|
36
|
+
//# sourceMappingURL=lib.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"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"}
|
package/dist/lib.js
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// agent-knowledge — Library API
|
|
3
|
+
//
|
|
4
|
+
// Public exports for programmatic use. Import from 'agent-knowledge/lib'.
|
|
5
|
+
// The default export (index.ts) is the MCP stdio server.
|
|
6
|
+
// =============================================================================
|
|
7
|
+
// Server factory
|
|
8
|
+
export { createServer } from './server.js';
|
|
9
|
+
// Configuration
|
|
10
|
+
export { getConfig, getConfigLocation, loadPersistedConfig, savePersistedConfig } from './types.js';
|
|
11
|
+
// Knowledge store (CRUD)
|
|
12
|
+
export { listEntries, readEntry, writeEntry, deleteEntry, parseFrontmatter, sanitizePath, CATEGORIES, } from './knowledge/store.js';
|
|
13
|
+
// Knowledge search
|
|
14
|
+
export { searchKnowledge, invalidateKnowledgeIndexCache } from './knowledge/search.js';
|
|
15
|
+
// Knowledge graph
|
|
16
|
+
export { KnowledgeGraph, getKnowledgeGraph, RELATIONSHIP_TYPES } from './knowledge/graph.js';
|
|
17
|
+
// Confidence/decay scoring
|
|
18
|
+
export { EntryScoring, getEntryScoring, decayFactor, maturityMultiplier, computeFinalScore, } from './knowledge/scoring.js';
|
|
19
|
+
// Consolidation (duplicate detection)
|
|
20
|
+
export { checkDuplicates, consolidate } from './knowledge/consolidate.js';
|
|
21
|
+
// Reflection
|
|
22
|
+
export { reflect } from './knowledge/reflect.js';
|
|
23
|
+
// Session discovery & parsing
|
|
24
|
+
export { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './sessions/parser.js';
|
|
25
|
+
// Session search
|
|
26
|
+
export { searchSessions } from './sessions/search.js';
|
|
27
|
+
// Session summaries
|
|
28
|
+
export { listSessions, getSessionSummary } from './sessions/summary.js';
|
|
29
|
+
// Scoped search
|
|
30
|
+
export { scopedSearch } from './sessions/scopes.js';
|
|
31
|
+
// Search primitives
|
|
32
|
+
export { TfIdfIndex, recencyDecay } from './search/tfidf.js';
|
|
33
|
+
export { getEmbeddingConfig } from './embeddings/types.js';
|
|
34
|
+
export { getEmbeddingProvider, resetProvider } from './embeddings/factory.js';
|
|
35
|
+
// Vector store
|
|
36
|
+
export { VectorStore } from './vectorstore/store.js';
|
|
37
|
+
export { chunkKnowledge, chunkSession } from './vectorstore/chunker.js';
|
|
38
|
+
// Tool handlers
|
|
39
|
+
export { toolHandlers, validateArgs, ok, err, SCOPES } from './tool-handlers.js';
|
|
40
|
+
// Validation
|
|
41
|
+
export { ValidationError, requireString, optionalString, optionalNumber, optionalBoolean, requireEnum, optionalEnum, validateFilename, } from './validate.js';
|
|
42
|
+
//# sourceMappingURL=lib.js.map
|
package/dist/lib.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gCAAgC;AAChC,EAAE;AACF,0EAA0E;AAC1E,yDAAyD;AACzD,gFAAgF;AAEhF,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAE/D,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGpG,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,sBAAsB,CAAC;AAG9B,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAMvF,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7F,2BAA2B;AAC3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAO1E,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,8BAA8B;AAC9B,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGxE,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAK7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE9E,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxE,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjF,aAAa;AACb,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,9 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.7",
|
|
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",
|
|
7
|
+
"types": "dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"default": "./dist/index.js"
|
|
12
|
+
},
|
|
13
|
+
"./lib": {
|
|
14
|
+
"types": "./dist/lib.d.ts",
|
|
15
|
+
"default": "./dist/lib.js"
|
|
16
|
+
},
|
|
17
|
+
"./dist/lib.js": {
|
|
18
|
+
"types": "./dist/lib.d.ts",
|
|
19
|
+
"default": "./dist/lib.js"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
7
22
|
"bin": {
|
|
8
23
|
"agent-knowledge": "dist/index.js"
|
|
9
24
|
},
|