@tanstack/ai-gemini 0.17.3 → 0.18.1

package/dist/esm/adapters/video.js

@@ -1,227 +0,0 @@
-import { VideoGenerationReferenceType, GenerateVideosOperation } from "@google/genai";
-import { resolveMediaPrompt } from "@tanstack/ai";
-import { BaseVideoAdapter, snapToDurationOption } from "@tanstack/ai/adapters";
-import { arrayBufferToBase64 } from "@tanstack/ai-utils";
-import { createGeminiClient, getGeminiApiKeyFromEnv } from "../utils/client.js";
-import { getGeminiVideoDurationOptions } from "../video/video-provider-options.js";
-function operationErrorMessage(error) {
-  if (typeof error.message === "string" && error.message.length > 0) {
-    return error.message;
-  }
-  return JSON.stringify(error);
-}
-async function imagePartToVeoImage(part) {
-  if (part.source.type === "data") {
-    return {
-      imageBytes: part.source.value,
-      mimeType: part.source.mimeType || "image/png"
-    };
-  }
-  const url = part.source.value;
-  if (url.startsWith("gs://")) {
-    return {
-      gcsUri: url,
-      ...part.source.mimeType && { mimeType: part.source.mimeType }
-    };
-  }
-  if (url.startsWith("data:")) {
-    const match = url.match(/^data:([^;,]+)?(;base64)?,(.*)$/);
-    if (!match || !match[2]) {
-      throw new Error(
-        "gemini: only base64 data: URIs are supported for video image inputs."
-      );
-    }
-    return {
-      imageBytes: match[3] ?? "",
-      mimeType: match[1] || part.source.mimeType || "image/png"
-    };
-  }
-  const response = await fetch(url);
-  if (!response.ok) {
-    throw new Error(
-      `Failed to fetch image input (${response.status} ${response.statusText}): ${url}`
-    );
-  }
-  const blob = await response.blob();
-  const buffer = await blob.arrayBuffer();
-  return {
-    imageBytes: arrayBufferToBase64(buffer),
-    mimeType: part.source.mimeType || blob.type || "image/png"
-  };
-}
-class GeminiVideoAdapter extends BaseVideoAdapter {
-  name = "gemini";
-  client;
-  constructor(config, model) {
-    super({}, model);
-    this.client = createGeminiClient(config);
-  }
-  async createVideoJob(options) {
-    const { prompt, size, duration, modelOptions, logger } = options;
-    logger.request(
-      `activity=video.create provider=${this.name} model=${this.model} size=${size ?? "default"} duration=${duration ?? "default"}`,
-      { provider: this.name, model: this.model }
-    );
-    try {
-      const resolved = resolveMediaPrompt(prompt);
-      if (resolved.videos.length > 0) {
-        throw new Error(
-          `${this.name}.createVideoJob does not support video prompt parts (model: ${this.model}).`
-        );
-      }
-      if (resolved.audios.length > 0) {
-        throw new Error(
-          `${this.name}.createVideoJob does not support audio prompt parts (model: ${this.model}).`
-        );
-      }
-      const { image, lastFrame, referenceImages } = await this.routeImageParts(
-        resolved.images
-      );
-      const config = {
-        ...modelOptions,
-        ...size !== void 0 && { aspectRatio: size },
-        ...duration !== void 0 && { durationSeconds: duration },
-        ...lastFrame && { lastFrame },
-        ...referenceImages.length > 0 && { referenceImages }
-      };
-      const operation = await this.client.models.generateVideos({
-        model: this.model,
-        prompt: resolved.text,
-        ...image && { image },
-        config
-      });
-      if (!operation.name) {
-        throw new Error(
-          "Veo did not return an operation name for the video generation job."
-        );
-      }
-      return { jobId: operation.name, model: this.model };
-    } catch (error) {
-      logger.errors(`${this.name}.createVideoJob fatal`, {
-        error,
-        source: `${this.name}.createVideoJob`
-      });
-      throw error;
-    }
-  }
-  /**
-   * Route image prompt parts onto Veo's request fields by `metadata.role`.
-   */
-  async routeImageParts(parts) {
-    let image;
-    let lastFrame;
-    const referenceImages = [];
-    for (const part of parts) {
-      const role = part.metadata?.role;
-      switch (role) {
-        case "end_frame": {
-          if (lastFrame) {
-            throw new Error(
-              `${this.name}: Veo accepts at most one 'end_frame' image.`
-            );
-          }
-          lastFrame = await imagePartToVeoImage(part);
-          break;
-        }
-        case "reference":
-        case "character": {
-          referenceImages.push({
-            image: await imagePartToVeoImage(part),
-            referenceType: VideoGenerationReferenceType.ASSET
-          });
-          break;
-        }
-        case "start_frame":
-        case void 0: {
-          if (image) {
-            throw new Error(
-              `${this.name}: Veo accepts at most one starting image; received multiple 'start_frame'/un-roled images. Use metadata.role ('end_frame', 'reference') to disambiguate the others.`
-            );
-          }
-          image = await imagePartToVeoImage(part);
-          break;
-        }
-        case "mask":
-        case "control":
-          throw new Error(
-            `${this.name}: unsupported image role "${role}" for Veo video generation.`
-          );
-      }
-    }
-    return { image, lastFrame, referenceImages };
-  }
-  async getVideoStatus(jobId) {
-    const operation = await this.getOperation(jobId);
-    if (!operation.done) {
-      return { jobId, status: "processing" };
-    }
-    if (operation.error) {
-      return {
-        jobId,
-        status: "failed",
-        error: operationErrorMessage(operation.error)
-      };
-    }
-    const videos = operation.response?.generatedVideos ?? [];
-    if (videos.length === 0) {
-      const reasons = operation.response?.raiMediaFilteredReasons;
-      return {
-        jobId,
-        status: "failed",
-        error: reasons?.length ? `Video was filtered by Responsible-AI: ${reasons.join("; ")}` : "Veo returned no generated videos."
-      };
-    }
-    return { jobId, status: "completed" };
-  }
-  async getVideoUrl(jobId) {
-    const operation = await this.getOperation(jobId);
-    if (!operation.done) {
-      throw new Error(
-        `Video is not ready yet. Check status first. Job ID: ${jobId}`
-      );
-    }
-    if (operation.error) {
-      throw new Error(
-        `Video generation failed: ${operationErrorMessage(operation.error)}`
-      );
-    }
-    const uri = operation.response?.generatedVideos?.[0]?.video?.uri;
-    if (!uri) {
-      const reasons = operation.response?.raiMediaFilteredReasons;
-      throw new Error(
-        reasons?.length ? `Video was filtered by Responsible-AI: ${reasons.join("; ")}` : `Video URL not found in operation response. Job ID: ${jobId}`
-      );
-    }
-    return { jobId, url: uri };
-  }
-  availableDurations() {
-    return getGeminiVideoDurationOptions(this.model);
-  }
-  snapDuration(seconds) {
-    return snapToDurationOption(seconds, this.availableDurations());
-  }
-  /**
-   * Fetch the long-running operation by name. The SDK's
-   * `operations.getVideosOperation` needs a real `GenerateVideosOperation`
-   * instance (it calls `_fromAPIResponse` on it), so reconstruct one from
-   * the job ID rather than passing an object literal.
-   */
-  async getOperation(jobId) {
-    const operation = new GenerateVideosOperation();
-    operation.name = jobId;
-    return await this.client.operations.getVideosOperation({ operation });
-  }
-}
-function createGeminiVideo(model, apiKey, config) {
-  return new GeminiVideoAdapter({ apiKey, ...config }, model);
-}
-function geminiVideo(model, config) {
-  const apiKey = getGeminiApiKeyFromEnv();
-  return createGeminiVideo(model, apiKey, config);
-}
-export {
-  GeminiVideoAdapter,
-  createGeminiVideo,
-  geminiVideo
-};
-//# sourceMappingURL=video.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"video.js","sources":["../../../src/adapters/video.ts"],"sourcesContent":["import {\n  GenerateVideosOperation,\n  VideoGenerationReferenceType,\n} from '@google/genai'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { arrayBufferToBase64 } from '@tanstack/ai-utils'\nimport { createGeminiClient, getGeminiApiKeyFromEnv } from '../utils'\nimport { getGeminiVideoDurationOptions } from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  ImagePart,\n  MediaInputMetadata,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  GenerateVideosConfig,\n  GoogleGenAI,\n  Image,\n  VideoGenerationReferenceImage,\n} from '@google/genai'\nimport type {\n  GeminiVideoModel,\n  GeminiVideoModelDurationByName,\n  GeminiVideoModelInputModalitiesByName,\n  GeminiVideoModelProviderOptionsByName,\n  GeminiVideoModelSizeByName,\n  GeminiVideoProviderOptions,\n  GeminiVideoSize,\n} from '../video/video-provider-options'\nimport type { GeminiClientConfig } from '../utils'\n\n/**\n * Configuration for Gemini video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GeminiVideoConfig extends GeminiClientConfig {}\n\n/**\n * Extract a human-readable message from a long-running operation's error,\n * which the SDK types as `Record<string, unknown>` (a google.rpc.Status).\n */\nfunction operationErrorMessage(error: Record<string, unknown>): string {\n  if (typeof error.message === 'string' && error.message.length > 0) {\n    return error.message\n  }\n  return JSON.stringify(error)\n}\n\n/**\n * Convert a TanStack image prompt part into the genai `Image` shape Veo\n * accepts: base64 `imageBytes` (data sources, data: URIs, fetched HTTP\n * URLs) or a `gcsUri` passthrough for Cloud Storage references.\n */\nasync function imagePartToVeoImage(\n  part: ImagePart<MediaInputMetadata>,\n): Promise<Image> {\n  if (part.source.type === 'data') {\n    return {\n      imageBytes: part.source.value,\n      mimeType: part.source.mimeType || 'image/png',\n    }\n  }\n  const url = part.source.value\n  if (url.startsWith('gs://')) {\n    return {\n      gcsUri: url,\n      ...(part.source.mimeType && { mimeType: part.source.mimeType }),\n    }\n  }\n  if (url.startsWith('data:')) {\n    const match = url.match(/^data:([^;,]+)?(;base64)?,(.*)$/)\n    if (!match || !match[2]) {\n      throw new Error(\n        'gemini: only base64 data: URIs are supported for video image inputs.',\n      )\n    }\n    return {\n      imageBytes: match[3] ?? '',\n      mimeType: match[1] || part.source.mimeType || 'image/png',\n    }\n  }\n  const response = await fetch(url)\n  if (!response.ok) {\n    throw new Error(\n      `Failed to fetch image input (${response.status} ${response.statusText}): ${url}`,\n    )\n  }\n  const blob = await response.blob()\n  const buffer = await blob.arrayBuffer()\n  return {\n    imageBytes: arrayBufferToBase64(buffer),\n    mimeType: part.source.mimeType || blob.type || 'image/png',\n  }\n}\n\n/**\n * Gemini Veo Video Generation Adapter\n *\n * Tree-shakeable adapter for Google Veo video generation. Veo runs as a\n * long-running operation: `createVideoJob` starts the operation via the\n * `:predictLongRunning` endpoint, `getVideoStatus` polls it, and\n * `getVideoUrl` extracts the generated video's URI once it completes.\n *\n * Image prompt parts are routed by `metadata.role`:\n * - `'start_frame'` (or the first un-roled image) → the input image the\n *   video starts from\n * - `'end_frame'` → `lastFrame` (the frame the video ends on)\n * - `'reference'` / `'character'` → `referenceImages` (asset references,\n *   Veo 3.1)\n *\n * Note: the returned video URI is served by the Gemini Files API and\n * requires the API key (`x-goog-api-key` header or `?key=` query\n * parameter) to download.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport class GeminiVideoAdapter<\n  TModel extends GeminiVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GeminiVideoProviderOptions,\n  GeminiVideoModelProviderOptionsByName,\n  GeminiVideoModelSizeByName,\n  GeminiVideoModelInputModalitiesByName,\n  GeminiVideoModelDurationByName\n> {\n  readonly name = 'gemini' as const\n\n  protected client: GoogleGenAI\n\n  constructor(config: GeminiVideoConfig, model: TModel) {\n    super({}, model)\n    this.client = createGeminiClient(config)\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      GeminiVideoProviderOptions,\n      GeminiVideoSize,\n      GeminiVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { prompt, size, duration, modelOptions, logger } = options\n\n    logger.request(\n      `activity=video.create provider=${this.name} model=${this.model} size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n      { provider: this.name, model: this.model },\n    )\n\n    try {\n      const resolved = resolveMediaPrompt(prompt)\n\n      if (resolved.videos.length > 0) {\n        throw new Error(\n          `${this.name}.createVideoJob does not support video prompt parts (model: ${this.model}).`,\n        )\n      }\n      if (resolved.audios.length > 0) {\n        throw new Error(\n          `${this.name}.createVideoJob does not support audio prompt parts (model: ${this.model}).`,\n        )\n      }\n\n      const { image, lastFrame, referenceImages } = await this.routeImageParts(\n        resolved.images,\n      )\n\n      const config: GenerateVideosConfig = {\n        ...modelOptions,\n        ...(size !== undefined && { aspectRatio: size }),\n        ...(duration !== undefined && { durationSeconds: duration }),\n        ...(lastFrame && { lastFrame }),\n        ...(referenceImages.length > 0 && { referenceImages }),\n      }\n\n      const operation = await this.client.models.generateVideos({\n        model: this.model,\n        prompt: resolved.text,\n        ...(image && { image }),\n        config,\n      })\n\n      if (!operation.name) {\n        throw new Error(\n          'Veo did not return an operation name for the video generation job.',\n        )\n      }\n\n      return { jobId: operation.name, model: this.model }\n    } catch (error) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error,\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Route image prompt parts onto Veo's request fields by `metadata.role`.\n   */\n  private async routeImageParts(\n    parts: Array<ImagePart<MediaInputMetadata>>,\n  ): Promise<{\n    image: Image | undefined\n    lastFrame: Image | undefined\n    referenceImages: Array<VideoGenerationReferenceImage>\n  }> {\n    let image: Image | undefined\n    let lastFrame: Image | undefined\n    const referenceImages: Array<VideoGenerationReferenceImage> = []\n\n    for (const part of parts) {\n      const role = part.metadata?.role\n      switch (role) {\n        case 'end_frame': {\n          if (lastFrame) {\n            throw new Error(\n              `${this.name}: Veo accepts at most one 'end_frame' image.`,\n            )\n          }\n          lastFrame = await imagePartToVeoImage(part)\n          break\n        }\n        case 'reference':\n        case 'character': {\n          referenceImages.push({\n            image: await imagePartToVeoImage(part),\n            referenceType: VideoGenerationReferenceType.ASSET,\n          })\n          break\n        }\n        case 'start_frame':\n        case undefined: {\n          if (image) {\n            throw new Error(\n              `${this.name}: Veo accepts at most one starting image; received multiple 'start_frame'/un-roled images. Use metadata.role ('end_frame', 'reference') to disambiguate the others.`,\n            )\n          }\n          image = await imagePartToVeoImage(part)\n          break\n        }\n        case 'mask':\n        case 'control':\n          throw new Error(\n            `${this.name}: unsupported image role \"${role}\" for Veo video generation.`,\n          )\n      }\n    }\n\n    return { image, lastFrame, referenceImages }\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    const operation = await this.getOperation(jobId)\n\n    if (!operation.done) {\n      return { jobId, status: 'processing' }\n    }\n\n    if (operation.error) {\n      return {\n        jobId,\n        status: 'failed',\n        error: operationErrorMessage(operation.error),\n      }\n    }\n\n    // The operation can finish \"successfully\" with every sample dropped by\n    // Responsible-AI filters — surface that as a failure instead of letting\n    // getVideoUrl() throw on an empty response.\n    const videos = operation.response?.generatedVideos ?? []\n    if (videos.length === 0) {\n      const reasons = operation.response?.raiMediaFilteredReasons\n      return {\n        jobId,\n        status: 'failed',\n        error: reasons?.length\n          ? `Video was filtered by Responsible-AI: ${reasons.join('; ')}`\n          : 'Veo returned no generated videos.',\n      }\n    }\n\n    return { jobId, status: 'completed' }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    const operation = await this.getOperation(jobId)\n\n    if (!operation.done) {\n      throw new Error(\n        `Video is not ready yet. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    if (operation.error) {\n      throw new Error(\n        `Video generation failed: ${operationErrorMessage(operation.error)}`,\n      )\n    }\n\n    const uri = operation.response?.generatedVideos?.[0]?.video?.uri\n    if (!uri) {\n      const reasons = operation.response?.raiMediaFilteredReasons\n      throw new Error(\n        reasons?.length\n          ? `Video was filtered by Responsible-AI: ${reasons.join('; ')}`\n          : `Video URL not found in operation response. Job ID: ${jobId}`,\n      )\n    }\n\n    return { jobId, url: uri }\n  }\n\n  override availableDurations(): DurationOptions<\n    GeminiVideoModelDurationByName[TModel]\n  > {\n    return getGeminiVideoDurationOptions(this.model)\n  }\n\n  override snapDuration(\n    seconds: number,\n  ): GeminiVideoModelDurationByName[TModel] | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n\n  /**\n   * Fetch the long-running operation by name. The SDK's\n   * `operations.getVideosOperation` needs a real `GenerateVideosOperation`\n   * instance (it calls `_fromAPIResponse` on it), so reconstruct one from\n   * the job ID rather than passing an object literal.\n   */\n  private async getOperation(jobId: string): Promise<GenerateVideosOperation> {\n    const operation = new GenerateVideosOperation()\n    operation.name = jobId\n    return await this.client.operations.getVideosOperation({ operation })\n  }\n}\n\n/**\n * Creates a Gemini video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'veo-3.1-generate-preview')\n * @param apiKey - Your Google API key\n * @param config - Optional additional configuration\n * @returns Configured Gemini video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGeminiVideo('veo-3.1-generate-preview', 'your-api-key');\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A beautiful sunset over the ocean',\n *   duration: adapter.snapDuration(7), // → 6\n * });\n * ```\n */\nexport function createGeminiVideo<TModel extends GeminiVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GeminiVideoConfig, 'apiKey'>,\n): GeminiVideoAdapter<TModel> {\n  return new GeminiVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Gemini video 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 * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'veo-3.1-generate-preview')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Gemini video 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 = geminiVideo('veo-3.1-generate-preview');\n *\n * // Create a video generation job\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A cat playing piano'\n * });\n *\n * // Poll for status\n * const status = await getVideoJobStatus({ adapter, jobId });\n * ```\n */\nexport function geminiVideo<TModel extends GeminiVideoModel>(\n  model: TModel,\n  config?: Omit<GeminiVideoConfig, 'apiKey'>,\n): GeminiVideoAdapter<TModel> {\n  const apiKey = getGeminiApiKeyFromEnv()\n  return createGeminiVideo(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/experimental/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * @experimental Gemini's Interactions API is in Beta per Google. Shapes and
- * behavior may change between minor releases of `@tanstack/ai-gemini`.
- */
-export { GeminiTextInteractionsAdapter, createGeminiTextInteractions, geminiTextInteractions, type GeminiTextInteractionsConfig, type GeminiTextInteractionsProviderOptions, type GeminiInteractionsStream, } from './text-interactions/adapter.js';
-export type { GeminiInteractionsCustomEvent, GeminiInteractionsCustomEventName, GeminiInteractionsCustomEventValue, } from './text-interactions/events.js';

package/dist/esm/experimental/index.js

@@ -1,7 +0,0 @@
-import { GeminiTextInteractionsAdapter, createGeminiTextInteractions, geminiTextInteractions } from "./text-interactions/adapter.js";
-export {
-  GeminiTextInteractionsAdapter,
-  createGeminiTextInteractions,
-  geminiTextInteractions
-};
-//# sourceMappingURL=index.js.map

package/dist/esm/experimental/index.js.map

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

package/dist/esm/experimental/text-interactions/adapter.d.ts

@@ -1,75 +0,0 @@
-import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
-import { GeminiChatModelToolCapabilitiesByName, GeminiModelInputModalitiesByName, GeminiModels } from '../../model-meta.js';
-import { Modality, StreamChunk, TextOptions } from '@tanstack/ai';
-import { GeminiInteractionsStream } from './events.js';
-import { ExternalTextInteractionsProviderOptions } from './provider-options.js';
-import { GeminiMessageMetadataByModality } from '../../message-types.js';
-import { GeminiClientConfig } from '../../utils.js';
-export type GeminiTextInteractionsConfig = GeminiClientConfig;
-export type GeminiTextInteractionsProviderOptions = ExternalTextInteractionsProviderOptions;
-/**
- * Resolve provider options for a specific model. The Interactions API's
- * request shape is the same across all chat-capable Gemini models — the
- * SDK doesn't expose a per-model param union — so this currently falls
- * through to the flat `GeminiTextInteractionsProviderOptions` for every
- * model. The alias exists for parity with `GeminiTextAdapter`, so a
- * per-model map can be slotted in later without changing the adapter
- * signature.
- */
-type ResolveProviderOptions = GeminiTextInteractionsProviderOptions;
-/**
- * Resolve input modalities for a specific model. Reuses the chat-model
- * modality map from `model-meta.ts`: passing a `document` content block
- * to a model that doesn't support it is a compile error, matching the
- * sibling `GeminiTextAdapter`.
- */
-type ResolveInputModalities<TModel extends string> = TModel extends keyof GeminiModelInputModalitiesByName ? GeminiModelInputModalitiesByName[TModel] : readonly ['text', 'image', 'audio', 'video', 'document'];
-/**
- * Resolve tool capabilities for a specific model. Reuses the chat-model
- * capability map: `google_maps` / `google_search_retrieval` /
- * `mcp_server` are rejected at runtime by `convertToolsToInteractionsFormat`,
- * but per-model gating happens here at compile time.
- */
-type ResolveToolCapabilities<TModel extends string> = TModel extends keyof GeminiChatModelToolCapabilitiesByName ? NonNullable<GeminiChatModelToolCapabilitiesByName[TModel]> : readonly [];
-/**
- * Tree-shakeable adapter for Gemini's stateful Interactions API. Routes
- * through `client.interactions.create` and surfaces the server-assigned
- * `interactionId` via an AG-UI `CUSTOM` event with
- * `name: 'gemini.interactionId'` emitted just before `RUN_FINISHED`; pass
- * that id back on the next turn via `modelOptions.previous_interaction_id`
- * to continue the conversation without resending history.
- *
- * The Interactions API does NOT support stateless multi-turn replay —
- * passing more than one message in `messages` without a
- * `previous_interaction_id` throws. For a chat UI that maintains local
- * history (e.g. `useChat`), see the "Wiring with `useChat`" section of
- * `docs/adapters/gemini.md` for the canonical client/server pattern.
- *
- * Supports user-defined function tools and the built-in tools
- * `google_search`, `code_execution`, `url_context`, `file_search`, and
- * `computer_use`. Built-in tool *activity* for the four search/exec
- * variants is surfaced via `CUSTOM` events
- * (`gemini.googleSearchCall` / `gemini.googleSearchResult` and the
- * corresponding per-tool variants) carrying the raw Interactions delta;
- * see {@link GeminiInteractionsCustomEvent}. `computer_use` is accepted
- * in the request but the Interactions API does not currently stream
- * per-delta CUSTOM events for it. `google_search_retrieval`,
- * `google_maps`, and `mcp_server` are not supported on this adapter.
- *
- * @experimental Interactions API is in Beta per Google; shapes may change.
- * @see https://ai.google.dev/gemini-api/docs/interactions
- */
-export declare class GeminiTextInteractionsAdapter<TModel extends GeminiModels, TProviderOptions extends Record<string, any> = ResolveProviderOptions, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, GeminiMessageMetadataByModality, TToolCapabilities> {
-    readonly kind: "text";
-    readonly name: "gemini-text-interactions";
-    private readonly client;
-    private readonly interactionIdByThread;
-    constructor(config: GeminiTextInteractionsConfig, model: TModel);
-    chatStream(options: TextOptions<GeminiTextInteractionsProviderOptions>): AsyncIterable<StreamChunk>;
-    structuredOutput(options: StructuredOutputOptions<GeminiTextInteractionsProviderOptions>): Promise<StructuredOutputResult<unknown>>;
-}
-/** @experimental Interactions API is in Beta. */
-export declare function createGeminiTextInteractions<TModel extends GeminiModels>(model: TModel, apiKey: string, config?: Omit<GeminiTextInteractionsConfig, 'apiKey'>): GeminiTextInteractionsAdapter<TModel, ResolveProviderOptions, ResolveInputModalities<TModel>, ResolveToolCapabilities<TModel>>;
-/** @experimental Interactions API is in Beta. */
-export declare function geminiTextInteractions<TModel extends GeminiModels>(model: TModel, config?: Omit<GeminiTextInteractionsConfig, 'apiKey'>): GeminiTextInteractionsAdapter<TModel, ResolveProviderOptions, ResolveInputModalities<TModel>, ResolveToolCapabilities<TModel>>;
-export type { GeminiInteractionsStream };