@ai-sdk/amazon-bedrock 4.0.175 → 4.0.177

package/dist/mantle/index.js

@@ -35,7 +35,7 @@ var import_provider_utils = require("@ai-sdk/provider-utils");
 var import_aws4fetch = require("aws4fetch");
 
 // src/version.ts
-var VERSION = true ? "4.0.175" : "0.0.0-test";
+var VERSION = true ? "4.0.177" : "0.0.0-test";
 
 // src/bedrock-sigv4-fetch.ts
 function createSigV4FetchFunction(getCredentials, fetch, service = "bedrock") {

package/dist/mantle/index.mjs

@@ -23,7 +23,7 @@ import {
 import { AwsV4Signer } from "aws4fetch";
 
 // src/version.ts
-var VERSION = true ? "4.0.175" : "0.0.0-test";
+var VERSION = true ? "4.0.177" : "0.0.0-test";
 
 // src/bedrock-sigv4-fetch.ts
 function createSigV4FetchFunction(getCredentials, fetch, service = "bedrock") {

package/docs/08-amazon-bedrock.mdx

@@ -203,6 +203,10 @@ You can use the following optional settings to customize the Amazon Bedrock prov
 
   Optional. Base URL for the Bedrock API calls.
   Useful for custom endpoints or proxy configurations.
+  When omitted, the provider also supports the service-specific
+  `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` and
+  `AWS_ENDPOINT_URL_BEDROCK_AGENT_RUNTIME` environment variables, which take
+  precedence over the global `AWS_ENDPOINT_URL` environment variable.
 
 - **headers** _Record<string, string>_
 
@@ -301,6 +305,42 @@ For parity with the Anthropic provider,
 `providerOptions.anthropic.structuredOutputMode` is also honored for Anthropic
 models on Bedrock. When both are provided, the `bedrock` value takes precedence.
 
+For an Anthropic application inference profile, prefer the Bedrock Anthropic
+provider. It uses Bedrock's native InvokeModel API, which accepts application
+inference profile ARNs, and identifies the model as Anthropic automatically:
+
+```ts
+import { bedrockAnthropic } from '@ai-sdk/amazon-bedrock/anthropic';
+
+const profileArn =
+  'arn:aws:bedrock:us-east-1:123456789012:application-inference-profile/qibm5eutlkcy';
+
+const model = bedrockAnthropic(profileArn);
+```
+
+Use `modelFamily: 'anthropic'` only when you need to use the generic
+`@ai-sdk/amazon-bedrock` provider, which uses Bedrock's Converse API (for
+example, when IAM permits Converse but not InvokeModel). Application inference
+profile ARNs do not identify their underlying model, so declaring the family
+allows Anthropic-specific features, including native structured output:
+
+```ts
+import {
+  bedrock,
+  type AmazonBedrockChatModelSettings,
+} from '@ai-sdk/amazon-bedrock';
+
+const profileArn =
+  'arn:aws:bedrock:us-east-1:123456789012:application-inference-profile/qibm5eutlkcy';
+
+const model = bedrock(profileArn, {
+  modelFamily: 'anthropic',
+} satisfies AmazonBedrockChatModelSettings);
+```
+
+For an underlying model that does not reliably support native structured
+output, set `structuredOutputMode` to `"jsonTool"`.
+
 ### File Inputs
 
 <Note type="warning">
@@ -1473,6 +1513,9 @@ You can use the following optional settings to customize the Bedrock Anthropic p
 
   Base URL for the Bedrock API calls.
   Useful for custom endpoints or proxy configurations.
+  When omitted, the provider also supports the service-specific
+  `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` environment variable, which takes
+  precedence over the global `AWS_ENDPOINT_URL` environment variable.
 
 - **headers** _Resolvable&lt;Record&lt;string, string | undefined&gt;&gt;_
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/amazon-bedrock",
-  "version": "4.0.175",
+  "version": "4.0.177",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -44,8 +44,8 @@
     "@smithy/eventstream-codec": "^4.0.1",
     "@smithy/util-utf8": "^4.0.0",
     "aws4fetch": "^1.0.20",
-    "@ai-sdk/anthropic": "3.0.117",
-    "@ai-sdk/openai": "3.0.112",
+    "@ai-sdk/anthropic": "3.0.118",
+    "@ai-sdk/openai": "3.0.113",
     "@ai-sdk/provider": "3.0.16",
     "@ai-sdk/provider-utils": "4.0.51"
   },

package/src/anthropic/bedrock-anthropic-provider.ts

@@ -7,7 +7,6 @@ import {
   loadOptionalSetting,
   loadSetting,
   resolve,
-  withoutTrailingSlash,
   withUserAgentSuffix,
   type FetchFunction,
   type Resolvable,
@@ -25,6 +24,7 @@ import {
   supportsNativeStructuredOutput,
   supportsStrictTools,
 } from '../bedrock-anthropic-model-support';
+import { resolveBedrockBaseURL } from '../resolve-bedrock-base-url';
 import { createBedrockAnthropicFetch } from './bedrock-anthropic-fetch';
 import type { BedrockAnthropicModelId } from './bedrock-anthropic-options';
 import { VERSION } from '../version';
@@ -112,7 +112,9 @@ export interface BedrockAnthropicProviderSettings {
   sessionToken?: string;
 
   /**
-   * Base URL for the Bedrock API calls.
+   * Base URL for the Bedrock API calls. When omitted, the provider uses
+   * `AWS_ENDPOINT_URL_BEDROCK_RUNTIME`, then `AWS_ENDPOINT_URL`, before
+   * generating an endpoint from the AWS region.
    */
   baseURL?: string;
 
@@ -237,15 +239,19 @@ export function createBedrockAnthropic(
   const fetchFunction = createBedrockAnthropicFetch(baseFetchFunction);
 
   const getBaseURL = (): string =>
-    withoutTrailingSlash(
-      options.baseURL ??
-        `https://bedrock-runtime.${loadSetting({
+    resolveBedrockBaseURL({
+      baseURL: options.baseURL,
+      getRegion: () =>
+        loadSetting({
           settingValue: options.region,
           settingName: 'region',
           environmentVariableName: 'AWS_REGION',
           description: 'AWS region',
-        })}.amazonaws.com`,
-    ) ?? 'https://bedrock-runtime.us-east-1.amazonaws.com';
+        }),
+      service: 'bedrock-runtime',
+      serviceEndpointUrlEnvironmentVariableName:
+        'AWS_ENDPOINT_URL_BEDROCK_RUNTIME',
+    });
 
   const getHeaders = async () => {
     const baseHeaders = (await resolve(options.headers)) ?? {};

package/src/bedrock-anthropic-model-support.ts

@@ -1,3 +1,22 @@
+import type { AmazonBedrockChatModelSettings } from './bedrock-chat-options';
+
+export function isAnthropicModel({
+  modelId,
+  modelFamily,
+  reasoningBudgetTokens,
+}: {
+  modelId: string;
+  modelFamily?: AmazonBedrockChatModelSettings['modelFamily'];
+  reasoningBudgetTokens?: number;
+}): boolean {
+  return (
+    modelFamily === 'anthropic' ||
+    modelId.includes('anthropic') ||
+    (modelId.includes(':application-inference-profile/') &&
+      reasoningBudgetTokens != null)
+  );
+}
+
 export function supportsStrictTools(modelId: string): boolean {
   return !matchesModel(modelId, MODELS_WITHOUT_STRICT_TOOL_SUPPORT);
 }

package/src/bedrock-chat-language-model.ts

@@ -37,8 +37,10 @@ import {
 import {
   amazonBedrockLanguageModelOptions,
   type BedrockChatModelId,
+  type AmazonBedrockChatModelSettings,
 } from './bedrock-chat-options';
 import {
+  isAnthropicModel as detectAnthropicModel,
   supportsNativeStructuredOutput,
   supportsStrictTools,
 } from './bedrock-anthropic-model-support';
@@ -59,6 +61,7 @@ type BedrockChatConfig = {
   headers: Resolvable<Record<string, string | undefined>>;
   fetch?: FetchFunction;
   generateId: () => string;
+  modelFamily?: AmazonBedrockChatModelSettings['modelFamily'];
 };
 
 function isJsonResponseToolName(name: string): boolean {
@@ -165,12 +168,11 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
       });
     }
 
-    // Application inference profile ARNs do not expose their underlying model.
-    // The Anthropic-only reasoning budget provides the model-family signal.
-    const isAnthropicModel =
-      this.modelId.includes('anthropic') ||
-      (this.modelId.includes(':application-inference-profile/') &&
-        bedrockOptions.reasoningConfig?.budgetTokens != null);
+    const isAnthropicModel = detectAnthropicModel({
+      modelId: this.modelId,
+      modelFamily: this.config.modelFamily,
+      reasoningBudgetTokens: bedrockOptions.reasoningConfig?.budgetTokens,
+    });
     const openAIModelId = /^(?:[^.]+\.)?(openai\..+)$/.exec(this.modelId)?.[1];
     const isOpenAIModel = openAIModelId != null;
     const isOpenAIGptOssModel =
@@ -215,7 +217,9 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
 
     const modelSupportsNativeStructuredOutput =
       supportsNativeStructuredOutput(this.modelId) &&
-      (modelSupportsStructuredOutput || isThinkingEnabled);
+      (modelSupportsStructuredOutput ||
+        isThinkingEnabled ||
+        this.config.modelFamily === 'anthropic');
 
     const useNativeStructuredOutput =
       isAnthropicModel &&
@@ -254,6 +258,8 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
         toolChoice:
           jsonResponseTool != null ? { type: 'required' } : toolChoice,
         modelId: this.modelId,
+        modelFamily: this.config.modelFamily,
+        reasoningBudgetTokens: bedrockOptions.reasoningConfig?.budgetTokens,
         disableParallelToolUse: anthropicOptions?.disableParallelToolUse,
       });
 

package/src/bedrock-chat-options.ts

@@ -83,6 +83,16 @@ export type BedrockChatModelId =
   | 'us.meta.llama4-maverick-17b-instruct-v1:0'
   | (string & {});
 
+export type AmazonBedrockChatModelSettings = {
+  /**
+   * The chat model family.
+   *
+   * Specify this when the model ID does not identify the underlying model,
+   * such as an application inference profile ARN.
+   */
+  modelFamily?: 'anthropic';
+};
+
 /**
  * Bedrock file part provider options for document-specific features.
  * These options apply to individual file parts (documents).

package/src/bedrock-prepare-tools.ts

@@ -9,21 +9,29 @@ import {
   anthropicTools,
   prepareTools as prepareAnthropicTools,
 } from '@ai-sdk/anthropic/internal';
-import { supportsStrictTools } from './bedrock-anthropic-model-support';
+import {
+  isAnthropicModel as detectAnthropicModel,
+  supportsStrictTools,
+} from './bedrock-anthropic-model-support';
 import type {
   BedrockTool,
   BedrockToolConfiguration,
 } from './bedrock-api-types';
+import type { AmazonBedrockChatModelSettings } from './bedrock-chat-options';
 
 export async function prepareTools({
   tools,
   toolChoice,
   modelId,
+  modelFamily,
+  reasoningBudgetTokens,
   disableParallelToolUse,
 }: {
   tools: LanguageModelV3CallOptions['tools'];
   toolChoice?: LanguageModelV3CallOptions['toolChoice'];
   modelId: string;
+  modelFamily?: AmazonBedrockChatModelSettings['modelFamily'];
+  reasoningBudgetTokens?: number;
   disableParallelToolUse?: boolean;
 }): Promise<{
   toolConfig: BedrockToolConfiguration;
@@ -69,7 +77,11 @@ export async function prepareTools({
     };
   }
 
-  const isAnthropicModel = modelId.includes('anthropic.');
+  const isAnthropicModel = detectAnthropicModel({
+    modelId,
+    modelFamily,
+    reasoningBudgetTokens,
+  });
   const ProviderTools = supportedTools.filter(t => t.type === 'provider');
   const functionTools = supportedTools.filter(t => t.type === 'function');
 

package/src/bedrock-provider.ts

@@ -10,12 +10,14 @@ import {
   generateId,
   loadOptionalSetting,
   loadSetting,
-  withoutTrailingSlash,
   withUserAgentSuffix,
   type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { BedrockChatLanguageModel } from './bedrock-chat-language-model';
-import type { BedrockChatModelId } from './bedrock-chat-options';
+import type {
+  AmazonBedrockChatModelSettings,
+  BedrockChatModelId,
+} from './bedrock-chat-options';
 import { BedrockEmbeddingModel } from './bedrock-embedding-model';
 import type {
   BedrockEmbeddingModelId,
@@ -30,6 +32,7 @@ import {
 } from './bedrock-sigv4-fetch';
 import { BedrockRerankingModel } from './reranking/bedrock-reranking-model';
 import type { BedrockRerankingModelId } from './reranking/bedrock-reranking-options';
+import { resolveBedrockBaseURL } from './resolve-bedrock-base-url';
 import { VERSION } from './version';
 
 export interface AmazonBedrockProviderSettings {
@@ -85,7 +88,9 @@ export interface AmazonBedrockProviderSettings {
   sessionToken?: string;
 
   /**
-   * Base URL for the Bedrock API calls.
+   * Base URL for the Bedrock API calls. When omitted, the provider uses
+   * service-specific AWS endpoint environment variables, then `AWS_ENDPOINT_URL`,
+   * before generating an endpoint from the AWS region.
    */
   baseURL?: string;
 
@@ -113,9 +118,15 @@ export interface AmazonBedrockProviderSettings {
 }
 
 export interface AmazonBedrockProvider extends ProviderV3 {
-  (modelId: BedrockChatModelId): LanguageModelV3;
+  (
+    modelId: BedrockChatModelId,
+    settings?: AmazonBedrockChatModelSettings,
+  ): LanguageModelV3;
 
-  languageModel(modelId: BedrockChatModelId): LanguageModelV3;
+  languageModel(
+    modelId: BedrockChatModelId,
+    settings?: AmazonBedrockChatModelSettings,
+  ): LanguageModelV3;
 
   /**
    * Creates a model for text embeddings.
@@ -284,43 +295,58 @@ export function createAmazonBedrock(
   };
 
   const getBedrockRuntimeBaseUrl = (): string =>
-    withoutTrailingSlash(
-      options.baseURL ??
-        `https://bedrock-runtime.${loadSetting({
+    resolveBedrockBaseURL({
+      baseURL: options.baseURL,
+      getRegion: () =>
+        loadSetting({
           settingValue: options.region,
           settingName: 'region',
           environmentVariableName: 'AWS_REGION',
           description: 'AWS region',
-        })}.amazonaws.com`,
-    ) ?? `https://bedrock-runtime.us-east-1.amazonaws.com`;
+        }),
+      service: 'bedrock-runtime',
+      serviceEndpointUrlEnvironmentVariableName:
+        'AWS_ENDPOINT_URL_BEDROCK_RUNTIME',
+    });
 
   const getBedrockAgentRuntimeBaseUrl = (): string =>
-    withoutTrailingSlash(
-      options.baseURL ??
-        `https://bedrock-agent-runtime.${loadSetting({
+    resolveBedrockBaseURL({
+      baseURL: options.baseURL,
+      getRegion: () =>
+        loadSetting({
           settingValue: options.region,
           settingName: 'region',
           environmentVariableName: 'AWS_REGION',
           description: 'AWS region',
-        })}.amazonaws.com`,
-    ) ?? `https://bedrock-agent-runtime.us-west-2.amazonaws.com`;
+        }),
+      service: 'bedrock-agent-runtime',
+      serviceEndpointUrlEnvironmentVariableName:
+        'AWS_ENDPOINT_URL_BEDROCK_AGENT_RUNTIME',
+    });
 
-  const createChatModel = (modelId: BedrockChatModelId) =>
+  const createChatModel = (
+    modelId: BedrockChatModelId,
+    settings: AmazonBedrockChatModelSettings = {},
+  ) =>
     new BedrockChatLanguageModel(modelId, {
       baseUrl: getBedrockRuntimeBaseUrl,
       headers: getHeaders,
       fetch: fetchFunction,
       generateId,
+      modelFamily: settings.modelFamily,
     });
 
-  const provider = function (modelId: BedrockChatModelId) {
+  const provider = function (
+    modelId: BedrockChatModelId,
+    settings?: AmazonBedrockChatModelSettings,
+  ) {
     if (new.target) {
       throw new Error(
         'The Amazon Bedrock model function cannot be called with the new keyword.',
       );
     }
 
-    return createChatModel(modelId);
+    return createChatModel(modelId, settings);
   };
 
   const createEmbeddingModel = (

package/src/index.ts

@@ -5,6 +5,7 @@ export type {
   AmazonBedrockEmbeddingModelSettings,
 } from './bedrock-embedding-options';
 export type {
+  AmazonBedrockChatModelSettings,
   AmazonBedrockLanguageModelOptions,
   /** @deprecated Use `AmazonBedrockLanguageModelOptions` instead. */
   AmazonBedrockLanguageModelOptions as BedrockProviderOptions,

package/src/resolve-bedrock-base-url.ts

@@ -0,0 +1,51 @@
+import {
+  loadOptionalSetting,
+  withoutTrailingSlash,
+} from '@ai-sdk/provider-utils';
+
+const AWS_PARTITION_DNS_SUFFIXES = [
+  { regionPrefix: 'cn-', dnsSuffix: 'amazonaws.com.cn' },
+  { regionPrefix: 'us-iso-', dnsSuffix: 'c2s.ic.gov' },
+  { regionPrefix: 'us-isob-', dnsSuffix: 'sc2s.sgov.gov' },
+  { regionPrefix: 'eu-isoe-', dnsSuffix: 'cloud.adc-e.uk' },
+  { regionPrefix: 'us-isof-', dnsSuffix: 'csp.hci.ic.gov' },
+  { regionPrefix: 'eusc-', dnsSuffix: 'amazonaws.eu' },
+] as const;
+
+export function resolveBedrockBaseURL({
+  baseURL,
+  getRegion,
+  service,
+  serviceEndpointUrlEnvironmentVariableName,
+}: {
+  baseURL: string | undefined;
+  getRegion: () => string;
+  service: 'bedrock-runtime' | 'bedrock-agent-runtime';
+  serviceEndpointUrlEnvironmentVariableName:
+    | 'AWS_ENDPOINT_URL_BEDROCK_RUNTIME'
+    | 'AWS_ENDPOINT_URL_BEDROCK_AGENT_RUNTIME';
+}): string {
+  const resolvedBaseURL =
+    baseURL ??
+    loadOptionalSetting({
+      settingValue: undefined,
+      environmentVariableName: serviceEndpointUrlEnvironmentVariableName,
+    }) ??
+    loadOptionalSetting({
+      settingValue: undefined,
+      environmentVariableName: 'AWS_ENDPOINT_URL',
+    });
+
+  if (resolvedBaseURL != null) {
+    return withoutTrailingSlash(resolvedBaseURL) ?? resolvedBaseURL;
+  }
+
+  const region = getRegion();
+  const dnsSuffix =
+    AWS_PARTITION_DNS_SUFFIXES.find(({ regionPrefix }) =>
+      region.startsWith(regionPrefix),
+    )?.dnsSuffix ?? 'amazonaws.com';
+  const generatedBaseURL = `https://${service}.${region}.${dnsSuffix}`;
+
+  return withoutTrailingSlash(generatedBaseURL) ?? generatedBaseURL;
+}