@hazeljs/agent 0.2.0-alpha.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 (166) hide show
  1. package/IMPLEMENTATION_SUMMARY.md +400 -0
  2. package/LICENSE +192 -0
  3. package/PERSISTENCE.md +201 -0
  4. package/PRISMA_INTEGRATION.md +499 -0
  5. package/PRODUCTION_READINESS.md +264 -0
  6. package/QUICKSTART.md +135 -0
  7. package/README.md +541 -0
  8. package/STATE_VS_MEMORY.md +243 -0
  9. package/benchmarks/performance.benchmark.ts +157 -0
  10. package/coverage/clover.xml +1508 -0
  11. package/coverage/lcov-report/base.css +224 -0
  12. package/coverage/lcov-report/block-navigation.js +87 -0
  13. package/coverage/lcov-report/favicon.png +0 -0
  14. package/coverage/lcov-report/index.html +296 -0
  15. package/coverage/lcov-report/prettify.css +1 -0
  16. package/coverage/lcov-report/prettify.js +2 -0
  17. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  18. package/coverage/lcov-report/sorter.js +210 -0
  19. package/coverage/lcov.info +2722 -0
  20. package/dist/agent.module.d.ts +57 -0
  21. package/dist/agent.module.d.ts.map +1 -0
  22. package/dist/agent.module.js +99 -0
  23. package/dist/agent.module.js.map +1 -0
  24. package/dist/context/agent.context.d.ts +27 -0
  25. package/dist/context/agent.context.d.ts.map +1 -0
  26. package/dist/context/agent.context.js +98 -0
  27. package/dist/context/agent.context.js.map +1 -0
  28. package/dist/decorators/agent.decorator.d.ts +21 -0
  29. package/dist/decorators/agent.decorator.d.ts.map +1 -0
  30. package/dist/decorators/agent.decorator.js +38 -0
  31. package/dist/decorators/agent.decorator.js.map +1 -0
  32. package/dist/decorators/delegate.decorator.d.ts +66 -0
  33. package/dist/decorators/delegate.decorator.d.ts.map +1 -0
  34. package/dist/decorators/delegate.decorator.js +108 -0
  35. package/dist/decorators/delegate.decorator.js.map +1 -0
  36. package/dist/decorators/tool.decorator.d.ts +23 -0
  37. package/dist/decorators/tool.decorator.d.ts.map +1 -0
  38. package/dist/decorators/tool.decorator.js +61 -0
  39. package/dist/decorators/tool.decorator.js.map +1 -0
  40. package/dist/events/event.emitter.d.ts +45 -0
  41. package/dist/events/event.emitter.d.ts.map +1 -0
  42. package/dist/events/event.emitter.js +96 -0
  43. package/dist/events/event.emitter.js.map +1 -0
  44. package/dist/executor/agent.executor.d.ts +58 -0
  45. package/dist/executor/agent.executor.d.ts.map +1 -0
  46. package/dist/executor/agent.executor.js +312 -0
  47. package/dist/executor/agent.executor.js.map +1 -0
  48. package/dist/executor/tool.executor.d.ts +55 -0
  49. package/dist/executor/tool.executor.d.ts.map +1 -0
  50. package/dist/executor/tool.executor.js +266 -0
  51. package/dist/executor/tool.executor.js.map +1 -0
  52. package/dist/graph/agent-graph.d.ts +131 -0
  53. package/dist/graph/agent-graph.d.ts.map +1 -0
  54. package/dist/graph/agent-graph.js +462 -0
  55. package/dist/graph/agent-graph.js.map +1 -0
  56. package/dist/graph/agent-graph.types.d.ts +210 -0
  57. package/dist/graph/agent-graph.types.d.ts.map +1 -0
  58. package/dist/graph/agent-graph.types.js +12 -0
  59. package/dist/graph/agent-graph.types.js.map +1 -0
  60. package/dist/index.d.ts +34 -0
  61. package/dist/index.d.ts.map +1 -0
  62. package/dist/index.js +51 -0
  63. package/dist/index.js.map +1 -0
  64. package/dist/prompts/agent-system.prompt.d.ts +10 -0
  65. package/dist/prompts/agent-system.prompt.d.ts.map +1 -0
  66. package/dist/prompts/agent-system.prompt.js +18 -0
  67. package/dist/prompts/agent-system.prompt.js.map +1 -0
  68. package/dist/prompts/index.d.ts +4 -0
  69. package/dist/prompts/index.d.ts.map +1 -0
  70. package/dist/prompts/index.js +20 -0
  71. package/dist/prompts/index.js.map +1 -0
  72. package/dist/prompts/supervisor-routing.prompt.d.ts +9 -0
  73. package/dist/prompts/supervisor-routing.prompt.d.ts.map +1 -0
  74. package/dist/prompts/supervisor-routing.prompt.js +22 -0
  75. package/dist/prompts/supervisor-routing.prompt.js.map +1 -0
  76. package/dist/prompts/supervisor-system.prompt.d.ts +9 -0
  77. package/dist/prompts/supervisor-system.prompt.d.ts.map +1 -0
  78. package/dist/prompts/supervisor-system.prompt.js +21 -0
  79. package/dist/prompts/supervisor-system.prompt.js.map +1 -0
  80. package/dist/registry/agent.registry.d.ts +49 -0
  81. package/dist/registry/agent.registry.d.ts.map +1 -0
  82. package/dist/registry/agent.registry.js +90 -0
  83. package/dist/registry/agent.registry.js.map +1 -0
  84. package/dist/registry/tool.registry.d.ts +54 -0
  85. package/dist/registry/tool.registry.d.ts.map +1 -0
  86. package/dist/registry/tool.registry.js +153 -0
  87. package/dist/registry/tool.registry.js.map +1 -0
  88. package/dist/runtime/agent.runtime.d.ts +218 -0
  89. package/dist/runtime/agent.runtime.d.ts.map +1 -0
  90. package/dist/runtime/agent.runtime.extensions.d.ts +49 -0
  91. package/dist/runtime/agent.runtime.extensions.d.ts.map +1 -0
  92. package/dist/runtime/agent.runtime.extensions.js +93 -0
  93. package/dist/runtime/agent.runtime.extensions.js.map +1 -0
  94. package/dist/runtime/agent.runtime.js +448 -0
  95. package/dist/runtime/agent.runtime.js.map +1 -0
  96. package/dist/state/agent-state.interface.d.ts +63 -0
  97. package/dist/state/agent-state.interface.d.ts.map +1 -0
  98. package/dist/state/agent-state.interface.js +7 -0
  99. package/dist/state/agent-state.interface.js.map +1 -0
  100. package/dist/state/agent.state.d.ts +67 -0
  101. package/dist/state/agent.state.d.ts.map +1 -0
  102. package/dist/state/agent.state.js +172 -0
  103. package/dist/state/agent.state.js.map +1 -0
  104. package/dist/state/database-state.manager.d.ts +63 -0
  105. package/dist/state/database-state.manager.d.ts.map +1 -0
  106. package/dist/state/database-state.manager.js +282 -0
  107. package/dist/state/database-state.manager.js.map +1 -0
  108. package/dist/state/redis-state.manager.d.ts +81 -0
  109. package/dist/state/redis-state.manager.d.ts.map +1 -0
  110. package/dist/state/redis-state.manager.js +253 -0
  111. package/dist/state/redis-state.manager.js.map +1 -0
  112. package/dist/supervisor/supervisor.d.ts +81 -0
  113. package/dist/supervisor/supervisor.d.ts.map +1 -0
  114. package/dist/supervisor/supervisor.js +220 -0
  115. package/dist/supervisor/supervisor.js.map +1 -0
  116. package/dist/types/agent.types.d.ts +166 -0
  117. package/dist/types/agent.types.d.ts.map +1 -0
  118. package/dist/types/agent.types.js +32 -0
  119. package/dist/types/agent.types.js.map +1 -0
  120. package/dist/types/event.types.d.ts +198 -0
  121. package/dist/types/event.types.d.ts.map +1 -0
  122. package/dist/types/event.types.js +46 -0
  123. package/dist/types/event.types.js.map +1 -0
  124. package/dist/types/llm.types.d.ts +66 -0
  125. package/dist/types/llm.types.d.ts.map +1 -0
  126. package/dist/types/llm.types.js +7 -0
  127. package/dist/types/llm.types.js.map +1 -0
  128. package/dist/types/rag.types.d.ts +40 -0
  129. package/dist/types/rag.types.d.ts.map +1 -0
  130. package/dist/types/rag.types.js +7 -0
  131. package/dist/types/rag.types.js.map +1 -0
  132. package/dist/types/tool.types.d.ts +118 -0
  133. package/dist/types/tool.types.d.ts.map +1 -0
  134. package/dist/types/tool.types.js +19 -0
  135. package/dist/types/tool.types.js.map +1 -0
  136. package/dist/utils/circuit-breaker.d.ts +9 -0
  137. package/dist/utils/circuit-breaker.d.ts.map +1 -0
  138. package/dist/utils/circuit-breaker.js +16 -0
  139. package/dist/utils/circuit-breaker.js.map +1 -0
  140. package/dist/utils/health-check.d.ts +71 -0
  141. package/dist/utils/health-check.d.ts.map +1 -0
  142. package/dist/utils/health-check.js +156 -0
  143. package/dist/utils/health-check.js.map +1 -0
  144. package/dist/utils/logger.d.ts +53 -0
  145. package/dist/utils/logger.d.ts.map +1 -0
  146. package/dist/utils/logger.js +133 -0
  147. package/dist/utils/logger.js.map +1 -0
  148. package/dist/utils/metrics.d.ts +90 -0
  149. package/dist/utils/metrics.d.ts.map +1 -0
  150. package/dist/utils/metrics.js +186 -0
  151. package/dist/utils/metrics.js.map +1 -0
  152. package/dist/utils/rate-limiter.d.ts +44 -0
  153. package/dist/utils/rate-limiter.d.ts.map +1 -0
  154. package/dist/utils/rate-limiter.js +82 -0
  155. package/dist/utils/rate-limiter.js.map +1 -0
  156. package/dist/utils/retry.d.ts +42 -0
  157. package/dist/utils/retry.d.ts.map +1 -0
  158. package/dist/utils/retry.js +103 -0
  159. package/dist/utils/retry.js.map +1 -0
  160. package/jest.config.js +30 -0
  161. package/logs/combined.log +1 -0
  162. package/logs/error.log +0 -0
  163. package/package.json +74 -0
  164. package/prisma-schema.example.prisma +76 -0
  165. package/tests/setup.ts +17 -0
  166. package/tsconfig.tsbuildinfo +1 -0
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Tool System Types
3
+ */
4
+ /**
5
+ * Tool execution status
6
+ */
7
+ export declare enum ToolExecutionStatus {
8
+ PENDING = "pending",
9
+ APPROVED = "approved",
10
+ REJECTED = "rejected",
11
+ EXECUTING = "executing",
12
+ COMPLETED = "completed",
13
+ FAILED = "failed"
14
+ }
15
+ /**
16
+ * Tool configuration
17
+ */
18
+ export interface ToolConfig {
19
+ name: string;
20
+ description: string;
21
+ parameters?: ToolParameter[];
22
+ requiresApproval?: boolean;
23
+ timeout?: number;
24
+ retries?: number;
25
+ policy?: string;
26
+ metadata?: Record<string, unknown>;
27
+ }
28
+ /**
29
+ * Tool parameter definition
30
+ */
31
+ export interface ToolParameter {
32
+ name: string;
33
+ type: 'string' | 'number' | 'boolean' | 'object' | 'array';
34
+ description: string;
35
+ required?: boolean;
36
+ default?: unknown;
37
+ enum?: unknown[];
38
+ validation?: (value: unknown) => boolean;
39
+ }
40
+ /**
41
+ * Tool metadata stored via decorator
42
+ */
43
+ export interface ToolMetadata extends ToolConfig {
44
+ target: object;
45
+ propertyKey: string;
46
+ method: Function;
47
+ agentClass?: new (...args: unknown[]) => unknown;
48
+ }
49
+ /**
50
+ * Tool execution context
51
+ */
52
+ export interface ToolExecutionContext {
53
+ executionId: string;
54
+ toolName: string;
55
+ agentId: string;
56
+ sessionId: string;
57
+ userId?: string;
58
+ input: Record<string, unknown>;
59
+ status: ToolExecutionStatus;
60
+ approvedBy?: string;
61
+ approvedAt?: Date;
62
+ startedAt: Date;
63
+ completedAt?: Date;
64
+ duration?: number;
65
+ metadata?: Record<string, unknown>;
66
+ }
67
+ /**
68
+ * Tool execution result
69
+ */
70
+ export interface ToolExecutionResult {
71
+ success: boolean;
72
+ output?: unknown;
73
+ error?: Error;
74
+ metadata?: Record<string, unknown>;
75
+ duration: number;
76
+ }
77
+ /**
78
+ * Tool approval request
79
+ */
80
+ export interface ToolApprovalRequest {
81
+ requestId: string;
82
+ executionId: string;
83
+ toolName: string;
84
+ agentId: string;
85
+ input: Record<string, unknown>;
86
+ reason?: string;
87
+ requestedAt: Date;
88
+ expiresAt?: Date;
89
+ metadata?: Record<string, unknown>;
90
+ }
91
+ /**
92
+ * Tool approval response
93
+ */
94
+ export interface ToolApprovalResponse {
95
+ requestId: string;
96
+ approved: boolean;
97
+ approvedBy: string;
98
+ reason?: string;
99
+ approvedAt: Date;
100
+ modifications?: Record<string, unknown>;
101
+ }
102
+ /**
103
+ * Tool definition for LLM
104
+ */
105
+ export interface ToolDefinition {
106
+ name: string;
107
+ description: string;
108
+ parameters: {
109
+ type: 'object';
110
+ properties: Record<string, {
111
+ type: string;
112
+ description: string;
113
+ enum?: unknown[];
114
+ }>;
115
+ required: string[];
116
+ };
117
+ }
118
+ //# sourceMappingURL=tool.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.types.d.ts","sourceRoot":"","sources":["../../src/types/tool.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;YACE,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;SAClB,CACF,CAAC;QACF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH"}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ /**
3
+ * Tool System Types
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.ToolExecutionStatus = void 0;
7
+ /**
8
+ * Tool execution status
9
+ */
10
+ var ToolExecutionStatus;
11
+ (function (ToolExecutionStatus) {
12
+ ToolExecutionStatus["PENDING"] = "pending";
13
+ ToolExecutionStatus["APPROVED"] = "approved";
14
+ ToolExecutionStatus["REJECTED"] = "rejected";
15
+ ToolExecutionStatus["EXECUTING"] = "executing";
16
+ ToolExecutionStatus["COMPLETED"] = "completed";
17
+ ToolExecutionStatus["FAILED"] = "failed";
18
+ })(ToolExecutionStatus || (exports.ToolExecutionStatus = ToolExecutionStatus = {}));
19
+ //# sourceMappingURL=tool.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../src/types/tool.types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,4CAAqB,CAAA;IACrB,4CAAqB,CAAA;IACrB,8CAAuB,CAAA;IACvB,8CAAuB,CAAA;IACvB,wCAAiB,CAAA;AACnB,CAAC,EAPW,mBAAmB,mCAAnB,mBAAmB,QAO9B"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Circuit Breaker Pattern
3
+ * Re-exports from @hazeljs/resilience for backward compatibility.
4
+ *
5
+ * @deprecated Import directly from '@hazeljs/resilience' instead.
6
+ * This module is kept for backward compatibility with existing agent code.
7
+ */
8
+ export { CircuitState, CircuitBreakerError, CircuitBreaker, CircuitBreakerConfig, WithCircuitBreaker, } from '@hazeljs/resilience';
9
+ //# sourceMappingURL=circuit-breaker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,16 @@
1
+ "use strict";
2
+ /**
3
+ * Circuit Breaker Pattern
4
+ * Re-exports from @hazeljs/resilience for backward compatibility.
5
+ *
6
+ * @deprecated Import directly from '@hazeljs/resilience' instead.
7
+ * This module is kept for backward compatibility with existing agent code.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.WithCircuitBreaker = exports.CircuitBreaker = exports.CircuitBreakerError = exports.CircuitState = void 0;
11
+ var resilience_1 = require("@hazeljs/resilience");
12
+ Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return resilience_1.CircuitState; } });
13
+ Object.defineProperty(exports, "CircuitBreakerError", { enumerable: true, get: function () { return resilience_1.CircuitBreakerError; } });
14
+ Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return resilience_1.CircuitBreaker; } });
15
+ Object.defineProperty(exports, "WithCircuitBreaker", { enumerable: true, get: function () { return resilience_1.WithCircuitBreaker; } });
16
+ //# sourceMappingURL=circuit-breaker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,kDAM6B;AAL3B,0GAAA,YAAY,OAAA;AACZ,iHAAA,mBAAmB,OAAA;AACnB,4GAAA,cAAc,OAAA;AAEd,gHAAA,kBAAkB,OAAA"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Health Check System
3
+ * Monitor agent runtime health and dependencies
4
+ */
5
+ import { LLMProvider } from '../types/llm.types';
6
+ import { RAGService } from '../types/rag.types';
7
+ export declare enum HealthStatus {
8
+ HEALTHY = "healthy",
9
+ DEGRADED = "degraded",
10
+ UNHEALTHY = "unhealthy"
11
+ }
12
+ export interface ComponentHealth {
13
+ status: HealthStatus;
14
+ message?: string;
15
+ latencyMs?: number;
16
+ lastCheck?: number;
17
+ }
18
+ export interface HealthCheckResult {
19
+ status: HealthStatus;
20
+ timestamp: number;
21
+ uptime: number;
22
+ components: {
23
+ llmProvider?: ComponentHealth;
24
+ ragService?: ComponentHealth;
25
+ memory?: ComponentHealth;
26
+ };
27
+ metrics?: {
28
+ totalExecutions: number;
29
+ successRate: number;
30
+ averageLatency: number;
31
+ };
32
+ }
33
+ export interface HealthCheckConfig {
34
+ checkIntervalMs?: number;
35
+ timeoutMs?: number;
36
+ }
37
+ export declare class HealthChecker {
38
+ private startTime;
39
+ private lastCheck?;
40
+ private config;
41
+ constructor(config?: HealthCheckConfig);
42
+ /**
43
+ * Perform a health check
44
+ */
45
+ check(llmProvider?: LLMProvider, ragService?: RAGService, metrics?: {
46
+ totalExecutions: number;
47
+ successRate: number;
48
+ averageLatency: number;
49
+ }): Promise<HealthCheckResult>;
50
+ /**
51
+ * Check a single component
52
+ */
53
+ private checkComponent;
54
+ /**
55
+ * Determine overall status from component statuses
56
+ */
57
+ private determineOverallStatus;
58
+ /**
59
+ * Get last health check result
60
+ */
61
+ getLastCheck(): HealthCheckResult | undefined;
62
+ /**
63
+ * Get uptime in seconds
64
+ */
65
+ getUptime(): number;
66
+ /**
67
+ * Format health check result as string
68
+ */
69
+ formatResult(result: HealthCheckResult): string;
70
+ }
71
+ //# sourceMappingURL=health-check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/utils/health-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,WAAW,CAAC,EAAE,eAAe,CAAC;QAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;QAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,GAAE,iBAAsB;IAQ1C;;OAEG;IACG,KAAK,CACT,WAAW,CAAC,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,iBAAiB,CAAC;IA8C7B;;OAEG;YACW,cAAc;IAuC5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,YAAY,IAAI,iBAAiB,GAAG,SAAS;IAI7C;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAgChD"}
@@ -0,0 +1,156 @@
1
+ "use strict";
2
+ /**
3
+ * Health Check System
4
+ * Monitor agent runtime health and dependencies
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.HealthChecker = exports.HealthStatus = void 0;
8
+ var HealthStatus;
9
+ (function (HealthStatus) {
10
+ HealthStatus["HEALTHY"] = "healthy";
11
+ HealthStatus["DEGRADED"] = "degraded";
12
+ HealthStatus["UNHEALTHY"] = "unhealthy";
13
+ })(HealthStatus || (exports.HealthStatus = HealthStatus = {}));
14
+ class HealthChecker {
15
+ constructor(config = {}) {
16
+ this.startTime = Date.now();
17
+ this.config = {
18
+ checkIntervalMs: config.checkIntervalMs ?? 30000,
19
+ timeoutMs: config.timeoutMs ?? 5000,
20
+ };
21
+ }
22
+ /**
23
+ * Perform a health check
24
+ */
25
+ async check(llmProvider, ragService, metrics) {
26
+ const components = {};
27
+ // Check LLM Provider
28
+ if (llmProvider) {
29
+ components.llmProvider = await this.checkComponent('LLM Provider', async () => {
30
+ if (llmProvider.isAvailable) {
31
+ return await llmProvider.isAvailable();
32
+ }
33
+ return true;
34
+ });
35
+ }
36
+ // Check RAG Service
37
+ if (ragService) {
38
+ components.ragService = await this.checkComponent('RAG Service', async () => {
39
+ if (ragService.isAvailable) {
40
+ return await ragService.isAvailable();
41
+ }
42
+ return true;
43
+ });
44
+ }
45
+ // Check Memory (basic check)
46
+ components.memory = {
47
+ status: HealthStatus.HEALTHY,
48
+ message: 'Memory system operational',
49
+ lastCheck: Date.now(),
50
+ };
51
+ // Determine overall status
52
+ const componentStatuses = Object.values(components).map((c) => c.status);
53
+ const overallStatus = this.determineOverallStatus(componentStatuses);
54
+ const result = {
55
+ status: overallStatus,
56
+ timestamp: Date.now(),
57
+ uptime: Date.now() - this.startTime,
58
+ components,
59
+ metrics,
60
+ };
61
+ this.lastCheck = result;
62
+ return result;
63
+ }
64
+ /**
65
+ * Check a single component
66
+ */
67
+ async checkComponent(name, checkFn) {
68
+ const startTime = Date.now();
69
+ let timeoutId;
70
+ try {
71
+ const timeoutPromise = new Promise((_, reject) => {
72
+ timeoutId = setTimeout(() => reject(new Error('Health check timeout')), this.config.timeoutMs);
73
+ });
74
+ const isHealthy = await Promise.race([checkFn(), timeoutPromise]);
75
+ const latencyMs = Date.now() - startTime;
76
+ return {
77
+ status: isHealthy ? HealthStatus.HEALTHY : HealthStatus.UNHEALTHY,
78
+ message: isHealthy ? `${name} is operational` : `${name} is not responding`,
79
+ latencyMs,
80
+ lastCheck: Date.now(),
81
+ };
82
+ }
83
+ catch (error) {
84
+ const latencyMs = Date.now() - startTime;
85
+ return {
86
+ status: HealthStatus.UNHEALTHY,
87
+ message: `${name} check failed: ${error.message}`,
88
+ latencyMs,
89
+ lastCheck: Date.now(),
90
+ };
91
+ }
92
+ finally {
93
+ if (timeoutId) {
94
+ clearTimeout(timeoutId);
95
+ }
96
+ }
97
+ }
98
+ /**
99
+ * Determine overall status from component statuses
100
+ */
101
+ determineOverallStatus(statuses) {
102
+ if (statuses.every((s) => s === HealthStatus.HEALTHY)) {
103
+ return HealthStatus.HEALTHY;
104
+ }
105
+ if (statuses.some((s) => s === HealthStatus.UNHEALTHY)) {
106
+ return HealthStatus.UNHEALTHY;
107
+ }
108
+ return HealthStatus.DEGRADED;
109
+ }
110
+ /**
111
+ * Get last health check result
112
+ */
113
+ getLastCheck() {
114
+ return this.lastCheck;
115
+ }
116
+ /**
117
+ * Get uptime in seconds
118
+ */
119
+ getUptime() {
120
+ return Math.floor((Date.now() - this.startTime) / 1000);
121
+ }
122
+ /**
123
+ * Format health check result as string
124
+ */
125
+ formatResult(result) {
126
+ const lines = [
127
+ 'Health Check Report',
128
+ '===================',
129
+ `Status: ${result.status.toUpperCase()}`,
130
+ `Timestamp: ${new Date(result.timestamp).toISOString()}`,
131
+ `Uptime: ${Math.floor(result.uptime / 1000)}s`,
132
+ '',
133
+ 'Components:',
134
+ ];
135
+ for (const [name, health] of Object.entries(result.components)) {
136
+ lines.push(` ${name}:`);
137
+ lines.push(` Status: ${health.status}`);
138
+ if (health.message) {
139
+ lines.push(` Message: ${health.message}`);
140
+ }
141
+ if (health.latencyMs !== undefined) {
142
+ lines.push(` Latency: ${health.latencyMs}ms`);
143
+ }
144
+ }
145
+ if (result.metrics) {
146
+ lines.push('');
147
+ lines.push('Metrics:');
148
+ lines.push(` Total Executions: ${result.metrics.totalExecutions}`);
149
+ lines.push(` Success Rate: ${(result.metrics.successRate * 100).toFixed(2)}%`);
150
+ lines.push(` Average Latency: ${result.metrics.averageLatency.toFixed(2)}ms`);
151
+ }
152
+ return lines.join('\n');
153
+ }
154
+ }
155
+ exports.HealthChecker = HealthChecker;
156
+ //# sourceMappingURL=health-check.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../src/utils/health-check.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Structured Logger
3
+ * Production-ready logging with levels, context, and formatting
4
+ */
5
+ export declare enum LogLevel {
6
+ DEBUG = 0,
7
+ INFO = 1,
8
+ WARN = 2,
9
+ ERROR = 3,
10
+ FATAL = 4
11
+ }
12
+ export interface LogContext {
13
+ agentId?: string;
14
+ executionId?: string;
15
+ sessionId?: string;
16
+ toolName?: string;
17
+ [key: string]: unknown;
18
+ }
19
+ export interface LogEntry {
20
+ timestamp: string;
21
+ level: string;
22
+ message: string;
23
+ context?: LogContext;
24
+ error?: {
25
+ name: string;
26
+ message: string;
27
+ stack?: string;
28
+ };
29
+ }
30
+ export interface LoggerConfig {
31
+ level?: LogLevel;
32
+ enableConsole?: boolean;
33
+ enableJson?: boolean;
34
+ customHandler?: (entry: LogEntry) => void;
35
+ }
36
+ export declare class Logger {
37
+ private level;
38
+ private enableConsole;
39
+ private enableJson;
40
+ private customHandler?;
41
+ constructor(config?: LoggerConfig);
42
+ debug(message: string, context?: LogContext): void;
43
+ info(message: string, context?: LogContext): void;
44
+ warn(message: string, context?: LogContext): void;
45
+ error(message: string, error?: Error, context?: LogContext): void;
46
+ fatal(message: string, error?: Error, context?: LogContext): void;
47
+ private log;
48
+ private logToConsole;
49
+ setLevel(level: LogLevel): void;
50
+ getLevel(): LogLevel;
51
+ }
52
+ export declare const logger: Logger;
53
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,aAAa,CAAC,CAA4B;gBAEtC,MAAM,GAAE,YAAiB;IAOrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAcjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAcjE,OAAO,CAAC,GAAG;IA0BX,OAAO,CAAC,YAAY;IAoDpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;CAGrB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}
@@ -0,0 +1,133 @@
1
+ "use strict";
2
+ /**
3
+ * Structured Logger
4
+ * Production-ready logging with levels, context, and formatting
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.logger = exports.Logger = exports.LogLevel = void 0;
8
+ var LogLevel;
9
+ (function (LogLevel) {
10
+ LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
11
+ LogLevel[LogLevel["INFO"] = 1] = "INFO";
12
+ LogLevel[LogLevel["WARN"] = 2] = "WARN";
13
+ LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
14
+ LogLevel[LogLevel["FATAL"] = 4] = "FATAL";
15
+ })(LogLevel || (exports.LogLevel = LogLevel = {}));
16
+ class Logger {
17
+ constructor(config = {}) {
18
+ this.level = config.level ?? LogLevel.INFO;
19
+ this.enableConsole = config.enableConsole ?? true;
20
+ this.enableJson = config.enableJson ?? false;
21
+ this.customHandler = config.customHandler;
22
+ }
23
+ debug(message, context) {
24
+ this.log(LogLevel.DEBUG, message, context);
25
+ }
26
+ info(message, context) {
27
+ this.log(LogLevel.INFO, message, context);
28
+ }
29
+ warn(message, context) {
30
+ this.log(LogLevel.WARN, message, context);
31
+ }
32
+ error(message, error, context) {
33
+ const errorContext = error
34
+ ? {
35
+ ...context,
36
+ error: {
37
+ name: error.name,
38
+ message: error.message,
39
+ stack: error.stack,
40
+ },
41
+ }
42
+ : context;
43
+ this.log(LogLevel.ERROR, message, errorContext);
44
+ }
45
+ fatal(message, error, context) {
46
+ const errorContext = error
47
+ ? {
48
+ ...context,
49
+ error: {
50
+ name: error.name,
51
+ message: error.message,
52
+ stack: error.stack,
53
+ },
54
+ }
55
+ : context;
56
+ this.log(LogLevel.FATAL, message, errorContext);
57
+ }
58
+ log(level, message, context) {
59
+ if (level < this.level) {
60
+ return;
61
+ }
62
+ const entry = {
63
+ timestamp: new Date().toISOString(),
64
+ level: LogLevel[level],
65
+ message,
66
+ context,
67
+ };
68
+ if (context?.error) {
69
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
70
+ entry.error = context.error;
71
+ }
72
+ if (this.customHandler) {
73
+ this.customHandler(entry);
74
+ }
75
+ if (this.enableConsole) {
76
+ this.logToConsole(level, entry);
77
+ }
78
+ }
79
+ logToConsole(level, entry) {
80
+ if (this.enableJson) {
81
+ // eslint-disable-next-line no-console
82
+ console.log(JSON.stringify(entry));
83
+ return;
84
+ }
85
+ const levelColors = {
86
+ [LogLevel.DEBUG]: '\x1b[36m',
87
+ [LogLevel.INFO]: '\x1b[32m',
88
+ [LogLevel.WARN]: '\x1b[33m',
89
+ [LogLevel.ERROR]: '\x1b[31m',
90
+ [LogLevel.FATAL]: '\x1b[35m',
91
+ };
92
+ const reset = '\x1b[0m';
93
+ const color = levelColors[level];
94
+ const levelStr = `${color}[${entry.level}]${reset}`;
95
+ const timestamp = `\x1b[90m${entry.timestamp}${reset}`;
96
+ let logMessage = `${timestamp} ${levelStr} ${entry.message}`;
97
+ if (entry.context && Object.keys(entry.context).length > 0) {
98
+ const contextStr = JSON.stringify(entry.context, null, 2);
99
+ logMessage += `\n Context: ${contextStr}`;
100
+ }
101
+ if (entry.error) {
102
+ logMessage += `\n Error: ${entry.error.name}: ${entry.error.message}`;
103
+ if (entry.error.stack) {
104
+ logMessage += `\n${entry.error.stack}`;
105
+ }
106
+ }
107
+ switch (level) {
108
+ case LogLevel.DEBUG:
109
+ case LogLevel.INFO:
110
+ // eslint-disable-next-line no-console
111
+ console.log(logMessage);
112
+ break;
113
+ case LogLevel.WARN:
114
+ // eslint-disable-next-line no-console
115
+ console.warn(logMessage);
116
+ break;
117
+ case LogLevel.ERROR:
118
+ case LogLevel.FATAL:
119
+ // eslint-disable-next-line no-console
120
+ console.error(logMessage);
121
+ break;
122
+ }
123
+ }
124
+ setLevel(level) {
125
+ this.level = level;
126
+ }
127
+ getLevel() {
128
+ return this.level;
129
+ }
130
+ }
131
+ exports.Logger = Logger;
132
+ exports.logger = new Logger();
133
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}