agent-knowledge 1.6.2 → 1.6.3
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 +2 -1
- package/README.md +28 -15
- package/agent-desk-plugin.json +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 1.6.
|
|
3
|
+
## 1.6.3 (2026-04-13)
|
|
4
4
|
|
|
5
5
|
### Added
|
|
6
6
|
|
|
7
7
|
- **`POST /api/knowledge` REST endpoint** — write knowledge entries via HTTP. Runs the full MCP write pipeline: git pull, file write, embedding index, auto-link (cosine > 0.7), git push, duplicate check. Returns `{ path, autoLinks, duplicateWarnings, git }`. POST restricted to `/api/` paths; non-API POST still returns 405. Used by agent-tasks KnowledgeBridge to push learning/decision artifacts on task completion. 481/481 tests green.
|
|
8
|
+
- **README: Integrations section** — documents the REST write endpoint and the agent-tasks KnowledgeBridge integration. REST API table updated with POST entry.
|
|
8
9
|
|
|
9
10
|
## 1.5.2 (2026-04-11)
|
|
10
11
|
|
package/README.md
CHANGED
|
@@ -189,21 +189,22 @@ Relationship types: `related_to`, `supersedes`, `depends_on`, `contradicts`, `sp
|
|
|
189
189
|
|
|
190
190
|
## REST API
|
|
191
191
|
|
|
192
|
-
| Method | Endpoint | Description
|
|
193
|
-
| ------ | --------------------------------------- |
|
|
194
|
-
| GET | `/api/knowledge` | List knowledge entries
|
|
195
|
-
| GET | `/api/knowledge/search?q=` | Search knowledge base
|
|
196
|
-
| GET | `/api/knowledge/:path` | Read a specific entry
|
|
197
|
-
| GET | `/api/knowledge/god-nodes?top_n=` | Most-connected entries
|
|
198
|
-
| GET | `/api/knowledge/bridges?top_n=` | Cross-category connectors
|
|
199
|
-
| GET | `/api/knowledge/gaps?max_entries=` | Isolated entries
|
|
200
|
-
| GET | `/api/knowledge/brief` | Knowledge base brief
|
|
201
|
-
| GET | `/api/sessions` | List sessions
|
|
202
|
-
| GET | `/api/sessions/search?q=&role=&ranked=` | Search sessions (TF-IDF)
|
|
203
|
-
| GET | `/api/sessions/recall?scope=&q=` | Scoped recall
|
|
204
|
-
| GET | `/api/sessions/:id` | Read a session
|
|
205
|
-
| GET | `/api/sessions/:id/summary` | Session summary
|
|
206
|
-
|
|
|
192
|
+
| Method | Endpoint | Description |
|
|
193
|
+
| ------ | --------------------------------------- | -------------------------- |
|
|
194
|
+
| GET | `/api/knowledge` | List knowledge entries |
|
|
195
|
+
| GET | `/api/knowledge/search?q=` | Search knowledge base |
|
|
196
|
+
| GET | `/api/knowledge/:path` | Read a specific entry |
|
|
197
|
+
| GET | `/api/knowledge/god-nodes?top_n=` | Most-connected entries |
|
|
198
|
+
| GET | `/api/knowledge/bridges?top_n=` | Cross-category connectors |
|
|
199
|
+
| GET | `/api/knowledge/gaps?max_entries=` | Isolated entries |
|
|
200
|
+
| GET | `/api/knowledge/brief` | Knowledge base brief |
|
|
201
|
+
| GET | `/api/sessions` | List sessions |
|
|
202
|
+
| GET | `/api/sessions/search?q=&role=&ranked=` | Search sessions (TF-IDF) |
|
|
203
|
+
| GET | `/api/sessions/recall?scope=&q=` | Scoped recall |
|
|
204
|
+
| GET | `/api/sessions/:id` | Read a session |
|
|
205
|
+
| GET | `/api/sessions/:id/summary` | Session summary |
|
|
206
|
+
| POST | `/api/knowledge` | Write entry (HTTP clients) |
|
|
207
|
+
| GET | `/health` | Health check |
|
|
207
208
|
|
|
208
209
|
## Architecture
|
|
209
210
|
|
|
@@ -299,6 +300,18 @@ Frequently accessed entries rise in search rankings; stale entries decay over ti
|
|
|
299
300
|
| `files` | File paths, modifications |
|
|
300
301
|
| `decisions` | Trade-offs, rationale, choices |
|
|
301
302
|
|
|
303
|
+
## Integrations
|
|
304
|
+
|
|
305
|
+
### REST Write Endpoint
|
|
306
|
+
|
|
307
|
+
`POST /api/knowledge` accepts `{ category, filename, content }` and runs the full write pipeline: git pull → file write → embedding index → auto-link → git push → duplicate check. Returns `{ path, autoLinks?, duplicateWarnings?, git }` with status 201.
|
|
308
|
+
|
|
309
|
+
This enables HTTP-based writes from other services without an MCP connection.
|
|
310
|
+
|
|
311
|
+
### agent-tasks KnowledgeBridge
|
|
312
|
+
|
|
313
|
+
[agent-tasks](https://github.com/keshrath/agent-tasks) has a built-in `KnowledgeBridge` that auto-pushes `learning` and `decision` artifacts to agent-knowledge on task completion. Entries land in `decisions/` with frontmatter tags (`agent-tasks`, project name, artifact type), are auto-indexed with embeddings, and auto-linked to similar entries. No configuration needed — if agent-knowledge is running at `localhost:3423`, it works.
|
|
314
|
+
|
|
302
315
|
## Testing
|
|
303
316
|
|
|
304
317
|
```bash
|
package/agent-desk-plugin.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.3",
|
|
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",
|