@hazeljs/agent 1.0.0 → 1.0.2

package/dist/utils/agent-tracing.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Optional OpenTelemetry span helpers for agent runtime (no hard dependency on @hazeljs/observability).
+ */
+import type { ObservabilityProvider } from '../types/observability.types';
+export declare function withAgentSpan<T>(name: string, attributes: Record<string, string | number | boolean>, fn: () => Promise<T>, observability?: ObservabilityProvider): Promise<T>;
+export declare function trackLlmCost(observability: ObservabilityProvider | undefined, model: string | undefined, usage?: {
+    promptTokens?: number;
+    completionTokens?: number;
+}): void;
+//# sourceMappingURL=agent-tracing.d.ts.map

package/dist/utils/agent-tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tracing.d.ts","sourceRoot":"","sources":["../../src/utils/agent-tracing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA+C1E,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACrD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,aAAa,CAAC,EAAE,qBAAqB,GACpC,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAED,wBAAgB,YAAY,CAC1B,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,IAAI,CAGN"}

package/dist/utils/agent-tracing.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Optional OpenTelemetry span helpers for agent runtime (no hard dependency on @hazeljs/observability).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAgentSpan = withAgentSpan;
+exports.trackLlmCost = trackLlmCost;
+const SPAN_OK = 1;
+const SPAN_ERROR = 2;
+let otelApi;
+let otelLoadFailed = false;
+function getOtelApiSync() {
+    if (otelApi !== undefined) {
+        return otelApi;
+    }
+    if (otelLoadFailed) {
+        return null;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        otelApi = require('@opentelemetry/api');
+        return otelApi;
+    }
+    catch {
+        otelLoadFailed = true;
+        otelApi = null;
+        return null;
+    }
+}
+async function loadOtelApi() {
+    const sync = getOtelApiSync();
+    if (sync)
+        return sync;
+    if (otelLoadFailed)
+        return null;
+    try {
+        otelApi = await Promise.resolve().then(() => __importStar(require('@opentelemetry/api')));
+        return otelApi;
+    }
+    catch {
+        otelLoadFailed = true;
+        otelApi = null;
+        return null;
+    }
+}
+async function withAgentSpan(name, attributes, fn, observability) {
+    if (!observability) {
+        return fn();
+    }
+    const api = getOtelApiSync() ?? (await loadOtelApi());
+    if (!api) {
+        return fn();
+    }
+    const tracer = observability?.getTracer('hazeljs-agent') ?? api.trace.getTracer('hazeljs-agent');
+    return tracer.startActiveSpan(name, async (span) => {
+        const activeSpan = span;
+        for (const [key, value] of Object.entries(attributes)) {
+            activeSpan.setAttribute(key, value);
+        }
+        try {
+            const result = await fn();
+            activeSpan.setStatus({ code: SPAN_OK });
+            return result;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            activeSpan.recordException(err);
+            activeSpan.setStatus({ code: SPAN_ERROR, message: err.message });
+            throw error;
+        }
+        finally {
+            activeSpan.end();
+        }
+    });
+}
+function trackLlmCost(observability, model, usage) {
+    if (!observability || !model || !usage)
+        return;
+    observability.trackCost(model, usage.promptTokens ?? 0, usage.completionTokens ?? 0);
+}
+//# sourceMappingURL=agent-tracing.js.map

package/dist/utils/agent-tracing.js.map

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

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

@@ -1,44 +1,20 @@
 /**
- * Rate Limiter
- * Token bucket algorithm for rate limiting agent executions
+ * @deprecated Use TokenBucketLimiter from @hazeljs/resilience directly.
+ * Adapter preserving tokensPerMinute / waitForToken API used by AgentRuntime.
  */
 export interface RateLimiterConfig {
     tokensPerMinute: number;
     burstSize?: number;
 }
 export declare class RateLimiter {
-    private tokens;
-    private lastRefill;
-    private readonly tokensPerMinute;
-    private readonly burstSize;
-    private readonly refillRate;
+    private limiter;
+    private readonly maxTokens;
+    private readonly refillRatePerSecond;
     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
-     */
+    /** Approximate peek: 1 when a token is available, 0 otherwise. */
     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

@@ -1 +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"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,MAAM,EAAE,iBAAiB;IAMrC,UAAU,IAAI,OAAO;IAIf,YAAY,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB/D,kEAAkE;IAClE,kBAAkB,IAAI,MAAM;IAI5B,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/rate-limiter.js

@@ -1,82 +1,45 @@
 "use strict";
 /**
- * Rate Limiter
- * Token bucket algorithm for rate limiting agent executions
+ * @deprecated Use TokenBucketLimiter from @hazeljs/resilience directly.
+ * Adapter preserving tokensPerMinute / waitForToken API used by AgentRuntime.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimiter = void 0;
+const resilience_1 = require("@hazeljs/resilience");
 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
+        this.maxTokens = config.burstSize ?? config.tokensPerMinute;
+        this.refillRatePerSecond = config.tokensPerMinute / 60;
+        this.limiter = new resilience_1.TokenBucketLimiter(this.maxTokens, this.refillRatePerSecond);
     }
-    /**
-     * 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;
+        return this.limiter.tryAcquire();
     }
-    /**
-     * 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()) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            if (this.limiter.tryAcquire()) {
                 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);
+            const waitMs = Math.min(this.limiter.getRetryAfterMs(), 1000, timeoutMs - (Date.now() - start));
+            if (waitMs <= 0) {
+                await sleep(50);
+                continue;
             }
+            await sleep(waitMs);
         }
         return false;
     }
-    /**
-     * Get current token count
-     */
+    /** Approximate peek: 1 when a token is available, 0 otherwise. */
     getAvailableTokens() {
-        this.refill();
-        return Math.floor(this.tokens);
+        return this.limiter.getRetryAfterMs() === 0 ? 1 : 0;
     }
-    /**
-     * 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));
+        this.limiter = new resilience_1.TokenBucketLimiter(this.maxTokens, this.refillRatePerSecond);
     }
 }
 exports.RateLimiter = RateLimiter;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 //# sourceMappingURL=rate-limiter.js.map

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

@@ -1 +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"}
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,oDAAyD;AAOzD,MAAa,WAAW;IAKtB,YAAY,MAAyB;QACnC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,eAAe,CAAC;QAC5D,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,eAAe,GAAG,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClF,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,YAAoB,KAAK;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAC9B,IAAI,EACJ,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CACjC,CAAC;YACF,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kEAAkE;IAClE,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClF,CAAC;CACF;AA3CD,kCA2CC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/retry.d.ts

@@ -1,6 +1,6 @@
 /**
- * Retry Logic with Exponential Backoff
- * Handles transient failures with configurable retry strategies
+ * @deprecated Use RetryPolicy from @hazeljs/resilience directly.
+ * Thin adapter preserving the legacy RetryHandler API.
  */
 export interface RetryConfig {
     maxRetries: number;
@@ -16,27 +16,9 @@ export declare class RetryError extends Error {
     constructor(message: string, attempts: number, lastError: Error);
 }
 export declare class RetryHandler {
-    private config;
+    private readonly policy;
     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

@@ -1 +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"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,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,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IA+BvC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAenD;AAED,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,eAAe,CAYpE"}

package/dist/utils/retry.js

@@ -1,11 +1,12 @@
 "use strict";
 /**
- * Retry Logic with Exponential Backoff
- * Handles transient failures with configurable retry strategies
+ * @deprecated Use RetryPolicy from @hazeljs/resilience directly.
+ * Thin adapter preserving the legacy RetryHandler API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetryHandler = exports.RetryError = void 0;
 exports.Retry = Retry;
+const resilience_1 = require("@hazeljs/resilience");
 class RetryError extends Error {
     constructor(message, attempts, lastError) {
         super(message);
@@ -17,82 +18,49 @@ class RetryError extends Error {
 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 ?? (() => { }),
-        };
+        const retryableErrors = config.retryableErrors ?? [
+            'ECONNRESET',
+            'ETIMEDOUT',
+            'ENOTFOUND',
+            'ECONNREFUSED',
+            'RATE_LIMIT',
+            'SERVICE_UNAVAILABLE',
+            'TIMEOUT',
+        ];
+        this.policy = new resilience_1.RetryPolicy({
+            maxAttempts: config.maxRetries ?? 3,
+            baseDelay: config.initialDelayMs ?? 1000,
+            maxDelay: config.maxDelayMs ?? 30000,
+            backoff: 'exponential',
+            jitter: true,
+            onRetry: config.onRetry
+                ? (error, attempt) => config.onRetry(attempt, error)
+                : undefined,
+            retryPredicate: (error) => {
+                const err = error;
+                const errorCode = err.code || err.name;
+                const errorMessage = err.message.toUpperCase();
+                return retryableErrors.some((retryableError) => errorCode === retryableError || errorMessage.includes(retryableError.toUpperCase()));
+            },
+        });
     }
-    /**
-     * 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);
+        try {
+            return await this.policy.execute(fn);
+        }
+        catch (error) {
+            if (error instanceof resilience_1.RetryExhaustedError) {
+                const totalAttempts = error.attempts + 1;
+                throw new RetryError(`Failed after ${totalAttempts} attempts`, totalAttempts, error.lastError);
             }
+            throw error;
         }
-        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) {
+    return function (_target, _propertyKey, descriptor) {
         const originalMethod = descriptor.value;
         descriptor.value = async function (...args) {
             return retryHandler.execute(() => originalMethod.apply(this, args));

package/dist/utils/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2EH,sBAYC;AArFD,oDAAuE;AAWvE,MAAa,UAAW,SAAQ,KAAK;IACnC,YACE,OAAe,EACC,QAAgB,EAChB,SAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAO;QAGhC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AATD,gCASC;AAED,MAAa,YAAY;IAGvB,YAAY,SAA+B,EAAE;QAC3C,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI;YAChD,YAAY;YACZ,WAAW;YACX,WAAW;YACX,cAAc;YACd,YAAY;YACZ,qBAAqB;YACrB,SAAS;SACV,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAW,CAAC;YAC5B,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YACnC,SAAS,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;YACxC,QAAQ,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;YACpC,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO;gBACrB,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAQ,EAAE,CAAC,MAAM,CAAC,OAAQ,CAAC,OAAO,EAAE,KAAc,CAAC;gBACpE,CAAC,CAAC,SAAS;YACb,cAAc,EAAE,CAAC,KAAK,EAAW,EAAE;gBACjC,MAAM,GAAG,GAAG,KAAkC,CAAC;gBAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;gBACvC,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBAC/C,OAAO,eAAe,CAAC,IAAI,CACzB,CAAC,cAAc,EAAE,EAAE,CACjB,SAAS,KAAK,cAAc,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CACtF,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,EAAoB;QACnC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,gCAAmB,EAAE,CAAC;gBACzC,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACzC,MAAM,IAAI,UAAU,CAClB,gBAAgB,aAAa,WAAW,EACxC,aAAa,EACb,KAAK,CAAC,SAAkB,CACzB,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAjDD,oCAiDC;AAED,SAAgB,KAAK,CAAC,MAA6B;IACjD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAE9C,OAAO,UAAU,OAAe,EAAE,YAA6B,EAAE,UAA8B;QAC7F,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAe;YACnD,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazeljs/agent",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI-native Agent Runtime for HazelJS - stateful, long-running agents with tools, memory, and human-in-the-loop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hazel-js/hazeljs.git",
+    "url": "https://github.com/hazel-js/hazeljs",
     "directory": "packages/agent"
   },
   "publishConfig": {
@@ -38,11 +38,11 @@
     "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
-    "@hazeljs/core": "^1.0.0",
-    "@hazeljs/eval": "^1.0.0",
-    "@hazeljs/prompts": "^1.0.0",
-    "@hazeljs/rag": "^1.0.0",
-    "@hazeljs/resilience": "^1.0.0",
+    "@hazeljs/core": "^1.0.2",
+    "@hazeljs/eval": "^1.0.2",
+    "@hazeljs/prompts": "^1.0.2",
+    "@hazeljs/rag": "^1.0.2",
+    "@hazeljs/resilience": "^1.0.2",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.19.39",
     "jest": "^29.7.0",
@@ -50,12 +50,14 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@hazeljs/core": "^1.0.0",
-    "@hazeljs/eval": "^1.0.0",
-    "@hazeljs/guardrails": "^1.0.0",
-    "@hazeljs/prompts": "^1.0.0",
-    "@hazeljs/rag": "^1.0.0",
-    "@hazeljs/resilience": "^1.0.0",
+    "@hazeljs/core": "^1.0.2",
+    "@hazeljs/eval": "^1.0.2",
+    "@hazeljs/guardrails": "^1.0.2",
+    "@hazeljs/prompts": "^1.0.2",
+    "@hazeljs/rag": "^1.0.2",
+    "@hazeljs/resilience": "^1.0.2",
+    "@hazeljs/observability": "^1.0.2",
+    "@opentelemetry/api": "^1.9.0",
     "redis": ">=4.0.0"
   },
   "peerDependenciesMeta": {
@@ -74,6 +76,14 @@
     "@hazeljs/guardrails": {
       "optional": true,
       "description": "Optional guardrails for tool input/output validation"
+    },
+    "@hazeljs/observability": {
+      "optional": true,
+      "description": "OpenTelemetry spans and LLM cost tracking"
+    },
+    "@opentelemetry/api": {
+      "optional": true,
+      "description": "OpenTelemetry API for agent execution spans"
     }
   },
   "bugs": {

package/tsconfig.jest.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "composite": false,
+    "declaration": false,
+    "declarationMap": false,
+    "paths": {
+      "@hazeljs/eval": ["src/testing/mocks/hazeljs-eval.ts"],
+      "@hazeljs/prompts": ["../prompts/src"],
+      "@hazeljs/rag": ["../rag/src"],
+      "@hazeljs/resilience": ["../resilience/src"]
+    }
+  },
+  "include": ["src/**/*", "tests/**/*"]
+}