@tanstack/ai-gemini 0.18.1 → 0.18.3

package/dist/esm/tools/url-context-tool.js

@@ -0,0 +1,18 @@
+import { brandProviderTool } from "@tanstack/ai";
+function convertUrlContextToolToAdapterFormat(_tool) {
+  return {
+    urlContext: {}
+  };
+}
+function urlContextTool() {
+  return brandProviderTool({
+    name: "url_context",
+    description: "",
+    metadata: {}
+  });
+}
+export {
+  convertUrlContextToolToAdapterFormat,
+  urlContextTool
+};
+//# sourceMappingURL=url-context-tool.js.map

package/dist/esm/tools/url-context-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-context-tool.js","sources":["../../../src/tools/url-context-tool.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\n\nexport interface UrlContextToolConfig {}\n\n/** @deprecated Renamed to `UrlContextToolConfig`. Will be removed in a future release. */\nexport type UrlContextTool = UrlContextToolConfig\n\nexport type GeminiUrlContextTool = ProviderTool<'gemini', 'url_context'>\n\nexport function convertUrlContextToolToAdapterFormat(_tool: Tool) {\n  return {\n    urlContext: {},\n  }\n}\n\nexport function urlContextTool(): GeminiUrlContextTool {\n  return brandProviderTool<GeminiUrlContextTool>({\n    name: 'url_context',\n    description: '',\n    metadata: {},\n  })\n}\n"],"names":[],"mappings":";AAUO,SAAS,qCAAqC,OAAa;AAChE,SAAO;AAAA,IACL,YAAY,CAAA;AAAA,EAAC;AAEjB;AAEO,SAAS,iBAAuC;AACrD,SAAO,kBAAwC;AAAA,IAC7C,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU,CAAA;AAAA,EAAC,CACZ;AACH;"}

package/dist/esm/usage.d.ts

@@ -0,0 +1,67 @@
+import { TokenUsage } from '@tanstack/ai';
+import { GenerateContentResponseUsageMetadata, ModalityTokenCount } from '@google/genai';
+/**
+ * Flattened modality token counts for normalized usage reporting.
+ * Maps Gemini's ModalityTokenCount array to individual fields.
+ */
+export interface FlattenedModalityTokens {
+    /** Text tokens */
+    textTokens?: number;
+    /** Image tokens */
+    imageTokens?: number;
+    /** Audio tokens */
+    audioTokens?: number;
+    /** Video tokens */
+    videoTokens?: number;
+    /** Document tokens (e.g. PDF inputs) */
+    documentTokens?: number;
+}
+/**
+ * Flattens Gemini's ModalityTokenCount array into individual token fields.
+ * Extracts TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT modality counts into a
+ * normalized structure.
+ */
+export declare function flattenModalityTokenCounts(modalities?: Array<ModalityTokenCount>): FlattenedModalityTokens;
+/**
+ * Checks if a FlattenedModalityTokens object has any values set.
+ */
+export declare function hasModalityTokens(tokens: FlattenedModalityTokens): boolean;
+/**
+ * Gemini-specific provider usage details.
+ * These fields are unique to Gemini and placed in providerUsageDetails.
+ */
+export type GeminiProviderUsageDetails = {
+    /**
+     * The traffic type for this request.
+     * Can indicate whether request was handled by different service tiers.
+     */
+    trafficType?: string;
+    /**
+     * Number of tokens in the results from tool executions,
+     * which are provided back to the model as input.
+     */
+    toolUsePromptTokenCount?: number;
+    /**
+     * Detailed breakdown by modality of the token counts from
+     * the results of tool executions.
+     */
+    toolUsePromptTokensDetails?: Array<{
+        modality: string;
+        tokenCount: number;
+    }>;
+    /**
+     * Detailed breakdown of cache tokens by modality.
+     * More granular than the normalized cachedTokens field.
+     */
+    cacheTokensDetails?: Array<{
+        modality: string;
+        tokenCount: number;
+    }>;
+};
+/**
+ * Build normalized TokenUsage from Gemini's usageMetadata.
+ * Handles modality breakdowns and thinking tokens. Returns `undefined` when the
+ * provider reported no usage metadata, so callers omit the field rather than
+ * fabricating zeroed totals.
+ */
+export declare function buildGeminiUsage(usageMetadata: GenerateContentResponseUsageMetadata | undefined | null): TokenUsage<GeminiProviderUsageDetails> | undefined;

package/dist/esm/usage.js

@@ -0,0 +1,94 @@
+import { buildBaseUsage } from "@tanstack/ai";
+function flattenModalityTokenCounts(modalities) {
+  if (!modalities || modalities.length === 0) {
+    return {};
+  }
+  const result = {};
+  for (const item of modalities) {
+    if (!item.modality || item.tokenCount === void 0) {
+      continue;
+    }
+    const modality = item.modality.toUpperCase();
+    const count = item.tokenCount;
+    switch (modality) {
+      case "TEXT":
+        result.textTokens = (result.textTokens ?? 0) + count;
+        break;
+      case "IMAGE":
+        result.imageTokens = (result.imageTokens ?? 0) + count;
+        break;
+      case "AUDIO":
+        result.audioTokens = (result.audioTokens ?? 0) + count;
+        break;
+      case "VIDEO":
+        result.videoTokens = (result.videoTokens ?? 0) + count;
+        break;
+      case "DOCUMENT":
+        result.documentTokens = (result.documentTokens ?? 0) + count;
+        break;
+    }
+  }
+  return result;
+}
+function hasModalityTokens(tokens) {
+  return tokens.textTokens !== void 0 || tokens.imageTokens !== void 0 || tokens.audioTokens !== void 0 || tokens.videoTokens !== void 0 || tokens.documentTokens !== void 0;
+}
+function buildGeminiUsage(usageMetadata) {
+  if (!usageMetadata) return void 0;
+  const promptTokens = usageMetadata.promptTokenCount ?? 0;
+  const completionTokens = usageMetadata.candidatesTokenCount ?? 0;
+  const result = buildBaseUsage({
+    promptTokens,
+    completionTokens,
+    totalTokens: usageMetadata.totalTokenCount ?? promptTokens + completionTokens
+  });
+  const promptModalities = flattenModalityTokenCounts(
+    usageMetadata.promptTokensDetails
+  );
+  const cachedTokens = usageMetadata.cachedContentTokenCount;
+  const promptTokensDetails = {
+    ...hasModalityTokens(promptModalities) ? promptModalities : {},
+    ...cachedTokens !== void 0 && cachedTokens > 0 ? { cachedTokens } : {}
+  };
+  const completionModalities = flattenModalityTokenCounts(
+    usageMetadata.candidatesTokensDetails
+  );
+  const thoughtsTokens = usageMetadata.thoughtsTokenCount;
+  const completionTokensDetails = {
+    ...hasModalityTokens(completionModalities) ? completionModalities : {},
+    // Map thoughtsTokenCount to reasoningTokens for consistency with OpenAI
+    ...thoughtsTokens !== void 0 && thoughtsTokens > 0 ? { reasoningTokens: thoughtsTokens } : {}
+  };
+  const providerDetails = {
+    ...usageMetadata.trafficType ? { trafficType: usageMetadata.trafficType } : {},
+    ...usageMetadata.toolUsePromptTokenCount !== void 0 && usageMetadata.toolUsePromptTokenCount > 0 ? { toolUsePromptTokenCount: usageMetadata.toolUsePromptTokenCount } : {},
+    ...usageMetadata.toolUsePromptTokensDetails && usageMetadata.toolUsePromptTokensDetails.length > 0 ? {
+      toolUsePromptTokensDetails: usageMetadata.toolUsePromptTokensDetails.map((item) => ({
+        modality: item.modality || "UNKNOWN",
+        tokenCount: item.tokenCount ?? 0
+      }))
+    } : {},
+    ...usageMetadata.cacheTokensDetails && usageMetadata.cacheTokensDetails.length > 0 ? {
+      cacheTokensDetails: usageMetadata.cacheTokensDetails.map((item) => ({
+        modality: item.modality || "UNKNOWN",
+        tokenCount: item.tokenCount ?? 0
+      }))
+    } : {}
+  };
+  if (Object.keys(promptTokensDetails).length > 0) {
+    result.promptTokensDetails = promptTokensDetails;
+  }
+  if (Object.keys(providerDetails).length > 0) {
+    result.providerUsageDetails = providerDetails;
+  }
+  if (Object.keys(completionTokensDetails).length > 0) {
+    result.completionTokensDetails = completionTokensDetails;
+  }
+  return result;
+}
+export {
+  buildGeminiUsage,
+  flattenModalityTokenCounts,
+  hasModalityTokens
+};
+//# sourceMappingURL=usage.js.map

package/dist/esm/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sources":["../../src/usage.ts"],"sourcesContent":["import { buildBaseUsage } from '@tanstack/ai'\nimport type { TokenUsage } from '@tanstack/ai'\nimport type {\n  GenerateContentResponseUsageMetadata,\n  ModalityTokenCount,\n} from '@google/genai'\n\n/**\n * Flattened modality token counts for normalized usage reporting.\n * Maps Gemini's ModalityTokenCount array to individual fields.\n */\nexport interface FlattenedModalityTokens {\n  /** Text tokens */\n  textTokens?: number\n  /** Image tokens */\n  imageTokens?: number\n  /** Audio tokens */\n  audioTokens?: number\n  /** Video tokens */\n  videoTokens?: number\n  /** Document tokens (e.g. PDF inputs) */\n  documentTokens?: number\n}\n\n/**\n * Flattens Gemini's ModalityTokenCount array into individual token fields.\n * Extracts TEXT, IMAGE, AUDIO, VIDEO, DOCUMENT modality counts into a\n * normalized structure.\n */\nexport function flattenModalityTokenCounts(\n  modalities?: Array<ModalityTokenCount>,\n): FlattenedModalityTokens {\n  if (!modalities || modalities.length === 0) {\n    return {}\n  }\n\n  const result: FlattenedModalityTokens = {}\n\n  for (const item of modalities) {\n    if (!item.modality || item.tokenCount === undefined) {\n      continue\n    }\n\n    const modality = item.modality.toUpperCase()\n    const count = item.tokenCount\n\n    switch (modality) {\n      case 'TEXT':\n        result.textTokens = (result.textTokens ?? 0) + count\n        break\n      case 'IMAGE':\n        result.imageTokens = (result.imageTokens ?? 0) + count\n        break\n      case 'AUDIO':\n        result.audioTokens = (result.audioTokens ?? 0) + count\n        break\n      case 'VIDEO':\n        result.videoTokens = (result.videoTokens ?? 0) + count\n        break\n      case 'DOCUMENT':\n        result.documentTokens = (result.documentTokens ?? 0) + count\n        break\n    }\n  }\n\n  return result\n}\n\n/**\n * Checks if a FlattenedModalityTokens object has any values set.\n */\nexport function hasModalityTokens(tokens: FlattenedModalityTokens): boolean {\n  return (\n    tokens.textTokens !== undefined ||\n    tokens.imageTokens !== undefined ||\n    tokens.audioTokens !== undefined ||\n    tokens.videoTokens !== undefined ||\n    tokens.documentTokens !== undefined\n  )\n}\n\n/**\n * Gemini-specific provider usage details.\n * These fields are unique to Gemini and placed in providerUsageDetails.\n */\nexport type GeminiProviderUsageDetails = {\n  /**\n   * The traffic type for this request.\n   * Can indicate whether request was handled by different service tiers.\n   */\n  trafficType?: string\n  /**\n   * Number of tokens in the results from tool executions,\n   * which are provided back to the model as input.\n   */\n  toolUsePromptTokenCount?: number\n  /**\n   * Detailed breakdown by modality of the token counts from\n   * the results of tool executions.\n   */\n  toolUsePromptTokensDetails?: Array<{\n    modality: string\n    tokenCount: number\n  }>\n  /**\n   * Detailed breakdown of cache tokens by modality.\n   * More granular than the normalized cachedTokens field.\n   */\n  cacheTokensDetails?: Array<{\n    modality: string\n    tokenCount: number\n  }>\n}\n\n/**\n * Build normalized TokenUsage from Gemini's usageMetadata.\n * Handles modality breakdowns and thinking tokens. Returns `undefined` when the\n * provider reported no usage metadata, so callers omit the field rather than\n * fabricating zeroed totals.\n */\nexport function buildGeminiUsage(\n  usageMetadata: GenerateContentResponseUsageMetadata | undefined | null,\n): TokenUsage<GeminiProviderUsageDetails> | undefined {\n  if (!usageMetadata) return undefined\n\n  const promptTokens = usageMetadata.promptTokenCount ?? 0\n  const completionTokens = usageMetadata.candidatesTokenCount ?? 0\n\n  const result = buildBaseUsage<GeminiProviderUsageDetails>({\n    promptTokens: promptTokens,\n    completionTokens: completionTokens,\n    totalTokens:\n      usageMetadata.totalTokenCount ?? promptTokens + completionTokens,\n  })\n\n  // Add prompt token details\n  // Flatten modality breakdown for prompt\n  const promptModalities = flattenModalityTokenCounts(\n    usageMetadata.promptTokensDetails,\n  )\n  const cachedTokens = usageMetadata.cachedContentTokenCount\n\n  const promptTokensDetails = {\n    ...(hasModalityTokens(promptModalities) ? promptModalities : {}),\n    ...(cachedTokens !== undefined && cachedTokens > 0 ? { cachedTokens } : {}),\n  }\n\n  // Add completion token details\n  // Flatten modality breakdown for candidates (output)\n  const completionModalities = flattenModalityTokenCounts(\n    usageMetadata.candidatesTokensDetails,\n  )\n  const thoughtsTokens = usageMetadata.thoughtsTokenCount\n\n  const completionTokensDetails = {\n    ...(hasModalityTokens(completionModalities) ? completionModalities : {}),\n    // Map thoughtsTokenCount to reasoningTokens for consistency with OpenAI\n    ...(thoughtsTokens !== undefined && thoughtsTokens > 0\n      ? { reasoningTokens: thoughtsTokens }\n      : {}),\n  }\n\n  // Add provider-specific details\n  const providerDetails: GeminiProviderUsageDetails = {\n    ...(usageMetadata.trafficType\n      ? { trafficType: usageMetadata.trafficType }\n      : {}),\n    ...(usageMetadata.toolUsePromptTokenCount !== undefined &&\n    usageMetadata.toolUsePromptTokenCount > 0\n      ? { toolUsePromptTokenCount: usageMetadata.toolUsePromptTokenCount }\n      : {}),\n    ...(usageMetadata.toolUsePromptTokensDetails &&\n    usageMetadata.toolUsePromptTokensDetails.length > 0\n      ? {\n          toolUsePromptTokensDetails:\n            usageMetadata.toolUsePromptTokensDetails.map((item) => ({\n              modality: item.modality || 'UNKNOWN',\n              tokenCount: item.tokenCount ?? 0,\n            })),\n        }\n      : {}),\n    ...(usageMetadata.cacheTokensDetails &&\n    usageMetadata.cacheTokensDetails.length > 0\n      ? {\n          cacheTokensDetails: usageMetadata.cacheTokensDetails.map((item) => ({\n            modality: item.modality || 'UNKNOWN',\n            tokenCount: item.tokenCount ?? 0,\n          })),\n        }\n      : {}),\n  }\n\n  // Add prompt token details if available\n  if (Object.keys(promptTokensDetails).length > 0) {\n    result.promptTokensDetails = promptTokensDetails\n  }\n  // Add provider details if available\n  if (Object.keys(providerDetails).length > 0) {\n    result.providerUsageDetails = providerDetails\n  }\n  // Add completion token details if available\n  if (Object.keys(completionTokensDetails).length > 0) {\n    result.completionTokensDetails = completionTokensDetails\n  }\n\n  return result\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/client.d.ts

@@ -0,0 +1,17 @@
+import { GoogleGenAI, GoogleGenAIOptions } from '@google/genai';
+export interface GeminiClientConfig extends GoogleGenAIOptions {
+    apiKey: string;
+}
+/**
+ * Creates a Google Generative AI client instance
+ */
+export declare function createGeminiClient(config: GeminiClientConfig): GoogleGenAI;
+/**
+ * Gets Google API key from environment variables
+ * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found
+ */
+export declare function getGeminiApiKeyFromEnv(): string;
+/**
+ * Generates a unique ID with a prefix
+ */
+export declare function generateId(prefix: string): string;

package/dist/esm/utils/client.js

@@ -0,0 +1,30 @@
+import { GoogleGenAI } from "@google/genai";
+import { generateId as generateId$1, getApiKeyFromEnv } from "@tanstack/ai-utils";
+function createGeminiClient(config) {
+  return new GoogleGenAI({
+    ...config,
+    apiKey: config.apiKey
+  });
+}
+function getGeminiApiKeyFromEnv() {
+  try {
+    return getApiKeyFromEnv("GOOGLE_API_KEY");
+  } catch {
+    try {
+      return getApiKeyFromEnv("GEMINI_API_KEY");
+    } catch {
+      throw new Error(
+        "GOOGLE_API_KEY or GEMINI_API_KEY is not set. Please set one of these environment variables or pass the API key directly."
+      );
+    }
+  }
+}
+function generateId(prefix) {
+  return generateId$1(prefix);
+}
+export {
+  createGeminiClient,
+  generateId,
+  getGeminiApiKeyFromEnv
+};
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { GoogleGenAI } from '@google/genai'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { GoogleGenAIOptions } from '@google/genai'\n\nexport interface GeminiClientConfig extends GoogleGenAIOptions {\n  apiKey: string\n}\n\n/**\n * Creates a Google Generative AI client instance\n */\nexport function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {\n  return new GoogleGenAI({\n    ...config,\n    apiKey: config.apiKey,\n  })\n}\n\n/**\n * Gets Google API key from environment variables\n * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found\n */\nexport function getGeminiApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('GOOGLE_API_KEY')\n  } catch {\n    try {\n      return getApiKeyFromEnv('GEMINI_API_KEY')\n    } catch {\n      throw new Error(\n        'GOOGLE_API_KEY or GEMINI_API_KEY is not set. Please set one of these environment variables or pass the API key directly.',\n      )\n    }\n  }\n}\n\n/**\n * Generates a unique ID with a prefix\n */\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n"],"names":["_generateId"],"mappings":";;AAWO,SAAS,mBAAmB,QAAyC;AAC1E,SAAO,IAAI,YAAY;AAAA,IACrB,GAAG;AAAA,IACH,QAAQ,OAAO;AAAA,EAAA,CAChB;AACH;AAMO,SAAS,yBAAiC;AAC/C,MAAI;AACF,WAAO,iBAAiB,gBAAgB;AAAA,EAC1C,QAAQ;AACN,QAAI;AACF,aAAO,iBAAiB,gBAAgB;AAAA,IAC1C,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;AAKO,SAAS,WAAW,QAAwB;AACjD,SAAOA,aAAY,MAAM;AAC3B;"}

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

@@ -0,0 +1 @@
+export { createGeminiClient, generateId, getGeminiApiKeyFromEnv, type GeminiClientConfig, } from './client.js';

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.18.1",
+  "version": "0.18.3",
   "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -56,16 +56,16 @@
   "dependencies": {
     "@google/genai": "^2.8.0",
     "partial-json": "^0.1.7",
-    "@tanstack/ai-utils": "0.3.0"
+    "@tanstack/ai-utils": "0.3.1"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.36.0"
+    "@tanstack/ai": "^0.38.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.3.3",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.36.0"
+    "@tanstack/ai": "0.38.0"
   },
   "scripts": {
     "build": "vite build",