@xfabric/memory 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,350 @@
+/**
+ * Core type definitions for @vibestudio/memory
+ */
+export type EmbeddingProviderType = "openai" | "gemini" | "local" | "auto";
+export type MemoryConfig = {
+    /** Unique identifier for the agent using this memory */
+    agentId: string;
+    /** Root directory of the workspace to index */
+    workspaceDir: string;
+    /** Embedding provider configuration */
+    provider?: EmbeddingProviderType;
+    /** Remote API configuration (OpenAI/Gemini) */
+    remote?: {
+        apiKey?: string;
+        baseUrl?: string;
+        model?: string;
+    };
+    /** Local embedding configuration */
+    local?: {
+        modelPath?: string;
+    };
+    /** Storage configuration */
+    store?: {
+        path?: string;
+    };
+    /** Chunking configuration */
+    chunking?: {
+        tokens?: number;
+        overlap?: number;
+    };
+    /** Query configuration */
+    query?: {
+        maxResults?: number;
+        minScore?: number;
+        hybrid?: {
+            vectorWeight?: number;
+            textWeight?: number;
+        };
+    };
+    /** Sync configuration */
+    sync?: {
+        watchDebounceMs?: number;
+        enabled?: boolean;
+    };
+};
+export declare const DEFAULT_CONFIG: {
+    readonly provider: EmbeddingProviderType;
+    readonly model: "text-embedding-3-small";
+    readonly chunking: {
+        readonly tokens: 400;
+        readonly overlap: 80;
+    };
+    readonly query: {
+        readonly maxResults: 10;
+        readonly minScore: 0.35;
+        readonly hybrid: {
+            readonly vectorWeight: 0.7;
+            readonly textWeight: 0.3;
+        };
+    };
+    readonly sync: {
+        readonly watchDebounceMs: 1500;
+    };
+};
+export type MemorySource = "memory" | "sessions";
+export type MemoryFileEntry = {
+    /** Relative path from workspace root */
+    path: string;
+    /** Absolute path on filesystem */
+    absPath: string;
+    /** Last modification time in milliseconds */
+    mtimeMs: number;
+    /** File size in bytes */
+    size: number;
+    /** SHA-256 hash of file contents */
+    hash: string;
+};
+export type MemoryChunk = {
+    /** Starting line number (1-indexed) */
+    startLine: number;
+    /** Ending line number (1-indexed, inclusive) */
+    endLine: number;
+    /** Chunk text content */
+    text: string;
+    /** SHA-256 hash of chunk text */
+    hash: string;
+};
+export type StoredChunk = MemoryChunk & {
+    /** Unique chunk ID (path:startLine) */
+    id: string;
+    /** File path */
+    path: string;
+    /** Source type */
+    source: MemorySource;
+    /** Model used for embedding */
+    model: string;
+    /** Embedding vector */
+    embedding: number[];
+    /** Last update timestamp */
+    updatedAt: number;
+};
+export type MemorySearchResult = {
+    /** File path relative to workspace */
+    path: string;
+    /** Starting line number of the matched chunk */
+    startLine: number;
+    /** Ending line number of the matched chunk */
+    endLine: number;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Text snippet from the matched chunk */
+    snippet: string;
+    /** Source of the memory (file or session) */
+    source: MemorySource;
+};
+export type VectorSearchResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: MemorySource;
+    snippet: string;
+    vectorScore: number;
+};
+export type KeywordSearchResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: MemorySource;
+    snippet: string;
+    textScore: number;
+};
+export type HybridSearchOptions = {
+    vectorWeight?: number;
+    textWeight?: number;
+};
+export type SearchOptions = {
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Minimum relevance score threshold (0-1) */
+    minScore?: number;
+    /** Session key for session-aware search */
+    sessionKey?: string;
+};
+export type MemorySearchParams = {
+    query: string;
+    maxResults?: number;
+    minScore?: number;
+};
+export type MemoryGetParams = {
+    path: string;
+    from?: number;
+    lines?: number;
+};
+export type MemorySearchResponse = {
+    success: boolean;
+    results?: MemorySearchResult[];
+    error?: string;
+    meta?: {
+        provider: string;
+        model: string;
+        fallbackFrom?: string;
+        fallbackReason?: string;
+    };
+};
+export type MemoryGetResponse = {
+    success: boolean;
+    content?: string;
+    path?: string;
+    startLine?: number;
+    endLine?: number;
+    error?: string;
+};
+export type MemoryIndexMeta = {
+    model: string;
+    provider: string;
+    providerKey?: string;
+    chunkTokens: number;
+    chunkOverlap: number;
+    vectorDims?: number;
+};
+export type FileChangeEvent = {
+    type: "add" | "change" | "unlink";
+    path: string;
+};
+export type SessionEvent = {
+    type: "message";
+    sessionId: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+};
+export type SyncProgress = {
+    /** Current phase of sync */
+    phase: "scanning" | "chunking" | "embedding" | "storing" | "complete";
+    /** Source being synced */
+    source: MemorySource;
+    /** Total files to process */
+    totalFiles: number;
+    /** Files processed so far */
+    processedFiles: number;
+    /** Total chunks created */
+    totalChunks: number;
+    /** Chunks embedded so far */
+    embeddedChunks: number;
+    /** Any errors encountered */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+};
+export type MemoryStatus = {
+    /** Database status */
+    database: {
+        path: string;
+        sizeBytes: number;
+        schemaVersion: number;
+    };
+    /** File/chunk counts by source */
+    sources: {
+        memory: {
+            files: number;
+            chunks: number;
+        };
+        sessions: {
+            files: number;
+            chunks: number;
+        };
+    };
+    /** FTS5 availability */
+    fts: {
+        available: boolean;
+        error?: string;
+    };
+    /** Vector search status */
+    vector: {
+        /** sqlite-vec available for ANN search */
+        sqliteVecAvailable: boolean;
+        /** Using JS fallback for cosine similarity */
+        usingJsFallback: boolean;
+        error?: string;
+    };
+    /** Embedding provider status */
+    provider: {
+        id: string;
+        model: string;
+        dimensions: number;
+        /** Whether fallback was activated */
+        fallbackActivated: boolean;
+        fallbackFrom?: string;
+        fallbackReason?: string;
+        /** Failure count for active fallback switching */
+        consecutiveFailures: number;
+    };
+    /** Batch processing status */
+    batch: {
+        /** Whether batch API is enabled */
+        enabled: boolean;
+        /** Pending batch jobs */
+        pendingJobs: number;
+        /** Whether batch was auto-disabled due to failures */
+        autoDisabled: boolean;
+        disableReason?: string;
+    };
+    /** Sync status */
+    sync: {
+        watching: boolean;
+        intervalMs?: number;
+        lastSyncAt?: number;
+        memoryDirty: boolean;
+        sessionsDirty: boolean;
+    };
+};
+export type ProbeResult = {
+    available: boolean;
+    error?: string;
+    latencyMs?: number;
+};
+export type SessionChunk = {
+    /** Session ID this chunk belongs to */
+    sessionId: string;
+    /** Role of the message (user or assistant) */
+    role: "user" | "assistant";
+    /** Starting byte offset in the JSONL file */
+    byteOffset: number;
+    /** Chunk index within the session */
+    chunkIndex: number;
+    /** Starting line number (1-indexed) */
+    startLine: number;
+    /** Ending line number (1-indexed, inclusive) */
+    endLine: number;
+    /** Chunk text content */
+    text: string;
+    /** SHA-256 hash of chunk text */
+    hash: string;
+};
+export type SessionFileState = {
+    /** Session ID */
+    sessionId: string;
+    /** Path to JSONL file */
+    path: string;
+    /** Last processed byte offset for delta tracking */
+    lastByteOffset: number;
+    /** Last modification time */
+    mtimeMs: number;
+    /** File size in bytes */
+    size: number;
+    /** SHA-256 hash of entire file */
+    hash: string;
+};
+export type BatchConfig = {
+    /** Enable batch API for bulk embedding */
+    enabled: boolean;
+    /** Max texts per batch request */
+    maxBatchSize: number;
+    /** Max concurrent batch requests */
+    concurrency: number;
+    /** Timeout for batch operations (ms) */
+    timeoutMs: number;
+    /** Auto-disable after consecutive failures */
+    maxConsecutiveFailures: number;
+};
+export type BatchJob = {
+    id: string;
+    status: "pending" | "processing" | "completed" | "failed";
+    texts: string[];
+    embeddings?: number[][];
+    error?: string;
+    createdAt: number;
+    completedAt?: number;
+};
+export type ExtendedMemoryConfig = MemoryConfig & {
+    /** Progress callback for sync operations */
+    onProgress?: (progress: SyncProgress) => void;
+    /** Extra paths to index outside workspace (e.g., global memory dirs) */
+    extraPaths?: string[];
+    /** Session directory for transcript indexing */
+    sessionsDir?: string;
+    /** Extended sync configuration */
+    sync?: MemoryConfig["sync"] & {
+        /** Interval-based sync period (ms), 0 to disable */
+        intervalMs?: number;
+        /** Sync sessions automatically */
+        syncSessions?: boolean;
+    };
+    /** Batch API configuration */
+    batch?: Partial<BatchConfig>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * Core type definitions for @vibestudio/memory
+ */
+export const DEFAULT_CONFIG = {
+    provider: "openai",
+    model: "text-embedding-3-small",
+    chunking: { tokens: 400, overlap: 80 },
+    query: {
+        maxResults: 10,
+        minScore: 0.35,
+        hybrid: { vectorWeight: 0.7, textWeight: 0.3 },
+    },
+    sync: { watchDebounceMs: 1500 },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkDH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,QAAiC;IAC3C,KAAK,EAAE,wBAAwB;IAC/B,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;IACtC,KAAK,EAAE;QACL,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;KAC/C;IACD,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;CACvB,CAAC"}

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Async semaphore for limiting concurrent operations
+ */
+export declare class Semaphore {
+    private permits;
+    private waitQueue;
+    constructor(maxPermits: number);
+    /**
+     * Number of available permits
+     */
+    get available(): number;
+    /**
+     * Acquire a permit, waiting if necessary
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release a permit
+     */
+    release(): void;
+    /**
+     * Run an async function with automatic acquire/release
+     */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=concurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAyB;gBAE9B,UAAU,EAAE,MAAM;IAO9B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ/C"}

package/dist/utils/concurrency.js

@@ -0,0 +1,59 @@
+/**
+ * Async semaphore for limiting concurrent operations
+ */
+export class Semaphore {
+    permits;
+    waitQueue = [];
+    constructor(maxPermits) {
+        if (maxPermits < 1) {
+            throw new Error("Semaphore requires at least 1 permit");
+        }
+        this.permits = maxPermits;
+    }
+    /**
+     * Number of available permits
+     */
+    get available() {
+        return this.permits;
+    }
+    /**
+     * Acquire a permit, waiting if necessary
+     */
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        // Wait for a permit to become available
+        return new Promise((resolve) => {
+            this.waitQueue.push(resolve);
+        });
+    }
+    /**
+     * Release a permit
+     */
+    release() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            // Give permit to waiting task
+            next();
+        }
+        else {
+            // Return permit to pool
+            this.permits++;
+        }
+    }
+    /**
+     * Run an async function with automatic acquire/release
+     */
+    async run(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,OAAO,CAAS;IAChB,SAAS,GAAsB,EAAE,CAAC;IAE1C,YAAY,UAAkB;QAC5B,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACT,8BAA8B;YAC9B,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,EAAoB;QAC/B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compute SHA-256 hash of a string
+ */
+export declare function hashText(value: string): string;
+/**
+ * Compute SHA-256 hash of a file's contents
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE"}

package/dist/utils/hash.js

@@ -0,0 +1,16 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+/**
+ * Compute SHA-256 hash of a string
+ */
+export function hashText(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+/**
+ * Compute SHA-256 hash of a file's contents
+ */
+export async function hashFile(filePath) {
+    const content = await readFile(filePath, "utf-8");
+    return hashText(content);
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { hashText, hashFile } from "./hash.js";
+export { retry, RetryError, type RetryOptions } from "./retry.js";
+export { Semaphore } from "./concurrency.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { hashText, hashFile } from "./hash.js";
+export { retry, RetryError } from "./retry.js";
+export { Semaphore } from "./concurrency.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,22 @@
+export type RetryOptions = {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Base delay in ms before retry (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelayMs?: number;
+    /** Callback on each retry */
+    onRetry?: (error: Error, attempt: number) => void;
+    /** Return false to stop retrying (default: always retry) */
+    shouldRetry?: (error: Error) => boolean | Promise<boolean>;
+};
+export declare class RetryError extends Error {
+    readonly attempts: number;
+    readonly errors: Error[];
+    constructor(message: string, attempts: number, errors: Error[]);
+}
+/**
+ * Retry an async function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# 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,MAAM,MAAM,YAAY,GAAG;IACzB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D,CAAC;AAEF,qBAAa,UAAW,SAAQ,KAAK;aAGjB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,KAAK,EAAE;gBAF/B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,EAAE;CAKlC;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA8CZ"}

package/dist/utils/retry.js

@@ -0,0 +1,48 @@
+export class RetryError extends Error {
+    attempts;
+    errors;
+    constructor(message, attempts, errors) {
+        super(message);
+        this.attempts = attempts;
+        this.errors = errors;
+        this.name = "RetryError";
+    }
+}
+/**
+ * Retry an async function with exponential backoff
+ */
+export async function retry(fn, options = {}) {
+    const { maxAttempts = 3, baseDelayMs = 1000, maxDelayMs = 30000, onRetry, shouldRetry, } = options;
+    const errors = [];
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            errors.push(error);
+            // Check if we should retry
+            if (shouldRetry) {
+                const canRetry = await shouldRetry(error);
+                if (!canRetry) {
+                    throw error;
+                }
+            }
+            // If this was the last attempt, throw
+            if (attempt >= maxAttempts) {
+                throw new RetryError(`Failed after ${maxAttempts} attempts: ${error.message}`, maxAttempts, errors);
+            }
+            // Call onRetry callback
+            onRetry?.(error, attempt);
+            // Calculate delay with exponential backoff
+            const delay = Math.min(baseDelayMs * Math.pow(2, attempt - 1), maxDelayMs);
+            await sleep(delay);
+        }
+    }
+    // This should never be reached
+    throw new RetryError("Unexpected retry exit", maxAttempts, errors);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# 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":"AAaA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,QAAgB,EAChB,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,WAAW,GAAG,IAAI,EAClB,UAAU,GAAG,KAAK,EAClB,OAAO,EACP,WAAW,GACZ,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEnB,2BAA2B;YAC3B,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,MAAM,IAAI,UAAU,CAClB,gBAAgB,WAAW,cAAc,KAAK,CAAC,OAAO,EAAE,EACxD,WAAW,EACX,MAAM,CACP,CAAC;YACJ,CAAC;YAED,wBAAwB;YACxB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE1B,2CAA2C;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAC3E,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,IAAI,UAAU,CAAC,uBAAuB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;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"}