illuma-agents 1.0.2 → 1.0.3

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 +7 -6
  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 +7 -6
  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 +9 -7
  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
package/src/events.ts CHANGED
@@ -1,191 +1,197 @@
1
- /* eslint-disable no-console */
2
- // src/events.ts
3
- import type {
4
- UsageMetadata,
5
- BaseMessageFields,
6
- } from '@langchain/core/messages';
7
- import type { Graph } from '@/graphs';
8
- import type * as t from '@/types';
9
- import { handleToolCalls } from '@/tools/handlers';
10
- import { Providers } from '@/common';
11
-
12
- export class HandlerRegistry {
13
- private handlers: Map<string, t.EventHandler> = new Map();
14
-
15
- register(eventType: string, handler: t.EventHandler): void {
16
- this.handlers.set(eventType, handler);
17
- }
18
-
19
- getHandler(eventType: string): t.EventHandler | undefined {
20
- return this.handlers.get(eventType);
21
- }
22
- }
23
-
24
- export class ModelEndHandler implements t.EventHandler {
25
- collectedUsage?: UsageMetadata[];
26
- constructor(collectedUsage?: UsageMetadata[]) {
27
- if (collectedUsage && !Array.isArray(collectedUsage)) {
28
- throw new Error('collectedUsage must be an array');
29
- }
30
- this.collectedUsage = collectedUsage;
31
- }
32
-
33
- handle(
34
- event: string,
35
- data: t.ModelEndData,
36
- metadata?: Record<string, unknown>,
37
- graph?: Graph
38
- ): void {
39
- if (!graph || !metadata) {
40
- console.warn(`Graph or metadata not found in ${event} event`);
41
- return;
42
- }
43
-
44
- const usage = data?.output?.usage_metadata;
45
- if (usage != null && this.collectedUsage != null) {
46
- this.collectedUsage.push(usage);
47
- }
48
-
49
- if (metadata.ls_provider === 'FakeListChatModel') {
50
- return handleToolCalls(data?.output?.tool_calls, metadata, graph);
51
- }
52
-
53
- console.log(`====== ${event.toUpperCase()} ======`);
54
- console.dir(
55
- {
56
- usage,
57
- },
58
- { depth: null }
59
- );
60
-
61
- if (metadata.provider !== Providers.GOOGLE) {
62
- return;
63
- }
64
-
65
- handleToolCalls(data?.output?.tool_calls, metadata, graph);
66
- }
67
- }
68
-
69
- export class ToolEndHandler implements t.EventHandler {
70
- private callback?: t.ToolEndCallback;
71
- private omitOutput?: (name?: string) => boolean;
72
- constructor(
73
- callback?: t.ToolEndCallback,
74
- omitOutput?: (name?: string) => boolean
75
- ) {
76
- this.callback = callback;
77
- this.omitOutput = omitOutput;
78
- }
79
- handle(
80
- event: string,
81
- data: t.StreamEventData | undefined,
82
- metadata?: Record<string, unknown>,
83
- graph?: Graph
84
- ): void {
85
- if (!graph || !metadata) {
86
- console.warn(`Graph or metadata not found in ${event} event`);
87
- return;
88
- }
89
-
90
- const toolEndData = data as t.ToolEndData | undefined;
91
- if (!toolEndData?.output) {
92
- console.warn('No output found in tool_end event');
93
- return;
94
- }
95
-
96
- this.callback?.(toolEndData, metadata);
97
- graph.handleToolCallCompleted(
98
- { input: toolEndData.input, output: toolEndData.output },
99
- metadata,
100
- this.omitOutput?.(toolEndData.output.name)
101
- );
102
- }
103
- }
104
-
105
- export class TestLLMStreamHandler implements t.EventHandler {
106
- handle(event: string, data: t.StreamEventData | undefined): void {
107
- const chunk = data?.chunk;
108
- const isMessageChunk = !!(chunk && 'message' in chunk);
109
- const msg = isMessageChunk ? chunk.message : undefined;
110
- if (msg && msg.tool_call_chunks && msg.tool_call_chunks.length > 0) {
111
- console.log(msg.tool_call_chunks);
112
- } else if (msg && msg.content) {
113
- if (typeof msg.content === 'string') {
114
- process.stdout.write(msg.content);
115
- }
116
- }
117
- }
118
- }
119
-
120
- export class TestChatStreamHandler implements t.EventHandler {
121
- handle(event: string, data: t.StreamEventData | undefined): void {
122
- const chunk = data?.chunk;
123
- const isContentChunk = !!(chunk && 'content' in chunk);
124
- const content = isContentChunk && chunk.content;
125
-
126
- if (!content || !isContentChunk) {
127
- return;
128
- }
129
-
130
- if (chunk.tool_call_chunks && chunk.tool_call_chunks.length > 0) {
131
- console.dir(chunk.tool_call_chunks, { depth: null });
132
- }
133
-
134
- if (typeof content === 'string') {
135
- process.stdout.write(content);
136
- } else {
137
- console.dir(content, { depth: null });
138
- }
139
- }
140
- }
141
-
142
- export class LLMStreamHandler implements t.EventHandler {
143
- handle(
144
- event: string,
145
- data: t.StreamEventData | undefined,
146
- metadata?: Record<string, unknown>
147
- ): void {
148
- const chunk = data?.chunk;
149
- const isMessageChunk = !!(chunk && 'message' in chunk);
150
- const msg = isMessageChunk && chunk.message;
151
- if (metadata) {
152
- console.log(metadata);
153
- }
154
- if (msg && msg.tool_call_chunks && msg.tool_call_chunks.length > 0) {
155
- console.log(msg.tool_call_chunks);
156
- } else if (msg && msg.content) {
157
- if (typeof msg.content === 'string') {
158
- // const text_delta = msg.content;
159
- // dispatchCustomEvent(GraphEvents.CHAT_MODEL_STREAM, { chunk }, config);
160
- process.stdout.write(msg.content);
161
- }
162
- }
163
- }
164
- }
165
-
166
- export const createMetadataAggregator = (
167
- _collected?: Record<
168
- string,
169
- NonNullable<BaseMessageFields['response_metadata']>
170
- >[]
171
- ): t.MetadataAggregatorResult => {
172
- const collected = _collected || [];
173
-
174
- const handleLLMEnd: t.HandleLLMEnd = (output) => {
175
- const { generations } = output;
176
- const lastMessageOutput = (
177
- generations[generations.length - 1] as
178
- | (t.StreamGeneration | undefined)[]
179
- | undefined
180
- )?.[0];
181
- if (!lastMessageOutput) {
182
- return;
183
- }
184
- const { message } = lastMessageOutput;
185
- if (message?.response_metadata) {
186
- collected.push(message.response_metadata);
187
- }
188
- };
189
-
190
- return { handleLLMEnd, collected };
191
- };
1
+ /* eslint-disable no-console */
2
+ // src/events.ts
3
+ import type {
4
+ ToolMessage,
5
+ UsageMetadata,
6
+ BaseMessageFields,
7
+ } from '@langchain/core/messages';
8
+ import type { MultiAgentGraph, StandardGraph } from '@/graphs';
9
+ import type * as t from '@/types';
10
+ import { handleToolCalls } from '@/tools/handlers';
11
+ import { Providers } from '@/common';
12
+
13
+ export class HandlerRegistry {
14
+ private handlers: Map<string, t.EventHandler> = new Map();
15
+
16
+ register(eventType: string, handler: t.EventHandler): void {
17
+ this.handlers.set(eventType, handler);
18
+ }
19
+
20
+ getHandler(eventType: string): t.EventHandler | undefined {
21
+ return this.handlers.get(eventType);
22
+ }
23
+ }
24
+
25
+ export class ModelEndHandler implements t.EventHandler {
26
+ collectedUsage?: UsageMetadata[];
27
+ constructor(collectedUsage?: UsageMetadata[]) {
28
+ if (collectedUsage && !Array.isArray(collectedUsage)) {
29
+ throw new Error('collectedUsage must be an array');
30
+ }
31
+ this.collectedUsage = collectedUsage;
32
+ }
33
+
34
+ async handle(
35
+ event: string,
36
+ data: t.ModelEndData,
37
+ metadata?: Record<string, unknown>,
38
+ graph?: StandardGraph | MultiAgentGraph
39
+ ): Promise<void> {
40
+ if (!graph || !metadata) {
41
+ console.warn(`Graph or metadata not found in ${event} event`);
42
+ return;
43
+ }
44
+
45
+ const usage = data?.output?.usage_metadata;
46
+ if (usage != null && this.collectedUsage != null) {
47
+ this.collectedUsage.push(usage);
48
+ }
49
+
50
+ if (metadata.ls_provider === 'FakeListChatModel') {
51
+ return handleToolCalls(data?.output?.tool_calls, metadata, graph);
52
+ }
53
+
54
+ console.log(`====== ${event.toUpperCase()} ======`);
55
+ console.dir(
56
+ {
57
+ usage,
58
+ },
59
+ { depth: null }
60
+ );
61
+
62
+ const agentContext = graph.getAgentContext(metadata);
63
+
64
+ if (
65
+ agentContext.provider !== Providers.GOOGLE &&
66
+ agentContext.provider !== Providers.BEDROCK
67
+ ) {
68
+ return;
69
+ }
70
+
71
+ await handleToolCalls(data?.output?.tool_calls, metadata, graph);
72
+ }
73
+ }
74
+
75
+ export class ToolEndHandler implements t.EventHandler {
76
+ private callback?: t.ToolEndCallback;
77
+ private omitOutput?: (name?: string) => boolean;
78
+ constructor(
79
+ callback?: t.ToolEndCallback,
80
+ omitOutput?: (name?: string) => boolean
81
+ ) {
82
+ this.callback = callback;
83
+ this.omitOutput = omitOutput;
84
+ }
85
+ async handle(
86
+ event: string,
87
+ data: t.StreamEventData | undefined,
88
+ metadata?: Record<string, unknown>,
89
+ graph?: StandardGraph | MultiAgentGraph
90
+ ): Promise<void> {
91
+ if (!graph || !metadata) {
92
+ console.warn(`Graph or metadata not found in ${event} event`);
93
+ return;
94
+ }
95
+
96
+ const toolEndData = data as t.ToolEndData | undefined;
97
+ if (!toolEndData?.output) {
98
+ console.warn('No output found in tool_end event');
99
+ return;
100
+ }
101
+
102
+ this.callback?.(toolEndData, metadata);
103
+ await graph.handleToolCallCompleted(
104
+ { input: toolEndData.input, output: toolEndData.output },
105
+ metadata,
106
+ this.omitOutput?.((toolEndData.output as ToolMessage | undefined)?.name)
107
+ );
108
+ }
109
+ }
110
+
111
+ export class TestLLMStreamHandler implements t.EventHandler {
112
+ handle(event: string, data: t.StreamEventData | undefined): void {
113
+ const chunk = data?.chunk;
114
+ const isMessageChunk = !!(chunk && 'message' in chunk);
115
+ const msg = isMessageChunk ? chunk.message : undefined;
116
+ if (msg && msg.tool_call_chunks && msg.tool_call_chunks.length > 0) {
117
+ console.log(msg.tool_call_chunks);
118
+ } else if (msg && msg.content) {
119
+ if (typeof msg.content === 'string') {
120
+ process.stdout.write(msg.content);
121
+ }
122
+ }
123
+ }
124
+ }
125
+
126
+ export class TestChatStreamHandler implements t.EventHandler {
127
+ handle(event: string, data: t.StreamEventData | undefined): void {
128
+ const chunk = data?.chunk;
129
+ const isContentChunk = !!(chunk && 'content' in chunk);
130
+ const content = isContentChunk && chunk.content;
131
+
132
+ if (!content || !isContentChunk) {
133
+ return;
134
+ }
135
+
136
+ if (chunk.tool_call_chunks && chunk.tool_call_chunks.length > 0) {
137
+ console.dir(chunk.tool_call_chunks, { depth: null });
138
+ }
139
+
140
+ if (typeof content === 'string') {
141
+ process.stdout.write(content);
142
+ } else {
143
+ console.dir(content, { depth: null });
144
+ }
145
+ }
146
+ }
147
+
148
+ export class LLMStreamHandler implements t.EventHandler {
149
+ handle(
150
+ event: string,
151
+ data: t.StreamEventData | undefined,
152
+ metadata?: Record<string, unknown>
153
+ ): void {
154
+ const chunk = data?.chunk;
155
+ const isMessageChunk = !!(chunk && 'message' in chunk);
156
+ const msg = isMessageChunk && chunk.message;
157
+ if (metadata) {
158
+ console.log(metadata);
159
+ }
160
+ if (msg && msg.tool_call_chunks && msg.tool_call_chunks.length > 0) {
161
+ console.log(msg.tool_call_chunks);
162
+ } else if (msg && msg.content) {
163
+ if (typeof msg.content === 'string') {
164
+ // const text_delta = msg.content;
165
+ // dispatchCustomEvent(GraphEvents.CHAT_MODEL_STREAM, { chunk }, config);
166
+ process.stdout.write(msg.content);
167
+ }
168
+ }
169
+ }
170
+ }
171
+
172
+ export const createMetadataAggregator = (
173
+ _collected?: Record<
174
+ string,
175
+ NonNullable<BaseMessageFields['response_metadata']>
176
+ >[]
177
+ ): t.MetadataAggregatorResult => {
178
+ const collected = _collected || [];
179
+
180
+ const handleLLMEnd: t.HandleLLMEnd = (output) => {
181
+ const { generations } = output;
182
+ const lastMessageOutput = (
183
+ generations[generations.length - 1] as
184
+ | (t.StreamGeneration | undefined)[]
185
+ | undefined
186
+ )?.[0];
187
+ if (!lastMessageOutput) {
188
+ return;
189
+ }
190
+ const { message } = lastMessageOutput;
191
+ if (message?.response_metadata) {
192
+ collected.push(message.response_metadata);
193
+ }
194
+ };
195
+
196
+ return { handleLLMEnd, collected };
197
+ };