langchain 0.0.191 → 0.0.193

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 (502) hide show
  1. package/cache/file_system.cjs +1 -0
  2. package/cache/file_system.d.ts +1 -0
  3. package/cache/file_system.js +1 -0
  4. package/dist/agents/agent.cjs +24 -0
  5. package/dist/agents/agent.d.ts +24 -0
  6. package/dist/agents/agent.js +24 -0
  7. package/dist/agents/chat/outputParser.cjs +32 -0
  8. package/dist/agents/chat/outputParser.d.ts +32 -0
  9. package/dist/agents/chat/outputParser.js +32 -0
  10. package/dist/agents/executor.cjs +14 -0
  11. package/dist/agents/executor.d.ts +14 -0
  12. package/dist/agents/executor.js +14 -0
  13. package/dist/agents/mrkl/index.cjs +21 -0
  14. package/dist/agents/mrkl/index.d.ts +21 -0
  15. package/dist/agents/mrkl/index.js +21 -0
  16. package/dist/agents/openai/output_parser.cjs +65 -0
  17. package/dist/agents/openai/output_parser.d.ts +65 -0
  18. package/dist/agents/openai/output_parser.js +65 -0
  19. package/dist/agents/react/output_parser.cjs +16 -0
  20. package/dist/agents/react/output_parser.d.ts +16 -0
  21. package/dist/agents/react/output_parser.js +16 -0
  22. package/dist/agents/structured_chat/outputParser.cjs +12 -0
  23. package/dist/agents/structured_chat/outputParser.d.ts +12 -0
  24. package/dist/agents/structured_chat/outputParser.js +12 -0
  25. package/dist/agents/toolkits/aws_sfn.cjs +20 -0
  26. package/dist/agents/toolkits/aws_sfn.d.ts +20 -0
  27. package/dist/agents/toolkits/aws_sfn.js +20 -0
  28. package/dist/agents/toolkits/json/json.cjs +8 -0
  29. package/dist/agents/toolkits/json/json.d.ts +8 -0
  30. package/dist/agents/toolkits/json/json.js +8 -0
  31. package/dist/agents/toolkits/openapi/openapi.cjs +18 -0
  32. package/dist/agents/toolkits/openapi/openapi.d.ts +18 -0
  33. package/dist/agents/toolkits/openapi/openapi.js +18 -0
  34. package/dist/agents/toolkits/sql/sql.cjs +8 -0
  35. package/dist/agents/toolkits/sql/sql.d.ts +8 -0
  36. package/dist/agents/toolkits/sql/sql.js +8 -0
  37. package/dist/agents/toolkits/vectorstore/vectorstore.cjs +16 -0
  38. package/dist/agents/toolkits/vectorstore/vectorstore.d.ts +16 -0
  39. package/dist/agents/toolkits/vectorstore/vectorstore.js +16 -0
  40. package/dist/agents/toolkits/zapier/zapier.cjs +10 -0
  41. package/dist/agents/toolkits/zapier/zapier.d.ts +10 -0
  42. package/dist/agents/toolkits/zapier/zapier.js +10 -0
  43. package/dist/agents/xml/output_parser.cjs +21 -0
  44. package/dist/agents/xml/output_parser.d.ts +21 -0
  45. package/dist/agents/xml/output_parser.js +21 -0
  46. package/dist/cache/cloudflare_kv.cjs +13 -0
  47. package/dist/cache/cloudflare_kv.d.ts +13 -0
  48. package/dist/cache/cloudflare_kv.js +13 -0
  49. package/dist/cache/file_system.cjs +73 -0
  50. package/dist/cache/file_system.d.ts +33 -0
  51. package/dist/cache/file_system.js +66 -0
  52. package/dist/cache/ioredis.cjs +13 -0
  53. package/dist/cache/ioredis.d.ts +13 -0
  54. package/dist/cache/ioredis.js +13 -0
  55. package/dist/cache/momento.cjs +19 -0
  56. package/dist/cache/momento.d.ts +19 -0
  57. package/dist/cache/momento.js +19 -0
  58. package/dist/cache/redis.cjs +10 -0
  59. package/dist/cache/redis.d.ts +10 -0
  60. package/dist/cache/redis.js +10 -0
  61. package/dist/cache/upstash_redis.cjs +15 -0
  62. package/dist/cache/upstash_redis.d.ts +15 -0
  63. package/dist/cache/upstash_redis.js +15 -0
  64. package/dist/callbacks/handlers/console.cjs +10 -0
  65. package/dist/callbacks/handlers/console.d.ts +10 -0
  66. package/dist/callbacks/handlers/console.js +10 -0
  67. package/dist/callbacks/manager.cjs +49 -0
  68. package/dist/callbacks/manager.d.ts +49 -0
  69. package/dist/callbacks/manager.js +49 -0
  70. package/dist/chains/analyze_documents_chain.cjs +18 -0
  71. package/dist/chains/analyze_documents_chain.d.ts +18 -0
  72. package/dist/chains/analyze_documents_chain.js +18 -0
  73. package/dist/chains/constitutional_ai/constitutional_chain.cjs +21 -0
  74. package/dist/chains/constitutional_ai/constitutional_chain.d.ts +21 -0
  75. package/dist/chains/constitutional_ai/constitutional_chain.js +21 -0
  76. package/dist/chains/constitutional_ai/constitutional_principle.cjs +21 -0
  77. package/dist/chains/constitutional_ai/constitutional_principle.d.ts +21 -0
  78. package/dist/chains/constitutional_ai/constitutional_principle.js +21 -0
  79. package/dist/chains/conversation.cjs +13 -0
  80. package/dist/chains/conversation.d.ts +13 -0
  81. package/dist/chains/conversation.js +13 -0
  82. package/dist/chains/conversational_retrieval_chain.cjs +29 -0
  83. package/dist/chains/conversational_retrieval_chain.d.ts +29 -0
  84. package/dist/chains/conversational_retrieval_chain.js +29 -0
  85. package/dist/chains/graph_qa/cypher.cjs +10 -0
  86. package/dist/chains/graph_qa/cypher.d.ts +10 -0
  87. package/dist/chains/graph_qa/cypher.js +10 -0
  88. package/dist/chains/openai_moderation.cjs +28 -0
  89. package/dist/chains/openai_moderation.d.ts +28 -0
  90. package/dist/chains/openai_moderation.js +28 -0
  91. package/dist/chains/retrieval_qa.cjs +21 -0
  92. package/dist/chains/retrieval_qa.d.ts +21 -0
  93. package/dist/chains/retrieval_qa.js +21 -0
  94. package/dist/chains/router/multi_prompt.cjs +19 -0
  95. package/dist/chains/router/multi_prompt.d.ts +19 -0
  96. package/dist/chains/router/multi_prompt.js +19 -0
  97. package/dist/chains/router/multi_retrieval_qa.cjs +29 -0
  98. package/dist/chains/router/multi_retrieval_qa.d.ts +29 -0
  99. package/dist/chains/router/multi_retrieval_qa.js +29 -0
  100. package/dist/chains/sequential_chain.cjs +43 -0
  101. package/dist/chains/sequential_chain.d.ts +43 -0
  102. package/dist/chains/sequential_chain.js +43 -0
  103. package/dist/chains/sql_db/sql_db_chain.cjs +9 -0
  104. package/dist/chains/sql_db/sql_db_chain.d.ts +9 -0
  105. package/dist/chains/sql_db/sql_db_chain.js +9 -0
  106. package/dist/chat_models/anthropic.cjs +9 -1
  107. package/dist/chat_models/anthropic.d.ts +9 -1
  108. package/dist/chat_models/anthropic.js +9 -1
  109. package/dist/chat_models/baiduwenxin.cjs +20 -0
  110. package/dist/chat_models/baiduwenxin.d.ts +20 -0
  111. package/dist/chat_models/baiduwenxin.js +20 -0
  112. package/dist/chat_models/base.cjs +2 -0
  113. package/dist/chat_models/base.d.ts +1 -1
  114. package/dist/chat_models/base.js +2 -0
  115. package/dist/chat_models/bedrock/index.cjs +11 -0
  116. package/dist/chat_models/bedrock/index.d.ts +11 -0
  117. package/dist/chat_models/bedrock/index.js +11 -0
  118. package/dist/chat_models/bedrock/web.cjs +10 -1
  119. package/dist/chat_models/bedrock/web.d.ts +9 -0
  120. package/dist/chat_models/bedrock/web.js +10 -1
  121. package/dist/chat_models/cloudflare_workersai.cjs +15 -0
  122. package/dist/chat_models/cloudflare_workersai.d.ts +15 -0
  123. package/dist/chat_models/cloudflare_workersai.js +15 -0
  124. package/dist/chat_models/fake.cjs +16 -0
  125. package/dist/chat_models/fake.d.ts +16 -0
  126. package/dist/chat_models/fake.js +16 -0
  127. package/dist/chat_models/fireworks.cjs +10 -0
  128. package/dist/chat_models/fireworks.d.ts +10 -0
  129. package/dist/chat_models/fireworks.js +10 -0
  130. package/dist/chat_models/googlepalm.cjs +24 -0
  131. package/dist/chat_models/googlepalm.d.ts +24 -0
  132. package/dist/chat_models/googlepalm.js +24 -0
  133. package/dist/chat_models/googlevertexai/index.cjs +7 -0
  134. package/dist/chat_models/googlevertexai/index.d.ts +7 -0
  135. package/dist/chat_models/googlevertexai/index.js +7 -0
  136. package/dist/chat_models/googlevertexai/web.cjs +9 -0
  137. package/dist/chat_models/googlevertexai/web.d.ts +9 -0
  138. package/dist/chat_models/googlevertexai/web.js +9 -0
  139. package/dist/chat_models/iflytek_xinghuo/index.cjs +8 -0
  140. package/dist/chat_models/iflytek_xinghuo/index.d.ts +8 -0
  141. package/dist/chat_models/iflytek_xinghuo/index.js +8 -0
  142. package/dist/chat_models/iflytek_xinghuo/web.cjs +8 -0
  143. package/dist/chat_models/iflytek_xinghuo/web.d.ts +8 -0
  144. package/dist/chat_models/iflytek_xinghuo/web.js +8 -0
  145. package/dist/chat_models/llama_cpp.cjs +17 -0
  146. package/dist/chat_models/llama_cpp.d.ts +17 -0
  147. package/dist/chat_models/llama_cpp.js +17 -0
  148. package/dist/chat_models/minimax.cjs +27 -0
  149. package/dist/chat_models/minimax.d.ts +27 -0
  150. package/dist/chat_models/minimax.js +27 -0
  151. package/dist/chat_models/ollama.cjs +24 -0
  152. package/dist/chat_models/ollama.d.ts +24 -0
  153. package/dist/chat_models/ollama.js +24 -0
  154. package/dist/chat_models/openai.cjs +15 -0
  155. package/dist/chat_models/openai.d.ts +15 -0
  156. package/dist/chat_models/openai.js +15 -0
  157. package/dist/chat_models/yandex.cjs +14 -0
  158. package/dist/chat_models/yandex.d.ts +14 -0
  159. package/dist/chat_models/yandex.js +14 -0
  160. package/dist/document_loaders/fs/directory.cjs +14 -0
  161. package/dist/document_loaders/fs/directory.d.ts +14 -0
  162. package/dist/document_loaders/fs/directory.js +14 -0
  163. package/dist/document_loaders/fs/openai_whisper_audio.cjs +10 -0
  164. package/dist/document_loaders/fs/openai_whisper_audio.d.ts +10 -0
  165. package/dist/document_loaders/fs/openai_whisper_audio.js +10 -0
  166. package/dist/document_loaders/fs/pdf.cjs +15 -2
  167. package/dist/document_loaders/fs/pdf.d.ts +9 -1
  168. package/dist/document_loaders/fs/pdf.js +15 -2
  169. package/dist/document_loaders/fs/srt.cjs +6 -0
  170. package/dist/document_loaders/fs/srt.d.ts +6 -0
  171. package/dist/document_loaders/fs/srt.js +6 -0
  172. package/dist/document_loaders/fs/text.cjs +5 -0
  173. package/dist/document_loaders/fs/text.d.ts +5 -0
  174. package/dist/document_loaders/fs/text.js +5 -0
  175. package/dist/document_loaders/fs/unstructured.cjs +7 -0
  176. package/dist/document_loaders/fs/unstructured.d.ts +7 -0
  177. package/dist/document_loaders/fs/unstructured.js +7 -0
  178. package/dist/document_loaders/web/apify_dataset.cjs +26 -2
  179. package/dist/document_loaders/web/apify_dataset.d.ts +25 -1
  180. package/dist/document_loaders/web/apify_dataset.js +26 -2
  181. package/dist/document_loaders/web/assemblyai.cjs +24 -0
  182. package/dist/document_loaders/web/assemblyai.d.ts +24 -0
  183. package/dist/document_loaders/web/assemblyai.js +24 -0
  184. package/dist/document_loaders/web/azure_blob_storage_file.cjs +11 -0
  185. package/dist/document_loaders/web/azure_blob_storage_file.d.ts +11 -0
  186. package/dist/document_loaders/web/azure_blob_storage_file.js +11 -0
  187. package/dist/document_loaders/web/cheerio.cjs +6 -0
  188. package/dist/document_loaders/web/cheerio.d.ts +6 -0
  189. package/dist/document_loaders/web/cheerio.js +6 -0
  190. package/dist/document_loaders/web/college_confidential.cjs +6 -0
  191. package/dist/document_loaders/web/college_confidential.d.ts +6 -0
  192. package/dist/document_loaders/web/college_confidential.js +6 -0
  193. package/dist/document_loaders/web/confluence.cjs +11 -0
  194. package/dist/document_loaders/web/confluence.d.ts +11 -0
  195. package/dist/document_loaders/web/confluence.js +11 -0
  196. package/dist/document_loaders/web/figma.cjs +9 -0
  197. package/dist/document_loaders/web/figma.d.ts +9 -0
  198. package/dist/document_loaders/web/figma.js +9 -0
  199. package/dist/document_loaders/web/notionapi.cjs +16 -0
  200. package/dist/document_loaders/web/notionapi.d.ts +16 -0
  201. package/dist/document_loaders/web/notionapi.js +16 -0
  202. package/dist/document_loaders/web/notiondb.cjs +11 -1
  203. package/dist/document_loaders/web/notiondb.d.ts +11 -1
  204. package/dist/document_loaders/web/notiondb.js +11 -1
  205. package/dist/document_loaders/web/pdf.cjs +15 -2
  206. package/dist/document_loaders/web/pdf.d.ts +9 -1
  207. package/dist/document_loaders/web/pdf.js +15 -2
  208. package/dist/document_loaders/web/puppeteer.cjs +12 -0
  209. package/dist/document_loaders/web/puppeteer.d.ts +12 -0
  210. package/dist/document_loaders/web/puppeteer.js +12 -0
  211. package/dist/document_loaders/web/s3.cjs +17 -0
  212. package/dist/document_loaders/web/s3.d.ts +17 -0
  213. package/dist/document_loaders/web/s3.js +17 -0
  214. package/dist/document_loaders/web/searchapi.cjs +9 -0
  215. package/dist/document_loaders/web/searchapi.d.ts +9 -0
  216. package/dist/document_loaders/web/searchapi.js +9 -0
  217. package/dist/document_loaders/web/serpapi.cjs +5 -0
  218. package/dist/document_loaders/web/serpapi.d.ts +5 -0
  219. package/dist/document_loaders/web/serpapi.js +5 -0
  220. package/dist/document_loaders/web/sonix_audio.cjs +12 -0
  221. package/dist/document_loaders/web/sonix_audio.d.ts +12 -0
  222. package/dist/document_loaders/web/sonix_audio.js +12 -0
  223. package/dist/document_loaders/web/sort_xyz_blockchain.cjs +22 -0
  224. package/dist/document_loaders/web/sort_xyz_blockchain.d.ts +22 -0
  225. package/dist/document_loaders/web/sort_xyz_blockchain.js +22 -0
  226. package/dist/document_loaders/web/youtube.cjs +9 -0
  227. package/dist/document_loaders/web/youtube.d.ts +9 -0
  228. package/dist/document_loaders/web/youtube.js +9 -0
  229. package/dist/document_transformers/html_to_text.cjs +18 -0
  230. package/dist/document_transformers/html_to_text.d.ts +18 -0
  231. package/dist/document_transformers/html_to_text.js +18 -0
  232. package/dist/document_transformers/mozilla_readability.cjs +18 -0
  233. package/dist/document_transformers/mozilla_readability.d.ts +18 -0
  234. package/dist/document_transformers/mozilla_readability.js +18 -0
  235. package/dist/embeddings/bedrock.cjs +17 -0
  236. package/dist/embeddings/bedrock.d.ts +17 -0
  237. package/dist/embeddings/bedrock.js +17 -0
  238. package/dist/embeddings/cache_backed.cjs +37 -0
  239. package/dist/embeddings/cache_backed.d.ts +37 -0
  240. package/dist/embeddings/cache_backed.js +37 -0
  241. package/dist/embeddings/cohere.cjs +10 -0
  242. package/dist/embeddings/cohere.d.ts +10 -0
  243. package/dist/embeddings/cohere.js +10 -0
  244. package/dist/embeddings/googlepalm.cjs +17 -0
  245. package/dist/embeddings/googlepalm.d.ts +17 -0
  246. package/dist/embeddings/googlepalm.js +17 -0
  247. package/dist/embeddings/googlevertexai.cjs +8 -0
  248. package/dist/embeddings/googlevertexai.d.ts +8 -0
  249. package/dist/embeddings/googlevertexai.js +8 -0
  250. package/dist/embeddings/hf_transformers.cjs +18 -0
  251. package/dist/embeddings/hf_transformers.d.ts +18 -0
  252. package/dist/embeddings/hf_transformers.js +18 -0
  253. package/dist/embeddings/llama_cpp.cjs +16 -0
  254. package/dist/embeddings/llama_cpp.d.ts +16 -0
  255. package/dist/embeddings/llama_cpp.js +16 -0
  256. package/dist/embeddings/minimax.cjs +15 -0
  257. package/dist/embeddings/minimax.d.ts +15 -0
  258. package/dist/embeddings/minimax.js +15 -0
  259. package/dist/embeddings/openai.cjs +10 -0
  260. package/dist/embeddings/openai.d.ts +10 -0
  261. package/dist/embeddings/openai.js +10 -0
  262. package/dist/embeddings/tensorflow.cjs +16 -0
  263. package/dist/embeddings/tensorflow.d.ts +16 -0
  264. package/dist/embeddings/tensorflow.js +16 -0
  265. package/dist/experimental/autogpt/agent.cjs +21 -0
  266. package/dist/experimental/autogpt/agent.d.ts +21 -0
  267. package/dist/experimental/autogpt/agent.js +21 -0
  268. package/dist/experimental/babyagi/agent.cjs +12 -0
  269. package/dist/experimental/babyagi/agent.d.ts +12 -0
  270. package/dist/experimental/babyagi/agent.js +12 -0
  271. package/dist/experimental/chat_models/ollama_functions.cjs +12 -15
  272. package/dist/experimental/chat_models/ollama_functions.d.ts +3 -4
  273. package/dist/experimental/chat_models/ollama_functions.js +13 -16
  274. package/dist/experimental/generative_agents/generative_agent.cjs +30 -0
  275. package/dist/experimental/generative_agents/generative_agent.d.ts +30 -0
  276. package/dist/experimental/generative_agents/generative_agent.js +30 -0
  277. package/dist/experimental/generative_agents/generative_agent_memory.cjs +18 -0
  278. package/dist/experimental/generative_agents/generative_agent_memory.d.ts +18 -0
  279. package/dist/experimental/generative_agents/generative_agent_memory.js +18 -0
  280. package/dist/llms/base.cjs +3 -1
  281. package/dist/llms/base.d.ts +1 -1
  282. package/dist/llms/base.js +3 -1
  283. package/dist/llms/bedrock/web.cjs +1 -1
  284. package/dist/llms/bedrock/web.js +1 -1
  285. package/dist/llms/cohere.cjs +13 -0
  286. package/dist/llms/cohere.d.ts +13 -0
  287. package/dist/llms/cohere.js +13 -0
  288. package/dist/llms/googlevertexai/index.cjs +12 -0
  289. package/dist/llms/googlevertexai/index.d.ts +12 -0
  290. package/dist/llms/googlevertexai/index.js +12 -0
  291. package/dist/llms/googlevertexai/web.cjs +12 -0
  292. package/dist/llms/googlevertexai/web.d.ts +12 -0
  293. package/dist/llms/googlevertexai/web.js +12 -0
  294. package/dist/llms/hf.cjs +13 -0
  295. package/dist/llms/hf.d.ts +13 -0
  296. package/dist/llms/hf.js +13 -0
  297. package/dist/llms/ollama.cjs +19 -0
  298. package/dist/llms/ollama.d.ts +19 -0
  299. package/dist/llms/ollama.js +19 -0
  300. package/dist/llms/openai-chat.cjs +17 -0
  301. package/dist/llms/openai-chat.d.ts +17 -0
  302. package/dist/llms/openai-chat.js +17 -0
  303. package/dist/llms/openai.cjs +14 -0
  304. package/dist/llms/openai.d.ts +14 -0
  305. package/dist/llms/openai.js +14 -0
  306. package/dist/llms/portkey.cjs +24 -0
  307. package/dist/llms/portkey.d.ts +24 -0
  308. package/dist/llms/portkey.js +24 -0
  309. package/dist/llms/replicate.cjs +11 -0
  310. package/dist/llms/replicate.d.ts +11 -0
  311. package/dist/llms/replicate.js +11 -0
  312. package/dist/load/import_constants.cjs +2 -0
  313. package/dist/load/import_constants.js +2 -0
  314. package/dist/memory/buffer_memory.cjs +24 -0
  315. package/dist/memory/buffer_memory.d.ts +24 -0
  316. package/dist/memory/buffer_memory.js +24 -0
  317. package/dist/memory/buffer_token_memory.cjs +15 -0
  318. package/dist/memory/buffer_token_memory.d.ts +15 -0
  319. package/dist/memory/buffer_token_memory.js +15 -0
  320. package/dist/memory/buffer_window_memory.cjs +23 -0
  321. package/dist/memory/buffer_window_memory.d.ts +23 -0
  322. package/dist/memory/buffer_window_memory.js +23 -0
  323. package/dist/memory/entity_memory.cjs +29 -0
  324. package/dist/memory/entity_memory.d.ts +29 -0
  325. package/dist/memory/entity_memory.js +29 -0
  326. package/dist/memory/summary.cjs +24 -0
  327. package/dist/memory/summary.d.ts +24 -0
  328. package/dist/memory/summary.js +24 -0
  329. package/dist/memory/summary_buffer.cjs +32 -0
  330. package/dist/memory/summary_buffer.d.ts +32 -0
  331. package/dist/memory/summary_buffer.js +32 -0
  332. package/dist/memory/vector_store.cjs +24 -0
  333. package/dist/memory/vector_store.d.ts +24 -0
  334. package/dist/memory/vector_store.js +24 -0
  335. package/dist/memory/zep.cjs +34 -0
  336. package/dist/memory/zep.d.ts +34 -0
  337. package/dist/memory/zep.js +34 -0
  338. package/dist/prompts/chat.cjs +31 -0
  339. package/dist/prompts/chat.d.ts +31 -0
  340. package/dist/prompts/chat.js +31 -0
  341. package/dist/prompts/few_shot.cjs +31 -0
  342. package/dist/prompts/few_shot.d.ts +31 -0
  343. package/dist/prompts/few_shot.js +31 -0
  344. package/dist/prompts/pipeline.cjs +39 -0
  345. package/dist/prompts/pipeline.d.ts +39 -0
  346. package/dist/prompts/pipeline.js +39 -0
  347. package/dist/prompts/selectors/LengthBasedExampleSelector.cjs +36 -0
  348. package/dist/prompts/selectors/LengthBasedExampleSelector.d.ts +36 -0
  349. package/dist/prompts/selectors/LengthBasedExampleSelector.js +36 -0
  350. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.cjs +25 -0
  351. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.d.ts +25 -0
  352. package/dist/prompts/selectors/SemanticSimilarityExampleSelector.js +25 -0
  353. package/dist/retrievers/amazon_kendra.cjs +16 -0
  354. package/dist/retrievers/amazon_kendra.d.ts +16 -0
  355. package/dist/retrievers/amazon_kendra.js +16 -0
  356. package/dist/retrievers/chaindesk.cjs +11 -0
  357. package/dist/retrievers/chaindesk.d.ts +11 -0
  358. package/dist/retrievers/chaindesk.js +11 -0
  359. package/dist/retrievers/contextual_compression.cjs +10 -0
  360. package/dist/retrievers/contextual_compression.d.ts +10 -0
  361. package/dist/retrievers/contextual_compression.js +10 -0
  362. package/dist/retrievers/document_compressors/embeddings_filter.cjs +13 -0
  363. package/dist/retrievers/document_compressors/embeddings_filter.d.ts +13 -0
  364. package/dist/retrievers/document_compressors/embeddings_filter.js +13 -0
  365. package/dist/retrievers/document_compressors/index.cjs +26 -0
  366. package/dist/retrievers/document_compressors/index.d.ts +26 -0
  367. package/dist/retrievers/document_compressors/index.js +26 -0
  368. package/dist/retrievers/hyde.cjs +19 -0
  369. package/dist/retrievers/hyde.d.ts +19 -0
  370. package/dist/retrievers/hyde.js +19 -0
  371. package/dist/retrievers/metal.cjs +11 -0
  372. package/dist/retrievers/metal.d.ts +11 -0
  373. package/dist/retrievers/metal.js +11 -0
  374. package/dist/retrievers/multi_query.cjs +13 -1
  375. package/dist/retrievers/multi_query.d.ts +13 -0
  376. package/dist/retrievers/multi_query.js +13 -1
  377. package/dist/retrievers/multi_vector.cjs +13 -0
  378. package/dist/retrievers/multi_vector.d.ts +13 -0
  379. package/dist/retrievers/multi_vector.js +13 -0
  380. package/dist/retrievers/parent_document.cjs +21 -0
  381. package/dist/retrievers/parent_document.d.ts +21 -0
  382. package/dist/retrievers/parent_document.js +21 -0
  383. package/dist/retrievers/remote/chatgpt-plugin.cjs +10 -0
  384. package/dist/retrievers/remote/chatgpt-plugin.d.ts +10 -0
  385. package/dist/retrievers/remote/chatgpt-plugin.js +10 -0
  386. package/dist/retrievers/self_query/chroma.cjs +15 -0
  387. package/dist/retrievers/self_query/chroma.d.ts +15 -0
  388. package/dist/retrievers/self_query/chroma.js +15 -0
  389. package/dist/retrievers/self_query/functional.cjs +7 -0
  390. package/dist/retrievers/self_query/functional.d.ts +7 -0
  391. package/dist/retrievers/self_query/functional.js +7 -0
  392. package/dist/retrievers/self_query/index.cjs +13 -0
  393. package/dist/retrievers/self_query/index.d.ts +13 -0
  394. package/dist/retrievers/self_query/index.js +13 -0
  395. package/dist/retrievers/self_query/pinecone.cjs +14 -0
  396. package/dist/retrievers/self_query/pinecone.d.ts +14 -0
  397. package/dist/retrievers/self_query/pinecone.js +14 -0
  398. package/dist/retrievers/self_query/supabase.cjs +14 -0
  399. package/dist/retrievers/self_query/supabase.d.ts +14 -0
  400. package/dist/retrievers/self_query/supabase.js +14 -0
  401. package/dist/retrievers/self_query/weaviate.cjs +14 -0
  402. package/dist/retrievers/self_query/weaviate.d.ts +14 -0
  403. package/dist/retrievers/self_query/weaviate.js +14 -0
  404. package/dist/retrievers/time_weighted.cjs +16 -0
  405. package/dist/retrievers/time_weighted.d.ts +16 -0
  406. package/dist/retrievers/time_weighted.js +16 -0
  407. package/dist/retrievers/vespa.cjs +15 -0
  408. package/dist/retrievers/vespa.d.ts +15 -0
  409. package/dist/retrievers/vespa.js +15 -0
  410. package/dist/retrievers/zep.cjs +10 -0
  411. package/dist/retrievers/zep.d.ts +10 -0
  412. package/dist/retrievers/zep.js +10 -0
  413. package/dist/schema/index.d.ts +8 -6
  414. package/dist/schema/output_parser.cjs +15 -0
  415. package/dist/schema/output_parser.d.ts +15 -0
  416. package/dist/schema/output_parser.js +15 -0
  417. package/dist/schema/runnable/base.cjs +20 -0
  418. package/dist/schema/runnable/base.d.ts +20 -0
  419. package/dist/schema/runnable/base.js +20 -0
  420. package/dist/schema/runnable/branch.cjs +28 -0
  421. package/dist/schema/runnable/branch.d.ts +28 -0
  422. package/dist/schema/runnable/branch.js +28 -0
  423. package/dist/storage/file_system.cjs +21 -0
  424. package/dist/storage/file_system.d.ts +21 -0
  425. package/dist/storage/file_system.js +21 -0
  426. package/dist/storage/in_memory.cjs +15 -0
  427. package/dist/storage/in_memory.d.ts +15 -0
  428. package/dist/storage/in_memory.js +15 -0
  429. package/dist/storage/ioredis.cjs +24 -0
  430. package/dist/storage/ioredis.d.ts +24 -0
  431. package/dist/storage/ioredis.js +24 -0
  432. package/dist/storage/upstash_redis.cjs +19 -0
  433. package/dist/storage/upstash_redis.d.ts +19 -0
  434. package/dist/storage/upstash_redis.js +19 -0
  435. package/dist/storage/vercel_kv.cjs +16 -0
  436. package/dist/storage/vercel_kv.d.ts +16 -0
  437. package/dist/storage/vercel_kv.js +16 -0
  438. package/dist/stores/message/cassandra.cjs +25 -0
  439. package/dist/stores/message/cassandra.d.ts +25 -0
  440. package/dist/stores/message/cassandra.js +25 -0
  441. package/dist/stores/message/cloudflare_d1.cjs +18 -0
  442. package/dist/stores/message/cloudflare_d1.d.ts +18 -0
  443. package/dist/stores/message/cloudflare_d1.js +18 -0
  444. package/dist/stores/message/firestore.cjs +19 -0
  445. package/dist/stores/message/firestore.d.ts +19 -0
  446. package/dist/stores/message/firestore.js +19 -0
  447. package/dist/stores/message/ioredis.cjs +18 -0
  448. package/dist/stores/message/ioredis.d.ts +18 -0
  449. package/dist/stores/message/ioredis.js +18 -0
  450. package/dist/stores/message/momento.cjs +18 -0
  451. package/dist/stores/message/momento.d.ts +18 -0
  452. package/dist/stores/message/momento.js +18 -0
  453. package/dist/stores/message/mongodb.cjs +11 -0
  454. package/dist/stores/message/mongodb.d.ts +11 -0
  455. package/dist/stores/message/mongodb.js +11 -0
  456. package/dist/stores/message/planetscale.cjs +18 -0
  457. package/dist/stores/message/planetscale.d.ts +18 -0
  458. package/dist/stores/message/planetscale.js +18 -0
  459. package/dist/stores/message/redis.cjs +18 -0
  460. package/dist/stores/message/redis.d.ts +18 -0
  461. package/dist/stores/message/redis.js +18 -0
  462. package/dist/stores/message/xata.cjs +23 -0
  463. package/dist/stores/message/xata.d.ts +23 -0
  464. package/dist/stores/message/xata.js +23 -0
  465. package/dist/tools/calculator.cjs +6 -0
  466. package/dist/tools/calculator.d.ts +6 -0
  467. package/dist/tools/calculator.js +6 -0
  468. package/dist/tools/google_calendar/create.cjs +22 -0
  469. package/dist/tools/google_calendar/create.d.ts +22 -0
  470. package/dist/tools/google_calendar/create.js +22 -0
  471. package/dist/tools/google_calendar/view.cjs +20 -0
  472. package/dist/tools/google_calendar/view.d.ts +20 -0
  473. package/dist/tools/google_calendar/view.js +20 -0
  474. package/dist/tools/searchapi.cjs +27 -0
  475. package/dist/tools/searchapi.d.ts +27 -0
  476. package/dist/tools/searchapi.js +27 -0
  477. package/dist/tools/searxng_search.cjs +20 -1
  478. package/dist/tools/searxng_search.d.ts +20 -1
  479. package/dist/tools/searxng_search.js +20 -1
  480. package/dist/tools/webbrowser.cjs +8 -0
  481. package/dist/tools/webbrowser.d.ts +8 -0
  482. package/dist/tools/webbrowser.js +8 -0
  483. package/dist/tools/wikipedia_query_run.cjs +8 -0
  484. package/dist/tools/wikipedia_query_run.d.ts +8 -0
  485. package/dist/tools/wikipedia_query_run.js +8 -0
  486. package/dist/tools/wolframalpha.cjs +9 -0
  487. package/dist/tools/wolframalpha.d.ts +9 -0
  488. package/dist/tools/wolframalpha.js +9 -0
  489. package/dist/util/googlevertexai-connection.cjs +3 -9
  490. package/dist/util/googlevertexai-connection.js +3 -9
  491. package/dist/vectorstores/opensearch.cjs +2 -1
  492. package/dist/vectorstores/opensearch.js +2 -1
  493. package/dist/vectorstores/prisma.cjs +20 -2
  494. package/dist/vectorstores/prisma.d.ts +4 -0
  495. package/dist/vectorstores/prisma.js +20 -2
  496. package/dist/vectorstores/rockset.cjs +353 -0
  497. package/dist/vectorstores/rockset.d.ts +202 -0
  498. package/dist/vectorstores/rockset.js +347 -0
  499. package/package.json +24 -5
  500. package/vectorstores/rockset.cjs +1 -0
  501. package/vectorstores/rockset.d.ts +1 -0
  502. package/vectorstores/rockset.js +1 -0
@@ -26,6 +26,16 @@ export interface ChatGPTPluginRetrieverParams extends RemoteRetrieverParams {
26
26
  * Class that connects ChatGPT to third-party applications via plugins. It
27
27
  * extends the RemoteRetriever class and implements the
28
28
  * ChatGPTPluginRetrieverParams interface.
29
+ * @example
30
+ * ```typescript
31
+ * const retriever = new ChatGPTPluginRetriever({
32
+ * url: "http:
33
+ * auth: {
34
+ * bearer: "super-secret-jwt-token-with-at-least-32-characters-long",
35
+ * },
36
+ * });
37
+ * const docs = await retriever.getRelevantDocuments("hello world");
38
+ * ```
29
39
  */
30
40
  export declare class ChatGPTPluginRetriever extends RemoteRetriever implements ChatGPTPluginRetrieverParams {
31
41
  lc_namespace: string[];
@@ -4,6 +4,16 @@ import { RemoteRetriever, } from "./base.js";
4
4
  * Class that connects ChatGPT to third-party applications via plugins. It
5
5
  * extends the RemoteRetriever class and implements the
6
6
  * ChatGPTPluginRetrieverParams interface.
7
+ * @example
8
+ * ```typescript
9
+ * const retriever = new ChatGPTPluginRetriever({
10
+ * url: "http:
11
+ * auth: {
12
+ * bearer: "super-secret-jwt-token-with-at-least-32-characters-long",
13
+ * },
14
+ * });
15
+ * const docs = await retriever.getRelevantDocuments("hello world");
16
+ * ```
7
17
  */
8
18
  export class ChatGPTPluginRetriever extends RemoteRetriever {
9
19
  constructor({ topK = 4, filter, ...rest }) {
@@ -8,6 +8,21 @@ const base_js_1 = require("./base.cjs");
8
8
  * BasicTranslator class and translates internal query language elements
9
9
  * to valid filters. The class defines a subset of allowed logical
10
10
  * operators and comparators that can be used in the translation process.
11
+ * @example
12
+ * ```typescript
13
+ * const chromaTranslator = new ChromaTranslator();
14
+ * const selfQueryRetriever = new SelfQueryRetriever({
15
+ * llm: new ChatOpenAI(),
16
+ * vectorStore: new Chroma(),
17
+ * documentContents: "Brief summary of a movie",
18
+ * attributeInfo: [],
19
+ * structuredQueryTranslator: chromaTranslator,
20
+ * });
21
+ *
22
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
23
+ * "Which movies are directed by Greta Gerwig?",
24
+ * );
25
+ * ```
11
26
  */
12
27
  class ChromaTranslator extends base_js_1.BasicTranslator {
13
28
  constructor() {
@@ -5,6 +5,21 @@ import { BasicTranslator } from "./base.js";
5
5
  * BasicTranslator class and translates internal query language elements
6
6
  * to valid filters. The class defines a subset of allowed logical
7
7
  * operators and comparators that can be used in the translation process.
8
+ * @example
9
+ * ```typescript
10
+ * const chromaTranslator = new ChromaTranslator();
11
+ * const selfQueryRetriever = new SelfQueryRetriever({
12
+ * llm: new ChatOpenAI(),
13
+ * vectorStore: new Chroma(),
14
+ * documentContents: "Brief summary of a movie",
15
+ * attributeInfo: [],
16
+ * structuredQueryTranslator: chromaTranslator,
17
+ * });
18
+ *
19
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
8
23
  */
9
24
  export declare class ChromaTranslator<T extends Chroma> extends BasicTranslator<T> {
10
25
  constructor();
@@ -5,6 +5,21 @@ import { BasicTranslator } from "./base.js";
5
5
  * BasicTranslator class and translates internal query language elements
6
6
  * to valid filters. The class defines a subset of allowed logical
7
7
  * operators and comparators that can be used in the translation process.
8
+ * @example
9
+ * ```typescript
10
+ * const chromaTranslator = new ChromaTranslator();
11
+ * const selfQueryRetriever = new SelfQueryRetriever({
12
+ * llm: new ChatOpenAI(),
13
+ * vectorStore: new Chroma(),
14
+ * documentContents: "Brief summary of a movie",
15
+ * attributeInfo: [],
16
+ * structuredQueryTranslator: chromaTranslator,
17
+ * });
18
+ *
19
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
8
23
  */
9
24
  export class ChromaTranslator extends BasicTranslator {
10
25
  constructor() {
@@ -7,6 +7,13 @@ const utils_js_1 = require("./utils.cjs");
7
7
  /**
8
8
  * A class that extends `BaseTranslator` to translate structured queries
9
9
  * into functional filters.
10
+ * @example
11
+ * ```typescript
12
+ * const functionalTranslator = new FunctionalTranslator();
13
+ * const relevantDocuments = await functionalTranslator.getRelevantDocuments(
14
+ * "Which movies are rated higher than 8.5?",
15
+ * );
16
+ * ```
10
17
  */
11
18
  class FunctionalTranslator extends base_js_1.BaseTranslator {
12
19
  constructor() {
@@ -22,6 +22,13 @@ export type FunctionFilter = (document: Document) => boolean;
22
22
  /**
23
23
  * A class that extends `BaseTranslator` to translate structured queries
24
24
  * into functional filters.
25
+ * @example
26
+ * ```typescript
27
+ * const functionalTranslator = new FunctionalTranslator();
28
+ * const relevantDocuments = await functionalTranslator.getRelevantDocuments(
29
+ * "Which movies are rated higher than 8.5?",
30
+ * );
31
+ * ```
25
32
  */
26
33
  export declare class FunctionalTranslator extends BaseTranslator {
27
34
  VisitOperationOutput: FunctionFilter;
@@ -4,6 +4,13 @@ import { castValue, isFilterEmpty } from "./utils.js";
4
4
  /**
5
5
  * A class that extends `BaseTranslator` to translate structured queries
6
6
  * into functional filters.
7
+ * @example
8
+ * ```typescript
9
+ * const functionalTranslator = new FunctionalTranslator();
10
+ * const relevantDocuments = await functionalTranslator.getRelevantDocuments(
11
+ * "Which movies are rated higher than 8.5?",
12
+ * );
13
+ * ```
7
14
  */
8
15
  export class FunctionalTranslator extends BaseTranslator {
9
16
  constructor() {
@@ -12,6 +12,19 @@ Object.defineProperty(exports, "BasicTranslator", { enumerable: true, get: funct
12
12
  * Class for question answering over an index. It retrieves relevant
13
13
  * documents based on a query. It extends the BaseRetriever class and
14
14
  * implements the SelfQueryRetrieverArgs interface.
15
+ * @example
16
+ * ```typescript
17
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
18
+ * llm: new ChatOpenAI(),
19
+ * vectorStore: await HNSWLib.fromDocuments(docs, new OpenAIEmbeddings()),
20
+ * documentContents: "Brief summary of a movie",
21
+ * attributeInfo: attributeInfo,
22
+ * structuredQueryTranslator: new FunctionalTranslator(),
23
+ * });
24
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
25
+ * "Which movies are directed by Greta Gerwig?",
26
+ * );
27
+ * ```
15
28
  */
16
29
  class SelfQueryRetriever extends retriever_js_1.BaseRetriever {
17
30
  static lc_name() {
@@ -28,6 +28,19 @@ export interface SelfQueryRetrieverArgs<T extends VectorStore> extends BaseRetri
28
28
  * Class for question answering over an index. It retrieves relevant
29
29
  * documents based on a query. It extends the BaseRetriever class and
30
30
  * implements the SelfQueryRetrieverArgs interface.
31
+ * @example
32
+ * ```typescript
33
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
34
+ * llm: new ChatOpenAI(),
35
+ * vectorStore: await HNSWLib.fromDocuments(docs, new OpenAIEmbeddings()),
36
+ * documentContents: "Brief summary of a movie",
37
+ * attributeInfo: attributeInfo,
38
+ * structuredQueryTranslator: new FunctionalTranslator(),
39
+ * });
40
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
41
+ * "Which movies are directed by Greta Gerwig?",
42
+ * );
43
+ * ```
31
44
  */
32
45
  export declare class SelfQueryRetriever<T extends VectorStore> extends BaseRetriever implements SelfQueryRetrieverArgs<T> {
33
46
  static lc_name(): string;
@@ -7,6 +7,19 @@ export { BaseTranslator, BasicTranslator, FunctionalTranslator };
7
7
  * Class for question answering over an index. It retrieves relevant
8
8
  * documents based on a query. It extends the BaseRetriever class and
9
9
  * implements the SelfQueryRetrieverArgs interface.
10
+ * @example
11
+ * ```typescript
12
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
13
+ * llm: new ChatOpenAI(),
14
+ * vectorStore: await HNSWLib.fromDocuments(docs, new OpenAIEmbeddings()),
15
+ * documentContents: "Brief summary of a movie",
16
+ * attributeInfo: attributeInfo,
17
+ * structuredQueryTranslator: new FunctionalTranslator(),
18
+ * });
19
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
10
23
  */
11
24
  export class SelfQueryRetriever extends BaseRetriever {
12
25
  static lc_name() {
@@ -9,6 +9,20 @@ const base_js_1 = require("./base.cjs");
9
9
  * LangChain. The class is initialized with a set of allowed operators and
10
10
  * comparators, which are used in the translation process to construct
11
11
  * queries and compare results.
12
+ * @example
13
+ * ```typescript
14
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
15
+ * llm: new ChatOpenAI(),
16
+ * vectorStore: new PineconeStore(),
17
+ * documentContents: "Brief summary of a movie",
18
+ * attributeInfo: [],
19
+ * structuredQueryTranslator: new PineconeTranslator(),
20
+ * });
21
+ *
22
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
23
+ * "Which movies are directed by Greta Gerwig?",
24
+ * );
25
+ * ```
12
26
  */
13
27
  class PineconeTranslator extends base_js_1.BasicTranslator {
14
28
  constructor() {
@@ -6,6 +6,20 @@ import { BasicTranslator } from "./base.js";
6
6
  * LangChain. The class is initialized with a set of allowed operators and
7
7
  * comparators, which are used in the translation process to construct
8
8
  * queries and compare results.
9
+ * @example
10
+ * ```typescript
11
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
12
+ * llm: new ChatOpenAI(),
13
+ * vectorStore: new PineconeStore(),
14
+ * documentContents: "Brief summary of a movie",
15
+ * attributeInfo: [],
16
+ * structuredQueryTranslator: new PineconeTranslator(),
17
+ * });
18
+ *
19
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
9
23
  */
10
24
  export declare class PineconeTranslator<T extends PineconeStore> extends BasicTranslator<T> {
11
25
  constructor();
@@ -6,6 +6,20 @@ import { BasicTranslator } from "./base.js";
6
6
  * LangChain. The class is initialized with a set of allowed operators and
7
7
  * comparators, which are used in the translation process to construct
8
8
  * queries and compare results.
9
+ * @example
10
+ * ```typescript
11
+ * const selfQueryRetriever = await SelfQueryRetriever.fromLLM({
12
+ * llm: new ChatOpenAI(),
13
+ * vectorStore: new PineconeStore(),
14
+ * documentContents: "Brief summary of a movie",
15
+ * attributeInfo: [],
16
+ * structuredQueryTranslator: new PineconeTranslator(),
17
+ * });
18
+ *
19
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
9
23
  */
10
24
  export class PineconeTranslator extends BasicTranslator {
11
25
  constructor() {
@@ -9,6 +9,20 @@ const supabase_utils_js_1 = require("./supabase_utils.cjs");
9
9
  * A specialized translator designed to work with Supabase, extending the
10
10
  * BaseTranslator class. It translates structured queries into a format
11
11
  * that can be understood by the Supabase database.
12
+ * @example
13
+ * ```typescript
14
+ * const selfQueryRetriever = new SelfQueryRetriever({
15
+ * llm: new ChatOpenAI(),
16
+ * vectorStore: new SupabaseVectorStore(),
17
+ * documentContents: "Brief summary of a movie",
18
+ * attributeInfo: [],
19
+ * structuredQueryTranslator: new SupabaseTranslator(),
20
+ * });
21
+ *
22
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
23
+ * "Which movies are directed by Greta Gerwig?",
24
+ * );
25
+ * ```
12
26
  */
13
27
  class SupabaseTranslator extends base_js_1.BaseTranslator {
14
28
  constructor() {
@@ -17,6 +17,20 @@ type ValueType = {
17
17
  * A specialized translator designed to work with Supabase, extending the
18
18
  * BaseTranslator class. It translates structured queries into a format
19
19
  * that can be understood by the Supabase database.
20
+ * @example
21
+ * ```typescript
22
+ * const selfQueryRetriever = new SelfQueryRetriever({
23
+ * llm: new ChatOpenAI(),
24
+ * vectorStore: new SupabaseVectorStore(),
25
+ * documentContents: "Brief summary of a movie",
26
+ * attributeInfo: [],
27
+ * structuredQueryTranslator: new SupabaseTranslator(),
28
+ * });
29
+ *
30
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
31
+ * "Which movies are directed by Greta Gerwig?",
32
+ * );
33
+ * ```
20
34
  */
21
35
  export declare class SupabaseTranslator<T extends SupabaseVectorStore> extends BaseTranslator<T> {
22
36
  VisitOperationOutput: SupabaseFilterRPCCall;
@@ -6,6 +6,20 @@ import { ProxyParamsDuplicator, convertObjectFilterToStructuredQuery, } from "./
6
6
  * A specialized translator designed to work with Supabase, extending the
7
7
  * BaseTranslator class. It translates structured queries into a format
8
8
  * that can be understood by the Supabase database.
9
+ * @example
10
+ * ```typescript
11
+ * const selfQueryRetriever = new SelfQueryRetriever({
12
+ * llm: new ChatOpenAI(),
13
+ * vectorStore: new SupabaseVectorStore(),
14
+ * documentContents: "Brief summary of a movie",
15
+ * attributeInfo: [],
16
+ * structuredQueryTranslator: new SupabaseTranslator(),
17
+ * });
18
+ *
19
+ * const queryResult = await selfQueryRetriever.getRelevantDocuments(
20
+ * "Which movies are directed by Greta Gerwig?",
21
+ * );
22
+ * ```
9
23
  */
10
24
  export class SupabaseTranslator extends BaseTranslator {
11
25
  constructor() {
@@ -8,6 +8,20 @@ const utils_js_1 = require("./utils.cjs");
8
8
  * A class that translates or converts data into a format that can be used
9
9
  * with Weaviate, a vector search engine. It extends the `BaseTranslator`
10
10
  * class and provides specific implementation for Weaviate.
11
+ * @example
12
+ * ```typescript
13
+ * const selfQueryRetriever = new SelfQueryRetriever({
14
+ * llm: new ChatOpenAI(),
15
+ * vectorStore: new WeaviateStore(),
16
+ * documentContents: "Brief summary of a movie",
17
+ * attributeInfo: [],
18
+ * structuredQueryTranslator: new WeaviateTranslator(),
19
+ * });
20
+ *
21
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
22
+ * "Which movies are rated higher than 8.5?",
23
+ * );
24
+ * ```
11
25
  */
12
26
  class WeaviateTranslator extends base_js_1.BaseTranslator {
13
27
  constructor() {
@@ -33,6 +33,20 @@ export type WeaviateStructuredQueryResult = {
33
33
  * A class that translates or converts data into a format that can be used
34
34
  * with Weaviate, a vector search engine. It extends the `BaseTranslator`
35
35
  * class and provides specific implementation for Weaviate.
36
+ * @example
37
+ * ```typescript
38
+ * const selfQueryRetriever = new SelfQueryRetriever({
39
+ * llm: new ChatOpenAI(),
40
+ * vectorStore: new WeaviateStore(),
41
+ * documentContents: "Brief summary of a movie",
42
+ * attributeInfo: [],
43
+ * structuredQueryTranslator: new WeaviateTranslator(),
44
+ * });
45
+ *
46
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
47
+ * "Which movies are rated higher than 8.5?",
48
+ * );
49
+ * ```
36
50
  */
37
51
  export declare class WeaviateTranslator<T extends WeaviateStore> extends BaseTranslator<T> {
38
52
  VisitOperationOutput: WeaviateOperationResult;
@@ -5,6 +5,20 @@ import { isFilterEmpty, isString, isInt, isFloat } from "./utils.js";
5
5
  * A class that translates or converts data into a format that can be used
6
6
  * with Weaviate, a vector search engine. It extends the `BaseTranslator`
7
7
  * class and provides specific implementation for Weaviate.
8
+ * @example
9
+ * ```typescript
10
+ * const selfQueryRetriever = new SelfQueryRetriever({
11
+ * llm: new ChatOpenAI(),
12
+ * vectorStore: new WeaviateStore(),
13
+ * documentContents: "Brief summary of a movie",
14
+ * attributeInfo: [],
15
+ * structuredQueryTranslator: new WeaviateTranslator(),
16
+ * });
17
+ *
18
+ * const relevantDocuments = await selfQueryRetriever.getRelevantDocuments(
19
+ * "Which movies are rated higher than 8.5?",
20
+ * );
21
+ * ```
8
22
  */
9
23
  export class WeaviateTranslator extends BaseTranslator {
10
24
  constructor() {
@@ -7,6 +7,22 @@ exports.BUFFER_IDX = "buffer_idx";
7
7
  /**
8
8
  * TimeWeightedVectorStoreRetriever retrieves documents based on their time-weighted relevance.
9
9
  * ref: https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain/retrievers/time_weighted_retriever.py
10
+ * @example
11
+ * ```typescript
12
+ * const retriever = new TimeWeightedVectorStoreRetriever({
13
+ * vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),
14
+ * memoryStream: [],
15
+ * searchKwargs: 2,
16
+ * });
17
+ * await retriever.addDocuments([
18
+ * { pageContent: "My name is John.", metadata: {} },
19
+ * { pageContent: "My favourite food is pizza.", metadata: {} },
20
+ *
21
+ * ]);
22
+ * const results = await retriever.getRelevantDocuments(
23
+ * "What is my favourite food?",
24
+ * );
25
+ * ```
10
26
  */
11
27
  class TimeWeightedVectorStoreRetriever extends retriever_js_1.BaseRetriever {
12
28
  static lc_name() {
@@ -20,6 +20,22 @@ export declare const BUFFER_IDX = "buffer_idx";
20
20
  /**
21
21
  * TimeWeightedVectorStoreRetriever retrieves documents based on their time-weighted relevance.
22
22
  * ref: https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain/retrievers/time_weighted_retriever.py
23
+ * @example
24
+ * ```typescript
25
+ * const retriever = new TimeWeightedVectorStoreRetriever({
26
+ * vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),
27
+ * memoryStream: [],
28
+ * searchKwargs: 2,
29
+ * });
30
+ * await retriever.addDocuments([
31
+ * { pageContent: "My name is John.", metadata: {} },
32
+ * { pageContent: "My favourite food is pizza.", metadata: {} },
33
+ *
34
+ * ]);
35
+ * const results = await retriever.getRelevantDocuments(
36
+ * "What is my favourite food?",
37
+ * );
38
+ * ```
23
39
  */
24
40
  export declare class TimeWeightedVectorStoreRetriever extends BaseRetriever {
25
41
  static lc_name(): string;
@@ -4,6 +4,22 @@ export const BUFFER_IDX = "buffer_idx";
4
4
  /**
5
5
  * TimeWeightedVectorStoreRetriever retrieves documents based on their time-weighted relevance.
6
6
  * ref: https://github.com/langchain-ai/langchain/blob/master/libs/langchain/langchain/retrievers/time_weighted_retriever.py
7
+ * @example
8
+ * ```typescript
9
+ * const retriever = new TimeWeightedVectorStoreRetriever({
10
+ * vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),
11
+ * memoryStream: [],
12
+ * searchKwargs: 2,
13
+ * });
14
+ * await retriever.addDocuments([
15
+ * { pageContent: "My name is John.", metadata: {} },
16
+ * { pageContent: "My favourite food is pizza.", metadata: {} },
17
+ *
18
+ * ]);
19
+ * const results = await retriever.getRelevantDocuments(
20
+ * "What is my favourite food?",
21
+ * );
22
+ * ```
7
23
  */
8
24
  export class TimeWeightedVectorStoreRetriever extends BaseRetriever {
9
25
  static lc_name() {
@@ -7,6 +7,21 @@ const base_js_1 = require("./remote/base.cjs");
7
7
  * Class responsible for retrieving data from Vespa. It extends the
8
8
  * `RemoteRetriever` class and includes methods for creating the JSON body
9
9
  * for a query and processing the JSON response from Vespa.
10
+ * @example
11
+ * ```typescript
12
+ * const retriever = new VespaRetriever({
13
+ * url: "https:
14
+ * auth: false,
15
+ * query_body: {
16
+ * yql: "select content from paragraph where userQuery()",
17
+ * hits: 5,
18
+ * ranking: "documentation",
19
+ * locale: "en-us",
20
+ * },
21
+ * content_field: "content",
22
+ * });
23
+ * const result = await retriever.getRelevantDocuments("what is vespa?");
24
+ * ```
10
25
  */
11
26
  class VespaRetriever extends base_js_1.RemoteRetriever {
12
27
  static lc_name() {
@@ -14,6 +14,21 @@ export interface VespaRetrieverParams extends RemoteRetrieverParams {
14
14
  * Class responsible for retrieving data from Vespa. It extends the
15
15
  * `RemoteRetriever` class and includes methods for creating the JSON body
16
16
  * for a query and processing the JSON response from Vespa.
17
+ * @example
18
+ * ```typescript
19
+ * const retriever = new VespaRetriever({
20
+ * url: "https:
21
+ * auth: false,
22
+ * query_body: {
23
+ * yql: "select content from paragraph where userQuery()",
24
+ * hits: 5,
25
+ * ranking: "documentation",
26
+ * locale: "en-us",
27
+ * },
28
+ * content_field: "content",
29
+ * });
30
+ * const result = await retriever.getRelevantDocuments("what is vespa?");
31
+ * ```
17
32
  */
18
33
  export declare class VespaRetriever extends RemoteRetriever {
19
34
  static lc_name(): string;
@@ -4,6 +4,21 @@ import { RemoteRetriever, } from "./remote/base.js";
4
4
  * Class responsible for retrieving data from Vespa. It extends the
5
5
  * `RemoteRetriever` class and includes methods for creating the JSON body
6
6
  * for a query and processing the JSON response from Vespa.
7
+ * @example
8
+ * ```typescript
9
+ * const retriever = new VespaRetriever({
10
+ * url: "https:
11
+ * auth: false,
12
+ * query_body: {
13
+ * yql: "select content from paragraph where userQuery()",
14
+ * hits: 5,
15
+ * ranking: "documentation",
16
+ * locale: "en-us",
17
+ * },
18
+ * content_field: "content",
19
+ * });
20
+ * const result = await retriever.getRelevantDocuments("what is vespa?");
21
+ * ```
7
22
  */
8
23
  export class VespaRetriever extends RemoteRetriever {
9
24
  static lc_name() {
@@ -7,6 +7,16 @@ const document_js_1 = require("../document.cjs");
7
7
  /**
8
8
  * Class for retrieving information from a Zep long-term memory store.
9
9
  * Extends the BaseRetriever class.
10
+ * @example
11
+ * ```typescript
12
+ * const retriever = new ZepRetriever({
13
+ * url: "http:
14
+ * sessionId: "session_exampleUUID",
15
+ * topK: 3,
16
+ * });
17
+ * const query = "Can I drive red cars in France?";
18
+ * const docs = await retriever.getRelevantDocuments(query);
19
+ * ```
10
20
  */
11
21
  class ZepRetriever extends retriever_js_1.BaseRetriever {
12
22
  static lc_name() {
@@ -27,6 +27,16 @@ export interface ZepRetrieverConfig extends BaseRetrieverInput {
27
27
  /**
28
28
  * Class for retrieving information from a Zep long-term memory store.
29
29
  * Extends the BaseRetriever class.
30
+ * @example
31
+ * ```typescript
32
+ * const retriever = new ZepRetriever({
33
+ * url: "http:
34
+ * sessionId: "session_exampleUUID",
35
+ * topK: 3,
36
+ * });
37
+ * const query = "Can I drive red cars in France?";
38
+ * const docs = await retriever.getRelevantDocuments(query);
39
+ * ```
30
40
  */
31
41
  export declare class ZepRetriever extends BaseRetriever {
32
42
  static lc_name(): string;
@@ -4,6 +4,16 @@ import { Document } from "../document.js";
4
4
  /**
5
5
  * Class for retrieving information from a Zep long-term memory store.
6
6
  * Extends the BaseRetriever class.
7
+ * @example
8
+ * ```typescript
9
+ * const retriever = new ZepRetriever({
10
+ * url: "http:
11
+ * sessionId: "session_exampleUUID",
12
+ * topK: 3,
13
+ * });
14
+ * const query = "Can I drive red cars in France?";
15
+ * const docs = await retriever.getRelevantDocuments(query);
16
+ * ```
7
17
  */
8
18
  export class ZepRetriever extends BaseRetriever {
9
19
  static lc_name() {
@@ -66,14 +66,16 @@ export interface StoredGeneration {
66
66
  message?: StoredMessage;
67
67
  }
68
68
  export type MessageType = "human" | "ai" | "generic" | "system" | "function" | "tool";
69
- export type MessageContent = string | {
70
- type: "text" | "image_url";
71
- text?: string;
72
- image_url?: string | {
69
+ export type MessageContent = string | ({
70
+ type: "text";
71
+ text: string;
72
+ } | {
73
+ type: "image_url";
74
+ image_url: string | {
73
75
  url: string;
74
- detail?: "low" | "high";
76
+ detail?: "auto" | "low" | "high";
75
77
  };
76
- }[];
78
+ })[];
77
79
  export interface BaseMessageFields {
78
80
  content: MessageContent;
79
81
  name?: string;
@@ -171,6 +171,21 @@ class BaseCumulativeTransformOutputParser extends BaseTransformOutputParser {
171
171
  exports.BaseCumulativeTransformOutputParser = BaseCumulativeTransformOutputParser;
172
172
  /**
173
173
  * OutputParser that parses LLMResult into the top likely string.
174
+ * @example
175
+ * ```typescript
176
+ * const promptTemplate = PromptTemplate.fromTemplate(
177
+ * "Tell me a joke about {topic}",
178
+ * );
179
+ *
180
+ * const chain = RunnableSequence.from([
181
+ * promptTemplate,
182
+ * new ChatOpenAI({}),
183
+ * new StringOutputParser(),
184
+ * ]);
185
+ *
186
+ * const result = await chain.invoke({ topic: "bears" });
187
+ * console.log("What do you call a bear with no teeth? A gummy bear!");
188
+ * ```
174
189
  */
175
190
  class StringOutputParser extends BaseTransformOutputParser {
176
191
  constructor() {