langchain 0.0.131 → 0.0.132

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 (804) hide show
  1. package/dist/agents/agent.cjs +23 -0
  2. package/dist/agents/agent.d.ts +28 -0
  3. package/dist/agents/agent.js +23 -0
  4. package/dist/agents/chat/index.cjs +25 -0
  5. package/dist/agents/chat/index.d.ts +32 -0
  6. package/dist/agents/chat/index.js +25 -0
  7. package/dist/agents/chat/outputParser.cjs +19 -0
  8. package/dist/agents/chat/outputParser.d.ts +19 -0
  9. package/dist/agents/chat/outputParser.js +19 -0
  10. package/dist/agents/chat_convo/index.cjs +22 -0
  11. package/dist/agents/chat_convo/index.d.ts +31 -0
  12. package/dist/agents/chat_convo/index.js +22 -0
  13. package/dist/agents/chat_convo/outputParser.cjs +42 -0
  14. package/dist/agents/chat_convo/outputParser.d.ts +42 -0
  15. package/dist/agents/chat_convo/outputParser.js +42 -0
  16. package/dist/agents/executor.cjs +6 -0
  17. package/dist/agents/executor.d.ts +11 -0
  18. package/dist/agents/executor.js +6 -0
  19. package/dist/agents/initialize.d.ts +5 -0
  20. package/dist/agents/mrkl/index.cjs +17 -0
  21. package/dist/agents/mrkl/index.d.ts +24 -0
  22. package/dist/agents/mrkl/index.js +17 -0
  23. package/dist/agents/mrkl/outputParser.cjs +15 -0
  24. package/dist/agents/mrkl/outputParser.d.ts +15 -0
  25. package/dist/agents/mrkl/outputParser.js +15 -0
  26. package/dist/agents/openai/index.cjs +43 -0
  27. package/dist/agents/openai/index.d.ts +39 -0
  28. package/dist/agents/openai/index.js +43 -0
  29. package/dist/agents/structured_chat/index.cjs +32 -0
  30. package/dist/agents/structured_chat/index.d.ts +40 -0
  31. package/dist/agents/structured_chat/index.js +32 -0
  32. package/dist/agents/structured_chat/outputParser.cjs +44 -0
  33. package/dist/agents/structured_chat/outputParser.d.ts +48 -0
  34. package/dist/agents/structured_chat/outputParser.js +44 -0
  35. package/dist/agents/toolkits/aws_sfn.cjs +5 -0
  36. package/dist/agents/toolkits/aws_sfn.d.ts +9 -0
  37. package/dist/agents/toolkits/aws_sfn.js +5 -0
  38. package/dist/agents/toolkits/base.cjs +5 -0
  39. package/dist/agents/toolkits/base.d.ts +5 -0
  40. package/dist/agents/toolkits/base.js +5 -0
  41. package/dist/agents/toolkits/conversational_retrieval/openai_functions.cjs +10 -0
  42. package/dist/agents/toolkits/conversational_retrieval/openai_functions.d.ts +10 -0
  43. package/dist/agents/toolkits/conversational_retrieval/openai_functions.js +10 -0
  44. package/dist/agents/toolkits/conversational_retrieval/token_buffer_memory.cjs +17 -0
  45. package/dist/agents/toolkits/conversational_retrieval/token_buffer_memory.d.ts +21 -0
  46. package/dist/agents/toolkits/conversational_retrieval/token_buffer_memory.js +17 -0
  47. package/dist/agents/toolkits/json/json.cjs +15 -0
  48. package/dist/agents/toolkits/json/json.d.ts +15 -0
  49. package/dist/agents/toolkits/json/json.js +15 -0
  50. package/dist/agents/toolkits/openapi/openapi.cjs +21 -0
  51. package/dist/agents/toolkits/openapi/openapi.d.ts +21 -0
  52. package/dist/agents/toolkits/openapi/openapi.js +21 -0
  53. package/dist/agents/toolkits/sql/sql.cjs +4 -0
  54. package/dist/agents/toolkits/sql/sql.d.ts +8 -0
  55. package/dist/agents/toolkits/sql/sql.js +4 -0
  56. package/dist/agents/toolkits/vectorstore/vectorstore.cjs +10 -0
  57. package/dist/agents/toolkits/vectorstore/vectorstore.d.ts +14 -0
  58. package/dist/agents/toolkits/vectorstore/vectorstore.js +10 -0
  59. package/dist/agents/toolkits/zapier/zapier.cjs +12 -0
  60. package/dist/agents/toolkits/zapier/zapier.d.ts +12 -0
  61. package/dist/agents/toolkits/zapier/zapier.js +12 -0
  62. package/dist/agents/types.cjs +5 -0
  63. package/dist/agents/types.d.ts +28 -0
  64. package/dist/agents/types.js +5 -0
  65. package/dist/cache/index.cjs +21 -0
  66. package/dist/cache/index.d.ts +21 -0
  67. package/dist/cache/index.js +21 -0
  68. package/dist/cache/ioredis.cjs +16 -0
  69. package/dist/cache/ioredis.d.ts +16 -0
  70. package/dist/cache/ioredis.js +16 -0
  71. package/dist/cache/redis.cjs +21 -0
  72. package/dist/cache/redis.d.ts +25 -0
  73. package/dist/cache/redis.js +21 -0
  74. package/dist/callbacks/base.cjs +11 -0
  75. package/dist/callbacks/base.d.ts +20 -0
  76. package/dist/callbacks/base.js +11 -0
  77. package/dist/callbacks/handlers/console.cjs +87 -0
  78. package/dist/callbacks/handlers/console.d.ts +87 -0
  79. package/dist/callbacks/handlers/console.js +87 -0
  80. package/dist/callbacks/handlers/initialize.cjs +12 -0
  81. package/dist/callbacks/handlers/initialize.d.ts +12 -0
  82. package/dist/callbacks/handlers/initialize.js +12 -0
  83. package/dist/callbacks/manager.cjs +9 -0
  84. package/dist/callbacks/manager.d.ts +9 -0
  85. package/dist/callbacks/manager.js +9 -0
  86. package/dist/callbacks/promises.cjs +9 -0
  87. package/dist/callbacks/promises.d.ts +4 -0
  88. package/dist/callbacks/promises.js +9 -0
  89. package/dist/chains/analyze_documents_chain.d.ts +4 -0
  90. package/dist/chains/api/api_chain.cjs +12 -0
  91. package/dist/chains/api/api_chain.d.ts +19 -0
  92. package/dist/chains/api/api_chain.js +12 -0
  93. package/dist/chains/base.cjs +6 -0
  94. package/dist/chains/base.d.ts +6 -0
  95. package/dist/chains/base.js +6 -0
  96. package/dist/chains/chat_vector_db_chain.cjs +8 -0
  97. package/dist/chains/chat_vector_db_chain.d.ts +11 -0
  98. package/dist/chains/chat_vector_db_chain.js +8 -0
  99. package/dist/chains/combine_docs_chain.d.ts +10 -0
  100. package/dist/chains/constitutional_ai/constitutional_chain.cjs +17 -0
  101. package/dist/chains/constitutional_ai/constitutional_chain.d.ts +20 -0
  102. package/dist/chains/constitutional_ai/constitutional_chain.js +17 -0
  103. package/dist/chains/constitutional_ai/constitutional_principle.cjs +4 -0
  104. package/dist/chains/constitutional_ai/constitutional_principle.d.ts +4 -0
  105. package/dist/chains/constitutional_ai/constitutional_principle.js +4 -0
  106. package/dist/chains/conversation.cjs +4 -0
  107. package/dist/chains/conversation.d.ts +4 -0
  108. package/dist/chains/conversation.js +4 -0
  109. package/dist/chains/conversational_retrieval_chain.cjs +21 -0
  110. package/dist/chains/conversational_retrieval_chain.d.ts +26 -1
  111. package/dist/chains/conversational_retrieval_chain.js +21 -0
  112. package/dist/chains/llm_chain.d.ts +3 -0
  113. package/dist/chains/openai_functions/extraction.cjs +21 -0
  114. package/dist/chains/openai_functions/extraction.d.ts +15 -0
  115. package/dist/chains/openai_functions/extraction.js +21 -0
  116. package/dist/chains/openai_functions/openapi.cjs +27 -0
  117. package/dist/chains/openai_functions/openapi.d.ts +3 -0
  118. package/dist/chains/openai_functions/openapi.js +27 -0
  119. package/dist/chains/openai_functions/structured_output.cjs +12 -0
  120. package/dist/chains/openai_functions/structured_output.d.ts +18 -0
  121. package/dist/chains/openai_functions/structured_output.js +12 -0
  122. package/dist/chains/openai_functions/tagging.cjs +24 -0
  123. package/dist/chains/openai_functions/tagging.d.ts +21 -0
  124. package/dist/chains/openai_functions/tagging.js +24 -0
  125. package/dist/chains/openai_moderation.cjs +5 -0
  126. package/dist/chains/openai_moderation.d.ts +8 -0
  127. package/dist/chains/openai_moderation.js +5 -0
  128. package/dist/chains/query_constructor/index.cjs +17 -0
  129. package/dist/chains/query_constructor/index.d.ts +20 -0
  130. package/dist/chains/query_constructor/index.js +17 -0
  131. package/dist/chains/query_constructor/ir.cjs +24 -0
  132. package/dist/chains/query_constructor/ir.d.ts +71 -0
  133. package/dist/chains/query_constructor/ir.js +24 -0
  134. package/dist/chains/query_constructor/parser.cjs +21 -0
  135. package/dist/chains/query_constructor/parser.d.ts +25 -0
  136. package/dist/chains/query_constructor/parser.js +21 -0
  137. package/dist/chains/question_answering/load.cjs +21 -0
  138. package/dist/chains/question_answering/load.d.ts +34 -0
  139. package/dist/chains/question_answering/load.js +21 -0
  140. package/dist/chains/retrieval_qa.cjs +12 -0
  141. package/dist/chains/retrieval_qa.d.ts +15 -0
  142. package/dist/chains/retrieval_qa.js +12 -0
  143. package/dist/chains/router/llm_router.cjs +16 -0
  144. package/dist/chains/router/llm_router.d.ts +24 -0
  145. package/dist/chains/router/llm_router.js +16 -0
  146. package/dist/chains/router/multi_prompt.cjs +19 -0
  147. package/dist/chains/router/multi_prompt.d.ts +19 -0
  148. package/dist/chains/router/multi_prompt.js +19 -0
  149. package/dist/chains/router/multi_retrieval_qa.cjs +22 -0
  150. package/dist/chains/router/multi_retrieval_qa.d.ts +27 -0
  151. package/dist/chains/router/multi_retrieval_qa.js +22 -0
  152. package/dist/chains/router/multi_route.cjs +10 -0
  153. package/dist/chains/router/multi_route.d.ts +25 -0
  154. package/dist/chains/router/multi_route.js +10 -0
  155. package/dist/chains/sequential_chain.d.ts +6 -0
  156. package/dist/chains/serde.d.ts +58 -0
  157. package/dist/chains/sql_db/sql_db_chain.cjs +13 -0
  158. package/dist/chains/sql_db/sql_db_chain.d.ts +18 -0
  159. package/dist/chains/sql_db/sql_db_chain.js +13 -0
  160. package/dist/chains/summarization/load.d.ts +4 -0
  161. package/dist/chains/transform.cjs +6 -0
  162. package/dist/chains/transform.d.ts +11 -0
  163. package/dist/chains/transform.js +6 -0
  164. package/dist/chains/vector_db_qa.cjs +15 -0
  165. package/dist/chains/vector_db_qa.d.ts +21 -0
  166. package/dist/chains/vector_db_qa.js +15 -0
  167. package/dist/chat_models/anthropic.cjs +24 -4
  168. package/dist/chat_models/anthropic.d.ts +14 -0
  169. package/dist/chat_models/anthropic.js +24 -4
  170. package/dist/chat_models/baiduwenxin.cjs +16 -0
  171. package/dist/chat_models/baiduwenxin.d.ts +18 -0
  172. package/dist/chat_models/baiduwenxin.js +16 -0
  173. package/dist/chat_models/base.cjs +61 -0
  174. package/dist/chat_models/base.d.ts +73 -0
  175. package/dist/chat_models/base.js +61 -0
  176. package/dist/chat_models/googlepalm.cjs +3 -0
  177. package/dist/chat_models/googlepalm.d.ts +6 -0
  178. package/dist/chat_models/googlepalm.js +3 -0
  179. package/dist/chat_models/googlevertexai.cjs +32 -0
  180. package/dist/chat_models/googlevertexai.d.ts +49 -0
  181. package/dist/chat_models/googlevertexai.js +32 -0
  182. package/dist/chat_models/ollama.cjs +11 -0
  183. package/dist/chat_models/ollama.d.ts +15 -0
  184. package/dist/chat_models/ollama.js +11 -0
  185. package/dist/document_loaders/base.cjs +10 -0
  186. package/dist/document_loaders/base.d.ts +17 -0
  187. package/dist/document_loaders/base.js +10 -0
  188. package/dist/document_loaders/fs/buffer.cjs +21 -0
  189. package/dist/document_loaders/fs/buffer.d.ts +28 -0
  190. package/dist/document_loaders/fs/buffer.js +21 -0
  191. package/dist/document_loaders/fs/csv.cjs +19 -0
  192. package/dist/document_loaders/fs/csv.d.ts +19 -0
  193. package/dist/document_loaders/fs/csv.js +19 -0
  194. package/dist/document_loaders/fs/directory.cjs +21 -0
  195. package/dist/document_loaders/fs/directory.d.ts +29 -0
  196. package/dist/document_loaders/fs/directory.js +21 -0
  197. package/dist/document_loaders/fs/docx.cjs +16 -0
  198. package/dist/document_loaders/fs/docx.d.ts +16 -0
  199. package/dist/document_loaders/fs/docx.js +16 -0
  200. package/dist/document_loaders/fs/epub.cjs +16 -0
  201. package/dist/document_loaders/fs/epub.d.ts +16 -0
  202. package/dist/document_loaders/fs/epub.js +16 -0
  203. package/dist/document_loaders/fs/json.cjs +40 -0
  204. package/dist/document_loaders/fs/json.d.ts +40 -0
  205. package/dist/document_loaders/fs/json.js +40 -0
  206. package/dist/document_loaders/fs/notion.cjs +6 -0
  207. package/dist/document_loaders/fs/notion.d.ts +6 -0
  208. package/dist/document_loaders/fs/notion.js +6 -0
  209. package/dist/document_loaders/fs/pdf.cjs +21 -0
  210. package/dist/document_loaders/fs/pdf.d.ts +21 -0
  211. package/dist/document_loaders/fs/pdf.js +21 -0
  212. package/dist/document_loaders/fs/srt.cjs +19 -0
  213. package/dist/document_loaders/fs/srt.d.ts +19 -0
  214. package/dist/document_loaders/fs/srt.js +19 -0
  215. package/dist/document_loaders/fs/text.cjs +34 -0
  216. package/dist/document_loaders/fs/text.d.ts +34 -0
  217. package/dist/document_loaders/fs/text.js +34 -0
  218. package/dist/document_loaders/fs/unstructured.cjs +14 -0
  219. package/dist/document_loaders/fs/unstructured.d.ts +26 -0
  220. package/dist/document_loaders/fs/unstructured.js +14 -0
  221. package/dist/document_loaders/web/apify_dataset.cjs +11 -0
  222. package/dist/document_loaders/web/apify_dataset.d.ts +15 -0
  223. package/dist/document_loaders/web/apify_dataset.js +11 -0
  224. package/dist/document_loaders/web/azure_blob_storage_container.cjs +13 -0
  225. package/dist/document_loaders/web/azure_blob_storage_container.d.ts +26 -0
  226. package/dist/document_loaders/web/azure_blob_storage_container.js +13 -0
  227. package/dist/document_loaders/web/azure_blob_storage_file.cjs +12 -0
  228. package/dist/document_loaders/web/azure_blob_storage_file.d.ts +21 -0
  229. package/dist/document_loaders/web/azure_blob_storage_file.js +12 -0
  230. package/dist/document_loaders/web/cheerio.cjs +21 -0
  231. package/dist/document_loaders/web/cheerio.d.ts +26 -0
  232. package/dist/document_loaders/web/cheerio.js +21 -0
  233. package/dist/document_loaders/web/college_confidential.cjs +11 -0
  234. package/dist/document_loaders/web/college_confidential.d.ts +11 -0
  235. package/dist/document_loaders/web/college_confidential.js +11 -0
  236. package/dist/document_loaders/web/confluence.cjs +23 -0
  237. package/dist/document_loaders/web/confluence.d.ts +33 -0
  238. package/dist/document_loaders/web/confluence.js +23 -0
  239. package/dist/document_loaders/web/figma.cjs +21 -0
  240. package/dist/document_loaders/web/figma.d.ts +32 -0
  241. package/dist/document_loaders/web/figma.js +21 -0
  242. package/dist/document_loaders/web/gitbook.cjs +33 -0
  243. package/dist/document_loaders/web/gitbook.d.ts +38 -0
  244. package/dist/document_loaders/web/gitbook.js +33 -0
  245. package/dist/document_loaders/web/github.cjs +50 -0
  246. package/dist/document_loaders/web/github.d.ts +53 -0
  247. package/dist/document_loaders/web/github.js +50 -0
  248. package/dist/document_loaders/web/hn.cjs +31 -0
  249. package/dist/document_loaders/web/hn.d.ts +31 -0
  250. package/dist/document_loaders/web/hn.js +31 -0
  251. package/dist/document_loaders/web/imsdb.cjs +14 -0
  252. package/dist/document_loaders/web/imsdb.d.ts +14 -0
  253. package/dist/document_loaders/web/imsdb.js +14 -0
  254. package/dist/document_loaders/web/notionapi.cjs +39 -0
  255. package/dist/document_loaders/web/notionapi.d.ts +43 -0
  256. package/dist/document_loaders/web/notionapi.js +39 -0
  257. package/dist/document_loaders/web/notiondb.cjs +19 -0
  258. package/dist/document_loaders/web/notiondb.d.ts +24 -0
  259. package/dist/document_loaders/web/notiondb.js +19 -0
  260. package/dist/document_loaders/web/playwright.cjs +22 -0
  261. package/dist/document_loaders/web/playwright.d.ts +27 -0
  262. package/dist/document_loaders/web/playwright.js +22 -0
  263. package/dist/document_loaders/web/puppeteer.cjs +20 -0
  264. package/dist/document_loaders/web/puppeteer.d.ts +25 -0
  265. package/dist/document_loaders/web/puppeteer.js +20 -0
  266. package/dist/document_loaders/web/s3.cjs +9 -0
  267. package/dist/document_loaders/web/s3.d.ts +21 -0
  268. package/dist/document_loaders/web/s3.js +9 -0
  269. package/dist/document_loaders/web/serpapi.cjs +4 -0
  270. package/dist/document_loaders/web/serpapi.d.ts +8 -0
  271. package/dist/document_loaders/web/serpapi.js +4 -0
  272. package/dist/document_loaders/web/sonix_audio.cjs +10 -0
  273. package/dist/document_loaders/web/sonix_audio.d.ts +10 -0
  274. package/dist/document_loaders/web/sonix_audio.js +10 -0
  275. package/dist/document_loaders/web/sort_xyz_blockchain.cjs +10 -0
  276. package/dist/document_loaders/web/sort_xyz_blockchain.d.ts +17 -0
  277. package/dist/document_loaders/web/sort_xyz_blockchain.js +10 -0
  278. package/dist/document_loaders/web/youtube.cjs +23 -0
  279. package/dist/document_loaders/web/youtube.d.ts +27 -0
  280. package/dist/document_loaders/web/youtube.js +23 -0
  281. package/dist/document_transformers/html_to_text.cjs +3 -0
  282. package/dist/document_transformers/html_to_text.d.ts +3 -0
  283. package/dist/document_transformers/html_to_text.js +3 -0
  284. package/dist/document_transformers/mozilla_readability.cjs +4 -0
  285. package/dist/document_transformers/mozilla_readability.d.ts +4 -0
  286. package/dist/document_transformers/mozilla_readability.js +4 -0
  287. package/dist/document_transformers/openai_functions.cjs +3 -0
  288. package/dist/document_transformers/openai_functions.d.ts +3 -0
  289. package/dist/document_transformers/openai_functions.js +3 -0
  290. package/dist/embeddings/base.cjs +4 -0
  291. package/dist/embeddings/base.d.ts +21 -0
  292. package/dist/embeddings/base.js +4 -0
  293. package/dist/embeddings/cache_backed.d.ts +4 -0
  294. package/dist/embeddings/cohere.d.ts +4 -0
  295. package/dist/embeddings/fake.cjs +33 -0
  296. package/dist/embeddings/fake.d.ts +37 -0
  297. package/dist/embeddings/fake.js +33 -0
  298. package/dist/embeddings/googlepalm.cjs +18 -0
  299. package/dist/embeddings/googlepalm.d.ts +22 -0
  300. package/dist/embeddings/googlepalm.js +18 -0
  301. package/dist/embeddings/googlevertexai.cjs +15 -0
  302. package/dist/embeddings/googlevertexai.d.ts +20 -0
  303. package/dist/embeddings/googlevertexai.js +15 -0
  304. package/dist/embeddings/hf.cjs +20 -0
  305. package/dist/embeddings/hf.d.ts +24 -0
  306. package/dist/embeddings/hf.js +20 -0
  307. package/dist/embeddings/openai.cjs +25 -0
  308. package/dist/embeddings/openai.d.ts +29 -0
  309. package/dist/embeddings/openai.js +25 -0
  310. package/dist/embeddings/tensorflow.cjs +27 -0
  311. package/dist/embeddings/tensorflow.d.ts +31 -0
  312. package/dist/embeddings/tensorflow.js +27 -0
  313. package/dist/experimental/autogpt/agent.cjs +21 -0
  314. package/dist/experimental/autogpt/agent.d.ts +24 -0
  315. package/dist/experimental/autogpt/agent.js +21 -0
  316. package/dist/experimental/autogpt/output_parser.cjs +24 -0
  317. package/dist/experimental/autogpt/output_parser.d.ts +24 -0
  318. package/dist/experimental/autogpt/output_parser.js +24 -0
  319. package/dist/experimental/autogpt/prompt.cjs +25 -0
  320. package/dist/experimental/autogpt/prompt.d.ts +28 -0
  321. package/dist/experimental/autogpt/prompt.js +25 -0
  322. package/dist/experimental/autogpt/prompt_generator.cjs +32 -0
  323. package/dist/experimental/autogpt/prompt_generator.d.ts +32 -0
  324. package/dist/experimental/autogpt/prompt_generator.js +32 -0
  325. package/dist/experimental/autogpt/schema.d.ts +11 -0
  326. package/dist/experimental/babyagi/agent.cjs +65 -0
  327. package/dist/experimental/babyagi/agent.d.ts +75 -0
  328. package/dist/experimental/babyagi/agent.js +65 -0
  329. package/dist/experimental/babyagi/task_creation.cjs +10 -0
  330. package/dist/experimental/babyagi/task_creation.d.ts +10 -0
  331. package/dist/experimental/babyagi/task_creation.js +10 -0
  332. package/dist/experimental/babyagi/task_execution.cjs +9 -0
  333. package/dist/experimental/babyagi/task_execution.d.ts +9 -0
  334. package/dist/experimental/babyagi/task_execution.js +9 -0
  335. package/dist/experimental/babyagi/task_prioritization.cjs +8 -0
  336. package/dist/experimental/babyagi/task_prioritization.d.ts +8 -0
  337. package/dist/experimental/babyagi/task_prioritization.js +8 -0
  338. package/dist/experimental/generative_agents/generative_agent.cjs +74 -0
  339. package/dist/experimental/generative_agents/generative_agent.d.ts +79 -0
  340. package/dist/experimental/generative_agents/generative_agent.js +74 -0
  341. package/dist/experimental/generative_agents/generative_agent_memory.cjs +113 -0
  342. package/dist/experimental/generative_agents/generative_agent_memory.d.ts +113 -0
  343. package/dist/experimental/generative_agents/generative_agent_memory.js +113 -0
  344. package/dist/experimental/multimodal_embeddings/googlevertexai.cjs +46 -0
  345. package/dist/experimental/multimodal_embeddings/googlevertexai.d.ts +58 -0
  346. package/dist/experimental/multimodal_embeddings/googlevertexai.js +46 -0
  347. package/dist/experimental/plan_and_execute/agent_executor.cjs +32 -0
  348. package/dist/experimental/plan_and_execute/agent_executor.d.ts +37 -0
  349. package/dist/experimental/plan_and_execute/agent_executor.js +32 -0
  350. package/dist/experimental/plan_and_execute/base.cjs +26 -0
  351. package/dist/experimental/plan_and_execute/base.d.ts +38 -0
  352. package/dist/experimental/plan_and_execute/base.js +26 -0
  353. package/dist/experimental/plan_and_execute/outputParser.cjs +18 -0
  354. package/dist/experimental/plan_and_execute/outputParser.d.ts +18 -0
  355. package/dist/experimental/plan_and_execute/outputParser.js +18 -0
  356. package/dist/llms/ai21.cjs +13 -0
  357. package/dist/llms/ai21.d.ts +19 -0
  358. package/dist/llms/ai21.js +13 -0
  359. package/dist/llms/aleph_alpha.cjs +10 -0
  360. package/dist/llms/aleph_alpha.d.ts +13 -0
  361. package/dist/llms/aleph_alpha.js +10 -0
  362. package/dist/llms/base.cjs +32 -0
  363. package/dist/llms/base.d.ts +32 -0
  364. package/dist/llms/base.js +32 -0
  365. package/dist/llms/bedrock.cjs +21 -0
  366. package/dist/llms/bedrock.d.ts +9 -0
  367. package/dist/llms/bedrock.js +21 -0
  368. package/dist/llms/cohere.cjs +4 -0
  369. package/dist/llms/cohere.d.ts +7 -0
  370. package/dist/llms/cohere.js +4 -0
  371. package/dist/llms/googlevertexai.cjs +23 -0
  372. package/dist/llms/googlevertexai.d.ts +38 -0
  373. package/dist/llms/googlevertexai.js +23 -0
  374. package/dist/llms/hf.cjs +4 -0
  375. package/dist/llms/hf.d.ts +8 -0
  376. package/dist/llms/hf.js +4 -0
  377. package/dist/llms/ollama.cjs +4 -0
  378. package/dist/llms/ollama.d.ts +4 -0
  379. package/dist/llms/ollama.js +4 -0
  380. package/dist/llms/openai-chat.cjs +17 -0
  381. package/dist/llms/openai-chat.d.ts +22 -0
  382. package/dist/llms/openai-chat.js +17 -0
  383. package/dist/llms/openai.cjs +6 -0
  384. package/dist/llms/openai.d.ts +6 -0
  385. package/dist/llms/openai.js +6 -0
  386. package/dist/llms/replicate.cjs +6 -0
  387. package/dist/llms/replicate.d.ts +11 -0
  388. package/dist/llms/replicate.js +6 -0
  389. package/dist/llms/sagemaker_endpoint.cjs +11 -0
  390. package/dist/llms/sagemaker_endpoint.d.ts +17 -0
  391. package/dist/llms/sagemaker_endpoint.js +11 -0
  392. package/dist/memory/base.cjs +11 -0
  393. package/dist/memory/base.d.ts +40 -0
  394. package/dist/memory/base.js +11 -0
  395. package/dist/memory/buffer_memory.cjs +19 -0
  396. package/dist/memory/buffer_memory.d.ts +22 -0
  397. package/dist/memory/buffer_memory.js +19 -0
  398. package/dist/memory/buffer_window_memory.cjs +15 -0
  399. package/dist/memory/buffer_window_memory.d.ts +18 -0
  400. package/dist/memory/buffer_window_memory.js +15 -0
  401. package/dist/memory/chat_memory.cjs +16 -0
  402. package/dist/memory/chat_memory.d.ts +19 -0
  403. package/dist/memory/chat_memory.js +16 -0
  404. package/dist/memory/combined_memory.cjs +28 -0
  405. package/dist/memory/combined_memory.d.ts +33 -0
  406. package/dist/memory/combined_memory.js +28 -0
  407. package/dist/memory/entity_memory.cjs +21 -0
  408. package/dist/memory/entity_memory.d.ts +24 -0
  409. package/dist/memory/entity_memory.js +21 -0
  410. package/dist/memory/motorhead_memory.cjs +25 -0
  411. package/dist/memory/motorhead_memory.d.ts +29 -0
  412. package/dist/memory/motorhead_memory.js +25 -0
  413. package/dist/memory/stores/entity/in_memory.cjs +29 -0
  414. package/dist/memory/stores/entity/in_memory.d.ts +29 -0
  415. package/dist/memory/stores/entity/in_memory.js +29 -0
  416. package/dist/memory/summary.cjs +31 -0
  417. package/dist/memory/summary.d.ts +39 -0
  418. package/dist/memory/summary.js +31 -0
  419. package/dist/memory/summary_buffer.cjs +33 -0
  420. package/dist/memory/summary_buffer.d.ts +37 -0
  421. package/dist/memory/summary_buffer.js +33 -0
  422. package/dist/memory/vector_store.cjs +22 -0
  423. package/dist/memory/vector_store.d.ts +26 -0
  424. package/dist/memory/vector_store.js +22 -0
  425. package/dist/memory/zep.cjs +22 -0
  426. package/dist/memory/zep.d.ts +27 -0
  427. package/dist/memory/zep.js +22 -0
  428. package/dist/output_parsers/combining.cjs +12 -0
  429. package/dist/output_parsers/combining.d.ts +18 -0
  430. package/dist/output_parsers/combining.js +12 -0
  431. package/dist/output_parsers/expression.cjs +12 -0
  432. package/dist/output_parsers/expression.d.ts +12 -0
  433. package/dist/output_parsers/expression.js +12 -0
  434. package/dist/output_parsers/expression_type_handlers/array_literal_expression_handler.cjs +18 -0
  435. package/dist/output_parsers/expression_type_handlers/array_literal_expression_handler.d.ts +18 -0
  436. package/dist/output_parsers/expression_type_handlers/array_literal_expression_handler.js +18 -0
  437. package/dist/output_parsers/expression_type_handlers/base.cjs +68 -0
  438. package/dist/output_parsers/expression_type_handlers/base.d.ts +79 -0
  439. package/dist/output_parsers/expression_type_handlers/base.js +68 -0
  440. package/dist/output_parsers/expression_type_handlers/boolean_literal_handler.cjs +18 -0
  441. package/dist/output_parsers/expression_type_handlers/boolean_literal_handler.d.ts +18 -0
  442. package/dist/output_parsers/expression_type_handlers/boolean_literal_handler.js +18 -0
  443. package/dist/output_parsers/expression_type_handlers/call_expression_handler.cjs +22 -0
  444. package/dist/output_parsers/expression_type_handlers/call_expression_handler.d.ts +22 -0
  445. package/dist/output_parsers/expression_type_handlers/call_expression_handler.js +22 -0
  446. package/dist/output_parsers/expression_type_handlers/factory.cjs +20 -0
  447. package/dist/output_parsers/expression_type_handlers/factory.d.ts +20 -0
  448. package/dist/output_parsers/expression_type_handlers/factory.js +20 -0
  449. package/dist/output_parsers/expression_type_handlers/identifier_handler.cjs +19 -0
  450. package/dist/output_parsers/expression_type_handlers/identifier_handler.d.ts +19 -0
  451. package/dist/output_parsers/expression_type_handlers/identifier_handler.js +19 -0
  452. package/dist/output_parsers/expression_type_handlers/member_expression_handler.cjs +17 -0
  453. package/dist/output_parsers/expression_type_handlers/member_expression_handler.d.ts +17 -0
  454. package/dist/output_parsers/expression_type_handlers/member_expression_handler.js +17 -0
  455. package/dist/output_parsers/expression_type_handlers/numeric_literal_handler.cjs +16 -0
  456. package/dist/output_parsers/expression_type_handlers/numeric_literal_handler.d.ts +16 -0
  457. package/dist/output_parsers/expression_type_handlers/numeric_literal_handler.js +16 -0
  458. package/dist/output_parsers/expression_type_handlers/object_literal_expression_handler.cjs +16 -0
  459. package/dist/output_parsers/expression_type_handlers/object_literal_expression_handler.d.ts +16 -0
  460. package/dist/output_parsers/expression_type_handlers/object_literal_expression_handler.js +16 -0
  461. package/dist/output_parsers/expression_type_handlers/property_assignment_handler.cjs +17 -0
  462. package/dist/output_parsers/expression_type_handlers/property_assignment_handler.d.ts +17 -0
  463. package/dist/output_parsers/expression_type_handlers/property_assignment_handler.js +17 -0
  464. package/dist/output_parsers/expression_type_handlers/string_literal_handler.cjs +16 -0
  465. package/dist/output_parsers/expression_type_handlers/string_literal_handler.d.ts +16 -0
  466. package/dist/output_parsers/expression_type_handlers/string_literal_handler.js +16 -0
  467. package/dist/output_parsers/expression_type_handlers/types.d.ts +50 -0
  468. package/dist/output_parsers/fix.cjs +25 -0
  469. package/dist/output_parsers/fix.d.ts +25 -0
  470. package/dist/output_parsers/fix.js +25 -0
  471. package/dist/output_parsers/list.cjs +24 -0
  472. package/dist/output_parsers/list.d.ts +24 -0
  473. package/dist/output_parsers/list.js +24 -0
  474. package/dist/output_parsers/noop.cjs +18 -0
  475. package/dist/output_parsers/noop.d.ts +18 -0
  476. package/dist/output_parsers/noop.js +18 -0
  477. package/dist/output_parsers/openai_functions.cjs +31 -0
  478. package/dist/output_parsers/openai_functions.d.ts +34 -0
  479. package/dist/output_parsers/openai_functions.js +31 -0
  480. package/dist/output_parsers/regex.cjs +12 -0
  481. package/dist/output_parsers/regex.d.ts +15 -0
  482. package/dist/output_parsers/regex.js +12 -0
  483. package/dist/output_parsers/router.cjs +15 -0
  484. package/dist/output_parsers/router.d.ts +19 -0
  485. package/dist/output_parsers/router.js +15 -0
  486. package/dist/output_parsers/structured.cjs +30 -0
  487. package/dist/output_parsers/structured.d.ts +36 -0
  488. package/dist/output_parsers/structured.js +30 -0
  489. package/dist/prompts/base.cjs +26 -0
  490. package/dist/prompts/base.d.ts +36 -0
  491. package/dist/prompts/base.js +26 -0
  492. package/dist/prompts/chat.cjs +48 -0
  493. package/dist/prompts/chat.d.ts +69 -0
  494. package/dist/prompts/chat.js +48 -0
  495. package/dist/prompts/few_shot.cjs +5 -0
  496. package/dist/prompts/few_shot.d.ts +5 -0
  497. package/dist/prompts/few_shot.js +5 -0
  498. package/dist/prompts/pipeline.cjs +26 -0
  499. package/dist/prompts/pipeline.d.ts +34 -0
  500. package/dist/prompts/pipeline.js +26 -0
  501. package/dist/prompts/prompt.cjs +10 -0
  502. package/dist/prompts/prompt.d.ts +10 -0
  503. package/dist/prompts/prompt.js +10 -0
  504. package/dist/prompts/selectors/LengthBasedExampleSelector.cjs +32 -0
  505. package/dist/prompts/selectors/LengthBasedExampleSelector.d.ts +33 -0
  506. package/dist/prompts/selectors/LengthBasedExampleSelector.js +32 -0
  507. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.cjs +31 -0
  508. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.d.ts +35 -0
  509. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.js +31 -0
  510. package/dist/prompts/selectors/conditional.cjs +30 -0
  511. package/dist/prompts/selectors/conditional.d.ts +37 -0
  512. package/dist/prompts/selectors/conditional.js +30 -0
  513. package/dist/prompts/serde.d.ts +24 -0
  514. package/dist/prompts/template.d.ts +17 -0
  515. package/dist/retrievers/amazon_kendra.cjs +62 -0
  516. package/dist/retrievers/amazon_kendra.d.ts +66 -0
  517. package/dist/retrievers/amazon_kendra.js +62 -0
  518. package/dist/retrievers/contextual_compression.cjs +5 -0
  519. package/dist/retrievers/contextual_compression.d.ts +10 -0
  520. package/dist/retrievers/contextual_compression.js +5 -0
  521. package/dist/retrievers/databerry.cjs +5 -0
  522. package/dist/retrievers/databerry.d.ts +9 -0
  523. package/dist/retrievers/databerry.js +5 -0
  524. package/dist/retrievers/document_compressors/chain_extract.cjs +18 -0
  525. package/dist/retrievers/document_compressors/chain_extract.d.ts +22 -0
  526. package/dist/retrievers/document_compressors/chain_extract.js +18 -0
  527. package/dist/retrievers/document_compressors/index.d.ts +9 -0
  528. package/dist/retrievers/hyde.cjs +9 -0
  529. package/dist/retrievers/hyde.d.ts +17 -0
  530. package/dist/retrievers/hyde.js +9 -0
  531. package/dist/retrievers/metal.cjs +7 -0
  532. package/dist/retrievers/metal.d.ts +12 -0
  533. package/dist/retrievers/metal.js +7 -0
  534. package/dist/retrievers/parent_document.cjs +17 -1
  535. package/dist/retrievers/parent_document.d.ts +15 -0
  536. package/dist/retrievers/parent_document.js +17 -1
  537. package/dist/retrievers/remote/base.cjs +4 -0
  538. package/dist/retrievers/remote/base.d.ts +28 -0
  539. package/dist/retrievers/remote/base.js +4 -0
  540. package/dist/retrievers/remote/chatgpt-plugin.cjs +17 -0
  541. package/dist/retrievers/remote/chatgpt-plugin.d.ts +21 -0
  542. package/dist/retrievers/remote/chatgpt-plugin.js +17 -0
  543. package/dist/retrievers/remote/remote-retriever.cjs +20 -0
  544. package/dist/retrievers/remote/remote-retriever.d.ts +20 -0
  545. package/dist/retrievers/remote/remote-retriever.js +20 -0
  546. package/dist/retrievers/self_query/base.cjs +28 -0
  547. package/dist/retrievers/self_query/base.d.ts +45 -0
  548. package/dist/retrievers/self_query/base.js +28 -0
  549. package/dist/retrievers/self_query/chroma.cjs +6 -0
  550. package/dist/retrievers/self_query/chroma.d.ts +6 -0
  551. package/dist/retrievers/self_query/chroma.js +6 -0
  552. package/dist/retrievers/self_query/functional.cjs +40 -0
  553. package/dist/retrievers/self_query/functional.d.ts +49 -0
  554. package/dist/retrievers/self_query/functional.js +40 -0
  555. package/dist/retrievers/self_query/index.cjs +14 -0
  556. package/dist/retrievers/self_query/index.d.ts +18 -0
  557. package/dist/retrievers/self_query/index.js +14 -0
  558. package/dist/retrievers/self_query/pinecone.cjs +7 -0
  559. package/dist/retrievers/self_query/pinecone.d.ts +7 -0
  560. package/dist/retrievers/self_query/pinecone.js +7 -0
  561. package/dist/retrievers/self_query/supabase.cjs +63 -0
  562. package/dist/retrievers/self_query/supabase.d.ts +67 -0
  563. package/dist/retrievers/self_query/supabase.js +63 -0
  564. package/dist/retrievers/self_query/supabase_utils.cjs +78 -0
  565. package/dist/retrievers/self_query/supabase_utils.d.ts +78 -0
  566. package/dist/retrievers/self_query/supabase_utils.js +78 -0
  567. package/dist/retrievers/self_query/utils.cjs +17 -0
  568. package/dist/retrievers/self_query/utils.d.ts +17 -0
  569. package/dist/retrievers/self_query/utils.js +17 -0
  570. package/dist/retrievers/self_query/weaviate.cjs +42 -0
  571. package/dist/retrievers/self_query/weaviate.d.ts +42 -0
  572. package/dist/retrievers/self_query/weaviate.js +42 -0
  573. package/dist/retrievers/supabase.cjs +30 -0
  574. package/dist/retrievers/supabase.d.ts +30 -0
  575. package/dist/retrievers/supabase.js +30 -0
  576. package/dist/retrievers/time_weighted.cjs +8 -0
  577. package/dist/retrievers/time_weighted.d.ts +12 -0
  578. package/dist/retrievers/time_weighted.js +8 -0
  579. package/dist/retrievers/vespa.cjs +18 -0
  580. package/dist/retrievers/vespa.d.ts +18 -0
  581. package/dist/retrievers/vespa.js +18 -0
  582. package/dist/retrievers/zep.cjs +4 -0
  583. package/dist/retrievers/zep.d.ts +8 -0
  584. package/dist/retrievers/zep.js +4 -0
  585. package/dist/schema/document.cjs +7 -0
  586. package/dist/schema/document.d.ts +7 -0
  587. package/dist/schema/document.js +7 -0
  588. package/dist/schema/index.cjs +70 -0
  589. package/dist/schema/index.d.ts +70 -0
  590. package/dist/schema/index.js +70 -0
  591. package/dist/schema/output_parser.cjs +43 -0
  592. package/dist/schema/output_parser.d.ts +51 -0
  593. package/dist/schema/output_parser.js +43 -0
  594. package/dist/schema/query_constructor.cjs +5 -0
  595. package/dist/schema/query_constructor.d.ts +5 -0
  596. package/dist/schema/query_constructor.js +5 -0
  597. package/dist/schema/retriever.cjs +18 -0
  598. package/dist/schema/retriever.d.ts +18 -0
  599. package/dist/schema/retriever.js +18 -0
  600. package/dist/schema/storage.d.ts +20 -0
  601. package/dist/storage/encoder_backed.cjs +27 -0
  602. package/dist/storage/encoder_backed.d.ts +27 -0
  603. package/dist/storage/encoder_backed.js +27 -0
  604. package/dist/storage/in_memory.cjs +25 -0
  605. package/dist/storage/in_memory.d.ts +25 -0
  606. package/dist/storage/in_memory.js +25 -0
  607. package/dist/storage/ioredis.cjs +25 -0
  608. package/dist/storage/ioredis.d.ts +25 -0
  609. package/dist/storage/ioredis.js +25 -0
  610. package/dist/stores/doc/gcs.cjs +28 -0
  611. package/dist/stores/doc/gcs.d.ts +33 -0
  612. package/dist/stores/doc/gcs.js +28 -0
  613. package/dist/stores/doc/in_memory.cjs +27 -0
  614. package/dist/stores/doc/in_memory.d.ts +27 -0
  615. package/dist/stores/doc/in_memory.js +27 -0
  616. package/dist/stores/file/in_memory.cjs +20 -0
  617. package/dist/stores/file/in_memory.d.ts +20 -0
  618. package/dist/stores/file/in_memory.js +20 -0
  619. package/dist/stores/file/node.cjs +15 -0
  620. package/dist/stores/file/node.d.ts +15 -0
  621. package/dist/stores/file/node.js +15 -0
  622. package/dist/stores/message/dynamodb.cjs +17 -0
  623. package/dist/stores/message/dynamodb.d.ts +23 -0
  624. package/dist/stores/message/dynamodb.js +17 -0
  625. package/dist/stores/message/firestore.cjs +19 -0
  626. package/dist/stores/message/firestore.d.ts +24 -0
  627. package/dist/stores/message/firestore.js +19 -0
  628. package/dist/stores/message/in_memory.cjs +19 -0
  629. package/dist/stores/message/in_memory.d.ts +19 -0
  630. package/dist/stores/message/in_memory.js +19 -0
  631. package/dist/stores/message/ioredis.cjs +17 -0
  632. package/dist/stores/message/ioredis.d.ts +22 -0
  633. package/dist/stores/message/ioredis.js +17 -0
  634. package/dist/stores/message/momento.cjs +18 -0
  635. package/dist/stores/message/momento.d.ts +18 -0
  636. package/dist/stores/message/momento.js +18 -0
  637. package/dist/stores/message/planetscale.cjs +26 -0
  638. package/dist/stores/message/planetscale.d.ts +30 -0
  639. package/dist/stores/message/planetscale.js +26 -0
  640. package/dist/stores/message/redis.cjs +24 -0
  641. package/dist/stores/message/redis.d.ts +27 -0
  642. package/dist/stores/message/redis.js +24 -0
  643. package/dist/stores/message/upstash_redis.cjs +17 -0
  644. package/dist/stores/message/upstash_redis.d.ts +21 -0
  645. package/dist/stores/message/upstash_redis.js +17 -0
  646. package/dist/stores/message/utils.cjs +21 -0
  647. package/dist/stores/message/utils.d.ts +21 -0
  648. package/dist/stores/message/utils.js +21 -0
  649. package/dist/stores/message/xata.cjs +25 -0
  650. package/dist/stores/message/xata.d.ts +29 -0
  651. package/dist/stores/message/xata.js +25 -0
  652. package/dist/tools/IFTTTWebhook.cjs +6 -0
  653. package/dist/tools/IFTTTWebhook.d.ts +6 -0
  654. package/dist/tools/IFTTTWebhook.js +6 -0
  655. package/dist/tools/aiplugin.cjs +12 -0
  656. package/dist/tools/aiplugin.d.ts +16 -0
  657. package/dist/tools/aiplugin.js +12 -0
  658. package/dist/tools/aws_lambda.cjs +9 -0
  659. package/dist/tools/aws_lambda.d.ts +7 -0
  660. package/dist/tools/aws_lambda.js +9 -0
  661. package/dist/tools/aws_sfn.cjs +19 -0
  662. package/dist/tools/aws_sfn.d.ts +19 -0
  663. package/dist/tools/aws_sfn.js +19 -0
  664. package/dist/tools/base.cjs +22 -0
  665. package/dist/tools/base.d.ts +25 -0
  666. package/dist/tools/base.js +22 -0
  667. package/dist/tools/bingserpapi.cjs +10 -0
  668. package/dist/tools/bingserpapi.d.ts +10 -0
  669. package/dist/tools/bingserpapi.js +10 -0
  670. package/dist/tools/brave_search.cjs +6 -0
  671. package/dist/tools/brave_search.d.ts +10 -0
  672. package/dist/tools/brave_search.js +6 -0
  673. package/dist/tools/calculator.cjs +4 -0
  674. package/dist/tools/calculator.d.ts +4 -0
  675. package/dist/tools/calculator.js +4 -0
  676. package/dist/tools/chain.cjs +6 -0
  677. package/dist/tools/chain.d.ts +11 -0
  678. package/dist/tools/chain.js +6 -0
  679. package/dist/tools/convert_to_openai.cjs +6 -0
  680. package/dist/tools/convert_to_openai.d.ts +6 -0
  681. package/dist/tools/convert_to_openai.js +6 -0
  682. package/dist/tools/dadjokeapi.cjs +6 -0
  683. package/dist/tools/dadjokeapi.d.ts +6 -0
  684. package/dist/tools/dadjokeapi.js +6 -0
  685. package/dist/tools/dataforseo_api_search.d.ts +9 -0
  686. package/dist/tools/dynamic.cjs +6 -0
  687. package/dist/tools/dynamic.d.ts +12 -0
  688. package/dist/tools/dynamic.js +6 -0
  689. package/dist/tools/fs.cjs +8 -0
  690. package/dist/tools/fs.d.ts +14 -0
  691. package/dist/tools/fs.js +8 -0
  692. package/dist/tools/google_custom_search.cjs +5 -0
  693. package/dist/tools/google_custom_search.d.ts +8 -0
  694. package/dist/tools/google_custom_search.js +5 -0
  695. package/dist/tools/json.cjs +22 -0
  696. package/dist/tools/json.d.ts +22 -0
  697. package/dist/tools/json.js +22 -0
  698. package/dist/tools/requests.cjs +11 -0
  699. package/dist/tools/requests.d.ts +15 -0
  700. package/dist/tools/requests.js +11 -0
  701. package/dist/tools/searxng_search.cjs +7 -0
  702. package/dist/tools/searxng_search.d.ts +10 -0
  703. package/dist/tools/searxng_search.js +7 -0
  704. package/dist/tools/serpapi.cjs +7 -0
  705. package/dist/tools/serpapi.d.ts +7 -0
  706. package/dist/tools/serpapi.js +7 -0
  707. package/dist/tools/serper.cjs +5 -0
  708. package/dist/tools/serper.d.ts +9 -0
  709. package/dist/tools/serper.js +5 -0
  710. package/dist/tools/sql.cjs +25 -0
  711. package/dist/tools/sql.d.ts +32 -0
  712. package/dist/tools/sql.js +25 -0
  713. package/dist/tools/vectorstore.cjs +11 -0
  714. package/dist/tools/vectorstore.d.ts +14 -0
  715. package/dist/tools/vectorstore.js +11 -0
  716. package/dist/tools/webbrowser.cjs +6 -0
  717. package/dist/tools/webbrowser.d.ts +12 -0
  718. package/dist/tools/webbrowser.js +6 -0
  719. package/dist/tools/wikipedia_query_run.cjs +16 -0
  720. package/dist/tools/wikipedia_query_run.d.ts +24 -0
  721. package/dist/tools/wikipedia_query_run.js +16 -0
  722. package/dist/tools/zapier.cjs +12 -0
  723. package/dist/tools/zapier.d.ts +12 -0
  724. package/dist/tools/zapier.js +12 -0
  725. package/dist/vectorstores/analyticdb.cjs +76 -0
  726. package/dist/vectorstores/analyticdb.d.ts +80 -0
  727. package/dist/vectorstores/analyticdb.js +76 -0
  728. package/dist/vectorstores/base.cjs +13 -0
  729. package/dist/vectorstores/base.d.ts +26 -0
  730. package/dist/vectorstores/base.js +13 -0
  731. package/dist/vectorstores/chroma.cjs +73 -0
  732. package/dist/vectorstores/chroma.d.ts +84 -0
  733. package/dist/vectorstores/chroma.js +73 -0
  734. package/dist/vectorstores/elasticsearch.cjs +73 -0
  735. package/dist/vectorstores/elasticsearch.d.ts +90 -0
  736. package/dist/vectorstores/elasticsearch.js +73 -0
  737. package/dist/vectorstores/faiss.cjs +65 -0
  738. package/dist/vectorstores/faiss.d.ts +69 -0
  739. package/dist/vectorstores/faiss.js +65 -0
  740. package/dist/vectorstores/hnswlib.cjs +71 -0
  741. package/dist/vectorstores/hnswlib.d.ts +80 -0
  742. package/dist/vectorstores/hnswlib.js +71 -0
  743. package/dist/vectorstores/lancedb.cjs +38 -0
  744. package/dist/vectorstores/lancedb.d.ts +42 -0
  745. package/dist/vectorstores/lancedb.js +38 -0
  746. package/dist/vectorstores/memory.cjs +56 -0
  747. package/dist/vectorstores/memory.d.ts +66 -0
  748. package/dist/vectorstores/memory.js +56 -0
  749. package/dist/vectorstores/milvus.cjs +91 -7
  750. package/dist/vectorstores/milvus.d.ts +80 -1
  751. package/dist/vectorstores/milvus.js +91 -7
  752. package/dist/vectorstores/mongo.cjs +45 -0
  753. package/dist/vectorstores/mongo.d.ts +49 -0
  754. package/dist/vectorstores/mongo.js +45 -0
  755. package/dist/vectorstores/mongodb_atlas.cjs +48 -0
  756. package/dist/vectorstores/mongodb_atlas.d.ts +59 -0
  757. package/dist/vectorstores/mongodb_atlas.js +48 -0
  758. package/dist/vectorstores/myscale.cjs +66 -0
  759. package/dist/vectorstores/myscale.d.ts +80 -0
  760. package/dist/vectorstores/myscale.js +66 -0
  761. package/dist/vectorstores/opensearch.cjs +60 -0
  762. package/dist/vectorstores/opensearch.d.ts +74 -0
  763. package/dist/vectorstores/opensearch.js +60 -0
  764. package/dist/vectorstores/pinecone.cjs +54 -0
  765. package/dist/vectorstores/pinecone.d.ts +58 -0
  766. package/dist/vectorstores/pinecone.js +54 -0
  767. package/dist/vectorstores/prisma.cjs +66 -0
  768. package/dist/vectorstores/prisma.d.ts +66 -0
  769. package/dist/vectorstores/prisma.js +66 -0
  770. package/dist/vectorstores/qdrant.cjs +60 -0
  771. package/dist/vectorstores/qdrant.d.ts +66 -0
  772. package/dist/vectorstores/qdrant.js +60 -0
  773. package/dist/vectorstores/redis.cjs +62 -0
  774. package/dist/vectorstores/redis.d.ts +88 -0
  775. package/dist/vectorstores/redis.js +62 -0
  776. package/dist/vectorstores/singlestore.cjs +46 -0
  777. package/dist/vectorstores/singlestore.d.ts +46 -0
  778. package/dist/vectorstores/singlestore.js +46 -0
  779. package/dist/vectorstores/supabase.cjs +50 -0
  780. package/dist/vectorstores/supabase.d.ts +53 -0
  781. package/dist/vectorstores/supabase.js +50 -0
  782. package/dist/vectorstores/tigris.cjs +49 -0
  783. package/dist/vectorstores/tigris.d.ts +53 -0
  784. package/dist/vectorstores/tigris.js +49 -0
  785. package/dist/vectorstores/typeorm.cjs +71 -0
  786. package/dist/vectorstores/typeorm.d.ts +76 -0
  787. package/dist/vectorstores/typeorm.js +71 -0
  788. package/dist/vectorstores/typesense.cjs +5 -0
  789. package/dist/vectorstores/typesense.d.ts +5 -0
  790. package/dist/vectorstores/typesense.js +5 -0
  791. package/dist/vectorstores/usearch.cjs +50 -0
  792. package/dist/vectorstores/usearch.d.ts +55 -0
  793. package/dist/vectorstores/usearch.js +50 -0
  794. package/dist/vectorstores/vectara.cjs +104 -0
  795. package/dist/vectorstores/vectara.d.ts +72 -0
  796. package/dist/vectorstores/vectara.js +104 -0
  797. package/dist/vectorstores/weaviate.cjs +61 -0
  798. package/dist/vectorstores/weaviate.d.ts +70 -0
  799. package/dist/vectorstores/weaviate.js +61 -0
  800. package/dist/vectorstores/xata.cjs +36 -0
  801. package/dist/vectorstores/xata.d.ts +43 -0
  802. package/dist/vectorstores/xata.js +36 -0
  803. package/dist/vectorstores/zep.d.ts +11 -0
  804. package/package.json +2 -2
@@ -4,6 +4,10 @@ exports.FunctionalTranslator = void 0;
4
4
  const ir_js_1 = require("../../chains/query_constructor/ir.cjs");
5
5
  const base_js_1 = require("./base.cjs");
6
6
  const utils_js_1 = require("./utils.cjs");
7
+ /**
8
+ * A class that extends `BaseTranslator` to translate structured queries
9
+ * into functional filters.
10
+ */
7
11
  class FunctionalTranslator extends base_js_1.BaseTranslator {
8
12
  constructor() {
9
13
  super(...arguments);
@@ -30,6 +34,12 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
30
34
  formatFunction() {
31
35
  throw new Error("Not implemented");
32
36
  }
37
+ /**
38
+ * Returns a function that performs a comparison based on the provided
39
+ * comparator.
40
+ * @param comparator The comparator to base the comparison function on.
41
+ * @returns A function that takes two arguments and returns a boolean based on the comparison.
42
+ */
33
43
  getComparatorFunction(comparator) {
34
44
  switch (comparator) {
35
45
  case ir_js_1.Comparators.eq: {
@@ -55,6 +65,12 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
55
65
  }
56
66
  }
57
67
  }
68
+ /**
69
+ * Returns a function that performs an operation based on the provided
70
+ * operator.
71
+ * @param operator The operator to base the operation function on.
72
+ * @returns A function that takes two boolean arguments and returns a boolean based on the operation.
73
+ */
58
74
  getOperatorFunction(operator) {
59
75
  switch (operator) {
60
76
  case ir_js_1.Operators.and: {
@@ -68,6 +84,12 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
68
84
  }
69
85
  }
70
86
  }
87
+ /**
88
+ * Visits the operation part of a structured query and translates it into
89
+ * a functional filter.
90
+ * @param operation The operation part of a structured query.
91
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the operation.
92
+ */
71
93
  visitOperation(operation) {
72
94
  const { operator, args } = operation;
73
95
  if (this.allowedOperators.includes(operator)) {
@@ -91,6 +113,12 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
91
113
  throw new Error("Operator not allowed");
92
114
  }
93
115
  }
116
+ /**
117
+ * Visits the comparison part of a structured query and translates it into
118
+ * a functional filter.
119
+ * @param comparison The comparison part of a structured query.
120
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the comparison.
121
+ */
94
122
  visitComparison(comparison) {
95
123
  const { comparator, attribute, value } = comparison;
96
124
  const undefinedTrue = [ir_js_1.Comparators.ne];
@@ -111,6 +139,11 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
111
139
  throw new Error("Comparator not allowed");
112
140
  }
113
141
  }
142
+ /**
143
+ * Visits a structured query and translates it into a functional filter.
144
+ * @param query The structured query to translate.
145
+ * @returns An object containing a `filter` property, which is a function that takes a `Document` as an argument and returns a boolean based on the structured query.
146
+ */
114
147
  visitStructuredQuery(query) {
115
148
  if (!query.filter) {
116
149
  return {};
@@ -121,6 +154,13 @@ class FunctionalTranslator extends base_js_1.BaseTranslator {
121
154
  }
122
155
  return { filter: filterFunction };
123
156
  }
157
+ /**
158
+ * Merges two filters into one, based on the specified merge type.
159
+ * @param defaultFilter The default filter function.
160
+ * @param generatedFilter The generated filter function.
161
+ * @param mergeType The type of merge to perform. Can be 'and', 'or', or 'replace'. Default is 'and'.
162
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the merged filters, or `undefined` if both filters are empty.
163
+ */
124
164
  mergeFilters(defaultFilter, generatedFilter, mergeType = "and") {
125
165
  if ((0, utils_js_1.isFilterEmpty)(defaultFilter) && (0, utils_js_1.isFilterEmpty)(generatedFilter)) {
126
166
  return undefined;
@@ -1,6 +1,11 @@
1
1
  import { Comparator, Comparison, Operation, Operator, StructuredQuery } from "../../chains/query_constructor/ir.js";
2
2
  import { Document } from "../../document.js";
3
3
  import { BaseTranslator } from "./base.js";
4
+ /**
5
+ * A type alias for an object that maps comparison operators to string or
6
+ * number values. This is used in the comparison functions to determine
7
+ * the result of a comparison operation.
8
+ */
4
9
  type ValueType = {
5
10
  eq: string | number;
6
11
  ne: string | number;
@@ -9,7 +14,15 @@ type ValueType = {
9
14
  gt: string | number;
10
15
  gte: string | number;
11
16
  };
17
+ /**
18
+ * A type alias for a function that takes a `Document` as an argument and
19
+ * returns a boolean. This function is used as a filter for documents.
20
+ */
12
21
  export type FunctionFilter = (document: Document) => boolean;
22
+ /**
23
+ * A class that extends `BaseTranslator` to translate structured queries
24
+ * into functional filters.
25
+ */
13
26
  export declare class FunctionalTranslator extends BaseTranslator {
14
27
  VisitOperationOutput: FunctionFilter;
15
28
  VisitComparisonOutput: FunctionFilter;
@@ -21,11 +34,47 @@ export declare class FunctionalTranslator extends BaseTranslator {
21
34
  allowedOperators: Operator[];
22
35
  allowedComparators: Comparator[];
23
36
  formatFunction(): string;
37
+ /**
38
+ * Returns a function that performs a comparison based on the provided
39
+ * comparator.
40
+ * @param comparator The comparator to base the comparison function on.
41
+ * @returns A function that takes two arguments and returns a boolean based on the comparison.
42
+ */
24
43
  getComparatorFunction<C extends Comparator>(comparator: Comparator): (a: string | number, b: ValueType[C]) => boolean;
44
+ /**
45
+ * Returns a function that performs an operation based on the provided
46
+ * operator.
47
+ * @param operator The operator to base the operation function on.
48
+ * @returns A function that takes two boolean arguments and returns a boolean based on the operation.
49
+ */
25
50
  getOperatorFunction(operator: Operator): (a: boolean, b: boolean) => boolean;
51
+ /**
52
+ * Visits the operation part of a structured query and translates it into
53
+ * a functional filter.
54
+ * @param operation The operation part of a structured query.
55
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the operation.
56
+ */
26
57
  visitOperation(operation: Operation): this["VisitOperationOutput"];
58
+ /**
59
+ * Visits the comparison part of a structured query and translates it into
60
+ * a functional filter.
61
+ * @param comparison The comparison part of a structured query.
62
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the comparison.
63
+ */
27
64
  visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
65
+ /**
66
+ * Visits a structured query and translates it into a functional filter.
67
+ * @param query The structured query to translate.
68
+ * @returns An object containing a `filter` property, which is a function that takes a `Document` as an argument and returns a boolean based on the structured query.
69
+ */
28
70
  visitStructuredQuery(query: StructuredQuery): this["VisitStructuredQueryOutput"];
71
+ /**
72
+ * Merges two filters into one, based on the specified merge type.
73
+ * @param defaultFilter The default filter function.
74
+ * @param generatedFilter The generated filter function.
75
+ * @param mergeType The type of merge to perform. Can be 'and', 'or', or 'replace'. Default is 'and'.
76
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the merged filters, or `undefined` if both filters are empty.
77
+ */
29
78
  mergeFilters(defaultFilter: FunctionFilter, generatedFilter: FunctionFilter, mergeType?: string): FunctionFilter | undefined;
30
79
  }
31
80
  export {};
@@ -1,6 +1,10 @@
1
1
  import { Comparators, Operators, } from "../../chains/query_constructor/ir.js";
2
2
  import { BaseTranslator } from "./base.js";
3
3
  import { isFilterEmpty } from "./utils.js";
4
+ /**
5
+ * A class that extends `BaseTranslator` to translate structured queries
6
+ * into functional filters.
7
+ */
4
8
  export class FunctionalTranslator extends BaseTranslator {
5
9
  constructor() {
6
10
  super(...arguments);
@@ -27,6 +31,12 @@ export class FunctionalTranslator extends BaseTranslator {
27
31
  formatFunction() {
28
32
  throw new Error("Not implemented");
29
33
  }
34
+ /**
35
+ * Returns a function that performs a comparison based on the provided
36
+ * comparator.
37
+ * @param comparator The comparator to base the comparison function on.
38
+ * @returns A function that takes two arguments and returns a boolean based on the comparison.
39
+ */
30
40
  getComparatorFunction(comparator) {
31
41
  switch (comparator) {
32
42
  case Comparators.eq: {
@@ -52,6 +62,12 @@ export class FunctionalTranslator extends BaseTranslator {
52
62
  }
53
63
  }
54
64
  }
65
+ /**
66
+ * Returns a function that performs an operation based on the provided
67
+ * operator.
68
+ * @param operator The operator to base the operation function on.
69
+ * @returns A function that takes two boolean arguments and returns a boolean based on the operation.
70
+ */
55
71
  getOperatorFunction(operator) {
56
72
  switch (operator) {
57
73
  case Operators.and: {
@@ -65,6 +81,12 @@ export class FunctionalTranslator extends BaseTranslator {
65
81
  }
66
82
  }
67
83
  }
84
+ /**
85
+ * Visits the operation part of a structured query and translates it into
86
+ * a functional filter.
87
+ * @param operation The operation part of a structured query.
88
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the operation.
89
+ */
68
90
  visitOperation(operation) {
69
91
  const { operator, args } = operation;
70
92
  if (this.allowedOperators.includes(operator)) {
@@ -88,6 +110,12 @@ export class FunctionalTranslator extends BaseTranslator {
88
110
  throw new Error("Operator not allowed");
89
111
  }
90
112
  }
113
+ /**
114
+ * Visits the comparison part of a structured query and translates it into
115
+ * a functional filter.
116
+ * @param comparison The comparison part of a structured query.
117
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the comparison.
118
+ */
91
119
  visitComparison(comparison) {
92
120
  const { comparator, attribute, value } = comparison;
93
121
  const undefinedTrue = [Comparators.ne];
@@ -108,6 +136,11 @@ export class FunctionalTranslator extends BaseTranslator {
108
136
  throw new Error("Comparator not allowed");
109
137
  }
110
138
  }
139
+ /**
140
+ * Visits a structured query and translates it into a functional filter.
141
+ * @param query The structured query to translate.
142
+ * @returns An object containing a `filter` property, which is a function that takes a `Document` as an argument and returns a boolean based on the structured query.
143
+ */
111
144
  visitStructuredQuery(query) {
112
145
  if (!query.filter) {
113
146
  return {};
@@ -118,6 +151,13 @@ export class FunctionalTranslator extends BaseTranslator {
118
151
  }
119
152
  return { filter: filterFunction };
120
153
  }
154
+ /**
155
+ * Merges two filters into one, based on the specified merge type.
156
+ * @param defaultFilter The default filter function.
157
+ * @param generatedFilter The generated filter function.
158
+ * @param mergeType The type of merge to perform. Can be 'and', 'or', or 'replace'. Default is 'and'.
159
+ * @returns A function that takes a `Document` as an argument and returns a boolean based on the merged filters, or `undefined` if both filters are empty.
160
+ */
121
161
  mergeFilters(defaultFilter, generatedFilter, mergeType = "and") {
122
162
  if (isFilterEmpty(defaultFilter) && isFilterEmpty(generatedFilter)) {
123
163
  return undefined;
@@ -8,6 +8,11 @@ Object.defineProperty(exports, "FunctionalTranslator", { enumerable: true, get:
8
8
  const base_js_1 = require("./base.cjs");
9
9
  Object.defineProperty(exports, "BaseTranslator", { enumerable: true, get: function () { return base_js_1.BaseTranslator; } });
10
10
  Object.defineProperty(exports, "BasicTranslator", { enumerable: true, get: function () { return base_js_1.BasicTranslator; } });
11
+ /**
12
+ * Class for question answering over an index. It retrieves relevant
13
+ * documents based on a query. It extends the BaseRetriever class and
14
+ * implements the SelfQueryRetrieverArgs interface.
15
+ */
11
16
  class SelfQueryRetriever extends retriever_js_1.BaseRetriever {
12
17
  static lc_name() {
13
18
  return "SelfQueryRetriever";
@@ -79,6 +84,15 @@ class SelfQueryRetriever extends retriever_js_1.BaseRetriever {
79
84
  return this.vectorStore.similaritySearch(myQuery, this.searchParams?.k, filter, runManager?.getChild("vectorstore"));
80
85
  }
81
86
  }
87
+ /**
88
+ * Static method to create a new SelfQueryRetriever instance from a
89
+ * BaseLanguageModel and a VectorStore. It first loads a query constructor
90
+ * chain using the loadQueryConstructorChain function, then creates a new
91
+ * SelfQueryRetriever instance with the loaded chain and the provided
92
+ * options.
93
+ * @param options The options used to create the SelfQueryRetriever instance. It includes the QueryConstructorChainOptions and all the SelfQueryRetrieverArgs except 'llmChain'.
94
+ * @returns A new instance of SelfQueryRetriever.
95
+ */
82
96
  static fromLLM(options) {
83
97
  const { structuredQueryTranslator, allowedComparators, allowedOperators, llm, documentContents, attributeInfo, examples, vectorStore, ...rest } = options;
84
98
  const llmChain = (0, index_js_1.loadQueryConstructorChain)({
@@ -7,6 +7,10 @@ import { FunctionalTranslator } from "./functional.js";
7
7
  import { BaseTranslator, BasicTranslator } from "./base.js";
8
8
  import { CallbackManagerForRetrieverRun } from "../../callbacks/manager.js";
9
9
  export { BaseTranslator, BasicTranslator, FunctionalTranslator };
10
+ /**
11
+ * Interface for the arguments required to create a SelfQueryRetriever
12
+ * instance. It extends the BaseRetrieverInput interface.
13
+ */
10
14
  export interface SelfQueryRetrieverArgs<T extends VectorStore> extends BaseRetrieverInput {
11
15
  vectorStore: T;
12
16
  structuredQueryTranslator: BaseTranslator<T>;
@@ -19,6 +23,11 @@ export interface SelfQueryRetrieverArgs<T extends VectorStore> extends BaseRetri
19
23
  mergeFiltersOperator?: "or" | "and" | "replace";
20
24
  };
21
25
  }
26
+ /**
27
+ * Class for question answering over an index. It retrieves relevant
28
+ * documents based on a query. It extends the BaseRetriever class and
29
+ * implements the SelfQueryRetrieverArgs interface.
30
+ */
22
31
  export declare class SelfQueryRetriever<T extends VectorStore> extends BaseRetriever implements SelfQueryRetrieverArgs<T> {
23
32
  static lc_name(): string;
24
33
  get lc_namespace(): string[];
@@ -34,5 +43,14 @@ export declare class SelfQueryRetriever<T extends VectorStore> extends BaseRetri
34
43
  };
35
44
  constructor(options: SelfQueryRetrieverArgs<T>);
36
45
  _getRelevantDocuments(query: string, runManager?: CallbackManagerForRetrieverRun): Promise<Document<Record<string, unknown>>[]>;
46
+ /**
47
+ * Static method to create a new SelfQueryRetriever instance from a
48
+ * BaseLanguageModel and a VectorStore. It first loads a query constructor
49
+ * chain using the loadQueryConstructorChain function, then creates a new
50
+ * SelfQueryRetriever instance with the loaded chain and the provided
51
+ * options.
52
+ * @param options The options used to create the SelfQueryRetriever instance. It includes the QueryConstructorChainOptions and all the SelfQueryRetrieverArgs except 'llmChain'.
53
+ * @returns A new instance of SelfQueryRetriever.
54
+ */
37
55
  static fromLLM<T extends VectorStore>(options: QueryConstructorChainOptions & Omit<SelfQueryRetrieverArgs<T>, "llmChain">): SelfQueryRetriever<T>;
38
56
  }
@@ -3,6 +3,11 @@ import { BaseRetriever } from "../../schema/retriever.js";
3
3
  import { FunctionalTranslator } from "./functional.js";
4
4
  import { BaseTranslator, BasicTranslator } from "./base.js";
5
5
  export { BaseTranslator, BasicTranslator, FunctionalTranslator };
6
+ /**
7
+ * Class for question answering over an index. It retrieves relevant
8
+ * documents based on a query. It extends the BaseRetriever class and
9
+ * implements the SelfQueryRetrieverArgs interface.
10
+ */
6
11
  export class SelfQueryRetriever extends BaseRetriever {
7
12
  static lc_name() {
8
13
  return "SelfQueryRetriever";
@@ -74,6 +79,15 @@ export class SelfQueryRetriever extends BaseRetriever {
74
79
  return this.vectorStore.similaritySearch(myQuery, this.searchParams?.k, filter, runManager?.getChild("vectorstore"));
75
80
  }
76
81
  }
82
+ /**
83
+ * Static method to create a new SelfQueryRetriever instance from a
84
+ * BaseLanguageModel and a VectorStore. It first loads a query constructor
85
+ * chain using the loadQueryConstructorChain function, then creates a new
86
+ * SelfQueryRetriever instance with the loaded chain and the provided
87
+ * options.
88
+ * @param options The options used to create the SelfQueryRetriever instance. It includes the QueryConstructorChainOptions and all the SelfQueryRetrieverArgs except 'llmChain'.
89
+ * @returns A new instance of SelfQueryRetriever.
90
+ */
77
91
  static fromLLM(options) {
78
92
  const { structuredQueryTranslator, allowedComparators, allowedOperators, llm, documentContents, attributeInfo, examples, vectorStore, ...rest } = options;
79
93
  const llmChain = loadQueryConstructorChain({
@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.PineconeTranslator = void 0;
4
4
  const ir_js_1 = require("../../chains/query_constructor/ir.cjs");
5
5
  const base_js_1 = require("./base.cjs");
6
+ /**
7
+ * Specialized translator class that extends the BasicTranslator. It is
8
+ * designed to work with PineconeStore, a type of vector store in
9
+ * LangChain. The class is initialized with a set of allowed operators and
10
+ * comparators, which are used in the translation process to construct
11
+ * queries and compare results.
12
+ */
6
13
  class PineconeTranslator extends base_js_1.BasicTranslator {
7
14
  constructor() {
8
15
  super({
@@ -1,5 +1,12 @@
1
1
  import { PineconeStore } from "../../vectorstores/pinecone.js";
2
2
  import { BasicTranslator } from "./base.js";
3
+ /**
4
+ * Specialized translator class that extends the BasicTranslator. It is
5
+ * designed to work with PineconeStore, a type of vector store in
6
+ * LangChain. The class is initialized with a set of allowed operators and
7
+ * comparators, which are used in the translation process to construct
8
+ * queries and compare results.
9
+ */
3
10
  export declare class PineconeTranslator<T extends PineconeStore> extends BasicTranslator<T> {
4
11
  constructor();
5
12
  }
@@ -1,5 +1,12 @@
1
1
  import { Comparators, Operators } from "../../chains/query_constructor/ir.js";
2
2
  import { BasicTranslator } from "./base.js";
3
+ /**
4
+ * Specialized translator class that extends the BasicTranslator. It is
5
+ * designed to work with PineconeStore, a type of vector store in
6
+ * LangChain. The class is initialized with a set of allowed operators and
7
+ * comparators, which are used in the translation process to construct
8
+ * queries and compare results.
9
+ */
3
10
  export class PineconeTranslator extends BasicTranslator {
4
11
  constructor() {
5
12
  super({
@@ -5,6 +5,11 @@ const ir_js_1 = require("../../chains/query_constructor/ir.cjs");
5
5
  const base_js_1 = require("./base.cjs");
6
6
  const utils_js_1 = require("./utils.cjs");
7
7
  const supabase_utils_js_1 = require("./supabase_utils.cjs");
8
+ /**
9
+ * A specialized translator designed to work with Supabase, extending the
10
+ * BaseTranslator class. It translates structured queries into a format
11
+ * that can be understood by the Supabase database.
12
+ */
8
13
  class SupabaseTranslator extends base_js_1.BaseTranslator {
9
14
  constructor() {
10
15
  super(...arguments);
@@ -31,6 +36,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
31
36
  formatFunction() {
32
37
  throw new Error("Not implemented");
33
38
  }
39
+ /**
40
+ * Returns a function that applies the appropriate comparator operation on
41
+ * the attribute and value provided. The function returned is used to
42
+ * filter data in a Supabase database.
43
+ * @param comparator The comparator to be used in the operation.
44
+ * @returns A function that applies the comparator operation on the attribute and value provided.
45
+ */
34
46
  getComparatorFunction(comparator) {
35
47
  switch (comparator) {
36
48
  case ir_js_1.Comparators.eq: {
@@ -56,6 +68,14 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
56
68
  }
57
69
  }
58
70
  }
71
+ /**
72
+ * Builds a column name based on the attribute and value provided. The
73
+ * column name is used in filtering data in a Supabase database.
74
+ * @param attr The attribute to be used in the column name.
75
+ * @param value The value to be used in the column name.
76
+ * @param includeType Whether to include the data type in the column name.
77
+ * @returns The built column name.
78
+ */
59
79
  buildColumnName(attr, value, includeType = true) {
60
80
  let column = "";
61
81
  if ((0, utils_js_1.isString)(value)) {
@@ -72,6 +92,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
72
92
  }
73
93
  return column;
74
94
  }
95
+ /**
96
+ * Visits an operation and returns a string representation of it. This is
97
+ * used in translating a structured query into a format that can be
98
+ * understood by Supabase.
99
+ * @param operation The operation to be visited.
100
+ * @returns A string representation of the operation.
101
+ */
75
102
  visitOperationAsString(operation) {
76
103
  const { args } = operation;
77
104
  if (!args) {
@@ -90,6 +117,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
90
117
  }, [])
91
118
  .join(",");
92
119
  }
120
+ /**
121
+ * Visits an operation and returns a function that applies the operation
122
+ * on a Supabase database. This is used in translating a structured query
123
+ * into a format that can be understood by Supabase.
124
+ * @param operation The operation to be visited.
125
+ * @returns A function that applies the operation on a Supabase database.
126
+ */
93
127
  visitOperation(operation) {
94
128
  const { operator, args } = operation;
95
129
  if (this.allowedOperators.includes(operator)) {
@@ -114,6 +148,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
114
148
  throw new Error("Operator not allowed");
115
149
  }
116
150
  }
151
+ /**
152
+ * Visits a comparison and returns a string representation of it. This is
153
+ * used in translating a structured query into a format that can be
154
+ * understood by Supabase.
155
+ * @param comparison The comparison to be visited.
156
+ * @returns A string representation of the comparison.
157
+ */
117
158
  visitComparisonAsString(comparison) {
118
159
  let { value } = comparison;
119
160
  const { comparator: _comparator, attribute } = comparison;
@@ -132,6 +173,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
132
173
  }
133
174
  return `${this.buildColumnName(attribute, value, false)}.${comparator}.${value}}`;
134
175
  }
176
+ /**
177
+ * Visits a comparison and returns a function that applies the comparison
178
+ * on a Supabase database. This is used in translating a structured query
179
+ * into a format that can be understood by Supabase.
180
+ * @param comparison The comparison to be visited.
181
+ * @returns A function that applies the comparison on a Supabase database.
182
+ */
135
183
  visitComparison(comparison) {
136
184
  const { comparator, attribute, value } = comparison;
137
185
  if (this.allowedComparators.includes(comparator)) {
@@ -142,6 +190,13 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
142
190
  throw new Error("Comparator not allowed");
143
191
  }
144
192
  }
193
+ /**
194
+ * Visits a structured query and returns a function that applies the query
195
+ * on a Supabase database. This is used in translating a structured query
196
+ * into a format that can be understood by Supabase.
197
+ * @param query The structured query to be visited.
198
+ * @returns A function that applies the query on a Supabase database.
199
+ */
145
200
  visitStructuredQuery(query) {
146
201
  if (!query.filter) {
147
202
  return {};
@@ -149,6 +204,14 @@ class SupabaseTranslator extends base_js_1.BaseTranslator {
149
204
  const filterFunction = query.filter?.accept(this);
150
205
  return { filter: filterFunction ?? {} };
151
206
  }
207
+ /**
208
+ * Merges two filters into one. The merged filter can be used to filter
209
+ * data in a Supabase database.
210
+ * @param defaultFilter The default filter to be merged.
211
+ * @param generatedFilter The generated filter to be merged.
212
+ * @param mergeType The type of merge to be performed. It can be 'and', 'or', or 'replace'.
213
+ * @returns The merged filter.
214
+ */
152
215
  mergeFilters(defaultFilter, generatedFilter, mergeType = "and") {
153
216
  if ((0, utils_js_1.isFilterEmpty)(defaultFilter) && (0, utils_js_1.isFilterEmpty)(generatedFilter)) {
154
217
  return undefined;
@@ -1,6 +1,10 @@
1
1
  import { Comparator, Comparison, Operation, Operator, StructuredQuery } from "../../chains/query_constructor/ir.js";
2
2
  import type { SupabaseFilterRPCCall, SupabaseMetadata, SupabaseVectorStore } from "../../vectorstores/supabase.js";
3
3
  import { BaseTranslator } from "./base.js";
4
+ /**
5
+ * Represents the possible values that can be used in a comparison in a
6
+ * structured query. It can be a string or a number.
7
+ */
4
8
  type ValueType = {
5
9
  eq: string | number;
6
10
  ne: string | number;
@@ -9,19 +13,82 @@ type ValueType = {
9
13
  gt: string | number;
10
14
  gte: string | number;
11
15
  };
16
+ /**
17
+ * A specialized translator designed to work with Supabase, extending the
18
+ * BaseTranslator class. It translates structured queries into a format
19
+ * that can be understood by the Supabase database.
20
+ */
12
21
  export declare class SupabaseTranslator<T extends SupabaseVectorStore> extends BaseTranslator<T> {
13
22
  VisitOperationOutput: SupabaseFilterRPCCall;
14
23
  VisitComparisonOutput: SupabaseFilterRPCCall;
15
24
  allowedOperators: Operator[];
16
25
  allowedComparators: Comparator[];
17
26
  formatFunction(): string;
27
+ /**
28
+ * Returns a function that applies the appropriate comparator operation on
29
+ * the attribute and value provided. The function returned is used to
30
+ * filter data in a Supabase database.
31
+ * @param comparator The comparator to be used in the operation.
32
+ * @returns A function that applies the comparator operation on the attribute and value provided.
33
+ */
18
34
  getComparatorFunction<C extends Comparator>(comparator: Comparator): (attr: string, value: ValueType[C]) => SupabaseFilterRPCCall;
35
+ /**
36
+ * Builds a column name based on the attribute and value provided. The
37
+ * column name is used in filtering data in a Supabase database.
38
+ * @param attr The attribute to be used in the column name.
39
+ * @param value The value to be used in the column name.
40
+ * @param includeType Whether to include the data type in the column name.
41
+ * @returns The built column name.
42
+ */
19
43
  buildColumnName(attr: string, value: string | number, includeType?: boolean): string;
44
+ /**
45
+ * Visits an operation and returns a string representation of it. This is
46
+ * used in translating a structured query into a format that can be
47
+ * understood by Supabase.
48
+ * @param operation The operation to be visited.
49
+ * @returns A string representation of the operation.
50
+ */
20
51
  visitOperationAsString(operation: Operation): string;
52
+ /**
53
+ * Visits an operation and returns a function that applies the operation
54
+ * on a Supabase database. This is used in translating a structured query
55
+ * into a format that can be understood by Supabase.
56
+ * @param operation The operation to be visited.
57
+ * @returns A function that applies the operation on a Supabase database.
58
+ */
21
59
  visitOperation(operation: Operation): this["VisitOperationOutput"];
60
+ /**
61
+ * Visits a comparison and returns a string representation of it. This is
62
+ * used in translating a structured query into a format that can be
63
+ * understood by Supabase.
64
+ * @param comparison The comparison to be visited.
65
+ * @returns A string representation of the comparison.
66
+ */
22
67
  visitComparisonAsString(comparison: Comparison): string;
68
+ /**
69
+ * Visits a comparison and returns a function that applies the comparison
70
+ * on a Supabase database. This is used in translating a structured query
71
+ * into a format that can be understood by Supabase.
72
+ * @param comparison The comparison to be visited.
73
+ * @returns A function that applies the comparison on a Supabase database.
74
+ */
23
75
  visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
76
+ /**
77
+ * Visits a structured query and returns a function that applies the query
78
+ * on a Supabase database. This is used in translating a structured query
79
+ * into a format that can be understood by Supabase.
80
+ * @param query The structured query to be visited.
81
+ * @returns A function that applies the query on a Supabase database.
82
+ */
24
83
  visitStructuredQuery(query: StructuredQuery): this["VisitStructuredQueryOutput"];
84
+ /**
85
+ * Merges two filters into one. The merged filter can be used to filter
86
+ * data in a Supabase database.
87
+ * @param defaultFilter The default filter to be merged.
88
+ * @param generatedFilter The generated filter to be merged.
89
+ * @param mergeType The type of merge to be performed. It can be 'and', 'or', or 'replace'.
90
+ * @returns The merged filter.
91
+ */
25
92
  mergeFilters(defaultFilter: SupabaseFilterRPCCall | SupabaseMetadata | undefined, generatedFilter: SupabaseFilterRPCCall | undefined, mergeType?: string): SupabaseFilterRPCCall | SupabaseMetadata | undefined;
26
93
  }
27
94
  export {};