@framers/agentos 0.2.12 → 0.3.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 (178) hide show
  1. package/dist/ingest-router/executors/EntityExtractor.d.ts +23 -0
  2. package/dist/ingest-router/executors/EntityExtractor.d.ts.map +1 -0
  3. package/dist/ingest-router/executors/EntityExtractor.js +69 -0
  4. package/dist/ingest-router/executors/EntityExtractor.js.map +1 -0
  5. package/dist/ingest-router/executors/EntityLinkingIngestExecutor.d.ts +46 -0
  6. package/dist/ingest-router/executors/EntityLinkingIngestExecutor.d.ts.map +1 -0
  7. package/dist/ingest-router/executors/EntityLinkingIngestExecutor.js +45 -0
  8. package/dist/ingest-router/executors/EntityLinkingIngestExecutor.js.map +1 -0
  9. package/dist/ingest-router/executors/entity-types.d.ts +55 -0
  10. package/dist/ingest-router/executors/entity-types.d.ts.map +1 -0
  11. package/dist/ingest-router/executors/entity-types.js +17 -0
  12. package/dist/ingest-router/executors/entity-types.js.map +1 -0
  13. package/dist/ingest-router/executors/index.d.ts +7 -0
  14. package/dist/ingest-router/executors/index.d.ts.map +1 -1
  15. package/dist/ingest-router/executors/index.js +6 -0
  16. package/dist/ingest-router/executors/index.js.map +1 -1
  17. package/dist/ingest-router/index.d.ts +2 -2
  18. package/dist/ingest-router/index.d.ts.map +1 -1
  19. package/dist/ingest-router/index.js +1 -1
  20. package/dist/ingest-router/index.js.map +1 -1
  21. package/dist/memory/AgentMemory.js +1 -1
  22. package/dist/memory/AgentMemory.js.map +1 -1
  23. package/dist/memory/CognitiveMemoryManager.js +4 -4
  24. package/dist/memory/CognitiveMemoryManager.js.map +1 -1
  25. package/dist/memory/archive/IMemoryArchive.d.ts +2 -2
  26. package/dist/memory/archive/SqlStorageMemoryArchive.d.ts +17 -13
  27. package/dist/memory/archive/SqlStorageMemoryArchive.d.ts.map +1 -1
  28. package/dist/memory/archive/SqlStorageMemoryArchive.js +36 -28
  29. package/dist/memory/archive/SqlStorageMemoryArchive.js.map +1 -1
  30. package/dist/memory/core/config.d.ts +4 -4
  31. package/dist/memory/core/config.d.ts.map +1 -1
  32. package/dist/memory/index.d.ts +3 -3
  33. package/dist/memory/index.d.ts.map +1 -1
  34. package/dist/memory/index.js +3 -3
  35. package/dist/memory/index.js.map +1 -1
  36. package/dist/memory/io/ChatGptImporter.d.ts +5 -5
  37. package/dist/memory/io/ChatGptImporter.d.ts.map +1 -1
  38. package/dist/memory/io/ChatGptImporter.js +9 -7
  39. package/dist/memory/io/ChatGptImporter.js.map +1 -1
  40. package/dist/memory/io/CsvImporter.d.ts +4 -4
  41. package/dist/memory/io/CsvImporter.d.ts.map +1 -1
  42. package/dist/memory/io/CsvImporter.js +11 -8
  43. package/dist/memory/io/CsvImporter.js.map +1 -1
  44. package/dist/memory/io/JsonExporter.d.ts +5 -5
  45. package/dist/memory/io/JsonExporter.d.ts.map +1 -1
  46. package/dist/memory/io/JsonExporter.js +13 -12
  47. package/dist/memory/io/JsonExporter.js.map +1 -1
  48. package/dist/memory/io/JsonImporter.d.ts +5 -5
  49. package/dist/memory/io/JsonImporter.d.ts.map +1 -1
  50. package/dist/memory/io/JsonImporter.js +50 -34
  51. package/dist/memory/io/JsonImporter.js.map +1 -1
  52. package/dist/memory/io/MarkdownExporter.d.ts +4 -4
  53. package/dist/memory/io/MarkdownExporter.d.ts.map +1 -1
  54. package/dist/memory/io/MarkdownExporter.js +1 -1
  55. package/dist/memory/io/MarkdownExporter.js.map +1 -1
  56. package/dist/memory/io/MarkdownImporter.d.ts +6 -6
  57. package/dist/memory/io/MarkdownImporter.d.ts.map +1 -1
  58. package/dist/memory/io/MarkdownImporter.js +8 -7
  59. package/dist/memory/io/MarkdownImporter.js.map +1 -1
  60. package/dist/memory/io/ObsidianImporter.d.ts +4 -4
  61. package/dist/memory/io/ObsidianImporter.d.ts.map +1 -1
  62. package/dist/memory/io/ObsidianImporter.js +15 -10
  63. package/dist/memory/io/ObsidianImporter.js.map +1 -1
  64. package/dist/memory/io/SqliteExporter.d.ts +5 -5
  65. package/dist/memory/io/SqliteExporter.d.ts.map +1 -1
  66. package/dist/memory/io/SqliteExporter.js +3 -3
  67. package/dist/memory/io/SqliteExporter.js.map +1 -1
  68. package/dist/memory/io/SqliteImporter.d.ts +4 -4
  69. package/dist/memory/io/SqliteImporter.d.ts.map +1 -1
  70. package/dist/memory/io/SqliteImporter.js +23 -16
  71. package/dist/memory/io/SqliteImporter.js.map +1 -1
  72. package/dist/memory/io/facade/Memory.d.ts +58 -10
  73. package/dist/memory/io/facade/Memory.d.ts.map +1 -1
  74. package/dist/memory/io/facade/Memory.js +124 -50
  75. package/dist/memory/io/facade/Memory.js.map +1 -1
  76. package/dist/memory/io/facade/types.d.ts +1 -1
  77. package/dist/memory/io/index.d.ts +2 -2
  78. package/dist/memory/io/index.js +2 -2
  79. package/dist/memory/io/tools/MemoryAddTool.d.ts +2 -2
  80. package/dist/memory/io/tools/MemoryAddTool.d.ts.map +1 -1
  81. package/dist/memory/io/tools/MemoryAddTool.js +2 -2
  82. package/dist/memory/io/tools/MemoryAddTool.js.map +1 -1
  83. package/dist/memory/io/tools/MemoryDeleteTool.d.ts +2 -2
  84. package/dist/memory/io/tools/MemoryDeleteTool.d.ts.map +1 -1
  85. package/dist/memory/io/tools/MemoryDeleteTool.js +1 -1
  86. package/dist/memory/io/tools/MemoryDeleteTool.js.map +1 -1
  87. package/dist/memory/io/tools/MemoryMergeTool.d.ts +2 -2
  88. package/dist/memory/io/tools/MemoryMergeTool.d.ts.map +1 -1
  89. package/dist/memory/io/tools/MemoryMergeTool.js +4 -3
  90. package/dist/memory/io/tools/MemoryMergeTool.js.map +1 -1
  91. package/dist/memory/io/tools/MemoryReflectTool.d.ts +2 -2
  92. package/dist/memory/io/tools/MemoryReflectTool.d.ts.map +1 -1
  93. package/dist/memory/io/tools/MemoryReflectTool.js.map +1 -1
  94. package/dist/memory/io/tools/MemorySearchTool.d.ts +2 -2
  95. package/dist/memory/io/tools/MemorySearchTool.d.ts.map +1 -1
  96. package/dist/memory/io/tools/MemorySearchTool.js.map +1 -1
  97. package/dist/memory/io/tools/MemoryUpdateTool.d.ts +2 -2
  98. package/dist/memory/io/tools/MemoryUpdateTool.d.ts.map +1 -1
  99. package/dist/memory/io/tools/MemoryUpdateTool.js +5 -4
  100. package/dist/memory/io/tools/MemoryUpdateTool.js.map +1 -1
  101. package/dist/memory/pipeline/consolidation/ConsolidationLoop.d.ts +3 -3
  102. package/dist/memory/pipeline/consolidation/ConsolidationLoop.d.ts.map +1 -1
  103. package/dist/memory/pipeline/consolidation/ConsolidationLoop.js +22 -17
  104. package/dist/memory/pipeline/consolidation/ConsolidationLoop.js.map +1 -1
  105. package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.d.ts +3 -3
  106. package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.d.ts.map +1 -1
  107. package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.js +15 -12
  108. package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.js.map +1 -1
  109. package/dist/memory/retrieval/graph/index.d.ts +0 -1
  110. package/dist/memory/retrieval/graph/index.d.ts.map +1 -1
  111. package/dist/memory/retrieval/graph/index.js +4 -1
  112. package/dist/memory/retrieval/graph/index.js.map +1 -1
  113. package/dist/memory/retrieval/store/{SqliteBrain.d.ts → Brain.d.ts} +106 -23
  114. package/dist/memory/retrieval/store/Brain.d.ts.map +1 -0
  115. package/dist/memory/retrieval/store/Brain.js +898 -0
  116. package/dist/memory/retrieval/store/Brain.js.map +1 -0
  117. package/dist/memory/retrieval/store/HnswSidecar.d.ts +1 -1
  118. package/dist/memory/retrieval/store/HnswSidecar.js +1 -1
  119. package/dist/memory/retrieval/store/MemoryStore.d.ts +6 -6
  120. package/dist/memory/retrieval/store/MemoryStore.d.ts.map +1 -1
  121. package/dist/memory/retrieval/store/MemoryStore.js +10 -9
  122. package/dist/memory/retrieval/store/MemoryStore.js.map +1 -1
  123. package/dist/memory/retrieval/store/{SqliteKnowledgeGraph.d.ts → SqlKnowledgeGraph.d.ts} +12 -12
  124. package/dist/memory/retrieval/store/SqlKnowledgeGraph.d.ts.map +1 -0
  125. package/dist/memory/retrieval/store/{SqliteKnowledgeGraph.js → SqlKnowledgeGraph.js} +83 -64
  126. package/dist/memory/retrieval/store/SqlKnowledgeGraph.js.map +1 -0
  127. package/dist/memory/retrieval/store/{SqliteMemoryGraph.d.ts → SqlMemoryGraph.d.ts} +11 -11
  128. package/dist/memory/retrieval/store/SqlMemoryGraph.d.ts.map +1 -0
  129. package/dist/memory/retrieval/store/{SqliteMemoryGraph.js → SqlMemoryGraph.js} +26 -24
  130. package/dist/memory/retrieval/store/SqlMemoryGraph.js.map +1 -0
  131. package/dist/memory/retrieval/store/migrations/MigrationRunner.d.ts +50 -0
  132. package/dist/memory/retrieval/store/migrations/MigrationRunner.d.ts.map +1 -0
  133. package/dist/memory/retrieval/store/migrations/MigrationRunner.js +100 -0
  134. package/dist/memory/retrieval/store/migrations/MigrationRunner.js.map +1 -0
  135. package/dist/memory/retrieval/store/migrations/index.d.ts +20 -0
  136. package/dist/memory/retrieval/store/migrations/index.d.ts.map +1 -0
  137. package/dist/memory/retrieval/store/migrations/index.js +19 -0
  138. package/dist/memory/retrieval/store/migrations/index.js.map +1 -0
  139. package/dist/memory/retrieval/store/migrations/types.d.ts +28 -0
  140. package/dist/memory/retrieval/store/migrations/types.d.ts.map +1 -0
  141. package/dist/memory/retrieval/store/migrations/types.js +7 -0
  142. package/dist/memory/retrieval/store/migrations/types.js.map +1 -0
  143. package/dist/memory/retrieval/store/migrations/v1-to-v2.d.ts +40 -0
  144. package/dist/memory/retrieval/store/migrations/v1-to-v2.d.ts.map +1 -0
  145. package/dist/memory/retrieval/store/migrations/v1-to-v2.js +491 -0
  146. package/dist/memory/retrieval/store/migrations/v1-to-v2.js.map +1 -0
  147. package/dist/memory/retrieval/store/portable-tables.d.ts +27 -0
  148. package/dist/memory/retrieval/store/portable-tables.d.ts.map +1 -0
  149. package/dist/memory/retrieval/store/portable-tables.js +56 -0
  150. package/dist/memory/retrieval/store/portable-tables.js.map +1 -0
  151. package/dist/memory-router/backends/EntityRetrievalRanker.d.ts +54 -0
  152. package/dist/memory-router/backends/EntityRetrievalRanker.d.ts.map +1 -0
  153. package/dist/memory-router/backends/EntityRetrievalRanker.js +39 -0
  154. package/dist/memory-router/backends/EntityRetrievalRanker.js.map +1 -0
  155. package/dist/memory-router/backends/index.d.ts +16 -0
  156. package/dist/memory-router/backends/index.d.ts.map +1 -0
  157. package/dist/memory-router/backends/index.js +16 -0
  158. package/dist/memory-router/backends/index.js.map +1 -0
  159. package/dist/memory-router/index.d.ts +2 -0
  160. package/dist/memory-router/index.d.ts.map +1 -1
  161. package/dist/memory-router/index.js +4 -0
  162. package/dist/memory-router/index.js.map +1 -1
  163. package/dist/rag/utils/vectorMath.d.ts +1 -1
  164. package/dist/rag/utils/vectorMath.js +1 -1
  165. package/dist/rag/vector-search/HnswIndexSidecar.d.ts +1 -1
  166. package/dist/rag/vector-search/HnswIndexSidecar.js +1 -1
  167. package/package.json +2 -2
  168. package/dist/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.d.ts +0 -10
  169. package/dist/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.d.ts.map +0 -1
  170. package/dist/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.js +0 -10
  171. package/dist/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.js.map +0 -1
  172. package/dist/memory/retrieval/store/SqliteBrain.d.ts.map +0 -1
  173. package/dist/memory/retrieval/store/SqliteBrain.js +0 -553
  174. package/dist/memory/retrieval/store/SqliteBrain.js.map +0 -1
  175. package/dist/memory/retrieval/store/SqliteKnowledgeGraph.d.ts.map +0 -1
  176. package/dist/memory/retrieval/store/SqliteKnowledgeGraph.js.map +0 -1
  177. package/dist/memory/retrieval/store/SqliteMemoryGraph.d.ts.map +0 -1
  178. package/dist/memory/retrieval/store/SqliteMemoryGraph.js.map +0 -1
@@ -0,0 +1,39 @@
1
+ /**
2
+ * @file EntityRetrievalRanker.ts
3
+ * @description Mem0-v3-style recall-stage re-ranker. Adds an
4
+ * entity-overlap signal to the existing semantic-similarity score:
5
+ *
6
+ * combinedScore = (1 - entityWeight) * semanticScore
7
+ * + entityWeight * (overlap / queryEntityCount)
8
+ *
9
+ * Returns candidates sorted descending by combinedScore. The original
10
+ * fields (id, text, semanticScore, entities) are preserved alongside
11
+ * the new combinedScore + entityOverlap.
12
+ *
13
+ * The query's entities are extracted via {@link EntityExtractor} so
14
+ * this ranker is end-to-end self-contained: pass a query string and
15
+ * candidate list, get a re-ranked list back.
16
+ *
17
+ * Reference: docs.mem0.ai/migration/oss-v2-to-v3.
18
+ *
19
+ * @module @framers/agentos/memory-router/backends/EntityRetrievalRanker
20
+ */
21
+ import { EntityExtractor } from '../../ingest-router/executors/EntityExtractor.js';
22
+ export class EntityRetrievalRanker {
23
+ constructor(opts) {
24
+ this.extractor = new EntityExtractor();
25
+ this.entityWeight = opts.entityWeight;
26
+ }
27
+ rank(query, candidates) {
28
+ const queryEntities = new Set(this.extractor.extract(query).entities.map((e) => e.text));
29
+ const queryEntityCount = queryEntities.size;
30
+ const scored = candidates.map((c) => {
31
+ const overlap = c.entities.filter((e) => queryEntities.has(e)).length;
32
+ const overlapRatio = queryEntityCount > 0 ? overlap / queryEntityCount : 0;
33
+ const combinedScore = (1 - this.entityWeight) * c.semanticScore + this.entityWeight * overlapRatio;
34
+ return { ...c, combinedScore, entityOverlap: overlap };
35
+ });
36
+ return scored.sort((a, b) => b.combinedScore - a.combinedScore);
37
+ }
38
+ }
39
+ //# sourceMappingURL=EntityRetrievalRanker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EntityRetrievalRanker.js","sourceRoot":"","sources":["../../../src/memory-router/backends/EntityRetrievalRanker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAgCnF,MAAM,OAAO,qBAAqB;IAIhC,YAAY,IAAkC;QAF7B,cAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QAGjD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,UAA6B;QAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC;QAE5C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAA2B,CAAC,CAAC,EAAE,EAAE;YAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtE,MAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3E,MAAM,aAAa,GACjB,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YAC/E,OAAO,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;CACF"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @file backends/index.ts
3
+ * @description Sub-barrel for MemoryRouter recall-side backends. The
4
+ * top-level `@framers/agentos/memory-router` barrel re-exports these
5
+ * symbols so consumers can write
6
+ * `import { EntityRetrievalRanker } from '../../memory-router'`.
7
+ *
8
+ * Reference recall-stage components ship in agentos core so the
9
+ * memory-router strategy IDs work out of the box.
10
+ */
11
+ export { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
12
+ export type { RankedCandidate, RankedCandidateWithBoost, EntityRetrievalRankerOptions, } from './EntityRetrievalRanker.js';
13
+ import { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
14
+ import type { EntityRetrievalRankerOptions } from './EntityRetrievalRanker.js';
15
+ export declare function createEntityRetrievalRanker(opts: EntityRetrievalRankerOptions): EntityRetrievalRanker;
16
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory-router/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE/E,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,4BAA4B,GACjC,qBAAqB,CAEvB"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @file backends/index.ts
3
+ * @description Sub-barrel for MemoryRouter recall-side backends. The
4
+ * top-level `@framers/agentos/memory-router` barrel re-exports these
5
+ * symbols so consumers can write
6
+ * `import { EntityRetrievalRanker } from '../../memory-router'`.
7
+ *
8
+ * Reference recall-stage components ship in agentos core so the
9
+ * memory-router strategy IDs work out of the box.
10
+ */
11
+ export { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
12
+ import { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
13
+ export function createEntityRetrievalRanker(opts) {
14
+ return new EntityRetrievalRanker(opts);
15
+ }
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory-router/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,MAAM,UAAU,2BAA2B,CACzC,IAAkC;IAElC,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}
@@ -123,4 +123,6 @@ export { FunctionMemoryDispatcher, UnsupportedMemoryBackendError, } from './disp
123
123
  export { MemoryRouter, MemoryRouterDispatcherMissingError, } from './MemoryRouter.js';
124
124
  export type { CalibrationSample, CalibrationCell, AggregatedCalibration, AdaptivePresetRule, SelectByPresetArgs, BuildAdaptiveRoutingTableArgs, AdaptiveMemoryRouterOptions, } from './adaptive.js';
125
125
  export { aggregateCalibration, selectByPreset, buildAdaptiveRoutingTable, AdaptiveMemoryRouter, } from './adaptive.js';
126
+ export { EntityRetrievalRanker, createEntityRetrievalRanker, } from './backends/index.js';
127
+ export type { RankedCandidate, RankedCandidateWithBoost, EntityRetrievalRankerOptions, } from './backends/index.js';
126
128
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAMH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAMH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC"}
@@ -119,4 +119,8 @@ export { CLASSIFIER_SYSTEM_PROMPT, CLASSIFIER_SYSTEM_PROMPT_FEWSHOT, SAFE_FALLBA
119
119
  export { FunctionMemoryDispatcher, UnsupportedMemoryBackendError, } from './dispatcher.js';
120
120
  export { MemoryRouter, MemoryRouterDispatcherMissingError, } from './MemoryRouter.js';
121
121
  export { aggregateCalibration, selectByPreset, buildAdaptiveRoutingTable, AdaptiveMemoryRouter, } from './adaptive.js';
122
+ // ============================================================================
123
+ // Reference recall-stage backends (Stage I: Mem0-v3-style entity-linking)
124
+ // ============================================================================
125
+ export { EntityRetrievalRanker, createEntityRetrievalRanker, } from './backends/index.js';
122
126
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAYH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAoC9D,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAgB3B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AAYH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAoC9D,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAgB3B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAE/E,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC"}
@@ -4,7 +4,7 @@
4
4
  *
5
5
  * Single source of truth for vector math across the entire AgentOS codebase.
6
6
  * Replaces 6+ duplicate implementations scattered across SqlVectorStore,
7
- * InMemoryVectorStore, KnowledgeGraph, SqliteKnowledgeGraph,
7
+ * InMemoryVectorStore, KnowledgeGraph, SqlKnowledgeGraph,
8
8
  * ConsolidationLoop, ProspectiveMemoryManager, and ChunkingEngine.
9
9
  *
10
10
  * Optimized for hot-loop performance:
@@ -4,7 +4,7 @@
4
4
  *
5
5
  * Single source of truth for vector math across the entire AgentOS codebase.
6
6
  * Replaces 6+ duplicate implementations scattered across SqlVectorStore,
7
- * InMemoryVectorStore, KnowledgeGraph, SqliteKnowledgeGraph,
7
+ * InMemoryVectorStore, KnowledgeGraph, SqlKnowledgeGraph,
8
8
  * ConsolidationLoop, ProspectiveMemoryManager, and ChunkingEngine.
9
9
  *
10
10
  * Optimized for hot-loop performance:
@@ -4,7 +4,7 @@
4
4
  * with automatic activation at a configurable document count threshold
5
5
  * and graceful fallback when the native addon is unavailable.
6
6
  *
7
- * Used by both the RAG system (SqlVectorStore) and the Memory system (SqliteBrain).
7
+ * Used by both the RAG system (SqlVectorStore) and the Memory system (Brain).
8
8
  *
9
9
  * @module agentos/rag/vector-search/HnswIndexSidecar
10
10
  */
@@ -4,7 +4,7 @@
4
4
  * with automatic activation at a configurable document count threshold
5
5
  * and graceful fallback when the native addon is unavailable.
6
6
  *
7
- * Used by both the RAG system (SqlVectorStore) and the Memory system (SqliteBrain).
7
+ * Used by both the RAG system (SqlVectorStore) and the Memory system (Brain).
8
8
  *
9
9
  * @module agentos/rag/vector-search/HnswIndexSidecar
10
10
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@framers/agentos",
3
- "version": "0.2.12",
3
+ "version": "0.3.1",
4
4
  "description": "Modular AgentOS orchestration library",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -371,7 +371,7 @@
371
371
  "@types/natural": "^5.1.5",
372
372
  "@types/node": "^20.12.12",
373
373
  "@types/pg": "^8.20.0",
374
- "better-sqlite3": "^12.6.2",
374
+ "better-sqlite3": "^12.9.0",
375
375
  "conventional-changelog-conventionalcommits": "^7.0.2",
376
376
  "eslint": "^9.11.0",
377
377
  "eslint-config-prettier": "^9.1.0",
@@ -1,10 +0,0 @@
1
- /**
2
- * Compatibility export for the SQLite-backed knowledge graph.
3
- *
4
- * The canonical implementation lives under `memory/retrieval/store/` because
5
- * it depends on `SqliteBrain` and the storage-adapter feature bundle. This
6
- * wrapper keeps the older `memory/retrieval/graph/knowledge/...` import path
7
- * working without maintaining a second copy of the class.
8
- */
9
- export { SqliteKnowledgeGraph } from '../../store/SqliteKnowledgeGraph.js';
10
- //# sourceMappingURL=SqliteKnowledgeGraph.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SqliteKnowledgeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}
@@ -1,10 +0,0 @@
1
- /**
2
- * Compatibility export for the SQLite-backed knowledge graph.
3
- *
4
- * The canonical implementation lives under `memory/retrieval/store/` because
5
- * it depends on `SqliteBrain` and the storage-adapter feature bundle. This
6
- * wrapper keeps the older `memory/retrieval/graph/knowledge/...` import path
7
- * working without maintaining a second copy of the class.
8
- */
9
- export { SqliteKnowledgeGraph } from '../../store/SqliteKnowledgeGraph.js';
10
- //# sourceMappingURL=SqliteKnowledgeGraph.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SqliteKnowledgeGraph.js","sourceRoot":"","sources":["../../../../../src/memory/retrieval/graph/knowledge/SqliteKnowledgeGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"SqliteBrain.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/store/SqliteBrain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AA2QtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAW;IACtB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAM5C;;;;;OAKG;IACH,OAAO;IASP;;;;;;;;;;;;;;;;OAgBG;WACU,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BvD;;;;;OAKG;WACU,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQzD;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7E;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIlF;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI7E;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzE;;;;;OAKG;IACH,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,eAAe,CAE9B;IAMD;;;;OAIG;YACW,WAAW;IA4CzB;;;OAGG;YACW,SAAS;IAmBvB;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASvD;;;;;;;;OAQG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD;;;;;;;;;;;;OAYG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhE;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}