@tanstack/ai-gemini 0.32.1 → 0.34.1

package/README.md

@@ -240,6 +240,7 @@ Official adapters include:
 | [`@tanstack/ai-byteplus`](https://tanstack.com/ai/latest/docs/adapters/byteplus)     | BytePlus Seed chat, Seedance video, Seedream image, and Seed Speech TTS/ASR            |
 | [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal)               | fal.ai image, video, audio, speech, and transcription models                           |
 | [`@tanstack/ai-reactor`](https://tanstack.com/ai/latest/docs/adapters/reactor)       | Reactor live world and video generation (Orbis, Happy Oyster, LingBot, Helios, FastH3) |
+| [`@tanstack/ai-worldlabs`](https://tanstack.com/ai/latest/docs/adapters/worldlabs)   | World Labs Marble persistent 3D world generation                                       |
 | [`@tanstack/ai-cloudflare`](https://tanstack.com/ai/latest/docs/adapters/cloudflare) | Cloudflare Workers AI chat, embeddings, image, speech, transcription, and AI Gateway   |
 
 The adapter system is tree-shakeable by activity. Import `openaiText` for chat,

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

@@ -0,0 +1,27 @@
+import { BaseFilesAdapter, FileHandle, FileUploadInput } from '@tanstack/ai/adapters';
+import { GeminiClientConfig } from '../utils/client.js';
+export interface GeminiFilesConfig extends GeminiClientConfig {
+}
+/**
+ * Gemini Files adapter — uploads media to the Gemini Files API and references
+ * it by its file URI. Pair with `geminiText()` / `geminiImage()`: reference the
+ * returned handle via `fileSourceFromHandle(handle)`, which uses the handle URI
+ * (Gemini fetches it server-side as `fileData.fileUri`).
+ */
+export declare class GeminiFilesAdapter extends BaseFilesAdapter<'gemini'> {
+    readonly name: "gemini";
+    private readonly client;
+    constructor(config: GeminiFilesConfig);
+    upload(input: FileUploadInput): Promise<FileHandle<'gemini'>>;
+    get(id: string): Promise<FileHandle<'gemini'>>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * Create a Gemini Files adapter with an explicit API key.
+ */
+export declare function createGeminiFiles(apiKey: string, config?: Omit<GeminiFilesConfig, 'apiKey'>): GeminiFilesAdapter;
+/**
+ * Create a Gemini Files adapter, reading the API key from `GOOGLE_API_KEY` /
+ * `GEMINI_API_KEY`.
+ */
+export declare function geminiFiles(config?: Omit<GeminiFilesConfig, 'apiKey'>): GeminiFilesAdapter;

package/dist/esm/adapters/files.js

@@ -0,0 +1,62 @@
+import { createGeminiClient, getGeminiApiKeyFromEnv } from "../utils/client.js";
+import { BaseFilesAdapter, normalizeFileUploadInput } from "@tanstack/ai/adapters";
+//#region src/adapters/files.ts
+/**
+* Gemini Files adapter — uploads media to the Gemini Files API and references
+* it by its file URI. Pair with `geminiText()` / `geminiImage()`: reference the
+* returned handle via `fileSourceFromHandle(handle)`, which uses the handle URI
+* (Gemini fetches it server-side as `fileData.fileUri`).
+*/
+var GeminiFilesAdapter = class extends BaseFilesAdapter {
+	name = "gemini";
+	client;
+	constructor(config) {
+		super();
+		this.client = createGeminiClient(config);
+	}
+	async upload(input) {
+		const { blob, mimeType } = normalizeFileUploadInput(input);
+		return toFileHandle(await this.client.files.upload({
+			file: blob,
+			...mimeType ? { config: { mimeType } } : {}
+		}));
+	}
+	async get(id) {
+		return toFileHandle(await this.client.files.get({ name: id }));
+	}
+	async delete(id) {
+		await this.client.files.delete({ name: id });
+	}
+};
+function toFileHandle(file) {
+	if (!file.name) throw new Error("gemini: files.upload returned a file without a name");
+	const expiresAt = file.expirationTime ? Date.parse(file.expirationTime) : void 0;
+	return {
+		id: file.name,
+		provider: "gemini",
+		...file.uri ? { uri: file.uri } : {},
+		...file.mimeType ? { mimeType: file.mimeType } : {},
+		...file.sizeBytes ? { sizeBytes: Number(file.sizeBytes) } : {},
+		...expiresAt !== void 0 && !Number.isNaN(expiresAt) ? { expiresAt } : {}
+	};
+}
+/**
+* Create a Gemini Files adapter with an explicit API key.
+*/
+function createGeminiFiles(apiKey, config) {
+	return new GeminiFilesAdapter({
+		...config,
+		apiKey
+	});
+}
+/**
+* Create a Gemini Files adapter, reading the API key from `GOOGLE_API_KEY` /
+* `GEMINI_API_KEY`.
+*/
+function geminiFiles(config) {
+	return createGeminiFiles(getGeminiApiKeyFromEnv(), config);
+}
+//#endregion
+export { GeminiFilesAdapter, createGeminiFiles, geminiFiles };
+
+//# sourceMappingURL=files.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","names":[],"sources":["../../../src/adapters/files.ts"],"sourcesContent":["import {\n  BaseFilesAdapter,\n  normalizeFileUploadInput,\n} from '@tanstack/ai/adapters'\nimport { createGeminiClient, getGeminiApiKeyFromEnv } from '../utils/client'\nimport type { File as GeminiFile, GoogleGenAI } from '@google/genai'\nimport type { FileHandle, FileUploadInput } from '@tanstack/ai/adapters'\nimport type { GeminiClientConfig } from '../utils/client'\n\nexport interface GeminiFilesConfig extends GeminiClientConfig {}\n\n/**\n * Gemini Files adapter — uploads media to the Gemini Files API and references\n * it by its file URI. Pair with `geminiText()` / `geminiImage()`: reference the\n * returned handle via `fileSourceFromHandle(handle)`, which uses the handle URI\n * (Gemini fetches it server-side as `fileData.fileUri`).\n */\nexport class GeminiFilesAdapter extends BaseFilesAdapter<'gemini'> {\n  readonly name = 'gemini' as const\n  private readonly client: GoogleGenAI\n\n  constructor(config: GeminiFilesConfig) {\n    super()\n    this.client = createGeminiClient(config)\n  }\n\n  async upload(input: FileUploadInput): Promise<FileHandle<'gemini'>> {\n    const { blob, mimeType } = normalizeFileUploadInput(input)\n    const file = await this.client.files.upload({\n      file: blob,\n      ...(mimeType ? { config: { mimeType } } : {}),\n    })\n    return toFileHandle(file)\n  }\n\n  async get(id: string): Promise<FileHandle<'gemini'>> {\n    return toFileHandle(await this.client.files.get({ name: id }))\n  }\n\n  async delete(id: string): Promise<void> {\n    await this.client.files.delete({ name: id })\n  }\n}\n\nfunction toFileHandle(file: GeminiFile): FileHandle<'gemini'> {\n  // `name` (e.g. \"files/abc-123\") is the lifecycle id; `uri` is the URL Gemini\n  // fetches when the handle is referenced in a message.\n  if (!file.name) {\n    throw new Error('gemini: files.upload returned a file without a name')\n  }\n  const expiresAt = file.expirationTime\n    ? Date.parse(file.expirationTime)\n    : undefined\n  return {\n    id: file.name,\n    provider: 'gemini',\n    ...(file.uri ? { uri: file.uri } : {}),\n    ...(file.mimeType ? { mimeType: file.mimeType } : {}),\n    ...(file.sizeBytes ? { sizeBytes: Number(file.sizeBytes) } : {}),\n    ...(expiresAt !== undefined && !Number.isNaN(expiresAt)\n      ? { expiresAt }\n      : {}),\n  }\n}\n\n/**\n * Create a Gemini Files adapter with an explicit API key.\n */\nexport function createGeminiFiles(\n  apiKey: string,\n  config?: Omit<GeminiFilesConfig, 'apiKey'>,\n): GeminiFilesAdapter {\n  return new GeminiFilesAdapter({ ...config, apiKey })\n}\n\n/**\n * Create a Gemini Files adapter, reading the API key from `GOOGLE_API_KEY` /\n * `GEMINI_API_KEY`.\n */\nexport function geminiFiles(\n  config?: Omit<GeminiFilesConfig, 'apiKey'>,\n): GeminiFilesAdapter {\n  return createGeminiFiles(getGeminiApiKeyFromEnv(), config)\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,qBAAb,cAAwC,iBAA2B;CACjE,OAAgB;CAChB;CAEA,YAAY,QAA2B;EACrC,MAAM;EACN,KAAK,SAAS,mBAAmB,MAAM;CACzC;CAEA,MAAM,OAAO,OAAuD;EAClE,MAAM,EAAE,MAAM,aAAa,yBAAyB,KAAK;EAKzD,OAAO,aAAa,MAJD,KAAK,OAAO,MAAM,OAAO;GAC1C,MAAM;GACN,GAAI,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC;EAC7C,CAAC,CACuB;CAC1B;CAEA,MAAM,IAAI,IAA2C;EACnD,OAAO,aAAa,MAAM,KAAK,OAAO,MAAM,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/D;CAEA,MAAM,OAAO,IAA2B;EACtC,MAAM,KAAK,OAAO,MAAM,OAAO,EAAE,MAAM,GAAG,CAAC;CAC7C;AACF;AAEA,SAAS,aAAa,MAAwC;CAG5D,IAAI,CAAC,KAAK,MACR,MAAM,IAAI,MAAM,qDAAqD;CAEvE,MAAM,YAAY,KAAK,iBACnB,KAAK,MAAM,KAAK,cAAc,IAC9B,KAAA;CACJ,OAAO;EACL,IAAI,KAAK;EACT,UAAU;EACV,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;EACpC,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACnD,GAAI,KAAK,YAAY,EAAE,WAAW,OAAO,KAAK,SAAS,EAAE,IAAI,CAAC;EAC9D,GAAI,cAAc,KAAA,KAAa,CAAC,OAAO,MAAM,SAAS,IAClD,EAAE,UAAU,IACZ,CAAC;CACP;AACF;;;;AAKA,SAAgB,kBACd,QACA,QACoB;CACpB,OAAO,IAAI,mBAAmB;EAAE,GAAG;EAAQ;CAAO,CAAC;AACrD;;;;;AAMA,SAAgB,YACd,QACoB;CACpB,OAAO,kBAAkB,uBAAuB,GAAG,MAAM;AAC3D"}

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

@@ -27,6 +27,7 @@ export type GeminiImageModel = GeminiImageModels;
 export declare class GeminiImageAdapter<TModel extends GeminiImageModel> extends BaseImageAdapter<TModel, GeminiAnyImageProviderOptions, GeminiImageModelProviderOptionsByName, GeminiImageModelSizeByName, GeminiImageModelInputModalitiesByName> {
     readonly kind: "image";
     readonly name: "gemini";
+    readonly supportsFileSources = true;
     '~types': {
         providerOptions: GeminiAnyImageProviderOptions;
         modelProviderOptionsByName: GeminiImageModelProviderOptionsByName;

package/dist/esm/adapters/image.js

@@ -2,7 +2,7 @@ import { buildGeminiUsage } from "../usage.js";
 import { createGeminiClient, generateId, getGeminiApiKeyFromEnv } from "../utils/client.js";
 import "../utils/index.js";
 import { isGeminiNativeImageModel, parseNativeImageSize, sizeToAspectRatio, validateImageSize, validateNumberOfImages, validatePrompt } from "../image/image-provider-options.js";
-import { resolveMediaPrompt } from "@tanstack/ai";
+import { fileReferenceFor, isFileSource, resolveMediaPrompt } from "@tanstack/ai";
 import { BaseImageAdapter } from "@tanstack/ai/adapters";
 //#region src/adapters/image.ts
 /**
@@ -22,6 +22,7 @@ import { BaseImageAdapter } from "@tanstack/ai/adapters";
 var GeminiImageAdapter = class extends BaseImageAdapter {
 	kind = "image";
 	name = "gemini";
+	supportsFileSources = true;
 	client;
 	constructor(config, model) {
 		super(model, config);
@@ -114,7 +115,7 @@ var GeminiImageAdapter = class extends BaseImageAdapter {
 			data: part.source.value
 		} };
 		return { fileData: {
-			fileUri: part.source.value,
+			fileUri: isFileSource(part.source) ? fileReferenceFor(part.source, this.name) : part.source.value,
 			mimeType: part.source.mimeType ?? "image/jpeg"
 		} };
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","names":[],"sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport { buildGeminiUsage } from '../usage'\nimport {\n  isGeminiNativeImageModel,\n  parseNativeImageSize,\n  sizeToAspectRatio,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type { GeminiImageModels } from '../model-meta'\nimport type {\n  GeminiAnyImageProviderOptions,\n  GeminiImageModelInputModalitiesByName,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiNativeImageProviderOptions,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ImagePart,\n  MediaInputMetadata,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type {\n  Content,\n  GenerateContentConfig,\n  GenerateContentResponse,\n  GenerateImagesConfig,\n  GenerateImagesResponse,\n  GoogleGenAI,\n  ImageConfig,\n  Part,\n} from '@google/genai'\nimport type { GeminiClientConfig } from '../utils/client'\n\n/**\n * Configuration for Gemini image adapter\n */\nexport interface GeminiImageConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini Image */\nexport type GeminiImageModel = GeminiImageModels\n\n/**\n * Gemini Image Generation Adapter\n *\n * Tree-shakeable adapter for Gemini image generation functionality.\n * Supports Imagen 3/4 models (via generateImages API) and Gemini native\n * image models like Nano Banana 2 (via generateContent API).\n *\n * Features:\n * - Aspect ratio-based image sizing\n * - Person generation controls\n * - Safety filtering\n * - Watermark options\n * - Extended resolution tiers (Nano Banana 2)\n */\nexport class GeminiImageAdapter<\n  TModel extends GeminiImageModel,\n> extends BaseImageAdapter<\n  TModel,\n  GeminiAnyImageProviderOptions,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiImageModelInputModalitiesByName\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'gemini' as const\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: GeminiAnyImageProviderOptions\n    modelProviderOptionsByName: GeminiImageModelProviderOptionsByName\n    modelSizeByName: GeminiImageModelSizeByName\n    modelInputModalitiesByName: GeminiImageModelInputModalitiesByName\n  }\n\n  private readonly client: GoogleGenAI\n\n  constructor(config: GeminiImageConfig, model: TModel) {\n    super(model, config)\n    this.client = createGeminiClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GeminiAnyImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, logger } = options\n\n    logger.request(\n      `activity=generateImage provider=gemini model=${this.model}`,\n      {\n        provider: 'gemini',\n        model: this.model,\n      },\n    )\n\n    try {\n      const resolved = resolveMediaPrompt(options.prompt)\n\n      // Image-only prompts are allowed (the image inputs carry the intent);\n      // a prompt with neither text nor images is always an error.\n      if (resolved.images.length === 0) {\n        validatePrompt({ prompt: resolved.text, model })\n      }\n\n      if (resolved.videos.length > 0) {\n        throw new Error(\n          `${this.name}.generateImages does not support video prompt parts (model: ${model}).`,\n        )\n      }\n      if (resolved.audios.length > 0) {\n        throw new Error(\n          `${this.name}.generateImages does not support audio prompt parts (model: ${model}).`,\n        )\n      }\n\n      if (isGeminiNativeImageModel(model)) {\n        return await this.generateWithGeminiApi(options, resolved)\n      }\n\n      // Imagen does not accept image inputs — it's strictly text-to-image.\n      if (resolved.images.length > 0) {\n        throw new Error(\n          `${this.name}: model \"${model}\" (Imagen) does not support image prompt parts. ` +\n            `Use a Gemini-native image model (e.g. gemini-2.5-flash-image, \"nano-banana\") for image-conditioned generation.`,\n        )\n      }\n\n      // Imagen models path (generateImages API)\n      validateImageSize(model, options.size)\n      validateNumberOfImages(model, options.numberOfImages)\n\n      const config = this.buildImagenConfig(options)\n\n      const response = await this.client.models.generateImages({\n        model,\n        prompt: resolved.text,\n        config,\n      })\n\n      return this.transformImagenResponse(model, response)\n    } catch (error) {\n      logger.errors('gemini.generateImage fatal', {\n        error,\n        source: 'gemini.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private async generateWithGeminiApi(\n    options: ImageGenerationOptions<GeminiNativeImageProviderOptions>,\n    resolved: ResolvedMediaPrompt,\n  ): Promise<ImageGenerationResult> {\n    const { model, size, numberOfImages, modelOptions } = options\n\n    const parsedSize = size ? parseNativeImageSize(size) : undefined\n\n    // The portable `size` option is the baseline; modelOptions.imageConfig is\n    // the provider escape hatch and wins per field, so a caller passing only\n    // `imageConfig.imageSize` keeps the aspectRatio derived from `size`.\n    const imageConfig: ImageConfig = {\n      ...(parsedSize?.aspectRatio && { aspectRatio: parsedSize.aspectRatio }),\n      ...(parsedSize?.resolution && { imageSize: parsedSize.resolution }),\n      ...modelOptions?.imageConfig,\n    }\n\n    // Named picks, never a wholesale spread: the Imagen-shaped fields of\n    // GeminiImageProviderOptions (personGeneration, safetyFilterLevel,\n    // addWatermark, outputMimeType, …) are only valid on GenerateImagesConfig\n    // and would be rejected by generateContent. Picking by name means no\n    // Imagen field can reach this path even if one slips past the per-model\n    // provider-options map.\n    const nativeConfig: GenerateContentConfig = {\n      ...(modelOptions?.seed !== undefined && { seed: modelOptions.seed }),\n      ...(modelOptions?.safetySettings !== undefined && {\n        safetySettings: modelOptions.safetySettings,\n      }),\n      ...(modelOptions?.thinkingConfig !== undefined && {\n        thinkingConfig: modelOptions.thinkingConfig,\n      }),\n      ...(modelOptions?.systemInstruction !== undefined && {\n        systemInstruction: modelOptions.systemInstruction,\n      }),\n    }\n\n    const config: GenerateContentConfig = {\n      ...nativeConfig,\n      // Include TEXT so the model can interleave descriptions between images.\n      // IMPORTANT: responseModalities is a protected default — set it AFTER\n      // nativeConfig so nothing can silently disable image output.\n      responseModalities: ['TEXT', 'IMAGE'],\n      ...(Object.keys(imageConfig).length > 0 && { imageConfig }),\n    }\n\n    const contents = this.buildContents(resolved, numberOfImages)\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents,\n      config,\n    })\n\n    return this.transformGeminiResponse(model, response)\n  }\n\n  /**\n   * Build the multimodal `contents` payload. Text-only prompts pass through\n   * as a plain string (the SDK accepts it directly); prompts with image\n   * parts become a single user `Content` whose `parts` mirror the prompt's\n   * interleaved order — position is meaningful to Gemini (\"not like this\n   * *(image)*, more like this *(image)*\").\n   *\n   * The generateContent API has no numberOfImages parameter, so when more\n   * than one image is requested a trailing instruction is appended.\n   */\n  private buildContents(\n    resolved: ResolvedMediaPrompt,\n    numberOfImages: number | undefined,\n  ): string | Array<Content> {\n    const countInstruction =\n      numberOfImages && numberOfImages > 1\n        ? `Generate ${numberOfImages} distinct images.`\n        : undefined\n\n    if (resolved.images.length === 0) {\n      return countInstruction\n        ? `${resolved.text} ${countInstruction}`\n        : resolved.text\n    }\n\n    const parts: Array<Part> = resolved.parts.map((part) => {\n      if (part.type === 'text') {\n        return { text: part.content }\n      }\n      if (part.type === 'image') {\n        return this.imagePartToGeminiPart(part)\n      }\n      // Video / audio parts were rejected in generateImages above.\n      throw new Error(\n        `gemini: unsupported prompt part type \"${part.type}\" in image generation.`,\n      )\n    })\n    if (countInstruction) {\n      parts.push({ text: countInstruction })\n    }\n    return [{ role: 'user', parts }]\n  }\n\n  private imagePartToGeminiPart(part: ImagePart<MediaInputMetadata>): Part {\n    if (part.source.type === 'data') {\n      return {\n        inlineData: {\n          mimeType: part.source.mimeType || 'image/png',\n          data: part.source.value,\n        },\n      }\n    }\n    // URL sources (public HTTPS, Files API URIs, gs://) pass through as\n    // `fileData` and Gemini fetches them server-side — same as the chat\n    // adapter. Fetching locally and inlining as base64 double-buffers the\n    // image and OOMs on memory-constrained runtimes (e.g. Cloudflare\n    // Workers).\n    return {\n      fileData: {\n        fileUri: part.source.value,\n        mimeType: part.source.mimeType ?? 'image/jpeg',\n      },\n    }\n  }\n\n  private transformGeminiResponse(\n    model: string,\n    response: GenerateContentResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const textParts: Array<string> = []\n    const parts = response.candidates?.[0]?.content?.parts ?? []\n\n    for (const part of parts) {\n      if (\n        part.inlineData?.data &&\n        typeof part.inlineData.data === 'string' &&\n        part.inlineData.data.length > 0\n      ) {\n        images.push({ b64Json: part.inlineData.data })\n      } else if (typeof part.text === 'string' && part.text.length > 0) {\n        textParts.push(part.text)\n      }\n    }\n\n    // If the model returned only text parts (for example a safety refusal\n    // or a \"can't do that\" message), surface the text instead of silently\n    // resolving to an empty images array — otherwise callers can't tell a\n    // generation failure apart from a genuine empty response.\n    if (images.length === 0) {\n      const reason =\n        textParts.length > 0\n          ? `: ${textParts.join(' ').trim()}`\n          : ' (no inline image or text parts were returned).'\n      throw new Error(`Gemini ${model} returned no images${reason}`)\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      // Surface token usage (with per-modality breakdown) when the model\n      // reports it (e.g. Nano Banana via generateContent). Conditionally spread\n      // to satisfy exactOptionalPropertyTypes — only include usage when\n      // present. See #330.\n      ...(response.usageMetadata\n        ? { usage: buildGeminiUsage(response.usageMetadata) }\n        : {}),\n    }\n  }\n\n  private buildImagenConfig(\n    options: ImageGenerationOptions<GeminiAnyImageProviderOptions>,\n  ): GenerateImagesConfig {\n    const { size, numberOfImages, modelOptions } = options\n\n    // Build with conditional spreads — under exactOptionalPropertyTypes the\n    // vendor `GenerateImagesConfig` fields are `field?: T` (no `| undefined`),\n    // so we can only assign the property when we actually have a value.\n    const sizeAspectRatio = size ? sizeToAspectRatio(size) : undefined\n\n    // Named picks, never a wholesale spread — the mirror image of the native\n    // path below. A native-only field (safetySettings, thinkingConfig,\n    // imageConfig, systemInstruction) belongs to GenerateContentConfig and is\n    // rejected by generateImages with 400 INVALID_ARGUMENT, so it must not be\n    // able to reach here even when the caller's `modelOptions` was typed\n    // against both shapes at once (e.g. an adapter inferred from a union of\n    // model names).\n    return {\n      numberOfImages: numberOfImages ?? 1,\n      // Map size to aspect ratio if provided; modelOptions.aspectRatio,\n      // picked after it, overrides.\n      ...(sizeAspectRatio !== undefined && { aspectRatio: sizeAspectRatio }),\n      ...(modelOptions?.aspectRatio !== undefined && {\n        aspectRatio: modelOptions.aspectRatio,\n      }),\n      ...(modelOptions?.personGeneration !== undefined && {\n        personGeneration: modelOptions.personGeneration,\n      }),\n      ...(modelOptions?.safetyFilterLevel !== undefined && {\n        safetyFilterLevel: modelOptions.safetyFilterLevel,\n      }),\n      ...(modelOptions?.seed !== undefined && { seed: modelOptions.seed }),\n      ...(modelOptions?.addWatermark !== undefined && {\n        addWatermark: modelOptions.addWatermark,\n      }),\n      ...(modelOptions?.language !== undefined && {\n        language: modelOptions.language,\n      }),\n      ...(modelOptions?.negativePrompt !== undefined && {\n        negativePrompt: modelOptions.negativePrompt,\n      }),\n      ...(modelOptions?.outputMimeType !== undefined && {\n        outputMimeType: modelOptions.outputMimeType,\n      }),\n      ...(modelOptions?.outputCompressionQuality !== undefined && {\n        outputCompressionQuality: modelOptions.outputCompressionQuality,\n      }),\n      ...(modelOptions?.guidanceScale !== undefined && {\n        guidanceScale: modelOptions.guidanceScale,\n      }),\n      ...(modelOptions?.enhancePrompt !== undefined && {\n        enhancePrompt: modelOptions.enhancePrompt,\n      }),\n      ...(modelOptions?.includeSafetyAttributes !== undefined && {\n        includeSafetyAttributes: modelOptions.includeSafetyAttributes,\n      }),\n      ...(modelOptions?.includeRaiReason !== undefined && {\n        includeRaiReason: modelOptions.includeRaiReason,\n      }),\n      ...(modelOptions?.outputGcsUri !== undefined && {\n        outputGcsUri: modelOptions.outputGcsUri,\n      }),\n      ...(modelOptions?.labels !== undefined && {\n        labels: modelOptions.labels,\n      }),\n    }\n  }\n\n  private transformImagenResponse(\n    model: string,\n    response: GenerateImagesResponse,\n  ): ImageGenerationResult {\n    const entries = response.generatedImages ?? []\n    const images: Array<GeneratedImage> = []\n    const filterReasons: Array<string> = []\n\n    for (const item of entries) {\n      const b64Json = item.image?.imageBytes\n      if (b64Json) {\n        images.push({\n          b64Json,\n          ...(item.enhancedPrompt !== undefined && {\n            revisedPrompt: item.enhancedPrompt,\n          }),\n        })\n        continue\n      }\n      // Imagen can drop individual entries with a raiFilteredReason when\n      // Responsible-AI filters fire. Preserve the reason so callers can\n      // surface it instead of silently getting back fewer images.\n      const reason = (item as { raiFilteredReason?: string }).raiFilteredReason\n      if (reason) {\n        filterReasons.push(reason)\n      }\n    }\n\n    // Every entry was filtered — no usable images to return. Throw rather\n    // than resolve to an empty array so the caller is forced to handle the\n    // failure mode explicitly.\n    if (entries.length > 0 && images.length === 0) {\n      const joined = filterReasons.length > 0 ? filterReasons.join('; ') : ''\n      throw new Error(\n        `Imagen ${model} returned no images: all ${entries.length} generated image(s) were filtered by Responsible-AI${joined ? ` (${joined})` : ''}.`,\n      )\n    }\n\n    // Partial filter: surface via console.warn since ImageGenerationResult\n    // has no warnings field. Callers that care can still inspect the count\n    // mismatch between requested and returned images.\n    if (filterReasons.length > 0 && typeof console !== 'undefined') {\n      console.warn(\n        `[gemini-image] ${filterReasons.length} of ${entries.length} images from ${model} were filtered by Responsible-AI: ${filterReasons.join('; ')}`,\n      )\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n    }\n  }\n}\n\n/** @deprecated Shut down 2026-06-25. Use `gemini-3.1-flash-image`. */\nexport function createGeminiImage(\n  model: 'gemini-3.1-flash-image-preview',\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3.1-flash-image-preview'>\n/** @deprecated Shut down 2026-06-25. Use `gemini-3-pro-image`. */\nexport function createGeminiImage(\n  model: 'gemini-3-pro-image-preview',\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3-pro-image-preview'>\n/**\n * Creates a Gemini image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'imagen-4.0-generate-001')\n * @param apiKey - Your Google API key\n * @param config - Optional additional configuration\n * @returns Configured Gemini image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGeminiImage('imagen-4.0-generate-001', \"your-api-key\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGeminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel>\nexport function createGeminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel> {\n  return new GeminiImageAdapter({ apiKey, ...config }, model)\n}\n\n/** @deprecated Shut down 2026-06-25. Use `gemini-3.1-flash-image`. */\nexport function geminiImage(\n  model: 'gemini-3.1-flash-image-preview',\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3.1-flash-image-preview'>\n/** @deprecated Shut down 2026-06-25. Use `gemini-3-pro-image`. */\nexport function geminiImage(\n  model: 'gemini-3-pro-image-preview',\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3-pro-image-preview'>\n/**\n * Creates a Gemini image adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `GOOGLE_API_KEY` or `GEMINI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'imagen-4.0-generate-001')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Gemini image adapter instance with resolved types\n * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses GOOGLE_API_KEY from environment\n * const adapter = geminiImage('imagen-4.0-generate-001');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function geminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel>\nexport function geminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiImage(model, apiKey, config)\n}\n"],"mappings":"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"}
+{"version":3,"file":"image.js","names":[],"sources":["../../../src/adapters/image.ts"],"sourcesContent":["import {\n  fileReferenceFor,\n  isFileSource,\n  resolveMediaPrompt,\n} from '@tanstack/ai'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport { buildGeminiUsage } from '../usage'\nimport {\n  isGeminiNativeImageModel,\n  parseNativeImageSize,\n  sizeToAspectRatio,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type { GeminiImageModels } from '../model-meta'\nimport type {\n  GeminiAnyImageProviderOptions,\n  GeminiImageModelInputModalitiesByName,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiNativeImageProviderOptions,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n  ImagePart,\n  MediaInputMetadata,\n  ResolvedMediaPrompt,\n} from '@tanstack/ai'\nimport type {\n  Content,\n  GenerateContentConfig,\n  GenerateContentResponse,\n  GenerateImagesConfig,\n  GenerateImagesResponse,\n  GoogleGenAI,\n  ImageConfig,\n  Part,\n} from '@google/genai'\nimport type { GeminiClientConfig } from '../utils/client'\n\n/**\n * Configuration for Gemini image adapter\n */\nexport interface GeminiImageConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini Image */\nexport type GeminiImageModel = GeminiImageModels\n\n/**\n * Gemini Image Generation Adapter\n *\n * Tree-shakeable adapter for Gemini image generation functionality.\n * Supports Imagen 3/4 models (via generateImages API) and Gemini native\n * image models like Nano Banana 2 (via generateContent API).\n *\n * Features:\n * - Aspect ratio-based image sizing\n * - Person generation controls\n * - Safety filtering\n * - Watermark options\n * - Extended resolution tiers (Nano Banana 2)\n */\nexport class GeminiImageAdapter<\n  TModel extends GeminiImageModel,\n> extends BaseImageAdapter<\n  TModel,\n  GeminiAnyImageProviderOptions,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiImageModelInputModalitiesByName\n> {\n  override readonly kind = 'image' as const\n  readonly name = 'gemini' as const\n  // Consumes Gemini Files API references (geminiFiles()) as fileData.fileUri.\n  override readonly supportsFileSources = true\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: GeminiAnyImageProviderOptions\n    modelProviderOptionsByName: GeminiImageModelProviderOptionsByName\n    modelSizeByName: GeminiImageModelSizeByName\n    modelInputModalitiesByName: GeminiImageModelInputModalitiesByName\n  }\n\n  private readonly client: GoogleGenAI\n\n  constructor(config: GeminiImageConfig, model: TModel) {\n    super(model, config)\n    this.client = createGeminiClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GeminiAnyImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, logger } = options\n\n    logger.request(\n      `activity=generateImage provider=gemini model=${this.model}`,\n      {\n        provider: 'gemini',\n        model: this.model,\n      },\n    )\n\n    try {\n      const resolved = resolveMediaPrompt(options.prompt)\n\n      // Image-only prompts are allowed (the image inputs carry the intent);\n      // a prompt with neither text nor images is always an error.\n      if (resolved.images.length === 0) {\n        validatePrompt({ prompt: resolved.text, model })\n      }\n\n      if (resolved.videos.length > 0) {\n        throw new Error(\n          `${this.name}.generateImages does not support video prompt parts (model: ${model}).`,\n        )\n      }\n      if (resolved.audios.length > 0) {\n        throw new Error(\n          `${this.name}.generateImages does not support audio prompt parts (model: ${model}).`,\n        )\n      }\n\n      if (isGeminiNativeImageModel(model)) {\n        return await this.generateWithGeminiApi(options, resolved)\n      }\n\n      // Imagen does not accept image inputs — it's strictly text-to-image.\n      if (resolved.images.length > 0) {\n        throw new Error(\n          `${this.name}: model \"${model}\" (Imagen) does not support image prompt parts. ` +\n            `Use a Gemini-native image model (e.g. gemini-2.5-flash-image, \"nano-banana\") for image-conditioned generation.`,\n        )\n      }\n\n      // Imagen models path (generateImages API)\n      validateImageSize(model, options.size)\n      validateNumberOfImages(model, options.numberOfImages)\n\n      const config = this.buildImagenConfig(options)\n\n      const response = await this.client.models.generateImages({\n        model,\n        prompt: resolved.text,\n        config,\n      })\n\n      return this.transformImagenResponse(model, response)\n    } catch (error) {\n      logger.errors('gemini.generateImage fatal', {\n        error,\n        source: 'gemini.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private async generateWithGeminiApi(\n    options: ImageGenerationOptions<GeminiNativeImageProviderOptions>,\n    resolved: ResolvedMediaPrompt,\n  ): Promise<ImageGenerationResult> {\n    const { model, size, numberOfImages, modelOptions } = options\n\n    const parsedSize = size ? parseNativeImageSize(size) : undefined\n\n    // The portable `size` option is the baseline; modelOptions.imageConfig is\n    // the provider escape hatch and wins per field, so a caller passing only\n    // `imageConfig.imageSize` keeps the aspectRatio derived from `size`.\n    const imageConfig: ImageConfig = {\n      ...(parsedSize?.aspectRatio && { aspectRatio: parsedSize.aspectRatio }),\n      ...(parsedSize?.resolution && { imageSize: parsedSize.resolution }),\n      ...modelOptions?.imageConfig,\n    }\n\n    // Named picks, never a wholesale spread: the Imagen-shaped fields of\n    // GeminiImageProviderOptions (personGeneration, safetyFilterLevel,\n    // addWatermark, outputMimeType, …) are only valid on GenerateImagesConfig\n    // and would be rejected by generateContent. Picking by name means no\n    // Imagen field can reach this path even if one slips past the per-model\n    // provider-options map.\n    const nativeConfig: GenerateContentConfig = {\n      ...(modelOptions?.seed !== undefined && { seed: modelOptions.seed }),\n      ...(modelOptions?.safetySettings !== undefined && {\n        safetySettings: modelOptions.safetySettings,\n      }),\n      ...(modelOptions?.thinkingConfig !== undefined && {\n        thinkingConfig: modelOptions.thinkingConfig,\n      }),\n      ...(modelOptions?.systemInstruction !== undefined && {\n        systemInstruction: modelOptions.systemInstruction,\n      }),\n    }\n\n    const config: GenerateContentConfig = {\n      ...nativeConfig,\n      // Include TEXT so the model can interleave descriptions between images.\n      // IMPORTANT: responseModalities is a protected default — set it AFTER\n      // nativeConfig so nothing can silently disable image output.\n      responseModalities: ['TEXT', 'IMAGE'],\n      ...(Object.keys(imageConfig).length > 0 && { imageConfig }),\n    }\n\n    const contents = this.buildContents(resolved, numberOfImages)\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents,\n      config,\n    })\n\n    return this.transformGeminiResponse(model, response)\n  }\n\n  /**\n   * Build the multimodal `contents` payload. Text-only prompts pass through\n   * as a plain string (the SDK accepts it directly); prompts with image\n   * parts become a single user `Content` whose `parts` mirror the prompt's\n   * interleaved order — position is meaningful to Gemini (\"not like this\n   * *(image)*, more like this *(image)*\").\n   *\n   * The generateContent API has no numberOfImages parameter, so when more\n   * than one image is requested a trailing instruction is appended.\n   */\n  private buildContents(\n    resolved: ResolvedMediaPrompt,\n    numberOfImages: number | undefined,\n  ): string | Array<Content> {\n    const countInstruction =\n      numberOfImages && numberOfImages > 1\n        ? `Generate ${numberOfImages} distinct images.`\n        : undefined\n\n    if (resolved.images.length === 0) {\n      return countInstruction\n        ? `${resolved.text} ${countInstruction}`\n        : resolved.text\n    }\n\n    const parts: Array<Part> = resolved.parts.map((part) => {\n      if (part.type === 'text') {\n        return { text: part.content }\n      }\n      if (part.type === 'image') {\n        return this.imagePartToGeminiPart(part)\n      }\n      // Video / audio parts were rejected in generateImages above.\n      throw new Error(\n        `gemini: unsupported prompt part type \"${part.type}\" in image generation.`,\n      )\n    })\n    if (countInstruction) {\n      parts.push({ text: countInstruction })\n    }\n    return [{ role: 'user', parts }]\n  }\n\n  private imagePartToGeminiPart(part: ImagePart<MediaInputMetadata>): Part {\n    if (part.source.type === 'data') {\n      return {\n        inlineData: {\n          mimeType: part.source.mimeType || 'image/png',\n          data: part.source.value,\n        },\n      }\n    }\n    // URL sources (public HTTPS, Files API URIs, gs://) pass through as\n    // `fileData` and Gemini fetches them server-side — same as the chat\n    // adapter. Fetching locally and inlining as base64 double-buffers the\n    // image and OOMs on memory-constrained runtimes (e.g. Cloudflare\n    // Workers). A file source's handle is the file URI (throws when another\n    // provider issued it).\n    const fileUri = isFileSource(part.source)\n      ? fileReferenceFor(part.source, this.name)\n      : part.source.value\n    return {\n      fileData: {\n        fileUri,\n        mimeType: part.source.mimeType ?? 'image/jpeg',\n      },\n    }\n  }\n\n  private transformGeminiResponse(\n    model: string,\n    response: GenerateContentResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const textParts: Array<string> = []\n    const parts = response.candidates?.[0]?.content?.parts ?? []\n\n    for (const part of parts) {\n      if (\n        part.inlineData?.data &&\n        typeof part.inlineData.data === 'string' &&\n        part.inlineData.data.length > 0\n      ) {\n        images.push({ b64Json: part.inlineData.data })\n      } else if (typeof part.text === 'string' && part.text.length > 0) {\n        textParts.push(part.text)\n      }\n    }\n\n    // If the model returned only text parts (for example a safety refusal\n    // or a \"can't do that\" message), surface the text instead of silently\n    // resolving to an empty images array — otherwise callers can't tell a\n    // generation failure apart from a genuine empty response.\n    if (images.length === 0) {\n      const reason =\n        textParts.length > 0\n          ? `: ${textParts.join(' ').trim()}`\n          : ' (no inline image or text parts were returned).'\n      throw new Error(`Gemini ${model} returned no images${reason}`)\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      // Surface token usage (with per-modality breakdown) when the model\n      // reports it (e.g. Nano Banana via generateContent). Conditionally spread\n      // to satisfy exactOptionalPropertyTypes — only include usage when\n      // present. See #330.\n      ...(response.usageMetadata\n        ? { usage: buildGeminiUsage(response.usageMetadata) }\n        : {}),\n    }\n  }\n\n  private buildImagenConfig(\n    options: ImageGenerationOptions<GeminiAnyImageProviderOptions>,\n  ): GenerateImagesConfig {\n    const { size, numberOfImages, modelOptions } = options\n\n    // Build with conditional spreads — under exactOptionalPropertyTypes the\n    // vendor `GenerateImagesConfig` fields are `field?: T` (no `| undefined`),\n    // so we can only assign the property when we actually have a value.\n    const sizeAspectRatio = size ? sizeToAspectRatio(size) : undefined\n\n    // Named picks, never a wholesale spread — the mirror image of the native\n    // path below. A native-only field (safetySettings, thinkingConfig,\n    // imageConfig, systemInstruction) belongs to GenerateContentConfig and is\n    // rejected by generateImages with 400 INVALID_ARGUMENT, so it must not be\n    // able to reach here even when the caller's `modelOptions` was typed\n    // against both shapes at once (e.g. an adapter inferred from a union of\n    // model names).\n    return {\n      numberOfImages: numberOfImages ?? 1,\n      // Map size to aspect ratio if provided; modelOptions.aspectRatio,\n      // picked after it, overrides.\n      ...(sizeAspectRatio !== undefined && { aspectRatio: sizeAspectRatio }),\n      ...(modelOptions?.aspectRatio !== undefined && {\n        aspectRatio: modelOptions.aspectRatio,\n      }),\n      ...(modelOptions?.personGeneration !== undefined && {\n        personGeneration: modelOptions.personGeneration,\n      }),\n      ...(modelOptions?.safetyFilterLevel !== undefined && {\n        safetyFilterLevel: modelOptions.safetyFilterLevel,\n      }),\n      ...(modelOptions?.seed !== undefined && { seed: modelOptions.seed }),\n      ...(modelOptions?.addWatermark !== undefined && {\n        addWatermark: modelOptions.addWatermark,\n      }),\n      ...(modelOptions?.language !== undefined && {\n        language: modelOptions.language,\n      }),\n      ...(modelOptions?.negativePrompt !== undefined && {\n        negativePrompt: modelOptions.negativePrompt,\n      }),\n      ...(modelOptions?.outputMimeType !== undefined && {\n        outputMimeType: modelOptions.outputMimeType,\n      }),\n      ...(modelOptions?.outputCompressionQuality !== undefined && {\n        outputCompressionQuality: modelOptions.outputCompressionQuality,\n      }),\n      ...(modelOptions?.guidanceScale !== undefined && {\n        guidanceScale: modelOptions.guidanceScale,\n      }),\n      ...(modelOptions?.enhancePrompt !== undefined && {\n        enhancePrompt: modelOptions.enhancePrompt,\n      }),\n      ...(modelOptions?.includeSafetyAttributes !== undefined && {\n        includeSafetyAttributes: modelOptions.includeSafetyAttributes,\n      }),\n      ...(modelOptions?.includeRaiReason !== undefined && {\n        includeRaiReason: modelOptions.includeRaiReason,\n      }),\n      ...(modelOptions?.outputGcsUri !== undefined && {\n        outputGcsUri: modelOptions.outputGcsUri,\n      }),\n      ...(modelOptions?.labels !== undefined && {\n        labels: modelOptions.labels,\n      }),\n    }\n  }\n\n  private transformImagenResponse(\n    model: string,\n    response: GenerateImagesResponse,\n  ): ImageGenerationResult {\n    const entries = response.generatedImages ?? []\n    const images: Array<GeneratedImage> = []\n    const filterReasons: Array<string> = []\n\n    for (const item of entries) {\n      const b64Json = item.image?.imageBytes\n      if (b64Json) {\n        images.push({\n          b64Json,\n          ...(item.enhancedPrompt !== undefined && {\n            revisedPrompt: item.enhancedPrompt,\n          }),\n        })\n        continue\n      }\n      // Imagen can drop individual entries with a raiFilteredReason when\n      // Responsible-AI filters fire. Preserve the reason so callers can\n      // surface it instead of silently getting back fewer images.\n      const reason = (item as { raiFilteredReason?: string }).raiFilteredReason\n      if (reason) {\n        filterReasons.push(reason)\n      }\n    }\n\n    // Every entry was filtered — no usable images to return. Throw rather\n    // than resolve to an empty array so the caller is forced to handle the\n    // failure mode explicitly.\n    if (entries.length > 0 && images.length === 0) {\n      const joined = filterReasons.length > 0 ? filterReasons.join('; ') : ''\n      throw new Error(\n        `Imagen ${model} returned no images: all ${entries.length} generated image(s) were filtered by Responsible-AI${joined ? ` (${joined})` : ''}.`,\n      )\n    }\n\n    // Partial filter: surface via console.warn since ImageGenerationResult\n    // has no warnings field. Callers that care can still inspect the count\n    // mismatch between requested and returned images.\n    if (filterReasons.length > 0 && typeof console !== 'undefined') {\n      console.warn(\n        `[gemini-image] ${filterReasons.length} of ${entries.length} images from ${model} were filtered by Responsible-AI: ${filterReasons.join('; ')}`,\n      )\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n    }\n  }\n}\n\n/** @deprecated Shut down 2026-06-25. Use `gemini-3.1-flash-image`. */\nexport function createGeminiImage(\n  model: 'gemini-3.1-flash-image-preview',\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3.1-flash-image-preview'>\n/** @deprecated Shut down 2026-06-25. Use `gemini-3-pro-image`. */\nexport function createGeminiImage(\n  model: 'gemini-3-pro-image-preview',\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3-pro-image-preview'>\n/**\n * Creates a Gemini image adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'imagen-4.0-generate-001')\n * @param apiKey - Your Google API key\n * @param config - Optional additional configuration\n * @returns Configured Gemini image adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGeminiImage('imagen-4.0-generate-001', \"your-api-key\");\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A cute baby sea otter'\n * });\n * ```\n */\nexport function createGeminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel>\nexport function createGeminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel> {\n  return new GeminiImageAdapter({ apiKey, ...config }, model)\n}\n\n/** @deprecated Shut down 2026-06-25. Use `gemini-3.1-flash-image`. */\nexport function geminiImage(\n  model: 'gemini-3.1-flash-image-preview',\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3.1-flash-image-preview'>\n/** @deprecated Shut down 2026-06-25. Use `gemini-3-pro-image`. */\nexport function geminiImage(\n  model: 'gemini-3-pro-image-preview',\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<'gemini-3-pro-image-preview'>\n/**\n * Creates a Gemini image adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `GOOGLE_API_KEY` or `GEMINI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'imagen-4.0-generate-001')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Gemini image adapter instance with resolved types\n * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses GOOGLE_API_KEY from environment\n * const adapter = geminiImage('imagen-4.0-generate-001');\n *\n * const result = await generateImage({\n *   adapter,\n *   prompt: 'A beautiful sunset over mountains'\n * });\n * ```\n */\nexport function geminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel>\nexport function geminiImage<TModel extends GeminiImageModel>(\n  model: TModel,\n  config?: Omit<GeminiImageConfig, 'apiKey'>,\n): GeminiImageAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiImage(model, apiKey, config)\n}\n"],"mappings":"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"}

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

@@ -37,6 +37,7 @@ type ResolveToolCapabilities<TModel extends string> = TModel extends keyof Gemin
 export declare class GeminiTextAdapter<TModel extends (typeof GEMINI_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, GeminiMessageMetadataByModality, TToolCapabilities, GeminiToolCallMetadata> {
     readonly kind: "text";
     readonly name: "gemini";
+    readonly supportsFileSources = true;
     private readonly client;
     constructor(config: GeminiTextConfig, model: TModel);
     chatStream(options: TextOptions<GeminiTextProviderOptions>): AsyncIterable<AdapterYieldChunk>;

package/dist/esm/adapters/text.js

@@ -4,7 +4,7 @@ import { createGeminiClient, generateId, getGeminiApiKeyFromEnv } from "../utils
 import "../utils/index.js";
 import { GEMINI_COMBINED_TOOLS_AND_SCHEMA_MODELS } from "../model-meta.js";
 import { FinishReason } from "@google/genai";
-import { EventType, normalizeSystemPrompts } from "@tanstack/ai";
+import { EventType, fileReferenceFor, isFileSource, normalizeSystemPrompts } from "@tanstack/ai";
 import { toRunErrorRawEvent } from "@tanstack/ai/adapter-internals";
 import { BaseTextAdapter } from "@tanstack/ai/adapters";
 //#region src/adapters/text.ts
@@ -17,6 +17,23 @@ var DEFAULT_MEDIA_MIME_TYPES = {
 	video: "video/mp4",
 	document: "application/pdf"
 };
+function getGroundingSources(metadata) {
+	const sources = /* @__PURE__ */ new Map();
+	for (const chunk of metadata.groundingChunks ?? []) {
+		const url = chunk.web?.uri;
+		if (!url) continue;
+		const existing = sources.get(url);
+		if (existing) {
+			if (!existing.title && chunk.web?.title) existing.title = chunk.web.title;
+			continue;
+		}
+		sources.set(url, {
+			url,
+			...chunk.web?.title ? { title: chunk.web.title } : {}
+		});
+	}
+	return [...sources.values()];
+}
 /** True when any message carries a video part requesting agentic processing. */
 function hasAgenticVideo(messages) {
 	return messages.some((msg) => Array.isArray(msg.content) && msg.content.some((part) => part.type === "video" && part.metadata?.processing === "agentic"));
@@ -29,7 +46,10 @@ function contentPartToInteraction(part) {
 	};
 	const source = part.source;
 	const mimeType = source.type === "data" ? source.mimeType : source.mimeType ?? DEFAULT_MEDIA_MIME_TYPES[part.type];
-	const base = source.type === "data" ? {
+	const base = isFileSource(source) ? {
+		uri: fileReferenceFor(source, "gemini"),
+		mime_type: mimeType
+	} : source.type === "data" ? {
 		data: source.value,
 		mime_type: mimeType
 	} : {
@@ -82,6 +102,7 @@ function buildInteractionsInput(messages) {
 var GeminiTextAdapter = class extends BaseTextAdapter {
 	kind = "text";
 	name = "gemini";
+	supportsFileSources = true;
 	client;
 	constructor(config, model) {
 		super({}, model);
@@ -343,6 +364,41 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 		let hasEmittedRunStarted = false;
 		let hasEmittedTextMessageStart = false;
 		let hasEmittedStepStarted = false;
+		let groundingMetadata;
+		let groundingCallEmitted = false;
+		const adapterName = this.name;
+		const emitGroundingToolCall = function* () {
+			if (!groundingMetadata || groundingCallEmitted) return;
+			const sources = getGroundingSources(groundingMetadata);
+			if (!(sources.length > 0 || (groundingMetadata.webSearchQueries?.length ?? 0) > 0 || groundingMetadata.searchEntryPoint !== void 0)) return;
+			groundingCallEmitted = true;
+			const toolCallId = generateId(adapterName);
+			const metadata = {
+				providerExecuted: true,
+				sources,
+				gemini: { groundingMetadata }
+			};
+			yield {
+				type: EventType.TOOL_CALL_START,
+				toolCallId,
+				toolCallName: "google_search",
+				toolName: "google_search",
+				parentMessageId: messageId,
+				model,
+				timestamp: Date.now(),
+				index: toolCallMap.size,
+				metadata
+			};
+			yield {
+				type: EventType.TOOL_CALL_END,
+				toolCallId,
+				toolCallName: "google_search",
+				toolName: "google_search",
+				model,
+				timestamp: Date.now(),
+				input: { ...groundingMetadata.webSearchQueries && { queries: groundingMetadata.webSearchQueries } }
+			};
+		};
 		for await (const chunk of result) {
 			logger.provider(`provider=gemini`, { chunk });
 			if (!hasEmittedRunStarted) {
@@ -356,6 +412,7 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 					parentRunId: options.parentRunId
 				};
 			}
+			if (chunk.candidates?.[0]?.groundingMetadata) groundingMetadata = chunk.candidates[0].groundingMetadata;
 			if (chunk.candidates?.[0]?.content?.parts) {
 				const parts = chunk.candidates[0].content.parts;
 				for (const part of parts) {
@@ -517,6 +574,7 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 				};
 			}
 			if (chunk.candidates?.[0]?.finishReason) {
+				yield* emitGroundingToolCall();
 				const finishReason = chunk.candidates[0].finishReason;
 				for (const [toolCallId, toolCallData] of toolCallMap.entries()) {
 					let parsedInput = {};
@@ -581,6 +639,7 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 				};
 			}
 		}
+		yield* emitGroundingToolCall();
 	}
 	convertContentPartToGemini(part) {
 		switch (part.type) {
@@ -589,11 +648,12 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 			case "audio":
 			case "video":
 			case "document": {
+				const fileUri = isFileSource(part.source) ? fileReferenceFor(part.source, this.name) : part.source.value;
 				const geminiPart = part.source.type === "data" ? { inlineData: {
 					data: part.source.value,
 					mimeType: part.source.mimeType
 				} } : { fileData: {
-					fileUri: part.source.value,
+					fileUri,
 					mimeType: part.source.mimeType ?? DEFAULT_MEDIA_MIME_TYPES[part.type]
 				} };
 				if (part.type === "video") {
@@ -619,13 +679,15 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 			if (Array.isArray(msg.content)) for (const contentPart of msg.content) parts.push(this.convertContentPartToGemini(contentPart));
 			else if (msg.content && msg.role !== "tool") parts.push({ text: msg.content });
 			if (msg.role === "assistant" && msg.toolCalls?.length) for (const toolCall of msg.toolCalls) {
+				const metadata = toolCall.metadata;
+				if (metadata?.providerExecuted) continue;
 				let parsedArgs = {};
 				try {
 					parsedArgs = toolCall.function.arguments ? JSON.parse(toolCall.function.arguments) : {};
 				} catch {
 					parsedArgs = {};
 				}
-				const thoughtSignature = toolCall.metadata?.thoughtSignature;
+				const thoughtSignature = metadata?.thoughtSignature;
 				const part = { functionCall: {
 					id: toolCall.id,
 					name: toolCall.function.name,
@@ -646,6 +708,7 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 						mimeType: part.source.mimeType
 					} });
 					else {
+						const fileUri = isFileSource(part.source) ? fileReferenceFor(part.source, this.name) : part.source.value;
 						const defaultMimeType = {
 							image: "image/jpeg",
 							audio: "audio/mp3",
@@ -653,7 +716,7 @@ var GeminiTextAdapter = class extends BaseTextAdapter {
 							document: "application/pdf"
 						}[part.type];
 						mediaParts.push({ fileData: {
-							fileUri: part.source.value,
+							fileUri,
 							mimeType: part.source.mimeType ?? defaultMimeType
 						} });
 					}