@ai-sdk/anthropic 3.0.0-beta.55 → 3.0.0-beta.57

package/dist/internal/index.mjs

@@ -566,7 +566,26 @@ var anthropicFilePartProviderOptions = z3.object({
   context: z3.string().optional()
 });
 var anthropicProviderOptions = z3.object({
+  /**
+   * Whether to send reasoning to the model.
+   *
+   * This allows you to deactivate reasoning inputs for models that do not support them.
+   */
   sendReasoning: z3.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.
+   * - `auto`: Use 'outputFormat' when supported, otherwise use 'jsonTool' (default).
+   */
+  structuredOutputMode: z3.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: z3.object({
     type: z3.union([z3.literal("enabled"), z3.literal("disabled")]),
     budgetTokens: z3.number().optional()
@@ -584,6 +603,9 @@ var anthropicProviderOptions = z3.object({
     type: z3.literal("ephemeral"),
     ttl: z3.union([z3.literal("5m"), z3.literal("1h")]).optional()
   }).optional(),
+  /**
+   * MCP servers to be utilized in this request.
+   */
   mcpServers: z3.array(
     z3.object({
       type: z3.literal("url"),
@@ -1896,7 +1918,7 @@ var AnthropicMessagesLanguageModel = class {
     providerOptions,
     stream
   }) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const warnings = [];
     if (frequencyPenalty != null) {
       warnings.push({
@@ -1940,27 +1962,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 parseProviderOptions2({
       provider: "anthropic",
       providerOptions,
       schema: anthropicProviderOptions
     });
+    const {
+      maxOutputTokens: maxOutputTokensForModel,
+      supportsStructuredOutput,
+      isKnownModel
+    } = getModelCapabilities(this.modelId);
+    const structureOutputMode = (_a = anthropicOptions == null ? void 0 : anthropicOptions.structuredOutputMode) != null ? _a : "auto";
+    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:
@@ -1975,6 +2003,13 @@ var AnthropicMessagesLanguageModel = class {
       ...isThinking && {
         thinking: { type: "enabled", budget_tokens: thinkingBudget }
       },
+      // structured output:
+      ...useStructuredOutput && (responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null && {
+        output_format: {
+          type: "json_schema",
+          schema: responseFormat.schema
+        }
+      },
       // mcp servers:
       ...(anthropicOptions == null ? void 0 : anthropicOptions.mcpServers) && anthropicOptions.mcpServers.length > 0 && {
         mcp_servers: anthropicOptions.mcpServers.map((server) => ({
@@ -1992,7 +2027,7 @@ var AnthropicMessagesLanguageModel = class {
       ...(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
@@ -2035,7 +2070,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",
@@ -2061,9 +2096,12 @@ var AnthropicMessagesLanguageModel = class {
         });
       }
     }
-    if (stream && ((_e = anthropicOptions == null ? void 0 : anthropicOptions.toolStreaming) != null ? _e : true)) {
+    if (stream && ((_f = anthropicOptions == null ? void 0 : anthropicOptions.toolStreaming) != null ? _f : true)) {
       betas.add("fine-grained-tool-streaming-2025-05-14");
     }
+    if (useStructuredOutput) {
+      betas.add("structured-outputs-2025-11-13");
+    }
     const {
       tools: anthropicTools2,
       toolChoice: anthropicToolChoice,
@@ -2940,17 +2978,49 @@ var AnthropicMessagesLanguageModel = class {
     };
   }
 };
-function getMaxOutputTokensForModel(modelId) {
-  if (modelId.includes("claude-sonnet-4-") || modelId.includes("claude-3-7-sonnet") || modelId.includes("claude-haiku-4-5")) {
-    return { maxOutputTokens: 64e3, knownModel: true };
+function getModelCapabilities(modelId) {
+  if (modelId.includes("claude-sonnet-4-5")) {
+    return {
+      maxOutputTokens: 64e3,
+      supportsStructuredOutput: true,
+      isKnownModel: true
+    };
+  } else if (modelId.includes("claude-opus-4-1")) {
+    return {
+      maxOutputTokens: 32e3,
+      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,
+      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
+    };
   }
 }