@ai-sdk/anthropic 3.0.137 → 3.0.138

package/docs/05-anthropic.mdx

@@ -152,7 +152,7 @@ The following optional provider options are available for Anthropic models:
 
   - `"outputFormat"`: Use the `output_format` parameter to specify the structured output format.
   - `"jsonTool"`: Use a special `"json"` tool to specify the structured output format.
-  - `"auto"`: Use `"outputFormat"` when supported, otherwise fall back to `"jsonTool"` (default).
+  - `"auto"`: Use `"outputFormat"` when the model and schema support it, otherwise fall back to `"jsonTool"` (default). Schemas with recursive references, open objects, or more than ten optional properties use the JSON-tool fallback to avoid rejected requests or lost data.
 
 - `metadata` _object_
 
@@ -205,6 +205,12 @@ Likewise, a `required` or named `toolChoice` is downgraded to
 `auto` with a warning; instruct the model to use the tool in your prompt and
 verify that a tool call was made.
 
+The JSON-tool fallback limits which application tools are available:
+`toolChoice: 'none'` sends only the internal JSON response tool, and a named tool
+choice sends only that application tool alongside the JSON response tool. The
+fallback can produce a JSON response without calling the named application tool;
+verify the selected call if your application requires it.
+
 When the JSON tool cannot be forced (for example with manual thinking) and the
 model answers in text without calling it, the text of its final answer is
 returned. Text before a tool call is still dropped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "3.0.137",
+  "version": "3.0.138",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "3.0.19",
-    "@ai-sdk/provider-utils": "4.0.63"
+    "@ai-sdk/provider-utils": "4.0.64"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/anthropic-messages-language-model.ts

@@ -449,6 +449,11 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
       (this.config.supportsNativeStructuredOutput ?? true) &&
       modelSupportsStructuredOutput;
 
+    const supportsResponseSchema =
+      responseFormat?.type !== 'json' ||
+      responseFormat.schema == null ||
+      supportsNativeStructuredOutputSchema(responseFormat.schema);
+
     const supportsStrictTools =
       (this.config.supportsStrictTools ?? true) &&
       modelSupportsStructuredOutput;
@@ -457,7 +462,9 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
       anthropicOptions?.structuredOutputMode ?? 'auto';
     let useStructuredOutput =
       structureOutputMode === 'outputFormat' ||
-      (structureOutputMode === 'auto' && supportsStructuredOutput);
+      (structureOutputMode === 'auto' &&
+        supportsStructuredOutput &&
+        supportsResponseSchema);
 
     // The JSON response tool relies on forced tool use, which some models
     // reject (e.g. Opus 5.5, Fable 5.1). Fall back to native structured
@@ -1007,7 +1014,15 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
     } = await prepareTools(
       jsonResponseTool != null
         ? {
-            tools: [...(tools ?? []), jsonResponseTool],
+            tools: [
+              ...(tools ?? []).filter(
+                tool =>
+                  toolChoice?.type !== 'none' &&
+                  (toolChoice?.type !== 'tool' ||
+                    tool.name === toolChoice.toolName),
+              ),
+              jsonResponseTool,
+            ],
             toolChoice: { type: 'required' },
             disableParallelToolUse: true,
             cacheControlValidator,

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

@@ -8,6 +8,7 @@ import {
   type SharedV3ProviderMetadata,
 } from '@ai-sdk/provider';
 import {
+  stringifyWithBigIntAndCycles,
   convertBase64ToUint8Array,
   convertToBase64,
   parseProviderOptions,
@@ -585,7 +586,7 @@ export async function convertToAnthropicMessagesPrompt({
                   case 'json':
                   case 'error-json':
                   default:
-                    contentValue = JSON.stringify(output.value);
+                    contentValue = stringifyWithBigIntAndCycles(output.value);
                     break;
                 }
 
@@ -899,7 +900,7 @@ export async function convertToAnthropicMessagesPrompt({
                   type: 'tool_use',
                   id: part.toolCallId,
                   name: part.toolName,
-                  input: part.input,
+                  input: parseToolCallInput(part.input),
                   ...(caller && { caller }),
                   cache_control: cacheControl,
                 });
@@ -1564,3 +1565,21 @@ function getAnthropicCaller(
 
   return caller?.type === 'direct' ? { type: 'direct' } : undefined;
 }
+
+function parseToolCallInput(input: unknown): unknown {
+  if (typeof input === 'string') {
+    try {
+      const parsed = secureJsonParse(input);
+      if (
+        typeof parsed === 'object' &&
+        parsed !== null &&
+        !Array.isArray(parsed)
+      ) {
+        return parsed;
+      }
+    } catch {
+      // Preserve malformed input for replay.
+    }
+  }
+  return input;
+}

package/src/internal/index.ts

@@ -6,3 +6,4 @@ export { anthropicTools } from '../anthropic-tools';
 export type { AnthropicMessagesModelId } from '../anthropic-messages-options';
 export { prepareTools } from '../anthropic-prepare-tools';
 export { sanitizeJsonSchema } from '../sanitize-json-schema';
+export { supportsNativeStructuredOutputSchema } from '../supports-native-structured-output-schema';