@mnemoai/core 1.1.0 → 1.1.2

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 (220) hide show
  1. package/dist/cli.d.ts +2 -0
  2. package/dist/cli.d.ts.map +1 -0
  3. package/dist/cli.js +7 -0
  4. package/dist/cli.js.map +7 -0
  5. package/dist/index.d.ts +136 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/{index.ts → dist/index.js} +537 -1333
  8. package/dist/index.js.map +7 -0
  9. package/dist/src/access-tracker.d.ts +97 -0
  10. package/dist/src/access-tracker.d.ts.map +1 -0
  11. package/dist/src/access-tracker.js +184 -0
  12. package/dist/src/access-tracker.js.map +7 -0
  13. package/dist/src/adapters/chroma.d.ts +31 -0
  14. package/dist/src/adapters/chroma.d.ts.map +1 -0
  15. package/{src/adapters/chroma.ts → dist/src/adapters/chroma.js} +45 -107
  16. package/dist/src/adapters/chroma.js.map +7 -0
  17. package/dist/src/adapters/lancedb.d.ts +29 -0
  18. package/dist/src/adapters/lancedb.d.ts.map +1 -0
  19. package/{src/adapters/lancedb.ts → dist/src/adapters/lancedb.js} +41 -109
  20. package/dist/src/adapters/lancedb.js.map +7 -0
  21. package/dist/src/adapters/pgvector.d.ts +33 -0
  22. package/dist/src/adapters/pgvector.d.ts.map +1 -0
  23. package/{src/adapters/pgvector.ts → dist/src/adapters/pgvector.js} +42 -104
  24. package/dist/src/adapters/pgvector.js.map +7 -0
  25. package/dist/src/adapters/qdrant.d.ts +34 -0
  26. package/dist/src/adapters/qdrant.d.ts.map +1 -0
  27. package/dist/src/adapters/qdrant.js +132 -0
  28. package/dist/src/adapters/qdrant.js.map +7 -0
  29. package/dist/src/adaptive-retrieval.d.ts +14 -0
  30. package/dist/src/adaptive-retrieval.d.ts.map +1 -0
  31. package/dist/src/adaptive-retrieval.js +52 -0
  32. package/dist/src/adaptive-retrieval.js.map +7 -0
  33. package/dist/src/audit-log.d.ts +56 -0
  34. package/dist/src/audit-log.d.ts.map +1 -0
  35. package/dist/src/audit-log.js +139 -0
  36. package/dist/src/audit-log.js.map +7 -0
  37. package/dist/src/chunker.d.ts +45 -0
  38. package/dist/src/chunker.d.ts.map +1 -0
  39. package/dist/src/chunker.js +157 -0
  40. package/dist/src/chunker.js.map +7 -0
  41. package/dist/src/config.d.ts +70 -0
  42. package/dist/src/config.d.ts.map +1 -0
  43. package/dist/src/config.js +142 -0
  44. package/dist/src/config.js.map +7 -0
  45. package/dist/src/decay-engine.d.ts +73 -0
  46. package/dist/src/decay-engine.d.ts.map +1 -0
  47. package/dist/src/decay-engine.js +119 -0
  48. package/dist/src/decay-engine.js.map +7 -0
  49. package/dist/src/embedder.d.ts +94 -0
  50. package/dist/src/embedder.d.ts.map +1 -0
  51. package/{src/embedder.ts → dist/src/embedder.js} +119 -317
  52. package/dist/src/embedder.js.map +7 -0
  53. package/dist/src/extraction-prompts.d.ts +12 -0
  54. package/dist/src/extraction-prompts.d.ts.map +1 -0
  55. package/dist/src/extraction-prompts.js +311 -0
  56. package/dist/src/extraction-prompts.js.map +7 -0
  57. package/dist/src/license.d.ts +29 -0
  58. package/dist/src/license.d.ts.map +1 -0
  59. package/{src/license.ts → dist/src/license.js} +42 -113
  60. package/dist/src/license.js.map +7 -0
  61. package/dist/src/llm-client.d.ts +23 -0
  62. package/dist/src/llm-client.d.ts.map +1 -0
  63. package/{src/llm-client.ts → dist/src/llm-client.js} +22 -55
  64. package/dist/src/llm-client.js.map +7 -0
  65. package/dist/src/logger.d.ts +33 -0
  66. package/dist/src/logger.d.ts.map +1 -0
  67. package/dist/src/logger.js +35 -0
  68. package/dist/src/logger.js.map +7 -0
  69. package/dist/src/mcp-server.d.ts +16 -0
  70. package/dist/src/mcp-server.d.ts.map +1 -0
  71. package/{src/mcp-server.ts → dist/src/mcp-server.js} +81 -181
  72. package/dist/src/mcp-server.js.map +7 -0
  73. package/dist/src/memory-categories.d.ts +40 -0
  74. package/dist/src/memory-categories.d.ts.map +1 -0
  75. package/dist/src/memory-categories.js +33 -0
  76. package/dist/src/memory-categories.js.map +7 -0
  77. package/dist/src/memory-upgrader.d.ts +71 -0
  78. package/dist/src/memory-upgrader.d.ts.map +1 -0
  79. package/dist/src/memory-upgrader.js +238 -0
  80. package/dist/src/memory-upgrader.js.map +7 -0
  81. package/dist/src/migrate.d.ts +47 -0
  82. package/dist/src/migrate.d.ts.map +1 -0
  83. package/{src/migrate.ts → dist/src/migrate.js} +57 -165
  84. package/dist/src/migrate.js.map +7 -0
  85. package/dist/src/mnemo.d.ts +67 -0
  86. package/dist/src/mnemo.d.ts.map +1 -0
  87. package/dist/src/mnemo.js +66 -0
  88. package/dist/src/mnemo.js.map +7 -0
  89. package/dist/src/noise-filter.d.ts +23 -0
  90. package/dist/src/noise-filter.d.ts.map +1 -0
  91. package/dist/src/noise-filter.js +62 -0
  92. package/dist/src/noise-filter.js.map +7 -0
  93. package/dist/src/noise-prototypes.d.ts +40 -0
  94. package/dist/src/noise-prototypes.d.ts.map +1 -0
  95. package/dist/src/noise-prototypes.js +116 -0
  96. package/dist/src/noise-prototypes.js.map +7 -0
  97. package/dist/src/observability.d.ts +16 -0
  98. package/dist/src/observability.d.ts.map +1 -0
  99. package/dist/src/observability.js +53 -0
  100. package/dist/src/observability.js.map +7 -0
  101. package/dist/src/query-tracker.d.ts +27 -0
  102. package/dist/src/query-tracker.d.ts.map +1 -0
  103. package/dist/src/query-tracker.js +32 -0
  104. package/dist/src/query-tracker.js.map +7 -0
  105. package/dist/src/reflection-event-store.d.ts +44 -0
  106. package/dist/src/reflection-event-store.d.ts.map +1 -0
  107. package/dist/src/reflection-event-store.js +50 -0
  108. package/dist/src/reflection-event-store.js.map +7 -0
  109. package/dist/src/reflection-item-store.d.ts +58 -0
  110. package/dist/src/reflection-item-store.d.ts.map +1 -0
  111. package/dist/src/reflection-item-store.js +69 -0
  112. package/dist/src/reflection-item-store.js.map +7 -0
  113. package/dist/src/reflection-mapped-metadata.d.ts +47 -0
  114. package/dist/src/reflection-mapped-metadata.d.ts.map +1 -0
  115. package/dist/src/reflection-mapped-metadata.js +40 -0
  116. package/dist/src/reflection-mapped-metadata.js.map +7 -0
  117. package/dist/src/reflection-metadata.d.ts +11 -0
  118. package/dist/src/reflection-metadata.d.ts.map +1 -0
  119. package/dist/src/reflection-metadata.js +24 -0
  120. package/dist/src/reflection-metadata.js.map +7 -0
  121. package/dist/src/reflection-ranking.d.ts +13 -0
  122. package/dist/src/reflection-ranking.d.ts.map +1 -0
  123. package/{src/reflection-ranking.ts → dist/src/reflection-ranking.js} +12 -21
  124. package/dist/src/reflection-ranking.js.map +7 -0
  125. package/dist/src/reflection-retry.d.ts +30 -0
  126. package/dist/src/reflection-retry.d.ts.map +1 -0
  127. package/{src/reflection-retry.ts → dist/src/reflection-retry.js} +24 -64
  128. package/dist/src/reflection-retry.js.map +7 -0
  129. package/dist/src/reflection-slices.d.ts +42 -0
  130. package/dist/src/reflection-slices.d.ts.map +1 -0
  131. package/{src/reflection-slices.ts → dist/src/reflection-slices.js} +60 -136
  132. package/dist/src/reflection-slices.js.map +7 -0
  133. package/dist/src/reflection-store.d.ts +85 -0
  134. package/dist/src/reflection-store.d.ts.map +1 -0
  135. package/dist/src/reflection-store.js +407 -0
  136. package/dist/src/reflection-store.js.map +7 -0
  137. package/dist/src/resonance-state.d.ts +19 -0
  138. package/dist/src/resonance-state.d.ts.map +1 -0
  139. package/{src/resonance-state.ts → dist/src/resonance-state.js} +13 -42
  140. package/dist/src/resonance-state.js.map +7 -0
  141. package/dist/src/retriever.d.ts +228 -0
  142. package/dist/src/retriever.d.ts.map +1 -0
  143. package/dist/src/retriever.js +1006 -0
  144. package/dist/src/retriever.js.map +7 -0
  145. package/dist/src/scopes.d.ts +58 -0
  146. package/dist/src/scopes.d.ts.map +1 -0
  147. package/dist/src/scopes.js +252 -0
  148. package/dist/src/scopes.js.map +7 -0
  149. package/dist/src/self-improvement-files.d.ts +20 -0
  150. package/dist/src/self-improvement-files.d.ts.map +1 -0
  151. package/{src/self-improvement-files.ts → dist/src/self-improvement-files.js} +24 -49
  152. package/dist/src/self-improvement-files.js.map +7 -0
  153. package/dist/src/semantic-gate.d.ts +24 -0
  154. package/dist/src/semantic-gate.d.ts.map +1 -0
  155. package/dist/src/semantic-gate.js +86 -0
  156. package/dist/src/semantic-gate.js.map +7 -0
  157. package/dist/src/session-recovery.d.ts +9 -0
  158. package/dist/src/session-recovery.d.ts.map +1 -0
  159. package/{src/session-recovery.ts → dist/src/session-recovery.js} +40 -57
  160. package/dist/src/session-recovery.js.map +7 -0
  161. package/dist/src/smart-extractor.d.ts +107 -0
  162. package/dist/src/smart-extractor.d.ts.map +1 -0
  163. package/{src/smart-extractor.ts → dist/src/smart-extractor.js} +130 -383
  164. package/dist/src/smart-extractor.js.map +7 -0
  165. package/dist/src/smart-metadata.d.ts +103 -0
  166. package/dist/src/smart-metadata.d.ts.map +1 -0
  167. package/dist/src/smart-metadata.js +361 -0
  168. package/dist/src/smart-metadata.js.map +7 -0
  169. package/dist/src/storage-adapter.d.ts +102 -0
  170. package/dist/src/storage-adapter.d.ts.map +1 -0
  171. package/dist/src/storage-adapter.js +22 -0
  172. package/dist/src/storage-adapter.js.map +7 -0
  173. package/dist/src/store.d.ts +108 -0
  174. package/dist/src/store.d.ts.map +1 -0
  175. package/dist/src/store.js +939 -0
  176. package/dist/src/store.js.map +7 -0
  177. package/dist/src/tier-manager.d.ts +57 -0
  178. package/dist/src/tier-manager.d.ts.map +1 -0
  179. package/dist/src/tier-manager.js +80 -0
  180. package/dist/src/tier-manager.js.map +7 -0
  181. package/dist/src/tools.d.ts +43 -0
  182. package/dist/src/tools.d.ts.map +1 -0
  183. package/dist/src/tools.js +1075 -0
  184. package/dist/src/tools.js.map +7 -0
  185. package/dist/src/wal-recovery.d.ts +30 -0
  186. package/dist/src/wal-recovery.d.ts.map +1 -0
  187. package/{src/wal-recovery.ts → dist/src/wal-recovery.js} +26 -79
  188. package/dist/src/wal-recovery.js.map +7 -0
  189. package/package.json +21 -2
  190. package/openclaw.plugin.json +0 -815
  191. package/src/access-tracker.ts +0 -341
  192. package/src/adapters/README.md +0 -78
  193. package/src/adapters/qdrant.ts +0 -191
  194. package/src/adaptive-retrieval.ts +0 -90
  195. package/src/audit-log.ts +0 -238
  196. package/src/chunker.ts +0 -254
  197. package/src/config.ts +0 -271
  198. package/src/decay-engine.ts +0 -238
  199. package/src/extraction-prompts.ts +0 -339
  200. package/src/memory-categories.ts +0 -71
  201. package/src/memory-upgrader.ts +0 -388
  202. package/src/mnemo.ts +0 -142
  203. package/src/noise-filter.ts +0 -97
  204. package/src/noise-prototypes.ts +0 -164
  205. package/src/observability.ts +0 -81
  206. package/src/query-tracker.ts +0 -57
  207. package/src/reflection-event-store.ts +0 -98
  208. package/src/reflection-item-store.ts +0 -112
  209. package/src/reflection-mapped-metadata.ts +0 -84
  210. package/src/reflection-metadata.ts +0 -23
  211. package/src/reflection-store.ts +0 -602
  212. package/src/retriever.ts +0 -1510
  213. package/src/scopes.ts +0 -375
  214. package/src/semantic-gate.ts +0 -121
  215. package/src/smart-metadata.ts +0 -561
  216. package/src/storage-adapter.ts +0 -153
  217. package/src/store.ts +0 -1330
  218. package/src/tier-manager.ts +0 -189
  219. package/src/tools.ts +0 -1292
  220. package/test/core.test.mjs +0 -301
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/store.ts"],
4
+ "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * LanceDB Storage Layer with Multi-Scope Support\n */\n\nimport type * as LanceDB from \"@lancedb/lancedb\";\nimport { randomUUID } from \"node:crypto\";\nimport {\n existsSync,\n accessSync,\n constants,\n mkdirSync,\n realpathSync,\n lstatSync,\n} from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { buildSmartMetadata, parseSmartMetadata, stringifySmartMetadata } from \"./smart-metadata.js\";\nimport type { SemanticGate } from \"./semantic-gate.js\";\nimport { requirePro } from \"./license.js\";\nimport { log } from \"./logger.js\";\n\n// Pro: Audit log \u2014 record all CRUD operations for GDPR/compliance\n// TODO: type these with actual audit function signatures from audit-log.ts\nlet _auditCreate: ((...args: unknown[]) => void) | null = null;\nlet _auditUpdate: ((...args: unknown[]) => void) | null = null;\nlet _auditDelete: ((...args: unknown[]) => void) | null = null;\nlet _auditExpire: ((...args: unknown[]) => void) | null = null;\n\nif (requirePro(\"audit-log\")) {\n import(\"./audit-log.js\").then((mod) => {\n _auditCreate = mod.auditCreate;\n _auditUpdate = mod.auditUpdate;\n _auditDelete = mod.auditDelete;\n _auditExpire = mod.auditExpire;\n }).catch(() => {});\n}\n\n// Pro: WAL (Write-Ahead Log) \u2014 graceful degradation without license\n// TODO: type these with actual WAL function signatures from wal-recovery.ts\nlet walAppend: ((...args: unknown[]) => Promise<void>) | null = null;\nlet walMarkCommitted: ((...args: unknown[]) => Promise<void>) | null = null;\nlet walMarkFailed: ((...args: unknown[]) => Promise<void>) | null = null;\n\nif (requirePro(\"wal\")) {\n import(\"./wal-recovery.js\").then((mod) => {\n walAppend = mod.walAppend;\n walMarkCommitted = mod.walMarkCommitted;\n walMarkFailed = mod.walMarkFailed;\n }).catch(() => {});\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface MemoryEntry {\n id: string;\n text: string;\n vector: number[];\n category: \"preference\" | \"fact\" | \"decision\" | \"entity\" | \"other\" | \"reflection\";\n scope: string;\n importance: number;\n timestamp: number;\n metadata?: string; // JSON string for extensible metadata\n}\n\nexport interface MemorySearchResult {\n entry: MemoryEntry;\n score: number;\n}\n\nexport interface StoreConfig {\n dbPath: string;\n vectorDim: number;\n /** Enable near-duplicate detection before writing (default: true) */\n deduplication?: boolean;\n /** Enable semantic noise gate to filter fragments (default: true) */\n semanticGate?: boolean;\n /** Storage backend: \"lancedb\" (default), \"qdrant\", \"chroma\", \"pgvector\" */\n storageBackend?: string;\n /** Backend-specific config (url, connectionString, etc.) */\n storageConfig?: Record<string, unknown>;\n}\n\nconst DEDUP_SIMILARITY_THRESHOLD = 0.92;\nconst CONFLICT_SIMILARITY_THRESHOLD = 0.70;\n\nexport interface MetadataPatch {\n [key: string]: unknown;\n}\n\n// ============================================================================\n// Storage Adapter Support (multi-backend)\n// ============================================================================\n\nimport type { StorageAdapter } from \"./storage-adapter.js\";\nimport { createAdapter, listAdapters } from \"./storage-adapter.js\";\n\n// Auto-register adapters on first import\nlet _adaptersLoaded = false;\nasync function ensureAdaptersLoaded(): Promise<void> {\n if (_adaptersLoaded) return;\n _adaptersLoaded = true;\n // Dynamic imports \u2014 only loads the adapter that's actually needed\n const dbg = !!process.env.MNEMO_DEBUG;\n try { await import(\"./adapters/lancedb.js\"); } catch (e) { if (dbg) log.debug(\"adapter lancedb not available:\", e); }\n try { await import(\"./adapters/qdrant.js\"); } catch (e) { if (dbg) log.debug(\"adapter qdrant not available:\", e); }\n try { await import(\"./adapters/chroma.js\"); } catch (e) { if (dbg) log.debug(\"adapter chroma not available:\", e); }\n try { await import(\"./adapters/pgvector.js\"); } catch (e) { if (dbg) log.debug(\"adapter pgvector not available:\", e); }\n}\n\n// ============================================================================\n// LanceDB Dynamic Import (legacy path \u2014 used when storageBackend is unset or \"lancedb\")\n// ============================================================================\n\nlet lancedbImportPromise: Promise<typeof import(\"@lancedb/lancedb\")> | null =\n null;\n\nexport const loadLanceDB = async (): Promise<\n typeof import(\"@lancedb/lancedb\")\n> => {\n if (!lancedbImportPromise) {\n lancedbImportPromise = import(\"@lancedb/lancedb\");\n }\n try {\n return await lancedbImportPromise;\n } catch (err) {\n throw new Error(\n `mnemo: failed to load LanceDB. ${String(err)}`,\n { cause: err },\n );\n }\n};\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nfunction clampInt(value: number, min: number, max: number): number {\n if (!Number.isFinite(value)) return min;\n return Math.min(max, Math.max(min, Math.floor(value)));\n}\n\n/**\n * Sanitize a string for use in SQL WHERE clauses.\n * Strips everything except alphanumeric, dash, underscore, dot, colon, and space.\n * This is stricter than SQL escaping \u2014 it prevents injection by allowlist.\n */\nfunction escapeSqlLiteral(value: string): string {\n if (typeof value !== \"string\") return \"\";\n // Allowlist: only safe chars for IDs, scopes, categories\n return value.replace(/[^a-zA-Z0-9\\-_.:@ \\u4e00-\\u9fff\\u3400-\\u4dbf]/g, \"\");\n}\n\nfunction normalizeSearchText(value: string): string {\n return value.toLowerCase().trim();\n}\n\nfunction scoreLexicalHit(query: string, candidates: Array<{ text: string; weight: number }>): number {\n const normalizedQuery = normalizeSearchText(query);\n if (!normalizedQuery) return 0;\n\n let score = 0;\n for (const candidate of candidates) {\n const normalized = normalizeSearchText(candidate.text);\n if (!normalized) continue;\n if (normalized.includes(normalizedQuery)) {\n score = Math.max(score, Math.min(0.95, 0.72 + normalizedQuery.length * 0.02) * candidate.weight);\n }\n }\n\n return score;\n}\n\n// ============================================================================\n// Storage Path Validation\n// ============================================================================\n\n/**\n * Validate and prepare the storage directory before LanceDB connection.\n * Resolves symlinks, creates missing directories, and checks write permissions.\n * Returns the resolved absolute path on success, or throws a descriptive error.\n */\nexport function validateStoragePath(dbPath: string): string {\n let resolvedPath = dbPath;\n\n // Resolve symlinks (including dangling symlinks)\n try {\n const stats = lstatSync(dbPath);\n if (stats.isSymbolicLink()) {\n try {\n resolvedPath = realpathSync(dbPath);\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n throw new Error(\n `dbPath \"${dbPath}\" is a symlink whose target does not exist.\\n` +\n ` Fix: Create the target directory, or update the symlink to point to a valid path.\\n` +\n ` Details: ${e.code || \"\"} ${e.message}`,\n );\n }\n }\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n // Missing path is OK (it will be created below)\n if (e?.code === \"ENOENT\") {\n // no-op\n } else if (\n typeof e?.message === \"string\" &&\n e.message.includes(\"symlink whose target does not exist\")\n ) {\n throw err;\n } else {\n // Other lstat failures \u2014 continue with original path\n }\n }\n\n // Create directory if it doesn't exist\n if (!existsSync(resolvedPath)) {\n try {\n mkdirSync(resolvedPath, { recursive: true });\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n throw new Error(\n `Failed to create dbPath directory \"${resolvedPath}\".\\n` +\n ` Fix: Ensure the parent directory \"${dirname(resolvedPath)}\" exists and is writable,\\n` +\n ` or create it manually: mkdir -p \"${resolvedPath}\"\\n` +\n ` Details: ${e.code || \"\"} ${e.message}`,\n );\n }\n }\n\n // Check write permissions\n try {\n accessSync(resolvedPath, constants.W_OK);\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n throw new Error(\n `dbPath directory \"${resolvedPath}\" is not writable.\\n` +\n ` Fix: Check permissions with: ls -la \"${dirname(resolvedPath)}\"\\n` +\n ` Or grant write access: chmod u+w \"${resolvedPath}\"\\n` +\n ` Details: ${e.code || \"\"} ${e.message}`,\n );\n }\n\n return resolvedPath;\n}\n\n// ============================================================================\n// Memory Store\n// ============================================================================\n\nconst TABLE_NAME = \"memories\";\n\nexport class MemoryStore {\n private db: LanceDB.Connection | null = null;\n private table: LanceDB.Table | null = null;\n private initPromise: Promise<void> | null = null;\n private ftsIndexCreated = false;\n private updateQueue: Promise<void> = Promise.resolve();\n private semanticGateInstance: SemanticGate | null = null;\n\n /** When using a non-LanceDB adapter, this holds the active adapter instance */\n private _adapter: StorageAdapter | null = null;\n\n /** True when using the adapter path (non-LanceDB backends) */\n get usingAdapter(): boolean { return this._adapter !== null; }\n\n constructor(private readonly config: StoreConfig) { }\n\n /** Inject a SemanticGate instance (created externally with an Embedder). */\n setSemanticGate(gate: SemanticGate): void {\n this.semanticGateInstance = gate;\n }\n\n get dbPath(): string {\n return this.config.dbPath;\n }\n\n /** Get the active adapter (null if using legacy LanceDB path) */\n get adapter(): StorageAdapter | null {\n return this._adapter;\n }\n\n /** Whether BM25 full-text search is available */\n get hasFtsSupport(): boolean {\n if (this._adapter) return this._adapter.hasFullTextSearch();\n return this.ftsIndexCreated;\n }\n\n private async ensureInitialized(): Promise<void> {\n if (this.table || this._adapter) {\n return;\n }\n if (this.initPromise) {\n return this.initPromise;\n }\n\n this.initPromise = this.doInitialize().catch((err) => {\n this.initPromise = null;\n throw err;\n });\n return this.initPromise;\n }\n\n private async doInitialize(): Promise<void> {\n // \u2500\u2500 Adapter path: non-LanceDB backends (qdrant, chroma, pgvector) \u2500\u2500\n const backend = this.config.storageBackend;\n if (backend && backend !== \"lancedb\") {\n await ensureAdaptersLoaded();\n const available = listAdapters();\n if (!available.includes(backend)) {\n throw new Error(\n `Storage backend \"${backend}\" not available. Installed: ${available.join(\", \")}. ` +\n `Check that the adapter is properly imported.`\n );\n }\n this._adapter = createAdapter(backend, this.config.storageConfig);\n await this._adapter.connect(this.config.dbPath);\n await this._adapter.ensureTable(this.config.vectorDim);\n this.ftsIndexCreated = this._adapter.hasFullTextSearch();\n return; // Skip LanceDB initialization\n }\n\n // \u2500\u2500 Legacy LanceDB path (default) \u2500\u2500\n const lancedb = await loadLanceDB();\n\n let db: LanceDB.Connection;\n try {\n db = await lancedb.connect(this.config.dbPath);\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n const code = e.code || \"\";\n const message = e.message || String(err);\n throw new Error(\n `Failed to open LanceDB at \"${this.config.dbPath}\": ${code} ${message}\\n` +\n ` Fix: Verify the path exists and is writable. Check parent directory permissions.`,\n );\n }\n\n let table: LanceDB.Table;\n\n // Idempotent table init: try openTable first, create only if missing,\n // and handle the race where tableNames() misses an existing table but\n // createTable then sees it (LanceDB eventual consistency).\n try {\n table = await db.openTable(TABLE_NAME);\n\n // Check if we need to add scope column for backward compatibility\n try {\n const sample = await table.query().limit(1).toArray();\n if (sample.length > 0 && !(\"scope\" in sample[0])) {\n log.warn(\n \"Adding scope column for backward compatibility with existing data\",\n );\n }\n } catch (err) {\n log.warn(\"Could not check table schema:\", err);\n }\n } catch (_openErr) {\n // Table doesn't exist yet \u2014 create it\n const schemaEntry: MemoryEntry = {\n id: \"__schema__\",\n text: \"\",\n vector: Array.from({ length: this.config.vectorDim }).fill(\n 0,\n ) as number[],\n category: \"other\",\n scope: \"global\",\n importance: 0,\n timestamp: 0,\n metadata: \"{}\",\n };\n\n try {\n table = await db.createTable(TABLE_NAME, [schemaEntry]);\n await table.delete('id = \"__schema__\"');\n } catch (createErr) {\n // Race: another caller (or eventual consistency) created the table\n // between our failed openTable and this createTable \u2014 just open it.\n if (String(createErr).includes(\"already exists\")) {\n table = await db.openTable(TABLE_NAME);\n } else {\n throw createErr;\n }\n }\n }\n\n // Validate vector dimensions\n // Note: LanceDB returns Arrow Vector objects, not plain JS arrays.\n // Array.isArray() returns false for Arrow Vectors, so use .length instead.\n const sample = await table.query().limit(1).toArray();\n if (sample.length > 0 && sample[0]?.vector?.length) {\n const existingDim = sample[0].vector.length;\n if (existingDim !== this.config.vectorDim) {\n throw new Error(\n `Vector dimension mismatch: table=${existingDim}, config=${this.config.vectorDim}. Create a new table/dbPath or set matching embedding.dimensions.`,\n );\n }\n }\n\n // Create FTS index for BM25 search (graceful fallback if unavailable)\n try {\n await this.createFtsIndex(table);\n this.ftsIndexCreated = true;\n } catch (err) {\n log.warn(\n \"Failed to create FTS index, falling back to vector-only search:\",\n err,\n );\n this.ftsIndexCreated = false;\n }\n\n this.db = db;\n this.table = table;\n }\n\n private async createFtsIndex(table: LanceDB.Table): Promise<void> {\n try {\n // Check if FTS index already exists\n const indices = await table.listIndices();\n const hasFtsIndex = indices?.some(\n // TODO: type this \u2014 LanceDB index type lacks proper typings for indexType/columns\n (idx: any) => idx.indexType === \"FTS\" || idx.columns?.includes(\"text\"),\n );\n\n if (!hasFtsIndex) {\n // LanceDB @lancedb/lancedb >=0.26: use Index.fts() config\n const lancedb = await loadLanceDB();\n await table.createIndex(\"text\", {\n // TODO: type this \u2014 LanceDB dynamic import doesn't expose Index type\n config: (lancedb as any).Index.fts(),\n });\n }\n } catch (err) {\n throw new Error(\n `FTS index creation failed: ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n }\n\n async store(\n entry: Omit<MemoryEntry, \"id\" | \"timestamp\">,\n ): Promise<MemoryEntry> {\n await this.ensureInitialized();\n\n // \u2500\u2500 Step 0: Semantic noise gate (before dedup) \u2500\u2500\n if (this.config.semanticGate !== false && this.semanticGateInstance) {\n try {\n const passed = await this.semanticGateInstance.shouldPass(entry.vector, entry.text);\n if (!passed) {\n // Return a synthetic entry with a marker id so callers know it was filtered\n return {\n ...entry,\n id: \"__filtered__\",\n timestamp: Date.now(),\n metadata: entry.metadata || \"{}\",\n };\n }\n } catch {\n // Gate failure \u2192 pass through\n }\n }\n\n // \u2500\u2500 Step 1: Near-duplicate detection \u2500\u2500\n if (this.config.deduplication !== false && entry.vector && entry.vector.length > 0) {\n try {\n const scopeFilter = entry.scope ? [entry.scope] : undefined;\n const similar = await this.vectorSearch(entry.vector, 3, 0.3, scopeFilter);\n\n for (const match of similar) {\n // Convert LanceDB distance-based score to cosine similarity\n // vectorSearch returns score = 1 / (1 + distance), so:\n // cosine_similarity \u2248 1 - distance = (2*score - 1) / score ... but simpler:\n // For cosine distance: similarity = 1 - distance\n // score = 1/(1+d) \u2192 d = 1/score - 1 \u2192 similarity = 1 - d = 2 - 1/score\n const cosineSim = 2 - 1 / match.score;\n if (cosineSim > DEDUP_SIMILARITY_THRESHOLD) {\n // Duplicate found \u2014 update existing entry instead of creating new\n const existingMeta = parseSmartMetadata(match.entry.metadata, match.entry);\n const accessCount = (existingMeta.access_count ?? 0) + 1;\n\n const updates: {\n text?: string;\n importance?: number;\n metadata?: string;\n } = {};\n\n // If new text is longer or importance is higher, update\n if (entry.text.length > match.entry.text.length) {\n updates.text = entry.text;\n }\n if (entry.importance > match.entry.importance) {\n updates.importance = entry.importance;\n }\n\n // Always update accessCount and updatedAt\n const patchedMeta = {\n ...existingMeta,\n access_count: accessCount,\n updatedAt: Date.now(),\n };\n updates.metadata = stringifySmartMetadata(patchedMeta);\n\n await this.update(match.entry.id, updates, scopeFilter);\n\n // Return existing entry id so caller knows dedup happened\n return {\n ...match.entry,\n id: match.entry.id,\n timestamp: match.entry.timestamp,\n metadata: updates.metadata,\n };\n }\n }\n } catch {\n // Dedup failure \u2192 proceed with normal write\n }\n }\n\n // \u2500\u2500 Step 1b: Conflict detection (mid-similarity range) \u2500\u2500\n // If the new entry is similar but not identical to an existing one,\n // check if it's a contradiction/update and demote the old entry.\n // Search without scope filter to catch conflicts across scopes.\n if (this.config.deduplication !== false && entry.vector && entry.vector.length > 0) {\n try {\n const similar = await this.vectorSearch(entry.vector, 3, 0.3);\n\n for (const match of similar) {\n const cosineSim = 2 - 1 / match.score;\n if (cosineSim > CONFLICT_SIMILARITY_THRESHOLD && cosineSim <= DEDUP_SIMILARITY_THRESHOLD) {\n // Mid-range similarity: might be a contradiction or update\n // Heuristic: if both texts are about the same topic but have different\n // values/numbers/states, it's likely a contradiction\n const oldText = match.entry.text || \"\";\n const newText = entry.text || \"\";\n\n // Quick contradiction signals:\n // 1. Both mention the same entity but with different numbers\n // 2. Negation patterns (\u4E0D/\u6CA1/no/not + similar keywords)\n // 3. New text explicitly says \"changed to\" / \"\u6539\u6210\" / \"updated\"\n const hasContradictionSignal =\n /\u6539\u6210|\u53D8\u6210|\u66F4\u65B0\u4E3A|\u6362\u6210|\u4E0D\u518D|\u53D6\u6D88\u4E86|changed to|updated to|no longer|switched to/i.test(newText) ||\n (oldText.match(/\\d+/) && newText.match(/\\d+/) && cosineSim > 0.80);\n\n if (hasContradictionSignal) {\n // Audit: record contradiction-based expiration (version history)\n _auditExpire?.(match.entry.id, match.entry.scope || \"global\", \"contradiction\",\n `old: \"${match.entry.text?.slice(0, 100)}\" \u2192 new: \"${newText.slice(0, 100)}\"`);\n\n // Demote old entry\n const existingMeta = parseSmartMetadata(match.entry.metadata, match.entry);\n const oldImportance = match.entry.importance ?? 0.7;\n existingMeta.expired_at = new Date().toISOString();\n existingMeta.expired_reason = `superseded: ${newText.slice(0, 80)}`;\n await this.update(\n match.entry.id,\n {\n importance: Math.max(0.05, oldImportance * 0.1),\n metadata: stringifySmartMetadata(existingMeta),\n },\n );\n }\n }\n }\n } catch {\n // Conflict check failure \u2192 proceed with normal write\n }\n }\n\n // \u2500\u2500 Step 2: Normal write \u2500\u2500\n const fullEntry: MemoryEntry = {\n ...entry,\n id: randomUUID(),\n timestamp: Date.now(),\n metadata: entry.metadata || \"{}\",\n };\n\n try {\n if (this._adapter) {\n // TODO: type this \u2014 adapter.add signature doesn't match MemoryEntry exactly\n await this._adapter.add([fullEntry as any]);\n } else {\n await this.table!.add([fullEntry]);\n }\n } catch (err: unknown) {\n const e = err as NodeJS.ErrnoException;\n const code = e.code || \"\";\n const message = e.message || String(err);\n throw new Error(\n `Failed to store memory in \"${this.config.dbPath}\": ${code} ${message}`,\n );\n }\n\n // Audit: record creation\n _auditCreate?.(fullEntry.id, fullEntry.scope, fullEntry.scope, \"store\", fullEntry.text?.slice(0, 200));\n\n // \u2500\u2500 Step 3: Graphiti \u65F6\u5E8F\u56FE\u8C31\u53CC\u5199 with WAL \u2500\u2500\n const textLen = (fullEntry.text || \"\").length;\n const importance = typeof fullEntry.importance === \"number\" ? fullEntry.importance : 0.7;\n if (process.env.GRAPHITI_ENABLED === \"true\" && importance >= 0.5 && textLen >= 20) {\n const graphitiBase = process.env.GRAPHITI_BASE_URL || \"http://127.0.0.1:18799\";\n const scope = fullEntry.scope || \"default\";\n const groupId = scope.startsWith(\"agent:\") ? scope.split(\":\")[1] || \"default\" : \"default\";\n const walTs = new Date(fullEntry.timestamp).toISOString();\n\n // Write WAL pending entry before Graphiti call (Pro feature)\n if (walAppend) {\n walAppend({\n ts: walTs,\n action: \"write\",\n text: fullEntry.text,\n scope,\n category: fullEntry.category || \"fact\",\n groupId,\n importance,\n status: \"pending\",\n }).catch(() => {});\n }\n\n // Async Graphiti write (WAL tracking is Pro, Graphiti write is Core)\n fetch(`${graphitiBase}/episodes`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n text: `[${fullEntry.category || \"fact\"}] ${fullEntry.text}`,\n group_id: groupId,\n reference_time: walTs,\n source: `lancedb-pro-store-${groupId}`,\n category: fullEntry.category || \"fact\",\n }),\n signal: AbortSignal.timeout(15000),\n })\n .then(() => {\n walMarkCommitted?.(walTs).catch(() => {});\n })\n .catch((err) => {\n walMarkFailed?.(walTs, String(err)).catch(() => {});\n });\n }\n\n return fullEntry;\n }\n\n /**\n * Import a pre-built entry while preserving its id/timestamp.\n * Used for re-embedding / migration / A/B testing across embedding models.\n * Intentionally separate from `store()` to keep normal writes simple.\n */\n async importEntry(entry: MemoryEntry): Promise<MemoryEntry> {\n await this.ensureInitialized();\n\n if (!entry.id || typeof entry.id !== \"string\") {\n throw new Error(\"importEntry requires a stable id\");\n }\n\n const vector = entry.vector || [];\n if (!Array.isArray(vector) || vector.length !== this.config.vectorDim) {\n throw new Error(\n `Vector dimension mismatch: expected ${this.config.vectorDim}, got ${Array.isArray(vector) ? vector.length : \"non-array\"}`,\n );\n }\n\n const full: MemoryEntry = {\n ...entry,\n scope: entry.scope || \"global\",\n importance: Number.isFinite(entry.importance) ? entry.importance : 0.7,\n timestamp: Number.isFinite(entry.timestamp)\n ? entry.timestamp\n : Date.now(),\n metadata: entry.metadata || \"{}\",\n };\n\n await this.table!.add([full]);\n return full;\n }\n\n async hasId(id: string): Promise<boolean> {\n await this.ensureInitialized();\n if (this._adapter) {\n const results = await this._adapter.query({ where: `id = '${escapeSqlLiteral(id)}'`, limit: 1 });\n return results.length > 0;\n }\n const safeId = escapeSqlLiteral(id);\n const res = await this.table!.query()\n .select([\"id\"])\n .where(`id = '${safeId}'`)\n .limit(1)\n .toArray();\n return res.length > 0;\n }\n\n async getById(id: string, scopeFilter?: string[]): Promise<MemoryEntry | null> {\n await this.ensureInitialized();\n\n if (this._adapter) {\n const results = await this._adapter.query({ where: `id = '${escapeSqlLiteral(id)}'`, limit: 1 });\n if (results.length === 0) return null;\n const r = results[0];\n return { id: r.id, text: r.text, vector: r.vector, category: r.category as MemoryEntry[\"category\"], scope: r.scope, importance: r.importance, timestamp: r.timestamp, metadata: r.metadata } as MemoryEntry;\n }\n\n const safeId = escapeSqlLiteral(id);\n const rows = await this.table!\n .query()\n .where(`id = '${safeId}'`)\n .limit(1)\n .toArray();\n\n if (rows.length === 0) return null;\n\n const row = rows[0];\n const rowScope = (row.scope as string | undefined) ?? \"global\";\n if (scopeFilter && scopeFilter.length > 0 && !scopeFilter.includes(rowScope)) {\n return null;\n }\n\n return {\n id: row.id as string,\n text: row.text as string,\n vector: Array.from(row.vector as Iterable<number>),\n category: row.category as MemoryEntry[\"category\"],\n scope: rowScope,\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n };\n }\n\n async vectorSearch(vector: number[], limit = 5, minScore = 0.3, scopeFilter?: string[]): Promise<MemorySearchResult[]> {\n await this.ensureInitialized();\n\n // Adapter path: delegate to backend\n if (this._adapter) {\n const results = await this._adapter.vectorSearch(vector, limit, minScore, scopeFilter);\n return results.map(r => ({\n entry: { id: r.record.id, text: r.record.text, vector: r.record.vector, category: r.record.category as MemoryEntry[\"category\"], scope: r.record.scope, importance: r.record.importance, timestamp: r.record.timestamp, metadata: r.record.metadata } as MemoryEntry,\n score: r.score,\n }));\n }\n\n const safeLimit = clampInt(limit, 1, 20);\n const fetchLimit = Math.min(safeLimit * 10, 200); // Over-fetch for scope filtering\n\n let query = this.table!.vectorSearch(vector).distanceType('cosine').limit(fetchLimit);\n\n // Apply scope filter if provided\n if (scopeFilter && scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map((scope) => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n query = query.where(`(${scopeConditions}) OR scope IS NULL`); // NULL for backward compatibility\n }\n\n const results = await query.toArray();\n const mapped: MemorySearchResult[] = [];\n\n for (const row of results) {\n const distance = Number(row._distance ?? 0);\n const score = 1 / (1 + distance);\n\n if (score < minScore) continue;\n\n const rowScope = (row.scope as string | undefined) ?? \"global\";\n\n // Double-check scope filter in application layer\n if (\n scopeFilter &&\n scopeFilter.length > 0 &&\n !scopeFilter.includes(rowScope)\n ) {\n continue;\n }\n\n mapped.push({\n entry: {\n id: row.id as string,\n text: row.text as string,\n vector: row.vector as number[],\n category: row.category as MemoryEntry[\"category\"],\n scope: rowScope,\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n },\n score,\n });\n\n if (mapped.length >= safeLimit) break;\n }\n\n return mapped;\n }\n\n async bm25Search(\n query: string,\n limit = 5,\n scopeFilter?: string[],\n ): Promise<MemorySearchResult[]> {\n await this.ensureInitialized();\n\n // Adapter path\n if (this._adapter) {\n const results = await this._adapter.fullTextSearch(query, limit, scopeFilter);\n return results.map(r => ({\n entry: { id: r.record.id, text: r.record.text, vector: r.record.vector, category: r.record.category as MemoryEntry[\"category\"], scope: r.record.scope, importance: r.record.importance, timestamp: r.record.timestamp, metadata: r.record.metadata } as MemoryEntry,\n score: r.score,\n }));\n }\n\n const safeLimit = clampInt(limit, 1, 20);\n\n if (!this.ftsIndexCreated) {\n return this.lexicalFallbackSearch(query, safeLimit, scopeFilter);\n }\n\n try {\n // Use FTS query type explicitly\n let searchQuery = this.table!.search(query, \"fts\").limit(safeLimit);\n\n // Apply scope filter if provided\n if (scopeFilter && scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map((scope) => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n searchQuery = searchQuery.where(\n `(${scopeConditions}) OR scope IS NULL`,\n );\n }\n\n const results = await searchQuery.toArray();\n const mapped: MemorySearchResult[] = [];\n\n for (const row of results) {\n const rowScope = (row.scope as string | undefined) ?? \"global\";\n\n // Double-check scope filter in application layer\n if (\n scopeFilter &&\n scopeFilter.length > 0 &&\n !scopeFilter.includes(rowScope)\n ) {\n continue;\n }\n\n // LanceDB FTS _score is raw BM25 (unbounded). Normalize with sigmoid.\n // LanceDB may return BigInt for numeric columns; coerce safely.\n const rawScore = row._score != null ? Number(row._score) : 0;\n const normalizedScore =\n rawScore > 0 ? 1 / (1 + Math.exp(-rawScore / 5)) : 0.5;\n\n mapped.push({\n entry: {\n id: row.id as string,\n text: row.text as string,\n vector: row.vector as number[],\n category: row.category as MemoryEntry[\"category\"],\n scope: rowScope,\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n },\n score: normalizedScore,\n });\n }\n\n if (mapped.length > 0) {\n return mapped;\n }\n return this.lexicalFallbackSearch(query, safeLimit, scopeFilter);\n } catch (err) {\n log.warn(\"BM25 search failed, falling back to empty results:\", err);\n return this.lexicalFallbackSearch(query, safeLimit, scopeFilter);\n }\n }\n\n private async lexicalFallbackSearch(query: string, limit: number, scopeFilter?: string[]): Promise<MemorySearchResult[]> {\n const trimmedQuery = query.trim();\n if (!trimmedQuery) return [];\n\n let searchQuery = this.table!.query().select([\n \"id\",\n \"text\",\n \"vector\",\n \"category\",\n \"scope\",\n \"importance\",\n \"timestamp\",\n \"metadata\",\n ]);\n\n if (scopeFilter && scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map(scope => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n searchQuery = searchQuery.where(`(${scopeConditions}) OR scope IS NULL`);\n }\n\n const rows = await searchQuery.toArray();\n const matches: MemorySearchResult[] = [];\n\n for (const row of rows) {\n const rowScope = (row.scope as string | undefined) ?? \"global\";\n if (scopeFilter && scopeFilter.length > 0 && !scopeFilter.includes(rowScope)) {\n continue;\n }\n\n const entry: MemoryEntry = {\n id: row.id as string,\n text: row.text as string,\n vector: row.vector as number[],\n category: row.category as MemoryEntry[\"category\"],\n scope: rowScope,\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n };\n\n const metadata = parseSmartMetadata(entry.metadata, entry);\n const score = scoreLexicalHit(trimmedQuery, [\n { text: entry.text, weight: 1 },\n { text: metadata.l0_abstract, weight: 0.98 },\n { text: metadata.l1_overview, weight: 0.92 },\n { text: metadata.l2_content, weight: 0.96 },\n ]);\n\n if (score <= 0) continue;\n matches.push({ entry, score });\n }\n\n return matches\n .sort((a, b) => b.score - a.score || b.entry.timestamp - a.entry.timestamp)\n .slice(0, limit);\n }\n\n async delete(id: string, scopeFilter?: string[]): Promise<boolean> {\n await this.ensureInitialized();\n\n // Support both full UUID and short prefix (8+ hex chars)\n const uuidRegex =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n const prefixRegex = /^[0-9a-f]{8,}$/i;\n const isFullId = uuidRegex.test(id);\n const isPrefix = !isFullId && prefixRegex.test(id);\n\n if (!isFullId && !isPrefix) {\n throw new Error(`Invalid memory ID format: ${id}`);\n }\n\n let candidates: Record<string, unknown>[];\n if (isFullId) {\n candidates = await this.table!.query()\n .where(`id = '${id}'`)\n .limit(1)\n .toArray();\n } else {\n // Prefix match: fetch candidates and filter in app layer\n const all = await this.table!.query()\n .select([\"id\", \"scope\"])\n .limit(1000)\n .toArray();\n candidates = all.filter((r: Record<string, unknown>) => (r.id as string).startsWith(id));\n if (candidates.length > 1) {\n throw new Error(\n `Ambiguous prefix \"${id}\" matches ${candidates.length} memories. Use a longer prefix or full ID.`,\n );\n }\n }\n if (candidates.length === 0) {\n return false;\n }\n\n const resolvedId = candidates[0].id as string;\n const rowScope = (candidates[0].scope as string | undefined) ?? \"global\";\n\n // Check scope permissions\n if (\n scopeFilter &&\n scopeFilter.length > 0 &&\n !scopeFilter.includes(rowScope)\n ) {\n throw new Error(`Memory ${resolvedId} is outside accessible scopes`);\n }\n\n // Audit: record deletion with old value for version history\n _auditDelete?.([resolvedId], rowScope, \"user-request\");\n\n if (this._adapter) {\n await this._adapter.delete(`id = '${escapeSqlLiteral(resolvedId)}'`);\n } else {\n await this.table!.delete(`id = '${resolvedId}'`);\n }\n return true;\n }\n\n async list(\n scopeFilter?: string[],\n category?: string,\n limit = 20,\n offset = 0,\n ): Promise<MemoryEntry[]> {\n await this.ensureInitialized();\n\n let query = this.table!.query();\n\n // Build where conditions\n const conditions: string[] = [];\n\n if (scopeFilter && scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map((scope) => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n conditions.push(`((${scopeConditions}) OR scope IS NULL)`);\n }\n\n if (category) {\n conditions.push(`category = '${escapeSqlLiteral(category)}'`);\n }\n\n if (conditions.length > 0) {\n query = query.where(conditions.join(\" AND \"));\n }\n\n // Fetch all matching rows (no pre-limit) so app-layer sort is correct across full dataset\n const results = await query\n .select([\n \"id\",\n \"text\",\n \"category\",\n \"scope\",\n \"importance\",\n \"timestamp\",\n \"metadata\",\n ])\n .toArray();\n\n return results\n .map(\n (row): MemoryEntry => ({\n id: row.id as string,\n text: row.text as string,\n vector: [], // Don't include vectors in list results for performance\n category: row.category as MemoryEntry[\"category\"],\n scope: (row.scope as string | undefined) ?? \"global\",\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n }),\n )\n .sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0))\n .slice(offset, offset + limit);\n }\n\n async stats(scopeFilter?: string[]): Promise<{\n totalCount: number;\n scopeCounts: Record<string, number>;\n categoryCounts: Record<string, number>;\n }> {\n await this.ensureInitialized();\n\n let query = this.table!.query();\n\n if (scopeFilter && scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map((scope) => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n query = query.where(`((${scopeConditions}) OR scope IS NULL)`);\n }\n\n const results = await query.select([\"scope\", \"category\"]).toArray();\n\n const scopeCounts: Record<string, number> = {};\n const categoryCounts: Record<string, number> = {};\n\n for (const row of results) {\n const scope = (row.scope as string | undefined) ?? \"global\";\n const category = row.category as string;\n\n scopeCounts[scope] = (scopeCounts[scope] || 0) + 1;\n categoryCounts[category] = (categoryCounts[category] || 0) + 1;\n }\n\n return {\n totalCount: results.length,\n scopeCounts,\n categoryCounts,\n };\n }\n\n async update(\n id: string,\n updates: {\n text?: string;\n vector?: number[];\n importance?: number;\n category?: MemoryEntry[\"category\"];\n metadata?: string;\n },\n scopeFilter?: string[],\n ): Promise<MemoryEntry | null> {\n await this.ensureInitialized();\n\n return this.runSerializedUpdate(async () => {\n // Support both full UUID and short prefix (8+ hex chars), same as delete()\n const uuidRegex =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n const prefixRegex = /^[0-9a-f]{8,}$/i;\n const isFullId = uuidRegex.test(id);\n const isPrefix = !isFullId && prefixRegex.test(id);\n\n if (!isFullId && !isPrefix) {\n throw new Error(`Invalid memory ID format: ${id}`);\n }\n\n let rows: Record<string, unknown>[];\n if (isFullId) {\n const safeId = escapeSqlLiteral(id);\n rows = await this.table!.query()\n .where(`id = '${safeId}'`)\n .limit(1)\n .toArray();\n } else {\n // Prefix match\n const all = await this.table!.query()\n .select([\n \"id\",\n \"text\",\n \"vector\",\n \"category\",\n \"scope\",\n \"importance\",\n \"timestamp\",\n \"metadata\",\n ])\n .limit(1000)\n .toArray();\n rows = all.filter((r: Record<string, unknown>) => (r.id as string).startsWith(id));\n if (rows.length > 1) {\n throw new Error(\n `Ambiguous prefix \"${id}\" matches ${rows.length} memories. Use a longer prefix or full ID.`,\n );\n }\n }\n\n if (rows.length === 0) return null;\n\n const row = rows[0];\n const rowScope = (row.scope as string | undefined) ?? \"global\";\n\n // Check scope permissions\n if (\n scopeFilter &&\n scopeFilter.length > 0 &&\n !scopeFilter.includes(rowScope)\n ) {\n throw new Error(`Memory ${id} is outside accessible scopes`);\n }\n\n const original: MemoryEntry = {\n id: row.id as string,\n text: row.text as string,\n vector: Array.from(row.vector as Iterable<number>),\n category: row.category as MemoryEntry[\"category\"],\n scope: rowScope,\n importance: Number(row.importance),\n timestamp: Number(row.timestamp),\n metadata: (row.metadata as string) || \"{}\",\n };\n\n // Build updated entry, preserving original timestamp\n const updated: MemoryEntry = {\n ...original,\n text: updates.text ?? original.text,\n vector: updates.vector ?? original.vector,\n category: updates.category ?? original.category,\n scope: rowScope,\n importance: updates.importance ?? original.importance,\n timestamp: original.timestamp, // preserve original\n metadata: updates.metadata ?? original.metadata,\n };\n\n // Audit: record update with old value snapshot (version history)\n _auditUpdate?.(original.id, rowScope, \"memory-update\",\n JSON.stringify({\n old: { text: original.text?.slice(0, 200), importance: original.importance, category: original.category },\n new: { text: updated.text?.slice(0, 200), importance: updated.importance, category: updated.category },\n })\n );\n\n // LanceDB doesn't support in-place update; delete + re-add.\n // Serialize updates per store instance to avoid stale rollback races.\n // If the add fails after delete, attempt best-effort recovery without\n // overwriting a newer concurrent successful update.\n const rollbackCandidate =\n (await this.getById(original.id).catch(() => null)) ?? original;\n const resolvedId = escapeSqlLiteral(row.id as string);\n await this.table!.delete(`id = '${resolvedId}'`);\n try {\n await this.table!.add([updated]);\n } catch (addError) {\n const current = await this.getById(original.id).catch(() => null);\n if (current) {\n throw new Error(\n `Failed to update memory ${id}: write failed after delete, but an existing record was preserved. ` +\n `Write error: ${addError instanceof Error ? addError.message : String(addError)}`,\n );\n }\n\n try {\n await this.table!.add([rollbackCandidate]);\n } catch (rollbackError) {\n throw new Error(\n `Failed to update memory ${id}: write failed after delete, and rollback also failed. ` +\n `Write error: ${addError instanceof Error ? addError.message : String(addError)}. ` +\n `Rollback error: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`,\n );\n }\n\n throw new Error(\n `Failed to update memory ${id}: write failed after delete, latest available record restored. ` +\n `Write error: ${addError instanceof Error ? addError.message : String(addError)}`,\n );\n }\n\n return updated;\n });\n }\n\n private async runSerializedUpdate<T>(action: () => Promise<T>): Promise<T> {\n const previous = this.updateQueue;\n let release: (() => void) | undefined;\n const lock = new Promise<void>((resolve) => {\n release = resolve;\n });\n this.updateQueue = previous.then(() => lock);\n\n await previous;\n try {\n return await action();\n } finally {\n release?.();\n }\n }\n\n async patchMetadata(\n id: string,\n patch: MetadataPatch,\n scopeFilter?: string[],\n ): Promise<MemoryEntry | null> {\n const existing = await this.getById(id, scopeFilter);\n if (!existing) return null;\n\n const metadata = buildSmartMetadata(existing, patch);\n return this.update(\n id,\n { metadata: stringifySmartMetadata(metadata) },\n scopeFilter,\n );\n }\n\n async bulkDelete(scopeFilter: string[], beforeTimestamp?: number): Promise<number> {\n await this.ensureInitialized();\n\n const conditions: string[] = [];\n\n if (scopeFilter.length > 0) {\n const scopeConditions = scopeFilter\n .map((scope) => `scope = '${escapeSqlLiteral(scope)}'`)\n .join(\" OR \");\n conditions.push(`(${scopeConditions})`);\n }\n\n if (beforeTimestamp) {\n conditions.push(`timestamp < ${beforeTimestamp}`);\n }\n\n if (conditions.length === 0) {\n throw new Error(\n \"Bulk delete requires at least scope or timestamp filter for safety\",\n );\n }\n\n const whereClause = conditions.join(\" AND \");\n\n // Count first\n const countResults = await this.table!.query().where(whereClause).toArray();\n const deleteCount = countResults.length;\n\n // Then delete\n if (deleteCount > 0) {\n await this.table!.delete(whereClause);\n }\n\n return deleteCount;\n }\n\n /** Last FTS error for diagnostics */\n private _lastFtsError: string | null = null;\n\n get lastFtsError(): string | null {\n return this._lastFtsError;\n }\n\n /** Get FTS index health status */\n getFtsStatus(): { available: boolean; lastError: string | null } {\n return {\n available: this.ftsIndexCreated,\n lastError: this._lastFtsError,\n };\n }\n\n /** Rebuild FTS index (drops and recreates). Useful for recovery after corruption. */\n async rebuildFtsIndex(): Promise<{ success: boolean; error?: string }> {\n await this.ensureInitialized();\n try {\n // Drop existing FTS index if any\n const indices = await this.table!.listIndices();\n for (const idx of indices) {\n if (idx.indexType === \"FTS\" || idx.columns?.includes(\"text\")) {\n try {\n // TODO: type this \u2014 LanceDB index type lacks .name property in typings\n await this.table!.dropIndex((idx as any).name || \"text\");\n } catch (err) {\n // TODO: type this \u2014 LanceDB index type lacks .name property in typings\n log.warn(`dropIndex(${(idx as any).name || \"text\"}) failed:`, err);\n }\n }\n }\n // Recreate\n await this.createFtsIndex(this.table!);\n this.ftsIndexCreated = true;\n this._lastFtsError = null;\n return { success: true };\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n this._lastFtsError = msg;\n this.ftsIndexCreated = false;\n return { success: false, error: msg };\n }\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["sample", "results"]
7
+ }
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Tier Manager — Three-tier memory promotion/demotion system
3
+ *
4
+ * Tiers:
5
+ * - Core (decay floor 0.9): Identity-level facts, almost never forgotten
6
+ * - Working (decay floor 0.7): Active context, ages out without reinforcement
7
+ * - Peripheral (decay floor 0.5): Low-priority or aging memories
8
+ *
9
+ * Promotion: Peripheral → Working → Core (based on access, composite score, importance)
10
+ * Demotion: Core → Working → Peripheral (based on decay, age)
11
+ */
12
+ import type { MemoryTier } from "./memory-categories.js";
13
+ import type { DecayScore } from "./decay-engine.js";
14
+ export interface TierConfig {
15
+ /** Minimum access count for Core promotion (default: 10) */
16
+ coreAccessThreshold: number;
17
+ /** Minimum composite decay score for Core promotion (default: 0.7) */
18
+ coreCompositeThreshold: number;
19
+ /** Minimum importance for Core promotion (default: 0.8) */
20
+ coreImportanceThreshold: number;
21
+ /** Composite threshold below which to demote to Peripheral (default: 0.15) */
22
+ peripheralCompositeThreshold: number;
23
+ /** Age in days after which infrequent memories demote to Peripheral (default: 60) */
24
+ peripheralAgeDays: number;
25
+ /** Minimum access count for Working promotion from Peripheral (default: 3) */
26
+ workingAccessThreshold: number;
27
+ /** Minimum composite for Working promotion from Peripheral (default: 0.4) */
28
+ workingCompositeThreshold: number;
29
+ }
30
+ export declare const DEFAULT_TIER_CONFIG: TierConfig;
31
+ export interface TierTransition {
32
+ memoryId: string;
33
+ fromTier: MemoryTier;
34
+ toTier: MemoryTier;
35
+ reason: string;
36
+ }
37
+ /** Minimal memory fields needed for tier evaluation. */
38
+ export interface TierableMemory {
39
+ id: string;
40
+ tier: MemoryTier;
41
+ importance: number;
42
+ accessCount: number;
43
+ createdAt: number;
44
+ }
45
+ export interface TierManager {
46
+ /**
47
+ * Evaluate whether a memory should change tiers.
48
+ * Returns the transition if a change is needed, null otherwise.
49
+ */
50
+ evaluate(memory: TierableMemory, decayScore: DecayScore, now?: number): TierTransition | null;
51
+ /**
52
+ * Evaluate multiple memories and return all transitions.
53
+ */
54
+ evaluateAll(memories: TierableMemory[], decayScores: DecayScore[], now?: number): TierTransition[];
55
+ }
56
+ export declare function createTierManager(config?: TierConfig): TierManager;
57
+ //# sourceMappingURL=tier-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tier-manager.d.ts","sourceRoot":"","sources":["../../src/tier-manager.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,uBAAuB,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,4BAA4B,EAAE,MAAM,CAAC;IACrC,qFAAqF;IACrF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,mBAAmB,EAAE,UAQjC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,WAAW,CACT,QAAQ,EAAE,cAAc,EAAE,EAC1B,WAAW,EAAE,UAAU,EAAE,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,EAAE,CAAC;CACrB;AAQD,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,UAAgC,GACvC,WAAW,CAgGb"}
@@ -0,0 +1,80 @@
1
+ const DEFAULT_TIER_CONFIG = {
2
+ coreAccessThreshold: 10,
3
+ coreCompositeThreshold: 0.7,
4
+ coreImportanceThreshold: 0.8,
5
+ peripheralCompositeThreshold: 0.15,
6
+ peripheralAgeDays: 60,
7
+ workingAccessThreshold: 3,
8
+ workingCompositeThreshold: 0.4
9
+ };
10
+ const MS_PER_DAY = 864e5;
11
+ function createTierManager(config = DEFAULT_TIER_CONFIG) {
12
+ function evaluate(memory, decayScore, now = Date.now()) {
13
+ const ageDays = (now - memory.createdAt) / MS_PER_DAY;
14
+ switch (memory.tier) {
15
+ case "peripheral": {
16
+ if (memory.accessCount >= config.workingAccessThreshold && decayScore.composite >= config.workingCompositeThreshold) {
17
+ return {
18
+ memoryId: memory.id,
19
+ fromTier: "peripheral",
20
+ toTier: "working",
21
+ reason: `Access count (${memory.accessCount}) >= ${config.workingAccessThreshold} and composite (${decayScore.composite.toFixed(2)}) >= ${config.workingCompositeThreshold}`
22
+ };
23
+ }
24
+ break;
25
+ }
26
+ case "working": {
27
+ if (memory.accessCount >= config.coreAccessThreshold && decayScore.composite >= config.coreCompositeThreshold && memory.importance >= config.coreImportanceThreshold) {
28
+ return {
29
+ memoryId: memory.id,
30
+ fromTier: "working",
31
+ toTier: "core",
32
+ reason: `High access (${memory.accessCount}), composite (${decayScore.composite.toFixed(2)}), importance (${memory.importance})`
33
+ };
34
+ }
35
+ if (decayScore.composite < config.peripheralCompositeThreshold || ageDays > config.peripheralAgeDays && memory.accessCount < config.workingAccessThreshold) {
36
+ return {
37
+ memoryId: memory.id,
38
+ fromTier: "working",
39
+ toTier: "peripheral",
40
+ reason: `Low composite (${decayScore.composite.toFixed(2)}) or aged ${ageDays.toFixed(0)} days with low access (${memory.accessCount})`
41
+ };
42
+ }
43
+ break;
44
+ }
45
+ case "core": {
46
+ if (decayScore.composite < config.peripheralCompositeThreshold && memory.accessCount < config.workingAccessThreshold) {
47
+ return {
48
+ memoryId: memory.id,
49
+ fromTier: "core",
50
+ toTier: "working",
51
+ reason: `Severely low composite (${decayScore.composite.toFixed(2)}) and access (${memory.accessCount})`
52
+ };
53
+ }
54
+ break;
55
+ }
56
+ }
57
+ return null;
58
+ }
59
+ return {
60
+ evaluate,
61
+ evaluateAll(memories, decayScores, now = Date.now()) {
62
+ const scoreMap = new Map(decayScores.map((s) => [s.memoryId, s]));
63
+ const transitions = [];
64
+ for (const memory of memories) {
65
+ const score = scoreMap.get(memory.id);
66
+ if (!score) continue;
67
+ const transition = evaluate(memory, score, now);
68
+ if (transition) {
69
+ transitions.push(transition);
70
+ }
71
+ }
72
+ return transitions;
73
+ }
74
+ };
75
+ }
76
+ export {
77
+ DEFAULT_TIER_CONFIG,
78
+ createTierManager
79
+ };
80
+ //# sourceMappingURL=tier-manager.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/tier-manager.ts"],
4
+ "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Tier Manager \u2014 Three-tier memory promotion/demotion system\n *\n * Tiers:\n * - Core (decay floor 0.9): Identity-level facts, almost never forgotten\n * - Working (decay floor 0.7): Active context, ages out without reinforcement\n * - Peripheral (decay floor 0.5): Low-priority or aging memories\n *\n * Promotion: Peripheral \u2192 Working \u2192 Core (based on access, composite score, importance)\n * Demotion: Core \u2192 Working \u2192 Peripheral (based on decay, age)\n */\n\nimport type { MemoryTier } from \"./memory-categories.js\";\nimport type { DecayScore } from \"./decay-engine.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface TierConfig {\n /** Minimum access count for Core promotion (default: 10) */\n coreAccessThreshold: number;\n /** Minimum composite decay score for Core promotion (default: 0.7) */\n coreCompositeThreshold: number;\n /** Minimum importance for Core promotion (default: 0.8) */\n coreImportanceThreshold: number;\n /** Composite threshold below which to demote to Peripheral (default: 0.15) */\n peripheralCompositeThreshold: number;\n /** Age in days after which infrequent memories demote to Peripheral (default: 60) */\n peripheralAgeDays: number;\n /** Minimum access count for Working promotion from Peripheral (default: 3) */\n workingAccessThreshold: number;\n /** Minimum composite for Working promotion from Peripheral (default: 0.4) */\n workingCompositeThreshold: number;\n}\n\nexport const DEFAULT_TIER_CONFIG: TierConfig = {\n coreAccessThreshold: 10,\n coreCompositeThreshold: 0.7,\n coreImportanceThreshold: 0.8,\n peripheralCompositeThreshold: 0.15,\n peripheralAgeDays: 60,\n workingAccessThreshold: 3,\n workingCompositeThreshold: 0.4,\n};\n\nexport interface TierTransition {\n memoryId: string;\n fromTier: MemoryTier;\n toTier: MemoryTier;\n reason: string;\n}\n\n/** Minimal memory fields needed for tier evaluation. */\nexport interface TierableMemory {\n id: string;\n tier: MemoryTier;\n importance: number;\n accessCount: number;\n createdAt: number;\n}\n\nexport interface TierManager {\n /**\n * Evaluate whether a memory should change tiers.\n * Returns the transition if a change is needed, null otherwise.\n */\n evaluate(\n memory: TierableMemory,\n decayScore: DecayScore,\n now?: number,\n ): TierTransition | null;\n\n /**\n * Evaluate multiple memories and return all transitions.\n */\n evaluateAll(\n memories: TierableMemory[],\n decayScores: DecayScore[],\n now?: number,\n ): TierTransition[];\n}\n\n// ============================================================================\n// Factory\n// ============================================================================\n\nconst MS_PER_DAY = 86_400_000;\n\nexport function createTierManager(\n config: TierConfig = DEFAULT_TIER_CONFIG,\n): TierManager {\n function evaluate(\n memory: TierableMemory,\n decayScore: DecayScore,\n now: number = Date.now(),\n ): TierTransition | null {\n const ageDays = (now - memory.createdAt) / MS_PER_DAY;\n\n switch (memory.tier) {\n case \"peripheral\": {\n // Promote to Working?\n if (\n memory.accessCount >= config.workingAccessThreshold &&\n decayScore.composite >= config.workingCompositeThreshold\n ) {\n return {\n memoryId: memory.id,\n fromTier: \"peripheral\",\n toTier: \"working\",\n reason: `Access count (${memory.accessCount}) >= ${config.workingAccessThreshold} and composite (${decayScore.composite.toFixed(2)}) >= ${config.workingCompositeThreshold}`,\n };\n }\n break;\n }\n\n case \"working\": {\n // Promote to Core?\n if (\n memory.accessCount >= config.coreAccessThreshold &&\n decayScore.composite >= config.coreCompositeThreshold &&\n memory.importance >= config.coreImportanceThreshold\n ) {\n return {\n memoryId: memory.id,\n fromTier: \"working\",\n toTier: \"core\",\n reason: `High access (${memory.accessCount}), composite (${decayScore.composite.toFixed(2)}), importance (${memory.importance})`,\n };\n }\n\n // Demote to Peripheral?\n if (\n decayScore.composite < config.peripheralCompositeThreshold ||\n (ageDays > config.peripheralAgeDays &&\n memory.accessCount < config.workingAccessThreshold)\n ) {\n return {\n memoryId: memory.id,\n fromTier: \"working\",\n toTier: \"peripheral\",\n reason: `Low composite (${decayScore.composite.toFixed(2)}) or aged ${ageDays.toFixed(0)} days with low access (${memory.accessCount})`,\n };\n }\n break;\n }\n\n case \"core\": {\n // Demote to Working? (Core rarely demotes, but it can)\n if (\n decayScore.composite < config.peripheralCompositeThreshold &&\n memory.accessCount < config.workingAccessThreshold\n ) {\n return {\n memoryId: memory.id,\n fromTier: \"core\",\n toTier: \"working\",\n reason: `Severely low composite (${decayScore.composite.toFixed(2)}) and access (${memory.accessCount})`,\n };\n }\n break;\n }\n }\n\n return null;\n }\n\n return {\n evaluate,\n\n evaluateAll(memories, decayScores, now = Date.now()) {\n const scoreMap = new Map(decayScores.map((s) => [s.memoryId, s]));\n const transitions: TierTransition[] = [];\n\n for (const memory of memories) {\n const score = scoreMap.get(memory.id);\n if (!score) continue;\n\n const transition = evaluate(memory, score, now);\n if (transition) {\n transitions.push(transition);\n }\n }\n\n return transitions;\n },\n };\n}\n"],
5
+ "mappings": "AAqCO,MAAM,sBAAkC;AAAA,EAC7C,qBAAqB;AAAA,EACrB,wBAAwB;AAAA,EACxB,yBAAyB;AAAA,EACzB,8BAA8B;AAAA,EAC9B,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,2BAA2B;AAC7B;AA2CA,MAAM,aAAa;AAEZ,SAAS,kBACd,SAAqB,qBACR;AACb,WAAS,SACP,QACA,YACA,MAAc,KAAK,IAAI,GACA;AACvB,UAAM,WAAW,MAAM,OAAO,aAAa;AAE3C,YAAQ,OAAO,MAAM;AAAA,MACnB,KAAK,cAAc;AAEjB,YACE,OAAO,eAAe,OAAO,0BAC7B,WAAW,aAAa,OAAO,2BAC/B;AACA,iBAAO;AAAA,YACL,UAAU,OAAO;AAAA,YACjB,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,QAAQ,iBAAiB,OAAO,WAAW,QAAQ,OAAO,sBAAsB,mBAAmB,WAAW,UAAU,QAAQ,CAAC,CAAC,QAAQ,OAAO,yBAAyB;AAAA,UAC5K;AAAA,QACF;AACA;AAAA,MACF;AAAA,MAEA,KAAK,WAAW;AAEd,YACE,OAAO,eAAe,OAAO,uBAC7B,WAAW,aAAa,OAAO,0BAC/B,OAAO,cAAc,OAAO,yBAC5B;AACA,iBAAO;AAAA,YACL,UAAU,OAAO;AAAA,YACjB,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,QAAQ,gBAAgB,OAAO,WAAW,iBAAiB,WAAW,UAAU,QAAQ,CAAC,CAAC,kBAAkB,OAAO,UAAU;AAAA,UAC/H;AAAA,QACF;AAGA,YACE,WAAW,YAAY,OAAO,gCAC7B,UAAU,OAAO,qBAChB,OAAO,cAAc,OAAO,wBAC9B;AACA,iBAAO;AAAA,YACL,UAAU,OAAO;AAAA,YACjB,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,QAAQ,kBAAkB,WAAW,UAAU,QAAQ,CAAC,CAAC,aAAa,QAAQ,QAAQ,CAAC,CAAC,0BAA0B,OAAO,WAAW;AAAA,UACtI;AAAA,QACF;AACA;AAAA,MACF;AAAA,MAEA,KAAK,QAAQ;AAEX,YACE,WAAW,YAAY,OAAO,gCAC9B,OAAO,cAAc,OAAO,wBAC5B;AACA,iBAAO;AAAA,YACL,UAAU,OAAO;AAAA,YACjB,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,QAAQ,2BAA2B,WAAW,UAAU,QAAQ,CAAC,CAAC,iBAAiB,OAAO,WAAW;AAAA,UACvG;AAAA,QACF;AACA;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IAEA,YAAY,UAAU,aAAa,MAAM,KAAK,IAAI,GAAG;AACnD,YAAM,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAChE,YAAM,cAAgC,CAAC;AAEvC,iBAAW,UAAU,UAAU;AAC7B,cAAM,QAAQ,SAAS,IAAI,OAAO,EAAE;AACpC,YAAI,CAAC,MAAO;AAEZ,cAAM,aAAa,SAAS,QAAQ,OAAO,GAAG;AAC9C,YAAI,YAAY;AACd,sBAAY,KAAK,UAAU;AAAA,QAC7B;AAAA,MACF;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
6
+ "names": []
7
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Agent Tool Definitions
3
+ * Memory management tools for AI agents
4
+ */
5
+ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
6
+ import type { MemoryRetriever } from "./retriever.js";
7
+ import type { MemoryStore } from "./store.js";
8
+ import type { MemoryScopeManager } from "./scopes.js";
9
+ import type { Embedder } from "./embedder.js";
10
+ export declare const MEMORY_CATEGORIES: readonly ["preference", "fact", "decision", "entity", "reflection", "other"];
11
+ export type MdMirrorWriter = (entry: {
12
+ text: string;
13
+ category: string;
14
+ scope: string;
15
+ timestamp?: number;
16
+ }, meta?: {
17
+ source?: string;
18
+ agentId?: string;
19
+ }) => Promise<void>;
20
+ interface ToolContext {
21
+ retriever: MemoryRetriever;
22
+ store: MemoryStore;
23
+ scopeManager: MemoryScopeManager;
24
+ embedder: Embedder;
25
+ agentId?: string;
26
+ workspaceDir?: string;
27
+ mdMirror?: MdMirrorWriter | null;
28
+ }
29
+ export declare function registerSelfImprovementLogTool(api: OpenClawPluginApi, context: ToolContext): void;
30
+ export declare function registerSelfImprovementExtractSkillTool(api: OpenClawPluginApi, context: ToolContext): void;
31
+ export declare function registerSelfImprovementReviewTool(api: OpenClawPluginApi, context: ToolContext): void;
32
+ export declare function registerMemoryRecallTool(api: OpenClawPluginApi, context: ToolContext): void;
33
+ export declare function registerMemoryStoreTool(api: OpenClawPluginApi, context: ToolContext): void;
34
+ export declare function registerMemoryForgetTool(api: OpenClawPluginApi, context: ToolContext): void;
35
+ export declare function registerMemoryUpdateTool(api: OpenClawPluginApi, context: ToolContext): void;
36
+ export declare function registerMemoryStatsTool(api: OpenClawPluginApi, context: ToolContext): void;
37
+ export declare function registerMemoryListTool(api: OpenClawPluginApi, context: ToolContext): void;
38
+ export declare function registerAllMemoryTools(api: OpenClawPluginApi, context: ToolContext, options?: {
39
+ enableManagementTools?: boolean;
40
+ enableSelfImprovementTools?: boolean;
41
+ }): void;
42
+ export {};
43
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAc9C,eAAO,MAAM,iBAAiB,8EAOpB,CAAC;AAQX,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5E,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACzC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,UAAU,WAAW;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CAClC;AA+FD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,QA8D1F;AAED,wBAAgB,uCAAuC,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,QAqHnG;AAED,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,QAkD7F;AAMD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAiIrB;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAoKrB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAwJrB;AAMD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAyKrB;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAyFrB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,QAwIrB;AAMD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE;IACP,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACjC,QAoBP"}