qlogicagent 0.2.1 → 0.3.0

package/dist/orchestration/embedded-failover-policy.js

@@ -1,168 +0,0 @@
-export function resolveRetryableFailureReason(params) {
-    if (!params.reason) {
-        return null;
-    }
-    if ((params.nonRetryableReasons ?? []).includes(params.reason)) {
-        return null;
-    }
-    return params.reason;
-}
-export function resolveAuthProfileFailoverReason(params) {
-    if (params.allInCooldown) {
-        return params.unavailableReason ?? params.cooldownFallbackReason;
-    }
-    return params.classifiedReason ?? params.defaultReason;
-}
-export function resolveFallbackThinkingDecision(params) {
-    if (params.aborted || !params.fallbackThinking) {
-        return undefined;
-    }
-    return {
-        thinkLevel: params.fallbackThinking,
-        warningMessage: `unsupported thinking level for ${params.provider}/${params.modelId}; ` +
-            `retrying with ${params.fallbackThinking}`,
-    };
-}
-function extractSupportedThinkingValues(raw) {
-    const match = raw.match(/supported values are:\s*([^\n.]+)/i) ??
-        raw.match(/supported values:\s*([^\n.]+)/i);
-    if (!match?.[1]) {
-        return [];
-    }
-    const fragment = match[1];
-    const quoted = Array.from(fragment.matchAll(/['"]([^'"]+)['"]/g)).map((entry) => entry[1]?.trim());
-    if (quoted.length > 0) {
-        return quoted.filter((entry) => Boolean(entry));
-    }
-    return fragment
-        .split(/,|\band\b/gi)
-        .map((entry) => entry.replace(/^[^a-zA-Z]+|[^a-zA-Z]+$/g, "").trim())
-        .filter(Boolean);
-}
-export function pickFallbackThinkingLevel(params) {
-    const raw = params.message?.trim();
-    if (!raw) {
-        return undefined;
-    }
-    const supported = extractSupportedThinkingValues(raw);
-    if (supported.length === 0) {
-        if (/not supported/i.test(raw) &&
-            params.offLevel &&
-            !params.attempted.has(params.offLevel)) {
-            return params.offLevel;
-        }
-        return undefined;
-    }
-    for (const entry of supported) {
-        const normalized = params.normalizeThinkLevel(entry);
-        if (!normalized || params.attempted.has(normalized)) {
-            continue;
-        }
-        return normalized;
-    }
-    return undefined;
-}
-export function shouldAttemptPromptFailureRotation(params) {
-    if (!params.promptFailoverFailure) {
-        return false;
-    }
-    return !(params.nonRotatableReasons ?? []).includes(params.promptFailoverReason);
-}
-export function shouldAttemptAssistantFailureRotation(params) {
-    return params.failoverFailure || (params.timedOut && !params.timedOutDuringCompaction);
-}
-export function resolvePromptFailureActionDecision(params) {
-    if (params.canRotate) {
-        return { kind: "retry-rotated" };
-    }
-    if (params.fallbackThinking) {
-        return {
-            kind: "retry-thinking",
-            thinkLevel: params.fallbackThinking,
-        };
-    }
-    if (params.fallbackConfigured && params.promptFailoverFailure) {
-        return {
-            kind: "throw-failover",
-            reason: params.promptFailoverReason,
-        };
-    }
-    return { kind: "unhandled" };
-}
-export function resolveAssistantFailureActionDecision(params) {
-    const shouldRotate = shouldAttemptAssistantFailureRotation({
-        timedOut: params.timedOut,
-        timedOutDuringCompaction: params.timedOutDuringCompaction,
-        failoverFailure: params.failoverFailure,
-    });
-    if (!shouldRotate) {
-        return { kind: "unhandled" };
-    }
-    if (params.canRotate) {
-        return { kind: "retry-rotated" };
-    }
-    if (params.shouldThrowFailover) {
-        return {
-            kind: "throw-failover",
-            reason: params.failoverReason,
-        };
-    }
-    return { kind: "unhandled" };
-}
-export function resolvePromptErrorPolicy(params) {
-    if (!params.hasPromptError || params.aborted) {
-        return { kind: "noop" };
-    }
-    if (params.roleAlternationError) {
-        return {
-            kind: "return-error",
-            errorKind: "role_ordering",
-            text: "Message ordering conflict - please try again. " +
-                "If this persists, use /new to start a fresh session.",
-            message: params.errorText,
-        };
-    }
-    if (typeof params.imageSizeMaxMb === "number" && Number.isFinite(params.imageSizeMaxMb)) {
-        const maxBytesHint = ` (max ${params.imageSizeMaxMb}MB)`;
-        return {
-            kind: "return-error",
-            errorKind: "image_size",
-            text: `Image too large for the model${maxBytesHint}. ` +
-                "Please compress or resize the image and try again.",
-            message: params.errorText,
-        };
-    }
-    if (params.promptFailureAction.kind === "retry-rotated") {
-        return { kind: "retry-rotated" };
-    }
-    if (params.promptFailureAction.kind === "retry-thinking") {
-        return {
-            kind: "retry-thinking",
-            thinkLevel: params.promptFailureAction.thinkLevel,
-        };
-    }
-    if (params.promptFailureAction.kind === "throw-failover") {
-        return {
-            kind: "throw-failover",
-            reason: params.promptFailureAction.reason,
-        };
-    }
-    return { kind: "throw-original" };
-}
-export function buildAssistantFailoverErrorDetails(params) {
-    const message = params.formattedAssistantErrorText ||
-        params.assistantErrorMessage?.trim() ||
-        (params.timedOut
-            ? "LLM request timed out."
-            : params.rateLimitFailure
-                ? "LLM request rate limited."
-                : params.billingFailureMessage
-                    ? params.billingFailureMessage
-                    : params.authFailure
-                        ? "LLM request unauthorized."
-                        : "LLM request failed.");
-    return {
-        message,
-        status: params.failoverStatus ?? (params.timeoutDetectedFromMessage ? (params.timeoutStatus ?? 408) : undefined),
-    };
-}

package/dist/orchestration/error-classification.js

@@ -1,77 +0,0 @@
-// ============================================================
-// Error classification — maps FailoverReason to high-level
-// retry categories for consumers that need a simple decision.
-// ============================================================
-import { classifyFailoverReason, classifyFailoverReasonFromHttpStatus, } from "./failover-classification.js";
-const FAILOVER_TO_CATEGORY = {
-    timeout: "RETRYABLE_TRANSIENT",
-    overloaded: "RETRYABLE_TRANSIENT",
-    rate_limit: "RETRYABLE_DEGRADED",
-    auth: "NON_RETRYABLE_AUTH",
-    auth_permanent: "NON_RETRYABLE_AUTH",
-    billing: "NON_RETRYABLE_QUOTA",
-    format: "NON_RETRYABLE_CONTENT",
-    model_not_found: "NON_RETRYABLE_CONTENT",
-    session_expired: "NON_RETRYABLE_CONTENT",
-    unknown: "RETRYABLE_TRANSIENT",
-};
-const RETRY_STRATEGIES = {
-    RETRYABLE_TRANSIENT: {
-        retryable: true,
-        maxRetries: 3,
-        baseDelayMs: 1000,
-        backoffMultiplier: 2,
-        switchProvider: true,
-    },
-    RETRYABLE_DEGRADED: {
-        retryable: true,
-        maxRetries: 2,
-        baseDelayMs: 5000,
-        backoffMultiplier: 3,
-        switchProvider: true,
-    },
-    NON_RETRYABLE_AUTH: {
-        retryable: false,
-        maxRetries: 0,
-        baseDelayMs: 0,
-        backoffMultiplier: 1,
-        switchProvider: true,
-    },
-    NON_RETRYABLE_CONTENT: {
-        retryable: false,
-        maxRetries: 0,
-        baseDelayMs: 0,
-        backoffMultiplier: 1,
-        switchProvider: false,
-    },
-    NON_RETRYABLE_QUOTA: {
-        retryable: false,
-        maxRetries: 0,
-        baseDelayMs: 0,
-        backoffMultiplier: 1,
-        switchProvider: true,
-    },
-    TOOL_EXECUTION_FAILED: {
-        retryable: true,
-        maxRetries: 1,
-        baseDelayMs: 500,
-        backoffMultiplier: 1,
-        switchProvider: false,
-    },
-};
-export function classifyError(status, message) {
-    const reason = classifyFailoverReasonFromHttpStatus(status, message) ??
-        (message ? classifyFailoverReason(message) : null);
-    if (!reason) {
-        return typeof status === "number" && status >= 400 && status < 500
-            ? "NON_RETRYABLE_CONTENT"
-            : "RETRYABLE_TRANSIENT";
-    }
-    return FAILOVER_TO_CATEGORY[reason];
-}
-export function classifyErrorFromReason(reason) {
-    return FAILOVER_TO_CATEGORY[reason];
-}
-export function getRetryStrategy(category) {
-    return RETRY_STRATEGIES[category];
-}

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;
-}