qlogicagent 0.1.0

package/dist/orchestration/curator-scheduler.js

@@ -0,0 +1,136 @@
+/**
+ * Curator scheduler — pure strategy for autonomous skill library
+ * maintenance. Decides WHEN to run the curator review cycle and
+ * computes automatic lifecycle transitions (active → stale → archived).
+ *
+ * No I/O — all functions are pure; the caller supplies timestamps and
+ * skill records, and receives transition instructions back.
+ */
+export const DEFAULT_CURATOR_SCHEDULE_POLICY = {
+    minIdleSeconds: 7200,
+    intervalSeconds: 604_800,
+    staleAfterDays: 30,
+    archiveAfterDays: 90,
+    maxReviewBatchSize: 50,
+};
+export const INITIAL_CURATOR_STATE = {
+    lastRunAt: null,
+    lastRunDurationSeconds: 0,
+    lastRunSummary: "",
+    paused: false,
+    runCount: 0,
+};
+/**
+ * Determine whether the curator should run now.
+ *
+ * All gates must pass:
+ * 1. Feature enabled
+ * 2. Not paused
+ * 3. Session idle ≥ minIdleSeconds
+ * 4. Time since last run ≥ intervalSeconds
+ */
+export function shouldRunCurator(input) {
+    const policy = { ...DEFAULT_CURATOR_SCHEDULE_POLICY, ...input.policy };
+    if (!input.enabled) {
+        return { shouldRun: false, reason: "curator disabled" };
+    }
+    if (input.state.paused) {
+        return { shouldRun: false, reason: "curator paused by user" };
+    }
+    if (input.idleSeconds < policy.minIdleSeconds) {
+        return {
+            shouldRun: false,
+            reason: `session not idle long enough (${input.idleSeconds}s < ${policy.minIdleSeconds}s)`,
+        };
+    }
+    if (input.state.lastRunAt) {
+        const elapsed = (new Date(input.now).getTime() - new Date(input.state.lastRunAt).getTime()) / 1000;
+        if (elapsed < policy.intervalSeconds) {
+            return {
+                shouldRun: false,
+                reason: `last run too recent (${Math.round(elapsed)}s < ${policy.intervalSeconds}s)`,
+            };
+        }
+    }
+    return { shouldRun: true, reason: "all gates passed" };
+}
+/**
+ * Compute automatic lifecycle transitions for agent-created skills.
+ *
+ * Pure function — no I/O, no mutations. The caller applies the
+ * returned transitions to its skill storage.
+ *
+ * Rules:
+ * - Pinned skills are never transitioned.
+ * - Non-agent-created skills are skipped.
+ * - active → stale: no activity for staleAfterDays.
+ * - stale → archived: no activity for archiveAfterDays.
+ * - stale/archived → active: if useCount increased (reactivation).
+ */
+export function computeLifecycleTransitions(skills, now, policy) {
+    const resolved = { ...DEFAULT_CURATOR_SCHEDULE_POLICY, ...policy };
+    const nowMs = new Date(now).getTime();
+    const transitions = [];
+    let checked = 0;
+    for (const skill of skills) {
+        if (!skill.agentCreated)
+            continue;
+        checked++;
+        if (skill.pinned)
+            continue;
+        const lastMs = skill.lastActivityAt
+            ? new Date(skill.lastActivityAt).getTime()
+            : new Date(skill.createdAt).getTime();
+        const inactiveDays = (nowMs - lastMs) / (1000 * 60 * 60 * 24);
+        if (skill.state === "active" && inactiveDays >= resolved.staleAfterDays) {
+            transitions.push({
+                skillName: skill.name,
+                from: "active",
+                to: "stale",
+                reason: `inactive for ${Math.floor(inactiveDays)} days (threshold: ${resolved.staleAfterDays})`,
+            });
+        }
+        else if (skill.state === "stale" && inactiveDays >= resolved.archiveAfterDays) {
+            transitions.push({
+                skillName: skill.name,
+                from: "stale",
+                to: "archived",
+                reason: `inactive for ${Math.floor(inactiveDays)} days (threshold: ${resolved.archiveAfterDays})`,
+            });
+        }
+        // Reactivation: stale/archived skill with recent activity
+        if ((skill.state === "stale" || skill.state === "archived")
+            && skill.useCount > 0
+            && inactiveDays < resolved.staleAfterDays) {
+            transitions.push({
+                skillName: skill.name,
+                from: skill.state,
+                to: "active",
+                reason: "recent activity detected — reactivated",
+            });
+        }
+    }
+    return {
+        checked,
+        transitions,
+        markedStale: transitions.filter((t) => t.to === "stale").length,
+        archived: transitions.filter((t) => t.to === "archived").length,
+        reactivated: transitions.filter((t) => t.to === "active").length,
+    };
+}
+// ── Review candidate selection ─────────────────────────────────────
+/**
+ * Select skills that should be reviewed by the LLM curator.
+ *
+ * Only non-pinned, agent-created skills in active or stale state
+ * are eligible for review. Returns at most maxReviewBatchSize names.
+ */
+export function selectReviewCandidates(skills, policy) {
+    const resolved = { ...DEFAULT_CURATOR_SCHEDULE_POLICY, ...policy };
+    return skills
+        .filter((s) => s.agentCreated && !s.pinned && (s.state === "active" || s.state === "stale"))
+        .sort((a, b) => a.useCount - b.useCount) // least-used first → most likely consolidation candidates
+        .slice(0, resolved.maxReviewBatchSize)
+        .map((s) => s.name);
+}
+//# sourceMappingURL=curator-scheduler.js.map

package/dist/orchestration/curator-scheduler.js.map

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

package/dist/orchestration/embedded-failover-policy.d.ts

@@ -0,0 +1,111 @@
+export type EmbeddedPromptFailureAction<TThinkingLevel extends string = string, TFailoverReason extends string = string> = {
+    kind: "retry-rotated";
+} | {
+    kind: "retry-thinking";
+    thinkLevel: TThinkingLevel;
+} | {
+    kind: "throw-failover";
+    reason: TFailoverReason | null;
+} | {
+    kind: "unhandled";
+};
+export type EmbeddedAssistantFailureAction<TFailoverReason extends string = string> = {
+    kind: "retry-rotated";
+} | {
+    kind: "throw-failover";
+    reason: TFailoverReason | null;
+} | {
+    kind: "unhandled";
+};
+export type EmbeddedPromptErrorPolicyResolution<TThinkingLevel extends string = string, TFailoverReason extends string = string> = {
+    kind: "noop";
+} | {
+    kind: "return-error";
+    errorKind: "role_ordering" | "image_size";
+    text: string;
+    message: string;
+} | {
+    kind: "retry-rotated";
+} | {
+    kind: "retry-thinking";
+    thinkLevel: TThinkingLevel;
+} | {
+    kind: "throw-failover";
+    reason: TFailoverReason | null;
+} | {
+    kind: "throw-original";
+};
+export declare function resolveRetryableFailureReason<TReason extends string = string>(params: {
+    reason: TReason | null | undefined;
+    nonRetryableReasons?: readonly TReason[];
+}): TReason | null;
+export declare function resolveAuthProfileFailoverReason<TFailoverReason extends string = string>(params: {
+    allInCooldown: boolean;
+    unavailableReason?: TFailoverReason | null;
+    classifiedReason?: TFailoverReason | null;
+    cooldownFallbackReason: TFailoverReason;
+    defaultReason: TFailoverReason;
+}): TFailoverReason;
+export declare function resolveFallbackThinkingDecision<TThinkingLevel extends string = string>(params: {
+    aborted: boolean;
+    fallbackThinking?: TThinkingLevel;
+    provider: string;
+    modelId: string;
+}): {
+    thinkLevel: TThinkingLevel;
+    warningMessage: string;
+} | undefined;
+export declare function pickFallbackThinkingLevel<TThinkingLevel extends string = string>(params: {
+    message?: string;
+    attempted: Set<TThinkingLevel>;
+    normalizeThinkLevel: (raw: string) => TThinkingLevel | undefined;
+    offLevel?: TThinkingLevel;
+}): TThinkingLevel | undefined;
+export declare function shouldAttemptPromptFailureRotation<TFailoverReason extends string = string>(params: {
+    promptFailoverFailure: boolean;
+    promptFailoverReason: TFailoverReason | null;
+    nonRotatableReasons?: readonly TFailoverReason[];
+}): boolean;
+export declare function shouldAttemptAssistantFailureRotation(params: {
+    timedOut: boolean;
+    timedOutDuringCompaction: boolean;
+    failoverFailure: boolean;
+}): boolean;
+export declare function resolvePromptFailureActionDecision<TThinkingLevel extends string = string, TFailoverReason extends string = string>(params: {
+    promptFailoverFailure: boolean;
+    canRotate: boolean;
+    fallbackThinking?: TThinkingLevel;
+    fallbackConfigured: boolean;
+    promptFailoverReason: TFailoverReason | null;
+}): EmbeddedPromptFailureAction<TThinkingLevel, TFailoverReason>;
+export declare function resolveAssistantFailureActionDecision<TFailoverReason extends string = string>(params: {
+    timedOut: boolean;
+    timedOutDuringCompaction: boolean;
+    failoverFailure: boolean;
+    canRotate: boolean;
+    shouldThrowFailover: boolean;
+    failoverReason: TFailoverReason | null;
+}): EmbeddedAssistantFailureAction<TFailoverReason>;
+export declare function resolvePromptErrorPolicy<TThinkingLevel extends string = string, TFailoverReason extends string = string>(params: {
+    hasPromptError: boolean;
+    aborted: boolean;
+    errorText: string;
+    roleAlternationError: boolean;
+    imageSizeMaxMb?: number | null;
+    promptFailureAction: EmbeddedPromptFailureAction<TThinkingLevel, TFailoverReason>;
+}): EmbeddedPromptErrorPolicyResolution<TThinkingLevel, TFailoverReason>;
+export declare function buildAssistantFailoverErrorDetails(params: {
+    formattedAssistantErrorText?: string;
+    assistantErrorMessage?: string;
+    timedOut: boolean;
+    rateLimitFailure: boolean;
+    billingFailureMessage?: string;
+    authFailure: boolean;
+    failoverStatus?: number;
+    timeoutDetectedFromMessage: boolean;
+    timeoutStatus?: number;
+}): {
+    message: string;
+    status: number | undefined;
+};
+//# sourceMappingURL=embedded-failover-policy.d.ts.map

package/dist/orchestration/embedded-failover-policy.d.ts.map

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

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

@@ -0,0 +1,169 @@
+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),
+    };
+}
+//# sourceMappingURL=embedded-failover-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-failover-policy.js","sourceRoot":"","sources":["../../src/orchestration/embedded-failover-policy.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,6BAA6B,CAAkC,MAG9E;IACC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAA0C,MAMzF;IACC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,sBAAsB,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,aAAa,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAyC,MAKvF;IACC,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,gBAAgB;QACnC,cAAc,EACZ,kCAAkC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,IAAI;YACvE,iBAAiB,MAAM,CAAC,gBAAgB,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,GAAW;IACjD,MAAM,KAAK,GACT,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC;QAC/C,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9E,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CACjB,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ;SACZ,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACpE,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAyC,MAKjF;IACC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,IACE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YAC1B,MAAM,CAAC,QAAQ;YACf,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EACtC,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAA0C,MAI3F;IACC,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAuC,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,MAIrD;IACC,OAAO,MAAM,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAGhD,MAMD;IACC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,UAAU,EAAE,MAAM,CAAC,gBAAgB;SACpC,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC9D,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,MAAM,CAAC,oBAAoB;SACpC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,qCAAqC,CAA0C,MAO9F;IACC,MAAM,YAAY,GAAG,qCAAqC,CAAC;QACzD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;QACzD,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC,CAAC;IACH,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,MAAM,CAAC,cAAc;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAGtC,MAOD;IACC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,eAAe;YAC1B,IAAI,EACF,gDAAgD;gBAChD,sDAAsD;YACxD,OAAO,EAAE,MAAM,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACxF,MAAM,YAAY,GAAG,SAAS,MAAM,CAAC,cAAc,KAAK,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,YAAY;YACvB,IAAI,EACF,gCAAgC,YAAY,IAAI;gBAChD,oDAAoD;YACtD,OAAO,EAAE,MAAM,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACxD,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,UAAU,EAAE,MAAM,CAAC,mBAAmB,CAAC,UAAU;SAClD,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,MAAM;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,MAUlD;IAIC,MAAM,OAAO,GACX,MAAM,CAAC,2BAA2B;QAClC,MAAM,CAAC,qBAAqB,EAAE,IAAI,EAAE;QACpC,CAAC,MAAM,CAAC,QAAQ;YACd,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,MAAM,CAAC,gBAAgB;gBACvB,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,MAAM,CAAC,qBAAqB;oBAC5B,CAAC,CAAC,MAAM,CAAC,qBAAqB;oBAC9B,CAAC,CAAC,MAAM,CAAC,WAAW;wBAClB,CAAC,CAAC,2BAA2B;wBAC7B,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO;QACL,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KACjH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { FailoverReason } from "./failover-classification.js";
+export type ErrorCategory = "RETRYABLE_TRANSIENT" | "RETRYABLE_DEGRADED" | "NON_RETRYABLE_AUTH" | "NON_RETRYABLE_CONTENT" | "NON_RETRYABLE_QUOTA" | "TOOL_EXECUTION_FAILED";
+export interface RetryStrategy {
+    retryable: boolean;
+    maxRetries: number;
+    baseDelayMs: number;
+    backoffMultiplier: number;
+    switchProvider: boolean;
+}
+export declare function classifyError(status: number | undefined, message?: string): ErrorCategory;
+export declare function classifyErrorFromReason(reason: FailoverReason): ErrorCategory;
+export declare function getRetryStrategy(category: ErrorCategory): RetryStrategy;
+//# sourceMappingURL=error-classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.d.ts","sourceRoot":"","sources":["../../src/orchestration/error-classification.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,uBAAuB,GACvB,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB;AA4DD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAUf;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAEvE"}

package/dist/orchestration/error-classification.js

@@ -0,0 +1,78 @@
+// ============================================================
+// 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];
+}
+//# sourceMappingURL=error-classification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.js","sourceRoot":"","sources":["../../src/orchestration/error-classification.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2DAA2D;AAC3D,8DAA8D;AAC9D,+DAA+D;AAG/D,OAAO,EACL,sBAAsB,EACtB,oCAAoC,GACrC,MAAM,8BAA8B,CAAC;AAkBtC,MAAM,oBAAoB,GAA0C;IAClE,OAAO,EAAE,qBAAqB;IAC9B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,oBAAoB;IAChC,IAAI,EAAE,oBAAoB;IAC1B,cAAc,EAAE,oBAAoB;IACpC,OAAO,EAAE,qBAAqB;IAC9B,MAAM,EAAE,uBAAuB;IAC/B,eAAe,EAAE,uBAAuB;IACxC,eAAe,EAAE,uBAAuB;IACxC,OAAO,EAAE,qBAAqB;CAC/B,CAAC;AAEF,MAAM,gBAAgB,GAAyC;IAC7D,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,IAAI;QACjB,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,IAAI;KACrB;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,IAAI;QACjB,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,IAAI;KACrB;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,IAAI;KACrB;IACD,qBAAqB,EAAE;QACrB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,KAAK;KACtB;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,IAAI;KACrB;IACD,qBAAqB,EAAE;QACrB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,GAAG;QAChB,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,MAA0B,EAC1B,OAAgB;IAEhB,MAAM,MAAM,GACV,oCAAoC,CAAC,MAAM,EAAE,OAAO,CAAC;QACrD,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAChE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,qBAAqB,CAAC;IAC5B,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,9 @@
+export type FailoverReason = "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "timeout" | "model_not_found" | "session_expired" | "unknown";
+export declare function isTimeoutErrorMessage(raw: string): boolean;
+export declare function isCloudflareOrHtmlErrorPage(raw: string): boolean;
+export declare function isTransientHttpError(raw: string): boolean;
+export declare function classifyFailoverReasonFromHttpStatus(status: number | undefined, message?: string): FailoverReason | null;
+export declare function isModelNotFoundErrorMessage(raw: string): boolean;
+export declare function classifyFailoverReason(raw: string): FailoverReason | null;
+export declare function isFailoverErrorMessage(raw: string): boolean;
+//# sourceMappingURL=failover-classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"failover-classification.d.ts","sourceRoot":"","sources":["../../src/orchestration/failover-classification.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,SAAS,GACT,iBAAiB,GACjB,iBAAiB,GACjB,SAAS,CAAC;AAqJd,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAqHD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAahE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUzD;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,GAAG,IAAI,CAsCvB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsBhE;AAuBD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA8CzE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D"}