@hazeljs/agent 0.2.0-alpha.1

package/dist/utils/metrics.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Metrics Collection
+ * Track agent performance and usage metrics
+ */
+export interface MetricValue {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+    lastUpdated: number;
+}
+export interface AgentMetrics {
+    executions: {
+        total: number;
+        successful: number;
+        failed: number;
+        successRate: number;
+    };
+    performance: {
+        averageDuration: number;
+        minDuration: number;
+        maxDuration: number;
+        p50Duration: number;
+        p95Duration: number;
+        p99Duration: number;
+    };
+    tools: {
+        totalCalls: number;
+        byTool: Record<string, number>;
+        successRate: number;
+    };
+    llm: {
+        totalCalls: number;
+        totalTokens: number;
+        averageTokensPerCall: number;
+        errors: number;
+    };
+    memory: {
+        totalRetrievals: number;
+        averageRetrievalTime: number;
+    };
+}
+export declare class MetricsCollector {
+    private executionCount;
+    private successCount;
+    private failureCount;
+    private durations;
+    private toolCalls;
+    private toolSuccesses;
+    private toolFailures;
+    private llmCalls;
+    private llmTokens;
+    private llmErrors;
+    private memoryRetrievals;
+    private memoryRetrievalTimes;
+    private startTime;
+    constructor();
+    /**
+     * Record an agent execution
+     */
+    recordExecution(success: boolean, durationMs: number): void;
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName: string, success: boolean): void;
+    /**
+     * Record an LLM call
+     */
+    recordLLMCall(tokens: number, error?: boolean): void;
+    /**
+     * Record a memory retrieval
+     */
+    recordMemoryRetrieval(durationMs: number): void;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): AgentMetrics;
+    /**
+     * Get metrics summary as string
+     */
+    getSummary(): string;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    private calculateAverage;
+    private calculatePercentile;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/metrics.d.ts.map

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

package/dist/utils/metrics.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Metrics Collection
+ * Track agent performance and usage metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+class MetricsCollector {
+    constructor() {
+        this.executionCount = 0;
+        this.successCount = 0;
+        this.failureCount = 0;
+        this.durations = [];
+        this.toolCalls = {};
+        this.toolSuccesses = 0;
+        this.toolFailures = 0;
+        this.llmCalls = 0;
+        this.llmTokens = 0;
+        this.llmErrors = 0;
+        this.memoryRetrievals = 0;
+        this.memoryRetrievalTimes = [];
+        this.startTime = Date.now();
+    }
+    /**
+     * Record an agent execution
+     */
+    recordExecution(success, durationMs) {
+        this.executionCount++;
+        if (success) {
+            this.successCount++;
+        }
+        else {
+            this.failureCount++;
+        }
+        this.durations.push(durationMs);
+        // Keep only last 1000 durations to prevent memory bloat
+        if (this.durations.length > 1000) {
+            this.durations = this.durations.slice(-1000);
+        }
+    }
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName, success) {
+        this.toolCalls[toolName] = (this.toolCalls[toolName] || 0) + 1;
+        if (success) {
+            this.toolSuccesses++;
+        }
+        else {
+            this.toolFailures++;
+        }
+    }
+    /**
+     * Record an LLM call
+     */
+    recordLLMCall(tokens, error = false) {
+        this.llmCalls++;
+        this.llmTokens += tokens;
+        if (error) {
+            this.llmErrors++;
+        }
+    }
+    /**
+     * Record a memory retrieval
+     */
+    recordMemoryRetrieval(durationMs) {
+        this.memoryRetrievals++;
+        this.memoryRetrievalTimes.push(durationMs);
+        // Keep only last 1000 retrieval times
+        if (this.memoryRetrievalTimes.length > 1000) {
+            this.memoryRetrievalTimes = this.memoryRetrievalTimes.slice(-1000);
+        }
+    }
+    /**
+     * Get all metrics
+     */
+    getMetrics() {
+        const sortedDurations = [...this.durations].sort((a, b) => a - b);
+        const totalToolCalls = this.toolSuccesses + this.toolFailures;
+        return {
+            executions: {
+                total: this.executionCount,
+                successful: this.successCount,
+                failed: this.failureCount,
+                successRate: this.executionCount > 0 ? this.successCount / this.executionCount : 0,
+            },
+            performance: {
+                averageDuration: this.calculateAverage(this.durations),
+                minDuration: Math.min(...this.durations, Infinity),
+                maxDuration: Math.max(...this.durations, -Infinity),
+                p50Duration: this.calculatePercentile(sortedDurations, 50),
+                p95Duration: this.calculatePercentile(sortedDurations, 95),
+                p99Duration: this.calculatePercentile(sortedDurations, 99),
+            },
+            tools: {
+                totalCalls: totalToolCalls,
+                byTool: { ...this.toolCalls },
+                successRate: totalToolCalls > 0 ? this.toolSuccesses / totalToolCalls : 0,
+            },
+            llm: {
+                totalCalls: this.llmCalls,
+                totalTokens: this.llmTokens,
+                averageTokensPerCall: this.llmCalls > 0 ? this.llmTokens / this.llmCalls : 0,
+                errors: this.llmErrors,
+            },
+            memory: {
+                totalRetrievals: this.memoryRetrievals,
+                averageRetrievalTime: this.calculateAverage(this.memoryRetrievalTimes),
+            },
+        };
+    }
+    /**
+     * Get metrics summary as string
+     */
+    getSummary() {
+        const metrics = this.getMetrics();
+        const uptime = Math.floor((Date.now() - this.startTime) / 1000);
+        return `
+Agent Metrics Summary
+=====================
+Uptime: ${uptime}s
+
+Executions:
+  Total: ${metrics.executions.total}
+  Success: ${metrics.executions.successful}
+  Failed: ${metrics.executions.failed}
+  Success Rate: ${(metrics.executions.successRate * 100).toFixed(2)}%
+
+Performance:
+  Avg Duration: ${metrics.performance.averageDuration.toFixed(2)}ms
+  P50: ${metrics.performance.p50Duration.toFixed(2)}ms
+  P95: ${metrics.performance.p95Duration.toFixed(2)}ms
+  P99: ${metrics.performance.p99Duration.toFixed(2)}ms
+
+Tools:
+  Total Calls: ${metrics.tools.totalCalls}
+  Success Rate: ${(metrics.tools.successRate * 100).toFixed(2)}%
+  Top Tools: ${Object.entries(metrics.tools.byTool)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([name, count]) => `${name} (${count})`)
+            .join(', ')}
+
+LLM:
+  Total Calls: ${metrics.llm.totalCalls}
+  Total Tokens: ${metrics.llm.totalTokens}
+  Avg Tokens/Call: ${metrics.llm.averageTokensPerCall.toFixed(2)}
+  Errors: ${metrics.llm.errors}
+
+Memory:
+  Total Retrievals: ${metrics.memory.totalRetrievals}
+  Avg Retrieval Time: ${metrics.memory.averageRetrievalTime.toFixed(2)}ms
+    `.trim();
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this.executionCount = 0;
+        this.successCount = 0;
+        this.failureCount = 0;
+        this.durations = [];
+        this.toolCalls = {};
+        this.toolSuccesses = 0;
+        this.toolFailures = 0;
+        this.llmCalls = 0;
+        this.llmTokens = 0;
+        this.llmErrors = 0;
+        this.memoryRetrievals = 0;
+        this.memoryRetrievalTimes = [];
+        this.startTime = Date.now();
+    }
+    calculateAverage(values) {
+        if (values.length === 0)
+            return 0;
+        return values.reduce((sum, val) => sum + val, 0) / values.length;
+    }
+    calculatePercentile(sortedValues, percentile) {
+        if (sortedValues.length === 0)
+            return 0;
+        const index = Math.ceil((percentile / 100) * sortedValues.length) - 1;
+        return sortedValues[Math.max(0, index)] || 0;
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Rate Limiter
+ * Token bucket algorithm for rate limiting agent executions
+ */
+export interface RateLimiterConfig {
+    tokensPerMinute: number;
+    burstSize?: number;
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private readonly tokensPerMinute;
+    private readonly burstSize;
+    private readonly refillRate;
+    constructor(config: RateLimiterConfig);
+    /**
+     * Try to consume a token
+     * @returns true if token was consumed, false if rate limit exceeded
+     */
+    tryConsume(): boolean;
+    /**
+     * Wait until a token is available
+     * @param timeoutMs Maximum time to wait in milliseconds
+     * @returns true if token was acquired, false if timeout
+     */
+    waitForToken(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Get current token count
+     */
+    getAvailableTokens(): number;
+    /**
+     * Reset the rate limiter
+     */
+    reset(): void;
+    /**
+     * Refill tokens based on elapsed time
+     */
+    private refill;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,iBAAiB;IAQrC;;;OAGG;IACH,UAAU,IAAI,OAAO;IAWrB;;;;OAIG;IACG,YAAY,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB/D;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAK5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,CAAC,MAAM;IASd;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Rate Limiter
+ * Token bucket algorithm for rate limiting agent executions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+class RateLimiter {
+    constructor(config) {
+        this.tokensPerMinute = config.tokensPerMinute;
+        this.burstSize = config.burstSize || config.tokensPerMinute;
+        this.tokens = this.burstSize;
+        this.lastRefill = Date.now();
+        this.refillRate = this.tokensPerMinute / 60000; // tokens per millisecond
+    }
+    /**
+     * Try to consume a token
+     * @returns true if token was consumed, false if rate limit exceeded
+     */
+    tryConsume() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Wait until a token is available
+     * @param timeoutMs Maximum time to wait in milliseconds
+     * @returns true if token was acquired, false if timeout
+     */
+    async waitForToken(timeoutMs = 30000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            if (this.tryConsume()) {
+                return true;
+            }
+            // Calculate wait time until next token
+            const tokensNeeded = 1 - this.tokens;
+            const waitMs = Math.ceil(tokensNeeded / this.refillRate);
+            const remainingTimeout = timeoutMs - (Date.now() - startTime);
+            const actualWaitMs = Math.min(waitMs, remainingTimeout, 1000);
+            if (actualWaitMs > 0) {
+                await this.sleep(actualWaitMs);
+            }
+        }
+        return false;
+    }
+    /**
+     * Get current token count
+     */
+    getAvailableTokens() {
+        this.refill();
+        return Math.floor(this.tokens);
+    }
+    /**
+     * Reset the rate limiter
+     */
+    reset() {
+        this.tokens = this.burstSize;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Refill tokens based on elapsed time
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const tokensToAdd = elapsed * this.refillRate;
+        this.tokens = Math.min(this.burstSize, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAOH,MAAa,WAAW;IAOtB,YAAY,MAAyB;QACnC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,eAAe,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,yBAAyB;IAC3E,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,YAAoB,KAAK;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,uCAAuC;YACvC,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,gBAAgB,GAAG,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAE9D,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;QAE9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AA3FD,kCA2FC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Retry Logic with Exponential Backoff
+ * Handles transient failures with configurable retry strategies
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    retryableErrors?: string[];
+    onRetry?: (attempt: number, error: Error) => void;
+}
+export declare class RetryError extends Error {
+    readonly attempts: number;
+    readonly lastError: Error;
+    constructor(message: string, attempts: number, lastError: Error);
+}
+export declare class RetryHandler {
+    private config;
+    constructor(config?: Partial<RetryConfig>);
+    /**
+     * Execute a function with retry logic
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryable;
+    /**
+     * Calculate delay with exponential backoff and jitter
+     */
+    private calculateDelay;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+}
+/**
+ * Decorator for automatic retry
+ */
+export declare function Retry(config?: Partial<RetryConfig>): MethodDecorator;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD;AAED,qBAAa,UAAW,SAAQ,KAAK;aAGjB,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,KAAK;gBAFhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK;CAKnC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAmB7C;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqClD;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,eAAe,CAYpE"}

package/dist/utils/retry.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Retry Logic with Exponential Backoff
+ * Handles transient failures with configurable retry strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryHandler = exports.RetryError = void 0;
+exports.Retry = Retry;
+class RetryError extends Error {
+    constructor(message, attempts, lastError) {
+        super(message);
+        this.attempts = attempts;
+        this.lastError = lastError;
+        this.name = 'RetryError';
+    }
+}
+exports.RetryError = RetryError;
+class RetryHandler {
+    constructor(config = {}) {
+        this.config = {
+            maxRetries: config.maxRetries ?? 3,
+            initialDelayMs: config.initialDelayMs ?? 1000,
+            maxDelayMs: config.maxDelayMs ?? 30000,
+            backoffMultiplier: config.backoffMultiplier ?? 2,
+            retryableErrors: config.retryableErrors ?? [
+                'ECONNRESET',
+                'ETIMEDOUT',
+                'ENOTFOUND',
+                'ECONNREFUSED',
+                'RATE_LIMIT',
+                'SERVICE_UNAVAILABLE',
+                'TIMEOUT',
+            ],
+            onRetry: config.onRetry ?? (() => { }),
+        };
+    }
+    /**
+     * Execute a function with retry logic
+     */
+    async execute(fn) {
+        let lastError;
+        let attempt = 0;
+        while (attempt <= this.config.maxRetries) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                attempt++;
+                if (attempt > this.config.maxRetries) {
+                    throw new RetryError(`Failed after ${attempt} attempts: ${lastError.message}`, attempt, lastError);
+                }
+                if (!this.isRetryable(lastError)) {
+                    throw lastError;
+                }
+                const delay = this.calculateDelay(attempt);
+                this.config.onRetry(attempt, lastError);
+                await this.sleep(delay);
+            }
+        }
+        throw new RetryError(`Failed after ${attempt} attempts: ${lastError.message}`, attempt, lastError);
+    }
+    /**
+     * Check if an error is retryable
+     */
+    isRetryable(error) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const errorCode = error.code || error.name;
+        const errorMessage = error.message.toUpperCase();
+        return this.config.retryableErrors.some((retryableError) => errorCode === retryableError || errorMessage.includes(retryableError.toUpperCase()));
+    }
+    /**
+     * Calculate delay with exponential backoff and jitter
+     */
+    calculateDelay(attempt) {
+        const exponentialDelay = this.config.initialDelayMs * Math.pow(this.config.backoffMultiplier, attempt - 1);
+        const delayWithCap = Math.min(exponentialDelay, this.config.maxDelayMs);
+        // Add jitter (±25%)
+        const jitter = delayWithCap * 0.25 * (Math.random() * 2 - 1);
+        return Math.max(0, delayWithCap + jitter);
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.RetryHandler = RetryHandler;
+/**
+ * Decorator for automatic retry
+ */
+function Retry(config) {
+    const retryHandler = new RetryHandler(config);
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            return retryHandler.execute(() => originalMethod.apply(this, args));
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/jest.config.js

@@ -0,0 +1,30 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/tests'],
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  transform: {
+    '^.+\\.ts$': 'ts-jest',
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 90,
+      lines: 90,
+      statements: 90,
+    },
+  },
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'clover'],
+  verbose: true,
+  moduleNameMapper: {
+    '^@hazeljs/core$': '<rootDir>/../core/src',
+    '^@hazeljs/rag$': '<rootDir>/../rag/src',
+  },
+  setupFilesAfterEnv: ['<rootDir>/tests/setup.ts'],
+};

package/logs/combined.log

@@ -0,0 +1 @@
+2026-03-08 14:07:23 [INFO] Application started | {"service":"hazeljs","version":"0.1.0","environment":"test"}