@ai-sdk/anthropic 4.0.68 → 4.0.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "4.0.68",
+  "version": "4.0.69",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,14 +35,14 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.19",
-    "@ai-sdk/provider-utils": "5.0.51"
+    "@ai-sdk/provider": "4.0.20",
+    "@ai-sdk/provider-utils": "5.0.52"
   },
   "devDependencies": {
-    "@ai-sdk/test-server": "2.0.2",
+    "@ai-sdk/test-server": "2.0.3",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.23.0",
     "typescript": "5.8.3",
     "zod": "3.25.76"
   },
@@ -69,9 +69,9 @@
     "ai"
   ],
   "scripts": {
-    "build": "pnpm clean && tsup --tsconfig tsconfig.build.json",
-    "build:watch": "pnpm clean && tsup --watch --tsconfig tsconfig.build.json",
-    "clean": "del-cli dist docs *.tsbuildinfo",
+    "build": "pnpm clean && tsdown",
+    "build:watch": "pnpm clean && tsdown --watch",
+    "clean": "del-cli docs *.tsbuildinfo",
     "type-check": "tsc --build",
     "test": "pnpm test:node && pnpm test:edge",
     "test:update": "pnpm test:node -u",

package/src/anthropic-api.ts

@@ -60,6 +60,7 @@ export interface AnthropicAssistantMessage {
     | AnthropicTextContent
     | AnthropicThinkingContent
     | AnthropicRedactedThinkingContent
+    | AnthropicFallbackContent
     | AnthropicToolCallContent
     | AnthropicServerToolUseContent
     | AnthropicCodeExecutionToolResultContent
@@ -75,6 +76,18 @@ export interface AnthropicAssistantMessage {
   >;
 }
 
+export const anthropicFallbackContentSchema = z.object({
+  type: z.literal('fallback'),
+  from: z.object({ model: z.string() }),
+  to: z.object({ model: z.string() }),
+});
+
+export type AnthropicFallbackContent = InferSchema<
+  typeof anthropicFallbackContentSchema
+> & {
+  cache_control?: never;
+};
+
 export interface AnthropicCompactionContent {
   type: 'compaction';
   content: string;
@@ -1033,12 +1046,7 @@ export const anthropicResponseSchema = lazySchema(() =>
               }),
             ]),
           }),
-          // Server-side fallback marker. Parsed so the response validates, but
-          // dropped from the content output (the AI SDK has no model-hop
-          // primitive). The hop remains observable via usage.iterations.
-          z.object({
-            type: z.literal('fallback'),
-          }),
+          anthropicFallbackContentSchema,
         ]),
       ),
       stop_reason: z.string().nullish(),
@@ -1402,11 +1410,7 @@ export const anthropicChunkSchema = lazySchema(() =>
               }),
             ]),
           }),
-          // Server-side fallback marker; dropped from content output (see the
-          // response schema). The hop remains observable via usage.iterations.
-          z.object({
-            type: z.literal('fallback'),
-          }),
+          anthropicFallbackContentSchema,
         ]),
       }),
       z.object({

package/src/anthropic-batch.ts

@@ -1056,6 +1056,17 @@ function convertAnthropicBatchResponse(
         }
         break;
       case 'fallback':
+        content.push({
+          type: 'custom',
+          kind: 'anthropic.fallback',
+          providerMetadata: {
+            anthropic: {
+              type: 'fallback',
+              from: part.from,
+              to: part.to,
+            },
+          },
+        });
         break;
     }
   }

package/src/anthropic-language-model.ts

@@ -1721,10 +1721,18 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
           break;
         }
 
-        // Server-side fallback marker: the AI SDK has no content primitive for
-        // a model hop, so drop it. The hop is still observable via
-        // usage.iterations.
         case 'fallback': {
+          content.push({
+            type: 'custom',
+            kind: 'anthropic.fallback',
+            providerMetadata: {
+              anthropic: {
+                type: 'fallback',
+                from: part.from,
+                to: part.to,
+              },
+            },
+          });
           break;
         }
       }
@@ -1965,10 +1973,18 @@ export class AnthropicLanguageModel implements LanguageModelV4 {
               const part = value.content_block;
               const contentBlockType = part.type;
 
-              // Server-side fallback marker: the AI SDK has no content
-              // primitive for a model hop, so drop it. The hop is still
-              // observable via usage.iterations.
               if (contentBlockType === 'fallback') {
+                controller.enqueue({
+                  type: 'custom',
+                  kind: 'anthropic.fallback',
+                  providerMetadata: {
+                    anthropic: {
+                      type: 'fallback',
+                      from: part.from,
+                      to: part.to,
+                    },
+                  },
+                });
                 return;
               }
 

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

@@ -15,11 +15,13 @@ import {
   parseProviderOptions,
   resolveFullMediaType,
   resolveProviderReference,
+  safeValidateTypes,
   secureJsonParse,
   validateTypes,
   type ToolNameMapping,
 } from '@ai-sdk/provider-utils';
 import {
+  anthropicFallbackContentSchema,
   anthropicReasoningMetadataSchema,
   type AnthropicAssistantMessage,
   type AnthropicPrompt,
@@ -824,6 +826,33 @@ export async function convertToAnthropicPrompt({
                 break;
               }
 
+              case 'custom': {
+                if (part.kind !== 'anthropic.fallback') {
+                  break;
+                }
+
+                const fallbackMetadata = await safeValidateTypes({
+                  value: part.providerOptions?.anthropic,
+                  schema: anthropicFallbackContentSchema,
+                });
+
+                if (!fallbackMetadata.success) {
+                  warnings.push({
+                    type: 'other',
+                    message:
+                      'anthropic fallback metadata must include from.model and to.model',
+                  });
+                  break;
+                }
+
+                anthropicContent.push({
+                  type: 'fallback',
+                  from: fallbackMetadata.value.from,
+                  to: fallbackMetadata.value.to,
+                });
+                break;
+              }
+
               case 'tool-call': {
                 const caller = getAnthropicCaller(part.providerOptions);
 
@@ -1571,7 +1600,11 @@ function moveToolUseBlocksToEnd(
   }
 
   for (const part of content) {
-    if (part.type === 'thinking' || part.type === 'redacted_thinking') {
+    if (
+      part.type === 'thinking' ||
+      part.type === 'redacted_thinking' ||
+      part.type === 'fallback'
+    ) {
       flushSegment();
       result.push(part);
     } else {