@tanstack/ai-grok 0.14.9 → 0.14.11

package/dist/esm/adapters/video.js

@@ -1,237 +1,286 @@
+import { getGrokApiKeyFromEnv, withGrokDefaults } from "../utils/client.js";
+import { getGrokVideoDurationOptions, isImageToVideoOnlyModel, parseGrokVideoSize, validateVideoSize } from "../video/video-provider-options.js";
 import { resolveMediaPrompt } from "@tanstack/ai";
 import { BaseVideoAdapter, snapToDurationOption } from "@tanstack/ai/adapters";
 import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
-import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
-import { validateVideoSize, isImageToVideoOnlyModel, parseGrokVideoSize, getGrokVideoDurationOptions } from "../video/video-provider-options.js";
-const USD_TICKS_PER_DOLLAR = 1e10;
+//#region src/adapters/video.ts
+/**
+* xAI bills video generation in "USD ticks": 10^10 ticks per US dollar
+* (e.g. one grok-imagine-video-1.5 second costs $0.08 = 800_000_000 ticks).
+*/
+var USD_TICKS_PER_DOLLAR = 1e10;
+/**
+* Convert a TanStack ImagePart to the URL string accepted by xAI's Imagine
+* video endpoint: public URLs pass through (fetched by xAI's servers), data
+* sources become base64 data URIs.
+*/
 function imagePartToUrl(part) {
-  if (part.source.type === "url") return part.source.value;
-  return `data:${part.source.mimeType};base64,${part.source.value}`;
+	if (part.source.type === "url") return part.source.value;
+	return `data:${part.source.mimeType};base64,${part.source.value}`;
 }
 function buildGrokVideoUsage(response) {
-  const seconds = response.video?.duration;
-  const ticks = response.usage?.cost_in_usd_ticks;
-  if (seconds === void 0 && ticks === void 0) return void 0;
-  return {
-    promptTokens: 0,
-    completionTokens: 0,
-    totalTokens: 0,
-    ...seconds !== void 0 && { unitsBilled: seconds },
-    ...ticks !== void 0 && { cost: ticks / USD_TICKS_PER_DOLLAR }
-  };
-}
-class GrokVideoAdapter extends BaseVideoAdapter {
-  name = "grok";
-  clientConfig;
-  constructor(config, model) {
-    super({}, model);
-    this.clientConfig = withGrokDefaults(config);
-  }
-  get fetch() {
-    return this.clientConfig.fetch ?? fetch;
-  }
-  async request(path, init) {
-    return await this.fetch(`${this.clientConfig.baseURL}${path}`, {
-      ...init,
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${this.clientConfig.apiKey}`
-      }
-    });
-  }
-  /**
-   * Reads the error message out of an Imagine API error body
-   * (`{"code": "...", "error": "..."}`), falling back to the raw text.
-   */
-  async errorMessage(response) {
-    const body = await response.text();
-    try {
-      const parsed = JSON.parse(body);
-      if (typeof parsed === "object" && parsed !== null && "error" in parsed && typeof parsed.error === "string") {
-        return parsed.error;
-      }
-    } catch {
-    }
-    return body;
-  }
-  async createVideoJob(options) {
-    const { model, size, modelOptions, logger } = options;
-    validateVideoSize(model, size);
-    const rawDuration = modelOptions?.duration ?? options.duration;
-    const duration = rawDuration !== void 0 ? this.snapDuration(rawDuration) : void 0;
-    const resolved = resolveMediaPrompt(options.prompt);
-    if (resolved.videos.length > 0) {
-      throw new Error(
-        `${this.name}.createVideoJob does not support video prompt parts (model: ${model}).`
-      );
-    }
-    if (resolved.audios.length > 0) {
-      throw new Error(
-        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}).`
-      );
-    }
-    if (resolved.images.length === 0 && isImageToVideoOnlyModel(model)) {
-      throw new Error(
-        `${this.name}: ${model} does not support text-to-video — it is image-to-video only. Include an image prompt part as the starting frame, or use 'grok-imagine-video' for text-to-video.`
-      );
-    }
-    if (resolved.images.length > 1) {
-      throw new Error(
-        `${this.name}: ${model} accepts at most one starting-frame image; received ${resolved.images.length}.`
-      );
-    }
-    const [startFrame] = resolved.images;
-    const parsedSize = size !== void 0 ? parseGrokVideoSize(size) : void 0;
-    const request = {
-      model,
-      prompt: resolved.text,
-      ...startFrame && { image: { url: imagePartToUrl(startFrame) } },
-      ...parsedSize && {
-        aspect_ratio: parsedSize.aspectRatio,
-        ...parsedSize.resolution !== void 0 && {
-          resolution: parsedSize.resolution
-        }
-      },
-      ...modelOptions,
-      // Spread after modelOptions so the snapped duration is authoritative
-      // (modelOptions.duration is folded into `duration` via snapDuration above).
-      ...duration !== void 0 && { duration }
-    };
-    try {
-      logger.request(
-        `activity=video.create provider=${this.name} model=${model} size=${size ?? "default"} duration=${duration ?? "default"}`,
-        { provider: this.name, model }
-      );
-      const response = await this.request("/videos/generations", {
-        method: "POST",
-        body: JSON.stringify(request)
-      });
-      if (!response.ok) {
-        throw new Error(
-          `grok: video generation request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`
-        );
-      }
-      const result = await response.json();
-      if (!result.request_id) {
-        throw new Error(
-          "grok: video generation response contained no request_id"
-        );
-      }
-      return { jobId: result.request_id, model };
-    } catch (error) {
-      logger.errors(`${this.name}.createVideoJob fatal`, {
-        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),
-        source: `${this.name}.createVideoJob`
-      });
-      throw error;
-    }
-  }
-  async retrieveJob(jobId) {
-    const response = await this.request(`/videos/${jobId}`);
-    if (!response.ok) {
-      const error = new Error(
-        `grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`
-      );
-      error.status = response.status;
-      throw error;
-    }
-    return await response.json();
-  }
-  async getVideoStatus(jobId) {
-    let response;
-    try {
-      response = await this.retrieveJob(jobId);
-    } catch (error) {
-      if (error.status === 404) {
-        return { jobId, status: "failed", error: "Job not found" };
-      }
-      throw error;
-    }
-    return {
-      jobId,
-      status: this.mapStatus(response.status),
-      ...response.progress !== void 0 && { progress: response.progress },
-      ...response.error !== void 0 && { error: response.error }
-    };
-  }
-  async getVideoUrl(jobId) {
-    let response;
-    try {
-      response = await this.retrieveJob(jobId);
-    } catch (error) {
-      if (error.status === 404) {
-        throw new Error(`Video job not found: ${jobId}`);
-      }
-      throw error;
-    }
-    const status = this.mapStatus(response.status);
-    if (status === "failed") {
-      throw new Error(
-        `Video generation failed${response.error ? `: ${response.error}` : ""}. Job ID: ${jobId}`
-      );
-    }
-    const url = response.video?.url;
-    if (!url) {
-      throw new Error(
-        `Video is not ready for download. Check status first. Job ID: ${jobId}`
-      );
-    }
-    const usage = buildGrokVideoUsage(response);
-    return {
-      jobId,
-      url,
-      ...usage && { usage }
-    };
-  }
-  /**
-   * Maps Imagine API job statuses onto the generic video status set. The
-   * API reports 'pending' while queued/generating (with a numeric
-   * `progress`), then a terminal 'done' / 'failed' / 'expired'.
-   */
-  mapStatus(apiStatus) {
-    switch (apiStatus) {
-      case "pending":
-      case "queued":
-        return "pending";
-      case "done":
-      case "completed":
-      case "succeeded":
-        return "completed";
-      case "failed":
-      case "expired":
-      case "error":
-      case "cancelled":
-        return "failed";
-      case void 0:
-      default:
-        return "processing";
-    }
-  }
-  /**
-   * Both grok-imagine video models accept a continuous 1–15 integer-second
-   * range. Consumers can use this to render UI without provider knowledge.
-   */
-  availableDurations() {
-    return getGrokVideoDurationOptions(this.model);
-  }
-  /**
-   * Coerce a raw seconds value to the closest valid duration (clamped to
-   * [1, 15] and rounded to whole seconds).
-   */
-  snapDuration(seconds) {
-    return snapToDurationOption(seconds, this.availableDurations());
-  }
+	const seconds = response.video?.duration;
+	const ticks = response.usage?.cost_in_usd_ticks;
+	if (seconds === void 0 && ticks === void 0) return void 0;
+	return {
+		promptTokens: 0,
+		completionTokens: 0,
+		totalTokens: 0,
+		...seconds !== void 0 && { unitsBilled: seconds },
+		...ticks !== void 0 && { cost: ticks / USD_TICKS_PER_DOLLAR }
+	};
 }
+/**
+* Grok Video Generation Adapter (xAI Imagine API)
+*
+* Tree-shakeable adapter for the grok-imagine video models using the
+* async jobs/polling architecture: create a generation request, poll it,
+* then read the completed video URL.
+*
+* `grok-imagine-video` (v1.0) supports text-to-video and image-to-video.
+* `grok-imagine-video-1.5` is image-to-video only — every request needs an
+* image prompt part as the starting frame, and the adapter rejects a
+* text-only prompt with a clear error rather than a raw API 400.
+*
+* The Imagine video endpoints are not part of the OpenAI SDK surface (and
+* xAI rejects the SDK's multipart paths), so requests are plain JSON calls
+* issued with the configured `fetch` (or the global one).
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* Features:
+* - Async job-based video generation (1–15 second clips with audio)
+* - Aspect-ratio sizing via the "aspectRatio_resolution" size template
+*   (e.g. '16:9_720p'), consistent with the grok-imagine image models
+* - Image-to-video via an `image` prompt part (starting frame URL or data URI)
+* - Usage reporting: billed seconds (`unitsBilled`) and exact cost
+*/
+var GrokVideoAdapter = class extends BaseVideoAdapter {
+	name = "grok";
+	clientConfig;
+	constructor(config, model) {
+		super({}, model);
+		this.clientConfig = withGrokDefaults(config);
+	}
+	get fetch() {
+		return this.clientConfig.fetch ?? fetch;
+	}
+	async request(path, init) {
+		return await this.fetch(`${this.clientConfig.baseURL}${path}`, {
+			...init,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this.clientConfig.apiKey}`
+			}
+		});
+	}
+	/**
+	* Reads the error message out of an Imagine API error body
+	* (`{"code": "...", "error": "..."}`), falling back to the raw text.
+	*/
+	async errorMessage(response) {
+		const body = await response.text();
+		try {
+			const parsed = JSON.parse(body);
+			if (typeof parsed === "object" && parsed !== null && "error" in parsed && typeof parsed.error === "string") return parsed.error;
+		} catch {}
+		return body;
+	}
+	async createVideoJob(options) {
+		const { model, size, modelOptions, logger } = options;
+		validateVideoSize(model, size);
+		const rawDuration = modelOptions?.duration ?? options.duration;
+		const duration = rawDuration !== void 0 ? this.snapDuration(rawDuration) : void 0;
+		const resolved = resolveMediaPrompt(options.prompt);
+		if (resolved.videos.length > 0) throw new Error(`${this.name}.createVideoJob does not support video prompt parts (model: ${model}).`);
+		if (resolved.audios.length > 0) throw new Error(`${this.name}.createVideoJob does not support audio prompt parts (model: ${model}).`);
+		if (resolved.images.length === 0 && isImageToVideoOnlyModel(model)) throw new Error(`${this.name}: ${model} does not support text-to-video — it is image-to-video only. Include an image prompt part as the starting frame, or use 'grok-imagine-video' for text-to-video.`);
+		if (resolved.images.length > 1) throw new Error(`${this.name}: ${model} accepts at most one starting-frame image; received ${resolved.images.length}.`);
+		const [startFrame] = resolved.images;
+		const parsedSize = size !== void 0 ? parseGrokVideoSize(size) : void 0;
+		const request = {
+			model,
+			prompt: resolved.text,
+			...startFrame && { image: { url: imagePartToUrl(startFrame) } },
+			...parsedSize && {
+				aspect_ratio: parsedSize.aspectRatio,
+				...parsedSize.resolution !== void 0 && { resolution: parsedSize.resolution }
+			},
+			...modelOptions,
+			...duration !== void 0 && { duration }
+		};
+		try {
+			logger.request(`activity=video.create provider=${this.name} model=${model} size=${size ?? "default"} duration=${duration ?? "default"}`, {
+				provider: this.name,
+				model
+			});
+			const response = await this.request("/videos/generations", {
+				method: "POST",
+				body: JSON.stringify(request)
+			});
+			if (!response.ok) throw new Error(`grok: video generation request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`);
+			const result = await response.json();
+			if (!result.request_id) throw new Error("grok: video generation response contained no request_id");
+			return {
+				jobId: result.request_id,
+				model
+			};
+		} catch (error) {
+			logger.errors(`${this.name}.createVideoJob fatal`, {
+				error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),
+				source: `${this.name}.createVideoJob`
+			});
+			throw error;
+		}
+	}
+	async retrieveJob(jobId) {
+		const response = await this.request(`/videos/${jobId}`);
+		if (!response.ok) {
+			const error = /* @__PURE__ */ new Error(`grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`);
+			error.status = response.status;
+			throw error;
+		}
+		return await response.json();
+	}
+	async getVideoStatus(jobId) {
+		let response;
+		try {
+			response = await this.retrieveJob(jobId);
+		} catch (error) {
+			if (error.status === 404) return {
+				jobId,
+				status: "failed",
+				error: "Job not found"
+			};
+			throw error;
+		}
+		return {
+			jobId,
+			status: this.mapStatus(response.status),
+			...response.progress !== void 0 && { progress: response.progress },
+			...response.error !== void 0 && { error: response.error }
+		};
+	}
+	async getVideoUrl(jobId) {
+		let response;
+		try {
+			response = await this.retrieveJob(jobId);
+		} catch (error) {
+			if (error.status === 404) throw new Error(`Video job not found: ${jobId}`);
+			throw error;
+		}
+		if (this.mapStatus(response.status) === "failed") throw new Error(`Video generation failed${response.error ? `: ${response.error}` : ""}. Job ID: ${jobId}`);
+		const url = response.video?.url;
+		if (!url) throw new Error(`Video is not ready for download. Check status first. Job ID: ${jobId}`);
+		const usage = buildGrokVideoUsage(response);
+		return {
+			jobId,
+			url,
+			...usage && { usage }
+		};
+	}
+	/**
+	* Maps Imagine API job statuses onto the generic video status set. The
+	* API reports 'pending' while queued/generating (with a numeric
+	* `progress`), then a terminal 'done' / 'failed' / 'expired'.
+	*/
+	mapStatus(apiStatus) {
+		switch (apiStatus) {
+			case "pending":
+			case "queued": return "pending";
+			case "done":
+			case "completed":
+			case "succeeded": return "completed";
+			case "failed":
+			case "expired":
+			case "error":
+			case "cancelled": return "failed";
+			case void 0:
+			default: return "processing";
+		}
+	}
+	/**
+	* Both grok-imagine video models accept a continuous 1–15 integer-second
+	* range. Consumers can use this to render UI without provider knowledge.
+	*/
+	availableDurations() {
+		return getGrokVideoDurationOptions(this.model);
+	}
+	/**
+	* Coerce a raw seconds value to the closest valid duration (clamped to
+	* [1, 15] and rounded to whole seconds).
+	*/
+	snapDuration(seconds) {
+		return snapToDurationOption(seconds, this.availableDurations());
+	}
+};
+/**
+* Creates a Grok video adapter with an explicit API key.
+* Type resolution happens here at the call site.
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* @param model - The model name (e.g., 'grok-imagine-video')
+* @param apiKey - Your xAI API key
+* @param config - Optional additional configuration
+* @returns Configured Grok video adapter instance with resolved types
+*
+* @example
+* ```typescript
+* // grok-imagine-video (v1.0) supports text-to-video.
+* const adapter = createGrokVideo('grok-imagine-video', 'xai-...');
+*
+* const { jobId } = await generateVideo({
+*   adapter,
+*   prompt: 'A beautiful sunset over the ocean',
+*   size: '16:9_720p',
+*   duration: 5
+* });
+* ```
+*/
 function createGrokVideo(model, apiKey, config) {
-  return new GrokVideoAdapter({ apiKey, ...config }, model);
+	return new GrokVideoAdapter({
+		apiKey,
+		...config
+	}, model);
 }
+/**
+* Creates a Grok video adapter with automatic API key detection from environment variables.
+* Type resolution happens here at the call site.
+*
+* Looks for `XAI_API_KEY` in:
+* - `process.env` (Node.js)
+* - `window.env` (Browser with injected env)
+*
+* @experimental Video generation is an experimental feature and may change.
+*
+* @param model - The model name (e.g., 'grok-imagine-video-1.5')
+* @param config - Optional configuration (excluding apiKey which is auto-detected)
+* @returns Configured Grok video adapter instance with resolved types
+* @throws Error if XAI_API_KEY is not found in environment
+*
+* @example
+* ```typescript
+* // Automatically uses XAI_API_KEY from environment
+* const adapter = grokVideo('grok-imagine-video-1.5');
+*
+* // Image-to-video only: the prompt must carry a starting-frame image part.
+* const { jobId } = await generateVideo({
+*   adapter,
+*   prompt: [
+*     { type: 'text', content: 'Make the cat start playing the piano' },
+*     { type: 'image', source: { type: 'url', value: 'https://example.com/cat.png' } },
+*   ],
+* });
+*
+* // Poll for status
+* const status = await getVideoJobStatus({ adapter, jobId });
+* ```
+*/
 function grokVideo(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokVideo(model, apiKey, config);
+	return createGrokVideo(model, getGrokApiKeyFromEnv(), config);
 }
-export {
-  GrokVideoAdapter,
-  createGrokVideo,
-  grokVideo
-};
-//# sourceMappingURL=video.js.map
+//#endregion
+export { GrokVideoAdapter, createGrokVideo, grokVideo };
+
+//# sourceMappingURL=video.js.map

package/dist/esm/adapters/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  getGrokVideoDurationOptions,\n  isImageToVideoOnlyModel,\n  parseGrokVideoSize,\n  validateVideoSize,\n} from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  ImagePart,\n  MediaInputMetadata,\n  TokenUsage,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type { GrokVideoModel } from '../model-meta'\nimport type {\n  GrokVideoModelDurationByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoProviderOptions,\n} from '../video/video-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GrokVideoConfig extends GrokClientConfig {}\n\n/**\n * xAI bills video generation in \"USD ticks\": 10^10 ticks per US dollar\n * (e.g. one grok-imagine-video-1.5 second costs $0.08 = 800_000_000 ticks).\n */\nconst USD_TICKS_PER_DOLLAR = 10_000_000_000\n\n/** Response of POST /v1/videos/generations. */\ninterface GrokVideoCreateResponse {\n  request_id?: string\n}\n\n/** Response of GET /v1/videos/{request_id}. */\ninterface GrokVideoStatusResponse {\n  status?: string\n  progress?: number\n  model?: string\n  video?: {\n    url?: string\n    duration?: number\n  }\n  usage?: {\n    cost_in_usd_ticks?: number\n  }\n  error?: string\n}\n\n/**\n * Convert a TanStack ImagePart to the URL string accepted by xAI's Imagine\n * video endpoint: public URLs pass through (fetched by xAI's servers), data\n * sources become base64 data URIs.\n */\nfunction imagePartToUrl(part: ImagePart<MediaInputMetadata>): string {\n  if (part.source.type === 'url') return part.source.value\n  return `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\nfunction buildGrokVideoUsage(\n  response: GrokVideoStatusResponse,\n): TokenUsage | undefined {\n  const seconds = response.video?.duration\n  const ticks = response.usage?.cost_in_usd_ticks\n  if (seconds === undefined && ticks === undefined) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    ...(seconds !== undefined && { unitsBilled: seconds }),\n    ...(ticks !== undefined && { cost: ticks / USD_TICKS_PER_DOLLAR }),\n  }\n}\n\n/**\n * Grok Video Generation Adapter (xAI Imagine API)\n *\n * Tree-shakeable adapter for the grok-imagine video models using the\n * async jobs/polling architecture: create a generation request, poll it,\n * then read the completed video URL.\n *\n * `grok-imagine-video` (v1.0) supports text-to-video and image-to-video.\n * `grok-imagine-video-1.5` is image-to-video only — every request needs an\n * image prompt part as the starting frame, and the adapter rejects a\n * text-only prompt with a clear error rather than a raw API 400.\n *\n * The Imagine video endpoints are not part of the OpenAI SDK surface (and\n * xAI rejects the SDK's multipart paths), so requests are plain JSON calls\n * issued with the configured `fetch` (or the global one).\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * Features:\n * - Async job-based video generation (1–15 second clips with audio)\n * - Aspect-ratio sizing via the \"aspectRatio_resolution\" size template\n *   (e.g. '16:9_720p'), consistent with the grok-imagine image models\n * - Image-to-video via an `image` prompt part (starting frame URL or data URI)\n * - Usage reporting: billed seconds (`unitsBilled`) and exact cost\n */\nexport class GrokVideoAdapter<\n  TModel extends GrokVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GrokVideoProviderOptions,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelDurationByName\n> {\n  readonly name = 'grok' as const\n\n  private readonly clientConfig: GrokVideoConfig\n\n  constructor(config: GrokVideoConfig, model: TModel) {\n    super({}, model)\n    this.clientConfig = withGrokDefaults(config)\n  }\n\n  private get fetch(): (\n    input: string,\n    init?: RequestInit,\n  ) => Promise<Response> {\n    return this.clientConfig.fetch ?? fetch\n  }\n\n  private async request(\n    path: string,\n    init?: Omit<RequestInit, 'headers'>,\n  ): Promise<Response> {\n    return await this.fetch(`${this.clientConfig.baseURL}${path}`, {\n      ...init,\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.clientConfig.apiKey}`,\n      },\n    })\n  }\n\n  /**\n   * Reads the error message out of an Imagine API error body\n   * (`{\"code\": \"...\", \"error\": \"...\"}`), falling back to the raw text.\n   */\n  private async errorMessage(response: Response): Promise<string> {\n    const body = await response.text()\n    try {\n      const parsed: unknown = JSON.parse(body)\n      if (\n        typeof parsed === 'object' &&\n        parsed !== null &&\n        'error' in parsed &&\n        typeof parsed.error === 'string'\n      ) {\n        return parsed.error\n      }\n    } catch {\n      // not JSON — fall through to the raw body\n    }\n    return body\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      GrokVideoProviderOptions,\n      GrokVideoModelSizeByName[TModel],\n      GrokVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { model, size, modelOptions, logger } = options\n\n    validateVideoSize(model, size)\n\n    // Coerce the requested duration into the model's valid range (1–15s,\n    // integer) instead of rejecting it — `snapDuration` clamps and rounds.\n    // modelOptions wins over the generic `duration`, mirroring the size\n    // precedence below.\n    const rawDuration = modelOptions?.duration ?? options.duration\n    const duration =\n      rawDuration !== undefined ? this.snapDuration(rawDuration) : undefined\n\n    // The interleaved prompt decomposes into verbatim text plus typed media\n    // buckets. The Imagine video endpoint takes a text prompt and an optional\n    // starting frame; reject the modalities it can't consume.\n    const resolved = resolveMediaPrompt(options.prompt)\n    if (resolved.videos.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support video prompt parts (model: ${model}).`,\n      )\n    }\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}).`,\n      )\n    }\n    // grok-imagine-video-1.5 is image-to-video only — text-to-video is\n    // rejected by the API, so fail fast with a clear, actionable message\n    // pointing at the model that does support text-to-video.\n    if (resolved.images.length === 0 && isImageToVideoOnlyModel(model)) {\n      throw new Error(\n        `${this.name}: ${model} does not support text-to-video — it is image-to-video only. ` +\n          `Include an image prompt part as the starting frame, or use 'grok-imagine-video' for text-to-video.`,\n      )\n    }\n    if (resolved.images.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one starting-frame image; received ${resolved.images.length}.`,\n      )\n    }\n\n    // Image-to-video: the single image prompt part becomes the starting frame\n    // and the prompt text describes the desired motion. URL sources are\n    // fetched by xAI's servers; data sources are sent as base64 data URIs.\n    const [startFrame] = resolved.images\n\n    // The generic `size` option carries an \"aspectRatio_resolution\" template\n    // (e.g. '16:9_720p') and maps to the Imagine API's `aspect_ratio` /\n    // `resolution` parameters; explicit modelOptions win over the template.\n    const parsedSize = size !== undefined ? parseGrokVideoSize(size) : undefined\n    const request = {\n      model,\n      prompt: resolved.text,\n      ...(startFrame && { image: { url: imagePartToUrl(startFrame) } }),\n      ...(parsedSize && {\n        aspect_ratio: parsedSize.aspectRatio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      ...modelOptions,\n      // Spread after modelOptions so the snapped duration is authoritative\n      // (modelOptions.duration is folded into `duration` via snapDuration above).\n      ...(duration !== undefined && { duration }),\n    }\n\n    try {\n      logger.request(\n        `activity=video.create provider=${this.name} model=${model} size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n        { provider: this.name, model },\n      )\n\n      const response = await this.request('/videos/generations', {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw new Error(\n          `grok: video generation request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokVideoCreateResponse\n      if (!result.request_id) {\n        throw new Error(\n          'grok: video generation response contained no request_id',\n        )\n      }\n      return { jobId: result.request_id, model }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  private async retrieveJob(jobId: string): Promise<GrokVideoStatusResponse> {\n    const response = await this.request(`/videos/${jobId}`)\n    if (!response.ok) {\n      const error = new Error(\n        `grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n      )\n      ;(error as { status?: number }).status = response.status\n      throw error\n    }\n    return (await response.json()) as GrokVideoStatusResponse\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        return { jobId, status: 'failed', error: 'Job not found' }\n      }\n      throw error\n    }\n\n    return {\n      jobId,\n      status: this.mapStatus(response.status),\n      ...(response.progress !== undefined && { progress: response.progress }),\n      ...(response.error !== undefined && { error: response.error }),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        throw new Error(`Video job not found: ${jobId}`)\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(response.status)\n    if (status === 'failed') {\n      throw new Error(\n        `Video generation failed${response.error ? `: ${response.error}` : ''}. Job ID: ${jobId}`,\n      )\n    }\n    const url = response.video?.url\n    if (!url) {\n      throw new Error(\n        `Video is not ready for download. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    const usage = buildGrokVideoUsage(response)\n    return {\n      jobId,\n      url,\n      ...(usage && { usage }),\n    }\n  }\n\n  /**\n   * Maps Imagine API job statuses onto the generic video status set. The\n   * API reports 'pending' while queued/generating (with a numeric\n   * `progress`), then a terminal 'done' / 'failed' / 'expired'.\n   */\n  protected mapStatus(\n    apiStatus: string | undefined,\n  ): 'pending' | 'processing' | 'completed' | 'failed' {\n    switch (apiStatus) {\n      case 'pending':\n      case 'queued':\n        return 'pending'\n      case 'done':\n      case 'completed':\n      case 'succeeded':\n        return 'completed'\n      case 'failed':\n      case 'expired':\n      case 'error':\n      case 'cancelled':\n        return 'failed'\n      case undefined:\n      default:\n        return 'processing'\n    }\n  }\n\n  /**\n   * Both grok-imagine video models accept a continuous 1–15 integer-second\n   * range. Consumers can use this to render UI without provider knowledge.\n   */\n  override availableDurations(): DurationOptions<\n    GrokVideoModelDurationByName[TModel]\n  > {\n    return getGrokVideoDurationOptions(this.model)\n  }\n\n  /**\n   * Coerce a raw seconds value to the closest valid duration (clamped to\n   * [1, 15] and rounded to whole seconds).\n   */\n  override snapDuration(\n    seconds: number,\n  ): GrokVideoModelDurationByName[TModel] | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n}\n\n/**\n * Creates a Grok video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * // grok-imagine-video (v1.0) supports text-to-video.\n * const adapter = createGrokVideo('grok-imagine-video', 'xai-...');\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A beautiful sunset over the ocean',\n *   size: '16:9_720p',\n *   duration: 5\n * });\n * ```\n */\nexport function createGrokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  return new GrokVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok video adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok video adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokVideo('grok-imagine-video-1.5');\n *\n * // Image-to-video only: the prompt must carry a starting-frame image part.\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: [\n *     { type: 'text', content: 'Make the cat start playing the piano' },\n *     { type: 'image', source: { type: 'url', value: 'https://example.com/cat.png' } },\n *   ],\n * });\n *\n * // Poll for status\n * const status = await getVideoJobStatus({ adapter, jobId });\n * ```\n */\nexport function grokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokVideo(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  getGrokVideoDurationOptions,\n  isImageToVideoOnlyModel,\n  parseGrokVideoSize,\n  validateVideoSize,\n} from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  ImagePart,\n  MediaInputMetadata,\n  TokenUsage,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type { GrokVideoModel } from '../model-meta'\nimport type {\n  GrokVideoModelDurationByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoProviderOptions,\n} from '../video/video-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GrokVideoConfig extends GrokClientConfig {}\n\n/**\n * xAI bills video generation in \"USD ticks\": 10^10 ticks per US dollar\n * (e.g. one grok-imagine-video-1.5 second costs $0.08 = 800_000_000 ticks).\n */\nconst USD_TICKS_PER_DOLLAR = 10_000_000_000\n\n/** Response of POST /v1/videos/generations. */\ninterface GrokVideoCreateResponse {\n  request_id?: string\n}\n\n/** Response of GET /v1/videos/{request_id}. */\ninterface GrokVideoStatusResponse {\n  status?: string\n  progress?: number\n  model?: string\n  video?: {\n    url?: string\n    duration?: number\n  }\n  usage?: {\n    cost_in_usd_ticks?: number\n  }\n  error?: string\n}\n\n/**\n * Convert a TanStack ImagePart to the URL string accepted by xAI's Imagine\n * video endpoint: public URLs pass through (fetched by xAI's servers), data\n * sources become base64 data URIs.\n */\nfunction imagePartToUrl(part: ImagePart<MediaInputMetadata>): string {\n  if (part.source.type === 'url') return part.source.value\n  return `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\nfunction buildGrokVideoUsage(\n  response: GrokVideoStatusResponse,\n): TokenUsage | undefined {\n  const seconds = response.video?.duration\n  const ticks = response.usage?.cost_in_usd_ticks\n  if (seconds === undefined && ticks === undefined) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    ...(seconds !== undefined && { unitsBilled: seconds }),\n    ...(ticks !== undefined && { cost: ticks / USD_TICKS_PER_DOLLAR }),\n  }\n}\n\n/**\n * Grok Video Generation Adapter (xAI Imagine API)\n *\n * Tree-shakeable adapter for the grok-imagine video models using the\n * async jobs/polling architecture: create a generation request, poll it,\n * then read the completed video URL.\n *\n * `grok-imagine-video` (v1.0) supports text-to-video and image-to-video.\n * `grok-imagine-video-1.5` is image-to-video only — every request needs an\n * image prompt part as the starting frame, and the adapter rejects a\n * text-only prompt with a clear error rather than a raw API 400.\n *\n * The Imagine video endpoints are not part of the OpenAI SDK surface (and\n * xAI rejects the SDK's multipart paths), so requests are plain JSON calls\n * issued with the configured `fetch` (or the global one).\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * Features:\n * - Async job-based video generation (1–15 second clips with audio)\n * - Aspect-ratio sizing via the \"aspectRatio_resolution\" size template\n *   (e.g. '16:9_720p'), consistent with the grok-imagine image models\n * - Image-to-video via an `image` prompt part (starting frame URL or data URI)\n * - Usage reporting: billed seconds (`unitsBilled`) and exact cost\n */\nexport class GrokVideoAdapter<\n  TModel extends GrokVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GrokVideoProviderOptions,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelDurationByName\n> {\n  readonly name = 'grok' as const\n\n  private readonly clientConfig: GrokVideoConfig\n\n  constructor(config: GrokVideoConfig, model: TModel) {\n    super({}, model)\n    this.clientConfig = withGrokDefaults(config)\n  }\n\n  private get fetch(): (\n    input: string,\n    init?: RequestInit,\n  ) => Promise<Response> {\n    return this.clientConfig.fetch ?? fetch\n  }\n\n  private async request(\n    path: string,\n    init?: Omit<RequestInit, 'headers'>,\n  ): Promise<Response> {\n    return await this.fetch(`${this.clientConfig.baseURL}${path}`, {\n      ...init,\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.clientConfig.apiKey}`,\n      },\n    })\n  }\n\n  /**\n   * Reads the error message out of an Imagine API error body\n   * (`{\"code\": \"...\", \"error\": \"...\"}`), falling back to the raw text.\n   */\n  private async errorMessage(response: Response): Promise<string> {\n    const body = await response.text()\n    try {\n      const parsed: unknown = JSON.parse(body)\n      if (\n        typeof parsed === 'object' &&\n        parsed !== null &&\n        'error' in parsed &&\n        typeof parsed.error === 'string'\n      ) {\n        return parsed.error\n      }\n    } catch {\n      // not JSON — fall through to the raw body\n    }\n    return body\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      GrokVideoProviderOptions,\n      GrokVideoModelSizeByName[TModel],\n      GrokVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { model, size, modelOptions, logger } = options\n\n    validateVideoSize(model, size)\n\n    // Coerce the requested duration into the model's valid range (1–15s,\n    // integer) instead of rejecting it — `snapDuration` clamps and rounds.\n    // modelOptions wins over the generic `duration`, mirroring the size\n    // precedence below.\n    const rawDuration = modelOptions?.duration ?? options.duration\n    const duration =\n      rawDuration !== undefined ? this.snapDuration(rawDuration) : undefined\n\n    // The interleaved prompt decomposes into verbatim text plus typed media\n    // buckets. The Imagine video endpoint takes a text prompt and an optional\n    // starting frame; reject the modalities it can't consume.\n    const resolved = resolveMediaPrompt(options.prompt)\n    if (resolved.videos.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support video prompt parts (model: ${model}).`,\n      )\n    }\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}).`,\n      )\n    }\n    // grok-imagine-video-1.5 is image-to-video only — text-to-video is\n    // rejected by the API, so fail fast with a clear, actionable message\n    // pointing at the model that does support text-to-video.\n    if (resolved.images.length === 0 && isImageToVideoOnlyModel(model)) {\n      throw new Error(\n        `${this.name}: ${model} does not support text-to-video — it is image-to-video only. ` +\n          `Include an image prompt part as the starting frame, or use 'grok-imagine-video' for text-to-video.`,\n      )\n    }\n    if (resolved.images.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one starting-frame image; received ${resolved.images.length}.`,\n      )\n    }\n\n    // Image-to-video: the single image prompt part becomes the starting frame\n    // and the prompt text describes the desired motion. URL sources are\n    // fetched by xAI's servers; data sources are sent as base64 data URIs.\n    const [startFrame] = resolved.images\n\n    // The generic `size` option carries an \"aspectRatio_resolution\" template\n    // (e.g. '16:9_720p') and maps to the Imagine API's `aspect_ratio` /\n    // `resolution` parameters; explicit modelOptions win over the template.\n    const parsedSize = size !== undefined ? parseGrokVideoSize(size) : undefined\n    const request = {\n      model,\n      prompt: resolved.text,\n      ...(startFrame && { image: { url: imagePartToUrl(startFrame) } }),\n      ...(parsedSize && {\n        aspect_ratio: parsedSize.aspectRatio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      ...modelOptions,\n      // Spread after modelOptions so the snapped duration is authoritative\n      // (modelOptions.duration is folded into `duration` via snapDuration above).\n      ...(duration !== undefined && { duration }),\n    }\n\n    try {\n      logger.request(\n        `activity=video.create provider=${this.name} model=${model} size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n        { provider: this.name, model },\n      )\n\n      const response = await this.request('/videos/generations', {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw new Error(\n          `grok: video generation request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokVideoCreateResponse\n      if (!result.request_id) {\n        throw new Error(\n          'grok: video generation response contained no request_id',\n        )\n      }\n      return { jobId: result.request_id, model }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  private async retrieveJob(jobId: string): Promise<GrokVideoStatusResponse> {\n    const response = await this.request(`/videos/${jobId}`)\n    if (!response.ok) {\n      const error = new Error(\n        `grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n      )\n      ;(error as { status?: number }).status = response.status\n      throw error\n    }\n    return (await response.json()) as GrokVideoStatusResponse\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        return { jobId, status: 'failed', error: 'Job not found' }\n      }\n      throw error\n    }\n\n    return {\n      jobId,\n      status: this.mapStatus(response.status),\n      ...(response.progress !== undefined && { progress: response.progress }),\n      ...(response.error !== undefined && { error: response.error }),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        throw new Error(`Video job not found: ${jobId}`)\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(response.status)\n    if (status === 'failed') {\n      throw new Error(\n        `Video generation failed${response.error ? `: ${response.error}` : ''}. Job ID: ${jobId}`,\n      )\n    }\n    const url = response.video?.url\n    if (!url) {\n      throw new Error(\n        `Video is not ready for download. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    const usage = buildGrokVideoUsage(response)\n    return {\n      jobId,\n      url,\n      ...(usage && { usage }),\n    }\n  }\n\n  /**\n   * Maps Imagine API job statuses onto the generic video status set. The\n   * API reports 'pending' while queued/generating (with a numeric\n   * `progress`), then a terminal 'done' / 'failed' / 'expired'.\n   */\n  protected mapStatus(\n    apiStatus: string | undefined,\n  ): 'pending' | 'processing' | 'completed' | 'failed' {\n    switch (apiStatus) {\n      case 'pending':\n      case 'queued':\n        return 'pending'\n      case 'done':\n      case 'completed':\n      case 'succeeded':\n        return 'completed'\n      case 'failed':\n      case 'expired':\n      case 'error':\n      case 'cancelled':\n        return 'failed'\n      case undefined:\n      default:\n        return 'processing'\n    }\n  }\n\n  /**\n   * Both grok-imagine video models accept a continuous 1–15 integer-second\n   * range. Consumers can use this to render UI without provider knowledge.\n   */\n  override availableDurations(): DurationOptions<\n    GrokVideoModelDurationByName[TModel]\n  > {\n    return getGrokVideoDurationOptions(this.model)\n  }\n\n  /**\n   * Coerce a raw seconds value to the closest valid duration (clamped to\n   * [1, 15] and rounded to whole seconds).\n   */\n  override snapDuration(\n    seconds: number,\n  ): GrokVideoModelDurationByName[TModel] | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n}\n\n/**\n * Creates a Grok video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * // grok-imagine-video (v1.0) supports text-to-video.\n * const adapter = createGrokVideo('grok-imagine-video', 'xai-...');\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A beautiful sunset over the ocean',\n *   size: '16:9_720p',\n *   duration: 5\n * });\n * ```\n */\nexport function createGrokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  return new GrokVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok video adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok video adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokVideo('grok-imagine-video-1.5');\n *\n * // Image-to-video only: the prompt must carry a starting-frame image part.\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: [\n *     { type: 'text', content: 'Make the cat start playing the piano' },\n *     { type: 'image', source: { type: 'url', value: 'https://example.com/cat.png' } },\n *   ],\n * });\n *\n * // Poll for status\n * const status = await getVideoJobStatus({ adapter, jobId });\n * ```\n */\nexport function grokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokVideo(model, apiKey, config)\n}\n"],"mappings":"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"}