@lleverage-ai/agent-sdk 0.0.1

package/dist/hooks/retry.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Retry hook utilities.
+ *
+ * Provides retry hooks with exponential backoff that replace the retry
+ * middleware functionality using the unified hook system.
+ *
+ * @packageDocumentation
+ */
+import type { HookCallback } from "../types.js";
+/**
+ * Options for creating retry hooks.
+ *
+ * @category Hooks
+ */
+export interface RetryHooksOptions {
+    /**
+     * Maximum number of retry attempts.
+     * @defaultValue 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay in milliseconds for the first retry.
+     * @defaultValue 1000 (1 second)
+     */
+    baseDelay?: number;
+    /**
+     * Maximum delay in milliseconds between retries.
+     * @defaultValue 30000 (30 seconds)
+     */
+    maxDelay?: number;
+    /**
+     * Backoff multiplier for exponential backoff.
+     * @defaultValue 2 (doubles each retry)
+     */
+    backoffMultiplier?: number;
+    /**
+     * Whether to add random jitter to retry delays (0-50% of delay).
+     * Helps avoid thundering herd problem.
+     * @defaultValue true
+     */
+    jitter?: boolean;
+    /**
+     * Custom function to determine if an error should trigger a retry.
+     * @defaultValue Retries rate limits, server errors, network errors, timeouts
+     */
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    /**
+     * Custom delay calculator.
+     * @defaultValue Exponential backoff with jitter
+     */
+    calculateDelay?: (attempt: number) => number;
+}
+/**
+ * Creates a retry hook for PostGenerateFailure events.
+ *
+ * The hook implements exponential backoff with optional jitter for handling
+ * transient failures. When a retryable error occurs, the hook signals the
+ * agent to retry with an appropriate delay.
+ *
+ * This replaces the retry middleware with hook-based retry that works
+ * correctly with the unified hook system.
+ *
+ * @param options - Configuration options
+ * @returns A PostGenerateFailure hook that handles retries
+ *
+ * @example
+ * ```typescript
+ * const retryHook = createRetryHooks({
+ *   maxRetries: 3,
+ *   baseDelay: 1000,
+ *   backoffMultiplier: 2,
+ * });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PostGenerateFailure: [{ hooks: [retryHook] }],
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom retry logic for specific errors
+ * const retryHook = createRetryHooks({
+ *   shouldRetry: (error, attempt) => {
+ *     // Only retry rate limits, and only up to 5 times
+ *     return error.message.includes('rate limit') && attempt < 5;
+ *   },
+ *   baseDelay: 2000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom delay calculation (linear backoff)
+ * const retryHook = createRetryHooks({
+ *   calculateDelay: (attempt) => attempt * 1000, // 1s, 2s, 3s, ...
+ * });
+ * ```
+ *
+ * @category Hooks
+ */
+export declare function createRetryHooks(options?: RetryHooksOptions): HookCallback;
+/**
+ * Creates a retry hook with custom statistics tracking.
+ *
+ * Returns the hook along with a function to get retry statistics.
+ *
+ * @param options - Configuration options
+ * @returns Object with hook and statistics getter
+ *
+ * @example
+ * ```typescript
+ * const { hook: retryHook, getStats } = createManagedRetryHooks({
+ *   maxRetries: 5,
+ *   baseDelay: 1000,
+ * });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PostGenerateFailure: [{ hooks: [retryHook] }],
+ *   },
+ * });
+ *
+ * // Later, check statistics
+ * const stats = getStats();
+ * console.log(`Retry rate: ${stats.retries / stats.failures}`);
+ * console.log(`Average retries per failure: ${stats.retries / Math.max(1, stats.retriedFailures)}`);
+ * ```
+ *
+ * @category Hooks
+ */
+export declare function createManagedRetryHooks(options?: RetryHooksOptions): {
+    hook: HookCallback;
+    getStats: () => {
+        failures: number;
+        retries: number;
+        retriedFailures: number;
+        successAfterRetry: number;
+    };
+};
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/hooks/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,aAAa,CAAC;AAE/F;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAEzD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,YAAY,CAuD9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IACxE,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAgEA"}

package/dist/hooks/retry.js

@@ -0,0 +1,210 @@
+/**
+ * Retry hook utilities.
+ *
+ * Provides retry hooks with exponential backoff that replace the retry
+ * middleware functionality using the unified hook system.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Default function to determine if an error should trigger a retry.
+ *
+ * Retries on:
+ * - Rate limit errors (429, "rate limit")
+ * - Server errors (5xx)
+ * - Network errors (ECONNRESET, ECONNREFUSED, ETIMEDOUT)
+ * - Timeout errors
+ */
+function defaultShouldRetry(error, _attempt) {
+    const message = error.message.toLowerCase();
+    // Rate limit
+    if (message.includes("rate limit") || message.includes("429")) {
+        return true;
+    }
+    // Server errors
+    if (message.includes("500") ||
+        message.includes("502") ||
+        message.includes("503") ||
+        message.includes("504")) {
+        return true;
+    }
+    // Network errors
+    if (message.includes("network") ||
+        message.includes("econnreset") ||
+        message.includes("econnrefused") ||
+        message.includes("etimedout")) {
+        return true;
+    }
+    // Timeout errors
+    if (message.includes("timeout")) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Creates a retry hook for PostGenerateFailure events.
+ *
+ * The hook implements exponential backoff with optional jitter for handling
+ * transient failures. When a retryable error occurs, the hook signals the
+ * agent to retry with an appropriate delay.
+ *
+ * This replaces the retry middleware with hook-based retry that works
+ * correctly with the unified hook system.
+ *
+ * @param options - Configuration options
+ * @returns A PostGenerateFailure hook that handles retries
+ *
+ * @example
+ * ```typescript
+ * const retryHook = createRetryHooks({
+ *   maxRetries: 3,
+ *   baseDelay: 1000,
+ *   backoffMultiplier: 2,
+ * });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PostGenerateFailure: [{ hooks: [retryHook] }],
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom retry logic for specific errors
+ * const retryHook = createRetryHooks({
+ *   shouldRetry: (error, attempt) => {
+ *     // Only retry rate limits, and only up to 5 times
+ *     return error.message.includes('rate limit') && attempt < 5;
+ *   },
+ *   baseDelay: 2000,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom delay calculation (linear backoff)
+ * const retryHook = createRetryHooks({
+ *   calculateDelay: (attempt) => attempt * 1000, // 1s, 2s, 3s, ...
+ * });
+ * ```
+ *
+ * @category Hooks
+ */
+export function createRetryHooks(options = {}) {
+    const { maxRetries = 3, baseDelay = 1000, maxDelay = 30000, backoffMultiplier = 2, jitter = true, shouldRetry = defaultShouldRetry, calculateDelay: customCalculateDelay, } = options;
+    /**
+     * Calculate delay for next retry with exponential backoff and optional jitter.
+     */
+    function calculateDelay(attempt) {
+        // Exponential backoff: baseDelay * multiplier^(attempt-1)
+        let delay = baseDelay * backoffMultiplier ** (attempt - 1);
+        // Cap at maxDelay
+        delay = Math.min(delay, maxDelay);
+        // Add jitter (0-50% of delay)
+        if (jitter) {
+            delay = delay * (0.5 + Math.random() * 0.5);
+        }
+        return Math.round(delay);
+    }
+    const delayCalculator = customCalculateDelay || calculateDelay;
+    const retryHook = async (input, _toolUseId, context) => {
+        if (input.hook_event_name !== "PostGenerateFailure")
+            return {};
+        const failureInput = input;
+        const attempt = context.retryAttempt ?? 0;
+        // Check if we should retry
+        if (attempt < maxRetries && shouldRetry(failureInput.error, attempt + 1)) {
+            const delay = delayCalculator(attempt + 1);
+            return {
+                hookSpecificOutput: {
+                    hookEventName: "PostGenerateFailure",
+                    retry: true,
+                    retryDelayMs: delay,
+                },
+            };
+        }
+        // Max retries reached or error not retryable - let error propagate
+        return {};
+    };
+    return retryHook;
+}
+/**
+ * Creates a retry hook with custom statistics tracking.
+ *
+ * Returns the hook along with a function to get retry statistics.
+ *
+ * @param options - Configuration options
+ * @returns Object with hook and statistics getter
+ *
+ * @example
+ * ```typescript
+ * const { hook: retryHook, getStats } = createManagedRetryHooks({
+ *   maxRetries: 5,
+ *   baseDelay: 1000,
+ * });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PostGenerateFailure: [{ hooks: [retryHook] }],
+ *   },
+ * });
+ *
+ * // Later, check statistics
+ * const stats = getStats();
+ * console.log(`Retry rate: ${stats.retries / stats.failures}`);
+ * console.log(`Average retries per failure: ${stats.retries / Math.max(1, stats.retriedFailures)}`);
+ * ```
+ *
+ * @category Hooks
+ */
+export function createManagedRetryHooks(options = {}) {
+    const { maxRetries = 3, baseDelay = 1000, maxDelay = 30000, backoffMultiplier = 2, jitter = true, shouldRetry = defaultShouldRetry, calculateDelay: customCalculateDelay, } = options;
+    let totalFailures = 0;
+    let totalRetries = 0;
+    let retriedFailures = 0;
+    const successAfterRetry = 0;
+    function calculateDelay(attempt) {
+        let delay = baseDelay * backoffMultiplier ** (attempt - 1);
+        delay = Math.min(delay, maxDelay);
+        if (jitter) {
+            delay = delay * (0.5 + Math.random() * 0.5);
+        }
+        return Math.round(delay);
+    }
+    const delayCalculator = customCalculateDelay || calculateDelay;
+    const retryHook = async (input, _toolUseId, context) => {
+        if (input.hook_event_name !== "PostGenerateFailure")
+            return {};
+        const failureInput = input;
+        const attempt = context.retryAttempt ?? 0;
+        totalFailures++;
+        if (attempt < maxRetries && shouldRetry(failureInput.error, attempt + 1)) {
+            if (attempt === 0) {
+                retriedFailures++;
+            }
+            totalRetries++;
+            const delay = delayCalculator(attempt + 1);
+            return {
+                hookSpecificOutput: {
+                    hookEventName: "PostGenerateFailure",
+                    retry: true,
+                    retryDelayMs: delay,
+                },
+            };
+        }
+        return {};
+    };
+    return {
+        hook: retryHook,
+        getStats: () => ({
+            failures: totalFailures,
+            retries: totalRetries,
+            retriedFailures,
+            successAfterRetry,
+        }),
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/hooks/retry.js.map

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

package/dist/hooks/secrets.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Secrets filtering hook utilities.
+ *
+ * Provides hooks to detect and redact common secret patterns in inputs
+ * and outputs using the unified hook system.
+ *
+ * @packageDocumentation
+ */
+import type { HookCallback } from "../types.js";
+/**
+ * Common secret patterns for automatic detection.
+ *
+ * @category Hooks
+ */
+export declare const COMMON_SECRET_PATTERNS: {
+    /** AWS access keys (AKIA...) */
+    AWS_ACCESS_KEY: RegExp;
+    /** AWS secret keys (40 chars base64) */
+    AWS_SECRET_KEY: RegExp;
+    /** GitHub personal access tokens */
+    GITHUB_TOKEN: RegExp;
+    /** GitHub OAuth tokens */
+    GITHUB_OAUTH: RegExp;
+    /** Generic API keys (common formats) */
+    API_KEY: RegExp;
+    /** Bearer tokens */
+    BEARER_TOKEN: RegExp;
+    /** JWT tokens */
+    JWT: RegExp;
+    /** Private keys (PEM format headers) */
+    PRIVATE_KEY: RegExp;
+    /** Generic passwords in common formats */
+    PASSWORD: RegExp;
+    /** Slack tokens */
+    SLACK_TOKEN: RegExp;
+    /** Stripe API keys */
+    STRIPE_KEY: RegExp;
+    /** Generic secrets in common formats */
+    GENERIC_SECRET: RegExp;
+};
+/**
+ * Options for creating secrets filter hooks.
+ *
+ * @category Hooks
+ */
+export interface SecretsFilterHooksOptions {
+    /**
+     * Custom secret patterns to detect (in addition to built-in patterns).
+     */
+    customPatterns?: RegExp[];
+    /**
+     * Built-in patterns to use.
+     * @defaultValue All patterns from COMMON_SECRET_PATTERNS
+     */
+    patterns?: RegExp[];
+    /**
+     * Replacement text for redacted secrets.
+     * @defaultValue "[REDACTED]"
+     */
+    redactionText?: string;
+    /**
+     * Whether to filter input (user messages).
+     * @defaultValue true
+     */
+    filterInput?: boolean;
+    /**
+     * Whether to filter output (model responses).
+     * @defaultValue true
+     */
+    filterOutput?: boolean;
+    /**
+     * Callback when secrets are detected.
+     * Useful for logging/alerting.
+     */
+    onSecretDetected?: (type: "input" | "output", pattern: RegExp, match: string) => void;
+}
+/**
+ * Creates secrets filtering hooks for input and output.
+ *
+ * The PreGenerate hook redacts secrets from input messages before sending
+ * to the model. The PostGenerate hook redacts secrets from model responses.
+ *
+ * This addresses the secrets redaction requirement from CODE_REVIEW.md
+ * using the unified hook system.
+ *
+ * @param options - Configuration options
+ * @returns Array of two hooks: [PreGenerate input filter, PostGenerate output filter]
+ *
+ * @example
+ * ```typescript
+ * const [inputFilter, outputFilter] = createSecretsFilterHooks({
+ *   redactionText: "***REDACTED***",
+ * });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PreGenerate: [{ hooks: [inputFilter] }],
+ *     PostGenerate: [{ hooks: [outputFilter] }],
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom patterns with alerting
+ * const hooks = createSecretsFilterHooks({
+ *   customPatterns: [/my-secret-format-[A-Z0-9]{16}/g],
+ *   onSecretDetected: (type, pattern, match) => {
+ *     console.warn(`Secret detected in ${type}:`, pattern.source);
+ *     alertSecurityTeam({ type, pattern: pattern.source });
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Only specific patterns
+ * const hooks = createSecretsFilterHooks({
+ *   patterns: [
+ *     COMMON_SECRET_PATTERNS.AWS_ACCESS_KEY,
+ *     COMMON_SECRET_PATTERNS.GITHUB_TOKEN,
+ *   ],
+ * });
+ * ```
+ *
+ * @category Hooks
+ */
+export declare function createSecretsFilterHooks(options?: SecretsFilterHooksOptions): [HookCallback, HookCallback];
+/**
+ * Creates managed secrets filter hooks with detection statistics.
+ *
+ * Returns hooks along with functions to get detection statistics.
+ *
+ * @param options - Configuration options
+ * @returns Object with hooks and statistics getter
+ *
+ * @example
+ * ```typescript
+ * const { hooks, getStats, getDetections } = createManagedSecretsFilterHooks();
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     PreGenerate: [{ hooks: [hooks[0]] }],
+ *     PostGenerate: [{ hooks: [hooks[1]] }],
+ *   },
+ * });
+ *
+ * // Check statistics
+ * const stats = getStats();
+ * console.log(`Secrets detected: ${stats.totalDetections} (${stats.inputDetections} input, ${stats.outputDetections} output)`);
+ *
+ * // Get detailed detections
+ * const detections = getDetections();
+ * console.log('Recent detections:', detections.slice(0, 10));
+ * ```
+ *
+ * @category Hooks
+ */
+export declare function createManagedSecretsFilterHooks(options?: SecretsFilterHooksOptions): {
+    hooks: [HookCallback, HookCallback];
+    getStats: () => {
+        inputDetections: number;
+        outputDetections: number;
+        totalDetections: number;
+    };
+    getDetections: () => Array<{
+        type: "input" | "output";
+        pattern: string;
+        timestamp: number;
+    }>;
+};
+//# sourceMappingURL=secrets.d.ts.map

package/dist/hooks/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/hooks/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAuC,MAAM,aAAa,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,gCAAgC;;IAGhC,wCAAwC;;IAGxC,oCAAoC;;IAGpC,0BAA0B;;IAG1B,wCAAwC;;IAGxC,oBAAoB;;IAGpB,iBAAiB;;IAGjB,wCAAwC;;IAIxC,0CAA0C;;IAG1C,mBAAmB;;IAGnB,sBAAsB;;IAGtB,wCAAwC;;CAEzC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvF;AA6ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,CAAC,YAAY,EAAE,YAAY,CAAC,CA6E9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,yBAA8B,GAAG;IACxF,KAAK,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,aAAa,EAAE,MAAM,KAAK,CAAC;QACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ,CAqGA"}