@ai-sdk/anthropic 4.0.71 → 4.0.72

package/docs/05-anthropic.mdx

@@ -93,6 +93,34 @@ Anthropic language models can also be used in the `streamText` function
 and support structured data generation with [`Output`](/docs/reference/ai-sdk-core/output)
 (see [AI SDK Core](/docs/ai-sdk-core)).
 
+### Message-start events
+
+During streaming, each Anthropic `message_start` event is exposed as an
+`anthropic.message_start` custom stream part containing the message ID, model,
+and raw initial token usage. No provider option is required.
+
+```ts
+import { anthropic } from '@ai-sdk/anthropic';
+import { streamText } from 'ai';
+
+const result = streamText({
+  model: anthropic('claude-haiku-4-5'),
+  prompt: 'Say hi in one word.',
+});
+
+for await (const part of result.fullStream) {
+  if (part.type === 'custom' && part.kind === 'anthropic.message_start') {
+    console.log(part.providerMetadata?.anthropic);
+  }
+}
+```
+
+Initial usage may be incomplete; use `result.usage` for final token counts.
+Like other custom parts, this event is included in response content and forwarded
+to UI message streams. It is ignored when replaying conversation history to Anthropic.
+
+### Provider options
+
 The following optional provider options are available for Anthropic models:
 
 - `disableParallelToolUse` _boolean_
@@ -1334,7 +1362,7 @@ together with an older `computer_*` tool.
 
 Parameters:
 
-- `action` ('key' | 'type' | 'mouse_move' | 'left_click' | 'left_click_drag' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot' | 'cursor_position' | 'zoom'): The action to perform. The `zoom` action is only available with `computer_20251124`.
+- `action` ('key' | 'type' | 'mouse_move' | 'left_click' | 'left_click_drag' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot' | 'cursor_position' | 'zoom'): The action to perform. For versioned computer tools, the `zoom` action is only available with `computer_20251124`. It is also available with `computerToolset_20260801`, where it is enabled by default.
 - `coordinate` (number[], optional): Required for `mouse_move` and `left_click_drag` actions. Specifies the (x, y) coordinates.
 - `text` (string, optional): Required for `type` and `key` actions.
 - `region` (number[], optional): Required for `zoom` action. Specifies `[x1, y1, x2, y2]` coordinates for the area to inspect.
@@ -2231,18 +2259,18 @@ and the `mediaType` should be set to `'application/pdf'`.
   any available provider model ID as a string if needed.
 </Note>
 
-## Evaluation Models
+## Decision Models
 
-Create an experimental evaluation model with `anthropic.evaluationModel(modelId)`.
+Create an experimental decision model with `anthropic.decisionModel(modelId)`.
 It uses the Messages API's structured-output support for Choice, Score, and Boolean
 questions. `claude-haiku-4-5-20251001` is one supported model.
 
 ```ts
 import { anthropic } from '@ai-sdk/anthropic';
-import { experimental_evaluate } from 'ai';
+import { experimental_decide } from 'ai';
 
-const { answers } = await experimental_evaluate({
-  model: anthropic.evaluationModel('claude-haiku-4-5-20251001'),
+const { answers } = await experimental_decide({
+  model: anthropic.decisionModel('claude-haiku-4-5-20251001'),
   state: 'I was charged twice.',
   questions: {
     requestsRefund: {
@@ -2272,10 +2300,10 @@ It respects
 `structuredOutputMode`. Supported models use native structured output by default;
 `jsonTool` uses the existing Messages JSON-tool fallback. Usage, warnings,
 response information, and provider metadata are preserved.
-See [Evaluation](/docs/ai-sdk-core/evaluation).
+See [Decisions](/docs/ai-sdk-core/decisions).
 
-Evaluation models can also be accessed through `customProvider` aliases or
-`createProviderRegistry().evaluationModel('provider:model')`. Direct string IDs
+Decision models can also be accessed through `customProvider` aliases or
+`createProviderRegistry().decisionModel('provider:model')`. Direct string IDs
 use Gateway by default, or an explicitly configured default provider with an
-`evaluationModel` method. See
-[model aliases and registries](/docs/ai-sdk-core/evaluation#model-aliases-and-registries).
+`decisionModel` method. See
+[model aliases and registries](/docs/ai-sdk-core/decisions#model-aliases-and-registries).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "4.0.71",
+  "version": "4.0.72",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,8 +35,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.21",
-    "@ai-sdk/provider-utils": "5.0.53"
+    "@ai-sdk/provider": "4.0.22",
+    "@ai-sdk/provider-utils": "5.0.54"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.3",

package/src/anthropic-language-model.ts

@@ -2906,6 +2906,18 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
                 modelId: value.message.model ?? undefined,
               });
 
+              controller.enqueue({
+                type: 'custom',
+                kind: 'anthropic.message_start',
+                providerMetadata: {
+                  anthropic: {
+                    id: value.message.id ?? null,
+                    model: value.message.model ?? null,
+                    usage: rawUsage,
+                  },
+                },
+              });
+
               // Programmatic tool calling: process pre-populated content blocks
               // (for deferred tool calls, content may be in message_start)
               if (value.message.content != null) {

package/src/anthropic-provider.ts

@@ -2,7 +2,7 @@ import {
   InvalidArgumentError,
   NoSuchModelError,
   type Experimental_BatchV4 as BatchV4,
-  type Experimental_EvaluationModelV4 as EvaluationModelV4,
+  type Experimental_DecisionModelV4 as DecisionModelV4,
   type FilesV4,
   type LanguageModelV4,
   type ProviderV4,
@@ -17,7 +17,7 @@ import {
   withUserAgentSuffix,
   type FetchFunction,
 } from '@ai-sdk/provider-utils';
-import { Experimental_EvaluationLanguageModel as EvaluationLanguageModel } from '@ai-sdk/provider-utils/experimental-evaluation';
+import { Experimental_DecisionLanguageModel as DecisionLanguageModel } from '@ai-sdk/provider-utils/experimental-decision';
 import { AnthropicFiles } from './anthropic-files';
 import { AnthropicLanguageModel } from './anthropic-language-model';
 import { AnthropicBatch } from './anthropic-batch';
@@ -54,8 +54,12 @@ export interface AnthropicProvider extends ProviderV4 {
 
   messages(modelId: AnthropicModelId): LanguageModelV4;
 
-  /** Creates an experimental Choice/Score/Boolean evaluation model using Messages. */
-  evaluationModel(modelId: AnthropicModelId): EvaluationModelV4;
+  /** Creates an experimental Choice/Score/Boolean decision model using Messages. */
+  decisionModel(modelId: AnthropicModelId): DecisionModelV4;
+  /** @deprecated Use `decisionModel` instead. */
+  evaluationModel(modelId: AnthropicModelId): DecisionModelV4 & {
+    doEvaluate: DecisionModelV4['doDecide'];
+  };
 
   experimental_batch(): BatchV4<{ text: AnthropicModelId }>;
 
@@ -209,11 +213,13 @@ export function createAnthropic(
   provider.languageModel = createChatModel;
   provider.chat = createChatModel;
   provider.messages = createChatModel;
-  provider.evaluationModel = (modelId: AnthropicModelId) =>
-    new EvaluationLanguageModel({
+  provider.decisionModel = (modelId: AnthropicModelId) =>
+    new DecisionLanguageModel({
       model: createChatModel(modelId),
-      provider: `${providerName.replace(/\.messages$/, '')}.evaluation`,
+      provider: `${providerName.replace(/\.messages$/, '')}.decision`,
     });
+  provider.evaluationModel =
+    provider.decisionModel as AnthropicProvider['evaluationModel'];
   provider.experimental_batch = createBatch;
 
   provider.embeddingModel = (modelId: string) => {

package/src/convert-to-anthropic-prompt.ts

@@ -845,6 +845,7 @@ export async function convertToAnthropicPrompt({
                   break;
                 }
 
+                betas.add('server-side-fallback-2026-06-01');
                 anthropicContent.push({
                   type: 'fallback',
                   from: fallbackMetadata.value.from,