@ai-sdk/xai 4.0.25 → 4.0.26

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ai-sdk/xai
 
+## 4.0.26
+
+### Patch Changes
+
+- 79e133c: async APIs for generateVideo (poll, webhook)
+
+  Adds an asynchronous start/status flow to the experimental video model
+  interface (`VideoModelV4`): models may now implement `doStart`, `doStatus`,
+  and `handleWebhookOption` instead of (or in addition to) `doGenerate`, and
+  `experimental_generateVideo` accepts `poll` and `webhook` options to
+  orchestrate completion via polling or webhooks. Polling configuration can use
+  a custom delay implementation for durable workflow compatibility.
+
+- Updated dependencies [79e133c]
+  - @ai-sdk/provider@4.0.5
+  - @ai-sdk/openai-compatible@3.0.21
+  - @ai-sdk/provider-utils@5.0.19
+
 ## 4.0.25
 
 ### Patch Changes

package/dist/index.js

@@ -3510,7 +3510,7 @@ var xaiTools = {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.25" : "0.0.0-test";
+var VERSION = true ? "4.0.26" : "0.0.0-test";
 
 // src/files/xai-files.ts
 import {
@@ -3622,7 +3622,6 @@ import {
   combineHeaders as combineHeaders5,
   convertUint8ArrayToBase64,
   createJsonResponseHandler as createJsonResponseHandler5,
-  delay,
   extractResponseHeaders as extractResponseHeaders2,
   getFromApi as getFromApi2,
   getTopLevelMediaType as getTopLevelMediaType3,
@@ -3763,9 +3762,7 @@ var XaiVideoModel = class {
   get provider() {
     return this.config.provider;
   }
-  async doGenerate(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-    const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
+  async buildRequestBody(options) {
     const warnings = [];
     const xaiOptions = await parseProviderOptions7({
       provider: "xai",
@@ -3921,6 +3918,20 @@ var XaiVideoModel = class {
         }
       }
     }
+    return {
+      body,
+      warnings,
+      xaiOptions,
+      isEdit,
+      isExtension,
+      hasReferenceImages,
+      effectiveMode
+    };
+  }
+  async doStart(options) {
+    var _a, _b, _c, _d;
+    const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
+    const { body, warnings, isEdit, isExtension } = await this.buildRequestBody(options);
     const baseURL = (_d = this.config.baseURL) != null ? _d : "https://api.x.ai/v1";
     let endpoint;
     if (isEdit) {
@@ -3930,7 +3941,7 @@ var XaiVideoModel = class {
     } else {
       endpoint = `${baseURL}/videos/generations`;
     }
-    const { value: createResponse } = await postJsonToApi4({
+    const { value: createResponse, responseHeaders } = await postJsonToApi4({
       url: endpoint,
       headers: combineHeaders5(this.config.headers(), options.headers),
       body,
@@ -3945,82 +3956,103 @@ var XaiVideoModel = class {
     if (!requestId) {
       throw new AISDKError({
         name: "XAI_VIDEO_GENERATION_ERROR",
-        message: `No request_id returned from xAI API. Response: ${JSON.stringify(createResponse)}`
+        message: `No request_id returned from xAI API.`
       });
     }
-    const pollIntervalMs = (_e = xaiOptions == null ? void 0 : xaiOptions.pollIntervalMs) != null ? _e : 5e3;
-    const pollTimeoutMs = (_f = xaiOptions == null ? void 0 : xaiOptions.pollTimeoutMs) != null ? _f : 6e5;
-    const startTime = Date.now();
-    let responseHeaders;
-    while (true) {
-      await delay(pollIntervalMs, { abortSignal: options.abortSignal });
-      if (Date.now() - startTime > pollTimeoutMs) {
-        throw new AISDKError({
-          name: "XAI_VIDEO_GENERATION_TIMEOUT",
-          message: `Video generation timed out after ${pollTimeoutMs}ms`
-        });
+    return {
+      operation: { requestId },
+      warnings,
+      response: {
+        timestamp: currentDate,
+        modelId: this.modelId,
+        headers: responseHeaders
       }
-      const { value: statusResponse, responseHeaders: pollHeaders } = await getFromApi2({
-        url: `${baseURL}/videos/${requestId}`,
-        validateUrl: false,
-        headers: combineHeaders5(this.config.headers(), options.headers),
-        successfulResponseHandler: xaiVideoStatusResponseHandler,
-        failedResponseHandler: xaiFailedResponseHandler,
-        abortSignal: options.abortSignal,
-        fetch: this.config.fetch
-      });
-      responseHeaders = pollHeaders;
-      if (statusResponse.status === "done" || statusResponse.status == null && ((_g = statusResponse.video) == null ? void 0 : _g.url)) {
-        if (((_h = statusResponse.video) == null ? void 0 : _h.respect_moderation) === false) {
-          throw new AISDKError({
-            name: "XAI_VIDEO_MODERATION_ERROR",
-            message: "Video generation was blocked due to a content policy violation."
-          });
+    };
+  }
+  async doStatus(options) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
+    const { requestId } = options.operation;
+    const baseURL = (_d = this.config.baseURL) != null ? _d : "https://api.x.ai/v1";
+    const { value: statusResponse, responseHeaders } = await getFromApi2({
+      url: `${baseURL}/videos/${requestId}`,
+      validateUrl: false,
+      headers: combineHeaders5(this.config.headers(), options.headers),
+      successfulResponseHandler: xaiVideoStatusResponseHandler,
+      failedResponseHandler: xaiFailedResponseHandler,
+      abortSignal: options.abortSignal,
+      fetch: this.config.fetch
+    });
+    if (statusResponse.status === "expired") {
+      return {
+        status: "error",
+        error: "Video generation request expired.",
+        response: {
+          timestamp: currentDate,
+          modelId: this.modelId,
+          headers: responseHeaders
         }
-        if (!((_i = statusResponse.video) == null ? void 0 : _i.url)) {
-          throw new AISDKError({
-            name: "XAI_VIDEO_GENERATION_ERROR",
-            message: "Video generation completed but no video URL was returned."
-          });
+      };
+    }
+    if (statusResponse.status === "failed") {
+      const errorDetails = (_g = (_e = statusResponse.error) == null ? void 0 : _e.message) != null ? _g : (_f = statusResponse.error) == null ? void 0 : _f.code;
+      return {
+        status: "error",
+        error: errorDetails != null ? `Video generation failed: ${errorDetails}` : "Video generation failed.",
+        response: {
+          timestamp: currentDate,
+          modelId: this.modelId,
+          headers: responseHeaders
         }
-        return {
-          videos: [
-            {
-              type: "url",
-              url: statusResponse.video.url,
-              mediaType: "video/mp4"
-            }
-          ],
-          warnings,
-          response: {
-            timestamp: currentDate,
-            modelId: this.modelId,
-            headers: responseHeaders
-          },
-          providerMetadata: {
-            xai: {
-              requestId,
-              videoUrl: statusResponse.video.url,
-              ...statusResponse.video.duration != null ? { duration: statusResponse.video.duration } : {},
-              ...((_j = statusResponse.usage) == null ? void 0 : _j.cost_in_usd_ticks) != null ? { costInUsdTicks: statusResponse.usage.cost_in_usd_ticks } : {},
-              ...statusResponse.progress != null ? { progress: statusResponse.progress } : {}
-            }
-          }
-        };
-      }
-      if (statusResponse.status === "expired") {
+      };
+    }
+    if (statusResponse.status === "done" || statusResponse.status == null && ((_h = statusResponse.video) == null ? void 0 : _h.url)) {
+      if (((_i = statusResponse.video) == null ? void 0 : _i.respect_moderation) === false) {
         throw new AISDKError({
-          name: "XAI_VIDEO_GENERATION_EXPIRED",
-          message: "Video generation request expired."
+          name: "XAI_VIDEO_MODERATION_ERROR",
+          message: "Video generation was blocked due to a content policy violation."
         });
       }
-      if (statusResponse.status === "failed") {
+      if (!((_j = statusResponse.video) == null ? void 0 : _j.url)) {
         throw new AISDKError({
-          name: "XAI_VIDEO_GENERATION_FAILED",
-          message: "Video generation failed."
+          name: "XAI_VIDEO_GENERATION_ERROR",
+          message: "Video generation completed but no video URL was returned."
         });
       }
+      return {
+        status: "completed",
+        videos: [
+          {
+            type: "url",
+            url: statusResponse.video.url,
+            mediaType: "video/mp4"
+          }
+        ],
+        warnings: [],
+        response: {
+          timestamp: currentDate,
+          modelId: this.modelId,
+          headers: responseHeaders
+        },
+        providerMetadata: {
+          xai: {
+            requestId,
+            videoUrl: statusResponse.video.url,
+            ...statusResponse.video.duration != null ? { duration: statusResponse.video.duration } : {},
+            ...((_k = statusResponse.usage) == null ? void 0 : _k.cost_in_usd_ticks) != null ? { costInUsdTicks: statusResponse.usage.cost_in_usd_ticks } : {},
+            ...statusResponse.progress != null ? { progress: statusResponse.progress } : {}
+          }
+        }
+      };
     }
+    return {
+      status: "pending",
+      response: {
+        timestamp: currentDate,
+        modelId: this.modelId,
+        headers: responseHeaders
+      }
+    };
   }
 };
 var xaiCreateVideoResponseSchema = z19.object({