fix(google): make urlMetadata optional in urlContextMetadata schema (#12701)

sleitor · dancer · web-flow · commit 89d8b457de44 · 2026-03-04T23:11:06.000Z
## Summary The Gemini API can return `urlContextMetadata: {}` (empty object without `urlMetadata` key) when Google Search grounding is used but no URLs were fetched via the URL context tool. The Zod schema expected `urlMetadata` to always be an array, causing an `AI_APICallError` on an otherwise valid 200 response. ## Changes - **`google-generative-ai-language-model.ts`**: Make `urlMetadata` field `.nullish()` in the `getUrlContextMetadataSchema()` schema. - **Tests**: Added test case for empty object without `urlMetadata` key. All urlContextMetadata-related tests pass. Fixes #12698 --------- Co-authored-by: Dmitrii Troitskii <jsleitor@gmail.com> Co-authored-by: dancer <josh@afterima.ge> Co-authored-by: dancer <144584931+dancer@users.noreply.github.com>
diff --git a/.changeset/healthy-feet-wonder.md b/.changeset/healthy-feet-wonder.md
@@ -0,0 +1,5 @@
+---
+'@ai-sdk/google': patch
+---
+
+fix(google): make urlMetadata optional in urlContextMetadata schema
diff --git a/packages/google/src/google-generative-ai-language-model.test.ts b/packages/google/src/google-generative-ai-language-model.test.ts
@@ -330,6 +330,13 @@ describe('urlContextMetadata', () => {
     const result = urlContextMetadataSchema.safeParse(output);
     expect(result.success).toBe(true);
   });
+
+  it('validates empty object without urlMetadata key', () => {
+    const output = {};
+
+    const result = urlContextMetadataSchema.safeParse(output);
+    expect(result.success).toBe(true);
+  });
 });
 
 describe('doGenerate', () => {
diff --git a/packages/google/src/google-generative-ai-language-model.ts b/packages/google/src/google-generative-ai-language-model.ts
@@ -974,12 +974,14 @@ const usageSchema = z.object({
 // https://ai.google.dev/api/generate-content#UrlRetrievalMetadata
 export const getUrlContextMetadataSchema = () =>
   z.object({
-    urlMetadata: z.array(
-      z.object({
-        retrievedUrl: z.string(),
-        urlRetrievalStatus: z.string(),
-      }),
-    ),
+    urlMetadata: z
+      .array(
+        z.object({
+          retrievedUrl: z.string(),
+          urlRetrievalStatus: z.string(),
+        }),
+      )
+      .nullish(),
   });
 
 const responseSchema = lazySchema(() =>

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@ai-sdk/google': patch
 +---
++
 +fix(google): make urlMetadata optional in urlContextMetadata schema