@falai/agent 2.7.0 → 3.1.0

package/dist/utils/retry.js

@@ -1,327 +0,0 @@
-/**
- * Retry utility with exponential backoff
- */
-import { logger } from './logger';
-import { getErrorMessage } from '../providers/errorClassification';
-const DEFAULT_RETRY_CONFIG = {
-    timeout: 60000,
-    retries: 3,
-};
-/**
- * Normalize a provider's optional retry config against the defaults. `timeout`
- * uses `||` (a 0ms timeout is degenerate — it aborts every call immediately — so
- * fall back to the default), while `retries` uses `??` so an explicit
- * `retries: 0` (disable retries) is honored rather than treated as unset. Single
- * definition so this distinction can't drift between providers.
- */
-export function resolveRetryConfig(input) {
-    return {
-        timeout: input?.timeout || DEFAULT_RETRY_CONFIG.timeout,
-        retries: input?.retries ?? DEFAULT_RETRY_CONFIG.retries,
-    };
-}
-export async function retry(options) {
-    const { operation, maxRetries, delay, onRetry, onFailure, isRetriable } = options;
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        try {
-            return await operation();
-        }
-        catch (error) {
-            lastError = error;
-            // Unretriable errors (auth, invalid request, caller aborts) fail fast —
-            // retrying a deterministic failure only adds latency to the same outcome.
-            if (isRetriable && !isRetriable(error)) {
-                throw error;
-            }
-            if (attempt === maxRetries) {
-                const shouldRethrow = onFailure ? onFailure(lastError) : true;
-                if (shouldRethrow) {
-                    throw lastError;
-                }
-                break;
-            }
-            if (onRetry) {
-                onRetry(attempt, lastError);
-            }
-            const delayMs = delay(attempt);
-            await new Promise((resolve) => setTimeout(resolve, delayMs));
-        }
-    }
-    // eslint-disable-next-line @typescript-eslint/only-throw-error
-    throw lastError ?? new Error("Operation failed");
-}
-/** Capped exponential backoff (1s, 2s, 4s, … max 5s) shared by the retry helpers. */
-const defaultBackoff = (attempt) => Math.min(1000 * Math.pow(2, attempt), 5000);
-/**
- * Combine abort signals into one that aborts as soon as any input aborts.
- * `undefined` inputs are skipped, so a caller can pass an optional caller-signal
- * alongside a required per-attempt one. Returns the sole signal when only one is
- * present (no wrapper), or `undefined` when none are.
- *
- * Prefers the platform `AbortSignal.any`, which cleans up its listeners via weak
- * refs — so merging onto a long-lived caller signal that's reused across many
- * calls can't accumulate listeners. Falls back to a manual controller on older
- * runtimes (< Node 20.3); there the listeners live until a source aborts or is
- * garbage-collected, which is fine for the usual per-request signal.
- */
-export function combineAbortSignals(...signals) {
-    const present = signals.filter((s) => s != null);
-    if (present.length <= 1)
-        return present[0];
-    if (typeof AbortSignal.any === "function")
-        return AbortSignal.any(present);
-    const controller = new AbortController();
-    for (const signal of present) {
-        if (signal.aborted) {
-            controller.abort(signal.reason);
-            break;
-        }
-        signal.addEventListener("abort", () => controller.abort(signal.reason), {
-            once: true,
-        });
-    }
-    return controller.signal;
-}
-export const withTimeoutAndRetry = async (operation, timeoutMs = 60000, maxRetries = 3, operationName = "AI operation", isRetriable) => {
-    const createTimeoutOperation = () => async () => {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => {
-            controller.abort();
-        }, timeoutMs);
-        try {
-            // Hand the operation the timeout signal so the in-flight upstream call is
-            // actually cancelled when the deadline fires — otherwise the abandoned
-            // attempt keeps running while the retry stacks a second concurrent call.
-            const result = await Promise.race([
-                operation(controller.signal),
-                new Promise((_, reject) => {
-                    controller.signal.addEventListener("abort", () => {
-                        reject(new Error(`Operation timed out after ${timeoutMs}ms`));
-                    });
-                }),
-            ]);
-            clearTimeout(timeoutId);
-            return result;
-        }
-        catch (error) {
-            clearTimeout(timeoutId);
-            throw error;
-        }
-    };
-    return retry({
-        operation: createTimeoutOperation(),
-        maxRetries,
-        delay: defaultBackoff,
-        isRetriable,
-        onRetry: (attempt, error) => {
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delay = defaultBackoff(attempt);
-            logger.debug(`[${operationName}] Retrying in ${delay}ms...`);
-            logger.debug(`[${operationName}] Attempt ${attempt + 2}/${maxRetries + 1}`);
-        },
-        onFailure: (_error) => {
-            logger.error(`[${operationName}] All ${maxRetries + 1} attempts failed`);
-            return true;
-        },
-    });
-};
-/** Reject if `next` hasn't settled within `timeoutMs`; always clears its timer. */
-function raceFirstChunk(next, timeoutMs, operationName) {
-    let timer;
-    const timeout = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(new Error(`[${operationName}] Stream timed out: no first chunk within ${timeoutMs}ms`)), timeoutMs);
-    });
-    return Promise.race([next, timeout]).finally(() => clearTimeout(timer));
-}
-/**
- * Streaming analog of {@link withTimeoutAndRetry}. Re-runs an async-generator
- * factory as long as it fails *before yielding its first chunk* — an empty
- * completion that throws "No response", an error while establishing the stream,
- * or (with `firstChunkTimeoutMs`) a stall before the first token. Once any chunk
- * has been yielded the stream is committed and further errors propagate, so a
- * retry can never double-emit deltas the consumer has already received.
- *
- * This mirrors the non-streaming path, where the provider throws on an empty
- * completion inside `withTimeoutAndRetry` and is retried on the same model
- * before the caller falls through to backup models.
- */
-export async function* withStreamRetry(factory, options = {}) {
-    const { maxRetries = 3, delay = defaultBackoff, operationName = "AI stream", firstChunkTimeoutMs, isRetriable, } = options;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        // One controller per attempt: aborting it on abandon cancels the upstream
-        // SDK call so a retry can't stack a second concurrent stream.
-        const controller = new AbortController();
-        const iterator = factory(controller.signal);
-        let yielded = false;
-        let completed = false;
-        try {
-            // Drive the iterator by hand so the first chunk can be raced against a
-            // deadline; for-await would give no hook for that.
-            for (;;) {
-                const result = !yielded && firstChunkTimeoutMs
-                    ? await raceFirstChunk(iterator.next(), firstChunkTimeoutMs, operationName)
-                    : await iterator.next();
-                if (result.done) {
-                    completed = true;
-                    return;
-                }
-                yielded = true;
-                yield result.value;
-            }
-        }
-        catch (error) {
-            // Unretriable errors (auth, invalid request, caller aborts) propagate
-            // immediately — no backoff for a deterministic failure.
-            if (isRetriable && !isRetriable(error)) {
-                throw error;
-            }
-            // Can't retry once deltas are out, and don't retry past the budget.
-            if (yielded || attempt === maxRetries) {
-                throw error;
-            }
-            const message = error instanceof Error ? error.message : String(error);
-            logger.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delayMs = delay(attempt);
-            logger.debug(`[${operationName}] Retrying in ${delayMs}ms... (attempt ${attempt + 2}/${maxRetries + 1})`);
-            await new Promise((resolve) => setTimeout(resolve, delayMs));
-        }
-        finally {
-            // Abandoning an attempt (first-chunk timeout, pre-yield error before a
-            // retry, or a consumer that breaks early): abort the upstream SDK call
-            // first so it's actually torn down — not left running while we retry —
-            // then dispose the iterator. Aborting also unblocks a stalled
-            // iterator.next() so return() can run the generator's cleanup. Both are
-            // fire-and-forget: a wedged generator's return() may never settle, so we
-            // must not await it.
-            if (!completed) {
-                controller.abort();
-                void iterator.return?.(undefined)?.catch(() => undefined);
-            }
-        }
-    }
-}
-/**
- * Try `models[0]` (the primary); on failure, if `shouldTryBackup` allows,
- * walk the remaining backup models in order. Resolves with the first
- * successful result; otherwise rethrows the last error seen. Errors are
- * rethrown untouched — wrap them at the call site.
- *
- * Streaming twin: {@link streamWithBackupFallback}.
- */
-export async function withBackupFallback(opts) {
-    const { models, attempt, shouldTryBackup, onModelFailed, onBackupStart, onBackupSucceeded, } = opts;
-    if (models.length === 0) {
-        throw new Error("withBackupFallback: `models` must include a primary model");
-    }
-    let lastError;
-    for (let i = 0; i < models.length; i++) {
-        const model = models[i];
-        if (i > 0)
-            onBackupStart?.(model, i, models.length - 1);
-        try {
-            const result = await attempt(model);
-            if (i > 0)
-                onBackupSucceeded?.(model);
-            return result;
-        }
-        catch (error) {
-            lastError = error;
-            onModelFailed?.(model, error, i + 1, models.length);
-            // A failure that doesn't qualify for backup ends the walk — the
-            // remaining models would hit the same deterministic error. Falling
-            // through to the throw covers both this early exit and exhaustion.
-            if (!shouldTryBackup(error))
-                break;
-        }
-    }
-    throw lastError;
-}
-/**
- * Streaming twin of {@link withBackupFallback}: same walk, consuming each
- * model's chunk stream lazily via `yield*` so chunks flow through unchanged.
- * A stream that errors before completion counts as that model's failure and
- * the walk proceeds exactly as in the non-streaming case.
- */
-export async function* streamWithBackupFallback(opts) {
-    const { models, attempt, shouldTryBackup, onModelFailed, onBackupStart, onBackupSucceeded, } = opts;
-    if (models.length === 0) {
-        throw new Error("streamWithBackupFallback: `models` must include a primary model");
-    }
-    let lastError;
-    for (let i = 0; i < models.length; i++) {
-        const model = models[i];
-        if (i > 0)
-            onBackupStart?.(model, i, models.length - 1);
-        try {
-            yield* attempt(model);
-            if (i > 0)
-                onBackupSucceeded?.(model);
-            return;
-        }
-        catch (error) {
-            lastError = error;
-            onModelFailed?.(model, error, i + 1, models.length);
-            if (!shouldTryBackup(error))
-                break;
-        }
-    }
-    throw lastError;
-}
-/**
- * Standard logging observer for the backup-fallback walkers. Holds the
- * per-walk state (primary error message, whether backups were tried) that the
- * terminal "All models failed" log needs, so each provider call site is just
- * `attempt` + `shouldTryBackup` + its own terminal error wrap.
- *
- * ```ts
- * const observer = backupFallbackLogging("[OPENAI]", shouldUseBackupModel);
- * try {
- *   return await withBackupFallback({ models, attempt, shouldTryBackup, ...observer.callbacks });
- * } catch (error) {
- *   observer.logExhausted(error);
- *   throw wrap(error);
- * }
- * ```
- */
-export function backupFallbackLogging(label, shouldTryBackup, options) {
-    let primaryErrMsg = "";
-    // Records that the primary failed but qualified for backups — the only path
-    // that reaches the "All models failed" terminal log; an ineligible primary
-    // rethrows directly.
-    let tryingBackups = false;
-    const streamSuffix = options?.streaming ? " for streaming" : "";
-    return {
-        callbacks: {
-            onModelFailed: (model, error, attemptNo, total) => {
-                const errMsg = getErrorMessage(error);
-                if (attemptNo === 1) {
-                    primaryErrMsg = errMsg;
-                    logger.warn(`${label} Primary model ${model} failed: ${errMsg}`);
-                    if (shouldTryBackup(error)) {
-                        tryingBackups = true;
-                        logger.debug(`${label} Trying backup models${streamSuffix}`);
-                    }
-                    return;
-                }
-                logger.warn(`${label} Backup model ${model} failed: ${errMsg}`);
-                if (!shouldTryBackup(error) && attemptNo < total) {
-                    logger.debug(`${label} Backup model error doesn't qualify for further attempts`);
-                }
-            },
-            onBackupStart: (model, backupNo, backupTotal) => {
-                logger.debug(`${label} Trying backup model ${backupNo}/${backupTotal}: ${model}`);
-            },
-            onBackupSucceeded: (model) => {
-                logger.debug(`${label} Backup model ${model} succeeded`);
-            },
-        },
-        logExhausted: (lastError) => {
-            if (tryingBackups) {
-                logger.error(`${label} All models failed. Primary: ${primaryErrMsg}, Last backup: ${getErrorMessage(lastError)}`);
-            }
-        },
-    };
-}
-//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/src/providers/errorClassification.ts

@@ -1,206 +0,0 @@
-/**
- * Shared provider error utilities: classification of SDK/HTTP errors onto
- * normalized ProviderErrorCode values, backup-model eligibility, and
- * wrapping of terminal failures in ProviderError.
- *
- * The classification is derived once and reused for both backup-model
- * decisions and final error wrapping, so the two can never drift apart.
- */
-
-import { ProviderError, type ProviderErrorCode } from "../types/errors";
-
-/**
- * Shape of errors with status/code properties thrown by provider SDKs
- */
-export interface ErrorWithStatus {
-  status?: number;
-  code?: string;
-  message?: string;
-  type?: string;
-}
-
-/**
- * Type guard to check if error is ErrorWithStatus
- */
-export function isErrorWithStatus(error: unknown): error is ErrorWithStatus {
-  return (
-    typeof error === "object" &&
-    error !== null &&
-    ("status" in error || "code" in error || "message" in error)
-  );
-}
-
-/**
- * Safely extract error message
- */
-export function getErrorMessage(error: unknown): string {
-  if (error instanceof Error) {
-    return error.message;
-  }
-  if (isErrorWithStatus(error) && error.message) {
-    return error.message;
-  }
-  return String(error);
-}
-
-/**
- * Provider-specific signals treated as "overloaded/unavailable", in
- * addition to the shared defaults (HTTP 500/503 and the common message
- * substrings below).
- */
-export interface ErrorClassificationOptions {
-  /** Extra HTTP statuses treated as overloaded (e.g. Anthropic's 529) */
-  overloadedStatuses?: readonly number[];
-  /** Error `code` values treated as overloaded/unavailable (e.g. "model_not_found") */
-  overloadedCodes?: readonly string[];
-  /** Error `type` values treated as overloaded (e.g. Anthropic's "overloaded_error") */
-  overloadedTypes?: readonly string[];
-  /** Extra message substrings treated as overloaded (e.g. OpenRouter's "capacity") */
-  overloadedMessages?: readonly string[];
-}
-
-/**
- * Message substrings every provider historically treated as
- * overloaded/unavailable for backup-model purposes.
- */
-const DEFAULT_OVERLOADED_MESSAGES: readonly string[] = [
-  "overloaded",
-  "unavailable",
-  "internal error",
-  "Internal error",
-];
-
-/**
- * Classify an unknown error into a normalized ProviderErrorCode.
- *
- * Overload/availability checks run first so that backup-model decisions
- * (rate_limited/overloaded) match the historical shouldUseBackupModel
- * predicate exactly.
- */
-export function classifyProviderError(
-  error: unknown,
-  options: ErrorClassificationOptions = {}
-): ProviderErrorCode {
-  if (!isErrorWithStatus(error)) {
-    return "unknown";
-  }
-
-  const { status, code, type } = error;
-  const message = getErrorMessage(error);
-
-  // Server errors / overload
-  if (status === 500 || status === 503) {
-    return "overloaded";
-  }
-
-  // Rate limiting
-  if (status === 429) {
-    return "rate_limited";
-  }
-
-  // Provider-specific overload/unavailability signals
-  if (status !== undefined && options.overloadedStatuses?.includes(status)) {
-    return "overloaded";
-  }
-  if (code !== undefined && options.overloadedCodes?.includes(code)) {
-    return "overloaded";
-  }
-  if (type !== undefined && options.overloadedTypes?.includes(type)) {
-    return "overloaded";
-  }
-  const overloadedMessages = options.overloadedMessages
-    ? [...DEFAULT_OVERLOADED_MESSAGES, ...options.overloadedMessages]
-    : DEFAULT_OVERLOADED_MESSAGES;
-  if (overloadedMessages.some((pattern) => message.includes(pattern))) {
-    return "overloaded";
-  }
-
-  // Non-retriable classifications (never triggered backup models)
-  if (status === 401 || status === 403) {
-    return "auth";
-  }
-  if (status === 400 || status === 404 || status === 422) {
-    return "invalid_request";
-  }
-  if (
-    status === 408 ||
-    message.includes("timed out") ||
-    message.includes("timeout")
-  ) {
-    return "timeout";
-  }
-  if (
-    message.includes("fetch failed") ||
-    message.includes("ECONNREFUSED") ||
-    message.includes("ECONNRESET") ||
-    message.includes("ETIMEDOUT") ||
-    message.includes("network")
-  ) {
-    return "network";
-  }
-
-  return "unknown";
-}
-
-/**
- * Whether an error code qualifies for trying backup models.
- * Mirrors the historical shouldUseBackupModel predicate.
- */
-export function isBackupEligible(code: ProviderErrorCode): boolean {
-  return code === "rate_limited" || code === "overloaded";
-}
-
-/** Errors whose name marks them as caller- or SDK-initiated aborts. */
-function isAbortLikeError(error: unknown): boolean {
-  if (!(error instanceof Error)) return false;
-  // OpenAI SDK: APIUserAbortError. Generic fetch/DOM: AbortError / TimeoutError
-  // handled below via classification (a timeout IS retriable; a caller abort is not).
-  return (
-    error.name === "AbortError" ||
-    error.name === "APIUserAbortError" ||
-    /abort/i.test(error.message)
-  );
-}
-
-/**
- * Whether an error is worth retrying with backoff: transient availability,
- * rate-limiting, timeouts and network faults only. Deterministic failures —
- * auth (401/403), invalid request (400/404/422) and caller aborts — must fail
- * fast instead of burning the retry budget on the same outcome.
- */
-export function isRetriableProviderError(
-  error: unknown,
-  options?: ErrorClassificationOptions
-): boolean {
-  if (isAbortLikeError(error)) {
-    return false;
-  }
-  const code = classifyProviderError(error, options);
-  return (
-    code === "rate_limited" ||
-    code === "overloaded" ||
-    code === "timeout" ||
-    code === "network"
-  );
-}
-
-/**
- * Wrap a terminal failure (after retries/backup exhaustion) in a
- * normalized ProviderError, preserving the original error as `cause`.
- * Already-wrapped errors pass through untouched.
- */
-export function toProviderError(
-  error: unknown,
-  provider: string,
-  options?: ErrorClassificationOptions
-): ProviderError {
-  if (error instanceof ProviderError) {
-    return error;
-  }
-  return new ProviderError(
-    classifyProviderError(error, options),
-    provider,
-    getErrorMessage(error),
-    error
-  );
-}