@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,725 @@
1
+ import { ContentTypes } from '@/common';
2
+ import { labelContentByAgent } from './format';
3
+ /**
4
+ * Type guard to check if content is ToolCallContent
5
+ */
6
+ function isToolCallContent(content) {
7
+ return content.type === ContentTypes.TOOL_CALL && 'tool_call' in content;
8
+ }
9
+ /**
10
+ * Type guard to check if content has text property
11
+ */
12
+ function hasTextProperty(content) {
13
+ return 'text' in content;
14
+ }
15
+ describe('labelContentByAgent', () => {
16
+ describe('Basic functionality', () => {
17
+ it('should return contentParts unchanged when no agentIdMap provided', () => {
18
+ const contentParts = [
19
+ { type: ContentTypes.TEXT, text: 'Hello world' },
20
+ ];
21
+ const result = labelContentByAgent(contentParts, undefined);
22
+ expect(result).toEqual(contentParts);
23
+ expect(result.length).toBe(1);
24
+ });
25
+ it('should return contentParts unchanged when agentIdMap is empty', () => {
26
+ const contentParts = [
27
+ { type: ContentTypes.TEXT, text: 'Hello world' },
28
+ ];
29
+ const result = labelContentByAgent(contentParts, {});
30
+ expect(result).toEqual(contentParts);
31
+ expect(result.length).toBe(1);
32
+ });
33
+ it('should handle empty contentParts array', () => {
34
+ const contentParts = [];
35
+ const agentIdMap = {};
36
+ const result = labelContentByAgent(contentParts, agentIdMap);
37
+ expect(result).toEqual([]);
38
+ });
39
+ });
40
+ describe('Transfer-based labeling (default)', () => {
41
+ it('should consolidate transferred agent content into transfer tool output', () => {
42
+ const contentParts = [
43
+ { type: ContentTypes.TEXT, text: '' },
44
+ {
45
+ type: ContentTypes.TOOL_CALL,
46
+ tool_call: {
47
+ id: 'call_123',
48
+ name: 'lc_transfer_to_specialist',
49
+ args: '',
50
+ },
51
+ },
52
+ { type: ContentTypes.TEXT, text: 'Specialist response here' },
53
+ ];
54
+ const agentIdMap = {
55
+ 0: 'supervisor',
56
+ 1: 'supervisor',
57
+ 2: 'specialist',
58
+ };
59
+ const agentNames = {
60
+ supervisor: 'Supervisor',
61
+ specialist: 'Specialist Agent',
62
+ };
63
+ const result = labelContentByAgent(contentParts, agentIdMap, agentNames);
64
+ // Should have 2 items: empty text + modified transfer tool call
65
+ expect(result.length).toBe(2);
66
+ expect(result[0].type).toBe(ContentTypes.TEXT);
67
+ // The transfer tool call should have consolidated output
68
+ expect(result[1].type).toBe(ContentTypes.TOOL_CALL);
69
+ const toolCallContent = result[1];
70
+ expect(toolCallContent.tool_call?.output).toContain('--- Transfer to Specialist Agent ---');
71
+ expect(toolCallContent.tool_call?.output).toContain('"type":"text"');
72
+ expect(toolCallContent.tool_call?.output).toContain('"text":"Specialist response here"');
73
+ expect(toolCallContent.tool_call?.output).toContain('--- End of Specialist Agent response ---');
74
+ });
75
+ it('should handle multiple content types from transferred agent', () => {
76
+ const contentParts = [
77
+ {
78
+ type: ContentTypes.TOOL_CALL,
79
+ tool_call: {
80
+ id: 'transfer_1',
81
+ name: 'lc_transfer_to_analyst',
82
+ args: '',
83
+ },
84
+ },
85
+ { type: ContentTypes.THINK, think: 'Analyzing the problem...' },
86
+ { type: ContentTypes.TEXT, text: 'Here is my analysis' },
87
+ {
88
+ type: ContentTypes.TOOL_CALL,
89
+ tool_call: {
90
+ id: 'tool_1',
91
+ name: 'search',
92
+ args: '{"query":"test"}',
93
+ },
94
+ },
95
+ ];
96
+ const agentIdMap = {
97
+ 0: 'supervisor',
98
+ 1: 'analyst',
99
+ 2: 'analyst',
100
+ 3: 'analyst',
101
+ };
102
+ const result = labelContentByAgent(contentParts, agentIdMap);
103
+ expect(result.length).toBe(1);
104
+ expect(isToolCallContent(result[0])).toBe(true);
105
+ if (isToolCallContent(result[0])) {
106
+ expect(result[0].tool_call?.output).toContain('"type":"think"');
107
+ expect(result[0].tool_call?.output).toContain('"type":"text"');
108
+ expect(result[0].tool_call?.output).toContain('"type":"tool_call"');
109
+ expect(result[0].tool_call?.output).toContain('Analyzing the problem...');
110
+ expect(result[0].tool_call?.output).toContain('Here is my analysis');
111
+ }
112
+ });
113
+ it('should use agentId when agentNames not provided', () => {
114
+ const contentParts = [
115
+ {
116
+ type: ContentTypes.TOOL_CALL,
117
+ tool_call: {
118
+ id: 'call_1',
119
+ name: 'lc_transfer_to_agent2',
120
+ args: '',
121
+ },
122
+ },
123
+ { type: ContentTypes.TEXT, text: 'Response from agent2' },
124
+ ];
125
+ const agentIdMap = {
126
+ 0: 'agent1',
127
+ 1: 'agent2',
128
+ };
129
+ const result = labelContentByAgent(contentParts, agentIdMap);
130
+ expect(isToolCallContent(result[0])).toBe(true);
131
+ if (isToolCallContent(result[0])) {
132
+ expect(result[0].tool_call?.output).toContain('--- Transfer to agent2 ---');
133
+ expect(result[0].tool_call?.output).toContain('agent2:');
134
+ }
135
+ });
136
+ it('should handle sequential transfers (agent1 -> agent2 -> agent3)', () => {
137
+ const contentParts = [
138
+ { type: ContentTypes.TEXT, text: 'Starting' },
139
+ {
140
+ type: ContentTypes.TOOL_CALL,
141
+ tool_call: {
142
+ id: 'transfer_1',
143
+ name: 'lc_transfer_to_agent2',
144
+ args: '',
145
+ },
146
+ },
147
+ { type: ContentTypes.TEXT, text: 'Agent2 response' },
148
+ {
149
+ type: ContentTypes.TOOL_CALL,
150
+ tool_call: {
151
+ id: 'transfer_2',
152
+ name: 'lc_transfer_to_agent3',
153
+ args: '',
154
+ },
155
+ },
156
+ { type: ContentTypes.TEXT, text: 'Agent3 final response' },
157
+ ];
158
+ const agentIdMap = {
159
+ 0: 'agent1',
160
+ 1: 'agent1',
161
+ 2: 'agent2',
162
+ 3: 'agent2',
163
+ 4: 'agent3',
164
+ };
165
+ const result = labelContentByAgent(contentParts, agentIdMap);
166
+ expect(result.length).toBe(3);
167
+ expect(result[0].type).toBe(ContentTypes.TEXT);
168
+ expect(result[1].type).toBe(ContentTypes.TOOL_CALL);
169
+ expect(result[2].type).toBe(ContentTypes.TOOL_CALL);
170
+ // First transfer should have agent2 content
171
+ if (isToolCallContent(result[1])) {
172
+ expect(result[1].tool_call?.output).toContain('agent2');
173
+ expect(result[1].tool_call?.output).toContain('Agent2 response');
174
+ }
175
+ // Second transfer should have agent3 content
176
+ if (isToolCallContent(result[2])) {
177
+ expect(result[2].tool_call?.output).toContain('agent3');
178
+ expect(result[2].tool_call?.output).toContain('Agent3 final response');
179
+ }
180
+ });
181
+ });
182
+ describe('Full agent labeling (labelNonTransferContent: true)', () => {
183
+ it('should label all agent content when labelNonTransferContent is true', () => {
184
+ const contentParts = [
185
+ { type: ContentTypes.TEXT, text: 'Researcher coordinating' },
186
+ { type: ContentTypes.TEXT, text: 'FINANCIAL ANALYSIS: Revenue impact' },
187
+ {
188
+ type: ContentTypes.TEXT,
189
+ text: 'TECHNICAL ANALYSIS: System requirements',
190
+ },
191
+ { type: ContentTypes.TEXT, text: 'Summary of all analyses' },
192
+ ];
193
+ const agentIdMap = {
194
+ 0: 'researcher',
195
+ 1: 'analyst1',
196
+ 2: 'analyst2',
197
+ 3: 'summarizer',
198
+ };
199
+ const agentNames = {
200
+ researcher: 'Research Coordinator',
201
+ analyst1: 'Financial Analyst',
202
+ analyst2: 'Technical Analyst',
203
+ summarizer: 'Synthesis Expert',
204
+ };
205
+ const result = labelContentByAgent(contentParts, agentIdMap, agentNames, {
206
+ labelNonTransferContent: true,
207
+ });
208
+ // Should create 4 labeled groups
209
+ expect(result.length).toBe(4);
210
+ // Each should be a text content part with agent labels
211
+ expect(result[0].type).toBe(ContentTypes.TEXT);
212
+ if (hasTextProperty(result[0])) {
213
+ expect(result[0].text).toContain('--- Research Coordinator ---');
214
+ expect(result[0].text).toContain('Research Coordinator: Researcher coordinating');
215
+ expect(result[0].text).toContain('--- End of Research Coordinator ---');
216
+ }
217
+ expect(result[1].type).toBe(ContentTypes.TEXT);
218
+ if (hasTextProperty(result[1])) {
219
+ expect(result[1].text).toContain('--- Financial Analyst ---');
220
+ expect(result[1].text).toContain('Financial Analyst: FINANCIAL ANALYSIS: Revenue impact');
221
+ }
222
+ expect(result[2].type).toBe(ContentTypes.TEXT);
223
+ if (hasTextProperty(result[2])) {
224
+ expect(result[2].text).toContain('--- Technical Analyst ---');
225
+ expect(result[2].text).toContain('Technical Analyst: TECHNICAL ANALYSIS: System requirements');
226
+ }
227
+ expect(result[3].type).toBe(ContentTypes.TEXT);
228
+ if (hasTextProperty(result[3])) {
229
+ expect(result[3].text).toContain('--- Synthesis Expert ---');
230
+ expect(result[3].text).toContain('Synthesis Expert: Summary of all analyses');
231
+ }
232
+ });
233
+ it('should group consecutive content from same agent', () => {
234
+ const contentParts = [
235
+ { type: ContentTypes.TEXT, text: 'First message' },
236
+ { type: ContentTypes.TEXT, text: 'Second message' },
237
+ { type: ContentTypes.TEXT, text: 'Third message' },
238
+ { type: ContentTypes.TEXT, text: 'Different agent' },
239
+ ];
240
+ const agentIdMap = {
241
+ 0: 'agent1',
242
+ 1: 'agent1',
243
+ 2: 'agent1',
244
+ 3: 'agent2',
245
+ };
246
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
247
+ labelNonTransferContent: true,
248
+ });
249
+ // Should create 2 groups
250
+ expect(result.length).toBe(2);
251
+ // First group has all 3 messages from agent1
252
+ if (hasTextProperty(result[0])) {
253
+ expect(result[0].text).toContain('agent1: First message');
254
+ expect(result[0].text).toContain('agent1: Second message');
255
+ expect(result[0].text).toContain('agent1: Third message');
256
+ }
257
+ // Second group has agent2 message
258
+ if (hasTextProperty(result[1])) {
259
+ expect(result[1].text).toContain('agent2: Different agent');
260
+ }
261
+ });
262
+ it('should handle thinking content in parallel labeling', () => {
263
+ const contentParts = [
264
+ { type: ContentTypes.THINK, think: 'Let me analyze this...' },
265
+ { type: ContentTypes.TEXT, text: 'My conclusion' },
266
+ ];
267
+ const agentIdMap = {
268
+ 0: 'analyst',
269
+ 1: 'analyst',
270
+ };
271
+ const agentNames = {
272
+ analyst: 'Expert Analyst',
273
+ };
274
+ const result = labelContentByAgent(contentParts, agentIdMap, agentNames, {
275
+ labelNonTransferContent: true,
276
+ });
277
+ expect(result.length).toBe(1);
278
+ if (hasTextProperty(result[0])) {
279
+ expect(result[0].text).toContain('--- Expert Analyst ---');
280
+ expect(result[0].text).toContain('"type":"think"');
281
+ expect(result[0].text).toContain('Let me analyze this...');
282
+ expect(result[0].text).toContain('Expert Analyst: My conclusion');
283
+ }
284
+ });
285
+ it('should skip empty text content in parallel labeling', () => {
286
+ const contentParts = [
287
+ { type: ContentTypes.TEXT, text: '' },
288
+ { type: ContentTypes.TEXT, text: 'Valid content' },
289
+ ];
290
+ const agentIdMap = {
291
+ 0: 'agent1',
292
+ 1: 'agent1',
293
+ };
294
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
295
+ labelNonTransferContent: true,
296
+ });
297
+ expect(result.length).toBe(1);
298
+ // Should only contain the valid content, not the empty string
299
+ if (hasTextProperty(result[0])) {
300
+ expect(result[0].text).toContain('agent1: Valid content');
301
+ expect(result[0].text).not.toContain('agent1: \n');
302
+ }
303
+ });
304
+ });
305
+ describe('Edge cases', () => {
306
+ it('should handle content parts without agentId in map', () => {
307
+ const contentParts = [
308
+ { type: ContentTypes.TEXT, text: 'Message 1' },
309
+ { type: ContentTypes.TEXT, text: 'Message 2' },
310
+ { type: ContentTypes.TEXT, text: 'Message 3' },
311
+ ];
312
+ const agentIdMap = {
313
+ 0: 'agent1',
314
+ // Missing index 1
315
+ 2: 'agent2',
316
+ };
317
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
318
+ labelNonTransferContent: true,
319
+ });
320
+ // Should still process and group by available agent IDs
321
+ expect(result.length).toBeGreaterThan(0);
322
+ });
323
+ it('should handle transfer tool without subsequent agent content', () => {
324
+ const contentParts = [
325
+ {
326
+ type: ContentTypes.TOOL_CALL,
327
+ tool_call: {
328
+ id: 'transfer_1',
329
+ name: 'lc_transfer_to_specialist',
330
+ args: '',
331
+ },
332
+ },
333
+ ];
334
+ const agentIdMap = {
335
+ 0: 'supervisor',
336
+ };
337
+ const result = labelContentByAgent(contentParts, agentIdMap);
338
+ // Transfer tool should still be present, just without added content
339
+ expect(result.length).toBe(1);
340
+ expect(result[0].type).toBe(ContentTypes.TOOL_CALL);
341
+ });
342
+ it('should handle multiple transfers in sequence', () => {
343
+ const contentParts = [
344
+ {
345
+ type: ContentTypes.TOOL_CALL,
346
+ tool_call: {
347
+ id: 'transfer_1',
348
+ name: 'lc_transfer_to_agent_a',
349
+ args: '',
350
+ },
351
+ },
352
+ { type: ContentTypes.TEXT, text: 'Agent A response' },
353
+ {
354
+ type: ContentTypes.TOOL_CALL,
355
+ tool_call: {
356
+ id: 'transfer_2',
357
+ name: 'lc_transfer_to_agent_b',
358
+ args: '',
359
+ },
360
+ },
361
+ { type: ContentTypes.TEXT, text: 'Agent B response' },
362
+ ];
363
+ const agentIdMap = {
364
+ 0: 'supervisor',
365
+ 1: 'agent_a',
366
+ 2: 'agent_a',
367
+ 3: 'agent_b',
368
+ };
369
+ const result = labelContentByAgent(contentParts, agentIdMap);
370
+ expect(result.length).toBe(2);
371
+ // Both transfers should have consolidated outputs
372
+ if (isToolCallContent(result[0])) {
373
+ expect(result[0].tool_call?.output).toContain('agent_a');
374
+ expect(result[0].tool_call?.output).toContain('Agent A response');
375
+ }
376
+ if (isToolCallContent(result[1])) {
377
+ expect(result[1].tool_call?.output).toContain('agent_b');
378
+ expect(result[1].tool_call?.output).toContain('Agent B response');
379
+ }
380
+ });
381
+ it('should preserve non-transfer tool calls unchanged', () => {
382
+ const contentParts = [
383
+ { type: ContentTypes.TEXT, text: 'Using a tool' },
384
+ {
385
+ type: ContentTypes.TOOL_CALL,
386
+ tool_call: {
387
+ id: 'tool_1',
388
+ name: 'search',
389
+ args: '{"query":"test"}',
390
+ output: 'Search results',
391
+ },
392
+ },
393
+ { type: ContentTypes.TEXT, text: 'Here are the results' },
394
+ ];
395
+ const agentIdMap = {
396
+ 0: 'agent1',
397
+ 1: 'agent1',
398
+ 2: 'agent1',
399
+ };
400
+ const result = labelContentByAgent(contentParts, agentIdMap);
401
+ // All content from same agent with no transfers, should pass through
402
+ expect(result).toEqual(contentParts);
403
+ });
404
+ });
405
+ describe('Parallel patterns', () => {
406
+ it('should label parallel analyst contributions separately', () => {
407
+ const contentParts = [
408
+ { type: ContentTypes.TEXT, text: 'Coordinating research' },
409
+ { type: ContentTypes.TEXT, text: 'FINANCIAL: Budget analysis' },
410
+ { type: ContentTypes.TEXT, text: 'TECHNICAL: System design' },
411
+ { type: ContentTypes.TEXT, text: 'MARKET: Competitive landscape' },
412
+ { type: ContentTypes.TEXT, text: 'Integrated summary' },
413
+ ];
414
+ const agentIdMap = {
415
+ 0: 'researcher',
416
+ 1: 'financial_analyst',
417
+ 2: 'technical_analyst',
418
+ 3: 'market_analyst',
419
+ 4: 'summarizer',
420
+ };
421
+ const agentNames = {
422
+ researcher: 'Research Coordinator',
423
+ financial_analyst: 'Financial Analyst',
424
+ technical_analyst: 'Technical Analyst',
425
+ market_analyst: 'Market Analyst',
426
+ summarizer: 'Synthesis Expert',
427
+ };
428
+ const result = labelContentByAgent(contentParts, agentIdMap, agentNames, {
429
+ labelNonTransferContent: true,
430
+ });
431
+ // Should have 5 labeled groups (one per agent)
432
+ expect(result.length).toBe(5);
433
+ // Verify each group
434
+ if (hasTextProperty(result[0])) {
435
+ expect(result[0].text).toContain('--- Research Coordinator ---');
436
+ expect(result[0].text).toContain('Coordinating research');
437
+ }
438
+ if (hasTextProperty(result[1])) {
439
+ expect(result[1].text).toContain('--- Financial Analyst ---');
440
+ expect(result[1].text).toContain('FINANCIAL: Budget analysis');
441
+ }
442
+ if (hasTextProperty(result[2])) {
443
+ expect(result[2].text).toContain('--- Technical Analyst ---');
444
+ expect(result[2].text).toContain('TECHNICAL: System design');
445
+ }
446
+ if (hasTextProperty(result[3])) {
447
+ expect(result[3].text).toContain('--- Market Analyst ---');
448
+ expect(result[3].text).toContain('MARKET: Competitive landscape');
449
+ }
450
+ if (hasTextProperty(result[4])) {
451
+ expect(result[4].text).toContain('--- Synthesis Expert ---');
452
+ expect(result[4].text).toContain('Integrated summary');
453
+ }
454
+ });
455
+ it('should handle agent alternation in parallel mode', () => {
456
+ const contentParts = [
457
+ { type: ContentTypes.TEXT, text: 'A1' },
458
+ { type: ContentTypes.TEXT, text: 'B1' },
459
+ { type: ContentTypes.TEXT, text: 'A2' },
460
+ { type: ContentTypes.TEXT, text: 'B2' },
461
+ ];
462
+ const agentIdMap = {
463
+ 0: 'agentA',
464
+ 1: 'agentB',
465
+ 2: 'agentA',
466
+ 3: 'agentB',
467
+ };
468
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
469
+ labelNonTransferContent: true,
470
+ });
471
+ // Should create 4 groups (alternating agents)
472
+ expect(result.length).toBe(4);
473
+ if (hasTextProperty(result[0]))
474
+ expect(result[0].text).toContain('agentA: A1');
475
+ if (hasTextProperty(result[1]))
476
+ expect(result[1].text).toContain('agentB: B1');
477
+ if (hasTextProperty(result[2]))
478
+ expect(result[2].text).toContain('agentA: A2');
479
+ if (hasTextProperty(result[3]))
480
+ expect(result[3].text).toContain('agentB: B2');
481
+ });
482
+ it('should handle tool calls in parallel labeling', () => {
483
+ const contentParts = [
484
+ { type: ContentTypes.TEXT, text: 'Analyzing' },
485
+ {
486
+ type: ContentTypes.TOOL_CALL,
487
+ tool_call: {
488
+ id: 'tool_1',
489
+ name: 'search',
490
+ args: '{"query":"data"}',
491
+ },
492
+ },
493
+ { type: ContentTypes.TEXT, text: 'Results analyzed' },
494
+ ];
495
+ const agentIdMap = {
496
+ 0: 'analyst',
497
+ 1: 'analyst',
498
+ 2: 'analyst',
499
+ };
500
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
501
+ labelNonTransferContent: true,
502
+ });
503
+ expect(result.length).toBe(1);
504
+ if (hasTextProperty(result[0])) {
505
+ expect(result[0].text).toContain('--- analyst ---');
506
+ expect(result[0].text).toContain('analyst: Analyzing');
507
+ expect(result[0].text).toContain('"type":"tool_call"');
508
+ expect(result[0].text).toContain('"name":"search"');
509
+ expect(result[0].text).toContain('analyst: Results analyzed');
510
+ }
511
+ });
512
+ });
513
+ describe('Mixed patterns', () => {
514
+ it('should handle content with no transfer but mixed agents (without option)', () => {
515
+ const contentParts = [
516
+ { type: ContentTypes.TEXT, text: 'Agent 1 says this' },
517
+ { type: ContentTypes.TEXT, text: 'Agent 2 says this' },
518
+ ];
519
+ const agentIdMap = {
520
+ 0: 'agent1',
521
+ 1: 'agent2',
522
+ };
523
+ // Default mode (transfer-based) should pass through non-transfer content
524
+ const result = labelContentByAgent(contentParts, agentIdMap);
525
+ expect(result).toEqual(contentParts);
526
+ });
527
+ it('should handle hybrid: transfer followed by non-transfer agents', () => {
528
+ const contentParts = [
529
+ {
530
+ type: ContentTypes.TOOL_CALL,
531
+ tool_call: {
532
+ id: 'transfer_1',
533
+ name: 'lc_transfer_to_specialist',
534
+ args: '',
535
+ },
536
+ },
537
+ { type: ContentTypes.TEXT, text: 'Specialist work' },
538
+ { type: ContentTypes.TEXT, text: 'Another agent response' },
539
+ ];
540
+ const agentIdMap = {
541
+ 0: 'supervisor',
542
+ 1: 'specialist',
543
+ 2: 'agent3',
544
+ };
545
+ const result = labelContentByAgent(contentParts, agentIdMap);
546
+ expect(result.length).toBe(2);
547
+ // Transfer tool should have specialist content
548
+ if (isToolCallContent(result[0])) {
549
+ expect(result[0].tool_call?.output).toContain('specialist');
550
+ expect(result[0].tool_call?.output).toContain('Specialist work');
551
+ }
552
+ // Non-transfer content should pass through
553
+ expect(result[1]).toEqual(contentParts[2]);
554
+ });
555
+ });
556
+ describe('Real-world scenarios', () => {
557
+ it('should handle supervisor -> legal_advisor handoff pattern', () => {
558
+ const contentParts = [
559
+ { type: ContentTypes.TEXT, text: '' },
560
+ {
561
+ type: ContentTypes.TOOL_CALL,
562
+ tool_call: {
563
+ id: 'call_legal',
564
+ name: 'lc_transfer_to_legal_advisor',
565
+ args: '',
566
+ },
567
+ },
568
+ {
569
+ type: ContentTypes.TEXT,
570
+ text: 'GPL licensing creates obligations...',
571
+ },
572
+ ];
573
+ const agentIdMap = {
574
+ 0: 'supervisor',
575
+ 1: 'supervisor',
576
+ 2: 'legal_advisor',
577
+ };
578
+ const agentNames = {
579
+ supervisor: 'Supervisor',
580
+ legal_advisor: 'Legal Advisor',
581
+ };
582
+ const result = labelContentByAgent(contentParts, agentIdMap, agentNames);
583
+ expect(result.length).toBe(2);
584
+ if (isToolCallContent(result[1])) {
585
+ expect(result[1].tool_call?.output).toContain('--- Transfer to Legal Advisor ---');
586
+ expect(result[1].tool_call?.output).toContain('"type":"text"');
587
+ expect(result[1].tool_call?.output).toContain('"text":"GPL licensing creates obligations..."');
588
+ expect(result[1].tool_call?.output).toContain('--- End of Legal Advisor response ---');
589
+ }
590
+ });
591
+ it('should handle fan-out to 3 analysts then fan-in to summarizer', () => {
592
+ const contentParts = [
593
+ { type: ContentTypes.TEXT, text: 'Coordination brief' },
594
+ { type: ContentTypes.TEXT, text: 'Financial analysis content' },
595
+ { type: ContentTypes.TEXT, text: 'Technical analysis content' },
596
+ { type: ContentTypes.TEXT, text: 'Market analysis content' },
597
+ { type: ContentTypes.TEXT, text: 'Executive summary' },
598
+ ];
599
+ const agentIdMap = {
600
+ 0: 'researcher',
601
+ 1: 'analyst1',
602
+ 2: 'analyst2',
603
+ 3: 'analyst3',
604
+ 4: 'summarizer',
605
+ };
606
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
607
+ labelNonTransferContent: true,
608
+ });
609
+ expect(result.length).toBe(5);
610
+ // Each analyst's work should be clearly separated
611
+ if (hasTextProperty(result[0]))
612
+ expect(result[0].text).toContain('researcher:');
613
+ if (hasTextProperty(result[1]))
614
+ expect(result[1].text).toContain('analyst1:');
615
+ if (hasTextProperty(result[2]))
616
+ expect(result[2].text).toContain('analyst2:');
617
+ if (hasTextProperty(result[3]))
618
+ expect(result[3].text).toContain('analyst3:');
619
+ if (hasTextProperty(result[4]))
620
+ expect(result[4].text).toContain('summarizer:');
621
+ });
622
+ });
623
+ describe('Performance and edge cases', () => {
624
+ it('should handle large number of content parts efficiently', () => {
625
+ const contentParts = [];
626
+ const agentIdMap = {};
627
+ // Create 100 content parts from 10 different agents
628
+ for (let i = 0; i < 100; i++) {
629
+ contentParts.push({
630
+ type: ContentTypes.TEXT,
631
+ text: `Message ${i}`,
632
+ });
633
+ agentIdMap[i] = `agent${i % 10}`;
634
+ }
635
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
636
+ labelNonTransferContent: true,
637
+ });
638
+ // Should complete without errors
639
+ expect(result.length).toBeGreaterThan(0);
640
+ expect(result.length).toBeLessThanOrEqual(100);
641
+ });
642
+ it('should handle all content from single agent', () => {
643
+ const contentParts = [
644
+ { type: ContentTypes.TEXT, text: 'Part 1' },
645
+ { type: ContentTypes.TEXT, text: 'Part 2' },
646
+ { type: ContentTypes.TEXT, text: 'Part 3' },
647
+ ];
648
+ const agentIdMap = {
649
+ 0: 'single_agent',
650
+ 1: 'single_agent',
651
+ 2: 'single_agent',
652
+ };
653
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
654
+ labelNonTransferContent: true,
655
+ });
656
+ // Should create 1 group with all content
657
+ expect(result.length).toBe(1);
658
+ if (hasTextProperty(result[0])) {
659
+ expect(result[0].text).toContain('single_agent: Part 1');
660
+ expect(result[0].text).toContain('single_agent: Part 2');
661
+ expect(result[0].text).toContain('single_agent: Part 3');
662
+ }
663
+ });
664
+ });
665
+ describe('Content type handling', () => {
666
+ it('should properly format thinking content with JSON', () => {
667
+ const contentParts = [
668
+ {
669
+ type: ContentTypes.THINK,
670
+ think: 'I need to consider multiple factors...',
671
+ },
672
+ ];
673
+ const agentIdMap = { 0: 'analyst' };
674
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
675
+ labelNonTransferContent: true,
676
+ });
677
+ if (hasTextProperty(result[0])) {
678
+ const parsed = JSON.parse(result[0].text.split('analyst: ')[1].split('\n')[0]);
679
+ expect(parsed.type).toBe('think');
680
+ expect(parsed.think).toBe('I need to consider multiple factors...');
681
+ }
682
+ });
683
+ it('should properly format tool call content with JSON', () => {
684
+ const contentParts = [
685
+ {
686
+ type: ContentTypes.TOOL_CALL,
687
+ tool_call: {
688
+ id: 'tool_123',
689
+ name: 'calculator',
690
+ args: { expression: '2+2' },
691
+ output: '4',
692
+ },
693
+ },
694
+ ];
695
+ const agentIdMap = { 0: 'agent1' };
696
+ const result = labelContentByAgent(contentParts, agentIdMap, undefined, {
697
+ labelNonTransferContent: true,
698
+ });
699
+ if (hasTextProperty(result[0])) {
700
+ expect(result[0].text).toContain('"type":"tool_call"');
701
+ expect(result[0].text).toContain('"name":"calculator"');
702
+ expect(result[0].text).toContain('"id":"tool_123"');
703
+ }
704
+ });
705
+ });
706
+ describe('Integration scenarios', () => {
707
+ it('should work with formatAgentMessages pipeline', () => {
708
+ const contentParts = [
709
+ { type: ContentTypes.TEXT, text: 'Agent 1 content' },
710
+ { type: ContentTypes.TEXT, text: 'Agent 2 content' },
711
+ ];
712
+ const agentIdMap = {
713
+ 0: 'agent1',
714
+ 1: 'agent2',
715
+ };
716
+ const labeled = labelContentByAgent(contentParts, agentIdMap, undefined, {
717
+ labelNonTransferContent: true,
718
+ });
719
+ // Labeled content should be valid for formatAgentMessages
720
+ expect(labeled.length).toBeGreaterThan(0);
721
+ expect(labeled.every((part) => part.type != null)).toBe(true);
722
+ });
723
+ });
724
+ });
725
+ //# sourceMappingURL=labelContentByAgent.test.js.map