@illuma-ai/agents 1.0.81

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 (558) hide show
  1. package/README.md +485 -0
  2. package/dist/cjs/agents/AgentContext.cjs +734 -0
  3. package/dist/cjs/agents/AgentContext.cjs.map +1 -0
  4. package/dist/cjs/common/enum.cjs +190 -0
  5. package/dist/cjs/common/enum.cjs.map +1 -0
  6. package/dist/cjs/events.cjs +172 -0
  7. package/dist/cjs/events.cjs.map +1 -0
  8. package/dist/cjs/graphs/Graph.cjs +1615 -0
  9. package/dist/cjs/graphs/Graph.cjs.map +1 -0
  10. package/dist/cjs/graphs/MultiAgentGraph.cjs +890 -0
  11. package/dist/cjs/graphs/MultiAgentGraph.cjs.map +1 -0
  12. package/dist/cjs/instrumentation.cjs +21 -0
  13. package/dist/cjs/instrumentation.cjs.map +1 -0
  14. package/dist/cjs/llm/anthropic/index.cjs +292 -0
  15. package/dist/cjs/llm/anthropic/index.cjs.map +1 -0
  16. package/dist/cjs/llm/anthropic/types.cjs +50 -0
  17. package/dist/cjs/llm/anthropic/types.cjs.map +1 -0
  18. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs +630 -0
  19. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs.map +1 -0
  20. package/dist/cjs/llm/anthropic/utils/message_outputs.cjs +218 -0
  21. package/dist/cjs/llm/anthropic/utils/message_outputs.cjs.map +1 -0
  22. package/dist/cjs/llm/anthropic/utils/tools.cjs +29 -0
  23. package/dist/cjs/llm/anthropic/utils/tools.cjs.map +1 -0
  24. package/dist/cjs/llm/bedrock/index.cjs +282 -0
  25. package/dist/cjs/llm/bedrock/index.cjs.map +1 -0
  26. package/dist/cjs/llm/fake.cjs +97 -0
  27. package/dist/cjs/llm/fake.cjs.map +1 -0
  28. package/dist/cjs/llm/google/index.cjs +216 -0
  29. package/dist/cjs/llm/google/index.cjs.map +1 -0
  30. package/dist/cjs/llm/google/utils/common.cjs +647 -0
  31. package/dist/cjs/llm/google/utils/common.cjs.map +1 -0
  32. package/dist/cjs/llm/openai/index.cjs +1028 -0
  33. package/dist/cjs/llm/openai/index.cjs.map +1 -0
  34. package/dist/cjs/llm/openai/utils/index.cjs +765 -0
  35. package/dist/cjs/llm/openai/utils/index.cjs.map +1 -0
  36. package/dist/cjs/llm/openrouter/index.cjs +212 -0
  37. package/dist/cjs/llm/openrouter/index.cjs.map +1 -0
  38. package/dist/cjs/llm/providers.cjs +43 -0
  39. package/dist/cjs/llm/providers.cjs.map +1 -0
  40. package/dist/cjs/llm/text.cjs +69 -0
  41. package/dist/cjs/llm/text.cjs.map +1 -0
  42. package/dist/cjs/llm/vertexai/index.cjs +329 -0
  43. package/dist/cjs/llm/vertexai/index.cjs.map +1 -0
  44. package/dist/cjs/main.cjs +240 -0
  45. package/dist/cjs/main.cjs.map +1 -0
  46. package/dist/cjs/messages/cache.cjs +387 -0
  47. package/dist/cjs/messages/cache.cjs.map +1 -0
  48. package/dist/cjs/messages/content.cjs +53 -0
  49. package/dist/cjs/messages/content.cjs.map +1 -0
  50. package/dist/cjs/messages/core.cjs +367 -0
  51. package/dist/cjs/messages/core.cjs.map +1 -0
  52. package/dist/cjs/messages/format.cjs +761 -0
  53. package/dist/cjs/messages/format.cjs.map +1 -0
  54. package/dist/cjs/messages/ids.cjs +23 -0
  55. package/dist/cjs/messages/ids.cjs.map +1 -0
  56. package/dist/cjs/messages/prune.cjs +398 -0
  57. package/dist/cjs/messages/prune.cjs.map +1 -0
  58. package/dist/cjs/messages/tools.cjs +96 -0
  59. package/dist/cjs/messages/tools.cjs.map +1 -0
  60. package/dist/cjs/run.cjs +328 -0
  61. package/dist/cjs/run.cjs.map +1 -0
  62. package/dist/cjs/schemas/validate.cjs +324 -0
  63. package/dist/cjs/schemas/validate.cjs.map +1 -0
  64. package/dist/cjs/splitStream.cjs +210 -0
  65. package/dist/cjs/splitStream.cjs.map +1 -0
  66. package/dist/cjs/stream.cjs +620 -0
  67. package/dist/cjs/stream.cjs.map +1 -0
  68. package/dist/cjs/tools/BrowserTools.cjs +248 -0
  69. package/dist/cjs/tools/BrowserTools.cjs.map +1 -0
  70. package/dist/cjs/tools/Calculator.cjs +66 -0
  71. package/dist/cjs/tools/Calculator.cjs.map +1 -0
  72. package/dist/cjs/tools/CodeExecutor.cjs +234 -0
  73. package/dist/cjs/tools/CodeExecutor.cjs.map +1 -0
  74. package/dist/cjs/tools/ProgrammaticToolCalling.cjs +636 -0
  75. package/dist/cjs/tools/ProgrammaticToolCalling.cjs.map +1 -0
  76. package/dist/cjs/tools/ToolNode.cjs +548 -0
  77. package/dist/cjs/tools/ToolNode.cjs.map +1 -0
  78. package/dist/cjs/tools/ToolSearch.cjs +909 -0
  79. package/dist/cjs/tools/ToolSearch.cjs.map +1 -0
  80. package/dist/cjs/tools/handlers.cjs +255 -0
  81. package/dist/cjs/tools/handlers.cjs.map +1 -0
  82. package/dist/cjs/tools/schema.cjs +31 -0
  83. package/dist/cjs/tools/schema.cjs.map +1 -0
  84. package/dist/cjs/tools/search/anthropic.cjs +40 -0
  85. package/dist/cjs/tools/search/anthropic.cjs.map +1 -0
  86. package/dist/cjs/tools/search/content.cjs +140 -0
  87. package/dist/cjs/tools/search/content.cjs.map +1 -0
  88. package/dist/cjs/tools/search/firecrawl.cjs +179 -0
  89. package/dist/cjs/tools/search/firecrawl.cjs.map +1 -0
  90. package/dist/cjs/tools/search/format.cjs +203 -0
  91. package/dist/cjs/tools/search/format.cjs.map +1 -0
  92. package/dist/cjs/tools/search/highlights.cjs +245 -0
  93. package/dist/cjs/tools/search/highlights.cjs.map +1 -0
  94. package/dist/cjs/tools/search/rerankers.cjs +174 -0
  95. package/dist/cjs/tools/search/rerankers.cjs.map +1 -0
  96. package/dist/cjs/tools/search/schema.cjs +117 -0
  97. package/dist/cjs/tools/search/schema.cjs.map +1 -0
  98. package/dist/cjs/tools/search/search.cjs +566 -0
  99. package/dist/cjs/tools/search/search.cjs.map +1 -0
  100. package/dist/cjs/tools/search/serper-scraper.cjs +132 -0
  101. package/dist/cjs/tools/search/serper-scraper.cjs.map +1 -0
  102. package/dist/cjs/tools/search/tool.cjs +456 -0
  103. package/dist/cjs/tools/search/tool.cjs.map +1 -0
  104. package/dist/cjs/tools/search/utils.cjs +66 -0
  105. package/dist/cjs/tools/search/utils.cjs.map +1 -0
  106. package/dist/cjs/types/graph.cjs +29 -0
  107. package/dist/cjs/types/graph.cjs.map +1 -0
  108. package/dist/cjs/utils/contextAnalytics.cjs +66 -0
  109. package/dist/cjs/utils/contextAnalytics.cjs.map +1 -0
  110. package/dist/cjs/utils/events.cjs +31 -0
  111. package/dist/cjs/utils/events.cjs.map +1 -0
  112. package/dist/cjs/utils/graph.cjs +16 -0
  113. package/dist/cjs/utils/graph.cjs.map +1 -0
  114. package/dist/cjs/utils/handlers.cjs +70 -0
  115. package/dist/cjs/utils/handlers.cjs.map +1 -0
  116. package/dist/cjs/utils/llm.cjs +27 -0
  117. package/dist/cjs/utils/llm.cjs.map +1 -0
  118. package/dist/cjs/utils/misc.cjs +56 -0
  119. package/dist/cjs/utils/misc.cjs.map +1 -0
  120. package/dist/cjs/utils/run.cjs +73 -0
  121. package/dist/cjs/utils/run.cjs.map +1 -0
  122. package/dist/cjs/utils/schema.cjs +27 -0
  123. package/dist/cjs/utils/schema.cjs.map +1 -0
  124. package/dist/cjs/utils/title.cjs +125 -0
  125. package/dist/cjs/utils/title.cjs.map +1 -0
  126. package/dist/cjs/utils/tokens.cjs +125 -0
  127. package/dist/cjs/utils/tokens.cjs.map +1 -0
  128. package/dist/cjs/utils/toonFormat.cjs +388 -0
  129. package/dist/cjs/utils/toonFormat.cjs.map +1 -0
  130. package/dist/esm/agents/AgentContext.mjs +732 -0
  131. package/dist/esm/agents/AgentContext.mjs.map +1 -0
  132. package/dist/esm/common/enum.mjs +190 -0
  133. package/dist/esm/common/enum.mjs.map +1 -0
  134. package/dist/esm/events.mjs +164 -0
  135. package/dist/esm/events.mjs.map +1 -0
  136. package/dist/esm/graphs/Graph.mjs +1612 -0
  137. package/dist/esm/graphs/Graph.mjs.map +1 -0
  138. package/dist/esm/graphs/MultiAgentGraph.mjs +888 -0
  139. package/dist/esm/graphs/MultiAgentGraph.mjs.map +1 -0
  140. package/dist/esm/instrumentation.mjs +19 -0
  141. package/dist/esm/instrumentation.mjs.map +1 -0
  142. package/dist/esm/llm/anthropic/index.mjs +290 -0
  143. package/dist/esm/llm/anthropic/index.mjs.map +1 -0
  144. package/dist/esm/llm/anthropic/types.mjs +48 -0
  145. package/dist/esm/llm/anthropic/types.mjs.map +1 -0
  146. package/dist/esm/llm/anthropic/utils/message_inputs.mjs +627 -0
  147. package/dist/esm/llm/anthropic/utils/message_inputs.mjs.map +1 -0
  148. package/dist/esm/llm/anthropic/utils/message_outputs.mjs +216 -0
  149. package/dist/esm/llm/anthropic/utils/message_outputs.mjs.map +1 -0
  150. package/dist/esm/llm/anthropic/utils/tools.mjs +27 -0
  151. package/dist/esm/llm/anthropic/utils/tools.mjs.map +1 -0
  152. package/dist/esm/llm/bedrock/index.mjs +280 -0
  153. package/dist/esm/llm/bedrock/index.mjs.map +1 -0
  154. package/dist/esm/llm/fake.mjs +94 -0
  155. package/dist/esm/llm/fake.mjs.map +1 -0
  156. package/dist/esm/llm/google/index.mjs +214 -0
  157. package/dist/esm/llm/google/index.mjs.map +1 -0
  158. package/dist/esm/llm/google/utils/common.mjs +638 -0
  159. package/dist/esm/llm/google/utils/common.mjs.map +1 -0
  160. package/dist/esm/llm/openai/index.mjs +1018 -0
  161. package/dist/esm/llm/openai/index.mjs.map +1 -0
  162. package/dist/esm/llm/openai/utils/index.mjs +759 -0
  163. package/dist/esm/llm/openai/utils/index.mjs.map +1 -0
  164. package/dist/esm/llm/openrouter/index.mjs +210 -0
  165. package/dist/esm/llm/openrouter/index.mjs.map +1 -0
  166. package/dist/esm/llm/providers.mjs +39 -0
  167. package/dist/esm/llm/providers.mjs.map +1 -0
  168. package/dist/esm/llm/text.mjs +67 -0
  169. package/dist/esm/llm/text.mjs.map +1 -0
  170. package/dist/esm/llm/vertexai/index.mjs +327 -0
  171. package/dist/esm/llm/vertexai/index.mjs.map +1 -0
  172. package/dist/esm/main.mjs +37 -0
  173. package/dist/esm/main.mjs.map +1 -0
  174. package/dist/esm/messages/cache.mjs +382 -0
  175. package/dist/esm/messages/cache.mjs.map +1 -0
  176. package/dist/esm/messages/content.mjs +51 -0
  177. package/dist/esm/messages/content.mjs.map +1 -0
  178. package/dist/esm/messages/core.mjs +359 -0
  179. package/dist/esm/messages/core.mjs.map +1 -0
  180. package/dist/esm/messages/format.mjs +752 -0
  181. package/dist/esm/messages/format.mjs.map +1 -0
  182. package/dist/esm/messages/ids.mjs +21 -0
  183. package/dist/esm/messages/ids.mjs.map +1 -0
  184. package/dist/esm/messages/prune.mjs +393 -0
  185. package/dist/esm/messages/prune.mjs.map +1 -0
  186. package/dist/esm/messages/tools.mjs +93 -0
  187. package/dist/esm/messages/tools.mjs.map +1 -0
  188. package/dist/esm/run.mjs +325 -0
  189. package/dist/esm/run.mjs.map +1 -0
  190. package/dist/esm/schemas/validate.mjs +317 -0
  191. package/dist/esm/schemas/validate.mjs.map +1 -0
  192. package/dist/esm/splitStream.mjs +207 -0
  193. package/dist/esm/splitStream.mjs.map +1 -0
  194. package/dist/esm/stream.mjs +616 -0
  195. package/dist/esm/stream.mjs.map +1 -0
  196. package/dist/esm/tools/BrowserTools.mjs +244 -0
  197. package/dist/esm/tools/BrowserTools.mjs.map +1 -0
  198. package/dist/esm/tools/Calculator.mjs +41 -0
  199. package/dist/esm/tools/Calculator.mjs.map +1 -0
  200. package/dist/esm/tools/CodeExecutor.mjs +226 -0
  201. package/dist/esm/tools/CodeExecutor.mjs.map +1 -0
  202. package/dist/esm/tools/ProgrammaticToolCalling.mjs +622 -0
  203. package/dist/esm/tools/ProgrammaticToolCalling.mjs.map +1 -0
  204. package/dist/esm/tools/ToolNode.mjs +545 -0
  205. package/dist/esm/tools/ToolNode.mjs.map +1 -0
  206. package/dist/esm/tools/ToolSearch.mjs +870 -0
  207. package/dist/esm/tools/ToolSearch.mjs.map +1 -0
  208. package/dist/esm/tools/handlers.mjs +250 -0
  209. package/dist/esm/tools/handlers.mjs.map +1 -0
  210. package/dist/esm/tools/schema.mjs +28 -0
  211. package/dist/esm/tools/schema.mjs.map +1 -0
  212. package/dist/esm/tools/search/anthropic.mjs +37 -0
  213. package/dist/esm/tools/search/anthropic.mjs.map +1 -0
  214. package/dist/esm/tools/search/content.mjs +119 -0
  215. package/dist/esm/tools/search/content.mjs.map +1 -0
  216. package/dist/esm/tools/search/firecrawl.mjs +176 -0
  217. package/dist/esm/tools/search/firecrawl.mjs.map +1 -0
  218. package/dist/esm/tools/search/format.mjs +201 -0
  219. package/dist/esm/tools/search/format.mjs.map +1 -0
  220. package/dist/esm/tools/search/highlights.mjs +243 -0
  221. package/dist/esm/tools/search/highlights.mjs.map +1 -0
  222. package/dist/esm/tools/search/rerankers.mjs +168 -0
  223. package/dist/esm/tools/search/rerankers.mjs.map +1 -0
  224. package/dist/esm/tools/search/schema.mjs +104 -0
  225. package/dist/esm/tools/search/schema.mjs.map +1 -0
  226. package/dist/esm/tools/search/search.mjs +563 -0
  227. package/dist/esm/tools/search/search.mjs.map +1 -0
  228. package/dist/esm/tools/search/serper-scraper.mjs +129 -0
  229. package/dist/esm/tools/search/serper-scraper.mjs.map +1 -0
  230. package/dist/esm/tools/search/tool.mjs +454 -0
  231. package/dist/esm/tools/search/tool.mjs.map +1 -0
  232. package/dist/esm/tools/search/utils.mjs +61 -0
  233. package/dist/esm/tools/search/utils.mjs.map +1 -0
  234. package/dist/esm/types/graph.mjs +26 -0
  235. package/dist/esm/types/graph.mjs.map +1 -0
  236. package/dist/esm/utils/contextAnalytics.mjs +64 -0
  237. package/dist/esm/utils/contextAnalytics.mjs.map +1 -0
  238. package/dist/esm/utils/events.mjs +29 -0
  239. package/dist/esm/utils/events.mjs.map +1 -0
  240. package/dist/esm/utils/graph.mjs +13 -0
  241. package/dist/esm/utils/graph.mjs.map +1 -0
  242. package/dist/esm/utils/handlers.mjs +68 -0
  243. package/dist/esm/utils/handlers.mjs.map +1 -0
  244. package/dist/esm/utils/llm.mjs +24 -0
  245. package/dist/esm/utils/llm.mjs.map +1 -0
  246. package/dist/esm/utils/misc.mjs +53 -0
  247. package/dist/esm/utils/misc.mjs.map +1 -0
  248. package/dist/esm/utils/run.mjs +70 -0
  249. package/dist/esm/utils/run.mjs.map +1 -0
  250. package/dist/esm/utils/schema.mjs +24 -0
  251. package/dist/esm/utils/schema.mjs.map +1 -0
  252. package/dist/esm/utils/title.mjs +122 -0
  253. package/dist/esm/utils/title.mjs.map +1 -0
  254. package/dist/esm/utils/tokens.mjs +121 -0
  255. package/dist/esm/utils/tokens.mjs.map +1 -0
  256. package/dist/esm/utils/toonFormat.mjs +381 -0
  257. package/dist/esm/utils/toonFormat.mjs.map +1 -0
  258. package/dist/types/agents/AgentContext.d.ts +293 -0
  259. package/dist/types/common/enum.d.ts +155 -0
  260. package/dist/types/common/index.d.ts +1 -0
  261. package/dist/types/events.d.ts +31 -0
  262. package/dist/types/graphs/Graph.d.ts +216 -0
  263. package/dist/types/graphs/MultiAgentGraph.d.ts +104 -0
  264. package/dist/types/graphs/index.d.ts +2 -0
  265. package/dist/types/index.d.ts +21 -0
  266. package/dist/types/instrumentation.d.ts +1 -0
  267. package/dist/types/llm/anthropic/index.d.ts +39 -0
  268. package/dist/types/llm/anthropic/types.d.ts +37 -0
  269. package/dist/types/llm/anthropic/utils/message_inputs.d.ts +14 -0
  270. package/dist/types/llm/anthropic/utils/message_outputs.d.ts +14 -0
  271. package/dist/types/llm/anthropic/utils/output_parsers.d.ts +22 -0
  272. package/dist/types/llm/anthropic/utils/tools.d.ts +3 -0
  273. package/dist/types/llm/bedrock/index.d.ts +141 -0
  274. package/dist/types/llm/bedrock/types.d.ts +27 -0
  275. package/dist/types/llm/bedrock/utils/index.d.ts +5 -0
  276. package/dist/types/llm/bedrock/utils/message_inputs.d.ts +31 -0
  277. package/dist/types/llm/bedrock/utils/message_outputs.d.ts +33 -0
  278. package/dist/types/llm/fake.d.ts +31 -0
  279. package/dist/types/llm/google/index.d.ts +24 -0
  280. package/dist/types/llm/google/types.d.ts +42 -0
  281. package/dist/types/llm/google/utils/common.d.ts +34 -0
  282. package/dist/types/llm/google/utils/tools.d.ts +10 -0
  283. package/dist/types/llm/google/utils/zod_to_genai_parameters.d.ts +14 -0
  284. package/dist/types/llm/openai/index.d.ts +127 -0
  285. package/dist/types/llm/openai/types.d.ts +10 -0
  286. package/dist/types/llm/openai/utils/index.d.ts +29 -0
  287. package/dist/types/llm/openrouter/index.d.ts +15 -0
  288. package/dist/types/llm/providers.d.ts +5 -0
  289. package/dist/types/llm/text.d.ts +21 -0
  290. package/dist/types/llm/vertexai/index.d.ts +293 -0
  291. package/dist/types/messages/cache.d.ts +54 -0
  292. package/dist/types/messages/content.d.ts +7 -0
  293. package/dist/types/messages/core.d.ts +14 -0
  294. package/dist/types/messages/format.d.ts +137 -0
  295. package/dist/types/messages/ids.d.ts +3 -0
  296. package/dist/types/messages/index.d.ts +7 -0
  297. package/dist/types/messages/prune.d.ts +52 -0
  298. package/dist/types/messages/reducer.d.ts +9 -0
  299. package/dist/types/messages/tools.d.ts +17 -0
  300. package/dist/types/mockStream.d.ts +32 -0
  301. package/dist/types/prompts/collab.d.ts +1 -0
  302. package/dist/types/prompts/index.d.ts +2 -0
  303. package/dist/types/prompts/taskmanager.d.ts +41 -0
  304. package/dist/types/run.d.ts +41 -0
  305. package/dist/types/schemas/index.d.ts +1 -0
  306. package/dist/types/schemas/validate.d.ts +59 -0
  307. package/dist/types/splitStream.d.ts +37 -0
  308. package/dist/types/stream.d.ts +15 -0
  309. package/dist/types/test/mockTools.d.ts +28 -0
  310. package/dist/types/tools/BrowserTools.d.ts +87 -0
  311. package/dist/types/tools/Calculator.d.ts +34 -0
  312. package/dist/types/tools/CodeExecutor.d.ts +57 -0
  313. package/dist/types/tools/ProgrammaticToolCalling.d.ts +138 -0
  314. package/dist/types/tools/ToolNode.d.ts +51 -0
  315. package/dist/types/tools/ToolSearch.d.ts +219 -0
  316. package/dist/types/tools/handlers.d.ts +22 -0
  317. package/dist/types/tools/schema.d.ts +12 -0
  318. package/dist/types/tools/search/anthropic.d.ts +16 -0
  319. package/dist/types/tools/search/content.d.ts +4 -0
  320. package/dist/types/tools/search/firecrawl.d.ts +54 -0
  321. package/dist/types/tools/search/format.d.ts +5 -0
  322. package/dist/types/tools/search/highlights.d.ts +13 -0
  323. package/dist/types/tools/search/index.d.ts +3 -0
  324. package/dist/types/tools/search/rerankers.d.ts +38 -0
  325. package/dist/types/tools/search/schema.d.ts +103 -0
  326. package/dist/types/tools/search/search.d.ts +8 -0
  327. package/dist/types/tools/search/serper-scraper.d.ts +59 -0
  328. package/dist/types/tools/search/test.d.ts +1 -0
  329. package/dist/types/tools/search/tool.d.ts +3 -0
  330. package/dist/types/tools/search/types.d.ts +575 -0
  331. package/dist/types/tools/search/utils.d.ts +10 -0
  332. package/dist/types/types/graph.d.ts +399 -0
  333. package/dist/types/types/index.d.ts +5 -0
  334. package/dist/types/types/llm.d.ts +105 -0
  335. package/dist/types/types/messages.d.ts +4 -0
  336. package/dist/types/types/run.d.ts +112 -0
  337. package/dist/types/types/stream.d.ts +308 -0
  338. package/dist/types/types/tools.d.ts +296 -0
  339. package/dist/types/utils/contextAnalytics.d.ts +37 -0
  340. package/dist/types/utils/events.d.ts +6 -0
  341. package/dist/types/utils/graph.d.ts +2 -0
  342. package/dist/types/utils/handlers.d.ts +34 -0
  343. package/dist/types/utils/index.d.ts +9 -0
  344. package/dist/types/utils/llm.d.ts +3 -0
  345. package/dist/types/utils/llmConfig.d.ts +3 -0
  346. package/dist/types/utils/logging.d.ts +1 -0
  347. package/dist/types/utils/misc.d.ts +7 -0
  348. package/dist/types/utils/run.d.ts +27 -0
  349. package/dist/types/utils/schema.d.ts +8 -0
  350. package/dist/types/utils/title.d.ts +4 -0
  351. package/dist/types/utils/tokens.d.ts +28 -0
  352. package/dist/types/utils/toonFormat.d.ts +111 -0
  353. package/package.json +190 -0
  354. package/src/agents/AgentContext.test.ts +458 -0
  355. package/src/agents/AgentContext.ts +972 -0
  356. package/src/agents/__tests__/AgentContext.test.ts +805 -0
  357. package/src/agents/__tests__/resolveStructuredOutputMode.test.ts +137 -0
  358. package/src/common/enum.ts +203 -0
  359. package/src/common/index.ts +2 -0
  360. package/src/events.ts +223 -0
  361. package/src/graphs/Graph.ts +2228 -0
  362. package/src/graphs/MultiAgentGraph.ts +1063 -0
  363. package/src/graphs/__tests__/structured-output.integration.test.ts +809 -0
  364. package/src/graphs/__tests__/structured-output.test.ts +183 -0
  365. package/src/graphs/index.ts +2 -0
  366. package/src/index.ts +34 -0
  367. package/src/instrumentation.ts +22 -0
  368. package/src/llm/anthropic/Jacob_Lee_Resume_2023.pdf +0 -0
  369. package/src/llm/anthropic/index.ts +413 -0
  370. package/src/llm/anthropic/llm.spec.ts +1442 -0
  371. package/src/llm/anthropic/types.ts +140 -0
  372. package/src/llm/anthropic/utils/message_inputs.ts +757 -0
  373. package/src/llm/anthropic/utils/message_outputs.ts +289 -0
  374. package/src/llm/anthropic/utils/output_parsers.ts +133 -0
  375. package/src/llm/anthropic/utils/tools.ts +29 -0
  376. package/src/llm/bedrock/__tests__/bedrock-caching.test.ts +495 -0
  377. package/src/llm/bedrock/index.ts +411 -0
  378. package/src/llm/bedrock/llm.spec.ts +616 -0
  379. package/src/llm/bedrock/types.ts +51 -0
  380. package/src/llm/bedrock/utils/index.ts +18 -0
  381. package/src/llm/bedrock/utils/message_inputs.ts +563 -0
  382. package/src/llm/bedrock/utils/message_outputs.ts +310 -0
  383. package/src/llm/fake.ts +133 -0
  384. package/src/llm/google/data/gettysburg10.wav +0 -0
  385. package/src/llm/google/data/hotdog.jpg +0 -0
  386. package/src/llm/google/index.ts +337 -0
  387. package/src/llm/google/llm.spec.ts +934 -0
  388. package/src/llm/google/types.ts +56 -0
  389. package/src/llm/google/utils/common.ts +873 -0
  390. package/src/llm/google/utils/tools.ts +160 -0
  391. package/src/llm/google/utils/zod_to_genai_parameters.ts +86 -0
  392. package/src/llm/openai/index.ts +1366 -0
  393. package/src/llm/openai/types.ts +24 -0
  394. package/src/llm/openai/utils/index.ts +1035 -0
  395. package/src/llm/openai/utils/isReasoningModel.test.ts +90 -0
  396. package/src/llm/openrouter/index.ts +291 -0
  397. package/src/llm/providers.ts +52 -0
  398. package/src/llm/text.ts +94 -0
  399. package/src/llm/vertexai/index.ts +359 -0
  400. package/src/messages/__tests__/tools.test.ts +473 -0
  401. package/src/messages/cache.test.ts +1261 -0
  402. package/src/messages/cache.ts +518 -0
  403. package/src/messages/content.test.ts +362 -0
  404. package/src/messages/content.ts +63 -0
  405. package/src/messages/core.ts +473 -0
  406. package/src/messages/ensureThinkingBlock.test.ts +468 -0
  407. package/src/messages/format.ts +1029 -0
  408. package/src/messages/formatAgentMessages.test.ts +1513 -0
  409. package/src/messages/formatAgentMessages.tools.test.ts +419 -0
  410. package/src/messages/formatMessage.test.ts +693 -0
  411. package/src/messages/ids.ts +26 -0
  412. package/src/messages/index.ts +7 -0
  413. package/src/messages/labelContentByAgent.test.ts +887 -0
  414. package/src/messages/prune.ts +568 -0
  415. package/src/messages/reducer.ts +80 -0
  416. package/src/messages/shiftIndexTokenCountMap.test.ts +81 -0
  417. package/src/messages/tools.ts +108 -0
  418. package/src/mockStream.ts +99 -0
  419. package/src/prompts/collab.ts +6 -0
  420. package/src/prompts/index.ts +2 -0
  421. package/src/prompts/taskmanager.ts +61 -0
  422. package/src/run.ts +467 -0
  423. package/src/schemas/index.ts +2 -0
  424. package/src/schemas/schema-preparation.test.ts +500 -0
  425. package/src/schemas/validate.test.ts +358 -0
  426. package/src/schemas/validate.ts +454 -0
  427. package/src/scripts/abort.ts +157 -0
  428. package/src/scripts/ant_web_search.ts +158 -0
  429. package/src/scripts/ant_web_search_edge_case.ts +162 -0
  430. package/src/scripts/ant_web_search_error_edge_case.ts +148 -0
  431. package/src/scripts/args.ts +48 -0
  432. package/src/scripts/caching.ts +132 -0
  433. package/src/scripts/cli.ts +172 -0
  434. package/src/scripts/cli2.ts +133 -0
  435. package/src/scripts/cli3.ts +184 -0
  436. package/src/scripts/cli4.ts +191 -0
  437. package/src/scripts/cli5.ts +191 -0
  438. package/src/scripts/code_exec.ts +213 -0
  439. package/src/scripts/code_exec_files.ts +236 -0
  440. package/src/scripts/code_exec_multi_session.ts +241 -0
  441. package/src/scripts/code_exec_ptc.ts +334 -0
  442. package/src/scripts/code_exec_session.ts +282 -0
  443. package/src/scripts/code_exec_simple.ts +147 -0
  444. package/src/scripts/content.ts +138 -0
  445. package/src/scripts/empty_input.ts +137 -0
  446. package/src/scripts/handoff-test.ts +135 -0
  447. package/src/scripts/image.ts +178 -0
  448. package/src/scripts/memory.ts +97 -0
  449. package/src/scripts/multi-agent-chain.ts +331 -0
  450. package/src/scripts/multi-agent-conditional.ts +221 -0
  451. package/src/scripts/multi-agent-document-review-chain.ts +197 -0
  452. package/src/scripts/multi-agent-hybrid-flow.ts +310 -0
  453. package/src/scripts/multi-agent-parallel-start.ts +265 -0
  454. package/src/scripts/multi-agent-parallel.ts +394 -0
  455. package/src/scripts/multi-agent-sequence.ts +217 -0
  456. package/src/scripts/multi-agent-supervisor.ts +365 -0
  457. package/src/scripts/multi-agent-test.ts +186 -0
  458. package/src/scripts/parallel-asymmetric-tools-test.ts +274 -0
  459. package/src/scripts/parallel-full-metadata-test.ts +240 -0
  460. package/src/scripts/parallel-tools-test.ts +340 -0
  461. package/src/scripts/programmatic_exec.ts +396 -0
  462. package/src/scripts/programmatic_exec_agent.ts +231 -0
  463. package/src/scripts/search.ts +146 -0
  464. package/src/scripts/sequential-full-metadata-test.ts +197 -0
  465. package/src/scripts/simple.ts +225 -0
  466. package/src/scripts/single-agent-metadata-test.ts +198 -0
  467. package/src/scripts/stream.ts +140 -0
  468. package/src/scripts/test-custom-prompt-key.ts +145 -0
  469. package/src/scripts/test-handoff-input.ts +170 -0
  470. package/src/scripts/test-handoff-preamble.ts +277 -0
  471. package/src/scripts/test-multi-agent-list-handoff.ts +417 -0
  472. package/src/scripts/test-parallel-agent-labeling.ts +325 -0
  473. package/src/scripts/test-parallel-handoffs.ts +291 -0
  474. package/src/scripts/test-thinking-handoff-bedrock.ts +153 -0
  475. package/src/scripts/test-thinking-handoff.ts +155 -0
  476. package/src/scripts/test-tools-before-handoff.ts +226 -0
  477. package/src/scripts/test_code_api.ts +361 -0
  478. package/src/scripts/thinking-bedrock.ts +159 -0
  479. package/src/scripts/thinking.ts +171 -0
  480. package/src/scripts/tool_search.ts +162 -0
  481. package/src/scripts/tools.ts +177 -0
  482. package/src/specs/agent-handoffs.test.ts +888 -0
  483. package/src/specs/anthropic.simple.test.ts +387 -0
  484. package/src/specs/azure.simple.test.ts +364 -0
  485. package/src/specs/cache.simple.test.ts +396 -0
  486. package/src/specs/deepseek.simple.test.ts +283 -0
  487. package/src/specs/emergency-prune.test.ts +407 -0
  488. package/src/specs/moonshot.simple.test.ts +358 -0
  489. package/src/specs/openai.simple.test.ts +311 -0
  490. package/src/specs/openrouter.simple.test.ts +107 -0
  491. package/src/specs/prune.test.ts +901 -0
  492. package/src/specs/reasoning.test.ts +201 -0
  493. package/src/specs/spec.utils.ts +3 -0
  494. package/src/specs/thinking-handoff.test.ts +620 -0
  495. package/src/specs/thinking-prune.test.ts +703 -0
  496. package/src/specs/token-distribution-edge-case.test.ts +316 -0
  497. package/src/specs/token-memoization.test.ts +32 -0
  498. package/src/specs/tool-error.test.ts +198 -0
  499. package/src/splitStream.test.ts +691 -0
  500. package/src/splitStream.ts +234 -0
  501. package/src/stream.test.ts +94 -0
  502. package/src/stream.ts +801 -0
  503. package/src/test/mockTools.ts +386 -0
  504. package/src/tools/BrowserTools.ts +393 -0
  505. package/src/tools/Calculator.test.ts +278 -0
  506. package/src/tools/Calculator.ts +46 -0
  507. package/src/tools/CodeExecutor.ts +270 -0
  508. package/src/tools/ProgrammaticToolCalling.ts +785 -0
  509. package/src/tools/ToolNode.ts +674 -0
  510. package/src/tools/ToolSearch.ts +1095 -0
  511. package/src/tools/__tests__/BrowserTools.test.ts +265 -0
  512. package/src/tools/__tests__/ProgrammaticToolCalling.integration.test.ts +319 -0
  513. package/src/tools/__tests__/ProgrammaticToolCalling.test.ts +1006 -0
  514. package/src/tools/__tests__/ToolSearch.integration.test.ts +162 -0
  515. package/src/tools/__tests__/ToolSearch.test.ts +1003 -0
  516. package/src/tools/handlers.ts +363 -0
  517. package/src/tools/schema.ts +37 -0
  518. package/src/tools/search/anthropic.ts +51 -0
  519. package/src/tools/search/content.test.ts +173 -0
  520. package/src/tools/search/content.ts +147 -0
  521. package/src/tools/search/firecrawl.ts +210 -0
  522. package/src/tools/search/format.ts +250 -0
  523. package/src/tools/search/highlights.ts +320 -0
  524. package/src/tools/search/index.ts +3 -0
  525. package/src/tools/search/jina-reranker.test.ts +130 -0
  526. package/src/tools/search/output.md +2775 -0
  527. package/src/tools/search/rerankers.ts +242 -0
  528. package/src/tools/search/schema.ts +113 -0
  529. package/src/tools/search/search.ts +768 -0
  530. package/src/tools/search/serper-scraper.ts +155 -0
  531. package/src/tools/search/test.html +884 -0
  532. package/src/tools/search/test.md +643 -0
  533. package/src/tools/search/test.ts +159 -0
  534. package/src/tools/search/tool.ts +657 -0
  535. package/src/tools/search/types.ts +665 -0
  536. package/src/tools/search/utils.ts +79 -0
  537. package/src/types/graph.test.ts +218 -0
  538. package/src/types/graph.ts +533 -0
  539. package/src/types/index.ts +6 -0
  540. package/src/types/llm.ts +140 -0
  541. package/src/types/messages.ts +4 -0
  542. package/src/types/run.ts +128 -0
  543. package/src/types/stream.ts +417 -0
  544. package/src/types/tools.ts +355 -0
  545. package/src/utils/contextAnalytics.ts +103 -0
  546. package/src/utils/events.ts +32 -0
  547. package/src/utils/graph.ts +11 -0
  548. package/src/utils/handlers.ts +107 -0
  549. package/src/utils/index.ts +9 -0
  550. package/src/utils/llm.ts +26 -0
  551. package/src/utils/llmConfig.ts +208 -0
  552. package/src/utils/logging.ts +48 -0
  553. package/src/utils/misc.ts +57 -0
  554. package/src/utils/run.ts +106 -0
  555. package/src/utils/schema.ts +35 -0
  556. package/src/utils/title.ts +177 -0
  557. package/src/utils/tokens.ts +142 -0
  558. package/src/utils/toonFormat.ts +475 -0
@@ -0,0 +1,759 @@
1
+ import { isDataContentBlock, convertToProviderContentBlock, isAIMessage, AIMessageChunk, ChatMessage, parseBase64DataUrl, parseMimeType, AIMessage } from '@langchain/core/messages';
2
+ import { ChatGenerationChunk } from '@langchain/core/outputs';
3
+ import { convertLangChainToolCallToOpenAI, parseToolCall, makeInvalidToolCall } from '@langchain/core/output_parsers/openai_tools';
4
+
5
+ function extractGenericMessageCustomRole(message) {
6
+ if (message.role !== 'system' &&
7
+ message.role !== 'developer' &&
8
+ message.role !== 'assistant' &&
9
+ message.role !== 'user' &&
10
+ message.role !== 'function' &&
11
+ message.role !== 'tool') {
12
+ console.warn(`Unknown message role: ${message.role}`);
13
+ }
14
+ return message.role;
15
+ }
16
+ function messageToOpenAIRole(message) {
17
+ const type = message._getType();
18
+ switch (type) {
19
+ case 'system':
20
+ return 'system';
21
+ case 'ai':
22
+ return 'assistant';
23
+ case 'human':
24
+ return 'user';
25
+ case 'function':
26
+ return 'function';
27
+ case 'tool':
28
+ return 'tool';
29
+ case 'generic': {
30
+ if (!ChatMessage.isInstance(message))
31
+ throw new Error('Invalid generic chat message');
32
+ return extractGenericMessageCustomRole(message);
33
+ }
34
+ default:
35
+ throw new Error(`Unknown message type: ${type}`);
36
+ }
37
+ }
38
+ const completionsApiContentBlockConverter = {
39
+ providerName: 'ChatOpenAI',
40
+ fromStandardTextBlock(block) {
41
+ return { type: 'text', text: block.text };
42
+ },
43
+ fromStandardImageBlock(block) {
44
+ if (block.source_type === 'url') {
45
+ return {
46
+ type: 'image_url',
47
+ image_url: {
48
+ url: block.url,
49
+ ...(block.metadata?.detail
50
+ ? { detail: block.metadata.detail }
51
+ : {}),
52
+ },
53
+ };
54
+ }
55
+ if (block.source_type === 'base64') {
56
+ const url = `data:${block.mime_type ?? ''};base64,${block.data}`;
57
+ return {
58
+ type: 'image_url',
59
+ image_url: {
60
+ url,
61
+ ...(block.metadata?.detail
62
+ ? { detail: block.metadata.detail }
63
+ : {}),
64
+ },
65
+ };
66
+ }
67
+ throw new Error(`Image content blocks with source_type ${block.source_type} are not supported for ChatOpenAI`);
68
+ },
69
+ fromStandardAudioBlock(block) {
70
+ if (block.source_type === 'url') {
71
+ const data = parseBase64DataUrl({ dataUrl: block.url });
72
+ if (!data) {
73
+ throw new Error(`URL audio blocks with source_type ${block.source_type} must be formatted as a data URL for ChatOpenAI`);
74
+ }
75
+ const rawMimeType = data.mime_type || block.mime_type || '';
76
+ let mimeType;
77
+ try {
78
+ mimeType = parseMimeType(rawMimeType);
79
+ }
80
+ catch {
81
+ throw new Error(`Audio blocks with source_type ${block.source_type} must have mime type of audio/wav or audio/mp3`);
82
+ }
83
+ if (mimeType.type !== 'audio' ||
84
+ (mimeType.subtype !== 'wav' && mimeType.subtype !== 'mp3')) {
85
+ throw new Error(`Audio blocks with source_type ${block.source_type} must have mime type of audio/wav or audio/mp3`);
86
+ }
87
+ return {
88
+ type: 'input_audio',
89
+ input_audio: {
90
+ format: mimeType.subtype,
91
+ data: data.data,
92
+ },
93
+ };
94
+ }
95
+ if (block.source_type === 'base64') {
96
+ let mimeType;
97
+ try {
98
+ mimeType = parseMimeType(block.mime_type ?? '');
99
+ }
100
+ catch {
101
+ throw new Error(`Audio blocks with source_type ${block.source_type} must have mime type of audio/wav or audio/mp3`);
102
+ }
103
+ if (mimeType.type !== 'audio' ||
104
+ (mimeType.subtype !== 'wav' && mimeType.subtype !== 'mp3')) {
105
+ throw new Error(`Audio blocks with source_type ${block.source_type} must have mime type of audio/wav or audio/mp3`);
106
+ }
107
+ return {
108
+ type: 'input_audio',
109
+ input_audio: {
110
+ format: mimeType.subtype,
111
+ data: block.data,
112
+ },
113
+ };
114
+ }
115
+ throw new Error(`Audio content blocks with source_type ${block.source_type} are not supported for ChatOpenAI`);
116
+ },
117
+ fromStandardFileBlock(block) {
118
+ if (block.source_type === 'url') {
119
+ const data = parseBase64DataUrl({ dataUrl: block.url });
120
+ if (!data) {
121
+ throw new Error(`URL file blocks with source_type ${block.source_type} must be formatted as a data URL for ChatOpenAI`);
122
+ }
123
+ return {
124
+ type: 'file',
125
+ file: {
126
+ file_data: block.url, // formatted as base64 data URL
127
+ ...(block.metadata?.filename || block.metadata?.name
128
+ ? {
129
+ filename: (block.metadata.filename ||
130
+ block.metadata.name),
131
+ }
132
+ : {}),
133
+ },
134
+ };
135
+ }
136
+ if (block.source_type === 'base64') {
137
+ return {
138
+ type: 'file',
139
+ file: {
140
+ file_data: `data:${block.mime_type ?? ''};base64,${block.data}`,
141
+ ...(block.metadata?.filename ||
142
+ block.metadata?.name ||
143
+ block.metadata?.title
144
+ ? {
145
+ filename: (block.metadata.filename ||
146
+ block.metadata.name ||
147
+ block.metadata.title),
148
+ }
149
+ : {}),
150
+ },
151
+ };
152
+ }
153
+ if (block.source_type === 'id') {
154
+ return {
155
+ type: 'file',
156
+ file: {
157
+ file_id: block.id,
158
+ },
159
+ };
160
+ }
161
+ throw new Error(`File content blocks with source_type ${block.source_type} are not supported for ChatOpenAI`);
162
+ },
163
+ };
164
+ // Used in LangSmith, export is important here
165
+ function _convertMessagesToOpenAIParams(messages, model, options) {
166
+ // TODO: Function messages do not support array content, fix cast
167
+ return messages.flatMap((message) => {
168
+ let role = messageToOpenAIRole(message);
169
+ if (role === 'system' && isReasoningModel(model)) {
170
+ role = 'developer';
171
+ }
172
+ let hasAnthropicThinkingBlock = false;
173
+ const content = typeof message.content === 'string'
174
+ ? message.content
175
+ : message.content.map((m) => {
176
+ if ('type' in m && m.type === 'thinking') {
177
+ hasAnthropicThinkingBlock = true;
178
+ return m;
179
+ }
180
+ if (isDataContentBlock(m)) {
181
+ return convertToProviderContentBlock(m, completionsApiContentBlockConverter);
182
+ }
183
+ return m;
184
+ });
185
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
186
+ const completionParam = {
187
+ role,
188
+ content,
189
+ };
190
+ if (message.name != null) {
191
+ completionParam.name = message.name;
192
+ }
193
+ if (message.additional_kwargs.function_call != null) {
194
+ completionParam.function_call = message.additional_kwargs.function_call;
195
+ completionParam.content = '';
196
+ }
197
+ if (isAIMessage(message) && !!message.tool_calls?.length) {
198
+ completionParam.tool_calls = message.tool_calls.map(convertLangChainToolCallToOpenAI);
199
+ completionParam.content = hasAnthropicThinkingBlock ? content : '';
200
+ if (options?.includeReasoningContent === true &&
201
+ message.additional_kwargs.reasoning_content != null) {
202
+ completionParam.reasoning_content =
203
+ message.additional_kwargs.reasoning_content;
204
+ }
205
+ if (options?.includeReasoningDetails === true &&
206
+ message.additional_kwargs.reasoning_details != null) {
207
+ // For Claude via OpenRouter, convert reasoning_details to content blocks
208
+ const isClaudeModel = model?.includes('claude') === true ||
209
+ model?.includes('anthropic') === true;
210
+ if (options.convertReasoningDetailsToContent === true &&
211
+ isClaudeModel) {
212
+ const reasoningDetails = message.additional_kwargs
213
+ .reasoning_details;
214
+ const contentBlocks = [];
215
+ // Add thinking blocks from reasoning_details
216
+ for (const detail of reasoningDetails) {
217
+ if (detail.type === 'reasoning.text' && detail.text != null) {
218
+ contentBlocks.push({
219
+ type: 'thinking',
220
+ thinking: detail.text,
221
+ });
222
+ }
223
+ else if (detail.type === 'reasoning.encrypted' &&
224
+ detail.data != null) {
225
+ contentBlocks.push({
226
+ type: 'redacted_thinking',
227
+ data: detail.data,
228
+ id: detail.id,
229
+ });
230
+ }
231
+ }
232
+ // Set content to array with thinking blocks
233
+ if (contentBlocks.length > 0) {
234
+ completionParam.content = contentBlocks;
235
+ }
236
+ }
237
+ else {
238
+ // For non-Claude models, pass as separate field
239
+ completionParam.reasoning_details =
240
+ message.additional_kwargs.reasoning_details;
241
+ }
242
+ }
243
+ }
244
+ else {
245
+ if (message.additional_kwargs.tool_calls != null) {
246
+ completionParam.tool_calls = message.additional_kwargs.tool_calls;
247
+ if (options?.includeReasoningContent === true &&
248
+ message.additional_kwargs.reasoning_content != null) {
249
+ completionParam.reasoning_content =
250
+ message.additional_kwargs.reasoning_content;
251
+ }
252
+ if (options?.includeReasoningDetails === true &&
253
+ message.additional_kwargs.reasoning_details != null) {
254
+ // For Claude via OpenRouter, convert reasoning_details to content blocks
255
+ const isClaudeModel = model?.includes('claude') === true ||
256
+ model?.includes('anthropic') === true;
257
+ if (options.convertReasoningDetailsToContent === true &&
258
+ isClaudeModel) {
259
+ const reasoningDetails = message.additional_kwargs
260
+ .reasoning_details;
261
+ const contentBlocks = [];
262
+ // Add thinking blocks from reasoning_details
263
+ for (const detail of reasoningDetails) {
264
+ if (detail.type === 'reasoning.text' && detail.text != null) {
265
+ contentBlocks.push({
266
+ type: 'thinking',
267
+ thinking: detail.text,
268
+ });
269
+ }
270
+ else if (detail.type === 'reasoning.encrypted' &&
271
+ detail.data != null) {
272
+ contentBlocks.push({
273
+ type: 'redacted_thinking',
274
+ data: detail.data,
275
+ id: detail.id,
276
+ });
277
+ }
278
+ }
279
+ // Set content to array with thinking blocks
280
+ if (contentBlocks.length > 0) {
281
+ completionParam.content = contentBlocks;
282
+ }
283
+ }
284
+ else {
285
+ // For non-Claude models, pass as separate field
286
+ completionParam.reasoning_details =
287
+ message.additional_kwargs.reasoning_details;
288
+ }
289
+ }
290
+ }
291
+ if (message.tool_call_id != null) {
292
+ completionParam.tool_call_id = message.tool_call_id;
293
+ }
294
+ }
295
+ if (message.additional_kwargs.audio &&
296
+ typeof message.additional_kwargs.audio === 'object' &&
297
+ 'id' in message.additional_kwargs.audio) {
298
+ const audioMessage = {
299
+ role: 'assistant',
300
+ audio: {
301
+ id: message.additional_kwargs.audio.id,
302
+ },
303
+ };
304
+ return [completionParam, audioMessage];
305
+ }
306
+ return completionParam;
307
+ });
308
+ }
309
+ const _FUNCTION_CALL_IDS_MAP_KEY = '__openai_function_call_ids__';
310
+ function _convertReasoningSummaryToOpenAIResponsesParams(reasoning) {
311
+ // combine summary parts that have the the same index and then remove the indexes
312
+ const summary = (reasoning.summary.length > 1
313
+ ? reasoning.summary.reduce((acc, curr) => {
314
+ const last = acc.at(-1);
315
+ if (last.index === curr.index) {
316
+ last.text += curr.text;
317
+ }
318
+ else {
319
+ acc.push(curr);
320
+ }
321
+ return acc;
322
+ }, [{ ...reasoning.summary[0] }])
323
+ : reasoning.summary).map((s) => Object.fromEntries(Object.entries(s).filter(([k]) => k !== 'index')));
324
+ return {
325
+ ...reasoning,
326
+ summary,
327
+ };
328
+ }
329
+ function _convertMessagesToOpenAIResponsesParams(messages, model, zdrEnabled) {
330
+ return messages.flatMap((lcMsg) => {
331
+ const additional_kwargs = lcMsg.additional_kwargs;
332
+ let role = messageToOpenAIRole(lcMsg);
333
+ if (role === 'system' && isReasoningModel(model))
334
+ role = 'developer';
335
+ if (role === 'function') {
336
+ throw new Error('Function messages are not supported in Responses API');
337
+ }
338
+ if (role === 'tool') {
339
+ const toolMessage = lcMsg;
340
+ // Handle computer call output
341
+ if (additional_kwargs.type === 'computer_call_output') {
342
+ const output = (() => {
343
+ if (typeof toolMessage.content === 'string') {
344
+ return {
345
+ type: 'computer_screenshot',
346
+ image_url: toolMessage.content,
347
+ };
348
+ }
349
+ if (Array.isArray(toolMessage.content)) {
350
+ const oaiScreenshot = toolMessage.content.find((i) => i.type === 'computer_screenshot');
351
+ if (oaiScreenshot)
352
+ return oaiScreenshot;
353
+ const lcImage = toolMessage.content.find((i) => i.type === 'image_url');
354
+ if (lcImage) {
355
+ return {
356
+ type: 'computer_screenshot',
357
+ image_url: typeof lcImage.image_url === 'string'
358
+ ? lcImage.image_url
359
+ : lcImage.image_url.url,
360
+ };
361
+ }
362
+ }
363
+ throw new Error('Invalid computer call output');
364
+ })();
365
+ return {
366
+ type: 'computer_call_output',
367
+ output,
368
+ call_id: toolMessage.tool_call_id,
369
+ };
370
+ }
371
+ return {
372
+ type: 'function_call_output',
373
+ call_id: toolMessage.tool_call_id,
374
+ id: toolMessage.id?.startsWith('fc_') ? toolMessage.id : undefined,
375
+ output: typeof toolMessage.content !== 'string'
376
+ ? JSON.stringify(toolMessage.content)
377
+ : toolMessage.content,
378
+ };
379
+ }
380
+ if (role === 'assistant') {
381
+ // if we have the original response items, just reuse them
382
+ if (!zdrEnabled &&
383
+ lcMsg.response_metadata.output != null &&
384
+ Array.isArray(lcMsg.response_metadata.output) &&
385
+ lcMsg.response_metadata.output.length > 0 &&
386
+ lcMsg.response_metadata.output.every((item) => 'type' in item)) {
387
+ return lcMsg.response_metadata.output;
388
+ }
389
+ // otherwise, try to reconstruct the response from what we have
390
+ const input = [];
391
+ // reasoning items
392
+ if (additional_kwargs.reasoning && !zdrEnabled) {
393
+ const reasoningItem = _convertReasoningSummaryToOpenAIResponsesParams(additional_kwargs.reasoning);
394
+ input.push(reasoningItem);
395
+ }
396
+ // ai content
397
+ let { content } = lcMsg;
398
+ if (additional_kwargs.refusal) {
399
+ if (typeof content === 'string') {
400
+ content = [{ type: 'output_text', text: content, annotations: [] }];
401
+ }
402
+ content = [
403
+ ...content,
404
+ { type: 'refusal', refusal: additional_kwargs.refusal },
405
+ ];
406
+ }
407
+ input.push({
408
+ type: 'message',
409
+ role: 'assistant',
410
+ ...(lcMsg.id && !zdrEnabled && lcMsg.id.startsWith('msg_')
411
+ ? { id: lcMsg.id }
412
+ : {}),
413
+ content: typeof content === 'string'
414
+ ? content
415
+ : content.flatMap((item) => {
416
+ if (item.type === 'text') {
417
+ return {
418
+ type: 'output_text',
419
+ text: item.text,
420
+ // @ts-expect-error TODO: add types for `annotations`
421
+ annotations: item.annotations ?? [],
422
+ };
423
+ }
424
+ if (item.type === 'output_text' || item.type === 'refusal') {
425
+ return item;
426
+ }
427
+ return [];
428
+ }),
429
+ });
430
+ const functionCallIds = additional_kwargs[_FUNCTION_CALL_IDS_MAP_KEY];
431
+ if (isAIMessage(lcMsg) && !!lcMsg.tool_calls?.length) {
432
+ input.push(...lcMsg.tool_calls.map((toolCall) => ({
433
+ type: 'function_call',
434
+ name: toolCall.name,
435
+ arguments: JSON.stringify(toolCall.args),
436
+ call_id: toolCall.id,
437
+ ...(zdrEnabled ? { id: functionCallIds?.[toolCall.id] } : {}),
438
+ })));
439
+ }
440
+ else if (additional_kwargs.tool_calls) {
441
+ input.push(...additional_kwargs.tool_calls.map((toolCall) => ({
442
+ type: 'function_call',
443
+ name: toolCall.function.name,
444
+ call_id: toolCall.id,
445
+ arguments: toolCall.function.arguments,
446
+ ...(zdrEnabled ? { id: functionCallIds?.[toolCall.id] } : {}),
447
+ })));
448
+ }
449
+ const toolOutputs = (lcMsg.response_metadata.output?.length ?? 0) > 0
450
+ ? lcMsg.response_metadata.output
451
+ : additional_kwargs.tool_outputs;
452
+ const fallthroughCallTypes = [
453
+ 'computer_call',
454
+ /** @ts-ignore */
455
+ 'mcp_call',
456
+ /** @ts-ignore */
457
+ 'code_interpreter_call',
458
+ /** @ts-ignore */
459
+ 'image_generation_call',
460
+ ];
461
+ if (toolOutputs != null) {
462
+ const castToolOutputs = toolOutputs;
463
+ const fallthroughCalls = castToolOutputs.filter((item) => fallthroughCallTypes.includes(item.type));
464
+ if (fallthroughCalls.length > 0)
465
+ input.push(...fallthroughCalls);
466
+ }
467
+ return input;
468
+ }
469
+ if (role === 'user' || role === 'system' || role === 'developer') {
470
+ if (typeof lcMsg.content === 'string') {
471
+ return { type: 'message', role, content: lcMsg.content };
472
+ }
473
+ const messages = [];
474
+ const content = lcMsg.content.flatMap((item) => {
475
+ if (item.type === 'mcp_approval_response') {
476
+ messages.push({
477
+ // @ts-ignore
478
+ type: 'mcp_approval_response',
479
+ approval_request_id: item.approval_request_id,
480
+ approve: item.approve,
481
+ });
482
+ }
483
+ if (isDataContentBlock(item)) {
484
+ return convertToProviderContentBlock(item, completionsApiContentBlockConverter);
485
+ }
486
+ if (item.type === 'text') {
487
+ return {
488
+ type: 'input_text',
489
+ text: item.text,
490
+ };
491
+ }
492
+ if (item.type === 'image_url') {
493
+ return {
494
+ type: 'input_image',
495
+ image_url: typeof item.image_url === 'string'
496
+ ? item.image_url
497
+ : item.image_url.url,
498
+ detail: typeof item.image_url === 'string'
499
+ ? 'auto'
500
+ : item.image_url.detail,
501
+ };
502
+ }
503
+ if (item.type === 'input_text' ||
504
+ item.type === 'input_image' ||
505
+ item.type === 'input_file') {
506
+ return item;
507
+ }
508
+ return [];
509
+ });
510
+ if (content.length > 0) {
511
+ messages.push({ type: 'message', role, content });
512
+ }
513
+ return messages;
514
+ }
515
+ console.warn(`Unsupported role found when converting to OpenAI Responses API: ${role}`);
516
+ return [];
517
+ });
518
+ }
519
+ function isReasoningModel(model) {
520
+ return model != null && model !== '' && /\b(o\d|gpt-[5-9])\b/i.test(model);
521
+ }
522
+ function _convertOpenAIResponsesMessageToBaseMessage(response) {
523
+ if (response.error) {
524
+ // TODO: add support for `addLangChainErrorFields`
525
+ const error = new Error(response.error.message);
526
+ error.name = response.error.code;
527
+ throw error;
528
+ }
529
+ let messageId;
530
+ const content = [];
531
+ const tool_calls = [];
532
+ const invalid_tool_calls = [];
533
+ const response_metadata = {
534
+ model: response.model,
535
+ created_at: response.created_at,
536
+ id: response.id,
537
+ incomplete_details: response.incomplete_details,
538
+ metadata: response.metadata,
539
+ object: response.object,
540
+ status: response.status,
541
+ user: response.user,
542
+ service_tier: response.service_tier,
543
+ // for compatibility with chat completion calls.
544
+ model_name: response.model,
545
+ };
546
+ const additional_kwargs = {};
547
+ for (const item of response.output) {
548
+ if (item.type === 'message') {
549
+ messageId = item.id;
550
+ content.push(...item.content.flatMap((part) => {
551
+ if (part.type === 'output_text') {
552
+ if ('parsed' in part && part.parsed != null) {
553
+ additional_kwargs.parsed = part.parsed;
554
+ }
555
+ return {
556
+ type: 'text',
557
+ text: part.text,
558
+ annotations: part.annotations,
559
+ };
560
+ }
561
+ if (part.type === 'refusal') {
562
+ additional_kwargs.refusal = part.refusal;
563
+ return [];
564
+ }
565
+ return part;
566
+ }));
567
+ }
568
+ else if (item.type === 'function_call') {
569
+ const fnAdapter = {
570
+ function: { name: item.name, arguments: item.arguments },
571
+ id: item.call_id,
572
+ };
573
+ try {
574
+ tool_calls.push(parseToolCall(fnAdapter, { returnId: true }));
575
+ }
576
+ catch (e) {
577
+ let errMessage;
578
+ if (typeof e === 'object' &&
579
+ e != null &&
580
+ 'message' in e &&
581
+ typeof e.message === 'string') {
582
+ errMessage = e.message;
583
+ }
584
+ invalid_tool_calls.push(makeInvalidToolCall(fnAdapter, errMessage));
585
+ }
586
+ additional_kwargs[_FUNCTION_CALL_IDS_MAP_KEY] ??= {};
587
+ if (item.id) {
588
+ additional_kwargs[_FUNCTION_CALL_IDS_MAP_KEY][item.call_id] = item.id;
589
+ }
590
+ }
591
+ else if (item.type === 'reasoning') {
592
+ additional_kwargs.reasoning = item;
593
+ }
594
+ else {
595
+ additional_kwargs.tool_outputs ??= [];
596
+ additional_kwargs.tool_outputs.push(item);
597
+ }
598
+ }
599
+ return new AIMessage({
600
+ id: messageId,
601
+ content,
602
+ tool_calls,
603
+ invalid_tool_calls,
604
+ usage_metadata: response.usage,
605
+ additional_kwargs,
606
+ response_metadata,
607
+ });
608
+ }
609
+ function _convertOpenAIResponsesDeltaToBaseMessageChunk(chunk) {
610
+ const content = [];
611
+ let generationInfo = {};
612
+ let usage_metadata;
613
+ const tool_call_chunks = [];
614
+ const response_metadata = {};
615
+ const additional_kwargs = {};
616
+ let id;
617
+ if (chunk.type === 'response.output_text.delta') {
618
+ content.push({
619
+ type: 'text',
620
+ text: chunk.delta,
621
+ index: chunk.content_index,
622
+ });
623
+ /** @ts-ignore */
624
+ }
625
+ else if (chunk.type === 'response.output_text_annotation.added') {
626
+ content.push({
627
+ type: 'text',
628
+ text: '',
629
+ /** @ts-ignore */
630
+ annotations: [chunk.annotation],
631
+ /** @ts-ignore */
632
+ index: chunk.content_index,
633
+ });
634
+ }
635
+ else if (chunk.type === 'response.output_item.added' &&
636
+ chunk.item.type === 'message') {
637
+ id = chunk.item.id;
638
+ }
639
+ else if (chunk.type === 'response.output_item.added' &&
640
+ chunk.item.type === 'function_call') {
641
+ tool_call_chunks.push({
642
+ type: 'tool_call_chunk',
643
+ name: chunk.item.name,
644
+ args: chunk.item.arguments,
645
+ id: chunk.item.call_id,
646
+ index: chunk.output_index,
647
+ });
648
+ additional_kwargs[_FUNCTION_CALL_IDS_MAP_KEY] = {
649
+ [chunk.item.call_id]: chunk.item.id,
650
+ };
651
+ }
652
+ else if (chunk.type === 'response.output_item.done' &&
653
+ [
654
+ 'web_search_call',
655
+ 'file_search_call',
656
+ 'computer_call',
657
+ 'code_interpreter_call',
658
+ 'mcp_call',
659
+ 'mcp_list_tools',
660
+ 'mcp_approval_request',
661
+ 'image_generation_call',
662
+ ].includes(chunk.item.type)) {
663
+ additional_kwargs.tool_outputs = [chunk.item];
664
+ }
665
+ else if (chunk.type === 'response.created') {
666
+ response_metadata.id = chunk.response.id;
667
+ response_metadata.model_name = chunk.response.model;
668
+ response_metadata.model = chunk.response.model;
669
+ }
670
+ else if (chunk.type === 'response.completed') {
671
+ const msg = _convertOpenAIResponsesMessageToBaseMessage(chunk.response);
672
+ usage_metadata = chunk.response.usage;
673
+ if (chunk.response.text?.format?.type === 'json_schema') {
674
+ additional_kwargs.parsed ??= JSON.parse(msg.text);
675
+ }
676
+ for (const [key, value] of Object.entries(chunk.response)) {
677
+ if (key !== 'id')
678
+ response_metadata[key] = value;
679
+ }
680
+ }
681
+ else if (chunk.type === 'response.function_call_arguments.delta') {
682
+ tool_call_chunks.push({
683
+ type: 'tool_call_chunk',
684
+ args: chunk.delta,
685
+ index: chunk.output_index,
686
+ });
687
+ }
688
+ else if (chunk.type === 'response.web_search_call.completed' ||
689
+ chunk.type === 'response.file_search_call.completed') {
690
+ generationInfo = {
691
+ tool_outputs: {
692
+ id: chunk.item_id,
693
+ type: chunk.type.replace('response.', '').replace('.completed', ''),
694
+ status: 'completed',
695
+ },
696
+ };
697
+ }
698
+ else if (chunk.type === 'response.refusal.done') {
699
+ additional_kwargs.refusal = chunk.refusal;
700
+ }
701
+ else if (chunk.type === 'response.output_item.added' &&
702
+ 'item' in chunk &&
703
+ chunk.item.type === 'reasoning') {
704
+ const summary = chunk
705
+ .item.summary
706
+ ? chunk.item.summary.map((s, index) => ({
707
+ ...s,
708
+ index,
709
+ }))
710
+ : undefined;
711
+ additional_kwargs.reasoning = {
712
+ // We only capture ID in the first chunk or else the concatenated result of all chunks will
713
+ // have an ID field that is repeated once per chunk. There is special handling for the `type`
714
+ // field that prevents this, however.
715
+ id: chunk.item.id,
716
+ type: chunk.item.type,
717
+ ...(summary ? { summary } : {}),
718
+ };
719
+ }
720
+ else if (chunk.type === 'response.reasoning_summary_part.added') {
721
+ additional_kwargs.reasoning = {
722
+ type: 'reasoning',
723
+ summary: [{ ...chunk.part, index: chunk.summary_index }],
724
+ };
725
+ }
726
+ else if (chunk.type === 'response.reasoning_summary_text.delta') {
727
+ additional_kwargs.reasoning = {
728
+ type: 'reasoning',
729
+ summary: [
730
+ { text: chunk.delta, type: 'summary_text', index: chunk.summary_index },
731
+ ],
732
+ };
733
+ /** @ts-ignore */
734
+ }
735
+ else if (chunk.type === 'response.image_generation_call.partial_image') {
736
+ // noop/fixme: retaining partial images in a message chunk means that _all_
737
+ // partial images get kept in history, so we don't do anything here.
738
+ return null;
739
+ }
740
+ else {
741
+ return null;
742
+ }
743
+ return new ChatGenerationChunk({
744
+ // Legacy reasons, `onLLMNewToken` should pulls this out
745
+ text: content.map((part) => part.text).join(''),
746
+ message: new AIMessageChunk({
747
+ id,
748
+ content,
749
+ tool_call_chunks,
750
+ usage_metadata,
751
+ additional_kwargs,
752
+ response_metadata,
753
+ }),
754
+ generationInfo,
755
+ });
756
+ }
757
+
758
+ export { _convertMessagesToOpenAIParams, _convertMessagesToOpenAIResponsesParams, _convertOpenAIResponsesDeltaToBaseMessageChunk, isReasoningModel, messageToOpenAIRole };
759
+ //# sourceMappingURL=index.mjs.map