@tanstack/ai-grok 0.14.9 → 0.14.11

package/dist/esm/image/image-provider-options.js

@@ -1,76 +1,74 @@
-const GROK_IMAGINE_ASPECT_RATIOS = [
-  "1:1",
-  "3:4",
-  "4:3",
-  "9:16",
-  "16:9",
-  "2:3",
-  "3:2",
-  "9:19.5",
-  "19.5:9",
-  "9:20",
-  "20:9",
-  "1:2",
-  "2:1",
-  "auto"
+//#region src/image/image-provider-options.ts
+var GROK_IMAGINE_ASPECT_RATIOS = [
+	"1:1",
+	"3:4",
+	"4:3",
+	"9:16",
+	"16:9",
+	"2:3",
+	"3:2",
+	"9:19.5",
+	"19.5:9",
+	"9:20",
+	"20:9",
+	"1:2",
+	"2:1",
+	"auto"
 ];
-const GROK_IMAGINE_RESOLUTIONS = ["1k", "2k"];
+var GROK_IMAGINE_RESOLUTIONS = ["1k", "2k"];
+/**
+* Models served by xAI's Imagine API. They are aspect-ratio sized and
+* support image-conditioned generation via `/v1/images/edits`; the legacy
+* grok-2-image-1212 model is pixel-sized and text-to-image only.
+*/
 function isGrokImagineImageModel(model) {
-  return model.startsWith("grok-imagine-image");
+	return model.startsWith("grok-imagine-image");
 }
+/**
+* Parses a grok-imagine size string into its components.
+* Format: "aspectRatio" or "aspectRatio_resolution",
+* e.g. "16:9_2k" → { aspectRatio: "16:9", resolution: "2k" }.
+* Returns undefined when the string doesn't match the template.
+*/
 function parseGrokImagineSize(size) {
-  const match = size.match(/^([\d.]+:[\d.]+|auto)(?:_(.+))?$/);
-  const [, aspectRatio, resolution] = match ?? [];
-  if (aspectRatio === void 0) return void 0;
-  return { aspectRatio, ...resolution !== void 0 && { resolution } };
+	const [, aspectRatio, resolution] = size.match(/^([\d.]+:[\d.]+|auto)(?:_(.+))?$/) ?? [];
+	if (aspectRatio === void 0) return void 0;
+	return {
+		aspectRatio,
+		...resolution !== void 0 && { resolution }
+	};
 }
+/**
+* Validates that the provided size is supported by the model.
+* Throws a descriptive error if the size is not supported.
+*/
 function validateImageSize(model, size) {
-  if (!size) return;
-  if (isGrokImagineImageModel(model)) {
-    const parsed = parseGrokImagineSize(size);
-    if (!parsed || !GROK_IMAGINE_ASPECT_RATIOS.includes(parsed.aspectRatio) || parsed.resolution !== void 0 && !GROK_IMAGINE_RESOLUTIONS.includes(parsed.resolution)) {
-      throw new Error(
-        `Size "${size}" is not supported by model "${model}". Expected an aspect ratio (${GROK_IMAGINE_ASPECT_RATIOS.join(", ")}) optionally suffixed with a resolution ("16:9_2k"; resolutions: ${GROK_IMAGINE_RESOLUTIONS.join(", ")}).`
-      );
-    }
-    return;
-  }
-  const validSizes = {
-    "grok-2-image-1212": ["1024x1024", "1536x1024", "1024x1536"]
-  };
-  const modelSizes = validSizes[model];
-  if (!modelSizes) {
-    throw new Error(`Unknown image model: ${model}`);
-  }
-  if (!modelSizes.includes(size)) {
-    throw new Error(
-      `Size "${size}" is not supported by model "${model}". Supported sizes: ${modelSizes.join(", ")}`
-    );
-  }
+	if (!size) return;
+	if (isGrokImagineImageModel(model)) {
+		const parsed = parseGrokImagineSize(size);
+		if (!parsed || !GROK_IMAGINE_ASPECT_RATIOS.includes(parsed.aspectRatio) || parsed.resolution !== void 0 && !GROK_IMAGINE_RESOLUTIONS.includes(parsed.resolution)) throw new Error(`Size "${size}" is not supported by model "${model}". Expected an aspect ratio (${GROK_IMAGINE_ASPECT_RATIOS.join(", ")}) optionally suffixed with a resolution ("16:9_2k"; resolutions: ${GROK_IMAGINE_RESOLUTIONS.join(", ")}).`);
+		return;
+	}
+	const modelSizes = { "grok-2-image-1212": [
+		"1024x1024",
+		"1536x1024",
+		"1024x1536"
+	] }[model];
+	if (!modelSizes) throw new Error(`Unknown image model: ${model}`);
+	if (!modelSizes.includes(size)) throw new Error(`Size "${size}" is not supported by model "${model}". Supported sizes: ${modelSizes.join(", ")}`);
 }
+/**
+* Validates that the number of images is within bounds for the model.
+*/
 function validateNumberOfImages(_model, numberOfImages) {
-  if (numberOfImages === void 0) return;
-  if (numberOfImages < 1 || numberOfImages > 10) {
-    throw new Error(
-      `Number of images must be between 1 and 10. Requested: ${numberOfImages}`
-    );
-  }
+	if (numberOfImages === void 0) return;
+	if (numberOfImages < 1 || numberOfImages > 10) throw new Error(`Number of images must be between 1 and 10. Requested: ${numberOfImages}`);
 }
-const validatePrompt = (options) => {
-  if (options.prompt.length === 0) {
-    throw new Error("Prompt cannot be empty.");
-  }
-  if (options.prompt.length > 4e3) {
-    throw new Error(
-      "For grok-2-image-1212, prompt length must be less than or equal to 4000 characters."
-    );
-  }
+var validatePrompt = (options) => {
+	if (options.prompt.length === 0) throw new Error("Prompt cannot be empty.");
+	if (options.prompt.length > 4e3) throw new Error("For grok-2-image-1212, prompt length must be less than or equal to 4000 characters.");
 };
-export {
-  isGrokImagineImageModel,
-  parseGrokImagineSize,
-  validateImageSize,
-  validateNumberOfImages,
-  validatePrompt
-};
-//# sourceMappingURL=image-provider-options.js.map
+//#endregion
+export { isGrokImagineImageModel, parseGrokImagineSize, validateImageSize, validateNumberOfImages, validatePrompt };
+
+//# sourceMappingURL=image-provider-options.js.map

package/dist/esm/image/image-provider-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-provider-options.js","sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["/**\n * Grok Image Generation Provider Options\n *\n * These are provider-specific options for Grok image generation.\n * Grok uses the grok-2-image-1212 model for image generation.\n */\n\n/**\n * Supported sizes for grok-2-image-1212 model\n */\nexport type GrokImageSize = '1024x1024' | '1536x1024' | '1024x1536'\n\n/**\n * Aspect ratios accepted by the grok-imagine image models.\n */\nexport type GrokImagineAspectRatio =\n  | '1:1'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '2:3'\n  | '3:2'\n  | '9:19.5'\n  | '19.5:9'\n  | '9:20'\n  | '20:9'\n  | '1:2'\n  | '2:1'\n  | 'auto'\n\n/**\n * Resolution tiers for the grok-imagine image models.\n */\nexport type GrokImagineResolution = '1k' | '2k'\n\n/**\n * Size strings for grok-imagine image models. The Imagine API is\n * aspect-ratio based rather than pixel-size based; like Gemini's native\n * image models, the generic `size` option uses an\n * `aspectRatio_resolution` template (\"16:9_2k\") — the resolution suffix is\n * optional (\"16:9\" uses the API default of 1k).\n */\nexport type GrokImagineImageSize =\n  | GrokImagineAspectRatio\n  | `${GrokImagineAspectRatio}_${GrokImagineResolution}`\n\nconst GROK_IMAGINE_ASPECT_RATIOS: ReadonlyArray<string> = [\n  '1:1',\n  '3:4',\n  '4:3',\n  '9:16',\n  '16:9',\n  '2:3',\n  '3:2',\n  '9:19.5',\n  '19.5:9',\n  '9:20',\n  '20:9',\n  '1:2',\n  '2:1',\n  'auto',\n]\n\nconst GROK_IMAGINE_RESOLUTIONS: ReadonlyArray<string> = ['1k', '2k']\n\n/**\n * Models served by xAI's Imagine API. They are aspect-ratio sized and\n * support image-conditioned generation via `/v1/images/edits`; the legacy\n * grok-2-image-1212 model is pixel-sized and text-to-image only.\n */\nexport function isGrokImagineImageModel(model: string): boolean {\n  return model.startsWith('grok-imagine-image')\n}\n\n/**\n * Parses a grok-imagine size string into its components.\n * Format: \"aspectRatio\" or \"aspectRatio_resolution\",\n * e.g. \"16:9_2k\" → { aspectRatio: \"16:9\", resolution: \"2k\" }.\n * Returns undefined when the string doesn't match the template.\n */\nexport function parseGrokImagineSize(\n  size: string,\n): { aspectRatio: string; resolution?: string } | undefined {\n  const match = size.match(/^([\\d.]+:[\\d.]+|auto)(?:_(.+))?$/)\n  const [, aspectRatio, resolution] = match ?? []\n  if (aspectRatio === undefined) return undefined\n  return { aspectRatio, ...(resolution !== undefined && { resolution }) }\n}\n\n/**\n * Base provider options for Grok image models\n */\nexport interface GrokImageBaseProviderOptions {\n  /**\n   * A unique identifier representing your end-user.\n   * Can help xAI to monitor and detect abuse.\n   */\n  user?: string\n}\n\n/**\n * Provider options for grok-2-image-1212 model\n */\nexport interface GrokImageProviderOptions extends GrokImageBaseProviderOptions {\n  /**\n   * The quality of the image.\n   * @default 'standard'\n   */\n  quality?: 'standard' | 'hd'\n\n  /**\n   * The format in which generated images are returned.\n   * URLs are only valid for 60 minutes after generation.\n   * @default 'url'\n   */\n  response_format?: 'url' | 'b64_json'\n}\n\n/**\n * Provider options for the grok-imagine image models (generation and\n * image-conditioned editing via xAI's Imagine API).\n */\nexport interface GrokImagineImageProviderOptions extends GrokImageBaseProviderOptions {\n  /**\n   * The format in which generated images are returned.\n   * @default 'url'\n   */\n  response_format?: 'url' | 'b64_json'\n\n  /**\n   * Output resolution.\n   * @default '1k'\n   */\n  resolution?: '1k' | '2k'\n\n  /**\n   * Processing tier for the request.\n   * @default 'default'\n   */\n  service_tier?: 'default' | 'priority'\n}\n\n/**\n * Type-only map from model name to its specific provider options.\n */\nexport type GrokImageModelProviderOptionsByName = {\n  'grok-2-image-1212': GrokImageProviderOptions\n  'grok-imagine-image': GrokImagineImageProviderOptions\n  'grok-imagine-image-quality': GrokImagineImageProviderOptions\n}\n\n/**\n * Type-only map from model name to its supported sizes.\n */\nexport type GrokImageModelSizeByName = {\n  'grok-2-image-1212': GrokImageSize\n  'grok-imagine-image': GrokImagineImageSize\n  'grok-imagine-image-quality': GrokImagineImageSize\n}\n\n/**\n * Per-model prompt input modalities. Imagine API models accept image parts\n * in the prompt (routed to `/v1/images/edits`, up to 3 images, addressed by\n * xAI in request order); grok-2-image is text-to-image only.\n */\nexport type GrokImageModelInputModalitiesByName = {\n  'grok-2-image-1212': readonly []\n  'grok-imagine-image': readonly ['image']\n  'grok-imagine-image-quality': readonly ['image']\n}\n\n/**\n * Internal options interface for validation\n */\ninterface ImageValidationOptions {\n  prompt: string\n  model: string\n}\n\n/**\n * Validates that the provided size is supported by the model.\n * Throws a descriptive error if the size is not supported.\n */\nexport function validateImageSize(\n  model: string,\n  size: string | undefined,\n): void {\n  if (!size) return\n\n  if (isGrokImagineImageModel(model)) {\n    const parsed = parseGrokImagineSize(size)\n    if (\n      !parsed ||\n      !GROK_IMAGINE_ASPECT_RATIOS.includes(parsed.aspectRatio) ||\n      (parsed.resolution !== undefined &&\n        !GROK_IMAGINE_RESOLUTIONS.includes(parsed.resolution))\n    ) {\n      throw new Error(\n        `Size \"${size}\" is not supported by model \"${model}\". ` +\n          `Expected an aspect ratio (${GROK_IMAGINE_ASPECT_RATIOS.join(', ')}) ` +\n          `optionally suffixed with a resolution (\"16:9_2k\"; resolutions: ${GROK_IMAGINE_RESOLUTIONS.join(', ')}).`,\n      )\n    }\n    return\n  }\n\n  const validSizes: Record<string, Array<string>> = {\n    'grok-2-image-1212': ['1024x1024', '1536x1024', '1024x1536'],\n  }\n\n  const modelSizes = validSizes[model]\n  if (!modelSizes) {\n    throw new Error(`Unknown image model: ${model}`)\n  }\n\n  if (!modelSizes.includes(size)) {\n    throw new Error(\n      `Size \"${size}\" is not supported by model \"${model}\". ` +\n        `Supported sizes: ${modelSizes.join(', ')}`,\n    )\n  }\n}\n\n/**\n * Validates that the number of images is within bounds for the model.\n */\nexport function validateNumberOfImages(\n  _model: string,\n  numberOfImages: number | undefined,\n): void {\n  if (numberOfImages === undefined) return\n\n  // grok-2-image-1212 supports 1-10 images per request\n  if (numberOfImages < 1 || numberOfImages > 10) {\n    throw new Error(\n      `Number of images must be between 1 and 10. Requested: ${numberOfImages}`,\n    )\n  }\n}\n\nexport const validatePrompt = (options: ImageValidationOptions) => {\n  if (options.prompt.length === 0) {\n    throw new Error('Prompt cannot be empty.')\n  }\n  // Grok image model supports up to 4000 characters\n  if (options.prompt.length > 4000) {\n    throw new Error(\n      'For grok-2-image-1212, prompt length must be less than or equal to 4000 characters.',\n    )\n  }\n}\n"],"names":[],"mappings":"AA+CA,MAAM,6BAAoD;AAAA,EACxD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,2BAAkD,CAAC,MAAM,IAAI;AAO5D,SAAS,wBAAwB,OAAwB;AAC9D,SAAO,MAAM,WAAW,oBAAoB;AAC9C;AAQO,SAAS,qBACd,MAC0D;AAC1D,QAAM,QAAQ,KAAK,MAAM,kCAAkC;AAC3D,QAAM,GAAG,aAAa,UAAU,IAAI,SAAS,CAAA;AAC7C,MAAI,gBAAgB,OAAW,QAAO;AACtC,SAAO,EAAE,aAAa,GAAI,eAAe,UAAa,EAAE,aAAW;AACrE;AAgGO,SAAS,kBACd,OACA,MACM;AACN,MAAI,CAAC,KAAM;AAEX,MAAI,wBAAwB,KAAK,GAAG;AAClC,UAAM,SAAS,qBAAqB,IAAI;AACxC,QACE,CAAC,UACD,CAAC,2BAA2B,SAAS,OAAO,WAAW,KACtD,OAAO,eAAe,UACrB,CAAC,yBAAyB,SAAS,OAAO,UAAU,GACtD;AACA,YAAM,IAAI;AAAA,QACR,SAAS,IAAI,gCAAgC,KAAK,gCACnB,2BAA2B,KAAK,IAAI,CAAC,oEACA,yBAAyB,KAAK,IAAI,CAAC;AAAA,MAAA;AAAA,IAE3G;AACA;AAAA,EACF;AAEA,QAAM,aAA4C;AAAA,IAChD,qBAAqB,CAAC,aAAa,aAAa,WAAW;AAAA,EAAA;AAG7D,QAAM,aAAa,WAAW,KAAK;AACnC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,wBAAwB,KAAK,EAAE;AAAA,EACjD;AAEA,MAAI,CAAC,WAAW,SAAS,IAAI,GAAG;AAC9B,UAAM,IAAI;AAAA,MACR,SAAS,IAAI,gCAAgC,KAAK,uBAC5B,WAAW,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAE/C;AACF;AAKO,SAAS,uBACd,QACA,gBACM;AACN,MAAI,mBAAmB,OAAW;AAGlC,MAAI,iBAAiB,KAAK,iBAAiB,IAAI;AAC7C,UAAM,IAAI;AAAA,MACR,yDAAyD,cAAc;AAAA,IAAA;AAAA,EAE3E;AACF;AAEO,MAAM,iBAAiB,CAAC,YAAoC;AACjE,MAAI,QAAQ,OAAO,WAAW,GAAG;AAC/B,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAEA,MAAI,QAAQ,OAAO,SAAS,KAAM;AAChC,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;"}
+{"version":3,"file":"image-provider-options.js","names":[],"sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["/**\n * Grok Image Generation Provider Options\n *\n * These are provider-specific options for Grok image generation.\n * Grok uses the grok-2-image-1212 model for image generation.\n */\n\n/**\n * Supported sizes for grok-2-image-1212 model\n */\nexport type GrokImageSize = '1024x1024' | '1536x1024' | '1024x1536'\n\n/**\n * Aspect ratios accepted by the grok-imagine image models.\n */\nexport type GrokImagineAspectRatio =\n  | '1:1'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '2:3'\n  | '3:2'\n  | '9:19.5'\n  | '19.5:9'\n  | '9:20'\n  | '20:9'\n  | '1:2'\n  | '2:1'\n  | 'auto'\n\n/**\n * Resolution tiers for the grok-imagine image models.\n */\nexport type GrokImagineResolution = '1k' | '2k'\n\n/**\n * Size strings for grok-imagine image models. The Imagine API is\n * aspect-ratio based rather than pixel-size based; like Gemini's native\n * image models, the generic `size` option uses an\n * `aspectRatio_resolution` template (\"16:9_2k\") — the resolution suffix is\n * optional (\"16:9\" uses the API default of 1k).\n */\nexport type GrokImagineImageSize =\n  | GrokImagineAspectRatio\n  | `${GrokImagineAspectRatio}_${GrokImagineResolution}`\n\nconst GROK_IMAGINE_ASPECT_RATIOS: ReadonlyArray<string> = [\n  '1:1',\n  '3:4',\n  '4:3',\n  '9:16',\n  '16:9',\n  '2:3',\n  '3:2',\n  '9:19.5',\n  '19.5:9',\n  '9:20',\n  '20:9',\n  '1:2',\n  '2:1',\n  'auto',\n]\n\nconst GROK_IMAGINE_RESOLUTIONS: ReadonlyArray<string> = ['1k', '2k']\n\n/**\n * Models served by xAI's Imagine API. They are aspect-ratio sized and\n * support image-conditioned generation via `/v1/images/edits`; the legacy\n * grok-2-image-1212 model is pixel-sized and text-to-image only.\n */\nexport function isGrokImagineImageModel(model: string): boolean {\n  return model.startsWith('grok-imagine-image')\n}\n\n/**\n * Parses a grok-imagine size string into its components.\n * Format: \"aspectRatio\" or \"aspectRatio_resolution\",\n * e.g. \"16:9_2k\" → { aspectRatio: \"16:9\", resolution: \"2k\" }.\n * Returns undefined when the string doesn't match the template.\n */\nexport function parseGrokImagineSize(\n  size: string,\n): { aspectRatio: string; resolution?: string } | undefined {\n  const match = size.match(/^([\\d.]+:[\\d.]+|auto)(?:_(.+))?$/)\n  const [, aspectRatio, resolution] = match ?? []\n  if (aspectRatio === undefined) return undefined\n  return { aspectRatio, ...(resolution !== undefined && { resolution }) }\n}\n\n/**\n * Base provider options for Grok image models\n */\nexport interface GrokImageBaseProviderOptions {\n  /**\n   * A unique identifier representing your end-user.\n   * Can help xAI to monitor and detect abuse.\n   */\n  user?: string\n}\n\n/**\n * Provider options for grok-2-image-1212 model\n */\nexport interface GrokImageProviderOptions extends GrokImageBaseProviderOptions {\n  /**\n   * The quality of the image.\n   * @default 'standard'\n   */\n  quality?: 'standard' | 'hd'\n\n  /**\n   * The format in which generated images are returned.\n   * URLs are only valid for 60 minutes after generation.\n   * @default 'url'\n   */\n  response_format?: 'url' | 'b64_json'\n}\n\n/**\n * Provider options for the grok-imagine image models (generation and\n * image-conditioned editing via xAI's Imagine API).\n */\nexport interface GrokImagineImageProviderOptions extends GrokImageBaseProviderOptions {\n  /**\n   * The format in which generated images are returned.\n   * @default 'url'\n   */\n  response_format?: 'url' | 'b64_json'\n\n  /**\n   * Output resolution.\n   * @default '1k'\n   */\n  resolution?: '1k' | '2k'\n\n  /**\n   * Processing tier for the request.\n   * @default 'default'\n   */\n  service_tier?: 'default' | 'priority'\n}\n\n/**\n * Type-only map from model name to its specific provider options.\n */\nexport type GrokImageModelProviderOptionsByName = {\n  'grok-2-image-1212': GrokImageProviderOptions\n  'grok-imagine-image': GrokImagineImageProviderOptions\n  'grok-imagine-image-quality': GrokImagineImageProviderOptions\n}\n\n/**\n * Type-only map from model name to its supported sizes.\n */\nexport type GrokImageModelSizeByName = {\n  'grok-2-image-1212': GrokImageSize\n  'grok-imagine-image': GrokImagineImageSize\n  'grok-imagine-image-quality': GrokImagineImageSize\n}\n\n/**\n * Per-model prompt input modalities. Imagine API models accept image parts\n * in the prompt (routed to `/v1/images/edits`, up to 3 images, addressed by\n * xAI in request order); grok-2-image is text-to-image only.\n */\nexport type GrokImageModelInputModalitiesByName = {\n  'grok-2-image-1212': readonly []\n  'grok-imagine-image': readonly ['image']\n  'grok-imagine-image-quality': readonly ['image']\n}\n\n/**\n * Internal options interface for validation\n */\ninterface ImageValidationOptions {\n  prompt: string\n  model: string\n}\n\n/**\n * Validates that the provided size is supported by the model.\n * Throws a descriptive error if the size is not supported.\n */\nexport function validateImageSize(\n  model: string,\n  size: string | undefined,\n): void {\n  if (!size) return\n\n  if (isGrokImagineImageModel(model)) {\n    const parsed = parseGrokImagineSize(size)\n    if (\n      !parsed ||\n      !GROK_IMAGINE_ASPECT_RATIOS.includes(parsed.aspectRatio) ||\n      (parsed.resolution !== undefined &&\n        !GROK_IMAGINE_RESOLUTIONS.includes(parsed.resolution))\n    ) {\n      throw new Error(\n        `Size \"${size}\" is not supported by model \"${model}\". ` +\n          `Expected an aspect ratio (${GROK_IMAGINE_ASPECT_RATIOS.join(', ')}) ` +\n          `optionally suffixed with a resolution (\"16:9_2k\"; resolutions: ${GROK_IMAGINE_RESOLUTIONS.join(', ')}).`,\n      )\n    }\n    return\n  }\n\n  const validSizes: Record<string, Array<string>> = {\n    'grok-2-image-1212': ['1024x1024', '1536x1024', '1024x1536'],\n  }\n\n  const modelSizes = validSizes[model]\n  if (!modelSizes) {\n    throw new Error(`Unknown image model: ${model}`)\n  }\n\n  if (!modelSizes.includes(size)) {\n    throw new Error(\n      `Size \"${size}\" is not supported by model \"${model}\". ` +\n        `Supported sizes: ${modelSizes.join(', ')}`,\n    )\n  }\n}\n\n/**\n * Validates that the number of images is within bounds for the model.\n */\nexport function validateNumberOfImages(\n  _model: string,\n  numberOfImages: number | undefined,\n): void {\n  if (numberOfImages === undefined) return\n\n  // grok-2-image-1212 supports 1-10 images per request\n  if (numberOfImages < 1 || numberOfImages > 10) {\n    throw new Error(\n      `Number of images must be between 1 and 10. Requested: ${numberOfImages}`,\n    )\n  }\n}\n\nexport const validatePrompt = (options: ImageValidationOptions) => {\n  if (options.prompt.length === 0) {\n    throw new Error('Prompt cannot be empty.')\n  }\n  // Grok image model supports up to 4000 characters\n  if (options.prompt.length > 4000) {\n    throw new Error(\n      'For grok-2-image-1212, prompt length must be less than or equal to 4000 characters.',\n    )\n  }\n}\n"],"mappings":";AA+CA,IAAM,6BAAoD;CACxD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,IAAM,2BAAkD,CAAC,MAAM,IAAI;;;;;;AAOnE,SAAgB,wBAAwB,OAAwB;CAC9D,OAAO,MAAM,WAAW,oBAAoB;AAC9C;;;;;;;AAQA,SAAgB,qBACd,MAC0D;CAE1D,MAAM,GAAG,aAAa,cADR,KAAK,MAAM,kCACW,KAAS,CAAC;CAC9C,IAAI,gBAAgB,KAAA,GAAW,OAAO,KAAA;CACtC,OAAO;EAAE;EAAa,GAAI,eAAe,KAAA,KAAa,EAAE,WAAW;CAAG;AACxE;;;;;AAgGA,SAAgB,kBACd,OACA,MACM;CACN,IAAI,CAAC,MAAM;CAEX,IAAI,wBAAwB,KAAK,GAAG;EAClC,MAAM,SAAS,qBAAqB,IAAI;EACxC,IACE,CAAC,UACD,CAAC,2BAA2B,SAAS,OAAO,WAAW,KACtD,OAAO,eAAe,KAAA,KACrB,CAAC,yBAAyB,SAAS,OAAO,UAAU,GAEtD,MAAM,IAAI,MACR,SAAS,KAAK,+BAA+B,MAAM,+BACpB,2BAA2B,KAAK,IAAI,EAAE,mEACD,yBAAyB,KAAK,IAAI,EAAE,GAC1G;EAEF;CACF;CAMA,MAAM,aAAa,EAHjB,qBAAqB;EAAC;EAAa;EAAa;CAAW,EAG1C,EAAW;CAC9B,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,wBAAwB,OAAO;CAGjD,IAAI,CAAC,WAAW,SAAS,IAAI,GAC3B,MAAM,IAAI,MACR,SAAS,KAAK,+BAA+B,MAAM,sBAC7B,WAAW,KAAK,IAAI,GAC5C;AAEJ;;;;AAKA,SAAgB,uBACd,QACA,gBACM;CACN,IAAI,mBAAmB,KAAA,GAAW;CAGlC,IAAI,iBAAiB,KAAK,iBAAiB,IACzC,MAAM,IAAI,MACR,yDAAyD,gBAC3D;AAEJ;AAEA,IAAa,kBAAkB,YAAoC;CACjE,IAAI,QAAQ,OAAO,WAAW,GAC5B,MAAM,IAAI,MAAM,yBAAyB;CAG3C,IAAI,QAAQ,OAAO,SAAS,KAC1B,MAAM,IAAI,MACR,qFACF;AAEJ"}

package/dist/esm/index.js

@@ -1,40 +1,12 @@
 import { GrokTextAdapter, createGrokText, grokText } from "./adapters/text.js";
 import { createGrokSummarize, grokSummarize } from "./adapters/summarize.js";
 import { GrokImageAdapter, createGrokImage, grokImage } from "./adapters/image.js";
-import { GrokVideoAdapter, createGrokVideo, grokVideo } from "./adapters/video.js";
 import { GROK_VIDEO_DURATIONS, getGrokVideoDurationOptions } from "./video/video-provider-options.js";
+import { GrokVideoAdapter, createGrokVideo, grokVideo } from "./adapters/video.js";
 import { GrokSpeechAdapter, createGrokSpeech, grokSpeech } from "./adapters/tts.js";
 import { GrokTranscriptionAdapter, createGrokTranscription, grokTranscription } from "./adapters/transcription.js";
 import { GROK_CHAT_MODELS, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_MODELS } from "./model-meta.js";
 import { grokRealtimeToken } from "./realtime/token.js";
 import { grokRealtime } from "./realtime/adapter.js";
-export {
-  GROK_CHAT_MODELS,
-  GROK_IMAGE_MODELS,
-  GROK_REALTIME_MODELS,
-  GROK_TRANSCRIPTION_MODELS,
-  GROK_TTS_MODELS,
-  GROK_VIDEO_DURATIONS,
-  GROK_VIDEO_MODELS,
-  GrokImageAdapter,
-  GrokSpeechAdapter,
-  GrokTextAdapter,
-  GrokTranscriptionAdapter,
-  GrokVideoAdapter,
-  createGrokImage,
-  createGrokSpeech,
-  createGrokSummarize,
-  createGrokText,
-  createGrokTranscription,
-  createGrokVideo,
-  getGrokVideoDurationOptions,
-  grokImage,
-  grokRealtime,
-  grokRealtimeToken,
-  grokSpeech,
-  grokSummarize,
-  grokText,
-  grokTranscription,
-  grokVideo
-};
-//# sourceMappingURL=index.js.map
+import "./realtime/index.js";
+export { GROK_CHAT_MODELS, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_DURATIONS, GROK_VIDEO_MODELS, GrokImageAdapter, GrokSpeechAdapter, GrokTextAdapter, GrokTranscriptionAdapter, GrokVideoAdapter, createGrokImage, createGrokSpeech, createGrokSummarize, createGrokText, createGrokTranscription, createGrokVideo, getGrokVideoDurationOptions, grokImage, grokRealtime, grokRealtimeToken, grokSpeech, grokSummarize, grokText, grokTranscription, grokVideo };

package/dist/esm/model-meta.js

@@ -1,58 +1,160 @@
-const GROK_2_IMAGE = {
-  name: "grok-2-image-1212"
-};
-const GROK_IMAGINE_IMAGE = {
-  name: "grok-imagine-image"
+//#region src/model-meta.ts
+var GROK_RESPONSES_TOOLS = [
+	"web_search",
+	"x_search",
+	"file_search",
+	"mcp"
+];
+var GROK_2_IMAGE = {
+	name: "grok-2-image-1212",
+	supports: {
+		input: ["text"],
+		output: ["image"]
+	},
+	pricing: {
+		input: { normal: .07 },
+		output: { normal: .07 }
+	}
 };
-const GROK_IMAGINE_IMAGE_QUALITY = {
-  name: "grok-imagine-image-quality"
+var GROK_IMAGINE_IMAGE = {
+	name: "grok-imagine-image",
+	supports: {
+		input: ["text", "image"],
+		output: ["image"]
+	},
+	pricing: {
+		input: { normal: 0 },
+		output: { normal: .02 }
+	}
 };
-const GROK_IMAGINE_VIDEO = {
-  name: "grok-imagine-video"
+var GROK_IMAGINE_IMAGE_QUALITY = {
+	name: "grok-imagine-image-quality",
+	supports: {
+		input: ["text", "image"],
+		output: ["image"]
+	},
+	pricing: {
+		input: { normal: 0 },
+		output: { normal: .05 }
+	}
 };
-const GROK_IMAGINE_VIDEO_1_5 = {
-  name: "grok-imagine-video-1.5"
+var GROK_IMAGINE_VIDEO = {
+	name: "grok-imagine-video",
+	supports: {
+		input: ["text", "image"],
+		output: ["video", "audio"]
+	},
+	pricing: {
+		input: { normal: 0 },
+		output: { normal: .05 }
+	}
 };
-const GROK_4_3 = {
-  name: "grok-4.3"
+var GROK_IMAGINE_VIDEO_1_5 = {
+	name: "grok-imagine-video-1.5",
+	supports: {
+		input: ["text", "image"],
+		output: ["video", "audio"]
+	},
+	pricing: {
+		input: { normal: 0 },
+		output: { normal: .08 }
+	}
 };
-const GROK_BUILD_0_1 = {
-  name: "grok-build-0.1"
+var GROK_4_3 = {
+	name: "grok-4.3",
+	context_window: 1e6,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: [
+			"reasoning",
+			"structured_outputs",
+			"tool_calling"
+		],
+		tools: GROK_RESPONSES_TOOLS
+	},
+	pricing: {
+		input: {
+			normal: 1.25,
+			cached: .2
+		},
+		output: { normal: 2.5 }
+	}
 };
-const GROK_CHAT_MODELS = [GROK_BUILD_0_1.name, GROK_4_3.name];
-const GROK_IMAGE_MODELS = [
-  GROK_2_IMAGE.name,
-  GROK_IMAGINE_IMAGE.name,
-  GROK_IMAGINE_IMAGE_QUALITY.name
+/**
+* Grok chat models supported by the Responses adapter.
+*/
+var GROK_CHAT_MODELS = [{
+	name: "grok-build-0.1",
+	context_window: 256e3,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: [
+			"reasoning",
+			"structured_outputs",
+			"tool_calling"
+		],
+		tools: GROK_RESPONSES_TOOLS
+	},
+	pricing: {
+		input: {
+			normal: 1,
+			cached: .2
+		},
+		output: { normal: 2 }
+	}
+}.name, GROK_4_3.name];
+/**
+* Grok Image Generation Models
+*/
+var GROK_IMAGE_MODELS = [
+	GROK_2_IMAGE.name,
+	GROK_IMAGINE_IMAGE.name,
+	GROK_IMAGINE_IMAGE_QUALITY.name
 ];
-const GROK_VIDEO_MODELS = [
-  GROK_IMAGINE_VIDEO.name,
-  GROK_IMAGINE_VIDEO_1_5.name
-];
-const GROK_TTS = {
-  name: "grok-tts"
+/**
+* Grok Video Generation Models (xAI Imagine API)
+*
+* @experimental Video generation is an experimental feature and may change.
+*/
+var GROK_VIDEO_MODELS = [GROK_IMAGINE_VIDEO.name, GROK_IMAGINE_VIDEO_1_5.name];
+var GROK_TTS = {
+	name: "grok-tts",
+	supports: {
+		input: ["text"],
+		output: ["audio"]
+	}
 };
-const GROK_STT = {
-  name: "grok-stt"
+var GROK_STT = {
+	name: "grok-stt",
+	supports: {
+		input: ["audio"],
+		output: ["text"]
+	}
 };
-const GROK_VOICE_FAST_1 = {
-  name: "grok-voice-fast-1.0"
+var GROK_VOICE_FAST_1 = {
+	name: "grok-voice-fast-1.0",
+	supports: {
+		input: ["audio", "text"],
+		output: ["audio", "text"],
+		capabilities: ["tool_calling"],
+		tools: []
+	}
 };
-const GROK_VOICE_THINK_FAST_1 = {
-  name: "grok-voice-think-fast-1.0"
+var GROK_VOICE_THINK_FAST_1 = {
+	name: "grok-voice-think-fast-1.0",
+	supports: {
+		input: ["audio", "text"],
+		output: ["audio", "text"],
+		capabilities: ["reasoning", "tool_calling"],
+		tools: []
+	}
 };
-const GROK_TTS_MODELS = [GROK_TTS.name];
-const GROK_TRANSCRIPTION_MODELS = [GROK_STT.name];
-const GROK_REALTIME_MODELS = [
-  GROK_VOICE_FAST_1.name,
-  GROK_VOICE_THINK_FAST_1.name
-];
-export {
-  GROK_CHAT_MODELS,
-  GROK_IMAGE_MODELS,
-  GROK_REALTIME_MODELS,
-  GROK_TRANSCRIPTION_MODELS,
-  GROK_TTS_MODELS,
-  GROK_VIDEO_MODELS
-};
-//# sourceMappingURL=model-meta.js.map
+var GROK_TTS_MODELS = [GROK_TTS.name];
+var GROK_TRANSCRIPTION_MODELS = [GROK_STT.name];
+var GROK_REALTIME_MODELS = [GROK_VOICE_FAST_1.name, GROK_VOICE_THINK_FAST_1.name];
+//#endregion
+export { GROK_CHAT_MODELS, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_MODELS };
+
+//# sourceMappingURL=model-meta.js.map

package/dist/esm/model-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["/**\n * Model metadata interface for documentation and type inference\n */\nimport type {\n  GrokBuildProviderOptions,\n  GrokTextProviderOptions,\n} from './text/text-provider-options'\n\ninterface ModelMeta {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<'reasoning' | 'tool_calling' | 'structured_outputs'>\n    tools?: ReadonlyArray<GrokProviderToolKind>\n  }\n  max_input_tokens?: number\n  max_output_tokens?: number\n  context_window?: number\n  knowledge_cutoff?: string\n  pricing?: {\n    input: {\n      normal: number\n      cached?: number\n    }\n    output: {\n      normal: number\n    }\n  }\n}\n\nexport type GrokProviderToolKind =\n  | 'web_search'\n  | 'x_search'\n  | 'file_search'\n  | 'mcp'\n\nconst GROK_RESPONSES_TOOLS = [\n  'web_search',\n  'x_search',\n  'file_search',\n  'mcp',\n] as const satisfies ReadonlyArray<GrokProviderToolKind>\n\nconst GROK_2_IMAGE = {\n  name: 'grok-2-image-1212',\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0.07,\n    },\n    output: {\n      normal: 0.07,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API image models. Pricing is per generated image (output only).\nconst GROK_IMAGINE_IMAGE = {\n  name: 'grok-imagine-image',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.02,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_IMAGE_QUALITY = {\n  name: 'grok-imagine-image-quality',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API video models. Pricing is per second of generated video\n// (output only); generated videos carry an audio track.\n//\n// grok-imagine-video (v1.0) supports both text-to-video (a starting image is\n// optional) and image-to-video. grok-imagine-video-1.5 is image-to-video\n// only: a starting-frame image is required (the text prompt describes the\n// desired motion) — its text-to-video is rejected by the API.\nconst GROK_IMAGINE_VIDEO = {\n  name: 'grok-imagine-video',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_VIDEO_1_5 = {\n  name: 'grok-imagine-video-1.5',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.08,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_3 = {\n  name: 'grok-4.3',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1.25,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_BUILD_0_1 = {\n  name: 'grok-build-0.1',\n  context_window: 256_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Grok chat models supported by the Responses adapter.\n */\nexport const GROK_CHAT_MODELS = [GROK_BUILD_0_1.name, GROK_4_3.name] as const\n\n/**\n * Grok Image Generation Models\n */\nexport const GROK_IMAGE_MODELS = [\n  GROK_2_IMAGE.name,\n  GROK_IMAGINE_IMAGE.name,\n  GROK_IMAGINE_IMAGE_QUALITY.name,\n] as const\n\n/**\n * Grok Video Generation Models (xAI Imagine API)\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const GROK_VIDEO_MODELS = [\n  GROK_IMAGINE_VIDEO.name,\n  GROK_IMAGINE_VIDEO_1_5.name,\n] as const\n\n// xAI's `/v1/tts` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's `TTSOptions.model`\n// contract and provides a stable value for logging and fixture matching.\nconst GROK_TTS = {\n  name: 'grok-tts',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n  },\n} as const satisfies ModelMeta\n\n// xAI's `/v1/stt` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's\n// `TranscriptionOptions.model` contract.\nconst GROK_STT = {\n  name: 'grok-stt',\n  supports: {\n    input: ['audio'],\n    output: ['text'],\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_FAST_1 = {\n  name: 'grok-voice-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_THINK_FAST_1 = {\n  name: 'grok-voice-think-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['reasoning', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nexport const GROK_TTS_MODELS = [GROK_TTS.name] as const\n\nexport const GROK_TRANSCRIPTION_MODELS = [GROK_STT.name] as const\n\nexport const GROK_REALTIME_MODELS = [\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\nexport type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]\nexport type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number]\nexport type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number]\nexport type GrokTTSModel = (typeof GROK_TTS_MODELS)[number]\nexport type GrokTranscriptionModel = (typeof GROK_TRANSCRIPTION_MODELS)[number]\nexport type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number]\n\n/**\n * Type-only map from Grok chat model name to its supported input modalities.\n * Used for type inference when constructing multimodal messages.\n */\nexport type GrokModelInputModalitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.input\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input\n}\n\n/**\n * Type-only map from Grok chat model name to its supported provider tools.\n * Keeps Grok provider-tool factories type-checked against the models that\n * advertise xAI Responses server-side tools.\n */\nexport type GrokChatModelToolCapabilitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.tools\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools\n}\n\nexport type GrokProviderOptions = GrokTextProviderOptions\n\n/**\n * Type-only map from Grok chat model name to its provider options type.\n */\nexport type GrokChatModelProviderOptionsByName = {\n  [GROK_4_3.name]: GrokProviderOptions\n  [GROK_BUILD_0_1.name]: GrokBuildProviderOptions\n}\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GrokChatModelProviderOptionsByName\n    ? GrokChatModelProviderOptionsByName[TModel]\n    : GrokProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GrokModelInputModalitiesByName\n    ? GrokModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"names":[],"mappings":"AA4CA,MAAM,eAAe;AAAA,EACnB,MAAM;AAaR;AAGA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAaR;AAEA,MAAM,6BAA6B;AAAA,EACjC,MAAM;AAaR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAcR;AAEA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAcR;AAEA,MAAM,WAAW;AAAA,EACf,MAAM;AAiBR;AAEA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAiBR;AAKO,MAAM,mBAAmB,CAAC,eAAe,MAAM,SAAS,IAAI;AAK5D,MAAM,oBAAoB;AAAA,EAC/B,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,2BAA2B;AAC7B;AAOO,MAAM,oBAAoB;AAAA,EAC/B,mBAAmB;AAAA,EACnB,uBAAuB;AACzB;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAEA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAOR;AAEA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAOR;AAEO,MAAM,kBAAkB,CAAC,SAAS,IAAI;AAEtC,MAAM,4BAA4B,CAAC,SAAS,IAAI;AAEhD,MAAM,uBAAuB;AAAA,EAClC,kBAAkB;AAAA,EAClB,wBAAwB;AAC1B;"}
+{"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["/**\n * Model metadata interface for documentation and type inference\n */\nimport type {\n  GrokBuildProviderOptions,\n  GrokTextProviderOptions,\n} from './text/text-provider-options'\n\ninterface ModelMeta {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<'reasoning' | 'tool_calling' | 'structured_outputs'>\n    tools?: ReadonlyArray<GrokProviderToolKind>\n  }\n  max_input_tokens?: number\n  max_output_tokens?: number\n  context_window?: number\n  knowledge_cutoff?: string\n  pricing?: {\n    input: {\n      normal: number\n      cached?: number\n    }\n    output: {\n      normal: number\n    }\n  }\n}\n\nexport type GrokProviderToolKind =\n  | 'web_search'\n  | 'x_search'\n  | 'file_search'\n  | 'mcp'\n\nconst GROK_RESPONSES_TOOLS = [\n  'web_search',\n  'x_search',\n  'file_search',\n  'mcp',\n] as const satisfies ReadonlyArray<GrokProviderToolKind>\n\nconst GROK_2_IMAGE = {\n  name: 'grok-2-image-1212',\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0.07,\n    },\n    output: {\n      normal: 0.07,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API image models. Pricing is per generated image (output only).\nconst GROK_IMAGINE_IMAGE = {\n  name: 'grok-imagine-image',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.02,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_IMAGE_QUALITY = {\n  name: 'grok-imagine-image-quality',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API video models. Pricing is per second of generated video\n// (output only); generated videos carry an audio track.\n//\n// grok-imagine-video (v1.0) supports both text-to-video (a starting image is\n// optional) and image-to-video. grok-imagine-video-1.5 is image-to-video\n// only: a starting-frame image is required (the text prompt describes the\n// desired motion) — its text-to-video is rejected by the API.\nconst GROK_IMAGINE_VIDEO = {\n  name: 'grok-imagine-video',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_VIDEO_1_5 = {\n  name: 'grok-imagine-video-1.5',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.08,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_3 = {\n  name: 'grok-4.3',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1.25,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_BUILD_0_1 = {\n  name: 'grok-build-0.1',\n  context_window: 256_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Grok chat models supported by the Responses adapter.\n */\nexport const GROK_CHAT_MODELS = [GROK_BUILD_0_1.name, GROK_4_3.name] as const\n\n/**\n * Grok Image Generation Models\n */\nexport const GROK_IMAGE_MODELS = [\n  GROK_2_IMAGE.name,\n  GROK_IMAGINE_IMAGE.name,\n  GROK_IMAGINE_IMAGE_QUALITY.name,\n] as const\n\n/**\n * Grok Video Generation Models (xAI Imagine API)\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const GROK_VIDEO_MODELS = [\n  GROK_IMAGINE_VIDEO.name,\n  GROK_IMAGINE_VIDEO_1_5.name,\n] as const\n\n// xAI's `/v1/tts` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's `TTSOptions.model`\n// contract and provides a stable value for logging and fixture matching.\nconst GROK_TTS = {\n  name: 'grok-tts',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n  },\n} as const satisfies ModelMeta\n\n// xAI's `/v1/stt` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's\n// `TranscriptionOptions.model` contract.\nconst GROK_STT = {\n  name: 'grok-stt',\n  supports: {\n    input: ['audio'],\n    output: ['text'],\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_FAST_1 = {\n  name: 'grok-voice-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_THINK_FAST_1 = {\n  name: 'grok-voice-think-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['reasoning', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nexport const GROK_TTS_MODELS = [GROK_TTS.name] as const\n\nexport const GROK_TRANSCRIPTION_MODELS = [GROK_STT.name] as const\n\nexport const GROK_REALTIME_MODELS = [\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\nexport type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]\nexport type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number]\nexport type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number]\nexport type GrokTTSModel = (typeof GROK_TTS_MODELS)[number]\nexport type GrokTranscriptionModel = (typeof GROK_TRANSCRIPTION_MODELS)[number]\nexport type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number]\n\n/**\n * Type-only map from Grok chat model name to its supported input modalities.\n * Used for type inference when constructing multimodal messages.\n */\nexport type GrokModelInputModalitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.input\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input\n}\n\n/**\n * Type-only map from Grok chat model name to its supported provider tools.\n * Keeps Grok provider-tool factories type-checked against the models that\n * advertise xAI Responses server-side tools.\n */\nexport type GrokChatModelToolCapabilitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.tools\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools\n}\n\nexport type GrokProviderOptions = GrokTextProviderOptions\n\n/**\n * Type-only map from Grok chat model name to its provider options type.\n */\nexport type GrokChatModelProviderOptionsByName = {\n  [GROK_4_3.name]: GrokProviderOptions\n  [GROK_BUILD_0_1.name]: GrokBuildProviderOptions\n}\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GrokChatModelProviderOptionsByName\n    ? GrokChatModelProviderOptionsByName[TModel]\n    : GrokProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GrokModelInputModalitiesByName\n    ? GrokModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"mappings":"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"}