qlogicagent 0.1.0

package/dist/orchestration/failover-classification.js

@@ -0,0 +1,382 @@
+const PERIODIC_USAGE_LIMIT_RE = /\b(?:daily|weekly|monthly)(?:\/(?:daily|weekly|monthly))* (?:usage )?limit(?:s)?(?: (?:exhausted|reached|exceeded))?\b/i;
+const ERROR_PATTERNS = {
+    rateLimit: [
+        /rate[_ ]limit|too many requests|429/,
+        "model_cooldown",
+        "exceeded your current quota",
+        "resource has been exhausted",
+        "quota exceeded",
+        "resource_exhausted",
+        "usage limit",
+        /\btpm\b/i,
+        "tokens per minute",
+        "tokens per day",
+    ],
+    overloaded: [
+        /overloaded_error|"type"\s*:\s*"overloaded_error"/i,
+        "overloaded",
+        /service[_ ]unavailable.*(?:overload|capacity|high[_ ]demand)|(?:overload|capacity|high[_ ]demand).*service[_ ]unavailable/i,
+        "high demand",
+    ],
+    timeout: [
+        "timeout",
+        "timed out",
+        "service unavailable",
+        "deadline exceeded",
+        "context deadline exceeded",
+        "connection error",
+        "network error",
+        "network request failed",
+        "fetch failed",
+        "socket hang up",
+        /\beconn(?:refused|reset|aborted)\b/i,
+        /\benotfound\b/i,
+        /\beai_again\b/i,
+        /without sending (?:any )?chunks?/i,
+        /\bstop reason:\s*(?:abort|error|network_error)\b/i,
+        /\breason:\s*(?:abort|error|network_error)\b/i,
+        /\bunhandled stop reason:\s*(?:abort|error|network_error)\b/i,
+    ],
+    billing: [
+        /["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|\b(?:got|returned|received)\s+(?:a\s+)?402\b|^\s*402\s+payment/i,
+        "payment required",
+        "insufficient credits",
+        /insufficient[_ ]quota/i,
+        "credit balance",
+        "plans & billing",
+        "insufficient balance",
+    ],
+    authPermanent: [
+        /api[_ ]?key[_ ]?(?:revoked|invalid|deactivated|deleted)/i,
+        "invalid_api_key",
+        "key has been disabled",
+        "key has been revoked",
+        "account has been deactivated",
+        /could not (?:authenticate|validate).*(?:api[_ ]?key|credentials)/i,
+        "permission_error",
+        "not allowed for this organization",
+    ],
+    auth: [
+        /invalid[_ ]?api[_ ]?key/,
+        "incorrect api key",
+        "invalid token",
+        "authentication",
+        "re-authenticate",
+        "oauth token refresh failed",
+        "unauthorized",
+        "forbidden",
+        "access denied",
+        "insufficient permissions",
+        "insufficient permission",
+        /missing scopes?:/i,
+        "expired",
+        "token has expired",
+        /\b401\b/,
+        /\b403\b/,
+        "no credentials found",
+        "no api key found",
+    ],
+    format: [
+        "string should match pattern",
+        "tool_use.id",
+        "tool_use_id",
+        "messages.1.content.1.tool_use.id",
+        "invalid request format",
+        /tool call id was.*must be/i,
+    ],
+};
+const BILLING_ERROR_HEAD_RE = /^(?:error[:\s-]+)?billing(?:\s+error)?(?:[:\s-]+|$)|^(?:error[:\s-]+)?(?:credit balance|insufficient credits?|payment required|http\s*402\b)/i;
+const BILLING_ERROR_HARD_402_RE = /["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|^\s*402\s+payment/i;
+const BILLING_ERROR_MAX_LENGTH = 512;
+const HTTP_STATUS_CODE_PREFIX_RE = /^(?:http\s*)?(\d{3})(?:\s+([\s\S]+))?$/i;
+const HTML_ERROR_PREFIX_RE = /^\s*(?:<!doctype\s+html\b|<html\b)/i;
+const CLOUDFLARE_HTML_ERROR_CODES = new Set([521, 522, 523, 524, 525, 526, 530]);
+const TRANSIENT_HTTP_ERROR_CODES = new Set([500, 502, 503, 504, 521, 522, 523, 524, 529]);
+const BILLING_402_HINTS = [
+    "insufficient credits",
+    "insufficient quota",
+    "credit balance",
+    "insufficient balance",
+    "plans & billing",
+    "add more credits",
+    "top up",
+];
+const BILLING_402_PLAN_HINTS = [
+    "upgrade your plan",
+    "upgrade plan",
+    "current plan",
+    "subscription",
+];
+const PERIODIC_402_HINTS = ["daily", "weekly", "monthly"];
+const RETRYABLE_402_RETRY_HINTS = ["try again", "retry", "temporary", "cooldown"];
+const RETRYABLE_402_LIMIT_HINTS = ["usage limit", "rate limit", "organization usage"];
+const RETRYABLE_402_SCOPED_HINTS = ["organization", "workspace"];
+const RETRYABLE_402_SCOPED_RESULT_HINTS = ["billing period", "exceeded", "reached", "exhausted"];
+const RAW_402_MARKER_RE = /["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|\b(?:got|returned|received)\s+(?:a\s+)?402\b|^\s*402\s+payment required\b/i;
+const LEADING_402_WRAPPER_RE = /^(?:error[:\s-]+)?(?:(?:http\s*)?402(?:\s+payment required)?|payment required)(?:[:\s-]+|$)/i;
+function matchesErrorPatterns(raw, patterns) {
+    if (!raw) {
+        return false;
+    }
+    const value = raw.toLowerCase();
+    return patterns.some((pattern) => pattern instanceof RegExp ? pattern.test(value) : value.includes(pattern));
+}
+function matchesFormatErrorPattern(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.format);
+}
+function isRateLimitErrorMessage(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.rateLimit);
+}
+export function isTimeoutErrorMessage(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.timeout);
+}
+function isPeriodicUsageLimitErrorMessage(raw) {
+    return PERIODIC_USAGE_LIMIT_RE.test(raw);
+}
+function isBillingErrorMessage(raw) {
+    const value = raw.toLowerCase();
+    if (!value) {
+        return false;
+    }
+    if (raw.length > BILLING_ERROR_MAX_LENGTH) {
+        return BILLING_ERROR_HARD_402_RE.test(value);
+    }
+    if (matchesErrorPatterns(value, ERROR_PATTERNS.billing)) {
+        return true;
+    }
+    if (!BILLING_ERROR_HEAD_RE.test(raw)) {
+        return false;
+    }
+    return (value.includes("upgrade") ||
+        value.includes("credits") ||
+        value.includes("payment") ||
+        value.includes("plan"));
+}
+function isAuthPermanentErrorMessage(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.authPermanent);
+}
+function isAuthErrorMessage(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.auth);
+}
+function isOverloadedErrorMessage(raw) {
+    return matchesErrorPatterns(raw, ERROR_PATTERNS.overloaded);
+}
+function includesAnyHint(text, hints) {
+    return hints.some((hint) => text.includes(hint));
+}
+function hasExplicit402BillingSignal(text) {
+    return (includesAnyHint(text, BILLING_402_HINTS) ||
+        (includesAnyHint(text, BILLING_402_PLAN_HINTS) && text.includes("limit")) ||
+        text.includes("billing hard limit") ||
+        text.includes("hard limit reached") ||
+        (text.includes("maximum allowed") && text.includes("limit")));
+}
+function hasRetryable402TransientSignal(text) {
+    const hasPeriodicHint = includesAnyHint(text, PERIODIC_402_HINTS);
+    const hasSpendLimit = text.includes("spend limit") || text.includes("spending limit");
+    const hasScopedHint = includesAnyHint(text, RETRYABLE_402_SCOPED_HINTS);
+    return ((includesAnyHint(text, RETRYABLE_402_RETRY_HINTS) &&
+        includesAnyHint(text, RETRYABLE_402_LIMIT_HINTS)) ||
+        (hasPeriodicHint && (text.includes("usage limit") || hasSpendLimit)) ||
+        (hasPeriodicHint && text.includes("limit") && text.includes("reset")) ||
+        (hasScopedHint &&
+            text.includes("limit") &&
+            (hasSpendLimit || includesAnyHint(text, RETRYABLE_402_SCOPED_RESULT_HINTS))));
+}
+function normalize402Message(raw) {
+    return raw.trim().toLowerCase().replace(LEADING_402_WRAPPER_RE, "").trim();
+}
+function classify402Message(message) {
+    const normalized = normalize402Message(message);
+    if (!normalized) {
+        return "billing";
+    }
+    if (hasExplicit402BillingSignal(normalized)) {
+        return "billing";
+    }
+    if (isRateLimitErrorMessage(normalized)) {
+        return "rate_limit";
+    }
+    if (hasRetryable402TransientSignal(normalized)) {
+        return "rate_limit";
+    }
+    return "billing";
+}
+function classifyFailoverReasonFrom402Text(raw) {
+    if (!RAW_402_MARKER_RE.test(raw)) {
+        return null;
+    }
+    return classify402Message(raw);
+}
+function extractLeadingHttpStatus(raw) {
+    const match = raw.match(HTTP_STATUS_CODE_PREFIX_RE);
+    if (!match) {
+        return null;
+    }
+    const code = Number(match[1]);
+    if (!Number.isFinite(code)) {
+        return null;
+    }
+    return { code, rest: (match[2] ?? "").trim() };
+}
+function isJsonApiInternalServerError(raw) {
+    if (!raw) {
+        return false;
+    }
+    const value = raw.toLowerCase();
+    return value.includes('"type":"api_error"') && value.includes("internal server error");
+}
+export function isCloudflareOrHtmlErrorPage(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return false;
+    }
+    const status = extractLeadingHttpStatus(trimmed);
+    if (!status || status.code < 500) {
+        return false;
+    }
+    if (CLOUDFLARE_HTML_ERROR_CODES.has(status.code)) {
+        return true;
+    }
+    return status.code < 600 && HTML_ERROR_PREFIX_RE.test(status.rest) && /<\/html>/i.test(status.rest);
+}
+export function isTransientHttpError(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return false;
+    }
+    const status = extractLeadingHttpStatus(trimmed);
+    if (!status) {
+        return false;
+    }
+    return TRANSIENT_HTTP_ERROR_CODES.has(status.code);
+}
+export function classifyFailoverReasonFromHttpStatus(status, message) {
+    if (typeof status !== "number" || !Number.isFinite(status)) {
+        return null;
+    }
+    if (status === 402) {
+        return message ? classify402Message(message) : "billing";
+    }
+    if (status === 429) {
+        return "rate_limit";
+    }
+    if (status === 401 || status === 403) {
+        if (message && isAuthPermanentErrorMessage(message)) {
+            return "auth_permanent";
+        }
+        return "auth";
+    }
+    if (status === 408) {
+        return "timeout";
+    }
+    if (status === 503) {
+        if (message && isOverloadedErrorMessage(message)) {
+            return "overloaded";
+        }
+        return "timeout";
+    }
+    if (status === 502 || status === 504) {
+        return "timeout";
+    }
+    if (status === 529) {
+        return "overloaded";
+    }
+    if (status === 400) {
+        if (message && isBillingErrorMessage(message)) {
+            return "billing";
+        }
+        return "format";
+    }
+    return null;
+}
+export function isModelNotFoundErrorMessage(raw) {
+    if (!raw) {
+        return false;
+    }
+    const lower = raw.toLowerCase();
+    if (lower.includes("unknown model") ||
+        lower.includes("model not found") ||
+        lower.includes("model_not_found") ||
+        lower.includes("not_found_error") ||
+        (lower.includes("does not exist") && lower.includes("model")) ||
+        (lower.includes("invalid model") && !lower.includes("invalid model reference"))) {
+        return true;
+    }
+    if (/models\/[^\s]+ is not found/i.test(raw)) {
+        return true;
+    }
+    if (/\b404\b/.test(raw) && /not[-_ ]?found/i.test(raw)) {
+        return true;
+    }
+    return false;
+}
+function isCliSessionExpiredErrorMessage(raw) {
+    if (!raw) {
+        return false;
+    }
+    const lower = raw.toLowerCase();
+    return (lower.includes("session not found") ||
+        lower.includes("session does not exist") ||
+        lower.includes("session expired") ||
+        lower.includes("session invalid") ||
+        lower.includes("conversation not found") ||
+        lower.includes("conversation does not exist") ||
+        lower.includes("conversation expired") ||
+        lower.includes("conversation invalid") ||
+        lower.includes("no such session") ||
+        lower.includes("invalid session") ||
+        lower.includes("session id not found") ||
+        lower.includes("conversation id not found"));
+}
+export function classifyFailoverReason(raw) {
+    if (isCliSessionExpiredErrorMessage(raw)) {
+        return "session_expired";
+    }
+    if (isModelNotFoundErrorMessage(raw)) {
+        return "model_not_found";
+    }
+    const reasonFrom402Text = classifyFailoverReasonFrom402Text(raw);
+    if (reasonFrom402Text) {
+        return reasonFrom402Text;
+    }
+    if (isPeriodicUsageLimitErrorMessage(raw)) {
+        return isBillingErrorMessage(raw) ? "billing" : "rate_limit";
+    }
+    if (isRateLimitErrorMessage(raw)) {
+        return "rate_limit";
+    }
+    if (isOverloadedErrorMessage(raw)) {
+        return "overloaded";
+    }
+    if (isTransientHttpError(raw)) {
+        const status = extractLeadingHttpStatus(raw.trim());
+        if (status?.code === 529) {
+            return "overloaded";
+        }
+        return "timeout";
+    }
+    if (isJsonApiInternalServerError(raw)) {
+        return "timeout";
+    }
+    if (matchesFormatErrorPattern(raw)) {
+        return "format";
+    }
+    if (isBillingErrorMessage(raw)) {
+        return "billing";
+    }
+    if (isTimeoutErrorMessage(raw)) {
+        return "timeout";
+    }
+    if (isAuthPermanentErrorMessage(raw)) {
+        return "auth_permanent";
+    }
+    if (isAuthErrorMessage(raw)) {
+        return "auth";
+    }
+    return null;
+}
+export function isFailoverErrorMessage(raw) {
+    return classifyFailoverReason(raw) !== null;
+}
+//# sourceMappingURL=failover-classification.js.map

package/dist/orchestration/failover-classification.js.map

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

package/dist/orchestration/failover-error.d.ts

@@ -0,0 +1,34 @@
+import { type FailoverReason } from "./failover-classification.js";
+export declare class FailoverError extends Error {
+    readonly reason: FailoverReason;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly profileId?: string;
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, params: {
+        reason: FailoverReason;
+        provider?: string;
+        model?: string;
+        profileId?: string;
+        status?: number;
+        code?: string;
+        cause?: unknown;
+    });
+}
+export declare function isFailoverError(err: unknown): err is FailoverError;
+export declare function resolveFailoverStatus(reason: FailoverReason): number | undefined;
+export declare function isTimeoutError(err: unknown): boolean;
+export declare function resolveFailoverReasonFromError(err: unknown): FailoverReason | null;
+export declare function describeFailoverError(err: unknown): {
+    message: string;
+    reason?: FailoverReason;
+    status?: number;
+    code?: string;
+};
+export declare function coerceToFailoverError(err: unknown, context?: {
+    provider?: string;
+    model?: string;
+    profileId?: string;
+}): FailoverError | null;
+//# sourceMappingURL=failover-error.d.ts.map

package/dist/orchestration/failover-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover-error.d.ts","sourceRoot":"","sources":["../../src/orchestration/failover-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAyEtC,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QACN,MAAM,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAWJ;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAuBhF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAiBpD;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAmClF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAgBA;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,GAAG,IAAI,CAsBtB"}

package/dist/orchestration/failover-error.js

@@ -0,0 +1,199 @@
+import { classifyFailoverReason, classifyFailoverReasonFromHttpStatus, isTimeoutErrorMessage, } from "./failover-classification.js";
+const ABORT_TIMEOUT_RE = /request was aborted|request aborted/i;
+function readErrorName(err) {
+    if (!err || typeof err !== "object") {
+        return undefined;
+    }
+    const candidate = err.name;
+    return typeof candidate === "string" && candidate.trim() ? candidate.trim() : undefined;
+}
+function getStatusCode(err) {
+    if (!err || typeof err !== "object") {
+        return undefined;
+    }
+    const candidate = err.status ??
+        err.statusCode;
+    if (typeof candidate === "number") {
+        return candidate;
+    }
+    if (typeof candidate === "string" && /^\d+$/.test(candidate)) {
+        return Number(candidate);
+    }
+    return undefined;
+}
+function getErrorCode(err) {
+    if (!err || typeof err !== "object") {
+        return undefined;
+    }
+    const candidate = err.code;
+    if (typeof candidate !== "string") {
+        return undefined;
+    }
+    const trimmed = candidate.trim();
+    return trimmed ? trimmed : undefined;
+}
+function getErrorMessage(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    if (typeof err === "string") {
+        return err;
+    }
+    if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") {
+        return String(err);
+    }
+    if (typeof err === "symbol") {
+        return err.description ?? "";
+    }
+    if (err && typeof err === "object") {
+        const message = err.message;
+        if (typeof message === "string") {
+            return message;
+        }
+    }
+    return "";
+}
+function hasTimeoutHint(err) {
+    if (!err) {
+        return false;
+    }
+    if (readErrorName(err) === "TimeoutError") {
+        return true;
+    }
+    const message = getErrorMessage(err);
+    return Boolean(message && isTimeoutErrorMessage(message));
+}
+export class FailoverError extends Error {
+    reason;
+    provider;
+    model;
+    profileId;
+    status;
+    code;
+    constructor(message, params) {
+        super(message, { cause: params.cause });
+        this.name = "FailoverError";
+        this.reason = params.reason;
+        this.provider = params.provider;
+        this.model = params.model;
+        this.profileId = params.profileId;
+        this.status = params.status;
+        this.code = params.code;
+    }
+}
+export function isFailoverError(err) {
+    return err instanceof FailoverError;
+}
+export function resolveFailoverStatus(reason) {
+    switch (reason) {
+        case "billing":
+            return 402;
+        case "rate_limit":
+            return 429;
+        case "overloaded":
+            return 503;
+        case "auth":
+            return 401;
+        case "auth_permanent":
+            return 403;
+        case "timeout":
+            return 408;
+        case "format":
+            return 400;
+        case "model_not_found":
+            return 404;
+        case "session_expired":
+            return 410;
+        default:
+            return undefined;
+    }
+}
+export function isTimeoutError(err) {
+    if (hasTimeoutHint(err)) {
+        return true;
+    }
+    if (!err || typeof err !== "object") {
+        return false;
+    }
+    if (readErrorName(err) !== "AbortError") {
+        return false;
+    }
+    const message = getErrorMessage(err);
+    if (message && ABORT_TIMEOUT_RE.test(message)) {
+        return true;
+    }
+    const cause = "cause" in err ? err.cause : undefined;
+    const reason = "reason" in err ? err.reason : undefined;
+    return hasTimeoutHint(cause) || hasTimeoutHint(reason);
+}
+export function resolveFailoverReasonFromError(err) {
+    if (isFailoverError(err)) {
+        return err.reason;
+    }
+    const status = getStatusCode(err);
+    const message = getErrorMessage(err);
+    const statusReason = classifyFailoverReasonFromHttpStatus(status, message);
+    if (statusReason) {
+        return statusReason;
+    }
+    const code = (getErrorCode(err) ?? "").toUpperCase();
+    if ([
+        "ETIMEDOUT",
+        "ESOCKETTIMEDOUT",
+        "ECONNRESET",
+        "ECONNABORTED",
+        "ECONNREFUSED",
+        "ENETUNREACH",
+        "EHOSTUNREACH",
+        "ENETRESET",
+        "EAI_AGAIN",
+    ].includes(code)) {
+        return "timeout";
+    }
+    if (isTimeoutError(err)) {
+        return "timeout";
+    }
+    if (!message) {
+        return null;
+    }
+    return classifyFailoverReason(message);
+}
+export function describeFailoverError(err) {
+    if (isFailoverError(err)) {
+        return {
+            message: err.message,
+            reason: err.reason,
+            status: err.status,
+            code: err.code,
+        };
+    }
+    const message = getErrorMessage(err) || String(err);
+    return {
+        message,
+        reason: resolveFailoverReasonFromError(err) ?? undefined,
+        status: getStatusCode(err),
+        code: getErrorCode(err),
+    };
+}
+export function coerceToFailoverError(err, context) {
+    if (isFailoverError(err)) {
+        return err;
+    }
+    const reason = resolveFailoverReasonFromError(err);
+    if (!reason) {
+        return null;
+    }
+    const message = getErrorMessage(err) || String(err);
+    const status = getStatusCode(err) ?? resolveFailoverStatus(reason);
+    const code = getErrorCode(err);
+    return new FailoverError(message, {
+        reason,
+        provider: context?.provider,
+        model: context?.model,
+        profileId: context?.profileId,
+        status,
+        code,
+        cause: err instanceof Error ? err : undefined,
+    });
+}
+//# sourceMappingURL=failover-error.js.map

package/dist/orchestration/failover-error.js.map

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