qlogicagent 0.2.1 → 0.4.0

package/dist/orchestration/failover-classification.js

@@ -1,381 +0,0 @@
-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;
-}

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

@@ -1,33 +0,0 @@
-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;

package/dist/orchestration/failover-error.js

@@ -1,198 +0,0 @@
-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,
-    });
-}