@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,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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"}
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Metrics Collection
3
+ * Track agent performance and usage metrics
4
+ */
5
+ export interface MetricValue {
6
+ count: number;
7
+ sum: number;
8
+ min: number;
9
+ max: number;
10
+ avg: number;
11
+ lastUpdated: number;
12
+ }
13
+ export interface AgentMetrics {
14
+ executions: {
15
+ total: number;
16
+ successful: number;
17
+ failed: number;
18
+ successRate: number;
19
+ };
20
+ performance: {
21
+ averageDuration: number;
22
+ minDuration: number;
23
+ maxDuration: number;
24
+ p50Duration: number;
25
+ p95Duration: number;
26
+ p99Duration: number;
27
+ };
28
+ tools: {
29
+ totalCalls: number;
30
+ byTool: Record<string, number>;
31
+ successRate: number;
32
+ };
33
+ llm: {
34
+ totalCalls: number;
35
+ totalTokens: number;
36
+ averageTokensPerCall: number;
37
+ errors: number;
38
+ };
39
+ memory: {
40
+ totalRetrievals: number;
41
+ averageRetrievalTime: number;
42
+ };
43
+ }
44
+ export declare class MetricsCollector {
45
+ private executionCount;
46
+ private successCount;
47
+ private failureCount;
48
+ private durations;
49
+ private toolCalls;
50
+ private toolSuccesses;
51
+ private toolFailures;
52
+ private llmCalls;
53
+ private llmTokens;
54
+ private llmErrors;
55
+ private memoryRetrievals;
56
+ private memoryRetrievalTimes;
57
+ private startTime;
58
+ constructor();
59
+ /**
60
+ * Record an agent execution
61
+ */
62
+ recordExecution(success: boolean, durationMs: number): void;
63
+ /**
64
+ * Record a tool call
65
+ */
66
+ recordToolCall(toolName: string, success: boolean): void;
67
+ /**
68
+ * Record an LLM call
69
+ */
70
+ recordLLMCall(tokens: number, error?: boolean): void;
71
+ /**
72
+ * Record a memory retrieval
73
+ */
74
+ recordMemoryRetrieval(durationMs: number): void;
75
+ /**
76
+ * Get all metrics
77
+ */
78
+ getMetrics(): AgentMetrics;
79
+ /**
80
+ * Get metrics summary as string
81
+ */
82
+ getSummary(): string;
83
+ /**
84
+ * Reset all metrics
85
+ */
86
+ reset(): void;
87
+ private calculateAverage;
88
+ private calculatePercentile;
89
+ }
90
+ //# sourceMappingURL=metrics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,WAAW,EAAE;QACX,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,SAAS,CAAS;;IAM1B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAe3D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASxD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,IAAI;IAQ3D;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAU/C;;OAEG;IACH,UAAU,IAAI,YAAY;IAqC1B;;OAEG;IACH,UAAU,IAAI,MAAM;IA0CpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,mBAAmB;CAK5B"}
@@ -0,0 +1,186 @@
1
+ "use strict";
2
+ /**
3
+ * Metrics Collection
4
+ * Track agent performance and usage metrics
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.MetricsCollector = void 0;
8
+ class MetricsCollector {
9
+ constructor() {
10
+ this.executionCount = 0;
11
+ this.successCount = 0;
12
+ this.failureCount = 0;
13
+ this.durations = [];
14
+ this.toolCalls = {};
15
+ this.toolSuccesses = 0;
16
+ this.toolFailures = 0;
17
+ this.llmCalls = 0;
18
+ this.llmTokens = 0;
19
+ this.llmErrors = 0;
20
+ this.memoryRetrievals = 0;
21
+ this.memoryRetrievalTimes = [];
22
+ this.startTime = Date.now();
23
+ }
24
+ /**
25
+ * Record an agent execution
26
+ */
27
+ recordExecution(success, durationMs) {
28
+ this.executionCount++;
29
+ if (success) {
30
+ this.successCount++;
31
+ }
32
+ else {
33
+ this.failureCount++;
34
+ }
35
+ this.durations.push(durationMs);
36
+ // Keep only last 1000 durations to prevent memory bloat
37
+ if (this.durations.length > 1000) {
38
+ this.durations = this.durations.slice(-1000);
39
+ }
40
+ }
41
+ /**
42
+ * Record a tool call
43
+ */
44
+ recordToolCall(toolName, success) {
45
+ this.toolCalls[toolName] = (this.toolCalls[toolName] || 0) + 1;
46
+ if (success) {
47
+ this.toolSuccesses++;
48
+ }
49
+ else {
50
+ this.toolFailures++;
51
+ }
52
+ }
53
+ /**
54
+ * Record an LLM call
55
+ */
56
+ recordLLMCall(tokens, error = false) {
57
+ this.llmCalls++;
58
+ this.llmTokens += tokens;
59
+ if (error) {
60
+ this.llmErrors++;
61
+ }
62
+ }
63
+ /**
64
+ * Record a memory retrieval
65
+ */
66
+ recordMemoryRetrieval(durationMs) {
67
+ this.memoryRetrievals++;
68
+ this.memoryRetrievalTimes.push(durationMs);
69
+ // Keep only last 1000 retrieval times
70
+ if (this.memoryRetrievalTimes.length > 1000) {
71
+ this.memoryRetrievalTimes = this.memoryRetrievalTimes.slice(-1000);
72
+ }
73
+ }
74
+ /**
75
+ * Get all metrics
76
+ */
77
+ getMetrics() {
78
+ const sortedDurations = [...this.durations].sort((a, b) => a - b);
79
+ const totalToolCalls = this.toolSuccesses + this.toolFailures;
80
+ return {
81
+ executions: {
82
+ total: this.executionCount,
83
+ successful: this.successCount,
84
+ failed: this.failureCount,
85
+ successRate: this.executionCount > 0 ? this.successCount / this.executionCount : 0,
86
+ },
87
+ performance: {
88
+ averageDuration: this.calculateAverage(this.durations),
89
+ minDuration: Math.min(...this.durations, Infinity),
90
+ maxDuration: Math.max(...this.durations, -Infinity),
91
+ p50Duration: this.calculatePercentile(sortedDurations, 50),
92
+ p95Duration: this.calculatePercentile(sortedDurations, 95),
93
+ p99Duration: this.calculatePercentile(sortedDurations, 99),
94
+ },
95
+ tools: {
96
+ totalCalls: totalToolCalls,
97
+ byTool: { ...this.toolCalls },
98
+ successRate: totalToolCalls > 0 ? this.toolSuccesses / totalToolCalls : 0,
99
+ },
100
+ llm: {
101
+ totalCalls: this.llmCalls,
102
+ totalTokens: this.llmTokens,
103
+ averageTokensPerCall: this.llmCalls > 0 ? this.llmTokens / this.llmCalls : 0,
104
+ errors: this.llmErrors,
105
+ },
106
+ memory: {
107
+ totalRetrievals: this.memoryRetrievals,
108
+ averageRetrievalTime: this.calculateAverage(this.memoryRetrievalTimes),
109
+ },
110
+ };
111
+ }
112
+ /**
113
+ * Get metrics summary as string
114
+ */
115
+ getSummary() {
116
+ const metrics = this.getMetrics();
117
+ const uptime = Math.floor((Date.now() - this.startTime) / 1000);
118
+ return `
119
+ Agent Metrics Summary
120
+ =====================
121
+ Uptime: ${uptime}s
122
+
123
+ Executions:
124
+ Total: ${metrics.executions.total}
125
+ Success: ${metrics.executions.successful}
126
+ Failed: ${metrics.executions.failed}
127
+ Success Rate: ${(metrics.executions.successRate * 100).toFixed(2)}%
128
+
129
+ Performance:
130
+ Avg Duration: ${metrics.performance.averageDuration.toFixed(2)}ms
131
+ P50: ${metrics.performance.p50Duration.toFixed(2)}ms
132
+ P95: ${metrics.performance.p95Duration.toFixed(2)}ms
133
+ P99: ${metrics.performance.p99Duration.toFixed(2)}ms
134
+
135
+ Tools:
136
+ Total Calls: ${metrics.tools.totalCalls}
137
+ Success Rate: ${(metrics.tools.successRate * 100).toFixed(2)}%
138
+ Top Tools: ${Object.entries(metrics.tools.byTool)
139
+ .sort((a, b) => b[1] - a[1])
140
+ .slice(0, 5)
141
+ .map(([name, count]) => `${name} (${count})`)
142
+ .join(', ')}
143
+
144
+ LLM:
145
+ Total Calls: ${metrics.llm.totalCalls}
146
+ Total Tokens: ${metrics.llm.totalTokens}
147
+ Avg Tokens/Call: ${metrics.llm.averageTokensPerCall.toFixed(2)}
148
+ Errors: ${metrics.llm.errors}
149
+
150
+ Memory:
151
+ Total Retrievals: ${metrics.memory.totalRetrievals}
152
+ Avg Retrieval Time: ${metrics.memory.averageRetrievalTime.toFixed(2)}ms
153
+ `.trim();
154
+ }
155
+ /**
156
+ * Reset all metrics
157
+ */
158
+ reset() {
159
+ this.executionCount = 0;
160
+ this.successCount = 0;
161
+ this.failureCount = 0;
162
+ this.durations = [];
163
+ this.toolCalls = {};
164
+ this.toolSuccesses = 0;
165
+ this.toolFailures = 0;
166
+ this.llmCalls = 0;
167
+ this.llmTokens = 0;
168
+ this.llmErrors = 0;
169
+ this.memoryRetrievals = 0;
170
+ this.memoryRetrievalTimes = [];
171
+ this.startTime = Date.now();
172
+ }
173
+ calculateAverage(values) {
174
+ if (values.length === 0)
175
+ return 0;
176
+ return values.reduce((sum, val) => sum + val, 0) / values.length;
177
+ }
178
+ calculatePercentile(sortedValues, percentile) {
179
+ if (sortedValues.length === 0)
180
+ return 0;
181
+ const index = Math.ceil((percentile / 100) * sortedValues.length) - 1;
182
+ return sortedValues[Math.max(0, index)] || 0;
183
+ }
184
+ }
185
+ exports.MetricsCollector = MetricsCollector;
186
+ //# sourceMappingURL=metrics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"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"}