@ai-sdk/google 4.0.0-canary.81 → 4.0.1

package/docs/15-google.mdx

@@ -1091,6 +1091,45 @@ Google realtime models may require provider-specific audio formats, depending
 on the model and modality. See [Realtime](/docs/ai-sdk-core/realtime) for the
 complete setup and tool calling pattern.
 
+### Live Translation
+
+Use `gemini-3.5-live-translate-preview` for low-latency speech-to-speech
+translation. Configure the target language with
+`providerOptions.google.translationConfig` in the realtime session config you
+use when creating the token:
+
+```ts
+import {
+  google,
+  type Experimental_GoogleRealtimeModelOptions as GoogleRealtimeModelOptions,
+} from '@ai-sdk/google';
+
+const token = await google.experimental_realtime.getToken({
+  model: 'gemini-3.5-live-translate-preview',
+  sessionConfig: {
+    outputModalities: ['audio'],
+    inputAudioTranscription: {},
+    outputAudioTranscription: {},
+    providerOptions: {
+      google: {
+        translationConfig: {
+          targetLanguageCode: 'pl',
+          echoTargetLanguage: true,
+        },
+      } satisfies GoogleRealtimeModelOptions,
+    },
+  },
+});
+```
+
+Set `targetLanguageCode` to a BCP-47 language code (defaults to `en`). When
+`echoTargetLanguage` is `true`, input audio already in the target language is
+echoed instead of producing silence.
+
+Gemini Live Translation accepts audio input and produces translated audio
+output. Text input, tools, and custom instructions are not supported by this
+model.
+
 ## Interactions API
 
 The [Gemini Interactions API](https://ai.google.dev/gemini-api/docs/interactions)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.0-canary.81",
+  "version": "4.0.1",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,15 +35,15 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.0-canary.18",
-    "@ai-sdk/provider-utils": "5.0.0-canary.48"
+    "@ai-sdk/provider": "4.0.0",
+    "@ai-sdk/provider-utils": "5.0.0"
   },
   "devDependencies": {
     "@types/node": "22.19.19",
     "tsup": "^8.5.1",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0-canary.6",
+    "@ai-sdk/test-server": "2.0.0",
     "@vercel/ai-tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/src/google-files.ts

@@ -214,12 +214,10 @@ const googleFileResponseSchema = lazySchema(() =>
 
 const googleFilesUploadOptionsSchema = lazySchema(() =>
   zodSchema(
-    z
-      .object({
-        displayName: z.string().nullish(),
-        pollIntervalMs: z.number().positive().nullish(),
-        pollTimeoutMs: z.number().positive().nullish(),
-      })
-      .passthrough(),
+    z.looseObject({
+      displayName: z.string().nullish(),
+      pollIntervalMs: z.number().positive().nullish(),
+      pollTimeoutMs: z.number().positive().nullish(),
+    }),
   ),
 );

package/src/google-video-model-options.ts

@@ -21,23 +21,21 @@ export type GoogleVideoModelOptions = {
 
 export const googleVideoModelOptionsSchema = lazySchema(() =>
   zodSchema(
-    z
-      .object({
-        pollIntervalMs: z.number().positive().nullish(),
-        pollTimeoutMs: z.number().positive().nullish(),
-        personGeneration: z
-          .enum(['dont_allow', 'allow_adult', 'allow_all'])
-          .nullish(),
-        negativePrompt: z.string().nullish(),
-        referenceImages: z
-          .array(
-            z.object({
-              bytesBase64Encoded: z.string().nullish(),
-              gcsUri: z.string().nullish(),
-            }),
-          )
-          .nullish(),
-      })
-      .passthrough(),
+    z.looseObject({
+      pollIntervalMs: z.number().positive().nullish(),
+      pollTimeoutMs: z.number().positive().nullish(),
+      personGeneration: z
+        .enum(['dont_allow', 'allow_adult', 'allow_all'])
+        .nullish(),
+      negativePrompt: z.string().nullish(),
+      referenceImages: z
+        .array(
+          z.object({
+            bytesBase64Encoded: z.string().nullish(),
+            gcsUri: z.string().nullish(),
+          }),
+        )
+        .nullish(),
+    }),
   ),
 );

package/src/index.ts

@@ -56,5 +56,9 @@ export type {
 } from './google-provider';
 export { GoogleRealtimeModel as Experimental_GoogleRealtimeModel } from './realtime/google-realtime-model';
 export type { GoogleRealtimeModelConfig as Experimental_GoogleRealtimeModelConfig } from './realtime/google-realtime-model';
+export type {
+  GoogleRealtimeModelId as Experimental_GoogleRealtimeModelId,
+  GoogleRealtimeModelOptions as Experimental_GoogleRealtimeModelOptions,
+} from './realtime/google-realtime-model-options';
 
 export { VERSION } from './version';

package/src/interactions/google-interactions-language-model.ts

@@ -459,7 +459,6 @@ export class GoogleInteractionsLanguageModel implements LanguageModelV4 {
     const url = `${this.config.baseURL}/interactions`;
 
     const mergedHeaders = combineHeaders(
-      INTERACTIONS_API_REVISION_HEADER,
       this.config.headers ? await resolve(this.config.headers) : undefined,
       options.headers,
     );
@@ -588,7 +587,6 @@ export class GoogleInteractionsLanguageModel implements LanguageModelV4 {
     const url = `${this.config.baseURL}/interactions`;
 
     const mergedHeaders = combineHeaders(
-      INTERACTIONS_API_REVISION_HEADER,
       this.config.headers ? await resolve(this.config.headers) : undefined,
       options.headers,
     );
@@ -757,15 +755,6 @@ export class GoogleInteractionsLanguageModel implements LanguageModelV4 {
   }
 }
 
-/*
- * Pins the Interactions API revision the SDK targets. Sent on every request
- * the model issues so model-id calls, agent calls, polling, SSE reconnects,
- * and cancellation all hit the same schema.
- */
-const INTERACTIONS_API_REVISION_HEADER: Record<string, string> = {
-  'Api-Revision': '2026-05-20',
-};
-
 function pruneUndefined<T extends Record<string, unknown>>(obj: T): T {
   const result: Record<string, unknown> = {};
   for (const [key, value] of Object.entries(obj)) {

package/src/realtime/google-realtime-event-mapper.ts

@@ -8,6 +8,7 @@ import type {
 import { safeParseJSON } from '@ai-sdk/provider-utils';
 import { convertJSONSchemaToOpenAPISchema } from '../convert-json-schema-to-openapi-schema';
 import { getModelPath } from '../get-model-path';
+import type { GoogleRealtimeModelOptions } from './google-realtime-model-options';
 
 type GoogleRealtimeFunctionCall = {
   id: string;
@@ -38,6 +39,10 @@ type GoogleRealtimeWireEvent = {
   inputTranscription?: { text?: string };
 };
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+
 /**
  * Stateful event mapper for Google's Gemini Live API.
  *
@@ -268,6 +273,12 @@ export class GoogleRealtimeEventMapper {
         };
 
       case 'input-audio-commit':
+        return {
+          realtimeInput: {
+            audioStreamEnd: true,
+          },
+        };
+
       case 'input-audio-clear':
       case 'response-create':
       case 'response-cancel':
@@ -375,8 +386,25 @@ export function buildGoogleSessionConfig(
     setup.outputAudioTranscription = {};
   }
 
-  if (config?.providerOptions != null) {
-    Object.assign(setup, config.providerOptions);
+  if (config?.providerOptions == null) {
+    return setup;
+  }
+
+  const { google, ...providerOptions } = config.providerOptions;
+  Object.assign(setup, providerOptions);
+
+  const googleOptions = isRecord(google)
+    ? (google as GoogleRealtimeModelOptions)
+    : undefined;
+
+  if (googleOptions?.translationConfig != null) {
+    const target = isRecord(setup.generationConfig)
+      ? setup.generationConfig
+      : generationConfig;
+    setup.generationConfig = {
+      ...target,
+      translationConfig: googleOptions.translationConfig,
+    };
   }
 
   return setup;

package/src/realtime/google-realtime-model-options.ts

@@ -1,3 +1,23 @@
 export type GoogleRealtimeModelId = string;
 
-export type GoogleRealtimeModelOptions = Record<string, never>;
+export type GoogleRealtimeModelOptions = {
+  /**
+   * Gemini Live Translation configuration.
+   *
+   * Required for `gemini-3.5-live-translate-preview` when translating speech
+   * to a target language.
+   */
+  translationConfig?: {
+    /**
+     * BCP-47 language code of the language to translate into.
+     * Defaults to `en` in the Gemini API.
+     */
+    targetLanguageCode?: string;
+
+    /**
+     * Whether input audio already in the target language should be echoed
+     * instead of producing silence.
+     */
+    echoTargetLanguage?: boolean;
+  };
+};

package/src/realtime/index.ts

@@ -1,2 +1,6 @@
 export { GoogleRealtimeModel as Experimental_GoogleRealtimeModel } from './google-realtime-model';
 export type { GoogleRealtimeModelConfig as Experimental_GoogleRealtimeModelConfig } from './google-realtime-model';
+export type {
+  GoogleRealtimeModelId as Experimental_GoogleRealtimeModelId,
+  GoogleRealtimeModelOptions as Experimental_GoogleRealtimeModelOptions,
+} from './google-realtime-model-options';

package/src/tool/file-search.ts

@@ -6,35 +6,33 @@ import {
 import { z } from 'zod/v4';
 
 /** Tool to retrieve knowledge from the File Search Stores. */
-const fileSearchArgsBaseSchema = z
-  .object({
-    /** The names of the file_search_stores to retrieve from.
-     *  Example: `fileSearchStores/my-file-search-store-123`
-     */
-    fileSearchStoreNames: z
-      .array(z.string())
-      .describe(
-        'The names of the file_search_stores to retrieve from. Example: `fileSearchStores/my-file-search-store-123`',
-      ),
-    /** The number of file search retrieval chunks to retrieve. */
-    topK: z
-      .number()
-      .int()
-      .positive()
-      .describe('The number of file search retrieval chunks to retrieve.')
-      .optional(),
+const fileSearchArgsBaseSchema = z.looseObject({
+  /** The names of the file_search_stores to retrieve from.
+   *  Example: `fileSearchStores/my-file-search-store-123`
+   */
+  fileSearchStoreNames: z
+    .array(z.string())
+    .describe(
+      'The names of the file_search_stores to retrieve from. Example: `fileSearchStores/my-file-search-store-123`',
+    ),
+  /** The number of file search retrieval chunks to retrieve. */
+  topK: z
+    .number()
+    .int()
+    .positive()
+    .describe('The number of file search retrieval chunks to retrieve.')
+    .optional(),
 
-    /** Metadata filter to apply to the file search retrieval documents.
-     *  See https://google.aip.dev/160 for the syntax of the filter expression.
-     */
-    metadataFilter: z
-      .string()
-      .describe(
-        'Metadata filter to apply to the file search retrieval documents. See https://google.aip.dev/160 for the syntax of the filter expression.',
-      )
-      .optional(),
-  })
-  .passthrough();
+  /** Metadata filter to apply to the file search retrieval documents.
+   *  See https://google.aip.dev/160 for the syntax of the filter expression.
+   */
+  metadataFilter: z
+    .string()
+    .describe(
+      'Metadata filter to apply to the file search retrieval documents. See https://google.aip.dev/160 for the syntax of the filter expression.',
+    )
+    .optional(),
+});
 
 export type GoogleFileSearchToolArgs = z.infer<typeof fileSearchArgsBaseSchema>;
 

package/src/tool/google-search.ts

@@ -9,23 +9,21 @@ import { z } from 'zod/v4';
 // https://ai.google.dev/api/generate-content#GroundingSupport
 // https://cloud.google.com/vertex-ai/generative-ai/docs/grounding/grounding-with-google-search
 
-export const googleSearchToolArgsBaseSchema = z
-  .object({
-    searchTypes: z
-      .object({
-        webSearch: z.object({}).optional(),
-        imageSearch: z.object({}).optional(),
-      })
-      .optional(),
+export const googleSearchToolArgsBaseSchema = z.looseObject({
+  searchTypes: z
+    .object({
+      webSearch: z.object({}).optional(),
+      imageSearch: z.object({}).optional(),
+    })
+    .optional(),
 
-    timeRangeFilter: z
-      .object({
-        startTime: z.string(),
-        endTime: z.string(),
-      })
-      .optional(),
-  })
-  .passthrough();
+  timeRangeFilter: z
+    .object({
+      startTime: z.string(),
+      endTime: z.string(),
+    })
+    .optional(),
+});
 
 export type GoogleSearchToolArgs = z.infer<
   typeof googleSearchToolArgsBaseSchema