@tanstack/ai-grok 0.14.11 → 0.15.0

package/dist/esm/adapters/image.js

@@ -62,7 +62,7 @@ var GrokImageAdapter = class extends BaseImageAdapter {
 		const prompt = resolved.text;
 		if (resolved.videos.length > 0 || resolved.audios.length > 0) throw new Error(`grok.generateImages does not support video / audio prompt parts on model ${model}.`);
 		if (resolved.images.length > 0) {
-			if (!isGrokImagineImageModel(model)) throw new Error(`grok: model "${model}" does not support image prompt parts. Image-conditioned generation requires an Imagine API model ('grok-imagine-image' or 'grok-imagine-image-quality').`);
+			if (!isGrokImagineImageModel(model)) throw new Error(`grok: model "${model}" does not support image prompt parts. Image-conditioned generation requires an Imagine API model ('grok-imagine-image', 'grok-imagine-image-2.0' or 'grok-imagine-image-quality').`);
 			return await this.editImages(options, resolved);
 		}
 		validatePrompt({

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","names":[],"sources":["../../../src/adapters/image.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { buildImagesUsage } from '@tanstack/openai-base'\nimport { generateId } from '@tanstack/ai-utils'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  isGrokImagineImageModel,\n  parseGrokImagineSize,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ImagePart,\n  MediaInputMetadata,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GrokImageModel } from '../model-meta'\nimport type {\n  GrokImageModelInputModalitiesByName,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageProviderOptions,\n} from '../image/image-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok image adapter\n */\nexport interface GrokImageConfig extends GrokClientConfig {}\n\n/** Maximum source images accepted by xAI's image edit endpoint. */\nconst MAX_EDIT_IMAGES = 3\n\n/**\n * Maps the generic `size` option onto Imagine API parameters: the\n * \"aspectRatio_resolution\" template (\"16:9_2k\") splits into `aspect_ratio`\n * and optional `resolution` request fields.\n */\nfunction imagineSizeParams(size: string | undefined): {\n  aspect_ratio?: string\n  resolution?: string\n} {\n  if (!size) return {}\n  const parsed = parseGrokImagineSize(size)\n  if (!parsed) return {}\n  return {\n    aspect_ratio: parsed.aspectRatio,\n    ...(parsed.resolution !== undefined && { resolution: parsed.resolution }),\n  }\n}\n\n/**\n * Convert a TanStack ImagePart to the URL string accepted by xAI's edit\n * 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\n/** Response shape of xAI's `/v1/images/edits` endpoint. */\ninterface GrokImageEditResponse {\n  data?: Array<{\n    url?: string | null\n    b64_json?: string | null\n    mime_type?: string\n  }>\n}\n\n/**\n * Grok Image Generation Adapter\n *\n * Tree-shakeable adapter for Grok image generation functionality.\n * Supports the legacy grok-2-image-1212 model (text-to-image via the\n * OpenAI-compat endpoint) and the grok-imagine image models, which also\n * accept image prompt parts for image-conditioned generation via xAI's\n * `/v1/images/edits` endpoint (up to 3 source images).\n *\n * Features:\n * - Model-specific type-safe provider options\n * - Size / aspect-ratio validation per model\n * - Number of images validation\n */\nexport class GrokImageAdapter<\n  TModel extends GrokImageModel,\n> extends BaseImageAdapter<\n  TModel,\n  GrokImageProviderOptions,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageModelInputModalitiesByName\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'grok' as const\n\n  protected client: OpenAI\n  private readonly clientConfig: GrokImageConfig\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(model, {})\n    this.clientConfig = withGrokDefaults(config)\n    this.client = new OpenAI(this.clientConfig)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions } = options\n\n    const resolved = resolveMediaPrompt(options.prompt)\n    const prompt = resolved.text\n\n    if (resolved.videos.length > 0 || resolved.audios.length > 0) {\n      throw new Error(\n        `grok.generateImages does not support video / audio prompt parts on model ${model}.`,\n      )\n    }\n\n    if (resolved.images.length > 0) {\n      if (!isGrokImagineImageModel(model)) {\n        throw new Error(\n          `grok: model \"${model}\" does not support image prompt parts. ` +\n            `Image-conditioned generation requires an Imagine API model ` +\n            `('grok-imagine-image' or 'grok-imagine-image-quality').`,\n        )\n      }\n      return await this.editImages(options, resolved)\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    // grok-imagine models are aspect-ratio sized: the generic `size` option\n    // carries an \"aspectRatio_resolution\" template (e.g. '16:9_2k', like\n    // Gemini native image models) and maps to the Imagine API's\n    // `aspect_ratio` / `resolution` parameters instead of OpenAI-style `size`.\n    const isImagine = isGrokImagineImageModel(model)\n    const request = {\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      ...(isImagine\n        ? imagineSizeParams(size)\n        : size !== undefined && {\n            size: size,\n          }),\n      stream: false,\n      ...modelOptions,\n    } as OpenAI_SDK.Images.ImageGenerateParamsNonStreaming\n\n    try {\n      options.logger.request(\n        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.images.generate(request)\n\n      const images: Array<GeneratedImage> = (response.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          const revisedPrompt = item.revised_prompt\n          if (item.b64_json) {\n            return [\n              {\n                b64Json: item.b64_json,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          if (item.url) {\n            return [\n              {\n                url: item.url,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          return []\n        },\n      )\n\n      const usage = buildImagesUsage(response.usage)\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n        ...(usage ? { usage } : {}),\n      }\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.generateImages fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),\n        source: `${this.name}.generateImages`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Image-conditioned generation via xAI's Imagine API.\n   *\n   * The `/v1/images/edits` endpoint takes `application/json` (the OpenAI\n   * SDK's `images.edit()` sends `multipart/form-data`, which xAI rejects),\n   * so this path issues the request directly. One input is sent as\n   * `image: { url }`; multiple inputs (up to 3) as `images: [{ url }, ...]`,\n   * addressed by xAI in the order they are sent. The prompt text is sent\n   * verbatim — no referencing markers are injected.\n   */\n  private async editImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n    resolved: ResolvedMediaPrompt,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions, logger } = options\n    const prompt = resolved.text\n    const imageInputs = resolved.images\n\n    const unsupportedRole = imageInputs.find(\n      (part) =>\n        part.metadata?.role === 'mask' || part.metadata?.role === 'control',\n    )\n    if (unsupportedRole) {\n      throw new Error(\n        `grok: the Imagine API has no ${unsupportedRole.metadata?.role} input; ` +\n          `only source/reference images are supported.`,\n      )\n    }\n    if (imageInputs.length > MAX_EDIT_IMAGES) {\n      throw new Error(\n        `grok: model \"${model}\" accepts at most ${MAX_EDIT_IMAGES} source images; received ${imageInputs.length}.`,\n      )\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    const urls = imageInputs.map((part) => imagePartToUrl(part))\n    const request: Record<string, unknown> = {\n      model,\n      prompt,\n      ...(urls.length === 1\n        ? { image: { url: urls[0] } }\n        : { images: urls.map((url) => ({ url })) }),\n      ...(numberOfImages !== undefined && { n: numberOfImages }),\n      ...imagineSizeParams(size),\n      ...modelOptions,\n    }\n\n    try {\n      logger.request(\n        `activity=image provider=${this.name} model=${model} edit images=${urls.length}`,\n        { provider: this.name, model },\n      )\n\n      const response = await fetch(\n        `${this.clientConfig.baseURL}/images/edits`,\n        {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.clientConfig.apiKey}`,\n          },\n          body: JSON.stringify(request),\n        },\n      )\n      if (!response.ok) {\n        const body = await response.text()\n        throw new Error(\n          `grok: image edit request failed (${response.status} ${response.statusText}): ${body}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokImageEditResponse\n      const images: Array<GeneratedImage> = (result.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          if (item.b64_json) return [{ b64Json: item.b64_json }]\n          if (item.url) return [{ url: item.url }]\n          return []\n        },\n      )\n      if (images.length === 0) {\n        throw new Error('grok: image edit response contained no images')\n      }\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n      }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.generateImages fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),\n        source: `${this.name}.generateImages`,\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Creates a Grok image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokImage('grok-2-image-1212', \"xai-...\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGrokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  return new GrokImageAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok image 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 * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok image 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 = grokImage('grok-2-image-1212');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function grokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokImage(model, apiKey, config)\n}\n"],"mappings":"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"}
+{"version":3,"file":"image.js","names":[],"sources":["../../../src/adapters/image.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { buildImagesUsage } from '@tanstack/openai-base'\nimport { generateId } from '@tanstack/ai-utils'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  isGrokImagineImageModel,\n  parseGrokImagineSize,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ImagePart,\n  MediaInputMetadata,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type OpenAI_SDK from 'openai'\nimport type { GrokImageModel } from '../model-meta'\nimport type {\n  GrokImageModelInputModalitiesByName,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageProviderOptions,\n} from '../image/image-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok image adapter\n */\nexport interface GrokImageConfig extends GrokClientConfig {}\n\n/** Maximum source images accepted by xAI's image edit endpoint. */\nconst MAX_EDIT_IMAGES = 3\n\n/**\n * Maps the generic `size` option onto Imagine API parameters: the\n * \"aspectRatio_resolution\" template (\"16:9_2k\") splits into `aspect_ratio`\n * and optional `resolution` request fields.\n */\nfunction imagineSizeParams(size: string | undefined): {\n  aspect_ratio?: string\n  resolution?: string\n} {\n  if (!size) return {}\n  const parsed = parseGrokImagineSize(size)\n  if (!parsed) return {}\n  return {\n    aspect_ratio: parsed.aspectRatio,\n    ...(parsed.resolution !== undefined && { resolution: parsed.resolution }),\n  }\n}\n\n/**\n * Convert a TanStack ImagePart to the URL string accepted by xAI's edit\n * 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\n/** Response shape of xAI's `/v1/images/edits` endpoint. */\ninterface GrokImageEditResponse {\n  data?: Array<{\n    url?: string | null\n    b64_json?: string | null\n    mime_type?: string\n  }>\n}\n\n/**\n * Grok Image Generation Adapter\n *\n * Tree-shakeable adapter for Grok image generation functionality.\n * Supports the legacy grok-2-image-1212 model (text-to-image via the\n * OpenAI-compat endpoint) and the grok-imagine image models, which also\n * accept image prompt parts for image-conditioned generation via xAI's\n * `/v1/images/edits` endpoint (up to 3 source images).\n *\n * Features:\n * - Model-specific type-safe provider options\n * - Size / aspect-ratio validation per model\n * - Number of images validation\n */\nexport class GrokImageAdapter<\n  TModel extends GrokImageModel,\n> extends BaseImageAdapter<\n  TModel,\n  GrokImageProviderOptions,\n  GrokImageModelProviderOptionsByName,\n  GrokImageModelSizeByName,\n  GrokImageModelInputModalitiesByName\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'grok' as const\n\n  protected client: OpenAI\n  private readonly clientConfig: GrokImageConfig\n\n  constructor(config: GrokImageConfig, model: TModel) {\n    super(model, {})\n    this.clientConfig = withGrokDefaults(config)\n    this.client = new OpenAI(this.clientConfig)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions } = options\n\n    const resolved = resolveMediaPrompt(options.prompt)\n    const prompt = resolved.text\n\n    if (resolved.videos.length > 0 || resolved.audios.length > 0) {\n      throw new Error(\n        `grok.generateImages does not support video / audio prompt parts on model ${model}.`,\n      )\n    }\n\n    if (resolved.images.length > 0) {\n      if (!isGrokImagineImageModel(model)) {\n        throw new Error(\n          `grok: model \"${model}\" does not support image prompt parts. ` +\n            `Image-conditioned generation requires an Imagine API model ` +\n            `('grok-imagine-image', 'grok-imagine-image-2.0' or ` +\n            `'grok-imagine-image-quality').`,\n        )\n      }\n      return await this.editImages(options, resolved)\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    // grok-imagine models are aspect-ratio sized: the generic `size` option\n    // carries an \"aspectRatio_resolution\" template (e.g. '16:9_2k', like\n    // Gemini native image models) and maps to the Imagine API's\n    // `aspect_ratio` / `resolution` parameters instead of OpenAI-style `size`.\n    const isImagine = isGrokImagineImageModel(model)\n    const request = {\n      model,\n      prompt,\n      n: numberOfImages ?? 1,\n      ...(isImagine\n        ? imagineSizeParams(size)\n        : size !== undefined && {\n            size: size,\n          }),\n      stream: false,\n      ...modelOptions,\n    } as OpenAI_SDK.Images.ImageGenerateParamsNonStreaming\n\n    try {\n      options.logger.request(\n        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,\n        { provider: this.name, model },\n      )\n      const response = await this.client.images.generate(request)\n\n      const images: Array<GeneratedImage> = (response.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          const revisedPrompt = item.revised_prompt\n          if (item.b64_json) {\n            return [\n              {\n                b64Json: item.b64_json,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          if (item.url) {\n            return [\n              {\n                url: item.url,\n                ...(revisedPrompt !== undefined && { revisedPrompt }),\n              },\n            ]\n          }\n          return []\n        },\n      )\n\n      const usage = buildImagesUsage(response.usage)\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n        ...(usage ? { usage } : {}),\n      }\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.generateImages fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),\n        source: `${this.name}.generateImages`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Image-conditioned generation via xAI's Imagine API.\n   *\n   * The `/v1/images/edits` endpoint takes `application/json` (the OpenAI\n   * SDK's `images.edit()` sends `multipart/form-data`, which xAI rejects),\n   * so this path issues the request directly. One input is sent as\n   * `image: { url }`; multiple inputs (up to 3) as `images: [{ url }, ...]`,\n   * addressed by xAI in the order they are sent. The prompt text is sent\n   * verbatim — no referencing markers are injected.\n   */\n  private async editImages(\n    options: ImageGenerationOptions<GrokImageProviderOptions>,\n    resolved: ResolvedMediaPrompt,\n  ): Promise<ImageGenerationResult> {\n    const { model, numberOfImages, size, modelOptions, logger } = options\n    const prompt = resolved.text\n    const imageInputs = resolved.images\n\n    const unsupportedRole = imageInputs.find(\n      (part) =>\n        part.metadata?.role === 'mask' || part.metadata?.role === 'control',\n    )\n    if (unsupportedRole) {\n      throw new Error(\n        `grok: the Imagine API has no ${unsupportedRole.metadata?.role} input; ` +\n          `only source/reference images are supported.`,\n      )\n    }\n    if (imageInputs.length > MAX_EDIT_IMAGES) {\n      throw new Error(\n        `grok: model \"${model}\" accepts at most ${MAX_EDIT_IMAGES} source images; received ${imageInputs.length}.`,\n      )\n    }\n\n    validatePrompt({ prompt, model })\n    validateImageSize(model, size)\n    validateNumberOfImages(model, numberOfImages)\n\n    const urls = imageInputs.map((part) => imagePartToUrl(part))\n    const request: Record<string, unknown> = {\n      model,\n      prompt,\n      ...(urls.length === 1\n        ? { image: { url: urls[0] } }\n        : { images: urls.map((url) => ({ url })) }),\n      ...(numberOfImages !== undefined && { n: numberOfImages }),\n      ...imagineSizeParams(size),\n      ...modelOptions,\n    }\n\n    try {\n      logger.request(\n        `activity=image provider=${this.name} model=${model} edit images=${urls.length}`,\n        { provider: this.name, model },\n      )\n\n      const response = await fetch(\n        `${this.clientConfig.baseURL}/images/edits`,\n        {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.clientConfig.apiKey}`,\n          },\n          body: JSON.stringify(request),\n        },\n      )\n      if (!response.ok) {\n        const body = await response.text()\n        throw new Error(\n          `grok: image edit request failed (${response.status} ${response.statusText}): ${body}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokImageEditResponse\n      const images: Array<GeneratedImage> = (result.data ?? []).flatMap(\n        (item): Array<GeneratedImage> => {\n          if (item.b64_json) return [{ b64Json: item.b64_json }]\n          if (item.url) return [{ url: item.url }]\n          return []\n        },\n      )\n      if (images.length === 0) {\n        throw new Error('grok: image edit response contained no images')\n      }\n\n      return {\n        id: generateId(this.name),\n        model,\n        images,\n      }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.generateImages fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),\n        source: `${this.name}.generateImages`,\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Creates a Grok image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokImage('grok-2-image-1212', \"xai-...\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGrokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  return new GrokImageAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok image 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 * @param model - The model name (e.g., 'grok-2-image-1212')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok image 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 = grokImage('grok-2-image-1212');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function grokImage<TModel extends GrokImageModel>(\n  model: TModel,\n  config?: Omit<GrokImageConfig, 'apiKey'>,\n): GrokImageAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokImage(model, apiKey, config)\n}\n"],"mappings":"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"}

package/dist/esm/adapters/tts.js

@@ -48,7 +48,8 @@ var GrokSpeechAdapter = class extends BaseTTSAdapter {
 				const errorText = await response.text();
 				throw new Error(`Grok TTS request failed: ${response.status} ${errorText}`);
 			}
-			const audio = arrayBufferToBase64(await response.arrayBuffer());
+			const arrayBuffer = await response.arrayBuffer();
+			const audio = arrayBufferToBase64(arrayBuffer);
 			return {
 				id: generateId(this.name),
 				model,

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

@@ -1 +1 @@
-{"version":3,"file":"tts.js","names":[],"sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport { arrayBufferToBase64, generateId, getGrokApiKeyFromEnv } from '../utils'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type { GrokTTSModel } from '../model-meta'\nimport type {\n  GrokTTSCodec,\n  GrokTTSProviderOptions,\n} from '../audio/tts-provider-options'\n\nconst DEFAULT_GROK_BASE_URL = 'https://api.x.ai/v1'\n\n/**\n * Configuration for the Grok TTS adapter.\n *\n * Unlike chat/image/summarize adapters, TTS does not use the OpenAI SDK\n * because xAI's `/v1/tts` endpoint is not OpenAI-compatible. This config\n * is a minimal subset suitable for direct `fetch` calls.\n */\nexport interface GrokSpeechConfig {\n  apiKey: string\n  baseURL?: string\n  /** Additional headers to merge into every request (e.g., test IDs). */\n  defaultHeaders?: Record<string, string>\n}\n\n/**\n * Grok Text-to-Speech Adapter.\n *\n * Talks to `POST {baseURL}/tts` per\n * https://docs.x.ai/developers/model-capabilities/audio/text-to-speech\n */\nexport class GrokSpeechAdapter<\n  TModel extends GrokTTSModel,\n> extends BaseTTSAdapter<TModel, GrokTTSProviderOptions> {\n  readonly name = 'grok' as const\n\n  private readonly apiKey: string\n  private readonly baseURL: string\n  private readonly defaultHeaders: Record<string, string>\n\n  constructor(config: GrokSpeechConfig, model: TModel) {\n    super(model, config)\n    this.apiKey = config.apiKey\n    this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\\/+$/, '')\n    this.defaultHeaders = config.defaultHeaders ?? {}\n  }\n\n  async generateSpeech(\n    options: TTSOptions<GrokTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { logger } = options\n    const { model, text, voice, format, modelOptions } = options\n\n    logger.request(`activity=generateSpeech provider=grok model=${model}`, {\n      provider: 'grok',\n      model,\n    })\n\n    const { body, codec, sampleRateForContentType } = buildTTSRequestBody({\n      text,\n      voice,\n      format,\n      modelOptions,\n    })\n\n    try {\n      const response = await fetch(`${this.baseURL}/tts`, {\n        method: 'POST',\n        headers: {\n          // `defaultHeaders` first so the adapter's Authorization / Content-Type\n          // always win — otherwise a caller-supplied `Authorization` header\n          // could silently clobber the bearer token.\n          ...this.defaultHeaders,\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(body),\n      })\n\n      if (!response.ok) {\n        const errorText = await response.text()\n        throw new Error(\n          `Grok TTS request failed: ${response.status} ${errorText}`,\n        )\n      }\n\n      const arrayBuffer = await response.arrayBuffer()\n      const audio = arrayBufferToBase64(arrayBuffer)\n\n      return {\n        id: generateId(this.name),\n        model,\n        audio,\n        format: codec,\n        contentType: getContentType(codec, sampleRateForContentType),\n      }\n    } catch (error) {\n      logger.errors('grok.generateSpeech fatal', {\n        error,\n        source: 'grok.generateSpeech',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Build the JSON body for `POST /v1/tts`, resolving codec / sample-rate / voice\n * defaults in one place.\n *\n * Returns the request `body`, the resolved `codec`, and the `sampleRateForContentType`\n * used by the caller to label the response via `getContentType`.\n */\nexport function buildTTSRequestBody(options: {\n  text: string\n  voice: string | undefined\n  format: TTSOptions['format'] | undefined\n  modelOptions: GrokTTSProviderOptions | undefined\n}): {\n  body: Record<string, unknown>\n  codec: GrokTTSCodec\n  sampleRateForContentType: number\n} {\n  const { text, voice, format, modelOptions } = options\n\n  const codec = pickCodec(modelOptions?.codec, format)\n\n  // Only forward `sample_rate` when either:\n  //   - the caller explicitly set `modelOptions.sample_rate`, or\n  //   - the codec's Content-Type carries the rate (pcm → audio/L16;rate=…).\n  // For mp3/wav/opus/aac/flac we leave sample_rate unset so xAI's server\n  // default applies.\n  const callerSampleRate = modelOptions?.sample_rate\n  // Default sample rate documented in GrokTTSProviderOptions is 24000 Hz —\n  // used only when we MUST attach a rate to the contentType (pcm) and the\n  // caller didn't pick one.\n  const pcmDefault = 24000\n  const needsRateInContentType = codec === 'pcm'\n\n  const outputFormat: Record<string, unknown> = { codec }\n  if (callerSampleRate !== undefined) {\n    outputFormat.sample_rate = callerSampleRate\n  } else if (needsRateInContentType) {\n    outputFormat.sample_rate = pcmDefault\n  }\n  if (codec === 'mp3' && modelOptions?.bit_rate !== undefined) {\n    outputFormat.bit_rate = modelOptions.bit_rate\n  }\n\n  // pcm embeds the rate in `audio/L16;rate=…`; mulaw/alaw embed it in\n  // `audio/PCMU;rate=…` / `audio/PCMA;rate=…` when non-default. mp3/wav\n  // don't carry a rate parameter so the value is unused for those.\n  const sampleRateForContentType = callerSampleRate ?? pcmDefault\n\n  const body: Record<string, unknown> = {\n    text,\n    voice_id: voice ?? 'eve',\n    language: modelOptions?.language ?? 'en',\n    output_format: outputFormat,\n  }\n  if (modelOptions?.optimize_streaming_latency !== undefined) {\n    body.optimize_streaming_latency = modelOptions.optimize_streaming_latency\n  }\n  if (modelOptions?.text_normalization !== undefined) {\n    body.text_normalization = modelOptions.text_normalization\n  }\n\n  return { body, codec, sampleRateForContentType }\n}\n\n/**\n * Maps the cross-provider `TTSOptions.format` onto Grok's supported codecs.\n * `opus`, `aac`, and `flac` are not supported by xAI TTS (which only exposes\n * mp3/wav/pcm/mulaw/alaw) — we fall back to mp3. An explicit\n * `modelOptions.codec` always wins.\n */\nfunction pickCodec(\n  codecOverride: GrokTTSCodec | undefined,\n  format: TTSOptions['format'] | undefined,\n): GrokTTSCodec {\n  if (codecOverride) return codecOverride\n  if (!format) return 'mp3'\n  switch (format) {\n    case 'mp3':\n    case 'wav':\n    case 'pcm':\n      return format\n    case 'flac':\n    case 'opus':\n    case 'aac':\n      return 'mp3'\n    default:\n      return 'mp3'\n  }\n}\n\nexport function getContentType(\n  codec: GrokTTSCodec,\n  sampleRate: number,\n): string {\n  switch (codec) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'pcm':\n      // `audio/L16` requires a `rate` parameter per RFC 3551/3555.\n      return `audio/L16;rate=${sampleRate}`\n    case 'mulaw':\n      // `audio/basic` is 8 kHz mono by RFC 2046 registration. For non-8kHz\n      // streams xAI still produces mulaw-encoded bytes at the requested\n      // rate, but the registered MIME can't carry that rate — so we use\n      // the non-standard but commonly-supported `audio/PCMU;rate=…` (RFC 3551\n      // RTP payload name) whenever the caller asked for a rate other than\n      // 8000, and keep `audio/basic` for the standard 8kHz case.\n      return sampleRate === 8000\n        ? 'audio/basic'\n        : `audio/PCMU;rate=${sampleRate}`\n    case 'alaw':\n      return sampleRate === 8000\n        ? 'audio/x-alaw-basic'\n        : `audio/PCMA;rate=${sampleRate}`\n  }\n}\n\n/**\n * Creates a Grok speech (TTS) adapter with an explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createGrokSpeech('grok-tts', 'xai-...')\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello from Grok',\n *   voice: 'eve',\n * })\n * ```\n */\nexport function createGrokSpeech<TModel extends GrokTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokSpeechConfig, 'apiKey'>,\n): GrokSpeechAdapter<TModel> {\n  return new GrokSpeechAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok speech (TTS) adapter, reading the API key from\n * `XAI_API_KEY` in the environment.\n *\n * @throws Error if `XAI_API_KEY` is not set.\n */\nexport function grokSpeech<TModel extends GrokTTSModel>(\n  model: TModel,\n  config?: Omit<GrokSpeechConfig, 'apiKey'>,\n): GrokSpeechAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokSpeech(model, apiKey, config)\n}\n"],"mappings":"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"}
+{"version":3,"file":"tts.js","names":[],"sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport { arrayBufferToBase64, generateId, getGrokApiKeyFromEnv } from '../utils'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type { GrokTTSModel } from '../model-meta'\nimport type {\n  GrokTTSCodec,\n  GrokTTSProviderOptions,\n} from '../audio/tts-provider-options'\n\nconst DEFAULT_GROK_BASE_URL = 'https://api.x.ai/v1'\n\n/**\n * Configuration for the Grok TTS adapter.\n *\n * Unlike chat/image/summarize adapters, TTS does not use the OpenAI SDK\n * because xAI's `/v1/tts` endpoint is not OpenAI-compatible. This config\n * is a minimal subset suitable for direct `fetch` calls.\n */\nexport interface GrokSpeechConfig {\n  apiKey: string\n  baseURL?: string\n  /** Additional headers to merge into every request (e.g., test IDs). */\n  defaultHeaders?: Record<string, string>\n}\n\n/**\n * Grok Text-to-Speech Adapter.\n *\n * Talks to `POST {baseURL}/tts` per\n * https://docs.x.ai/developers/model-capabilities/audio/text-to-speech\n */\nexport class GrokSpeechAdapter<\n  TModel extends GrokTTSModel,\n> extends BaseTTSAdapter<TModel, GrokTTSProviderOptions> {\n  readonly name = 'grok' as const\n\n  private readonly apiKey: string\n  private readonly baseURL: string\n  private readonly defaultHeaders: Record<string, string>\n\n  constructor(config: GrokSpeechConfig, model: TModel) {\n    super(model, config)\n    this.apiKey = config.apiKey\n    this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\\/+$/, '')\n    this.defaultHeaders = config.defaultHeaders ?? {}\n  }\n\n  async generateSpeech(\n    options: TTSOptions<GrokTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { logger } = options\n    const { model, text, voice, format, modelOptions } = options\n\n    logger.request(`activity=generateSpeech provider=grok model=${model}`, {\n      provider: 'grok',\n      model,\n    })\n\n    const { body, codec, sampleRateForContentType } = buildTTSRequestBody({\n      text,\n      voice,\n      format,\n      modelOptions,\n    })\n\n    try {\n      const response = await fetch(`${this.baseURL}/tts`, {\n        method: 'POST',\n        headers: {\n          // `defaultHeaders` first so the adapter's Authorization / Content-Type\n          // always win — otherwise a caller-supplied `Authorization` header\n          // could silently clobber the bearer token.\n          ...this.defaultHeaders,\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(body),\n      })\n\n      if (!response.ok) {\n        const errorText = await response.text()\n        throw new Error(\n          `Grok TTS request failed: ${response.status} ${errorText}`,\n        )\n      }\n\n      const arrayBuffer = await response.arrayBuffer()\n      const audio = arrayBufferToBase64(arrayBuffer)\n\n      return {\n        id: generateId(this.name),\n        model,\n        audio,\n        format: codec,\n        contentType: getContentType(codec, sampleRateForContentType),\n      }\n    } catch (error) {\n      logger.errors('grok.generateSpeech fatal', {\n        error,\n        source: 'grok.generateSpeech',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Build the JSON body for `POST /v1/tts`, resolving codec / sample-rate / voice\n * defaults in one place.\n *\n * Returns the request `body`, the resolved `codec`, and the `sampleRateForContentType`\n * used by the caller to label the response via `getContentType`.\n */\nexport function buildTTSRequestBody(options: {\n  text: string\n  voice: string | undefined\n  format: TTSOptions['format'] | undefined\n  modelOptions: GrokTTSProviderOptions | undefined\n}): {\n  body: Record<string, unknown>\n  codec: GrokTTSCodec\n  sampleRateForContentType: number\n} {\n  const { text, voice, format, modelOptions } = options\n\n  const codec = pickCodec(modelOptions?.codec, format)\n\n  // Only forward `sample_rate` when either:\n  //   - the caller explicitly set `modelOptions.sample_rate`, or\n  //   - the codec's Content-Type carries the rate (pcm → audio/L16;rate=…).\n  // For mp3/wav/opus/aac/flac we leave sample_rate unset so xAI's server\n  // default applies.\n  const callerSampleRate = modelOptions?.sample_rate\n  // Default sample rate documented in GrokTTSProviderOptions is 24000 Hz —\n  // used only when we MUST attach a rate to the contentType (pcm) and the\n  // caller didn't pick one.\n  const pcmDefault = 24000\n  const needsRateInContentType = codec === 'pcm'\n\n  const outputFormat: Record<string, unknown> = { codec }\n  if (callerSampleRate !== undefined) {\n    outputFormat.sample_rate = callerSampleRate\n  } else if (needsRateInContentType) {\n    outputFormat.sample_rate = pcmDefault\n  }\n  if (codec === 'mp3' && modelOptions?.bit_rate !== undefined) {\n    outputFormat.bit_rate = modelOptions.bit_rate\n  }\n\n  // pcm embeds the rate in `audio/L16;rate=…`; mulaw/alaw embed it in\n  // `audio/PCMU;rate=…` / `audio/PCMA;rate=…` when non-default. mp3/wav\n  // don't carry a rate parameter so the value is unused for those.\n  const sampleRateForContentType = callerSampleRate ?? pcmDefault\n\n  const body: Record<string, unknown> = {\n    text,\n    voice_id: voice ?? 'eve',\n    language: modelOptions?.language ?? 'en',\n    output_format: outputFormat,\n  }\n  if (modelOptions?.optimize_streaming_latency !== undefined) {\n    body.optimize_streaming_latency = modelOptions.optimize_streaming_latency\n  }\n  if (modelOptions?.text_normalization !== undefined) {\n    body.text_normalization = modelOptions.text_normalization\n  }\n\n  return { body, codec, sampleRateForContentType }\n}\n\n/**\n * Maps the cross-provider `TTSOptions.format` onto Grok's supported codecs.\n * `opus`, `aac`, and `flac` are not supported by xAI TTS (which only exposes\n * mp3/wav/pcm/mulaw/alaw) — we fall back to mp3. An explicit\n * `modelOptions.codec` always wins.\n */\nfunction pickCodec(\n  codecOverride: GrokTTSCodec | undefined,\n  format: TTSOptions['format'] | undefined,\n): GrokTTSCodec {\n  if (codecOverride) return codecOverride\n  if (!format) return 'mp3'\n  switch (format) {\n    case 'mp3':\n    case 'wav':\n    case 'pcm':\n      return format\n    case 'flac':\n    case 'opus':\n    case 'aac':\n      return 'mp3'\n    default:\n      return 'mp3'\n  }\n}\n\nexport function getContentType(\n  codec: GrokTTSCodec,\n  sampleRate: number,\n): string {\n  switch (codec) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'pcm':\n      // `audio/L16` requires a `rate` parameter per RFC 3551/3555.\n      return `audio/L16;rate=${sampleRate}`\n    case 'mulaw':\n      // `audio/basic` is 8 kHz mono by RFC 2046 registration. For non-8kHz\n      // streams xAI still produces mulaw-encoded bytes at the requested\n      // rate, but the registered MIME can't carry that rate — so we use\n      // the non-standard but commonly-supported `audio/PCMU;rate=…` (RFC 3551\n      // RTP payload name) whenever the caller asked for a rate other than\n      // 8000, and keep `audio/basic` for the standard 8kHz case.\n      return sampleRate === 8000\n        ? 'audio/basic'\n        : `audio/PCMU;rate=${sampleRate}`\n    case 'alaw':\n      return sampleRate === 8000\n        ? 'audio/x-alaw-basic'\n        : `audio/PCMA;rate=${sampleRate}`\n  }\n}\n\n/**\n * Creates a Grok speech (TTS) adapter with an explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createGrokSpeech('grok-tts', 'xai-...')\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello from Grok',\n *   voice: 'eve',\n * })\n * ```\n */\nexport function createGrokSpeech<TModel extends GrokTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokSpeechConfig, 'apiKey'>,\n): GrokSpeechAdapter<TModel> {\n  return new GrokSpeechAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok speech (TTS) adapter, reading the API key from\n * `XAI_API_KEY` in the environment.\n *\n * @throws Error if `XAI_API_KEY` is not set.\n */\nexport function grokSpeech<TModel extends GrokTTSModel>(\n  model: TModel,\n  config?: Omit<GrokSpeechConfig, 'apiKey'>,\n): GrokSpeechAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokSpeech(model, apiKey, config)\n}\n"],"mappings":"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"}

package/dist/esm/adapters/video.d.ts

@@ -1,7 +1,7 @@
 import { BaseVideoAdapter, DurationOptions } from '@tanstack/ai/adapters';
 import { VideoGenerationOptions, VideoJobResult, VideoStatusResult, VideoUrlResult } from '@tanstack/ai';
 import { GrokVideoModel } from '../model-meta.js';
-import { GrokVideoModelDurationByName, GrokVideoModelInputModalitiesByName, GrokVideoModelProviderOptionsByName, GrokVideoModelSizeByName, GrokVideoProviderOptions } from '../video/video-provider-options.js';
+import { GrokVideoModelDurationByName, GrokVideoModelInputModalitiesByName, GrokVideoModelProviderOptionsByName, GrokVideoModelSizeByName } from '../video/video-provider-options.js';
 import { GrokClientConfig } from '../utils/client.js';
 /**
  * Configuration for Grok video adapter.
@@ -17,10 +17,10 @@ export interface GrokVideoConfig extends GrokClientConfig {
  * 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.
+ * Both models support text-to-video and image-to-video;
+ * `grok-imagine-video-1.5` is xAI's documented default and adds native
+ * 1080p generation plus reference-to-video inputs. Source-video edit
+ * and extend are `grok-imagine-video` only.
  *
  * 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
@@ -33,9 +33,17 @@ export interface GrokVideoConfig extends GrokClientConfig {
  * - 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)
+ * - Reference-to-video via image prompt parts with
+ *   `metadata.role: 'reference'` or `'character'` (→ `reference_images`)
+ *   and preset voices via `modelOptions.reference_audios`
+ *   (grok-imagine-video-1.5 only)
+ * - Video editing / extension on `grok-imagine-video` via a source
+ *   `video` prompt part and `modelOptions.mode: 'edit' | 'extend'`
+ *   (`/v1/videos/edits` / `/v1/videos/extensions`; in extend mode
+ *   `duration` is the added tail)
  * - Usage reporting: billed seconds (`unitsBilled`) and exact cost
  */
-export declare class GrokVideoAdapter<TModel extends GrokVideoModel> extends BaseVideoAdapter<TModel, GrokVideoProviderOptions, GrokVideoModelProviderOptionsByName, GrokVideoModelSizeByName, GrokVideoModelInputModalitiesByName, GrokVideoModelDurationByName> {
+export declare class GrokVideoAdapter<TModel extends GrokVideoModel> extends BaseVideoAdapter<TModel, GrokVideoModelProviderOptionsByName[TModel], GrokVideoModelProviderOptionsByName, GrokVideoModelSizeByName, GrokVideoModelInputModalitiesByName, GrokVideoModelDurationByName> {
     readonly name: "grok";
     private readonly clientConfig;
     constructor(config: GrokVideoConfig, model: TModel);
@@ -46,7 +54,22 @@ export declare class GrokVideoAdapter<TModel extends GrokVideoModel> extends Bas
      * (`{"code": "...", "error": "..."}`), falling back to the raw text.
      */
     private errorMessage;
-    createVideoJob(options: VideoGenerationOptions<GrokVideoProviderOptions, GrokVideoModelSizeByName[TModel], GrokVideoModelDurationByName[TModel]>): Promise<VideoJobResult>;
+    createVideoJob(options: VideoGenerationOptions<GrokVideoModelProviderOptionsByName[TModel], GrokVideoModelSizeByName[TModel], GrokVideoModelDurationByName[TModel]>): Promise<VideoJobResult>;
+    /**
+     * Build and post an edit / extension request. Both endpoints take only
+     * `model`, `prompt`, and the source `video` (plus `duration` — the length
+     * of the added tail — for extensions): output geometry is inherited from
+     * the source clip, capped at 720p, and edit outputs also inherit the
+     * source length. Rather than sending fields the API documents as ignored,
+     * the inapplicable options are rejected with actionable errors.
+     */
+    private createSourceVideoJob;
+    /**
+     * POST a create-job request body to one of the Imagine video endpoints
+     * (`/videos/generations`, `/videos/edits`, `/videos/extensions`) and read
+     * the `request_id` out of the shared response shape.
+     */
+    private postVideoJob;
     private retrieveJob;
     getVideoStatus(jobId: string): Promise<VideoStatusResult>;
     getVideoUrl(jobId: string): Promise<VideoUrlResult>;
@@ -73,15 +96,14 @@ export declare class GrokVideoAdapter<TModel extends GrokVideoModel> extends Bas
  *
  * @experimental Video generation is an experimental feature and may change.
  *
- * @param model - The model name (e.g., 'grok-imagine-video')
+ * @param model - The model name (e.g., 'grok-imagine-video-1.5')
  * @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 adapter = createGrokVideo('grok-imagine-video-1.5', 'xai-...');
  *
  * const { jobId } = await generateVideo({
  *   adapter,
@@ -112,7 +134,7 @@ export declare function createGrokVideo<TModel extends GrokVideoModel>(model: TM
  * // 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.
+ * // Image-to-video: an optional image prompt part is the starting frame.
  * const { jobId } = await generateVideo({
  *   adapter,
  *   prompt: [

package/dist/esm/adapters/video.js

@@ -1,5 +1,5 @@
 import { getGrokApiKeyFromEnv, withGrokDefaults } from "../utils/client.js";
-import { getGrokVideoDurationOptions, isImageToVideoOnlyModel, parseGrokVideoSize, validateVideoSize } from "../video/video-provider-options.js";
+import { getGrokVideoDurationOptions, isGrokVideoReferenceModel, isGrokVideoSourceModel, 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";
@@ -10,11 +10,11 @@ import { toRunErrorPayload } from "@tanstack/ai/adapter-internals";
 */
 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.
+* Convert a TanStack image / video part to the URL string accepted by xAI's
+* Imagine video endpoints: public URLs pass through (fetched by xAI's
+* servers), data sources become base64 data URIs.
 */
-function imagePartToUrl(part) {
+function mediaPartToUrl(part) {
 	if (part.source.type === "url") return part.source.value;
 	return `data:${part.source.mimeType};base64,${part.source.value}`;
 }
@@ -37,10 +37,10 @@ function buildGrokVideoUsage(response) {
 * 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.
+* Both models support text-to-video and image-to-video;
+* `grok-imagine-video-1.5` is xAI's documented default and adds native
+* 1080p generation plus reference-to-video inputs. Source-video edit
+* and extend are `grok-imagine-video` only.
 *
 * 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
@@ -53,6 +53,14 @@ function buildGrokVideoUsage(response) {
 * - 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)
+* - Reference-to-video via image prompt parts with
+*   `metadata.role: 'reference'` or `'character'` (→ `reference_images`)
+*   and preset voices via `modelOptions.reference_audios`
+*   (grok-imagine-video-1.5 only)
+* - Video editing / extension on `grok-imagine-video` via a source
+*   `video` prompt part and `modelOptions.mode: 'edit' | 'extend'`
+*   (`/v1/videos/edits` / `/v1/videos/extensions`; in extend mode
+*   `duration` is the added tail)
 * - Usage reporting: billed seconds (`unitsBilled`) and exact cost
 */
 var GrokVideoAdapter = class extends BaseVideoAdapter {
@@ -88,39 +96,130 @@ var GrokVideoAdapter = class extends BaseVideoAdapter {
 	}
 	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 { mode, ...wireOptions } = modelOptions ?? {};
+		if (mode !== void 0 && mode !== "edit" && mode !== "extend") throw new Error(`${this.name}: unknown modelOptions.mode '${String(mode)}'. Expected 'edit' or 'extend'.`);
 		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;
+		if (resolved.audios.length > 0) throw new Error(`${this.name}.createVideoJob does not support audio prompt parts (model: ${model}). To reference a preset voice, pass modelOptions.reference_audios (e.g. [{ voice_id: 'eve' }]).`);
+		if (!isGrokVideoSourceModel(model) && (mode !== void 0 || resolved.videos.length > 0)) throw new Error(`${this.name}: ${model} does not support video editing or extension. Use 'grok-imagine-video' for /v1/videos/edits and /v1/videos/extensions.`);
+		if (resolved.videos.length > 1) throw new Error(`${this.name}: ${model} accepts at most one source video; received ${resolved.videos.length}.`);
+		const [sourceVideo] = resolved.videos;
+		if (sourceVideo && mode === void 0) throw new Error(`${this.name}: a video prompt part needs modelOptions.mode set to 'edit' (rewrite the clip) or 'extend' (append to it).`);
+		if (!sourceVideo && mode !== void 0) throw new Error(`${this.name}: modelOptions.mode '${mode}' requires a video prompt part carrying the source clip.`);
+		if (mode !== void 0 && sourceVideo) return await this.createSourceVideoJob({
+			model,
+			mode,
+			sourceVideo,
+			resolved,
+			wireOptions,
+			size,
+			genericDuration: options.duration,
+			logger
+		});
+		validateVideoSize(model, size);
+		const { duration: rawOptionDuration, reference_images: explicitReferenceImages, reference_audios: referenceAudios, ...generationOptions } = wireOptions;
+		const rawDuration = rawOptionDuration ?? options.duration;
+		const duration = rawDuration != null ? this.snapDuration(rawDuration) : void 0;
+		const startFrames = [];
+		const referenceImages = [];
+		for (const part of resolved.images) {
+			const role = part.metadata?.role;
+			switch (role) {
+				case "mask":
+				case "control":
+				case "end_frame": throw new Error(`${this.name}: the Imagine video API has no '${role}' image input on model ${model}. Use an un-roled / 'start_frame' image as the starting frame, or 'reference' images.`);
+				case "reference":
+				case "character":
+					referenceImages.push({ url: mediaPartToUrl(part) });
+					break;
+				case "start_frame":
+				case void 0:
+					startFrames.push(part);
+					break;
+				default: throw new Error(`${this.name}: unknown image metadata.role '${String(role)}'. Expected 'start_frame', 'reference', or 'character'.`);
+			}
+		}
+		if (startFrames.length > 1) throw new Error(`${this.name}: ${model} accepts at most one starting-frame image; received ${startFrames.length}. Use metadata.role: 'reference' for reference-to-video inputs.`);
+		const finalReferenceImages = explicitReferenceImages ?? (referenceImages.length > 0 ? referenceImages : void 0);
+		const referenceImageCount = finalReferenceImages?.length ?? 0;
+		const referenceAudioCount = referenceAudios?.length ?? 0;
+		const hasReference = referenceImageCount > 0 || referenceAudioCount > 0;
+		if (!isGrokVideoReferenceModel(model) && hasReference) throw new Error(`${this.name}: ${model} does not support reference-to-video inputs. Use 'grok-imagine-video-1.5' for reference_images / reference_audios.`);
+		if (referenceAudioCount > 3) throw new Error(`${this.name}: ${model} accepts at most 3 reference voices; received ${referenceAudioCount}.`);
+		if (referenceImageCount > 7) throw new Error(`${this.name}: ${model} accepts at most 7 reference images; received ${referenceImageCount}.`);
+		const [startFrame] = startFrames;
+		if (startFrame && hasReference) throw new Error(`${this.name}: image-to-video and reference-to-video cannot be combined. Use a starting-frame image, or reference images / voices, not both.`);
 		const parsedSize = size !== void 0 ? parseGrokVideoSize(size) : void 0;
+		const resolvedResolution = generationOptions.resolution ?? parsedSize?.resolution;
+		if (hasReference && resolvedResolution === "1080p") throw new Error(`${this.name}: reference-to-video is capped at 720p on ${model}.`);
 		const request = {
 			model,
 			prompt: resolved.text,
-			...startFrame && { image: { url: imagePartToUrl(startFrame) } },
+			...startFrame && { image: { url: mediaPartToUrl(startFrame) } },
+			...referenceImageCount > 0 && { reference_images: finalReferenceImages },
+			...referenceAudioCount > 0 && { reference_audios: referenceAudios },
 			...parsedSize && {
 				aspect_ratio: parsedSize.aspectRatio,
 				...parsedSize.resolution !== void 0 && { resolution: parsedSize.resolution }
 			},
-			...modelOptions,
+			...generationOptions,
+			...duration !== void 0 && { duration }
+		};
+		return await this.postVideoJob("/videos/generations", request, {
+			model,
+			logger,
+			logLine: `activity=video.create provider=${this.name} model=${model} mode=generate size=${size ?? "default"} duration=${duration ?? "default"}`
+		});
+	}
+	/**
+	* Build and post an edit / extension request. Both endpoints take only
+	* `model`, `prompt`, and the source `video` (plus `duration` — the length
+	* of the added tail — for extensions): output geometry is inherited from
+	* the source clip, capped at 720p, and edit outputs also inherit the
+	* source length. Rather than sending fields the API documents as ignored,
+	* the inapplicable options are rejected with actionable errors.
+	*/
+	async createSourceVideoJob(args) {
+		const { model, mode, sourceVideo, resolved, wireOptions, logger } = args;
+		const endpoint = mode === "edit" ? "/videos/edits" : "/videos/extensions";
+		if (resolved.images.length > 0) throw new Error(`${this.name}: '${mode}' mode takes only the source video — image prompt parts are not supported by ${endpoint}.`);
+		const { aspect_ratio: aspectRatio, resolution, duration: modeDuration, reference_images: referenceImagesOption, reference_audios: referenceAudiosOption, ...passthrough } = wireOptions;
+		if ((referenceImagesOption?.length ?? 0) > 0 || (referenceAudiosOption?.length ?? 0) > 0) throw new Error(`${this.name}: reference inputs are only supported by video generation, not '${mode}' mode.`);
+		if (args.size !== void 0 || aspectRatio != null || resolution != null) throw new Error(`${this.name}: '${mode}' mode does not accept size / aspect_ratio / resolution — the output inherits the source clip's geometry (capped at 720p).`);
+		const rawDuration = modeDuration ?? args.genericDuration;
+		if (mode === "edit" && rawDuration != null) throw new Error(`${this.name}: 'edit' mode does not accept a duration — the output inherits the source clip's length. Use mode 'extend' to append seconds to the clip.`);
+		const duration = rawDuration != null ? this.snapDuration(rawDuration) : void 0;
+		const request = {
+			model,
+			prompt: resolved.text,
+			video: { url: mediaPartToUrl(sourceVideo) },
+			...passthrough,
 			...duration !== void 0 && { duration }
 		};
+		return await this.postVideoJob(endpoint, request, {
+			model,
+			logger,
+			logLine: `activity=video.create provider=${this.name} model=${model} mode=${mode} duration=${duration ?? "default"}`
+		});
+	}
+	/**
+	* POST a create-job request body to one of the Imagine video endpoints
+	* (`/videos/generations`, `/videos/edits`, `/videos/extensions`) and read
+	* the `request_id` out of the shared response shape.
+	*/
+	async postVideoJob(endpoint, request, context) {
+		const { model, logger, logLine } = context;
 		try {
-			logger.request(`activity=video.create provider=${this.name} model=${model} size=${size ?? "default"} duration=${duration ?? "default"}`, {
+			logger.request(logLine, {
 				provider: this.name,
 				model
 			});
-			const response = await this.request("/videos/generations", {
+			const response = await this.request(endpoint, {
 				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)}`);
+			if (!response.ok) throw new Error(`grok: ${endpoint} 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");
+			if (!result.request_id) throw new Error(`grok: ${endpoint} response contained no request_id`);
 			return {
 				jobId: result.request_id,
 				model
@@ -220,15 +319,14 @@ var GrokVideoAdapter = class extends BaseVideoAdapter {
 *
 * @experimental Video generation is an experimental feature and may change.
 *
-* @param model - The model name (e.g., 'grok-imagine-video')
+* @param model - The model name (e.g., 'grok-imagine-video-1.5')
 * @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 adapter = createGrokVideo('grok-imagine-video-1.5', 'xai-...');
 *
 * const { jobId } = await generateVideo({
 *   adapter,
@@ -264,7 +362,7 @@ function createGrokVideo(model, apiKey, config) {
 * // 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.
+* // Image-to-video: an optional image prompt part is the starting frame.
 * const { jobId } = await generateVideo({
 *   adapter,
 *   prompt: [

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

@@ -1 +1 @@
-{"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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"}
+{"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  GROK_VIDEO_MAX_REFERENCE_AUDIOS,\n  GROK_VIDEO_MAX_REFERENCE_IMAGES,\n  getGrokVideoDurationOptions,\n  isGrokVideoReferenceModel,\n  isGrokVideoSourceModel,\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  VideoPart,\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  GrokVideoRuntimeOptions,\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 the POST /v1/videos/{generations,edits,extensions} endpoints. */\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 image / video part to the URL string accepted by xAI's\n * Imagine video endpoints: public URLs pass through (fetched by xAI's\n * servers), data sources become base64 data URIs.\n */\nfunction mediaPartToUrl(\n  part: ImagePart<MediaInputMetadata> | VideoPart<MediaInputMetadata>,\n): 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 * Both models support text-to-video and image-to-video;\n * `grok-imagine-video-1.5` is xAI's documented default and adds native\n * 1080p generation plus reference-to-video inputs. Source-video edit\n * and extend are `grok-imagine-video` only.\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 * - Reference-to-video via image prompt parts with\n *   `metadata.role: 'reference'` or `'character'` (→ `reference_images`)\n *   and preset voices via `modelOptions.reference_audios`\n *   (grok-imagine-video-1.5 only)\n * - Video editing / extension on `grok-imagine-video` via a source\n *   `video` prompt part and `modelOptions.mode: 'edit' | 'extend'`\n *   (`/v1/videos/edits` / `/v1/videos/extensions`; in extend mode\n *   `duration` is the added tail)\n * - Usage reporting: billed seconds (`unitsBilled`) and exact cost\n */\nexport class GrokVideoAdapter<\n  TModel extends GrokVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GrokVideoModelProviderOptionsByName[TModel],\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      GrokVideoModelProviderOptionsByName[TModel],\n      GrokVideoModelSizeByName[TModel],\n      GrokVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { model, size, modelOptions, logger } = options\n\n    // `mode` is a routing hint for this adapter, not an API field — strip it\n    // before the remaining options are spread onto the request body. The\n    // per-model map narrows what callers can pass, but modelOptions often\n    // arrives as deserialized JSON, so the adapter handles the widest option\n    // surface (the 1.5 shape) uniformly and gates by model at runtime.\n    const { mode, ...wireOptions } = (modelOptions ??\n      {}) as GrokVideoRuntimeOptions\n\n    // `mode` is typed 'edit' | 'extend' but reaches us untrusted from JSON\n    // callers. An unrecognised value must not fall through to the\n    // generations endpoint with a source-video body — that would silently\n    // run (and bill) a generation the caller never asked for.\n    if (mode !== undefined && mode !== 'edit' && mode !== 'extend') {\n      throw new Error(\n        `${this.name}: unknown modelOptions.mode '${String(mode)}'. ` +\n          `Expected 'edit' or 'extend'.`,\n      )\n    }\n\n    // The interleaved prompt decomposes into verbatim text plus typed media\n    // buckets. Reference audio is voice-id based (not an audio file), so\n    // audio prompt parts have no request field to land in.\n    const resolved = resolveMediaPrompt(options.prompt)\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}). ` +\n          `To reference a preset voice, pass modelOptions.reference_audios ` +\n          `(e.g. [{ voice_id: 'eve' }]).`,\n      )\n    }\n\n    // A video prompt part is the source clip for edit / extension mode.\n    // Those endpoints are grok-imagine-video only — 1.5 has no video input.\n    if (\n      !isGrokVideoSourceModel(model) &&\n      (mode !== undefined || resolved.videos.length > 0)\n    ) {\n      throw new Error(\n        `${this.name}: ${model} does not support video editing or extension. ` +\n          `Use 'grok-imagine-video' for /v1/videos/edits and /v1/videos/extensions.`,\n      )\n    }\n\n    // The mode must be chosen explicitly because the two endpoints have\n    // different semantics (edit rewrites the clip, extend appends\n    // `duration` seconds).\n    if (resolved.videos.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one source video; received ${resolved.videos.length}.`,\n      )\n    }\n    const [sourceVideo] = resolved.videos\n    if (sourceVideo && mode === undefined) {\n      throw new Error(\n        `${this.name}: a video prompt part needs modelOptions.mode set to ` +\n          `'edit' (rewrite the clip) or 'extend' (append to it).`,\n      )\n    }\n    if (!sourceVideo && mode !== undefined) {\n      throw new Error(\n        `${this.name}: modelOptions.mode '${mode}' requires a video prompt ` +\n          `part carrying the source clip.`,\n      )\n    }\n\n    if (mode !== undefined && sourceVideo) {\n      return await this.createSourceVideoJob({\n        model,\n        mode,\n        sourceVideo,\n        resolved,\n        wireOptions,\n        size,\n        genericDuration: options.duration,\n        logger,\n      })\n    }\n\n    validateVideoSize(model, size)\n\n    // Pull the specially-handled keys out of the wire options: `duration`\n    // is folded into the snapped value below, and the reference fields are\n    // re-added explicitly so a JSON-serialized `null` or empty array reads\n    // as \"unset\" instead of leaking onto the wire.\n    const {\n      duration: rawOptionDuration,\n      reference_images: explicitReferenceImages,\n      reference_audios: referenceAudios,\n      ...generationOptions\n    } = wireOptions\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 = rawOptionDuration ?? options.duration\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    // Image parts split by role: un-roled / 'start_frame' images become the\n    // starting frame (image-to-video); 'reference' / 'character' images\n    // become reference_images (reference-to-video). The Imagine API has no\n    // mask / control / end-frame inputs. Unknown role strings (possible via\n    // JSON callers) throw rather than silently dropping the part.\n    const startFrames: Array<ImagePart<MediaInputMetadata>> = []\n    const referenceImages: Array<{ url: string }> = []\n    for (const part of resolved.images) {\n      const role = part.metadata?.role\n      switch (role) {\n        case 'mask':\n        case 'control':\n        case 'end_frame':\n          throw new Error(\n            `${this.name}: the Imagine video API has no '${role}' image ` +\n              `input on model ${model}. Use an un-roled / 'start_frame' ` +\n              `image as the starting frame, or 'reference' images.`,\n          )\n        case 'reference':\n        case 'character':\n          referenceImages.push({ url: mediaPartToUrl(part) })\n          break\n        case 'start_frame':\n        case undefined:\n          startFrames.push(part)\n          break\n        default:\n          throw new Error(\n            `${this.name}: unknown image metadata.role '${String(role)}'. ` +\n              `Expected 'start_frame', 'reference', or 'character'.`,\n          )\n      }\n    }\n    if (startFrames.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one starting-frame image; received ${startFrames.length}. ` +\n          `Use metadata.role: 'reference' for reference-to-video inputs.`,\n      )\n    }\n    // Explicit modelOptions.reference_images replaces the part-derived list\n    // (an explicit empty array means \"none\").\n    const finalReferenceImages =\n      explicitReferenceImages ??\n      (referenceImages.length > 0 ? referenceImages : undefined)\n    const referenceImageCount = finalReferenceImages?.length ?? 0\n    const referenceAudioCount = referenceAudios?.length ?? 0\n    const hasReference = referenceImageCount > 0 || referenceAudioCount > 0\n\n    // Reference inputs are a grok-imagine-video-1.5 feature. The per-model\n    // options map already hides the fields from other models at compile\n    // time; this runtime gate covers prompt-part roles and untyped callers.\n    if (!isGrokVideoReferenceModel(model) && hasReference) {\n      throw new Error(\n        `${this.name}: ${model} does not support reference-to-video inputs. ` +\n          `Use 'grok-imagine-video-1.5' for reference_images / reference_audios.`,\n      )\n    }\n    if (referenceAudioCount > GROK_VIDEO_MAX_REFERENCE_AUDIOS) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_AUDIOS} reference voices; received ${referenceAudioCount}.`,\n      )\n    }\n    if (referenceImageCount > GROK_VIDEO_MAX_REFERENCE_IMAGES) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_IMAGES} reference images; received ${referenceImageCount}.`,\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] = startFrames\n\n    // xAI rejects `image` + `reference_images` / `reference_audios` as a\n    // 400: only one of image-to-video or reference-to-video can be active.\n    if (startFrame && hasReference) {\n      throw new Error(\n        `${this.name}: image-to-video and reference-to-video cannot be combined. ` +\n          `Use a starting-frame image, or reference images / voices, not both.`,\n      )\n    }\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    // (including `reference_images`, which replaces the part-derived list).\n    const parsedSize = size !== undefined ? parseGrokVideoSize(size) : undefined\n    const resolvedResolution =\n      generationOptions.resolution ?? parsedSize?.resolution\n    if (hasReference && resolvedResolution === '1080p') {\n      throw new Error(\n        `${this.name}: reference-to-video is capped at 720p on ${model}.`,\n      )\n    }\n    const request = {\n      model,\n      prompt: resolved.text,\n      ...(startFrame && { image: { url: mediaPartToUrl(startFrame) } }),\n      ...(referenceImageCount > 0 && {\n        reference_images: finalReferenceImages,\n      }),\n      ...(referenceAudioCount > 0 && {\n        reference_audios: referenceAudios,\n      }),\n      ...(parsedSize && {\n        aspect_ratio: parsedSize.aspectRatio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      // The remaining options spread after the size template so explicit\n      // aspect_ratio / resolution win over it; duration and the reference\n      // fields were destructured out above and re-added normalized.\n      ...generationOptions,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob('/videos/generations', request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=generate size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * Build and post an edit / extension request. Both endpoints take only\n   * `model`, `prompt`, and the source `video` (plus `duration` — the length\n   * of the added tail — for extensions): output geometry is inherited from\n   * the source clip, capped at 720p, and edit outputs also inherit the\n   * source length. Rather than sending fields the API documents as ignored,\n   * the inapplicable options are rejected with actionable errors.\n   */\n  private async createSourceVideoJob(args: {\n    model: string\n    mode: 'edit' | 'extend'\n    sourceVideo: VideoPart<MediaInputMetadata>\n    resolved: ReturnType<typeof resolveMediaPrompt>\n    wireOptions: Omit<GrokVideoRuntimeOptions, 'mode'>\n    size: string | undefined\n    genericDuration: number | undefined\n    logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n  }): Promise<VideoJobResult> {\n    const { model, mode, sourceVideo, resolved, wireOptions, logger } = args\n    const endpoint = mode === 'edit' ? '/videos/edits' : '/videos/extensions'\n\n    if (resolved.images.length > 0) {\n      throw new Error(\n        `${this.name}: '${mode}' mode takes only the source video — image ` +\n          `prompt parts are not supported by ${endpoint}.`,\n      )\n    }\n\n    // Pull every generation-only key out of the wire options so nothing can\n    // leak into the edit/extend body via the spread below. JSON-serialized\n    // `null` values (a common \"unset\" encoding) are treated as absent;\n    // actual values are rejected with actionable errors.\n    const {\n      aspect_ratio: aspectRatio,\n      resolution,\n      duration: modeDuration,\n      reference_images: referenceImagesOption,\n      reference_audios: referenceAudiosOption,\n      ...passthrough\n    } = wireOptions\n    if (\n      (referenceImagesOption?.length ?? 0) > 0 ||\n      (referenceAudiosOption?.length ?? 0) > 0\n    ) {\n      throw new Error(\n        `${this.name}: reference inputs are only supported by video ` +\n          `generation, not '${mode}' mode.`,\n      )\n    }\n    if (args.size !== undefined || aspectRatio != null || resolution != null) {\n      throw new Error(\n        `${this.name}: '${mode}' mode does not accept size / aspect_ratio / ` +\n          `resolution — the output inherits the source clip's geometry ` +\n          `(capped at 720p).`,\n      )\n    }\n    const rawDuration = modeDuration ?? args.genericDuration\n    if (mode === 'edit' && rawDuration != null) {\n      throw new Error(\n        `${this.name}: 'edit' mode does not accept a duration — the output ` +\n          `inherits the source clip's length. Use mode 'extend' to append ` +\n          `seconds to the clip.`,\n      )\n    }\n    // Extend: the snapped duration is the added-tail length (1–15s).\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    const request = {\n      model,\n      prompt: resolved.text,\n      video: { url: mediaPartToUrl(sourceVideo) },\n      ...passthrough,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob(endpoint, request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=${mode} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * POST a create-job request body to one of the Imagine video endpoints\n   * (`/videos/generations`, `/videos/edits`, `/videos/extensions`) and read\n   * the `request_id` out of the shared response shape.\n   */\n  private async postVideoJob(\n    endpoint: string,\n    request: Record<string, unknown>,\n    context: {\n      model: string\n      logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n      logLine: string\n    },\n  ): Promise<VideoJobResult> {\n    const { model, logger, logLine } = context\n    try {\n      logger.request(logLine, { provider: this.name, model })\n\n      const response = await this.request(endpoint, {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw new Error(\n          `grok: ${endpoint} 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(`grok: ${endpoint} response contained no request_id`)\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-1.5')\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 * const adapter = createGrokVideo('grok-imagine-video-1.5', '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: an optional image prompt part is the starting frame.\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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"}