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
@@ -1,5 +1,9 @@
1
1
  import { Document } from "../../document.js";
2
2
  import { BaseDocumentLoader } from "../base.js";
3
+ /**
4
+ * Interface representing the parameters for configuring the
5
+ * ConfluencePagesLoader.
6
+ */
3
7
  export interface ConfluencePagesLoaderParams {
4
8
  baseUrl: string;
5
9
  spaceKey: string;
@@ -7,6 +11,9 @@ export interface ConfluencePagesLoaderParams {
7
11
  accessToken: string;
8
12
  limit?: number;
9
13
  }
14
+ /**
15
+ * Interface representing a Confluence page.
16
+ */
10
17
  export interface ConfluencePage {
11
18
  id: string;
12
19
  title: string;
@@ -16,10 +23,16 @@ export interface ConfluencePage {
16
23
  };
17
24
  };
18
25
  }
26
+ /**
27
+ * Interface representing the response from the Confluence API.
28
+ */
19
29
  export interface ConfluenceAPIResponse {
20
30
  size: number;
21
31
  results: ConfluencePage[];
22
32
  }
33
+ /**
34
+ * Class representing a document loader for loading pages from Confluence.
35
+ */
23
36
  export declare class ConfluencePagesLoader extends BaseDocumentLoader {
24
37
  readonly baseUrl: string;
25
38
  readonly spaceKey: string;
@@ -27,8 +40,28 @@ export declare class ConfluencePagesLoader extends BaseDocumentLoader {
27
40
  readonly accessToken: string;
28
41
  readonly limit: number;
29
42
  constructor({ baseUrl, spaceKey, username, accessToken, limit, }: ConfluencePagesLoaderParams);
43
+ /**
44
+ * Fetches all the pages in the specified space and converts each page to
45
+ * a Document instance.
46
+ * @returns Promise resolving to an array of Document instances.
47
+ */
30
48
  load(): Promise<Document[]>;
49
+ /**
50
+ * Fetches data from the Confluence API using the provided URL.
51
+ * @param url The URL to fetch data from.
52
+ * @returns Promise resolving to the JSON response from the API.
53
+ */
31
54
  protected fetchConfluenceData(url: string): Promise<ConfluenceAPIResponse>;
55
+ /**
56
+ * Recursively fetches all the pages in the specified space.
57
+ * @param start The start parameter to paginate through the results.
58
+ * @returns Promise resolving to an array of ConfluencePage objects.
59
+ */
32
60
  private fetchAllPagesInSpace;
61
+ /**
62
+ * Creates a Document instance from a ConfluencePage object.
63
+ * @param page The ConfluencePage object to convert.
64
+ * @returns A Document instance.
65
+ */
33
66
  private createDocumentFromPage;
34
67
  }
@@ -1,6 +1,9 @@
1
1
  import { htmlToText } from "html-to-text";
2
2
  import { Document } from "../../document.js";
3
3
  import { BaseDocumentLoader } from "../base.js";
4
+ /**
5
+ * Class representing a document loader for loading pages from Confluence.
6
+ */
4
7
  export class ConfluencePagesLoader extends BaseDocumentLoader {
5
8
  constructor({ baseUrl, spaceKey, username, accessToken, limit = 25, }) {
6
9
  super();
@@ -40,6 +43,11 @@ export class ConfluencePagesLoader extends BaseDocumentLoader {
40
43
  this.accessToken = accessToken;
41
44
  this.limit = limit;
42
45
  }
46
+ /**
47
+ * Fetches all the pages in the specified space and converts each page to
48
+ * a Document instance.
49
+ * @returns Promise resolving to an array of Document instances.
50
+ */
43
51
  async load() {
44
52
  try {
45
53
  const pages = await this.fetchAllPagesInSpace();
@@ -50,6 +58,11 @@ export class ConfluencePagesLoader extends BaseDocumentLoader {
50
58
  return [];
51
59
  }
52
60
  }
61
+ /**
62
+ * Fetches data from the Confluence API using the provided URL.
63
+ * @param url The URL to fetch data from.
64
+ * @returns Promise resolving to the JSON response from the API.
65
+ */
53
66
  async fetchConfluenceData(url) {
54
67
  try {
55
68
  const authToken = Buffer.from(`${this.username}:${this.accessToken}`).toString("base64");
@@ -69,6 +82,11 @@ export class ConfluencePagesLoader extends BaseDocumentLoader {
69
82
  throw new Error(`Failed to fetch ${url} from Confluence: ${error}`);
70
83
  }
71
84
  }
85
+ /**
86
+ * Recursively fetches all the pages in the specified space.
87
+ * @param start The start parameter to paginate through the results.
88
+ * @returns Promise resolving to an array of ConfluencePage objects.
89
+ */
72
90
  async fetchAllPagesInSpace(start = 0) {
73
91
  const url = `${this.baseUrl}/rest/api/content?spaceKey=${this.spaceKey}&limit=${this.limit}&start=${start}&expand=body.storage`;
74
92
  const data = await this.fetchConfluenceData(url);
@@ -79,6 +97,11 @@ export class ConfluencePagesLoader extends BaseDocumentLoader {
79
97
  const nextPageResults = await this.fetchAllPagesInSpace(nextPageStart);
80
98
  return data.results.concat(nextPageResults);
81
99
  }
100
+ /**
101
+ * Creates a Document instance from a ConfluencePage object.
102
+ * @param page The ConfluencePage object to convert.
103
+ * @returns A Document instance.
104
+ */
82
105
  createDocumentFromPage(page) {
83
106
  // Convert the HTML content to plain text
84
107
  const plainTextContent = htmlToText(page.body.storage.value, {
@@ -4,6 +4,12 @@ exports.FigmaFileLoader = void 0;
4
4
  const base_js_1 = require("../base.cjs");
5
5
  const document_js_1 = require("../../document.cjs");
6
6
  const env_js_1 = require("../../util/env.cjs");
7
+ /**
8
+ * Class representing a document loader for loading Figma files. It
9
+ * extends the BaseDocumentLoader and implements the FigmaLoaderParams
10
+ * interface. The constructor takes a config object as a parameter, which
11
+ * contains the access token, an array of node IDs, and the file key.
12
+ */
7
13
  class FigmaFileLoader extends base_js_1.BaseDocumentLoader {
8
14
  constructor({ accessToken = (0, env_js_1.getEnvironmentVariable)("FIGMA_ACCESS_TOKEN"), nodeIds, fileKey, }) {
9
15
  super();
@@ -40,9 +46,18 @@ class FigmaFileLoader extends base_js_1.BaseDocumentLoader {
40
46
  };
41
47
  }
42
48
  }
49
+ /**
50
+ * Constructs the URL for the Figma API call.
51
+ * @returns The constructed URL as a string.
52
+ */
43
53
  constructFigmaApiURL() {
44
54
  return `https://api.figma.com/v1/files/${this.fileKey}/nodes?ids=${this.nodeIds.join(",")}`;
45
55
  }
56
+ /**
57
+ * Fetches the Figma file using the Figma API and returns it as a
58
+ * FigmaFile object.
59
+ * @returns A Promise that resolves to a FigmaFile object.
60
+ */
46
61
  async getFigmaFile() {
47
62
  const url = this.constructFigmaApiURL();
48
63
  const response = await fetch(url, { headers: this.headers });
@@ -55,6 +70,12 @@ class FigmaFileLoader extends base_js_1.BaseDocumentLoader {
55
70
  }
56
71
  return data;
57
72
  }
73
+ /**
74
+ * Fetches the Figma file using the Figma API, creates a Document instance
75
+ * with the JSON representation of the file as the page content and the
76
+ * API URL as the metadata, and returns it.
77
+ * @returns A Promise that resolves to an array of Document instances.
78
+ */
58
79
  async load() {
59
80
  const data = await this.getFigmaFile();
60
81
  const text = JSON.stringify(data);
@@ -1,5 +1,11 @@
1
1
  import { BaseDocumentLoader } from "../base.js";
2
2
  import { Document } from "../../document.js";
3
+ /**
4
+ * Interface representing a Figma file. It includes properties for the
5
+ * file name, role, last modified date, editor type, thumbnail URL,
6
+ * version, document node, schema version, main file key, and an array of
7
+ * branches.
8
+ */
3
9
  export interface FigmaFile {
4
10
  name: string;
5
11
  role: string;
@@ -18,18 +24,44 @@ export interface FigmaFile {
18
24
  link_access: string;
19
25
  }>;
20
26
  }
27
+ /**
28
+ * Interface representing the parameters for configuring the FigmaLoader.
29
+ * It includes optional properties for the access token, an array of node
30
+ * IDs, and the file key.
31
+ */
21
32
  export interface FigmaLoaderParams {
22
33
  accessToken?: string;
23
34
  nodeIds: string[];
24
35
  fileKey: string;
25
36
  }
37
+ /**
38
+ * Class representing a document loader for loading Figma files. It
39
+ * extends the BaseDocumentLoader and implements the FigmaLoaderParams
40
+ * interface. The constructor takes a config object as a parameter, which
41
+ * contains the access token, an array of node IDs, and the file key.
42
+ */
26
43
  export declare class FigmaFileLoader extends BaseDocumentLoader implements FigmaLoaderParams {
27
44
  accessToken?: string;
28
45
  nodeIds: string[];
29
46
  fileKey: string;
30
47
  private headers;
31
48
  constructor({ accessToken, nodeIds, fileKey, }: FigmaLoaderParams);
49
+ /**
50
+ * Constructs the URL for the Figma API call.
51
+ * @returns The constructed URL as a string.
52
+ */
32
53
  private constructFigmaApiURL;
54
+ /**
55
+ * Fetches the Figma file using the Figma API and returns it as a
56
+ * FigmaFile object.
57
+ * @returns A Promise that resolves to a FigmaFile object.
58
+ */
33
59
  private getFigmaFile;
60
+ /**
61
+ * Fetches the Figma file using the Figma API, creates a Document instance
62
+ * with the JSON representation of the file as the page content and the
63
+ * API URL as the metadata, and returns it.
64
+ * @returns A Promise that resolves to an array of Document instances.
65
+ */
34
66
  load(): Promise<Document[]>;
35
67
  }
@@ -1,6 +1,12 @@
1
1
  import { BaseDocumentLoader } from "../base.js";
2
2
  import { Document } from "../../document.js";
3
3
  import { getEnvironmentVariable } from "../../util/env.js";
4
+ /**
5
+ * Class representing a document loader for loading Figma files. It
6
+ * extends the BaseDocumentLoader and implements the FigmaLoaderParams
7
+ * interface. The constructor takes a config object as a parameter, which
8
+ * contains the access token, an array of node IDs, and the file key.
9
+ */
4
10
  export class FigmaFileLoader extends BaseDocumentLoader {
5
11
  constructor({ accessToken = getEnvironmentVariable("FIGMA_ACCESS_TOKEN"), nodeIds, fileKey, }) {
6
12
  super();
@@ -37,9 +43,18 @@ export class FigmaFileLoader extends BaseDocumentLoader {
37
43
  };
38
44
  }
39
45
  }
46
+ /**
47
+ * Constructs the URL for the Figma API call.
48
+ * @returns The constructed URL as a string.
49
+ */
40
50
  constructFigmaApiURL() {
41
51
  return `https://api.figma.com/v1/files/${this.fileKey}/nodes?ids=${this.nodeIds.join(",")}`;
42
52
  }
53
+ /**
54
+ * Fetches the Figma file using the Figma API and returns it as a
55
+ * FigmaFile object.
56
+ * @returns A Promise that resolves to a FigmaFile object.
57
+ */
43
58
  async getFigmaFile() {
44
59
  const url = this.constructFigmaApiURL();
45
60
  const response = await fetch(url, { headers: this.headers });
@@ -52,6 +67,12 @@ export class FigmaFileLoader extends BaseDocumentLoader {
52
67
  }
53
68
  return data;
54
69
  }
70
+ /**
71
+ * Fetches the Figma file using the Figma API, creates a Document instance
72
+ * with the JSON representation of the file as the page content and the
73
+ * API URL as the metadata, and returns it.
74
+ * @returns A Promise that resolves to an array of Document instances.
75
+ */
55
76
  async load() {
56
77
  const data = await this.getFigmaFile();
57
78
  const text = JSON.stringify(data);
@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.GitbookLoader = void 0;
4
4
  const document_js_1 = require("../../document.cjs");
5
5
  const cheerio_js_1 = require("./cheerio.cjs");
6
+ /**
7
+ * Class representing a document loader specifically designed for loading
8
+ * documents from Gitbook. It extends the CheerioWebBaseLoader.
9
+ */
6
10
  class GitbookLoader extends cheerio_js_1.CheerioWebBaseLoader {
7
11
  constructor(webPath, params = {}) {
8
12
  const path = params.shouldLoadAllPaths === true ? `${webPath}/sitemap.xml` : webPath;
@@ -23,6 +27,13 @@ class GitbookLoader extends cheerio_js_1.CheerioWebBaseLoader {
23
27
  this.shouldLoadAllPaths =
24
28
  params.shouldLoadAllPaths ?? this.shouldLoadAllPaths;
25
29
  }
30
+ /**
31
+ * Method that scrapes the web document using Cheerio and loads the
32
+ * content based on the value of shouldLoadAllPaths. If shouldLoadAllPaths
33
+ * is true, it calls the loadAllPaths() method to load all paths.
34
+ * Otherwise, it calls the loadPath() method to load a single path.
35
+ * @returns Promise resolving to an array of Document instances.
36
+ */
26
37
  async load() {
27
38
  const $ = await this.scrape();
28
39
  if (this.shouldLoadAllPaths === true) {
@@ -30,6 +41,18 @@ class GitbookLoader extends cheerio_js_1.CheerioWebBaseLoader {
30
41
  }
31
42
  return this.loadPath($);
32
43
  }
44
+ /**
45
+ * Private method that loads the content of a single path from the Gitbook
46
+ * web document. It extracts the page content by selecting all elements
47
+ * inside the "main" element, filters out empty text nodes, and joins the
48
+ * remaining text nodes with line breaks. It extracts the title by
49
+ * selecting the first "h1" element inside the "main" element. It creates
50
+ * a Document instance with the extracted page content and metadata
51
+ * containing the source URL and title.
52
+ * @param $ CheerioAPI instance representing the loaded web document.
53
+ * @param url Optional string representing the URL of the web document.
54
+ * @returns Array of Document instances.
55
+ */
33
56
  loadPath($, url) {
34
57
  const pageContent = $("main *")
35
58
  .contents()
@@ -45,6 +68,16 @@ class GitbookLoader extends cheerio_js_1.CheerioWebBaseLoader {
45
68
  }),
46
69
  ];
47
70
  }
71
+ /**
72
+ * Private method that loads the content of all paths from the Gitbook web
73
+ * document. It extracts the URLs of all paths from the "loc" elements in
74
+ * the sitemap.xml. It iterates over each URL, scrapes the web document
75
+ * using the _scrape() method, and calls the loadPath() method to load the
76
+ * content of each path. It collects all the loaded documents and returns
77
+ * them as an array.
78
+ * @param $ CheerioAPI instance representing the loaded web document.
79
+ * @returns Promise resolving to an array of Document instances.
80
+ */
48
81
  async loadAllPaths($) {
49
82
  const urls = $("loc")
50
83
  .toArray()
@@ -1,14 +1,52 @@
1
1
  import { Document } from "../../document.js";
2
2
  import { CheerioWebBaseLoader } from "./cheerio.js";
3
+ /**
4
+ * Interface representing the parameters for configuring the
5
+ * GitbookLoader. It has an optional property shouldLoadAllPaths, which
6
+ * indicates whether all paths should be loaded.
7
+ */
3
8
  interface GitbookLoaderParams {
4
9
  shouldLoadAllPaths?: boolean;
5
10
  }
11
+ /**
12
+ * Class representing a document loader specifically designed for loading
13
+ * documents from Gitbook. It extends the CheerioWebBaseLoader.
14
+ */
6
15
  export declare class GitbookLoader extends CheerioWebBaseLoader {
7
16
  webPath: string;
8
17
  shouldLoadAllPaths: boolean;
9
18
  constructor(webPath: string, params?: GitbookLoaderParams);
19
+ /**
20
+ * Method that scrapes the web document using Cheerio and loads the
21
+ * content based on the value of shouldLoadAllPaths. If shouldLoadAllPaths
22
+ * is true, it calls the loadAllPaths() method to load all paths.
23
+ * Otherwise, it calls the loadPath() method to load a single path.
24
+ * @returns Promise resolving to an array of Document instances.
25
+ */
10
26
  load(): Promise<Document[]>;
27
+ /**
28
+ * Private method that loads the content of a single path from the Gitbook
29
+ * web document. It extracts the page content by selecting all elements
30
+ * inside the "main" element, filters out empty text nodes, and joins the
31
+ * remaining text nodes with line breaks. It extracts the title by
32
+ * selecting the first "h1" element inside the "main" element. It creates
33
+ * a Document instance with the extracted page content and metadata
34
+ * containing the source URL and title.
35
+ * @param $ CheerioAPI instance representing the loaded web document.
36
+ * @param url Optional string representing the URL of the web document.
37
+ * @returns Array of Document instances.
38
+ */
11
39
  private loadPath;
40
+ /**
41
+ * Private method that loads the content of all paths from the Gitbook web
42
+ * document. It extracts the URLs of all paths from the "loc" elements in
43
+ * the sitemap.xml. It iterates over each URL, scrapes the web document
44
+ * using the _scrape() method, and calls the loadPath() method to load the
45
+ * content of each path. It collects all the loaded documents and returns
46
+ * them as an array.
47
+ * @param $ CheerioAPI instance representing the loaded web document.
48
+ * @returns Promise resolving to an array of Document instances.
49
+ */
12
50
  private loadAllPaths;
13
51
  }
14
52
  export {};
@@ -1,5 +1,9 @@
1
1
  import { Document } from "../../document.js";
2
2
  import { CheerioWebBaseLoader } from "./cheerio.js";
3
+ /**
4
+ * Class representing a document loader specifically designed for loading
5
+ * documents from Gitbook. It extends the CheerioWebBaseLoader.
6
+ */
3
7
  export class GitbookLoader extends CheerioWebBaseLoader {
4
8
  constructor(webPath, params = {}) {
5
9
  const path = params.shouldLoadAllPaths === true ? `${webPath}/sitemap.xml` : webPath;
@@ -20,6 +24,13 @@ export class GitbookLoader extends CheerioWebBaseLoader {
20
24
  this.shouldLoadAllPaths =
21
25
  params.shouldLoadAllPaths ?? this.shouldLoadAllPaths;
22
26
  }
27
+ /**
28
+ * Method that scrapes the web document using Cheerio and loads the
29
+ * content based on the value of shouldLoadAllPaths. If shouldLoadAllPaths
30
+ * is true, it calls the loadAllPaths() method to load all paths.
31
+ * Otherwise, it calls the loadPath() method to load a single path.
32
+ * @returns Promise resolving to an array of Document instances.
33
+ */
23
34
  async load() {
24
35
  const $ = await this.scrape();
25
36
  if (this.shouldLoadAllPaths === true) {
@@ -27,6 +38,18 @@ export class GitbookLoader extends CheerioWebBaseLoader {
27
38
  }
28
39
  return this.loadPath($);
29
40
  }
41
+ /**
42
+ * Private method that loads the content of a single path from the Gitbook
43
+ * web document. It extracts the page content by selecting all elements
44
+ * inside the "main" element, filters out empty text nodes, and joins the
45
+ * remaining text nodes with line breaks. It extracts the title by
46
+ * selecting the first "h1" element inside the "main" element. It creates
47
+ * a Document instance with the extracted page content and metadata
48
+ * containing the source URL and title.
49
+ * @param $ CheerioAPI instance representing the loaded web document.
50
+ * @param url Optional string representing the URL of the web document.
51
+ * @returns Array of Document instances.
52
+ */
30
53
  loadPath($, url) {
31
54
  const pageContent = $("main *")
32
55
  .contents()
@@ -42,6 +65,16 @@ export class GitbookLoader extends CheerioWebBaseLoader {
42
65
  }),
43
66
  ];
44
67
  }
68
+ /**
69
+ * Private method that loads the content of all paths from the Gitbook web
70
+ * document. It extracts the URLs of all paths from the "loc" elements in
71
+ * the sitemap.xml. It iterates over each URL, scrapes the web document
72
+ * using the _scrape() method, and calls the loadPath() method to load the
73
+ * content of each path. It collects all the loaded documents and returns
74
+ * them as an array.
75
+ * @param $ CheerioAPI instance representing the loaded web document.
76
+ * @returns Promise resolving to an array of Document instances.
77
+ */
45
78
  async loadAllPaths($) {
46
79
  const urls = $("loc")
47
80
  .toArray()
@@ -13,9 +13,20 @@ const extname_js_1 = require("../../util/extname.cjs");
13
13
  const env_js_1 = require("../../util/env.cjs");
14
14
  const async_caller_js_1 = require("../../util/async_caller.cjs");
15
15
  const extensions = new Set(binary_extensions_1.default);
16
+ /**
17
+ * A function that checks if a file path is a binary file based on its
18
+ * extension.
19
+ * @param name The file path to check.
20
+ * @returns A boolean indicating whether the file path is a binary file.
21
+ */
16
22
  function isBinaryPath(name) {
17
23
  return extensions.has((0, extname_js_1.extname)(name).slice(1).toLowerCase());
18
24
  }
25
+ /**
26
+ * A class that extends the BaseDocumentLoader and implements the
27
+ * GithubRepoLoaderParams interface. It represents a document loader for
28
+ * loading files from a GitHub repository.
29
+ */
19
30
  class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
20
31
  constructor(githubUrl, { accessToken = (0, env_js_1.getEnvironmentVariable)("GITHUB_ACCESS_TOKEN"), branch = "main", recursive = true, unknown = directory_js_1.UnknownHandling.Warn, ignoreFiles = [], ignorePaths, verbose = false, maxConcurrency = 2, maxRetries = 2, ...rest } = {}) {
21
32
  super();
@@ -115,6 +126,11 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
115
126
  };
116
127
  }
117
128
  }
129
+ /**
130
+ * Extracts the owner, repository, and path from a GitHub URL.
131
+ * @param url The GitHub URL to extract information from.
132
+ * @returns An object containing the owner, repository, and path extracted from the GitHub URL.
133
+ */
118
134
  extractOwnerAndRepoAndPath(url) {
119
135
  const match = url.match(/https:\/\/github.com\/([^/]+)\/([^/]+)(\/tree\/[^/]+\/(.+))?/i);
120
136
  if (!match) {
@@ -122,12 +138,25 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
122
138
  }
123
139
  return { owner: match[1], repo: match[2], path: match[4] || "" };
124
140
  }
141
+ /**
142
+ * Fetches the files from the GitHub repository and creates Document
143
+ * instances for each file. It also handles error handling based on the
144
+ * unknown handling option.
145
+ * @returns A promise that resolves to an array of Document instances.
146
+ */
125
147
  async load() {
126
148
  return (await this.processRepo()).map((fileResponse) => new document_js_1.Document({
127
149
  pageContent: fileResponse.contents,
128
150
  metadata: fileResponse.metadata,
129
151
  }));
130
152
  }
153
+ /**
154
+ * Determines whether a file or directory should be ignored based on its
155
+ * path and type.
156
+ * @param path The path of the file or directory.
157
+ * @param fileType The type of the file or directory.
158
+ * @returns A boolean indicating whether the file or directory should be ignored.
159
+ */
131
160
  shouldIgnore(path, fileType) {
132
161
  if (fileType !== "dir" && isBinaryPath(path)) {
133
162
  return true;
@@ -203,6 +232,12 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
203
232
  return Promise.reject(error);
204
233
  }
205
234
  }
235
+ /**
236
+ * Fetches the contents of a directory and maps the file / directory paths
237
+ * to promises that will fetch the file / directory contents.
238
+ * @param path The path of the directory to process.
239
+ * @returns A promise that resolves to an array of promises that will fetch the file / directory contents.
240
+ */
206
241
  async processDirectory(path) {
207
242
  try {
208
243
  const files = await this.fetchRepoFiles(path);
@@ -213,6 +248,11 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
213
248
  return Promise.reject(error);
214
249
  }
215
250
  }
251
+ /**
252
+ * Fetches the files from a GitHub repository.
253
+ * @param path The path of the repository to fetch the files from.
254
+ * @returns A promise that resolves to an array of GithubFile instances.
255
+ */
216
256
  async fetchRepoFiles(path) {
217
257
  const url = `https://api.github.com/repos/${this.owner}/${this.repo}/contents/${path}?ref=${this.branch}`;
218
258
  return this.caller.call(async () => {
@@ -230,6 +270,11 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
230
270
  return data;
231
271
  });
232
272
  }
273
+ /**
274
+ * Fetches the content of a file from a GitHub repository.
275
+ * @param file The file to fetch the content from.
276
+ * @returns A promise that resolves to the content of the file.
277
+ */
233
278
  async fetchFileContent(file) {
234
279
  return this.caller.call(async () => {
235
280
  if (this.verbose) {
@@ -241,6 +286,11 @@ class GithubRepoLoader extends base_js_1.BaseDocumentLoader {
241
286
  return response.text();
242
287
  });
243
288
  }
289
+ /**
290
+ * Handles errors based on the unknown handling option.
291
+ * @param message The error message.
292
+ * @returns void
293
+ */
244
294
  handleError(message) {
245
295
  switch (this.unknown) {
246
296
  case directory_js_1.UnknownHandling.Ignore:
@@ -3,6 +3,10 @@ import { Document } from "../../document.js";
3
3
  import { BaseDocumentLoader } from "../base.js";
4
4
  import { UnknownHandling } from "../fs/directory.js";
5
5
  import { AsyncCaller, AsyncCallerParams } from "../../util/async_caller.js";
6
+ /**
7
+ * An interface that represents a file in a GitHub repository. It has
8
+ * properties for the file name, path, SHA, size, URLs, type, and links.
9
+ */
6
10
  export interface GithubFile {
7
11
  name: string;
8
12
  path: string;
@@ -19,6 +23,11 @@ export interface GithubFile {
19
23
  html: string;
20
24
  };
21
25
  }
26
+ /**
27
+ * An interface that represents the parameters for the GithubRepoLoader
28
+ * class. It extends the AsyncCallerParams interface and adds additional
29
+ * properties specific to the GitHub repository loader.
30
+ */
22
31
  export interface GithubRepoLoaderParams extends AsyncCallerParams {
23
32
  branch?: string;
24
33
  recursive?: boolean;
@@ -37,6 +46,11 @@ export interface GithubRepoLoaderParams extends AsyncCallerParams {
37
46
  */
38
47
  maxRetries?: number;
39
48
  }
49
+ /**
50
+ * A class that extends the BaseDocumentLoader and implements the
51
+ * GithubRepoLoaderParams interface. It represents a document loader for
52
+ * loading files from a GitHub repository.
53
+ */
40
54
  export declare class GithubRepoLoader extends BaseDocumentLoader implements GithubRepoLoaderParams {
41
55
  private readonly owner;
42
56
  private readonly repo;
@@ -51,8 +65,26 @@ export declare class GithubRepoLoader extends BaseDocumentLoader implements Gith
51
65
  verbose?: boolean;
52
66
  protected caller: AsyncCaller;
53
67
  constructor(githubUrl: string, { accessToken, branch, recursive, unknown, ignoreFiles, ignorePaths, verbose, maxConcurrency, maxRetries, ...rest }?: GithubRepoLoaderParams);
68
+ /**
69
+ * Extracts the owner, repository, and path from a GitHub URL.
70
+ * @param url The GitHub URL to extract information from.
71
+ * @returns An object containing the owner, repository, and path extracted from the GitHub URL.
72
+ */
54
73
  private extractOwnerAndRepoAndPath;
74
+ /**
75
+ * Fetches the files from the GitHub repository and creates Document
76
+ * instances for each file. It also handles error handling based on the
77
+ * unknown handling option.
78
+ * @returns A promise that resolves to an array of Document instances.
79
+ */
55
80
  load(): Promise<Document[]>;
81
+ /**
82
+ * Determines whether a file or directory should be ignored based on its
83
+ * path and type.
84
+ * @param path The path of the file or directory.
85
+ * @param fileType The type of the file or directory.
86
+ * @returns A boolean indicating whether the file or directory should be ignored.
87
+ */
56
88
  protected shouldIgnore(path: string, fileType: string): boolean;
57
89
  /**
58
90
  * Takes the file info and wrap it in a promise that will resolve to the file content and metadata
@@ -68,8 +100,29 @@ export declare class GithubRepoLoader extends BaseDocumentLoader implements Gith
68
100
  * Begins the process of fetching the contents of the repository
69
101
  */
70
102
  private processRepo;
103
+ /**
104
+ * Fetches the contents of a directory and maps the file / directory paths
105
+ * to promises that will fetch the file / directory contents.
106
+ * @param path The path of the directory to process.
107
+ * @returns A promise that resolves to an array of promises that will fetch the file / directory contents.
108
+ */
71
109
  private processDirectory;
110
+ /**
111
+ * Fetches the files from a GitHub repository.
112
+ * @param path The path of the repository to fetch the files from.
113
+ * @returns A promise that resolves to an array of GithubFile instances.
114
+ */
72
115
  private fetchRepoFiles;
116
+ /**
117
+ * Fetches the content of a file from a GitHub repository.
118
+ * @param file The file to fetch the content from.
119
+ * @returns A promise that resolves to the content of the file.
120
+ */
73
121
  private fetchFileContent;
122
+ /**
123
+ * Handles errors based on the unknown handling option.
124
+ * @param message The error message.
125
+ * @returns void
126
+ */
74
127
  private handleError;
75
128
  }