@tanstack/ai-gemini 0.16.2 → 0.17.0

package/dist/esm/image/image-provider-options.d.ts

@@ -130,6 +130,17 @@ export type GeminiImageModelSizeByName = {
 } & {
     [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: GeminiImageSize;
 };
+/**
+ * Per-model prompt input modalities. Gemini-native image models accept image
+ * parts in the multimodal prompt (image-conditioned generation via
+ * generateContent); Imagen models are strictly text-to-image, so their
+ * `prompt` is constrained to text at compile time.
+ */
+export type GeminiImageModelInputModalitiesByName = {
+    [K in GeminiNativeImageModels]: readonly ['image'];
+} & {
+    [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: readonly [];
+};
 /**
  * Valid sizes for Gemini Imagen models
  * Gemini uses aspect ratios, but we map common WIDTHxHEIGHT formats to aspect ratios

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":["import type { GeminiImageModels } from '../model-meta'\nimport type {\n  ImagePromptLanguage,\n  PersonGeneration,\n  SafetyFilterLevel,\n} from '@google/genai'\n\n// Re-export SDK types so users can use them directly\nexport type { ImagePromptLanguage, PersonGeneration, SafetyFilterLevel }\n\n/**\n * Gemini Imagen aspect ratio options\n * Controls the aspect ratio of generated images\n */\nexport type GeminiAspectRatio =\n  | '1:1'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '9:21'\n  | '21:9'\n\n/**\n * Provider options for Gemini image generation\n * These options match the @google/genai GenerateImagesConfig interface\n * and can be spread directly into the API request.\n */\nexport interface GeminiImageProviderOptions {\n  /**\n   * The aspect ratio of generated images\n   * @default '1:1'\n   */\n  aspectRatio?: GeminiAspectRatio\n\n  /**\n   * Controls whether people can appear in generated images\n   * Use PersonGeneration enum values: DONT_ALLOW, ALLOW_ADULT, ALLOW_ALL\n   * @default 'ALLOW_ADULT'\n   */\n  personGeneration?: PersonGeneration\n\n  /**\n   * Safety filter level for content filtering\n   * Use SafetyFilterLevel enum values\n   */\n  safetyFilterLevel?: SafetyFilterLevel\n\n  /**\n   * Optional seed for reproducible image generation\n   * When the same seed is used with the same prompt and settings,\n   * you should get similar (though not identical) results\n   */\n  seed?: number\n\n  /**\n   * Whether to add a SynthID watermark to generated images\n   * SynthID helps identify AI-generated content\n   * @default true\n   */\n  addWatermark?: boolean\n\n  /**\n   * Language of the prompt\n   * Use ImagePromptLanguage enum values\n   */\n  language?: ImagePromptLanguage\n\n  /**\n   * Negative prompt - what to avoid in the generated image\n   * Not all models support negative prompts\n   */\n  negativePrompt?: string\n\n  /**\n   * Output MIME type for the generated image\n   * @default 'image/png'\n   */\n  outputMimeType?: 'image/png' | 'image/jpeg' | 'image/webp'\n\n  /**\n   * Compression quality for JPEG outputs (0-100)\n   * Higher values mean better quality but larger file sizes\n   * @default 75\n   */\n  outputCompressionQuality?: number\n\n  /**\n   * Controls how much the model adheres to the text prompt\n   * Large values increase output and prompt alignment,\n   * but may compromise image quality\n   */\n  guidanceScale?: number\n\n  /**\n   * Whether to use the prompt rewriting logic\n   */\n  enhancePrompt?: boolean\n\n  /**\n   * Whether to report the safety scores of each generated image\n   * and the positive prompt in the response\n   */\n  includeSafetyAttributes?: boolean\n\n  /**\n   * Whether to include the Responsible AI filter reason\n   * if the image is filtered out of the response\n   */\n  includeRaiReason?: boolean\n\n  /**\n   * Cloud Storage URI used to store the generated images\n   */\n  outputGcsUri?: string\n\n  /**\n   * User specified labels to track billing usage\n   */\n  labels?: Record<string, string>\n}\n\n/**\n * Model-specific provider options mapping\n * Currently all Imagen models use the same options structure\n */\nexport type GeminiImageModelProviderOptionsByName = {\n  [K in GeminiImageModels]: GeminiImageProviderOptions\n}\n\n/**\n * Supported size strings for Gemini Imagen models\n * These map to aspect ratios internally\n */\nexport type GeminiImageSize =\n  | '1024x1024'\n  | '512x512'\n  | '1024x768'\n  | '1536x1024'\n  | '1792x1024'\n  | '1920x1080'\n  | '768x1024'\n  | '1024x1536'\n  | '1024x1792'\n  | '1080x1920'\n\n/**\n * Aspect ratios supported by Gemini native image models (via generateContent API).\n * Matches the SDK's ImageConfig.aspectRatio values.\n */\nexport type GeminiNativeImageAspectRatio =\n  | '1:1'\n  | '2:3'\n  | '3:2'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '21:9'\n\n/**\n * Resolution tiers for Gemini native image models.\n * Matches the SDK's ImageConfig.imageSize values.\n */\nexport type GeminiNativeImageResolution = '1K' | '2K' | '4K'\n\n/**\n * Template literal size type for Gemini native image models: \"16:9_4K\", \"1:1_2K\", etc.\n */\nexport type GeminiNativeImageSize =\n  `${GeminiNativeImageAspectRatio}_${GeminiNativeImageResolution}`\n\n/**\n * Gemini native image models that use the generateContent API path.\n * These models support template literal sizes (aspectRatio_resolution).\n */\nexport type GeminiNativeImageModels =\n  | 'gemini-3.1-flash-image-preview'\n  | 'gemini-3-pro-image-preview'\n  | 'gemini-2.5-flash-image'\n\n/**\n * Model-specific size options mapping.\n * Gemini native image models use template literal sizes, Imagen models use pixel sizes.\n */\nexport type GeminiImageModelSizeByName = {\n  [K in GeminiNativeImageModels]: GeminiNativeImageSize\n} & {\n  [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: GeminiImageSize\n}\n\n/**\n * Valid sizes for Gemini Imagen models\n * Gemini uses aspect ratios, but we map common WIDTHxHEIGHT formats to aspect ratios\n * These are approximate mappings based on common image dimensions\n */\nexport const GEMINI_SIZE_TO_ASPECT_RATIO: Record<string, GeminiAspectRatio> = {\n  // Square\n  '1024x1024': '1:1',\n  '512x512': '1:1',\n  // Landscape\n  '1024x768': '4:3',\n  '1536x1024': '4:3',\n  '1792x1024': '16:9',\n  '1920x1080': '16:9',\n  // Portrait\n  '768x1024': '3:4',\n  '1024x1536': '3:4', // Inverted\n  '1024x1792': '9:16',\n  '1080x1920': '9:16',\n}\n\n/**\n * Maps a WIDTHxHEIGHT size string to a Gemini aspect ratio\n * Returns undefined if the size cannot be mapped\n */\nexport function sizeToAspectRatio(\n  size: string | undefined,\n): GeminiAspectRatio | undefined {\n  if (!size) return undefined\n  return GEMINI_SIZE_TO_ASPECT_RATIO[size]\n}\n\n/**\n * Validates that the provided size can be mapped to an aspect ratio\n * Throws an error if the size is invalid\n */\nexport function validateImageSize(\n  model: string,\n  size: string | undefined,\n): void {\n  if (!size) return\n\n  const aspectRatio = sizeToAspectRatio(size)\n  if (!aspectRatio) {\n    const validSizes = Object.keys(GEMINI_SIZE_TO_ASPECT_RATIO)\n    throw new Error(\n      `Invalid size \"${size}\" for model \"${model}\". ` +\n        `Gemini Imagen uses aspect ratios. Valid sizes that map to aspect ratios: ${validSizes.join(', ')}. ` +\n        `Alternatively, use providerOptions.aspectRatio directly with values: 1:1, 3:4, 4:3, 9:16, 16:9, 9:21, 21:9`,\n    )\n  }\n}\n\n/**\n * Per-model caps on images per request.\n * Imagen 3 and the Imagen 4 family all support up to 4 images per request\n * via the Gemini API (the rumored 8-image tier is Vertex-only and isn't\n * reachable through @google/genai today). Unknown models fall through to\n * the shared cap defined below.\n *\n * @see https://ai.google.dev/gemini-api/docs/imagen\n */\nconst IMAGEN_MAX_IMAGES_BY_MODEL: Record<string, number> = {\n  'imagen-3.0-generate-002': 4,\n  'imagen-4.0-generate-001': 4,\n  'imagen-4.0-ultra-generate-001': 4,\n  'imagen-4.0-fast-generate-001': 4,\n}\n\nconst DEFAULT_IMAGEN_MAX_IMAGES = 4\n\n/**\n * Validates the number of images requested against the model's known cap.\n * Uses a per-model table where available and falls back to the shared\n * default otherwise — no more \"some support up to 8\" comments that don't\n * match the error message.\n */\nexport function validateNumberOfImages(\n  model: string,\n  numberOfImages: number | undefined,\n): void {\n  if (numberOfImages === undefined) return\n\n  const maxImages =\n    IMAGEN_MAX_IMAGES_BY_MODEL[model] ?? DEFAULT_IMAGEN_MAX_IMAGES\n  if (numberOfImages < 1 || numberOfImages > maxImages) {\n    throw new Error(\n      `Invalid numberOfImages \"${numberOfImages}\" for model \"${model}\". ` +\n        `Must be between 1 and ${maxImages}.`,\n    )\n  }\n}\n\n/**\n * Validates the prompt is not empty\n */\nexport function validatePrompt(options: {\n  prompt: string\n  model: string\n}): void {\n  const { prompt, model } = options\n  if (!prompt || prompt.trim().length === 0) {\n    throw new Error(`Prompt cannot be empty for model \"${model}\".`)\n  }\n}\n\n/**\n * Parses a Gemini native image size string into its components.\n * Format: \"aspectRatio_resolution\" e.g. \"16:9_4K\" → { aspectRatio: \"16:9\", resolution: \"4K\" }\n */\nexport function parseNativeImageSize(\n  size: string,\n): { aspectRatio: string; resolution: string } | undefined {\n  const match = size.match(/^(\\d+:\\d+)_(.+)$/)\n  const [, aspectRatio, resolution] = match ?? []\n  if (aspectRatio === undefined || resolution === undefined) return undefined\n  return { aspectRatio, resolution }\n}\n"],"names":[],"mappings":"AAoMO,MAAM,8BAAiE;AAAA;AAAA,EAE5E,aAAa;AAAA,EACb,WAAW;AAAA;AAAA,EAEX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AAAA;AAAA,EAEb,YAAY;AAAA,EACZ,aAAa;AAAA;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AACf;AAMO,SAAS,kBACd,MAC+B;AAC/B,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,4BAA4B,IAAI;AACzC;AAMO,SAAS,kBACd,OACA,MACM;AACN,MAAI,CAAC,KAAM;AAEX,QAAM,cAAc,kBAAkB,IAAI;AAC1C,MAAI,CAAC,aAAa;AAChB,UAAM,aAAa,OAAO,KAAK,2BAA2B;AAC1D,UAAM,IAAI;AAAA,MACR,iBAAiB,IAAI,gBAAgB,KAAK,+EACoC,WAAW,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAGvG;AACF;AAWA,MAAM,6BAAqD;AAAA,EACzD,2BAA2B;AAAA,EAC3B,2BAA2B;AAAA,EAC3B,iCAAiC;AAAA,EACjC,gCAAgC;AAClC;AAEA,MAAM,4BAA4B;AAQ3B,SAAS,uBACd,OACA,gBACM;AACN,MAAI,mBAAmB,OAAW;AAElC,QAAM,YACJ,2BAA2B,KAAK,KAAK;AACvC,MAAI,iBAAiB,KAAK,iBAAiB,WAAW;AACpD,UAAM,IAAI;AAAA,MACR,2BAA2B,cAAc,gBAAgB,KAAK,4BACnC,SAAS;AAAA,IAAA;AAAA,EAExC;AACF;AAKO,SAAS,eAAe,SAGtB;AACP,QAAM,EAAE,QAAQ,MAAA,IAAU;AAC1B,MAAI,CAAC,UAAU,OAAO,KAAA,EAAO,WAAW,GAAG;AACzC,UAAM,IAAI,MAAM,qCAAqC,KAAK,IAAI;AAAA,EAChE;AACF;AAMO,SAAS,qBACd,MACyD;AACzD,QAAM,QAAQ,KAAK,MAAM,kBAAkB;AAC3C,QAAM,GAAG,aAAa,UAAU,IAAI,SAAS,CAAA;AAC7C,MAAI,gBAAgB,UAAa,eAAe,OAAW,QAAO;AAClE,SAAO,EAAE,aAAa,WAAA;AACxB;"}
+{"version":3,"file":"image-provider-options.js","sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { GeminiImageModels } from '../model-meta'\nimport type {\n  ImagePromptLanguage,\n  PersonGeneration,\n  SafetyFilterLevel,\n} from '@google/genai'\n\n// Re-export SDK types so users can use them directly\nexport type { ImagePromptLanguage, PersonGeneration, SafetyFilterLevel }\n\n/**\n * Gemini Imagen aspect ratio options\n * Controls the aspect ratio of generated images\n */\nexport type GeminiAspectRatio =\n  | '1:1'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '9:21'\n  | '21:9'\n\n/**\n * Provider options for Gemini image generation\n * These options match the @google/genai GenerateImagesConfig interface\n * and can be spread directly into the API request.\n */\nexport interface GeminiImageProviderOptions {\n  /**\n   * The aspect ratio of generated images\n   * @default '1:1'\n   */\n  aspectRatio?: GeminiAspectRatio\n\n  /**\n   * Controls whether people can appear in generated images\n   * Use PersonGeneration enum values: DONT_ALLOW, ALLOW_ADULT, ALLOW_ALL\n   * @default 'ALLOW_ADULT'\n   */\n  personGeneration?: PersonGeneration\n\n  /**\n   * Safety filter level for content filtering\n   * Use SafetyFilterLevel enum values\n   */\n  safetyFilterLevel?: SafetyFilterLevel\n\n  /**\n   * Optional seed for reproducible image generation\n   * When the same seed is used with the same prompt and settings,\n   * you should get similar (though not identical) results\n   */\n  seed?: number\n\n  /**\n   * Whether to add a SynthID watermark to generated images\n   * SynthID helps identify AI-generated content\n   * @default true\n   */\n  addWatermark?: boolean\n\n  /**\n   * Language of the prompt\n   * Use ImagePromptLanguage enum values\n   */\n  language?: ImagePromptLanguage\n\n  /**\n   * Negative prompt - what to avoid in the generated image\n   * Not all models support negative prompts\n   */\n  negativePrompt?: string\n\n  /**\n   * Output MIME type for the generated image\n   * @default 'image/png'\n   */\n  outputMimeType?: 'image/png' | 'image/jpeg' | 'image/webp'\n\n  /**\n   * Compression quality for JPEG outputs (0-100)\n   * Higher values mean better quality but larger file sizes\n   * @default 75\n   */\n  outputCompressionQuality?: number\n\n  /**\n   * Controls how much the model adheres to the text prompt\n   * Large values increase output and prompt alignment,\n   * but may compromise image quality\n   */\n  guidanceScale?: number\n\n  /**\n   * Whether to use the prompt rewriting logic\n   */\n  enhancePrompt?: boolean\n\n  /**\n   * Whether to report the safety scores of each generated image\n   * and the positive prompt in the response\n   */\n  includeSafetyAttributes?: boolean\n\n  /**\n   * Whether to include the Responsible AI filter reason\n   * if the image is filtered out of the response\n   */\n  includeRaiReason?: boolean\n\n  /**\n   * Cloud Storage URI used to store the generated images\n   */\n  outputGcsUri?: string\n\n  /**\n   * User specified labels to track billing usage\n   */\n  labels?: Record<string, string>\n}\n\n/**\n * Model-specific provider options mapping\n * Currently all Imagen models use the same options structure\n */\nexport type GeminiImageModelProviderOptionsByName = {\n  [K in GeminiImageModels]: GeminiImageProviderOptions\n}\n\n/**\n * Supported size strings for Gemini Imagen models\n * These map to aspect ratios internally\n */\nexport type GeminiImageSize =\n  | '1024x1024'\n  | '512x512'\n  | '1024x768'\n  | '1536x1024'\n  | '1792x1024'\n  | '1920x1080'\n  | '768x1024'\n  | '1024x1536'\n  | '1024x1792'\n  | '1080x1920'\n\n/**\n * Aspect ratios supported by Gemini native image models (via generateContent API).\n * Matches the SDK's ImageConfig.aspectRatio values.\n */\nexport type GeminiNativeImageAspectRatio =\n  | '1:1'\n  | '2:3'\n  | '3:2'\n  | '3:4'\n  | '4:3'\n  | '9:16'\n  | '16:9'\n  | '21:9'\n\n/**\n * Resolution tiers for Gemini native image models.\n * Matches the SDK's ImageConfig.imageSize values.\n */\nexport type GeminiNativeImageResolution = '1K' | '2K' | '4K'\n\n/**\n * Template literal size type for Gemini native image models: \"16:9_4K\", \"1:1_2K\", etc.\n */\nexport type GeminiNativeImageSize =\n  `${GeminiNativeImageAspectRatio}_${GeminiNativeImageResolution}`\n\n/**\n * Gemini native image models that use the generateContent API path.\n * These models support template literal sizes (aspectRatio_resolution).\n */\nexport type GeminiNativeImageModels =\n  | 'gemini-3.1-flash-image-preview'\n  | 'gemini-3-pro-image-preview'\n  | 'gemini-2.5-flash-image'\n\n/**\n * Model-specific size options mapping.\n * Gemini native image models use template literal sizes, Imagen models use pixel sizes.\n */\nexport type GeminiImageModelSizeByName = {\n  [K in GeminiNativeImageModels]: GeminiNativeImageSize\n} & {\n  [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: GeminiImageSize\n}\n\n/**\n * Per-model prompt input modalities. Gemini-native image models accept image\n * parts in the multimodal prompt (image-conditioned generation via\n * generateContent); Imagen models are strictly text-to-image, so their\n * `prompt` is constrained to text at compile time.\n */\nexport type GeminiImageModelInputModalitiesByName = {\n  [K in GeminiNativeImageModels]: readonly ['image']\n} & {\n  [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: readonly []\n}\n\n/**\n * Valid sizes for Gemini Imagen models\n * Gemini uses aspect ratios, but we map common WIDTHxHEIGHT formats to aspect ratios\n * These are approximate mappings based on common image dimensions\n */\nexport const GEMINI_SIZE_TO_ASPECT_RATIO: Record<string, GeminiAspectRatio> = {\n  // Square\n  '1024x1024': '1:1',\n  '512x512': '1:1',\n  // Landscape\n  '1024x768': '4:3',\n  '1536x1024': '4:3',\n  '1792x1024': '16:9',\n  '1920x1080': '16:9',\n  // Portrait\n  '768x1024': '3:4',\n  '1024x1536': '3:4', // Inverted\n  '1024x1792': '9:16',\n  '1080x1920': '9:16',\n}\n\n/**\n * Maps a WIDTHxHEIGHT size string to a Gemini aspect ratio\n * Returns undefined if the size cannot be mapped\n */\nexport function sizeToAspectRatio(\n  size: string | undefined,\n): GeminiAspectRatio | undefined {\n  if (!size) return undefined\n  return GEMINI_SIZE_TO_ASPECT_RATIO[size]\n}\n\n/**\n * Validates that the provided size can be mapped to an aspect ratio\n * Throws an error if the size is invalid\n */\nexport function validateImageSize(\n  model: string,\n  size: string | undefined,\n): void {\n  if (!size) return\n\n  const aspectRatio = sizeToAspectRatio(size)\n  if (!aspectRatio) {\n    const validSizes = Object.keys(GEMINI_SIZE_TO_ASPECT_RATIO)\n    throw new Error(\n      `Invalid size \"${size}\" for model \"${model}\". ` +\n        `Gemini Imagen uses aspect ratios. Valid sizes that map to aspect ratios: ${validSizes.join(', ')}. ` +\n        `Alternatively, use providerOptions.aspectRatio directly with values: 1:1, 3:4, 4:3, 9:16, 16:9, 9:21, 21:9`,\n    )\n  }\n}\n\n/**\n * Per-model caps on images per request.\n * Imagen 3 and the Imagen 4 family all support up to 4 images per request\n * via the Gemini API (the rumored 8-image tier is Vertex-only and isn't\n * reachable through @google/genai today). Unknown models fall through to\n * the shared cap defined below.\n *\n * @see https://ai.google.dev/gemini-api/docs/imagen\n */\nconst IMAGEN_MAX_IMAGES_BY_MODEL: Record<string, number> = {\n  'imagen-3.0-generate-002': 4,\n  'imagen-4.0-generate-001': 4,\n  'imagen-4.0-ultra-generate-001': 4,\n  'imagen-4.0-fast-generate-001': 4,\n}\n\nconst DEFAULT_IMAGEN_MAX_IMAGES = 4\n\n/**\n * Validates the number of images requested against the model's known cap.\n * Uses a per-model table where available and falls back to the shared\n * default otherwise — no more \"some support up to 8\" comments that don't\n * match the error message.\n */\nexport function validateNumberOfImages(\n  model: string,\n  numberOfImages: number | undefined,\n): void {\n  if (numberOfImages === undefined) return\n\n  const maxImages =\n    IMAGEN_MAX_IMAGES_BY_MODEL[model] ?? DEFAULT_IMAGEN_MAX_IMAGES\n  if (numberOfImages < 1 || numberOfImages > maxImages) {\n    throw new Error(\n      `Invalid numberOfImages \"${numberOfImages}\" for model \"${model}\". ` +\n        `Must be between 1 and ${maxImages}.`,\n    )\n  }\n}\n\n/**\n * Validates the prompt is not empty\n */\nexport function validatePrompt(options: {\n  prompt: string\n  model: string\n}): void {\n  const { prompt, model } = options\n  if (!prompt || prompt.trim().length === 0) {\n    throw new Error(`Prompt cannot be empty for model \"${model}\".`)\n  }\n}\n\n/**\n * Parses a Gemini native image size string into its components.\n * Format: \"aspectRatio_resolution\" e.g. \"16:9_4K\" → { aspectRatio: \"16:9\", resolution: \"4K\" }\n */\nexport function parseNativeImageSize(\n  size: string,\n): { aspectRatio: string; resolution: string } | undefined {\n  const match = size.match(/^(\\d+:\\d+)_(.+)$/)\n  const [, aspectRatio, resolution] = match ?? []\n  if (aspectRatio === undefined || resolution === undefined) return undefined\n  return { aspectRatio, resolution }\n}\n"],"names":[],"mappings":"AAgNO,MAAM,8BAAiE;AAAA;AAAA,EAE5E,aAAa;AAAA,EACb,WAAW;AAAA;AAAA,EAEX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AAAA;AAAA,EAEb,YAAY;AAAA,EACZ,aAAa;AAAA;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AACf;AAMO,SAAS,kBACd,MAC+B;AAC/B,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,4BAA4B,IAAI;AACzC;AAMO,SAAS,kBACd,OACA,MACM;AACN,MAAI,CAAC,KAAM;AAEX,QAAM,cAAc,kBAAkB,IAAI;AAC1C,MAAI,CAAC,aAAa;AAChB,UAAM,aAAa,OAAO,KAAK,2BAA2B;AAC1D,UAAM,IAAI;AAAA,MACR,iBAAiB,IAAI,gBAAgB,KAAK,+EACoC,WAAW,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAGvG;AACF;AAWA,MAAM,6BAAqD;AAAA,EACzD,2BAA2B;AAAA,EAC3B,2BAA2B;AAAA,EAC3B,iCAAiC;AAAA,EACjC,gCAAgC;AAClC;AAEA,MAAM,4BAA4B;AAQ3B,SAAS,uBACd,OACA,gBACM;AACN,MAAI,mBAAmB,OAAW;AAElC,QAAM,YACJ,2BAA2B,KAAK,KAAK;AACvC,MAAI,iBAAiB,KAAK,iBAAiB,WAAW;AACpD,UAAM,IAAI;AAAA,MACR,2BAA2B,cAAc,gBAAgB,KAAK,4BACnC,SAAS;AAAA,IAAA;AAAA,EAExC;AACF;AAKO,SAAS,eAAe,SAGtB;AACP,QAAM,EAAE,QAAQ,MAAA,IAAU;AAC1B,MAAI,CAAC,UAAU,OAAO,KAAA,EAAO,WAAW,GAAG;AACzC,UAAM,IAAI,MAAM,qCAAqC,KAAK,IAAI;AAAA,EAChE;AACF;AAMO,SAAS,qBACd,MACyD;AACzD,QAAM,QAAQ,KAAK,MAAM,kBAAkB;AAC3C,QAAM,GAAG,aAAa,UAAU,IAAI,SAAS,CAAA;AAC7C,MAAI,gBAAgB,UAAa,eAAe,OAAW,QAAO;AAClE,SAAO,EAAE,aAAa,WAAA;AACxB;"}

package/dist/esm/index.d.ts

@@ -10,12 +10,19 @@ export { GeminiTTSAdapter, createGeminiSpeech, geminiSpeech, type GeminiTTSConfi
  * @experimental Gemini Lyria music generation is an experimental feature and may change.
  */
 export { GeminiAudioAdapter, createGeminiAudio, geminiAudio, type GeminiAudioConfig, type GeminiAudioModel, type GeminiAudioProviderOptions, } from './adapters/audio.js';
+/**
+ * @experimental Veo video generation is an experimental feature and may change.
+ */
+export { GeminiVideoAdapter, createGeminiVideo, geminiVideo, type GeminiVideoConfig, } from './adapters/video.js';
+export { GEMINI_VIDEO_DURATIONS, getGeminiVideoDurationOptions, } from './video/video-provider-options.js';
+export type { GeminiVideoModel, GeminiVideoModelDurationByName, GeminiVideoModelInputModalitiesByName, GeminiVideoModelProviderOptionsByName, GeminiVideoModelSizeByName, GeminiVideoProviderOptions, GeminiVideoSize, } from './video/video-provider-options.js';
 export { GEMINI_MODELS, GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, } from './model-meta.js';
 export { GEMINI_MODELS as GeminiTextModels } from './model-meta.js';
 export { GEMINI_IMAGE_MODELS as GeminiImageModels } from './model-meta.js';
 export { GEMINI_TTS_MODELS as GeminiTTSModels } from './model-meta.js';
 export { GEMINI_TTS_VOICES as GeminiTTSVoices } from './model-meta.js';
 export { GEMINI_AUDIO_MODELS as GeminiAudioModels } from './model-meta.js';
+export { GEMINI_VIDEO_MODELS as GeminiVideoModels } from './model-meta.js';
 export type { GeminiModels as GeminiTextModel } from './model-meta.js';
 export type { GeminiImageModels as GeminiImageModel } from './model-meta.js';
 export type { GeminiTTSVoice } from './model-meta.js';

package/dist/esm/index.js

@@ -3,10 +3,13 @@ import { createGeminiSummarize, geminiSummarize } from "./adapters/summarize.js"
 import { GeminiImageAdapter, createGeminiImage, geminiImage } from "./adapters/image.js";
 import { GeminiTTSAdapter, createGeminiSpeech, geminiSpeech } from "./adapters/tts.js";
 import { GeminiAudioAdapter, createGeminiAudio, geminiAudio } from "./adapters/audio.js";
-import { GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, GEMINI_MODELS, GEMINI_AUDIO_MODELS, GEMINI_IMAGE_MODELS, GEMINI_TTS_MODELS, GEMINI_TTS_VOICES, GEMINI_MODELS as GEMINI_MODELS2 } from "./model-meta.js";
+import { GeminiVideoAdapter, createGeminiVideo, geminiVideo } from "./adapters/video.js";
+import { GEMINI_VIDEO_DURATIONS, getGeminiVideoDurationOptions } from "./video/video-provider-options.js";
+import { GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, GEMINI_MODELS, GEMINI_AUDIO_MODELS, GEMINI_IMAGE_MODELS, GEMINI_TTS_MODELS, GEMINI_TTS_VOICES, GEMINI_MODELS as GEMINI_MODELS2, GEMINI_VIDEO_MODELS } from "./model-meta.js";
 export {
   GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS,
   GEMINI_MODELS,
+  GEMINI_VIDEO_DURATIONS,
   GeminiAudioAdapter,
   GEMINI_AUDIO_MODELS as GeminiAudioModels,
   GeminiImageAdapter,
@@ -16,15 +19,20 @@ export {
   GEMINI_TTS_VOICES as GeminiTTSVoices,
   GeminiTextAdapter,
   GEMINI_MODELS2 as GeminiTextModels,
+  GeminiVideoAdapter,
+  GEMINI_VIDEO_MODELS as GeminiVideoModels,
   createGeminiAudio,
   createGeminiChat,
   createGeminiImage,
   createGeminiSpeech,
   createGeminiSummarize,
+  createGeminiVideo,
   geminiAudio,
   geminiImage,
   geminiSpeech,
   geminiSummarize,
-  geminiText
+  geminiText,
+  geminiVideo,
+  getGeminiVideoDurationOptions
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/esm/model-meta.d.ts

@@ -139,120 +139,6 @@ declare const GEMINI_2_5_FLASH_LITE: {
         };
     };
 };
-/**
-const VEO_3_1_PREVIEW = {
-  name: 'veo-3.1-generate-preview',
-  max_input_tokens: 1024,
-  max_output_tokens: 1,
-  supports: {
-    input: ['text', 'image'],
-    output: ['video', 'audio'],
-  },
-  pricing: {
-    input: {
-      normal: 0,
-    },
-    output: {
-      normal: 0.4,
-    },
-  },
-} as const satisfies ModelMeta<
-  GeminiToolConfigOptions &
-  GeminiSafetyOptions &
-  GeminiGenerationConfigOptions &
-  GeminiCachedContentOptions
->
-
-const VEO_3_1_FAST_PREVIEW = {
-  name: 'veo-3.1-fast-generate-preview',
-  max_input_tokens: 1024,
-  max_output_tokens: 1,
-  supports: {
-    input: ['text', 'image'],
-    output: ['video', 'audio'],
-  },
-  pricing: {
-    input: {
-      normal: 0,
-    },
-    output: {
-      normal: 0.15,
-    },
-  },
-} as const satisfies ModelMeta<
-  GeminiToolConfigOptions &
-  GeminiSafetyOptions &
-  GeminiGenerationConfigOptions &
-  GeminiCachedContentOptions
->
-
-const VEO_3 = {
-  name: 'veo-3.0-generate-001',
-  max_input_tokens: 1024,
-  max_output_tokens: 1,
-  supports: {
-    input: ['text', 'image'],
-    output: ['video', 'audio'],
-  },
-  pricing: {
-    input: {
-      normal: 0,
-    },
-    output: {
-      normal: 0.4,
-    },
-  },
-} as const satisfies ModelMeta<
-  GeminiToolConfigOptions &
-  GeminiSafetyOptions &
-  GeminiGenerationConfigOptions &
-  GeminiCachedContentOptions
->
-
-const VEO_3_FAST = {
-  name: 'veo-3.0-fast-generate-001',
-  max_input_tokens: 1024,
-  max_output_tokens: 1,
-  supports: {
-    input: ['text', 'image'],
-    output: ['video', 'audio'],
-  },
-  pricing: {
-    input: {
-      normal: 0,
-    },
-    output: {
-      normal: 0.15,
-    },
-  },
-} as const satisfies ModelMeta<
-  GeminiToolConfigOptions &
-  GeminiSafetyOptions &
-  GeminiGenerationConfigOptions &
-  GeminiCachedContentOptions
->
-
-const VEO_2 = {
-  name: 'veo-2.0-generate-001',
-  max_output_tokens: 2,
-  supports: {
-    input: ['text', 'image'],
-    output: ['video'],
-  },
-  pricing: {
-    input: {
-      normal: 0,
-    },
-    output: {
-      normal: 0.35,
-    },
-  },
-} as const satisfies ModelMeta<
-  GeminiToolConfigOptions &
-  GeminiSafetyOptions &
-  GeminiGenerationConfigOptions &
-  GeminiCachedContentOptions
-> */
 declare const GEMINI_3_5_FLASH: {
     readonly name: "gemini-3.5-flash";
     readonly max_input_tokens: 1048576;
@@ -301,6 +187,11 @@ export declare const GEMINI_AUDIO_MODELS: readonly ["lyria-3-pro-preview", "lyri
  */
 export declare const GEMINI_TTS_VOICES: readonly ["Zephyr", "Puck", "Charon", "Kore", "Fenrir", "Leda", "Orus", "Aoede", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat"];
 export type GeminiTTSVoice = (typeof GEMINI_TTS_VOICES)[number];
+/**
+ * Veo video generation models.
+ * @experimental Veo video generation is an experimental feature and may change.
+ */
+export declare const GEMINI_VIDEO_MODELS: readonly ["veo-3.1-generate-preview", "veo-3.1-fast-generate-preview", "veo-3.0-generate-001", "veo-3.0-fast-generate-001", "veo-2.0-generate-001"];
 export type GeminiChatModelProviderOptionsByName = {
     [GEMINI_3_1_PRO.name]: GeminiToolConfigOptions & GeminiSafetyOptions & GeminiCommonConfigOptions & GeminiCachedContentOptions & GeminiStructuredOutputOptions & GeminiThinkingOptions;
     [GEMINI_3_FLASH.name]: GeminiToolConfigOptions & GeminiSafetyOptions & GeminiCommonConfigOptions & GeminiCachedContentOptions & GeminiStructuredOutputOptions & GeminiThinkingOptions;

package/dist/esm/model-meta.js

@@ -55,6 +55,21 @@ const IMAGEN_4_GENERATE_FAST = {
 const IMAGEN_3 = {
   name: "imagen-3.0-generate-002"
 };
+const VEO_3_1_PREVIEW = {
+  name: "veo-3.1-generate-preview"
+};
+const VEO_3_1_FAST_PREVIEW = {
+  name: "veo-3.1-fast-generate-preview"
+};
+const VEO_3 = {
+  name: "veo-3.0-generate-001"
+};
+const VEO_3_FAST = {
+  name: "veo-3.0-fast-generate-001"
+};
+const VEO_2 = {
+  name: "veo-2.0-generate-001"
+};
 const GEMINI_3_5_FLASH = {
   name: "gemini-3.5-flash"
 };
@@ -125,12 +140,20 @@ const GEMINI_TTS_VOICES = [
   "Sadaltager",
   "Sulafat"
 ];
+const GEMINI_VIDEO_MODELS = [
+  VEO_3_1_PREVIEW.name,
+  VEO_3_1_FAST_PREVIEW.name,
+  VEO_3.name,
+  VEO_3_FAST.name,
+  VEO_2.name
+];
 export {
   GEMINI_AUDIO_MODELS,
   GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS,
   GEMINI_IMAGE_MODELS,
   GEMINI_MODELS,
   GEMINI_TTS_MODELS,
-  GEMINI_TTS_VOICES
+  GEMINI_TTS_VOICES,
+  GEMINI_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":["import type {\n  GeminiCachedContentOptions,\n  GeminiCommonConfigOptions,\n  GeminiSafetyOptions,\n  GeminiStructuredOutputOptions,\n  GeminiThinkingOptions,\n  GeminiToolConfigOptions,\n} from './text/text-provider-options'\n\ninterface ModelMeta<TProviderOptions = unknown> {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<\n      | 'audio_generation'\n      | 'batch_api'\n      | 'caching'\n      | 'function_calling'\n      | 'live_api'\n      | 'structured_output'\n      | 'thinking'\n    >\n    tools?: Array<\n      | 'code_execution'\n      | 'file_search'\n      | 'google_search'\n      | 'google_search_retrieval'\n      | 'google_maps'\n      | 'url_context'\n      | 'computer_use'\n    >\n  }\n  max_input_tokens?: number\n  max_output_tokens?: 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   * Type-level description of which provider options this model supports.\n   */\n  providerOptions?: TProviderOptions\n}\n\nconst GEMINI_3_1_PRO = {\n  name: 'gemini-3.1-pro-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_FLASH = {\n  name: 'gemini-3-flash-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.5,\n    },\n    output: {\n      normal: 3,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_PRO_IMAGE = {\n  name: 'gemini-3-pro-image-preview',\n  max_input_tokens: 65_536,\n  max_output_tokens: 32_768,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'structured_output', 'thinking'],\n    tools: ['google_search'],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n    },\n    output: {\n      normal: 0.134,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_IMAGE = {\n  name: 'gemini-3.1-flash-image-preview',\n  max_input_tokens: 65_536,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'structured_output', 'thinking'],\n    tools: ['google_search'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_LITE = {\n  name: 'gemini-3.1-flash-lite',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_LITE_PREVIEW = {\n  name: 'gemini-3.1-flash-lite-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_PRO = {\n  name: 'gemini-2.5-pro',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: [\n      'code_execution',\n      'file_search',\n      'google_maps',\n      'google_search',\n      'url_context',\n    ],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_PRO_TTS = {\n  name: 'gemini-2.5-pro-preview-tts',\n  max_input_tokens: 8_192,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst GEMINI_2_5_FLASH = {\n  name: 'gemini-2.5-flash',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: [\n      'code_execution',\n      'file_search',\n      'google_maps',\n      'google_search',\n      'url_context',\n    ],\n  },\n  pricing: {\n    input: {\n      normal: 1,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_FLASH_IMAGE = {\n  name: 'gemini-2.5-flash-image',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-06-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'caching', 'structured_output'],\n    tools: ['file_search'],\n  },\n  pricing: {\n    input: {\n      normal: 0.3,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n/**\nconst GEMINI_2_5_FLASH_LIVE = {\n  name: 'gemini-2.5-flash-native-audio-preview-09-2025',\n  max_input_tokens: 141_072,\n  max_output_tokens: 8_192,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'audio', 'video'],\n    output: ['text', 'audio'],\n    capabilities: [\n      'audio_generation',\n      'file_search',\n      'function_calling',\n      'live_api',\n      'search_grounding',\n      'thinking',\n    ],\n  },\n  pricing: {\n    // todo find this info\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions &\n  GeminiThinkingOptions\n>\n*/\nconst GEMINI_2_5_FLASH_TTS = {\n  name: 'gemini-2.5-flash-preview-tts',\n  max_input_tokens: 8_192,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation', 'batch_api'],\n  },\n  pricing: {\n    input: {\n      normal: 1,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\n/**\n * Gemini 3.1 Flash TTS Preview - latest expressive TTS model with\n * 200+ audio tags, 70+ languages, and multi-speaker dialogue support.\n * @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-tts-preview\n */\nconst GEMINI_3_1_FLASH_TTS = {\n  name: 'gemini-3.1-flash-tts-preview',\n  max_input_tokens: 32_768,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation', 'batch_api'],\n  },\n  pricing: {\n    input: {\n      normal: 0.5,\n    },\n    output: {\n      normal: 10,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\n/**\n * Lyria 3 Pro Preview — Google's flagship music generation model.\n * Generates full-length songs with multiple verses, choruses, and bridges.\n * Outputs MP3 or WAV at 48 kHz stereo.\n * @see https://ai.google.dev/gemini-api/docs/models/lyria-3-pro-preview\n */\nconst LYRIA_3_PRO = {\n  name: 'lyria-3-pro-preview',\n  max_input_tokens: 131_072,\n  supports: {\n    input: ['text', 'image'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Lyria 3 Clip Preview — 30-second music clips in MP3 format.\n * @see https://ai.google.dev/gemini-api/docs/music-generation\n */\nconst LYRIA_3_CLIP = {\n  name: 'lyria-3-clip-preview',\n  max_input_tokens: 131_072,\n  supports: {\n    input: ['text', 'image'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GEMINI_2_5_FLASH_LITE = {\n  name: 'gemini-2.5-flash-lite',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'google_maps', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.1,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst IMAGEN_4_GENERATE = {\n  name: 'imagen-4.0-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_4_GENERATE_ULTRA = {\n  name: 'imagen-4.0-ultra-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_4_GENERATE_FAST = {\n  name: 'imagen-4.0-fast-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.2,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_3 = {\n  name: 'imagen-3.0-generate-002',\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.03,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n/** \nconst VEO_3_1_PREVIEW = {\n  name: 'veo-3.1-generate-preview',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions\n>\n\nconst VEO_3_1_FAST_PREVIEW = {\n  name: 'veo-3.1-fast-generate-preview',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions\n>\n\nconst VEO_3 = {\n  name: 'veo-3.0-generate-001',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions\n>\n\nconst VEO_3_FAST = {\n  name: 'veo-3.0-fast-generate-001',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions\n>\n\nconst VEO_2 = {\n  name: 'veo-2.0-generate-001',\n  max_output_tokens: 2,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.35,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions\n> */\n\nconst GEMINI_3_5_FLASH = {\n  name: 'gemini-3.5-flash',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  supports: {\n    input: ['text', 'image', 'video', 'document', 'audio'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 1.5,\n      cached: 0.15,\n    },\n    output: {\n      normal: 9,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nexport const GEMINI_MODELS = [\n  GEMINI_3_5_FLASH.name,\n  GEMINI_3_1_PRO.name,\n  GEMINI_3_FLASH.name,\n  GEMINI_3_1_FLASH_LITE.name,\n  GEMINI_3_1_FLASH_LITE_PREVIEW.name,\n  GEMINI_2_5_PRO.name,\n  GEMINI_2_5_FLASH.name,\n  GEMINI_2_5_FLASH_LITE.name,\n] as const\n\n/**\n * Gemini models that support combining `tools` + `responseSchema` in a\n * single streaming `generateContent` call (per issue #605). Per the\n * provider matrix, Gemini 3.x natively interleaves the schema-constrained\n * answer with function-calling on one pass; Gemini 2.x is unsupported /\n * brittle and keeps the engine's legacy finalization fallback.\n */\nexport const GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS = new Set<string>([\n  GEMINI_3_1_PRO.name,\n  GEMINI_3_FLASH.name,\n  GEMINI_3_1_FLASH_LITE.name,\n  GEMINI_3_1_FLASH_LITE_PREVIEW.name,\n  GEMINI_3_5_FLASH.name,\n])\n\nexport type GeminiModels = (typeof GEMINI_MODELS)[number]\n\nexport type GeminiImageModels = (typeof GEMINI_IMAGE_MODELS)[number]\n\nexport const GEMINI_IMAGE_MODELS = [\n  GEMINI_3_1_FLASH_IMAGE.name,\n  GEMINI_3_PRO_IMAGE.name,\n  GEMINI_2_5_FLASH_IMAGE.name,\n  IMAGEN_3.name,\n  IMAGEN_4_GENERATE.name,\n  IMAGEN_4_GENERATE_FAST.name,\n  IMAGEN_4_GENERATE_ULTRA.name,\n] as const\n\n/**\n * Text-to-speech models\n * @experimental Gemini TTS is an experimental feature and may change.\n */\nexport const GEMINI_TTS_MODELS = [\n  GEMINI_3_1_FLASH_TTS.name,\n  GEMINI_2_5_FLASH_TTS.name,\n  GEMINI_2_5_PRO_TTS.name,\n] as const\n\n/**\n * Audio generation models (Lyria music generation).\n * @experimental Lyria music generation is an experimental feature and may change.\n */\nexport const GEMINI_AUDIO_MODELS = [\n  LYRIA_3_PRO.name,\n  LYRIA_3_CLIP.name,\n] as const\n\n/**\n * Available voice names for Gemini TTS\n * @see https://ai.google.dev/gemini-api/docs/speech-generation\n */\nexport const GEMINI_TTS_VOICES = [\n  'Zephyr',\n  'Puck',\n  'Charon',\n  'Kore',\n  'Fenrir',\n  'Leda',\n  'Orus',\n  'Aoede',\n  'Callirrhoe',\n  'Autonoe',\n  'Enceladus',\n  'Iapetus',\n  'Umbriel',\n  'Algieba',\n  'Despina',\n  'Erinome',\n  'Algenib',\n  'Rasalgethi',\n  'Laomedeia',\n  'Achernar',\n  'Alnilam',\n  'Schedar',\n  'Gacrux',\n  'Pulcherrima',\n  'Achird',\n  'Zubenelgenubi',\n  'Vindemiatrix',\n  'Sadachbia',\n  'Sadaltager',\n  'Sulafat',\n] as const\n\nexport type GeminiTTSVoice = (typeof GEMINI_TTS_VOICES)[number]\n\n/*   const GEMINI_AUDIO_MODELS = [\n  GEMINI_2_5_PRO_TTS.name,\n  GEMINI_2_5_FLASH_TTS.name,\n  GEMINI_2_5_FLASH_LIVE.name,\n  GEMINI_2_FLASH_LIVE.name,\n] as const\n\n  const GEMINI_VIDEO_MODELS = [\n  VEO_3_1_PREVIEW.name,\n  VEO_3_1_FAST_PREVIEW.name,\n  VEO_3.name,\n  VEO_3_FAST.name,\n  VEO_2.name,\n] as const */\n\n// Manual type map for per-model provider options\nexport type GeminiChatModelProviderOptionsByName = {\n  // Models with thinking and structured output support\n  [GEMINI_3_1_PRO.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_1_FLASH_LITE.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_PRO.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_FLASH_LITE.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_5_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n}\n\n/**\n * Type-only map from chat model name to its supported tool capabilities.\n * Based on the 'supports.tools' arrays defined for each model.\n */\nexport type GeminiChatModelToolCapabilitiesByName = {\n  [GEMINI_3_1_PRO.name]: typeof GEMINI_3_1_PRO.supports.tools\n  [GEMINI_3_FLASH.name]: typeof GEMINI_3_FLASH.supports.tools\n  [GEMINI_3_1_FLASH_LITE.name]: typeof GEMINI_3_1_FLASH_LITE.supports.tools\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: typeof GEMINI_3_1_FLASH_LITE_PREVIEW.supports.tools\n  [GEMINI_2_5_PRO.name]: typeof GEMINI_2_5_PRO.supports.tools\n  [GEMINI_2_5_FLASH.name]: typeof GEMINI_2_5_FLASH.supports.tools\n  [GEMINI_2_5_FLASH_LITE.name]: typeof GEMINI_2_5_FLASH_LITE.supports.tools\n  [GEMINI_3_5_FLASH.name]: typeof GEMINI_3_5_FLASH.supports.tools\n}\n\n/**\n * Type-only map from chat model name to its supported input modalities.\n * Based on the 'supports.input' arrays defined for each model.\n * Note: 'document' in the model meta is mapped to 'document' modality.\n * Used by the core AI types to constrain ContentPart types based on the selected model.\n * Note: These must be inlined as readonly arrays (not typeof) because the model\n * constants are not exported and typeof references don't work in .d.ts files\n * when consumed by external packages.\n *\n * @see https://ai.google.dev/gemini-api/docs/vision\n * @see https://ai.google.dev/gemini-api/docs/audio\n * @see https://ai.google.dev/gemini-api/docs/document-processing\n */\nexport type GeminiModelInputModalitiesByName = {\n  // Models with full multimodal support (text, image, audio, video, document)\n  [GEMINI_3_1_PRO.name]: typeof GEMINI_3_1_PRO.supports.input\n  [GEMINI_3_FLASH.name]: typeof GEMINI_3_FLASH.supports.input\n  [GEMINI_3_1_FLASH_LITE.name]: typeof GEMINI_3_1_FLASH_LITE.supports.input\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: typeof GEMINI_3_1_FLASH_LITE_PREVIEW.supports.input\n  [GEMINI_2_5_PRO.name]: typeof GEMINI_2_5_PRO.supports.input\n  [GEMINI_2_5_FLASH_LITE.name]: typeof GEMINI_2_5_FLASH_LITE.supports.input\n  [GEMINI_3_5_FLASH.name]: typeof GEMINI_3_5_FLASH.supports.input\n\n  // Models with text, image, audio, video (no document)\n  [GEMINI_2_5_FLASH.name]: typeof GEMINI_2_5_FLASH.supports.input\n}\n"],"names":[],"mappings":"AAmDA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAwBR;AASA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAwBR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAkBR;AASA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAkBR;AASA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAwBR;AASA,MAAM,gCAAgC;AAAA,EACpC,MAAM;AAwBR;AASA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AA8BR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAiBR;AAOA,MAAM,mBAAmB;AAAA,EACvB,MAAM;AA8BR;AASA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAkBR;AAyCA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAiBR;AAYA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAiBR;AAaA,MAAM,cAAc;AAAA,EAClB,MAAM;AAeR;AAMA,MAAM,eAAe;AAAA,EACnB,MAAM;AAeR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAwBR;AASA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAeR;AAOA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAeR;AAOA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAeR;AAOA,MAAM,WAAW;AAAA,EACf,MAAM;AAcR;AAyHA,MAAM,mBAAmB;AAAA,EACvB,MAAM;AAwBR;AASO,MAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,8BAA8B;AAAA,EAC9B,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,sBAAsB;AACxB;AASO,MAAM,8DAA8C,IAAY;AAAA,EACrE,eAAe;AAAA,EACf,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,8BAA8B;AAAA,EAC9B,iBAAiB;AACnB,CAAC;AAMM,MAAM,sBAAsB;AAAA,EACjC,uBAAuB;AAAA,EACvB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,uBAAuB;AAAA,EACvB,wBAAwB;AAC1B;AAMO,MAAM,oBAAoB;AAAA,EAC/B,qBAAqB;AAAA,EACrB,qBAAqB;AAAA,EACrB,mBAAmB;AACrB;AAMO,MAAM,sBAAsB;AAAA,EACjC,YAAY;AAAA,EACZ,aAAa;AACf;AAMO,MAAM,oBAAoB;AAAA,EAC/B;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;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;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;"}
+{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["import type {\n  GeminiCachedContentOptions,\n  GeminiCommonConfigOptions,\n  GeminiSafetyOptions,\n  GeminiStructuredOutputOptions,\n  GeminiThinkingOptions,\n  GeminiToolConfigOptions,\n} from './text/text-provider-options'\n\ninterface ModelMeta<TProviderOptions = unknown> {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<\n      | 'audio_generation'\n      | 'batch_api'\n      | 'caching'\n      | 'function_calling'\n      | 'live_api'\n      | 'structured_output'\n      | 'thinking'\n    >\n    tools?: Array<\n      | 'code_execution'\n      | 'file_search'\n      | 'google_search'\n      | 'google_search_retrieval'\n      | 'google_maps'\n      | 'url_context'\n      | 'computer_use'\n    >\n  }\n  max_input_tokens?: number\n  max_output_tokens?: 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   * Type-level description of which provider options this model supports.\n   */\n  providerOptions?: TProviderOptions\n}\n\nconst GEMINI_3_1_PRO = {\n  name: 'gemini-3.1-pro-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_FLASH = {\n  name: 'gemini-3-flash-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.5,\n    },\n    output: {\n      normal: 3,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_PRO_IMAGE = {\n  name: 'gemini-3-pro-image-preview',\n  max_input_tokens: 65_536,\n  max_output_tokens: 32_768,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'structured_output', 'thinking'],\n    tools: ['google_search'],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n    },\n    output: {\n      normal: 0.134,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_IMAGE = {\n  name: 'gemini-3.1-flash-image-preview',\n  max_input_tokens: 65_536,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'structured_output', 'thinking'],\n    tools: ['google_search'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_LITE = {\n  name: 'gemini-3.1-flash-lite',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_3_1_FLASH_LITE_PREVIEW = {\n  name: 'gemini-3.1-flash-lite-preview',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.25,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_PRO = {\n  name: 'gemini-2.5-pro',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: [\n      'code_execution',\n      'file_search',\n      'google_maps',\n      'google_search',\n      'url_context',\n    ],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_PRO_TTS = {\n  name: 'gemini-2.5-pro-preview-tts',\n  max_input_tokens: 8_192,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 2.5,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst GEMINI_2_5_FLASH = {\n  name: 'gemini-2.5-flash',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: [\n      'code_execution',\n      'file_search',\n      'google_maps',\n      'google_search',\n      'url_context',\n    ],\n  },\n  pricing: {\n    input: {\n      normal: 1,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst GEMINI_2_5_FLASH_IMAGE = {\n  name: 'gemini-2.5-flash-image',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-06-01',\n  supports: {\n    input: ['text', 'image'],\n    output: ['text', 'image'],\n    capabilities: ['batch_api', 'caching', 'structured_output'],\n    tools: ['file_search'],\n  },\n  pricing: {\n    input: {\n      normal: 0.3,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n/**\nconst GEMINI_2_5_FLASH_LIVE = {\n  name: 'gemini-2.5-flash-native-audio-preview-09-2025',\n  max_input_tokens: 141_072,\n  max_output_tokens: 8_192,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'audio', 'video'],\n    output: ['text', 'audio'],\n    capabilities: [\n      'audio_generation',\n      'file_search',\n      'function_calling',\n      'live_api',\n      'search_grounding',\n      'thinking',\n    ],\n  },\n  pricing: {\n    // todo find this info\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n  GeminiSafetyOptions &\n  GeminiGenerationConfigOptions &\n  GeminiCachedContentOptions &\n  GeminiThinkingOptions\n>\n*/\nconst GEMINI_2_5_FLASH_TTS = {\n  name: 'gemini-2.5-flash-preview-tts',\n  max_input_tokens: 8_192,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation', 'batch_api'],\n  },\n  pricing: {\n    input: {\n      normal: 1,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\n/**\n * Gemini 3.1 Flash TTS Preview - latest expressive TTS model with\n * 200+ audio tags, 70+ languages, and multi-speaker dialogue support.\n * @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-tts-preview\n */\nconst GEMINI_3_1_FLASH_TTS = {\n  name: 'gemini-3.1-flash-tts-preview',\n  max_input_tokens: 32_768,\n  max_output_tokens: 16_384,\n  knowledge_cutoff: '2025-05-01',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n    capabilities: ['audio_generation', 'batch_api'],\n  },\n  pricing: {\n    input: {\n      normal: 0.5,\n    },\n    output: {\n      normal: 10,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\n/**\n * Lyria 3 Pro Preview — Google's flagship music generation model.\n * Generates full-length songs with multiple verses, choruses, and bridges.\n * Outputs MP3 or WAV at 48 kHz stereo.\n * @see https://ai.google.dev/gemini-api/docs/models/lyria-3-pro-preview\n */\nconst LYRIA_3_PRO = {\n  name: 'lyria-3-pro-preview',\n  max_input_tokens: 131_072,\n  supports: {\n    input: ['text', 'image'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Lyria 3 Clip Preview — 30-second music clips in MP3 format.\n * @see https://ai.google.dev/gemini-api/docs/music-generation\n */\nconst LYRIA_3_CLIP = {\n  name: 'lyria-3-clip-preview',\n  max_input_tokens: 131_072,\n  supports: {\n    input: ['text', 'image'],\n    output: ['audio'],\n    capabilities: ['audio_generation'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GEMINI_2_5_FLASH_LITE = {\n  name: 'gemini-2.5-flash-lite',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  knowledge_cutoff: '2025-01-01',\n  supports: {\n    input: ['text', 'image', 'audio', 'video', 'document'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'google_maps', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 0.1,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nconst IMAGEN_4_GENERATE = {\n  name: 'imagen-4.0-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_4_GENERATE_ULTRA = {\n  name: 'imagen-4.0-ultra-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.6,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_4_GENERATE_FAST = {\n  name: 'imagen-4.0-fast-generate-001',\n  max_input_tokens: 480,\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.2,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst IMAGEN_3 = {\n  name: 'imagen-3.0-generate-002',\n  max_output_tokens: 4,\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.03,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n/**\n * Veo video generation models. Pricing is per second of generated video\n * (audio+video rate where the model supports audio).\n * @experimental Veo video generation is an experimental feature and may change.\n */\nconst VEO_3_1_PREVIEW = {\n  name: 'veo-3.1-generate-preview',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst VEO_3_1_FAST_PREVIEW = {\n  name: 'veo-3.1-fast-generate-preview',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst VEO_3 = {\n  name: 'veo-3.0-generate-001',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.4,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst VEO_3_FAST = {\n  name: 'veo-3.0-fast-generate-001',\n  max_input_tokens: 1024,\n  max_output_tokens: 1,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.15,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst VEO_2 = {\n  name: 'veo-2.0-generate-001',\n  max_output_tokens: 2,\n  supports: {\n    input: ['text', 'image'],\n    output: ['video'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.35,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions\n>\n\nconst GEMINI_3_5_FLASH = {\n  name: 'gemini-3.5-flash',\n  max_input_tokens: 1_048_576,\n  max_output_tokens: 65_536,\n  supports: {\n    input: ['text', 'image', 'video', 'document', 'audio'],\n    output: ['text'],\n    capabilities: [\n      'batch_api',\n      'caching',\n      'function_calling',\n      'structured_output',\n      'thinking',\n    ],\n    tools: ['code_execution', 'file_search', 'google_search', 'url_context'],\n  },\n  pricing: {\n    input: {\n      normal: 1.5,\n      cached: 0.15,\n    },\n    output: {\n      normal: 9,\n    },\n  },\n} as const satisfies ModelMeta<\n  GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n>\n\nexport const GEMINI_MODELS = [\n  GEMINI_3_5_FLASH.name,\n  GEMINI_3_1_PRO.name,\n  GEMINI_3_FLASH.name,\n  GEMINI_3_1_FLASH_LITE.name,\n  GEMINI_3_1_FLASH_LITE_PREVIEW.name,\n  GEMINI_2_5_PRO.name,\n  GEMINI_2_5_FLASH.name,\n  GEMINI_2_5_FLASH_LITE.name,\n] as const\n\n/**\n * Gemini models that support combining `tools` + `responseSchema` in a\n * single streaming `generateContent` call (per issue #605). Per the\n * provider matrix, Gemini 3.x natively interleaves the schema-constrained\n * answer with function-calling on one pass; Gemini 2.x is unsupported /\n * brittle and keeps the engine's legacy finalization fallback.\n */\nexport const GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS = new Set<string>([\n  GEMINI_3_1_PRO.name,\n  GEMINI_3_FLASH.name,\n  GEMINI_3_1_FLASH_LITE.name,\n  GEMINI_3_1_FLASH_LITE_PREVIEW.name,\n  GEMINI_3_5_FLASH.name,\n])\n\nexport type GeminiModels = (typeof GEMINI_MODELS)[number]\n\nexport type GeminiImageModels = (typeof GEMINI_IMAGE_MODELS)[number]\n\nexport const GEMINI_IMAGE_MODELS = [\n  GEMINI_3_1_FLASH_IMAGE.name,\n  GEMINI_3_PRO_IMAGE.name,\n  GEMINI_2_5_FLASH_IMAGE.name,\n  IMAGEN_3.name,\n  IMAGEN_4_GENERATE.name,\n  IMAGEN_4_GENERATE_FAST.name,\n  IMAGEN_4_GENERATE_ULTRA.name,\n] as const\n\n/**\n * Text-to-speech models\n * @experimental Gemini TTS is an experimental feature and may change.\n */\nexport const GEMINI_TTS_MODELS = [\n  GEMINI_3_1_FLASH_TTS.name,\n  GEMINI_2_5_FLASH_TTS.name,\n  GEMINI_2_5_PRO_TTS.name,\n] as const\n\n/**\n * Audio generation models (Lyria music generation).\n * @experimental Lyria music generation is an experimental feature and may change.\n */\nexport const GEMINI_AUDIO_MODELS = [\n  LYRIA_3_PRO.name,\n  LYRIA_3_CLIP.name,\n] as const\n\n/**\n * Available voice names for Gemini TTS\n * @see https://ai.google.dev/gemini-api/docs/speech-generation\n */\nexport const GEMINI_TTS_VOICES = [\n  'Zephyr',\n  'Puck',\n  'Charon',\n  'Kore',\n  'Fenrir',\n  'Leda',\n  'Orus',\n  'Aoede',\n  'Callirrhoe',\n  'Autonoe',\n  'Enceladus',\n  'Iapetus',\n  'Umbriel',\n  'Algieba',\n  'Despina',\n  'Erinome',\n  'Algenib',\n  'Rasalgethi',\n  'Laomedeia',\n  'Achernar',\n  'Alnilam',\n  'Schedar',\n  'Gacrux',\n  'Pulcherrima',\n  'Achird',\n  'Zubenelgenubi',\n  'Vindemiatrix',\n  'Sadachbia',\n  'Sadaltager',\n  'Sulafat',\n] as const\n\nexport type GeminiTTSVoice = (typeof GEMINI_TTS_VOICES)[number]\n\n/**\n * Veo video generation models.\n * @experimental Veo video generation is an experimental feature and may change.\n */\nexport const GEMINI_VIDEO_MODELS = [\n  VEO_3_1_PREVIEW.name,\n  VEO_3_1_FAST_PREVIEW.name,\n  VEO_3.name,\n  VEO_3_FAST.name,\n  VEO_2.name,\n] as const\n\n// Manual type map for per-model provider options\nexport type GeminiChatModelProviderOptionsByName = {\n  // Models with thinking and structured output support\n  [GEMINI_3_1_PRO.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_1_FLASH_LITE.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_PRO.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_2_5_FLASH_LITE.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n  [GEMINI_3_5_FLASH.name]: GeminiToolConfigOptions &\n    GeminiSafetyOptions &\n    GeminiCommonConfigOptions &\n    GeminiCachedContentOptions &\n    GeminiStructuredOutputOptions &\n    GeminiThinkingOptions\n}\n\n/**\n * Type-only map from chat model name to its supported tool capabilities.\n * Based on the 'supports.tools' arrays defined for each model.\n */\nexport type GeminiChatModelToolCapabilitiesByName = {\n  [GEMINI_3_1_PRO.name]: typeof GEMINI_3_1_PRO.supports.tools\n  [GEMINI_3_FLASH.name]: typeof GEMINI_3_FLASH.supports.tools\n  [GEMINI_3_1_FLASH_LITE.name]: typeof GEMINI_3_1_FLASH_LITE.supports.tools\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: typeof GEMINI_3_1_FLASH_LITE_PREVIEW.supports.tools\n  [GEMINI_2_5_PRO.name]: typeof GEMINI_2_5_PRO.supports.tools\n  [GEMINI_2_5_FLASH.name]: typeof GEMINI_2_5_FLASH.supports.tools\n  [GEMINI_2_5_FLASH_LITE.name]: typeof GEMINI_2_5_FLASH_LITE.supports.tools\n  [GEMINI_3_5_FLASH.name]: typeof GEMINI_3_5_FLASH.supports.tools\n}\n\n/**\n * Type-only map from chat model name to its supported input modalities.\n * Based on the 'supports.input' arrays defined for each model.\n * Note: 'document' in the model meta is mapped to 'document' modality.\n * Used by the core AI types to constrain ContentPart types based on the selected model.\n * Note: These must be inlined as readonly arrays (not typeof) because the model\n * constants are not exported and typeof references don't work in .d.ts files\n * when consumed by external packages.\n *\n * @see https://ai.google.dev/gemini-api/docs/vision\n * @see https://ai.google.dev/gemini-api/docs/audio\n * @see https://ai.google.dev/gemini-api/docs/document-processing\n */\nexport type GeminiModelInputModalitiesByName = {\n  // Models with full multimodal support (text, image, audio, video, document)\n  [GEMINI_3_1_PRO.name]: typeof GEMINI_3_1_PRO.supports.input\n  [GEMINI_3_FLASH.name]: typeof GEMINI_3_FLASH.supports.input\n  [GEMINI_3_1_FLASH_LITE.name]: typeof GEMINI_3_1_FLASH_LITE.supports.input\n  [GEMINI_3_1_FLASH_LITE_PREVIEW.name]: typeof GEMINI_3_1_FLASH_LITE_PREVIEW.supports.input\n  [GEMINI_2_5_PRO.name]: typeof GEMINI_2_5_PRO.supports.input\n  [GEMINI_2_5_FLASH_LITE.name]: typeof GEMINI_2_5_FLASH_LITE.supports.input\n  [GEMINI_3_5_FLASH.name]: typeof GEMINI_3_5_FLASH.supports.input\n\n  // Models with text, image, audio, video (no document)\n  [GEMINI_2_5_FLASH.name]: typeof GEMINI_2_5_FLASH.supports.input\n}\n"],"names":[],"mappings":"AAmDA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAwBR;AASA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAwBR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAkBR;AASA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAkBR;AASA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAwBR;AASA,MAAM,gCAAgC;AAAA,EACpC,MAAM;AAwBR;AASA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AA8BR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAiBR;AAOA,MAAM,mBAAmB;AAAA,EACvB,MAAM;AA8BR;AASA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAkBR;AAyCA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAiBR;AAYA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAiBR;AAaA,MAAM,cAAc;AAAA,EAClB,MAAM;AAeR;AAMA,MAAM,eAAe;AAAA,EACnB,MAAM;AAeR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAwBR;AASA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAeR;AAOA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAeR;AAOA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAeR;AAOA,MAAM,WAAW;AAAA,EACf,MAAM;AAcR;AAWA,MAAM,kBAAkB;AAAA,EACtB,MAAM;AAeR;AAOA,MAAM,uBAAuB;AAAA,EAC3B,MAAM;AAeR;AAOA,MAAM,QAAQ;AAAA,EACZ,MAAM;AAeR;AAOA,MAAM,aAAa;AAAA,EACjB,MAAM;AAeR;AAOA,MAAM,QAAQ;AAAA,EACZ,MAAM;AAcR;AAOA,MAAM,mBAAmB;AAAA,EACvB,MAAM;AAwBR;AASO,MAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,8BAA8B;AAAA,EAC9B,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,sBAAsB;AACxB;AASO,MAAM,8DAA8C,IAAY;AAAA,EACrE,eAAe;AAAA,EACf,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,8BAA8B;AAAA,EAC9B,iBAAiB;AACnB,CAAC;AAMM,MAAM,sBAAsB;AAAA,EACjC,uBAAuB;AAAA,EACvB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,uBAAuB;AAAA,EACvB,wBAAwB;AAC1B;AAMO,MAAM,oBAAoB;AAAA,EAC/B,qBAAqB;AAAA,EACrB,qBAAqB;AAAA,EACrB,mBAAmB;AACrB;AAMO,MAAM,sBAAsB;AAAA,EACjC,YAAY;AAAA,EACZ,aAAa;AACf;AAMO,MAAM,oBAAoB;AAAA,EAC/B;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;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;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,MAAM,sBAAsB;AAAA,EACjC,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,MAAM;AAAA,EACN,WAAW;AAAA,EACX,MAAM;AACR;"}

package/dist/esm/video/video-provider-options.d.ts

@@ -0,0 +1,90 @@
+import { DurationOptions } from '@tanstack/ai/adapters';
+import { GenerateVideosConfig } from '@google/genai';
+import { GEMINI_VIDEO_MODELS } from '../model-meta.js';
+/**
+ * Model type for Gemini Veo video generation.
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoModel = (typeof GEMINI_VIDEO_MODELS)[number];
+/**
+ * Supported aspect ratios for Veo video generation. This is the `size` value
+ * for the Gemini video adapter — Veo expresses output shape as an aspect
+ * ratio (plus an optional `resolution` in `modelOptions`), not pixel
+ * dimensions.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoSize = '16:9' | '9:16';
+/**
+ * Provider-specific options for Gemini Veo video generation.
+ *
+ * Derived from the SDK's `GenerateVideosConfig`, minus the fields the
+ * adapter manages itself:
+ * - `durationSeconds` — set via the typed top-level `duration` option
+ *   (use `adapter.snapDuration(seconds)` to coerce raw seconds)
+ * - `aspectRatio` — set via the top-level `size` option
+ * - `lastFrame` / `referenceImages` — set via image parts in the `prompt`
+ *   with `metadata.role: 'end_frame'` / `'reference'`
+ * - `httpOptions` / `abortSignal` — client-level transport concerns
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoProviderOptions = Omit<GenerateVideosConfig, 'durationSeconds' | 'aspectRatio' | 'lastFrame' | 'referenceImages' | 'httpOptions' | 'abortSignal'>;
+/**
+ * Model-specific provider options mapping.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoModelProviderOptionsByName = {
+    [TModel in GeminiVideoModel]: GeminiVideoProviderOptions;
+};
+/**
+ * Model-specific size (aspect ratio) mapping.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoModelSizeByName = {
+    [TModel in GeminiVideoModel]: GeminiVideoSize;
+};
+/**
+ * Per-model prompt input modalities. Every Veo model accepts image
+ * conditioning inputs (first frame, last frame, reference images) alongside
+ * the text prompt.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoModelInputModalitiesByName = {
+    [TModel in GeminiVideoModel]: readonly ['image'];
+};
+/**
+ * Per-model duration unions (seconds, as numbers — the API's
+ * `parameters.durationSeconds` field is numeric).
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type GeminiVideoModelDurationByName = {
+    'veo-3.1-generate-preview': 4 | 6 | 8;
+    'veo-3.1-fast-generate-preview': 4 | 6 | 8;
+    'veo-3.0-generate-001': 4 | 6 | 8;
+    'veo-3.0-fast-generate-001': 4 | 6 | 8;
+    'veo-2.0-generate-001': 5 | 6 | 8;
+};
+/**
+ * Runtime duration table backing `availableDurations()` / `snapDuration()`.
+ *
+ * Curated from the official Veo docs
+ * (https://ai.google.dev/gemini-api/docs/video) — the Gemini OpenAPI spec
+ * types the `:predictLongRunning` request's `parameters` as unconstrained,
+ * so it carries no per-model duration information to derive these from.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export declare const GEMINI_VIDEO_DURATIONS: {
+    readonly [TModel in GeminiVideoModel]: DurationOptions<GeminiVideoModelDurationByName[TModel]>;
+};
+/**
+ * Look up the duration options for a Veo model.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export declare function getGeminiVideoDurationOptions<TModel extends GeminiVideoModel>(model: TModel): DurationOptions<GeminiVideoModelDurationByName[TModel]>;

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

@@ -0,0 +1,15 @@
+const GEMINI_VIDEO_DURATIONS = {
+  "veo-3.1-generate-preview": { kind: "discrete", values: [4, 6, 8] },
+  "veo-3.1-fast-generate-preview": { kind: "discrete", values: [4, 6, 8] },
+  "veo-3.0-generate-001": { kind: "discrete", values: [4, 6, 8] },
+  "veo-3.0-fast-generate-001": { kind: "discrete", values: [4, 6, 8] },
+  "veo-2.0-generate-001": { kind: "discrete", values: [5, 6, 8] }
+};
+function getGeminiVideoDurationOptions(model) {
+  return GEMINI_VIDEO_DURATIONS[model];
+}
+export {
+  GEMINI_VIDEO_DURATIONS,
+  getGeminiVideoDurationOptions
+};
+//# sourceMappingURL=video-provider-options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-provider-options.js","sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["/**\n * Gemini Veo Video Generation Provider Options\n *\n * Based on https://ai.google.dev/gemini-api/docs/video\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type { GenerateVideosConfig } from '@google/genai'\nimport type { GEMINI_VIDEO_MODELS } from '../model-meta'\n\n/**\n * Model type for Gemini Veo video generation.\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoModel = (typeof GEMINI_VIDEO_MODELS)[number]\n\n/**\n * Supported aspect ratios for Veo video generation. This is the `size` value\n * for the Gemini video adapter — Veo expresses output shape as an aspect\n * ratio (plus an optional `resolution` in `modelOptions`), not pixel\n * dimensions.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoSize = '16:9' | '9:16'\n\n/**\n * Provider-specific options for Gemini Veo video generation.\n *\n * Derived from the SDK's `GenerateVideosConfig`, minus the fields the\n * adapter manages itself:\n * - `durationSeconds` — set via the typed top-level `duration` option\n *   (use `adapter.snapDuration(seconds)` to coerce raw seconds)\n * - `aspectRatio` — set via the top-level `size` option\n * - `lastFrame` / `referenceImages` — set via image parts in the `prompt`\n *   with `metadata.role: 'end_frame'` / `'reference'`\n * - `httpOptions` / `abortSignal` — client-level transport concerns\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoProviderOptions = Omit<\n  GenerateVideosConfig,\n  | 'durationSeconds'\n  | 'aspectRatio'\n  | 'lastFrame'\n  | 'referenceImages'\n  | 'httpOptions'\n  | 'abortSignal'\n>\n\n/**\n * Model-specific provider options mapping.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoModelProviderOptionsByName = {\n  [TModel in GeminiVideoModel]: GeminiVideoProviderOptions\n}\n\n/**\n * Model-specific size (aspect ratio) mapping.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoModelSizeByName = {\n  [TModel in GeminiVideoModel]: GeminiVideoSize\n}\n\n/**\n * Per-model prompt input modalities. Every Veo model accepts image\n * conditioning inputs (first frame, last frame, reference images) alongside\n * the text prompt.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoModelInputModalitiesByName = {\n  [TModel in GeminiVideoModel]: readonly ['image']\n}\n\n/**\n * Per-model duration unions (seconds, as numbers — the API's\n * `parameters.durationSeconds` field is numeric).\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GeminiVideoModelDurationByName = {\n  'veo-3.1-generate-preview': 4 | 6 | 8\n  'veo-3.1-fast-generate-preview': 4 | 6 | 8\n  'veo-3.0-generate-001': 4 | 6 | 8\n  'veo-3.0-fast-generate-001': 4 | 6 | 8\n  'veo-2.0-generate-001': 5 | 6 | 8\n}\n\n/**\n * Runtime duration table backing `availableDurations()` / `snapDuration()`.\n *\n * Curated from the official Veo docs\n * (https://ai.google.dev/gemini-api/docs/video) — the Gemini OpenAPI spec\n * types the `:predictLongRunning` request's `parameters` as unconstrained,\n * so it carries no per-model duration information to derive these from.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const GEMINI_VIDEO_DURATIONS: {\n  readonly [TModel in GeminiVideoModel]: DurationOptions<\n    GeminiVideoModelDurationByName[TModel]\n  >\n} = {\n  'veo-3.1-generate-preview': { kind: 'discrete', values: [4, 6, 8] },\n  'veo-3.1-fast-generate-preview': { kind: 'discrete', values: [4, 6, 8] },\n  'veo-3.0-generate-001': { kind: 'discrete', values: [4, 6, 8] },\n  'veo-3.0-fast-generate-001': { kind: 'discrete', values: [4, 6, 8] },\n  'veo-2.0-generate-001': { kind: 'discrete', values: [5, 6, 8] },\n}\n\n/**\n * Look up the duration options for a Veo model.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function getGeminiVideoDurationOptions<TModel extends GeminiVideoModel>(\n  model: TModel,\n): DurationOptions<GeminiVideoModelDurationByName[TModel]> {\n  return GEMINI_VIDEO_DURATIONS[model]\n}\n"],"names":[],"mappings":"AAwGO,MAAM,yBAIT;AAAA,EACF,4BAA4B,EAAE,MAAM,YAAY,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAA;AAAA,EAChE,iCAAiC,EAAE,MAAM,YAAY,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAA;AAAA,EACrE,wBAAwB,EAAE,MAAM,YAAY,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAA;AAAA,EAC5D,6BAA6B,EAAE,MAAM,YAAY,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAA;AAAA,EACjE,wBAAwB,EAAE,MAAM,YAAY,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAA;AAC9D;AAOO,SAAS,8BACd,OACyD;AACzD,SAAO,uBAAuB,KAAK;AACrC;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -58,13 +58,13 @@
     "@tanstack/ai-utils": "0.2.2"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.31.0"
+    "@tanstack/ai": "^0.32.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.3.3",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.31.0"
+    "@tanstack/ai": "0.32.0"
   },
   "scripts": {
     "build": "vite build",