agentdb 3.0.0-alpha.8 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +248 -269
- package/dist/schemas/frontier-schema.sql +7 -0
- package/dist/schemas/schema.sql +7 -0
- package/dist/src/backends/VectorBackend.d.ts +48 -6
- package/dist/src/backends/VectorBackend.d.ts.map +1 -1
- package/dist/src/backends/VectorBackend.js +13 -1
- package/dist/src/backends/VectorBackend.js.map +1 -1
- package/dist/src/backends/detector.js.map +1 -1
- package/dist/src/backends/factory.d.ts +16 -33
- package/dist/src/backends/factory.d.ts.map +1 -1
- package/dist/src/backends/factory.js +140 -110
- package/dist/src/backends/factory.js.map +1 -1
- package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts +54 -6
- package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts.map +1 -1
- package/dist/src/backends/graph/GraphDatabaseAdapter.js +143 -6
- package/dist/src/backends/graph/GraphDatabaseAdapter.js.map +1 -1
- package/dist/src/backends/hnswlib/HNSWLibBackend.d.ts.map +1 -1
- package/dist/src/backends/hnswlib/HNSWLibBackend.js +35 -8
- package/dist/src/backends/hnswlib/HNSWLibBackend.js.map +1 -1
- package/dist/src/backends/index.d.ts +2 -1
- package/dist/src/backends/index.d.ts.map +1 -1
- package/dist/src/backends/index.js +2 -0
- package/dist/src/backends/index.js.map +1 -1
- package/dist/src/backends/ruvector/RuVectorBackend.d.ts +256 -45
- package/dist/src/backends/ruvector/RuVectorBackend.d.ts.map +1 -1
- package/dist/src/backends/ruvector/RuVectorBackend.js +764 -290
- package/dist/src/backends/ruvector/RuVectorBackend.js.map +1 -1
- package/dist/src/backends/ruvector/RuVectorLearning.d.ts +0 -4
- package/dist/src/backends/ruvector/RuVectorLearning.d.ts.map +1 -1
- package/dist/src/backends/ruvector/RuVectorLearning.js +0 -6
- package/dist/src/backends/ruvector/RuVectorLearning.js.map +1 -1
- package/dist/src/backends/rvf/AdaptiveIndexTuner.d.ts +175 -0
- package/dist/src/backends/rvf/AdaptiveIndexTuner.d.ts.map +1 -0
- package/dist/src/backends/rvf/AdaptiveIndexTuner.js +567 -0
- package/dist/src/backends/rvf/AdaptiveIndexTuner.js.map +1 -0
- package/dist/src/backends/rvf/ContrastiveTrainer.d.ts +148 -0
- package/dist/src/backends/rvf/ContrastiveTrainer.d.ts.map +1 -0
- package/dist/src/backends/rvf/ContrastiveTrainer.js +438 -0
- package/dist/src/backends/rvf/ContrastiveTrainer.js.map +1 -0
- package/dist/src/backends/rvf/FederatedSessionManager.d.ts +212 -0
- package/dist/src/backends/rvf/FederatedSessionManager.d.ts.map +1 -0
- package/dist/src/backends/rvf/FederatedSessionManager.js +397 -0
- package/dist/src/backends/rvf/FederatedSessionManager.js.map +1 -0
- package/dist/src/backends/rvf/FilterBuilder.d.ts +136 -0
- package/dist/src/backends/rvf/FilterBuilder.d.ts.map +1 -0
- package/dist/src/backends/rvf/FilterBuilder.js +157 -0
- package/dist/src/backends/rvf/FilterBuilder.js.map +1 -0
- package/dist/src/backends/rvf/NativeAccelerator.d.ts +158 -0
- package/dist/src/backends/rvf/NativeAccelerator.d.ts.map +1 -0
- package/dist/src/backends/rvf/NativeAccelerator.js +702 -0
- package/dist/src/backends/rvf/NativeAccelerator.js.map +1 -0
- package/dist/src/backends/rvf/RvfBackend.d.ts +207 -0
- package/dist/src/backends/rvf/RvfBackend.d.ts.map +1 -0
- package/dist/src/backends/rvf/RvfBackend.js +651 -0
- package/dist/src/backends/rvf/RvfBackend.js.map +1 -0
- package/dist/src/backends/rvf/RvfSolver.d.ts +175 -0
- package/dist/src/backends/rvf/RvfSolver.d.ts.map +1 -0
- package/dist/src/backends/rvf/RvfSolver.js +176 -0
- package/dist/src/backends/rvf/RvfSolver.js.map +1 -0
- package/dist/src/backends/rvf/SelfLearningRvfBackend.d.ts +143 -0
- package/dist/src/backends/rvf/SelfLearningRvfBackend.d.ts.map +1 -0
- package/dist/src/backends/rvf/SelfLearningRvfBackend.js +612 -0
- package/dist/src/backends/rvf/SelfLearningRvfBackend.js.map +1 -0
- package/dist/src/backends/rvf/SemanticQueryRouter.d.ts +128 -0
- package/dist/src/backends/rvf/SemanticQueryRouter.d.ts.map +1 -0
- package/dist/src/backends/rvf/SemanticQueryRouter.js +415 -0
- package/dist/src/backends/rvf/SemanticQueryRouter.js.map +1 -0
- package/dist/src/backends/rvf/SimdFallbacks.d.ts +25 -0
- package/dist/src/backends/rvf/SimdFallbacks.d.ts.map +1 -0
- package/dist/src/backends/rvf/SimdFallbacks.js +287 -0
- package/dist/src/backends/rvf/SimdFallbacks.js.map +1 -0
- package/dist/src/backends/rvf/SolverBandit.d.ts +100 -0
- package/dist/src/backends/rvf/SolverBandit.d.ts.map +1 -0
- package/dist/src/backends/rvf/SolverBandit.js +216 -0
- package/dist/src/backends/rvf/SolverBandit.js.map +1 -0
- package/dist/src/backends/rvf/SonaLearningBackend.d.ts +157 -0
- package/dist/src/backends/rvf/SonaLearningBackend.d.ts.map +1 -0
- package/dist/src/backends/rvf/SonaLearningBackend.js +283 -0
- package/dist/src/backends/rvf/SonaLearningBackend.js.map +1 -0
- package/dist/src/backends/rvf/SqlJsRvfBackend.d.ts +104 -0
- package/dist/src/backends/rvf/SqlJsRvfBackend.d.ts.map +1 -0
- package/dist/src/backends/rvf/SqlJsRvfBackend.js +464 -0
- package/dist/src/backends/rvf/SqlJsRvfBackend.js.map +1 -0
- package/dist/src/backends/rvf/WasmStoreBridge.d.ts +27 -0
- package/dist/src/backends/rvf/WasmStoreBridge.d.ts.map +1 -0
- package/dist/src/backends/rvf/WasmStoreBridge.js +87 -0
- package/dist/src/backends/rvf/WasmStoreBridge.js.map +1 -0
- package/dist/src/backends/rvf/validation.d.ts +20 -0
- package/dist/src/backends/rvf/validation.d.ts.map +1 -0
- package/dist/src/backends/rvf/validation.js +78 -0
- package/dist/src/backends/rvf/validation.js.map +1 -0
- package/dist/src/benchmark/BenchmarkSuite.d.ts +318 -0
- package/dist/src/benchmark/BenchmarkSuite.d.ts.map +1 -0
- package/dist/src/benchmark/BenchmarkSuite.js +984 -0
- package/dist/src/benchmark/BenchmarkSuite.js.map +1 -0
- package/dist/src/benchmark/index.d.ts +29 -0
- package/dist/src/benchmark/index.d.ts.map +1 -0
- package/dist/src/benchmark/index.js +39 -0
- package/dist/src/benchmark/index.js.map +1 -0
- package/dist/src/browser/AttentionBrowser.d.ts.map +1 -1
- package/dist/src/browser/AttentionBrowser.js +1 -0
- package/dist/src/browser/AttentionBrowser.js.map +1 -1
- package/dist/src/cli/agentdb-cli.d.ts +14 -0
- package/dist/src/cli/agentdb-cli.d.ts.map +1 -1
- package/dist/src/cli/agentdb-cli.js +839 -143
- package/dist/src/cli/agentdb-cli.js.map +1 -1
- package/dist/src/cli/commands/attention.js +12 -2
- package/dist/src/cli/commands/attention.js.map +1 -1
- package/dist/src/cli/commands/doctor.js +5 -5
- package/dist/src/cli/commands/doctor.js.map +1 -1
- package/dist/src/cli/commands/hyperbolic.d.ts +11 -0
- package/dist/src/cli/commands/hyperbolic.d.ts.map +1 -0
- package/dist/src/cli/commands/hyperbolic.js +440 -0
- package/dist/src/cli/commands/hyperbolic.js.map +1 -0
- package/dist/src/cli/commands/install-embeddings.d.ts +1 -1
- package/dist/src/cli/commands/install-embeddings.d.ts.map +1 -1
- package/dist/src/cli/commands/install-embeddings.js +17 -11
- package/dist/src/cli/commands/install-embeddings.js.map +1 -1
- package/dist/src/cli/commands/learn.d.ts +11 -0
- package/dist/src/cli/commands/learn.d.ts.map +1 -0
- package/dist/src/cli/commands/learn.js +410 -0
- package/dist/src/cli/commands/learn.js.map +1 -0
- package/dist/src/cli/commands/migrate.d.ts +15 -0
- package/dist/src/cli/commands/migrate.d.ts.map +1 -1
- package/dist/src/cli/commands/migrate.js +190 -10
- package/dist/src/cli/commands/migrate.js.map +1 -1
- package/dist/src/cli/commands/route.d.ts +11 -0
- package/dist/src/cli/commands/route.d.ts.map +1 -0
- package/dist/src/cli/commands/route.js +419 -0
- package/dist/src/cli/commands/route.js.map +1 -0
- package/dist/src/cli/commands/rvf.d.ts +21 -0
- package/dist/src/cli/commands/rvf.d.ts.map +1 -0
- package/dist/src/cli/commands/rvf.js +448 -0
- package/dist/src/cli/commands/rvf.js.map +1 -0
- package/dist/src/cli/commands/simulate-report.js +14 -2
- package/dist/src/cli/commands/simulate-report.js.map +1 -1
- package/dist/src/cli/lib/report-store.d.ts +2 -1
- package/dist/src/cli/lib/report-store.d.ts.map +1 -1
- package/dist/src/cli/lib/report-store.js +85 -65
- package/dist/src/cli/lib/report-store.js.map +1 -1
- package/dist/src/cli/lib/simulation-runner.d.ts +40 -3
- package/dist/src/cli/lib/simulation-runner.d.ts.map +1 -1
- package/dist/src/cli/lib/simulation-runner.js +248 -6
- package/dist/src/cli/lib/simulation-runner.js.map +1 -1
- package/dist/src/compatibility/DeprecationWarnings.d.ts +54 -0
- package/dist/src/compatibility/DeprecationWarnings.d.ts.map +1 -0
- package/dist/src/compatibility/DeprecationWarnings.js +131 -0
- package/dist/src/compatibility/DeprecationWarnings.js.map +1 -0
- package/dist/src/compatibility/MigrationUtilities.d.ts +30 -0
- package/dist/src/compatibility/MigrationUtilities.d.ts.map +1 -0
- package/dist/src/compatibility/MigrationUtilities.js +184 -0
- package/dist/src/compatibility/MigrationUtilities.js.map +1 -0
- package/dist/src/compatibility/V1toV2Adapter.d.ts +76 -0
- package/dist/src/compatibility/V1toV2Adapter.d.ts.map +1 -0
- package/dist/src/compatibility/V1toV2Adapter.js +185 -0
- package/dist/src/compatibility/V1toV2Adapter.js.map +1 -0
- package/dist/src/compatibility/VersionDetector.d.ts +32 -0
- package/dist/src/compatibility/VersionDetector.d.ts.map +1 -0
- package/dist/src/compatibility/VersionDetector.js +144 -0
- package/dist/src/compatibility/VersionDetector.js.map +1 -0
- package/dist/src/compatibility/index.d.ts +14 -0
- package/dist/src/compatibility/index.d.ts.map +1 -0
- package/dist/src/compatibility/index.js +21 -0
- package/dist/src/compatibility/index.js.map +1 -0
- package/dist/src/compatibility/types.d.ts +103 -0
- package/dist/src/compatibility/types.d.ts.map +1 -0
- package/dist/src/compatibility/types.js +5 -0
- package/dist/src/compatibility/types.js.map +1 -0
- package/dist/src/controllers/AttentionService.d.ts +99 -202
- package/dist/src/controllers/AttentionService.d.ts.map +1 -1
- package/dist/src/controllers/AttentionService.js +450 -558
- package/dist/src/controllers/AttentionService.js.map +1 -1
- package/dist/src/controllers/CausalMemoryGraph.d.ts +30 -5
- package/dist/src/controllers/CausalMemoryGraph.d.ts.map +1 -1
- package/dist/src/controllers/CausalMemoryGraph.js +92 -15
- package/dist/src/controllers/CausalMemoryGraph.js.map +1 -1
- package/dist/src/controllers/CausalRecall.d.ts +4 -0
- package/dist/src/controllers/CausalRecall.d.ts.map +1 -1
- package/dist/src/controllers/CausalRecall.js +23 -5
- package/dist/src/controllers/CausalRecall.js.map +1 -1
- package/dist/src/controllers/EmbeddingService.d.ts +29 -0
- package/dist/src/controllers/EmbeddingService.d.ts.map +1 -1
- package/dist/src/controllers/EmbeddingService.js +154 -32
- package/dist/src/controllers/EmbeddingService.js.map +1 -1
- package/dist/src/controllers/EnhancedEmbeddingService.d.ts +4 -0
- package/dist/src/controllers/EnhancedEmbeddingService.d.ts.map +1 -1
- package/dist/src/controllers/EnhancedEmbeddingService.js +21 -7
- package/dist/src/controllers/EnhancedEmbeddingService.js.map +1 -1
- package/dist/src/controllers/ExplainableRecall.d.ts +1 -1
- package/dist/src/controllers/ExplainableRecall.d.ts.map +1 -1
- package/dist/src/controllers/ExplainableRecall.js +1 -1
- package/dist/src/controllers/ExplainableRecall.js.map +1 -1
- package/dist/src/controllers/HNSWIndex.d.ts +20 -2
- package/dist/src/controllers/HNSWIndex.d.ts.map +1 -1
- package/dist/src/controllers/HNSWIndex.js +114 -39
- package/dist/src/controllers/HNSWIndex.js.map +1 -1
- package/dist/src/controllers/LearningSystem.d.ts +6 -17
- package/dist/src/controllers/LearningSystem.d.ts.map +1 -1
- package/dist/src/controllers/LearningSystem.js +66 -155
- package/dist/src/controllers/LearningSystem.js.map +1 -1
- package/dist/src/controllers/MemoryController.d.ts +174 -0
- package/dist/src/controllers/MemoryController.d.ts.map +1 -0
- package/dist/src/controllers/MemoryController.js +320 -0
- package/dist/src/controllers/MemoryController.js.map +1 -0
- package/dist/src/controllers/MetadataFilter.d.ts.map +1 -1
- package/dist/src/controllers/MetadataFilter.js +38 -26
- package/dist/src/controllers/MetadataFilter.js.map +1 -1
- package/dist/src/controllers/MincutService.d.ts +92 -0
- package/dist/src/controllers/MincutService.d.ts.map +1 -0
- package/dist/src/controllers/MincutService.js +336 -0
- package/dist/src/controllers/MincutService.js.map +1 -0
- package/dist/src/controllers/NightlyLearner.d.ts +5 -1
- package/dist/src/controllers/NightlyLearner.d.ts.map +1 -1
- package/dist/src/controllers/NightlyLearner.js +45 -31
- package/dist/src/controllers/NightlyLearner.js.map +1 -1
- package/dist/src/controllers/QUICClient.d.ts +45 -0
- package/dist/src/controllers/QUICClient.d.ts.map +1 -1
- package/dist/src/controllers/QUICClient.js +211 -21
- package/dist/src/controllers/QUICClient.js.map +1 -1
- package/dist/src/controllers/QUICServer.d.ts.map +1 -1
- package/dist/src/controllers/QUICServer.js +36 -27
- package/dist/src/controllers/QUICServer.js.map +1 -1
- package/dist/src/controllers/ReasoningBank.d.ts +6 -3
- package/dist/src/controllers/ReasoningBank.d.ts.map +1 -1
- package/dist/src/controllers/ReasoningBank.js +77 -56
- package/dist/src/controllers/ReasoningBank.js.map +1 -1
- package/dist/src/controllers/ReflexionMemory.d.ts +129 -6
- package/dist/src/controllers/ReflexionMemory.d.ts.map +1 -1
- package/dist/src/controllers/ReflexionMemory.js +678 -220
- package/dist/src/controllers/ReflexionMemory.js.map +1 -1
- package/dist/src/controllers/SkillLibrary.d.ts +32 -3
- package/dist/src/controllers/SkillLibrary.d.ts.map +1 -1
- package/dist/src/controllers/SkillLibrary.js +239 -104
- package/dist/src/controllers/SkillLibrary.js.map +1 -1
- package/dist/src/controllers/SparsificationService.d.ts +151 -0
- package/dist/src/controllers/SparsificationService.d.ts.map +1 -0
- package/dist/src/controllers/SparsificationService.js +375 -0
- package/dist/src/controllers/SparsificationService.js.map +1 -0
- package/dist/src/controllers/SyncCoordinator.d.ts.map +1 -1
- package/dist/src/controllers/SyncCoordinator.js +126 -12
- package/dist/src/controllers/SyncCoordinator.js.map +1 -1
- package/dist/src/controllers/WASMVectorSearch.d.ts +12 -30
- package/dist/src/controllers/WASMVectorSearch.d.ts.map +1 -1
- package/dist/src/controllers/WASMVectorSearch.js +161 -102
- package/dist/src/controllers/WASMVectorSearch.js.map +1 -1
- package/dist/src/controllers/attention/AttentionCache.d.ts +38 -0
- package/dist/src/controllers/attention/AttentionCache.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionCache.js +80 -0
- package/dist/src/controllers/attention/AttentionCache.js.map +1 -0
- package/dist/src/controllers/attention/AttentionConfig.d.ts +127 -0
- package/dist/src/controllers/attention/AttentionConfig.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionConfig.js +124 -0
- package/dist/src/controllers/attention/AttentionConfig.js.map +1 -0
- package/dist/src/controllers/attention/AttentionCore.d.ts +89 -0
- package/dist/src/controllers/attention/AttentionCore.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionCore.js +289 -0
- package/dist/src/controllers/attention/AttentionCore.js.map +1 -0
- package/dist/src/controllers/attention/AttentionHelpers.d.ts +55 -0
- package/dist/src/controllers/attention/AttentionHelpers.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionHelpers.js +148 -0
- package/dist/src/controllers/attention/AttentionHelpers.js.map +1 -0
- package/dist/src/controllers/attention/AttentionMetrics.d.ts +55 -0
- package/dist/src/controllers/attention/AttentionMetrics.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionMetrics.js +72 -0
- package/dist/src/controllers/attention/AttentionMetrics.js.map +1 -0
- package/dist/src/controllers/attention/AttentionWASM.d.ts +98 -0
- package/dist/src/controllers/attention/AttentionWASM.d.ts.map +1 -0
- package/dist/src/controllers/attention/AttentionWASM.js +147 -0
- package/dist/src/controllers/attention/AttentionWASM.js.map +1 -0
- package/dist/src/controllers/attention/CrossAttentionController.d.ts +141 -0
- package/dist/src/controllers/attention/CrossAttentionController.d.ts.map +1 -0
- package/dist/src/controllers/attention/CrossAttentionController.js +325 -0
- package/dist/src/controllers/attention/CrossAttentionController.js.map +1 -0
- package/dist/src/controllers/attention/MultiHeadAttentionController.d.ts +137 -0
- package/dist/src/controllers/attention/MultiHeadAttentionController.d.ts.map +1 -0
- package/dist/src/controllers/attention/MultiHeadAttentionController.js +336 -0
- package/dist/src/controllers/attention/MultiHeadAttentionController.js.map +1 -0
- package/dist/src/controllers/attention/SelfAttentionController.d.ts +117 -0
- package/dist/src/controllers/attention/SelfAttentionController.d.ts.map +1 -0
- package/dist/src/controllers/attention/SelfAttentionController.js +205 -0
- package/dist/src/controllers/attention/SelfAttentionController.js.map +1 -0
- package/dist/src/controllers/attention/index.d.ts +24 -0
- package/dist/src/controllers/attention/index.d.ts.map +1 -0
- package/dist/src/controllers/attention/index.js +20 -0
- package/dist/src/controllers/attention/index.js.map +1 -0
- package/dist/src/controllers/index.d.ts +15 -28
- package/dist/src/controllers/index.d.ts.map +1 -1
- package/dist/src/controllers/index.js +11 -19
- package/dist/src/controllers/index.js.map +1 -1
- package/dist/src/controllers/prerequisites.d.ts +76 -0
- package/dist/src/controllers/prerequisites.d.ts.map +1 -0
- package/dist/src/controllers/prerequisites.js +235 -0
- package/dist/src/controllers/prerequisites.js.map +1 -0
- package/dist/src/core/AgentDB.d.ts +33 -19
- package/dist/src/core/AgentDB.d.ts.map +1 -1
- package/dist/src/core/AgentDB.js +87 -127
- package/dist/src/core/AgentDB.js.map +1 -1
- package/dist/src/core/QueryCache.d.ts +138 -0
- package/dist/src/core/QueryCache.d.ts.map +1 -0
- package/dist/src/core/QueryCache.js +309 -0
- package/dist/src/core/QueryCache.js.map +1 -0
- package/dist/src/db-fallback.d.ts +52 -4
- package/dist/src/db-fallback.d.ts.map +1 -1
- package/dist/src/db-fallback.js +521 -71
- package/dist/src/db-fallback.js.map +1 -1
- package/dist/src/db-unified.d.ts.map +1 -1
- package/dist/src/db-unified.js +32 -30
- package/dist/src/db-unified.js.map +1 -1
- package/dist/src/embedding/EmbeddingSpaceIdentity.d.ts +58 -0
- package/dist/src/embedding/EmbeddingSpaceIdentity.d.ts.map +1 -0
- package/dist/src/embedding/EmbeddingSpaceIdentity.js +137 -0
- package/dist/src/embedding/EmbeddingSpaceIdentity.js.map +1 -0
- package/dist/src/embedding/index.d.ts +3 -0
- package/dist/src/embedding/index.d.ts.map +1 -0
- package/dist/src/embedding/index.js +2 -0
- package/dist/src/embedding/index.js.map +1 -0
- package/dist/src/examples/quic-sync-example.js +2 -2
- package/dist/src/examples/quic-sync-example.js.map +1 -1
- package/dist/src/governance/MetaHarnessGateway.d.ts +55 -0
- package/dist/src/governance/MetaHarnessGateway.d.ts.map +1 -0
- package/dist/src/governance/MetaHarnessGateway.js +65 -0
- package/dist/src/governance/MetaHarnessGateway.js.map +1 -0
- package/dist/src/governance/RvfExperimentBranch.d.ts +65 -0
- package/dist/src/governance/RvfExperimentBranch.d.ts.map +1 -0
- package/dist/src/governance/RvfExperimentBranch.js +115 -0
- package/dist/src/governance/RvfExperimentBranch.js.map +1 -0
- package/dist/src/index.d.ts +20 -16
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +44 -12
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/agentdb-mcp-server.js +178 -15
- package/dist/src/mcp/agentdb-mcp-server.js.map +1 -1
- package/dist/src/mcp/reset-database.d.ts +15 -0
- package/dist/src/mcp/reset-database.d.ts.map +1 -0
- package/dist/src/mcp/reset-database.js +45 -0
- package/dist/src/mcp/reset-database.js.map +1 -0
- package/dist/src/model/ModelCacheLoader.d.ts +31 -0
- package/dist/src/model/ModelCacheLoader.d.ts.map +1 -0
- package/dist/src/model/ModelCacheLoader.js +209 -0
- package/dist/src/model/ModelCacheLoader.js.map +1 -0
- package/dist/src/observability/index.d.ts +8 -0
- package/dist/src/observability/index.d.ts.map +1 -0
- package/dist/src/observability/index.js +8 -0
- package/dist/src/observability/index.js.map +1 -0
- package/dist/src/observability/integration.d.ts +32 -0
- package/dist/src/observability/integration.d.ts.map +1 -0
- package/dist/src/observability/integration.js +159 -0
- package/dist/src/observability/integration.js.map +1 -0
- package/dist/src/observability/telemetry.d.ts +137 -0
- package/dist/src/observability/telemetry.d.ts.map +1 -0
- package/dist/src/observability/telemetry.js +424 -0
- package/dist/src/observability/telemetry.js.map +1 -0
- package/dist/src/optimizations/BatchOperations.d.ts +47 -0
- package/dist/src/optimizations/BatchOperations.d.ts.map +1 -1
- package/dist/src/optimizations/BatchOperations.js +189 -35
- package/dist/src/optimizations/BatchOperations.js.map +1 -1
- package/dist/src/optimizations/Quantization.d.ts +330 -0
- package/dist/src/optimizations/Quantization.d.ts.map +1 -0
- package/dist/src/optimizations/Quantization.js +793 -0
- package/dist/src/optimizations/Quantization.js.map +1 -0
- package/dist/src/optimizations/index.d.ts +1 -3
- package/dist/src/optimizations/index.d.ts.map +1 -1
- package/dist/src/optimizations/index.js +0 -1
- package/dist/src/optimizations/index.js.map +1 -1
- package/dist/src/quantization/index.d.ts +7 -0
- package/dist/src/quantization/index.d.ts.map +1 -0
- package/dist/src/quantization/index.js +15 -0
- package/dist/src/quantization/index.js.map +1 -0
- package/dist/src/quantization/vector-quantization.d.ts +388 -0
- package/dist/src/quantization/vector-quantization.d.ts.map +1 -0
- package/dist/src/quantization/vector-quantization.js +1132 -0
- package/dist/src/quantization/vector-quantization.js.map +1 -0
- package/dist/src/schemas/inline.d.ts +3 -0
- package/dist/src/schemas/inline.d.ts.map +1 -0
- package/dist/src/schemas/inline.js +10 -0
- package/dist/src/schemas/inline.js.map +1 -0
- package/dist/src/search/HybridSearch.d.ts +311 -0
- package/dist/src/search/HybridSearch.d.ts.map +1 -0
- package/dist/src/search/HybridSearch.js +713 -0
- package/dist/src/search/HybridSearch.js.map +1 -0
- package/dist/src/search/index.d.ts +12 -0
- package/dist/src/search/index.d.ts.map +1 -0
- package/dist/src/search/index.js +16 -0
- package/dist/src/search/index.js.map +1 -0
- package/dist/src/security/input-validation.d.ts +30 -0
- package/dist/src/security/input-validation.d.ts.map +1 -1
- package/dist/src/security/input-validation.js +77 -3
- package/dist/src/security/input-validation.js.map +1 -1
- package/dist/src/security/limits.d.ts.map +1 -1
- package/dist/src/security/limits.js +12 -3
- package/dist/src/security/limits.js.map +1 -1
- package/dist/src/security/mcp-policy.d.ts +17 -0
- package/dist/src/security/mcp-policy.d.ts.map +1 -0
- package/dist/src/security/mcp-policy.js +90 -0
- package/dist/src/security/mcp-policy.js.map +1 -0
- package/dist/src/security/path-security.d.ts.map +1 -1
- package/dist/src/security/path-security.js +3 -1
- package/dist/src/security/path-security.js.map +1 -1
- package/dist/src/security/validation.js +3 -3
- package/dist/src/security/validation.js.map +1 -1
- package/dist/src/services/AttentionService.d.ts +303 -0
- package/dist/src/services/AttentionService.d.ts.map +1 -0
- package/dist/src/services/AttentionService.js +1165 -0
- package/dist/src/services/AttentionService.js.map +1 -0
- package/dist/src/services/LLMRouter.d.ts +70 -8
- package/dist/src/services/LLMRouter.d.ts.map +1 -1
- package/dist/src/services/LLMRouter.js +279 -28
- package/dist/src/services/LLMRouter.js.map +1 -1
- package/dist/src/services/audit-logger.service.d.ts +168 -0
- package/dist/src/services/audit-logger.service.d.ts.map +1 -0
- package/dist/src/services/audit-logger.service.js +331 -0
- package/dist/src/services/audit-logger.service.js.map +1 -0
- package/dist/src/services/enhanced-embeddings.d.ts +271 -0
- package/dist/src/services/enhanced-embeddings.d.ts.map +1 -0
- package/dist/src/services/enhanced-embeddings.js +1036 -0
- package/dist/src/services/enhanced-embeddings.js.map +1 -0
- package/dist/src/services/federated-learning.d.ts +172 -0
- package/dist/src/services/federated-learning.d.ts.map +1 -0
- package/dist/src/services/federated-learning.js +344 -0
- package/dist/src/services/federated-learning.js.map +1 -0
- package/dist/src/simd/index.d.ts +9 -0
- package/dist/src/simd/index.d.ts.map +1 -0
- package/dist/src/simd/index.js +27 -0
- package/dist/src/simd/index.js.map +1 -0
- package/dist/src/simd/simd-vector-ops.d.ts +332 -0
- package/dist/src/simd/simd-vector-ops.d.ts.map +1 -0
- package/dist/src/simd/simd-vector-ops.js +945 -0
- package/dist/src/simd/simd-vector-ops.js.map +1 -0
- package/dist/src/types/database.types.d.ts +275 -0
- package/dist/src/types/database.types.d.ts.map +1 -0
- package/dist/src/types/database.types.js +55 -0
- package/dist/src/types/database.types.js.map +1 -0
- package/dist/src/types/graph.d.ts +29 -0
- package/dist/src/types/graph.d.ts.map +1 -0
- package/dist/src/types/graph.js +8 -0
- package/dist/src/types/graph.js.map +1 -0
- package/dist/src/utils/chalk-fallback.d.ts +3 -0
- package/dist/src/utils/chalk-fallback.d.ts.map +1 -0
- package/dist/src/utils/chalk-fallback.js +20 -0
- package/dist/src/utils/chalk-fallback.js.map +1 -0
- package/dist/src/utils/similarity.d.ts +11 -0
- package/dist/src/utils/similarity.d.ts.map +1 -0
- package/dist/src/utils/similarity.js +25 -0
- package/dist/src/utils/similarity.js.map +1 -0
- package/dist/src/wasm-loader.d.ts +66 -0
- package/dist/src/wasm-loader.d.ts.map +1 -0
- package/dist/src/wasm-loader.js +76 -0
- package/dist/src/wasm-loader.js.map +1 -0
- package/dist/src/wrappers/agentdb-fast.d.ts +140 -0
- package/dist/src/wrappers/agentdb-fast.d.ts.map +1 -0
- package/dist/src/wrappers/agentdb-fast.js +309 -0
- package/dist/src/wrappers/agentdb-fast.js.map +1 -0
- package/dist/src/wrappers/attention-fallbacks.d.ts +343 -0
- package/dist/src/wrappers/attention-fallbacks.d.ts.map +1 -0
- package/dist/src/wrappers/attention-fallbacks.js +1484 -0
- package/dist/src/wrappers/attention-fallbacks.js.map +1 -0
- package/dist/src/wrappers/attention-native.d.ts +111 -0
- package/dist/src/wrappers/attention-native.d.ts.map +1 -0
- package/dist/src/wrappers/attention-native.js +273 -0
- package/dist/src/wrappers/attention-native.js.map +1 -0
- package/dist/src/wrappers/embedding-service.d.ts +117 -0
- package/dist/src/wrappers/embedding-service.d.ts.map +1 -0
- package/dist/src/wrappers/embedding-service.js +370 -0
- package/dist/src/wrappers/embedding-service.js.map +1 -0
- package/dist/src/wrappers/gnn-wrapper.d.ts +71 -0
- package/dist/src/wrappers/gnn-wrapper.d.ts.map +1 -0
- package/dist/src/wrappers/gnn-wrapper.js +236 -0
- package/dist/src/wrappers/gnn-wrapper.js.map +1 -0
- package/dist/src/wrappers/index.d.ts +48 -0
- package/dist/src/wrappers/index.d.ts.map +1 -0
- package/dist/src/wrappers/index.js +83 -0
- package/dist/src/wrappers/index.js.map +1 -0
- package/package.json +130 -80
- package/scripts/postinstall.cjs +13 -144
- package/dist/agentdb.browser.js +0 -1685
- package/dist/agentdb.browser.js.map +0 -7
- package/dist/agentdb.browser.min.js +0 -3
- package/dist/agentdb.browser.min.js.map +0 -7
- package/dist/agentdb.wasm-loader.js +0 -207
- package/dist/backends/VectorBackend.d.ts +0 -120
- package/dist/backends/VectorBackend.js +0 -14
- package/dist/backends/VectorBackend.js.map +0 -1
- package/dist/optimizations/RVFOptimizer.d.ts +0 -225
- package/dist/optimizations/RVFOptimizer.js +0 -541
- package/dist/optimizations/RVFOptimizer.js.map +0 -1
- package/dist/simulation/cli.d.ts +0 -9
- package/dist/simulation/cli.d.ts.map +0 -1
- package/dist/simulation/cli.js +0 -68
- package/dist/simulation/cli.js.map +0 -1
- package/dist/simulation/runner.d.ts +0 -21
- package/dist/simulation/runner.d.ts.map +0 -1
- package/dist/simulation/runner.js +0 -241
- package/dist/simulation/runner.js.map +0 -1
- package/dist/simulation/scenarios/aidefence-integration.d.ts +0 -24
- package/dist/simulation/scenarios/aidefence-integration.d.ts.map +0 -1
- package/dist/simulation/scenarios/aidefence-integration.js +0 -124
- package/dist/simulation/scenarios/aidefence-integration.js.map +0 -1
- package/dist/simulation/scenarios/bmssp-integration.d.ts +0 -23
- package/dist/simulation/scenarios/bmssp-integration.d.ts.map +0 -1
- package/dist/simulation/scenarios/bmssp-integration.js +0 -104
- package/dist/simulation/scenarios/bmssp-integration.js.map +0 -1
- package/dist/simulation/scenarios/causal-reasoning.d.ts +0 -16
- package/dist/simulation/scenarios/causal-reasoning.d.ts.map +0 -1
- package/dist/simulation/scenarios/causal-reasoning.js +0 -108
- package/dist/simulation/scenarios/causal-reasoning.js.map +0 -1
- package/dist/simulation/scenarios/consciousness-explorer.d.ts +0 -25
- package/dist/simulation/scenarios/consciousness-explorer.d.ts.map +0 -1
- package/dist/simulation/scenarios/consciousness-explorer.js +0 -108
- package/dist/simulation/scenarios/consciousness-explorer.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts +0 -135
- package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js +0 -158
- package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/index.d.ts +0 -14
- package/dist/simulation/scenarios/domain-examples/index.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/index.js +0 -14
- package/dist/simulation/scenarios/domain-examples/index.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts +0 -178
- package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js +0 -218
- package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts +0 -122
- package/dist/simulation/scenarios/domain-examples/medical-imaging.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/medical-imaging.js +0 -129
- package/dist/simulation/scenarios/domain-examples/medical-imaging.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts +0 -166
- package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/robotics-navigation.js +0 -161
- package/dist/simulation/scenarios/domain-examples/robotics-navigation.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts +0 -151
- package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/scientific-research.js +0 -187
- package/dist/simulation/scenarios/domain-examples/scientific-research.js.map +0 -1
- package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts +0 -102
- package/dist/simulation/scenarios/domain-examples/trading-systems.d.ts.map +0 -1
- package/dist/simulation/scenarios/domain-examples/trading-systems.js +0 -100
- package/dist/simulation/scenarios/domain-examples/trading-systems.js.map +0 -1
- package/dist/simulation/scenarios/goalie-integration.d.ts +0 -24
- package/dist/simulation/scenarios/goalie-integration.d.ts.map +0 -1
- package/dist/simulation/scenarios/goalie-integration.js +0 -121
- package/dist/simulation/scenarios/goalie-integration.js.map +0 -1
- package/dist/simulation/scenarios/graph-traversal.d.ts +0 -17
- package/dist/simulation/scenarios/graph-traversal.d.ts.map +0 -1
- package/dist/simulation/scenarios/graph-traversal.js +0 -101
- package/dist/simulation/scenarios/graph-traversal.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts +0 -45
- package/dist/simulation/scenarios/latent-space/attention-analysis.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/attention-analysis.js +0 -435
- package/dist/simulation/scenarios/latent-space/attention-analysis.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts +0 -55
- package/dist/simulation/scenarios/latent-space/clustering-analysis.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/clustering-analysis.js +0 -606
- package/dist/simulation/scenarios/latent-space/clustering-analysis.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts +0 -74
- package/dist/simulation/scenarios/latent-space/hnsw-exploration.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/hnsw-exploration.js +0 -391
- package/dist/simulation/scenarios/latent-space/hnsw-exploration.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts +0 -51
- package/dist/simulation/scenarios/latent-space/hypergraph-exploration.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js +0 -536
- package/dist/simulation/scenarios/latent-space/hypergraph-exploration.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/index.d.ts +0 -35
- package/dist/simulation/scenarios/latent-space/index.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/index.js +0 -35
- package/dist/simulation/scenarios/latent-space/index.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts +0 -52
- package/dist/simulation/scenarios/latent-space/neural-augmentation.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/neural-augmentation.js +0 -472
- package/dist/simulation/scenarios/latent-space/neural-augmentation.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts +0 -53
- package/dist/simulation/scenarios/latent-space/quantum-hybrid.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/quantum-hybrid.js +0 -391
- package/dist/simulation/scenarios/latent-space/quantum-hybrid.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts +0 -52
- package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js +0 -514
- package/dist/simulation/scenarios/latent-space/self-organizing-hnsw.js.map +0 -1
- package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts +0 -53
- package/dist/simulation/scenarios/latent-space/traversal-optimization.d.ts.map +0 -1
- package/dist/simulation/scenarios/latent-space/traversal-optimization.js +0 -595
- package/dist/simulation/scenarios/latent-space/traversal-optimization.js.map +0 -1
- package/dist/simulation/scenarios/lean-agentic-swarm.d.ts +0 -18
- package/dist/simulation/scenarios/lean-agentic-swarm.d.ts.map +0 -1
- package/dist/simulation/scenarios/lean-agentic-swarm.js +0 -132
- package/dist/simulation/scenarios/lean-agentic-swarm.js.map +0 -1
- package/dist/simulation/scenarios/multi-agent-swarm.d.ts +0 -17
- package/dist/simulation/scenarios/multi-agent-swarm.d.ts.map +0 -1
- package/dist/simulation/scenarios/multi-agent-swarm.js +0 -111
- package/dist/simulation/scenarios/multi-agent-swarm.js.map +0 -1
- package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts +0 -23
- package/dist/simulation/scenarios/psycho-symbolic-reasoner.d.ts.map +0 -1
- package/dist/simulation/scenarios/psycho-symbolic-reasoner.js +0 -98
- package/dist/simulation/scenarios/psycho-symbolic-reasoner.js.map +0 -1
- package/dist/simulation/scenarios/reflexion-learning.d.ts +0 -16
- package/dist/simulation/scenarios/reflexion-learning.d.ts.map +0 -1
- package/dist/simulation/scenarios/reflexion-learning.js +0 -98
- package/dist/simulation/scenarios/reflexion-learning.js.map +0 -1
- package/dist/simulation/scenarios/research-swarm.d.ts +0 -24
- package/dist/simulation/scenarios/research-swarm.d.ts.map +0 -1
- package/dist/simulation/scenarios/research-swarm.js +0 -146
- package/dist/simulation/scenarios/research-swarm.js.map +0 -1
- package/dist/simulation/scenarios/skill-evolution.d.ts +0 -16
- package/dist/simulation/scenarios/skill-evolution.d.ts.map +0 -1
- package/dist/simulation/scenarios/skill-evolution.js +0 -109
- package/dist/simulation/scenarios/skill-evolution.js.map +0 -1
- package/dist/simulation/scenarios/stock-market-emergence.d.ts +0 -33
- package/dist/simulation/scenarios/stock-market-emergence.d.ts.map +0 -1
- package/dist/simulation/scenarios/stock-market-emergence.js +0 -246
- package/dist/simulation/scenarios/stock-market-emergence.js.map +0 -1
- package/dist/simulation/scenarios/strange-loops.d.ts +0 -18
- package/dist/simulation/scenarios/strange-loops.d.ts.map +0 -1
- package/dist/simulation/scenarios/strange-loops.js +0 -133
- package/dist/simulation/scenarios/strange-loops.js.map +0 -1
- package/dist/simulation/scenarios/sublinear-solver.d.ts +0 -22
- package/dist/simulation/scenarios/sublinear-solver.d.ts.map +0 -1
- package/dist/simulation/scenarios/sublinear-solver.js +0 -82
- package/dist/simulation/scenarios/sublinear-solver.js.map +0 -1
- package/dist/simulation/scenarios/temporal-lead-solver.d.ts +0 -23
- package/dist/simulation/scenarios/temporal-lead-solver.d.ts.map +0 -1
- package/dist/simulation/scenarios/temporal-lead-solver.js +0 -90
- package/dist/simulation/scenarios/temporal-lead-solver.js.map +0 -1
- package/dist/simulation/scenarios/voting-system-consensus.d.ts +0 -27
- package/dist/simulation/scenarios/voting-system-consensus.d.ts.map +0 -1
- package/dist/simulation/scenarios/voting-system-consensus.js +0 -175
- package/dist/simulation/scenarios/voting-system-consensus.js.map +0 -1
- package/dist/simulation/types.d.ts +0 -162
- package/dist/simulation/types.d.ts.map +0 -1
- package/dist/simulation/types.js +0 -5
- package/dist/simulation/types.js.map +0 -1
- package/dist/simulation/utils/PerformanceOptimizer.d.ts +0 -115
- package/dist/simulation/utils/PerformanceOptimizer.d.ts.map +0 -1
- package/dist/simulation/utils/PerformanceOptimizer.js +0 -223
- package/dist/simulation/utils/PerformanceOptimizer.js.map +0 -1
- package/dist/src/backends/index.cjs +0 -6
- package/dist/src/backends/ruvector/GuardedVectorBackend.d.ts +0 -93
- package/dist/src/backends/ruvector/GuardedVectorBackend.d.ts.map +0 -1
- package/dist/src/backends/ruvector/GuardedVectorBackend.js +0 -182
- package/dist/src/backends/ruvector/GuardedVectorBackend.js.map +0 -1
- package/dist/src/consensus/RaftConsensus.d.ts +0 -220
- package/dist/src/consensus/RaftConsensus.d.ts.map +0 -1
- package/dist/src/consensus/RaftConsensus.js +0 -762
- package/dist/src/consensus/RaftConsensus.js.map +0 -1
- package/dist/src/controllers/HierarchicalMemory.d.ts +0 -197
- package/dist/src/controllers/HierarchicalMemory.d.ts.map +0 -1
- package/dist/src/controllers/HierarchicalMemory.js +0 -519
- package/dist/src/controllers/HierarchicalMemory.js.map +0 -1
- package/dist/src/controllers/MemoryConsolidation.d.ts +0 -142
- package/dist/src/controllers/MemoryConsolidation.d.ts.map +0 -1
- package/dist/src/controllers/MemoryConsolidation.js +0 -479
- package/dist/src/controllers/MemoryConsolidation.js.map +0 -1
- package/dist/src/controllers/QUICConnection.d.ts +0 -122
- package/dist/src/controllers/QUICConnection.d.ts.map +0 -1
- package/dist/src/controllers/QUICConnection.js +0 -329
- package/dist/src/controllers/QUICConnection.js.map +0 -1
- package/dist/src/controllers/QUICConnectionPool.d.ts +0 -83
- package/dist/src/controllers/QUICConnectionPool.d.ts.map +0 -1
- package/dist/src/controllers/QUICConnectionPool.js +0 -256
- package/dist/src/controllers/QUICConnectionPool.js.map +0 -1
- package/dist/src/controllers/QUICStreamManager.d.ts +0 -114
- package/dist/src/controllers/QUICStreamManager.d.ts.map +0 -1
- package/dist/src/controllers/QUICStreamManager.js +0 -267
- package/dist/src/controllers/QUICStreamManager.js.map +0 -1
- package/dist/src/controllers/StreamingEmbeddingService.d.ts +0 -82
- package/dist/src/controllers/StreamingEmbeddingService.d.ts.map +0 -1
- package/dist/src/controllers/StreamingEmbeddingService.js +0 -243
- package/dist/src/controllers/StreamingEmbeddingService.js.map +0 -1
- package/dist/src/controllers/index.cjs +0 -6
- package/dist/src/coordination/MultiDatabaseCoordinator.d.ts +0 -348
- package/dist/src/coordination/MultiDatabaseCoordinator.d.ts.map +0 -1
- package/dist/src/coordination/MultiDatabaseCoordinator.js +0 -803
- package/dist/src/coordination/MultiDatabaseCoordinator.js.map +0 -1
- package/dist/src/coordination/index.d.ts +0 -10
- package/dist/src/coordination/index.d.ts.map +0 -1
- package/dist/src/coordination/index.js +0 -10
- package/dist/src/coordination/index.js.map +0 -1
- package/dist/src/index.cjs +0 -6
- package/dist/src/optimizations/RVFOptimizer.d.ts +0 -226
- package/dist/src/optimizations/RVFOptimizer.d.ts.map +0 -1
- package/dist/src/optimizations/RVFOptimizer.js +0 -541
- package/dist/src/optimizations/RVFOptimizer.js.map +0 -1
- package/dist/src/security/AttestationLog.d.ts +0 -70
- package/dist/src/security/AttestationLog.d.ts.map +0 -1
- package/dist/src/security/AttestationLog.js +0 -174
- package/dist/src/security/AttestationLog.js.map +0 -1
- package/dist/src/security/MutationGuard.d.ts +0 -83
- package/dist/src/security/MutationGuard.d.ts.map +0 -1
- package/dist/src/security/MutationGuard.js +0 -364
- package/dist/src/security/MutationGuard.js.map +0 -1
- package/dist/src/security/index.cjs +0 -6
- package/dist/src/security/index.d.ts +0 -15
- package/dist/src/security/index.d.ts.map +0 -1
- package/dist/src/security/index.js +0 -18
- package/dist/src/security/index.js.map +0 -1
- package/dist/src/services/GNNService.d.ts +0 -172
- package/dist/src/services/GNNService.d.ts.map +0 -1
- package/dist/src/services/GNNService.js +0 -612
- package/dist/src/services/GNNService.js.map +0 -1
- package/dist/src/services/GraphTransformerService.d.ts +0 -80
- package/dist/src/services/GraphTransformerService.d.ts.map +0 -1
- package/dist/src/services/GraphTransformerService.js +0 -369
- package/dist/src/services/GraphTransformerService.js.map +0 -1
- package/dist/src/services/SemanticRouter.d.ts +0 -83
- package/dist/src/services/SemanticRouter.d.ts.map +0 -1
- package/dist/src/services/SemanticRouter.js +0 -160
- package/dist/src/services/SemanticRouter.js.map +0 -1
- package/dist/src/services/SonaTrajectoryService.d.ts +0 -224
- package/dist/src/services/SonaTrajectoryService.d.ts.map +0 -1
- package/dist/src/services/SonaTrajectoryService.js +0 -539
- package/dist/src/services/SonaTrajectoryService.js.map +0 -1
- package/dist/src/utils/LegacyAttentionAdapter.d.ts +0 -93
- package/dist/src/utils/LegacyAttentionAdapter.d.ts.map +0 -1
- package/dist/src/utils/LegacyAttentionAdapter.js +0 -241
- package/dist/src/utils/LegacyAttentionAdapter.js.map +0 -1
- package/dist/src/utils/vector-math.d.ts +0 -29
- package/dist/src/utils/vector-math.d.ts.map +0 -1
- package/dist/src/utils/vector-math.js +0 -66
- package/dist/src/utils/vector-math.js.map +0 -1
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MemoryController - Unified Memory Management with Attention Mechanisms
|
|
3
|
+
*
|
|
4
|
+
* Provides a unified interface for memory storage, retrieval, and search
|
|
5
|
+
* with integrated attention mechanisms for enhanced relevance scoring.
|
|
6
|
+
*
|
|
7
|
+
* Features:
|
|
8
|
+
* - CRUD operations for memory entries
|
|
9
|
+
* - Vector similarity search
|
|
10
|
+
* - Attention-enhanced retrieval
|
|
11
|
+
* - Temporal and importance weighting
|
|
12
|
+
* - Multiple namespace support
|
|
13
|
+
* - Integration with vector backends
|
|
14
|
+
*/
|
|
15
|
+
import type { VectorBackend } from '../backends/VectorBackend.js';
|
|
16
|
+
import { type EmbeddingSpaceIdentity, type MemoryProvenance } from '../embedding/EmbeddingSpaceIdentity.js';
|
|
17
|
+
import { SelfAttentionController } from './attention/SelfAttentionController.js';
|
|
18
|
+
import { CrossAttentionController } from './attention/CrossAttentionController.js';
|
|
19
|
+
import { MultiHeadAttentionController } from './attention/MultiHeadAttentionController.js';
|
|
20
|
+
/**
|
|
21
|
+
* Configuration for the MemoryController
|
|
22
|
+
*/
|
|
23
|
+
export interface MemoryControllerConfig {
|
|
24
|
+
/** Default namespace for memories */
|
|
25
|
+
namespace?: string;
|
|
26
|
+
/** Enable attention-enhanced retrieval */
|
|
27
|
+
enableAttention?: boolean;
|
|
28
|
+
/** Number of attention heads for multi-head attention */
|
|
29
|
+
numHeads?: number;
|
|
30
|
+
/** Default top-k for search operations */
|
|
31
|
+
defaultTopK?: number;
|
|
32
|
+
/** Default similarity threshold */
|
|
33
|
+
defaultThreshold?: number;
|
|
34
|
+
/** Authoritative embedding space for corpus mutations */
|
|
35
|
+
embeddingSpaceIdentity?: EmbeddingSpaceIdentity;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Memory entry structure
|
|
39
|
+
*/
|
|
40
|
+
export interface Memory {
|
|
41
|
+
/** Unique identifier */
|
|
42
|
+
id: string;
|
|
43
|
+
/** Text content */
|
|
44
|
+
content?: string;
|
|
45
|
+
/** Embedding vector */
|
|
46
|
+
embedding: number[];
|
|
47
|
+
/** Importance score (0-1) */
|
|
48
|
+
importance?: number;
|
|
49
|
+
/** Creation timestamp */
|
|
50
|
+
timestamp?: number;
|
|
51
|
+
/** Additional metadata */
|
|
52
|
+
metadata?: Record<string, any>;
|
|
53
|
+
/** Typed origin and trust information for this memory */
|
|
54
|
+
provenance?: MemoryProvenance;
|
|
55
|
+
/** Space in which embedding was produced */
|
|
56
|
+
embeddingSpaceIdentity?: EmbeddingSpaceIdentity;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Search options for memory retrieval
|
|
60
|
+
*/
|
|
61
|
+
export interface SearchOptions {
|
|
62
|
+
/** Number of top results to return */
|
|
63
|
+
topK?: number;
|
|
64
|
+
/** Minimum similarity threshold */
|
|
65
|
+
threshold?: number;
|
|
66
|
+
/** Metadata filters */
|
|
67
|
+
filter?: Record<string, any>;
|
|
68
|
+
/** Use attention for ranking */
|
|
69
|
+
useAttention?: boolean;
|
|
70
|
+
/** Weight recent memories higher */
|
|
71
|
+
temporalWeight?: number;
|
|
72
|
+
/** Weight by importance score */
|
|
73
|
+
weighByImportance?: boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Identity of the supplied query vector. A mismatch is allowed for
|
|
76
|
+
* vector-only reads, but never for corpus mutation or cache reuse.
|
|
77
|
+
*/
|
|
78
|
+
embeddingSpaceIdentity?: EmbeddingSpaceIdentity;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Search result with scores
|
|
82
|
+
*/
|
|
83
|
+
export interface SearchResult extends Memory {
|
|
84
|
+
/** Similarity score */
|
|
85
|
+
score: number;
|
|
86
|
+
/** Attention score (if attention enabled) */
|
|
87
|
+
attentionScore?: number;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Result from attention-enhanced retrieval
|
|
91
|
+
*/
|
|
92
|
+
export interface AttentionRetrievalResult extends SearchResult {
|
|
93
|
+
/** Combined attention score from all mechanisms */
|
|
94
|
+
attentionScore: number;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* MemoryController - Main class for memory management
|
|
98
|
+
*/
|
|
99
|
+
export declare class MemoryController {
|
|
100
|
+
private vectorBackend;
|
|
101
|
+
private memories;
|
|
102
|
+
private config;
|
|
103
|
+
private selfAttention;
|
|
104
|
+
private crossAttention;
|
|
105
|
+
private multiHeadAttention;
|
|
106
|
+
constructor(vectorBackend?: VectorBackend | null, config?: MemoryControllerConfig);
|
|
107
|
+
/**
|
|
108
|
+
* Store a memory entry
|
|
109
|
+
*/
|
|
110
|
+
store(memory: Memory, namespace?: string): Promise<void>;
|
|
111
|
+
/**
|
|
112
|
+
* Retrieve a memory by ID
|
|
113
|
+
*/
|
|
114
|
+
retrieve(id: string): Promise<Memory | undefined>;
|
|
115
|
+
/**
|
|
116
|
+
* Update an existing memory
|
|
117
|
+
*/
|
|
118
|
+
update(id: string, updates: Partial<Memory>): Promise<boolean>;
|
|
119
|
+
/**
|
|
120
|
+
* Delete a memory by ID
|
|
121
|
+
*/
|
|
122
|
+
delete(id: string): Promise<boolean>;
|
|
123
|
+
/**
|
|
124
|
+
* Search for similar memories
|
|
125
|
+
*/
|
|
126
|
+
search(query: number[], options?: SearchOptions): Promise<SearchResult[]>;
|
|
127
|
+
private assertMutationIdentity;
|
|
128
|
+
/**
|
|
129
|
+
* Retrieve memories with attention-enhanced scoring
|
|
130
|
+
*/
|
|
131
|
+
retrieveWithAttention(query: number[], options?: SearchOptions): Promise<AttentionRetrievalResult[]>;
|
|
132
|
+
/**
|
|
133
|
+
* Compute cosine similarity between two vectors
|
|
134
|
+
*/
|
|
135
|
+
private cosineSimilarity;
|
|
136
|
+
/**
|
|
137
|
+
* Check if metadata matches filter criteria
|
|
138
|
+
*/
|
|
139
|
+
private matchesFilter;
|
|
140
|
+
/**
|
|
141
|
+
* Get all memories (for iteration/export)
|
|
142
|
+
*/
|
|
143
|
+
getAllMemories(): Memory[];
|
|
144
|
+
/**
|
|
145
|
+
* Get memory count
|
|
146
|
+
*/
|
|
147
|
+
get count(): number;
|
|
148
|
+
/**
|
|
149
|
+
* Clear all memories
|
|
150
|
+
*/
|
|
151
|
+
clear(): void;
|
|
152
|
+
/**
|
|
153
|
+
* Get the self-attention controller for direct access
|
|
154
|
+
*/
|
|
155
|
+
getSelfAttentionController(): SelfAttentionController;
|
|
156
|
+
/**
|
|
157
|
+
* Get the cross-attention controller for direct access
|
|
158
|
+
*/
|
|
159
|
+
getCrossAttentionController(): CrossAttentionController;
|
|
160
|
+
/**
|
|
161
|
+
* Get the multi-head attention controller for direct access
|
|
162
|
+
*/
|
|
163
|
+
getMultiHeadAttentionController(): MultiHeadAttentionController;
|
|
164
|
+
/**
|
|
165
|
+
* Get controller statistics
|
|
166
|
+
*/
|
|
167
|
+
getStats(): {
|
|
168
|
+
memoryCount: number;
|
|
169
|
+
selfAttention: ReturnType<SelfAttentionController['getStats']>;
|
|
170
|
+
crossAttention: ReturnType<CrossAttentionController['getStats']>;
|
|
171
|
+
multiHeadAttention: ReturnType<MultiHeadAttentionController['getStats']>;
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
//# sourceMappingURL=MemoryController.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MemoryController.d.ts","sourceRoot":"","sources":["../../../src/controllers/MemoryController.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MemoryController - Unified Memory Management with Attention Mechanisms
|
|
3
|
+
*
|
|
4
|
+
* Provides a unified interface for memory storage, retrieval, and search
|
|
5
|
+
* with integrated attention mechanisms for enhanced relevance scoring.
|
|
6
|
+
*
|
|
7
|
+
* Features:
|
|
8
|
+
* - CRUD operations for memory entries
|
|
9
|
+
* - Vector similarity search
|
|
10
|
+
* - Attention-enhanced retrieval
|
|
11
|
+
* - Temporal and importance weighting
|
|
12
|
+
* - Multiple namespace support
|
|
13
|
+
* - Integration with vector backends
|
|
14
|
+
*/
|
|
15
|
+
import { assertEmbeddingSpaceCompatible } from '../embedding/EmbeddingSpaceIdentity.js';
|
|
16
|
+
import { SelfAttentionController } from './attention/SelfAttentionController.js';
|
|
17
|
+
import { CrossAttentionController } from './attention/CrossAttentionController.js';
|
|
18
|
+
import { MultiHeadAttentionController } from './attention/MultiHeadAttentionController.js';
|
|
19
|
+
/**
|
|
20
|
+
* MemoryController - Main class for memory management
|
|
21
|
+
*/
|
|
22
|
+
export class MemoryController {
|
|
23
|
+
vectorBackend;
|
|
24
|
+
memories;
|
|
25
|
+
config;
|
|
26
|
+
// Attention controllers
|
|
27
|
+
selfAttention;
|
|
28
|
+
crossAttention;
|
|
29
|
+
multiHeadAttention;
|
|
30
|
+
constructor(vectorBackend = null, config = {}) {
|
|
31
|
+
this.vectorBackend = vectorBackend;
|
|
32
|
+
this.memories = new Map();
|
|
33
|
+
this.config = {
|
|
34
|
+
namespace: 'default',
|
|
35
|
+
enableAttention: true,
|
|
36
|
+
numHeads: 8,
|
|
37
|
+
defaultTopK: 10,
|
|
38
|
+
defaultThreshold: 0.0,
|
|
39
|
+
...config
|
|
40
|
+
};
|
|
41
|
+
// Initialize attention controllers
|
|
42
|
+
this.selfAttention = new SelfAttentionController(vectorBackend);
|
|
43
|
+
this.crossAttention = new CrossAttentionController(vectorBackend);
|
|
44
|
+
this.multiHeadAttention = new MultiHeadAttentionController(vectorBackend, {
|
|
45
|
+
numHeads: this.config.numHeads
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Store a memory entry
|
|
50
|
+
*/
|
|
51
|
+
async store(memory, namespace) {
|
|
52
|
+
if (!memory.id || !memory.embedding || memory.embedding.length === 0) {
|
|
53
|
+
throw new Error('Memory must have id and non-empty embedding');
|
|
54
|
+
}
|
|
55
|
+
this.assertMutationIdentity(memory.embeddingSpaceIdentity);
|
|
56
|
+
// Add timestamp if not provided
|
|
57
|
+
const storedMemory = {
|
|
58
|
+
...memory,
|
|
59
|
+
timestamp: memory.timestamp ?? Date.now()
|
|
60
|
+
};
|
|
61
|
+
// Store in local map
|
|
62
|
+
this.memories.set(memory.id, storedMemory);
|
|
63
|
+
// Store in vector backend if available
|
|
64
|
+
if (this.vectorBackend) {
|
|
65
|
+
const embedding = new Float32Array(memory.embedding);
|
|
66
|
+
this.vectorBackend.insert(memory.id, embedding, {
|
|
67
|
+
...memory.metadata,
|
|
68
|
+
provenance: memory.provenance,
|
|
69
|
+
embeddingSpaceIdentity: memory.embeddingSpaceIdentity,
|
|
70
|
+
namespace: namespace || this.config.namespace
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
// Add to attention controllers
|
|
74
|
+
const attentionEntry = {
|
|
75
|
+
id: memory.id,
|
|
76
|
+
embedding: memory.embedding,
|
|
77
|
+
content: memory.content,
|
|
78
|
+
metadata: memory.metadata
|
|
79
|
+
};
|
|
80
|
+
this.selfAttention.addMemory(attentionEntry);
|
|
81
|
+
if (namespace) {
|
|
82
|
+
this.crossAttention.addToContext(namespace, attentionEntry);
|
|
83
|
+
}
|
|
84
|
+
else {
|
|
85
|
+
this.crossAttention.addToContext(this.config.namespace || 'default', attentionEntry);
|
|
86
|
+
}
|
|
87
|
+
this.multiHeadAttention.addMemory(attentionEntry);
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Retrieve a memory by ID
|
|
91
|
+
*/
|
|
92
|
+
async retrieve(id) {
|
|
93
|
+
return this.memories.get(id);
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Update an existing memory
|
|
97
|
+
*/
|
|
98
|
+
async update(id, updates) {
|
|
99
|
+
const existing = this.memories.get(id);
|
|
100
|
+
if (!existing) {
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
this.assertMutationIdentity(updates.embeddingSpaceIdentity ?? existing.embeddingSpaceIdentity);
|
|
104
|
+
const updated = {
|
|
105
|
+
...existing,
|
|
106
|
+
...updates,
|
|
107
|
+
id // Ensure ID cannot be changed
|
|
108
|
+
};
|
|
109
|
+
// Re-store with updates
|
|
110
|
+
await this.delete(id);
|
|
111
|
+
await this.store(updated);
|
|
112
|
+
return true;
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Delete a memory by ID
|
|
116
|
+
*/
|
|
117
|
+
async delete(id) {
|
|
118
|
+
const existed = this.memories.delete(id);
|
|
119
|
+
// Remove from attention controllers
|
|
120
|
+
this.selfAttention.removeMemory(id);
|
|
121
|
+
this.multiHeadAttention.removeMemory(id);
|
|
122
|
+
// Remove from all cross-attention contexts
|
|
123
|
+
for (const contextName of this.crossAttention.listContexts()) {
|
|
124
|
+
this.crossAttention.removeFromContext(contextName, id);
|
|
125
|
+
}
|
|
126
|
+
return existed;
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Search for similar memories
|
|
130
|
+
*/
|
|
131
|
+
async search(query, options = {}) {
|
|
132
|
+
if (this.config.embeddingSpaceIdentity && options.embeddingSpaceIdentity) {
|
|
133
|
+
assertEmbeddingSpaceCompatible(this.config.embeddingSpaceIdentity, options.embeddingSpaceIdentity, 'vector-read');
|
|
134
|
+
}
|
|
135
|
+
const { topK = this.config.defaultTopK || 10, threshold = this.config.defaultThreshold || 0.0, filter, temporalWeight = 0, weighByImportance = false } = options;
|
|
136
|
+
// Compute similarity scores
|
|
137
|
+
const results = [];
|
|
138
|
+
for (const [id, memory] of this.memories.entries()) {
|
|
139
|
+
// Apply metadata filter if provided
|
|
140
|
+
if (filter && !this.matchesFilter(memory.metadata || {}, filter)) {
|
|
141
|
+
continue;
|
|
142
|
+
}
|
|
143
|
+
// Compute cosine similarity
|
|
144
|
+
let score = this.cosineSimilarity(query, memory.embedding);
|
|
145
|
+
// Apply temporal weighting
|
|
146
|
+
if (temporalWeight > 0 && memory.timestamp) {
|
|
147
|
+
const age = Date.now() - memory.timestamp;
|
|
148
|
+
const decayFactor = Math.exp(-temporalWeight * age / (24 * 60 * 60 * 1000));
|
|
149
|
+
score = score * (1 - temporalWeight) + score * temporalWeight * decayFactor;
|
|
150
|
+
}
|
|
151
|
+
// Apply importance weighting
|
|
152
|
+
if (weighByImportance && memory.importance !== undefined) {
|
|
153
|
+
score = score * (0.5 + 0.5 * memory.importance);
|
|
154
|
+
}
|
|
155
|
+
if (score >= threshold) {
|
|
156
|
+
results.push({
|
|
157
|
+
...memory,
|
|
158
|
+
score
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
// Sort by score and return top-k
|
|
163
|
+
return results
|
|
164
|
+
.sort((a, b) => b.score - a.score)
|
|
165
|
+
.slice(0, topK);
|
|
166
|
+
}
|
|
167
|
+
assertMutationIdentity(identity) {
|
|
168
|
+
const expected = this.config.embeddingSpaceIdentity;
|
|
169
|
+
if (!expected)
|
|
170
|
+
return;
|
|
171
|
+
if (!identity) {
|
|
172
|
+
throw new Error('Memory mutation requires embeddingSpaceIdentity when the controller has an authoritative space');
|
|
173
|
+
}
|
|
174
|
+
assertEmbeddingSpaceCompatible(expected, identity, 'corpus-mutation');
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Retrieve memories with attention-enhanced scoring
|
|
178
|
+
*/
|
|
179
|
+
async retrieveWithAttention(query, options = {}) {
|
|
180
|
+
const { topK = this.config.defaultTopK || 10, threshold = this.config.defaultThreshold || 0.0, useAttention = true, temporalWeight = 0, weighByImportance = false } = options;
|
|
181
|
+
// First get base search results
|
|
182
|
+
const baseResults = await this.search(query, {
|
|
183
|
+
...options,
|
|
184
|
+
topK: topK * 2 // Get more candidates for attention ranking
|
|
185
|
+
});
|
|
186
|
+
if (!useAttention || !this.config.enableAttention) {
|
|
187
|
+
return baseResults.map(r => ({
|
|
188
|
+
...r,
|
|
189
|
+
attentionScore: r.score
|
|
190
|
+
}));
|
|
191
|
+
}
|
|
192
|
+
// Compute attention scores
|
|
193
|
+
const selfAttentionResult = await this.selfAttention.computeAttention(query, {
|
|
194
|
+
topK: topK * 2,
|
|
195
|
+
minScore: 0
|
|
196
|
+
});
|
|
197
|
+
const multiHeadResult = await this.multiHeadAttention.computeMultiHeadAttention(query, { topK: topK * 2 });
|
|
198
|
+
// Build attention score map
|
|
199
|
+
const attentionScores = new Map();
|
|
200
|
+
for (const score of selfAttentionResult.scores) {
|
|
201
|
+
attentionScores.set(score.id, (attentionScores.get(score.id) || 0) + score.score);
|
|
202
|
+
}
|
|
203
|
+
if (multiHeadResult.aggregatedScores) {
|
|
204
|
+
for (const score of multiHeadResult.aggregatedScores) {
|
|
205
|
+
attentionScores.set(score.id, (attentionScores.get(score.id) || 0) + score.score);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
// Combine base similarity with attention scores
|
|
209
|
+
const results = [];
|
|
210
|
+
for (const baseResult of baseResults) {
|
|
211
|
+
const attentionScore = attentionScores.get(baseResult.id) || 0;
|
|
212
|
+
// Combine scores (weighted average)
|
|
213
|
+
const combinedScore = 0.5 * baseResult.score + 0.5 * (attentionScore / 2);
|
|
214
|
+
// Apply temporal weighting
|
|
215
|
+
let finalScore = combinedScore;
|
|
216
|
+
if (temporalWeight > 0 && baseResult.timestamp) {
|
|
217
|
+
const age = Date.now() - baseResult.timestamp;
|
|
218
|
+
const decayFactor = Math.exp(-temporalWeight * age / (24 * 60 * 60 * 1000));
|
|
219
|
+
finalScore = combinedScore * (1 - temporalWeight) + combinedScore * temporalWeight * decayFactor;
|
|
220
|
+
}
|
|
221
|
+
// Apply importance weighting
|
|
222
|
+
if (weighByImportance && baseResult.importance !== undefined) {
|
|
223
|
+
finalScore = finalScore * (0.5 + 0.5 * baseResult.importance);
|
|
224
|
+
}
|
|
225
|
+
if (finalScore >= threshold) {
|
|
226
|
+
results.push({
|
|
227
|
+
...baseResult,
|
|
228
|
+
score: finalScore,
|
|
229
|
+
attentionScore
|
|
230
|
+
});
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
// Sort by combined score and return top-k
|
|
234
|
+
return results
|
|
235
|
+
.sort((a, b) => b.score - a.score)
|
|
236
|
+
.slice(0, topK);
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Compute cosine similarity between two vectors
|
|
240
|
+
*/
|
|
241
|
+
cosineSimilarity(a, b) {
|
|
242
|
+
if (a.length !== b.length) {
|
|
243
|
+
throw new Error('Vectors must have same dimension');
|
|
244
|
+
}
|
|
245
|
+
let dotProduct = 0;
|
|
246
|
+
let normA = 0;
|
|
247
|
+
let normB = 0;
|
|
248
|
+
for (let i = 0; i < a.length; i++) {
|
|
249
|
+
dotProduct += a[i] * b[i];
|
|
250
|
+
normA += a[i] * a[i];
|
|
251
|
+
normB += b[i] * b[i];
|
|
252
|
+
}
|
|
253
|
+
const denominator = Math.sqrt(normA) * Math.sqrt(normB);
|
|
254
|
+
if (denominator === 0)
|
|
255
|
+
return 0;
|
|
256
|
+
return dotProduct / denominator;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Check if metadata matches filter criteria
|
|
260
|
+
*/
|
|
261
|
+
matchesFilter(metadata, filter) {
|
|
262
|
+
for (const [key, value] of Object.entries(filter)) {
|
|
263
|
+
if (metadata[key] !== value) {
|
|
264
|
+
return false;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
return true;
|
|
268
|
+
}
|
|
269
|
+
/**
|
|
270
|
+
* Get all memories (for iteration/export)
|
|
271
|
+
*/
|
|
272
|
+
getAllMemories() {
|
|
273
|
+
return Array.from(this.memories.values());
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* Get memory count
|
|
277
|
+
*/
|
|
278
|
+
get count() {
|
|
279
|
+
return this.memories.size;
|
|
280
|
+
}
|
|
281
|
+
/**
|
|
282
|
+
* Clear all memories
|
|
283
|
+
*/
|
|
284
|
+
clear() {
|
|
285
|
+
this.memories.clear();
|
|
286
|
+
this.selfAttention.clearMemories();
|
|
287
|
+
this.crossAttention.clearAllContexts();
|
|
288
|
+
this.multiHeadAttention.clearMemories();
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* Get the self-attention controller for direct access
|
|
292
|
+
*/
|
|
293
|
+
getSelfAttentionController() {
|
|
294
|
+
return this.selfAttention;
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Get the cross-attention controller for direct access
|
|
298
|
+
*/
|
|
299
|
+
getCrossAttentionController() {
|
|
300
|
+
return this.crossAttention;
|
|
301
|
+
}
|
|
302
|
+
/**
|
|
303
|
+
* Get the multi-head attention controller for direct access
|
|
304
|
+
*/
|
|
305
|
+
getMultiHeadAttentionController() {
|
|
306
|
+
return this.multiHeadAttention;
|
|
307
|
+
}
|
|
308
|
+
/**
|
|
309
|
+
* Get controller statistics
|
|
310
|
+
*/
|
|
311
|
+
getStats() {
|
|
312
|
+
return {
|
|
313
|
+
memoryCount: this.memories.size,
|
|
314
|
+
selfAttention: this.selfAttention.getStats(),
|
|
315
|
+
crossAttention: this.crossAttention.getStats(),
|
|
316
|
+
multiHeadAttention: this.multiHeadAttention.getStats()
|
|
317
|
+
};
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
//# sourceMappingURL=MemoryController.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MemoryController.js","sourceRoot":"","sources":["../../../src/controllers/MemoryController.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MetadataFilter.d.ts","sourceRoot":"","sources":["../../../src/controllers/MetadataFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;
|
|
1
|
+
{"version":3,"file":"MetadataFilter.d.ts","sourceRoot":"","sources":["../../../src/controllers/MetadataFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAExH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG;KAAG,EAAE,IAAI,cAAc,CAAC,CAAC,EAAE,GAAG;CAAE,CAAC;AAE7G,MAAM,WAAW,eAAe;IAC9B,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,EAAE;IAQjF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAsE5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAwB5B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,GAAE,MAAW,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE;IA6FhG;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAoBhF"}
|
|
@@ -16,6 +16,13 @@
|
|
|
16
16
|
* - $contains: String/array contains value
|
|
17
17
|
* - $exists: Field exists
|
|
18
18
|
*/
|
|
19
|
+
const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
20
|
+
function assertIdentifier(name, what) {
|
|
21
|
+
if (typeof name !== 'string' || !IDENTIFIER.test(name)) {
|
|
22
|
+
throw new Error(`Invalid ${what} in metadata filter: ${JSON.stringify(name)}`);
|
|
23
|
+
}
|
|
24
|
+
return name;
|
|
25
|
+
}
|
|
19
26
|
export class MetadataFilter {
|
|
20
27
|
/**
|
|
21
28
|
* Apply filters to a collection of items
|
|
@@ -145,17 +152,31 @@ export class MetadataFilter {
|
|
|
145
152
|
static toSQL(filters, tableName = '') {
|
|
146
153
|
const conditions = [];
|
|
147
154
|
const params = [];
|
|
148
|
-
|
|
155
|
+
// Table, column and JSON-path segments are identifiers only; the JSON
|
|
156
|
+
// path itself is bound as a parameter rather than spliced into SQL.
|
|
157
|
+
const prefix = tableName ? `${assertIdentifier(tableName, 'table name')}.` : '';
|
|
149
158
|
for (const [field, filter] of Object.entries(filters)) {
|
|
150
159
|
// For metadata fields, use JSON extraction
|
|
151
160
|
const isMetadata = field.startsWith('metadata.');
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
161
|
+
let columnRef;
|
|
162
|
+
let refParams;
|
|
163
|
+
if (isMetadata) {
|
|
164
|
+
const segments = field.slice(9).split('.');
|
|
165
|
+
segments.forEach((segment) => assertIdentifier(segment, 'metadata path segment'));
|
|
166
|
+
columnRef = `json_extract(${prefix}metadata, ?)`;
|
|
167
|
+
refParams = [`$.${segments.join('.')}`];
|
|
168
|
+
}
|
|
169
|
+
else {
|
|
170
|
+
columnRef = `${prefix}${assertIdentifier(field, 'field')}`;
|
|
171
|
+
refParams = [];
|
|
172
|
+
}
|
|
173
|
+
const add = (condition, ...values) => {
|
|
174
|
+
conditions.push(condition);
|
|
175
|
+
params.push(...refParams, ...values);
|
|
176
|
+
};
|
|
155
177
|
if (typeof filter !== 'object' || Array.isArray(filter)) {
|
|
156
178
|
// Simple equality
|
|
157
|
-
|
|
158
|
-
params.push(filter);
|
|
179
|
+
add(`${columnRef} = ?`, filter);
|
|
159
180
|
}
|
|
160
181
|
else {
|
|
161
182
|
// Operator-based filters
|
|
@@ -163,53 +184,44 @@ export class MetadataFilter {
|
|
|
163
184
|
for (const [operator, operand] of Object.entries(operators)) {
|
|
164
185
|
switch (operator) {
|
|
165
186
|
case '$eq':
|
|
166
|
-
|
|
167
|
-
params.push(operand);
|
|
187
|
+
add(`${columnRef} = ?`, operand);
|
|
168
188
|
break;
|
|
169
189
|
case '$ne':
|
|
170
|
-
|
|
171
|
-
params.push(operand);
|
|
190
|
+
add(`${columnRef} != ?`, operand);
|
|
172
191
|
break;
|
|
173
192
|
case '$gt':
|
|
174
|
-
|
|
175
|
-
params.push(operand);
|
|
193
|
+
add(`${columnRef} > ?`, operand);
|
|
176
194
|
break;
|
|
177
195
|
case '$gte':
|
|
178
|
-
|
|
179
|
-
params.push(operand);
|
|
196
|
+
add(`${columnRef} >= ?`, operand);
|
|
180
197
|
break;
|
|
181
198
|
case '$lt':
|
|
182
|
-
|
|
183
|
-
params.push(operand);
|
|
199
|
+
add(`${columnRef} < ?`, operand);
|
|
184
200
|
break;
|
|
185
201
|
case '$lte':
|
|
186
|
-
|
|
187
|
-
params.push(operand);
|
|
202
|
+
add(`${columnRef} <= ?`, operand);
|
|
188
203
|
break;
|
|
189
204
|
case '$in':
|
|
190
205
|
if (Array.isArray(operand)) {
|
|
191
206
|
const placeholders = operand.map(() => '?').join(', ');
|
|
192
|
-
|
|
193
|
-
params.push(...operand);
|
|
207
|
+
add(`${columnRef} IN (${placeholders})`, ...operand);
|
|
194
208
|
}
|
|
195
209
|
break;
|
|
196
210
|
case '$nin':
|
|
197
211
|
if (Array.isArray(operand)) {
|
|
198
212
|
const placeholders = operand.map(() => '?').join(', ');
|
|
199
|
-
|
|
200
|
-
params.push(...operand);
|
|
213
|
+
add(`${columnRef} NOT IN (${placeholders})`, ...operand);
|
|
201
214
|
}
|
|
202
215
|
break;
|
|
203
216
|
case '$contains':
|
|
204
|
-
|
|
205
|
-
params.push(`%${operand}%`);
|
|
217
|
+
add(`${columnRef} LIKE ?`, `%${operand}%`);
|
|
206
218
|
break;
|
|
207
219
|
case '$exists':
|
|
208
220
|
if (operand) {
|
|
209
|
-
|
|
221
|
+
add(`${columnRef} IS NOT NULL`);
|
|
210
222
|
}
|
|
211
223
|
else {
|
|
212
|
-
|
|
224
|
+
add(`${columnRef} IS NULL`);
|
|
213
225
|
}
|
|
214
226
|
break;
|
|
215
227
|
}
|