@tanstack/ai-gemini 0.9.0 → 0.9.1

package/dist/esm/adapters/image.js

@@ -9,20 +9,35 @@ class GeminiImageAdapter extends BaseImageAdapter {
     this.client = createGeminiClient(config);
   }
   async generateImages(options) {
-    const { model, prompt } = options;
-    validatePrompt({ prompt, model });
-    if (this.isGeminiImageModel(model)) {
-      return this.generateWithGeminiApi(options);
+    const { model, prompt, logger } = options;
+    logger.request(
+      `activity=generateImage provider=gemini model=${this.model}`,
+      {
+        provider: "gemini",
+        model: this.model
+      }
+    );
+    try {
+      validatePrompt({ prompt, model });
+      if (this.isGeminiImageModel(model)) {
+        return await this.generateWithGeminiApi(options);
+      }
+      validateImageSize(model, options.size);
+      validateNumberOfImages(model, options.numberOfImages);
+      const config = this.buildImagenConfig(options);
+      const response = await this.client.models.generateImages({
+        model,
+        prompt,
+        config
+      });
+      return this.transformImagenResponse(model, response);
+    } catch (error) {
+      logger.errors("gemini.generateImage fatal", {
+        error,
+        source: "gemini.generateImage"
+      });
+      throw error;
     }
-    validateImageSize(model, options.size);
-    validateNumberOfImages(model, options.numberOfImages);
-    const config = this.buildImagenConfig(options);
-    const response = await this.client.models.generateImages({
-      model,
-      prompt,
-      config
-    });
-    return this.transformImagenResponse(model, response);
   }
   isGeminiImageModel(model) {
     return model.startsWith("gemini-");

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport {\n  parseNativeImageSize,\n  sizeToAspectRatio,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type { GEMINI_IMAGE_MODELS } from '../model-meta'\nimport type {\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiImageProviderOptions,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  GenerateContentConfig,\n  GenerateContentResponse,\n  GenerateImagesConfig,\n  GenerateImagesResponse,\n  GoogleGenAI,\n} from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\n\n/**\n * Configuration for Gemini image adapter\n */\nexport interface GeminiImageConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini Image */\nexport type GeminiImageModel = (typeof GEMINI_IMAGE_MODELS)[number]\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  GeminiImageProviderOptions,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName\n> {\n  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: GeminiImageProviderOptions\n    modelProviderOptionsByName: GeminiImageModelProviderOptionsByName\n    modelSizeByName: GeminiImageModelSizeByName\n  }\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiImageConfig, model: TModel) {\n    super({}, model)\n    this.client = createGeminiClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt } = options\n\n    validatePrompt({ prompt, model })\n\n    if (this.isGeminiImageModel(model)) {\n      return this.generateWithGeminiApi(options)\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,\n      config,\n    })\n\n    return this.transformImagenResponse(model, response)\n  }\n\n  private isGeminiImageModel(model: string): boolean {\n    return model.startsWith('gemini-')\n  }\n\n  private async generateWithGeminiApi(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, size, numberOfImages, modelOptions } = options\n\n    const parsedSize = size ? parseNativeImageSize(size) : undefined\n\n    // The generateContent API has no numberOfImages parameter.\n    // Instead, augment the prompt to request multiple images when needed.\n    const augmentedPrompt =\n      numberOfImages && numberOfImages > 1\n        ? `${prompt} Generate ${numberOfImages} distinct images.`\n        : prompt\n\n    const config: GenerateContentConfig = {\n      // Include TEXT so the model can interleave descriptions between images\n      responseModalities: ['TEXT', 'IMAGE'],\n      ...(parsedSize && {\n        imageConfig: {\n          ...(parsedSize.aspectRatio && {\n            aspectRatio: parsedSize.aspectRatio,\n          }),\n          ...(parsedSize.resolution && {\n            imageSize: parsedSize.resolution,\n          }),\n        },\n      }),\n      ...modelOptions,\n    }\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents: augmentedPrompt,\n      config,\n    })\n\n    return this.transformGeminiResponse(model, response)\n  }\n\n  private transformGeminiResponse(\n    model: string,\n    response: GenerateContentResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\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      }\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      usage: undefined,\n    }\n  }\n\n  private buildImagenConfig(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): GenerateImagesConfig {\n    const { size, numberOfImages, modelOptions } = options\n\n    return {\n      numberOfImages: numberOfImages ?? 1,\n      // Map size to aspect ratio if provided (modelOptions.aspectRatio will override)\n      aspectRatio: size ? sizeToAspectRatio(size) : undefined,\n      ...modelOptions,\n    }\n  }\n\n  private transformImagenResponse(\n    model: string,\n    response: GenerateImagesResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = (response.generatedImages ?? []).map(\n      (item) => ({\n        b64Json: item.image?.imageBytes,\n        revisedPrompt: item.enhancedPrompt,\n      }),\n    )\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      usage: undefined,\n    }\n  }\n}\n\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-3.0-generate-002')\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-3.0-generate-002', \"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> {\n  return new GeminiImageAdapter({ apiKey, ...config }, model)\n}\n\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> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiImage(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport {\n  parseNativeImageSize,\n  sizeToAspectRatio,\n  validateImageSize,\n  validateNumberOfImages,\n  validatePrompt,\n} from '../image/image-provider-options'\nimport type { GEMINI_IMAGE_MODELS } from '../model-meta'\nimport type {\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName,\n  GeminiImageProviderOptions,\n} from '../image/image-provider-options'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  GenerateContentConfig,\n  GenerateContentResponse,\n  GenerateImagesConfig,\n  GenerateImagesResponse,\n  GoogleGenAI,\n} from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\n\n/**\n * Configuration for Gemini image adapter\n */\nexport interface GeminiImageConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini Image */\nexport type GeminiImageModel = (typeof GEMINI_IMAGE_MODELS)[number]\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  GeminiImageProviderOptions,\n  GeminiImageModelProviderOptionsByName,\n  GeminiImageModelSizeByName\n> {\n  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: GeminiImageProviderOptions\n    modelProviderOptionsByName: GeminiImageModelProviderOptionsByName\n    modelSizeByName: GeminiImageModelSizeByName\n  }\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiImageConfig, model: TModel) {\n    super({}, model)\n    this.client = createGeminiClient(config)\n  }\n\n  async generateImages(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, 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      validatePrompt({ prompt, model })\n\n      if (this.isGeminiImageModel(model)) {\n        return await this.generateWithGeminiApi(options)\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,\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 isGeminiImageModel(model: string): boolean {\n    return model.startsWith('gemini-')\n  }\n\n  private async generateWithGeminiApi(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): Promise<ImageGenerationResult> {\n    const { model, prompt, size, numberOfImages, modelOptions } = options\n\n    const parsedSize = size ? parseNativeImageSize(size) : undefined\n\n    // The generateContent API has no numberOfImages parameter.\n    // Instead, augment the prompt to request multiple images when needed.\n    const augmentedPrompt =\n      numberOfImages && numberOfImages > 1\n        ? `${prompt} Generate ${numberOfImages} distinct images.`\n        : prompt\n\n    const config: GenerateContentConfig = {\n      // Include TEXT so the model can interleave descriptions between images\n      responseModalities: ['TEXT', 'IMAGE'],\n      ...(parsedSize && {\n        imageConfig: {\n          ...(parsedSize.aspectRatio && {\n            aspectRatio: parsedSize.aspectRatio,\n          }),\n          ...(parsedSize.resolution && {\n            imageSize: parsedSize.resolution,\n          }),\n        },\n      }),\n      ...modelOptions,\n    }\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents: augmentedPrompt,\n      config,\n    })\n\n    return this.transformGeminiResponse(model, response)\n  }\n\n  private transformGeminiResponse(\n    model: string,\n    response: GenerateContentResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\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      }\n    }\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      usage: undefined,\n    }\n  }\n\n  private buildImagenConfig(\n    options: ImageGenerationOptions<GeminiImageProviderOptions>,\n  ): GenerateImagesConfig {\n    const { size, numberOfImages, modelOptions } = options\n\n    return {\n      numberOfImages: numberOfImages ?? 1,\n      // Map size to aspect ratio if provided (modelOptions.aspectRatio will override)\n      aspectRatio: size ? sizeToAspectRatio(size) : undefined,\n      ...modelOptions,\n    }\n  }\n\n  private transformImagenResponse(\n    model: string,\n    response: GenerateImagesResponse,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = (response.generatedImages ?? []).map(\n      (item) => ({\n        b64Json: item.image?.imageBytes,\n        revisedPrompt: item.enhancedPrompt,\n      }),\n    )\n\n    return {\n      id: generateId(this.name),\n      model,\n      images,\n      usage: undefined,\n    }\n  }\n}\n\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-3.0-generate-002')\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-3.0-generate-002', \"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> {\n  return new GeminiImageAdapter({ apiKey, ...config }, model)\n}\n\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> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiImage(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/adapters/summarize.js

@@ -16,41 +16,55 @@ class GeminiSummarizeAdapter {
     this.model = model;
   }
   async summarize(options) {
+    const { logger } = options;
     const model = options.model;
+    logger.request(`activity=summarize provider=gemini`, {
+      provider: "gemini",
+      model
+    });
     const formatInstructions = this.getFormatInstructions(options.style);
     const lengthInstructions = options.maxLength ? ` Keep the summary under ${options.maxLength} tokens.` : "";
     const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`;
-    const response = await this.client.models.generateContent({
-      model,
-      contents: [
-        {
-          role: "user",
-          parts: [
-            { text: `Please summarize the following:
+    try {
+      const response = await this.client.models.generateContent({
+        model,
+        contents: [
+          {
+            role: "user",
+            parts: [
+              { text: `Please summarize the following:
 
 ${options.text}` }
-          ]
+            ]
+          }
+        ],
+        config: {
+          systemInstruction: systemPrompt
         }
-      ],
-      config: {
-        systemInstruction: systemPrompt
-      }
-    });
-    const summary = response.text ?? "";
-    const inputTokens = response.usageMetadata?.promptTokenCount ?? 0;
-    const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0;
-    return {
-      id: generateId("sum"),
-      model,
-      summary,
-      usage: {
-        promptTokens: inputTokens,
-        completionTokens: outputTokens,
-        totalTokens: inputTokens + outputTokens
-      }
-    };
+      });
+      const summary = response.text ?? "";
+      const inputTokens = response.usageMetadata?.promptTokenCount ?? 0;
+      const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0;
+      return {
+        id: generateId("sum"),
+        model,
+        summary,
+        usage: {
+          promptTokens: inputTokens,
+          completionTokens: outputTokens,
+          totalTokens: inputTokens + outputTokens
+        }
+      };
+    } catch (error) {
+      logger.errors("gemini.summarize fatal", {
+        error,
+        source: "gemini.summarize"
+      });
+      throw error;
+    }
   }
   async *summarizeStream(options) {
+    const { logger } = options;
     const model = options.model;
     const id = generateId("sum");
     let accumulatedContent = "";
@@ -59,57 +73,71 @@ ${options.text}` }
     const formatInstructions = this.getFormatInstructions(options.style);
     const lengthInstructions = options.maxLength ? ` Keep the summary under ${options.maxLength} words.` : "";
     const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`;
-    const result = await this.client.models.generateContentStream({
+    logger.request(`activity=summarize provider=gemini`, {
+      provider: "gemini",
       model,
-      contents: [
-        {
-          role: "user",
-          parts: [
-            { text: `Please summarize the following:
+      stream: true
+    });
+    try {
+      const result = await this.client.models.generateContentStream({
+        model,
+        contents: [
+          {
+            role: "user",
+            parts: [
+              { text: `Please summarize the following:
 
 ${options.text}` }
-          ]
-        }
-      ],
-      config: {
-        systemInstruction: systemPrompt
-      }
-    });
-    for await (const chunk of result) {
-      if (chunk.usageMetadata) {
-        inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens;
-        outputTokens = chunk.usageMetadata.candidatesTokenCount ?? outputTokens;
-      }
-      if (chunk.candidates?.[0]?.content?.parts) {
-        for (const part of chunk.candidates[0].content.parts) {
-          if (part.text) {
-            accumulatedContent += part.text;
-            yield asChunk({
-              type: "TEXT_MESSAGE_CONTENT",
-              messageId: id,
-              model,
-              timestamp: Date.now(),
-              delta: part.text,
-              content: accumulatedContent
-            });
+            ]
           }
+        ],
+        config: {
+          systemInstruction: systemPrompt
         }
-      }
-      const finishReason = chunk.candidates?.[0]?.finishReason;
-      if (finishReason === FinishReason.STOP || finishReason === FinishReason.MAX_TOKENS || finishReason === FinishReason.SAFETY) {
-        yield asChunk({
-          type: "RUN_FINISHED",
-          runId: id,
-          model,
-          timestamp: Date.now(),
-          finishReason: finishReason === FinishReason.STOP ? "stop" : finishReason === FinishReason.MAX_TOKENS ? "length" : "content_filter",
-          usage: {
-            promptTokens: inputTokens,
-            completionTokens: outputTokens,
-            totalTokens: inputTokens + outputTokens
+      });
+      for await (const chunk of result) {
+        logger.provider(`provider=gemini`, { chunk });
+        if (chunk.usageMetadata) {
+          inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens;
+          outputTokens = chunk.usageMetadata.candidatesTokenCount ?? outputTokens;
+        }
+        if (chunk.candidates?.[0]?.content?.parts) {
+          for (const part of chunk.candidates[0].content.parts) {
+            if (part.text) {
+              accumulatedContent += part.text;
+              yield asChunk({
+                type: "TEXT_MESSAGE_CONTENT",
+                messageId: id,
+                model,
+                timestamp: Date.now(),
+                delta: part.text,
+                content: accumulatedContent
+              });
+            }
           }
-        });
+        }
+        const finishReason = chunk.candidates?.[0]?.finishReason;
+        if (finishReason === FinishReason.STOP || finishReason === FinishReason.MAX_TOKENS || finishReason === FinishReason.SAFETY) {
+          yield asChunk({
+            type: "RUN_FINISHED",
+            runId: id,
+            model,
+            timestamp: Date.now(),
+            finishReason: finishReason === FinishReason.STOP ? "stop" : finishReason === FinishReason.MAX_TOKENS ? "length" : "content_filter",
+            usage: {
+              promptTokens: inputTokens,
+              completionTokens: outputTokens,
+              totalTokens: inputTokens + outputTokens
+            }
+          });
+        }
       }
+    } catch (error) {
+      logger.errors("gemini.summarize fatal", {
+        error,
+        source: "gemini.summarize"
+      });
+      throw error;
     }
   }
   getFormatInstructions(style) {

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

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { FinishReason } from '@google/genai'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type { GoogleGenAI } from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\nimport type { SummarizeAdapter } from '@tanstack/ai/adapters'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from '@tanstack/ai'\n\n/** Cast an event object to StreamChunk. */\nconst asChunk = (chunk: Record<string, unknown>) =>\n  chunk as unknown as StreamChunk\n\n/**\n * Configuration for Gemini summarize adapter\n */\nexport interface GeminiSummarizeConfig extends GeminiClientConfig {}\n/**\n * Available Gemini models for summarization\n */\nexport const GeminiSummarizeModels = [\n  'gemini-3.1-flash-lite-preview',\n  'gemini-2.0-flash',\n  'gemini-1.5-flash',\n  'gemini-1.5-pro',\n  'gemini-2.0-flash-lite',\n] as const\n\nexport type GeminiSummarizeModel = (typeof GeminiSummarizeModels)[number]\n\n/**\n * Provider-specific options for Gemini summarization\n */\nexport interface GeminiSummarizeProviderOptions {\n  /** Generation configuration */\n  generationConfig?: {\n    temperature?: number\n    topP?: number\n    topK?: number\n    maxOutputTokens?: number\n    stopSequences?: Array<string>\n  }\n  /** Safety settings */\n  safetySettings?: Array<{\n    category: string\n    threshold: string\n  }>\n}\n\nexport interface GeminiSummarizeAdapterOptions {\n  // Additional adapter options can be added here\n}\n\n/**\n * Gemini Summarize Adapter\n * A tree-shakeable summarization adapter for Google Gemini\n */\nexport class GeminiSummarizeAdapter<\n  TModel extends GeminiSummarizeModel,\n> implements SummarizeAdapter<TModel, GeminiSummarizeProviderOptions> {\n  readonly kind = 'summarize' as const\n  readonly name = 'gemini' as const\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: GeminiSummarizeProviderOptions\n  }\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiSummarizeConfig, model: TModel) {\n    this.client = createGeminiClient(config)\n    this.model = model\n  }\n\n  async summarize(options: SummarizationOptions): Promise<SummarizationResult> {\n    const model = options.model\n\n    // Build the system prompt based on format\n    const formatInstructions = this.getFormatInstructions(options.style)\n    const lengthInstructions = options.maxLength\n      ? ` Keep the summary under ${options.maxLength} tokens.`\n      : ''\n\n    const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents: [\n        {\n          role: 'user',\n          parts: [\n            { text: `Please summarize the following:\\n\\n${options.text}` },\n          ],\n        },\n      ],\n      config: {\n        systemInstruction: systemPrompt,\n      },\n    })\n\n    const summary = response.text ?? ''\n    const inputTokens = response.usageMetadata?.promptTokenCount ?? 0\n    const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0\n\n    return {\n      id: generateId('sum'),\n      model,\n      summary,\n      usage: {\n        promptTokens: inputTokens,\n        completionTokens: outputTokens,\n        totalTokens: inputTokens + outputTokens,\n      },\n    }\n  }\n\n  async *summarizeStream(\n    options: SummarizationOptions,\n  ): AsyncIterable<StreamChunk> {\n    const model = options.model\n    const id = generateId('sum')\n    let accumulatedContent = ''\n    let inputTokens = 0\n    let outputTokens = 0\n\n    // Build the system prompt based on format\n    const formatInstructions = this.getFormatInstructions(options.style)\n    const lengthInstructions = options.maxLength\n      ? ` Keep the summary under ${options.maxLength} words.`\n      : ''\n\n    const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`\n\n    const result = await this.client.models.generateContentStream({\n      model,\n      contents: [\n        {\n          role: 'user',\n          parts: [\n            { text: `Please summarize the following:\\n\\n${options.text}` },\n          ],\n        },\n      ],\n      config: {\n        systemInstruction: systemPrompt,\n      },\n    })\n\n    for await (const chunk of result) {\n      // Track usage metadata\n      if (chunk.usageMetadata) {\n        inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens\n        outputTokens = chunk.usageMetadata.candidatesTokenCount ?? outputTokens\n      }\n\n      if (chunk.candidates?.[0]?.content?.parts) {\n        for (const part of chunk.candidates[0].content.parts) {\n          if (part.text) {\n            accumulatedContent += part.text\n            yield asChunk({\n              type: 'TEXT_MESSAGE_CONTENT',\n              messageId: id,\n              model,\n              timestamp: Date.now(),\n              delta: part.text,\n              content: accumulatedContent,\n            })\n          }\n        }\n      }\n\n      // Check for finish reason\n      const finishReason = chunk.candidates?.[0]?.finishReason\n      if (\n        finishReason === FinishReason.STOP ||\n        finishReason === FinishReason.MAX_TOKENS ||\n        finishReason === FinishReason.SAFETY\n      ) {\n        yield asChunk({\n          type: 'RUN_FINISHED',\n          runId: id,\n          model,\n          timestamp: Date.now(),\n          finishReason:\n            finishReason === FinishReason.STOP\n              ? 'stop'\n              : finishReason === FinishReason.MAX_TOKENS\n                ? 'length'\n                : 'content_filter',\n          usage: {\n            promptTokens: inputTokens,\n            completionTokens: outputTokens,\n            totalTokens: inputTokens + outputTokens,\n          },\n        })\n      }\n    }\n  }\n\n  private getFormatInstructions(\n    style?: 'paragraph' | 'bullet-points' | 'concise',\n  ): string {\n    switch (style) {\n      case 'bullet-points':\n        return 'Provide the summary as bullet points.'\n      case 'concise':\n        return 'Provide a very brief one or two sentence summary.'\n      case 'paragraph':\n      default:\n        return 'Provide the summary in paragraph form.'\n    }\n  }\n}\n\n/**\n * Creates a Gemini summarize adapter with explicit API key and model\n */\nexport function createGeminiSummarize<TModel extends GeminiSummarizeModel>(\n  apiKey: string,\n  model: TModel,\n  config?: Omit<GeminiSummarizeConfig, 'apiKey'>,\n): GeminiSummarizeAdapter<TModel> {\n  return new GeminiSummarizeAdapter({ ...config, apiKey }, model)\n}\n\n/**\n * Creates a Gemini summarize adapter with API key from environment and required model\n */\nexport function geminiSummarize<TModel extends GeminiSummarizeModel>(\n  model: TModel,\n  config?: Omit<GeminiSummarizeConfig, 'apiKey'>,\n): GeminiSummarizeAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return new GeminiSummarizeAdapter({ ...config, apiKey }, model)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { FinishReason } from '@google/genai'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type { GoogleGenAI } from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\nimport type { SummarizeAdapter } from '@tanstack/ai/adapters'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from '@tanstack/ai'\n\n/** Cast an event object to StreamChunk. */\nconst asChunk = (chunk: Record<string, unknown>) =>\n  chunk as unknown as StreamChunk\n\n/**\n * Configuration for Gemini summarize adapter\n */\nexport interface GeminiSummarizeConfig extends GeminiClientConfig {}\n/**\n * Available Gemini models for summarization\n */\nexport const GeminiSummarizeModels = [\n  'gemini-3.1-flash-lite-preview',\n  'gemini-2.0-flash',\n  'gemini-1.5-flash',\n  'gemini-1.5-pro',\n  'gemini-2.0-flash-lite',\n] as const\n\nexport type GeminiSummarizeModel = (typeof GeminiSummarizeModels)[number]\n\n/**\n * Provider-specific options for Gemini summarization\n */\nexport interface GeminiSummarizeProviderOptions {\n  /** Generation configuration */\n  generationConfig?: {\n    temperature?: number\n    topP?: number\n    topK?: number\n    maxOutputTokens?: number\n    stopSequences?: Array<string>\n  }\n  /** Safety settings */\n  safetySettings?: Array<{\n    category: string\n    threshold: string\n  }>\n}\n\nexport interface GeminiSummarizeAdapterOptions {\n  // Additional adapter options can be added here\n}\n\n/**\n * Gemini Summarize Adapter\n * A tree-shakeable summarization adapter for Google Gemini\n */\nexport class GeminiSummarizeAdapter<\n  TModel extends GeminiSummarizeModel,\n> implements SummarizeAdapter<TModel, GeminiSummarizeProviderOptions> {\n  readonly kind = 'summarize' as const\n  readonly name = 'gemini' as const\n  readonly model: TModel\n\n  // Type-only property - never assigned at runtime\n  declare '~types': {\n    providerOptions: GeminiSummarizeProviderOptions\n  }\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiSummarizeConfig, model: TModel) {\n    this.client = createGeminiClient(config)\n    this.model = model\n  }\n\n  async summarize(options: SummarizationOptions): Promise<SummarizationResult> {\n    const { logger } = options\n    const model = options.model\n\n    logger.request(`activity=summarize provider=gemini`, {\n      provider: 'gemini',\n      model,\n    })\n\n    // Build the system prompt based on format\n    const formatInstructions = this.getFormatInstructions(options.style)\n    const lengthInstructions = options.maxLength\n      ? ` Keep the summary under ${options.maxLength} tokens.`\n      : ''\n\n    const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`\n\n    try {\n      const response = await this.client.models.generateContent({\n        model,\n        contents: [\n          {\n            role: 'user',\n            parts: [\n              { text: `Please summarize the following:\\n\\n${options.text}` },\n            ],\n          },\n        ],\n        config: {\n          systemInstruction: systemPrompt,\n        },\n      })\n\n      const summary = response.text ?? ''\n      const inputTokens = response.usageMetadata?.promptTokenCount ?? 0\n      const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0\n\n      return {\n        id: generateId('sum'),\n        model,\n        summary,\n        usage: {\n          promptTokens: inputTokens,\n          completionTokens: outputTokens,\n          totalTokens: inputTokens + outputTokens,\n        },\n      }\n    } catch (error) {\n      logger.errors('gemini.summarize fatal', {\n        error,\n        source: 'gemini.summarize',\n      })\n      throw error\n    }\n  }\n\n  async *summarizeStream(\n    options: SummarizationOptions,\n  ): AsyncIterable<StreamChunk> {\n    const { logger } = options\n    const model = options.model\n    const id = generateId('sum')\n    let accumulatedContent = ''\n    let inputTokens = 0\n    let outputTokens = 0\n\n    // Build the system prompt based on format\n    const formatInstructions = this.getFormatInstructions(options.style)\n    const lengthInstructions = options.maxLength\n      ? ` Keep the summary under ${options.maxLength} words.`\n      : ''\n\n    const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`\n\n    logger.request(`activity=summarize provider=gemini`, {\n      provider: 'gemini',\n      model,\n      stream: true,\n    })\n\n    try {\n      const result = await this.client.models.generateContentStream({\n        model,\n        contents: [\n          {\n            role: 'user',\n            parts: [\n              { text: `Please summarize the following:\\n\\n${options.text}` },\n            ],\n          },\n        ],\n        config: {\n          systemInstruction: systemPrompt,\n        },\n      })\n\n      for await (const chunk of result) {\n        logger.provider(`provider=gemini`, { chunk })\n        // Track usage metadata\n        if (chunk.usageMetadata) {\n          inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens\n          outputTokens =\n            chunk.usageMetadata.candidatesTokenCount ?? outputTokens\n        }\n\n        if (chunk.candidates?.[0]?.content?.parts) {\n          for (const part of chunk.candidates[0].content.parts) {\n            if (part.text) {\n              accumulatedContent += part.text\n              yield asChunk({\n                type: 'TEXT_MESSAGE_CONTENT',\n                messageId: id,\n                model,\n                timestamp: Date.now(),\n                delta: part.text,\n                content: accumulatedContent,\n              })\n            }\n          }\n        }\n\n        // Check for finish reason\n        const finishReason = chunk.candidates?.[0]?.finishReason\n        if (\n          finishReason === FinishReason.STOP ||\n          finishReason === FinishReason.MAX_TOKENS ||\n          finishReason === FinishReason.SAFETY\n        ) {\n          yield asChunk({\n            type: 'RUN_FINISHED',\n            runId: id,\n            model,\n            timestamp: Date.now(),\n            finishReason:\n              finishReason === FinishReason.STOP\n                ? 'stop'\n                : finishReason === FinishReason.MAX_TOKENS\n                  ? 'length'\n                  : 'content_filter',\n            usage: {\n              promptTokens: inputTokens,\n              completionTokens: outputTokens,\n              totalTokens: inputTokens + outputTokens,\n            },\n          })\n        }\n      }\n    } catch (error) {\n      logger.errors('gemini.summarize fatal', {\n        error,\n        source: 'gemini.summarize',\n      })\n      throw error\n    }\n  }\n\n  private getFormatInstructions(\n    style?: 'paragraph' | 'bullet-points' | 'concise',\n  ): string {\n    switch (style) {\n      case 'bullet-points':\n        return 'Provide the summary as bullet points.'\n      case 'concise':\n        return 'Provide a very brief one or two sentence summary.'\n      case 'paragraph':\n      default:\n        return 'Provide the summary in paragraph form.'\n    }\n  }\n}\n\n/**\n * Creates a Gemini summarize adapter with explicit API key and model\n */\nexport function createGeminiSummarize<TModel extends GeminiSummarizeModel>(\n  apiKey: string,\n  model: TModel,\n  config?: Omit<GeminiSummarizeConfig, 'apiKey'>,\n): GeminiSummarizeAdapter<TModel> {\n  return new GeminiSummarizeAdapter({ ...config, apiKey }, model)\n}\n\n/**\n * Creates a Gemini summarize adapter with API key from environment and required model\n */\nexport function geminiSummarize<TModel extends GeminiSummarizeModel>(\n  model: TModel,\n  config?: Omit<GeminiSummarizeConfig, 'apiKey'>,\n): GeminiSummarizeAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return new GeminiSummarizeAdapter({ ...config, apiKey }, model)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/adapters/text.js

@@ -12,11 +12,20 @@ class GeminiTextAdapter extends BaseTextAdapter {
   }
   async *chatStream(options) {
     const mappedOptions = this.mapCommonOptionsToGemini(options);
+    const { logger } = options;
     try {
+      logger.request(
+        `activity=chat provider=gemini model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,
+        { provider: "gemini", model: this.model }
+      );
       const result = await this.client.models.generateContentStream(mappedOptions);
-      yield* this.processStreamChunks(result, options);
+      yield* this.processStreamChunks(result, options, logger);
     } catch (error) {
       const timestamp = Date.now();
+      logger.errors("gemini.chatStream fatal", {
+        error,
+        source: "gemini.chatStream"
+      });
       yield asChunk({
         type: "RUN_ERROR",
         model: options.model,
@@ -35,8 +44,13 @@ class GeminiTextAdapter extends BaseTextAdapter {
    */
   async structuredOutput(options) {
     const { chatOptions, outputSchema } = options;
+    const { logger } = chatOptions;
     const mappedOptions = this.mapCommonOptionsToGemini(chatOptions);
     try {
+      logger.request(
+        `activity=chat provider=gemini model=${this.model} messages=${chatOptions.messages.length} tools=${chatOptions.tools?.length ?? 0} stream=false`,
+        { provider: "gemini", model: this.model }
+      );
       const result = await this.client.models.generateContent({
         ...mappedOptions,
         config: {
@@ -59,6 +73,10 @@ class GeminiTextAdapter extends BaseTextAdapter {
         rawText
       };
     } catch (error) {
+      logger.errors("gemini.structuredOutput fatal", {
+        error,
+        source: "gemini.structuredOutput"
+      });
       throw new Error(
         error instanceof Error ? error.message : "An unknown error occurred during structured output generation."
       );
@@ -78,7 +96,7 @@ class GeminiTextAdapter extends BaseTextAdapter {
     }
     return textContent;
   }
-  async *processStreamChunks(result, options) {
+  async *processStreamChunks(result, options, logger) {
     const model = options.model;
     const timestamp = Date.now();
     let accumulatedContent = "";
@@ -95,6 +113,7 @@ class GeminiTextAdapter extends BaseTextAdapter {
     let hasEmittedTextMessageStart = false;
     let hasEmittedStepStarted = false;
     for await (const chunk of result) {
+      logger.provider(`provider=gemini`, { chunk });
       if (!hasEmittedRunStarted) {
         hasEmittedRunStarted = true;
         yield asChunk({

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

@@ -1 +1 @@
-{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import { FinishReason } from '@google/genai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport { convertToolsToProviderFormat } from '../tools/tool-converter'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type {\n  GEMINI_MODELS,\n  GeminiChatModelProviderOptionsByName,\n  GeminiChatModelToolCapabilitiesByName,\n  GeminiModelInputModalitiesByName,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type {\n  Content,\n  GenerateContentParameters,\n  GenerateContentResponse,\n  GoogleGenAI,\n  Part,\n  ThinkingLevel,\n} from '@google/genai'\nimport type {\n  ContentPart,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { ExternalTextProviderOptions } from '../text/text-provider-options'\nimport type { GeminiMessageMetadataByModality } from '../message-types'\nimport type { GeminiClientConfig } from '../utils'\n\n/** Cast an event object to StreamChunk. Adapters construct events with string\n *  literal types which are structurally compatible with the EventType enum. */\nconst asChunk = (chunk: Record<string, unknown>) =>\n  chunk as unknown as StreamChunk\n\n/**\n * Configuration for Gemini text adapter\n */\nexport interface GeminiTextConfig extends GeminiClientConfig {}\n\n/**\n * Gemini-specific provider options for text/chat\n */\nexport type GeminiTextProviderOptions = ExternalTextProviderOptions\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\ntype ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GeminiChatModelProviderOptionsByName\n    ? GeminiChatModelProviderOptionsByName[TModel]\n    : GeminiTextProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use all modalities.\n */\ntype ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GeminiModelInputModalitiesByName\n    ? GeminiModelInputModalitiesByName[TModel]\n    : readonly ['text', 'image', 'audio', 'video', 'document']\n\n/**\n * Resolve tool capabilities for a specific model.\n * If the model has explicit tools in the map, use those; otherwise use empty tuple.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GeminiChatModelToolCapabilitiesByName\n    ? NonNullable<GeminiChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n// ===========================\n// Adapter Implementation\n// ===========================\n\n/**\n * Gemini Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Gemini chat/text completion functionality.\n * Import only what you need for smaller bundle sizes.\n */\nexport class GeminiTextAdapter<\n  TModel extends (typeof GEMINI_MODELS)[number],\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GeminiMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  readonly name = 'gemini' as const\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGeminiClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<GeminiTextProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const mappedOptions = this.mapCommonOptionsToGemini(options)\n\n    try {\n      const result =\n        await this.client.models.generateContentStream(mappedOptions)\n\n      yield* this.processStreamChunks(result, options)\n    } catch (error) {\n      const timestamp = Date.now()\n      yield asChunk({\n        type: 'RUN_ERROR',\n        model: options.model,\n        timestamp,\n        message:\n          error instanceof Error\n            ? error.message\n            : 'An unknown error occurred during the chat stream.',\n        error: {\n          message:\n            error instanceof Error\n              ? error.message\n              : 'An unknown error occurred during the chat stream.',\n        },\n      })\n    }\n  }\n\n  /**\n   * Generate structured output using Gemini's native JSON response format.\n   * Uses responseMimeType: 'application/json' and responseSchema for structured output.\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<GeminiTextProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n\n    const mappedOptions = this.mapCommonOptionsToGemini(chatOptions)\n\n    try {\n      // Add structured output configuration\n      const result = await this.client.models.generateContent({\n        ...mappedOptions,\n        config: {\n          ...mappedOptions.config,\n          responseMimeType: 'application/json',\n          responseSchema: outputSchema,\n        },\n      })\n\n      // Extract text content from the response\n      const rawText = this.extractTextFromResponse(result)\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      return {\n        data: parsed,\n        rawText,\n      }\n    } catch (error) {\n      throw new Error(\n        error instanceof Error\n          ? error.message\n          : 'An unknown error occurred during structured output generation.',\n      )\n    }\n  }\n\n  /**\n   * Extract text content from a non-streaming response\n   */\n  private extractTextFromResponse(response: GenerateContentResponse): string {\n    let textContent = ''\n\n    if (response.candidates?.[0]?.content?.parts) {\n      for (const part of response.candidates[0].content.parts) {\n        if (part.text) {\n          textContent += part.text\n        }\n      }\n    }\n\n    return textContent\n  }\n\n  private async *processStreamChunks(\n    result: AsyncGenerator<GenerateContentResponse, unknown, unknown>,\n    options: TextOptions<GeminiTextProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const model = options.model\n    const timestamp = Date.now()\n    let accumulatedContent = ''\n    let accumulatedThinking = ''\n    const toolCallMap = new Map<\n      string,\n      {\n        name: string\n        args: string\n        index: number\n        started: boolean\n        thoughtSignature?: string\n      }\n    >()\n    let nextToolIndex = 0\n\n    // AG-UI lifecycle tracking\n    const runId = options.runId ?? generateId(this.name)\n    const threadId = options.threadId ?? generateId(this.name)\n    const messageId = generateId(this.name)\n    let stepId: string | null = null\n    let reasoningMessageId: string | null = null\n    let hasClosedReasoning = false\n    let hasEmittedRunStarted = false\n    let hasEmittedTextMessageStart = false\n    let hasEmittedStepStarted = false\n\n    for await (const chunk of result) {\n      // Emit RUN_STARTED on first chunk\n      if (!hasEmittedRunStarted) {\n        hasEmittedRunStarted = true\n        yield asChunk({\n          type: 'RUN_STARTED',\n          runId,\n          threadId,\n          model,\n          timestamp,\n        })\n      }\n\n      if (chunk.candidates?.[0]?.content?.parts) {\n        const parts = chunk.candidates[0].content.parts\n\n        for (const part of parts) {\n          if (part.text) {\n            if (part.thought) {\n              // Emit STEP_STARTED and REASONING events on first thinking content\n              if (!hasEmittedStepStarted) {\n                hasEmittedStepStarted = true\n                stepId = generateId(this.name)\n                reasoningMessageId = generateId(this.name)\n\n                // Spec REASONING events\n                yield asChunk({\n                  type: 'REASONING_START',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n                yield asChunk({\n                  type: 'REASONING_MESSAGE_START',\n                  messageId: reasoningMessageId,\n                  role: 'reasoning' as const,\n                  model,\n                  timestamp,\n                })\n\n                // Legacy STEP events (kept during transition)\n                yield asChunk({\n                  type: 'STEP_STARTED',\n                  stepName: stepId,\n                  stepId,\n                  model,\n                  timestamp,\n                  stepType: 'thinking',\n                })\n              }\n\n              accumulatedThinking += part.text\n\n              // Spec REASONING content event\n              yield asChunk({\n                type: 'REASONING_MESSAGE_CONTENT',\n                messageId: reasoningMessageId!,\n                delta: part.text,\n                model,\n                timestamp,\n              })\n\n              // Legacy STEP event\n              yield asChunk({\n                type: 'STEP_FINISHED',\n                stepName: stepId || generateId(this.name),\n                stepId: stepId || generateId(this.name),\n                model,\n                timestamp,\n                delta: part.text,\n                content: accumulatedThinking,\n              })\n            } else if (part.text.trim()) {\n              // Close reasoning before text starts\n              if (reasoningMessageId && !hasClosedReasoning) {\n                hasClosedReasoning = true\n                yield asChunk({\n                  type: 'REASONING_MESSAGE_END',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n                yield asChunk({\n                  type: 'REASONING_END',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n              }\n\n              // Skip whitespace-only text parts (e.g. \"\\n\" during auto-continuation)\n              // Emit TEXT_MESSAGE_START on first text content\n              if (!hasEmittedTextMessageStart) {\n                hasEmittedTextMessageStart = true\n                yield asChunk({\n                  type: 'TEXT_MESSAGE_START',\n                  messageId,\n                  model,\n                  timestamp,\n                  role: 'assistant',\n                })\n              }\n\n              accumulatedContent += part.text\n              yield asChunk({\n                type: 'TEXT_MESSAGE_CONTENT',\n                messageId,\n                model,\n                timestamp,\n                delta: part.text,\n                content: accumulatedContent,\n              })\n            }\n          }\n\n          const functionCall = part.functionCall\n          if (functionCall) {\n            const toolCallId =\n              functionCall.id ||\n              `${functionCall.name}_${Date.now()}_${nextToolIndex}`\n            const functionArgs = functionCall.args || {}\n\n            let toolCallData = toolCallMap.get(toolCallId)\n            if (!toolCallData) {\n              toolCallData = {\n                name: functionCall.name || '',\n                args:\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs),\n                index: nextToolIndex++,\n                started: false,\n                thoughtSignature:\n                  (functionCall as any).thoughtSignature || undefined,\n              }\n              toolCallMap.set(toolCallId, toolCallData)\n            } else {\n              try {\n                const existingArgs = JSON.parse(toolCallData.args)\n                const newArgs =\n                  typeof functionArgs === 'string'\n                    ? JSON.parse(functionArgs)\n                    : functionArgs\n                const mergedArgs = { ...existingArgs, ...newArgs }\n                toolCallData.args = JSON.stringify(mergedArgs)\n              } catch {\n                toolCallData.args =\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs)\n              }\n            }\n\n            // Emit TOOL_CALL_START if not already started\n            if (!toolCallData.started) {\n              toolCallData.started = true\n              yield asChunk({\n                type: 'TOOL_CALL_START',\n                toolCallId,\n                toolCallName: toolCallData.name,\n                toolName: toolCallData.name,\n                model,\n                timestamp,\n                index: toolCallData.index,\n                ...(toolCallData.thoughtSignature && {\n                  providerMetadata: {\n                    thoughtSignature: toolCallData.thoughtSignature,\n                  },\n                }),\n              })\n            }\n\n            // Emit TOOL_CALL_ARGS\n            yield asChunk({\n              type: 'TOOL_CALL_ARGS',\n              toolCallId,\n              model,\n              timestamp,\n              delta: toolCallData.args,\n              args: toolCallData.args,\n            })\n          }\n        }\n      } else if (chunk.data && chunk.data.trim()) {\n        // Skip whitespace-only data (e.g. \"\\n\" during auto-continuation)\n        // Emit TEXT_MESSAGE_START on first text content\n        if (!hasEmittedTextMessageStart) {\n          hasEmittedTextMessageStart = true\n          yield asChunk({\n            type: 'TEXT_MESSAGE_START',\n            messageId,\n            model,\n            timestamp,\n            role: 'assistant',\n          })\n        }\n\n        accumulatedContent += chunk.data\n        yield asChunk({\n          type: 'TEXT_MESSAGE_CONTENT',\n          messageId,\n          model,\n          timestamp,\n          delta: chunk.data,\n          content: accumulatedContent,\n        })\n      }\n\n      if (chunk.candidates?.[0]?.finishReason) {\n        const finishReason = chunk.candidates[0].finishReason\n\n        if (finishReason === FinishReason.UNEXPECTED_TOOL_CALL) {\n          if (chunk.candidates[0].content?.parts) {\n            for (const part of chunk.candidates[0].content.parts) {\n              const functionCall = part.functionCall\n              if (functionCall) {\n                const toolCallId =\n                  functionCall.id ||\n                  `${functionCall.name}_${Date.now()}_${nextToolIndex}`\n                const functionArgs = functionCall.args || {}\n\n                const argsString =\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs)\n\n                toolCallMap.set(toolCallId, {\n                  name: functionCall.name || '',\n                  args: argsString,\n                  index: nextToolIndex++,\n                  started: true,\n                })\n\n                // Emit TOOL_CALL_START\n                yield asChunk({\n                  type: 'TOOL_CALL_START',\n                  toolCallId,\n                  toolCallName: functionCall.name || '',\n                  toolName: functionCall.name || '',\n                  model,\n                  timestamp,\n                  index: nextToolIndex - 1,\n                })\n\n                // Emit TOOL_CALL_END with parsed input\n                let parsedInput: unknown = {}\n                try {\n                  const parsed =\n                    typeof functionArgs === 'string'\n                      ? JSON.parse(functionArgs)\n                      : functionArgs\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch {\n                  parsedInput = {}\n                }\n\n                yield asChunk({\n                  type: 'TOOL_CALL_END',\n                  toolCallId,\n                  toolCallName: functionCall.name || '',\n                  toolName: functionCall.name || '',\n                  model,\n                  timestamp,\n                  input: parsedInput,\n                })\n              }\n            }\n          }\n        }\n\n        // Emit TOOL_CALL_END for all tracked tool calls\n        for (const [toolCallId, toolCallData] of toolCallMap.entries()) {\n          let parsedInput: unknown = {}\n          try {\n            const parsed = JSON.parse(toolCallData.args)\n            parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n          } catch {\n            parsedInput = {}\n          }\n\n          yield asChunk({\n            type: 'TOOL_CALL_END',\n            toolCallId,\n            toolCallName: toolCallData.name,\n            toolName: toolCallData.name,\n            model,\n            timestamp,\n            input: parsedInput,\n          })\n        }\n\n        // Reset so a new TEXT_MESSAGE_START is emitted if text follows tool calls\n        if (toolCallMap.size > 0) {\n          hasEmittedTextMessageStart = false\n        }\n\n        if (finishReason === FinishReason.MAX_TOKENS) {\n          yield asChunk({\n            type: 'RUN_ERROR',\n            runId,\n            model,\n            timestamp,\n            message:\n              'The response was cut off because the maximum token limit was reached.',\n            code: 'max_tokens',\n            error: {\n              message:\n                'The response was cut off because the maximum token limit was reached.',\n              code: 'max_tokens',\n            },\n          })\n        }\n\n        // Close reasoning events if still open\n        if (reasoningMessageId && !hasClosedReasoning) {\n          hasClosedReasoning = true\n          yield asChunk({\n            type: 'REASONING_MESSAGE_END',\n            messageId: reasoningMessageId,\n            model,\n            timestamp,\n          })\n          yield asChunk({\n            type: 'REASONING_END',\n            messageId: reasoningMessageId,\n            model,\n            timestamp,\n          })\n        }\n\n        // Emit TEXT_MESSAGE_END if we had text content\n        if (hasEmittedTextMessageStart) {\n          yield asChunk({\n            type: 'TEXT_MESSAGE_END',\n            messageId,\n            model,\n            timestamp,\n          })\n        }\n\n        yield asChunk({\n          type: 'RUN_FINISHED',\n          runId,\n          threadId,\n          model,\n          timestamp,\n          finishReason: toolCallMap.size > 0 ? 'tool_calls' : 'stop',\n          usage: chunk.usageMetadata\n            ? {\n                promptTokens: chunk.usageMetadata.promptTokenCount ?? 0,\n                completionTokens: chunk.usageMetadata.candidatesTokenCount ?? 0,\n                totalTokens: chunk.usageMetadata.totalTokenCount ?? 0,\n              }\n            : undefined,\n        })\n      }\n    }\n  }\n\n  private convertContentPartToGemini(part: ContentPart): Part {\n    switch (part.type) {\n      case 'text':\n        return { text: part.content }\n      case 'image':\n      case 'audio':\n      case 'video':\n      case 'document': {\n        if (part.source.type === 'data') {\n          return {\n            inlineData: {\n              data: part.source.value,\n              mimeType: part.source.mimeType,\n            },\n          }\n        } else {\n          // For URL sources, use provided mimeType or fall back to reasonable defaults\n          const defaultMimeType = {\n            image: 'image/jpeg',\n            audio: 'audio/mp3',\n            video: 'video/mp4',\n            document: 'application/pdf',\n          }[part.type]\n\n          return {\n            fileData: {\n              fileUri: part.source.value,\n              mimeType: part.source.mimeType ?? defaultMimeType,\n            },\n          }\n        }\n      }\n      default: {\n        const _exhaustiveCheck: never = part\n        throw new Error(\n          `Unsupported content part type: ${(_exhaustiveCheck as ContentPart).type}`,\n        )\n      }\n    }\n  }\n\n  private formatMessages(\n    messages: Array<ModelMessage>,\n  ): GenerateContentParameters['contents'] {\n    // Build a lookup from toolCallId → function name so functionResponse uses the\n    // correct name instead of the raw call ID.\n    const toolCallIdToName = new Map<string, string>()\n    for (const msg of messages) {\n      if (msg.role === 'assistant' && msg.toolCalls) {\n        for (const tc of msg.toolCalls) {\n          toolCallIdToName.set(tc.id, tc.function.name)\n        }\n      }\n    }\n\n    const formatted = messages.map((msg) => {\n      const role: 'user' | 'model' = msg.role === 'assistant' ? 'model' : 'user'\n      const parts: Array<Part> = []\n\n      if (Array.isArray(msg.content)) {\n        for (const contentPart of msg.content) {\n          parts.push(this.convertContentPartToGemini(contentPart))\n        }\n      } else if (msg.content && msg.role !== 'tool') {\n        parts.push({ text: msg.content })\n      }\n\n      if (msg.role === 'assistant' && msg.toolCalls?.length) {\n        for (const toolCall of msg.toolCalls) {\n          let parsedArgs: Record<string, unknown> = {}\n          try {\n            parsedArgs = toolCall.function.arguments\n              ? (JSON.parse(toolCall.function.arguments) as Record<\n                  string,\n                  unknown\n                >)\n              : {}\n          } catch {\n            parsedArgs = toolCall.function.arguments as unknown as Record<\n              string,\n              unknown\n            >\n          }\n\n          const thoughtSignature = toolCall.providerMetadata\n            ?.thoughtSignature as string | undefined\n          parts.push({\n            functionCall: {\n              id: toolCall.id,\n              name: toolCall.function.name,\n              args: parsedArgs,\n              ...(thoughtSignature && { thoughtSignature }),\n            } as any,\n          })\n        }\n      }\n\n      if (msg.role === 'tool' && msg.toolCallId) {\n        const functionName =\n          toolCallIdToName.get(msg.toolCallId) || msg.toolCallId\n        parts.push({\n          functionResponse: {\n            id: msg.toolCallId,\n            name: functionName,\n            response: {\n              content: msg.content || '',\n            },\n          } as any,\n        })\n      }\n\n      return {\n        role,\n        parts: parts.length > 0 ? parts : [{ text: '' }],\n      }\n    })\n\n    // Post-process: Gemini requires strictly alternating user/model roles.\n    // Tool results are mapped to role:'user', which can create consecutive\n    // user messages when followed by a new user message. Merge them.\n    return this.mergeConsecutiveSameRoleMessages(formatted)\n  }\n\n  /**\n   * Merge consecutive messages of the same role into a single message.\n   * Gemini's API requires strictly alternating user/model roles.\n   * Tool results are mapped to role:'user', which can collide with actual\n   * user messages in multi-turn conversations.\n   *\n   * Also filters out empty model messages (e.g., from a previous failed request)\n   * and deduplicates functionResponse parts with the same name (tool call ID).\n   */\n  private mergeConsecutiveSameRoleMessages(\n    messages: Array<Content>,\n  ): Array<Content> {\n    const merged: Array<Content> = []\n\n    for (const msg of messages) {\n      const parts = msg.parts || []\n\n      // Skip empty model messages (no parts or only empty text)\n      if (msg.role === 'model') {\n        const hasContent =\n          parts.length > 0 &&\n          !parts.every(\n            (p) => 'text' in p && (p as { text: string }).text === '',\n          )\n        if (!hasContent) {\n          continue\n        }\n      }\n\n      const prev = merged[merged.length - 1]\n      if (prev && prev.role === msg.role) {\n        // Merge parts arrays\n        prev.parts = [...(prev.parts || []), ...parts]\n      } else {\n        merged.push({ ...msg, parts: [...parts] })\n      }\n    }\n\n    // Deduplicate functionResponse parts with the same name (tool call ID)\n    for (const msg of merged) {\n      if (!msg.parts) continue\n      const seenFunctionResponseNames = new Set<string>()\n      msg.parts = msg.parts.filter((part) => {\n        if ('functionResponse' in part && part.functionResponse?.name) {\n          if (seenFunctionResponseNames.has(part.functionResponse.name)) {\n            return false\n          }\n          seenFunctionResponseNames.add(part.functionResponse.name)\n        }\n        return true\n      })\n    }\n\n    return merged\n  }\n\n  private mapCommonOptionsToGemini(\n    options: TextOptions<GeminiTextProviderOptions>,\n  ) {\n    const modelOpts = options.modelOptions\n    const thinkingConfig = modelOpts?.thinkingConfig\n    const requestOptions: GenerateContentParameters = {\n      model: options.model,\n      contents: this.formatMessages(options.messages),\n      config: {\n        ...modelOpts,\n        temperature: options.temperature,\n        topP: options.topP,\n        maxOutputTokens: options.maxTokens,\n        thinkingConfig: thinkingConfig\n          ? {\n              ...thinkingConfig,\n              thinkingLevel: thinkingConfig.thinkingLevel\n                ? // Enum is provided by the SDK, we use it for the type but cast it to string constants, here we just cast them back\n                  (thinkingConfig.thinkingLevel as ThinkingLevel)\n                : undefined,\n            }\n          : undefined,\n        systemInstruction: options.systemPrompts?.join('\\n'),\n        tools: convertToolsToProviderFormat(options.tools),\n      },\n    }\n\n    return requestOptions\n  }\n}\n\n/**\n * Creates a Gemini text adapter with explicit API key.\n * Type resolution happens here at the call site.\n */\nexport function createGeminiChat<TModel extends (typeof GEMINI_MODELS)[number]>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiTextConfig, 'apiKey'>,\n): GeminiTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  ResolveToolCapabilities<TModel>\n> {\n  return new GeminiTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Gemini text adapter with automatic API key detection.\n * Type resolution happens here at the call site.\n */\nexport function geminiText<TModel extends (typeof GEMINI_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GeminiTextConfig, 'apiKey'>,\n): GeminiTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  ResolveToolCapabilities<TModel>\n> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiChat(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"text.js","sources":["../../../src/adapters/text.ts"],"sourcesContent":["import { FinishReason } from '@google/genai'\nimport { BaseTextAdapter } from '@tanstack/ai/adapters'\nimport { convertToolsToProviderFormat } from '../tools/tool-converter'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type {\n  GEMINI_MODELS,\n  GeminiChatModelProviderOptionsByName,\n  GeminiChatModelToolCapabilitiesByName,\n  GeminiModelInputModalitiesByName,\n} from '../model-meta'\nimport type {\n  StructuredOutputOptions,\n  StructuredOutputResult,\n} from '@tanstack/ai/adapters'\nimport type { InternalLogger } from '@tanstack/ai/adapter-internals'\nimport type {\n  Content,\n  GenerateContentParameters,\n  GenerateContentResponse,\n  GoogleGenAI,\n  Part,\n  ThinkingLevel,\n} from '@google/genai'\nimport type {\n  ContentPart,\n  Modality,\n  ModelMessage,\n  StreamChunk,\n  TextOptions,\n} from '@tanstack/ai'\nimport type { ExternalTextProviderOptions } from '../text/text-provider-options'\nimport type { GeminiMessageMetadataByModality } from '../message-types'\nimport type { GeminiClientConfig } from '../utils'\n\n/** Cast an event object to StreamChunk. Adapters construct events with string\n *  literal types which are structurally compatible with the EventType enum. */\nconst asChunk = (chunk: Record<string, unknown>) =>\n  chunk as unknown as StreamChunk\n\n/**\n * Configuration for Gemini text adapter\n */\nexport interface GeminiTextConfig extends GeminiClientConfig {}\n\n/**\n * Gemini-specific provider options for text/chat\n */\nexport type GeminiTextProviderOptions = ExternalTextProviderOptions\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\ntype ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GeminiChatModelProviderOptionsByName\n    ? GeminiChatModelProviderOptionsByName[TModel]\n    : GeminiTextProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use all modalities.\n */\ntype ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GeminiModelInputModalitiesByName\n    ? GeminiModelInputModalitiesByName[TModel]\n    : readonly ['text', 'image', 'audio', 'video', 'document']\n\n/**\n * Resolve tool capabilities for a specific model.\n * If the model has explicit tools in the map, use those; otherwise use empty tuple.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GeminiChatModelToolCapabilitiesByName\n    ? NonNullable<GeminiChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n// ===========================\n// Adapter Implementation\n// ===========================\n\n/**\n * Gemini Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Gemini chat/text completion functionality.\n * Import only what you need for smaller bundle sizes.\n */\nexport class GeminiTextAdapter<\n  TModel extends (typeof GEMINI_MODELS)[number],\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends BaseTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GeminiMessageMetadataByModality,\n  TToolCapabilities\n> {\n  readonly kind = 'text' as const\n  readonly name = 'gemini' as const\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiTextConfig, model: TModel) {\n    super({}, model)\n    this.client = createGeminiClient(config)\n  }\n\n  async *chatStream(\n    options: TextOptions<GeminiTextProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const mappedOptions = this.mapCommonOptionsToGemini(options)\n    const { logger } = options\n\n    try {\n      logger.request(\n        `activity=chat provider=gemini model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,\n        { provider: 'gemini', model: this.model },\n      )\n      const result =\n        await this.client.models.generateContentStream(mappedOptions)\n\n      yield* this.processStreamChunks(result, options, logger)\n    } catch (error) {\n      const timestamp = Date.now()\n      logger.errors('gemini.chatStream fatal', {\n        error,\n        source: 'gemini.chatStream',\n      })\n      yield asChunk({\n        type: 'RUN_ERROR',\n        model: options.model,\n        timestamp,\n        message:\n          error instanceof Error\n            ? error.message\n            : 'An unknown error occurred during the chat stream.',\n        error: {\n          message:\n            error instanceof Error\n              ? error.message\n              : 'An unknown error occurred during the chat stream.',\n        },\n      })\n    }\n  }\n\n  /**\n   * Generate structured output using Gemini's native JSON response format.\n   * Uses responseMimeType: 'application/json' and responseSchema for structured output.\n   * The outputSchema is already JSON Schema (converted in the ai layer).\n   */\n  async structuredOutput(\n    options: StructuredOutputOptions<GeminiTextProviderOptions>,\n  ): Promise<StructuredOutputResult<unknown>> {\n    const { chatOptions, outputSchema } = options\n    const { logger } = chatOptions\n\n    const mappedOptions = this.mapCommonOptionsToGemini(chatOptions)\n\n    try {\n      logger.request(\n        `activity=chat provider=gemini model=${this.model} messages=${chatOptions.messages.length} tools=${chatOptions.tools?.length ?? 0} stream=false`,\n        { provider: 'gemini', model: this.model },\n      )\n      // Add structured output configuration\n      const result = await this.client.models.generateContent({\n        ...mappedOptions,\n        config: {\n          ...mappedOptions.config,\n          responseMimeType: 'application/json',\n          responseSchema: outputSchema,\n        },\n      })\n\n      // Extract text content from the response\n      const rawText = this.extractTextFromResponse(result)\n\n      // Parse the JSON response\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(rawText)\n      } catch {\n        throw new Error(\n          `Failed to parse structured output as JSON. Content: ${rawText.slice(0, 200)}${rawText.length > 200 ? '...' : ''}`,\n        )\n      }\n\n      return {\n        data: parsed,\n        rawText,\n      }\n    } catch (error) {\n      logger.errors('gemini.structuredOutput fatal', {\n        error,\n        source: 'gemini.structuredOutput',\n      })\n      throw new Error(\n        error instanceof Error\n          ? error.message\n          : 'An unknown error occurred during structured output generation.',\n      )\n    }\n  }\n\n  /**\n   * Extract text content from a non-streaming response\n   */\n  private extractTextFromResponse(response: GenerateContentResponse): string {\n    let textContent = ''\n\n    if (response.candidates?.[0]?.content?.parts) {\n      for (const part of response.candidates[0].content.parts) {\n        if (part.text) {\n          textContent += part.text\n        }\n      }\n    }\n\n    return textContent\n  }\n\n  private async *processStreamChunks(\n    result: AsyncGenerator<GenerateContentResponse, unknown, unknown>,\n    options: TextOptions<GeminiTextProviderOptions>,\n    logger: InternalLogger,\n  ): AsyncIterable<StreamChunk> {\n    const model = options.model\n    const timestamp = Date.now()\n    let accumulatedContent = ''\n    let accumulatedThinking = ''\n    const toolCallMap = new Map<\n      string,\n      {\n        name: string\n        args: string\n        index: number\n        started: boolean\n        thoughtSignature?: string\n      }\n    >()\n    let nextToolIndex = 0\n\n    // AG-UI lifecycle tracking\n    const runId = options.runId ?? generateId(this.name)\n    const threadId = options.threadId ?? generateId(this.name)\n    const messageId = generateId(this.name)\n    let stepId: string | null = null\n    let reasoningMessageId: string | null = null\n    let hasClosedReasoning = false\n    let hasEmittedRunStarted = false\n    let hasEmittedTextMessageStart = false\n    let hasEmittedStepStarted = false\n\n    for await (const chunk of result) {\n      logger.provider(`provider=gemini`, { chunk })\n      // Emit RUN_STARTED on first chunk\n      if (!hasEmittedRunStarted) {\n        hasEmittedRunStarted = true\n        yield asChunk({\n          type: 'RUN_STARTED',\n          runId,\n          threadId,\n          model,\n          timestamp,\n        })\n      }\n\n      if (chunk.candidates?.[0]?.content?.parts) {\n        const parts = chunk.candidates[0].content.parts\n\n        for (const part of parts) {\n          if (part.text) {\n            if (part.thought) {\n              // Emit STEP_STARTED and REASONING events on first thinking content\n              if (!hasEmittedStepStarted) {\n                hasEmittedStepStarted = true\n                stepId = generateId(this.name)\n                reasoningMessageId = generateId(this.name)\n\n                // Spec REASONING events\n                yield asChunk({\n                  type: 'REASONING_START',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n                yield asChunk({\n                  type: 'REASONING_MESSAGE_START',\n                  messageId: reasoningMessageId,\n                  role: 'reasoning' as const,\n                  model,\n                  timestamp,\n                })\n\n                // Legacy STEP events (kept during transition)\n                yield asChunk({\n                  type: 'STEP_STARTED',\n                  stepName: stepId,\n                  stepId,\n                  model,\n                  timestamp,\n                  stepType: 'thinking',\n                })\n              }\n\n              accumulatedThinking += part.text\n\n              // Spec REASONING content event\n              yield asChunk({\n                type: 'REASONING_MESSAGE_CONTENT',\n                messageId: reasoningMessageId!,\n                delta: part.text,\n                model,\n                timestamp,\n              })\n\n              // Legacy STEP event\n              yield asChunk({\n                type: 'STEP_FINISHED',\n                stepName: stepId || generateId(this.name),\n                stepId: stepId || generateId(this.name),\n                model,\n                timestamp,\n                delta: part.text,\n                content: accumulatedThinking,\n              })\n            } else if (part.text.trim()) {\n              // Close reasoning before text starts\n              if (reasoningMessageId && !hasClosedReasoning) {\n                hasClosedReasoning = true\n                yield asChunk({\n                  type: 'REASONING_MESSAGE_END',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n                yield asChunk({\n                  type: 'REASONING_END',\n                  messageId: reasoningMessageId,\n                  model,\n                  timestamp,\n                })\n              }\n\n              // Skip whitespace-only text parts (e.g. \"\\n\" during auto-continuation)\n              // Emit TEXT_MESSAGE_START on first text content\n              if (!hasEmittedTextMessageStart) {\n                hasEmittedTextMessageStart = true\n                yield asChunk({\n                  type: 'TEXT_MESSAGE_START',\n                  messageId,\n                  model,\n                  timestamp,\n                  role: 'assistant',\n                })\n              }\n\n              accumulatedContent += part.text\n              yield asChunk({\n                type: 'TEXT_MESSAGE_CONTENT',\n                messageId,\n                model,\n                timestamp,\n                delta: part.text,\n                content: accumulatedContent,\n              })\n            }\n          }\n\n          const functionCall = part.functionCall\n          if (functionCall) {\n            const toolCallId =\n              functionCall.id ||\n              `${functionCall.name}_${Date.now()}_${nextToolIndex}`\n            const functionArgs = functionCall.args || {}\n\n            let toolCallData = toolCallMap.get(toolCallId)\n            if (!toolCallData) {\n              toolCallData = {\n                name: functionCall.name || '',\n                args:\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs),\n                index: nextToolIndex++,\n                started: false,\n                thoughtSignature:\n                  (functionCall as any).thoughtSignature || undefined,\n              }\n              toolCallMap.set(toolCallId, toolCallData)\n            } else {\n              try {\n                const existingArgs = JSON.parse(toolCallData.args)\n                const newArgs =\n                  typeof functionArgs === 'string'\n                    ? JSON.parse(functionArgs)\n                    : functionArgs\n                const mergedArgs = { ...existingArgs, ...newArgs }\n                toolCallData.args = JSON.stringify(mergedArgs)\n              } catch {\n                toolCallData.args =\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs)\n              }\n            }\n\n            // Emit TOOL_CALL_START if not already started\n            if (!toolCallData.started) {\n              toolCallData.started = true\n              yield asChunk({\n                type: 'TOOL_CALL_START',\n                toolCallId,\n                toolCallName: toolCallData.name,\n                toolName: toolCallData.name,\n                model,\n                timestamp,\n                index: toolCallData.index,\n                ...(toolCallData.thoughtSignature && {\n                  providerMetadata: {\n                    thoughtSignature: toolCallData.thoughtSignature,\n                  },\n                }),\n              })\n            }\n\n            // Emit TOOL_CALL_ARGS\n            yield asChunk({\n              type: 'TOOL_CALL_ARGS',\n              toolCallId,\n              model,\n              timestamp,\n              delta: toolCallData.args,\n              args: toolCallData.args,\n            })\n          }\n        }\n      } else if (chunk.data && chunk.data.trim()) {\n        // Skip whitespace-only data (e.g. \"\\n\" during auto-continuation)\n        // Emit TEXT_MESSAGE_START on first text content\n        if (!hasEmittedTextMessageStart) {\n          hasEmittedTextMessageStart = true\n          yield asChunk({\n            type: 'TEXT_MESSAGE_START',\n            messageId,\n            model,\n            timestamp,\n            role: 'assistant',\n          })\n        }\n\n        accumulatedContent += chunk.data\n        yield asChunk({\n          type: 'TEXT_MESSAGE_CONTENT',\n          messageId,\n          model,\n          timestamp,\n          delta: chunk.data,\n          content: accumulatedContent,\n        })\n      }\n\n      if (chunk.candidates?.[0]?.finishReason) {\n        const finishReason = chunk.candidates[0].finishReason\n\n        if (finishReason === FinishReason.UNEXPECTED_TOOL_CALL) {\n          if (chunk.candidates[0].content?.parts) {\n            for (const part of chunk.candidates[0].content.parts) {\n              const functionCall = part.functionCall\n              if (functionCall) {\n                const toolCallId =\n                  functionCall.id ||\n                  `${functionCall.name}_${Date.now()}_${nextToolIndex}`\n                const functionArgs = functionCall.args || {}\n\n                const argsString =\n                  typeof functionArgs === 'string'\n                    ? functionArgs\n                    : JSON.stringify(functionArgs)\n\n                toolCallMap.set(toolCallId, {\n                  name: functionCall.name || '',\n                  args: argsString,\n                  index: nextToolIndex++,\n                  started: true,\n                })\n\n                // Emit TOOL_CALL_START\n                yield asChunk({\n                  type: 'TOOL_CALL_START',\n                  toolCallId,\n                  toolCallName: functionCall.name || '',\n                  toolName: functionCall.name || '',\n                  model,\n                  timestamp,\n                  index: nextToolIndex - 1,\n                })\n\n                // Emit TOOL_CALL_END with parsed input\n                let parsedInput: unknown = {}\n                try {\n                  const parsed =\n                    typeof functionArgs === 'string'\n                      ? JSON.parse(functionArgs)\n                      : functionArgs\n                  parsedInput =\n                    parsed && typeof parsed === 'object' ? parsed : {}\n                } catch {\n                  parsedInput = {}\n                }\n\n                yield asChunk({\n                  type: 'TOOL_CALL_END',\n                  toolCallId,\n                  toolCallName: functionCall.name || '',\n                  toolName: functionCall.name || '',\n                  model,\n                  timestamp,\n                  input: parsedInput,\n                })\n              }\n            }\n          }\n        }\n\n        // Emit TOOL_CALL_END for all tracked tool calls\n        for (const [toolCallId, toolCallData] of toolCallMap.entries()) {\n          let parsedInput: unknown = {}\n          try {\n            const parsed = JSON.parse(toolCallData.args)\n            parsedInput = parsed && typeof parsed === 'object' ? parsed : {}\n          } catch {\n            parsedInput = {}\n          }\n\n          yield asChunk({\n            type: 'TOOL_CALL_END',\n            toolCallId,\n            toolCallName: toolCallData.name,\n            toolName: toolCallData.name,\n            model,\n            timestamp,\n            input: parsedInput,\n          })\n        }\n\n        // Reset so a new TEXT_MESSAGE_START is emitted if text follows tool calls\n        if (toolCallMap.size > 0) {\n          hasEmittedTextMessageStart = false\n        }\n\n        if (finishReason === FinishReason.MAX_TOKENS) {\n          yield asChunk({\n            type: 'RUN_ERROR',\n            runId,\n            model,\n            timestamp,\n            message:\n              'The response was cut off because the maximum token limit was reached.',\n            code: 'max_tokens',\n            error: {\n              message:\n                'The response was cut off because the maximum token limit was reached.',\n              code: 'max_tokens',\n            },\n          })\n        }\n\n        // Close reasoning events if still open\n        if (reasoningMessageId && !hasClosedReasoning) {\n          hasClosedReasoning = true\n          yield asChunk({\n            type: 'REASONING_MESSAGE_END',\n            messageId: reasoningMessageId,\n            model,\n            timestamp,\n          })\n          yield asChunk({\n            type: 'REASONING_END',\n            messageId: reasoningMessageId,\n            model,\n            timestamp,\n          })\n        }\n\n        // Emit TEXT_MESSAGE_END if we had text content\n        if (hasEmittedTextMessageStart) {\n          yield asChunk({\n            type: 'TEXT_MESSAGE_END',\n            messageId,\n            model,\n            timestamp,\n          })\n        }\n\n        yield asChunk({\n          type: 'RUN_FINISHED',\n          runId,\n          threadId,\n          model,\n          timestamp,\n          finishReason: toolCallMap.size > 0 ? 'tool_calls' : 'stop',\n          usage: chunk.usageMetadata\n            ? {\n                promptTokens: chunk.usageMetadata.promptTokenCount ?? 0,\n                completionTokens: chunk.usageMetadata.candidatesTokenCount ?? 0,\n                totalTokens: chunk.usageMetadata.totalTokenCount ?? 0,\n              }\n            : undefined,\n        })\n      }\n    }\n  }\n\n  private convertContentPartToGemini(part: ContentPart): Part {\n    switch (part.type) {\n      case 'text':\n        return { text: part.content }\n      case 'image':\n      case 'audio':\n      case 'video':\n      case 'document': {\n        if (part.source.type === 'data') {\n          return {\n            inlineData: {\n              data: part.source.value,\n              mimeType: part.source.mimeType,\n            },\n          }\n        } else {\n          // For URL sources, use provided mimeType or fall back to reasonable defaults\n          const defaultMimeType = {\n            image: 'image/jpeg',\n            audio: 'audio/mp3',\n            video: 'video/mp4',\n            document: 'application/pdf',\n          }[part.type]\n\n          return {\n            fileData: {\n              fileUri: part.source.value,\n              mimeType: part.source.mimeType ?? defaultMimeType,\n            },\n          }\n        }\n      }\n      default: {\n        const _exhaustiveCheck: never = part\n        throw new Error(\n          `Unsupported content part type: ${(_exhaustiveCheck as ContentPart).type}`,\n        )\n      }\n    }\n  }\n\n  private formatMessages(\n    messages: Array<ModelMessage>,\n  ): GenerateContentParameters['contents'] {\n    // Build a lookup from toolCallId → function name so functionResponse uses the\n    // correct name instead of the raw call ID.\n    const toolCallIdToName = new Map<string, string>()\n    for (const msg of messages) {\n      if (msg.role === 'assistant' && msg.toolCalls) {\n        for (const tc of msg.toolCalls) {\n          toolCallIdToName.set(tc.id, tc.function.name)\n        }\n      }\n    }\n\n    const formatted = messages.map((msg) => {\n      const role: 'user' | 'model' = msg.role === 'assistant' ? 'model' : 'user'\n      const parts: Array<Part> = []\n\n      if (Array.isArray(msg.content)) {\n        for (const contentPart of msg.content) {\n          parts.push(this.convertContentPartToGemini(contentPart))\n        }\n      } else if (msg.content && msg.role !== 'tool') {\n        parts.push({ text: msg.content })\n      }\n\n      if (msg.role === 'assistant' && msg.toolCalls?.length) {\n        for (const toolCall of msg.toolCalls) {\n          let parsedArgs: Record<string, unknown> = {}\n          try {\n            parsedArgs = toolCall.function.arguments\n              ? (JSON.parse(toolCall.function.arguments) as Record<\n                  string,\n                  unknown\n                >)\n              : {}\n          } catch {\n            parsedArgs = toolCall.function.arguments as unknown as Record<\n              string,\n              unknown\n            >\n          }\n\n          const thoughtSignature = toolCall.providerMetadata\n            ?.thoughtSignature as string | undefined\n          parts.push({\n            functionCall: {\n              id: toolCall.id,\n              name: toolCall.function.name,\n              args: parsedArgs,\n              ...(thoughtSignature && { thoughtSignature }),\n            } as any,\n          })\n        }\n      }\n\n      if (msg.role === 'tool' && msg.toolCallId) {\n        const functionName =\n          toolCallIdToName.get(msg.toolCallId) || msg.toolCallId\n        parts.push({\n          functionResponse: {\n            id: msg.toolCallId,\n            name: functionName,\n            response: {\n              content: msg.content || '',\n            },\n          } as any,\n        })\n      }\n\n      return {\n        role,\n        parts: parts.length > 0 ? parts : [{ text: '' }],\n      }\n    })\n\n    // Post-process: Gemini requires strictly alternating user/model roles.\n    // Tool results are mapped to role:'user', which can create consecutive\n    // user messages when followed by a new user message. Merge them.\n    return this.mergeConsecutiveSameRoleMessages(formatted)\n  }\n\n  /**\n   * Merge consecutive messages of the same role into a single message.\n   * Gemini's API requires strictly alternating user/model roles.\n   * Tool results are mapped to role:'user', which can collide with actual\n   * user messages in multi-turn conversations.\n   *\n   * Also filters out empty model messages (e.g., from a previous failed request)\n   * and deduplicates functionResponse parts with the same name (tool call ID).\n   */\n  private mergeConsecutiveSameRoleMessages(\n    messages: Array<Content>,\n  ): Array<Content> {\n    const merged: Array<Content> = []\n\n    for (const msg of messages) {\n      const parts = msg.parts || []\n\n      // Skip empty model messages (no parts or only empty text)\n      if (msg.role === 'model') {\n        const hasContent =\n          parts.length > 0 &&\n          !parts.every(\n            (p) => 'text' in p && (p as { text: string }).text === '',\n          )\n        if (!hasContent) {\n          continue\n        }\n      }\n\n      const prev = merged[merged.length - 1]\n      if (prev && prev.role === msg.role) {\n        // Merge parts arrays\n        prev.parts = [...(prev.parts || []), ...parts]\n      } else {\n        merged.push({ ...msg, parts: [...parts] })\n      }\n    }\n\n    // Deduplicate functionResponse parts with the same name (tool call ID)\n    for (const msg of merged) {\n      if (!msg.parts) continue\n      const seenFunctionResponseNames = new Set<string>()\n      msg.parts = msg.parts.filter((part) => {\n        if ('functionResponse' in part && part.functionResponse?.name) {\n          if (seenFunctionResponseNames.has(part.functionResponse.name)) {\n            return false\n          }\n          seenFunctionResponseNames.add(part.functionResponse.name)\n        }\n        return true\n      })\n    }\n\n    return merged\n  }\n\n  private mapCommonOptionsToGemini(\n    options: TextOptions<GeminiTextProviderOptions>,\n  ) {\n    const modelOpts = options.modelOptions\n    const thinkingConfig = modelOpts?.thinkingConfig\n    const requestOptions: GenerateContentParameters = {\n      model: options.model,\n      contents: this.formatMessages(options.messages),\n      config: {\n        ...modelOpts,\n        temperature: options.temperature,\n        topP: options.topP,\n        maxOutputTokens: options.maxTokens,\n        thinkingConfig: thinkingConfig\n          ? {\n              ...thinkingConfig,\n              thinkingLevel: thinkingConfig.thinkingLevel\n                ? // Enum is provided by the SDK, we use it for the type but cast it to string constants, here we just cast them back\n                  (thinkingConfig.thinkingLevel as ThinkingLevel)\n                : undefined,\n            }\n          : undefined,\n        systemInstruction: options.systemPrompts?.join('\\n'),\n        tools: convertToolsToProviderFormat(options.tools),\n      },\n    }\n\n    return requestOptions\n  }\n}\n\n/**\n * Creates a Gemini text adapter with explicit API key.\n * Type resolution happens here at the call site.\n */\nexport function createGeminiChat<TModel extends (typeof GEMINI_MODELS)[number]>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiTextConfig, 'apiKey'>,\n): GeminiTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  ResolveToolCapabilities<TModel>\n> {\n  return new GeminiTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Gemini text adapter with automatic API key detection.\n * Type resolution happens here at the call site.\n */\nexport function geminiText<TModel extends (typeof GEMINI_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GeminiTextConfig, 'apiKey'>,\n): GeminiTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  ResolveToolCapabilities<TModel>\n> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiChat(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/adapters/tts.js

@@ -13,54 +13,67 @@ class GeminiTTSAdapter extends BaseTTSAdapter {
    * @see https://ai.google.dev/gemini-api/docs/speech-generation
    */
   async generateSpeech(options) {
+    const { logger } = options;
     const { model, text, modelOptions } = options;
+    logger.request(`activity=generateSpeech provider=gemini model=${model}`, {
+      provider: "gemini",
+      model
+    });
     const voiceConfig = modelOptions?.voiceConfig || {
       prebuiltVoiceConfig: {
         voiceName: "Kore"
       }
     };
-    const response = await this.client.models.generateContent({
-      model,
-      contents: [
-        {
-          role: "user",
-          parts: [{ text }]
-        }
-      ],
-      config: {
-        responseModalities: ["AUDIO"],
-        speechConfig: {
-          voiceConfig,
-          ...modelOptions?.languageCode && {
-            languageCode: modelOptions.languageCode
+    try {
+      const response = await this.client.models.generateContent({
+        model,
+        contents: [
+          {
+            role: "user",
+            parts: [{ text }]
           }
+        ],
+        config: {
+          responseModalities: ["AUDIO"],
+          speechConfig: {
+            voiceConfig,
+            ...modelOptions?.languageCode && {
+              languageCode: modelOptions.languageCode
+            }
+          }
+        },
+        ...modelOptions?.systemInstruction && {
+          systemInstruction: modelOptions.systemInstruction
         }
-      },
-      ...modelOptions?.systemInstruction && {
-        systemInstruction: modelOptions.systemInstruction
+      });
+      const candidate = response.candidates?.[0];
+      const parts = candidate?.content?.parts;
+      if (!parts || parts.length === 0) {
+        throw new Error("No audio output received from Gemini TTS");
       }
-    });
-    const candidate = response.candidates?.[0];
-    const parts = candidate?.content?.parts;
-    if (!parts || parts.length === 0) {
-      throw new Error("No audio output received from Gemini TTS");
-    }
-    const audioPart = parts.find(
-      (part) => part.inlineData?.mimeType?.startsWith("audio/")
-    );
-    if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {
-      throw new Error("No audio data in Gemini TTS response");
+      const audioPart = parts.find(
+        (part) => part.inlineData?.mimeType?.startsWith("audio/")
+      );
+      if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {
+        throw new Error("No audio data in Gemini TTS response");
+      }
+      const audioBase64 = audioPart.inlineData.data;
+      const mimeType = audioPart.inlineData.mimeType || "audio/wav";
+      const format = mimeType.split("/")[1] || "wav";
+      return {
+        id: generateId(this.name),
+        model,
+        audio: audioBase64,
+        format,
+        contentType: mimeType
+      };
+    } catch (error) {
+      logger.errors("gemini.generateSpeech fatal", {
+        error,
+        source: "gemini.generateSpeech"
+      });
+      throw error;
     }
-    const audioBase64 = audioPart.inlineData.data;
-    const mimeType = audioPart.inlineData.mimeType || "audio/wav";
-    const format = mimeType.split("/")[1] || "wav";
-    return {
-      id: generateId(this.name),
-      model,
-      audio: audioBase64,
-      format,
-      contentType: mimeType
-    };
   }
 }
 function createGeminiSpeech(model, apiKey, config) {

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

@@ -1 +1 @@
-{"version":3,"file":"tts.js","sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type { GEMINI_TTS_MODELS, GeminiTTSVoice } from '../model-meta'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type { GoogleGenAI } from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\n\n/**\n * Provider-specific options for Gemini TTS\n *\n * @experimental Gemini TTS is an experimental feature.\n * @see https://ai.google.dev/gemini-api/docs/speech-generation\n */\nexport interface GeminiTTSProviderOptions {\n  /**\n   * Voice configuration for TTS.\n   * Choose from 30 available voices with different characteristics.\n   */\n  voiceConfig?: {\n    prebuiltVoiceConfig?: {\n      /**\n       * The voice name to use for speech synthesis.\n       * @see https://ai.google.dev/gemini-api/docs/speech-generation#voices\n       */\n      voiceName?: GeminiTTSVoice\n    }\n  }\n\n  /**\n   * System instruction for controlling speech style.\n   * Use natural language to describe the desired speaking style,\n   * pace, tone, accent, or other characteristics.\n   *\n   * @example \"Speak slowly and calmly, as if telling a bedtime story\"\n   * @example \"Use an upbeat, enthusiastic tone with moderate pace\"\n   * @example \"Speak with a British accent\"\n   */\n  systemInstruction?: string\n\n  /**\n   * Language code hint for the speech synthesis.\n   * Gemini TTS supports 24 languages and can auto-detect,\n   * but you can provide a hint for better results.\n   *\n   * @example \"en-US\" for American English\n   * @example \"es-ES\" for Spanish (Spain)\n   * @example \"ja-JP\" for Japanese\n   */\n  languageCode?: string\n}\n\n/**\n * Configuration for Gemini TTS adapter\n *\n * @experimental Gemini TTS is an experimental feature.\n */\nexport interface GeminiTTSConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini TTS */\nexport type GeminiTTSModel = (typeof GEMINI_TTS_MODELS)[number]\n\n/**\n * Gemini Text-to-Speech Adapter\n *\n * Tree-shakeable adapter for Gemini TTS functionality.\n *\n * **IMPORTANT**: Gemini TTS uses the Live API (WebSocket-based) which requires\n * different handling than traditional REST APIs. This adapter provides a\n * simplified interface but may have limitations.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\n *\n * Models:\n * - gemini-2.5-flash-preview-tts\n */\nexport class GeminiTTSAdapter<\n  TModel extends GeminiTTSModel,\n> extends BaseTTSAdapter<TModel, GeminiTTSProviderOptions> {\n  readonly name = 'gemini' as const\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiTTSConfig, model: TModel) {\n    super(config, model)\n    this.client = createGeminiClient(config)\n  }\n\n  /**\n   * Generate speech from text using Gemini's TTS model.\n   *\n   * @experimental This implementation is experimental and may change.\n   * @see https://ai.google.dev/gemini-api/docs/speech-generation\n   */\n  async generateSpeech(\n    options: TTSOptions<GeminiTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { model, text, modelOptions } = options\n\n    const voiceConfig = modelOptions?.voiceConfig || {\n      prebuiltVoiceConfig: {\n        voiceName: 'Kore',\n      },\n    }\n\n    const response = await this.client.models.generateContent({\n      model,\n      contents: [\n        {\n          role: 'user',\n          parts: [{ text }],\n        },\n      ],\n      config: {\n        responseModalities: ['AUDIO'],\n        speechConfig: {\n          voiceConfig,\n          ...(modelOptions?.languageCode && {\n            languageCode: modelOptions.languageCode,\n          }),\n        },\n      },\n      ...(modelOptions?.systemInstruction && {\n        systemInstruction: modelOptions.systemInstruction,\n      }),\n    })\n\n    // Extract audio data from response\n    const candidate = response.candidates?.[0]\n    const parts = candidate?.content?.parts\n\n    if (!parts || parts.length === 0) {\n      throw new Error('No audio output received from Gemini TTS')\n    }\n\n    // Look for inline data (audio)\n    const audioPart = parts.find((part: any) =>\n      part.inlineData?.mimeType?.startsWith('audio/'),\n    )\n\n    if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {\n      throw new Error('No audio data in Gemini TTS response')\n    }\n\n    const audioBase64 = audioPart.inlineData.data\n    const mimeType = audioPart.inlineData.mimeType || 'audio/wav'\n    const format = mimeType.split('/')[1] || 'wav'\n\n    return {\n      id: generateId(this.name),\n      model,\n      audio: audioBase64,\n      format,\n      contentType: mimeType,\n    }\n  }\n}\n\n/**\n * Creates a Gemini TTS adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'gemini-2.5-flash-preview-tts')\n * @param apiKey - Your Google API key\n * @param config - Optional additional configuration\n * @returns Configured Gemini TTS adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGeminiSpeech('gemini-2.5-flash-preview-tts', \"your-api-key\");\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello, world!'\n * });\n * ```\n */\nexport function createGeminiSpeech<TModel extends GeminiTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiTTSConfig, 'apiKey'>,\n): GeminiTTSAdapter<TModel> {\n  return new GeminiTTSAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Gemini speech adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\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., 'gemini-2.5-flash-preview-tts')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Gemini speech 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 = geminiSpeech('gemini-2.5-flash-preview-tts');\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Welcome to TanStack AI!'\n * });\n * ```\n */\nexport function geminiSpeech<TModel extends GeminiTTSModel>(\n  model: TModel,\n  config?: Omit<GeminiTTSConfig, 'apiKey'>,\n): GeminiTTSAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiSpeech(model, apiKey, config)\n}\n"],"names":[],"mappings":";;AA+EO,MAAM,yBAEH,eAAiD;AAAA,EAKzD,YAAY,QAAyB,OAAe;AAClD,UAAM,QAAQ,KAAK;AALrB,SAAS,OAAO;AAMd,SAAK,SAAS,mBAAmB,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eACJ,SACoB;AACpB,UAAM,EAAE,OAAO,MAAM,aAAA,IAAiB;AAEtC,UAAM,cAAc,cAAc,eAAe;AAAA,MAC/C,qBAAqB;AAAA,QACnB,WAAW;AAAA,MAAA;AAAA,IACb;AAGF,UAAM,WAAW,MAAM,KAAK,OAAO,OAAO,gBAAgB;AAAA,MACxD;AAAA,MACA,UAAU;AAAA,QACR;AAAA,UACE,MAAM;AAAA,UACN,OAAO,CAAC,EAAE,KAAA,CAAM;AAAA,QAAA;AAAA,MAClB;AAAA,MAEF,QAAQ;AAAA,QACN,oBAAoB,CAAC,OAAO;AAAA,QAC5B,cAAc;AAAA,UACZ;AAAA,UACA,GAAI,cAAc,gBAAgB;AAAA,YAChC,cAAc,aAAa;AAAA,UAAA;AAAA,QAC7B;AAAA,MACF;AAAA,MAEF,GAAI,cAAc,qBAAqB;AAAA,QACrC,mBAAmB,aAAa;AAAA,MAAA;AAAA,IAClC,CACD;AAGD,UAAM,YAAY,SAAS,aAAa,CAAC;AACzC,UAAM,QAAQ,WAAW,SAAS;AAElC,QAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AAGA,UAAM,YAAY,MAAM;AAAA,MAAK,CAAC,SAC5B,KAAK,YAAY,UAAU,WAAW,QAAQ;AAAA,IAAA;AAGhD,QAAI,CAAC,aAAa,CAAC,UAAU,cAAc,CAAC,UAAU,WAAW,MAAM;AACrE,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,UAAM,cAAc,UAAU,WAAW;AACzC,UAAM,WAAW,UAAU,WAAW,YAAY;AAClD,UAAM,SAAS,SAAS,MAAM,GAAG,EAAE,CAAC,KAAK;AAEzC,WAAO;AAAA,MACL,IAAI,WAAW,KAAK,IAAI;AAAA,MACxB;AAAA,MACA,OAAO;AAAA,MACP;AAAA,MACA,aAAa;AAAA,IAAA;AAAA,EAEjB;AACF;AAuBO,SAAS,mBACd,OACA,QACA,QAC0B;AAC1B,SAAO,IAAI,iBAAiB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAC1D;AA4BO,SAAS,aACd,OACA,QAC0B;AAC1B,QAAM,SAAS,uBAAA;AACf,SAAO,mBAAmB,OAAO,QAAQ,MAAM;AACjD;"}
+{"version":3,"file":"tts.js","sources":["../../../src/adapters/tts.ts"],"sourcesContent":["import { BaseTTSAdapter } from '@tanstack/ai/adapters'\nimport {\n  createGeminiClient,\n  generateId,\n  getGeminiApiKeyFromEnv,\n} from '../utils'\nimport type { GEMINI_TTS_MODELS, GeminiTTSVoice } from '../model-meta'\nimport type { TTSOptions, TTSResult } from '@tanstack/ai'\nimport type { GoogleGenAI } from '@google/genai'\nimport type { GeminiClientConfig } from '../utils'\n\n/**\n * Provider-specific options for Gemini TTS\n *\n * @experimental Gemini TTS is an experimental feature.\n * @see https://ai.google.dev/gemini-api/docs/speech-generation\n */\nexport interface GeminiTTSProviderOptions {\n  /**\n   * Voice configuration for TTS.\n   * Choose from 30 available voices with different characteristics.\n   */\n  voiceConfig?: {\n    prebuiltVoiceConfig?: {\n      /**\n       * The voice name to use for speech synthesis.\n       * @see https://ai.google.dev/gemini-api/docs/speech-generation#voices\n       */\n      voiceName?: GeminiTTSVoice\n    }\n  }\n\n  /**\n   * System instruction for controlling speech style.\n   * Use natural language to describe the desired speaking style,\n   * pace, tone, accent, or other characteristics.\n   *\n   * @example \"Speak slowly and calmly, as if telling a bedtime story\"\n   * @example \"Use an upbeat, enthusiastic tone with moderate pace\"\n   * @example \"Speak with a British accent\"\n   */\n  systemInstruction?: string\n\n  /**\n   * Language code hint for the speech synthesis.\n   * Gemini TTS supports 24 languages and can auto-detect,\n   * but you can provide a hint for better results.\n   *\n   * @example \"en-US\" for American English\n   * @example \"es-ES\" for Spanish (Spain)\n   * @example \"ja-JP\" for Japanese\n   */\n  languageCode?: string\n}\n\n/**\n * Configuration for Gemini TTS adapter\n *\n * @experimental Gemini TTS is an experimental feature.\n */\nexport interface GeminiTTSConfig extends GeminiClientConfig {}\n\n/** Model type for Gemini TTS */\nexport type GeminiTTSModel = (typeof GEMINI_TTS_MODELS)[number]\n\n/**\n * Gemini Text-to-Speech Adapter\n *\n * Tree-shakeable adapter for Gemini TTS functionality.\n *\n * **IMPORTANT**: Gemini TTS uses the Live API (WebSocket-based) which requires\n * different handling than traditional REST APIs. This adapter provides a\n * simplified interface but may have limitations.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\n *\n * Models:\n * - gemini-2.5-flash-preview-tts\n */\nexport class GeminiTTSAdapter<\n  TModel extends GeminiTTSModel,\n> extends BaseTTSAdapter<TModel, GeminiTTSProviderOptions> {\n  readonly name = 'gemini' as const\n\n  private client: GoogleGenAI\n\n  constructor(config: GeminiTTSConfig, model: TModel) {\n    super(config, model)\n    this.client = createGeminiClient(config)\n  }\n\n  /**\n   * Generate speech from text using Gemini's TTS model.\n   *\n   * @experimental This implementation is experimental and may change.\n   * @see https://ai.google.dev/gemini-api/docs/speech-generation\n   */\n  async generateSpeech(\n    options: TTSOptions<GeminiTTSProviderOptions>,\n  ): Promise<TTSResult> {\n    const { logger } = options\n    const { model, text, modelOptions } = options\n\n    logger.request(`activity=generateSpeech provider=gemini model=${model}`, {\n      provider: 'gemini',\n      model,\n    })\n\n    const voiceConfig = modelOptions?.voiceConfig || {\n      prebuiltVoiceConfig: {\n        voiceName: 'Kore',\n      },\n    }\n\n    try {\n      const response = await this.client.models.generateContent({\n        model,\n        contents: [\n          {\n            role: 'user',\n            parts: [{ text }],\n          },\n        ],\n        config: {\n          responseModalities: ['AUDIO'],\n          speechConfig: {\n            voiceConfig,\n            ...(modelOptions?.languageCode && {\n              languageCode: modelOptions.languageCode,\n            }),\n          },\n        },\n        ...(modelOptions?.systemInstruction && {\n          systemInstruction: modelOptions.systemInstruction,\n        }),\n      })\n\n      // Extract audio data from response\n      const candidate = response.candidates?.[0]\n      const parts = candidate?.content?.parts\n\n      if (!parts || parts.length === 0) {\n        throw new Error('No audio output received from Gemini TTS')\n      }\n\n      // Look for inline data (audio)\n      const audioPart = parts.find((part: any) =>\n        part.inlineData?.mimeType?.startsWith('audio/'),\n      )\n\n      if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {\n        throw new Error('No audio data in Gemini TTS response')\n      }\n\n      const audioBase64 = audioPart.inlineData.data\n      const mimeType = audioPart.inlineData.mimeType || 'audio/wav'\n      const format = mimeType.split('/')[1] || 'wav'\n\n      return {\n        id: generateId(this.name),\n        model,\n        audio: audioBase64,\n        format,\n        contentType: mimeType,\n      }\n    } catch (error) {\n      logger.errors('gemini.generateSpeech fatal', {\n        error,\n        source: 'gemini.generateSpeech',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Creates a Gemini TTS adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'gemini-2.5-flash-preview-tts')\n * @param apiKey - Your Google API key\n * @param config - Optional additional configuration\n * @returns Configured Gemini TTS adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGeminiSpeech('gemini-2.5-flash-preview-tts', \"your-api-key\");\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Hello, world!'\n * });\n * ```\n */\nexport function createGeminiSpeech<TModel extends GeminiTTSModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiTTSConfig, 'apiKey'>,\n): GeminiTTSAdapter<TModel> {\n  return new GeminiTTSAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Gemini speech adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * @experimental Gemini TTS is an experimental feature and may change.\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., 'gemini-2.5-flash-preview-tts')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Gemini speech 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 = geminiSpeech('gemini-2.5-flash-preview-tts');\n *\n * const result = await generateSpeech({\n *   adapter,\n *   text: 'Welcome to TanStack AI!'\n * });\n * ```\n */\nexport function geminiSpeech<TModel extends GeminiTTSModel>(\n  model: TModel,\n  config?: Omit<GeminiTTSConfig, 'apiKey'>,\n): GeminiTTSAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiSpeech(model, apiKey, config)\n}\n"],"names":[],"mappings":";;AA+EO,MAAM,yBAEH,eAAiD;AAAA,EAKzD,YAAY,QAAyB,OAAe;AAClD,UAAM,QAAQ,KAAK;AALrB,SAAS,OAAO;AAMd,SAAK,SAAS,mBAAmB,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eACJ,SACoB;AACpB,UAAM,EAAE,WAAW;AACnB,UAAM,EAAE,OAAO,MAAM,aAAA,IAAiB;AAEtC,WAAO,QAAQ,iDAAiD,KAAK,IAAI;AAAA,MACvE,UAAU;AAAA,MACV;AAAA,IAAA,CACD;AAED,UAAM,cAAc,cAAc,eAAe;AAAA,MAC/C,qBAAqB;AAAA,QACnB,WAAW;AAAA,MAAA;AAAA,IACb;AAGF,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OAAO,OAAO,gBAAgB;AAAA,QACxD;AAAA,QACA,UAAU;AAAA,UACR;AAAA,YACE,MAAM;AAAA,YACN,OAAO,CAAC,EAAE,KAAA,CAAM;AAAA,UAAA;AAAA,QAClB;AAAA,QAEF,QAAQ;AAAA,UACN,oBAAoB,CAAC,OAAO;AAAA,UAC5B,cAAc;AAAA,YACZ;AAAA,YACA,GAAI,cAAc,gBAAgB;AAAA,cAChC,cAAc,aAAa;AAAA,YAAA;AAAA,UAC7B;AAAA,QACF;AAAA,QAEF,GAAI,cAAc,qBAAqB;AAAA,UACrC,mBAAmB,aAAa;AAAA,QAAA;AAAA,MAClC,CACD;AAGD,YAAM,YAAY,SAAS,aAAa,CAAC;AACzC,YAAM,QAAQ,WAAW,SAAS;AAElC,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,cAAM,IAAI,MAAM,0CAA0C;AAAA,MAC5D;AAGA,YAAM,YAAY,MAAM;AAAA,QAAK,CAAC,SAC5B,KAAK,YAAY,UAAU,WAAW,QAAQ;AAAA,MAAA;AAGhD,UAAI,CAAC,aAAa,CAAC,UAAU,cAAc,CAAC,UAAU,WAAW,MAAM;AACrE,cAAM,IAAI,MAAM,sCAAsC;AAAA,MACxD;AAEA,YAAM,cAAc,UAAU,WAAW;AACzC,YAAM,WAAW,UAAU,WAAW,YAAY;AAClD,YAAM,SAAS,SAAS,MAAM,GAAG,EAAE,CAAC,KAAK;AAEzC,aAAO;AAAA,QACL,IAAI,WAAW,KAAK,IAAI;AAAA,QACxB;AAAA,QACA,OAAO;AAAA,QACP;AAAA,QACA,aAAa;AAAA,MAAA;AAAA,IAEjB,SAAS,OAAO;AACd,aAAO,OAAO,+BAA+B;AAAA,QAC3C;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAuBO,SAAS,mBACd,OACA,QACA,QAC0B;AAC1B,SAAO,IAAI,iBAAiB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAC1D;AA4BO,SAAS,aACd,OACA,QAC0B;AAC1B,QAAM,SAAS,uBAAA;AACf,SAAO,mBAAmB,OAAO,QAAQ,MAAM;AACjD;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Google Gemini adapter for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -37,13 +37,13 @@
     "@google/genai": "^1.43.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.12.0"
+    "@tanstack/ai": "^0.13.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.2.7",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.12.0"
+    "@tanstack/ai": "0.13.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/image.ts

@@ -81,27 +81,43 @@ export class GeminiImageAdapter<
   async generateImages(
     options: ImageGenerationOptions<GeminiImageProviderOptions>,
   ): Promise<ImageGenerationResult> {
-    const { model, prompt } = options
+    const { model, prompt, logger } = options
 
-    validatePrompt({ prompt, model })
+    logger.request(
+      `activity=generateImage provider=gemini model=${this.model}`,
+      {
+        provider: 'gemini',
+        model: this.model,
+      },
+    )
 
-    if (this.isGeminiImageModel(model)) {
-      return this.generateWithGeminiApi(options)
-    }
+    try {
+      validatePrompt({ prompt, model })
 
-    // Imagen models path (generateImages API)
-    validateImageSize(model, options.size)
-    validateNumberOfImages(model, options.numberOfImages)
+      if (this.isGeminiImageModel(model)) {
+        return await this.generateWithGeminiApi(options)
+      }
 
-    const config = this.buildImagenConfig(options)
+      // Imagen models path (generateImages API)
+      validateImageSize(model, options.size)
+      validateNumberOfImages(model, options.numberOfImages)
 
-    const response = await this.client.models.generateImages({
-      model,
-      prompt,
-      config,
-    })
+      const config = this.buildImagenConfig(options)
 
-    return this.transformImagenResponse(model, response)
+      const response = await this.client.models.generateImages({
+        model,
+        prompt,
+        config,
+      })
+
+      return this.transformImagenResponse(model, response)
+    } catch (error) {
+      logger.errors('gemini.generateImage fatal', {
+        error,
+        source: 'gemini.generateImage',
+      })
+      throw error
+    }
   }
 
   private isGeminiImageModel(model: string): boolean {

package/src/adapters/summarize.ts

@@ -81,8 +81,14 @@ export class GeminiSummarizeAdapter<
   }
 
   async summarize(options: SummarizationOptions): Promise<SummarizationResult> {
+    const { logger } = options
     const model = options.model
 
+    logger.request(`activity=summarize provider=gemini`, {
+      provider: 'gemini',
+      model,
+    })
+
     // Build the system prompt based on format
     const formatInstructions = this.getFormatInstructions(options.style)
     const lengthInstructions = options.maxLength
@@ -91,40 +97,49 @@ export class GeminiSummarizeAdapter<
 
     const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`
 
-    const response = await this.client.models.generateContent({
-      model,
-      contents: [
-        {
-          role: 'user',
-          parts: [
-            { text: `Please summarize the following:\n\n${options.text}` },
-          ],
+    try {
+      const response = await this.client.models.generateContent({
+        model,
+        contents: [
+          {
+            role: 'user',
+            parts: [
+              { text: `Please summarize the following:\n\n${options.text}` },
+            ],
+          },
+        ],
+        config: {
+          systemInstruction: systemPrompt,
         },
-      ],
-      config: {
-        systemInstruction: systemPrompt,
-      },
-    })
+      })
 
-    const summary = response.text ?? ''
-    const inputTokens = response.usageMetadata?.promptTokenCount ?? 0
-    const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0
+      const summary = response.text ?? ''
+      const inputTokens = response.usageMetadata?.promptTokenCount ?? 0
+      const outputTokens = response.usageMetadata?.candidatesTokenCount ?? 0
 
-    return {
-      id: generateId('sum'),
-      model,
-      summary,
-      usage: {
-        promptTokens: inputTokens,
-        completionTokens: outputTokens,
-        totalTokens: inputTokens + outputTokens,
-      },
+      return {
+        id: generateId('sum'),
+        model,
+        summary,
+        usage: {
+          promptTokens: inputTokens,
+          completionTokens: outputTokens,
+          totalTokens: inputTokens + outputTokens,
+        },
+      }
+    } catch (error) {
+      logger.errors('gemini.summarize fatal', {
+        error,
+        source: 'gemini.summarize',
+      })
+      throw error
     }
   }
 
   async *summarizeStream(
     options: SummarizationOptions,
   ): AsyncIterable<StreamChunk> {
+    const { logger } = options
     const model = options.model
     const id = generateId('sum')
     let accumulatedContent = ''
@@ -139,69 +154,85 @@ export class GeminiSummarizeAdapter<
 
     const systemPrompt = `You are a helpful assistant that summarizes text. ${formatInstructions}${lengthInstructions}`
 
-    const result = await this.client.models.generateContentStream({
+    logger.request(`activity=summarize provider=gemini`, {
+      provider: 'gemini',
       model,
-      contents: [
-        {
-          role: 'user',
-          parts: [
-            { text: `Please summarize the following:\n\n${options.text}` },
-          ],
-        },
-      ],
-      config: {
-        systemInstruction: systemPrompt,
-      },
+      stream: true,
     })
 
-    for await (const chunk of result) {
-      // Track usage metadata
-      if (chunk.usageMetadata) {
-        inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens
-        outputTokens = chunk.usageMetadata.candidatesTokenCount ?? outputTokens
-      }
+    try {
+      const result = await this.client.models.generateContentStream({
+        model,
+        contents: [
+          {
+            role: 'user',
+            parts: [
+              { text: `Please summarize the following:\n\n${options.text}` },
+            ],
+          },
+        ],
+        config: {
+          systemInstruction: systemPrompt,
+        },
+      })
 
-      if (chunk.candidates?.[0]?.content?.parts) {
-        for (const part of chunk.candidates[0].content.parts) {
-          if (part.text) {
-            accumulatedContent += part.text
-            yield asChunk({
-              type: 'TEXT_MESSAGE_CONTENT',
-              messageId: id,
-              model,
-              timestamp: Date.now(),
-              delta: part.text,
-              content: accumulatedContent,
-            })
+      for await (const chunk of result) {
+        logger.provider(`provider=gemini`, { chunk })
+        // Track usage metadata
+        if (chunk.usageMetadata) {
+          inputTokens = chunk.usageMetadata.promptTokenCount ?? inputTokens
+          outputTokens =
+            chunk.usageMetadata.candidatesTokenCount ?? outputTokens
+        }
+
+        if (chunk.candidates?.[0]?.content?.parts) {
+          for (const part of chunk.candidates[0].content.parts) {
+            if (part.text) {
+              accumulatedContent += part.text
+              yield asChunk({
+                type: 'TEXT_MESSAGE_CONTENT',
+                messageId: id,
+                model,
+                timestamp: Date.now(),
+                delta: part.text,
+                content: accumulatedContent,
+              })
+            }
           }
         }
-      }
 
-      // Check for finish reason
-      const finishReason = chunk.candidates?.[0]?.finishReason
-      if (
-        finishReason === FinishReason.STOP ||
-        finishReason === FinishReason.MAX_TOKENS ||
-        finishReason === FinishReason.SAFETY
-      ) {
-        yield asChunk({
-          type: 'RUN_FINISHED',
-          runId: id,
-          model,
-          timestamp: Date.now(),
-          finishReason:
-            finishReason === FinishReason.STOP
-              ? 'stop'
-              : finishReason === FinishReason.MAX_TOKENS
-                ? 'length'
-                : 'content_filter',
-          usage: {
-            promptTokens: inputTokens,
-            completionTokens: outputTokens,
-            totalTokens: inputTokens + outputTokens,
-          },
-        })
+        // Check for finish reason
+        const finishReason = chunk.candidates?.[0]?.finishReason
+        if (
+          finishReason === FinishReason.STOP ||
+          finishReason === FinishReason.MAX_TOKENS ||
+          finishReason === FinishReason.SAFETY
+        ) {
+          yield asChunk({
+            type: 'RUN_FINISHED',
+            runId: id,
+            model,
+            timestamp: Date.now(),
+            finishReason:
+              finishReason === FinishReason.STOP
+                ? 'stop'
+                : finishReason === FinishReason.MAX_TOKENS
+                  ? 'length'
+                  : 'content_filter',
+            usage: {
+              promptTokens: inputTokens,
+              completionTokens: outputTokens,
+              totalTokens: inputTokens + outputTokens,
+            },
+          })
+        }
       }
+    } catch (error) {
+      logger.errors('gemini.summarize fatal', {
+        error,
+        source: 'gemini.summarize',
+      })
+      throw error
     }
   }
 

package/src/adapters/text.ts

@@ -16,6 +16,7 @@ import type {
   StructuredOutputOptions,
   StructuredOutputResult,
 } from '@tanstack/ai/adapters'
+import type { InternalLogger } from '@tanstack/ai/adapter-internals'
 import type {
   Content,
   GenerateContentParameters,
@@ -119,14 +120,23 @@ export class GeminiTextAdapter<
     options: TextOptions<GeminiTextProviderOptions>,
   ): AsyncIterable<StreamChunk> {
     const mappedOptions = this.mapCommonOptionsToGemini(options)
+    const { logger } = options
 
     try {
+      logger.request(
+        `activity=chat provider=gemini model=${this.model} messages=${options.messages.length} tools=${options.tools?.length ?? 0} stream=true`,
+        { provider: 'gemini', model: this.model },
+      )
       const result =
         await this.client.models.generateContentStream(mappedOptions)
 
-      yield* this.processStreamChunks(result, options)
+      yield* this.processStreamChunks(result, options, logger)
     } catch (error) {
       const timestamp = Date.now()
+      logger.errors('gemini.chatStream fatal', {
+        error,
+        source: 'gemini.chatStream',
+      })
       yield asChunk({
         type: 'RUN_ERROR',
         model: options.model,
@@ -154,10 +164,15 @@ export class GeminiTextAdapter<
     options: StructuredOutputOptions<GeminiTextProviderOptions>,
   ): Promise<StructuredOutputResult<unknown>> {
     const { chatOptions, outputSchema } = options
+    const { logger } = chatOptions
 
     const mappedOptions = this.mapCommonOptionsToGemini(chatOptions)
 
     try {
+      logger.request(
+        `activity=chat provider=gemini model=${this.model} messages=${chatOptions.messages.length} tools=${chatOptions.tools?.length ?? 0} stream=false`,
+        { provider: 'gemini', model: this.model },
+      )
       // Add structured output configuration
       const result = await this.client.models.generateContent({
         ...mappedOptions,
@@ -186,6 +201,10 @@ export class GeminiTextAdapter<
         rawText,
       }
     } catch (error) {
+      logger.errors('gemini.structuredOutput fatal', {
+        error,
+        source: 'gemini.structuredOutput',
+      })
       throw new Error(
         error instanceof Error
           ? error.message
@@ -214,6 +233,7 @@ export class GeminiTextAdapter<
   private async *processStreamChunks(
     result: AsyncGenerator<GenerateContentResponse, unknown, unknown>,
     options: TextOptions<GeminiTextProviderOptions>,
+    logger: InternalLogger,
   ): AsyncIterable<StreamChunk> {
     const model = options.model
     const timestamp = Date.now()
@@ -243,6 +263,7 @@ export class GeminiTextAdapter<
     let hasEmittedStepStarted = false
 
     for await (const chunk of result) {
+      logger.provider(`provider=gemini`, { chunk })
       // Emit RUN_STARTED on first chunk
       if (!hasEmittedRunStarted) {
         hasEmittedRunStarted = true

package/src/adapters/tts.ts

@@ -98,63 +98,77 @@ export class GeminiTTSAdapter<
   async generateSpeech(
     options: TTSOptions<GeminiTTSProviderOptions>,
   ): Promise<TTSResult> {
+    const { logger } = options
     const { model, text, modelOptions } = options
 
+    logger.request(`activity=generateSpeech provider=gemini model=${model}`, {
+      provider: 'gemini',
+      model,
+    })
+
     const voiceConfig = modelOptions?.voiceConfig || {
       prebuiltVoiceConfig: {
         voiceName: 'Kore',
       },
     }
 
-    const response = await this.client.models.generateContent({
-      model,
-      contents: [
-        {
-          role: 'user',
-          parts: [{ text }],
+    try {
+      const response = await this.client.models.generateContent({
+        model,
+        contents: [
+          {
+            role: 'user',
+            parts: [{ text }],
+          },
+        ],
+        config: {
+          responseModalities: ['AUDIO'],
+          speechConfig: {
+            voiceConfig,
+            ...(modelOptions?.languageCode && {
+              languageCode: modelOptions.languageCode,
+            }),
+          },
         },
-      ],
-      config: {
-        responseModalities: ['AUDIO'],
-        speechConfig: {
-          voiceConfig,
-          ...(modelOptions?.languageCode && {
-            languageCode: modelOptions.languageCode,
-          }),
-        },
-      },
-      ...(modelOptions?.systemInstruction && {
-        systemInstruction: modelOptions.systemInstruction,
-      }),
-    })
-
-    // Extract audio data from response
-    const candidate = response.candidates?.[0]
-    const parts = candidate?.content?.parts
-
-    if (!parts || parts.length === 0) {
-      throw new Error('No audio output received from Gemini TTS')
-    }
-
-    // Look for inline data (audio)
-    const audioPart = parts.find((part: any) =>
-      part.inlineData?.mimeType?.startsWith('audio/'),
-    )
-
-    if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {
-      throw new Error('No audio data in Gemini TTS response')
-    }
-
-    const audioBase64 = audioPart.inlineData.data
-    const mimeType = audioPart.inlineData.mimeType || 'audio/wav'
-    const format = mimeType.split('/')[1] || 'wav'
-
-    return {
-      id: generateId(this.name),
-      model,
-      audio: audioBase64,
-      format,
-      contentType: mimeType,
+        ...(modelOptions?.systemInstruction && {
+          systemInstruction: modelOptions.systemInstruction,
+        }),
+      })
+
+      // Extract audio data from response
+      const candidate = response.candidates?.[0]
+      const parts = candidate?.content?.parts
+
+      if (!parts || parts.length === 0) {
+        throw new Error('No audio output received from Gemini TTS')
+      }
+
+      // Look for inline data (audio)
+      const audioPart = parts.find((part: any) =>
+        part.inlineData?.mimeType?.startsWith('audio/'),
+      )
+
+      if (!audioPart || !audioPart.inlineData || !audioPart.inlineData.data) {
+        throw new Error('No audio data in Gemini TTS response')
+      }
+
+      const audioBase64 = audioPart.inlineData.data
+      const mimeType = audioPart.inlineData.mimeType || 'audio/wav'
+      const format = mimeType.split('/')[1] || 'wav'
+
+      return {
+        id: generateId(this.name),
+        model,
+        audio: audioBase64,
+        format,
+        contentType: mimeType,
+      }
+    } catch (error) {
+      logger.errors('gemini.generateSpeech fatal', {
+        error,
+        source: 'gemini.generateSpeech',
+      })
+      throw error
     }
   }
 }