@ai-sdk/anthropic 4.0.92 → 4.0.93

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-sdk/anthropic
 
+## 4.0.93
+
+### Patch Changes
+
+- dcd2f8d: Introduce a model entry contract with named capability sections and request configuration. Consolidate the OpenAI and Anthropic model catalogs so existing request behavior and generated capability documentation use the same source of truth. Catalogs also declare the provider options each provider accepts and which models support them.
+- Updated dependencies [7716e18]
+- Updated dependencies [5c247e9]
+- Updated dependencies [dcd2f8d]
+  - @ai-sdk/provider-utils@5.0.72
+  - @ai-sdk/provider@4.0.35
+
 ## 4.0.92
 
 ### Patch Changes

package/dist/index.js

@@ -64,6 +64,330 @@ var AnthropicFiles = class {
 	}
 };
 //#endregion
+//#region src/anthropic-model-catalog.ts
+/**
+* Options accepted under `providerOptions.anthropic`. The `satisfies` check
+* keeps this list in sync with the option schema.
+*/
+const anthropicProviderOptions = { language: {
+	sendReasoning: { description: "Whether to send reasoning to the model." },
+	structuredOutputMode: { description: "How structured outputs are generated." },
+	thinking: { description: "Extended thinking configuration." },
+	disableParallelToolUse: { description: "Use at most one tool per response." },
+	cacheControl: { description: "Prompt cache control settings." },
+	metadata: { description: "Request metadata, such as a user ID." },
+	mcpServers: { description: "MCP servers to use in the request." },
+	container: { description: "Container and Agent Skills configuration." },
+	toolStreaming: { description: "Fine-grained streaming of tool inputs and outputs." },
+	effort: { description: "Effort spent on thinking, text, and tool calls." },
+	taskBudget: { description: "Advisory token budget for an agentic task." },
+	speed: { description: "Fast mode for faster output token speeds." },
+	serviceTier: { description: "Service tier for the request." },
+	inferenceGeo: { description: "Where model inference runs." },
+	fallbacks: { description: "Server-side fallback models." },
+	anthropicBeta: { description: "Additional beta features to enable." },
+	safeguards: { description: "Server-side safeguards to run." },
+	compaction: { description: "On-demand conversation summary." },
+	contextManagement: { description: "Server-side context management." }
+} };
+const legacyClaude = defineRuntime({});
+const currentClaude = defineRuntime({
+	maxOutputTokens: 128e3,
+	nativeStructuredOutput: true,
+	adaptiveThinking: true
+});
+const currentClaudeWithoutSampling = defineRuntime({
+	...currentClaude,
+	samplingParameters: false,
+	xhighEffort: true
+});
+function defineRuntime(overrides) {
+	return {
+		maxOutputTokens: 4096,
+		nativeStructuredOutput: false,
+		adaptiveThinking: false,
+		samplingParameters: true,
+		xhighEffort: false,
+		thinkingCanBeDisabledAboveHighEffort: true,
+		thinkingCanBeDisabled: true,
+		budgetThinking: true,
+		forcedToolUse: true,
+		betweenToolsThinking: false,
+		knownModel: true,
+		...overrides
+	};
+}
+const runtimeRules = [
+	{
+		matches: (modelId) => modelId.includes("claude-sonnet-5-5"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabledAboveHighEffort: false,
+			thinkingCanBeDisabled: false,
+			budgetThinking: false,
+			forcedToolUse: false,
+			betweenToolsThinking: true
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-opus-5-5"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabledAboveHighEffort: false,
+			thinkingCanBeDisabled: false,
+			budgetThinking: false,
+			forcedToolUse: false
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-haiku-5-5"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabledAboveHighEffort: false,
+			budgetThinking: false
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-opus-5"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabledAboveHighEffort: false
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-fable-5-1"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabled: false,
+			budgetThinking: false,
+			forcedToolUse: false
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-fable-5"),
+		definition: defineRuntime({
+			...currentClaudeWithoutSampling,
+			thinkingCanBeDisabled: false,
+			budgetThinking: false
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-sonnet-5"),
+		definition: currentClaudeWithoutSampling
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-sonnet-4-6") || modelId.includes("claude-opus-4-6"),
+		definition: currentClaude
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-sonnet-4-5") || modelId.includes("claude-opus-4-5") || modelId.includes("claude-haiku-4-5"),
+		definition: defineRuntime({
+			maxOutputTokens: 64e3,
+			nativeStructuredOutput: true
+		})
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-opus-4-1"),
+		definition: defineRuntime({
+			maxOutputTokens: 32e3,
+			nativeStructuredOutput: true
+		})
+	},
+	{
+		matches: (modelId) => /claude-sonnet-4(?:-|@)/.test(modelId),
+		definition: defineRuntime({ maxOutputTokens: 64e3 })
+	},
+	{
+		matches: (modelId) => /claude-opus-4(?:-|@)/.test(modelId),
+		definition: defineRuntime({ maxOutputTokens: 32e3 })
+	},
+	{
+		matches: (modelId) => modelId.includes("claude-3-haiku"),
+		definition: legacyClaude
+	},
+	{
+		matches: (modelId) => /claude-(?:instant(?:-|$)|v?2(?=$|[-.:])|3(?=$|[-.]))/.test(modelId),
+		definition: defineRuntime({ knownModel: false })
+	}
+];
+const anthropicModelCatalog = Object.fromEntries(Object.entries({
+	"claude-opus-5-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-opus-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-sonnet-5-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-sonnet-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-haiku-5-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-fable-5-1": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-fable-5": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-opus-4-8": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-opus-4-7": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-opus-4-6": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-sonnet-4-6": {
+		toolSearch: true,
+		compaction: true,
+		effort: true
+	},
+	"claude-opus-4-5": {
+		toolSearch: true,
+		compaction: false,
+		effort: true
+	},
+	"claude-haiku-4-5": {
+		toolSearch: true,
+		compaction: false,
+		effort: false
+	},
+	"claude-sonnet-4-5": {
+		toolSearch: true,
+		compaction: false,
+		effort: false
+	},
+	"claude-opus-4-1": {
+		toolSearch: false,
+		compaction: false,
+		effort: false
+	},
+	"claude-opus-4-0": {
+		toolSearch: false,
+		compaction: false,
+		effort: false
+	},
+	"claude-sonnet-4-0": {
+		toolSearch: false,
+		compaction: false,
+		effort: false
+	}
+}).map(([modelId, capabilities]) => [modelId, createAnthropicLanguageModelEntry(modelId, capabilities)]));
+function getAnthropicLanguageModelEntry(modelId) {
+	return Object.prototype.hasOwnProperty.call(anthropicModelCatalog, modelId) ? anthropicModelCatalog[modelId] : createAnthropicLanguageModelEntry(modelId);
+}
+function createAnthropicLanguageModelEntry(modelId, documented) {
+	const runtime = resolveRuntimeDefinition(modelId);
+	const declared = documented != null;
+	const samplingSupport = runtime.samplingParameters ? true : { condition: "Only supported when thinking is disabled." };
+	const reasoningSupport = runtime.adaptiveThinking || runtime.budgetThinking;
+	return {
+		capabilities: { language: {
+			inputs: {
+				image: declared ? true : "unknown",
+				audio: declared ? false : "unknown"
+			},
+			objectGeneration: declared ? true : "unknown",
+			tools: {
+				usage: declared ? true : "unknown",
+				streaming: declared ? true : "unknown",
+				forcedChoice: runtime.forcedToolUse,
+				computerUse: declared ? true : "unknown",
+				webSearch: declared ? true : "unknown",
+				toolSearch: documented?.toolSearch ?? "unknown"
+			},
+			reasoning: {
+				support: reasoningSupport,
+				efforts: runtime.xhighEffort ? [
+					"low",
+					"medium",
+					"high",
+					"xhigh",
+					"max"
+				] : void 0,
+				adaptive: runtime.adaptiveThinking,
+				budget: runtime.budgetThinking,
+				canDisable: runtime.thinkingCanBeDisabled,
+				canDisableAboveHighEffort: runtime.thinkingCanBeDisabledAboveHighEffort,
+				supportsXhighEffort: runtime.xhighEffort,
+				betweenTools: runtime.betweenToolsThinking
+			},
+			sampling: {
+				temperature: samplingSupport,
+				topP: samplingSupport,
+				topK: samplingSupport,
+				logprobs: false
+			},
+			structuredOutput: { native: runtime.nativeStructuredOutput },
+			compaction: documented?.compaction ?? "unknown"
+		} },
+		providerOptions: { language: declareProviderOptions(anthropicProviderOptions.language, declared ? true : "unknown", {
+			thinking: reasoningSupport,
+			effort: documented?.effort ?? "unknown",
+			speed: declared ? modelId === "claude-opus-4-6" : "unknown",
+			taskBudget: modelId === "claude-opus-4-7" ? true : "unknown"
+		}) },
+		requestConfig: { language: {
+			maxOutputTokens: runtime.maxOutputTokens,
+			knownModel: runtime.knownModel
+		} }
+	};
+}
+/** Applies one default support value to every option, except the listed ones. */
+function declareProviderOptions(definitions, support, exceptions) {
+	return Object.fromEntries(Object.keys(definitions).map((option) => [option, exceptions[option] ?? support]));
+}
+function resolveRuntimeDefinition(modelId) {
+	const rule = runtimeRules.find((rule) => rule.matches(modelId));
+	if (rule != null) return rule.definition;
+	return modelId.includes("claude-") ? defineRuntime({
+		...currentClaudeWithoutSampling,
+		thinkingCanBeDisabledAboveHighEffort: false,
+		knownModel: false
+	}) : defineRuntime({ knownModel: false });
+}
+/** Compatibility projection for the provider's existing request preparation. */
+function getAnthropicModelCapabilities(modelId) {
+	const { capabilities: { language }, requestConfig: { language: requestConfig } } = getAnthropicLanguageModelEntry(modelId);
+	return {
+		maxOutputTokens: requestConfig.maxOutputTokens,
+		supportsStructuredOutput: language.structuredOutput.native,
+		supportsAdaptiveThinking: language.reasoning.adaptive,
+		rejectsSamplingParameters: language.sampling.temperature !== true,
+		supportsXhighEffort: language.reasoning.supportsXhighEffort,
+		rejectsThinkingDisabledAboveHighEffort: !language.reasoning.canDisableAboveHighEffort,
+		rejectsThinkingDisabled: !language.reasoning.canDisable,
+		rejectsBudgetThinking: !language.reasoning.budget,
+		rejectsForcedToolUse: !language.tools.forcedChoice,
+		supportsBetweenToolsThinking: language.reasoning.betweenTools,
+		isKnownModel: requestConfig.knownModel
+	};
+}
+//#endregion
 //#region src/map-anthropic-citation.ts
 function mapAnthropicCitation(citation, documents) {
 	if (citation.type === "web_search_result_location" || citation.type === "search_result_location") {
@@ -3616,7 +3940,7 @@ var AnthropicLanguageModel = class AnthropicLanguageModel {
 		}) : null;
 		const usedCustomProviderKey = customProviderOptions != null;
 		const anthropicOptions = Object.assign({}, canonicalOptions ?? {}, customProviderOptions ?? {});
-		const { maxOutputTokens: maxOutputTokensForModel, supportsStructuredOutput: modelSupportsStructuredOutput, supportsAdaptiveThinking, rejectsSamplingParameters, supportsXhighEffort, rejectsThinkingDisabledAboveHighEffort, rejectsThinkingDisabled, rejectsBudgetThinking, rejectsForcedToolUse, supportsBetweenToolsThinking, isKnownModel } = getModelCapabilities(modelId);
+		const { maxOutputTokens: maxOutputTokensForModel, supportsStructuredOutput: modelSupportsStructuredOutput, supportsAdaptiveThinking, rejectsSamplingParameters, supportsXhighEffort, rejectsThinkingDisabledAboveHighEffort, rejectsThinkingDisabled, rejectsBudgetThinking, rejectsForcedToolUse, supportsBetweenToolsThinking, isKnownModel } = getAnthropicModelCapabilities(modelId);
 		if (!isKnownModel && maxOutputTokens == null) warnings.push({
 			type: "compatibility",
 			feature: "maxOutputTokens",
@@ -5306,222 +5630,6 @@ var AnthropicLanguageModel = class AnthropicLanguageModel {
 		};
 	}
 };
-/**
-* Returns the capabilities of a Claude model that are used for defaults and feature selection.
-*
-* @see https://docs.claude.com/en/docs/about-claude/models/overview#model-comparison-table
-* @see https://platform.claude.com/docs/en/build-with-claude/structured-outputs
-*/
-function getModelCapabilities(modelId) {
-	if (modelId.includes("claude-sonnet-5-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: true,
-		rejectsThinkingDisabled: true,
-		rejectsBudgetThinking: true,
-		rejectsForcedToolUse: true,
-		supportsBetweenToolsThinking: true,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-opus-5-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: true,
-		rejectsThinkingDisabled: true,
-		rejectsBudgetThinking: true,
-		rejectsForcedToolUse: true,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-haiku-5-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: true,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: true,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-opus-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: true,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-fable-5-1")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: true,
-		rejectsBudgetThinking: true,
-		rejectsForcedToolUse: true,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-fable-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: true,
-		rejectsBudgetThinking: true,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-opus-4-8") || modelId.includes("claude-opus-4-7") || modelId.includes("claude-sonnet-5")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-sonnet-4-6") || modelId.includes("claude-opus-4-6")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-sonnet-4-5") || modelId.includes("claude-opus-4-5") || modelId.includes("claude-haiku-4-5")) return {
-		maxOutputTokens: 64e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-opus-4-1")) return {
-		maxOutputTokens: 32e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (/claude-sonnet-4(?:-|@)/.test(modelId)) return {
-		maxOutputTokens: 64e3,
-		supportsStructuredOutput: false,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (/claude-opus-4(?:-|@)/.test(modelId)) return {
-		maxOutputTokens: 32e3,
-		supportsStructuredOutput: false,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (modelId.includes("claude-3-haiku")) return {
-		maxOutputTokens: 4096,
-		supportsStructuredOutput: false,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: true
-	};
-	else if (/claude-(?:instant(?:-|$)|v?2(?=$|[-.:])|3(?=$|[-.]))/.test(modelId)) return {
-		maxOutputTokens: 4096,
-		supportsStructuredOutput: false,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: false
-	};
-	else if (modelId.includes("claude-")) return {
-		maxOutputTokens: 128e3,
-		supportsStructuredOutput: true,
-		supportsAdaptiveThinking: true,
-		rejectsSamplingParameters: true,
-		supportsXhighEffort: true,
-		rejectsThinkingDisabledAboveHighEffort: true,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: false
-	};
-	else return {
-		maxOutputTokens: 4096,
-		supportsStructuredOutput: false,
-		supportsAdaptiveThinking: false,
-		rejectsSamplingParameters: false,
-		supportsXhighEffort: false,
-		rejectsThinkingDisabledAboveHighEffort: false,
-		rejectsThinkingDisabled: false,
-		rejectsBudgetThinking: false,
-		rejectsForcedToolUse: false,
-		supportsBetweenToolsThinking: false,
-		isKnownModel: false
-	};
-}
 function hasDynamicFilteringWebToolWithoutCodeExecution(tools) {
 	if (!tools) return false;
 	let hasDynamicFilteringWebTool = false;
@@ -7025,7 +7133,7 @@ var AnthropicSkills = class {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "4.0.92";
+const VERSION = "4.0.93";
 //#endregion
 //#region src/anthropic-provider.ts
 const ANTHROPIC_API_URL = "https://api.anthropic.com";