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
@@ -1,176 +1,177 @@
1
- /**
2
- * Enum representing the various event types emitted during the execution of runnables.
3
- * These events provide real-time information about the progress and state of different components.
4
- *
5
- * @enum {string}
6
- */
7
- export enum GraphEvents {
8
- /* Custom Events */
9
-
10
- /** [Custom] Agent update event in multi-agent graph/workflow */
11
- ON_AGENT_UPDATE = 'on_agent_update',
12
- /** [Custom] Delta event for run steps (message creation and tool calls) */
13
- ON_RUN_STEP = 'on_run_step',
14
- /** [Custom] Delta event for run steps (tool calls) */
15
- ON_RUN_STEP_DELTA = 'on_run_step_delta',
16
- /** [Custom] Completed event for run steps (tool calls) */
17
- ON_RUN_STEP_COMPLETED = 'on_run_step_completed',
18
- /** [Custom] Delta events for messages */
19
- ON_MESSAGE_DELTA = 'on_message_delta',
20
- /** [Custom] Reasoning Delta events for messages */
21
- ON_REASONING_DELTA = 'on_reasoning_delta',
22
-
23
- /* Official Events */
24
-
25
- /** Custom event, emitted by system */
26
- ON_CUSTOM_EVENT = 'on_custom_event',
27
- /** Emitted when a chat model starts processing. */
28
- CHAT_MODEL_START = 'on_chat_model_start',
29
-
30
- /** Emitted when a chat model streams a chunk of its response. */
31
- CHAT_MODEL_STREAM = 'on_chat_model_stream',
32
-
33
- /** Emitted when a chat model completes its processing. */
34
- CHAT_MODEL_END = 'on_chat_model_end',
35
-
36
- /** Emitted when a language model starts processing. */
37
- LLM_START = 'on_llm_start',
38
-
39
- /** Emitted when a language model streams a chunk of its response. */
40
- LLM_STREAM = 'on_llm_stream',
41
-
42
- /** Emitted when a language model completes its processing. */
43
- LLM_END = 'on_llm_end',
44
-
45
- /** Emitted when a chain starts processing. */
46
- CHAIN_START = 'on_chain_start',
47
-
48
- /** Emitted when a chain streams a chunk of its output. */
49
- CHAIN_STREAM = 'on_chain_stream',
50
-
51
- /** Emitted when a chain completes its processing. */
52
- CHAIN_END = 'on_chain_end',
53
-
54
- /** Emitted when a tool starts its operation. */
55
- TOOL_START = 'on_tool_start',
56
-
57
- /** Emitted when a tool completes its operation. */
58
- TOOL_END = 'on_tool_end',
59
-
60
- /** Emitted when a retriever starts its operation. */
61
- RETRIEVER_START = 'on_retriever_start',
62
-
63
- /** Emitted when a retriever completes its operation. */
64
- RETRIEVER_END = 'on_retriever_end',
65
-
66
- /** Emitted when a prompt starts processing. */
67
- PROMPT_START = 'on_prompt_start',
68
-
69
- /** Emitted when a prompt completes its processing. */
70
- PROMPT_END = 'on_prompt_end',
71
- }
72
-
73
- export enum Providers {
74
- OPENAI = 'openAI',
75
- BEDROCK_LEGACY = 'bedrock_legacy',
76
- VERTEXAI = 'vertexai',
77
- BEDROCK = 'bedrock',
78
- ANTHROPIC = 'anthropic',
79
- MISTRALAI = 'mistralai',
80
- MISTRAL = 'mistral',
81
- OLLAMA = 'ollama',
82
- GOOGLE = 'google',
83
- AZURE = 'azureOpenAI',
84
- DEEPSEEK = 'deepseek',
85
- OPENROUTER = 'openrouter',
86
- XAI = 'xai',
87
- }
88
-
89
- export enum GraphNodeKeys {
90
- TOOLS = 'tools',
91
- AGENT = 'agent',
92
- PRE_TOOLS = 'pre_tools',
93
- POST_TOOLS = 'post_tools',
94
- }
95
-
96
- export enum GraphNodeActions {
97
- TOOL_NODE = 'tool_node',
98
- CALL_MODEL = 'call_model',
99
- ROUTE_MESSAGE = 'route_message',
100
- }
101
-
102
- export enum CommonEvents {
103
- LANGGRAPH = 'LangGraph',
104
- }
105
-
106
- export enum StepTypes {
107
- TOOL_CALLS = 'tool_calls',
108
- MESSAGE_CREATION = 'message_creation',
109
- }
110
-
111
- export enum ContentTypes {
112
- TEXT = 'text',
113
- ERROR = 'error',
114
- THINK = 'think',
115
- TOOL_CALL = 'tool_call',
116
- IMAGE_URL = 'image_url',
117
- IMAGE_FILE = 'image_file',
118
- /** Anthropic */
119
- THINKING = 'thinking',
120
- /** Vertex AI / Google Common */
121
- REASONING = 'reasoning',
122
- /** Multi-Agent Switch */
123
- AGENT_UPDATE = 'agent_update',
124
- /** Bedrock */
125
- REASONING_CONTENT = 'reasoning_content',
126
- }
127
-
128
- export enum ToolCallTypes {
129
- FUNCTION = 'function',
130
- RETRIEVAL = 'retrieval',
131
- FILE_SEARCH = 'file_search',
132
- CODE_INTERPRETER = 'code_interpreter',
133
- /* Agents Tool Call */
134
- TOOL_CALL = 'tool_call',
135
- }
136
-
137
- export enum Callback {
138
- TOOL_ERROR = 'handleToolError',
139
- TOOL_START = 'handleToolStart',
140
- TOOL_END = 'handleToolEnd',
141
- /*
142
- LLM_START = 'handleLLMStart',
143
- LLM_NEW_TOKEN = 'handleLLMNewToken',
144
- LLM_ERROR = 'handleLLMError',
145
- LLM_END = 'handleLLMEnd',
146
- CHAT_MODEL_START = 'handleChatModelStart',
147
- CHAIN_START = 'handleChainStart',
148
- CHAIN_ERROR = 'handleChainError',
149
- CHAIN_END = 'handleChainEnd',
150
- TEXT = 'handleText',
151
- AGENT_ACTION = 'handleAgentAction',
152
- AGENT_END = 'handleAgentEnd',
153
- RETRIEVER_START = 'handleRetrieverStart',
154
- RETRIEVER_END = 'handleRetrieverEnd',
155
- RETRIEVER_ERROR = 'handleRetrieverError',
156
- CUSTOM_EVENT = 'handleCustomEvent'
157
- */
158
- }
159
-
160
- export enum Constants {
161
- OFFICIAL_CODE_BASEURL = 'https://api.illuma.ai/v1',
162
- EXECUTE_CODE = 'execute_code',
163
- WEB_SEARCH = 'web_search',
164
- CONTENT_AND_ARTIFACT = 'content_and_artifact',
165
- }
166
-
167
- export enum TitleMethod {
168
- STRUCTURED = 'structured',
169
- FUNCTIONS = 'functions',
170
- COMPLETION = 'completion',
171
- }
172
-
173
- export enum EnvVar {
174
- CODE_API_KEY = 'CODE_EXECUTOR_API_KEY',
175
- CODE_BASEURL = 'CODE_EXECUTOR_API_BASEURL',
176
- }
1
+ /**
2
+ * Enum representing the various event types emitted during the execution of runnables.
3
+ * These events provide real-time information about the progress and state of different components.
4
+ *
5
+ * @enum {string}
6
+ */
7
+ export enum GraphEvents {
8
+ /* Custom Events */
9
+
10
+ /** [Custom] Agent update event in multi-agent graph/workflow */
11
+ ON_AGENT_UPDATE = 'on_agent_update',
12
+ /** [Custom] Delta event for run steps (message creation and tool calls) */
13
+ ON_RUN_STEP = 'on_run_step',
14
+ /** [Custom] Delta event for run steps (tool calls) */
15
+ ON_RUN_STEP_DELTA = 'on_run_step_delta',
16
+ /** [Custom] Completed event for run steps (tool calls) */
17
+ ON_RUN_STEP_COMPLETED = 'on_run_step_completed',
18
+ /** [Custom] Delta events for messages */
19
+ ON_MESSAGE_DELTA = 'on_message_delta',
20
+ /** [Custom] Reasoning Delta events for messages */
21
+ ON_REASONING_DELTA = 'on_reasoning_delta',
22
+
23
+ /* Official Events */
24
+
25
+ /** Custom event, emitted by system */
26
+ ON_CUSTOM_EVENT = 'on_custom_event',
27
+ /** Emitted when a chat model starts processing. */
28
+ CHAT_MODEL_START = 'on_chat_model_start',
29
+
30
+ /** Emitted when a chat model streams a chunk of its response. */
31
+ CHAT_MODEL_STREAM = 'on_chat_model_stream',
32
+
33
+ /** Emitted when a chat model completes its processing. */
34
+ CHAT_MODEL_END = 'on_chat_model_end',
35
+
36
+ /** Emitted when a language model starts processing. */
37
+ LLM_START = 'on_llm_start',
38
+
39
+ /** Emitted when a language model streams a chunk of its response. */
40
+ LLM_STREAM = 'on_llm_stream',
41
+
42
+ /** Emitted when a language model completes its processing. */
43
+ LLM_END = 'on_llm_end',
44
+
45
+ /** Emitted when a chain starts processing. */
46
+ CHAIN_START = 'on_chain_start',
47
+
48
+ /** Emitted when a chain streams a chunk of its output. */
49
+ CHAIN_STREAM = 'on_chain_stream',
50
+
51
+ /** Emitted when a chain completes its processing. */
52
+ CHAIN_END = 'on_chain_end',
53
+
54
+ /** Emitted when a tool starts its operation. */
55
+ TOOL_START = 'on_tool_start',
56
+
57
+ /** Emitted when a tool completes its operation. */
58
+ TOOL_END = 'on_tool_end',
59
+
60
+ /** Emitted when a retriever starts its operation. */
61
+ RETRIEVER_START = 'on_retriever_start',
62
+
63
+ /** Emitted when a retriever completes its operation. */
64
+ RETRIEVER_END = 'on_retriever_end',
65
+
66
+ /** Emitted when a prompt starts processing. */
67
+ PROMPT_START = 'on_prompt_start',
68
+
69
+ /** Emitted when a prompt completes its processing. */
70
+ PROMPT_END = 'on_prompt_end',
71
+ }
72
+
73
+ export enum Providers {
74
+ OPENAI = 'openAI',
75
+ VERTEXAI = 'vertexai',
76
+ BEDROCK = 'bedrock',
77
+ ANTHROPIC = 'anthropic',
78
+ MISTRALAI = 'mistralai',
79
+ MISTRAL = 'mistral',
80
+ OLLAMA = 'ollama',
81
+ GOOGLE = 'google',
82
+ AZURE = 'azureOpenAI',
83
+ DEEPSEEK = 'deepseek',
84
+ OPENROUTER = 'openrouter',
85
+ XAI = 'xai',
86
+ }
87
+
88
+ export enum GraphNodeKeys {
89
+ TOOLS = 'tools=',
90
+ AGENT = 'agent=',
91
+ ROUTER = 'router',
92
+ PRE_TOOLS = 'pre_tools',
93
+ POST_TOOLS = 'post_tools',
94
+ }
95
+
96
+ export enum GraphNodeActions {
97
+ TOOL_NODE = 'tool_node',
98
+ CALL_MODEL = 'call_model',
99
+ ROUTE_MESSAGE = 'route_message',
100
+ }
101
+
102
+ export enum CommonEvents {
103
+ LANGGRAPH = 'LangGraph',
104
+ }
105
+
106
+ export enum StepTypes {
107
+ TOOL_CALLS = 'tool_calls',
108
+ MESSAGE_CREATION = 'message_creation',
109
+ }
110
+
111
+ export enum ContentTypes {
112
+ TEXT = 'text',
113
+ ERROR = 'error',
114
+ THINK = 'think',
115
+ TOOL_CALL = 'tool_call',
116
+ IMAGE_URL = 'image_url',
117
+ IMAGE_FILE = 'image_file',
118
+ /** Anthropic */
119
+ THINKING = 'thinking',
120
+ /** Vertex AI / Google Common */
121
+ REASONING = 'reasoning',
122
+ /** Multi-Agent Switch */
123
+ AGENT_UPDATE = 'agent_update',
124
+ /** Bedrock */
125
+ REASONING_CONTENT = 'reasoning_content',
126
+ }
127
+
128
+ export enum ToolCallTypes {
129
+ FUNCTION = 'function',
130
+ RETRIEVAL = 'retrieval',
131
+ FILE_SEARCH = 'file_search',
132
+ CODE_INTERPRETER = 'code_interpreter',
133
+ /* Agents Tool Call */
134
+ TOOL_CALL = 'tool_call',
135
+ }
136
+
137
+ export enum Callback {
138
+ TOOL_ERROR = 'handleToolError',
139
+ TOOL_START = 'handleToolStart',
140
+ TOOL_END = 'handleToolEnd',
141
+ CUSTOM_EVENT = 'handleCustomEvent',
142
+ /*
143
+ LLM_START = 'handleLLMStart',
144
+ LLM_NEW_TOKEN = 'handleLLMNewToken',
145
+ LLM_ERROR = 'handleLLMError',
146
+ LLM_END = 'handleLLMEnd',
147
+ CHAT_MODEL_START = 'handleChatModelStart',
148
+ CHAIN_START = 'handleChainStart',
149
+ CHAIN_ERROR = 'handleChainError',
150
+ CHAIN_END = 'handleChainEnd',
151
+ TEXT = 'handleText',
152
+ AGENT_ACTION = 'handleAgentAction',
153
+ AGENT_END = 'handleAgentEnd',
154
+ RETRIEVER_START = 'handleRetrieverStart',
155
+ RETRIEVER_END = 'handleRetrieverEnd',
156
+ RETRIEVER_ERROR = 'handleRetrieverError',
157
+ */
158
+ }
159
+
160
+ export enum Constants {
161
+ OFFICIAL_CODE_BASEURL = 'https://api.illuma.ai/v1',
162
+ EXECUTE_CODE = 'execute_code',
163
+ WEB_SEARCH = 'web_search',
164
+ CONTENT_AND_ARTIFACT = 'content_and_artifact',
165
+ LC_TRANSFER_TO_ = 'lc_transfer_to_',
166
+ }
167
+
168
+ export enum TitleMethod {
169
+ STRUCTURED = 'structured',
170
+ FUNCTIONS = 'functions',
171
+ COMPLETION = 'completion',
172
+ }
173
+
174
+ export enum EnvVar {
175
+ CODE_API_KEY = 'ILLUMA_CODE_API_KEY',
176
+ CODE_BASEURL = 'ILLUMA_CODE_BASEURL',
177
+ }