moflo 4.8.19 → 4.8.20

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 (241) hide show
  1. package/.claude/guidance/shipped/moflo.md +45 -0
  2. package/.claude/helpers/statusline.cjs +1 -1
  3. package/.claude/workflow-state.json +9 -0
  4. package/package.json +2 -2
  5. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +1 -1
  6. package/src/@claude-flow/cli/dist/src/services/agentic-flow-bridge.js +5 -3
  7. package/src/@claude-flow/cli/package.json +1 -1
  8. package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +131 -0
  9. package/src/@claude-flow/memory/dist/agent-memory-scope.js +223 -0
  10. package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +8 -0
  11. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +466 -0
  12. package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +165 -0
  13. package/src/@claude-flow/memory/dist/agentdb-adapter.js +806 -0
  14. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +212 -0
  15. package/src/@claude-flow/memory/dist/agentdb-backend.js +842 -0
  16. package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +7 -0
  17. package/src/@claude-flow/memory/dist/agentdb-backend.test.js +258 -0
  18. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +65 -0
  19. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +129 -0
  20. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +48 -0
  21. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +72 -0
  22. package/src/@claude-flow/memory/dist/application/index.d.ts +12 -0
  23. package/src/@claude-flow/memory/dist/application/index.js +15 -0
  24. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +72 -0
  25. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +143 -0
  26. package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +121 -0
  27. package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +190 -0
  28. package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +226 -0
  29. package/src/@claude-flow/memory/dist/auto-memory-bridge.js +709 -0
  30. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +8 -0
  31. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +757 -0
  32. package/src/@claude-flow/memory/dist/benchmark.test.d.ts +2 -0
  33. package/src/@claude-flow/memory/dist/benchmark.test.js +277 -0
  34. package/src/@claude-flow/memory/dist/cache-manager.d.ts +134 -0
  35. package/src/@claude-flow/memory/dist/cache-manager.js +407 -0
  36. package/src/@claude-flow/memory/dist/controller-registry.d.ts +216 -0
  37. package/src/@claude-flow/memory/dist/controller-registry.js +893 -0
  38. package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +14 -0
  39. package/src/@claude-flow/memory/dist/controller-registry.test.js +593 -0
  40. package/src/@claude-flow/memory/dist/database-provider.d.ts +87 -0
  41. package/src/@claude-flow/memory/dist/database-provider.js +372 -0
  42. package/src/@claude-flow/memory/dist/database-provider.test.d.ts +7 -0
  43. package/src/@claude-flow/memory/dist/database-provider.test.js +287 -0
  44. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +143 -0
  45. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +226 -0
  46. package/src/@claude-flow/memory/dist/domain/index.d.ts +11 -0
  47. package/src/@claude-flow/memory/dist/domain/index.js +12 -0
  48. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +102 -0
  49. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +11 -0
  50. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +105 -0
  51. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +297 -0
  52. package/src/@claude-flow/memory/dist/hnsw-index.d.ts +111 -0
  53. package/src/@claude-flow/memory/dist/hnsw-index.js +781 -0
  54. package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +23 -0
  55. package/src/@claude-flow/memory/dist/hnsw-lite.js +168 -0
  56. package/src/@claude-flow/memory/dist/index.d.ts +204 -0
  57. package/src/@claude-flow/memory/dist/index.js +358 -0
  58. package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +17 -0
  59. package/src/@claude-flow/memory/dist/infrastructure/index.js +16 -0
  60. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +66 -0
  61. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +409 -0
  62. package/src/@claude-flow/memory/dist/learning-bridge.d.ts +137 -0
  63. package/src/@claude-flow/memory/dist/learning-bridge.js +335 -0
  64. package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +8 -0
  65. package/src/@claude-flow/memory/dist/learning-bridge.test.js +578 -0
  66. package/src/@claude-flow/memory/dist/memory-graph.d.ts +100 -0
  67. package/src/@claude-flow/memory/dist/memory-graph.js +333 -0
  68. package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +8 -0
  69. package/src/@claude-flow/memory/dist/memory-graph.test.js +609 -0
  70. package/src/@claude-flow/memory/dist/migration.d.ts +68 -0
  71. package/src/@claude-flow/memory/dist/migration.js +513 -0
  72. package/src/@claude-flow/memory/dist/persistent-sona.d.ts +144 -0
  73. package/src/@claude-flow/memory/dist/persistent-sona.js +332 -0
  74. package/src/@claude-flow/memory/dist/query-builder.d.ts +211 -0
  75. package/src/@claude-flow/memory/dist/query-builder.js +438 -0
  76. package/src/@claude-flow/memory/dist/rvf-backend.d.ts +51 -0
  77. package/src/@claude-flow/memory/dist/rvf-backend.js +481 -0
  78. package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +139 -0
  79. package/src/@claude-flow/memory/dist/rvf-learning-store.js +295 -0
  80. package/src/@claude-flow/memory/dist/rvf-migration.d.ts +45 -0
  81. package/src/@claude-flow/memory/dist/rvf-migration.js +234 -0
  82. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +127 -0
  83. package/src/@claude-flow/memory/dist/sqljs-backend.js +600 -0
  84. package/src/@claude-flow/memory/dist/types.d.ts +484 -0
  85. package/src/@claude-flow/memory/dist/types.js +58 -0
  86. package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  87. package/src/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  88. package/src/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  89. package/src/@claude-flow/shared/dist/core/config/index.js +12 -0
  90. package/src/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  91. package/src/@claude-flow/shared/dist/core/config/loader.js +222 -0
  92. package/src/@claude-flow/shared/dist/core/config/schema.d.ts +1134 -0
  93. package/src/@claude-flow/shared/dist/core/config/schema.js +158 -0
  94. package/src/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  95. package/src/@claude-flow/shared/dist/core/config/validator.js +147 -0
  96. package/src/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  97. package/src/@claude-flow/shared/dist/core/event-bus.js +197 -0
  98. package/src/@claude-flow/shared/dist/core/index.d.ts +15 -0
  99. package/src/@claude-flow/shared/dist/core/index.js +19 -0
  100. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  101. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  102. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  103. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  104. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  105. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  106. package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  107. package/src/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  108. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  109. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  110. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  111. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  112. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  113. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  114. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  115. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  116. package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  117. package/src/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  118. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  119. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  120. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  121. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  122. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  123. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  124. package/src/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  125. package/src/@claude-flow/shared/dist/events/domain-events.js +165 -0
  126. package/src/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  127. package/src/@claude-flow/shared/dist/events/event-store.js +432 -0
  128. package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  129. package/src/@claude-flow/shared/dist/events/event-store.test.js +297 -0
  130. package/src/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  131. package/src/@claude-flow/shared/dist/events/example-usage.js +193 -0
  132. package/src/@claude-flow/shared/dist/events/index.d.ts +21 -0
  133. package/src/@claude-flow/shared/dist/events/index.js +22 -0
  134. package/src/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  135. package/src/@claude-flow/shared/dist/events/projections.js +421 -0
  136. package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  137. package/src/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  138. package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  139. package/src/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  140. package/src/@claude-flow/shared/dist/events.d.ts +80 -0
  141. package/src/@claude-flow/shared/dist/events.js +249 -0
  142. package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  143. package/src/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  144. package/src/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  145. package/src/@claude-flow/shared/dist/hooks/executor.js +267 -0
  146. package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  147. package/src/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  148. package/src/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  149. package/src/@claude-flow/shared/dist/hooks/index.js +51 -0
  150. package/src/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  151. package/src/@claude-flow/shared/dist/hooks/registry.js +277 -0
  152. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  153. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  154. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  155. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  156. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  157. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  158. package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  159. package/src/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  160. package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  161. package/src/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  162. package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  163. package/src/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  164. package/src/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  165. package/src/@claude-flow/shared/dist/hooks/types.js +62 -0
  166. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  167. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  168. package/src/@claude-flow/shared/dist/index.d.ts +20 -0
  169. package/src/@claude-flow/shared/dist/index.js +50 -0
  170. package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  171. package/src/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  172. package/src/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  173. package/src/@claude-flow/shared/dist/mcp/index.js +84 -0
  174. package/src/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  175. package/src/@claude-flow/shared/dist/mcp/server.js +593 -0
  176. package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  177. package/src/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  178. package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  179. package/src/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  180. package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  181. package/src/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  182. package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  183. package/src/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  184. package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  185. package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  186. package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  187. package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  188. package/src/@claude-flow/shared/dist/mcp/types.d.ts +438 -0
  189. package/src/@claude-flow/shared/dist/mcp/types.js +54 -0
  190. package/src/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  191. package/src/@claude-flow/shared/dist/plugin-interface.js +23 -0
  192. package/src/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  193. package/src/@claude-flow/shared/dist/plugin-loader.js +434 -0
  194. package/src/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  195. package/src/@claude-flow/shared/dist/plugin-registry.js +457 -0
  196. package/src/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  197. package/src/@claude-flow/shared/dist/plugins/index.js +10 -0
  198. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  199. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  200. package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  201. package/src/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  202. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  203. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  204. package/src/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  205. package/src/@claude-flow/shared/dist/plugins/types.js +9 -0
  206. package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  207. package/src/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  208. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  209. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  210. package/src/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  211. package/src/@claude-flow/shared/dist/resilience/index.js +19 -0
  212. package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  213. package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  214. package/src/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  215. package/src/@claude-flow/shared/dist/resilience/retry.js +159 -0
  216. package/src/@claude-flow/shared/dist/security/index.d.ts +10 -0
  217. package/src/@claude-flow/shared/dist/security/index.js +12 -0
  218. package/src/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  219. package/src/@claude-flow/shared/dist/security/input-validation.js +201 -0
  220. package/src/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  221. package/src/@claude-flow/shared/dist/security/secure-random.js +142 -0
  222. package/src/@claude-flow/shared/dist/services/index.d.ts +7 -0
  223. package/src/@claude-flow/shared/dist/services/index.js +7 -0
  224. package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  225. package/src/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  226. package/src/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  227. package/src/@claude-flow/shared/dist/types/agent.types.js +6 -0
  228. package/src/@claude-flow/shared/dist/types/index.d.ts +11 -0
  229. package/src/@claude-flow/shared/dist/types/index.js +17 -0
  230. package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  231. package/src/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  232. package/src/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  233. package/src/@claude-flow/shared/dist/types/memory.types.js +7 -0
  234. package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  235. package/src/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  236. package/src/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  237. package/src/@claude-flow/shared/dist/types/task.types.js +32 -0
  238. package/src/@claude-flow/shared/dist/types.d.ts +197 -0
  239. package/src/@claude-flow/shared/dist/types.js +21 -0
  240. package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  241. package/src/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
@@ -0,0 +1,842 @@
1
+ /**
2
+ * AgentDB Backend - Integration with agentdb@2.0.0-alpha.3.4
3
+ *
4
+ * Provides IMemoryBackend implementation using AgentDB with:
5
+ * - HNSW vector search (150x-12,500x faster than brute-force)
6
+ * - Native or WASM backend support with graceful fallback
7
+ * - Optional dependency handling (works without hnswlib-node)
8
+ *
9
+ * @module v3/memory/agentdb-backend
10
+ */
11
+ import { EventEmitter } from 'node:events';
12
+ // ===== AgentDB Optional Import =====
13
+ let AgentDB;
14
+ let HNSWIndex;
15
+ let isHnswlibAvailable;
16
+ // Dynamically import agentdb (handled at runtime)
17
+ let agentdbImportPromise;
18
+ function ensureAgentDBImport() {
19
+ if (!agentdbImportPromise) {
20
+ agentdbImportPromise = (async () => {
21
+ try {
22
+ const agentdbModule = await import('agentdb');
23
+ AgentDB = agentdbModule.AgentDB || agentdbModule.default;
24
+ HNSWIndex = agentdbModule.HNSWIndex;
25
+ isHnswlibAvailable = agentdbModule.isHnswlibAvailable;
26
+ }
27
+ catch (error) {
28
+ // AgentDB not available - will use fallback
29
+ }
30
+ })();
31
+ }
32
+ return agentdbImportPromise;
33
+ }
34
+ /**
35
+ * Default configuration
36
+ */
37
+ const DEFAULT_CONFIG = {
38
+ namespace: 'default',
39
+ forceWasm: false,
40
+ vectorBackend: 'auto',
41
+ vectorDimension: 1536,
42
+ hnswM: 16,
43
+ hnswEfConstruction: 200,
44
+ hnswEfSearch: 100,
45
+ cacheEnabled: true,
46
+ maxEntries: 1000000,
47
+ };
48
+ // ===== AgentDB Backend Implementation =====
49
+ /**
50
+ * AgentDB Backend
51
+ *
52
+ * Integrates AgentDB for vector search with the V3 memory system.
53
+ * Provides 150x-12,500x faster search compared to brute-force approaches.
54
+ *
55
+ * Features:
56
+ * - HNSW indexing for fast approximate nearest neighbor search
57
+ * - Automatic fallback: native hnswlib → ruvector → WASM
58
+ * - Graceful handling of optional native dependencies
59
+ * - Semantic search with filtering
60
+ */
61
+ export class AgentDBBackend extends EventEmitter {
62
+ config;
63
+ agentdb;
64
+ initialized = false;
65
+ available = false;
66
+ // In-memory storage for compatibility
67
+ entries = new Map();
68
+ namespaceIndex = new Map();
69
+ keyIndex = new Map();
70
+ // O(1) reverse lookup for numeric ID -> string ID (fixes O(n) linear scan)
71
+ numericToStringIdMap = new Map();
72
+ // Performance tracking
73
+ stats = {
74
+ queryCount: 0,
75
+ totalQueryTime: 0,
76
+ searchCount: 0,
77
+ totalSearchTime: 0,
78
+ };
79
+ constructor(config = {}) {
80
+ super();
81
+ this.config = { ...DEFAULT_CONFIG, ...config };
82
+ this.available = false; // Will be set during initialization
83
+ }
84
+ /**
85
+ * Initialize AgentDB
86
+ */
87
+ async initialize() {
88
+ if (this.initialized)
89
+ return;
90
+ // Try to import AgentDB
91
+ await ensureAgentDBImport();
92
+ this.available = AgentDB !== undefined;
93
+ if (!this.available) {
94
+ console.warn('AgentDB not available, using fallback in-memory storage');
95
+ this.initialized = true;
96
+ return;
97
+ }
98
+ try {
99
+ // Initialize AgentDB with config
100
+ this.agentdb = new AgentDB({
101
+ dbPath: this.config.dbPath || ':memory:',
102
+ namespace: this.config.namespace,
103
+ forceWasm: this.config.forceWasm,
104
+ vectorBackend: this.config.vectorBackend,
105
+ vectorDimension: this.config.vectorDimension,
106
+ });
107
+ // Suppress agentdb's noisy console.log during init
108
+ // (EmbeddingService, AgentDB core emit info-level logs we don't need)
109
+ const origLog = console.log;
110
+ console.log = (...args) => {
111
+ const msg = String(args[0] ?? '');
112
+ if (msg.includes('Transformers.js loaded') ||
113
+ msg.includes('Using better-sqlite3') ||
114
+ msg.includes('better-sqlite3 unavailable') ||
115
+ msg.includes('[AgentDB]'))
116
+ return;
117
+ origLog.apply(console, args);
118
+ };
119
+ try {
120
+ await this.agentdb.initialize();
121
+ }
122
+ finally {
123
+ console.log = origLog;
124
+ }
125
+ // Create memory_entries table if it doesn't exist
126
+ await this.createSchema();
127
+ this.initialized = true;
128
+ this.emit('initialized', {
129
+ backend: this.agentdb.vectorBackendName,
130
+ isWasm: this.agentdb.isWasm,
131
+ });
132
+ }
133
+ catch (error) {
134
+ console.error('Failed to initialize AgentDB:', error);
135
+ this.available = false;
136
+ this.initialized = true;
137
+ this.emit('initialization:failed', { error });
138
+ }
139
+ }
140
+ /**
141
+ * Shutdown AgentDB
142
+ */
143
+ async shutdown() {
144
+ if (!this.initialized)
145
+ return;
146
+ if (this.agentdb) {
147
+ await this.agentdb.close();
148
+ }
149
+ this.initialized = false;
150
+ this.emit('shutdown');
151
+ }
152
+ /**
153
+ * Store a memory entry
154
+ */
155
+ async store(entry) {
156
+ // Generate embedding if needed
157
+ if (entry.content && !entry.embedding && this.config.embeddingGenerator) {
158
+ entry.embedding = await this.config.embeddingGenerator(entry.content);
159
+ }
160
+ // Store in-memory for quick access
161
+ this.entries.set(entry.id, entry);
162
+ // Register ID mapping for O(1) reverse lookup
163
+ this.registerIdMapping(entry.id);
164
+ // Update indexes
165
+ this.updateIndexes(entry);
166
+ // Store in AgentDB if available
167
+ if (this.agentdb) {
168
+ await this.storeInAgentDB(entry);
169
+ }
170
+ this.emit('entry:stored', { id: entry.id });
171
+ }
172
+ /**
173
+ * Get entry by ID
174
+ */
175
+ async get(id) {
176
+ // Check in-memory first
177
+ const cached = this.entries.get(id);
178
+ if (cached)
179
+ return cached;
180
+ // Query AgentDB if available
181
+ if (this.agentdb) {
182
+ return this.getFromAgentDB(id);
183
+ }
184
+ return null;
185
+ }
186
+ /**
187
+ * Get entry by key
188
+ */
189
+ async getByKey(namespace, key) {
190
+ const keyIndexKey = `${namespace}:${key}`;
191
+ const id = this.keyIndex.get(keyIndexKey);
192
+ if (!id)
193
+ return null;
194
+ return this.get(id);
195
+ }
196
+ /**
197
+ * Update entry
198
+ */
199
+ async update(id, update) {
200
+ const entry = this.entries.get(id);
201
+ if (!entry)
202
+ return null;
203
+ // Apply updates
204
+ if (update.content !== undefined) {
205
+ entry.content = update.content;
206
+ // Regenerate embedding if needed
207
+ if (this.config.embeddingGenerator) {
208
+ entry.embedding = await this.config.embeddingGenerator(entry.content);
209
+ }
210
+ }
211
+ if (update.tags !== undefined) {
212
+ entry.tags = update.tags;
213
+ }
214
+ if (update.metadata !== undefined) {
215
+ entry.metadata = { ...entry.metadata, ...update.metadata };
216
+ }
217
+ if (update.accessLevel !== undefined) {
218
+ entry.accessLevel = update.accessLevel;
219
+ }
220
+ if (update.expiresAt !== undefined) {
221
+ entry.expiresAt = update.expiresAt;
222
+ }
223
+ if (update.references !== undefined) {
224
+ entry.references = update.references;
225
+ }
226
+ entry.updatedAt = Date.now();
227
+ entry.version++;
228
+ // Update in AgentDB
229
+ if (this.agentdb) {
230
+ await this.updateInAgentDB(entry);
231
+ }
232
+ this.emit('entry:updated', { id });
233
+ return entry;
234
+ }
235
+ /**
236
+ * Delete entry
237
+ */
238
+ async delete(id) {
239
+ const entry = this.entries.get(id);
240
+ if (!entry)
241
+ return false;
242
+ // Remove from indexes
243
+ this.entries.delete(id);
244
+ this.unregisterIdMapping(id); // Clean up reverse lookup map
245
+ this.namespaceIndex.get(entry.namespace)?.delete(id);
246
+ const keyIndexKey = `${entry.namespace}:${entry.key}`;
247
+ this.keyIndex.delete(keyIndexKey);
248
+ // Delete from AgentDB
249
+ if (this.agentdb) {
250
+ await this.deleteFromAgentDB(id);
251
+ }
252
+ this.emit('entry:deleted', { id });
253
+ return true;
254
+ }
255
+ /**
256
+ * Query entries
257
+ */
258
+ async query(query) {
259
+ const startTime = performance.now();
260
+ let results = [];
261
+ if (query.type === 'semantic' && (query.embedding || query.content)) {
262
+ // Use semantic search
263
+ const searchResults = await this.semanticSearch(query);
264
+ results = searchResults.map((r) => r.entry);
265
+ }
266
+ else {
267
+ // Fallback to in-memory filtering
268
+ results = this.queryInMemory(query);
269
+ }
270
+ const duration = performance.now() - startTime;
271
+ this.stats.queryCount++;
272
+ this.stats.totalQueryTime += duration;
273
+ return results;
274
+ }
275
+ /**
276
+ * Semantic vector search
277
+ */
278
+ async search(embedding, options) {
279
+ const startTime = performance.now();
280
+ if (!this.agentdb) {
281
+ // Fallback to brute-force search
282
+ return this.bruteForceSearch(embedding, options);
283
+ }
284
+ try {
285
+ // Use AgentDB HNSW search
286
+ const results = await this.searchWithAgentDB(embedding, options);
287
+ const duration = performance.now() - startTime;
288
+ this.stats.searchCount++;
289
+ this.stats.totalSearchTime += duration;
290
+ return results;
291
+ }
292
+ catch (error) {
293
+ console.error('AgentDB search failed, falling back to brute-force:', error);
294
+ return this.bruteForceSearch(embedding, options);
295
+ }
296
+ }
297
+ /**
298
+ * Bulk insert
299
+ */
300
+ async bulkInsert(entries) {
301
+ for (const entry of entries) {
302
+ await this.store(entry);
303
+ }
304
+ }
305
+ /**
306
+ * Bulk delete
307
+ */
308
+ async bulkDelete(ids) {
309
+ let deleted = 0;
310
+ for (const id of ids) {
311
+ if (await this.delete(id)) {
312
+ deleted++;
313
+ }
314
+ }
315
+ return deleted;
316
+ }
317
+ /**
318
+ * Count entries
319
+ */
320
+ async count(namespace) {
321
+ if (namespace) {
322
+ return this.namespaceIndex.get(namespace)?.size || 0;
323
+ }
324
+ return this.entries.size;
325
+ }
326
+ /**
327
+ * List namespaces
328
+ */
329
+ async listNamespaces() {
330
+ return Array.from(this.namespaceIndex.keys());
331
+ }
332
+ /**
333
+ * Clear namespace
334
+ */
335
+ async clearNamespace(namespace) {
336
+ const ids = this.namespaceIndex.get(namespace);
337
+ if (!ids)
338
+ return 0;
339
+ let deleted = 0;
340
+ for (const id of ids) {
341
+ if (await this.delete(id)) {
342
+ deleted++;
343
+ }
344
+ }
345
+ return deleted;
346
+ }
347
+ /**
348
+ * Get statistics
349
+ */
350
+ async getStats() {
351
+ const entriesByNamespace = {};
352
+ for (const [namespace, ids] of this.namespaceIndex) {
353
+ entriesByNamespace[namespace] = ids.size;
354
+ }
355
+ const entriesByType = {
356
+ episodic: 0,
357
+ semantic: 0,
358
+ procedural: 0,
359
+ working: 0,
360
+ cache: 0,
361
+ };
362
+ for (const entry of this.entries.values()) {
363
+ entriesByType[entry.type]++;
364
+ }
365
+ // Get HNSW stats if available
366
+ let hnswStats;
367
+ if (this.agentdb && HNSWIndex) {
368
+ try {
369
+ const hnsw = this.agentdb.getController('hnsw');
370
+ if (hnsw) {
371
+ const stats = hnsw.getStats();
372
+ hnswStats = {
373
+ vectorCount: stats.numElements || 0,
374
+ memoryUsage: 0,
375
+ avgSearchTime: stats.avgSearchTimeMs || 0,
376
+ buildTime: stats.lastBuildTime || 0,
377
+ compressionRatio: 1.0,
378
+ };
379
+ }
380
+ }
381
+ catch {
382
+ // HNSW not available
383
+ }
384
+ }
385
+ return {
386
+ totalEntries: this.entries.size,
387
+ entriesByNamespace,
388
+ entriesByType,
389
+ memoryUsage: this.estimateMemoryUsage(),
390
+ hnswStats,
391
+ avgQueryTime: this.stats.queryCount > 0
392
+ ? this.stats.totalQueryTime / this.stats.queryCount
393
+ : 0,
394
+ avgSearchTime: this.stats.searchCount > 0
395
+ ? this.stats.totalSearchTime / this.stats.searchCount
396
+ : 0,
397
+ };
398
+ }
399
+ /**
400
+ * Health check
401
+ */
402
+ async healthCheck() {
403
+ const issues = [];
404
+ const recommendations = [];
405
+ // Check AgentDB availability
406
+ const storageHealth = this.agentdb
407
+ ? { status: 'healthy', latency: 0 }
408
+ : {
409
+ status: 'degraded',
410
+ latency: 0,
411
+ message: 'AgentDB not available, using fallback',
412
+ };
413
+ // Check index health
414
+ const indexHealth = { status: 'healthy', latency: 0 };
415
+ if (!this.agentdb) {
416
+ indexHealth.status = 'degraded';
417
+ indexHealth.message = 'HNSW index not available';
418
+ recommendations.push('Install agentdb for 150x-12,500x faster vector search');
419
+ }
420
+ // Check cache health
421
+ const cacheHealth = { status: 'healthy', latency: 0 };
422
+ const status = storageHealth.status === 'unhealthy' || indexHealth.status === 'unhealthy'
423
+ ? 'unhealthy'
424
+ : storageHealth.status === 'degraded' || indexHealth.status === 'degraded'
425
+ ? 'degraded'
426
+ : 'healthy';
427
+ return {
428
+ status,
429
+ components: {
430
+ storage: storageHealth,
431
+ index: indexHealth,
432
+ cache: cacheHealth,
433
+ },
434
+ timestamp: Date.now(),
435
+ issues,
436
+ recommendations,
437
+ };
438
+ }
439
+ // ===== Private Methods =====
440
+ /**
441
+ * Create database schema
442
+ */
443
+ async createSchema() {
444
+ if (!this.agentdb)
445
+ return;
446
+ const db = this.agentdb.database;
447
+ if (!db || typeof db.run !== 'function') {
448
+ // AgentDB doesn't expose raw database - using native API
449
+ return;
450
+ }
451
+ try {
452
+ // Create memory_entries table
453
+ await db.run(`
454
+ CREATE TABLE IF NOT EXISTS memory_entries (
455
+ id TEXT PRIMARY KEY,
456
+ key TEXT NOT NULL,
457
+ content TEXT NOT NULL,
458
+ embedding BLOB,
459
+ type TEXT NOT NULL,
460
+ namespace TEXT NOT NULL,
461
+ tags TEXT,
462
+ metadata TEXT,
463
+ owner_id TEXT,
464
+ access_level TEXT NOT NULL,
465
+ created_at INTEGER NOT NULL,
466
+ updated_at INTEGER NOT NULL,
467
+ expires_at INTEGER,
468
+ version INTEGER NOT NULL,
469
+ references TEXT,
470
+ access_count INTEGER DEFAULT 0,
471
+ last_accessed_at INTEGER
472
+ )
473
+ `);
474
+ // Create indexes
475
+ await db.run('CREATE INDEX IF NOT EXISTS idx_namespace ON memory_entries(namespace)');
476
+ await db.run('CREATE INDEX IF NOT EXISTS idx_key ON memory_entries(key)');
477
+ await db.run('CREATE INDEX IF NOT EXISTS idx_type ON memory_entries(type)');
478
+ }
479
+ catch {
480
+ // Schema creation failed - using in-memory only
481
+ }
482
+ }
483
+ /**
484
+ * Store entry in AgentDB
485
+ */
486
+ async storeInAgentDB(entry) {
487
+ if (!this.agentdb)
488
+ return;
489
+ // Try to use agentdb's native store method if available
490
+ try {
491
+ if (typeof this.agentdb.store === 'function') {
492
+ await this.agentdb.store(entry.id, {
493
+ key: entry.key,
494
+ content: entry.content,
495
+ embedding: entry.embedding,
496
+ type: entry.type,
497
+ namespace: entry.namespace,
498
+ tags: entry.tags,
499
+ metadata: entry.metadata,
500
+ });
501
+ return;
502
+ }
503
+ // Fallback: use database directly if available
504
+ const db = this.agentdb.database;
505
+ if (!db || typeof db.run !== 'function') {
506
+ // No compatible database interface - skip agentdb storage
507
+ // Entry is already stored in-memory
508
+ return;
509
+ }
510
+ await db.run(`
511
+ INSERT OR REPLACE INTO memory_entries
512
+ (id, key, content, embedding, type, namespace, tags, metadata, owner_id,
513
+ access_level, created_at, updated_at, expires_at, version, references,
514
+ access_count, last_accessed_at)
515
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
516
+ `, [
517
+ entry.id,
518
+ entry.key,
519
+ entry.content,
520
+ entry.embedding ? Buffer.from(entry.embedding.buffer) : null,
521
+ entry.type,
522
+ entry.namespace,
523
+ JSON.stringify(entry.tags),
524
+ JSON.stringify(entry.metadata),
525
+ entry.ownerId || null,
526
+ entry.accessLevel,
527
+ entry.createdAt,
528
+ entry.updatedAt,
529
+ entry.expiresAt || null,
530
+ entry.version,
531
+ JSON.stringify(entry.references),
532
+ entry.accessCount,
533
+ entry.lastAccessedAt,
534
+ ]);
535
+ }
536
+ catch {
537
+ // AgentDB storage failed - entry is already in-memory
538
+ }
539
+ // Add to vector index if HNSW is available
540
+ if (entry.embedding && HNSWIndex) {
541
+ try {
542
+ const hnsw = this.agentdb.getController('hnsw');
543
+ if (hnsw) {
544
+ // Convert string ID to number for HNSW (use hash)
545
+ const numericId = this.stringIdToNumeric(entry.id);
546
+ hnsw.addVector(numericId, entry.embedding);
547
+ }
548
+ }
549
+ catch {
550
+ // HNSW not available
551
+ }
552
+ }
553
+ }
554
+ /**
555
+ * Get entry from AgentDB
556
+ */
557
+ async getFromAgentDB(id) {
558
+ if (!this.agentdb)
559
+ return null;
560
+ try {
561
+ // Try native get method first
562
+ if (typeof this.agentdb.get === 'function') {
563
+ const data = await this.agentdb.get(id);
564
+ if (data)
565
+ return this.dataToEntry(id, data);
566
+ }
567
+ // Fallback to database
568
+ const db = this.agentdb.database;
569
+ if (!db || typeof db.get !== 'function')
570
+ return null;
571
+ const row = await db.get('SELECT * FROM memory_entries WHERE id = ?', [id]);
572
+ if (!row)
573
+ return null;
574
+ return this.rowToEntry(row);
575
+ }
576
+ catch {
577
+ return null;
578
+ }
579
+ }
580
+ /**
581
+ * Convert agentdb data to MemoryEntry
582
+ */
583
+ dataToEntry(id, data) {
584
+ const now = Date.now();
585
+ return {
586
+ id,
587
+ key: data.key || id,
588
+ content: data.content || '',
589
+ embedding: data.embedding,
590
+ type: data.type || 'semantic',
591
+ namespace: data.namespace || this.config.namespace,
592
+ tags: data.tags || [],
593
+ metadata: data.metadata || {},
594
+ ownerId: data.ownerId,
595
+ accessLevel: data.accessLevel || 'private',
596
+ createdAt: data.createdAt || now,
597
+ updatedAt: data.updatedAt || now,
598
+ expiresAt: data.expiresAt,
599
+ version: data.version || 1,
600
+ references: data.references || [],
601
+ accessCount: data.accessCount || 0,
602
+ lastAccessedAt: data.lastAccessedAt || now,
603
+ };
604
+ }
605
+ /**
606
+ * Update entry in AgentDB
607
+ */
608
+ async updateInAgentDB(entry) {
609
+ await this.storeInAgentDB(entry);
610
+ }
611
+ /**
612
+ * Delete entry from AgentDB
613
+ */
614
+ async deleteFromAgentDB(id) {
615
+ if (!this.agentdb)
616
+ return;
617
+ try {
618
+ // Try native delete method first
619
+ if (typeof this.agentdb.delete === 'function') {
620
+ await this.agentdb.delete(id);
621
+ return;
622
+ }
623
+ // Fallback to database
624
+ const db = this.agentdb.database;
625
+ if (!db || typeof db.run !== 'function')
626
+ return;
627
+ await db.run('DELETE FROM memory_entries WHERE id = ?', [id]);
628
+ }
629
+ catch {
630
+ // Delete failed - entry removed from in-memory
631
+ }
632
+ }
633
+ /**
634
+ * Search with AgentDB HNSW
635
+ */
636
+ async searchWithAgentDB(embedding, options) {
637
+ if (!this.agentdb || !HNSWIndex) {
638
+ return [];
639
+ }
640
+ try {
641
+ const hnsw = this.agentdb.getController('hnsw');
642
+ if (!hnsw) {
643
+ return this.bruteForceSearch(embedding, options);
644
+ }
645
+ const results = await hnsw.search(embedding, options.k, {
646
+ threshold: options.threshold,
647
+ });
648
+ const searchResults = [];
649
+ for (const result of results) {
650
+ const id = this.numericIdToString(result.id);
651
+ const entry = await this.get(id);
652
+ if (!entry)
653
+ continue;
654
+ searchResults.push({
655
+ entry,
656
+ score: result.similarity,
657
+ distance: result.distance,
658
+ });
659
+ }
660
+ return searchResults;
661
+ }
662
+ catch (error) {
663
+ console.error('HNSW search failed:', error);
664
+ return this.bruteForceSearch(embedding, options);
665
+ }
666
+ }
667
+ /**
668
+ * Brute-force vector search fallback
669
+ */
670
+ bruteForceSearch(embedding, options) {
671
+ const results = [];
672
+ for (const entry of this.entries.values()) {
673
+ if (!entry.embedding)
674
+ continue;
675
+ const score = this.cosineSimilarity(embedding, entry.embedding);
676
+ const distance = 1 - score;
677
+ if (options.threshold && score < options.threshold)
678
+ continue;
679
+ results.push({ entry, score, distance });
680
+ }
681
+ // Sort by score descending
682
+ results.sort((a, b) => b.score - a.score);
683
+ return results.slice(0, options.k);
684
+ }
685
+ /**
686
+ * Semantic search helper
687
+ */
688
+ async semanticSearch(query) {
689
+ let embedding = query.embedding;
690
+ if (!embedding && query.content && this.config.embeddingGenerator) {
691
+ embedding = await this.config.embeddingGenerator(query.content);
692
+ }
693
+ if (!embedding) {
694
+ return [];
695
+ }
696
+ return this.search(embedding, {
697
+ k: query.limit,
698
+ threshold: query.threshold,
699
+ filters: query,
700
+ });
701
+ }
702
+ /**
703
+ * In-memory query fallback
704
+ */
705
+ queryInMemory(query) {
706
+ let results = Array.from(this.entries.values());
707
+ // Apply filters
708
+ if (query.namespace) {
709
+ results = results.filter((e) => e.namespace === query.namespace);
710
+ }
711
+ if (query.key) {
712
+ results = results.filter((e) => e.key === query.key);
713
+ }
714
+ if (query.keyPrefix) {
715
+ results = results.filter((e) => e.key.startsWith(query.keyPrefix));
716
+ }
717
+ if (query.tags && query.tags.length > 0) {
718
+ results = results.filter((e) => query.tags.every((tag) => e.tags.includes(tag)));
719
+ }
720
+ return results.slice(0, query.limit);
721
+ }
722
+ /**
723
+ * Update in-memory indexes
724
+ */
725
+ updateIndexes(entry) {
726
+ const namespace = entry.namespace;
727
+ if (!this.namespaceIndex.has(namespace)) {
728
+ this.namespaceIndex.set(namespace, new Set());
729
+ }
730
+ this.namespaceIndex.get(namespace).add(entry.id);
731
+ const keyIndexKey = `${namespace}:${entry.key}`;
732
+ this.keyIndex.set(keyIndexKey, entry.id);
733
+ }
734
+ /**
735
+ * Convert DB row to MemoryEntry
736
+ */
737
+ rowToEntry(row) {
738
+ return {
739
+ id: row.id,
740
+ key: row.key,
741
+ content: row.content,
742
+ embedding: row.embedding
743
+ ? new Float32Array(new Uint8Array(row.embedding).buffer)
744
+ : undefined,
745
+ type: row.type,
746
+ namespace: row.namespace,
747
+ tags: JSON.parse(row.tags || '[]'),
748
+ metadata: JSON.parse(row.metadata || '{}'),
749
+ ownerId: row.owner_id,
750
+ accessLevel: row.access_level,
751
+ createdAt: row.created_at,
752
+ updatedAt: row.updated_at,
753
+ expiresAt: row.expires_at,
754
+ version: row.version,
755
+ references: JSON.parse(row.references || '[]'),
756
+ accessCount: row.access_count || 0,
757
+ lastAccessedAt: row.last_accessed_at || row.created_at,
758
+ };
759
+ }
760
+ /**
761
+ * Convert string ID to numeric for HNSW
762
+ */
763
+ stringIdToNumeric(id) {
764
+ let hash = 0;
765
+ for (let i = 0; i < id.length; i++) {
766
+ hash = (hash << 5) - hash + id.charCodeAt(i);
767
+ hash |= 0;
768
+ }
769
+ return Math.abs(hash);
770
+ }
771
+ /**
772
+ * Convert numeric ID back to string using O(1) reverse lookup
773
+ * PERFORMANCE FIX: Uses pre-built reverse map instead of O(n) linear scan
774
+ */
775
+ numericIdToString(numericId) {
776
+ // Use O(1) reverse lookup map
777
+ const stringId = this.numericToStringIdMap.get(numericId);
778
+ if (stringId) {
779
+ return stringId;
780
+ }
781
+ // Fallback for unmapped IDs
782
+ return String(numericId);
783
+ }
784
+ /**
785
+ * Register string ID in reverse lookup map
786
+ * Called when storing entries to maintain bidirectional mapping
787
+ */
788
+ registerIdMapping(stringId) {
789
+ const numericId = this.stringIdToNumeric(stringId);
790
+ this.numericToStringIdMap.set(numericId, stringId);
791
+ }
792
+ /**
793
+ * Unregister string ID from reverse lookup map
794
+ * Called when deleting entries
795
+ */
796
+ unregisterIdMapping(stringId) {
797
+ const numericId = this.stringIdToNumeric(stringId);
798
+ this.numericToStringIdMap.delete(numericId);
799
+ }
800
+ /**
801
+ * Cosine similarity (returns value in range [0, 1] where 1 = identical)
802
+ */
803
+ cosineSimilarity(a, b) {
804
+ let dotProduct = 0;
805
+ let normA = 0;
806
+ let normB = 0;
807
+ for (let i = 0; i < a.length; i++) {
808
+ dotProduct += a[i] * b[i];
809
+ normA += a[i] * a[i];
810
+ normB += b[i] * b[i];
811
+ }
812
+ const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
813
+ return magnitude === 0 ? 0 : dotProduct / magnitude;
814
+ }
815
+ /**
816
+ * Estimate memory usage
817
+ */
818
+ estimateMemoryUsage() {
819
+ let total = 0;
820
+ for (const entry of this.entries.values()) {
821
+ total += entry.content.length * 2;
822
+ if (entry.embedding) {
823
+ total += entry.embedding.length * 4;
824
+ }
825
+ }
826
+ return total;
827
+ }
828
+ /**
829
+ * Check if AgentDB is available
830
+ */
831
+ isAvailable() {
832
+ return this.available;
833
+ }
834
+ /**
835
+ * Get underlying AgentDB instance
836
+ */
837
+ getAgentDB() {
838
+ return this.agentdb;
839
+ }
840
+ }
841
+ export default AgentDBBackend;
842
+ //# sourceMappingURL=agentdb-backend.js.map