@kb-labs/mind-entry 2.104.0 → 2.106.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 (2) hide show
  1. package/dist/manifest.json +606 -0
  2. package/package.json +20 -20
@@ -0,0 +1,606 @@
1
+ {
2
+ "schema": "kb.plugin/3",
3
+ "id": "@kb-labs/mind",
4
+ "version": "0.1.0",
5
+ "configSection": "mind",
6
+ "display": {
7
+ "name": "Mind (RAG)",
8
+ "description": "Retrieval-augmented knowledge engine — index and query your codebase and docs",
9
+ "tags": [
10
+ "rag",
11
+ "search",
12
+ "embeddings",
13
+ "ai",
14
+ "mind"
15
+ ]
16
+ },
17
+ "platform": {
18
+ "requires": [
19
+ "cache",
20
+ "storage"
21
+ ],
22
+ "optional": [
23
+ "llm",
24
+ "embeddings",
25
+ "vectorStore",
26
+ "analytics"
27
+ ]
28
+ },
29
+ "permissions": {
30
+ "fs": {
31
+ "read": [
32
+ ".kb/**",
33
+ ".kb/mind/**"
34
+ ],
35
+ "write": [
36
+ ".kb/**",
37
+ ".kb/mind/**"
38
+ ]
39
+ },
40
+ "env": {
41
+ "read": [
42
+ "HOME",
43
+ "USER",
44
+ "PATH",
45
+ "TMPDIR",
46
+ "NODE_ENV",
47
+ "KB_*"
48
+ ]
49
+ },
50
+ "platform": {
51
+ "llm": true,
52
+ "embeddings": true,
53
+ "vectorStore": {
54
+ "collections": [
55
+ "mind:"
56
+ ]
57
+ },
58
+ "analytics": true,
59
+ "cache": {
60
+ "namespaces": [
61
+ "mind:"
62
+ ]
63
+ },
64
+ "storage": true
65
+ },
66
+ "quotas": {
67
+ "timeoutMs": 600000,
68
+ "memoryMb": 512
69
+ }
70
+ },
71
+ "cli": {
72
+ "groupMeta": [
73
+ {
74
+ "path": "mind",
75
+ "describe": "Mind — RAG index & search"
76
+ }
77
+ ],
78
+ "commands": [
79
+ {
80
+ "path": "mind index",
81
+ "category": "Index",
82
+ "operationType": "mutate",
83
+ "describe": "Build or refresh a Mind index from source files.",
84
+ "handler": "./cli/commands/index.js#default",
85
+ "flags": [
86
+ {
87
+ "name": "index",
88
+ "type": "string",
89
+ "description": "Index/corpus id"
90
+ },
91
+ {
92
+ "name": "scope",
93
+ "type": "string",
94
+ "description": "Glob/path scope to index"
95
+ },
96
+ {
97
+ "name": "root",
98
+ "type": "string",
99
+ "description": "Project root to index (default: cwd)"
100
+ },
101
+ {
102
+ "name": "full",
103
+ "type": "boolean",
104
+ "default": false,
105
+ "description": "Full rebuild instead of incremental delta"
106
+ },
107
+ {
108
+ "name": "json",
109
+ "type": "boolean",
110
+ "default": false,
111
+ "description": "Output JSON"
112
+ }
113
+ ],
114
+ "examples": [
115
+ "kb mind index",
116
+ "kb mind index --index code --scope src/"
117
+ ]
118
+ },
119
+ {
120
+ "path": "mind search",
121
+ "category": "Query",
122
+ "operationType": "read",
123
+ "describe": "Semantic + keyword search over a Mind index.",
124
+ "handler": "./cli/commands/search.js#default",
125
+ "flags": [
126
+ {
127
+ "name": "text",
128
+ "type": "string",
129
+ "description": "Query text",
130
+ "required": true
131
+ },
132
+ {
133
+ "name": "index",
134
+ "type": "string",
135
+ "description": "Index/corpus id to search"
136
+ },
137
+ {
138
+ "name": "intent",
139
+ "type": "string",
140
+ "description": "Query intent hint"
141
+ },
142
+ {
143
+ "name": "limit",
144
+ "type": "number",
145
+ "description": "Max results"
146
+ },
147
+ {
148
+ "name": "snippet",
149
+ "type": "string",
150
+ "description": "How much source text per result"
151
+ },
152
+ {
153
+ "name": "format",
154
+ "type": "string",
155
+ "description": "Output format"
156
+ },
157
+ {
158
+ "name": "json",
159
+ "type": "boolean",
160
+ "default": false,
161
+ "description": "Output JSON (alias for --format json)"
162
+ }
163
+ ],
164
+ "examples": [
165
+ "kb mind search --text \"how does login work\"",
166
+ "kb mind search --text \"ClassName\" --index code --agent"
167
+ ]
168
+ },
169
+ {
170
+ "path": "mind ask",
171
+ "category": "Query",
172
+ "operationType": "read",
173
+ "describe": "Ask a question and get a grounded answer with citations.",
174
+ "handler": "./cli/commands/ask.js#default",
175
+ "flags": [
176
+ {
177
+ "name": "text",
178
+ "type": "string",
179
+ "description": "Question to answer",
180
+ "required": true
181
+ },
182
+ {
183
+ "name": "index",
184
+ "type": "string",
185
+ "description": "Index/corpus id to query"
186
+ },
187
+ {
188
+ "name": "mode",
189
+ "type": "string",
190
+ "description": "Answer depth"
191
+ },
192
+ {
193
+ "name": "snippet",
194
+ "type": "string",
195
+ "description": "How much source text per result"
196
+ },
197
+ {
198
+ "name": "format",
199
+ "type": "string",
200
+ "description": "Output format"
201
+ },
202
+ {
203
+ "name": "agent",
204
+ "type": "boolean",
205
+ "default": false,
206
+ "description": "Emit machine-readable agent JSON (alias for --format json)"
207
+ },
208
+ {
209
+ "name": "json",
210
+ "type": "boolean",
211
+ "default": false,
212
+ "description": "Output JSON"
213
+ }
214
+ ],
215
+ "examples": [
216
+ "kb mind ask --text \"how does auth work\" --index code",
217
+ "kb mind ask --text \"billing flow\" --mode thinking --agent"
218
+ ]
219
+ },
220
+ {
221
+ "path": "mind explore",
222
+ "category": "Query",
223
+ "operationType": "read",
224
+ "describe": "Task-orientation map — where to start and how involved a task looks.",
225
+ "handler": "./cli/commands/explore.js#default",
226
+ "flags": [
227
+ {
228
+ "name": "task",
229
+ "type": "string",
230
+ "description": "The task to orient around",
231
+ "required": true
232
+ },
233
+ {
234
+ "name": "index",
235
+ "type": "string",
236
+ "description": "Index/corpus id to explore"
237
+ },
238
+ {
239
+ "name": "limit",
240
+ "type": "number",
241
+ "description": "Max files in the map"
242
+ },
243
+ {
244
+ "name": "format",
245
+ "type": "string",
246
+ "description": "Output format"
247
+ },
248
+ {
249
+ "name": "json",
250
+ "type": "boolean",
251
+ "default": false,
252
+ "description": "Output JSON (alias for --format json)"
253
+ }
254
+ ],
255
+ "examples": [
256
+ "kb mind explore --task \"add rate limiting to the gateway\" --index code",
257
+ "kb mind explore --task \"where is auth handled\" --format json"
258
+ ]
259
+ },
260
+ {
261
+ "path": "mind reindex",
262
+ "category": "Index",
263
+ "operationType": "mutate",
264
+ "describe": "Rebuild an index from source files.",
265
+ "handler": "./cli/commands/reindex.js#default",
266
+ "flags": [
267
+ {
268
+ "name": "index",
269
+ "type": "string",
270
+ "description": "Index/corpus id"
271
+ },
272
+ {
273
+ "name": "full",
274
+ "type": "boolean",
275
+ "default": false,
276
+ "description": "Full rebuild"
277
+ },
278
+ {
279
+ "name": "json",
280
+ "type": "boolean",
281
+ "default": false,
282
+ "description": "Output JSON"
283
+ }
284
+ ],
285
+ "examples": [
286
+ "kb mind reindex --index code --full"
287
+ ]
288
+ },
289
+ {
290
+ "path": "mind drop",
291
+ "category": "Index",
292
+ "operationType": "mutate",
293
+ "describe": "Drop an entire index (all vectors + manifest).",
294
+ "handler": "./cli/commands/drop.js#default",
295
+ "flags": [
296
+ {
297
+ "name": "index",
298
+ "type": "string",
299
+ "description": "Index to drop (vectors + manifest)",
300
+ "required": true
301
+ },
302
+ {
303
+ "name": "yes",
304
+ "type": "boolean",
305
+ "default": false,
306
+ "description": "Skip the confirmation prompt"
307
+ },
308
+ {
309
+ "name": "json",
310
+ "type": "boolean",
311
+ "default": false,
312
+ "description": "Output JSON"
313
+ }
314
+ ],
315
+ "examples": [
316
+ "kb mind drop --index kbrt --yes"
317
+ ]
318
+ },
319
+ {
320
+ "path": "mind sync add",
321
+ "category": "Sync",
322
+ "operationType": "mutate",
323
+ "describe": "Add documents to an index (incremental).",
324
+ "handler": "./cli/commands/sync-add.js#default",
325
+ "flags": [
326
+ {
327
+ "name": "index",
328
+ "type": "string",
329
+ "description": "Index/corpus id"
330
+ },
331
+ {
332
+ "name": "json",
333
+ "type": "boolean",
334
+ "default": false,
335
+ "description": "Output JSON"
336
+ }
337
+ ],
338
+ "examples": [
339
+ "kb mind sync add src/new.ts --index code"
340
+ ]
341
+ },
342
+ {
343
+ "path": "mind sync update",
344
+ "category": "Sync",
345
+ "operationType": "mutate",
346
+ "describe": "Re-index updated documents (incremental).",
347
+ "handler": "./cli/commands/sync-update.js#default",
348
+ "flags": [
349
+ {
350
+ "name": "index",
351
+ "type": "string",
352
+ "description": "Index/corpus id"
353
+ },
354
+ {
355
+ "name": "json",
356
+ "type": "boolean",
357
+ "default": false,
358
+ "description": "Output JSON"
359
+ }
360
+ ],
361
+ "examples": [
362
+ "kb mind sync update src/auth.ts --index code"
363
+ ]
364
+ },
365
+ {
366
+ "path": "mind sync delete",
367
+ "category": "Sync",
368
+ "operationType": "mutate",
369
+ "describe": "Remove documents from an index (incremental).",
370
+ "handler": "./cli/commands/sync-delete.js#default",
371
+ "flags": [
372
+ {
373
+ "name": "index",
374
+ "type": "string",
375
+ "description": "Index/corpus id"
376
+ },
377
+ {
378
+ "name": "yes",
379
+ "type": "boolean",
380
+ "default": false,
381
+ "description": "Confirm deletion (recoverable via `kb mind sync add`)"
382
+ },
383
+ {
384
+ "name": "json",
385
+ "type": "boolean",
386
+ "default": false,
387
+ "description": "Output JSON"
388
+ }
389
+ ],
390
+ "examples": [
391
+ "kb mind sync delete src/old.ts --index code"
392
+ ]
393
+ },
394
+ {
395
+ "path": "mind sync list",
396
+ "category": "Sync",
397
+ "operationType": "read",
398
+ "describe": "List documents synced into an index.",
399
+ "handler": "./cli/commands/sync-list.js#default",
400
+ "flags": [
401
+ {
402
+ "name": "index",
403
+ "type": "string",
404
+ "description": "Index/corpus id"
405
+ },
406
+ {
407
+ "name": "json",
408
+ "type": "boolean",
409
+ "default": false,
410
+ "description": "Output JSON"
411
+ }
412
+ ],
413
+ "examples": [
414
+ "kb mind sync list --index code"
415
+ ]
416
+ },
417
+ {
418
+ "path": "mind sync health",
419
+ "category": "Sync",
420
+ "operationType": "read",
421
+ "describe": "Show sync health for an index.",
422
+ "handler": "./cli/commands/sync-status.js#default",
423
+ "flags": [
424
+ {
425
+ "name": "index",
426
+ "type": "string",
427
+ "description": "Index/corpus id"
428
+ },
429
+ {
430
+ "name": "json",
431
+ "type": "boolean",
432
+ "default": false,
433
+ "description": "Output JSON"
434
+ }
435
+ ],
436
+ "examples": [
437
+ "kb mind sync health --index code"
438
+ ]
439
+ },
440
+ {
441
+ "path": "mind status",
442
+ "category": "Index",
443
+ "operationType": "read",
444
+ "describe": "Show Mind index status.",
445
+ "handler": "./cli/commands/status.js#default",
446
+ "flags": [
447
+ {
448
+ "name": "index",
449
+ "type": "string",
450
+ "description": "Limit to a single index"
451
+ },
452
+ {
453
+ "name": "json",
454
+ "type": "boolean",
455
+ "default": false,
456
+ "description": "Output JSON"
457
+ }
458
+ ],
459
+ "examples": [
460
+ "kb mind status",
461
+ "kb mind status --index code"
462
+ ]
463
+ }
464
+ ]
465
+ },
466
+ "rest": {
467
+ "basePath": "/v1/plugins/mind",
468
+ "routes": [
469
+ {
470
+ "method": "POST",
471
+ "path": "/index",
472
+ "handler": "./rest/handlers/index.js#default",
473
+ "input": {
474
+ "zod": "@kb-labs/mind-contracts#IndexRequestSchema"
475
+ },
476
+ "output": {
477
+ "zod": "@kb-labs/mind-contracts#IndexResponseSchema"
478
+ },
479
+ "timeoutMs": 600000
480
+ },
481
+ {
482
+ "method": "POST",
483
+ "path": "/search",
484
+ "handler": "./rest/handlers/search.js#default",
485
+ "input": {
486
+ "zod": "@kb-labs/mind-contracts#SearchRequestSchema"
487
+ },
488
+ "output": {
489
+ "zod": "@kb-labs/mind-contracts#SearchResponseSchema"
490
+ }
491
+ },
492
+ {
493
+ "method": "POST",
494
+ "path": "/query",
495
+ "handler": "./rest/handlers/query.js#default",
496
+ "input": {
497
+ "zod": "@kb-labs/mind-contracts#QueryRequestSchema"
498
+ },
499
+ "output": {
500
+ "zod": "@kb-labs/mind-contracts#AgentResponseSchema"
501
+ },
502
+ "timeoutMs": 120000
503
+ },
504
+ {
505
+ "method": "POST",
506
+ "path": "/explore",
507
+ "handler": "./rest/handlers/explore.js#default",
508
+ "input": {
509
+ "zod": "@kb-labs/mind-contracts#ExploreRequestSchema"
510
+ },
511
+ "output": {
512
+ "zod": "@kb-labs/mind-contracts#ExploreResponseSchema"
513
+ },
514
+ "timeoutMs": 120000
515
+ },
516
+ {
517
+ "method": "DELETE",
518
+ "path": "/index",
519
+ "handler": "./rest/handlers/drop.js#default",
520
+ "input": {
521
+ "zod": "@kb-labs/mind-contracts#DropRequestSchema"
522
+ },
523
+ "output": {
524
+ "zod": "@kb-labs/mind-contracts#DropResponseSchema"
525
+ }
526
+ },
527
+ {
528
+ "method": "GET",
529
+ "path": "/status",
530
+ "handler": "./rest/handlers/status.js#default",
531
+ "output": {
532
+ "zod": "@kb-labs/mind-contracts#StatusResponseSchema"
533
+ }
534
+ },
535
+ {
536
+ "method": "GET",
537
+ "path": "/health",
538
+ "handler": "./rest/handlers/health.js#default",
539
+ "output": {
540
+ "zod": "@kb-labs/mind-contracts#HealthResponseSchema"
541
+ }
542
+ },
543
+ {
544
+ "method": "POST",
545
+ "path": "/reindex",
546
+ "handler": "./rest/handlers/reindex.js#default",
547
+ "input": {
548
+ "zod": "@kb-labs/mind-contracts#ReindexRequestSchema"
549
+ },
550
+ "output": {
551
+ "zod": "@kb-labs/mind-contracts#IndexResponseSchema"
552
+ },
553
+ "timeoutMs": 600000
554
+ },
555
+ {
556
+ "method": "POST",
557
+ "path": "/sync/add",
558
+ "handler": "./rest/handlers/sync-add.js#default",
559
+ "input": {
560
+ "zod": "@kb-labs/mind-contracts#SyncAddRequestSchema"
561
+ },
562
+ "output": {
563
+ "zod": "@kb-labs/mind-contracts#SyncResponseSchema"
564
+ }
565
+ },
566
+ {
567
+ "method": "POST",
568
+ "path": "/sync/update",
569
+ "handler": "./rest/handlers/sync-update.js#default",
570
+ "input": {
571
+ "zod": "@kb-labs/mind-contracts#SyncUpdateRequestSchema"
572
+ },
573
+ "output": {
574
+ "zod": "@kb-labs/mind-contracts#SyncResponseSchema"
575
+ }
576
+ },
577
+ {
578
+ "method": "POST",
579
+ "path": "/sync/delete",
580
+ "handler": "./rest/handlers/sync-delete.js#default",
581
+ "input": {
582
+ "zod": "@kb-labs/mind-contracts#SyncDeleteRequestSchema"
583
+ },
584
+ "output": {
585
+ "zod": "@kb-labs/mind-contracts#SyncResponseSchema"
586
+ }
587
+ },
588
+ {
589
+ "method": "GET",
590
+ "path": "/sync/list",
591
+ "handler": "./rest/handlers/sync-list.js#default",
592
+ "output": {
593
+ "zod": "@kb-labs/mind-contracts#SyncListResponseSchema"
594
+ }
595
+ },
596
+ {
597
+ "method": "GET",
598
+ "path": "/sync/status",
599
+ "handler": "./rest/handlers/sync-status.js#default",
600
+ "output": {
601
+ "zod": "@kb-labs/mind-contracts#SyncStatusResponseSchema"
602
+ }
603
+ }
604
+ ]
605
+ }
606
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@kb-labs/mind-entry",
3
3
  "description": "Manifest, CLI commands and REST handlers for KB Labs Mind (RAG) plugin.",
4
- "version": "2.104.0",
4
+ "version": "2.106.0",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
7
7
  "types": "./dist/index.d.ts",
@@ -21,18 +21,30 @@
21
21
  "README.md",
22
22
  "LICENSE"
23
23
  ],
24
+ "scripts": {
25
+ "build": "tsup --config tsup.config.ts",
26
+ "clean": "rimraf dist",
27
+ "dev": "tsup --config tsup.config.ts --watch",
28
+ "lint": "eslint src --ext .ts",
29
+ "lint:fix": "eslint . --fix",
30
+ "pretype-check": "pnpm --filter @kb-labs/mind-entry build",
31
+ "test": "vitest run --passWithNoTests",
32
+ "test:cli": "vitest run --config vitest.cli.config.ts --passWithNoTests",
33
+ "test:watch": "vitest",
34
+ "type-check": "tsc --noEmit"
35
+ },
24
36
  "dependencies": {
25
- "@kb-labs/sdk": "2.22.0",
26
- "@kb-labs/mind-contracts": "2.104.0",
27
- "@kb-labs/mind-core": "2.104.0"
37
+ "@kb-labs/mind-contracts": "^2.106.0",
38
+ "@kb-labs/mind-core": "^2.106.0",
39
+ "@kb-labs/sdk": "workspace:*"
28
40
  },
29
41
  "devDependencies": {
42
+ "@kb-labs/devkit": "workspace:*",
30
43
  "@types/node": "^24.3.3",
31
44
  "rimraf": "^6.0.1",
32
45
  "tsup": "^8.5.0",
33
46
  "typescript": "^5.6.3",
34
- "vitest": "^3.2.6",
35
- "@kb-labs/devkit": "2.104.0"
47
+ "vitest": "^3.2.6"
36
48
  },
37
49
  "engines": {
38
50
  "node": ">=20.0.0",
@@ -41,17 +53,5 @@
41
53
  "kb": {
42
54
  "manifest": "./dist/manifest.js"
43
55
  },
44
- "sideEffects": false,
45
- "scripts": {
46
- "build": "tsup --config tsup.config.ts",
47
- "clean": "rimraf dist",
48
- "dev": "tsup --config tsup.config.ts --watch",
49
- "lint": "eslint src --ext .ts",
50
- "lint:fix": "eslint . --fix",
51
- "pretype-check": "pnpm --filter @kb-labs/mind-entry build",
52
- "test": "vitest run --passWithNoTests",
53
- "test:cli": "vitest run --config vitest.cli.config.ts --passWithNoTests",
54
- "test:watch": "vitest",
55
- "type-check": "tsc --noEmit"
56
- }
57
- }
56
+ "sideEffects": false
57
+ }