@illuma-ai/agents 1.0.89 → 1.0.93

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 (838) hide show
  1. package/dist/cjs/agents/AgentContext.cjs +98 -49
  2. package/dist/cjs/agents/AgentContext.cjs.map +1 -1
  3. package/dist/cjs/common/constants.cjs +25 -0
  4. package/dist/cjs/common/constants.cjs.map +1 -0
  5. package/dist/cjs/common/enum.cjs +30 -0
  6. package/dist/cjs/common/enum.cjs.map +1 -1
  7. package/dist/cjs/events.cjs +9 -4
  8. package/dist/cjs/events.cjs.map +1 -1
  9. package/dist/cjs/graphs/Graph.cjs +397 -92
  10. package/dist/cjs/graphs/Graph.cjs.map +1 -1
  11. package/dist/cjs/graphs/MultiAgentGraph.cjs +223 -92
  12. package/dist/cjs/graphs/MultiAgentGraph.cjs.map +1 -1
  13. package/dist/cjs/instrumentation.cjs +30 -14
  14. package/dist/cjs/instrumentation.cjs.map +1 -1
  15. package/dist/cjs/llm/anthropic/index.cjs +43 -11
  16. package/dist/cjs/llm/anthropic/index.cjs.map +1 -1
  17. package/dist/cjs/llm/anthropic/types.cjs.map +1 -1
  18. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs +10 -7
  19. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs.map +1 -1
  20. package/dist/cjs/llm/anthropic/utils/message_outputs.cjs +32 -0
  21. package/dist/cjs/llm/anthropic/utils/message_outputs.cjs.map +1 -1
  22. package/dist/cjs/llm/anthropic/utils/tools.cjs.map +1 -1
  23. package/dist/cjs/llm/bedrock/index.cjs +129 -101
  24. package/dist/cjs/llm/bedrock/index.cjs.map +1 -1
  25. package/dist/cjs/llm/bedrock/utils/message_inputs.cjs +489 -0
  26. package/dist/cjs/llm/bedrock/utils/message_inputs.cjs.map +1 -0
  27. package/dist/cjs/llm/bedrock/utils/message_outputs.cjs +176 -0
  28. package/dist/cjs/llm/bedrock/utils/message_outputs.cjs.map +1 -0
  29. package/dist/cjs/llm/fake.cjs.map +1 -1
  30. package/dist/cjs/llm/google/index.cjs.map +1 -1
  31. package/dist/cjs/llm/google/utils/common.cjs.map +1 -1
  32. package/dist/cjs/llm/openai/index.cjs +1 -1
  33. package/dist/cjs/llm/openai/index.cjs.map +1 -1
  34. package/dist/cjs/llm/openai/utils/index.cjs.map +1 -1
  35. package/dist/cjs/llm/openrouter/index.cjs +59 -5
  36. package/dist/cjs/llm/openrouter/index.cjs.map +1 -1
  37. package/dist/cjs/llm/providers.cjs.map +1 -1
  38. package/dist/cjs/llm/text.cjs.map +1 -1
  39. package/dist/cjs/llm/vertexai/index.cjs +80 -2
  40. package/dist/cjs/llm/vertexai/index.cjs.map +1 -1
  41. package/dist/cjs/main.cjs +60 -27
  42. package/dist/cjs/main.cjs.map +1 -1
  43. package/dist/cjs/messages/cache.cjs +131 -108
  44. package/dist/cjs/messages/cache.cjs.map +1 -1
  45. package/dist/cjs/messages/content.cjs.map +1 -1
  46. package/dist/cjs/messages/core.cjs +3 -0
  47. package/dist/cjs/messages/core.cjs.map +1 -1
  48. package/dist/cjs/messages/format.cjs +265 -47
  49. package/dist/cjs/messages/format.cjs.map +1 -1
  50. package/dist/cjs/messages/ids.cjs.map +1 -1
  51. package/dist/cjs/messages/prune.cjs +55 -2
  52. package/dist/cjs/messages/prune.cjs.map +1 -1
  53. package/dist/cjs/messages/summarize.cjs +170 -0
  54. package/dist/cjs/messages/summarize.cjs.map +1 -0
  55. package/dist/cjs/messages/tools.cjs.map +1 -1
  56. package/dist/cjs/run.cjs +87 -30
  57. package/dist/cjs/run.cjs.map +1 -1
  58. package/dist/cjs/schemas/validate.cjs.map +1 -1
  59. package/dist/cjs/splitStream.cjs.map +1 -1
  60. package/dist/cjs/stream.cjs +59 -25
  61. package/dist/cjs/stream.cjs.map +1 -1
  62. package/dist/cjs/tools/AskUser.cjs +131 -0
  63. package/dist/cjs/tools/AskUser.cjs.map +1 -0
  64. package/dist/cjs/tools/BrowserTools.cjs +11 -7
  65. package/dist/cjs/tools/BrowserTools.cjs.map +1 -1
  66. package/dist/cjs/tools/Calculator.cjs.map +1 -1
  67. package/dist/cjs/tools/CodeExecutor.cjs +46 -4
  68. package/dist/cjs/tools/CodeExecutor.cjs.map +1 -1
  69. package/dist/cjs/tools/ProgrammaticToolCalling.cjs +36 -53
  70. package/dist/cjs/tools/ProgrammaticToolCalling.cjs.map +1 -1
  71. package/dist/cjs/tools/StreamingToolCallBuffer.cjs +208 -0
  72. package/dist/cjs/tools/StreamingToolCallBuffer.cjs.map +1 -0
  73. package/dist/cjs/tools/ToolNode.cjs +333 -30
  74. package/dist/cjs/tools/ToolNode.cjs.map +1 -1
  75. package/dist/cjs/tools/ToolSearch.cjs +66 -30
  76. package/dist/cjs/tools/ToolSearch.cjs.map +1 -1
  77. package/dist/cjs/tools/handlers.cjs +94 -8
  78. package/dist/cjs/tools/handlers.cjs.map +1 -1
  79. package/dist/cjs/tools/schema.cjs.map +1 -1
  80. package/dist/cjs/tools/search/content.cjs.map +1 -1
  81. package/dist/cjs/tools/search/firecrawl.cjs.map +1 -1
  82. package/dist/cjs/tools/search/format.cjs.map +1 -1
  83. package/dist/cjs/tools/search/highlights.cjs.map +1 -1
  84. package/dist/cjs/tools/search/rerankers.cjs.map +1 -1
  85. package/dist/cjs/tools/search/schema.cjs.map +1 -1
  86. package/dist/cjs/tools/search/search.cjs +1 -0
  87. package/dist/cjs/tools/search/search.cjs.map +1 -1
  88. package/dist/cjs/tools/search/serper-scraper.cjs.map +1 -1
  89. package/dist/cjs/tools/search/tool.cjs.map +1 -1
  90. package/dist/cjs/tools/search/utils.cjs.map +1 -1
  91. package/dist/cjs/types/graph.cjs +1 -1
  92. package/dist/cjs/types/graph.cjs.map +1 -1
  93. package/dist/cjs/utils/contextAnalytics.cjs +23 -6
  94. package/dist/cjs/utils/contextAnalytics.cjs.map +1 -1
  95. package/dist/cjs/utils/events.cjs.map +1 -1
  96. package/dist/cjs/utils/graph.cjs.map +1 -1
  97. package/dist/cjs/utils/handlers.cjs.map +1 -1
  98. package/dist/cjs/utils/llm.cjs.map +1 -1
  99. package/dist/cjs/utils/misc.cjs.map +1 -1
  100. package/dist/cjs/utils/run.cjs +3 -1
  101. package/dist/cjs/utils/run.cjs.map +1 -1
  102. package/dist/cjs/utils/schema.cjs.map +1 -1
  103. package/dist/cjs/utils/title.cjs.map +1 -1
  104. package/dist/cjs/utils/tokens.cjs +33 -58
  105. package/dist/cjs/utils/tokens.cjs.map +1 -1
  106. package/dist/cjs/utils/toolCallContinuation.cjs +55 -0
  107. package/dist/cjs/utils/toolCallContinuation.cjs.map +1 -0
  108. package/dist/cjs/utils/toonFormat.cjs.map +1 -1
  109. package/dist/esm/agents/AgentContext.mjs +98 -49
  110. package/dist/esm/agents/AgentContext.mjs.map +1 -1
  111. package/dist/esm/common/constants.mjs +22 -0
  112. package/dist/esm/common/constants.mjs.map +1 -0
  113. package/dist/esm/common/enum.mjs +31 -1
  114. package/dist/esm/common/enum.mjs.map +1 -1
  115. package/dist/esm/events.mjs +9 -4
  116. package/dist/esm/events.mjs.map +1 -1
  117. package/dist/esm/graphs/Graph.mjs +393 -88
  118. package/dist/esm/graphs/Graph.mjs.map +1 -1
  119. package/dist/esm/graphs/MultiAgentGraph.mjs +224 -93
  120. package/dist/esm/graphs/MultiAgentGraph.mjs.map +1 -1
  121. package/dist/esm/instrumentation.mjs +30 -14
  122. package/dist/esm/instrumentation.mjs.map +1 -1
  123. package/dist/esm/llm/anthropic/index.mjs +43 -11
  124. package/dist/esm/llm/anthropic/index.mjs.map +1 -1
  125. package/dist/esm/llm/anthropic/types.mjs.map +1 -1
  126. package/dist/esm/llm/anthropic/utils/message_inputs.mjs +10 -7
  127. package/dist/esm/llm/anthropic/utils/message_inputs.mjs.map +1 -1
  128. package/dist/esm/llm/anthropic/utils/message_outputs.mjs +32 -0
  129. package/dist/esm/llm/anthropic/utils/message_outputs.mjs.map +1 -1
  130. package/dist/esm/llm/anthropic/utils/tools.mjs.map +1 -1
  131. package/dist/esm/llm/bedrock/index.mjs +128 -101
  132. package/dist/esm/llm/bedrock/index.mjs.map +1 -1
  133. package/dist/esm/llm/bedrock/utils/message_inputs.mjs +484 -0
  134. package/dist/esm/llm/bedrock/utils/message_inputs.mjs.map +1 -0
  135. package/dist/esm/llm/bedrock/utils/message_outputs.mjs +171 -0
  136. package/dist/esm/llm/bedrock/utils/message_outputs.mjs.map +1 -0
  137. package/dist/esm/llm/fake.mjs.map +1 -1
  138. package/dist/esm/llm/google/index.mjs.map +1 -1
  139. package/dist/esm/llm/google/utils/common.mjs.map +1 -1
  140. package/dist/esm/llm/openai/index.mjs +1 -1
  141. package/dist/esm/llm/openai/index.mjs.map +1 -1
  142. package/dist/esm/llm/openai/utils/index.mjs.map +1 -1
  143. package/dist/esm/llm/openrouter/index.mjs +59 -5
  144. package/dist/esm/llm/openrouter/index.mjs.map +1 -1
  145. package/dist/esm/llm/providers.mjs.map +1 -1
  146. package/dist/esm/llm/text.mjs.map +1 -1
  147. package/dist/esm/llm/vertexai/index.mjs +80 -2
  148. package/dist/esm/llm/vertexai/index.mjs.map +1 -1
  149. package/dist/esm/main.mjs +8 -3
  150. package/dist/esm/main.mjs.map +1 -1
  151. package/dist/esm/messages/cache.mjs +131 -108
  152. package/dist/esm/messages/cache.mjs.map +1 -1
  153. package/dist/esm/messages/content.mjs.map +1 -1
  154. package/dist/esm/messages/core.mjs +4 -1
  155. package/dist/esm/messages/core.mjs.map +1 -1
  156. package/dist/esm/messages/format.mjs +267 -49
  157. package/dist/esm/messages/format.mjs.map +1 -1
  158. package/dist/esm/messages/ids.mjs.map +1 -1
  159. package/dist/esm/messages/prune.mjs +56 -4
  160. package/dist/esm/messages/prune.mjs.map +1 -1
  161. package/dist/esm/messages/summarize.mjs +161 -0
  162. package/dist/esm/messages/summarize.mjs.map +1 -0
  163. package/dist/esm/messages/tools.mjs.map +1 -1
  164. package/dist/esm/run.mjs +88 -31
  165. package/dist/esm/run.mjs.map +1 -1
  166. package/dist/esm/schemas/validate.mjs.map +1 -1
  167. package/dist/esm/splitStream.mjs.map +1 -1
  168. package/dist/esm/stream.mjs +60 -26
  169. package/dist/esm/stream.mjs.map +1 -1
  170. package/dist/esm/tools/AskUser.mjs +125 -0
  171. package/dist/esm/tools/AskUser.mjs.map +1 -0
  172. package/dist/esm/tools/BrowserTools.mjs +11 -7
  173. package/dist/esm/tools/BrowserTools.mjs.map +1 -1
  174. package/dist/esm/tools/Calculator.mjs.map +1 -1
  175. package/dist/esm/tools/CodeExecutor.mjs +46 -4
  176. package/dist/esm/tools/CodeExecutor.mjs.map +1 -1
  177. package/dist/esm/tools/ProgrammaticToolCalling.mjs +37 -54
  178. package/dist/esm/tools/ProgrammaticToolCalling.mjs.map +1 -1
  179. package/dist/esm/tools/StreamingToolCallBuffer.mjs +206 -0
  180. package/dist/esm/tools/StreamingToolCallBuffer.mjs.map +1 -0
  181. package/dist/esm/tools/ToolNode.mjs +333 -30
  182. package/dist/esm/tools/ToolNode.mjs.map +1 -1
  183. package/dist/esm/tools/ToolSearch.mjs +66 -30
  184. package/dist/esm/tools/ToolSearch.mjs.map +1 -1
  185. package/dist/esm/tools/handlers.mjs +95 -9
  186. package/dist/esm/tools/handlers.mjs.map +1 -1
  187. package/dist/esm/tools/schema.mjs.map +1 -1
  188. package/dist/esm/tools/search/content.mjs.map +1 -1
  189. package/dist/esm/tools/search/firecrawl.mjs.map +1 -1
  190. package/dist/esm/tools/search/format.mjs.map +1 -1
  191. package/dist/esm/tools/search/highlights.mjs.map +1 -1
  192. package/dist/esm/tools/search/rerankers.mjs.map +1 -1
  193. package/dist/esm/tools/search/schema.mjs.map +1 -1
  194. package/dist/esm/tools/search/search.mjs +1 -0
  195. package/dist/esm/tools/search/search.mjs.map +1 -1
  196. package/dist/esm/tools/search/serper-scraper.mjs.map +1 -1
  197. package/dist/esm/tools/search/tool.mjs.map +1 -1
  198. package/dist/esm/tools/search/utils.mjs.map +1 -1
  199. package/dist/esm/types/graph.mjs +1 -1
  200. package/dist/esm/types/graph.mjs.map +1 -1
  201. package/dist/esm/utils/contextAnalytics.mjs +23 -6
  202. package/dist/esm/utils/contextAnalytics.mjs.map +1 -1
  203. package/dist/esm/utils/events.mjs.map +1 -1
  204. package/dist/esm/utils/graph.mjs.map +1 -1
  205. package/dist/esm/utils/handlers.mjs.map +1 -1
  206. package/dist/esm/utils/llm.mjs.map +1 -1
  207. package/dist/esm/utils/misc.mjs.map +1 -1
  208. package/dist/esm/utils/run.mjs +3 -1
  209. package/dist/esm/utils/run.mjs.map +1 -1
  210. package/dist/esm/utils/schema.mjs.map +1 -1
  211. package/dist/esm/utils/title.mjs.map +1 -1
  212. package/dist/esm/utils/tokens.mjs +33 -59
  213. package/dist/esm/utils/tokens.mjs.map +1 -1
  214. package/dist/esm/utils/toolCallContinuation.mjs +52 -0
  215. package/dist/esm/utils/toolCallContinuation.mjs.map +1 -0
  216. package/dist/esm/utils/toonFormat.mjs.map +1 -1
  217. package/dist/types/agents/AgentContext.d.ts +14 -7
  218. package/dist/types/common/constants.d.ts +18 -0
  219. package/dist/types/common/enum.d.ts +28 -0
  220. package/dist/types/common/index.d.ts +1 -0
  221. package/dist/types/events.d.ts +10 -3
  222. package/dist/types/graphs/Graph.d.ts +37 -0
  223. package/dist/types/index.d.ts +4 -0
  224. package/dist/types/llm/anthropic/index.d.ts +7 -1
  225. package/dist/types/llm/anthropic/types.d.ts +5 -2
  226. package/dist/types/llm/anthropic/utils/message_outputs.d.ts +1 -1
  227. package/dist/types/llm/bedrock/index.d.ts +40 -33
  228. package/dist/types/llm/bedrock/utils/message_outputs.d.ts +1 -1
  229. package/dist/types/llm/google/index.d.ts +2 -3
  230. package/dist/types/llm/openrouter/index.d.ts +21 -1
  231. package/dist/types/llm/vertexai/index.d.ts +3 -2
  232. package/dist/types/messages/cache.d.ts +1 -1
  233. package/dist/types/messages/index.d.ts +1 -0
  234. package/dist/types/messages/prune.d.ts +2 -7
  235. package/dist/types/messages/summarize.d.ts +33 -0
  236. package/dist/types/run.d.ts +6 -0
  237. package/dist/types/tools/AskUser.d.ts +408 -0
  238. package/dist/types/tools/BrowserTools.d.ts +2 -2
  239. package/dist/types/tools/CodeExecutor.d.ts +2 -2
  240. package/dist/types/tools/StreamingToolCallBuffer.d.ts +106 -0
  241. package/dist/types/tools/ToolNode.d.ts +55 -3
  242. package/dist/types/tools/ToolSearch.d.ts +9 -5
  243. package/dist/types/tools/handlers.d.ts +2 -2
  244. package/dist/types/types/graph.d.ts +9 -2
  245. package/dist/types/types/llm.d.ts +8 -3
  246. package/dist/types/types/run.d.ts +2 -0
  247. package/dist/types/types/tools.d.ts +20 -2
  248. package/dist/types/utils/contextAnalytics.d.ts +5 -4
  249. package/dist/types/utils/index.d.ts +1 -0
  250. package/dist/types/utils/tokens.d.ts +6 -19
  251. package/dist/types/utils/toolCallContinuation.d.ts +30 -0
  252. package/package.json +15 -8
  253. package/src/agents/AgentContext.js +782 -0
  254. package/src/agents/AgentContext.js.map +1 -0
  255. package/src/agents/AgentContext.test.js +421 -0
  256. package/src/agents/AgentContext.test.js.map +1 -0
  257. package/src/agents/AgentContext.ts +132 -64
  258. package/src/agents/__tests__/AgentContext.test.js +678 -0
  259. package/src/agents/__tests__/AgentContext.test.js.map +1 -0
  260. package/src/agents/__tests__/AgentContext.test.ts +25 -4
  261. package/src/agents/__tests__/resolveStructuredOutputMode.test.js +117 -0
  262. package/src/agents/__tests__/resolveStructuredOutputMode.test.js.map +1 -0
  263. package/src/common/__tests__/enum.test.ts +135 -0
  264. package/src/common/constants.ts +21 -0
  265. package/src/common/enum.js +192 -0
  266. package/src/common/enum.js.map +1 -0
  267. package/src/common/enum.ts +30 -0
  268. package/src/common/index.js +3 -0
  269. package/src/common/index.js.map +1 -0
  270. package/src/common/index.ts +2 -1
  271. package/src/events.js +166 -0
  272. package/src/events.js.map +1 -0
  273. package/src/events.ts +11 -14
  274. package/src/graphs/Graph.js +1857 -0
  275. package/src/graphs/Graph.js.map +1 -0
  276. package/src/graphs/Graph.ts +580 -162
  277. package/src/graphs/MultiAgentGraph.js +1092 -0
  278. package/src/graphs/MultiAgentGraph.js.map +1 -0
  279. package/src/graphs/MultiAgentGraph.ts +331 -112
  280. package/src/graphs/__tests__/adaptive-thinking.test.ts +369 -0
  281. package/src/graphs/__tests__/graph-direct-tool-names.test.ts +210 -0
  282. package/src/graphs/__tests__/multi-agent-edges.test.ts +237 -0
  283. package/src/graphs/__tests__/structured-output.integration.test.js +624 -0
  284. package/src/graphs/__tests__/structured-output.integration.test.js.map +1 -0
  285. package/src/graphs/__tests__/structured-output.test.js +144 -0
  286. package/src/graphs/__tests__/structured-output.test.js.map +1 -0
  287. package/src/graphs/contextManagement.e2e.test.js +718 -0
  288. package/src/graphs/contextManagement.e2e.test.js.map +1 -0
  289. package/src/graphs/contextManagement.e2e.test.ts +990 -0
  290. package/src/graphs/contextManagement.test.js +485 -0
  291. package/src/graphs/contextManagement.test.js.map +1 -0
  292. package/src/graphs/contextManagement.test.ts +625 -0
  293. package/src/graphs/handoffValidation.test.js +276 -0
  294. package/src/graphs/handoffValidation.test.js.map +1 -0
  295. package/src/graphs/handoffValidation.test.ts +353 -0
  296. package/src/graphs/index.js +3 -0
  297. package/src/graphs/index.js.map +1 -0
  298. package/src/index.js +28 -0
  299. package/src/index.js.map +1 -0
  300. package/src/index.ts +13 -0
  301. package/src/instrumentation.js +21 -0
  302. package/src/instrumentation.js.map +1 -0
  303. package/src/instrumentation.ts +38 -17
  304. package/src/llm/anthropic/index.js +319 -0
  305. package/src/llm/anthropic/index.js.map +1 -0
  306. package/src/llm/anthropic/index.ts +68 -15
  307. package/src/llm/anthropic/llm.spec.ts +402 -0
  308. package/src/llm/anthropic/types.js +46 -0
  309. package/src/llm/anthropic/types.js.map +1 -0
  310. package/src/llm/anthropic/types.ts +8 -2
  311. package/src/llm/anthropic/utils/message_inputs.js +627 -0
  312. package/src/llm/anthropic/utils/message_inputs.js.map +1 -0
  313. package/src/llm/anthropic/utils/message_inputs.ts +16 -33
  314. package/src/llm/anthropic/utils/message_outputs.js +290 -0
  315. package/src/llm/anthropic/utils/message_outputs.js.map +1 -0
  316. package/src/llm/anthropic/utils/message_outputs.ts +40 -1
  317. package/src/llm/anthropic/utils/output_parsers.js +89 -0
  318. package/src/llm/anthropic/utils/output_parsers.js.map +1 -0
  319. package/src/llm/anthropic/utils/tools.js +25 -0
  320. package/src/llm/anthropic/utils/tools.js.map +1 -0
  321. package/src/llm/bedrock/__tests__/bedrock-caching.test.js +392 -0
  322. package/src/llm/bedrock/__tests__/bedrock-caching.test.js.map +1 -0
  323. package/src/llm/bedrock/__tests__/bedrock-caching.test.ts +24 -40
  324. package/src/llm/bedrock/index.js +303 -0
  325. package/src/llm/bedrock/index.js.map +1 -0
  326. package/src/llm/bedrock/index.ts +171 -134
  327. package/src/llm/bedrock/llm.spec.ts +395 -52
  328. package/src/llm/bedrock/types.js +2 -0
  329. package/src/llm/bedrock/types.js.map +1 -0
  330. package/src/llm/bedrock/utils/index.js +6 -0
  331. package/src/llm/bedrock/utils/index.js.map +1 -0
  332. package/src/llm/bedrock/utils/message_inputs.js +463 -0
  333. package/src/llm/bedrock/utils/message_inputs.js.map +1 -0
  334. package/src/llm/bedrock/utils/message_inputs.ts +30 -5
  335. package/src/llm/bedrock/utils/message_outputs.js +269 -0
  336. package/src/llm/bedrock/utils/message_outputs.js.map +1 -0
  337. package/src/llm/bedrock/utils/message_outputs.ts +70 -22
  338. package/src/llm/fake.js +92 -0
  339. package/src/llm/fake.js.map +1 -0
  340. package/src/llm/google/index.js +215 -0
  341. package/src/llm/google/index.js.map +1 -0
  342. package/src/llm/google/index.ts +2 -3
  343. package/src/llm/google/types.js +12 -0
  344. package/src/llm/google/types.js.map +1 -0
  345. package/src/llm/google/utils/common.js +670 -0
  346. package/src/llm/google/utils/common.js.map +1 -0
  347. package/src/llm/google/utils/tools.js +111 -0
  348. package/src/llm/google/utils/tools.js.map +1 -0
  349. package/src/llm/google/utils/zod_to_genai_parameters.js +47 -0
  350. package/src/llm/google/utils/zod_to_genai_parameters.js.map +1 -0
  351. package/src/llm/openai/index.js +1033 -0
  352. package/src/llm/openai/index.js.map +1 -0
  353. package/src/llm/openai/types.js +2 -0
  354. package/src/llm/openai/types.js.map +1 -0
  355. package/src/llm/openai/utils/index.js +756 -0
  356. package/src/llm/openai/utils/index.js.map +1 -0
  357. package/src/llm/openai/utils/isReasoningModel.test.js +79 -0
  358. package/src/llm/openai/utils/isReasoningModel.test.js.map +1 -0
  359. package/src/llm/openrouter/index.js +261 -0
  360. package/src/llm/openrouter/index.js.map +1 -0
  361. package/src/llm/openrouter/index.ts +117 -6
  362. package/src/llm/openrouter/reasoning.test.js +181 -0
  363. package/src/llm/openrouter/reasoning.test.js.map +1 -0
  364. package/src/llm/openrouter/reasoning.test.ts +207 -0
  365. package/src/llm/providers.js +36 -0
  366. package/src/llm/providers.js.map +1 -0
  367. package/src/llm/text.js +65 -0
  368. package/src/llm/text.js.map +1 -0
  369. package/src/llm/vertexai/index.js +402 -0
  370. package/src/llm/vertexai/index.js.map +1 -0
  371. package/src/llm/vertexai/index.ts +115 -5
  372. package/src/llm/vertexai/llm.spec.ts +114 -0
  373. package/src/messages/__tests__/tools.test.js +392 -0
  374. package/src/messages/__tests__/tools.test.js.map +1 -0
  375. package/src/messages/cache.js +404 -0
  376. package/src/messages/cache.js.map +1 -0
  377. package/src/messages/cache.test.js +1167 -0
  378. package/src/messages/cache.test.js.map +1 -0
  379. package/src/messages/cache.test.ts +178 -16
  380. package/src/messages/cache.ts +152 -147
  381. package/src/messages/content.js +48 -0
  382. package/src/messages/content.js.map +1 -0
  383. package/src/messages/content.test.js +314 -0
  384. package/src/messages/content.test.js.map +1 -0
  385. package/src/messages/core.js +359 -0
  386. package/src/messages/core.js.map +1 -0
  387. package/src/messages/core.ts +5 -0
  388. package/src/messages/ensureThinkingBlock.test.js +997 -0
  389. package/src/messages/ensureThinkingBlock.test.js.map +1 -0
  390. package/src/messages/ensureThinkingBlock.test.ts +751 -10
  391. package/src/messages/format.js +973 -0
  392. package/src/messages/format.js.map +1 -0
  393. package/src/messages/format.ts +334 -57
  394. package/src/messages/formatAgentMessages.test.js +2278 -0
  395. package/src/messages/formatAgentMessages.test.js.map +1 -0
  396. package/src/messages/formatAgentMessages.test.ts +1175 -1
  397. package/src/messages/formatAgentMessages.tools.test.js +362 -0
  398. package/src/messages/formatAgentMessages.tools.test.js.map +1 -0
  399. package/src/messages/formatMessage.test.js +608 -0
  400. package/src/messages/formatMessage.test.js.map +1 -0
  401. package/src/messages/ids.js +18 -0
  402. package/src/messages/ids.js.map +1 -0
  403. package/src/messages/index.js +9 -0
  404. package/src/messages/index.js.map +1 -0
  405. package/src/messages/index.ts +1 -0
  406. package/src/messages/labelContentByAgent.test.js +725 -0
  407. package/src/messages/labelContentByAgent.test.js.map +1 -0
  408. package/src/messages/prune.js +438 -0
  409. package/src/messages/prune.js.map +1 -0
  410. package/src/messages/prune.ts +87 -25
  411. package/src/messages/reducer.js +60 -0
  412. package/src/messages/reducer.js.map +1 -0
  413. package/src/messages/shiftIndexTokenCountMap.test.js +63 -0
  414. package/src/messages/shiftIndexTokenCountMap.test.js.map +1 -0
  415. package/src/messages/summarize.js +146 -0
  416. package/src/messages/summarize.js.map +1 -0
  417. package/src/messages/summarize.test.js +332 -0
  418. package/src/messages/summarize.test.js.map +1 -0
  419. package/src/messages/summarize.test.ts +466 -0
  420. package/src/messages/summarize.ts +222 -0
  421. package/src/messages/tools.js +90 -0
  422. package/src/messages/tools.js.map +1 -0
  423. package/src/mockStream.js +81 -0
  424. package/src/mockStream.js.map +1 -0
  425. package/src/prompts/collab.js +7 -0
  426. package/src/prompts/collab.js.map +1 -0
  427. package/src/prompts/index.js +3 -0
  428. package/src/prompts/index.js.map +1 -0
  429. package/src/prompts/taskmanager.js +58 -0
  430. package/src/prompts/taskmanager.js.map +1 -0
  431. package/src/run.js +427 -0
  432. package/src/run.js.map +1 -0
  433. package/src/run.ts +101 -33
  434. package/src/schemas/index.js +3 -0
  435. package/src/schemas/index.js.map +1 -0
  436. package/src/schemas/schema-preparation.test.js +370 -0
  437. package/src/schemas/schema-preparation.test.js.map +1 -0
  438. package/src/schemas/validate.js +314 -0
  439. package/src/schemas/validate.js.map +1 -0
  440. package/src/schemas/validate.test.js +264 -0
  441. package/src/schemas/validate.test.js.map +1 -0
  442. package/src/scripts/abort.js +127 -0
  443. package/src/scripts/abort.js.map +1 -0
  444. package/src/scripts/ant_web_search.js +130 -0
  445. package/src/scripts/ant_web_search.js.map +1 -0
  446. package/src/scripts/ant_web_search.ts +1 -0
  447. package/src/scripts/ant_web_search_edge_case.js +133 -0
  448. package/src/scripts/ant_web_search_edge_case.js.map +1 -0
  449. package/src/scripts/ant_web_search_edge_case.ts +1 -0
  450. package/src/scripts/ant_web_search_error_edge_case.js +119 -0
  451. package/src/scripts/ant_web_search_error_edge_case.js.map +1 -0
  452. package/src/scripts/ant_web_search_error_edge_case.ts +1 -0
  453. package/src/scripts/args.js +41 -0
  454. package/src/scripts/args.js.map +1 -0
  455. package/src/scripts/bedrock-cache-debug.js +186 -0
  456. package/src/scripts/bedrock-cache-debug.js.map +1 -0
  457. package/src/scripts/bedrock-cache-debug.ts +250 -0
  458. package/src/scripts/bedrock-content-aggregation-test.js +195 -0
  459. package/src/scripts/bedrock-content-aggregation-test.js.map +1 -0
  460. package/src/scripts/bedrock-content-aggregation-test.ts +266 -0
  461. package/src/scripts/bedrock-merge-test.js +80 -0
  462. package/src/scripts/bedrock-merge-test.js.map +1 -0
  463. package/src/scripts/bedrock-merge-test.ts +107 -0
  464. package/src/scripts/bedrock-parallel-tools-test.js +150 -0
  465. package/src/scripts/bedrock-parallel-tools-test.js.map +1 -0
  466. package/src/scripts/bedrock-parallel-tools-test.ts +204 -0
  467. package/src/scripts/caching.js +106 -0
  468. package/src/scripts/caching.js.map +1 -0
  469. package/src/scripts/caching.ts +1 -0
  470. package/src/scripts/cli.js +152 -0
  471. package/src/scripts/cli.js.map +1 -0
  472. package/src/scripts/cli2.js +119 -0
  473. package/src/scripts/cli2.js.map +1 -0
  474. package/src/scripts/cli3.js +163 -0
  475. package/src/scripts/cli3.js.map +1 -0
  476. package/src/scripts/cli4.js +165 -0
  477. package/src/scripts/cli4.js.map +1 -0
  478. package/src/scripts/cli5.js +165 -0
  479. package/src/scripts/cli5.js.map +1 -0
  480. package/src/scripts/code_exec.js +171 -0
  481. package/src/scripts/code_exec.js.map +1 -0
  482. package/src/scripts/code_exec.ts +1 -0
  483. package/src/scripts/code_exec_files.js +180 -0
  484. package/src/scripts/code_exec_files.js.map +1 -0
  485. package/src/scripts/code_exec_files.ts +1 -0
  486. package/src/scripts/code_exec_multi_session.js +185 -0
  487. package/src/scripts/code_exec_multi_session.js.map +1 -0
  488. package/src/scripts/code_exec_multi_session.ts +9 -13
  489. package/src/scripts/code_exec_ptc.js +265 -0
  490. package/src/scripts/code_exec_ptc.js.map +1 -0
  491. package/src/scripts/code_exec_ptc.ts +1 -0
  492. package/src/scripts/code_exec_session.js +217 -0
  493. package/src/scripts/code_exec_session.js.map +1 -0
  494. package/src/scripts/code_exec_session.ts +1 -0
  495. package/src/scripts/code_exec_simple.js +120 -0
  496. package/src/scripts/code_exec_simple.js.map +1 -0
  497. package/src/scripts/code_exec_simple.ts +1 -0
  498. package/src/scripts/content.js +111 -0
  499. package/src/scripts/content.js.map +1 -0
  500. package/src/scripts/content.ts +1 -0
  501. package/src/scripts/empty_input.js +125 -0
  502. package/src/scripts/empty_input.js.map +1 -0
  503. package/src/scripts/handoff-test.js +96 -0
  504. package/src/scripts/handoff-test.js.map +1 -0
  505. package/src/scripts/image.js +138 -0
  506. package/src/scripts/image.js.map +1 -0
  507. package/src/scripts/image.ts +3 -1
  508. package/src/scripts/memory.js +83 -0
  509. package/src/scripts/memory.js.map +1 -0
  510. package/src/scripts/memory.ts +16 -6
  511. package/src/scripts/multi-agent-chain.js +271 -0
  512. package/src/scripts/multi-agent-chain.js.map +1 -0
  513. package/src/scripts/multi-agent-chain.ts +1 -0
  514. package/src/scripts/multi-agent-conditional.js +185 -0
  515. package/src/scripts/multi-agent-conditional.js.map +1 -0
  516. package/src/scripts/multi-agent-conditional.ts +1 -0
  517. package/src/scripts/multi-agent-document-review-chain.js +171 -0
  518. package/src/scripts/multi-agent-document-review-chain.js.map +1 -0
  519. package/src/scripts/multi-agent-document-review-chain.ts +1 -0
  520. package/src/scripts/multi-agent-hybrid-flow.js +264 -0
  521. package/src/scripts/multi-agent-hybrid-flow.js.map +1 -0
  522. package/src/scripts/multi-agent-hybrid-flow.ts +1 -0
  523. package/src/scripts/multi-agent-parallel-start.js +214 -0
  524. package/src/scripts/multi-agent-parallel-start.js.map +1 -0
  525. package/src/scripts/multi-agent-parallel-start.ts +4 -4
  526. package/src/scripts/multi-agent-parallel.js +346 -0
  527. package/src/scripts/multi-agent-parallel.js.map +1 -0
  528. package/src/scripts/multi-agent-parallel.ts +1 -0
  529. package/src/scripts/multi-agent-sequence.js +184 -0
  530. package/src/scripts/multi-agent-sequence.js.map +1 -0
  531. package/src/scripts/multi-agent-sequence.ts +4 -4
  532. package/src/scripts/multi-agent-supervisor.js +324 -0
  533. package/src/scripts/multi-agent-supervisor.js.map +1 -0
  534. package/src/scripts/multi-agent-supervisor.ts +1 -0
  535. package/src/scripts/multi-agent-test.js +147 -0
  536. package/src/scripts/multi-agent-test.js.map +1 -0
  537. package/src/scripts/multi-agent-test.ts +1 -0
  538. package/src/scripts/parallel-asymmetric-tools-test.js +202 -0
  539. package/src/scripts/parallel-asymmetric-tools-test.js.map +1 -0
  540. package/src/scripts/parallel-asymmetric-tools-test.ts +1 -0
  541. package/src/scripts/parallel-full-metadata-test.js +176 -0
  542. package/src/scripts/parallel-full-metadata-test.js.map +1 -0
  543. package/src/scripts/parallel-full-metadata-test.ts +1 -0
  544. package/src/scripts/parallel-tools-test.js +256 -0
  545. package/src/scripts/parallel-tools-test.js.map +1 -0
  546. package/src/scripts/parallel-tools-test.ts +1 -0
  547. package/src/scripts/poc-multi-agent-comprehensive.ts +1222 -0
  548. package/src/scripts/programmatic_exec.js +277 -0
  549. package/src/scripts/programmatic_exec.js.map +1 -0
  550. package/src/scripts/programmatic_exec_agent.js +168 -0
  551. package/src/scripts/programmatic_exec_agent.js.map +1 -0
  552. package/src/scripts/programmatic_exec_agent.ts +1 -0
  553. package/src/scripts/search.js +118 -0
  554. package/src/scripts/search.js.map +1 -0
  555. package/src/scripts/search.ts +1 -0
  556. package/src/scripts/sequential-full-metadata-test.js +143 -0
  557. package/src/scripts/sequential-full-metadata-test.js.map +1 -0
  558. package/src/scripts/sequential-full-metadata-test.ts +1 -0
  559. package/src/scripts/simple.js +174 -0
  560. package/src/scripts/simple.js.map +1 -0
  561. package/src/scripts/simple.ts +2 -1
  562. package/src/scripts/single-agent-metadata-test.js +152 -0
  563. package/src/scripts/single-agent-metadata-test.js.map +1 -0
  564. package/src/scripts/single-agent-metadata-test.ts +4 -6
  565. package/src/scripts/stream.js +113 -0
  566. package/src/scripts/stream.js.map +1 -0
  567. package/src/scripts/stream.ts +1 -0
  568. package/src/scripts/test-custom-prompt-key.js +132 -0
  569. package/src/scripts/test-custom-prompt-key.js.map +1 -0
  570. package/src/scripts/test-handoff-input.js +143 -0
  571. package/src/scripts/test-handoff-input.js.map +1 -0
  572. package/src/scripts/test-handoff-preamble.js +227 -0
  573. package/src/scripts/test-handoff-preamble.js.map +1 -0
  574. package/src/scripts/test-handoff-preamble.ts +1 -0
  575. package/src/scripts/test-handoff-steering.js +353 -0
  576. package/src/scripts/test-handoff-steering.js.map +1 -0
  577. package/src/scripts/test-handoff-steering.ts +430 -0
  578. package/src/scripts/test-multi-agent-list-handoff.js +318 -0
  579. package/src/scripts/test-multi-agent-list-handoff.js.map +1 -0
  580. package/src/scripts/test-multi-agent-list-handoff.ts +1 -0
  581. package/src/scripts/test-parallel-agent-labeling.js +253 -0
  582. package/src/scripts/test-parallel-agent-labeling.js.map +1 -0
  583. package/src/scripts/test-parallel-agent-labeling.ts +2 -0
  584. package/src/scripts/test-parallel-handoffs.js +229 -0
  585. package/src/scripts/test-parallel-handoffs.js.map +1 -0
  586. package/src/scripts/test-parallel-handoffs.ts +1 -0
  587. package/src/scripts/test-thinking-handoff-bedrock.js +132 -0
  588. package/src/scripts/test-thinking-handoff-bedrock.js.map +1 -0
  589. package/src/scripts/test-thinking-handoff-bedrock.ts +1 -0
  590. package/src/scripts/test-thinking-handoff.js +132 -0
  591. package/src/scripts/test-thinking-handoff.js.map +1 -0
  592. package/src/scripts/test-thinking-handoff.ts +1 -0
  593. package/src/scripts/test-thinking-to-thinking-handoff-bedrock.js +140 -0
  594. package/src/scripts/test-thinking-to-thinking-handoff-bedrock.js.map +1 -0
  595. package/src/scripts/test-thinking-to-thinking-handoff-bedrock.ts +166 -0
  596. package/src/scripts/test-tool-before-handoff-role-order.js +223 -0
  597. package/src/scripts/test-tool-before-handoff-role-order.js.map +1 -0
  598. package/src/scripts/test-tool-before-handoff-role-order.ts +276 -0
  599. package/src/scripts/test-tools-before-handoff.js +187 -0
  600. package/src/scripts/test-tools-before-handoff.js.map +1 -0
  601. package/src/scripts/test-tools-before-handoff.ts +4 -8
  602. package/src/scripts/test_code_api.js +263 -0
  603. package/src/scripts/test_code_api.js.map +1 -0
  604. package/src/scripts/thinking-bedrock.js +128 -0
  605. package/src/scripts/thinking-bedrock.js.map +1 -0
  606. package/src/scripts/thinking-bedrock.ts +1 -0
  607. package/src/scripts/thinking-vertexai.js +130 -0
  608. package/src/scripts/thinking-vertexai.js.map +1 -0
  609. package/src/scripts/thinking-vertexai.ts +168 -0
  610. package/src/scripts/thinking.js +134 -0
  611. package/src/scripts/thinking.js.map +1 -0
  612. package/src/scripts/thinking.ts +1 -0
  613. package/src/scripts/tool_search.js +114 -0
  614. package/src/scripts/tool_search.js.map +1 -0
  615. package/src/scripts/tools.js +125 -0
  616. package/src/scripts/tools.js.map +1 -0
  617. package/src/scripts/tools.ts +5 -19
  618. package/src/specs/agent-handoffs-bedrock.integration.test.js +280 -0
  619. package/src/specs/agent-handoffs-bedrock.integration.test.js.map +1 -0
  620. package/src/specs/agent-handoffs-bedrock.integration.test.ts +412 -375
  621. package/src/specs/agent-handoffs.test.js +924 -0
  622. package/src/specs/agent-handoffs.test.js.map +1 -0
  623. package/src/specs/agent-handoffs.test.ts +152 -39
  624. package/src/specs/anthropic.simple.test.js +287 -0
  625. package/src/specs/anthropic.simple.test.js.map +1 -0
  626. package/src/specs/anthropic.simple.test.ts +7 -4
  627. package/src/specs/azure.simple.test.js +381 -0
  628. package/src/specs/azure.simple.test.js.map +1 -0
  629. package/src/specs/azure.simple.test.ts +143 -5
  630. package/src/specs/cache.simple.test.js +282 -0
  631. package/src/specs/cache.simple.test.js.map +1 -0
  632. package/src/specs/cache.simple.test.ts +9 -2
  633. package/src/specs/custom-event-await.test.js +148 -0
  634. package/src/specs/custom-event-await.test.js.map +1 -0
  635. package/src/specs/custom-event-await.test.ts +215 -0
  636. package/src/specs/deepseek.simple.test.js +189 -0
  637. package/src/specs/deepseek.simple.test.js.map +1 -0
  638. package/src/specs/deepseek.simple.test.ts +4 -2
  639. package/src/specs/emergency-prune.test.js +308 -0
  640. package/src/specs/emergency-prune.test.js.map +1 -0
  641. package/src/specs/moonshot.simple.test.js +237 -0
  642. package/src/specs/moonshot.simple.test.js.map +1 -0
  643. package/src/specs/moonshot.simple.test.ts +6 -2
  644. package/src/specs/observability.integration.test.js +1337 -0
  645. package/src/specs/observability.integration.test.js.map +1 -0
  646. package/src/specs/observability.integration.test.ts +2223 -0
  647. package/src/specs/openai.simple.test.js +233 -0
  648. package/src/specs/openai.simple.test.js.map +1 -0
  649. package/src/specs/openai.simple.test.ts +4 -2
  650. package/src/specs/openrouter.simple.test.js +202 -0
  651. package/src/specs/openrouter.simple.test.js.map +1 -0
  652. package/src/specs/openrouter.simple.test.ts +165 -4
  653. package/src/specs/prune.test.js +733 -0
  654. package/src/specs/prune.test.js.map +1 -0
  655. package/src/specs/prune.test.ts +1 -0
  656. package/src/specs/reasoning.test.js +144 -0
  657. package/src/specs/reasoning.test.js.map +1 -0
  658. package/src/specs/reasoning.test.ts +2 -2
  659. package/src/specs/spec.utils.js +4 -0
  660. package/src/specs/spec.utils.js.map +1 -0
  661. package/src/specs/thinking-handoff.test.js +486 -0
  662. package/src/specs/thinking-handoff.test.js.map +1 -0
  663. package/src/specs/thinking-handoff.test.ts +3 -2
  664. package/src/specs/thinking-prune.test.js +600 -0
  665. package/src/specs/thinking-prune.test.js.map +1 -0
  666. package/src/specs/token-distribution-edge-case.test.js +246 -0
  667. package/src/specs/token-distribution-edge-case.test.js.map +1 -0
  668. package/src/specs/token-memoization.test.js +32 -0
  669. package/src/specs/token-memoization.test.js.map +1 -0
  670. package/src/specs/token-memoization.test.ts +14 -5
  671. package/src/specs/tokens.test.js +49 -0
  672. package/src/specs/tokens.test.js.map +1 -0
  673. package/src/specs/tokens.test.ts +64 -0
  674. package/src/specs/tool-error.test.js +139 -0
  675. package/src/specs/tool-error.test.js.map +1 -0
  676. package/src/specs/tool-error.test.ts +2 -2
  677. package/src/splitStream.js +204 -0
  678. package/src/splitStream.js.map +1 -0
  679. package/src/splitStream.test.js +504 -0
  680. package/src/splitStream.test.js.map +1 -0
  681. package/src/stream.js +650 -0
  682. package/src/stream.js.map +1 -0
  683. package/src/stream.test.js +225 -0
  684. package/src/stream.test.js.map +1 -0
  685. package/src/stream.test.ts +25 -15
  686. package/src/stream.ts +82 -32
  687. package/src/test/mockTools.js +340 -0
  688. package/src/test/mockTools.js.map +1 -0
  689. package/src/tools/AskUser.ts +159 -0
  690. package/src/tools/BrowserTools.js +245 -0
  691. package/src/tools/BrowserTools.js.map +1 -0
  692. package/src/tools/BrowserTools.ts +12 -8
  693. package/src/tools/Calculator.js +38 -0
  694. package/src/tools/Calculator.js.map +1 -0
  695. package/src/tools/Calculator.test.js +225 -0
  696. package/src/tools/Calculator.test.js.map +1 -0
  697. package/src/tools/CodeExecutor.js +233 -0
  698. package/src/tools/CodeExecutor.js.map +1 -0
  699. package/src/tools/CodeExecutor.selfhealing.test.ts +435 -0
  700. package/src/tools/CodeExecutor.ts +62 -4
  701. package/src/tools/ProgrammaticToolCalling.js +602 -0
  702. package/src/tools/ProgrammaticToolCalling.js.map +1 -0
  703. package/src/tools/ProgrammaticToolCalling.ts +40 -52
  704. package/src/tools/StreamingToolCallBuffer.js +179 -0
  705. package/src/tools/StreamingToolCallBuffer.js.map +1 -0
  706. package/src/tools/StreamingToolCallBuffer.ts +218 -0
  707. package/src/tools/ToolNode.js +930 -0
  708. package/src/tools/ToolNode.js.map +1 -0
  709. package/src/tools/ToolNode.ts +454 -41
  710. package/src/tools/ToolSearch.js +904 -0
  711. package/src/tools/ToolSearch.js.map +1 -0
  712. package/src/tools/ToolSearch.ts +84 -33
  713. package/src/tools/__tests__/AskUser.test.ts +537 -0
  714. package/src/tools/__tests__/BrowserTools.test.js +306 -0
  715. package/src/tools/__tests__/BrowserTools.test.js.map +1 -0
  716. package/src/tools/__tests__/BrowserTools.test.ts +131 -6
  717. package/src/tools/__tests__/ProgrammaticToolCalling.integration.test.js +276 -0
  718. package/src/tools/__tests__/ProgrammaticToolCalling.integration.test.js.map +1 -0
  719. package/src/tools/__tests__/ProgrammaticToolCalling.test.js +807 -0
  720. package/src/tools/__tests__/ProgrammaticToolCalling.test.js.map +1 -0
  721. package/src/tools/__tests__/StreamingToolCallBuffer.test.js +175 -0
  722. package/src/tools/__tests__/StreamingToolCallBuffer.test.js.map +1 -0
  723. package/src/tools/__tests__/StreamingToolCallBuffer.test.ts +263 -0
  724. package/src/tools/__tests__/ToolApproval.test.js +675 -0
  725. package/src/tools/__tests__/ToolApproval.test.js.map +1 -0
  726. package/src/tools/__tests__/ToolApproval.test.ts +194 -20
  727. package/src/tools/__tests__/ToolNode.hitl.test.ts +267 -0
  728. package/src/tools/__tests__/ToolNode.recovery.test.js +200 -0
  729. package/src/tools/__tests__/ToolNode.recovery.test.js.map +1 -0
  730. package/src/tools/__tests__/ToolNode.recovery.test.ts +276 -0
  731. package/src/tools/__tests__/ToolNode.session.test.js +319 -0
  732. package/src/tools/__tests__/ToolNode.session.test.js.map +1 -0
  733. package/src/tools/__tests__/ToolNode.session.test.ts +465 -0
  734. package/src/tools/__tests__/ToolSearch.integration.test.js +125 -0
  735. package/src/tools/__tests__/ToolSearch.integration.test.js.map +1 -0
  736. package/src/tools/__tests__/ToolSearch.test.js +812 -0
  737. package/src/tools/__tests__/ToolSearch.test.js.map +1 -0
  738. package/src/tools/__tests__/ToolSearch.test.ts +78 -5
  739. package/src/tools/__tests__/handlers.test.js +799 -0
  740. package/src/tools/__tests__/handlers.test.js.map +1 -0
  741. package/src/tools/__tests__/handlers.test.ts +1100 -0
  742. package/src/tools/__tests__/truncation-recovery.integration.test.js +362 -0
  743. package/src/tools/__tests__/truncation-recovery.integration.test.js.map +1 -0
  744. package/src/tools/__tests__/truncation-recovery.integration.test.ts +560 -0
  745. package/src/tools/handlers.js +306 -0
  746. package/src/tools/handlers.js.map +1 -0
  747. package/src/tools/handlers.ts +119 -16
  748. package/src/tools/schema.js +25 -0
  749. package/src/tools/schema.js.map +1 -0
  750. package/src/tools/search/anthropic.js +34 -0
  751. package/src/tools/search/anthropic.js.map +1 -0
  752. package/src/tools/search/content.js +116 -0
  753. package/src/tools/search/content.js.map +1 -0
  754. package/src/tools/search/content.test.js +133 -0
  755. package/src/tools/search/content.test.js.map +1 -0
  756. package/src/tools/search/firecrawl.js +173 -0
  757. package/src/tools/search/firecrawl.js.map +1 -0
  758. package/src/tools/search/format.js +198 -0
  759. package/src/tools/search/format.js.map +1 -0
  760. package/src/tools/search/highlights.js +241 -0
  761. package/src/tools/search/highlights.js.map +1 -0
  762. package/src/tools/search/index.js +3 -0
  763. package/src/tools/search/index.js.map +1 -0
  764. package/src/tools/search/jina-reranker.test.js +106 -0
  765. package/src/tools/search/jina-reranker.test.js.map +1 -0
  766. package/src/tools/search/rerankers.js +165 -0
  767. package/src/tools/search/rerankers.js.map +1 -0
  768. package/src/tools/search/schema.js +102 -0
  769. package/src/tools/search/schema.js.map +1 -0
  770. package/src/tools/search/search.js +561 -0
  771. package/src/tools/search/search.js.map +1 -0
  772. package/src/tools/search/serper-scraper.js +126 -0
  773. package/src/tools/search/serper-scraper.js.map +1 -0
  774. package/src/tools/search/test.js +129 -0
  775. package/src/tools/search/test.js.map +1 -0
  776. package/src/tools/search/tool.js +453 -0
  777. package/src/tools/search/tool.js.map +1 -0
  778. package/src/tools/search/types.js +2 -0
  779. package/src/tools/search/types.js.map +1 -0
  780. package/src/tools/search/utils.js +59 -0
  781. package/src/tools/search/utils.js.map +1 -0
  782. package/src/types/graph.js +24 -0
  783. package/src/types/graph.js.map +1 -0
  784. package/src/types/graph.test.js +192 -0
  785. package/src/types/graph.test.js.map +1 -0
  786. package/src/types/graph.ts +26 -6
  787. package/src/types/index.js +7 -0
  788. package/src/types/index.js.map +1 -0
  789. package/src/types/llm.js +2 -0
  790. package/src/types/llm.js.map +1 -0
  791. package/src/types/llm.ts +8 -3
  792. package/src/types/messages.js +2 -0
  793. package/src/types/messages.js.map +1 -0
  794. package/src/types/run.js +2 -0
  795. package/src/types/run.js.map +1 -0
  796. package/src/types/run.ts +2 -0
  797. package/src/types/stream.js +2 -0
  798. package/src/types/stream.js.map +1 -0
  799. package/src/types/tools.js +2 -0
  800. package/src/types/tools.js.map +1 -0
  801. package/src/types/tools.ts +21 -2
  802. package/src/utils/contextAnalytics.js +79 -0
  803. package/src/utils/contextAnalytics.js.map +1 -0
  804. package/src/utils/contextAnalytics.test.js +166 -0
  805. package/src/utils/contextAnalytics.test.js.map +1 -0
  806. package/src/utils/contextAnalytics.test.ts +222 -0
  807. package/src/utils/contextAnalytics.ts +27 -9
  808. package/src/utils/events.js +26 -0
  809. package/src/utils/events.js.map +1 -0
  810. package/src/utils/graph.js +11 -0
  811. package/src/utils/graph.js.map +1 -0
  812. package/src/utils/handlers.js +65 -0
  813. package/src/utils/handlers.js.map +1 -0
  814. package/src/utils/index.js +10 -0
  815. package/src/utils/index.js.map +1 -0
  816. package/src/utils/index.ts +1 -0
  817. package/src/utils/llm.js +21 -0
  818. package/src/utils/llm.js.map +1 -0
  819. package/src/utils/llmConfig.js +205 -0
  820. package/src/utils/llmConfig.js.map +1 -0
  821. package/src/utils/llmConfig.ts +5 -5
  822. package/src/utils/logging.js +37 -0
  823. package/src/utils/logging.js.map +1 -0
  824. package/src/utils/misc.js +51 -0
  825. package/src/utils/misc.js.map +1 -0
  826. package/src/utils/run.js +69 -0
  827. package/src/utils/run.js.map +1 -0
  828. package/src/utils/run.ts +108 -106
  829. package/src/utils/schema.js +21 -0
  830. package/src/utils/schema.js.map +1 -0
  831. package/src/utils/title.js +119 -0
  832. package/src/utils/title.js.map +1 -0
  833. package/src/utils/tokens.js +92 -0
  834. package/src/utils/tokens.js.map +1 -0
  835. package/src/utils/tokens.ts +118 -142
  836. package/src/utils/toolCallContinuation.ts +55 -0
  837. package/src/utils/toonFormat.js +379 -0
  838. package/src/utils/toonFormat.js.map +1 -0
@@ -0,0 +1,1033 @@
1
+ import { AzureOpenAI as AzureOpenAIClient } from 'openai';
2
+ import { ChatXAI as OriginalChatXAI } from '@langchain/xai';
3
+ import { ChatGenerationChunk } from '@langchain/core/outputs';
4
+ import { AIMessage, AIMessageChunk } from '@langchain/core/messages';
5
+ import { isLangChainTool } from '@langchain/core/utils/function_calling';
6
+ import { ChatDeepSeek as OriginalChatDeepSeek } from '@langchain/deepseek';
7
+ import { getEndpoint, OpenAIClient, formatToOpenAITool, ChatOpenAI as OriginalChatOpenAI, AzureChatOpenAI as OriginalAzureChatOpenAI, } from '@langchain/openai';
8
+ import { isReasoningModel, _convertMessagesToOpenAIParams, _convertMessagesToOpenAIResponsesParams, _convertOpenAIResponsesDeltaToBaseMessageChunk, } from './utils';
9
+ import { sleep } from '@/utils';
10
+ // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
11
+ const iife = (fn) => fn();
12
+ export function isHeaders(headers) {
13
+ return (typeof Headers !== 'undefined' &&
14
+ headers !== null &&
15
+ typeof headers === 'object' &&
16
+ Object.prototype.toString.call(headers) === '[object Headers]');
17
+ }
18
+ export function normalizeHeaders(headers) {
19
+ const output = iife(() => {
20
+ // If headers is a Headers instance
21
+ if (isHeaders(headers)) {
22
+ return headers;
23
+ }
24
+ // If headers is an array of [key, value] pairs
25
+ else if (Array.isArray(headers)) {
26
+ return new Headers(headers);
27
+ }
28
+ // If headers is a NullableHeaders-like object (has 'values' property that is a Headers)
29
+ else if (typeof headers === 'object' &&
30
+ headers !== null &&
31
+ 'values' in headers &&
32
+ isHeaders(headers.values)) {
33
+ return headers.values;
34
+ }
35
+ // If headers is a plain object
36
+ else if (typeof headers === 'object' && headers !== null) {
37
+ const entries = Object.entries(headers)
38
+ .filter(([, v]) => typeof v === 'string')
39
+ .map(([k, v]) => [k, v]);
40
+ return new Headers(entries);
41
+ }
42
+ return new Headers();
43
+ });
44
+ return Object.fromEntries(output.entries());
45
+ }
46
+ function createAbortHandler(controller) {
47
+ return function () {
48
+ controller.abort();
49
+ };
50
+ }
51
+ /**
52
+ * Formats a tool in either OpenAI format, or LangChain structured tool format
53
+ * into an OpenAI tool format. If the tool is already in OpenAI format, return without
54
+ * any changes. If it is in LangChain structured tool format, convert it to OpenAI tool format
55
+ * using OpenAI's `zodFunction` util, falling back to `convertToOpenAIFunction` if the parameters
56
+ * returned from the `zodFunction` util are not defined.
57
+ *
58
+ * @param {BindToolsInput} tool The tool to convert to an OpenAI tool.
59
+ * @param {Object} [fields] Additional fields to add to the OpenAI tool.
60
+ * @returns {ToolDefinition} The inputted tool in OpenAI tool format.
61
+ */
62
+ export function _convertToOpenAITool(tool, fields) {
63
+ let toolDef;
64
+ if (isLangChainTool(tool)) {
65
+ toolDef = formatToOpenAITool(tool);
66
+ }
67
+ else {
68
+ toolDef = tool;
69
+ }
70
+ if (fields?.strict !== undefined) {
71
+ toolDef.function.strict = fields.strict;
72
+ }
73
+ return toolDef;
74
+ }
75
+ export class CustomOpenAIClient extends OpenAIClient {
76
+ abortHandler;
77
+ async fetchWithTimeout(url, init, ms, controller) {
78
+ const { signal, ...options } = init || {};
79
+ const handler = createAbortHandler(controller);
80
+ this.abortHandler = handler;
81
+ if (signal)
82
+ signal.addEventListener('abort', handler, { once: true });
83
+ const timeout = setTimeout(() => handler, ms);
84
+ const fetchOptions = {
85
+ signal: controller.signal,
86
+ ...options,
87
+ };
88
+ if (fetchOptions.method != null) {
89
+ // Custom methods like 'patch' need to be uppercased
90
+ // See https://github.com/nodejs/undici/issues/2294
91
+ fetchOptions.method = fetchOptions.method.toUpperCase();
92
+ }
93
+ return (
94
+ // use undefined this binding; fetch errors if bound to something else in browser/cloudflare
95
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
96
+ /** @ts-ignore */
97
+ this.fetch.call(undefined, url, fetchOptions).finally(() => {
98
+ clearTimeout(timeout);
99
+ }));
100
+ }
101
+ }
102
+ export class CustomAzureOpenAIClient extends AzureOpenAIClient {
103
+ abortHandler;
104
+ async fetchWithTimeout(url, init, ms, controller) {
105
+ const { signal, ...options } = init || {};
106
+ const handler = createAbortHandler(controller);
107
+ this.abortHandler = handler;
108
+ if (signal)
109
+ signal.addEventListener('abort', handler, { once: true });
110
+ const timeout = setTimeout(() => handler, ms);
111
+ const fetchOptions = {
112
+ signal: controller.signal,
113
+ ...options,
114
+ };
115
+ if (fetchOptions.method != null) {
116
+ // Custom methods like 'patch' need to be uppercased
117
+ // See https://github.com/nodejs/undici/issues/2294
118
+ fetchOptions.method = fetchOptions.method.toUpperCase();
119
+ }
120
+ return (
121
+ // use undefined this binding; fetch errors if bound to something else in browser/cloudflare
122
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
123
+ /** @ts-ignore */
124
+ this.fetch.call(undefined, url, fetchOptions).finally(() => {
125
+ clearTimeout(timeout);
126
+ }));
127
+ }
128
+ }
129
+ /** @ts-expect-error We are intentionally overriding `getReasoningParams` */
130
+ export class ChatOpenAI extends OriginalChatOpenAI {
131
+ _lc_stream_delay;
132
+ constructor(fields) {
133
+ super(fields);
134
+ this._lc_stream_delay = fields?._lc_stream_delay;
135
+ }
136
+ get exposedClient() {
137
+ return this.client;
138
+ }
139
+ static lc_name() {
140
+ return 'IllumaOpenAI';
141
+ }
142
+ _getClientOptions(options) {
143
+ if (!this.client) {
144
+ const openAIEndpointConfig = {
145
+ baseURL: this.clientConfig.baseURL,
146
+ };
147
+ const endpoint = getEndpoint(openAIEndpointConfig);
148
+ const params = {
149
+ ...this.clientConfig,
150
+ baseURL: endpoint,
151
+ timeout: this.timeout,
152
+ maxRetries: 0,
153
+ };
154
+ if (params.baseURL == null) {
155
+ delete params.baseURL;
156
+ }
157
+ this.client = new CustomOpenAIClient(params);
158
+ }
159
+ const requestOptions = {
160
+ ...this.clientConfig,
161
+ ...options,
162
+ };
163
+ return requestOptions;
164
+ }
165
+ /**
166
+ * Returns backwards compatible reasoning parameters from constructor params and call options
167
+ * @internal
168
+ */
169
+ getReasoningParams(options) {
170
+ // apply options in reverse order of importance -- newer options supersede older options
171
+ let reasoning;
172
+ if (this.reasoning !== undefined) {
173
+ reasoning = {
174
+ ...reasoning,
175
+ ...this.reasoning,
176
+ };
177
+ }
178
+ if (options?.reasoning !== undefined) {
179
+ reasoning = {
180
+ ...reasoning,
181
+ ...options.reasoning,
182
+ };
183
+ }
184
+ return reasoning;
185
+ }
186
+ _getReasoningParams(options) {
187
+ return this.getReasoningParams(options);
188
+ }
189
+ async *_streamResponseChunks(messages, options, runManager) {
190
+ if (!this._useResponseApi(options)) {
191
+ return yield* this._streamResponseChunks2(messages, options, runManager);
192
+ }
193
+ const streamIterable = await this.responseApiWithRetry({
194
+ ...this.invocationParams(options, { streaming: true }),
195
+ input: _convertMessagesToOpenAIResponsesParams(messages, this.model, this.zdrEnabled),
196
+ stream: true,
197
+ }, options);
198
+ for await (const data of streamIterable) {
199
+ const chunk = _convertOpenAIResponsesDeltaToBaseMessageChunk(data);
200
+ if (chunk == null)
201
+ continue;
202
+ yield chunk;
203
+ if (this._lc_stream_delay != null) {
204
+ await sleep(this._lc_stream_delay);
205
+ }
206
+ await runManager?.handleLLMNewToken(chunk.text || '', undefined, undefined, undefined, undefined, { chunk });
207
+ }
208
+ return;
209
+ }
210
+ async *_streamResponseChunks2(messages, options, runManager) {
211
+ const messagesMapped = _convertMessagesToOpenAIParams(messages, this.model);
212
+ const params = {
213
+ ...this.invocationParams(options, {
214
+ streaming: true,
215
+ }),
216
+ messages: messagesMapped,
217
+ stream: true,
218
+ };
219
+ let defaultRole;
220
+ const streamIterable = await this.completionWithRetry(params, options);
221
+ let usage;
222
+ for await (const data of streamIterable) {
223
+ const choice = data.choices[0];
224
+ if (data.usage) {
225
+ usage = data.usage;
226
+ }
227
+ if (!choice) {
228
+ continue;
229
+ }
230
+ const { delta } = choice;
231
+ if (!delta) {
232
+ continue;
233
+ }
234
+ const chunk = this._convertOpenAIDeltaToBaseMessageChunk(delta, data, defaultRole);
235
+ if ('reasoning_content' in delta) {
236
+ chunk.additional_kwargs.reasoning_content = delta.reasoning_content;
237
+ }
238
+ else if ('reasoning' in delta) {
239
+ chunk.additional_kwargs.reasoning_content = delta.reasoning;
240
+ }
241
+ if ('provider_specific_fields' in delta) {
242
+ chunk.additional_kwargs.provider_specific_fields =
243
+ delta.provider_specific_fields;
244
+ }
245
+ defaultRole = delta.role ?? defaultRole;
246
+ const newTokenIndices = {
247
+ prompt: options.promptIndex ?? 0,
248
+ completion: choice.index ?? 0,
249
+ };
250
+ if (typeof chunk.content !== 'string') {
251
+ // eslint-disable-next-line no-console
252
+ console.log('[WARNING]: Received non-string content from OpenAI. This is currently not supported.');
253
+ continue;
254
+ }
255
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
256
+ const generationInfo = { ...newTokenIndices };
257
+ if (choice.finish_reason != null) {
258
+ generationInfo.finish_reason = choice.finish_reason;
259
+ // Only include system fingerprint in the last chunk for now
260
+ // to avoid concatenation issues
261
+ generationInfo.system_fingerprint = data.system_fingerprint;
262
+ generationInfo.model_name = data.model;
263
+ generationInfo.service_tier = data.service_tier;
264
+ }
265
+ if (this.logprobs == true) {
266
+ generationInfo.logprobs = choice.logprobs;
267
+ }
268
+ const generationChunk = new ChatGenerationChunk({
269
+ message: chunk,
270
+ text: chunk.content,
271
+ generationInfo,
272
+ });
273
+ yield generationChunk;
274
+ if (this._lc_stream_delay != null) {
275
+ await sleep(this._lc_stream_delay);
276
+ }
277
+ await runManager?.handleLLMNewToken(generationChunk.text || '', newTokenIndices, undefined, undefined, undefined, { chunk: generationChunk });
278
+ }
279
+ if (usage) {
280
+ const inputTokenDetails = {
281
+ ...(usage.prompt_tokens_details?.audio_tokens != null && {
282
+ audio: usage.prompt_tokens_details.audio_tokens,
283
+ }),
284
+ ...(usage.prompt_tokens_details?.cached_tokens != null && {
285
+ cache_read: usage.prompt_tokens_details.cached_tokens,
286
+ }),
287
+ };
288
+ const outputTokenDetails = {
289
+ ...(usage.completion_tokens_details?.audio_tokens != null && {
290
+ audio: usage.completion_tokens_details.audio_tokens,
291
+ }),
292
+ ...(usage.completion_tokens_details?.reasoning_tokens != null && {
293
+ reasoning: usage.completion_tokens_details.reasoning_tokens,
294
+ }),
295
+ };
296
+ const generationChunk = new ChatGenerationChunk({
297
+ message: new AIMessageChunk({
298
+ content: '',
299
+ response_metadata: {
300
+ usage: { ...usage },
301
+ },
302
+ usage_metadata: {
303
+ input_tokens: usage.prompt_tokens,
304
+ output_tokens: usage.completion_tokens,
305
+ total_tokens: usage.total_tokens,
306
+ ...(Object.keys(inputTokenDetails).length > 0 && {
307
+ input_token_details: inputTokenDetails,
308
+ }),
309
+ ...(Object.keys(outputTokenDetails).length > 0 && {
310
+ output_token_details: outputTokenDetails,
311
+ }),
312
+ },
313
+ }),
314
+ text: '',
315
+ });
316
+ yield generationChunk;
317
+ if (this._lc_stream_delay != null) {
318
+ await sleep(this._lc_stream_delay);
319
+ }
320
+ }
321
+ if (options.signal?.aborted === true) {
322
+ throw new Error('AbortError');
323
+ }
324
+ }
325
+ }
326
+ /** @ts-expect-error We are intentionally overriding `getReasoningParams` */
327
+ export class AzureChatOpenAI extends OriginalAzureChatOpenAI {
328
+ _lc_stream_delay;
329
+ constructor(fields) {
330
+ super(fields);
331
+ this._lc_stream_delay = fields?._lc_stream_delay;
332
+ }
333
+ get exposedClient() {
334
+ return this.client;
335
+ }
336
+ static lc_name() {
337
+ return 'IllumaAzureOpenAI';
338
+ }
339
+ /**
340
+ * Returns backwards compatible reasoning parameters from constructor params and call options
341
+ * @internal
342
+ */
343
+ getReasoningParams(options) {
344
+ if (!isReasoningModel(this.model)) {
345
+ return;
346
+ }
347
+ // apply options in reverse order of importance -- newer options supersede older options
348
+ let reasoning;
349
+ if (this.reasoning !== undefined) {
350
+ reasoning = {
351
+ ...reasoning,
352
+ ...this.reasoning,
353
+ };
354
+ }
355
+ if (options?.reasoning !== undefined) {
356
+ reasoning = {
357
+ ...reasoning,
358
+ ...options.reasoning,
359
+ };
360
+ }
361
+ return reasoning;
362
+ }
363
+ _getReasoningParams(options) {
364
+ return this.getReasoningParams(options);
365
+ }
366
+ _getClientOptions(options) {
367
+ if (!this.client) {
368
+ const openAIEndpointConfig = {
369
+ azureOpenAIApiDeploymentName: this.azureOpenAIApiDeploymentName,
370
+ azureOpenAIApiInstanceName: this.azureOpenAIApiInstanceName,
371
+ azureOpenAIApiKey: this.azureOpenAIApiKey,
372
+ azureOpenAIBasePath: this.azureOpenAIBasePath,
373
+ azureADTokenProvider: this.azureADTokenProvider,
374
+ baseURL: this.clientConfig.baseURL,
375
+ };
376
+ const endpoint = getEndpoint(openAIEndpointConfig);
377
+ const params = {
378
+ ...this.clientConfig,
379
+ baseURL: endpoint,
380
+ timeout: this.timeout,
381
+ maxRetries: 0,
382
+ };
383
+ if (!this.azureADTokenProvider) {
384
+ params.apiKey = openAIEndpointConfig.azureOpenAIApiKey;
385
+ }
386
+ if (params.baseURL == null) {
387
+ delete params.baseURL;
388
+ }
389
+ const defaultHeaders = normalizeHeaders(params.defaultHeaders);
390
+ params.defaultHeaders = {
391
+ ...params.defaultHeaders,
392
+ 'User-Agent': defaultHeaders['User-Agent'] != null
393
+ ? `${defaultHeaders['User-Agent']}: illuma-azure-openai-v2`
394
+ : 'illuma-azure-openai-v2',
395
+ };
396
+ this.client = new CustomAzureOpenAIClient({
397
+ apiVersion: this.azureOpenAIApiVersion,
398
+ azureADTokenProvider: this.azureADTokenProvider,
399
+ ...params,
400
+ });
401
+ }
402
+ const requestOptions = {
403
+ ...this.clientConfig,
404
+ ...options,
405
+ };
406
+ if (this.azureOpenAIApiKey != null) {
407
+ requestOptions.headers = {
408
+ 'api-key': this.azureOpenAIApiKey,
409
+ ...requestOptions.headers,
410
+ };
411
+ requestOptions.query = {
412
+ 'api-version': this.azureOpenAIApiVersion,
413
+ ...requestOptions.query,
414
+ };
415
+ }
416
+ return requestOptions;
417
+ }
418
+ async *_streamResponseChunks(messages, options, runManager) {
419
+ if (!this._useResponseApi(options)) {
420
+ return yield* super._streamResponseChunks(messages, options, runManager);
421
+ }
422
+ const streamIterable = await this.responseApiWithRetry({
423
+ ...this.invocationParams(options, { streaming: true }),
424
+ input: _convertMessagesToOpenAIResponsesParams(messages, this.model, this.zdrEnabled),
425
+ stream: true,
426
+ }, options);
427
+ for await (const data of streamIterable) {
428
+ const chunk = _convertOpenAIResponsesDeltaToBaseMessageChunk(data);
429
+ if (chunk == null)
430
+ continue;
431
+ yield chunk;
432
+ if (this._lc_stream_delay != null) {
433
+ await sleep(this._lc_stream_delay);
434
+ }
435
+ await runManager?.handleLLMNewToken(chunk.text || '', undefined, undefined, undefined, undefined, { chunk });
436
+ }
437
+ return;
438
+ }
439
+ }
440
+ export class ChatDeepSeek extends OriginalChatDeepSeek {
441
+ get exposedClient() {
442
+ return this.client;
443
+ }
444
+ static lc_name() {
445
+ return 'IllumaDeepSeek';
446
+ }
447
+ _convertMessages(messages) {
448
+ return _convertMessagesToOpenAIParams(messages, this.model, {
449
+ includeReasoningContent: true,
450
+ });
451
+ }
452
+ async _generate(messages, options, runManager) {
453
+ const params = this.invocationParams(options);
454
+ if (params.stream === true) {
455
+ return super._generate(messages, options ?? {}, runManager);
456
+ }
457
+ const messagesMapped = this._convertMessages(messages);
458
+ const data = await this.completionWithRetry({
459
+ ...params,
460
+ stream: false,
461
+ messages: messagesMapped,
462
+ }, {
463
+ signal: options?.signal,
464
+ ...options?.options,
465
+ });
466
+ const { completion_tokens, prompt_tokens, total_tokens } = data.usage ?? {};
467
+ const generations = [];
468
+ for (const part of data.choices ?? []) {
469
+ const text = part.message.content ?? '';
470
+ const generation = {
471
+ text: typeof text === 'string' ? text : '',
472
+ message: this._convertResponseToMessage(part, data),
473
+ };
474
+ generation.generationInfo = {
475
+ ...(part.finish_reason != null
476
+ ? { finish_reason: part.finish_reason }
477
+ : {}),
478
+ ...(part.logprobs ? { logprobs: part.logprobs } : {}),
479
+ };
480
+ generations.push(generation);
481
+ }
482
+ return {
483
+ generations,
484
+ llmOutput: {
485
+ tokenUsage: {
486
+ completionTokens: completion_tokens,
487
+ promptTokens: prompt_tokens,
488
+ totalTokens: total_tokens,
489
+ },
490
+ },
491
+ };
492
+ }
493
+ _convertResponseToMessage(choice, data) {
494
+ const { message } = choice;
495
+ const rawToolCalls = message.tool_calls;
496
+ const toolCalls = rawToolCalls?.map((tc) => ({
497
+ id: tc.id,
498
+ name: tc.function.name,
499
+ args: JSON.parse(tc.function.arguments || '{}'),
500
+ type: 'tool_call',
501
+ }));
502
+ const additional_kwargs = {};
503
+ if (rawToolCalls) {
504
+ additional_kwargs.tool_calls = rawToolCalls;
505
+ }
506
+ if ('reasoning_content' in message &&
507
+ message.reasoning_content != null &&
508
+ message.reasoning_content !== '') {
509
+ additional_kwargs.reasoning_content = message.reasoning_content;
510
+ }
511
+ return new AIMessage({
512
+ content: message.content ?? '',
513
+ tool_calls: toolCalls,
514
+ additional_kwargs,
515
+ usage_metadata: data.usage
516
+ ? {
517
+ input_tokens: data.usage.prompt_tokens,
518
+ output_tokens: data.usage.completion_tokens,
519
+ total_tokens: data.usage.total_tokens,
520
+ }
521
+ : undefined,
522
+ response_metadata: {
523
+ model_name: data.model,
524
+ system_fingerprint: data.system_fingerprint,
525
+ finish_reason: choice.finish_reason,
526
+ },
527
+ });
528
+ }
529
+ _getClientOptions(options) {
530
+ if (!this.client) {
531
+ const openAIEndpointConfig = {
532
+ baseURL: this.clientConfig.baseURL,
533
+ };
534
+ const endpoint = getEndpoint(openAIEndpointConfig);
535
+ const params = {
536
+ ...this.clientConfig,
537
+ baseURL: endpoint,
538
+ timeout: this.timeout,
539
+ maxRetries: 0,
540
+ };
541
+ if (params.baseURL == null) {
542
+ delete params.baseURL;
543
+ }
544
+ this.client = new CustomOpenAIClient(params);
545
+ }
546
+ const requestOptions = {
547
+ ...this.clientConfig,
548
+ ...options,
549
+ };
550
+ return requestOptions;
551
+ }
552
+ async *_streamResponseChunks(messages, options, runManager) {
553
+ const messagesMapped = _convertMessagesToOpenAIParams(messages, this.model, {
554
+ includeReasoningContent: true,
555
+ });
556
+ const params = {
557
+ ...this.invocationParams(options, {
558
+ streaming: true,
559
+ }),
560
+ messages: messagesMapped,
561
+ stream: true,
562
+ };
563
+ let defaultRole;
564
+ const streamIterable = await this.completionWithRetry(params, options);
565
+ let usage;
566
+ for await (const data of streamIterable) {
567
+ const choice = data.choices[0];
568
+ if (data.usage) {
569
+ usage = data.usage;
570
+ }
571
+ if (!choice) {
572
+ continue;
573
+ }
574
+ const { delta } = choice;
575
+ if (!delta) {
576
+ continue;
577
+ }
578
+ const chunk = this._convertOpenAIDeltaToBaseMessageChunk(delta, data, defaultRole);
579
+ if ('reasoning_content' in delta) {
580
+ chunk.additional_kwargs.reasoning_content = delta.reasoning_content;
581
+ }
582
+ defaultRole = delta.role ?? defaultRole;
583
+ const newTokenIndices = {
584
+ prompt: options.promptIndex ?? 0,
585
+ completion: choice.index ?? 0,
586
+ };
587
+ if (typeof chunk.content !== 'string') {
588
+ // eslint-disable-next-line no-console
589
+ console.log('[WARNING]: Received non-string content from OpenAI. This is currently not supported.');
590
+ continue;
591
+ }
592
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
593
+ const generationInfo = { ...newTokenIndices };
594
+ if (choice.finish_reason != null) {
595
+ generationInfo.finish_reason = choice.finish_reason;
596
+ generationInfo.system_fingerprint = data.system_fingerprint;
597
+ generationInfo.model_name = data.model;
598
+ generationInfo.service_tier = data.service_tier;
599
+ }
600
+ if (this.logprobs == true) {
601
+ generationInfo.logprobs = choice.logprobs;
602
+ }
603
+ const generationChunk = new ChatGenerationChunk({
604
+ message: chunk,
605
+ text: chunk.content,
606
+ generationInfo,
607
+ });
608
+ yield generationChunk;
609
+ await runManager?.handleLLMNewToken(generationChunk.text || '', newTokenIndices, undefined, undefined, undefined, { chunk: generationChunk });
610
+ }
611
+ if (usage) {
612
+ const inputTokenDetails = {
613
+ ...(usage.prompt_tokens_details?.audio_tokens != null && {
614
+ audio: usage.prompt_tokens_details.audio_tokens,
615
+ }),
616
+ ...(usage.prompt_tokens_details?.cached_tokens != null && {
617
+ cache_read: usage.prompt_tokens_details.cached_tokens,
618
+ }),
619
+ };
620
+ const outputTokenDetails = {
621
+ ...(usage.completion_tokens_details?.audio_tokens != null && {
622
+ audio: usage.completion_tokens_details.audio_tokens,
623
+ }),
624
+ ...(usage.completion_tokens_details?.reasoning_tokens != null && {
625
+ reasoning: usage.completion_tokens_details.reasoning_tokens,
626
+ }),
627
+ };
628
+ const generationChunk = new ChatGenerationChunk({
629
+ message: new AIMessageChunk({
630
+ content: '',
631
+ response_metadata: {
632
+ usage: { ...usage },
633
+ },
634
+ usage_metadata: {
635
+ input_tokens: usage.prompt_tokens,
636
+ output_tokens: usage.completion_tokens,
637
+ total_tokens: usage.total_tokens,
638
+ ...(Object.keys(inputTokenDetails).length > 0 && {
639
+ input_token_details: inputTokenDetails,
640
+ }),
641
+ ...(Object.keys(outputTokenDetails).length > 0 && {
642
+ output_token_details: outputTokenDetails,
643
+ }),
644
+ },
645
+ }),
646
+ text: '',
647
+ });
648
+ yield generationChunk;
649
+ }
650
+ if (options.signal?.aborted === true) {
651
+ throw new Error('AbortError');
652
+ }
653
+ }
654
+ }
655
+ export class ChatMoonshot extends ChatOpenAI {
656
+ static lc_name() {
657
+ return 'LibreChatMoonshot';
658
+ }
659
+ _convertMessages(messages) {
660
+ return _convertMessagesToOpenAIParams(messages, this.model, {
661
+ includeReasoningContent: true,
662
+ });
663
+ }
664
+ async _generate(messages, options, runManager) {
665
+ const params = this.invocationParams(options);
666
+ if (params.stream === true) {
667
+ return super._generate(messages, options, runManager);
668
+ }
669
+ const messagesMapped = this._convertMessages(messages);
670
+ const data = await this.completionWithRetry({
671
+ ...params,
672
+ stream: false,
673
+ messages: messagesMapped,
674
+ }, {
675
+ signal: options.signal,
676
+ ...options.options,
677
+ });
678
+ const { completion_tokens, prompt_tokens, total_tokens } = data.usage ?? {};
679
+ const generations = [];
680
+ for (const part of data.choices ?? []) {
681
+ const text = part.message.content ?? '';
682
+ const generation = {
683
+ text: typeof text === 'string' ? text : '',
684
+ message: this._convertResponseToMessage(part, data),
685
+ };
686
+ generation.generationInfo = {
687
+ ...(part.finish_reason ? { finish_reason: part.finish_reason } : {}),
688
+ ...(part.logprobs ? { logprobs: part.logprobs } : {}),
689
+ };
690
+ generations.push(generation);
691
+ }
692
+ return {
693
+ generations,
694
+ llmOutput: {
695
+ tokenUsage: {
696
+ completionTokens: completion_tokens,
697
+ promptTokens: prompt_tokens,
698
+ totalTokens: total_tokens,
699
+ },
700
+ },
701
+ };
702
+ }
703
+ _convertResponseToMessage(choice, data) {
704
+ const { message } = choice;
705
+ const rawToolCalls = message.tool_calls;
706
+ const toolCalls = rawToolCalls?.map((tc) => ({
707
+ id: tc.id,
708
+ name: tc.function.name,
709
+ args: JSON.parse(tc.function.arguments || '{}'),
710
+ type: 'tool_call',
711
+ }));
712
+ const additional_kwargs = {};
713
+ if (rawToolCalls) {
714
+ additional_kwargs.tool_calls = rawToolCalls;
715
+ }
716
+ if ('reasoning_content' in message &&
717
+ message.reasoning_content != null &&
718
+ message.reasoning_content !== '') {
719
+ additional_kwargs.reasoning_content = message.reasoning_content;
720
+ }
721
+ return new AIMessage({
722
+ content: message.content ?? '',
723
+ tool_calls: toolCalls,
724
+ additional_kwargs,
725
+ usage_metadata: data.usage
726
+ ? {
727
+ input_tokens: data.usage.prompt_tokens,
728
+ output_tokens: data.usage.completion_tokens,
729
+ total_tokens: data.usage.total_tokens,
730
+ }
731
+ : undefined,
732
+ response_metadata: {
733
+ model_name: data.model,
734
+ system_fingerprint: data.system_fingerprint,
735
+ finish_reason: choice.finish_reason,
736
+ },
737
+ });
738
+ }
739
+ async *_streamResponseChunks(messages, options, runManager) {
740
+ const messagesMapped = _convertMessagesToOpenAIParams(messages, this.model, {
741
+ includeReasoningContent: true,
742
+ });
743
+ const params = {
744
+ ...this.invocationParams(options, {
745
+ streaming: true,
746
+ }),
747
+ messages: messagesMapped,
748
+ stream: true,
749
+ };
750
+ let defaultRole;
751
+ const streamIterable = await this.completionWithRetry(params, options);
752
+ let usage;
753
+ for await (const data of streamIterable) {
754
+ const choice = data.choices[0];
755
+ if (data.usage) {
756
+ usage = data.usage;
757
+ }
758
+ if (!choice) {
759
+ continue;
760
+ }
761
+ const { delta } = choice;
762
+ if (!delta) {
763
+ continue;
764
+ }
765
+ const chunk = this._convertOpenAIDeltaToBaseMessageChunk(delta, data, defaultRole);
766
+ if ('reasoning_content' in delta) {
767
+ chunk.additional_kwargs.reasoning_content = delta.reasoning_content;
768
+ }
769
+ defaultRole = delta.role ?? defaultRole;
770
+ const newTokenIndices = {
771
+ prompt: options.promptIndex ?? 0,
772
+ completion: choice.index ?? 0,
773
+ };
774
+ if (typeof chunk.content !== 'string') {
775
+ // eslint-disable-next-line no-console
776
+ console.log('[WARNING]: Received non-string content from OpenAI. This is currently not supported.');
777
+ continue;
778
+ }
779
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
780
+ const generationInfo = { ...newTokenIndices };
781
+ if (choice.finish_reason != null) {
782
+ generationInfo.finish_reason = choice.finish_reason;
783
+ generationInfo.system_fingerprint = data.system_fingerprint;
784
+ generationInfo.model_name = data.model;
785
+ generationInfo.service_tier = data.service_tier;
786
+ }
787
+ if (this.logprobs == true) {
788
+ generationInfo.logprobs = choice.logprobs;
789
+ }
790
+ const generationChunk = new ChatGenerationChunk({
791
+ message: chunk,
792
+ text: chunk.content,
793
+ generationInfo,
794
+ });
795
+ yield generationChunk;
796
+ if (this._lc_stream_delay != null) {
797
+ await sleep(this._lc_stream_delay);
798
+ }
799
+ await runManager?.handleLLMNewToken(generationChunk.text || '', newTokenIndices, undefined, undefined, undefined, { chunk: generationChunk });
800
+ }
801
+ if (usage) {
802
+ const inputTokenDetails = {
803
+ ...(usage.prompt_tokens_details?.audio_tokens != null && {
804
+ audio: usage.prompt_tokens_details.audio_tokens,
805
+ }),
806
+ ...(usage.prompt_tokens_details?.cached_tokens != null && {
807
+ cache_read: usage.prompt_tokens_details.cached_tokens,
808
+ }),
809
+ };
810
+ const outputTokenDetails = {
811
+ ...(usage.completion_tokens_details?.audio_tokens != null && {
812
+ audio: usage.completion_tokens_details.audio_tokens,
813
+ }),
814
+ ...(usage.completion_tokens_details?.reasoning_tokens != null && {
815
+ reasoning: usage.completion_tokens_details.reasoning_tokens,
816
+ }),
817
+ };
818
+ const generationChunk = new ChatGenerationChunk({
819
+ message: new AIMessageChunk({
820
+ content: '',
821
+ response_metadata: {
822
+ usage: { ...usage },
823
+ },
824
+ usage_metadata: {
825
+ input_tokens: usage.prompt_tokens,
826
+ output_tokens: usage.completion_tokens,
827
+ total_tokens: usage.total_tokens,
828
+ ...(Object.keys(inputTokenDetails).length > 0 && {
829
+ input_token_details: inputTokenDetails,
830
+ }),
831
+ ...(Object.keys(outputTokenDetails).length > 0 && {
832
+ output_token_details: outputTokenDetails,
833
+ }),
834
+ },
835
+ }),
836
+ text: '',
837
+ });
838
+ yield generationChunk;
839
+ if (this._lc_stream_delay != null) {
840
+ await sleep(this._lc_stream_delay);
841
+ }
842
+ }
843
+ if (options.signal?.aborted === true) {
844
+ throw new Error('AbortError');
845
+ }
846
+ }
847
+ }
848
+ export class ChatXAI extends OriginalChatXAI {
849
+ _lc_stream_delay;
850
+ constructor(fields) {
851
+ super(fields);
852
+ this._lc_stream_delay = fields?._lc_stream_delay;
853
+ const customBaseURL = fields?.configuration?.baseURL ?? fields?.clientConfig?.baseURL;
854
+ if (customBaseURL != null && customBaseURL) {
855
+ this.clientConfig = {
856
+ ...this.clientConfig,
857
+ baseURL: customBaseURL,
858
+ };
859
+ // Reset the client to force recreation with new config
860
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
861
+ this.client = undefined;
862
+ }
863
+ }
864
+ static lc_name() {
865
+ return 'IllumaXAI';
866
+ }
867
+ get exposedClient() {
868
+ return this.client;
869
+ }
870
+ _getClientOptions(options) {
871
+ if (!this.client) {
872
+ const openAIEndpointConfig = {
873
+ baseURL: this.clientConfig.baseURL,
874
+ };
875
+ const endpoint = getEndpoint(openAIEndpointConfig);
876
+ const params = {
877
+ ...this.clientConfig,
878
+ baseURL: endpoint,
879
+ timeout: this.timeout,
880
+ maxRetries: 0,
881
+ };
882
+ if (params.baseURL == null) {
883
+ delete params.baseURL;
884
+ }
885
+ this.client = new CustomOpenAIClient(params);
886
+ }
887
+ const requestOptions = {
888
+ ...this.clientConfig,
889
+ ...options,
890
+ };
891
+ return requestOptions;
892
+ }
893
+ async *_streamResponseChunks(messages, options, runManager) {
894
+ const messagesMapped = _convertMessagesToOpenAIParams(messages, this.model);
895
+ const params = {
896
+ ...this.invocationParams(options, {
897
+ streaming: true,
898
+ }),
899
+ messages: messagesMapped,
900
+ stream: true,
901
+ };
902
+ let defaultRole;
903
+ const streamIterable = await this.completionWithRetry(params, options);
904
+ let usage;
905
+ for await (const data of streamIterable) {
906
+ const choice = data.choices[0];
907
+ if (data.usage) {
908
+ usage = data.usage;
909
+ }
910
+ if (!choice) {
911
+ continue;
912
+ }
913
+ const { delta } = choice;
914
+ if (!delta) {
915
+ continue;
916
+ }
917
+ const chunk = this._convertOpenAIDeltaToBaseMessageChunk(delta, data, defaultRole);
918
+ if (chunk.usage_metadata != null) {
919
+ chunk.usage_metadata = {
920
+ input_tokens: chunk.usage_metadata.input_tokens ?? 0,
921
+ output_tokens: chunk.usage_metadata.output_tokens ?? 0,
922
+ total_tokens: chunk.usage_metadata.total_tokens ?? 0,
923
+ };
924
+ }
925
+ if ('reasoning_content' in delta) {
926
+ chunk.additional_kwargs.reasoning_content = delta.reasoning_content;
927
+ }
928
+ defaultRole = delta.role ?? defaultRole;
929
+ const newTokenIndices = {
930
+ prompt: options.promptIndex ?? 0,
931
+ completion: choice.index ?? 0,
932
+ };
933
+ if (typeof chunk.content !== 'string') {
934
+ // eslint-disable-next-line no-console
935
+ console.log('[WARNING]: Received non-string content from OpenAI. This is currently not supported.');
936
+ continue;
937
+ }
938
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
939
+ const generationInfo = { ...newTokenIndices };
940
+ if (choice.finish_reason != null) {
941
+ generationInfo.finish_reason = choice.finish_reason;
942
+ // Only include system fingerprint in the last chunk for now
943
+ // to avoid concatenation issues
944
+ generationInfo.system_fingerprint = data.system_fingerprint;
945
+ generationInfo.model_name = data.model;
946
+ generationInfo.service_tier = data.service_tier;
947
+ }
948
+ if (this.logprobs == true) {
949
+ generationInfo.logprobs = choice.logprobs;
950
+ }
951
+ const generationChunk = new ChatGenerationChunk({
952
+ message: chunk,
953
+ text: chunk.content,
954
+ generationInfo,
955
+ });
956
+ yield generationChunk;
957
+ if (this._lc_stream_delay != null) {
958
+ await sleep(this._lc_stream_delay);
959
+ }
960
+ await runManager?.handleLLMNewToken(generationChunk.text || '', newTokenIndices, undefined, undefined, undefined, { chunk: generationChunk });
961
+ }
962
+ if (usage) {
963
+ // Type assertion for xAI-specific usage structure
964
+ const xaiUsage = usage;
965
+ const inputTokenDetails = {
966
+ // Standard OpenAI fields
967
+ ...(usage.prompt_tokens_details?.audio_tokens != null && {
968
+ audio: usage.prompt_tokens_details.audio_tokens,
969
+ }),
970
+ ...(usage.prompt_tokens_details?.cached_tokens != null && {
971
+ cache_read: usage.prompt_tokens_details.cached_tokens,
972
+ }),
973
+ // Add xAI-specific prompt token details if they exist
974
+ ...(xaiUsage.prompt_tokens_details?.text_tokens != null && {
975
+ text: xaiUsage.prompt_tokens_details.text_tokens,
976
+ }),
977
+ ...(xaiUsage.prompt_tokens_details?.image_tokens != null && {
978
+ image: xaiUsage.prompt_tokens_details.image_tokens,
979
+ }),
980
+ };
981
+ const outputTokenDetails = {
982
+ // Standard OpenAI fields
983
+ ...(usage.completion_tokens_details?.audio_tokens != null && {
984
+ audio: usage.completion_tokens_details.audio_tokens,
985
+ }),
986
+ ...(usage.completion_tokens_details?.reasoning_tokens != null && {
987
+ reasoning: usage.completion_tokens_details.reasoning_tokens,
988
+ }),
989
+ // Add xAI-specific completion token details if they exist
990
+ ...(xaiUsage.completion_tokens_details?.accepted_prediction_tokens !=
991
+ null && {
992
+ accepted_prediction: xaiUsage.completion_tokens_details.accepted_prediction_tokens,
993
+ }),
994
+ ...(xaiUsage.completion_tokens_details?.rejected_prediction_tokens !=
995
+ null && {
996
+ rejected_prediction: xaiUsage.completion_tokens_details.rejected_prediction_tokens,
997
+ }),
998
+ };
999
+ const generationChunk = new ChatGenerationChunk({
1000
+ message: new AIMessageChunk({
1001
+ content: '',
1002
+ response_metadata: {
1003
+ usage: { ...usage },
1004
+ // Include xAI-specific metadata if it exists
1005
+ ...(xaiUsage.num_sources_used != null && {
1006
+ num_sources_used: xaiUsage.num_sources_used,
1007
+ }),
1008
+ },
1009
+ usage_metadata: {
1010
+ input_tokens: usage.prompt_tokens,
1011
+ output_tokens: usage.completion_tokens,
1012
+ total_tokens: usage.total_tokens,
1013
+ ...(Object.keys(inputTokenDetails).length > 0 && {
1014
+ input_token_details: inputTokenDetails,
1015
+ }),
1016
+ ...(Object.keys(outputTokenDetails).length > 0 && {
1017
+ output_token_details: outputTokenDetails,
1018
+ }),
1019
+ },
1020
+ }),
1021
+ text: '',
1022
+ });
1023
+ yield generationChunk;
1024
+ if (this._lc_stream_delay != null) {
1025
+ await sleep(this._lc_stream_delay);
1026
+ }
1027
+ }
1028
+ if (options.signal?.aborted === true) {
1029
+ throw new Error('AbortError');
1030
+ }
1031
+ }
1032
+ }
1033
+ //# sourceMappingURL=index.js.map