@framers/agentos 0.1.120 → 0.1.122
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/README.md +21 -0
- package/dist/api/agency.d.ts.map +1 -1
- package/dist/api/agency.js +227 -84
- package/dist/api/agency.js.map +1 -1
- package/dist/api/analyzeVideo.d.ts +127 -0
- package/dist/api/analyzeVideo.d.ts.map +1 -0
- package/dist/api/analyzeVideo.js +136 -0
- package/dist/api/analyzeVideo.js.map +1 -0
- package/dist/api/detectScenes.d.ts +82 -0
- package/dist/api/detectScenes.d.ts.map +1 -0
- package/dist/api/detectScenes.js +67 -0
- package/dist/api/detectScenes.js.map +1 -0
- package/dist/api/generateImage.d.ts +7 -0
- package/dist/api/generateImage.d.ts.map +1 -1
- package/dist/api/generateImage.js +133 -9
- package/dist/api/generateImage.js.map +1 -1
- package/dist/api/generateMusic.d.ts +98 -0
- package/dist/api/generateMusic.d.ts.map +1 -0
- package/dist/api/generateMusic.js +319 -0
- package/dist/api/generateMusic.js.map +1 -0
- package/dist/api/generateSFX.d.ts +96 -0
- package/dist/api/generateSFX.d.ts.map +1 -0
- package/dist/api/generateSFX.js +317 -0
- package/dist/api/generateSFX.js.map +1 -0
- package/dist/api/generateVideo.d.ts +113 -0
- package/dist/api/generateVideo.d.ts.map +1 -0
- package/dist/api/generateVideo.js +342 -0
- package/dist/api/generateVideo.js.map +1 -0
- package/dist/api/model.d.ts.map +1 -1
- package/dist/api/model.js +8 -4
- package/dist/api/model.js.map +1 -1
- package/dist/api/performOCR.d.ts +169 -0
- package/dist/api/performOCR.d.ts.map +1 -0
- package/dist/api/performOCR.js +198 -0
- package/dist/api/performOCR.js.map +1 -0
- package/dist/api/provider-defaults.d.ts +7 -5
- package/dist/api/provider-defaults.d.ts.map +1 -1
- package/dist/api/provider-defaults.js +32 -10
- package/dist/api/provider-defaults.js.map +1 -1
- package/dist/api/strategies/debate.d.ts.map +1 -1
- package/dist/api/strategies/debate.js +1 -0
- package/dist/api/strategies/debate.js.map +1 -1
- package/dist/api/strategies/graph.d.ts.map +1 -1
- package/dist/api/strategies/graph.js +69 -13
- package/dist/api/strategies/graph.js.map +1 -1
- package/dist/api/strategies/hierarchical.d.ts.map +1 -1
- package/dist/api/strategies/hierarchical.js +1 -0
- package/dist/api/strategies/hierarchical.js.map +1 -1
- package/dist/api/strategies/parallel.d.ts.map +1 -1
- package/dist/api/strategies/parallel.js +1 -0
- package/dist/api/strategies/parallel.js.map +1 -1
- package/dist/api/strategies/review-loop.d.ts.map +1 -1
- package/dist/api/strategies/review-loop.js +1 -0
- package/dist/api/strategies/review-loop.js.map +1 -1
- package/dist/api/strategies/sequential.d.ts.map +1 -1
- package/dist/api/strategies/sequential.js +54 -48
- package/dist/api/strategies/sequential.js.map +1 -1
- package/dist/api/streamBuffer.d.ts +20 -0
- package/dist/api/streamBuffer.d.ts.map +1 -0
- package/dist/api/streamBuffer.js +81 -0
- package/dist/api/streamBuffer.js.map +1 -0
- package/dist/api/types.d.ts +145 -5
- package/dist/api/types.d.ts.map +1 -1
- package/dist/api/types.js.map +1 -1
- package/dist/channels/adapters/RedditChannelAdapter.js.map +1 -1
- package/dist/core/audio/AudioProcessor.d.ts.map +1 -1
- package/dist/core/audio/AudioProcessor.js +1 -0
- package/dist/core/audio/AudioProcessor.js.map +1 -1
- package/dist/core/audio/EnvironmentalCalibrator.d.ts.map +1 -1
- package/dist/core/audio/EnvironmentalCalibrator.js +1 -0
- package/dist/core/audio/EnvironmentalCalibrator.js.map +1 -1
- package/dist/core/audio/FallbackAudioProxy.d.ts +169 -0
- package/dist/core/audio/FallbackAudioProxy.d.ts.map +1 -0
- package/dist/core/audio/FallbackAudioProxy.js +236 -0
- package/dist/core/audio/FallbackAudioProxy.js.map +1 -0
- package/dist/core/audio/IAudioGenerator.d.ts +103 -0
- package/dist/core/audio/IAudioGenerator.d.ts.map +1 -0
- package/dist/core/audio/IAudioGenerator.js +24 -0
- package/dist/core/audio/IAudioGenerator.js.map +1 -0
- package/dist/core/audio/index.d.ts +54 -0
- package/dist/core/audio/index.d.ts.map +1 -1
- package/dist/core/audio/index.js +93 -0
- package/dist/core/audio/index.js.map +1 -1
- package/dist/core/audio/providers/AudioGenLocalProvider.d.ts +136 -0
- package/dist/core/audio/providers/AudioGenLocalProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/AudioGenLocalProvider.js +235 -0
- package/dist/core/audio/providers/AudioGenLocalProvider.js.map +1 -0
- package/dist/core/audio/providers/ElevenLabsSFXProvider.d.ts +107 -0
- package/dist/core/audio/providers/ElevenLabsSFXProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/ElevenLabsSFXProvider.js +154 -0
- package/dist/core/audio/providers/ElevenLabsSFXProvider.js.map +1 -0
- package/dist/core/audio/providers/FalAudioProvider.d.ts +207 -0
- package/dist/core/audio/providers/FalAudioProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/FalAudioProvider.js +315 -0
- package/dist/core/audio/providers/FalAudioProvider.js.map +1 -0
- package/dist/core/audio/providers/MusicGenLocalProvider.d.ts +136 -0
- package/dist/core/audio/providers/MusicGenLocalProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/MusicGenLocalProvider.js +235 -0
- package/dist/core/audio/providers/MusicGenLocalProvider.js.map +1 -0
- package/dist/core/audio/providers/ReplicateAudioProvider.d.ts +200 -0
- package/dist/core/audio/providers/ReplicateAudioProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/ReplicateAudioProvider.js +346 -0
- package/dist/core/audio/providers/ReplicateAudioProvider.js.map +1 -0
- package/dist/core/audio/providers/StableAudioProvider.d.ts +138 -0
- package/dist/core/audio/providers/StableAudioProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/StableAudioProvider.js +192 -0
- package/dist/core/audio/providers/StableAudioProvider.js.map +1 -0
- package/dist/core/audio/providers/SunoProvider.d.ts +182 -0
- package/dist/core/audio/providers/SunoProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/SunoProvider.js +312 -0
- package/dist/core/audio/providers/SunoProvider.js.map +1 -0
- package/dist/core/audio/providers/UdioProvider.d.ts +177 -0
- package/dist/core/audio/providers/UdioProvider.d.ts.map +1 -0
- package/dist/core/audio/providers/UdioProvider.js +305 -0
- package/dist/core/audio/providers/UdioProvider.js.map +1 -0
- package/dist/core/audio/types.d.ts +257 -0
- package/dist/core/audio/types.d.ts.map +1 -0
- package/dist/core/audio/types.js +21 -0
- package/dist/core/audio/types.js.map +1 -0
- package/dist/core/images/FallbackImageProxy.d.ts +183 -0
- package/dist/core/images/FallbackImageProxy.d.ts.map +1 -0
- package/dist/core/images/FallbackImageProxy.js +283 -0
- package/dist/core/images/FallbackImageProxy.js.map +1 -0
- package/dist/core/images/IImageProvider.d.ts +1 -1
- package/dist/core/images/IImageProvider.d.ts.map +1 -1
- package/dist/core/images/index.d.ts +1 -0
- package/dist/core/images/index.d.ts.map +1 -1
- package/dist/core/images/index.js +1 -0
- package/dist/core/images/index.js.map +1 -1
- package/dist/core/llm/providers/AIModelProviderManager.d.ts +3 -1
- package/dist/core/llm/providers/AIModelProviderManager.d.ts.map +1 -1
- package/dist/core/llm/providers/AIModelProviderManager.js +8 -0
- package/dist/core/llm/providers/AIModelProviderManager.js.map +1 -1
- package/dist/core/llm/providers/errors/ClaudeCodeProviderError.d.ts +52 -0
- package/dist/core/llm/providers/errors/ClaudeCodeProviderError.d.ts.map +1 -0
- package/dist/core/llm/providers/errors/ClaudeCodeProviderError.js +36 -0
- package/dist/core/llm/providers/errors/ClaudeCodeProviderError.js.map +1 -0
- package/dist/core/llm/providers/errors/GeminiCLIProviderError.d.ts +32 -0
- package/dist/core/llm/providers/errors/GeminiCLIProviderError.d.ts.map +1 -0
- package/dist/core/llm/providers/errors/GeminiCLIProviderError.js +27 -0
- package/dist/core/llm/providers/errors/GeminiCLIProviderError.js.map +1 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.d.ts +38 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.d.ts.map +1 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.js +128 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.js.map +1 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeProvider.d.ts +107 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeProvider.d.ts.map +1 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeProvider.js +504 -0
- package/dist/core/llm/providers/implementations/ClaudeCodeProvider.js.map +1 -0
- package/dist/core/llm/providers/implementations/GeminiCLIBridge.d.ts +60 -0
- package/dist/core/llm/providers/implementations/GeminiCLIBridge.d.ts.map +1 -0
- package/dist/core/llm/providers/implementations/GeminiCLIBridge.js +177 -0
- package/dist/core/llm/providers/implementations/GeminiCLIBridge.js.map +1 -0
- package/dist/core/llm/providers/implementations/GeminiCLIProvider.d.ts +55 -0
- package/dist/core/llm/providers/implementations/GeminiCLIProvider.d.ts.map +1 -0
- package/dist/core/llm/providers/implementations/GeminiCLIProvider.js +447 -0
- package/dist/core/llm/providers/implementations/GeminiCLIProvider.js.map +1 -0
- package/dist/core/media/ProviderPreferences.d.ts +158 -0
- package/dist/core/media/ProviderPreferences.d.ts.map +1 -0
- package/dist/core/media/ProviderPreferences.js +183 -0
- package/dist/core/media/ProviderPreferences.js.map +1 -0
- package/dist/core/subprocess/CLIRegistry.d.ts +71 -0
- package/dist/core/subprocess/CLIRegistry.d.ts.map +1 -0
- package/dist/core/subprocess/CLIRegistry.js +210 -0
- package/dist/core/subprocess/CLIRegistry.js.map +1 -0
- package/dist/core/subprocess/CLISubprocessBridge.d.ts +117 -0
- package/dist/core/subprocess/CLISubprocessBridge.d.ts.map +1 -0
- package/dist/core/subprocess/CLISubprocessBridge.js +199 -0
- package/dist/core/subprocess/CLISubprocessBridge.js.map +1 -0
- package/dist/core/subprocess/errors.d.ts +76 -0
- package/dist/core/subprocess/errors.d.ts.map +1 -0
- package/dist/core/subprocess/errors.js +75 -0
- package/dist/core/subprocess/errors.js.map +1 -0
- package/dist/core/subprocess/index.d.ts +11 -0
- package/dist/core/subprocess/index.d.ts.map +1 -0
- package/dist/core/subprocess/index.js +10 -0
- package/dist/core/subprocess/index.js.map +1 -0
- package/dist/core/subprocess/types.d.ts +100 -0
- package/dist/core/subprocess/types.d.ts.map +1 -0
- package/dist/core/subprocess/types.js +9 -0
- package/dist/core/subprocess/types.js.map +1 -0
- package/dist/core/video/FallbackVideoProxy.d.ts +166 -0
- package/dist/core/video/FallbackVideoProxy.d.ts.map +1 -0
- package/dist/core/video/FallbackVideoProxy.js +228 -0
- package/dist/core/video/FallbackVideoProxy.js.map +1 -0
- package/dist/core/video/IVideoAnalyzer.d.ts +29 -0
- package/dist/core/video/IVideoAnalyzer.d.ts.map +1 -0
- package/dist/core/video/IVideoAnalyzer.js +12 -0
- package/dist/core/video/IVideoAnalyzer.js.map +1 -0
- package/dist/core/video/IVideoGenerator.d.ts +76 -0
- package/dist/core/video/IVideoGenerator.d.ts.map +1 -0
- package/dist/core/video/IVideoGenerator.js +13 -0
- package/dist/core/video/IVideoGenerator.js.map +1 -0
- package/dist/core/video/VideoAnalyzer.d.ts +278 -0
- package/dist/core/video/VideoAnalyzer.d.ts.map +1 -0
- package/dist/core/video/VideoAnalyzer.js +648 -0
- package/dist/core/video/VideoAnalyzer.js.map +1 -0
- package/dist/core/video/index.d.ts +55 -0
- package/dist/core/video/index.d.ts.map +1 -0
- package/dist/core/video/index.js +78 -0
- package/dist/core/video/index.js.map +1 -0
- package/dist/core/video/providers/FalVideoProvider.d.ts +195 -0
- package/dist/core/video/providers/FalVideoProvider.d.ts.map +1 -0
- package/dist/core/video/providers/FalVideoProvider.js +322 -0
- package/dist/core/video/providers/FalVideoProvider.js.map +1 -0
- package/dist/core/video/providers/ReplicateVideoProvider.d.ts +194 -0
- package/dist/core/video/providers/ReplicateVideoProvider.d.ts.map +1 -0
- package/dist/core/video/providers/ReplicateVideoProvider.js +356 -0
- package/dist/core/video/providers/ReplicateVideoProvider.js.map +1 -0
- package/dist/core/video/providers/RunwayVideoProvider.d.ts +175 -0
- package/dist/core/video/providers/RunwayVideoProvider.d.ts.map +1 -0
- package/dist/core/video/providers/RunwayVideoProvider.js +293 -0
- package/dist/core/video/providers/RunwayVideoProvider.js.map +1 -0
- package/dist/core/video/types.d.ts +441 -0
- package/dist/core/video/types.d.ts.map +1 -0
- package/dist/core/video/types.js +10 -0
- package/dist/core/video/types.js.map +1 -0
- package/dist/core/vision/SceneDetector.d.ts +180 -0
- package/dist/core/vision/SceneDetector.d.ts.map +1 -0
- package/dist/core/vision/SceneDetector.js +366 -0
- package/dist/core/vision/SceneDetector.js.map +1 -0
- package/dist/core/vision/index.d.ts +2 -1
- package/dist/core/vision/index.d.ts.map +1 -1
- package/dist/core/vision/index.js +1 -0
- package/dist/core/vision/index.js.map +1 -1
- package/dist/core/vision/types.d.ts +125 -0
- package/dist/core/vision/types.d.ts.map +1 -1
- package/dist/discovery/CapabilityDiscoveryEngine.d.ts +32 -0
- package/dist/discovery/CapabilityDiscoveryEngine.d.ts.map +1 -1
- package/dist/discovery/CapabilityDiscoveryEngine.js +46 -0
- package/dist/discovery/CapabilityDiscoveryEngine.js.map +1 -1
- package/dist/emergent/AdaptPersonalityTool.d.ts +158 -0
- package/dist/emergent/AdaptPersonalityTool.d.ts.map +1 -0
- package/dist/emergent/AdaptPersonalityTool.js +190 -0
- package/dist/emergent/AdaptPersonalityTool.js.map +1 -0
- package/dist/emergent/CreateWorkflowTool.d.ts +181 -0
- package/dist/emergent/CreateWorkflowTool.d.ts.map +1 -0
- package/dist/emergent/CreateWorkflowTool.js +307 -0
- package/dist/emergent/CreateWorkflowTool.js.map +1 -0
- package/dist/emergent/ManageSkillsTool.d.ts +154 -0
- package/dist/emergent/ManageSkillsTool.d.ts.map +1 -0
- package/dist/emergent/ManageSkillsTool.js +241 -0
- package/dist/emergent/ManageSkillsTool.js.map +1 -0
- package/dist/emergent/PersonalityMutationStore.d.ts +183 -0
- package/dist/emergent/PersonalityMutationStore.d.ts.map +1 -0
- package/dist/emergent/PersonalityMutationStore.js +222 -0
- package/dist/emergent/PersonalityMutationStore.js.map +1 -0
- package/dist/emergent/SelfEvaluateTool.d.ts +189 -0
- package/dist/emergent/SelfEvaluateTool.d.ts.map +1 -0
- package/dist/emergent/SelfEvaluateTool.js +353 -0
- package/dist/emergent/SelfEvaluateTool.js.map +1 -0
- package/dist/emergent/SelfImprovementConfig.d.ts +166 -0
- package/dist/emergent/SelfImprovementConfig.d.ts.map +1 -0
- package/dist/emergent/SelfImprovementConfig.js +43 -0
- package/dist/emergent/SelfImprovementConfig.js.map +1 -0
- package/dist/emergent/index.d.ts +1 -0
- package/dist/emergent/index.d.ts.map +1 -1
- package/dist/emergent/index.js +1 -0
- package/dist/emergent/index.js.map +1 -1
- package/dist/emergent/types.d.ts +9 -0
- package/dist/emergent/types.d.ts.map +1 -1
- package/dist/emergent/types.js.map +1 -1
- package/dist/extensions/MultiRegistryLoader.js.map +1 -1
- package/dist/index.d.ts +17 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -0
- package/dist/index.js.map +1 -1
- package/dist/memory/CognitiveMemoryManager.d.ts +40 -0
- package/dist/memory/CognitiveMemoryManager.d.ts.map +1 -1
- package/dist/memory/CognitiveMemoryManager.js +54 -1
- package/dist/memory/CognitiveMemoryManager.js.map +1 -1
- package/dist/memory/facade/Memory.d.ts +4 -0
- package/dist/memory/facade/Memory.d.ts.map +1 -1
- package/dist/memory/facade/Memory.js +140 -4
- package/dist/memory/facade/Memory.js.map +1 -1
- package/dist/memory/facade/types.d.ts +30 -2
- package/dist/memory/facade/types.d.ts.map +1 -1
- package/dist/memory/index.d.ts +1 -0
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/memory/index.js +1 -0
- package/dist/memory/index.js.map +1 -1
- package/dist/memory/types.d.ts +15 -0
- package/dist/memory/types.d.ts.map +1 -1
- package/dist/query-router/QueryClassifier.d.ts +192 -21
- package/dist/query-router/QueryClassifier.d.ts.map +1 -1
- package/dist/query-router/QueryClassifier.js +604 -23
- package/dist/query-router/QueryClassifier.js.map +1 -1
- package/dist/query-router/QueryDispatcher.d.ts +106 -8
- package/dist/query-router/QueryDispatcher.d.ts.map +1 -1
- package/dist/query-router/QueryDispatcher.js +387 -8
- package/dist/query-router/QueryDispatcher.js.map +1 -1
- package/dist/query-router/QueryRouter.d.ts +198 -14
- package/dist/query-router/QueryRouter.d.ts.map +1 -1
- package/dist/query-router/QueryRouter.js +738 -50
- package/dist/query-router/QueryRouter.js.map +1 -1
- package/dist/query-router/index.d.ts +1 -1
- package/dist/query-router/index.d.ts.map +1 -1
- package/dist/query-router/index.js +1 -1
- package/dist/query-router/index.js.map +1 -1
- package/dist/query-router/types.d.ts +396 -3
- package/dist/query-router/types.d.ts.map +1 -1
- package/dist/query-router/types.js +35 -0
- package/dist/query-router/types.js.map +1 -1
- package/dist/rag/HydeRetriever.d.ts +108 -0
- package/dist/rag/HydeRetriever.d.ts.map +1 -1
- package/dist/rag/HydeRetriever.js +184 -0
- package/dist/rag/HydeRetriever.js.map +1 -1
- package/dist/rag/IRetrievalAugmentor.d.ts +15 -0
- package/dist/rag/IRetrievalAugmentor.d.ts.map +1 -1
- package/dist/rag/RetrievalAugmentor.d.ts +58 -0
- package/dist/rag/RetrievalAugmentor.d.ts.map +1 -1
- package/dist/rag/RetrievalAugmentor.js +200 -32
- package/dist/rag/RetrievalAugmentor.js.map +1 -1
- package/dist/rag/VectorStoreManager.js +1 -1
- package/dist/rag/audit/RAGAuditCollector.d.ts +7 -0
- package/dist/rag/audit/RAGAuditCollector.d.ts.map +1 -1
- package/dist/rag/audit/RAGAuditCollector.js +10 -0
- package/dist/rag/audit/RAGAuditCollector.js.map +1 -1
- package/dist/rag/audit/RAGAuditTypes.d.ts +10 -1
- package/dist/rag/audit/RAGAuditTypes.d.ts.map +1 -1
- package/dist/rag/chunking/SemanticChunker.d.ts +210 -0
- package/dist/rag/chunking/SemanticChunker.d.ts.map +1 -0
- package/dist/rag/chunking/SemanticChunker.js +460 -0
- package/dist/rag/chunking/SemanticChunker.js.map +1 -0
- package/dist/rag/chunking/index.d.ts +10 -0
- package/dist/rag/chunking/index.d.ts.map +1 -0
- package/dist/rag/chunking/index.js +10 -0
- package/dist/rag/chunking/index.js.map +1 -0
- package/dist/rag/implementations/vector_stores/PineconeVectorStore.d.ts +103 -0
- package/dist/rag/implementations/vector_stores/PineconeVectorStore.d.ts.map +1 -0
- package/dist/rag/implementations/vector_stores/PineconeVectorStore.js +315 -0
- package/dist/rag/implementations/vector_stores/PineconeVectorStore.js.map +1 -0
- package/dist/rag/implementations/vector_stores/PostgresVectorStore.d.ts +107 -0
- package/dist/rag/implementations/vector_stores/PostgresVectorStore.d.ts.map +1 -0
- package/dist/rag/implementations/vector_stores/PostgresVectorStore.js +438 -0
- package/dist/rag/implementations/vector_stores/PostgresVectorStore.js.map +1 -0
- package/dist/rag/index.d.ts +15 -1
- package/dist/rag/index.d.ts.map +1 -1
- package/dist/rag/index.js +32 -0
- package/dist/rag/index.js.map +1 -1
- package/dist/rag/migration/MigrationEngine.d.ts +47 -0
- package/dist/rag/migration/MigrationEngine.d.ts.map +1 -0
- package/dist/rag/migration/MigrationEngine.js +168 -0
- package/dist/rag/migration/MigrationEngine.js.map +1 -0
- package/dist/rag/migration/adapters/PineconeSourceAdapter.d.ts +23 -0
- package/dist/rag/migration/adapters/PineconeSourceAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/PineconeSourceAdapter.js +63 -0
- package/dist/rag/migration/adapters/PineconeSourceAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/PostgresSourceAdapter.d.ts +30 -0
- package/dist/rag/migration/adapters/PostgresSourceAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/PostgresSourceAdapter.js +71 -0
- package/dist/rag/migration/adapters/PostgresSourceAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/PostgresTargetAdapter.d.ts +38 -0
- package/dist/rag/migration/adapters/PostgresTargetAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/PostgresTargetAdapter.js +114 -0
- package/dist/rag/migration/adapters/PostgresTargetAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/QdrantSourceAdapter.d.ts +36 -0
- package/dist/rag/migration/adapters/QdrantSourceAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/QdrantSourceAdapter.js +109 -0
- package/dist/rag/migration/adapters/QdrantSourceAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts +35 -0
- package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/QdrantTargetAdapter.js +110 -0
- package/dist/rag/migration/adapters/QdrantTargetAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts +37 -0
- package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/SqliteSourceAdapter.js +72 -0
- package/dist/rag/migration/adapters/SqliteSourceAdapter.js.map +1 -0
- package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts +47 -0
- package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts.map +1 -0
- package/dist/rag/migration/adapters/SqliteTargetAdapter.js +93 -0
- package/dist/rag/migration/adapters/SqliteTargetAdapter.js.map +1 -0
- package/dist/rag/migration/types.d.ts +108 -0
- package/dist/rag/migration/types.d.ts.map +1 -0
- package/dist/rag/migration/types.js +11 -0
- package/dist/rag/migration/types.js.map +1 -0
- package/dist/rag/multimodal/MultimodalIndexer.d.ts +35 -0
- package/dist/rag/multimodal/MultimodalIndexer.d.ts.map +1 -1
- package/dist/rag/multimodal/MultimodalIndexer.js +66 -1
- package/dist/rag/multimodal/MultimodalIndexer.js.map +1 -1
- package/dist/rag/multimodal/types.d.ts +24 -0
- package/dist/rag/multimodal/types.d.ts.map +1 -1
- package/dist/rag/raptor/RaptorTree.d.ts +268 -0
- package/dist/rag/raptor/RaptorTree.d.ts.map +1 -0
- package/dist/rag/raptor/RaptorTree.js +443 -0
- package/dist/rag/raptor/RaptorTree.js.map +1 -0
- package/dist/rag/raptor/index.d.ts +11 -0
- package/dist/rag/raptor/index.d.ts.map +1 -0
- package/dist/rag/raptor/index.js +11 -0
- package/dist/rag/raptor/index.js.map +1 -0
- package/dist/rag/reranking/providers/CohereReranker.js.map +1 -1
- package/dist/rag/search/BM25Index.d.ts +282 -0
- package/dist/rag/search/BM25Index.d.ts.map +1 -0
- package/dist/rag/search/BM25Index.js +344 -0
- package/dist/rag/search/BM25Index.js.map +1 -0
- package/dist/rag/search/HybridSearcher.d.ts +198 -0
- package/dist/rag/search/HybridSearcher.d.ts.map +1 -0
- package/dist/rag/search/HybridSearcher.js +316 -0
- package/dist/rag/search/HybridSearcher.js.map +1 -0
- package/dist/rag/search/index.d.ts +12 -0
- package/dist/rag/search/index.d.ts.map +1 -0
- package/dist/rag/search/index.js +12 -0
- package/dist/rag/search/index.js.map +1 -0
- package/dist/rag/setup/DockerDetector.d.ts +67 -0
- package/dist/rag/setup/DockerDetector.d.ts.map +1 -0
- package/dist/rag/setup/DockerDetector.js +125 -0
- package/dist/rag/setup/DockerDetector.js.map +1 -0
- package/dist/rag/setup/PostgresSetup.d.ts +20 -0
- package/dist/rag/setup/PostgresSetup.d.ts.map +1 -0
- package/dist/rag/setup/PostgresSetup.js +133 -0
- package/dist/rag/setup/PostgresSetup.js.map +1 -0
- package/dist/rag/setup/QdrantSetup.d.ts +26 -0
- package/dist/rag/setup/QdrantSetup.d.ts.map +1 -0
- package/dist/rag/setup/QdrantSetup.js +96 -0
- package/dist/rag/setup/QdrantSetup.js.map +1 -0
- package/dist/rag/setup/types.d.ts +55 -0
- package/dist/rag/setup/types.d.ts.map +1 -0
- package/dist/rag/setup/types.js +6 -0
- package/dist/rag/setup/types.js.map +1 -0
- package/dist/rag/unified/UnifiedRetriever.d.ts +472 -0
- package/dist/rag/unified/UnifiedRetriever.d.ts.map +1 -0
- package/dist/rag/unified/UnifiedRetriever.js +887 -0
- package/dist/rag/unified/UnifiedRetriever.js.map +1 -0
- package/dist/rag/unified/index.d.ts +24 -0
- package/dist/rag/unified/index.d.ts.map +1 -0
- package/dist/rag/unified/index.js +23 -0
- package/dist/rag/unified/index.js.map +1 -0
- package/dist/rag/unified/types.d.ts +546 -0
- package/dist/rag/unified/types.d.ts.map +1 -0
- package/dist/rag/unified/types.js +177 -0
- package/dist/rag/unified/types.js.map +1 -0
- package/dist/speech/providers/AssemblyAISTTProvider.js.map +1 -1
- package/dist/speech/providers/AzureSpeechSTTProvider.js.map +1 -1
- package/dist/speech/providers/BuiltInAdaptiveVadProvider.d.ts +1 -1
- package/dist/speech/providers/DeepgramBatchSTTProvider.js.map +1 -1
- package/package.json +5 -2
|
@@ -0,0 +1,472 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview UnifiedRetriever — single-entry-point retrieval orchestrator
|
|
3
|
+
* that executes a {@link RetrievalPlan} across ALL available sources in
|
|
4
|
+
* parallel, merges results via Reciprocal Rank Fusion (RRF), reranks, and
|
|
5
|
+
* feeds back into cognitive memory.
|
|
6
|
+
*
|
|
7
|
+
* This replaces the need to call RetrievalAugmentor, QueryDispatcher,
|
|
8
|
+
* CognitiveMemoryManager, and MultimodalIndexer separately. It is the
|
|
9
|
+
* canonical retrieval path for AgentOS v2.
|
|
10
|
+
*
|
|
11
|
+
* Architecture:
|
|
12
|
+
* ```
|
|
13
|
+
* RetrievalPlan
|
|
14
|
+
* │
|
|
15
|
+
* ▼
|
|
16
|
+
* ┌─────────────────────────┐
|
|
17
|
+
* │ 1. Memory-first check │ (episodic cache shortcut)
|
|
18
|
+
* └───────────┬─────────────┘
|
|
19
|
+
* ▼
|
|
20
|
+
* ┌─────────────────────────┐
|
|
21
|
+
* │ 2. Parallel sources │ Promise.allSettled across enabled sources
|
|
22
|
+
* │ • hybrid (vector+BM25) │
|
|
23
|
+
* │ • RAPTOR tree │
|
|
24
|
+
* │ • GraphRAG │
|
|
25
|
+
* │ • Cognitive memory │
|
|
26
|
+
* │ • Multimodal index │
|
|
27
|
+
* │ • HyDE hypotheses │
|
|
28
|
+
* └───────────┬─────────────┘
|
|
29
|
+
* ▼
|
|
30
|
+
* ┌─────────────────────────┐
|
|
31
|
+
* │ 3. RRF merge │ Reciprocal Rank Fusion across all source lists
|
|
32
|
+
* └───────────┬─────────────┘
|
|
33
|
+
* ▼
|
|
34
|
+
* ┌─────────────────────────┐
|
|
35
|
+
* │ 4. Temporal boosting │ Exponential decay boost for recent results
|
|
36
|
+
* └───────────┬─────────────┘
|
|
37
|
+
* ▼
|
|
38
|
+
* ┌─────────────────────────┐
|
|
39
|
+
* │ 5. Rerank │ Cross-encoder or LLM-based reranking
|
|
40
|
+
* └───────────┬─────────────┘
|
|
41
|
+
* ▼
|
|
42
|
+
* ┌─────────────────────────┐
|
|
43
|
+
* │ 6. Deep research │ (complex strategy only: decompose → recurse)
|
|
44
|
+
* └───────────┬─────────────┘
|
|
45
|
+
* ▼
|
|
46
|
+
* ┌─────────────────────────┐
|
|
47
|
+
* │ 7. Memory feedback │ Store retrieval as episodic memory + Hebbian
|
|
48
|
+
* └─────────────────────────┘
|
|
49
|
+
* ```
|
|
50
|
+
*
|
|
51
|
+
* @module agentos/rag/unified/UnifiedRetriever
|
|
52
|
+
* @see RetrievalPlan for the plan specification
|
|
53
|
+
* @see buildDefaultPlan for creating default plans
|
|
54
|
+
*/
|
|
55
|
+
import { EventEmitter } from 'node:events';
|
|
56
|
+
import type { RetrievalPlan, UnifiedRetrievalResult, UnifiedRetrieverEvent } from './types.js';
|
|
57
|
+
import type { RetrievedChunk } from '../../query-router/types.js';
|
|
58
|
+
import type { HybridSearcher } from '../search/HybridSearcher.js';
|
|
59
|
+
import type { RaptorTree } from '../raptor/RaptorTree.js';
|
|
60
|
+
import type { HydeRetriever } from '../HydeRetriever.js';
|
|
61
|
+
import type { ICognitiveMemoryManager } from '../../memory/CognitiveMemoryManager.js';
|
|
62
|
+
import type { MultimodalIndexer } from '../multimodal/MultimodalIndexer.js';
|
|
63
|
+
import type { IGraphRAGEngine } from '../graphrag/IGraphRAG.js';
|
|
64
|
+
/**
|
|
65
|
+
* Dependencies injected into the {@link UnifiedRetriever}.
|
|
66
|
+
*
|
|
67
|
+
* All dependencies are optional — the retriever gracefully skips sources
|
|
68
|
+
* whose dependencies are not provided. This allows incremental adoption:
|
|
69
|
+
* start with just vector + BM25, then add GraphRAG, RAPTOR, memory, etc.
|
|
70
|
+
*
|
|
71
|
+
* @example
|
|
72
|
+
* ```typescript
|
|
73
|
+
* const deps: UnifiedRetrieverDeps = {
|
|
74
|
+
* hybridSearcher: myHybridSearcher,
|
|
75
|
+
* rerank: async (q, chunks, n) => chunks.slice(0, n),
|
|
76
|
+
* emit: (event) => console.log(event.type),
|
|
77
|
+
* };
|
|
78
|
+
* ```
|
|
79
|
+
*/
|
|
80
|
+
export interface UnifiedRetrieverDeps {
|
|
81
|
+
/**
|
|
82
|
+
* Hybrid dense+sparse searcher (vector + BM25).
|
|
83
|
+
* When provided, enables the `vector` and `bm25` sources.
|
|
84
|
+
*/
|
|
85
|
+
hybridSearcher?: HybridSearcher;
|
|
86
|
+
/**
|
|
87
|
+
* Vector store collection name for hybrid search.
|
|
88
|
+
* @default 'knowledge-base'
|
|
89
|
+
*/
|
|
90
|
+
collectionName?: string;
|
|
91
|
+
/**
|
|
92
|
+
* RAPTOR hierarchical summary tree.
|
|
93
|
+
* When provided, enables the `raptor` source.
|
|
94
|
+
*/
|
|
95
|
+
raptorTree?: RaptorTree;
|
|
96
|
+
/**
|
|
97
|
+
* GraphRAG engine for entity/relationship traversal.
|
|
98
|
+
* When provided, enables the `graph` source.
|
|
99
|
+
*/
|
|
100
|
+
graphEngine?: IGraphRAGEngine;
|
|
101
|
+
/**
|
|
102
|
+
* Cognitive memory manager.
|
|
103
|
+
* When provided, enables the `memory` source and memory feedback loop.
|
|
104
|
+
*/
|
|
105
|
+
memoryManager?: ICognitiveMemoryManager;
|
|
106
|
+
/**
|
|
107
|
+
* HyDE (Hypothetical Document Embedding) retriever.
|
|
108
|
+
* When provided and plan.hyde.enabled is true, generates hypothetical
|
|
109
|
+
* answers before embedding for improved recall.
|
|
110
|
+
*/
|
|
111
|
+
hydeRetriever?: HydeRetriever;
|
|
112
|
+
/**
|
|
113
|
+
* Multimodal indexer for image/audio/video search.
|
|
114
|
+
* When provided, enables the `multimodal` source.
|
|
115
|
+
*/
|
|
116
|
+
multimodalIndexer?: MultimodalIndexer;
|
|
117
|
+
/**
|
|
118
|
+
* Vector search function (fallback when hybridSearcher is not available).
|
|
119
|
+
*
|
|
120
|
+
* @param query - The search query.
|
|
121
|
+
* @param topK - Maximum results to return.
|
|
122
|
+
* @returns Retrieved chunks.
|
|
123
|
+
*/
|
|
124
|
+
vectorSearch?: (query: string, topK: number) => Promise<RetrievedChunk[]>;
|
|
125
|
+
/**
|
|
126
|
+
* Cross-encoder or LLM-based reranker.
|
|
127
|
+
*
|
|
128
|
+
* @param query - The user query for relevance scoring.
|
|
129
|
+
* @param chunks - Candidate chunks to rerank.
|
|
130
|
+
* @param topN - Maximum chunks to keep after reranking.
|
|
131
|
+
* @returns Reranked chunks.
|
|
132
|
+
*/
|
|
133
|
+
rerank?: (query: string, chunks: RetrievedChunk[], topN: number) => Promise<RetrievedChunk[]>;
|
|
134
|
+
/**
|
|
135
|
+
* Deep research synthesis callback.
|
|
136
|
+
*
|
|
137
|
+
* @param query - The user query.
|
|
138
|
+
* @param sources - Source hints for research.
|
|
139
|
+
* @returns Synthesis narrative and source chunks.
|
|
140
|
+
*/
|
|
141
|
+
deepResearch?: (query: string, sources: string[]) => Promise<{
|
|
142
|
+
synthesis: string;
|
|
143
|
+
sources: RetrievedChunk[];
|
|
144
|
+
}>;
|
|
145
|
+
/**
|
|
146
|
+
* Query decomposition callback for complex strategies.
|
|
147
|
+
*
|
|
148
|
+
* @param query - The original multi-part query.
|
|
149
|
+
* @param maxSubQueries - Maximum sub-queries to generate.
|
|
150
|
+
* @returns Array of decomposed sub-query strings.
|
|
151
|
+
*/
|
|
152
|
+
decompose?: (query: string, maxSubQueries: number) => Promise<string[]>;
|
|
153
|
+
/**
|
|
154
|
+
* Event listener callback for retrieval lifecycle events.
|
|
155
|
+
* @param event - A typed UnifiedRetriever event.
|
|
156
|
+
*/
|
|
157
|
+
emit?: (event: UnifiedRetrieverEvent) => void;
|
|
158
|
+
/**
|
|
159
|
+
* RRF constant k. Higher values flatten score differences.
|
|
160
|
+
* @default 60
|
|
161
|
+
*/
|
|
162
|
+
rrfK?: number;
|
|
163
|
+
/**
|
|
164
|
+
* Default topK for final results.
|
|
165
|
+
* @default 10
|
|
166
|
+
*/
|
|
167
|
+
defaultTopK?: number;
|
|
168
|
+
/**
|
|
169
|
+
* Maximum sub-queries for complex decomposition.
|
|
170
|
+
* @default 5
|
|
171
|
+
*/
|
|
172
|
+
maxSubQueries?: number;
|
|
173
|
+
/**
|
|
174
|
+
* Memory cache hit confidence threshold.
|
|
175
|
+
* Episodic memories above this confidence skip external sources.
|
|
176
|
+
* @default 0.85
|
|
177
|
+
*/
|
|
178
|
+
memoryCacheThreshold?: number;
|
|
179
|
+
/**
|
|
180
|
+
* Default PAD mood state for memory operations.
|
|
181
|
+
* Used when no mood context is available.
|
|
182
|
+
*/
|
|
183
|
+
defaultMood?: {
|
|
184
|
+
valence: number;
|
|
185
|
+
arousal: number;
|
|
186
|
+
dominance: number;
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* Unified retrieval orchestrator that executes a {@link RetrievalPlan}
|
|
191
|
+
* across ALL available sources in parallel, merges results via RRF,
|
|
192
|
+
* reranks, and feeds back into cognitive memory.
|
|
193
|
+
*
|
|
194
|
+
* This is the single entry point for ALL retrieval in AgentOS. It replaces
|
|
195
|
+
* the need to call RetrievalAugmentor, QueryDispatcher, CognitiveMemoryManager,
|
|
196
|
+
* and MultimodalIndexer separately.
|
|
197
|
+
*
|
|
198
|
+
* All source queries are executed with `Promise.allSettled` so partial
|
|
199
|
+
* failures degrade gracefully — a failed GraphRAG query does not prevent
|
|
200
|
+
* vector results from being returned.
|
|
201
|
+
*
|
|
202
|
+
* @example
|
|
203
|
+
* ```typescript
|
|
204
|
+
* import { UnifiedRetriever } from '../../rag/unified';
|
|
205
|
+
* import { buildDefaultPlan } from '../../rag/unified/types';
|
|
206
|
+
*
|
|
207
|
+
* const retriever = new UnifiedRetriever({
|
|
208
|
+
* hybridSearcher,
|
|
209
|
+
* raptorTree,
|
|
210
|
+
* graphEngine,
|
|
211
|
+
* memoryManager,
|
|
212
|
+
* hydeRetriever,
|
|
213
|
+
* rerank: async (q, chunks, n) => reranker.rerank(q, chunks, n),
|
|
214
|
+
* });
|
|
215
|
+
*
|
|
216
|
+
* const plan = buildDefaultPlan('moderate');
|
|
217
|
+
* const result = await retriever.retrieve('How does authentication work?', plan);
|
|
218
|
+
* console.log(`Found ${result.chunks.length} chunks from ${Object.keys(result.sourceDiagnostics).length} sources`);
|
|
219
|
+
* ```
|
|
220
|
+
*
|
|
221
|
+
* @see RetrievalPlan for plan specification
|
|
222
|
+
* @see buildDefaultPlan for creating default plans
|
|
223
|
+
* @see UnifiedRetrieverDeps for dependency injection
|
|
224
|
+
*/
|
|
225
|
+
export declare class UnifiedRetriever extends EventEmitter {
|
|
226
|
+
/** Injected dependencies. */
|
|
227
|
+
private readonly deps;
|
|
228
|
+
/** Resolved RRF constant. */
|
|
229
|
+
private readonly rrfK;
|
|
230
|
+
/** Resolved default topK. */
|
|
231
|
+
private readonly defaultTopK;
|
|
232
|
+
/** Resolved max sub-queries for decomposition. */
|
|
233
|
+
private readonly maxSubQueries;
|
|
234
|
+
/** Memory cache hit confidence threshold. */
|
|
235
|
+
private readonly memoryCacheThreshold;
|
|
236
|
+
/** Default mood for memory operations. */
|
|
237
|
+
private readonly defaultMood;
|
|
238
|
+
/**
|
|
239
|
+
* Creates a new UnifiedRetriever.
|
|
240
|
+
*
|
|
241
|
+
* @param deps - Dependency injection container. All dependencies are optional;
|
|
242
|
+
* the retriever gracefully skips sources whose deps are not provided.
|
|
243
|
+
*
|
|
244
|
+
* @example
|
|
245
|
+
* ```typescript
|
|
246
|
+
* const retriever = new UnifiedRetriever({
|
|
247
|
+
* hybridSearcher: myHybridSearcher,
|
|
248
|
+
* raptorTree: myRaptorTree,
|
|
249
|
+
* graphEngine: myGraphEngine,
|
|
250
|
+
* memoryManager: myMemoryManager,
|
|
251
|
+
* rerank: myReranker,
|
|
252
|
+
* });
|
|
253
|
+
* ```
|
|
254
|
+
*/
|
|
255
|
+
constructor(deps: UnifiedRetrieverDeps);
|
|
256
|
+
/**
|
|
257
|
+
* Execute a retrieval plan across all enabled sources.
|
|
258
|
+
*
|
|
259
|
+
* Flow:
|
|
260
|
+
* 1. Check memory first — if episodic memory has a cached answer, fast-return
|
|
261
|
+
* 2. Execute all enabled sources in parallel (Promise.allSettled)
|
|
262
|
+
* 3. Merge results via Reciprocal Rank Fusion (RRF)
|
|
263
|
+
* 4. Apply temporal boosting if configured
|
|
264
|
+
* 5. Rerank merged results
|
|
265
|
+
* 6. For complex plans: decompose and recurse
|
|
266
|
+
* 7. Store retrieval event as episodic memory (feedback loop)
|
|
267
|
+
*
|
|
268
|
+
* @param query - The user's natural-language query.
|
|
269
|
+
* @param plan - The retrieval plan specifying which sources to query.
|
|
270
|
+
* @param topK - Maximum number of final results. Defaults to deps.defaultTopK (10).
|
|
271
|
+
* @returns Unified retrieval result with merged, reranked chunks and diagnostics.
|
|
272
|
+
*
|
|
273
|
+
* @throws Never — all source failures are caught and reported in diagnostics.
|
|
274
|
+
* The retriever always returns a result, even if empty.
|
|
275
|
+
*
|
|
276
|
+
* @example
|
|
277
|
+
* ```typescript
|
|
278
|
+
* const plan = buildDefaultPlan('moderate');
|
|
279
|
+
* const result = await retriever.retrieve('How does auth work?', plan);
|
|
280
|
+
* for (const chunk of result.chunks) {
|
|
281
|
+
* console.log(`[${chunk.matchType}] ${chunk.relevanceScore.toFixed(3)}: ${chunk.content.slice(0, 80)}`);
|
|
282
|
+
* }
|
|
283
|
+
* ```
|
|
284
|
+
*/
|
|
285
|
+
retrieve(query: string, plan: RetrievalPlan, topK?: number): Promise<UnifiedRetrievalResult>;
|
|
286
|
+
/**
|
|
287
|
+
* Checks episodic memory for a previous retrieval about the same topic.
|
|
288
|
+
*
|
|
289
|
+
* If a high-confidence cached retrieval is found, returns the cached chunks
|
|
290
|
+
* directly — avoiding the cost of external source queries.
|
|
291
|
+
*
|
|
292
|
+
* @param query - The user query.
|
|
293
|
+
* @param plan - The retrieval plan.
|
|
294
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
295
|
+
* @returns Cached chunks if a high-confidence match was found, null otherwise.
|
|
296
|
+
*/
|
|
297
|
+
private checkMemoryCache;
|
|
298
|
+
/**
|
|
299
|
+
* Executes all enabled retrieval sources in parallel using Promise.allSettled.
|
|
300
|
+
*
|
|
301
|
+
* Sources that fail are silently skipped — their error is recorded in diagnostics
|
|
302
|
+
* and an event is emitted, but the overall retrieval continues with results from
|
|
303
|
+
* other sources.
|
|
304
|
+
*
|
|
305
|
+
* @param query - The user query.
|
|
306
|
+
* @param plan - The retrieval plan.
|
|
307
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
308
|
+
* @returns Map of source name to retrieved chunks.
|
|
309
|
+
*/
|
|
310
|
+
private executeSourcesInParallel;
|
|
311
|
+
/**
|
|
312
|
+
* Searches the hybrid dense+sparse index.
|
|
313
|
+
*
|
|
314
|
+
* @param query - The search query.
|
|
315
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
316
|
+
* @returns Retrieved chunks from hybrid search.
|
|
317
|
+
*/
|
|
318
|
+
private searchHybrid;
|
|
319
|
+
/**
|
|
320
|
+
* Searches the RAPTOR hierarchical summary tree.
|
|
321
|
+
*
|
|
322
|
+
* @param query - The search query.
|
|
323
|
+
* @param plan - The retrieval plan (for layer filtering).
|
|
324
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
325
|
+
* @returns Retrieved chunks from RAPTOR search.
|
|
326
|
+
*/
|
|
327
|
+
private searchRaptor;
|
|
328
|
+
/**
|
|
329
|
+
* Searches the GraphRAG engine using seed chunks from hybrid search.
|
|
330
|
+
*
|
|
331
|
+
* @param query - The search query.
|
|
332
|
+
* @param seedChunks - Seed chunks from hybrid search for entity extraction.
|
|
333
|
+
* @param plan - The retrieval plan (for graph traversal config).
|
|
334
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
335
|
+
* @returns Retrieved chunks from graph search.
|
|
336
|
+
*/
|
|
337
|
+
private searchGraph;
|
|
338
|
+
/**
|
|
339
|
+
* Searches cognitive memory for relevant traces.
|
|
340
|
+
*
|
|
341
|
+
* @param query - The search query.
|
|
342
|
+
* @param plan - The retrieval plan (for memory type filtering).
|
|
343
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
344
|
+
* @returns Retrieved chunks from memory.
|
|
345
|
+
*/
|
|
346
|
+
private searchMemory;
|
|
347
|
+
/**
|
|
348
|
+
* Searches the multimodal index for non-text content.
|
|
349
|
+
*
|
|
350
|
+
* @param query - The search query.
|
|
351
|
+
* @param plan - The retrieval plan (for modality filtering).
|
|
352
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
353
|
+
* @returns Retrieved chunks from multimodal search.
|
|
354
|
+
*/
|
|
355
|
+
private searchMultimodal;
|
|
356
|
+
/**
|
|
357
|
+
* Generates HyDE hypotheses and searches with each hypothesis embedding.
|
|
358
|
+
*
|
|
359
|
+
* @param query - The search query.
|
|
360
|
+
* @param plan - The retrieval plan (for hypothesis count).
|
|
361
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
362
|
+
* @returns Retrieved chunks from HyDE search.
|
|
363
|
+
*/
|
|
364
|
+
private searchHyde;
|
|
365
|
+
/**
|
|
366
|
+
* Merges results from multiple sources using Reciprocal Rank Fusion (RRF).
|
|
367
|
+
*
|
|
368
|
+
* RRF formula (Cormack et al. 2009):
|
|
369
|
+
* ```
|
|
370
|
+
* score(d) = sum_{i} 1 / (k + rank_i(d))
|
|
371
|
+
* ```
|
|
372
|
+
* where k is the RRF constant (default 60) and rank_i(d) is the 1-based
|
|
373
|
+
* rank of document d in source i's result list.
|
|
374
|
+
*
|
|
375
|
+
* Documents appearing in multiple sources naturally receive higher fused
|
|
376
|
+
* scores, boosting documents that are relevant across different retrieval
|
|
377
|
+
* methods.
|
|
378
|
+
*
|
|
379
|
+
* @param sourceResults - Map of source name to ranked chunk lists.
|
|
380
|
+
* @param plan - The retrieval plan (unused currently, reserved for future weighting).
|
|
381
|
+
* @returns Merged chunks with fused RRF scores, sorted descending.
|
|
382
|
+
*/
|
|
383
|
+
private rrfMerge;
|
|
384
|
+
/**
|
|
385
|
+
* Applies exponential decay temporal boosting to results.
|
|
386
|
+
*
|
|
387
|
+
* Recent results receive a multiplicative boost based on their age.
|
|
388
|
+
* The boost decays exponentially: `boost = exp(-age / maxAgeMs) * recencyBoost`.
|
|
389
|
+
*
|
|
390
|
+
* Also filters out results older than `maxAgeMs` when set.
|
|
391
|
+
*
|
|
392
|
+
* @param chunks - Chunks to boost.
|
|
393
|
+
* @param plan - The retrieval plan with temporal configuration.
|
|
394
|
+
* @returns Chunks with adjusted relevance scores.
|
|
395
|
+
*/
|
|
396
|
+
private applyTemporalBoosting;
|
|
397
|
+
/**
|
|
398
|
+
* Executes deep research by decomposing the query into sub-queries and
|
|
399
|
+
* recursing with moderate-level plans.
|
|
400
|
+
*
|
|
401
|
+
* @param query - The original query.
|
|
402
|
+
* @param plan - The retrieval plan.
|
|
403
|
+
* @param existingChunks - Chunks already gathered from other sources.
|
|
404
|
+
* @param diagnostics - Diagnostics accumulator.
|
|
405
|
+
* @returns Research synthesis and additional chunks, or null if research failed.
|
|
406
|
+
*/
|
|
407
|
+
private executeDeepResearch;
|
|
408
|
+
/**
|
|
409
|
+
* Stores the retrieval event as an episodic memory trace and strengthens
|
|
410
|
+
* memory traces for top-retrieved content (Hebbian learning).
|
|
411
|
+
*
|
|
412
|
+
* This creates a feedback loop where frequently retrieved information
|
|
413
|
+
* becomes easier to retrieve in the future, similar to how biological
|
|
414
|
+
* memory consolidation strengthens neural pathways through repeated access.
|
|
415
|
+
*
|
|
416
|
+
* @param query - The original query.
|
|
417
|
+
* @param chunks - The final reranked chunks.
|
|
418
|
+
* @param plan - The retrieval plan.
|
|
419
|
+
*/
|
|
420
|
+
private storeMemoryFeedback;
|
|
421
|
+
/**
|
|
422
|
+
* Deduplicates chunks by ID, keeping the one with the highest relevance score.
|
|
423
|
+
*
|
|
424
|
+
* @param chunks - Chunks to deduplicate.
|
|
425
|
+
* @returns Deduplicated chunks.
|
|
426
|
+
*/
|
|
427
|
+
private deduplicateChunks;
|
|
428
|
+
/**
|
|
429
|
+
* Merges two chunk arrays, deduplicating by ID.
|
|
430
|
+
*
|
|
431
|
+
* @param primary - Primary chunk array.
|
|
432
|
+
* @param secondary - Secondary chunk array.
|
|
433
|
+
* @returns Merged, deduplicated array.
|
|
434
|
+
*/
|
|
435
|
+
private mergeChunks;
|
|
436
|
+
/**
|
|
437
|
+
* Emits a typed UnifiedRetriever event.
|
|
438
|
+
*
|
|
439
|
+
* Routes to both the injected deps.emit callback and the Node.js
|
|
440
|
+
* EventEmitter for maximum flexibility.
|
|
441
|
+
*
|
|
442
|
+
* @param event - The event to emit.
|
|
443
|
+
*/
|
|
444
|
+
private emitEvent;
|
|
445
|
+
/**
|
|
446
|
+
* Creates an empty diagnostics object.
|
|
447
|
+
*
|
|
448
|
+
* @returns Fresh diagnostics with all counters at zero.
|
|
449
|
+
*/
|
|
450
|
+
private emptyDiagnostics;
|
|
451
|
+
/**
|
|
452
|
+
* Builds an empty result for the 'none' strategy.
|
|
453
|
+
*
|
|
454
|
+
* @param plan - The retrieval plan.
|
|
455
|
+
* @param startTime - Pipeline start timestamp.
|
|
456
|
+
* @returns Empty unified retrieval result.
|
|
457
|
+
*/
|
|
458
|
+
private buildEmptyResult;
|
|
459
|
+
/**
|
|
460
|
+
* Builds the final unified retrieval result.
|
|
461
|
+
*
|
|
462
|
+
* @param chunks - The final merged, reranked chunks.
|
|
463
|
+
* @param plan - The retrieval plan that was executed.
|
|
464
|
+
* @param diagnostics - Per-source diagnostics.
|
|
465
|
+
* @param startTime - Pipeline start timestamp.
|
|
466
|
+
* @param memoryCacheHit - Whether a memory cache hit was used.
|
|
467
|
+
* @param researchSynthesis - Optional deep research synthesis.
|
|
468
|
+
* @returns Complete unified retrieval result.
|
|
469
|
+
*/
|
|
470
|
+
private buildResult;
|
|
471
|
+
}
|
|
472
|
+
//# sourceMappingURL=UnifiedRetriever.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UnifiedRetriever.d.ts","sourceRoot":"","sources":["../../../src/rag/unified/UnifiedRetriever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,6BAA6B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,0BAA0B,CAAC;AAOnF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;;OAGG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IAExC;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE9F;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,KACd,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAE/D;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExE;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAE9C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAE9C,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0D;IAEtF;;;;;;;;;;;;;;;;OAgBG;gBACS,IAAI,EAAE,oBAAoB;IActC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC;IA2FlC;;;;;;;;;;OAUG;YACW,gBAAgB;IA+D9B;;;;;;;;;;;OAWG;YACW,wBAAwB;IAgFtC;;;;;;OAMG;YACW,YAAY;IAgC1B;;;;;;;OAOG;YACW,YAAY;IA6B1B;;;;;;;;OAQG;YACW,WAAW;IA+CzB;;;;;;;OAOG;YACW,YAAY;IA6B1B;;;;;;;OAOG;YACW,gBAAgB;IA0B9B;;;;;;;OAOG;YACW,UAAU;IAmFxB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,QAAQ;IAwChB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;;;;;;;;OASG;YACW,mBAAmB;IAiEjC;;;;;;;;;;;OAWG;YACW,mBAAmB;IAgDjC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAOjB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;CAoBpB"}
|