illuma-agents 1.0.2 → 1.0.4

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 (225) hide show
  1. package/LICENSE +25 -21
  2. package/dist/cjs/agents/AgentContext.cjs +222 -0
  3. package/dist/cjs/agents/AgentContext.cjs.map +1 -0
  4. package/dist/cjs/common/enum.cjs +5 -4
  5. package/dist/cjs/common/enum.cjs.map +1 -1
  6. package/dist/cjs/events.cjs +7 -5
  7. package/dist/cjs/events.cjs.map +1 -1
  8. package/dist/cjs/graphs/Graph.cjs +328 -207
  9. package/dist/cjs/graphs/Graph.cjs.map +1 -1
  10. package/dist/cjs/graphs/MultiAgentGraph.cjs +507 -0
  11. package/dist/cjs/graphs/MultiAgentGraph.cjs.map +1 -0
  12. package/dist/cjs/llm/anthropic/index.cjs.map +1 -1
  13. package/dist/cjs/llm/google/index.cjs.map +1 -1
  14. package/dist/cjs/llm/ollama/index.cjs.map +1 -1
  15. package/dist/cjs/llm/openai/index.cjs +35 -0
  16. package/dist/cjs/llm/openai/index.cjs.map +1 -1
  17. package/dist/cjs/llm/openai/utils/index.cjs +3 -1
  18. package/dist/cjs/llm/openai/utils/index.cjs.map +1 -1
  19. package/dist/cjs/llm/openrouter/index.cjs.map +1 -1
  20. package/dist/cjs/llm/providers.cjs +0 -2
  21. package/dist/cjs/llm/providers.cjs.map +1 -1
  22. package/dist/cjs/llm/vertexai/index.cjs.map +1 -1
  23. package/dist/cjs/main.cjs +12 -1
  24. package/dist/cjs/main.cjs.map +1 -1
  25. package/dist/cjs/messages/cache.cjs +123 -0
  26. package/dist/cjs/messages/cache.cjs.map +1 -0
  27. package/dist/cjs/messages/content.cjs +53 -0
  28. package/dist/cjs/messages/content.cjs.map +1 -0
  29. package/dist/cjs/messages/format.cjs +17 -29
  30. package/dist/cjs/messages/format.cjs.map +1 -1
  31. package/dist/cjs/run.cjs +119 -74
  32. package/dist/cjs/run.cjs.map +1 -1
  33. package/dist/cjs/stream.cjs +77 -73
  34. package/dist/cjs/stream.cjs.map +1 -1
  35. package/dist/cjs/tools/Calculator.cjs +45 -0
  36. package/dist/cjs/tools/Calculator.cjs.map +1 -0
  37. package/dist/cjs/tools/CodeExecutor.cjs +22 -22
  38. package/dist/cjs/tools/CodeExecutor.cjs.map +1 -1
  39. package/dist/cjs/tools/ToolNode.cjs +5 -3
  40. package/dist/cjs/tools/ToolNode.cjs.map +1 -1
  41. package/dist/cjs/tools/handlers.cjs +20 -20
  42. package/dist/cjs/tools/handlers.cjs.map +1 -1
  43. package/dist/cjs/utils/events.cjs +31 -0
  44. package/dist/cjs/utils/events.cjs.map +1 -0
  45. package/dist/cjs/utils/handlers.cjs +70 -0
  46. package/dist/cjs/utils/handlers.cjs.map +1 -0
  47. package/dist/cjs/utils/tokens.cjs +54 -7
  48. package/dist/cjs/utils/tokens.cjs.map +1 -1
  49. package/dist/esm/agents/AgentContext.mjs +220 -0
  50. package/dist/esm/agents/AgentContext.mjs.map +1 -0
  51. package/dist/esm/common/enum.mjs +5 -4
  52. package/dist/esm/common/enum.mjs.map +1 -1
  53. package/dist/esm/events.mjs +7 -5
  54. package/dist/esm/events.mjs.map +1 -1
  55. package/dist/esm/graphs/Graph.mjs +330 -209
  56. package/dist/esm/graphs/Graph.mjs.map +1 -1
  57. package/dist/esm/graphs/MultiAgentGraph.mjs +505 -0
  58. package/dist/esm/graphs/MultiAgentGraph.mjs.map +1 -0
  59. package/dist/esm/llm/anthropic/index.mjs.map +1 -1
  60. package/dist/esm/llm/google/index.mjs.map +1 -1
  61. package/dist/esm/llm/ollama/index.mjs.map +1 -1
  62. package/dist/esm/llm/openai/index.mjs +35 -0
  63. package/dist/esm/llm/openai/index.mjs.map +1 -1
  64. package/dist/esm/llm/openai/utils/index.mjs +3 -1
  65. package/dist/esm/llm/openai/utils/index.mjs.map +1 -1
  66. package/dist/esm/llm/openrouter/index.mjs.map +1 -1
  67. package/dist/esm/llm/providers.mjs +0 -2
  68. package/dist/esm/llm/providers.mjs.map +1 -1
  69. package/dist/esm/llm/vertexai/index.mjs.map +1 -1
  70. package/dist/esm/main.mjs +7 -2
  71. package/dist/esm/main.mjs.map +1 -1
  72. package/dist/esm/messages/cache.mjs +120 -0
  73. package/dist/esm/messages/cache.mjs.map +1 -0
  74. package/dist/esm/messages/content.mjs +51 -0
  75. package/dist/esm/messages/content.mjs.map +1 -0
  76. package/dist/esm/messages/format.mjs +18 -29
  77. package/dist/esm/messages/format.mjs.map +1 -1
  78. package/dist/esm/run.mjs +119 -74
  79. package/dist/esm/run.mjs.map +1 -1
  80. package/dist/esm/stream.mjs +77 -73
  81. package/dist/esm/stream.mjs.map +1 -1
  82. package/dist/esm/tools/Calculator.mjs +24 -0
  83. package/dist/esm/tools/Calculator.mjs.map +1 -0
  84. package/dist/esm/tools/CodeExecutor.mjs +22 -22
  85. package/dist/esm/tools/CodeExecutor.mjs.map +1 -1
  86. package/dist/esm/tools/ToolNode.mjs +5 -3
  87. package/dist/esm/tools/ToolNode.mjs.map +1 -1
  88. package/dist/esm/tools/handlers.mjs +20 -20
  89. package/dist/esm/tools/handlers.mjs.map +1 -1
  90. package/dist/esm/utils/events.mjs +29 -0
  91. package/dist/esm/utils/events.mjs.map +1 -0
  92. package/dist/esm/utils/handlers.mjs +68 -0
  93. package/dist/esm/utils/handlers.mjs.map +1 -0
  94. package/dist/esm/utils/tokens.mjs +54 -8
  95. package/dist/esm/utils/tokens.mjs.map +1 -1
  96. package/dist/types/agents/AgentContext.d.ts +94 -0
  97. package/dist/types/common/enum.d.ts +7 -5
  98. package/dist/types/events.d.ts +3 -3
  99. package/dist/types/graphs/Graph.d.ts +60 -66
  100. package/dist/types/graphs/MultiAgentGraph.d.ts +47 -0
  101. package/dist/types/graphs/index.d.ts +1 -0
  102. package/dist/types/index.d.ts +1 -0
  103. package/dist/types/llm/openai/index.d.ts +10 -0
  104. package/dist/types/messages/cache.d.ts +20 -0
  105. package/dist/types/messages/content.d.ts +7 -0
  106. package/dist/types/messages/format.d.ts +1 -7
  107. package/dist/types/messages/index.d.ts +2 -0
  108. package/dist/types/messages/reducer.d.ts +9 -0
  109. package/dist/types/run.d.ts +16 -10
  110. package/dist/types/stream.d.ts +4 -3
  111. package/dist/types/tools/Calculator.d.ts +8 -0
  112. package/dist/types/tools/ToolNode.d.ts +1 -1
  113. package/dist/types/tools/handlers.d.ts +9 -7
  114. package/dist/types/tools/search/tool.d.ts +4 -4
  115. package/dist/types/types/graph.d.ts +124 -11
  116. package/dist/types/types/llm.d.ts +13 -9
  117. package/dist/types/types/messages.d.ts +4 -0
  118. package/dist/types/types/run.d.ts +46 -8
  119. package/dist/types/types/stream.d.ts +3 -2
  120. package/dist/types/utils/events.d.ts +6 -0
  121. package/dist/types/utils/handlers.d.ts +34 -0
  122. package/dist/types/utils/index.d.ts +1 -0
  123. package/dist/types/utils/tokens.d.ts +24 -0
  124. package/package.json +162 -145
  125. package/src/agents/AgentContext.ts +323 -0
  126. package/src/common/enum.ts +177 -176
  127. package/src/events.ts +197 -191
  128. package/src/graphs/Graph.ts +1058 -846
  129. package/src/graphs/MultiAgentGraph.ts +598 -0
  130. package/src/graphs/index.ts +2 -1
  131. package/src/index.ts +25 -24
  132. package/src/llm/anthropic/index.ts +413 -413
  133. package/src/llm/google/index.ts +222 -222
  134. package/src/llm/google/utils/zod_to_genai_parameters.ts +86 -88
  135. package/src/llm/ollama/index.ts +92 -92
  136. package/src/llm/openai/index.ts +894 -853
  137. package/src/llm/openai/utils/index.ts +920 -918
  138. package/src/llm/openrouter/index.ts +60 -60
  139. package/src/llm/providers.ts +55 -57
  140. package/src/llm/vertexai/index.ts +360 -360
  141. package/src/messages/cache.test.ts +461 -0
  142. package/src/messages/cache.ts +151 -0
  143. package/src/messages/content.test.ts +362 -0
  144. package/src/messages/content.ts +63 -0
  145. package/src/messages/format.ts +611 -625
  146. package/src/messages/formatAgentMessages.test.ts +1144 -917
  147. package/src/messages/index.ts +6 -4
  148. package/src/messages/reducer.ts +80 -0
  149. package/src/run.ts +447 -381
  150. package/src/scripts/abort.ts +157 -138
  151. package/src/scripts/ant_web_search.ts +158 -158
  152. package/src/scripts/cli.ts +172 -167
  153. package/src/scripts/cli2.ts +133 -125
  154. package/src/scripts/cli3.ts +184 -178
  155. package/src/scripts/cli4.ts +191 -184
  156. package/src/scripts/cli5.ts +191 -184
  157. package/src/scripts/code_exec.ts +213 -214
  158. package/src/scripts/code_exec_simple.ts +147 -129
  159. package/src/scripts/content.ts +138 -120
  160. package/src/scripts/handoff-test.ts +135 -0
  161. package/src/scripts/multi-agent-chain.ts +278 -0
  162. package/src/scripts/multi-agent-conditional.ts +220 -0
  163. package/src/scripts/multi-agent-document-review-chain.ts +197 -0
  164. package/src/scripts/multi-agent-hybrid-flow.ts +310 -0
  165. package/src/scripts/multi-agent-parallel.ts +343 -0
  166. package/src/scripts/multi-agent-sequence.ts +212 -0
  167. package/src/scripts/multi-agent-supervisor.ts +364 -0
  168. package/src/scripts/multi-agent-test.ts +186 -0
  169. package/src/scripts/search.ts +146 -150
  170. package/src/scripts/simple.ts +225 -225
  171. package/src/scripts/stream.ts +140 -122
  172. package/src/scripts/test-custom-prompt-key.ts +145 -0
  173. package/src/scripts/test-handoff-input.ts +170 -0
  174. package/src/scripts/test-multi-agent-list-handoff.ts +261 -0
  175. package/src/scripts/test-tools-before-handoff.ts +222 -0
  176. package/src/scripts/tools.ts +153 -155
  177. package/src/specs/agent-handoffs.test.ts +889 -0
  178. package/src/specs/anthropic.simple.test.ts +320 -317
  179. package/src/specs/azure.simple.test.ts +325 -316
  180. package/src/specs/openai.simple.test.ts +311 -316
  181. package/src/specs/openrouter.simple.test.ts +107 -0
  182. package/src/specs/prune.test.ts +758 -763
  183. package/src/specs/reasoning.test.ts +201 -165
  184. package/src/specs/thinking-prune.test.ts +769 -703
  185. package/src/specs/token-memoization.test.ts +39 -0
  186. package/src/stream.ts +664 -651
  187. package/src/tools/Calculator.test.ts +278 -0
  188. package/src/tools/Calculator.ts +25 -0
  189. package/src/tools/CodeExecutor.ts +220 -220
  190. package/src/tools/ToolNode.ts +170 -170
  191. package/src/tools/handlers.ts +341 -336
  192. package/src/types/graph.ts +372 -185
  193. package/src/types/llm.ts +141 -140
  194. package/src/types/messages.ts +4 -0
  195. package/src/types/run.ts +128 -89
  196. package/src/types/stream.ts +401 -400
  197. package/src/utils/events.ts +32 -0
  198. package/src/utils/handlers.ts +107 -0
  199. package/src/utils/index.ts +6 -5
  200. package/src/utils/llmConfig.ts +183 -183
  201. package/src/utils/tokens.ts +129 -70
  202. package/dist/types/scripts/abort.d.ts +0 -1
  203. package/dist/types/scripts/ant_web_search.d.ts +0 -1
  204. package/dist/types/scripts/args.d.ts +0 -7
  205. package/dist/types/scripts/caching.d.ts +0 -1
  206. package/dist/types/scripts/cli.d.ts +0 -1
  207. package/dist/types/scripts/cli2.d.ts +0 -1
  208. package/dist/types/scripts/cli3.d.ts +0 -1
  209. package/dist/types/scripts/cli4.d.ts +0 -1
  210. package/dist/types/scripts/cli5.d.ts +0 -1
  211. package/dist/types/scripts/code_exec.d.ts +0 -1
  212. package/dist/types/scripts/code_exec_files.d.ts +0 -1
  213. package/dist/types/scripts/code_exec_simple.d.ts +0 -1
  214. package/dist/types/scripts/content.d.ts +0 -1
  215. package/dist/types/scripts/empty_input.d.ts +0 -1
  216. package/dist/types/scripts/image.d.ts +0 -1
  217. package/dist/types/scripts/memory.d.ts +0 -1
  218. package/dist/types/scripts/search.d.ts +0 -1
  219. package/dist/types/scripts/simple.d.ts +0 -1
  220. package/dist/types/scripts/stream.d.ts +0 -1
  221. package/dist/types/scripts/thinking.d.ts +0 -1
  222. package/dist/types/scripts/tools.d.ts +0 -1
  223. package/dist/types/specs/spec.utils.d.ts +0 -1
  224. package/dist/types/tools/example.d.ts +0 -78
  225. package/src/tools/example.ts +0 -129
@@ -1,165 +1,201 @@
1
- /* eslint-disable no-console */
2
-
3
- // src/scripts/cli.test.ts
4
- import { config } from 'dotenv';
5
- config();
6
- import { HumanMessage, BaseMessage, MessageContentText } from '@langchain/core/messages';
7
- import type { RunnableConfig } from '@langchain/core/runnables';
8
- import type { StandardGraph } from '@/graphs';
9
- import type * as t from '@/types';
10
- import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
11
- import { capitalizeFirstLetter } from './spec.utils';
12
- import { GraphEvents, Providers } from '@/common';
13
- import { getLLMConfig } from '@/utils/llmConfig';
14
- import { getArgs } from '@/scripts/args';
15
- import { Run } from '@/run';
16
-
17
- const reasoningText = `<think>
18
- Okay, the user is Jo from New York. I should start by greeting them by name. Let's keep it friendly and open-ended. Maybe mention the weather in New York to make it personal. Then offer help with something specific like plans or questions. Need to keep it concise and welcoming. Check for any typos. Alright, that should work.
19
- </think>
20
- Hi Jo! 🌆 How's everything in New York today? Whether you need recommendations for the city, help with a task, or just want to chat, I'm here for it. What's on your mind? 😊`;
21
-
22
- const provider = 'Reasoning LLM';
23
- describe(`${capitalizeFirstLetter(provider)} Streaming Tests`, () => {
24
- jest.setTimeout(30000);
25
- let run: Run<t.IState>;
26
- let contentParts: t.MessageContentComplex[];
27
- let conversationHistory: BaseMessage[];
28
- let aggregateContent: t.ContentAggregator;
29
- let runSteps: Set<string>;
30
-
31
- const config: Partial<RunnableConfig> & { version: 'v1' | 'v2'; run_id?: string; streamMode: string } = {
32
- configurable: {
33
- thread_id: 'conversation-num-1',
34
- },
35
- streamMode: 'values',
36
- version: 'v2' as const,
37
- callbacks: [{
38
- async handleCustomEvent(event, data, metadata): Promise<void> {
39
- if (event !== GraphEvents.ON_MESSAGE_DELTA) {
40
- return;
41
- }
42
- const messageDeltaData = data as t.MessageDeltaEvent;
43
-
44
- // Wait until we see the run step (with timeout for safety)
45
- const maxAttempts = 50; // 5 seconds total
46
- let attempts = 0;
47
- while (!runSteps.has(messageDeltaData.id) && attempts < maxAttempts) {
48
- await new Promise(resolve => setTimeout(resolve, 100));
49
- attempts++;
50
- }
51
-
52
- if (!runSteps.has(messageDeltaData.id)) {
53
- console.warn(`Timeout waiting for run step: ${messageDeltaData.id}`);
54
- }
55
-
56
- onMessageDeltaSpy(event, data, metadata, run.Graph);
57
- aggregateContent({ event, data: messageDeltaData });
58
- },
59
- }],
60
- };
61
-
62
- beforeEach(async () => {
63
- conversationHistory = [];
64
- const { contentParts: parts, aggregateContent: ac } = createContentAggregator();
65
- aggregateContent = ac;
66
- runSteps = new Set();
67
- contentParts = parts as t.MessageContentComplex[];
68
- });
69
-
70
- afterEach(() => {
71
- runSteps.clear();
72
- });
73
-
74
- const onReasoningDeltaSpy = jest.fn();
75
- const onMessageDeltaSpy = jest.fn();
76
- const onRunStepSpy = jest.fn();
77
-
78
- afterAll(() => {
79
- onReasoningDeltaSpy.mockReset();
80
- onMessageDeltaSpy.mockReset();
81
- onRunStepSpy.mockReset();
82
- });
83
-
84
- const setupCustomHandlers = (): Record<string | GraphEvents, t.EventHandler> => ({
85
- [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
86
- [GraphEvents.ON_RUN_STEP_COMPLETED]: {
87
- handle: (event: GraphEvents.ON_RUN_STEP_COMPLETED, data: t.StreamEventData): void => {
88
- aggregateContent({ event, data: data as unknown as { result: t.ToolEndEvent; } });
89
- }
90
- },
91
- [GraphEvents.ON_RUN_STEP]: {
92
- handle: (event: GraphEvents.ON_RUN_STEP, data: t.StreamEventData, metadata, graph): void => {
93
- const runStepData = data as t.RunStep;
94
- runSteps.add(runStepData.id);
95
-
96
- onRunStepSpy(event, runStepData, metadata, graph);
97
- aggregateContent({ event, data: runStepData });
98
- }
99
- },
100
- [GraphEvents.ON_RUN_STEP_DELTA]: {
101
- handle: (event: GraphEvents.ON_RUN_STEP_DELTA, data: t.StreamEventData): void => {
102
- aggregateContent({ event, data: data as t.RunStepDeltaEvent });
103
- }
104
- },
105
- [GraphEvents.ON_REASONING_DELTA]: {
106
- handle: (event: GraphEvents.ON_REASONING_DELTA, data: t.StreamEventData, metadata, graph): void => {
107
- onReasoningDeltaSpy(event, data, metadata, graph);
108
- aggregateContent({ event, data: data as t.ReasoningDeltaEvent });
109
- }
110
- },
111
- });
112
-
113
- test(`${capitalizeFirstLetter(provider)}: should process a simple reasoning message`, async () => {
114
- const { userName, location } = await getArgs();
115
- const llmConfig = getLLMConfig(Providers.OPENAI);
116
- const customHandlers = setupCustomHandlers();
117
-
118
- run = await Run.create<t.IState>({
119
- runId: 'test-run-id',
120
- graphConfig: {
121
- type: 'standard',
122
- llmConfig,
123
- instructions: 'You are a friendly AI assistant. Always address the user by their name.',
124
- additional_instructions: `The user's name is ${userName} and they are located in ${location}.`,
125
- },
126
- returnContent: true,
127
- customHandlers,
128
- });
129
-
130
- run.Graph?.overrideTestModel([reasoningText], 2);
131
-
132
- const userMessage = 'hi';
133
- conversationHistory.push(new HumanMessage(userMessage));
134
-
135
- const inputs = {
136
- messages: conversationHistory,
137
- };
138
-
139
- await run.processStream(inputs, config);
140
- expect(contentParts).toBeDefined();
141
- expect(contentParts.length).toBe(2);
142
- const reasoningContent = reasoningText.match(/<think>(.*)<\/think>/s)?.[0];
143
- const content = reasoningText.split(/<\/think>/)[1];
144
- expect((contentParts[0] as t.ReasoningContentText).think).toBe(reasoningContent);
145
- expect((contentParts[1] as MessageContentText).text).toBe(content);
146
-
147
- const finalMessages = run.getRunMessages();
148
- expect(finalMessages).toBeDefined();
149
- conversationHistory.push(...finalMessages ?? []);
150
- expect(conversationHistory.length).toBeGreaterThan(1);
151
-
152
- expect(onMessageDeltaSpy).toHaveBeenCalled();
153
- expect(onMessageDeltaSpy.mock.calls.length).toBeGreaterThan(1);
154
- expect((onMessageDeltaSpy.mock.calls[0][3] as StandardGraph).provider).toBeDefined();
155
-
156
- expect(onReasoningDeltaSpy).toHaveBeenCalled();
157
- expect(onReasoningDeltaSpy.mock.calls.length).toBeGreaterThan(1);
158
- expect((onReasoningDeltaSpy.mock.calls[0][3] as StandardGraph).provider).toBeDefined();
159
-
160
- expect(onRunStepSpy).toHaveBeenCalled();
161
- expect(onRunStepSpy.mock.calls.length).toBeGreaterThan(0);
162
- expect((onRunStepSpy.mock.calls[0][3] as StandardGraph).provider).toBeDefined();
163
-
164
- });
165
- });
1
+ /* eslint-disable no-console */
2
+
3
+ // src/scripts/cli.test.ts
4
+ import { config } from 'dotenv';
5
+ config();
6
+ import {
7
+ HumanMessage,
8
+ BaseMessage,
9
+ MessageContentText,
10
+ } from '@langchain/core/messages';
11
+ import type { RunnableConfig } from '@langchain/core/runnables';
12
+ import type * as t from '@/types';
13
+ import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
14
+ import { capitalizeFirstLetter } from './spec.utils';
15
+ import { GraphEvents, Providers } from '@/common';
16
+ import { getLLMConfig } from '@/utils/llmConfig';
17
+ import { getArgs } from '@/scripts/args';
18
+ import { Run } from '@/run';
19
+
20
+ const reasoningText = `<think>
21
+ Okay, the user is Jo from New York. I should start by greeting them by name. Let's keep it friendly and open-ended. Maybe mention the weather in New York to make it personal. Then offer help with something specific like plans or questions. Need to keep it concise and welcoming. Check for any typos. Alright, that should work.
22
+ </think>
23
+ Hi Jo! 🌆 How's everything in New York today? Whether you need recommendations for the city, help with a task, or just want to chat, I'm here for it. What's on your mind? 😊`;
24
+
25
+ const provider = 'Reasoning LLM';
26
+ describe(`${capitalizeFirstLetter(provider)} Streaming Tests`, () => {
27
+ jest.setTimeout(30000);
28
+ let run: Run<t.IState>;
29
+ let contentParts: t.MessageContentComplex[];
30
+ let conversationHistory: BaseMessage[];
31
+ let aggregateContent: t.ContentAggregator;
32
+ let runSteps: Set<string>;
33
+
34
+ const config: Partial<RunnableConfig> & {
35
+ version: 'v1' | 'v2';
36
+ run_id?: string;
37
+ streamMode: string;
38
+ } = {
39
+ configurable: {
40
+ thread_id: 'conversation-num-1',
41
+ },
42
+ streamMode: 'values',
43
+ version: 'v2' as const,
44
+ callbacks: [
45
+ {
46
+ async handleCustomEvent(event, data, metadata): Promise<void> {
47
+ if (event !== GraphEvents.ON_MESSAGE_DELTA) {
48
+ return;
49
+ }
50
+ const messageDeltaData = data as t.MessageDeltaEvent;
51
+
52
+ // Wait until we see the run step (with timeout for safety)
53
+ const maxAttempts = 50; // 5 seconds total
54
+ let attempts = 0;
55
+ while (!runSteps.has(messageDeltaData.id) && attempts < maxAttempts) {
56
+ await new Promise((resolve) => setTimeout(resolve, 100));
57
+ attempts++;
58
+ }
59
+
60
+ if (!runSteps.has(messageDeltaData.id)) {
61
+ console.warn(
62
+ `Timeout waiting for run step: ${messageDeltaData.id}`
63
+ );
64
+ }
65
+
66
+ onMessageDeltaSpy(event, data, metadata, run.Graph);
67
+ aggregateContent({ event, data: messageDeltaData });
68
+ },
69
+ },
70
+ ],
71
+ };
72
+
73
+ beforeEach(async () => {
74
+ conversationHistory = [];
75
+ const { contentParts: parts, aggregateContent: ac } =
76
+ createContentAggregator();
77
+ aggregateContent = ac;
78
+ runSteps = new Set();
79
+ contentParts = parts as t.MessageContentComplex[];
80
+ });
81
+
82
+ afterEach(() => {
83
+ runSteps.clear();
84
+ });
85
+
86
+ const onReasoningDeltaSpy = jest.fn();
87
+ const onMessageDeltaSpy = jest.fn();
88
+ const onRunStepSpy = jest.fn();
89
+
90
+ afterAll(() => {
91
+ onReasoningDeltaSpy.mockReset();
92
+ onMessageDeltaSpy.mockReset();
93
+ onRunStepSpy.mockReset();
94
+ });
95
+
96
+ const setupCustomHandlers = (): Record<
97
+ string | GraphEvents,
98
+ t.EventHandler
99
+ > => ({
100
+ [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
101
+ [GraphEvents.ON_RUN_STEP_COMPLETED]: {
102
+ handle: (
103
+ event: GraphEvents.ON_RUN_STEP_COMPLETED,
104
+ data: t.StreamEventData
105
+ ): void => {
106
+ aggregateContent({
107
+ event,
108
+ data: data as unknown as { result: t.ToolEndEvent },
109
+ });
110
+ },
111
+ },
112
+ [GraphEvents.ON_RUN_STEP]: {
113
+ handle: (
114
+ event: GraphEvents.ON_RUN_STEP,
115
+ data: t.StreamEventData,
116
+ metadata,
117
+ graph
118
+ ): void => {
119
+ const runStepData = data as t.RunStep;
120
+ runSteps.add(runStepData.id);
121
+
122
+ onRunStepSpy(event, runStepData, metadata, graph);
123
+ aggregateContent({ event, data: runStepData });
124
+ },
125
+ },
126
+ [GraphEvents.ON_RUN_STEP_DELTA]: {
127
+ handle: (
128
+ event: GraphEvents.ON_RUN_STEP_DELTA,
129
+ data: t.StreamEventData
130
+ ): void => {
131
+ aggregateContent({ event, data: data as t.RunStepDeltaEvent });
132
+ },
133
+ },
134
+ [GraphEvents.ON_REASONING_DELTA]: {
135
+ handle: (
136
+ event: GraphEvents.ON_REASONING_DELTA,
137
+ data: t.StreamEventData,
138
+ metadata,
139
+ graph
140
+ ): void => {
141
+ onReasoningDeltaSpy(event, data, metadata, graph);
142
+ aggregateContent({ event, data: data as t.ReasoningDeltaEvent });
143
+ },
144
+ },
145
+ });
146
+
147
+ test(`${capitalizeFirstLetter(provider)}: should process a simple reasoning message`, async () => {
148
+ const { userName, location } = await getArgs();
149
+ const llmConfig = getLLMConfig(Providers.OPENAI);
150
+ const customHandlers = setupCustomHandlers();
151
+
152
+ run = await Run.create<t.IState>({
153
+ runId: 'test-run-id',
154
+ graphConfig: {
155
+ type: 'standard',
156
+ llmConfig,
157
+ instructions:
158
+ 'You are a friendly AI assistant. Always address the user by their name.',
159
+ additional_instructions: `The user's name is ${userName} and they are located in ${location}.`,
160
+ },
161
+ returnContent: true,
162
+ customHandlers,
163
+ });
164
+
165
+ run.Graph?.overrideTestModel([reasoningText], 2);
166
+
167
+ const userMessage = 'hi';
168
+ conversationHistory.push(new HumanMessage(userMessage));
169
+
170
+ const inputs = {
171
+ messages: conversationHistory,
172
+ };
173
+
174
+ await run.processStream(inputs, config);
175
+ expect(contentParts).toBeDefined();
176
+ expect(contentParts.length).toBe(2);
177
+ const reasoningContent = reasoningText.match(/<think>(.*)<\/think>/s)?.[0];
178
+ const content = reasoningText.split(/<\/think>/)[1];
179
+ expect((contentParts[0] as t.ReasoningContentText).think).toBe(
180
+ reasoningContent
181
+ );
182
+ expect((contentParts[1] as MessageContentText).text).toBe(content);
183
+
184
+ const finalMessages = run.getRunMessages();
185
+ expect(finalMessages).toBeDefined();
186
+ conversationHistory.push(...(finalMessages ?? []));
187
+ expect(conversationHistory.length).toBeGreaterThan(1);
188
+
189
+ expect(onMessageDeltaSpy).toHaveBeenCalled();
190
+ expect(onMessageDeltaSpy.mock.calls.length).toBeGreaterThan(1);
191
+ expect(onMessageDeltaSpy.mock.calls[0][3]).toBeDefined(); // Graph exists
192
+
193
+ expect(onReasoningDeltaSpy).toHaveBeenCalled();
194
+ expect(onReasoningDeltaSpy.mock.calls.length).toBeGreaterThan(1);
195
+ expect(onReasoningDeltaSpy.mock.calls[0][3]).toBeDefined(); // Graph exists
196
+
197
+ expect(onRunStepSpy).toHaveBeenCalled();
198
+ expect(onRunStepSpy.mock.calls.length).toBeGreaterThan(0);
199
+ expect(onRunStepSpy.mock.calls[0][3]).toBeDefined(); // Graph exists
200
+ });
201
+ });