@jaypie/llm 1.2.28 → 1.2.29

package/dist/cjs/operate/adapters/XaiAdapter.d.ts

@@ -1,11 +1,14 @@
+import { ClassifiedError } from "../types.js";
 import { OpenAiAdapter } from "./OpenAiAdapter.js";
 /**
  * XaiAdapter extends OpenAiAdapter since xAI (Grok) uses an OpenAI-compatible API.
- * Only the name and default model are overridden; all request building, response parsing,
- * error classification, tool handling, and streaming are inherited.
+ * Name, default model, and transient-ingest-error detection are overridden;
+ * all request building, response parsing, tool handling, and streaming are
+ * inherited.
  */
 export declare class XaiAdapter extends OpenAiAdapter {
     readonly name: "xai";
     readonly defaultModel: "grok-4.20-0309-reasoning";
+    classifyError(error: unknown): ClassifiedError;
 }
 export declare const xaiAdapter: XaiAdapter;

package/dist/esm/index.js

@@ -3338,10 +3338,29 @@ class OpenRouterAdapter extends BaseProviderAdapter {
 // Export singleton instance
 const openRouterAdapter = new OpenRouterAdapter();
 
+/**
+ * Error-message substrings that indicate a transient xAI media-ingest flake.
+ * The xAI ingest service enters a bad state after ~12 consecutive file-bearing
+ * calls and rejects subsequent requests with HTTP 400. The condition is
+ * self-clearing, so these errors should be retried with backoff rather than
+ * surfaced as unrecoverable.
+ *
+ * See: github.com/finlaysonstudio/jaypie issue #301
+ */
+const TRANSIENT_INGEST_MESSAGE_PATTERNS = [
+    "failed to ingest inline file bytes",
+];
+function isTransientIngestError(error) {
+    if (!(error instanceof BadRequestError))
+        return false;
+    const message = (error.message ?? "").toLowerCase();
+    return TRANSIENT_INGEST_MESSAGE_PATTERNS.some((pattern) => message.includes(pattern));
+}
 /**
  * XaiAdapter extends OpenAiAdapter since xAI (Grok) uses an OpenAI-compatible API.
- * Only the name and default model are overridden; all request building, response parsing,
- * error classification, tool handling, and streaming are inherited.
+ * Name, default model, and transient-ingest-error detection are overridden;
+ * all request building, response parsing, tool handling, and streaming are
+ * inherited.
  */
 class XaiAdapter extends OpenAiAdapter {
     constructor() {
@@ -3351,6 +3370,16 @@ class XaiAdapter extends OpenAiAdapter {
         // @ts-expect-error Narrowing override: xAI default model differs from parent's literal
         this.defaultModel = PROVIDER.XAI.MODEL.DEFAULT;
     }
+    classifyError(error) {
+        if (isTransientIngestError(error)) {
+            return {
+                error,
+                category: ErrorCategory.Retryable,
+                shouldRetry: true,
+            };
+        }
+        return super.classifyError(error);
+    }
 }
 // Export singleton instance
 const xaiAdapter = new XaiAdapter();