memories-lite 0.10.1 → 0.99.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.
Files changed (23) hide show
  1. package/dist/config/defaults.js +11 -4
  2. package/dist/config/manager.js +2 -4
  3. package/dist/memory/index.d.ts +11 -0
  4. package/dist/memory/index.js +62 -124
  5. package/dist/memory/memory.types.d.ts +1 -2
  6. package/dist/prompts/index.d.ts +53 -17
  7. package/dist/prompts/index.js +63 -23
  8. package/dist/types/index.d.ts +28 -137
  9. package/dist/types/index.js +2 -8
  10. package/memories-lite-a42ac5108869b599bcbac21069f63fb47f07452fcc4b87e89b3c06a945612d0b.db +0 -0
  11. package/memories-lite-a9137698d8d3fdbf27efcdc8cd372084b52d484e8db866c5455bbb3f85299b54.db +0 -0
  12. package/package.json +1 -1
  13. package/src/config/defaults.ts +11 -4
  14. package/src/config/manager.ts +2 -4
  15. package/src/memory/index.ts +76 -158
  16. package/src/memory/memory.types.ts +1 -2
  17. package/src/prompts/index.ts +69 -26
  18. package/src/types/index.ts +4 -11
  19. package/tests/lite.spec.ts +44 -34
  20. package/tests/memory.discussion.test.ts +279 -0
  21. package/tests/memory.update.test.ts +5 -1
  22. package/tests/memory.facts.test.ts +0 -175
  23. package/tests/memory.todo.test.ts +0 -126
package/dist/types/index.d.ts CHANGED
@@ -62,9 +62,8 @@ export interface MemoryTypeConfig {
62
62
  halfLifeDays: number;
63
63
  }
64
64
  export interface MemoryScoringConfig {
65
- todo: MemoryTypeConfig;
66
- factual: MemoryTypeConfig;
67
65
  assistant_preference: MemoryTypeConfig;
66
+ discussion: MemoryTypeConfig;
68
67
  default: MemoryTypeConfig;
69
68
  }
70
69
  export interface MemoryConfig {
@@ -89,7 +88,7 @@ export interface MemoryConfig {
89
88
  graphStore?: GraphStoreConfig;
90
89
  enableGraph?: boolean;
91
90
  }
92
- export type MemoryType = 'todo' | 'factual' | 'assistant_preference';
91
+ export type MemoryType = 'assistant_preference' | 'discussion';
93
92
  export interface MemoryItem {
94
93
  id: string;
95
94
  memory: string;
@@ -169,7 +168,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
169
168
  dimension: z.ZodOptional<z.ZodNumber>;
170
169
  client: z.ZodOptional<z.ZodAny>;
171
170
  scoring: z.ZodOptional<z.ZodObject<{
172
- todo: z.ZodObject<{
171
+ assistant_preference: z.ZodObject<{
173
172
  alpha: z.ZodNumber;
174
173
  beta: z.ZodNumber;
175
174
  gamma: z.ZodNumber;
@@ -185,23 +184,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
185
184
  gamma: number;
186
185
  halfLifeDays: number;
187
186
  }>;
188
- factual: z.ZodObject<{
189
- alpha: z.ZodNumber;
190
- beta: z.ZodNumber;
191
- gamma: z.ZodNumber;
192
- halfLifeDays: z.ZodNumber;
193
- }, "strip", z.ZodTypeAny, {
194
- alpha: number;
195
- beta: number;
196
- gamma: number;
197
- halfLifeDays: number;
198
- }, {
199
- alpha: number;
200
- beta: number;
201
- gamma: number;
202
- halfLifeDays: number;
203
- }>;
204
- assistant_preference: z.ZodObject<{
187
+ discussion: z.ZodObject<{
205
188
  alpha: z.ZodNumber;
206
189
  beta: z.ZodNumber;
207
190
  gamma: z.ZodNumber;
@@ -234,19 +217,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
234
217
  halfLifeDays: number;
235
218
  }>;
236
219
  }, "strip", z.ZodTypeAny, {
237
- todo: {
238
- alpha: number;
239
- beta: number;
240
- gamma: number;
241
- halfLifeDays: number;
242
- };
243
- factual: {
220
+ assistant_preference: {
244
221
  alpha: number;
245
222
  beta: number;
246
223
  gamma: number;
247
224
  halfLifeDays: number;
248
225
  };
249
- assistant_preference: {
226
+ discussion: {
250
227
  alpha: number;
251
228
  beta: number;
252
229
  gamma: number;
@@ -259,19 +236,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
259
236
  halfLifeDays: number;
260
237
  };
261
238
  }, {
262
- todo: {
263
- alpha: number;
264
- beta: number;
265
- gamma: number;
266
- halfLifeDays: number;
267
- };
268
- factual: {
239
+ assistant_preference: {
269
240
  alpha: number;
270
241
  beta: number;
271
242
  gamma: number;
272
243
  halfLifeDays: number;
273
244
  };
274
- assistant_preference: {
245
+ discussion: {
275
246
  alpha: number;
276
247
  beta: number;
277
248
  gamma: number;
@@ -290,23 +261,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
290
261
  dimension: z.ZodOptional<z.ZodNumber>;
291
262
  client: z.ZodOptional<z.ZodAny>;
292
263
  scoring: z.ZodOptional<z.ZodObject<{
293
- todo: z.ZodObject<{
294
- alpha: z.ZodNumber;
295
- beta: z.ZodNumber;
296
- gamma: z.ZodNumber;
297
- halfLifeDays: z.ZodNumber;
298
- }, "strip", z.ZodTypeAny, {
299
- alpha: number;
300
- beta: number;
301
- gamma: number;
302
- halfLifeDays: number;
303
- }, {
304
- alpha: number;
305
- beta: number;
306
- gamma: number;
307
- halfLifeDays: number;
308
- }>;
309
- factual: z.ZodObject<{
264
+ assistant_preference: z.ZodObject<{
310
265
  alpha: z.ZodNumber;
311
266
  beta: z.ZodNumber;
312
267
  gamma: z.ZodNumber;
@@ -322,7 +277,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
322
277
  gamma: number;
323
278
  halfLifeDays: number;
324
279
  }>;
325
- assistant_preference: z.ZodObject<{
280
+ discussion: z.ZodObject<{
326
281
  alpha: z.ZodNumber;
327
282
  beta: z.ZodNumber;
328
283
  gamma: z.ZodNumber;
@@ -355,19 +310,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
355
310
  halfLifeDays: number;
356
311
  }>;
357
312
  }, "strip", z.ZodTypeAny, {
358
- todo: {
313
+ assistant_preference: {
359
314
  alpha: number;
360
315
  beta: number;
361
316
  gamma: number;
362
317
  halfLifeDays: number;
363
318
  };
364
- factual: {
365
- alpha: number;
366
- beta: number;
367
- gamma: number;
368
- halfLifeDays: number;
369
- };
370
- assistant_preference: {
319
+ discussion: {
371
320
  alpha: number;
372
321
  beta: number;
373
322
  gamma: number;
@@ -380,19 +329,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
380
329
  halfLifeDays: number;
381
330
  };
382
331
  }, {
383
- todo: {
332
+ assistant_preference: {
384
333
  alpha: number;
385
334
  beta: number;
386
335
  gamma: number;
387
336
  halfLifeDays: number;
388
337
  };
389
- factual: {
390
- alpha: number;
391
- beta: number;
392
- gamma: number;
393
- halfLifeDays: number;
394
- };
395
- assistant_preference: {
338
+ discussion: {
396
339
  alpha: number;
397
340
  beta: number;
398
341
  gamma: number;
@@ -411,23 +354,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
411
354
  dimension: z.ZodOptional<z.ZodNumber>;
412
355
  client: z.ZodOptional<z.ZodAny>;
413
356
  scoring: z.ZodOptional<z.ZodObject<{
414
- todo: z.ZodObject<{
415
- alpha: z.ZodNumber;
416
- beta: z.ZodNumber;
417
- gamma: z.ZodNumber;
418
- halfLifeDays: z.ZodNumber;
419
- }, "strip", z.ZodTypeAny, {
420
- alpha: number;
421
- beta: number;
422
- gamma: number;
423
- halfLifeDays: number;
424
- }, {
425
- alpha: number;
426
- beta: number;
427
- gamma: number;
428
- halfLifeDays: number;
429
- }>;
430
- factual: z.ZodObject<{
357
+ assistant_preference: z.ZodObject<{
431
358
  alpha: z.ZodNumber;
432
359
  beta: z.ZodNumber;
433
360
  gamma: z.ZodNumber;
@@ -443,7 +370,7 @@ export declare const MemoryConfigSchema: z.ZodObject<{
443
370
  gamma: number;
444
371
  halfLifeDays: number;
445
372
  }>;
446
- assistant_preference: z.ZodObject<{
373
+ discussion: z.ZodObject<{
447
374
  alpha: z.ZodNumber;
448
375
  beta: z.ZodNumber;
449
376
  gamma: z.ZodNumber;
@@ -476,19 +403,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
476
403
  halfLifeDays: number;
477
404
  }>;
478
405
  }, "strip", z.ZodTypeAny, {
479
- todo: {
480
- alpha: number;
481
- beta: number;
482
- gamma: number;
483
- halfLifeDays: number;
484
- };
485
- factual: {
406
+ assistant_preference: {
486
407
  alpha: number;
487
408
  beta: number;
488
409
  gamma: number;
489
410
  halfLifeDays: number;
490
411
  };
491
- assistant_preference: {
412
+ discussion: {
492
413
  alpha: number;
493
414
  beta: number;
494
415
  gamma: number;
@@ -501,19 +422,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
501
422
  halfLifeDays: number;
502
423
  };
503
424
  }, {
504
- todo: {
505
- alpha: number;
506
- beta: number;
507
- gamma: number;
508
- halfLifeDays: number;
509
- };
510
- factual: {
425
+ assistant_preference: {
511
426
  alpha: number;
512
427
  beta: number;
513
428
  gamma: number;
514
429
  halfLifeDays: number;
515
430
  };
516
- assistant_preference: {
431
+ discussion: {
517
432
  alpha: number;
518
433
  beta: number;
519
434
  gamma: number;
@@ -535,19 +450,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
535
450
  dimension?: number | undefined;
536
451
  client?: any;
537
452
  scoring?: {
538
- todo: {
453
+ assistant_preference: {
539
454
  alpha: number;
540
455
  beta: number;
541
456
  gamma: number;
542
457
  halfLifeDays: number;
543
458
  };
544
- factual: {
545
- alpha: number;
546
- beta: number;
547
- gamma: number;
548
- halfLifeDays: number;
549
- };
550
- assistant_preference: {
459
+ discussion: {
551
460
  alpha: number;
552
461
  beta: number;
553
462
  gamma: number;
@@ -571,19 +480,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
571
480
  dimension?: number | undefined;
572
481
  client?: any;
573
482
  scoring?: {
574
- todo: {
575
- alpha: number;
576
- beta: number;
577
- gamma: number;
578
- halfLifeDays: number;
579
- };
580
- factual: {
483
+ assistant_preference: {
581
484
  alpha: number;
582
485
  beta: number;
583
486
  gamma: number;
584
487
  halfLifeDays: number;
585
488
  };
586
- assistant_preference: {
489
+ discussion: {
587
490
  alpha: number;
588
491
  beta: number;
589
492
  gamma: number;
@@ -713,19 +616,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
713
616
  dimension?: number | undefined;
714
617
  client?: any;
715
618
  scoring?: {
716
- todo: {
717
- alpha: number;
718
- beta: number;
719
- gamma: number;
720
- halfLifeDays: number;
721
- };
722
- factual: {
619
+ assistant_preference: {
723
620
  alpha: number;
724
621
  beta: number;
725
622
  gamma: number;
726
623
  halfLifeDays: number;
727
624
  };
728
- assistant_preference: {
625
+ discussion: {
729
626
  alpha: number;
730
627
  beta: number;
731
628
  gamma: number;
@@ -790,19 +687,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
790
687
  dimension?: number | undefined;
791
688
  client?: any;
792
689
  scoring?: {
793
- todo: {
794
- alpha: number;
795
- beta: number;
796
- gamma: number;
797
- halfLifeDays: number;
798
- };
799
- factual: {
690
+ assistant_preference: {
800
691
  alpha: number;
801
692
  beta: number;
802
693
  gamma: number;
803
694
  halfLifeDays: number;
804
695
  };
805
- assistant_preference: {
696
+ discussion: {
806
697
  alpha: number;
807
698
  beta: number;
808
699
  gamma: number;
package/dist/types/index.js CHANGED
@@ -21,19 +21,13 @@ exports.MemoryConfigSchema = zod_1.z.object({
21
21
  dimension: zod_1.z.number().optional(),
22
22
  client: zod_1.z.any().optional(),
23
23
  scoring: zod_1.z.object({
24
- todo: zod_1.z.object({
25
- alpha: zod_1.z.number(),
26
- beta: zod_1.z.number(),
27
- gamma: zod_1.z.number(),
28
- halfLifeDays: zod_1.z.number(),
29
- }),
30
- factual: zod_1.z.object({
24
+ assistant_preference: zod_1.z.object({
31
25
  alpha: zod_1.z.number(),
32
26
  beta: zod_1.z.number(),
33
27
  gamma: zod_1.z.number(),
34
28
  halfLifeDays: zod_1.z.number(),
35
29
  }),
36
- assistant_preference: zod_1.z.object({
30
+ discussion: zod_1.z.object({
37
31
  alpha: zod_1.z.number(),
38
32
  beta: zod_1.z.number(),
39
33
  gamma: zod_1.z.number(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memories-lite",
3
- "version": "0.10.1",
3
+ "version": "0.99.1",
4
4
  "description": "A lightweight memory system for LLM agents",
5
5
  "author": "olivier@evaletolab.ch",
6
6
  "main": "dist/index.js",
package/src/config/defaults.ts CHANGED
@@ -1,11 +1,18 @@
1
1
  import { MemoryConfig, MemoryScoringConfig } from "../types";
2
2
 
3
3
  const DEFAULT_SCORING_CONFIG: MemoryScoringConfig = {
4
- // Focused on user preferences with AI - removed episodic and procedural memories
5
- todo: { alpha: 0.40, beta: 0.50, gamma: 0.10, halfLifeDays: 40 }, // ~40 days
6
- factual: { alpha: 0.70, beta: 0.20, gamma: 0.10, halfLifeDays: 150 }, // ~150 days
4
+ //
5
+ // assistant_preference: préférences utilisateur avec l'assistant (style, langue, etc.)
7
6
  assistant_preference: { alpha: 0.60, beta: 0.05, gamma: 0.35, halfLifeDays: Infinity },
8
- default: { alpha: 0.5, beta: 0.3, gamma: 0.1, halfLifeDays: 30 } // Fallback default
7
+ //
8
+ // discussion: mémoires de discussions (synthèses opérationnelles)
9
+ // - alpha=0: pas de cosine dans le score final
10
+ // - beta=1: score basé sur recency (constant car halfLife=∞)
11
+ // - gamma=0: pas d'importance base
12
+ discussion: { alpha: 0, beta: 1, gamma: 0, halfLifeDays: Infinity },
13
+ //
14
+ // default: fallback si type manquant ou inconnu
15
+ default: { alpha: 0.5, beta: 0.3, gamma: 0.1, halfLifeDays: 30 }
9
16
  };
10
17
 
11
18
  export const DEFAULT_MEMORY_CONFIG: MemoryConfig = {
package/src/config/manager.ts CHANGED
@@ -51,9 +51,8 @@ export class ConfigManager {
51
51
  dimension: userConf.dimension || defaultConf.dimension,
52
52
  // Merge scoring deeply if present in userConf, otherwise use default
53
53
  scoring: userConf.scoring ? {
54
- todo: { ...defaultConf.scoring?.todo, ...userConf.scoring.todo },
55
- factual: { ...defaultConf.scoring?.factual, ...userConf.scoring.factual },
56
54
  assistant_preference: { ...defaultConf.scoring?.assistant_preference, ...userConf.scoring.assistant_preference },
55
+ discussion: { ...defaultConf.scoring?.discussion, ...userConf.scoring.discussion },
57
56
  default: { ...defaultConf.scoring?.default, ...userConf.scoring.default },
58
57
  } : defaultConf.scoring,
59
58
  ...userConf, // Include any other passthrough fields from user
@@ -67,9 +66,8 @@ export class ConfigManager {
67
66
  client: undefined,
68
67
  // Merge scoring deeply if present in userConf, otherwise use default
69
68
  scoring: userConf?.scoring ? {
70
- todo: { ...defaultConf.scoring?.todo, ...userConf.scoring.todo },
71
- factual: { ...defaultConf.scoring?.factual, ...userConf.scoring.factual },
72
69
  assistant_preference: { ...defaultConf.scoring?.assistant_preference, ...userConf.scoring.assistant_preference },
70
+ discussion: { ...defaultConf.scoring?.discussion, ...userConf.scoring.discussion },
73
71
  default: { ...defaultConf.scoring?.default, ...userConf.scoring.default },
74
72
  } : defaultConf.scoring,
75
73
  recencyCleanupThreshold: