universal-agent-memory 0.7.3 → 0.8.0

package/dist/memory/adaptive-context.js

@@ -0,0 +1,456 @@
+/**
+ * Hybrid Adaptive Context Selector for UAM (Option 4)
+ *
+ * Combines task classification with time-budget awareness, runtime monitoring,
+ * and historical benefit tracking for optimal context loading decisions.
+ *
+ * Decision factors:
+ * 1. Task classification (reasoning vs domain-knowledge tasks)
+ * 2. Time budget (critical/high/medium/low pressure)
+ * 3. Historical success rate for similar tasks
+ * 4. Estimated overhead vs available time
+ */
+import { classifyTask as classifyTaskType } from './task-classifier.js';
+// Task categories that typically don't benefit from UAM context
+const LOW_BENEFIT_CATEGORIES = new Set([
+    'reasoning',
+    'scheduling',
+    'constraint-satisfaction',
+    'games',
+    'pure-logic',
+    'mathematical',
+]);
+// Keywords that suggest a task won't benefit from domain knowledge
+const SKIP_UAM_KEYWORDS = [
+    'schedule',
+    'scheduling',
+    'calendar',
+    'meeting',
+    'constraint',
+    'satisfy',
+    'optimize',
+    'chess move',
+    'best move',
+    'game theory',
+    'mathematical proof',
+    'prove that',
+    'logic puzzle',
+    'sudoku',
+];
+// Keywords that strongly suggest UAM will help
+const HIGH_BENEFIT_KEYWORDS = [
+    'password',
+    'hash',
+    'crack',
+    'decrypt',
+    'elf',
+    'binary',
+    'executable',
+    'extract',
+    'xss',
+    'injection',
+    'sanitize',
+    'filter',
+    'sqlite',
+    'database',
+    'recovery',
+    'wal',
+    'compile',
+    'build',
+    'makefile',
+    'cobol',
+    'modernize',
+    'legacy',
+];
+// Context sections with token counts and relevance keywords
+const CONTEXT_SECTIONS = {
+    security: {
+        tokens: 150,
+        keywords: ['xss', 'password', 'hash', 'crack', 'secret', 'exploit', 'injection', 'sanitize'],
+        content: `### Security
+- XSS: Use bleach.clean() or DOMPurify. Remove script, onclick, onerror, javascript:
+- Password cracking: hashcat -m 11600 for 7z, -m 0 MD5, john for CPU
+- Binary secrets: strings, objdump -d, check .rodata section
+- Always validate and sanitize user input`,
+    },
+    file_formats: {
+        tokens: 120,
+        keywords: ['elf', 'sqlite', '7z', 'archive', 'binary', 'extract', 'format'],
+        content: `### File Formats
+- ELF: Program headers at e_phoff. Use struct.unpack for parsing
+- SQLite WAL: Header 32 bytes, frames follow. PRAGMA wal_checkpoint to recover
+- 7z: Install p7zip-full, use 7z x -p for password protected archives`,
+    },
+    coding: {
+        tokens: 80,
+        keywords: ['implement', 'function', 'class', 'refactor', 'algorithm', 'code'],
+        content: `### Coding
+- Use absolute paths (/app/...)
+- Verify file exists before reading
+- Handle edge cases in parsing
+- Match exact output format required`,
+    },
+    tools: {
+        tokens: 100,
+        keywords: ['hashcat', 'john', 'strings', 'objdump', 'readelf', 'command', 'cli'],
+        content: `### Tools
+- hashcat: GPU password cracking, -m flag for hash type
+- john: CPU password cracking, flexible format support
+- readelf/objdump: Binary analysis
+- strings: Extract printable strings from binaries`,
+    },
+    legacy: {
+        tokens: 90,
+        keywords: ['cobol', 'fortran', 'legacy', 'modernize', 'mainframe'],
+        content: `### Legacy Code
+- COBOL: Fixed-format columns, WORKING-STORAGE for variables
+- Modernization: Preserve business logic, update data structures
+- Test with original inputs to verify behavior`,
+    },
+    debugging: {
+        tokens: 70,
+        keywords: ['debug', 'error', 'fix', 'traceback', 'exception', 'crash'],
+        content: `### Debugging
+- Check logs first: journalctl, /var/log/
+- Use verbose flags: -v, --debug
+- Isolate the problem: binary search through changes`,
+    },
+};
+// Estimated overhead per token (ms) - accounts for context processing
+const MS_PER_TOKEN = 4;
+// Historical benefit threshold - below this, skip UAM
+const BENEFIT_THRESHOLD = 0.1;
+// In-memory historical data store (in production, use SQLite)
+const historicalDataStore = new Map();
+/**
+ * Classify task type from instruction text
+ */
+export function classifyTask(instruction) {
+    const lower = instruction.toLowerCase();
+    // Check skip keywords first (pure reasoning tasks)
+    for (const kw of SKIP_UAM_KEYWORDS) {
+        if (lower.includes(kw)) {
+            if (lower.includes('schedule') || lower.includes('calendar') || lower.includes('meeting')) {
+                return 'scheduling';
+            }
+            if (lower.includes('chess') || lower.includes('game') || lower.includes('move')) {
+                return 'games';
+            }
+            if (lower.includes('constraint') || lower.includes('satisfy')) {
+                return 'constraint-satisfaction';
+            }
+            if (lower.includes('prove') || lower.includes('proof') || lower.includes('logic')) {
+                return 'pure-logic';
+            }
+            if (lower.includes('sudoku') || lower.includes('puzzle')) {
+                return 'reasoning';
+            }
+        }
+    }
+    // Check high-benefit keywords
+    for (const kw of HIGH_BENEFIT_KEYWORDS) {
+        if (lower.includes(kw)) {
+            if (lower.includes('password') || lower.includes('hash') || lower.includes('crack')) {
+                return 'security';
+            }
+            if (lower.includes('xss') || lower.includes('injection') || lower.includes('sanitize')) {
+                return 'security';
+            }
+            if (lower.includes('elf') || lower.includes('sqlite') || lower.includes('binary')) {
+                return 'file-ops';
+            }
+            if (lower.includes('cobol') || lower.includes('legacy') || lower.includes('modernize')) {
+                return 'legacy';
+            }
+        }
+    }
+    // Fall back to task-classifier for detailed classification
+    const classification = classifyTaskType(instruction);
+    return classification.category;
+}
+/**
+ * Assess time pressure based on timeout and task complexity
+ */
+export function assessTimePressure(timeoutSec, taskType, difficulty = 'medium') {
+    // Expected duration multipliers by difficulty
+    const difficultyMultiplier = {
+        easy: 0.5,
+        medium: 1.0,
+        hard: 2.0,
+    };
+    // Base expected duration by task type (seconds)
+    const baseDuration = {
+        security: 120,
+        'file-ops': 90,
+        legacy: 150,
+        coding: 60,
+        debugging: 90,
+        scheduling: 45,
+        games: 30,
+        'constraint-satisfaction': 60,
+        'pure-logic': 90,
+        reasoning: 60,
+        general: 60,
+        sysadmin: 120,
+        'ml-training': 180,
+        testing: 60,
+        unknown: 60,
+    };
+    const expectedDuration = (baseDuration[taskType] || 60) * (difficultyMultiplier[difficulty] || 1.0);
+    const ratio = timeoutSec / expectedDuration;
+    if (ratio < 1.2)
+        return 'critical';
+    if (ratio < 1.5)
+        return 'high';
+    if (ratio < 2.0)
+        return 'medium';
+    return 'low';
+}
+/**
+ * Get historical benefit ratio for a task type
+ */
+export function getHistoricalBenefit(taskType) {
+    const data = historicalDataStore.get(taskType);
+    if (!data || data.totalAttempts < 3) {
+        // Not enough data - use defaults based on category
+        if (LOW_BENEFIT_CATEGORIES.has(taskType)) {
+            return 0.05; // Very low default for reasoning tasks
+        }
+        return 0.5; // Neutral default
+    }
+    // Calculate benefit as improvement ratio
+    const uamRate = data.uamSuccesses / Math.max(data.totalAttempts / 2, 1);
+    const noUamRate = data.noUamSuccesses / Math.max(data.totalAttempts / 2, 1);
+    if (noUamRate === 0)
+        return uamRate > 0 ? 1.0 : 0.5;
+    return (uamRate - noUamRate) / Math.max(uamRate, noUamRate, 0.1);
+}
+/**
+ * Record task outcome for historical tracking
+ */
+export function recordOutcome(taskType, usedUam, success, durationMs) {
+    let data = historicalDataStore.get(taskType);
+    if (!data) {
+        data = {
+            taskType,
+            totalAttempts: 0,
+            uamSuccesses: 0,
+            noUamSuccesses: 0,
+            avgTimeWithUam: 0,
+            avgTimeWithoutUam: 0,
+        };
+        historicalDataStore.set(taskType, data);
+    }
+    data.totalAttempts++;
+    if (success) {
+        if (usedUam) {
+            data.uamSuccesses++;
+            data.avgTimeWithUam =
+                (data.avgTimeWithUam * (data.uamSuccesses - 1) + durationMs) / data.uamSuccesses;
+        }
+        else {
+            data.noUamSuccesses++;
+            data.avgTimeWithoutUam =
+                (data.avgTimeWithoutUam * (data.noUamSuccesses - 1) + durationMs) / data.noUamSuccesses;
+        }
+    }
+}
+/**
+ * Select relevant context sections based on task type and instruction
+ */
+export function selectRelevantSections(instruction, taskType) {
+    const lower = instruction.toLowerCase();
+    const sections = [];
+    for (const [name, config] of Object.entries(CONTEXT_SECTIONS)) {
+        if (config.keywords.some((kw) => lower.includes(kw))) {
+            sections.push(name);
+        }
+    }
+    // Add default sections for certain task types
+    if (taskType === 'security' && !sections.includes('security')) {
+        sections.push('security');
+    }
+    if (taskType === 'file-ops' && !sections.includes('file_formats')) {
+        sections.push('file_formats');
+    }
+    if (taskType === 'legacy' && !sections.includes('legacy')) {
+        sections.push('legacy');
+    }
+    return sections;
+}
+/**
+ * Calculate estimated overhead for given sections in milliseconds
+ */
+export function calculateOverhead(sections) {
+    let totalTokens = 0;
+    for (const section of sections) {
+        totalTokens += CONTEXT_SECTIONS[section]?.tokens || 0;
+    }
+    return totalTokens * MS_PER_TOKEN;
+}
+/**
+ * Main decision function: determine optimal context level using hybrid approach
+ *
+ * Decision Matrix:
+ * 1. Task type is pure reasoning → skip UAM
+ * 2. Historical benefit < threshold → skip UAM
+ * 3. Critical time pressure → skip UAM
+ * 4. High time pressure → minimal UAM (essential only)
+ * 5. Default → full UAM with relevant sections
+ */
+export function decideContextLevel(instruction, metadata = {}) {
+    const taskType = classifyTask(instruction);
+    const timeoutSec = metadata.timeout_sec || 300;
+    const difficulty = metadata.difficulty || 'medium';
+    // Factor 1: Task classification - skip for pure reasoning
+    if (LOW_BENEFIT_CATEGORIES.has(taskType)) {
+        return {
+            level: 'none',
+            sections: [],
+            reason: `Task type '${taskType}' is pure reasoning - UAM adds no benefit`,
+            estimatedOverheadMs: 0,
+            taskType,
+            timePressure: 'low',
+            historicalBenefit: 0,
+        };
+    }
+    // Factor 2: Time pressure assessment
+    const timePressure = assessTimePressure(timeoutSec, taskType, difficulty);
+    // Factor 3: Historical benefit
+    const historicalBenefit = metadata.historical_uam_benefit ?? getHistoricalBenefit(taskType);
+    // Factor 4: Check if historical data suggests skipping UAM
+    if (historicalBenefit < BENEFIT_THRESHOLD) {
+        return {
+            level: 'none',
+            sections: [],
+            reason: `Low historical benefit (${(historicalBenefit * 100).toFixed(1)}%) for ${taskType}`,
+            estimatedOverheadMs: 0,
+            taskType,
+            timePressure,
+            historicalBenefit,
+        };
+    }
+    // Factor 5: Critical time pressure - skip UAM
+    if (timePressure === 'critical') {
+        return {
+            level: 'none',
+            sections: [],
+            reason: 'Critical time pressure - skipping UAM to avoid timeout',
+            estimatedOverheadMs: 0,
+            taskType,
+            timePressure,
+            historicalBenefit,
+        };
+    }
+    // Factor 6: Select relevant sections
+    const relevantSections = selectRelevantSections(instruction, taskType);
+    const estimatedOverhead = calculateOverhead(relevantSections);
+    // Factor 7: Check if overhead fits within time budget
+    const overheadRatio = estimatedOverhead / (timeoutSec * 1000);
+    if (timePressure === 'high' || overheadRatio > 0.1) {
+        // Use minimal context - only most relevant section
+        const minimalSections = relevantSections.slice(0, 1);
+        return {
+            level: 'minimal',
+            sections: minimalSections,
+            reason: `High time pressure - using minimal context (${minimalSections.join(', ') || 'best_practices'})`,
+            estimatedOverheadMs: calculateOverhead(minimalSections),
+            taskType,
+            timePressure,
+            historicalBenefit,
+        };
+    }
+    // Default: Full context for everything else
+    return {
+        level: 'full',
+        sections: relevantSections.length > 0 ? relevantSections : ['coding'],
+        reason: `Full context for ${taskType} task (${timePressure} pressure)`,
+        estimatedOverheadMs: estimatedOverhead,
+        taskType,
+        timePressure,
+        historicalBenefit,
+    };
+}
+/**
+ * Generate context string based on decision
+ */
+export function generateContext(decision) {
+    if (decision.level === 'none' || decision.sections.length === 0) {
+        return '';
+    }
+    const contextParts = ['## UAM Memory Context\n'];
+    for (const section of decision.sections) {
+        const sectionConfig = CONTEXT_SECTIONS[section];
+        if (sectionConfig) {
+            contextParts.push(sectionConfig.content);
+        }
+    }
+    return contextParts.join('\n');
+}
+/**
+ * Progressive context strategy for retry scenarios
+ *
+ * Returns context levels to try in order based on initial failure analysis.
+ */
+export function getProgressiveContextLevels(instruction, initialError, metadata = {}) {
+    const decision = decideContextLevel(instruction, metadata);
+    // If we already decided 'none' for a good reason, don't retry with more
+    if (decision.level === 'none' && LOW_BENEFIT_CATEGORIES.has(decision.taskType)) {
+        return ['none']; // Don't escalate for pure reasoning tasks
+    }
+    // Analyze error to see if context might help
+    const errorLower = initialError.toLowerCase();
+    const contextMightHelp = errorLower.includes('unknown') ||
+        errorLower.includes('how to') ||
+        errorLower.includes('what is') ||
+        errorLower.includes('command not found') ||
+        errorLower.includes('invalid syntax') ||
+        errorLower.includes('format') ||
+        errorLower.includes('parse');
+    if (!contextMightHelp) {
+        return [decision.level]; // Don't escalate if error is unrelated to knowledge
+    }
+    // Progressive escalation based on starting point
+    switch (decision.level) {
+        case 'none':
+            return ['none', 'minimal', 'full'];
+        case 'minimal':
+            return ['minimal', 'full'];
+        case 'full':
+            return ['full']; // Already at max
+        default:
+            return ['none', 'minimal', 'full'];
+    }
+}
+/**
+ * Export configuration for Python agent integration
+ */
+export function exportConfigForPython(instruction, metadata = {}) {
+    const decision = decideContextLevel(instruction, metadata);
+    const context = generateContext(decision);
+    return JSON.stringify({
+        level: decision.level,
+        sections: decision.sections,
+        reason: decision.reason,
+        estimatedOverheadMs: decision.estimatedOverheadMs,
+        taskType: decision.taskType,
+        timePressure: decision.timePressure,
+        historicalBenefit: decision.historicalBenefit,
+        context,
+    }, null, 2);
+}
+// Export main interface
+export const HybridAdaptiveContext = {
+    classifyTask,
+    assessTimePressure,
+    getHistoricalBenefit,
+    recordOutcome,
+    decideContextLevel,
+    generateContext,
+    selectRelevantSections,
+    calculateOverhead,
+    getProgressiveContextLevels,
+    exportConfigForPython,
+};
+export default HybridAdaptiveContext;
+//# sourceMappingURL=adaptive-context.js.map

package/dist/memory/adaptive-context.js.map

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

package/dist/utils/calculate-average.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Calculates the arithmetic mean of an array of numbers.
+ *
+ * @param numbers - An array of numbers to calculate the average of
+ * @returns The arithmetic mean of the numbers, or 0 if the array is empty
+ *
+ * @example
+ * ```typescript
+ * calculateAverage([1, 2, 3, 4, 5]); // Returns: 3
+ * calculateAverage([10, 20]); // Returns: 15
+ * calculateAverage([]); // Returns: 0
+ * ```
+ */
+export declare function calculateAverage(numbers: number[]): number;
+//# sourceMappingURL=calculate-average.d.ts.map

package/dist/utils/calculate-average.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-average.d.ts","sourceRoot":"","sources":["../../src/utils/calculate-average.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAO1D"}

package/dist/utils/calculate-average.js

@@ -0,0 +1,21 @@
+/**
+ * Calculates the arithmetic mean of an array of numbers.
+ *
+ * @param numbers - An array of numbers to calculate the average of
+ * @returns The arithmetic mean of the numbers, or 0 if the array is empty
+ *
+ * @example
+ * ```typescript
+ * calculateAverage([1, 2, 3, 4, 5]); // Returns: 3
+ * calculateAverage([10, 20]); // Returns: 15
+ * calculateAverage([]); // Returns: 0
+ * ```
+ */
+export function calculateAverage(numbers) {
+    if (numbers.length === 0) {
+        return 0;
+    }
+    const sum = numbers.reduce((acc, num) => acc + num, 0);
+    return sum / numbers.length;
+}
+//# sourceMappingURL=calculate-average.js.map

package/dist/utils/calculate-average.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-average.js","sourceRoot":"","sources":["../../src/utils/calculate-average.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB;IAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;AAC9B,CAAC"}

package/dist/utils/config-manager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Singleton configuration manager backed by an in-memory Map.
+ */
+export declare class ConfigManager {
+    private static instance;
+    private config;
+    /**
+     * Creates a new ConfigManager instance.
+     */
+    private constructor();
+    /**
+     * Returns the singleton instance of the ConfigManager.
+     * @returns The singleton ConfigManager instance.
+     */
+    static getInstance(): ConfigManager;
+    /**
+     * Gets a configuration value by key.
+     * @param key - Configuration key to retrieve.
+     * @returns The stored configuration value, or undefined if missing.
+     */
+    get(key: string): any;
+    /**
+     * Sets a configuration value by key.
+     * @param key - Configuration key to set.
+     * @param value - Configuration value to store.
+     * @returns No return value.
+     */
+    set(key: string, value: any): void;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/utils/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAmB;IAEjC;;OAEG;IACH,OAAO;IAIP;;;OAGG;WACW,WAAW,IAAI,aAAa;IAO1C;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAI5B;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;CAG1C"}

package/dist/utils/config-manager.js

@@ -0,0 +1,41 @@
+/**
+ * Singleton configuration manager backed by an in-memory Map.
+ */
+export class ConfigManager {
+    static instance;
+    config;
+    /**
+     * Creates a new ConfigManager instance.
+     */
+    constructor() {
+        this.config = new Map();
+    }
+    /**
+     * Returns the singleton instance of the ConfigManager.
+     * @returns The singleton ConfigManager instance.
+     */
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    /**
+     * Gets a configuration value by key.
+     * @param key - Configuration key to retrieve.
+     * @returns The stored configuration value, or undefined if missing.
+     */
+    get(key) {
+        return this.config.get(key);
+    }
+    /**
+     * Sets a configuration value by key.
+     * @param key - Configuration key to set.
+     * @param value - Configuration value to store.
+     * @returns No return value.
+     */
+    set(key, value) {
+        this.config.set(key, value);
+    }
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/utils/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,CAAgB;IAC/B,MAAM,CAAmB;IAEjC;;OAEG;IACH;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,GAAW,EAAE,KAAU;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/utils/fetch-with-retry.d.ts

@@ -0,0 +1,5 @@
+export declare function fetchWithRetry(url: string, retryConfig?: {
+    maxRetries: number;
+    backoffMs: number;
+}): Promise<Response>;
+//# sourceMappingURL=fetch-with-retry.d.ts.map

package/dist/utils/fetch-with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/utils/fetch-with-retry.ts"],"names":[],"mappings":"AAAA,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,QAAQ,CAAC,CA0FnB"}

package/dist/utils/fetch-with-retry.js

@@ -0,0 +1,61 @@
+export async function fetchWithRetry(url, retryConfig) {
+    const config = {
+        maxRetries: retryConfig?.maxRetries ?? 3,
+        backoffMs: retryConfig?.backoffMs ?? 1000,
+    };
+    let lastError = null;
+    let lastStatusCode;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            if (attempt > 0) {
+                const delay = config.backoffMs * Math.pow(2, attempt - 1);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+            const response = await fetch(url);
+            if (!response.ok) {
+                lastStatusCode = response.status;
+                const isRetryable = response.status >= 500 ||
+                    response.status === 408 ||
+                    response.status === 429;
+                if (isRetryable && attempt < config.maxRetries) {
+                    lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+                    continue;
+                }
+                const httpError = new Error(`HTTP error ${response.status}: ${response.statusText}`);
+                httpError.name = 'FetchRetryError';
+                httpError.url = url;
+                httpError.attempts = attempt + 1;
+                httpError.statusCode = response.status;
+                httpError.lastError = null;
+                throw httpError;
+            }
+            return response;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'FetchRetryError') {
+                throw error;
+            }
+            if (error instanceof Error) {
+                lastError = error;
+                if (attempt < config.maxRetries) {
+                    continue;
+                }
+            }
+            const finalError = new Error(`Fetch failed after ${attempt + 1} attempts: ${error instanceof Error ? error.message : String(error)}`);
+            finalError.name = 'FetchRetryError';
+            finalError.url = url;
+            finalError.attempts = attempt + 1;
+            finalError.statusCode = lastStatusCode;
+            finalError.lastError = lastError;
+            throw finalError;
+        }
+    }
+    const exhaustedError = new Error(`All ${config.maxRetries + 1} attempts failed for ${url}`);
+    exhaustedError.name = 'FetchRetryError';
+    exhaustedError.url = url;
+    exhaustedError.attempts = config.maxRetries + 1;
+    exhaustedError.statusCode = lastStatusCode;
+    exhaustedError.lastError = lastError;
+    throw exhaustedError;
+}
+//# sourceMappingURL=fetch-with-retry.js.map