@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.
- package/IMPLEMENTATION_SUMMARY.md +400 -0
- package/LICENSE +192 -0
- package/PERSISTENCE.md +201 -0
- package/PRISMA_INTEGRATION.md +499 -0
- package/PRODUCTION_READINESS.md +264 -0
- package/QUICKSTART.md +135 -0
- package/README.md +541 -0
- package/STATE_VS_MEMORY.md +243 -0
- package/benchmarks/performance.benchmark.ts +157 -0
- package/coverage/clover.xml +1508 -0
- package/coverage/lcov-report/base.css +224 -0
- package/coverage/lcov-report/block-navigation.js +87 -0
- package/coverage/lcov-report/favicon.png +0 -0
- package/coverage/lcov-report/index.html +296 -0
- package/coverage/lcov-report/prettify.css +1 -0
- package/coverage/lcov-report/prettify.js +2 -0
- package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
- package/coverage/lcov-report/sorter.js +210 -0
- package/coverage/lcov.info +2722 -0
- package/dist/agent.module.d.ts +57 -0
- package/dist/agent.module.d.ts.map +1 -0
- package/dist/agent.module.js +99 -0
- package/dist/agent.module.js.map +1 -0
- package/dist/context/agent.context.d.ts +27 -0
- package/dist/context/agent.context.d.ts.map +1 -0
- package/dist/context/agent.context.js +98 -0
- package/dist/context/agent.context.js.map +1 -0
- package/dist/decorators/agent.decorator.d.ts +21 -0
- package/dist/decorators/agent.decorator.d.ts.map +1 -0
- package/dist/decorators/agent.decorator.js +38 -0
- package/dist/decorators/agent.decorator.js.map +1 -0
- package/dist/decorators/delegate.decorator.d.ts +66 -0
- package/dist/decorators/delegate.decorator.d.ts.map +1 -0
- package/dist/decorators/delegate.decorator.js +108 -0
- package/dist/decorators/delegate.decorator.js.map +1 -0
- package/dist/decorators/tool.decorator.d.ts +23 -0
- package/dist/decorators/tool.decorator.d.ts.map +1 -0
- package/dist/decorators/tool.decorator.js +61 -0
- package/dist/decorators/tool.decorator.js.map +1 -0
- package/dist/events/event.emitter.d.ts +45 -0
- package/dist/events/event.emitter.d.ts.map +1 -0
- package/dist/events/event.emitter.js +96 -0
- package/dist/events/event.emitter.js.map +1 -0
- package/dist/executor/agent.executor.d.ts +58 -0
- package/dist/executor/agent.executor.d.ts.map +1 -0
- package/dist/executor/agent.executor.js +312 -0
- package/dist/executor/agent.executor.js.map +1 -0
- package/dist/executor/tool.executor.d.ts +55 -0
- package/dist/executor/tool.executor.d.ts.map +1 -0
- package/dist/executor/tool.executor.js +266 -0
- package/dist/executor/tool.executor.js.map +1 -0
- package/dist/graph/agent-graph.d.ts +131 -0
- package/dist/graph/agent-graph.d.ts.map +1 -0
- package/dist/graph/agent-graph.js +462 -0
- package/dist/graph/agent-graph.js.map +1 -0
- package/dist/graph/agent-graph.types.d.ts +210 -0
- package/dist/graph/agent-graph.types.d.ts.map +1 -0
- package/dist/graph/agent-graph.types.js +12 -0
- package/dist/graph/agent-graph.types.js.map +1 -0
- package/dist/index.d.ts +34 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +51 -0
- package/dist/index.js.map +1 -0
- package/dist/prompts/agent-system.prompt.d.ts +10 -0
- package/dist/prompts/agent-system.prompt.d.ts.map +1 -0
- package/dist/prompts/agent-system.prompt.js +18 -0
- package/dist/prompts/agent-system.prompt.js.map +1 -0
- package/dist/prompts/index.d.ts +4 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/index.js +20 -0
- package/dist/prompts/index.js.map +1 -0
- package/dist/prompts/supervisor-routing.prompt.d.ts +9 -0
- package/dist/prompts/supervisor-routing.prompt.d.ts.map +1 -0
- package/dist/prompts/supervisor-routing.prompt.js +22 -0
- package/dist/prompts/supervisor-routing.prompt.js.map +1 -0
- package/dist/prompts/supervisor-system.prompt.d.ts +9 -0
- package/dist/prompts/supervisor-system.prompt.d.ts.map +1 -0
- package/dist/prompts/supervisor-system.prompt.js +21 -0
- package/dist/prompts/supervisor-system.prompt.js.map +1 -0
- package/dist/registry/agent.registry.d.ts +49 -0
- package/dist/registry/agent.registry.d.ts.map +1 -0
- package/dist/registry/agent.registry.js +90 -0
- package/dist/registry/agent.registry.js.map +1 -0
- package/dist/registry/tool.registry.d.ts +54 -0
- package/dist/registry/tool.registry.d.ts.map +1 -0
- package/dist/registry/tool.registry.js +153 -0
- package/dist/registry/tool.registry.js.map +1 -0
- package/dist/runtime/agent.runtime.d.ts +218 -0
- package/dist/runtime/agent.runtime.d.ts.map +1 -0
- package/dist/runtime/agent.runtime.extensions.d.ts +49 -0
- package/dist/runtime/agent.runtime.extensions.d.ts.map +1 -0
- package/dist/runtime/agent.runtime.extensions.js +93 -0
- package/dist/runtime/agent.runtime.extensions.js.map +1 -0
- package/dist/runtime/agent.runtime.js +448 -0
- package/dist/runtime/agent.runtime.js.map +1 -0
- package/dist/state/agent-state.interface.d.ts +63 -0
- package/dist/state/agent-state.interface.d.ts.map +1 -0
- package/dist/state/agent-state.interface.js +7 -0
- package/dist/state/agent-state.interface.js.map +1 -0
- package/dist/state/agent.state.d.ts +67 -0
- package/dist/state/agent.state.d.ts.map +1 -0
- package/dist/state/agent.state.js +172 -0
- package/dist/state/agent.state.js.map +1 -0
- package/dist/state/database-state.manager.d.ts +63 -0
- package/dist/state/database-state.manager.d.ts.map +1 -0
- package/dist/state/database-state.manager.js +282 -0
- package/dist/state/database-state.manager.js.map +1 -0
- package/dist/state/redis-state.manager.d.ts +81 -0
- package/dist/state/redis-state.manager.d.ts.map +1 -0
- package/dist/state/redis-state.manager.js +253 -0
- package/dist/state/redis-state.manager.js.map +1 -0
- package/dist/supervisor/supervisor.d.ts +81 -0
- package/dist/supervisor/supervisor.d.ts.map +1 -0
- package/dist/supervisor/supervisor.js +220 -0
- package/dist/supervisor/supervisor.js.map +1 -0
- package/dist/types/agent.types.d.ts +166 -0
- package/dist/types/agent.types.d.ts.map +1 -0
- package/dist/types/agent.types.js +32 -0
- package/dist/types/agent.types.js.map +1 -0
- package/dist/types/event.types.d.ts +198 -0
- package/dist/types/event.types.d.ts.map +1 -0
- package/dist/types/event.types.js +46 -0
- package/dist/types/event.types.js.map +1 -0
- package/dist/types/llm.types.d.ts +66 -0
- package/dist/types/llm.types.d.ts.map +1 -0
- package/dist/types/llm.types.js +7 -0
- package/dist/types/llm.types.js.map +1 -0
- package/dist/types/rag.types.d.ts +40 -0
- package/dist/types/rag.types.d.ts.map +1 -0
- package/dist/types/rag.types.js +7 -0
- package/dist/types/rag.types.js.map +1 -0
- package/dist/types/tool.types.d.ts +118 -0
- package/dist/types/tool.types.d.ts.map +1 -0
- package/dist/types/tool.types.js +19 -0
- package/dist/types/tool.types.js.map +1 -0
- package/dist/utils/circuit-breaker.d.ts +9 -0
- package/dist/utils/circuit-breaker.d.ts.map +1 -0
- package/dist/utils/circuit-breaker.js +16 -0
- package/dist/utils/circuit-breaker.js.map +1 -0
- package/dist/utils/health-check.d.ts +71 -0
- package/dist/utils/health-check.d.ts.map +1 -0
- package/dist/utils/health-check.js +156 -0
- package/dist/utils/health-check.js.map +1 -0
- package/dist/utils/logger.d.ts +53 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +133 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/utils/metrics.d.ts +90 -0
- package/dist/utils/metrics.d.ts.map +1 -0
- package/dist/utils/metrics.js +186 -0
- package/dist/utils/metrics.js.map +1 -0
- package/dist/utils/rate-limiter.d.ts +44 -0
- package/dist/utils/rate-limiter.d.ts.map +1 -0
- package/dist/utils/rate-limiter.js +82 -0
- package/dist/utils/rate-limiter.js.map +1 -0
- package/dist/utils/retry.d.ts +42 -0
- package/dist/utils/retry.d.ts.map +1 -0
- package/dist/utils/retry.js +103 -0
- package/dist/utils/retry.js.map +1 -0
- package/jest.config.js +30 -0
- package/logs/combined.log +1 -0
- package/logs/error.log +0 -0
- package/package.json +74 -0
- package/prisma-schema.example.prisma +76 -0
- package/tests/setup.ts +17 -0
- 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":"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"}
|
|
@@ -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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"}
|