@ai-sdk/anthropic 2.0.47 → 2.0.49

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/anthropic
 
+## 2.0.49
+
+### Patch Changes
+
+- dcdfeb7: Retain user-supplied betas.
+
+## 2.0.48
+
+### Patch Changes
+
+- f2c6cbd: feat(provider/anthropic): Anthropic-native structured outputs
+
 ## 2.0.47
 
 ### Patch Changes

package/dist/index.d.mts

@@ -45,6 +45,11 @@ interface AnthropicMessageMetadata {
 type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | (string & {});
 declare const anthropicProviderOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
+    structuredOutputMode: z.ZodOptional<z.ZodEnum<{
+        outputFormat: "outputFormat";
+        jsonTool: "jsonTool";
+        auto: "auto";
+    }>>;
     thinking: z.ZodOptional<z.ZodObject<{
         type: z.ZodUnion<readonly [z.ZodLiteral<"enabled">, z.ZodLiteral<"disabled">]>;
         budgetTokens: z.ZodOptional<z.ZodNumber>;

package/dist/index.d.ts

@@ -45,6 +45,11 @@ interface AnthropicMessageMetadata {
 type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | (string & {});
 declare const anthropicProviderOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
+    structuredOutputMode: z.ZodOptional<z.ZodEnum<{
+        outputFormat: "outputFormat";
+        jsonTool: "jsonTool";
+        auto: "auto";
+    }>>;
     thinking: z.ZodOptional<z.ZodObject<{
         type: z.ZodUnion<readonly [z.ZodLiteral<"enabled">, z.ZodLiteral<"disabled">]>;
         budgetTokens: z.ZodOptional<z.ZodNumber>;

package/dist/index.js

@@ -31,7 +31,7 @@ var import_provider4 = require("@ai-sdk/provider");
 var import_provider_utils20 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "2.0.47" : "0.0.0-test";
+var VERSION = true ? "2.0.49" : "0.0.0-test";
 
 // src/anthropic-messages-language-model.ts
 var import_provider3 = require("@ai-sdk/provider");
@@ -552,6 +552,20 @@ var anthropicFilePartProviderOptions = import_v43.z.object({
 });
 var anthropicProviderOptions = import_v43.z.object({
   sendReasoning: import_v43.z.boolean().optional(),
+  /**
+   * Determines how structured outputs are generated.
+   *
+   * - `outputFormat`: Use the `output_format` parameter to specify the structured output format.
+   * - `jsonTool`: Use a special 'json' tool to specify the structured output format (default).
+   * - `auto`: Use 'outputFormat' when supported, otherwise use 'jsonTool'.
+   */
+  structuredOutputMode: import_v43.z.enum(["outputFormat", "jsonTool", "auto"]).optional(),
+  /**
+   * Configuration for enabling Claude's extended thinking.
+   *
+   * When enabled, responses include thinking content blocks showing Claude's thinking process before the final answer.
+   * Requires a minimum budget of 1,024 tokens and counts towards the `max_tokens` limit.
+   */
   thinking: import_v43.z.object({
     type: import_v43.z.union([import_v43.z.literal("enabled"), import_v43.z.literal("disabled")]),
     budgetTokens: import_v43.z.number().optional()
@@ -1755,6 +1769,7 @@ var AnthropicMessagesLanguageModel = class {
     return (_c = (_b = (_a = this.config).supportedUrls) == null ? void 0 : _b.call(_a)) != null ? _c : {};
   }
   async getArgs({
+    userSuppliedBetas,
     prompt,
     maxOutputTokens,
     temperature,
@@ -1769,7 +1784,7 @@ var AnthropicMessagesLanguageModel = class {
     toolChoice,
     providerOptions
   }) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const warnings = [];
     if (frequencyPenalty != null) {
       warnings.push({
@@ -1819,27 +1834,33 @@ var AnthropicMessagesLanguageModel = class {
         });
       }
     }
-    const jsonResponseTool = (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null ? {
-      type: "function",
-      name: "json",
-      description: "Respond with a JSON object.",
-      inputSchema: responseFormat.schema
-    } : void 0;
     const anthropicOptions = await (0, import_provider_utils11.parseProviderOptions)({
       provider: "anthropic",
       providerOptions,
       schema: anthropicProviderOptions
     });
+    const {
+      maxOutputTokens: maxOutputTokensForModel,
+      supportsStructuredOutput,
+      isKnownModel
+    } = getModelCapabilities(this.modelId);
+    const structureOutputMode = (_a = anthropicOptions == null ? void 0 : anthropicOptions.structuredOutputMode) != null ? _a : "jsonTool";
+    const useStructuredOutput = structureOutputMode === "outputFormat" || structureOutputMode === "auto" && supportsStructuredOutput;
+    const jsonResponseTool = (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null && !useStructuredOutput ? {
+      type: "function",
+      name: "json",
+      description: "Respond with a JSON object.",
+      inputSchema: responseFormat.schema
+    } : void 0;
     const cacheControlValidator = new CacheControlValidator();
     const { prompt: messagesPrompt, betas } = await convertToAnthropicMessagesPrompt({
       prompt,
-      sendReasoning: (_a = anthropicOptions == null ? void 0 : anthropicOptions.sendReasoning) != null ? _a : true,
+      sendReasoning: (_b = anthropicOptions == null ? void 0 : anthropicOptions.sendReasoning) != null ? _b : true,
       warnings,
       cacheControlValidator
     });
-    const isThinking = ((_b = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _b.type) === "enabled";
-    const thinkingBudget = (_c = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _c.budgetTokens;
-    const { maxOutputTokens: maxOutputTokensForModel, knownModel } = getMaxOutputTokensForModel(this.modelId);
+    const isThinking = ((_c = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _c.type) === "enabled";
+    const thinkingBudget = (_d = anthropicOptions == null ? void 0 : anthropicOptions.thinking) == null ? void 0 : _d.budgetTokens;
     const maxTokens = maxOutputTokens != null ? maxOutputTokens : maxOutputTokensForModel;
     const baseArgs = {
       // model id:
@@ -1857,11 +1878,18 @@ var AnthropicMessagesLanguageModel = class {
       ...(anthropicOptions == null ? void 0 : anthropicOptions.effort) && {
         output_config: { effort: anthropicOptions.effort }
       },
+      // structured output:
+      ...useStructuredOutput && (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null && {
+        output_format: {
+          type: "json_schema",
+          schema: responseFormat.schema
+        }
+      },
       // container with agent skills:
       ...(anthropicOptions == null ? void 0 : anthropicOptions.container) && {
         container: {
           id: anthropicOptions.container.id,
-          skills: (_d = anthropicOptions.container.skills) == null ? void 0 : _d.map((skill) => ({
+          skills: (_e = anthropicOptions.container.skills) == null ? void 0 : _e.map((skill) => ({
             type: skill.type,
             skill_id: skill.skillId,
             version: skill.version
@@ -1904,7 +1932,7 @@ var AnthropicMessagesLanguageModel = class {
       }
       baseArgs.max_tokens = maxTokens + thinkingBudget;
     }
-    if (knownModel && baseArgs.max_tokens > maxOutputTokensForModel) {
+    if (isKnownModel && baseArgs.max_tokens > maxOutputTokensForModel) {
       if (maxOutputTokens != null) {
         warnings.push({
           type: "unsupported-setting",
@@ -1930,6 +1958,9 @@ var AnthropicMessagesLanguageModel = class {
     if (anthropicOptions == null ? void 0 : anthropicOptions.effort) {
       betas.add("effort-2025-11-24");
     }
+    if (useStructuredOutput) {
+      betas.add("structured-outputs-2025-11-13");
+    }
     const {
       tools: anthropicTools2,
       toolChoice: anthropicToolChoice,
@@ -1956,7 +1987,7 @@ var AnthropicMessagesLanguageModel = class {
         tool_choice: anthropicToolChoice
       },
       warnings: [...warnings, ...toolWarnings, ...cacheWarnings],
-      betas: /* @__PURE__ */ new Set([...betas, ...toolsBetas]),
+      betas: /* @__PURE__ */ new Set([...betas, ...toolsBetas, ...userSuppliedBetas]),
       usesJsonResponseTool: jsonResponseTool != null
     };
   }
@@ -1966,8 +1997,20 @@ var AnthropicMessagesLanguageModel = class {
   }) {
     return (0, import_provider_utils11.combineHeaders)(
       await (0, import_provider_utils11.resolve)(this.config.headers),
-      betas.size > 0 ? { "anthropic-beta": Array.from(betas).join(",") } : {},
-      headers
+      headers,
+      betas.size > 0 ? { "anthropic-beta": Array.from(betas).join(",") } : {}
+    );
+  }
+  async getBetasFromHeaders(requestHeaders) {
+    var _a, _b;
+    const configHeaders = await (0, import_provider_utils11.resolve)(this.config.headers);
+    const configBetaHeader = (_a = configHeaders["anthropic-beta"]) != null ? _a : "";
+    const requestBetaHeader = (_b = requestHeaders == null ? void 0 : requestHeaders["anthropic-beta"]) != null ? _b : "";
+    return new Set(
+      [
+        ...configBetaHeader.toLowerCase().split(","),
+        ...requestBetaHeader.toLowerCase().split(",")
+      ].map((beta) => beta.trim()).filter((beta) => beta !== "")
     );
   }
   buildRequestUrl(isStreaming) {
@@ -2003,7 +2046,10 @@ var AnthropicMessagesLanguageModel = class {
   }
   async doGenerate(options) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
-    const { args, warnings, betas, usesJsonResponseTool } = await this.getArgs(options);
+    const { args, warnings, betas, usesJsonResponseTool } = await this.getArgs({
+      ...options,
+      userSuppliedBetas: await this.getBetasFromHeaders(options.headers)
+    });
     const citationDocuments = this.extractCitationDocuments(options.prompt);
     const {
       responseHeaders,
@@ -2268,7 +2314,10 @@ var AnthropicMessagesLanguageModel = class {
     };
   }
   async doStream(options) {
-    const { args, warnings, betas, usesJsonResponseTool } = await this.getArgs(options);
+    const { args, warnings, betas, usesJsonResponseTool } = await this.getArgs({
+      ...options,
+      userSuppliedBetas: await this.getBetasFromHeaders(options.headers)
+    });
     const citationDocuments = this.extractCitationDocuments(options.prompt);
     const body = { ...args, stream: true };
     const { responseHeaders, value: response } = await (0, import_provider_utils11.postJsonToApi)({
@@ -2732,27 +2781,49 @@ var AnthropicMessagesLanguageModel = class {
     };
   }
 };
-function getMaxOutputTokensForModel(modelId) {
+function getModelCapabilities(modelId) {
   if (modelId.includes("claude-sonnet-4-5") || modelId.includes("claude-opus-4-5")) {
     return {
       maxOutputTokens: 64e3,
-      knownModel: true
+      supportsStructuredOutput: true,
+      isKnownModel: true
     };
   } else if (modelId.includes("claude-opus-4-1")) {
     return {
       maxOutputTokens: 32e3,
-      knownModel: true
+      supportsStructuredOutput: true,
+      isKnownModel: true
     };
   } else if (modelId.includes("claude-sonnet-4-") || modelId.includes("claude-3-7-sonnet") || modelId.includes("claude-haiku-4-5")) {
-    return { maxOutputTokens: 64e3, knownModel: true };
+    return {
+      maxOutputTokens: 64e3,
+      supportsStructuredOutput: false,
+      isKnownModel: true
+    };
   } else if (modelId.includes("claude-opus-4-")) {
-    return { maxOutputTokens: 32e3, knownModel: true };
+    return {
+      maxOutputTokens: 32e3,
+      supportsStructuredOutput: false,
+      isKnownModel: true
+    };
   } else if (modelId.includes("claude-3-5-haiku")) {
-    return { maxOutputTokens: 8192, knownModel: true };
+    return {
+      maxOutputTokens: 8192,
+      supportsStructuredOutput: false,
+      isKnownModel: true
+    };
   } else if (modelId.includes("claude-3-haiku")) {
-    return { maxOutputTokens: 4096, knownModel: true };
+    return {
+      maxOutputTokens: 4096,
+      supportsStructuredOutput: false,
+      isKnownModel: true
+    };
   } else {
-    return { maxOutputTokens: 4096, knownModel: false };
+    return {
+      maxOutputTokens: 4096,
+      supportsStructuredOutput: false,
+      isKnownModel: false
+    };
   }
 }