Merge branch 'main' into fix/openai-file-search-tool-optional-query-param

Author: callycodes

.changeset/gorgeous-pets-tie.md

@@ -0,0 +1,5 @@
+---
+'@ai-sdk/anthropic': patch
+---
+
+fix(provider/anthorpic): add cacheControl to AnthropicProviderOptions

.changeset/unlucky-clouds-agree.md

@@ -234,18 +234,13 @@ const result = await generateText({
 
 #### Longer cache TTL
 
-Anthropic also supports a longer 1-hour cache duration. At time of writing,
-[this is currently in beta](https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching#1-hour-cache-duration),
-so you must pass a `'anthropic-beta'` header set to `'extended-cache-ttl-2025-04-11'`.
+Anthropic also supports a longer 1-hour cache duration.
 
 Here's an example:
 
 ```ts
 const result = await generateText({
   model: anthropic('claude-3-5-haiku-latest'),
-  headers: {
-    'anthropic-beta': 'extended-cache-ttl-2025-04-11',
-  },
   messages: [
     {
       role: 'user',

content/providers/01-ai-sdk-providers/05-anthropic.mdx

@@ -0,0 +1,39 @@
+import { createOpenAI } from '@ai-sdk/openai';
+import { generateObject } from 'ai';
+import 'dotenv/config';
+import { z } from 'zod';
+
+async function main() {
+  let headers;
+  const openai = createOpenAI({
+    fetch: (url, init) => {
+      headers = {
+        ...init?.headers,
+        authorization: 'REDACTED',
+      };
+      return fetch(url, init);
+    },
+  });
+  const options = {
+    model: openai('gpt-4o-mini'),
+    schema: z.object({
+      recipe: z.object({
+        name: z.string(),
+        ingredients: z.array(
+          z.object({
+            name: z.string(),
+            amount: z.string(),
+          }),
+        ),
+        steps: z.array(z.string()),
+      }),
+    }),
+    prompt: 'Generate a lasagna recipe.',
+  };
+  await generateObject(options);
+
+  console.log('REQUEST HEADERS');
+  console.log(headers);
+}
+
+main().catch(console.error);

examples/ai-core/src/generate-object/openai-request-headers.ts

@@ -1,4 +1,4 @@
-import { anthropic } from '@ai-sdk/anthropic';
+import { anthropic, AnthropicProviderOptions } from '@ai-sdk/anthropic';
 import { generateText } from 'ai';
 import 'dotenv/config';
 import fs from 'node:fs';
@@ -27,7 +27,7 @@ async function main() {
             providerOptions: {
               anthropic: {
                 cacheControl: { type: 'ephemeral', ttl: '1h' },
-              },
+              } satisfies AnthropicProviderOptions,
             },
           },
           {

examples/ai-core/src/generate-text/anthropic-cache-control-beta-1h.ts

@@ -1,5 +1,27 @@
 # ai
 
+## 5.0.44
+
+### Patch Changes
+
+- Updated dependencies [f49f924]
+  - @ai-sdk/gateway@1.0.23
+
+## 5.0.43
+
+### Patch Changes
+
+- 0294b58: feat(ai): set `ai`, `@ai-sdk/provider-utils`, and runtime in `user-agent` header
+- Updated dependencies [0294b58]
+  - @ai-sdk/provider-utils@3.0.9
+  - @ai-sdk/gateway@1.0.22
+
+## 5.0.42
+
+### Patch Changes
+
+- de5c066: fix(ai): forwarded providerExecuted flag in validateUIMessages
+
 ## 5.0.41
 
 ### Patch Changes

packages/ai/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "5.0.41",
+  "version": "5.0.44",
   "description": "AI SDK by Vercel - The AI Toolkit for TypeScript and JavaScript",
   "license": "Apache-2.0",
   "sideEffects": false,

packages/ai/package.json

@@ -27,6 +27,7 @@ exports[`telemetry > should not record telemetry inputs / outputs when disabled
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.usage.tokens": 10,
       "operation.name": "ai.embedMany",
@@ -39,6 +40,7 @@ exports[`telemetry > should not record telemetry inputs / outputs when disabled
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.usage.tokens": 10,
       "operation.name": "ai.embedMany.doEmbed",
@@ -61,6 +63,7 @@ exports[`telemetry > should record telemetry data when enabled (multiple calls p
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",
@@ -86,6 +89,7 @@ exports[`telemetry > should record telemetry data when enabled (multiple calls p
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",
@@ -109,6 +113,7 @@ exports[`telemetry > should record telemetry data when enabled (multiple calls p
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",
@@ -138,6 +143,7 @@ exports[`telemetry > should record telemetry data when enabled (single call path
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",
@@ -164,6 +170,7 @@ exports[`telemetry > should record telemetry data when enabled (single call path
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embedMany.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",

packages/ai/src/embed/__snapshots__/embed-many.test.ts.snap

@@ -9,6 +9,7 @@ exports[`telemetry > should not record telemetry inputs / outputs when disabled
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.usage.tokens": 10,
       "operation.name": "ai.embed",
@@ -21,6 +22,7 @@ exports[`telemetry > should not record telemetry inputs / outputs when disabled
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embed.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.usage.tokens": 10,
       "operation.name": "ai.embed.doEmbed",
@@ -39,6 +41,7 @@ exports[`telemetry > should record telemetry data when enabled 1`] = `
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",
@@ -59,6 +62,7 @@ exports[`telemetry > should record telemetry data when enabled 1`] = `
       "ai.model.id": "mock-model-id",
       "ai.model.provider": "mock-provider",
       "ai.operationId": "ai.embed.doEmbed",
+      "ai.request.headers.user-agent": "ai/0.0.0-test",
       "ai.settings.maxRetries": 2,
       "ai.telemetry.functionId": "test-function-id",
       "ai.telemetry.metadata.test1": "value1",

packages/ai/src/embed/__snapshots__/embed.test.ts.snap

@@ -7,6 +7,12 @@ import { Embedding, EmbeddingModelUsage } from '../types';
 import { createResolvablePromise } from '../util/create-resolvable-promise';
 import { embedMany } from './embed-many';
 
+vi.mock('../version', () => {
+  return {
+    VERSION: '0.0.0-test',
+  };
+});
+
 const dummyEmbeddings = [
   [0.1, 0.2, 0.3],
   [0.4, 0.5, 0.6],
@@ -303,13 +309,16 @@ describe('options.headers', () => {
         doEmbed: async ({ headers }) => {
           assert.deepStrictEqual(headers, {
             'custom-request-header': 'request-header-value',
+            'user-agent': 'ai/0.0.0-test',
           });
 
           return { embeddings: dummyEmbeddings };
         },
       }),
       values: testValues,
-      headers: { 'custom-request-header': 'request-header-value' },
+      headers: {
+        'custom-request-header': 'request-header-value',
+      },
     });
 
     assert.deepStrictEqual(result.embeddings, dummyEmbeddings);
@@ -336,7 +345,9 @@ describe('options.providerOptions', () => {
 
     expect(model.doEmbed).toHaveBeenCalledWith({
       abortSignal: undefined,
-      headers: undefined,
+      headers: {
+        'user-agent': 'ai/0.0.0-test',
+      },
       providerOptions: {
         aProvider: { someKey: 'someValue' },
       },