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,60 +1,60 @@
1
- import { ChatOpenAI } from '@/llm/openai';
2
- import type {
3
- FunctionMessageChunk,
4
- SystemMessageChunk,
5
- HumanMessageChunk,
6
- ToolMessageChunk,
7
- ChatMessageChunk,
8
- AIMessageChunk,
9
- } from '@langchain/core/messages';
10
- import type {
11
- ChatOpenAICallOptions,
12
- OpenAIChatInput,
13
- OpenAIClient,
14
- } from '@langchain/openai';
15
-
16
- export interface ChatOpenRouterCallOptions extends ChatOpenAICallOptions {
17
- include_reasoning?: boolean;
18
- modelKwargs?: OpenAIChatInput['modelKwargs'];
19
- }
20
- export class ChatOpenRouter extends ChatOpenAI {
21
- constructor(_fields: Partial<ChatOpenRouterCallOptions>) {
22
- const { include_reasoning, modelKwargs = {}, ...fields } = _fields;
23
- super({
24
- ...fields,
25
- modelKwargs: {
26
- ...modelKwargs,
27
- include_reasoning,
28
- },
29
- });
30
- }
31
- static lc_name(): 'IllumaOpenRouter' {
32
- return 'IllumaOpenRouter';
33
- }
34
- protected override _convertOpenAIDeltaToBaseMessageChunk(
35
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
36
- delta: Record<string, any>,
37
- rawResponse: OpenAIClient.ChatCompletionChunk,
38
- defaultRole?:
39
- | 'function'
40
- | 'user'
41
- | 'system'
42
- | 'developer'
43
- | 'assistant'
44
- | 'tool'
45
- ):
46
- | AIMessageChunk
47
- | HumanMessageChunk
48
- | SystemMessageChunk
49
- | FunctionMessageChunk
50
- | ToolMessageChunk
51
- | ChatMessageChunk {
52
- const messageChunk = super._convertOpenAIDeltaToBaseMessageChunk(
53
- delta,
54
- rawResponse,
55
- defaultRole
56
- );
57
- messageChunk.additional_kwargs.reasoning = delta.reasoning;
58
- return messageChunk;
59
- }
60
- }
1
+ import { ChatOpenAI } from '@/llm/openai';
2
+ import type {
3
+ FunctionMessageChunk,
4
+ SystemMessageChunk,
5
+ HumanMessageChunk,
6
+ ToolMessageChunk,
7
+ ChatMessageChunk,
8
+ AIMessageChunk,
9
+ } from '@langchain/core/messages';
10
+ import type {
11
+ ChatOpenAICallOptions,
12
+ OpenAIChatInput,
13
+ OpenAIClient,
14
+ } from '@langchain/openai';
15
+
16
+ export interface ChatOpenRouterCallOptions extends ChatOpenAICallOptions {
17
+ include_reasoning?: boolean;
18
+ modelKwargs?: OpenAIChatInput['modelKwargs'];
19
+ }
20
+ export class ChatOpenRouter extends ChatOpenAI {
21
+ constructor(_fields: Partial<ChatOpenRouterCallOptions>) {
22
+ const { include_reasoning, modelKwargs = {}, ...fields } = _fields;
23
+ super({
24
+ ...fields,
25
+ modelKwargs: {
26
+ ...modelKwargs,
27
+ include_reasoning,
28
+ },
29
+ });
30
+ }
31
+ static lc_name(): 'IllumaOpenRouter' {
32
+ return 'IllumaOpenRouter';
33
+ }
34
+ protected override _convertOpenAIDeltaToBaseMessageChunk(
35
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
36
+ delta: Record<string, any>,
37
+ rawResponse: OpenAIClient.ChatCompletionChunk,
38
+ defaultRole?:
39
+ | 'function'
40
+ | 'user'
41
+ | 'system'
42
+ | 'developer'
43
+ | 'assistant'
44
+ | 'tool'
45
+ ):
46
+ | AIMessageChunk
47
+ | HumanMessageChunk
48
+ | SystemMessageChunk
49
+ | FunctionMessageChunk
50
+ | ToolMessageChunk
51
+ | ChatMessageChunk {
52
+ const messageChunk = super._convertOpenAIDeltaToBaseMessageChunk(
53
+ delta,
54
+ rawResponse,
55
+ defaultRole
56
+ );
57
+ messageChunk.additional_kwargs.reasoning = delta.reasoning;
58
+ return messageChunk;
59
+ }
60
+ }
@@ -1,57 +1,55 @@
1
- // src/llm/providers.ts
2
- import { ChatMistralAI } from '@langchain/mistralai';
3
- import { ChatBedrockConverse } from '@langchain/aws';
4
- // import { ChatAnthropic } from '@langchain/anthropic';
5
- // import { ChatVertexAI } from '@langchain/google-vertexai';
6
- import { BedrockChat } from '@langchain/community/chat_models/bedrock/web';
7
- import type {
8
- ChatModelConstructorMap,
9
- ProviderOptionsMap,
10
- ChatModelMap,
11
- } from '@/types';
12
- import {
13
- AzureChatOpenAI,
14
- ChatDeepSeek,
15
- ChatOpenAI,
16
- ChatXAI,
17
- } from '@/llm/openai';
18
- import { CustomChatGoogleGenerativeAI } from '@/llm/google';
19
- import { CustomAnthropic } from '@/llm/anthropic';
20
- import { ChatOpenRouter } from '@/llm/openrouter';
21
- import { ChatVertexAI } from '@/llm/vertexai';
22
- import { ChatOllama } from '@/llm/ollama';
23
- import { Providers } from '@/common';
24
-
25
- export const llmProviders: Partial<ChatModelConstructorMap> = {
26
- [Providers.XAI]: ChatXAI,
27
- [Providers.OPENAI]: ChatOpenAI,
28
- [Providers.OLLAMA]: ChatOllama,
29
- [Providers.AZURE]: AzureChatOpenAI,
30
- [Providers.VERTEXAI]: ChatVertexAI,
31
- [Providers.DEEPSEEK]: ChatDeepSeek,
32
- [Providers.MISTRALAI]: ChatMistralAI,
33
- [Providers.MISTRAL]: ChatMistralAI,
34
- [Providers.ANTHROPIC]: CustomAnthropic,
35
- [Providers.OPENROUTER]: ChatOpenRouter,
36
- [Providers.BEDROCK_LEGACY]: BedrockChat,
37
- [Providers.BEDROCK]: ChatBedrockConverse,
38
- // [Providers.ANTHROPIC]: ChatAnthropic,
39
- [Providers.GOOGLE]: CustomChatGoogleGenerativeAI,
40
- };
41
-
42
- export const manualToolStreamProviders = new Set<Providers | string>([
43
- Providers.ANTHROPIC,
44
- Providers.BEDROCK,
45
- Providers.OLLAMA,
46
- ]);
47
-
48
- export const getChatModelClass = <P extends Providers>(
49
- provider: P
50
- ): new (config: ProviderOptionsMap[P]) => ChatModelMap[P] => {
51
- const ChatModelClass = llmProviders[provider];
52
- if (!ChatModelClass) {
53
- throw new Error(`Unsupported LLM provider: ${provider}`);
54
- }
55
-
56
- return ChatModelClass;
57
- };
1
+ // src/llm/providers.ts
2
+ import { ChatMistralAI } from '@langchain/mistralai';
3
+ import { ChatBedrockConverse } from '@langchain/aws';
4
+ // import { ChatAnthropic } from '@langchain/anthropic';
5
+ // import { ChatVertexAI } from '@langchain/google-vertexai';
6
+ import type {
7
+ ChatModelConstructorMap,
8
+ ProviderOptionsMap,
9
+ ChatModelMap,
10
+ } from '@/types';
11
+ import {
12
+ AzureChatOpenAI,
13
+ ChatDeepSeek,
14
+ ChatOpenAI,
15
+ ChatXAI,
16
+ } from '@/llm/openai';
17
+ import { CustomChatGoogleGenerativeAI } from '@/llm/google';
18
+ import { CustomAnthropic } from '@/llm/anthropic';
19
+ import { ChatOpenRouter } from '@/llm/openrouter';
20
+ import { ChatVertexAI } from '@/llm/vertexai';
21
+ import { ChatOllama } from '@/llm/ollama';
22
+ import { Providers } from '@/common';
23
+
24
+ export const llmProviders: Partial<ChatModelConstructorMap> = {
25
+ [Providers.XAI]: ChatXAI,
26
+ [Providers.OPENAI]: ChatOpenAI,
27
+ [Providers.OLLAMA]: ChatOllama,
28
+ [Providers.AZURE]: AzureChatOpenAI,
29
+ [Providers.VERTEXAI]: ChatVertexAI,
30
+ [Providers.DEEPSEEK]: ChatDeepSeek,
31
+ [Providers.MISTRALAI]: ChatMistralAI,
32
+ [Providers.MISTRAL]: ChatMistralAI,
33
+ [Providers.ANTHROPIC]: CustomAnthropic,
34
+ [Providers.OPENROUTER]: ChatOpenRouter,
35
+ [Providers.BEDROCK]: ChatBedrockConverse,
36
+ // [Providers.ANTHROPIC]: ChatAnthropic,
37
+ [Providers.GOOGLE]: CustomChatGoogleGenerativeAI,
38
+ };
39
+
40
+ export const manualToolStreamProviders = new Set<Providers | string>([
41
+ Providers.ANTHROPIC,
42
+ Providers.BEDROCK,
43
+ Providers.OLLAMA,
44
+ ]);
45
+
46
+ export const getChatModelClass = <P extends Providers>(
47
+ provider: P
48
+ ): new (config: ProviderOptionsMap[P]) => ChatModelMap[P] => {
49
+ const ChatModelClass = llmProviders[provider];
50
+ if (!ChatModelClass) {
51
+ throw new Error(`Unsupported LLM provider: ${provider}`);
52
+ }
53
+
54
+ return ChatModelClass;
55
+ };