@hazeljs/agent 0.2.0-beta.1

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 (117) hide show
  1. package/IMPLEMENTATION_SUMMARY.md +400 -0
  2. package/PERSISTENCE.md +201 -0
  3. package/PRISMA_INTEGRATION.md +499 -0
  4. package/PRODUCTION_READINESS.md +264 -0
  5. package/QUICKSTART.md +135 -0
  6. package/README.md +427 -0
  7. package/STATE_VS_MEMORY.md +243 -0
  8. package/dist/agent.module.d.ts +42 -0
  9. package/dist/agent.module.d.ts.map +1 -0
  10. package/dist/agent.module.js +90 -0
  11. package/dist/agent.module.js.map +1 -0
  12. package/dist/context/agent.context.d.ts +27 -0
  13. package/dist/context/agent.context.d.ts.map +1 -0
  14. package/dist/context/agent.context.js +98 -0
  15. package/dist/context/agent.context.js.map +1 -0
  16. package/dist/decorators/agent.decorator.d.ts +21 -0
  17. package/dist/decorators/agent.decorator.d.ts.map +1 -0
  18. package/dist/decorators/agent.decorator.js +38 -0
  19. package/dist/decorators/agent.decorator.js.map +1 -0
  20. package/dist/decorators/tool.decorator.d.ts +23 -0
  21. package/dist/decorators/tool.decorator.d.ts.map +1 -0
  22. package/dist/decorators/tool.decorator.js +61 -0
  23. package/dist/decorators/tool.decorator.js.map +1 -0
  24. package/dist/events/event.emitter.d.ts +45 -0
  25. package/dist/events/event.emitter.d.ts.map +1 -0
  26. package/dist/events/event.emitter.js +96 -0
  27. package/dist/events/event.emitter.js.map +1 -0
  28. package/dist/executor/agent.executor.d.ts +57 -0
  29. package/dist/executor/agent.executor.d.ts.map +1 -0
  30. package/dist/executor/agent.executor.js +303 -0
  31. package/dist/executor/agent.executor.js.map +1 -0
  32. package/dist/executor/tool.executor.d.ts +53 -0
  33. package/dist/executor/tool.executor.d.ts.map +1 -0
  34. package/dist/executor/tool.executor.js +234 -0
  35. package/dist/executor/tool.executor.js.map +1 -0
  36. package/dist/index.d.ts +30 -0
  37. package/dist/index.d.ts.map +1 -0
  38. package/dist/index.js +46 -0
  39. package/dist/index.js.map +1 -0
  40. package/dist/registry/agent.registry.d.ts +49 -0
  41. package/dist/registry/agent.registry.d.ts.map +1 -0
  42. package/dist/registry/agent.registry.js +90 -0
  43. package/dist/registry/agent.registry.js.map +1 -0
  44. package/dist/registry/tool.registry.d.ts +54 -0
  45. package/dist/registry/tool.registry.d.ts.map +1 -0
  46. package/dist/registry/tool.registry.js +153 -0
  47. package/dist/registry/tool.registry.js.map +1 -0
  48. package/dist/runtime/agent.runtime.d.ts +155 -0
  49. package/dist/runtime/agent.runtime.d.ts.map +1 -0
  50. package/dist/runtime/agent.runtime.extensions.d.ts +49 -0
  51. package/dist/runtime/agent.runtime.extensions.d.ts.map +1 -0
  52. package/dist/runtime/agent.runtime.extensions.js +93 -0
  53. package/dist/runtime/agent.runtime.extensions.js.map +1 -0
  54. package/dist/runtime/agent.runtime.js +347 -0
  55. package/dist/runtime/agent.runtime.js.map +1 -0
  56. package/dist/state/agent-state.interface.d.ts +63 -0
  57. package/dist/state/agent-state.interface.d.ts.map +1 -0
  58. package/dist/state/agent-state.interface.js +7 -0
  59. package/dist/state/agent-state.interface.js.map +1 -0
  60. package/dist/state/agent.state.d.ts +67 -0
  61. package/dist/state/agent.state.d.ts.map +1 -0
  62. package/dist/state/agent.state.js +172 -0
  63. package/dist/state/agent.state.js.map +1 -0
  64. package/dist/state/database-state.manager.d.ts +63 -0
  65. package/dist/state/database-state.manager.d.ts.map +1 -0
  66. package/dist/state/database-state.manager.js +282 -0
  67. package/dist/state/database-state.manager.js.map +1 -0
  68. package/dist/state/redis-state.manager.d.ts +81 -0
  69. package/dist/state/redis-state.manager.d.ts.map +1 -0
  70. package/dist/state/redis-state.manager.js +253 -0
  71. package/dist/state/redis-state.manager.js.map +1 -0
  72. package/dist/types/agent.types.d.ts +151 -0
  73. package/dist/types/agent.types.d.ts.map +1 -0
  74. package/dist/types/agent.types.js +32 -0
  75. package/dist/types/agent.types.js.map +1 -0
  76. package/dist/types/event.types.d.ts +123 -0
  77. package/dist/types/event.types.d.ts.map +1 -0
  78. package/dist/types/event.types.js +30 -0
  79. package/dist/types/event.types.js.map +1 -0
  80. package/dist/types/llm.types.d.ts +66 -0
  81. package/dist/types/llm.types.d.ts.map +1 -0
  82. package/dist/types/llm.types.js +7 -0
  83. package/dist/types/llm.types.js.map +1 -0
  84. package/dist/types/rag.types.d.ts +40 -0
  85. package/dist/types/rag.types.d.ts.map +1 -0
  86. package/dist/types/rag.types.js +7 -0
  87. package/dist/types/rag.types.js.map +1 -0
  88. package/dist/types/tool.types.d.ts +118 -0
  89. package/dist/types/tool.types.d.ts.map +1 -0
  90. package/dist/types/tool.types.js +19 -0
  91. package/dist/types/tool.types.js.map +1 -0
  92. package/dist/utils/circuit-breaker.d.ts +69 -0
  93. package/dist/utils/circuit-breaker.d.ts.map +1 -0
  94. package/dist/utils/circuit-breaker.js +156 -0
  95. package/dist/utils/circuit-breaker.js.map +1 -0
  96. package/dist/utils/health-check.d.ts +71 -0
  97. package/dist/utils/health-check.d.ts.map +1 -0
  98. package/dist/utils/health-check.js +156 -0
  99. package/dist/utils/health-check.js.map +1 -0
  100. package/dist/utils/logger.d.ts +53 -0
  101. package/dist/utils/logger.d.ts.map +1 -0
  102. package/dist/utils/logger.js +133 -0
  103. package/dist/utils/logger.js.map +1 -0
  104. package/dist/utils/metrics.d.ts +90 -0
  105. package/dist/utils/metrics.d.ts.map +1 -0
  106. package/dist/utils/metrics.js +186 -0
  107. package/dist/utils/metrics.js.map +1 -0
  108. package/dist/utils/rate-limiter.d.ts +44 -0
  109. package/dist/utils/rate-limiter.d.ts.map +1 -0
  110. package/dist/utils/rate-limiter.js +82 -0
  111. package/dist/utils/rate-limiter.js.map +1 -0
  112. package/dist/utils/retry.d.ts +42 -0
  113. package/dist/utils/retry.d.ts.map +1 -0
  114. package/dist/utils/retry.js +103 -0
  115. package/dist/utils/retry.js.map +1 -0
  116. package/package.json +58 -0
  117. package/prisma-schema.example.prisma +76 -0
@@ -0,0 +1,303 @@
1
+ "use strict";
2
+ /**
3
+ * Agent Executor
4
+ * Core execution loop for agents
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.AgentExecutor = void 0;
8
+ const crypto_1 = require("crypto");
9
+ const agent_types_1 = require("../types/agent.types");
10
+ const event_types_1 = require("../types/event.types");
11
+ /**
12
+ * Agent Executor
13
+ * Implements the core agent execution loop
14
+ */
15
+ class AgentExecutor {
16
+ constructor(stateManager, contextBuilder, toolExecutor, toolRegistry, llmProvider, eventEmitter) {
17
+ this.stateManager = stateManager;
18
+ this.contextBuilder = contextBuilder;
19
+ this.toolExecutor = toolExecutor;
20
+ this.toolRegistry = toolRegistry;
21
+ this.llmProvider = llmProvider;
22
+ this.eventEmitter = eventEmitter;
23
+ }
24
+ /**
25
+ * Helper to handle both sync and async state manager calls
26
+ */
27
+ async unwrap(value) {
28
+ return value instanceof Promise ? await value : value;
29
+ }
30
+ /**
31
+ * Execute agent with controlled loop
32
+ */
33
+ async execute(context, maxSteps = 10) {
34
+ const startTime = Date.now();
35
+ try {
36
+ this.emitEvent(event_types_1.AgentEventType.EXECUTION_STARTED, context.executionId, {
37
+ input: context.input,
38
+ sessionId: context.sessionId,
39
+ userId: context.userId,
40
+ options: context.metadata,
41
+ });
42
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.THINKING));
43
+ let stepNumber = 0;
44
+ let finalResponse;
45
+ while (await this.unwrap(this.stateManager.canContinue(context.executionId, maxSteps))) {
46
+ stepNumber++;
47
+ const step = await this.executeStep(context, stepNumber);
48
+ await this.unwrap(this.stateManager.addStep(context.executionId, step));
49
+ if (step.state === agent_types_1.AgentState.COMPLETED) {
50
+ finalResponse = step.action?.response;
51
+ break;
52
+ }
53
+ if (step.state === agent_types_1.AgentState.FAILED) {
54
+ throw step.error || new Error('Step failed without error');
55
+ }
56
+ if (step.state === agent_types_1.AgentState.WAITING_FOR_APPROVAL) {
57
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.WAITING_FOR_APPROVAL));
58
+ break;
59
+ }
60
+ if (step.state === agent_types_1.AgentState.WAITING_FOR_INPUT) {
61
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.WAITING_FOR_INPUT));
62
+ break;
63
+ }
64
+ }
65
+ if (stepNumber >= maxSteps) {
66
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.FAILED));
67
+ throw new Error(`Maximum steps (${maxSteps}) exceeded`);
68
+ }
69
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.COMPLETED));
70
+ const duration = Date.now() - startTime;
71
+ this.emitEvent(event_types_1.AgentEventType.EXECUTION_COMPLETED, context.executionId, {
72
+ response: finalResponse,
73
+ steps: stepNumber,
74
+ duration,
75
+ });
76
+ return {
77
+ executionId: context.executionId,
78
+ agentId: context.agentId,
79
+ state: agent_types_1.AgentState.COMPLETED,
80
+ response: finalResponse,
81
+ steps: context.steps,
82
+ metadata: context.metadata,
83
+ duration,
84
+ completedAt: new Date(),
85
+ };
86
+ }
87
+ catch (error) {
88
+ await this.unwrap(this.stateManager.updateState(context.executionId, agent_types_1.AgentState.FAILED));
89
+ const duration = Date.now() - startTime;
90
+ this.emitEvent(event_types_1.AgentEventType.EXECUTION_FAILED, context.executionId, {
91
+ error: error,
92
+ step: context.steps.length,
93
+ duration,
94
+ });
95
+ return {
96
+ executionId: context.executionId,
97
+ agentId: context.agentId,
98
+ state: agent_types_1.AgentState.FAILED,
99
+ error: error,
100
+ steps: context.steps,
101
+ metadata: context.metadata,
102
+ duration,
103
+ completedAt: new Date(),
104
+ };
105
+ }
106
+ }
107
+ /**
108
+ * Execute a single step
109
+ */
110
+ async executeStep(context, stepNumber) {
111
+ const stepId = (0, crypto_1.randomUUID)();
112
+ const startTime = Date.now();
113
+ const step = {
114
+ id: stepId,
115
+ agentId: context.agentId,
116
+ executionId: context.executionId,
117
+ stepNumber,
118
+ state: agent_types_1.AgentState.THINKING,
119
+ timestamp: new Date(),
120
+ };
121
+ this.emitEvent(event_types_1.AgentEventType.STEP_STARTED, context.executionId, {
122
+ stepNumber,
123
+ state: step.state,
124
+ });
125
+ try {
126
+ const action = await this.decideNextAction(context);
127
+ step.action = action;
128
+ switch (action.type) {
129
+ case agent_types_1.AgentActionType.USE_TOOL:
130
+ step.state = agent_types_1.AgentState.USING_TOOL;
131
+ step.result = await this.executeTool(context, action);
132
+ break;
133
+ case agent_types_1.AgentActionType.ASK_USER:
134
+ step.state = agent_types_1.AgentState.WAITING_FOR_INPUT;
135
+ this.emitEvent(event_types_1.AgentEventType.USER_INPUT_REQUESTED, context.executionId, {
136
+ question: action.question,
137
+ });
138
+ break;
139
+ case agent_types_1.AgentActionType.RESPOND:
140
+ step.state = agent_types_1.AgentState.COMPLETED;
141
+ step.result = {
142
+ success: true,
143
+ output: action.response,
144
+ };
145
+ break;
146
+ case agent_types_1.AgentActionType.WAIT:
147
+ step.state = agent_types_1.AgentState.WAITING_FOR_APPROVAL;
148
+ break;
149
+ case agent_types_1.AgentActionType.COMPLETE:
150
+ step.state = agent_types_1.AgentState.COMPLETED;
151
+ step.result = {
152
+ success: true,
153
+ output: action.response,
154
+ };
155
+ break;
156
+ default:
157
+ step.state = agent_types_1.AgentState.THINKING;
158
+ }
159
+ step.duration = Date.now() - startTime;
160
+ this.emitEvent(event_types_1.AgentEventType.STEP_COMPLETED, context.executionId, {
161
+ stepNumber,
162
+ state: step.state,
163
+ action,
164
+ result: step.result,
165
+ });
166
+ return step;
167
+ }
168
+ catch (error) {
169
+ step.state = agent_types_1.AgentState.FAILED;
170
+ step.error = error;
171
+ step.duration = Date.now() - startTime;
172
+ this.emitEvent(event_types_1.AgentEventType.STEP_FAILED, context.executionId, {
173
+ stepNumber,
174
+ state: step.state,
175
+ error: error.message,
176
+ });
177
+ return step;
178
+ }
179
+ }
180
+ /**
181
+ * Decide next action using LLM
182
+ */
183
+ async decideNextAction(context) {
184
+ if (!this.llmProvider) {
185
+ return {
186
+ type: agent_types_1.AgentActionType.RESPOND,
187
+ response: 'No LLM provider configured',
188
+ };
189
+ }
190
+ const prompt = this.buildPrompt(context);
191
+ const tools = this.toolRegistry.getToolDefinitionsForLLM(context.agentId);
192
+ try {
193
+ const response = await this.llmProvider.chat({
194
+ messages: [
195
+ { role: 'system', content: prompt.system },
196
+ ...prompt.messages,
197
+ { role: 'user', content: context.input },
198
+ ],
199
+ tools: tools.length > 0 ? tools : undefined,
200
+ });
201
+ if (response.tool_calls && response.tool_calls.length > 0) {
202
+ const toolCall = response.tool_calls[0];
203
+ return {
204
+ type: agent_types_1.AgentActionType.USE_TOOL,
205
+ toolName: toolCall.function.name,
206
+ toolInput: JSON.parse(toolCall.function.arguments),
207
+ thought: response.content,
208
+ };
209
+ }
210
+ return {
211
+ type: agent_types_1.AgentActionType.RESPOND,
212
+ response: response.content,
213
+ };
214
+ }
215
+ catch {
216
+ return {
217
+ type: agent_types_1.AgentActionType.RESPOND,
218
+ response: 'I encountered an error while processing your request.',
219
+ };
220
+ }
221
+ }
222
+ /**
223
+ * Execute a tool
224
+ */
225
+ async executeTool(context, action) {
226
+ if (!action.toolName || !action.toolInput) {
227
+ return {
228
+ success: false,
229
+ error: 'Tool name or input missing',
230
+ };
231
+ }
232
+ const fullToolName = `${context.agentId}.${action.toolName}`;
233
+ const tool = this.toolRegistry.getTool(fullToolName);
234
+ if (!tool) {
235
+ return {
236
+ success: false,
237
+ error: `Tool ${action.toolName} not found`,
238
+ };
239
+ }
240
+ const result = await this.toolExecutor.execute(tool, action.toolInput, context.agentId, context.sessionId, context.userId);
241
+ await this.unwrap(this.stateManager.addMessage(context.executionId, 'tool', JSON.stringify({
242
+ tool: action.toolName,
243
+ input: action.toolInput,
244
+ output: result.output,
245
+ })));
246
+ return {
247
+ success: result.success,
248
+ output: result.output,
249
+ error: result.error?.message,
250
+ metadata: {
251
+ duration: result.duration,
252
+ },
253
+ };
254
+ }
255
+ /**
256
+ * Build prompt for LLM
257
+ */
258
+ buildPrompt(context) {
259
+ let systemPrompt = context.metadata?.systemPrompt || 'You are a helpful AI agent.';
260
+ if (context.metadata?.agentDescription) {
261
+ systemPrompt += `\n\nAgent description: ${context.metadata.agentDescription}`;
262
+ }
263
+ if (context.ragContext && context.ragContext.length > 0) {
264
+ systemPrompt += '\n\nRelevant context:\n' + context.ragContext.join('\n\n');
265
+ }
266
+ const messages = context.memory.conversationHistory.map((msg) => ({
267
+ role: msg.role,
268
+ content: msg.content,
269
+ }));
270
+ return {
271
+ system: systemPrompt,
272
+ messages,
273
+ };
274
+ }
275
+ /**
276
+ * Resume execution after pause
277
+ */
278
+ async resume(executionId, input) {
279
+ const contextResult = this.stateManager.getContext(executionId);
280
+ const context = await this.unwrap(contextResult);
281
+ if (!context) {
282
+ throw new Error(`Execution context ${executionId} not found`);
283
+ }
284
+ if (input) {
285
+ await this.unwrap(this.stateManager.addMessage(executionId, 'user', input));
286
+ this.emitEvent(event_types_1.AgentEventType.USER_INPUT_RECEIVED, executionId, {
287
+ response: input,
288
+ });
289
+ }
290
+ await this.unwrap(this.stateManager.updateState(executionId, agent_types_1.AgentState.THINKING));
291
+ return this.execute(context);
292
+ }
293
+ /**
294
+ * Emit event
295
+ */
296
+ emitEvent(type, executionId, data) {
297
+ if (this.eventEmitter) {
298
+ this.eventEmitter(type, executionId, data);
299
+ }
300
+ }
301
+ }
302
+ exports.AgentExecutor = AgentExecutor;
303
+ //# sourceMappingURL=agent.executor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.executor.js","sourceRoot":"","sources":["../../src/executor/agent.executor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Tool Executor
3
+ * Executes tools with approval workflow and error handling
4
+ */
5
+ import { ToolExecutionResult, ToolApprovalRequest, ToolMetadata } from '../types/tool.types';
6
+ import { AgentEventType } from '../types/event.types';
7
+ /**
8
+ * Tool Executor
9
+ * Handles tool execution with approval and retry logic
10
+ */
11
+ export declare class ToolExecutor {
12
+ private eventEmitter?;
13
+ private pendingApprovals;
14
+ private executionContexts;
15
+ constructor(eventEmitter?: ((type: AgentEventType, data: unknown) => void) | undefined);
16
+ /**
17
+ * Execute a tool
18
+ */
19
+ execute(tool: ToolMetadata, input: Record<string, unknown>, agentId: string, sessionId: string, userId?: string): Promise<ToolExecutionResult>;
20
+ /**
21
+ * Execute tool with retry logic
22
+ */
23
+ private executeWithRetry;
24
+ /**
25
+ * Execute tool with timeout
26
+ */
27
+ private executeWithTimeout;
28
+ /**
29
+ * Request approval for tool execution
30
+ */
31
+ private requestApproval;
32
+ /**
33
+ * Approve a tool execution
34
+ */
35
+ approveExecution(requestId: string, approvedBy: string): void;
36
+ /**
37
+ * Reject a tool execution
38
+ */
39
+ rejectExecution(requestId: string): void;
40
+ /**
41
+ * Get pending approval requests
42
+ */
43
+ getPendingApprovals(): ToolApprovalRequest[];
44
+ /**
45
+ * Emit event
46
+ */
47
+ private emitEvent;
48
+ /**
49
+ * Delay helper
50
+ */
51
+ private delay;
52
+ }
53
+ //# sourceMappingURL=tool.executor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.executor.d.ts","sourceRoot":"","sources":["../../src/executor/tool.executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAEL,mBAAmB,EAEnB,mBAAmB,EACnB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,YAAY,CAAC;IAHjC,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,iBAAiB,CAAgD;gBAErD,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,aAAA;IAEhF;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC;IA4F/B;;OAEG;YACW,gBAAgB;IAwB9B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,eAAe;IA+D7B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ7D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACH,mBAAmB,IAAI,mBAAmB,EAAE;IAI5C;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}
@@ -0,0 +1,234 @@
1
+ "use strict";
2
+ /**
3
+ * Tool Executor
4
+ * Executes tools with approval workflow and error handling
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.ToolExecutor = void 0;
8
+ const crypto_1 = require("crypto");
9
+ const tool_types_1 = require("../types/tool.types");
10
+ const event_types_1 = require("../types/event.types");
11
+ /**
12
+ * Tool Executor
13
+ * Handles tool execution with approval and retry logic
14
+ */
15
+ class ToolExecutor {
16
+ constructor(eventEmitter) {
17
+ this.eventEmitter = eventEmitter;
18
+ this.pendingApprovals = new Map();
19
+ this.executionContexts = new Map();
20
+ }
21
+ /**
22
+ * Execute a tool
23
+ */
24
+ async execute(tool, input, agentId, sessionId, userId) {
25
+ const executionId = (0, crypto_1.randomUUID)();
26
+ const startTime = Date.now();
27
+ const context = {
28
+ executionId,
29
+ toolName: tool.name,
30
+ agentId,
31
+ sessionId,
32
+ userId,
33
+ input,
34
+ status: tool_types_1.ToolExecutionStatus.PENDING,
35
+ startedAt: new Date(),
36
+ };
37
+ this.executionContexts.set(executionId, context);
38
+ this.emitEvent(event_types_1.AgentEventType.TOOL_EXECUTION_STARTED, {
39
+ toolName: tool.name,
40
+ input,
41
+ });
42
+ try {
43
+ if (tool.requiresApproval) {
44
+ const approved = await this.requestApproval(tool, input, agentId, executionId);
45
+ if (!approved) {
46
+ context.status = tool_types_1.ToolExecutionStatus.REJECTED;
47
+ this.emitEvent(event_types_1.AgentEventType.TOOL_APPROVAL_DENIED, {
48
+ requestId: executionId,
49
+ toolName: tool.name,
50
+ input,
51
+ });
52
+ return {
53
+ success: false,
54
+ error: new Error('Tool execution rejected by user'),
55
+ duration: Date.now() - startTime,
56
+ };
57
+ }
58
+ context.status = tool_types_1.ToolExecutionStatus.APPROVED;
59
+ this.emitEvent(event_types_1.AgentEventType.TOOL_APPROVAL_GRANTED, {
60
+ requestId: executionId,
61
+ toolName: tool.name,
62
+ input,
63
+ });
64
+ }
65
+ context.status = tool_types_1.ToolExecutionStatus.EXECUTING;
66
+ const result = await this.executeWithRetry(tool, input, tool.retries || 0);
67
+ context.status = tool_types_1.ToolExecutionStatus.COMPLETED;
68
+ context.completedAt = new Date();
69
+ context.duration = Date.now() - startTime;
70
+ this.emitEvent(event_types_1.AgentEventType.TOOL_EXECUTION_COMPLETED, {
71
+ toolName: tool.name,
72
+ input,
73
+ output: result,
74
+ duration: context.duration,
75
+ });
76
+ return {
77
+ success: true,
78
+ output: result,
79
+ duration: context.duration,
80
+ };
81
+ }
82
+ catch (error) {
83
+ context.status = tool_types_1.ToolExecutionStatus.FAILED;
84
+ context.completedAt = new Date();
85
+ context.duration = Date.now() - startTime;
86
+ this.emitEvent(event_types_1.AgentEventType.TOOL_EXECUTION_FAILED, {
87
+ toolName: tool.name,
88
+ input,
89
+ error: error.message,
90
+ duration: context.duration,
91
+ });
92
+ return {
93
+ success: false,
94
+ error: error,
95
+ duration: context.duration,
96
+ };
97
+ }
98
+ finally {
99
+ this.executionContexts.delete(executionId);
100
+ }
101
+ }
102
+ /**
103
+ * Execute tool with retry logic
104
+ */
105
+ async executeWithRetry(tool, input, maxRetries) {
106
+ let lastError;
107
+ for (let attempt = 0; attempt <= maxRetries; attempt++) {
108
+ try {
109
+ const timeout = tool.timeout || 30000;
110
+ const result = await this.executeWithTimeout(tool, input, timeout);
111
+ return result;
112
+ }
113
+ catch (error) {
114
+ lastError = error;
115
+ if (attempt < maxRetries) {
116
+ await this.delay(Math.pow(2, attempt) * 1000);
117
+ }
118
+ }
119
+ }
120
+ throw lastError;
121
+ }
122
+ /**
123
+ * Execute tool with timeout
124
+ */
125
+ async executeWithTimeout(tool, input, timeout) {
126
+ let timeoutId;
127
+ try {
128
+ return await Promise.race([
129
+ tool.method.call(tool.target, input),
130
+ new Promise((_, reject) => {
131
+ timeoutId = setTimeout(() => reject(new Error(`Tool execution timeout after ${timeout}ms`)), timeout);
132
+ }),
133
+ ]);
134
+ }
135
+ finally {
136
+ if (timeoutId) {
137
+ clearTimeout(timeoutId);
138
+ }
139
+ }
140
+ }
141
+ /**
142
+ * Request approval for tool execution
143
+ */
144
+ async requestApproval(tool, input, agentId, executionId) {
145
+ const requestId = (0, crypto_1.randomUUID)();
146
+ const request = {
147
+ requestId,
148
+ executionId,
149
+ toolName: tool.name,
150
+ agentId,
151
+ input,
152
+ requestedAt: new Date(),
153
+ expiresAt: new Date(Date.now() + 300000),
154
+ };
155
+ this.pendingApprovals.set(requestId, request);
156
+ this.emitEvent(event_types_1.AgentEventType.TOOL_APPROVAL_REQUESTED, {
157
+ requestId,
158
+ toolName: tool.name,
159
+ input,
160
+ });
161
+ return new Promise((resolve) => {
162
+ const checkInterval = setInterval(() => {
163
+ const req = this.pendingApprovals.get(requestId);
164
+ if (!req) {
165
+ // Request was removed unexpectedly
166
+ clearInterval(checkInterval);
167
+ resolve(false);
168
+ return;
169
+ }
170
+ // Check if approved
171
+ if (req.status === 'approved') {
172
+ this.pendingApprovals.delete(requestId);
173
+ clearInterval(checkInterval);
174
+ resolve(true);
175
+ return;
176
+ }
177
+ // Check if rejected
178
+ if (req.status === 'rejected') {
179
+ this.pendingApprovals.delete(requestId);
180
+ clearInterval(checkInterval);
181
+ resolve(false);
182
+ return;
183
+ }
184
+ // Check if expired
185
+ if (req.expiresAt && req.expiresAt < new Date()) {
186
+ this.pendingApprovals.delete(requestId);
187
+ clearInterval(checkInterval);
188
+ resolve(false);
189
+ }
190
+ }, 1000);
191
+ });
192
+ }
193
+ /**
194
+ * Approve a tool execution
195
+ */
196
+ approveExecution(requestId, approvedBy) {
197
+ const request = this.pendingApprovals.get(requestId);
198
+ if (request) {
199
+ request.status = 'approved';
200
+ request.approvedBy = approvedBy;
201
+ }
202
+ }
203
+ /**
204
+ * Reject a tool execution
205
+ */
206
+ rejectExecution(requestId) {
207
+ const request = this.pendingApprovals.get(requestId);
208
+ if (request) {
209
+ request.status = 'rejected';
210
+ }
211
+ }
212
+ /**
213
+ * Get pending approval requests
214
+ */
215
+ getPendingApprovals() {
216
+ return Array.from(this.pendingApprovals.values());
217
+ }
218
+ /**
219
+ * Emit event
220
+ */
221
+ emitEvent(type, data) {
222
+ if (this.eventEmitter) {
223
+ this.eventEmitter(type, data);
224
+ }
225
+ }
226
+ /**
227
+ * Delay helper
228
+ */
229
+ delay(ms) {
230
+ return new Promise((resolve) => setTimeout(resolve, ms));
231
+ }
232
+ }
233
+ exports.ToolExecutor = ToolExecutor;
234
+ //# sourceMappingURL=tool.executor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.executor.js","sourceRoot":"","sources":["../../src/executor/tool.executor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * @hazeljs/agent
3
+ * AI-native Agent Runtime for HazelJS
4
+ */
5
+ export * from './types/agent.types';
6
+ export * from './types/tool.types';
7
+ export * from './types/event.types';
8
+ export * from './types/llm.types';
9
+ export * from './types/rag.types';
10
+ export * from './decorators/agent.decorator';
11
+ export * from './decorators/tool.decorator';
12
+ export * from './registry/agent.registry';
13
+ export * from './registry/tool.registry';
14
+ export * from './state/agent.state';
15
+ export * from './state/agent-state.interface';
16
+ export * from './state/redis-state.manager';
17
+ export * from './state/database-state.manager';
18
+ export * from './context/agent.context';
19
+ export * from './executor/agent.executor';
20
+ export * from './executor/tool.executor';
21
+ export * from './events/event.emitter';
22
+ export * from './runtime/agent.runtime';
23
+ export * from './utils/rate-limiter';
24
+ export * from './utils/logger';
25
+ export * from './utils/metrics';
26
+ export * from './utils/retry';
27
+ export * from './utils/circuit-breaker';
28
+ export * from './utils/health-check';
29
+ export * from './agent.module';
30
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AAExC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,yBAAyB,CAAC;AAExC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAErC,cAAc,gBAAgB,CAAC"}