illuma-agents 1.0.37 → 1.0.39

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 (139) hide show
  1. package/dist/cjs/agents/AgentContext.cjs +112 -14
  2. package/dist/cjs/agents/AgentContext.cjs.map +1 -1
  3. package/dist/cjs/common/enum.cjs +5 -1
  4. package/dist/cjs/common/enum.cjs.map +1 -1
  5. package/dist/cjs/graphs/Graph.cjs +148 -8
  6. package/dist/cjs/graphs/Graph.cjs.map +1 -1
  7. package/dist/cjs/graphs/MultiAgentGraph.cjs +277 -11
  8. package/dist/cjs/graphs/MultiAgentGraph.cjs.map +1 -1
  9. package/dist/cjs/llm/bedrock/index.cjs +128 -61
  10. package/dist/cjs/llm/bedrock/index.cjs.map +1 -1
  11. package/dist/cjs/main.cjs +22 -7
  12. package/dist/cjs/main.cjs.map +1 -1
  13. package/dist/cjs/messages/cache.cjs +140 -46
  14. package/dist/cjs/messages/cache.cjs.map +1 -1
  15. package/dist/cjs/messages/core.cjs +1 -1
  16. package/dist/cjs/messages/core.cjs.map +1 -1
  17. package/dist/cjs/messages/tools.cjs +2 -2
  18. package/dist/cjs/messages/tools.cjs.map +1 -1
  19. package/dist/cjs/schemas/validate.cjs +173 -0
  20. package/dist/cjs/schemas/validate.cjs.map +1 -0
  21. package/dist/cjs/stream.cjs +4 -2
  22. package/dist/cjs/stream.cjs.map +1 -1
  23. package/dist/cjs/tools/BrowserTools.cjs.map +1 -1
  24. package/dist/cjs/tools/CodeExecutor.cjs +22 -21
  25. package/dist/cjs/tools/CodeExecutor.cjs.map +1 -1
  26. package/dist/cjs/tools/ProgrammaticToolCalling.cjs +14 -11
  27. package/dist/cjs/tools/ProgrammaticToolCalling.cjs.map +1 -1
  28. package/dist/cjs/tools/ToolNode.cjs +101 -2
  29. package/dist/cjs/tools/ToolNode.cjs.map +1 -1
  30. package/dist/cjs/tools/ToolSearch.cjs +862 -0
  31. package/dist/cjs/tools/ToolSearch.cjs.map +1 -0
  32. package/dist/esm/agents/AgentContext.mjs +112 -14
  33. package/dist/esm/agents/AgentContext.mjs.map +1 -1
  34. package/dist/esm/common/enum.mjs +5 -1
  35. package/dist/esm/common/enum.mjs.map +1 -1
  36. package/dist/esm/graphs/Graph.mjs +149 -9
  37. package/dist/esm/graphs/Graph.mjs.map +1 -1
  38. package/dist/esm/graphs/MultiAgentGraph.mjs +278 -12
  39. package/dist/esm/graphs/MultiAgentGraph.mjs.map +1 -1
  40. package/dist/esm/llm/bedrock/index.mjs +127 -60
  41. package/dist/esm/llm/bedrock/index.mjs.map +1 -1
  42. package/dist/esm/main.mjs +2 -1
  43. package/dist/esm/main.mjs.map +1 -1
  44. package/dist/esm/messages/cache.mjs +140 -46
  45. package/dist/esm/messages/cache.mjs.map +1 -1
  46. package/dist/esm/messages/core.mjs +1 -1
  47. package/dist/esm/messages/core.mjs.map +1 -1
  48. package/dist/esm/messages/tools.mjs +2 -2
  49. package/dist/esm/messages/tools.mjs.map +1 -1
  50. package/dist/esm/schemas/validate.mjs +167 -0
  51. package/dist/esm/schemas/validate.mjs.map +1 -0
  52. package/dist/esm/stream.mjs +4 -2
  53. package/dist/esm/stream.mjs.map +1 -1
  54. package/dist/esm/tools/BrowserTools.mjs.map +1 -1
  55. package/dist/esm/tools/CodeExecutor.mjs +22 -21
  56. package/dist/esm/tools/CodeExecutor.mjs.map +1 -1
  57. package/dist/esm/tools/ProgrammaticToolCalling.mjs +14 -11
  58. package/dist/esm/tools/ProgrammaticToolCalling.mjs.map +1 -1
  59. package/dist/esm/tools/ToolNode.mjs +102 -3
  60. package/dist/esm/tools/ToolNode.mjs.map +1 -1
  61. package/dist/esm/tools/ToolSearch.mjs +827 -0
  62. package/dist/esm/tools/ToolSearch.mjs.map +1 -0
  63. package/dist/types/agents/AgentContext.d.ts +51 -1
  64. package/dist/types/common/enum.d.ts +6 -2
  65. package/dist/types/graphs/Graph.d.ts +12 -0
  66. package/dist/types/graphs/MultiAgentGraph.d.ts +16 -0
  67. package/dist/types/index.d.ts +2 -1
  68. package/dist/types/llm/bedrock/index.d.ts +89 -11
  69. package/dist/types/llm/bedrock/types.d.ts +27 -0
  70. package/dist/types/llm/bedrock/utils/index.d.ts +5 -0
  71. package/dist/types/llm/bedrock/utils/message_inputs.d.ts +31 -0
  72. package/dist/types/llm/bedrock/utils/message_outputs.d.ts +33 -0
  73. package/dist/types/messages/cache.d.ts +4 -1
  74. package/dist/types/schemas/index.d.ts +1 -0
  75. package/dist/types/schemas/validate.d.ts +36 -0
  76. package/dist/types/tools/CodeExecutor.d.ts +0 -3
  77. package/dist/types/tools/ProgrammaticToolCalling.d.ts +0 -3
  78. package/dist/types/tools/ToolNode.d.ts +3 -1
  79. package/dist/types/tools/ToolSearch.d.ts +148 -0
  80. package/dist/types/types/graph.d.ts +71 -0
  81. package/dist/types/types/llm.d.ts +3 -1
  82. package/dist/types/types/tools.d.ts +42 -2
  83. package/package.json +13 -6
  84. package/src/agents/AgentContext.test.ts +312 -0
  85. package/src/agents/AgentContext.ts +144 -16
  86. package/src/common/enum.ts +5 -1
  87. package/src/graphs/Graph.ts +214 -13
  88. package/src/graphs/MultiAgentGraph.ts +350 -13
  89. package/src/index.ts +4 -1
  90. package/src/llm/bedrock/index.ts +221 -99
  91. package/src/llm/bedrock/llm.spec.ts +616 -0
  92. package/src/llm/bedrock/types.ts +51 -0
  93. package/src/llm/bedrock/utils/index.ts +18 -0
  94. package/src/llm/bedrock/utils/message_inputs.ts +563 -0
  95. package/src/llm/bedrock/utils/message_outputs.ts +310 -0
  96. package/src/messages/__tests__/tools.test.ts +21 -21
  97. package/src/messages/cache.test.ts +304 -0
  98. package/src/messages/cache.ts +183 -53
  99. package/src/messages/core.ts +1 -1
  100. package/src/messages/tools.ts +2 -2
  101. package/src/schemas/index.ts +2 -0
  102. package/src/schemas/validate.test.ts +358 -0
  103. package/src/schemas/validate.ts +238 -0
  104. package/src/scripts/caching.ts +27 -19
  105. package/src/scripts/code_exec_files.ts +58 -15
  106. package/src/scripts/code_exec_multi_session.ts +241 -0
  107. package/src/scripts/code_exec_session.ts +282 -0
  108. package/src/scripts/multi-agent-conditional.ts +1 -0
  109. package/src/scripts/multi-agent-supervisor.ts +1 -0
  110. package/src/scripts/programmatic_exec_agent.ts +4 -4
  111. package/src/scripts/test-handoff-preamble.ts +277 -0
  112. package/src/scripts/test-parallel-handoffs.ts +291 -0
  113. package/src/scripts/test-tools-before-handoff.ts +8 -4
  114. package/src/scripts/test_code_api.ts +361 -0
  115. package/src/scripts/thinking-bedrock.ts +159 -0
  116. package/src/scripts/thinking.ts +39 -18
  117. package/src/scripts/{tool_search_regex.ts → tool_search.ts} +5 -5
  118. package/src/scripts/tools.ts +7 -3
  119. package/src/specs/cache.simple.test.ts +396 -0
  120. package/src/stream.ts +4 -2
  121. package/src/tools/BrowserTools.ts +39 -17
  122. package/src/tools/CodeExecutor.ts +26 -23
  123. package/src/tools/ProgrammaticToolCalling.ts +18 -14
  124. package/src/tools/ToolNode.ts +114 -1
  125. package/src/tools/ToolSearch.ts +1041 -0
  126. package/src/tools/__tests__/ProgrammaticToolCalling.test.ts +0 -2
  127. package/src/tools/__tests__/{ToolSearchRegex.integration.test.ts → ToolSearch.integration.test.ts} +6 -6
  128. package/src/tools/__tests__/ToolSearch.test.ts +1003 -0
  129. package/src/types/graph.test.ts +183 -0
  130. package/src/types/graph.ts +73 -0
  131. package/src/types/llm.ts +3 -1
  132. package/src/types/tools.ts +51 -2
  133. package/dist/cjs/tools/ToolSearchRegex.cjs +0 -455
  134. package/dist/cjs/tools/ToolSearchRegex.cjs.map +0 -1
  135. package/dist/esm/tools/ToolSearchRegex.mjs +0 -448
  136. package/dist/esm/tools/ToolSearchRegex.mjs.map +0 -1
  137. package/dist/types/tools/ToolSearchRegex.d.ts +0 -80
  138. package/src/tools/ToolSearchRegex.ts +0 -535
  139. package/src/tools/__tests__/ToolSearchRegex.test.ts +0 -232
@@ -1,232 +0,0 @@
1
- // src/tools/__tests__/ToolSearchRegex.test.ts
2
- /**
3
- * Unit tests for Tool Search Regex.
4
- * Tests helper functions and sanitization logic without hitting the API.
5
- */
6
- import { describe, it, expect } from '@jest/globals';
7
- import {
8
- sanitizeRegex,
9
- escapeRegexSpecialChars,
10
- isDangerousPattern,
11
- countNestedGroups,
12
- hasNestedQuantifiers,
13
- } from '../ToolSearchRegex';
14
-
15
- describe('ToolSearchRegex', () => {
16
- describe('escapeRegexSpecialChars', () => {
17
- it('escapes special regex characters', () => {
18
- expect(escapeRegexSpecialChars('hello.world')).toBe('hello\\.world');
19
- expect(escapeRegexSpecialChars('test*pattern')).toBe('test\\*pattern');
20
- expect(escapeRegexSpecialChars('query+result')).toBe('query\\+result');
21
- expect(escapeRegexSpecialChars('a?b')).toBe('a\\?b');
22
- expect(escapeRegexSpecialChars('(group)')).toBe('\\(group\\)');
23
- expect(escapeRegexSpecialChars('[abc]')).toBe('\\[abc\\]');
24
- expect(escapeRegexSpecialChars('a|b')).toBe('a\\|b');
25
- expect(escapeRegexSpecialChars('a^b$c')).toBe('a\\^b\\$c');
26
- expect(escapeRegexSpecialChars('a{2,3}')).toBe('a\\{2,3\\}');
27
- });
28
-
29
- it('handles empty string', () => {
30
- expect(escapeRegexSpecialChars('')).toBe('');
31
- });
32
-
33
- it('handles string with no special chars', () => {
34
- expect(escapeRegexSpecialChars('hello_world')).toBe('hello_world');
35
- expect(escapeRegexSpecialChars('test123')).toBe('test123');
36
- });
37
-
38
- it('handles multiple consecutive special chars', () => {
39
- expect(escapeRegexSpecialChars('...')).toBe('\\.\\.\\.');
40
- expect(escapeRegexSpecialChars('***')).toBe('\\*\\*\\*');
41
- });
42
- });
43
-
44
- describe('countNestedGroups', () => {
45
- it('counts simple nesting', () => {
46
- expect(countNestedGroups('(a)')).toBe(1);
47
- expect(countNestedGroups('((a))')).toBe(2);
48
- expect(countNestedGroups('(((a)))')).toBe(3);
49
- });
50
-
51
- it('counts maximum depth with multiple groups', () => {
52
- expect(countNestedGroups('(a)(b)(c)')).toBe(1);
53
- expect(countNestedGroups('(a(b)c)')).toBe(2);
54
- expect(countNestedGroups('(a(b(c)))')).toBe(3);
55
- });
56
-
57
- it('handles mixed nesting levels', () => {
58
- expect(countNestedGroups('(a)((b)(c))')).toBe(2);
59
- expect(countNestedGroups('((a)(b))((c))')).toBe(2);
60
- });
61
-
62
- it('ignores escaped parentheses', () => {
63
- expect(countNestedGroups('\\(not a group\\)')).toBe(0);
64
- expect(countNestedGroups('(a\\(b\\)c)')).toBe(1);
65
- });
66
-
67
- it('handles no groups', () => {
68
- expect(countNestedGroups('abc')).toBe(0);
69
- expect(countNestedGroups('test.*pattern')).toBe(0);
70
- });
71
-
72
- it('handles unbalanced groups', () => {
73
- expect(countNestedGroups('((a)')).toBe(2);
74
- expect(countNestedGroups('(a))')).toBe(1);
75
- });
76
- });
77
-
78
- describe('hasNestedQuantifiers', () => {
79
- it('detects nested quantifiers', () => {
80
- expect(hasNestedQuantifiers('(a+)+')).toBe(true);
81
- expect(hasNestedQuantifiers('(a*)*')).toBe(true);
82
- expect(hasNestedQuantifiers('(a+)*')).toBe(true);
83
- expect(hasNestedQuantifiers('(a*)?')).toBe(true);
84
- });
85
-
86
- it('allows safe quantifiers', () => {
87
- expect(hasNestedQuantifiers('a+')).toBe(false);
88
- expect(hasNestedQuantifiers('(abc)+')).toBe(false);
89
- expect(hasNestedQuantifiers('a+b*c?')).toBe(false);
90
- });
91
-
92
- it('handles complex patterns', () => {
93
- expect(hasNestedQuantifiers('(a|b)+')).toBe(false);
94
- // Note: This pattern might not be detected by the simple regex check
95
- const complexPattern = '((a|b)+)+';
96
- const result = hasNestedQuantifiers(complexPattern);
97
- // Just verify it doesn't crash - detection may vary
98
- expect(typeof result).toBe('boolean');
99
- });
100
- });
101
-
102
- describe('isDangerousPattern', () => {
103
- it('detects nested quantifiers', () => {
104
- expect(isDangerousPattern('(a+)+')).toBe(true);
105
- expect(isDangerousPattern('(a*)*')).toBe(true);
106
- expect(isDangerousPattern('(.+)+')).toBe(true);
107
- expect(isDangerousPattern('(.*)*')).toBe(true);
108
- });
109
-
110
- it('detects excessive nesting', () => {
111
- expect(isDangerousPattern('((((((a))))))')).toBe(true); // Depth > 5
112
- });
113
-
114
- it('detects excessive wildcards', () => {
115
- const pattern = '.{1000,}';
116
- expect(isDangerousPattern(pattern)).toBe(true);
117
- });
118
-
119
- it('allows safe patterns', () => {
120
- expect(isDangerousPattern('weather')).toBe(false);
121
- expect(isDangerousPattern('get_.*_data')).toBe(false);
122
- expect(isDangerousPattern('(a|b|c)')).toBe(false);
123
- expect(isDangerousPattern('test\\d+')).toBe(false);
124
- });
125
-
126
- it('detects various dangerous patterns', () => {
127
- expect(isDangerousPattern('(.*)+')).toBe(true);
128
- expect(isDangerousPattern('(.+)*')).toBe(true);
129
- });
130
- });
131
-
132
- describe('sanitizeRegex', () => {
133
- it('returns safe pattern unchanged', () => {
134
- const result = sanitizeRegex('weather');
135
- expect(result.safe).toBe('weather');
136
- expect(result.wasEscaped).toBe(false);
137
- });
138
-
139
- it('escapes dangerous patterns', () => {
140
- const result = sanitizeRegex('(a+)+');
141
- expect(result.safe).toBe('\\(a\\+\\)\\+');
142
- expect(result.wasEscaped).toBe(true);
143
- });
144
-
145
- it('escapes invalid regex', () => {
146
- const result = sanitizeRegex('(unclosed');
147
- expect(result.wasEscaped).toBe(true);
148
- expect(result.safe).toContain('\\(');
149
- });
150
-
151
- it('allows complex but safe patterns', () => {
152
- const result = sanitizeRegex('get_[a-z]+_data');
153
- expect(result.safe).toBe('get_[a-z]+_data');
154
- expect(result.wasEscaped).toBe(false);
155
- });
156
-
157
- it('handles alternation patterns', () => {
158
- const result = sanitizeRegex('weather|forecast');
159
- expect(result.safe).toBe('weather|forecast');
160
- expect(result.wasEscaped).toBe(false);
161
- });
162
- });
163
-
164
- describe('Pattern Validation Edge Cases', () => {
165
- it('handles empty pattern', () => {
166
- expect(countNestedGroups('')).toBe(0);
167
- expect(hasNestedQuantifiers('')).toBe(false);
168
- expect(isDangerousPattern('')).toBe(false);
169
- });
170
-
171
- it('handles pattern with only quantifiers', () => {
172
- expect(hasNestedQuantifiers('+++')).toBe(false);
173
- expect(hasNestedQuantifiers('***')).toBe(false);
174
- });
175
-
176
- it('handles escaped special sequences', () => {
177
- const result = sanitizeRegex('\\d+\\w*\\s?');
178
- expect(result.wasEscaped).toBe(false);
179
- });
180
-
181
- it('sanitizes exponential backtracking patterns', () => {
182
- // These can cause catastrophic backtracking
183
- expect(isDangerousPattern('(a+)+')).toBe(true);
184
- expect(isDangerousPattern('(a*)*')).toBe(true);
185
- expect(isDangerousPattern('(.*)*')).toBe(true);
186
- });
187
- });
188
-
189
- describe('Real-World Pattern Examples', () => {
190
- it('handles common search patterns safely', () => {
191
- const safePatterns = [
192
- 'expense',
193
- 'weather|forecast',
194
- 'data.*query',
195
- '_tool$',
196
- ];
197
-
198
- for (const pattern of safePatterns) {
199
- const result = sanitizeRegex(pattern);
200
- expect(result.wasEscaped).toBe(false);
201
- }
202
- });
203
-
204
- it('escapes clearly dangerous patterns', () => {
205
- const dangerousPatterns = ['(a+)+', '(.*)+', '(.+)*'];
206
-
207
- for (const pattern of dangerousPatterns) {
208
- const result = sanitizeRegex(pattern);
209
- expect(result.wasEscaped).toBe(true);
210
- }
211
- });
212
-
213
- it('handles patterns that may or may not be escaped', () => {
214
- // These patterns might be escaped depending on validation logic
215
- const edgeCasePatterns = [
216
- '(?i)email',
217
- '^create_',
218
- 'get_[a-z]+_info',
219
- 'get_.*',
220
- '((((((a))))))',
221
- '(a|a)*',
222
- ];
223
-
224
- for (const pattern of edgeCasePatterns) {
225
- const result = sanitizeRegex(pattern);
226
- // Just verify it returns a result without crashing
227
- expect(typeof result.safe).toBe('string');
228
- expect(typeof result.wasEscaped).toBe('boolean');
229
- }
230
- });
231
- });
232
- });