@hazeljs/agent 0.2.0-beta.1

package/dist/types/llm.types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LLM Provider Types
+ * Defines the interface for LLM providers used by the agent runtime
+ */
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    name?: string;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+export interface LLMChatRequest {
+    messages: LLMMessage[];
+    tools?: LLMToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    model?: string;
+}
+export interface LLMChatResponse {
+    content: string;
+    tool_calls?: LLMToolCall[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    finishReason?: string;
+}
+/**
+ * LLM Provider Interface
+ * All LLM providers must implement this interface
+ */
+export interface LLMProvider {
+    /**
+     * Send a chat completion request
+     */
+    chat(request: LLMChatRequest): Promise<LLMChatResponse>;
+    /**
+     * Optional: Check if the provider is available
+     */
+    isAvailable?(): Promise<boolean>;
+    /**
+     * Optional: Get supported models
+     */
+    getSupportedModels?(): string[];
+}
+//# sourceMappingURL=llm.types.d.ts.map

package/dist/types/llm.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.d.ts","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAExD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,kBAAkB,CAAC,IAAI,MAAM,EAAE,CAAC;CACjC"}

package/dist/types/llm.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * LLM Provider Types
+ * Defines the interface for LLM providers used by the agent runtime
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=llm.types.js.map

package/dist/types/llm.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.js","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/rag.types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * RAG Service Types
+ * Defines the interface for RAG services used by the agent runtime
+ */
+export interface RAGDocument {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    score?: number;
+}
+export interface RAGSearchRequest {
+    query: string;
+    topK?: number;
+    filter?: Record<string, unknown>;
+    minScore?: number;
+}
+export interface RAGSearchResponse {
+    documents: RAGDocument[];
+    totalResults: number;
+    searchTime?: number;
+}
+/**
+ * RAG Service Interface
+ * All RAG services must implement this interface
+ */
+export interface RAGService {
+    /**
+     * Search for relevant documents
+     */
+    search(request: RAGSearchRequest): Promise<RAGSearchResponse>;
+    /**
+     * Optional: Add documents to the index
+     */
+    addDocuments?(documents: RAGDocument[]): Promise<void>;
+    /**
+     * Optional: Check if the service is available
+     */
+    isAvailable?(): Promise<boolean>;
+}
+//# sourceMappingURL=rag.types.d.ts.map

package/dist/types/rag.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.types.d.ts","sourceRoot":"","sources":["../../src/types/rag.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9D;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC"}

package/dist/types/rag.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * RAG Service Types
+ * Defines the interface for RAG services used by the agent runtime
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rag.types.js.map

package/dist/types/rag.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.types.js","sourceRoot":"","sources":["../../src/types/rag.types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/tool.types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Tool System Types
+ */
+/**
+ * Tool execution status
+ */
+export declare enum ToolExecutionStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    REJECTED = "rejected",
+    EXECUTING = "executing",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * Tool configuration
+ */
+export interface ToolConfig {
+    name: string;
+    description: string;
+    parameters?: ToolParameter[];
+    requiresApproval?: boolean;
+    timeout?: number;
+    retries?: number;
+    policy?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool parameter definition
+ */
+export interface ToolParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: unknown[];
+    validation?: (value: unknown) => boolean;
+}
+/**
+ * Tool metadata stored via decorator
+ */
+export interface ToolMetadata extends ToolConfig {
+    target: object;
+    propertyKey: string;
+    method: Function;
+    agentClass?: new (...args: unknown[]) => unknown;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolExecutionContext {
+    executionId: string;
+    toolName: string;
+    agentId: string;
+    sessionId: string;
+    userId?: string;
+    input: Record<string, unknown>;
+    status: ToolExecutionStatus;
+    approvedBy?: string;
+    approvedAt?: Date;
+    startedAt: Date;
+    completedAt?: Date;
+    duration?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool execution result
+ */
+export interface ToolExecutionResult {
+    success: boolean;
+    output?: unknown;
+    error?: Error;
+    metadata?: Record<string, unknown>;
+    duration: number;
+}
+/**
+ * Tool approval request
+ */
+export interface ToolApprovalRequest {
+    requestId: string;
+    executionId: string;
+    toolName: string;
+    agentId: string;
+    input: Record<string, unknown>;
+    reason?: string;
+    requestedAt: Date;
+    expiresAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool approval response
+ */
+export interface ToolApprovalResponse {
+    requestId: string;
+    approved: boolean;
+    approvedBy: string;
+    reason?: string;
+    approvedAt: Date;
+    modifications?: Record<string, unknown>;
+}
+/**
+ * Tool definition for LLM
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: unknown[];
+        }>;
+        required: string[];
+    };
+}
+//# sourceMappingURL=tool.types.d.ts.map

package/dist/types/tool.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.types.d.ts","sourceRoot":"","sources":["../../src/types/tool.types.ts"],"names":[],"mappings":"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"}

package/dist/types/tool.types.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Tool System Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutionStatus = void 0;
+/**
+ * Tool execution status
+ */
+var ToolExecutionStatus;
+(function (ToolExecutionStatus) {
+    ToolExecutionStatus["PENDING"] = "pending";
+    ToolExecutionStatus["APPROVED"] = "approved";
+    ToolExecutionStatus["REJECTED"] = "rejected";
+    ToolExecutionStatus["EXECUTING"] = "executing";
+    ToolExecutionStatus["COMPLETED"] = "completed";
+    ToolExecutionStatus["FAILED"] = "failed";
+})(ToolExecutionStatus || (exports.ToolExecutionStatus = ToolExecutionStatus = {}));
+//# sourceMappingURL=tool.types.js.map

package/dist/types/tool.types.js.map

@@ -0,0 +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"}

package/dist/utils/circuit-breaker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Circuit Breaker Pattern
+ * Prevents cascading failures by stopping calls to failing services
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: number;
+    resetTimeout: number;
+    onStateChange?: (state: CircuitState) => void;
+}
+export declare class CircuitBreakerError extends Error {
+    readonly state: CircuitState;
+    constructor(message: string, state: CircuitState);
+}
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private nextAttempt;
+    private config;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Transition to a new state
+     */
+    private transitionTo;
+    /**
+     * Get current state
+     */
+    getState(): CircuitState;
+    /**
+     * Get failure count
+     */
+    getFailureCount(): number;
+    /**
+     * Get success count
+     */
+    getSuccessCount(): number;
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset(): void;
+    /**
+     * Get time until next attempt (for OPEN state)
+     */
+    getTimeUntilNextAttempt(): number;
+}
+/**
+ * Decorator for automatic circuit breaker
+ */
+export declare function WithCircuitBreaker(config?: Partial<CircuitBreakerConfig>): MethodDecorator;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/utils/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,KAAK,EAAE,YAAY;gBADnC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,YAAY;CAKtC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAUtD;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA+BlD;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,uBAAuB,IAAI,MAAM;CAMlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,eAAe,CAY1F"}

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Circuit Breaker Pattern
+ * Prevents cascading failures by stopping calls to failing services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitBreakerError = exports.CircuitState = void 0;
+exports.WithCircuitBreaker = WithCircuitBreaker;
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+class CircuitBreakerError extends Error {
+    constructor(message, state) {
+        super(message);
+        this.state = state;
+        this.name = 'CircuitBreakerError';
+    }
+}
+exports.CircuitBreakerError = CircuitBreakerError;
+class CircuitBreaker {
+    constructor(config = {}) {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.nextAttempt = Date.now();
+        this.config = {
+            failureThreshold: config.failureThreshold ?? 5,
+            successThreshold: config.successThreshold ?? 2,
+            timeout: config.timeout ?? 60000,
+            resetTimeout: config.resetTimeout ?? 30000,
+            onStateChange: config.onStateChange ?? (() => { }),
+        };
+    }
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    async execute(fn) {
+        if (this.state === CircuitState.OPEN) {
+            if (Date.now() < this.nextAttempt) {
+                throw new CircuitBreakerError('Circuit breaker is OPEN - service unavailable', this.state);
+            }
+            this.transitionTo(CircuitState.HALF_OPEN);
+        }
+        let timeoutId;
+        try {
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new Error('Circuit breaker timeout')), this.config.timeout);
+            });
+            const result = await Promise.race([fn(), timeoutPromise]);
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    /**
+     * Handle successful execution
+     */
+    onSuccess() {
+        this.failureCount = 0;
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.successCount++;
+            if (this.successCount >= this.config.successThreshold) {
+                this.transitionTo(CircuitState.CLOSED);
+            }
+        }
+    }
+    /**
+     * Handle failed execution
+     */
+    onFailure() {
+        this.failureCount++;
+        this.successCount = 0;
+        if (this.failureCount >= this.config.failureThreshold) {
+            this.transitionTo(CircuitState.OPEN);
+        }
+    }
+    /**
+     * Transition to a new state
+     */
+    transitionTo(newState) {
+        if (this.state === newState) {
+            return;
+        }
+        this.state = newState;
+        if (newState === CircuitState.OPEN) {
+            this.nextAttempt = Date.now() + this.config.resetTimeout;
+        }
+        else if (newState === CircuitState.CLOSED) {
+            this.failureCount = 0;
+            this.successCount = 0;
+        }
+        else if (newState === CircuitState.HALF_OPEN) {
+            this.successCount = 0;
+        }
+        this.config.onStateChange(newState);
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get failure count
+     */
+    getFailureCount() {
+        return this.failureCount;
+    }
+    /**
+     * Get success count
+     */
+    getSuccessCount() {
+        return this.successCount;
+    }
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset() {
+        this.transitionTo(CircuitState.CLOSED);
+    }
+    /**
+     * Get time until next attempt (for OPEN state)
+     */
+    getTimeUntilNextAttempt() {
+        if (this.state !== CircuitState.OPEN) {
+            return 0;
+        }
+        return Math.max(0, this.nextAttempt - Date.now());
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+/**
+ * Decorator for automatic circuit breaker
+ */
+function WithCircuitBreaker(config) {
+    const circuitBreaker = new CircuitBreaker(config);
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            return circuitBreaker.execute(() => originalMethod.apply(this, args));
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuKH,gDAYC;AAjLD,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AACzB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAUD,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,KAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAc;QAGnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED,MAAa,cAAc;IAOzB,YAAY,SAAwC,EAAE;QAN9C,UAAK,GAAiB,YAAY,CAAC,MAAM,CAAC;QAC1C,iBAAY,GAAG,CAAC,CAAC;QACjB,iBAAY,GAAG,CAAC,CAAC;QACjB,gBAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAI/B,IAAI,CAAC,MAAM,GAAG;YACZ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC;YAC9C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,KAAK;YAC1C,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC,GAAS,EAAE,GAAE,CAAC,CAAC;SACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAI,EAAoB;QACnC,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClC,MAAM,IAAI,mBAAmB,CAAC,+CAA+C,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,SAAqC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBACtD,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAClD,IAAI,CAAC,MAAM,CAAC,OAAO,CACpB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;YAE1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACtD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS;QACf,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAsB;QACzC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QAEtB,IAAI,QAAQ,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QAC3D,CAAC;aAAM,IAAI,QAAQ,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,QAAQ,KAAK,YAAY,CAAC,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAxID,wCAwIC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAsC;IACvE,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAElD,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAe;YACnD,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/health-check.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Health Check System
+ * Monitor agent runtime health and dependencies
+ */
+import { LLMProvider } from '../types/llm.types';
+import { RAGService } from '../types/rag.types';
+export declare enum HealthStatus {
+    HEALTHY = "healthy",
+    DEGRADED = "degraded",
+    UNHEALTHY = "unhealthy"
+}
+export interface ComponentHealth {
+    status: HealthStatus;
+    message?: string;
+    latencyMs?: number;
+    lastCheck?: number;
+}
+export interface HealthCheckResult {
+    status: HealthStatus;
+    timestamp: number;
+    uptime: number;
+    components: {
+        llmProvider?: ComponentHealth;
+        ragService?: ComponentHealth;
+        memory?: ComponentHealth;
+    };
+    metrics?: {
+        totalExecutions: number;
+        successRate: number;
+        averageLatency: number;
+    };
+}
+export interface HealthCheckConfig {
+    checkIntervalMs?: number;
+    timeoutMs?: number;
+}
+export declare class HealthChecker {
+    private startTime;
+    private lastCheck?;
+    private config;
+    constructor(config?: HealthCheckConfig);
+    /**
+     * Perform a health check
+     */
+    check(llmProvider?: LLMProvider, ragService?: RAGService, metrics?: {
+        totalExecutions: number;
+        successRate: number;
+        averageLatency: number;
+    }): Promise<HealthCheckResult>;
+    /**
+     * Check a single component
+     */
+    private checkComponent;
+    /**
+     * Determine overall status from component statuses
+     */
+    private determineOverallStatus;
+    /**
+     * Get last health check result
+     */
+    getLastCheck(): HealthCheckResult | undefined;
+    /**
+     * Get uptime in seconds
+     */
+    getUptime(): number;
+    /**
+     * Format health check result as string
+     */
+    formatResult(result: HealthCheckResult): string;
+}
+//# sourceMappingURL=health-check.d.ts.map

package/dist/utils/health-check.d.ts.map

@@ -0,0 +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"}