@tanstack/ai-gemini 0.23.0 → 0.24.0

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

@@ -1,6 +1,6 @@
 import { GeminiImageModels } from '../model-meta.js';
-import { ImagePromptLanguage, PersonGeneration, SafetyFilterLevel } from '@google/genai';
-export type { ImagePromptLanguage, PersonGeneration, SafetyFilterLevel };
+import { ContentUnion, ImageConfig, ImagePromptLanguage, PersonGeneration, SafetyFilterLevel, SafetySetting, ThinkingConfig } from '@google/genai';
+export type { ContentUnion, ImageConfig, ImagePromptLanguage, PersonGeneration, SafetyFilterLevel, SafetySetting, ThinkingConfig, };
 /**
  * Gemini Imagen aspect ratio options
  * Controls the aspect ratio of generated images
@@ -91,11 +91,70 @@ export interface GeminiImageProviderOptions {
     labels?: Record<string, string>;
 }
 /**
- * Model-specific provider options mapping
- * Currently all Imagen models use the same options structure
+ * Provider options for Gemini native image models (Nano Banana and friends).
+ *
+ * These models are served by `generateContent`, not `generateImages`, so they
+ * are configured by @google/genai's `GenerateContentConfig` — a different
+ * shape from the Imagen-only {@link GeminiImageProviderOptions} above. Only
+ * the `GenerateContentConfig` fields with clear image-generation semantics are
+ * surfaced; sampling knobs (`temperature`, `topK`, …) and chat-only plumbing
+ * (`tools`, `responseSchema`, …) are deliberately left out.
+ *
+ * `responseModalities` is intentionally absent: the adapter always requests
+ * `['TEXT', 'IMAGE']`, and letting a caller override it would silently disable
+ * image output on an image-generation call.
+ */
+export interface GeminiNativeImageProviderOptions {
+    /**
+     * Optional seed for reproducible image generation
+     * When the same seed is used with the same prompt and settings,
+     * you should get similar (though not identical) results
+     */
+    seed?: number;
+    /**
+     * Per-category safety thresholds applied to the request
+     * Each entry pairs a HarmCategory with a HarmBlockThreshold
+     */
+    safetySettings?: Array<SafetySetting>;
+    /**
+     * Controls the model's internal reasoning before it emits an image
+     * Use to raise or disable the thinking budget on models that support it
+     */
+    thinkingConfig?: ThinkingConfig;
+    /**
+     * Native image output controls. Merged over the values derived from the
+     * portable `size` option, so fields set here win per field while the rest
+     * of `size` is preserved.
+     *
+     * Only `aspectRatio` and `imageSize` are accepted on the Gemini Developer
+     * API. Other SDK `ImageConfig` keys throw on this surface.
+     */
+    imageConfig?: GeminiNativeImageConfig;
+    /**
+     * System-level instructions that steer the model for the whole request,
+     * e.g. a house art direction applied on top of the per-call prompt
+     */
+    systemInstruction?: ContentUnion;
+}
+/**
+ * Every provider-option field this adapter understands, across both API
+ * paths. Used as the adapter's base (model-agnostic) option type; the
+ * per-model map below is what narrows a given model to the half that
+ * actually applies to it.
+ */
+export type GeminiAnyImageProviderOptions = GeminiImageProviderOptions & GeminiNativeImageProviderOptions;
+/**
+ * Model-specific provider options mapping.
+ * Gemini native image models go through `generateContent` and take
+ * `GenerateContentConfig` fields; Imagen models go through `generateImages`
+ * and take `GenerateImagesConfig` fields. Mirrors the native/Imagen split in
+ * {@link GeminiImageModelSizeByName} and
+ * {@link GeminiImageModelInputModalitiesByName}.
  */
 export type GeminiImageModelProviderOptionsByName = {
-    [K in GeminiImageModels]: GeminiImageProviderOptions;
+    [K in GeminiNativeImageModels]: GeminiNativeImageProviderOptions;
+} & {
+    [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: GeminiImageProviderOptions;
 };
 /**
  * Supported size strings for Gemini Imagen models
@@ -103,30 +162,111 @@ export type GeminiImageModelProviderOptionsByName = {
  */
 export type GeminiImageSize = '1024x1024' | '512x512' | '1024x768' | '1536x1024' | '1792x1024' | '1920x1080' | '768x1024' | '1024x1536' | '1024x1792' | '1080x1920';
 /**
- * Aspect ratios supported by Gemini native image models (via generateContent API).
- * Matches the SDK's ImageConfig.aspectRatio values.
+ * The ten aspect ratios every Gemini native image model accepts.
+ *
+ * Note `9:21` is deliberately absent: it exists only on Vertex / Cloud and is
+ * rejected by the Gemini API (`generateContent`), which is the surface this
+ * adapter targets.
+ *
+ * @see https://ai.google.dev/gemini-api/docs/image-generation
+ */
+export type GeminiStandardImageAspectRatio = '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
+/**
+ * The ten standard ratios plus the four extreme banner/strip ratios that only
+ * the Gemini 3.1 Flash Image models accept — 14 values, matching the
+ * `generateContent` `ImageConfig.aspectRatio` field union.
+ *
+ * @see https://ai.google.dev/api/generate-content
+ */
+export type GeminiExtendedImageAspectRatio = GeminiStandardImageAspectRatio | '1:4' | '4:1' | '1:8' | '8:1';
+/**
+ * Sizes for `gemini-3.1-flash-image` (and its shut-down `-preview` alias):
+ * all 14 aspect ratios at 512 / 1K / 2K / 4K. `512` is the wire token for the
+ * 0.5K tier — not `512px`, and the `K` is case-sensitive (`1k` is rejected).
+ */
+export type Gemini31FlashImageSize = `${GeminiExtendedImageAspectRatio}_${'512' | '1K' | '2K' | '4K'}`;
+/**
+ * Sizes for `gemini-3.1-flash-lite-image`: all 14 aspect ratios, 1K only.
+ * 2K and 4K are unsupported on this model.
+ *
+ * The four banner ratios (`1:4`, `4:1`, `1:8`, `8:1`) come from the Cloud
+ * model page. The Gemini API page states a count of 14 but does not list them.
+ *
+ * @see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-1-flash-lite-image
+ * @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite-image
+ */
+export type Gemini31FlashLiteImageSize = `${GeminiExtendedImageAspectRatio}_1K`;
+/**
+ * Sizes for `gemini-3-pro-image` (and its shut-down `-preview` alias): the ten
+ * standard aspect ratios at 1K / 2K / 4K. Pro has no 512 tier and none of the
+ * extreme banner ratios on the Gemini API.
+ */
+export type Gemini3ProImageSize = `${GeminiStandardImageAspectRatio}_${'1K' | '2K' | '4K'}`;
+/**
+ * Sizes for `gemini-2.5-flash-image`: a bare aspect ratio with no resolution
+ * suffix, e.g. `'16:9'`. Google documents no `image_size` value or default for
+ * this model — it emits a single fixed 1024px-class output — so the adapter
+ * sends `imageConfig.aspectRatio` and omits `imageSize` entirely rather than
+ * guessing a tier the API never documented.
  */
-export type GeminiNativeImageAspectRatio = '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '9:16' | '16:9' | '21:9';
+export type Gemini25FlashImageSize = GeminiStandardImageAspectRatio;
 /**
- * Resolution tiers for Gemini native image models.
- * Matches the SDK's ImageConfig.imageSize values.
+ * `imageConfig` fields the Gemini Developer API accepts on `generateContent`.
+ * Other `@google/genai` `ImageConfig` keys (`personGeneration`,
+ * `outputMimeType`, and more) throw on this surface.
  */
-export type GeminiNativeImageResolution = '1K' | '2K' | '4K';
+export type GeminiNativeImageConfig = {
+    aspectRatio?: GeminiExtendedImageAspectRatio;
+    imageSize?: '512' | '1K' | '2K' | '4K';
+};
 /**
- * Template literal size type for Gemini native image models: "16:9_4K", "1:1_2K", etc.
+ * Any size accepted by any Gemini native image model. Prefer the per-model
+ * narrowing in {@link GeminiImageModelSizeByName} — this union is the widest
+ * possible set and accepts combinations no single model supports.
  */
-export type GeminiNativeImageSize = `${GeminiNativeImageAspectRatio}_${GeminiNativeImageResolution}`;
+export type GeminiNativeImageSize = Gemini31FlashImageSize | Gemini31FlashLiteImageSize | Gemini3ProImageSize | Gemini25FlashImageSize;
 /**
  * Gemini native image models that use the generateContent API path.
- * These models support template literal sizes (aspectRatio_resolution).
+ * These models take an aspect-ratio-based size rather than Imagen's
+ * WIDTHxHEIGHT pixel strings.
+ *
+ * This array is the single source of truth for the native/Imagen split: the
+ * `GeminiNativeImageModels` union and the per-model option/size/modality maps
+ * all derive from it. The `satisfies` clause makes a typo (or a name that
+ * is not a known image model) a build error rather than a phantom key on every
+ * per-model map.
+ *
+ * It is also the single source of truth for the adapter's runtime routing
+ * — see {@link isGeminiNativeImageModel}. Adding a new `gemini-*` image model
+ * means adding it here as well as to `GEMINI_IMAGE_MODELS` in model-meta.
+ * Until it is listed here it routes to the Imagen API instead and fails
+ * loudly on the first call, rather than silently taking the wrong option
+ * shape.
+ */
+export declare const GEMINI_NATIVE_IMAGE_MODELS: readonly ["gemini-3.1-flash-image", "gemini-3.1-flash-image-preview", "gemini-3.1-flash-lite-image", "gemini-3-pro-image", "gemini-3-pro-image-preview", "gemini-2.5-flash-image"];
+export type GeminiNativeImageModels = (typeof GEMINI_NATIVE_IMAGE_MODELS)[number];
+/**
+ * Runtime counterpart to {@link GeminiNativeImageModels} — decides which of
+ * the two Gemini image APIs a model goes to.
+ *
+ * Membership in {@link GEMINI_NATIVE_IMAGE_MODELS}, not a `gemini-` prefix
+ * test, so the runtime route and the type-level split cannot drift apart. An
+ * id this package does not know about reaches the Imagen endpoint and fails
+ * there, which is the intended signal to add the model here rather than to
+ * have it silently take the native path with Imagen-shaped option types.
  */
-export type GeminiNativeImageModels = 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-image' | 'gemini-3-pro-image-preview' | 'gemini-2.5-flash-image';
+export declare function isGeminiNativeImageModel(model: string): boolean;
 /**
- * Model-specific size options mapping.
- * Gemini native image models use template literal sizes, Imagen models use pixel sizes.
+ * Model-specific size options mapping. Each native model gets its own ratio ×
+ * resolution set (they genuinely differ); Imagen models use pixel sizes.
  */
 export type GeminiImageModelSizeByName = {
-    [K in GeminiNativeImageModels]: GeminiNativeImageSize;
+    'gemini-3.1-flash-image': Gemini31FlashImageSize;
+    'gemini-3.1-flash-image-preview': Gemini31FlashImageSize;
+    'gemini-3.1-flash-lite-image': Gemini31FlashLiteImageSize;
+    'gemini-3-pro-image': Gemini3ProImageSize;
+    'gemini-3-pro-image-preview': Gemini3ProImageSize;
+    'gemini-2.5-flash-image': Gemini25FlashImageSize;
 } & {
     [K in Exclude<GeminiImageModels, GeminiNativeImageModels>]: GeminiImageSize;
 };
@@ -173,9 +313,16 @@ export declare function validatePrompt(options: {
 }): void;
 /**
  * Parses a Gemini native image size string into its components.
- * Format: "aspectRatio_resolution" e.g. "16:9_4K" → { aspectRatio: "16:9", resolution: "4K" }
+ *
+ * Format: `"aspectRatio_resolution"`, e.g. `"16:9_4K"` →
+ * `{ aspectRatio: "16:9", resolution: "4K" }`.
+ *
+ * The resolution suffix is optional: `gemini-2.5-flash-image` takes a bare
+ * aspect ratio (`"16:9"` → `{ aspectRatio: "16:9" }`) because Google documents
+ * no `image_size` for it, and the caller must then omit `imageSize` from the
+ * request rather than substituting a default.
  */
 export declare function parseNativeImageSize(size: string): {
     aspectRatio: string;
-    resolution: string;
+    resolution?: string;
 } | undefined;

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

@@ -1,5 +1,45 @@
 //#region src/image/image-provider-options.ts
 /**
+* Gemini native image models that use the generateContent API path.
+* These models take an aspect-ratio-based size rather than Imagen's
+* WIDTHxHEIGHT pixel strings.
+*
+* This array is the single source of truth for the native/Imagen split: the
+* `GeminiNativeImageModels` union and the per-model option/size/modality maps
+* all derive from it. The `satisfies` clause makes a typo (or a name that
+* is not a known image model) a build error rather than a phantom key on every
+* per-model map.
+*
+* It is also the single source of truth for the adapter's runtime routing
+* — see {@link isGeminiNativeImageModel}. Adding a new `gemini-*` image model
+* means adding it here as well as to `GEMINI_IMAGE_MODELS` in model-meta.
+* Until it is listed here it routes to the Imagen API instead and fails
+* loudly on the first call, rather than silently taking the wrong option
+* shape.
+*/
+var GEMINI_NATIVE_IMAGE_MODELS = [
+	"gemini-3.1-flash-image",
+	"gemini-3.1-flash-image-preview",
+	"gemini-3.1-flash-lite-image",
+	"gemini-3-pro-image",
+	"gemini-3-pro-image-preview",
+	"gemini-2.5-flash-image"
+];
+var NATIVE_IMAGE_MODEL_NAMES = new Set(GEMINI_NATIVE_IMAGE_MODELS);
+/**
+* Runtime counterpart to {@link GeminiNativeImageModels} — decides which of
+* the two Gemini image APIs a model goes to.
+*
+* Membership in {@link GEMINI_NATIVE_IMAGE_MODELS}, not a `gemini-` prefix
+* test, so the runtime route and the type-level split cannot drift apart. An
+* id this package does not know about reaches the Imagen endpoint and fails
+* there, which is the intended signal to add the model here rather than to
+* have it silently take the native path with Imagen-shaped option types.
+*/
+function isGeminiNativeImageModel(model) {
+	return NATIVE_IMAGE_MODEL_NAMES.has(model);
+}
+/**
 * Valid sizes for Gemini Imagen models
 * Gemini uses aspect ratios, but we map common WIDTHxHEIGHT formats to aspect ratios
 * These are approximate mappings based on common image dimensions
@@ -70,17 +110,24 @@ function validatePrompt(options) {
 }
 /**
 * Parses a Gemini native image size string into its components.
-* Format: "aspectRatio_resolution" e.g. "16:9_4K" → { aspectRatio: "16:9", resolution: "4K" }
+*
+* Format: `"aspectRatio_resolution"`, e.g. `"16:9_4K"` →
+* `{ aspectRatio: "16:9", resolution: "4K" }`.
+*
+* The resolution suffix is optional: `gemini-2.5-flash-image` takes a bare
+* aspect ratio (`"16:9"` → `{ aspectRatio: "16:9" }`) because Google documents
+* no `image_size` for it, and the caller must then omit `imageSize` from the
+* request rather than substituting a default.
 */
 function parseNativeImageSize(size) {
-	const [, aspectRatio, resolution] = size.match(/^(\d+:\d+)_(.+)$/) ?? [];
-	if (aspectRatio === void 0 || resolution === void 0) return void 0;
+	const [, aspectRatio, resolution] = size.match(/^(\d+:\d+)(?:_(.+))?$/) ?? [];
+	if (aspectRatio === void 0) return void 0;
 	return {
 		aspectRatio,
-		resolution
+		...resolution !== void 0 && { resolution }
 	};
 }
 //#endregion
-export { GEMINI_SIZE_TO_ASPECT_RATIO, parseNativeImageSize, sizeToAspectRatio, validateImageSize, validateNumberOfImages, validatePrompt };
+export { GEMINI_NATIVE_IMAGE_MODELS, GEMINI_SIZE_TO_ASPECT_RATIO, isGeminiNativeImageModel, parseNativeImageSize, sizeToAspectRatio, validateImageSize, validateNumberOfImages, validatePrompt };
 
 //# sourceMappingURL=image-provider-options.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"image-provider-options.js","names":[],"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.1-flash-lite-image'\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 * The Imagen 4 family all support up to 4 images per request via the Gemini\n * API (the rumored 8-image tier is Vertex-only and isn't reachable through\n * @google/genai today). Unknown models fall through to the shared cap\n * 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-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"],"mappings":";;;;;;AAiNA,IAAa,8BAAiE;CAE5E,aAAa;CACb,WAAW;CAEX,YAAY;CACZ,aAAa;CACb,aAAa;CACb,aAAa;CAEb,YAAY;CACZ,aAAa;CACb,aAAa;CACb,aAAa;AACf;;;;;AAMA,SAAgB,kBACd,MAC+B;CAC/B,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,OAAO,4BAA4B;AACrC;;;;;AAMA,SAAgB,kBACd,OACA,MACM;CACN,IAAI,CAAC,MAAM;CAGX,IAAI,CADgB,kBAAkB,IACjC,GAAa;EAChB,MAAM,aAAa,OAAO,KAAK,2BAA2B;EAC1D,MAAM,IAAI,MACR,iBAAiB,KAAK,eAAe,MAAM,8EACmC,WAAW,KAAK,IAAI,EAAE,6GAEtG;CACF;AACF;;;;;;;;;;AAWA,IAAM,6BAAqD;CACzD,2BAA2B;CAC3B,iCAAiC;CACjC,gCAAgC;AAClC;AAEA,IAAM,4BAA4B;;;;;;;AAQlC,SAAgB,uBACd,OACA,gBACM;CACN,IAAI,mBAAmB,KAAA,GAAW;CAElC,MAAM,YACJ,2BAA2B,UAAU;CACvC,IAAI,iBAAiB,KAAK,iBAAiB,WACzC,MAAM,IAAI,MACR,2BAA2B,eAAe,eAAe,MAAM,2BACpC,UAAU,EACvC;AAEJ;;;;AAKA,SAAgB,eAAe,SAGtB;CACP,MAAM,EAAE,QAAQ,UAAU;CAC1B,IAAI,CAAC,UAAU,OAAO,KAAK,CAAC,CAAC,WAAW,GACtC,MAAM,IAAI,MAAM,qCAAqC,MAAM,GAAG;AAElE;;;;;AAMA,SAAgB,qBACd,MACyD;CAEzD,MAAM,GAAG,aAAa,cADR,KAAK,MAAM,kBACW,KAAS,CAAC;CAC9C,IAAI,gBAAgB,KAAA,KAAa,eAAe,KAAA,GAAW,OAAO,KAAA;CAClE,OAAO;EAAE;EAAa;CAAW;AACnC"}
+{"version":3,"file":"image-provider-options.js","names":[],"sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { GeminiImageModels } from '../model-meta'\nimport type {\n  ContentUnion,\n  ImageConfig,\n  ImagePromptLanguage,\n  PersonGeneration,\n  SafetyFilterLevel,\n  SafetySetting,\n  ThinkingConfig,\n} from '@google/genai'\n\n// Re-export SDK types so users can use them directly\nexport type {\n  ContentUnion,\n  ImageConfig,\n  ImagePromptLanguage,\n  PersonGeneration,\n  SafetyFilterLevel,\n  SafetySetting,\n  ThinkingConfig,\n}\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 * Provider options for Gemini native image models (Nano Banana and friends).\n *\n * These models are served by `generateContent`, not `generateImages`, so they\n * are configured by @google/genai's `GenerateContentConfig` — a different\n * shape from the Imagen-only {@link GeminiImageProviderOptions} above. Only\n * the `GenerateContentConfig` fields with clear image-generation semantics are\n * surfaced; sampling knobs (`temperature`, `topK`, …) and chat-only plumbing\n * (`tools`, `responseSchema`, …) are deliberately left out.\n *\n * `responseModalities` is intentionally absent: the adapter always requests\n * `['TEXT', 'IMAGE']`, and letting a caller override it would silently disable\n * image output on an image-generation call.\n */\nexport interface GeminiNativeImageProviderOptions {\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   * Per-category safety thresholds applied to the request\n   * Each entry pairs a HarmCategory with a HarmBlockThreshold\n   */\n  safetySettings?: Array<SafetySetting>\n\n  /**\n   * Controls the model's internal reasoning before it emits an image\n   * Use to raise or disable the thinking budget on models that support it\n   */\n  thinkingConfig?: ThinkingConfig\n\n  /**\n   * Native image output controls. Merged over the values derived from the\n   * portable `size` option, so fields set here win per field while the rest\n   * of `size` is preserved.\n   *\n   * Only `aspectRatio` and `imageSize` are accepted on the Gemini Developer\n   * API. Other SDK `ImageConfig` keys throw on this surface.\n   */\n  imageConfig?: GeminiNativeImageConfig\n\n  /**\n   * System-level instructions that steer the model for the whole request,\n   * e.g. a house art direction applied on top of the per-call prompt\n   */\n  systemInstruction?: ContentUnion\n}\n\n/**\n * Every provider-option field this adapter understands, across both API\n * paths. Used as the adapter's base (model-agnostic) option type; the\n * per-model map below is what narrows a given model to the half that\n * actually applies to it.\n */\nexport type GeminiAnyImageProviderOptions = GeminiImageProviderOptions &\n  GeminiNativeImageProviderOptions\n\n/**\n * Model-specific provider options mapping.\n * Gemini native image models go through `generateContent` and take\n * `GenerateContentConfig` fields; Imagen models go through `generateImages`\n * and take `GenerateImagesConfig` fields. Mirrors the native/Imagen split in\n * {@link GeminiImageModelSizeByName} and\n * {@link GeminiImageModelInputModalitiesByName}.\n */\nexport type GeminiImageModelProviderOptionsByName = {\n  [K in GeminiNativeImageModels]: GeminiNativeImageProviderOptions\n} & {\n  [K in Exclude<\n    GeminiImageModels,\n    GeminiNativeImageModels\n  >]: 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 * The ten aspect ratios every Gemini native image model accepts.\n *\n * Note `9:21` is deliberately absent: it exists only on Vertex / Cloud and is\n * rejected by the Gemini API (`generateContent`), which is the surface this\n * adapter targets.\n *\n * @see https://ai.google.dev/gemini-api/docs/image-generation\n */\nexport type GeminiStandardImageAspectRatio =\n  | '1:1'\n  | '2:3'\n  | '3:2'\n  | '3:4'\n  | '4:3'\n  | '4:5'\n  | '5:4'\n  | '9:16'\n  | '16:9'\n  | '21:9'\n\n/**\n * The ten standard ratios plus the four extreme banner/strip ratios that only\n * the Gemini 3.1 Flash Image models accept — 14 values, matching the\n * `generateContent` `ImageConfig.aspectRatio` field union.\n *\n * @see https://ai.google.dev/api/generate-content\n */\nexport type GeminiExtendedImageAspectRatio =\n  | GeminiStandardImageAspectRatio\n  | '1:4'\n  | '4:1'\n  | '1:8'\n  | '8:1'\n\n/**\n * Sizes for `gemini-3.1-flash-image` (and its shut-down `-preview` alias):\n * all 14 aspect ratios at 512 / 1K / 2K / 4K. `512` is the wire token for the\n * 0.5K tier — not `512px`, and the `K` is case-sensitive (`1k` is rejected).\n */\nexport type Gemini31FlashImageSize =\n  `${GeminiExtendedImageAspectRatio}_${'512' | '1K' | '2K' | '4K'}`\n\n/**\n * Sizes for `gemini-3.1-flash-lite-image`: all 14 aspect ratios, 1K only.\n * 2K and 4K are unsupported on this model.\n *\n * The four banner ratios (`1:4`, `4:1`, `1:8`, `8:1`) come from the Cloud\n * model page. The Gemini API page states a count of 14 but does not list them.\n *\n * @see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-1-flash-lite-image\n * @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite-image\n */\nexport type Gemini31FlashLiteImageSize = `${GeminiExtendedImageAspectRatio}_1K`\n\n/**\n * Sizes for `gemini-3-pro-image` (and its shut-down `-preview` alias): the ten\n * standard aspect ratios at 1K / 2K / 4K. Pro has no 512 tier and none of the\n * extreme banner ratios on the Gemini API.\n */\nexport type Gemini3ProImageSize =\n  `${GeminiStandardImageAspectRatio}_${'1K' | '2K' | '4K'}`\n\n/**\n * Sizes for `gemini-2.5-flash-image`: a bare aspect ratio with no resolution\n * suffix, e.g. `'16:9'`. Google documents no `image_size` value or default for\n * this model — it emits a single fixed 1024px-class output — so the adapter\n * sends `imageConfig.aspectRatio` and omits `imageSize` entirely rather than\n * guessing a tier the API never documented.\n */\nexport type Gemini25FlashImageSize = GeminiStandardImageAspectRatio\n\n/**\n * `imageConfig` fields the Gemini Developer API accepts on `generateContent`.\n * Other `@google/genai` `ImageConfig` keys (`personGeneration`,\n * `outputMimeType`, and more) throw on this surface.\n */\nexport type GeminiNativeImageConfig = {\n  aspectRatio?: GeminiExtendedImageAspectRatio\n  imageSize?: '512' | '1K' | '2K' | '4K'\n}\n\n/**\n * Any size accepted by any Gemini native image model. Prefer the per-model\n * narrowing in {@link GeminiImageModelSizeByName} — this union is the widest\n * possible set and accepts combinations no single model supports.\n */\nexport type GeminiNativeImageSize =\n  | Gemini31FlashImageSize\n  | Gemini31FlashLiteImageSize\n  | Gemini3ProImageSize\n  | Gemini25FlashImageSize\n\n/**\n * Gemini native image models that use the generateContent API path.\n * These models take an aspect-ratio-based size rather than Imagen's\n * WIDTHxHEIGHT pixel strings.\n *\n * This array is the single source of truth for the native/Imagen split: the\n * `GeminiNativeImageModels` union and the per-model option/size/modality maps\n * all derive from it. The `satisfies` clause makes a typo (or a name that\n * is not a known image model) a build error rather than a phantom key on every\n * per-model map.\n *\n * It is also the single source of truth for the adapter's runtime routing\n * — see {@link isGeminiNativeImageModel}. Adding a new `gemini-*` image model\n * means adding it here as well as to `GEMINI_IMAGE_MODELS` in model-meta.\n * Until it is listed here it routes to the Imagen API instead and fails\n * loudly on the first call, rather than silently taking the wrong option\n * shape.\n */\nexport const GEMINI_NATIVE_IMAGE_MODELS = [\n  'gemini-3.1-flash-image',\n  'gemini-3.1-flash-image-preview',\n  'gemini-3.1-flash-lite-image',\n  'gemini-3-pro-image',\n  'gemini-3-pro-image-preview',\n  'gemini-2.5-flash-image',\n] as const satisfies ReadonlyArray<GeminiImageModels>\n\nexport type GeminiNativeImageModels =\n  (typeof GEMINI_NATIVE_IMAGE_MODELS)[number]\n\nconst NATIVE_IMAGE_MODEL_NAMES: ReadonlySet<string> = new Set(\n  GEMINI_NATIVE_IMAGE_MODELS,\n)\n\n/**\n * Runtime counterpart to {@link GeminiNativeImageModels} — decides which of\n * the two Gemini image APIs a model goes to.\n *\n * Membership in {@link GEMINI_NATIVE_IMAGE_MODELS}, not a `gemini-` prefix\n * test, so the runtime route and the type-level split cannot drift apart. An\n * id this package does not know about reaches the Imagen endpoint and fails\n * there, which is the intended signal to add the model here rather than to\n * have it silently take the native path with Imagen-shaped option types.\n */\nexport function isGeminiNativeImageModel(model: string): boolean {\n  return NATIVE_IMAGE_MODEL_NAMES.has(model)\n}\n\n/**\n * Model-specific size options mapping. Each native model gets its own ratio ×\n * resolution set (they genuinely differ); Imagen models use pixel sizes.\n */\nexport type GeminiImageModelSizeByName = {\n  'gemini-3.1-flash-image': Gemini31FlashImageSize\n  'gemini-3.1-flash-image-preview': Gemini31FlashImageSize\n  'gemini-3.1-flash-lite-image': Gemini31FlashLiteImageSize\n  'gemini-3-pro-image': Gemini3ProImageSize\n  'gemini-3-pro-image-preview': Gemini3ProImageSize\n  'gemini-2.5-flash-image': Gemini25FlashImageSize\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 * The Imagen 4 family all support up to 4 images per request via the Gemini\n * API (the rumored 8-image tier is Vertex-only and isn't reachable through\n * @google/genai today). Unknown models fall through to the shared cap\n * 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-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 *\n * Format: `\"aspectRatio_resolution\"`, e.g. `\"16:9_4K\"` →\n * `{ aspectRatio: \"16:9\", resolution: \"4K\" }`.\n *\n * The resolution suffix is optional: `gemini-2.5-flash-image` takes a bare\n * aspect ratio (`\"16:9\"` → `{ aspectRatio: \"16:9\" }`) because Google documents\n * no `image_size` for it, and the caller must then omit `imageSize` from the\n * request rather than substituting a default.\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) return undefined\n  return {\n    aspectRatio,\n    ...(resolution !== undefined && { resolution }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkVA,IAAa,6BAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;AACF;AAKA,IAAM,2BAAgD,IAAI,IACxD,0BACF;;;;;;;;;;;AAYA,SAAgB,yBAAyB,OAAwB;CAC/D,OAAO,yBAAyB,IAAI,KAAK;AAC3C;;;;;;AAkCA,IAAa,8BAAiE;CAE5E,aAAa;CACb,WAAW;CAEX,YAAY;CACZ,aAAa;CACb,aAAa;CACb,aAAa;CAEb,YAAY;CACZ,aAAa;CACb,aAAa;CACb,aAAa;AACf;;;;;AAMA,SAAgB,kBACd,MAC+B;CAC/B,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,OAAO,4BAA4B;AACrC;;;;;AAMA,SAAgB,kBACd,OACA,MACM;CACN,IAAI,CAAC,MAAM;CAGX,IAAI,CADgB,kBAAkB,IACjC,GAAa;EAChB,MAAM,aAAa,OAAO,KAAK,2BAA2B;EAC1D,MAAM,IAAI,MACR,iBAAiB,KAAK,eAAe,MAAM,8EACmC,WAAW,KAAK,IAAI,EAAE,6GAEtG;CACF;AACF;;;;;;;;;;AAWA,IAAM,6BAAqD;CACzD,2BAA2B;CAC3B,iCAAiC;CACjC,gCAAgC;AAClC;AAEA,IAAM,4BAA4B;;;;;;;AAQlC,SAAgB,uBACd,OACA,gBACM;CACN,IAAI,mBAAmB,KAAA,GAAW;CAElC,MAAM,YACJ,2BAA2B,UAAU;CACvC,IAAI,iBAAiB,KAAK,iBAAiB,WACzC,MAAM,IAAI,MACR,2BAA2B,eAAe,eAAe,MAAM,2BACpC,UAAU,EACvC;AAEJ;;;;AAKA,SAAgB,eAAe,SAGtB;CACP,MAAM,EAAE,QAAQ,UAAU;CAC1B,IAAI,CAAC,UAAU,OAAO,KAAK,CAAC,CAAC,WAAW,GACtC,MAAM,IAAI,MAAM,qCAAqC,MAAM,GAAG;AAElE;;;;;;;;;;;;AAaA,SAAgB,qBACd,MAC0D;CAE1D,MAAM,GAAG,aAAa,cADR,KAAK,MAAM,uBACW,KAAS,CAAC;CAC9C,IAAI,gBAAgB,KAAA,GAAW,OAAO,KAAA;CACtC,OAAO;EACL;EACA,GAAI,eAAe,KAAA,KAAa,EAAE,WAAW;CAC/C;AACF"}

package/dist/esm/index.d.ts

@@ -1,7 +1,8 @@
 export { GeminiTextAdapter, createGeminiChat, geminiText, type GeminiTextConfig, type GeminiTextProviderOptions, } from './adapters/text.js';
 export { createGeminiSummarize, geminiSummarize, type GeminiSummarizeConfig, type GeminiSummarizeModel, } from './adapters/summarize.js';
 export { GeminiImageAdapter, createGeminiImage, geminiImage, type GeminiImageConfig, } from './adapters/image.js';
-export type { GeminiImageProviderOptions, GeminiImageModelProviderOptionsByName, GeminiAspectRatio, PersonGeneration, SafetyFilterLevel, ImagePromptLanguage, } from './image/image-provider-options.js';
+export type { GeminiImageProviderOptions, GeminiNativeImageConfig, GeminiNativeImageProviderOptions, GeminiAnyImageProviderOptions, GeminiImageModelProviderOptionsByName, GeminiAspectRatio, GeminiImageModelSizeByName, GeminiStandardImageAspectRatio, GeminiExtendedImageAspectRatio, Gemini31FlashImageSize, Gemini31FlashLiteImageSize, Gemini3ProImageSize, Gemini25FlashImageSize, GeminiNativeImageSize, PersonGeneration, SafetyFilterLevel, ImagePromptLanguage, SafetySetting, ThinkingConfig, ImageConfig, ContentUnion, } from './image/image-provider-options.js';
+export { HarmBlockThreshold, HarmCategory } from '@google/genai';
 export { GeminiEmbeddingAdapter, createGeminiEmbedding, geminiEmbedding, type GeminiEmbeddingConfig, } from './adapters/embedding.js';
 export type { GeminiEmbeddingProviderOptions } from './embedding/embedding-provider-options.js';
 /**
@@ -21,6 +22,7 @@ export type { GeminiInteractionsVideoModel, GeminiOmniVideoProviderOptions, Gemi
 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_NATIVE_IMAGE_MODELS, isGeminiNativeImageModel, } from './image/image-provider-options.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';

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import { GEMINI_AUDIO_MODELS, GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, GEMINI_EMBEDDING_MODELS, GEMINI_IMAGE_MODELS, GEMINI_INTERACTIONS_VIDEO_MODELS, GEMINI_MODELS, GEMINI_TTS_MODELS, GEMINI_TTS_VOICES, GEMINI_VIDEO_MODELS } from "./model-meta.js";
 import { GeminiTextAdapter, createGeminiChat, geminiText } from "./adapters/text.js";
 import { createGeminiSummarize, geminiSummarize } from "./adapters/summarize.js";
+import { GEMINI_NATIVE_IMAGE_MODELS, isGeminiNativeImageModel } from "./image/image-provider-options.js";
 import { GeminiImageAdapter, createGeminiImage, geminiImage } from "./adapters/image.js";
 import { GeminiEmbeddingAdapter, createGeminiEmbedding, geminiEmbedding } from "./adapters/embedding.js";
 import { GeminiTTSAdapter, createGeminiSpeech, geminiSpeech } from "./adapters/tts.js";
@@ -10,4 +11,5 @@ import { GeminiVideoAdapter, createGeminiVideo, geminiVideo } from "./adapters/v
 import { geminiRealtimeToken } from "./realtime/token.js";
 import { geminiRealtime } from "./realtime/adapter.js";
 import "./realtime/index.js";
-export { GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, GEMINI_EMBEDDING_MODELS, GEMINI_MODELS, GEMINI_VIDEO_DURATIONS, GeminiAudioAdapter, GEMINI_AUDIO_MODELS as GeminiAudioModels, GeminiEmbeddingAdapter, GeminiImageAdapter, GEMINI_IMAGE_MODELS as GeminiImageModels, GEMINI_INTERACTIONS_VIDEO_MODELS as GeminiInteractionsVideoModels, GeminiTTSAdapter, GEMINI_TTS_MODELS as GeminiTTSModels, GEMINI_TTS_VOICES as GeminiTTSVoices, GeminiTextAdapter, GEMINI_MODELS as GeminiTextModels, GeminiVideoAdapter, GEMINI_VIDEO_MODELS as GeminiVideoModels, createGeminiAudio, createGeminiChat, createGeminiEmbedding, createGeminiImage, createGeminiSpeech, createGeminiSummarize, createGeminiVideo, geminiAudio, geminiEmbedding, geminiImage, geminiRealtime, geminiRealtimeToken, geminiSpeech, geminiSummarize, geminiText, geminiVideo, getGeminiVideoDurationOptions, isInteractionsVideoModel };
+import { HarmBlockThreshold, HarmCategory } from "@google/genai";
+export { GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS, GEMINI_EMBEDDING_MODELS, GEMINI_MODELS, GEMINI_NATIVE_IMAGE_MODELS, GEMINI_VIDEO_DURATIONS, GeminiAudioAdapter, GEMINI_AUDIO_MODELS as GeminiAudioModels, GeminiEmbeddingAdapter, GeminiImageAdapter, GEMINI_IMAGE_MODELS as GeminiImageModels, GEMINI_INTERACTIONS_VIDEO_MODELS as GeminiInteractionsVideoModels, GeminiTTSAdapter, GEMINI_TTS_MODELS as GeminiTTSModels, GEMINI_TTS_VOICES as GeminiTTSVoices, GeminiTextAdapter, GEMINI_MODELS as GeminiTextModels, GeminiVideoAdapter, GEMINI_VIDEO_MODELS as GeminiVideoModels, HarmBlockThreshold, HarmCategory, createGeminiAudio, createGeminiChat, createGeminiEmbedding, createGeminiImage, createGeminiSpeech, createGeminiSummarize, createGeminiVideo, geminiAudio, geminiEmbedding, geminiImage, geminiRealtime, geminiRealtimeToken, geminiSpeech, geminiSummarize, geminiText, geminiVideo, getGeminiVideoDurationOptions, isGeminiNativeImageModel, isInteractionsVideoModel };

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

@@ -233,8 +233,21 @@ export declare const GEMINI_MODELS: readonly ["gemini-3.7-flash", "gemini-3.6-fl
  */
 export declare const GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS: Set<string>;
 export type GeminiModels = (typeof GEMINI_MODELS)[number];
-export type GeminiImageModels = (typeof GEMINI_IMAGE_MODELS)[number];
-export declare const GEMINI_IMAGE_MODELS: readonly ["gemini-3.1-flash-image-preview", "gemini-3.1-flash-lite-image", "gemini-3-pro-image-preview", "gemini-2.5-flash-image", "imagen-4.0-generate-001", "imagen-4.0-fast-generate-001", "imagen-4.0-ultra-generate-001"];
+/**
+ * @deprecated Shut down 2026-06-25. Use `gemini-3.1-flash-image`.
+ */
+type Gemini31FlashImagePreviewModel = 'gemini-3.1-flash-image-preview';
+/**
+ * @deprecated Shut down 2026-06-25. Use `gemini-3-pro-image`.
+ */
+type Gemini3ProImagePreviewModel = 'gemini-3-pro-image-preview';
+export type GeminiImageModels = Exclude<(typeof GEMINI_IMAGE_MODELS)[number], Gemini31FlashImagePreviewModel | Gemini3ProImagePreviewModel> | Gemini31FlashImagePreviewModel | Gemini3ProImagePreviewModel;
+/**
+ * Image generation models. GA ids come first; the trailing `-preview` ids are
+ * shut-down aliases kept only so existing code keeps compiling — new code
+ * should use the GA id above its alias.
+ */
+export declare const GEMINI_IMAGE_MODELS: readonly ["gemini-3.1-flash-image", "gemini-3.1-flash-lite-image", "gemini-3-pro-image", "gemini-2.5-flash-image", "imagen-4.0-generate-001", "imagen-4.0-fast-generate-001", "imagen-4.0-ultra-generate-001", "gemini-3.1-flash-image-preview", "gemini-3-pro-image-preview"];
 /**
  * Text-to-speech models
  * @experimental Gemini TTS is an experimental feature and may change.

package/dist/esm/model-meta.js

@@ -65,7 +65,38 @@ var GEMINI_3_FLASH = {
 		output: { normal: 3 }
 	}
 };
+/**
+* Gemini 3 Pro Image ("Nano Banana Pro") — GA. Accepts the ten standard
+* aspect ratios at 1K / 2K / 4K.
+* @see https://ai.google.dev/gemini-api/docs/models/gemini-3-pro-image
+*/
 var GEMINI_3_PRO_IMAGE = {
+	name: "gemini-3-pro-image",
+	max_input_tokens: 65536,
+	max_output_tokens: 32768,
+	knowledge_cutoff: "2025-01-01",
+	supports: {
+		input: ["text", "image"],
+		output: ["text", "image"],
+		capabilities: [
+			"batch_api",
+			"structured_output",
+			"thinking"
+		],
+		tools: ["google_search"]
+	},
+	pricing: {
+		input: { normal: 2 },
+		output: { normal: .134 }
+	}
+};
+/**
+* @deprecated `gemini-3-pro-image-preview` was shut down on 2026-06-25. Use
+* the GA id `gemini-3-pro-image` instead — the preview id now 404s.
+* Kept in the model union so existing code still compiles.
+* @see https://ai.google.dev/gemini-api/docs/deprecations
+*/
+var GEMINI_3_PRO_IMAGE_PREVIEW = {
 	name: "gemini-3-pro-image-preview",
 	max_input_tokens: 65536,
 	max_output_tokens: 32768,
@@ -85,7 +116,35 @@ var GEMINI_3_PRO_IMAGE = {
 		output: { normal: .134 }
 	}
 };
+/**
+* Gemini 3.1 Flash Image ("Nano Banana 2") — GA. The only native image model
+* that accepts the four extreme banner ratios (1:4, 4:1, 1:8, 8:1) and the
+* 512 (0.5K) resolution tier.
+* @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-image
+*/
 var GEMINI_3_1_FLASH_IMAGE = {
+	name: "gemini-3.1-flash-image",
+	max_input_tokens: 131072,
+	max_output_tokens: 32768,
+	knowledge_cutoff: "2025-01-01",
+	supports: {
+		input: ["text", "image"],
+		output: ["text", "image"],
+		capabilities: ["batch_api", "thinking"],
+		tools: ["google_search"]
+	},
+	pricing: {
+		input: { normal: .5 },
+		output: { normal: 3 }
+	}
+};
+/**
+* @deprecated `gemini-3.1-flash-image-preview` was shut down on 2026-06-25.
+* Use the GA id `gemini-3.1-flash-image` instead — the preview id now 404s.
+* Kept in the model union so existing code still compiles.
+* @see https://ai.google.dev/gemini-api/docs/deprecations
+*/
+var GEMINI_3_1_FLASH_IMAGE_PREVIEW = {
 	name: "gemini-3.1-flash-image-preview",
 	max_input_tokens: 65536,
 	max_output_tokens: 65536,
@@ -105,6 +164,10 @@ var GEMINI_3_1_FLASH_IMAGE = {
 		output: { normal: 1.5 }
 	}
 };
+/**
+* Gemini 3.1 Flash Lite Image ("Nano Banana 2 Lite") — GA. 1K output only.
+* @see https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite-image
+*/
 var GEMINI_3_1_FLASH_LITE_IMAGE = {
 	name: "gemini-3.1-flash-lite-image",
 	max_input_tokens: 65536,
@@ -273,6 +336,17 @@ var GEMINI_2_5_FLASH = {
 		output: { normal: 2.5 }
 	}
 };
+/**
+* Gemini 2.5 Flash Image ("Nano Banana") — still GA, but documented as the
+* legacy member of the family. Google publishes no `image_size` value for it,
+* so its size type is a bare aspect ratio and the adapter sends no
+* `imageConfig.imageSize`.
+* @deprecated `gemini-2.5-flash-image` shuts down on 2026-10-02. Migrate to
+* `gemini-3.1-flash-lite-image` (cheapest successor) or
+* `gemini-3.1-flash-image`. Google's deprecations table still names the
+* already-dead `gemini-3.1-flash-image-preview` as the replacement.
+* @see https://ai.google.dev/gemini-api/docs/deprecations
+*/
 var GEMINI_2_5_FLASH_IMAGE = {
 	name: "gemini-2.5-flash-image",
 	max_input_tokens: 1048576,
@@ -720,6 +794,11 @@ var GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS = /* @__PURE__ */ new Set([
 	GEMINI_3_1_FLASH_LITE.name,
 	GEMINI_3_1_FLASH_LITE_PREVIEW.name
 ]);
+/**
+* Image generation models. GA ids come first; the trailing `-preview` ids are
+* shut-down aliases kept only so existing code keeps compiling — new code
+* should use the GA id above its alias.
+*/
 var GEMINI_IMAGE_MODELS = [
 	GEMINI_3_1_FLASH_IMAGE.name,
 	GEMINI_3_1_FLASH_LITE_IMAGE.name,
@@ -727,7 +806,9 @@ var GEMINI_IMAGE_MODELS = [
 	GEMINI_2_5_FLASH_IMAGE.name,
 	IMAGEN_4_GENERATE.name,
 	IMAGEN_4_GENERATE_FAST.name,
-	IMAGEN_4_GENERATE_ULTRA.name
+	IMAGEN_4_GENERATE_ULTRA.name,
+	GEMINI_3_1_FLASH_IMAGE_PREVIEW.name,
+	GEMINI_3_PRO_IMAGE_PREVIEW.name
 ];
 /**
 * Text-to-speech models