@framers/agentos 0.1.120 → 0.1.121

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +21 -0
  2. package/dist/api/agency.d.ts.map +1 -1
  3. package/dist/api/agency.js +227 -84
  4. package/dist/api/agency.js.map +1 -1
  5. package/dist/api/analyzeVideo.d.ts +127 -0
  6. package/dist/api/analyzeVideo.d.ts.map +1 -0
  7. package/dist/api/analyzeVideo.js +136 -0
  8. package/dist/api/analyzeVideo.js.map +1 -0
  9. package/dist/api/detectScenes.d.ts +82 -0
  10. package/dist/api/detectScenes.d.ts.map +1 -0
  11. package/dist/api/detectScenes.js +67 -0
  12. package/dist/api/detectScenes.js.map +1 -0
  13. package/dist/api/generateImage.d.ts +7 -0
  14. package/dist/api/generateImage.d.ts.map +1 -1
  15. package/dist/api/generateImage.js +133 -9
  16. package/dist/api/generateImage.js.map +1 -1
  17. package/dist/api/generateMusic.d.ts +98 -0
  18. package/dist/api/generateMusic.d.ts.map +1 -0
  19. package/dist/api/generateMusic.js +319 -0
  20. package/dist/api/generateMusic.js.map +1 -0
  21. package/dist/api/generateSFX.d.ts +96 -0
  22. package/dist/api/generateSFX.d.ts.map +1 -0
  23. package/dist/api/generateSFX.js +317 -0
  24. package/dist/api/generateSFX.js.map +1 -0
  25. package/dist/api/generateVideo.d.ts +113 -0
  26. package/dist/api/generateVideo.d.ts.map +1 -0
  27. package/dist/api/generateVideo.js +342 -0
  28. package/dist/api/generateVideo.js.map +1 -0
  29. package/dist/api/model.d.ts.map +1 -1
  30. package/dist/api/model.js +8 -4
  31. package/dist/api/model.js.map +1 -1
  32. package/dist/api/performOCR.d.ts +169 -0
  33. package/dist/api/performOCR.d.ts.map +1 -0
  34. package/dist/api/performOCR.js +198 -0
  35. package/dist/api/performOCR.js.map +1 -0
  36. package/dist/api/provider-defaults.d.ts +7 -5
  37. package/dist/api/provider-defaults.d.ts.map +1 -1
  38. package/dist/api/provider-defaults.js +32 -10
  39. package/dist/api/provider-defaults.js.map +1 -1
  40. package/dist/api/strategies/debate.d.ts.map +1 -1
  41. package/dist/api/strategies/debate.js +1 -0
  42. package/dist/api/strategies/debate.js.map +1 -1
  43. package/dist/api/strategies/graph.d.ts.map +1 -1
  44. package/dist/api/strategies/graph.js +69 -13
  45. package/dist/api/strategies/graph.js.map +1 -1
  46. package/dist/api/strategies/hierarchical.d.ts.map +1 -1
  47. package/dist/api/strategies/hierarchical.js +1 -0
  48. package/dist/api/strategies/hierarchical.js.map +1 -1
  49. package/dist/api/strategies/parallel.d.ts.map +1 -1
  50. package/dist/api/strategies/parallel.js +1 -0
  51. package/dist/api/strategies/parallel.js.map +1 -1
  52. package/dist/api/strategies/review-loop.d.ts.map +1 -1
  53. package/dist/api/strategies/review-loop.js +1 -0
  54. package/dist/api/strategies/review-loop.js.map +1 -1
  55. package/dist/api/strategies/sequential.d.ts.map +1 -1
  56. package/dist/api/strategies/sequential.js +54 -48
  57. package/dist/api/strategies/sequential.js.map +1 -1
  58. package/dist/api/streamBuffer.d.ts +20 -0
  59. package/dist/api/streamBuffer.d.ts.map +1 -0
  60. package/dist/api/streamBuffer.js +81 -0
  61. package/dist/api/streamBuffer.js.map +1 -0
  62. package/dist/api/types.d.ts +145 -5
  63. package/dist/api/types.d.ts.map +1 -1
  64. package/dist/api/types.js.map +1 -1
  65. package/dist/channels/adapters/RedditChannelAdapter.js.map +1 -1
  66. package/dist/core/audio/AudioProcessor.d.ts.map +1 -1
  67. package/dist/core/audio/AudioProcessor.js +1 -0
  68. package/dist/core/audio/AudioProcessor.js.map +1 -1
  69. package/dist/core/audio/EnvironmentalCalibrator.d.ts.map +1 -1
  70. package/dist/core/audio/EnvironmentalCalibrator.js +1 -0
  71. package/dist/core/audio/EnvironmentalCalibrator.js.map +1 -1
  72. package/dist/core/audio/FallbackAudioProxy.d.ts +169 -0
  73. package/dist/core/audio/FallbackAudioProxy.d.ts.map +1 -0
  74. package/dist/core/audio/FallbackAudioProxy.js +236 -0
  75. package/dist/core/audio/FallbackAudioProxy.js.map +1 -0
  76. package/dist/core/audio/IAudioGenerator.d.ts +103 -0
  77. package/dist/core/audio/IAudioGenerator.d.ts.map +1 -0
  78. package/dist/core/audio/IAudioGenerator.js +24 -0
  79. package/dist/core/audio/IAudioGenerator.js.map +1 -0
  80. package/dist/core/audio/index.d.ts +54 -0
  81. package/dist/core/audio/index.d.ts.map +1 -1
  82. package/dist/core/audio/index.js +93 -0
  83. package/dist/core/audio/index.js.map +1 -1
  84. package/dist/core/audio/providers/AudioGenLocalProvider.d.ts +136 -0
  85. package/dist/core/audio/providers/AudioGenLocalProvider.d.ts.map +1 -0
  86. package/dist/core/audio/providers/AudioGenLocalProvider.js +235 -0
  87. package/dist/core/audio/providers/AudioGenLocalProvider.js.map +1 -0
  88. package/dist/core/audio/providers/ElevenLabsSFXProvider.d.ts +107 -0
  89. package/dist/core/audio/providers/ElevenLabsSFXProvider.d.ts.map +1 -0
  90. package/dist/core/audio/providers/ElevenLabsSFXProvider.js +154 -0
  91. package/dist/core/audio/providers/ElevenLabsSFXProvider.js.map +1 -0
  92. package/dist/core/audio/providers/FalAudioProvider.d.ts +207 -0
  93. package/dist/core/audio/providers/FalAudioProvider.d.ts.map +1 -0
  94. package/dist/core/audio/providers/FalAudioProvider.js +315 -0
  95. package/dist/core/audio/providers/FalAudioProvider.js.map +1 -0
  96. package/dist/core/audio/providers/MusicGenLocalProvider.d.ts +136 -0
  97. package/dist/core/audio/providers/MusicGenLocalProvider.d.ts.map +1 -0
  98. package/dist/core/audio/providers/MusicGenLocalProvider.js +235 -0
  99. package/dist/core/audio/providers/MusicGenLocalProvider.js.map +1 -0
  100. package/dist/core/audio/providers/ReplicateAudioProvider.d.ts +200 -0
  101. package/dist/core/audio/providers/ReplicateAudioProvider.d.ts.map +1 -0
  102. package/dist/core/audio/providers/ReplicateAudioProvider.js +346 -0
  103. package/dist/core/audio/providers/ReplicateAudioProvider.js.map +1 -0
  104. package/dist/core/audio/providers/StableAudioProvider.d.ts +138 -0
  105. package/dist/core/audio/providers/StableAudioProvider.d.ts.map +1 -0
  106. package/dist/core/audio/providers/StableAudioProvider.js +192 -0
  107. package/dist/core/audio/providers/StableAudioProvider.js.map +1 -0
  108. package/dist/core/audio/providers/SunoProvider.d.ts +182 -0
  109. package/dist/core/audio/providers/SunoProvider.d.ts.map +1 -0
  110. package/dist/core/audio/providers/SunoProvider.js +312 -0
  111. package/dist/core/audio/providers/SunoProvider.js.map +1 -0
  112. package/dist/core/audio/providers/UdioProvider.d.ts +177 -0
  113. package/dist/core/audio/providers/UdioProvider.d.ts.map +1 -0
  114. package/dist/core/audio/providers/UdioProvider.js +305 -0
  115. package/dist/core/audio/providers/UdioProvider.js.map +1 -0
  116. package/dist/core/audio/types.d.ts +257 -0
  117. package/dist/core/audio/types.d.ts.map +1 -0
  118. package/dist/core/audio/types.js +21 -0
  119. package/dist/core/audio/types.js.map +1 -0
  120. package/dist/core/images/FallbackImageProxy.d.ts +183 -0
  121. package/dist/core/images/FallbackImageProxy.d.ts.map +1 -0
  122. package/dist/core/images/FallbackImageProxy.js +283 -0
  123. package/dist/core/images/FallbackImageProxy.js.map +1 -0
  124. package/dist/core/images/IImageProvider.d.ts +1 -1
  125. package/dist/core/images/IImageProvider.d.ts.map +1 -1
  126. package/dist/core/images/index.d.ts +1 -0
  127. package/dist/core/images/index.d.ts.map +1 -1
  128. package/dist/core/images/index.js +1 -0
  129. package/dist/core/images/index.js.map +1 -1
  130. package/dist/core/llm/providers/AIModelProviderManager.d.ts +3 -1
  131. package/dist/core/llm/providers/AIModelProviderManager.d.ts.map +1 -1
  132. package/dist/core/llm/providers/AIModelProviderManager.js +8 -0
  133. package/dist/core/llm/providers/AIModelProviderManager.js.map +1 -1
  134. package/dist/core/llm/providers/errors/ClaudeCodeProviderError.d.ts +52 -0
  135. package/dist/core/llm/providers/errors/ClaudeCodeProviderError.d.ts.map +1 -0
  136. package/dist/core/llm/providers/errors/ClaudeCodeProviderError.js +36 -0
  137. package/dist/core/llm/providers/errors/ClaudeCodeProviderError.js.map +1 -0
  138. package/dist/core/llm/providers/errors/GeminiCLIProviderError.d.ts +32 -0
  139. package/dist/core/llm/providers/errors/GeminiCLIProviderError.d.ts.map +1 -0
  140. package/dist/core/llm/providers/errors/GeminiCLIProviderError.js +27 -0
  141. package/dist/core/llm/providers/errors/GeminiCLIProviderError.js.map +1 -0
  142. package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.d.ts +38 -0
  143. package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.d.ts.map +1 -0
  144. package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.js +128 -0
  145. package/dist/core/llm/providers/implementations/ClaudeCodeCLIBridge.js.map +1 -0
  146. package/dist/core/llm/providers/implementations/ClaudeCodeProvider.d.ts +107 -0
  147. package/dist/core/llm/providers/implementations/ClaudeCodeProvider.d.ts.map +1 -0
  148. package/dist/core/llm/providers/implementations/ClaudeCodeProvider.js +504 -0
  149. package/dist/core/llm/providers/implementations/ClaudeCodeProvider.js.map +1 -0
  150. package/dist/core/llm/providers/implementations/GeminiCLIBridge.d.ts +60 -0
  151. package/dist/core/llm/providers/implementations/GeminiCLIBridge.d.ts.map +1 -0
  152. package/dist/core/llm/providers/implementations/GeminiCLIBridge.js +177 -0
  153. package/dist/core/llm/providers/implementations/GeminiCLIBridge.js.map +1 -0
  154. package/dist/core/llm/providers/implementations/GeminiCLIProvider.d.ts +55 -0
  155. package/dist/core/llm/providers/implementations/GeminiCLIProvider.d.ts.map +1 -0
  156. package/dist/core/llm/providers/implementations/GeminiCLIProvider.js +447 -0
  157. package/dist/core/llm/providers/implementations/GeminiCLIProvider.js.map +1 -0
  158. package/dist/core/media/ProviderPreferences.d.ts +158 -0
  159. package/dist/core/media/ProviderPreferences.d.ts.map +1 -0
  160. package/dist/core/media/ProviderPreferences.js +183 -0
  161. package/dist/core/media/ProviderPreferences.js.map +1 -0
  162. package/dist/core/subprocess/CLIRegistry.d.ts +71 -0
  163. package/dist/core/subprocess/CLIRegistry.d.ts.map +1 -0
  164. package/dist/core/subprocess/CLIRegistry.js +210 -0
  165. package/dist/core/subprocess/CLIRegistry.js.map +1 -0
  166. package/dist/core/subprocess/CLISubprocessBridge.d.ts +117 -0
  167. package/dist/core/subprocess/CLISubprocessBridge.d.ts.map +1 -0
  168. package/dist/core/subprocess/CLISubprocessBridge.js +199 -0
  169. package/dist/core/subprocess/CLISubprocessBridge.js.map +1 -0
  170. package/dist/core/subprocess/errors.d.ts +76 -0
  171. package/dist/core/subprocess/errors.d.ts.map +1 -0
  172. package/dist/core/subprocess/errors.js +75 -0
  173. package/dist/core/subprocess/errors.js.map +1 -0
  174. package/dist/core/subprocess/index.d.ts +11 -0
  175. package/dist/core/subprocess/index.d.ts.map +1 -0
  176. package/dist/core/subprocess/index.js +10 -0
  177. package/dist/core/subprocess/index.js.map +1 -0
  178. package/dist/core/subprocess/types.d.ts +100 -0
  179. package/dist/core/subprocess/types.d.ts.map +1 -0
  180. package/dist/core/subprocess/types.js +9 -0
  181. package/dist/core/subprocess/types.js.map +1 -0
  182. package/dist/core/video/FallbackVideoProxy.d.ts +166 -0
  183. package/dist/core/video/FallbackVideoProxy.d.ts.map +1 -0
  184. package/dist/core/video/FallbackVideoProxy.js +228 -0
  185. package/dist/core/video/FallbackVideoProxy.js.map +1 -0
  186. package/dist/core/video/IVideoAnalyzer.d.ts +29 -0
  187. package/dist/core/video/IVideoAnalyzer.d.ts.map +1 -0
  188. package/dist/core/video/IVideoAnalyzer.js +12 -0
  189. package/dist/core/video/IVideoAnalyzer.js.map +1 -0
  190. package/dist/core/video/IVideoGenerator.d.ts +76 -0
  191. package/dist/core/video/IVideoGenerator.d.ts.map +1 -0
  192. package/dist/core/video/IVideoGenerator.js +13 -0
  193. package/dist/core/video/IVideoGenerator.js.map +1 -0
  194. package/dist/core/video/VideoAnalyzer.d.ts +278 -0
  195. package/dist/core/video/VideoAnalyzer.d.ts.map +1 -0
  196. package/dist/core/video/VideoAnalyzer.js +648 -0
  197. package/dist/core/video/VideoAnalyzer.js.map +1 -0
  198. package/dist/core/video/index.d.ts +55 -0
  199. package/dist/core/video/index.d.ts.map +1 -0
  200. package/dist/core/video/index.js +78 -0
  201. package/dist/core/video/index.js.map +1 -0
  202. package/dist/core/video/providers/FalVideoProvider.d.ts +195 -0
  203. package/dist/core/video/providers/FalVideoProvider.d.ts.map +1 -0
  204. package/dist/core/video/providers/FalVideoProvider.js +322 -0
  205. package/dist/core/video/providers/FalVideoProvider.js.map +1 -0
  206. package/dist/core/video/providers/ReplicateVideoProvider.d.ts +194 -0
  207. package/dist/core/video/providers/ReplicateVideoProvider.d.ts.map +1 -0
  208. package/dist/core/video/providers/ReplicateVideoProvider.js +356 -0
  209. package/dist/core/video/providers/ReplicateVideoProvider.js.map +1 -0
  210. package/dist/core/video/providers/RunwayVideoProvider.d.ts +175 -0
  211. package/dist/core/video/providers/RunwayVideoProvider.d.ts.map +1 -0
  212. package/dist/core/video/providers/RunwayVideoProvider.js +293 -0
  213. package/dist/core/video/providers/RunwayVideoProvider.js.map +1 -0
  214. package/dist/core/video/types.d.ts +441 -0
  215. package/dist/core/video/types.d.ts.map +1 -0
  216. package/dist/core/video/types.js +10 -0
  217. package/dist/core/video/types.js.map +1 -0
  218. package/dist/core/vision/SceneDetector.d.ts +180 -0
  219. package/dist/core/vision/SceneDetector.d.ts.map +1 -0
  220. package/dist/core/vision/SceneDetector.js +366 -0
  221. package/dist/core/vision/SceneDetector.js.map +1 -0
  222. package/dist/core/vision/index.d.ts +2 -1
  223. package/dist/core/vision/index.d.ts.map +1 -1
  224. package/dist/core/vision/index.js +1 -0
  225. package/dist/core/vision/index.js.map +1 -1
  226. package/dist/core/vision/types.d.ts +125 -0
  227. package/dist/core/vision/types.d.ts.map +1 -1
  228. package/dist/discovery/CapabilityDiscoveryEngine.d.ts +32 -0
  229. package/dist/discovery/CapabilityDiscoveryEngine.d.ts.map +1 -1
  230. package/dist/discovery/CapabilityDiscoveryEngine.js +46 -0
  231. package/dist/discovery/CapabilityDiscoveryEngine.js.map +1 -1
  232. package/dist/extensions/MultiRegistryLoader.js.map +1 -1
  233. package/dist/index.d.ts +17 -2
  234. package/dist/index.d.ts.map +1 -1
  235. package/dist/index.js +12 -0
  236. package/dist/index.js.map +1 -1
  237. package/dist/memory/CognitiveMemoryManager.d.ts +40 -0
  238. package/dist/memory/CognitiveMemoryManager.d.ts.map +1 -1
  239. package/dist/memory/CognitiveMemoryManager.js +54 -1
  240. package/dist/memory/CognitiveMemoryManager.js.map +1 -1
  241. package/dist/memory/facade/Memory.d.ts +4 -0
  242. package/dist/memory/facade/Memory.d.ts.map +1 -1
  243. package/dist/memory/facade/Memory.js +140 -4
  244. package/dist/memory/facade/Memory.js.map +1 -1
  245. package/dist/memory/facade/types.d.ts +30 -2
  246. package/dist/memory/facade/types.d.ts.map +1 -1
  247. package/dist/memory/index.d.ts +1 -0
  248. package/dist/memory/index.d.ts.map +1 -1
  249. package/dist/memory/index.js +1 -0
  250. package/dist/memory/index.js.map +1 -1
  251. package/dist/memory/types.d.ts +15 -0
  252. package/dist/memory/types.d.ts.map +1 -1
  253. package/dist/query-router/QueryClassifier.d.ts +192 -21
  254. package/dist/query-router/QueryClassifier.d.ts.map +1 -1
  255. package/dist/query-router/QueryClassifier.js +604 -23
  256. package/dist/query-router/QueryClassifier.js.map +1 -1
  257. package/dist/query-router/QueryDispatcher.d.ts +106 -8
  258. package/dist/query-router/QueryDispatcher.d.ts.map +1 -1
  259. package/dist/query-router/QueryDispatcher.js +387 -8
  260. package/dist/query-router/QueryDispatcher.js.map +1 -1
  261. package/dist/query-router/QueryRouter.d.ts +198 -14
  262. package/dist/query-router/QueryRouter.d.ts.map +1 -1
  263. package/dist/query-router/QueryRouter.js +738 -50
  264. package/dist/query-router/QueryRouter.js.map +1 -1
  265. package/dist/query-router/index.d.ts +1 -1
  266. package/dist/query-router/index.d.ts.map +1 -1
  267. package/dist/query-router/index.js +1 -1
  268. package/dist/query-router/index.js.map +1 -1
  269. package/dist/query-router/types.d.ts +396 -3
  270. package/dist/query-router/types.d.ts.map +1 -1
  271. package/dist/query-router/types.js +35 -0
  272. package/dist/query-router/types.js.map +1 -1
  273. package/dist/rag/HydeRetriever.d.ts +108 -0
  274. package/dist/rag/HydeRetriever.d.ts.map +1 -1
  275. package/dist/rag/HydeRetriever.js +184 -0
  276. package/dist/rag/HydeRetriever.js.map +1 -1
  277. package/dist/rag/IRetrievalAugmentor.d.ts +15 -0
  278. package/dist/rag/IRetrievalAugmentor.d.ts.map +1 -1
  279. package/dist/rag/RetrievalAugmentor.d.ts +58 -0
  280. package/dist/rag/RetrievalAugmentor.d.ts.map +1 -1
  281. package/dist/rag/RetrievalAugmentor.js +200 -32
  282. package/dist/rag/RetrievalAugmentor.js.map +1 -1
  283. package/dist/rag/VectorStoreManager.js +1 -1
  284. package/dist/rag/audit/RAGAuditCollector.d.ts +7 -0
  285. package/dist/rag/audit/RAGAuditCollector.d.ts.map +1 -1
  286. package/dist/rag/audit/RAGAuditCollector.js +10 -0
  287. package/dist/rag/audit/RAGAuditCollector.js.map +1 -1
  288. package/dist/rag/audit/RAGAuditTypes.d.ts +10 -1
  289. package/dist/rag/audit/RAGAuditTypes.d.ts.map +1 -1
  290. package/dist/rag/chunking/SemanticChunker.d.ts +210 -0
  291. package/dist/rag/chunking/SemanticChunker.d.ts.map +1 -0
  292. package/dist/rag/chunking/SemanticChunker.js +460 -0
  293. package/dist/rag/chunking/SemanticChunker.js.map +1 -0
  294. package/dist/rag/chunking/index.d.ts +10 -0
  295. package/dist/rag/chunking/index.d.ts.map +1 -0
  296. package/dist/rag/chunking/index.js +10 -0
  297. package/dist/rag/chunking/index.js.map +1 -0
  298. package/dist/rag/implementations/vector_stores/PineconeVectorStore.d.ts +103 -0
  299. package/dist/rag/implementations/vector_stores/PineconeVectorStore.d.ts.map +1 -0
  300. package/dist/rag/implementations/vector_stores/PineconeVectorStore.js +315 -0
  301. package/dist/rag/implementations/vector_stores/PineconeVectorStore.js.map +1 -0
  302. package/dist/rag/implementations/vector_stores/PostgresVectorStore.d.ts +107 -0
  303. package/dist/rag/implementations/vector_stores/PostgresVectorStore.d.ts.map +1 -0
  304. package/dist/rag/implementations/vector_stores/PostgresVectorStore.js +438 -0
  305. package/dist/rag/implementations/vector_stores/PostgresVectorStore.js.map +1 -0
  306. package/dist/rag/index.d.ts +15 -1
  307. package/dist/rag/index.d.ts.map +1 -1
  308. package/dist/rag/index.js +32 -0
  309. package/dist/rag/index.js.map +1 -1
  310. package/dist/rag/migration/MigrationEngine.d.ts +47 -0
  311. package/dist/rag/migration/MigrationEngine.d.ts.map +1 -0
  312. package/dist/rag/migration/MigrationEngine.js +168 -0
  313. package/dist/rag/migration/MigrationEngine.js.map +1 -0
  314. package/dist/rag/migration/adapters/PineconeSourceAdapter.d.ts +23 -0
  315. package/dist/rag/migration/adapters/PineconeSourceAdapter.d.ts.map +1 -0
  316. package/dist/rag/migration/adapters/PineconeSourceAdapter.js +63 -0
  317. package/dist/rag/migration/adapters/PineconeSourceAdapter.js.map +1 -0
  318. package/dist/rag/migration/adapters/PostgresSourceAdapter.d.ts +30 -0
  319. package/dist/rag/migration/adapters/PostgresSourceAdapter.d.ts.map +1 -0
  320. package/dist/rag/migration/adapters/PostgresSourceAdapter.js +71 -0
  321. package/dist/rag/migration/adapters/PostgresSourceAdapter.js.map +1 -0
  322. package/dist/rag/migration/adapters/PostgresTargetAdapter.d.ts +38 -0
  323. package/dist/rag/migration/adapters/PostgresTargetAdapter.d.ts.map +1 -0
  324. package/dist/rag/migration/adapters/PostgresTargetAdapter.js +114 -0
  325. package/dist/rag/migration/adapters/PostgresTargetAdapter.js.map +1 -0
  326. package/dist/rag/migration/adapters/QdrantSourceAdapter.d.ts +36 -0
  327. package/dist/rag/migration/adapters/QdrantSourceAdapter.d.ts.map +1 -0
  328. package/dist/rag/migration/adapters/QdrantSourceAdapter.js +109 -0
  329. package/dist/rag/migration/adapters/QdrantSourceAdapter.js.map +1 -0
  330. package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts +35 -0
  331. package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts.map +1 -0
  332. package/dist/rag/migration/adapters/QdrantTargetAdapter.js +110 -0
  333. package/dist/rag/migration/adapters/QdrantTargetAdapter.js.map +1 -0
  334. package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts +37 -0
  335. package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts.map +1 -0
  336. package/dist/rag/migration/adapters/SqliteSourceAdapter.js +72 -0
  337. package/dist/rag/migration/adapters/SqliteSourceAdapter.js.map +1 -0
  338. package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts +47 -0
  339. package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts.map +1 -0
  340. package/dist/rag/migration/adapters/SqliteTargetAdapter.js +93 -0
  341. package/dist/rag/migration/adapters/SqliteTargetAdapter.js.map +1 -0
  342. package/dist/rag/migration/types.d.ts +108 -0
  343. package/dist/rag/migration/types.d.ts.map +1 -0
  344. package/dist/rag/migration/types.js +11 -0
  345. package/dist/rag/migration/types.js.map +1 -0
  346. package/dist/rag/multimodal/MultimodalIndexer.d.ts +35 -0
  347. package/dist/rag/multimodal/MultimodalIndexer.d.ts.map +1 -1
  348. package/dist/rag/multimodal/MultimodalIndexer.js +66 -1
  349. package/dist/rag/multimodal/MultimodalIndexer.js.map +1 -1
  350. package/dist/rag/multimodal/types.d.ts +24 -0
  351. package/dist/rag/multimodal/types.d.ts.map +1 -1
  352. package/dist/rag/raptor/RaptorTree.d.ts +268 -0
  353. package/dist/rag/raptor/RaptorTree.d.ts.map +1 -0
  354. package/dist/rag/raptor/RaptorTree.js +443 -0
  355. package/dist/rag/raptor/RaptorTree.js.map +1 -0
  356. package/dist/rag/raptor/index.d.ts +11 -0
  357. package/dist/rag/raptor/index.d.ts.map +1 -0
  358. package/dist/rag/raptor/index.js +11 -0
  359. package/dist/rag/raptor/index.js.map +1 -0
  360. package/dist/rag/reranking/providers/CohereReranker.js.map +1 -1
  361. package/dist/rag/search/BM25Index.d.ts +282 -0
  362. package/dist/rag/search/BM25Index.d.ts.map +1 -0
  363. package/dist/rag/search/BM25Index.js +344 -0
  364. package/dist/rag/search/BM25Index.js.map +1 -0
  365. package/dist/rag/search/HybridSearcher.d.ts +198 -0
  366. package/dist/rag/search/HybridSearcher.d.ts.map +1 -0
  367. package/dist/rag/search/HybridSearcher.js +316 -0
  368. package/dist/rag/search/HybridSearcher.js.map +1 -0
  369. package/dist/rag/search/index.d.ts +12 -0
  370. package/dist/rag/search/index.d.ts.map +1 -0
  371. package/dist/rag/search/index.js +12 -0
  372. package/dist/rag/search/index.js.map +1 -0
  373. package/dist/rag/setup/DockerDetector.d.ts +67 -0
  374. package/dist/rag/setup/DockerDetector.d.ts.map +1 -0
  375. package/dist/rag/setup/DockerDetector.js +125 -0
  376. package/dist/rag/setup/DockerDetector.js.map +1 -0
  377. package/dist/rag/setup/PostgresSetup.d.ts +20 -0
  378. package/dist/rag/setup/PostgresSetup.d.ts.map +1 -0
  379. package/dist/rag/setup/PostgresSetup.js +133 -0
  380. package/dist/rag/setup/PostgresSetup.js.map +1 -0
  381. package/dist/rag/setup/QdrantSetup.d.ts +26 -0
  382. package/dist/rag/setup/QdrantSetup.d.ts.map +1 -0
  383. package/dist/rag/setup/QdrantSetup.js +96 -0
  384. package/dist/rag/setup/QdrantSetup.js.map +1 -0
  385. package/dist/rag/setup/types.d.ts +55 -0
  386. package/dist/rag/setup/types.d.ts.map +1 -0
  387. package/dist/rag/setup/types.js +6 -0
  388. package/dist/rag/setup/types.js.map +1 -0
  389. package/dist/rag/unified/UnifiedRetriever.d.ts +472 -0
  390. package/dist/rag/unified/UnifiedRetriever.d.ts.map +1 -0
  391. package/dist/rag/unified/UnifiedRetriever.js +887 -0
  392. package/dist/rag/unified/UnifiedRetriever.js.map +1 -0
  393. package/dist/rag/unified/index.d.ts +24 -0
  394. package/dist/rag/unified/index.d.ts.map +1 -0
  395. package/dist/rag/unified/index.js +23 -0
  396. package/dist/rag/unified/index.js.map +1 -0
  397. package/dist/rag/unified/types.d.ts +546 -0
  398. package/dist/rag/unified/types.d.ts.map +1 -0
  399. package/dist/rag/unified/types.js +177 -0
  400. package/dist/rag/unified/types.js.map +1 -0
  401. package/dist/speech/providers/AssemblyAISTTProvider.js.map +1 -1
  402. package/dist/speech/providers/AzureSpeechSTTProvider.js.map +1 -1
  403. package/dist/speech/providers/BuiltInAdaptiveVadProvider.d.ts +1 -1
  404. package/dist/speech/providers/DeepgramBatchSTTProvider.js.map +1 -1
  405. package/package.json +5 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SemanticChunker.js","sourceRoot":"","sources":["../../../src/rag/chunking/SemanticChunker.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @fileoverview Semantic chunking module for boundary-aware text splitting.
3
+ *
4
+ * Exports:
5
+ * - {@link SemanticChunker} — Splits text on heading/paragraph/sentence boundaries
6
+ *
7
+ * @module agentos/rag/chunking
8
+ */
9
+ export { SemanticChunker, type SemanticChunkerConfig, type SemanticChunk, type BoundaryType, } from './SemanticChunker.js';
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rag/chunking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @fileoverview Semantic chunking module for boundary-aware text splitting.
3
+ *
4
+ * Exports:
5
+ * - {@link SemanticChunker} — Splits text on heading/paragraph/sentence boundaries
6
+ *
7
+ * @module agentos/rag/chunking
8
+ */
9
+ export { SemanticChunker, } from './SemanticChunker.js';
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rag/chunking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,GAIhB,MAAM,sBAAsB,CAAC"}
@@ -0,0 +1,103 @@
1
+ /**
2
+ * @fileoverview Pinecone Vector Store Implementation.
3
+ * @module rag/implementations/vector_stores/PineconeVectorStore
4
+ *
5
+ * Implements `IVectorStore` using Pinecone's REST API via native `fetch`.
6
+ * No SDK dependency — works in any runtime that supports fetch (Node 18+,
7
+ * Deno, Bun, edge runtimes).
8
+ *
9
+ * Features:
10
+ * - Dense vector upsert/query via Pinecone Data Plane API
11
+ * - Metadata filtering via Pinecone's filter syntax
12
+ * - Namespace-based collection isolation
13
+ * - Serverless and pod-based index support
14
+ *
15
+ * Pinecone API docs: https://docs.pinecone.io/reference/api
16
+ *
17
+ * @see ../../IVectorStore.ts for the interface definition.
18
+ */
19
+ import type { IVectorStore, VectorStoreProviderConfig, VectorDocument, QueryOptions, QueryResult, UpsertOptions, UpsertResult, DeleteOptions, DeleteResult, CreateCollectionOptions } from '../../IVectorStore.js';
20
+ /** Configuration specific to Pinecone. */
21
+ export interface PineconeVectorStoreConfig extends VectorStoreProviderConfig {
22
+ type: 'pinecone';
23
+ /** Pinecone API key. Required. */
24
+ apiKey: string;
25
+ /**
26
+ * Pinecone index host URL (e.g. 'https://my-index-abc123.svc.aped-1234.pinecone.io').
27
+ * This is the Data Plane endpoint for a specific index — NOT the control plane URL.
28
+ * Find it in the Pinecone console under your index details.
29
+ */
30
+ indexHost: string;
31
+ /** Default namespace for operations. @default '' (default namespace) */
32
+ namespace?: string;
33
+ /** Default embedding dimensions. @default 1536 */
34
+ defaultDimension?: number;
35
+ }
36
+ export declare class PineconeVectorStore implements IVectorStore {
37
+ private config;
38
+ private isInitialized;
39
+ constructor(config: PineconeVectorStoreConfig);
40
+ /** Verify connectivity by calling the describe index stats endpoint. */
41
+ initialize(): Promise<void>;
42
+ /** No-op — Pinecone is cloud-managed. */
43
+ close(): Promise<void>;
44
+ /** Gracefully shut down the store (alias for close). */
45
+ shutdown(): Promise<void>;
46
+ /** Health check — verify index is reachable (legacy). */
47
+ healthCheck(): Promise<boolean>;
48
+ /** IVectorStore-compliant health check. */
49
+ checkHealth(): Promise<{
50
+ isHealthy: boolean;
51
+ details?: any;
52
+ }>;
53
+ /**
54
+ * Create a "collection" — in Pinecone this maps to a namespace.
55
+ * Namespaces are created implicitly on first upsert, so this is a no-op.
56
+ */
57
+ createCollection(_name: string, _dimension: number, _options?: CreateCollectionOptions): Promise<void>;
58
+ /**
59
+ * Drop a "collection" — deletes all vectors in the namespace.
60
+ */
61
+ dropCollection(name: string): Promise<void>;
62
+ /**
63
+ * Upsert vectors into Pinecone.
64
+ * Batches automatically in chunks of 100 (Pinecone's max batch size).
65
+ */
66
+ upsert(collectionName: string, documents: VectorDocument[], _options?: UpsertOptions): Promise<UpsertResult>;
67
+ /**
68
+ * Query for top-K nearest neighbors via Pinecone's query endpoint.
69
+ * Supports metadata filtering via Pinecone's native filter syntax.
70
+ */
71
+ query(collectionName: string, queryEmbedding: number[], options?: QueryOptions): Promise<QueryResult>;
72
+ /**
73
+ * Hybrid search is not natively supported by Pinecone in a single call.
74
+ * Falls back to dense-only query. For true hybrid search, use Postgres
75
+ * or Qdrant backends which support server-side RRF fusion.
76
+ */
77
+ hybridSearch(collectionName: string, queryEmbedding: number[], _queryText: string, options?: QueryOptions): Promise<QueryResult>;
78
+ /** Delete vectors by ID or delete all in namespace. */
79
+ delete(collectionName: string, ids?: string[], options?: DeleteOptions): Promise<DeleteResult>;
80
+ /** Ensure initialization before operations. */
81
+ private _ensureInit;
82
+ /**
83
+ * Make a fetch request to the Pinecone Data Plane API.
84
+ * Automatically sets Authorization header and Content-Type.
85
+ */
86
+ private _fetch;
87
+ /**
88
+ * Flatten metadata to Pinecone-compatible format.
89
+ * Pinecone metadata values must be string, number, boolean, or string[].
90
+ * Complex objects are JSON-stringified.
91
+ */
92
+ private _flattenMetadata;
93
+ /**
94
+ * Translate AgentOS MetadataFilter to Pinecone's filter format.
95
+ *
96
+ * Pinecone uses MongoDB-style operators:
97
+ * `{ "field": { "$eq": "value" } }`
98
+ *
99
+ * @see https://docs.pinecone.io/guides/data/filter-with-metadata
100
+ */
101
+ private _buildPineconeFilter;
102
+ }
103
+ //# sourceMappingURL=PineconeVectorStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PineconeVectorStore.d.ts","sourceRoot":"","sources":["../../../../src/rag/implementations/vector_stores/PineconeVectorStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EAEd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EAIxB,MAAM,uBAAuB,CAAC;AAM/B,0CAA0C;AAC1C,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,yBAAyB;IAQ7C,wEAAwE;IAClE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,yCAAyC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,yDAAyD;IACnD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,2CAA2C;IACrC,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IASnE;;;OAGG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,uBAAuB,GACjC,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD;;;OAGG;IACG,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,cAAc,EAAE,EAC3B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IA6CxB;;;OAGG;IACG,KAAK,CACT,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IA4DvB;;;;OAIG;IACG,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAWvB,uDAAuD;IACjD,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,GAAG,CAAC,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAkCxB,+CAA+C;YACjC,WAAW;IAIzB;;;OAGG;YACW,MAAM;IAepB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAkC7B"}
@@ -0,0 +1,315 @@
1
+ /**
2
+ * @fileoverview Pinecone Vector Store Implementation.
3
+ * @module rag/implementations/vector_stores/PineconeVectorStore
4
+ *
5
+ * Implements `IVectorStore` using Pinecone's REST API via native `fetch`.
6
+ * No SDK dependency — works in any runtime that supports fetch (Node 18+,
7
+ * Deno, Bun, edge runtimes).
8
+ *
9
+ * Features:
10
+ * - Dense vector upsert/query via Pinecone Data Plane API
11
+ * - Metadata filtering via Pinecone's filter syntax
12
+ * - Namespace-based collection isolation
13
+ * - Serverless and pod-based index support
14
+ *
15
+ * Pinecone API docs: https://docs.pinecone.io/reference/api
16
+ *
17
+ * @see ../../IVectorStore.ts for the interface definition.
18
+ */
19
+ // ---------------------------------------------------------------------------
20
+ // PineconeVectorStore
21
+ // ---------------------------------------------------------------------------
22
+ export class PineconeVectorStore {
23
+ constructor(config) {
24
+ this.isInitialized = false;
25
+ this.config = config;
26
+ }
27
+ // =========================================================================
28
+ // Lifecycle
29
+ // =========================================================================
30
+ /** Verify connectivity by calling the describe index stats endpoint. */
31
+ async initialize() {
32
+ if (this.isInitialized)
33
+ return;
34
+ // Ping the index to verify API key and host are correct.
35
+ const res = await this._fetch('/describe_index_stats', { method: 'POST', body: '{}' });
36
+ if (!res.ok) {
37
+ const body = await res.text().catch(() => 'unknown error');
38
+ throw new Error(`Pinecone initialization failed (${res.status}): ${body}`);
39
+ }
40
+ this.isInitialized = true;
41
+ }
42
+ /** No-op — Pinecone is cloud-managed. */
43
+ async close() {
44
+ this.isInitialized = false;
45
+ }
46
+ /** Gracefully shut down the store (alias for close). */
47
+ async shutdown() {
48
+ await this.close();
49
+ }
50
+ /** Health check — verify index is reachable (legacy). */
51
+ async healthCheck() {
52
+ try {
53
+ const res = await this._fetch('/describe_index_stats', { method: 'POST', body: '{}' });
54
+ return res.ok;
55
+ }
56
+ catch {
57
+ return false;
58
+ }
59
+ }
60
+ /** IVectorStore-compliant health check. */
61
+ async checkHealth() {
62
+ const isHealthy = await this.healthCheck();
63
+ return { isHealthy };
64
+ }
65
+ // =========================================================================
66
+ // Collection Management (mapped to Pinecone namespaces)
67
+ // =========================================================================
68
+ /**
69
+ * Create a "collection" — in Pinecone this maps to a namespace.
70
+ * Namespaces are created implicitly on first upsert, so this is a no-op.
71
+ */
72
+ async createCollection(_name, _dimension, _options) {
73
+ await this._ensureInit();
74
+ // Pinecone namespaces are created implicitly. Nothing to do.
75
+ }
76
+ /**
77
+ * Drop a "collection" — deletes all vectors in the namespace.
78
+ */
79
+ async dropCollection(name) {
80
+ await this._ensureInit();
81
+ const ns = name || this.config.namespace || '';
82
+ await this._fetch('/vectors/delete', {
83
+ method: 'POST',
84
+ body: JSON.stringify({ deleteAll: true, namespace: ns }),
85
+ });
86
+ }
87
+ // =========================================================================
88
+ // Upsert
89
+ // =========================================================================
90
+ /**
91
+ * Upsert vectors into Pinecone.
92
+ * Batches automatically in chunks of 100 (Pinecone's max batch size).
93
+ */
94
+ async upsert(collectionName, documents, _options) {
95
+ await this._ensureInit();
96
+ const ns = collectionName || this.config.namespace || '';
97
+ const batchSize = 100; // Pinecone max vectors per upsert request.
98
+ let successCount = 0;
99
+ const failedIds = [];
100
+ for (let i = 0; i < documents.length; i += batchSize) {
101
+ const batch = documents.slice(i, i + batchSize);
102
+ const vectors = batch.map(doc => ({
103
+ id: doc.id,
104
+ values: doc.embedding,
105
+ metadata: doc.metadata
106
+ ? this._flattenMetadata(doc.metadata)
107
+ : undefined,
108
+ }));
109
+ try {
110
+ const res = await this._fetch('/vectors/upsert', {
111
+ method: 'POST',
112
+ body: JSON.stringify({ vectors, namespace: ns }),
113
+ });
114
+ if (res.ok) {
115
+ const data = await res.json();
116
+ successCount += data.upsertedCount ?? batch.length;
117
+ }
118
+ else {
119
+ failedIds.push(...batch.map(d => d.id));
120
+ }
121
+ }
122
+ catch {
123
+ failedIds.push(...batch.map(d => d.id));
124
+ }
125
+ }
126
+ return {
127
+ upsertedCount: successCount,
128
+ upsertedIds: documents.map(d => d.id),
129
+ failedCount: failedIds.length,
130
+ };
131
+ }
132
+ // =========================================================================
133
+ // Query
134
+ // =========================================================================
135
+ /**
136
+ * Query for top-K nearest neighbors via Pinecone's query endpoint.
137
+ * Supports metadata filtering via Pinecone's native filter syntax.
138
+ */
139
+ async query(collectionName, queryEmbedding, options) {
140
+ await this._ensureInit();
141
+ const ns = collectionName || this.config.namespace || '';
142
+ const topK = options?.topK ?? 10;
143
+ const body = {
144
+ vector: queryEmbedding,
145
+ topK,
146
+ namespace: ns,
147
+ includeMetadata: options?.includeMetadata !== false,
148
+ includeValues: options?.includeEmbedding ?? false,
149
+ };
150
+ // Translate MetadataFilter to Pinecone's filter format.
151
+ if (options?.filter) {
152
+ body.filter = this._buildPineconeFilter(options.filter);
153
+ }
154
+ const res = await this._fetch('/query', {
155
+ method: 'POST',
156
+ body: JSON.stringify(body),
157
+ });
158
+ if (!res.ok) {
159
+ const text = await res.text().catch(() => '');
160
+ throw new Error(`Pinecone query failed (${res.status}): ${text}`);
161
+ }
162
+ const data = await res.json();
163
+ const documents = (data.matches ?? []).map(m => {
164
+ const doc = {
165
+ id: m.id,
166
+ similarityScore: m.score ?? 0,
167
+ embedding: m.values ?? [],
168
+ };
169
+ if (m.metadata && options?.includeMetadata !== false) {
170
+ doc.metadata = m.metadata;
171
+ }
172
+ return doc;
173
+ });
174
+ return {
175
+ documents,
176
+ queryId: `pinecone-${Date.now()}`,
177
+ stats: {
178
+ totalCandidates: documents.length,
179
+ filteredCandidates: documents.length,
180
+ returnedCount: documents.length,
181
+ },
182
+ };
183
+ }
184
+ /**
185
+ * Hybrid search is not natively supported by Pinecone in a single call.
186
+ * Falls back to dense-only query. For true hybrid search, use Postgres
187
+ * or Qdrant backends which support server-side RRF fusion.
188
+ */
189
+ async hybridSearch(collectionName, queryEmbedding, _queryText, options) {
190
+ // Pinecone supports sparse vectors for hybrid, but requires a separate
191
+ // sparse encoder (e.g., SPLADE). For simplicity, fall back to dense-only.
192
+ // TODO: Add sparse vector support when Pinecone's sparse API stabilizes.
193
+ return this.query(collectionName, queryEmbedding, options);
194
+ }
195
+ // =========================================================================
196
+ // Delete
197
+ // =========================================================================
198
+ /** Delete vectors by ID or delete all in namespace. */
199
+ async delete(collectionName, ids, options) {
200
+ await this._ensureInit();
201
+ const ns = collectionName || this.config.namespace || '';
202
+ if (options?.deleteAll) {
203
+ await this._fetch('/vectors/delete', {
204
+ method: 'POST',
205
+ body: JSON.stringify({ deleteAll: true, namespace: ns }),
206
+ });
207
+ return { deletedCount: -1 }; // Pinecone doesn't return count on deleteAll.
208
+ }
209
+ if (ids && ids.length > 0) {
210
+ // Pinecone supports up to 1000 IDs per delete.
211
+ const batchSize = 1000;
212
+ let deleted = 0;
213
+ for (let i = 0; i < ids.length; i += batchSize) {
214
+ const batch = ids.slice(i, i + batchSize);
215
+ const res = await this._fetch('/vectors/delete', {
216
+ method: 'POST',
217
+ body: JSON.stringify({ ids: batch, namespace: ns }),
218
+ });
219
+ if (res.ok)
220
+ deleted += batch.length;
221
+ }
222
+ return { deletedCount: deleted };
223
+ }
224
+ return { deletedCount: 0 };
225
+ }
226
+ // =========================================================================
227
+ // Internals
228
+ // =========================================================================
229
+ /** Ensure initialization before operations. */
230
+ async _ensureInit() {
231
+ if (!this.isInitialized)
232
+ await this.initialize();
233
+ }
234
+ /**
235
+ * Make a fetch request to the Pinecone Data Plane API.
236
+ * Automatically sets Authorization header and Content-Type.
237
+ */
238
+ async _fetch(path, init) {
239
+ const url = `${this.config.indexHost.replace(/\/+$/, '')}${path}`;
240
+ return fetch(url, {
241
+ method: init.method,
242
+ headers: {
243
+ 'Api-Key': this.config.apiKey,
244
+ 'Content-Type': 'application/json',
245
+ },
246
+ body: init.body,
247
+ });
248
+ }
249
+ /**
250
+ * Flatten metadata to Pinecone-compatible format.
251
+ * Pinecone metadata values must be string, number, boolean, or string[].
252
+ * Complex objects are JSON-stringified.
253
+ */
254
+ _flattenMetadata(metadata) {
255
+ const flat = {};
256
+ for (const [key, val] of Object.entries(metadata)) {
257
+ if (typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean') {
258
+ flat[key] = val;
259
+ }
260
+ else if (Array.isArray(val)) {
261
+ flat[key] = val.map(String);
262
+ }
263
+ else {
264
+ flat[key] = JSON.stringify(val);
265
+ }
266
+ }
267
+ return flat;
268
+ }
269
+ /**
270
+ * Translate AgentOS MetadataFilter to Pinecone's filter format.
271
+ *
272
+ * Pinecone uses MongoDB-style operators:
273
+ * `{ "field": { "$eq": "value" } }`
274
+ *
275
+ * @see https://docs.pinecone.io/guides/data/filter-with-metadata
276
+ */
277
+ _buildPineconeFilter(filter) {
278
+ const conditions = [];
279
+ for (const [field, condition] of Object.entries(filter)) {
280
+ // Direct scalar match (implicit $eq).
281
+ if (typeof condition !== 'object' || condition === null) {
282
+ conditions.push({ [field]: { $eq: condition } });
283
+ continue;
284
+ }
285
+ const cond = condition;
286
+ const fieldConditions = {};
287
+ if (cond.$eq !== undefined)
288
+ fieldConditions.$eq = cond.$eq;
289
+ if (cond.$ne !== undefined)
290
+ fieldConditions.$ne = cond.$ne;
291
+ if (cond.$gt !== undefined)
292
+ fieldConditions.$gt = cond.$gt;
293
+ if (cond.$gte !== undefined)
294
+ fieldConditions.$gte = cond.$gte;
295
+ if (cond.$lt !== undefined)
296
+ fieldConditions.$lt = cond.$lt;
297
+ if (cond.$lte !== undefined)
298
+ fieldConditions.$lte = cond.$lte;
299
+ if (cond.$in !== undefined)
300
+ fieldConditions.$in = cond.$in;
301
+ if (cond.$nin !== undefined)
302
+ fieldConditions.$nin = cond.$nin;
303
+ if (cond.$exists !== undefined)
304
+ fieldConditions.$exists = cond.$exists;
305
+ if (Object.keys(fieldConditions).length > 0) {
306
+ conditions.push({ [field]: fieldConditions });
307
+ }
308
+ }
309
+ // Pinecone requires $and for multiple conditions.
310
+ if (conditions.length === 1)
311
+ return conditions[0];
312
+ return { $and: conditions };
313
+ }
314
+ }
315
+ //# sourceMappingURL=PineconeVectorStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PineconeVectorStore.js","sourceRoot":"","sources":["../../../../src/rag/implementations/vector_stores/PineconeVectorStore.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,107 @@
1
+ /**
2
+ * @fileoverview Postgres + pgvector Vector Store Implementation.
3
+ * @module rag/implementations/vector_stores/PostgresVectorStore
4
+ *
5
+ * Implements `IVectorStore` using Postgres with the pgvector extension
6
+ * for native HNSW-indexed approximate nearest neighbor search. Supports:
7
+ *
8
+ * - Dense vector search via pgvector `<=>` (cosine), `<->` (L2), `<#>` (inner product)
9
+ * - Full-text search via tsvector + GIN indexes
10
+ * - Hybrid search combining both with RRF fusion in a single SQL query
11
+ * - JSONB metadata filtering with GIN indexes
12
+ * - Connection pooling via pg.Pool
13
+ *
14
+ * Scaling target: 500K → 10M vectors with multi-tenant schema isolation.
15
+ *
16
+ * @see ../../IVectorStore.ts for the interface definition.
17
+ */
18
+ import type { IVectorStore, VectorStoreProviderConfig, VectorDocument, QueryOptions, QueryResult, UpsertOptions, UpsertResult, DeleteOptions, DeleteResult, CreateCollectionOptions } from '../../IVectorStore.js';
19
+ /** Configuration specific to the Postgres vector store. */
20
+ export interface PostgresVectorStoreConfig extends VectorStoreProviderConfig {
21
+ type: 'postgres';
22
+ /** Postgres connection string. */
23
+ connectionString: string;
24
+ /** Connection pool size. @default 10 */
25
+ poolSize?: number;
26
+ /** Default embedding dimensions for new collections. @default 1536 */
27
+ defaultDimension?: number;
28
+ /** Default similarity metric. @default 'cosine' */
29
+ similarityMetric?: 'cosine' | 'euclidean' | 'dotproduct';
30
+ /** Table name prefix for multi-tenancy. @default '' */
31
+ tablePrefix?: string;
32
+ }
33
+ export declare class PostgresVectorStore implements IVectorStore {
34
+ private pool;
35
+ private config;
36
+ private prefix;
37
+ private isInitialized;
38
+ constructor(config: PostgresVectorStoreConfig);
39
+ /**
40
+ * Initialize the connection pool, ensure pgvector extension exists,
41
+ * and create the collections metadata table.
42
+ */
43
+ initialize(): Promise<void>;
44
+ /** Close the connection pool. */
45
+ close(): Promise<void>;
46
+ /** Gracefully shut down the store (alias for close). */
47
+ shutdown(): Promise<void>;
48
+ /**
49
+ * Health check — verifies connection and pgvector availability.
50
+ * @returns True if Postgres + pgvector is reachable.
51
+ */
52
+ healthCheck(): Promise<boolean>;
53
+ /** IVectorStore-compliant health check. */
54
+ checkHealth(): Promise<{
55
+ isHealthy: boolean;
56
+ details?: any;
57
+ }>;
58
+ /**
59
+ * Create a new collection (Postgres table) with pgvector HNSW index.
60
+ */
61
+ createCollection(name: string, dimension: number, options?: CreateCollectionOptions): Promise<void>;
62
+ /** Drop a collection table. */
63
+ dropCollection(name: string): Promise<void>;
64
+ /**
65
+ * Upsert documents into a collection.
66
+ * Uses INSERT ... ON CONFLICT (id) DO UPDATE for idempotent writes.
67
+ */
68
+ upsert(collectionName: string, documents: VectorDocument[], _options?: UpsertOptions): Promise<UpsertResult>;
69
+ /**
70
+ * Query for top-K nearest neighbors using pgvector operators.
71
+ * Uses HNSW index for O(log n) approximate search.
72
+ */
73
+ query(collectionName: string, queryEmbedding: number[], options?: QueryOptions): Promise<QueryResult>;
74
+ /**
75
+ * Hybrid search combining pgvector ANN and tsvector BM25 in a single
76
+ * SQL query with Reciprocal Rank Fusion.
77
+ *
78
+ * This runs as one query with two CTEs — no application-level fusion needed.
79
+ */
80
+ hybridSearch(collectionName: string, queryEmbedding: number[], queryText: string, options?: QueryOptions & {
81
+ alpha?: number;
82
+ fusion?: 'rrf' | 'weighted';
83
+ rrfK?: number;
84
+ }): Promise<QueryResult>;
85
+ /** Delete documents by ID. */
86
+ delete(collectionName: string, ids?: string[], options?: DeleteOptions): Promise<DeleteResult>;
87
+ /** Ensure the store is initialized before any operation. */
88
+ private _ensureInit;
89
+ /** Prefix a table name for multi-tenancy. */
90
+ private _t;
91
+ /** Get collection metadata. */
92
+ private _getCollectionMeta;
93
+ /**
94
+ * Parse pgvector string format '[0.1,0.2,0.3]' to number[].
95
+ */
96
+ private _parseVectorString;
97
+ /**
98
+ * Build JSONB metadata filter SQL clauses.
99
+ * Uses Postgres JSONB operators for efficient GIN-indexed filtering.
100
+ *
101
+ * @param filter - MetadataFilter to translate.
102
+ * @param startIdx - Starting parameter index ($N).
103
+ * @returns SQL WHERE clause and parameter values.
104
+ */
105
+ private _buildMetadataFilter;
106
+ }
107
+ //# sourceMappingURL=PostgresVectorStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PostgresVectorStore.d.ts","sourceRoot":"","sources":["../../../../src/rag/implementations/vector_stores/PostgresVectorStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EAEd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EAIxB,MAAM,uBAAuB,CAAC;AAM/B,2DAA2D;AAC3D,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;IACzD,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,yBAAyB;IAS7C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBjC,iCAAiC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAUrC,2CAA2C;IACrC,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IASnE;;OAEG;IACG,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IAmDhB,+BAA+B;IACzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD;;;OAGG;IACG,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,cAAc,EAAE,EAC3B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IA8CxB;;;OAGG;IACG,KAAK,CACT,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAkEvB;;;;;OAKG;IACG,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtF,OAAO,CAAC,WAAW,CAAC;IA2EvB,8BAA8B;IACxB,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,GAAG,CAAC,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAyBxB,4DAA4D;YAC9C,WAAW;IAIzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE;IAIV,+BAA+B;YACjB,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAuE7B"}