@aws-sdk/client-bedrock 3.613.0 → 3.616.0

package/dist-cjs/index.js

@@ -67,6 +67,7 @@ __export(src_exports, {
   GetModelInvocationLoggingConfigurationCommand: () => GetModelInvocationLoggingConfigurationCommand,
   GetProvisionedModelThroughputCommand: () => GetProvisionedModelThroughputCommand,
   GuardrailContentFilterType: () => GuardrailContentFilterType,
+  GuardrailContextualGroundingFilterType: () => GuardrailContextualGroundingFilterType,
   GuardrailFilterStrength: () => GuardrailFilterStrength,
   GuardrailManagedWordsType: () => GuardrailManagedWordsType,
   GuardrailPiiEntityType: () => GuardrailPiiEntityType,
@@ -224,19 +225,19 @@ var _BedrockClient = class _BedrockClient extends import_smithy_client.Client {
     const _config_1 = resolveClientEndpointParameters(_config_0);
     const _config_2 = (0, import_config_resolver.resolveRegionConfig)(_config_1);
     const _config_3 = (0, import_middleware_endpoint.resolveEndpointConfig)(_config_2);
-    const _config_4 = (0, import_middleware_retry.resolveRetryConfig)(_config_3);
-    const _config_5 = (0, import_middleware_host_header.resolveHostHeaderConfig)(_config_4);
-    const _config_6 = (0, import_middleware_user_agent.resolveUserAgentConfig)(_config_5);
+    const _config_4 = (0, import_middleware_host_header.resolveHostHeaderConfig)(_config_3);
+    const _config_5 = (0, import_middleware_user_agent.resolveUserAgentConfig)(_config_4);
+    const _config_6 = (0, import_middleware_retry.resolveRetryConfig)(_config_5);
     const _config_7 = (0, import_httpAuthSchemeProvider.resolveHttpAuthSchemeConfig)(_config_6);
     const _config_8 = resolveRuntimeExtensions(_config_7, (configuration == null ? void 0 : configuration.extensions) || []);
     super(_config_8);
     this.config = _config_8;
-    this.middlewareStack.use((0, import_middleware_retry.getRetryPlugin)(this.config));
-    this.middlewareStack.use((0, import_middleware_content_length.getContentLengthPlugin)(this.config));
     this.middlewareStack.use((0, import_middleware_host_header.getHostHeaderPlugin)(this.config));
     this.middlewareStack.use((0, import_middleware_logger.getLoggerPlugin)(this.config));
     this.middlewareStack.use((0, import_middleware_recursion_detection.getRecursionDetectionPlugin)(this.config));
     this.middlewareStack.use((0, import_middleware_user_agent.getUserAgentPlugin)(this.config));
+    this.middlewareStack.use((0, import_middleware_retry.getRetryPlugin)(this.config));
+    this.middlewareStack.use((0, import_middleware_content_length.getContentLengthPlugin)(this.config));
     this.middlewareStack.use(
       (0, import_core.getHttpAuthSchemeEndpointRuleSetPlugin)(this.config, {
         httpAuthSchemeParametersProvider: this.getDefaultHttpAuthSchemeParametersProvider(),
@@ -483,6 +484,10 @@ var GuardrailContentFilterType = {
   SEXUAL: "SEXUAL",
   VIOLENCE: "VIOLENCE"
 };
+var GuardrailContextualGroundingFilterType = {
+  GROUNDING: "GROUNDING",
+  RELEVANCE: "RELEVANCE"
+};
 var GuardrailSensitiveInformationAction = {
   ANONYMIZE: "ANONYMIZE",
   BLOCK: "BLOCK"
@@ -791,6 +796,7 @@ var se_CreateGuardrailCommand = /* @__PURE__ */ __name(async (input, context) =>
       blockedOutputsMessaging: [],
       clientRequestToken: [true, (_) => _ ?? (0, import_uuid.v4)()],
       contentPolicyConfig: (_) => (0, import_smithy_client._json)(_),
+      contextualGroundingPolicyConfig: (_) => se_GuardrailContextualGroundingPolicyConfig(_, context),
       description: [],
       kmsKeyId: [],
       name: [],
@@ -1165,6 +1171,7 @@ var se_UpdateGuardrailCommand = /* @__PURE__ */ __name(async (input, context) =>
       blockedInputMessaging: [],
       blockedOutputsMessaging: [],
       contentPolicyConfig: (_) => (0, import_smithy_client._json)(_),
+      contextualGroundingPolicyConfig: (_) => se_GuardrailContextualGroundingPolicyConfig(_, context),
       description: [],
       kmsKeyId: [],
       name: [],
@@ -1386,6 +1393,7 @@ var de_GetGuardrailCommand = /* @__PURE__ */ __name(async (output, context) => {
     blockedInputMessaging: import_smithy_client.expectString,
     blockedOutputsMessaging: import_smithy_client.expectString,
     contentPolicy: import_smithy_client._json,
+    contextualGroundingPolicy: (_) => de_GuardrailContextualGroundingPolicy(_, context),
     createdAt: (_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseRfc3339DateTimeWithOffset)(_)),
     description: import_smithy_client.expectString,
     failureRecommendations: import_smithy_client._json,
@@ -1804,6 +1812,22 @@ var de_ValidationExceptionRes = /* @__PURE__ */ __name(async (parsedOutput, cont
   });
   return (0, import_smithy_client.decorateServiceException)(exception, parsedOutput.body);
 }, "de_ValidationExceptionRes");
+var se_GuardrailContextualGroundingFilterConfig = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    threshold: import_smithy_client.serializeFloat,
+    type: []
+  });
+}, "se_GuardrailContextualGroundingFilterConfig");
+var se_GuardrailContextualGroundingFiltersConfig = /* @__PURE__ */ __name((input, context) => {
+  return input.filter((e) => e != null).map((entry) => {
+    return se_GuardrailContextualGroundingFilterConfig(entry, context);
+  });
+}, "se_GuardrailContextualGroundingFiltersConfig");
+var se_GuardrailContextualGroundingPolicyConfig = /* @__PURE__ */ __name((input, context) => {
+  return (0, import_smithy_client.take)(input, {
+    filtersConfig: (_) => se_GuardrailContextualGroundingFiltersConfig(_, context)
+  });
+}, "se_GuardrailContextualGroundingPolicyConfig");
 var de_CustomModelSummary = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     baseModelArn: import_smithy_client.expectString,
@@ -1837,6 +1861,23 @@ var de_EvaluationSummary = /* @__PURE__ */ __name((output, context) => {
     status: import_smithy_client.expectString
   });
 }, "de_EvaluationSummary");
+var de_GuardrailContextualGroundingFilter = /* @__PURE__ */ __name((output, context) => {
+  return (0, import_smithy_client.take)(output, {
+    threshold: import_smithy_client.limitedParseDouble,
+    type: import_smithy_client.expectString
+  });
+}, "de_GuardrailContextualGroundingFilter");
+var de_GuardrailContextualGroundingFilters = /* @__PURE__ */ __name((output, context) => {
+  const retVal = (output || []).filter((e) => e != null).map((entry) => {
+    return de_GuardrailContextualGroundingFilter(entry, context);
+  });
+  return retVal;
+}, "de_GuardrailContextualGroundingFilters");
+var de_GuardrailContextualGroundingPolicy = /* @__PURE__ */ __name((output, context) => {
+  return (0, import_smithy_client.take)(output, {
+    filters: (_) => de_GuardrailContextualGroundingFilters(_, context)
+  });
+}, "de_GuardrailContextualGroundingPolicy");
 var de_GuardrailSummaries = /* @__PURE__ */ __name((output, context) => {
   const retVal = (output || []).filter((e) => e != null).map((entry) => {
     return de_GuardrailSummary(entry, context);
@@ -2533,6 +2574,7 @@ var paginateListProvisionedModelThroughputs = (0, import_core.createPaginator)(B
   SortOrder,
   GuardrailFilterStrength,
   GuardrailContentFilterType,
+  GuardrailContextualGroundingFilterType,
   GuardrailSensitiveInformationAction,
   GuardrailPiiEntityType,
   GuardrailTopicType,

package/dist-es/BedrockClient.js

@@ -19,19 +19,19 @@ export class BedrockClient extends __Client {
         const _config_1 = resolveClientEndpointParameters(_config_0);
         const _config_2 = resolveRegionConfig(_config_1);
         const _config_3 = resolveEndpointConfig(_config_2);
-        const _config_4 = resolveRetryConfig(_config_3);
-        const _config_5 = resolveHostHeaderConfig(_config_4);
-        const _config_6 = resolveUserAgentConfig(_config_5);
+        const _config_4 = resolveHostHeaderConfig(_config_3);
+        const _config_5 = resolveUserAgentConfig(_config_4);
+        const _config_6 = resolveRetryConfig(_config_5);
         const _config_7 = resolveHttpAuthSchemeConfig(_config_6);
         const _config_8 = resolveRuntimeExtensions(_config_7, configuration?.extensions || []);
         super(_config_8);
         this.config = _config_8;
-        this.middlewareStack.use(getRetryPlugin(this.config));
-        this.middlewareStack.use(getContentLengthPlugin(this.config));
         this.middlewareStack.use(getHostHeaderPlugin(this.config));
         this.middlewareStack.use(getLoggerPlugin(this.config));
         this.middlewareStack.use(getRecursionDetectionPlugin(this.config));
         this.middlewareStack.use(getUserAgentPlugin(this.config));
+        this.middlewareStack.use(getRetryPlugin(this.config));
+        this.middlewareStack.use(getContentLengthPlugin(this.config));
         this.middlewareStack.use(getHttpAuthSchemeEndpointRuleSetPlugin(this.config, {
             httpAuthSchemeParametersProvider: this.getDefaultHttpAuthSchemeParametersProvider(),
             identityProviderConfigProvider: this.getIdentityProviderConfigProvider(),

package/dist-es/models/models_0.js

@@ -157,6 +157,10 @@ export const GuardrailContentFilterType = {
     SEXUAL: "SEXUAL",
     VIOLENCE: "VIOLENCE",
 };
+export const GuardrailContextualGroundingFilterType = {
+    GROUNDING: "GROUNDING",
+    RELEVANCE: "RELEVANCE",
+};
 export const GuardrailSensitiveInformationAction = {
     ANONYMIZE: "ANONYMIZE",
     BLOCK: "BLOCK",

package/dist-es/protocols/Aws_restJson1.js

@@ -1,6 +1,6 @@
 import { awsExpectUnion as __expectUnion, loadRestJsonErrorCode, parseJsonBody as parseBody, parseJsonErrorBody as parseErrorBody, } from "@aws-sdk/core";
 import { requestBuilder as rb } from "@smithy/core";
-import { _json, collectBody, decorateServiceException as __decorateServiceException, expectInt32 as __expectInt32, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseFloat32 as __limitedParseFloat32, map, parseRfc3339DateTimeWithOffset as __parseRfc3339DateTimeWithOffset, serializeDateTime as __serializeDateTime, take, withBaseException, } from "@smithy/smithy-client";
+import { _json, collectBody, decorateServiceException as __decorateServiceException, expectInt32 as __expectInt32, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseDouble as __limitedParseDouble, limitedParseFloat32 as __limitedParseFloat32, map, parseRfc3339DateTimeWithOffset as __parseRfc3339DateTimeWithOffset, serializeDateTime as __serializeDateTime, serializeFloat as __serializeFloat, take, withBaseException, } from "@smithy/smithy-client";
 import { v4 as generateIdempotencyToken } from "uuid";
 import { BedrockServiceException as __BaseException } from "../models/BedrockServiceException";
 import { AccessDeniedException, ConflictException, InternalServerException, ResourceNotFoundException, ServiceQuotaExceededException, ThrottlingException, TooManyTagsException, ValidationException, } from "../models/models_0";
@@ -37,6 +37,7 @@ export const se_CreateGuardrailCommand = async (input, context) => {
         blockedOutputsMessaging: [],
         clientRequestToken: [true, (_) => _ ?? generateIdempotencyToken()],
         contentPolicyConfig: (_) => _json(_),
+        contextualGroundingPolicyConfig: (_) => se_GuardrailContextualGroundingPolicyConfig(_, context),
         description: [],
         kmsKeyId: [],
         name: [],
@@ -395,6 +396,7 @@ export const se_UpdateGuardrailCommand = async (input, context) => {
         blockedInputMessaging: [],
         blockedOutputsMessaging: [],
         contentPolicyConfig: (_) => _json(_),
+        contextualGroundingPolicyConfig: (_) => se_GuardrailContextualGroundingPolicyConfig(_, context),
         description: [],
         kmsKeyId: [],
         name: [],
@@ -613,6 +615,7 @@ export const de_GetGuardrailCommand = async (output, context) => {
         blockedInputMessaging: __expectString,
         blockedOutputsMessaging: __expectString,
         contentPolicy: _json,
+        contextualGroundingPolicy: (_) => de_GuardrailContextualGroundingPolicy(_, context),
         createdAt: (_) => __expectNonNull(__parseRfc3339DateTimeWithOffset(_)),
         description: __expectString,
         failureRecommendations: _json,
@@ -1031,6 +1034,24 @@ const de_ValidationExceptionRes = async (parsedOutput, context) => {
     });
     return __decorateServiceException(exception, parsedOutput.body);
 };
+const se_GuardrailContextualGroundingFilterConfig = (input, context) => {
+    return take(input, {
+        threshold: __serializeFloat,
+        type: [],
+    });
+};
+const se_GuardrailContextualGroundingFiltersConfig = (input, context) => {
+    return input
+        .filter((e) => e != null)
+        .map((entry) => {
+        return se_GuardrailContextualGroundingFilterConfig(entry, context);
+    });
+};
+const se_GuardrailContextualGroundingPolicyConfig = (input, context) => {
+    return take(input, {
+        filtersConfig: (_) => se_GuardrailContextualGroundingFiltersConfig(_, context),
+    });
+};
 const de_CustomModelSummary = (output, context) => {
     return take(output, {
         baseModelArn: __expectString,
@@ -1068,6 +1089,25 @@ const de_EvaluationSummary = (output, context) => {
         status: __expectString,
     });
 };
+const de_GuardrailContextualGroundingFilter = (output, context) => {
+    return take(output, {
+        threshold: __limitedParseDouble,
+        type: __expectString,
+    });
+};
+const de_GuardrailContextualGroundingFilters = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_GuardrailContextualGroundingFilter(entry, context);
+    });
+    return retVal;
+};
+const de_GuardrailContextualGroundingPolicy = (output, context) => {
+    return take(output, {
+        filters: (_) => de_GuardrailContextualGroundingFilters(_, context),
+    });
+};
 const de_GuardrailSummaries = (output, context) => {
     const retVal = (output || [])
         .filter((e) => e != null)

package/dist-types/BedrockClient.d.ts

@@ -161,7 +161,7 @@ export interface ClientDefaults extends Partial<__SmithyConfiguration<__HttpHand
 /**
  * @public
  */
-export type BedrockClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointInputConfig<EndpointParameters> & RetryInputConfig & HostHeaderInputConfig & UserAgentInputConfig & HttpAuthSchemeInputConfig & ClientInputEndpointParameters;
+export type BedrockClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointInputConfig<EndpointParameters> & HostHeaderInputConfig & UserAgentInputConfig & RetryInputConfig & HttpAuthSchemeInputConfig & ClientInputEndpointParameters;
 /**
  * @public
  *
@@ -172,7 +172,7 @@ export interface BedrockClientConfig extends BedrockClientConfigType {
 /**
  * @public
  */
-export type BedrockClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RuntimeExtensionsConfig & RegionResolvedConfig & EndpointResolvedConfig<EndpointParameters> & RetryResolvedConfig & HostHeaderResolvedConfig & UserAgentResolvedConfig & HttpAuthSchemeResolvedConfig & ClientResolvedEndpointParameters;
+export type BedrockClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RuntimeExtensionsConfig & RegionResolvedConfig & EndpointResolvedConfig<EndpointParameters> & HostHeaderResolvedConfig & UserAgentResolvedConfig & RetryResolvedConfig & HttpAuthSchemeResolvedConfig & ClientResolvedEndpointParameters;
 /**
  * @public
  *

package/dist-types/commands/CreateGuardrailCommand.d.ts

@@ -27,46 +27,38 @@ declare const CreateGuardrailCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates a guardrail to block topics and to filter out harmful content.</p>
+ * <p>Creates a guardrail to block topics and to implement safeguards for your generative AI applications.</p>
+ *          <p>You can configure the following policies in a guardrail to avoid undesirable and harmful content, filter
+ *         out denied topics and words, and remove sensitive information for privacy protection.</p>
  *          <ul>
  *             <li>
- *                <p>Specify a <code>name</code> and optional <code>description</code>.</p>
+ *                <p>
+ *                   <b>Content filters</b> - Adjust filter strengths
+ *               to block input prompts or model responses containing harmful content.</p>
  *             </li>
  *             <li>
- *                <p>Specify messages for when the guardrail successfully blocks a prompt or a model response in the <code>blockedInputMessaging</code> and <code>blockedOutputsMessaging</code> fields.</p>
+ *                <p>
+ *                   <b>Denied topics</b> - Define a set of topics that
+ *               are undesirable in the context of your application. These topics will be blocked if
+ *               detected in user queries or model responses.</p>
  *             </li>
  *             <li>
- *                <p>Specify topics for the guardrail to deny in the <code>topicPolicyConfig</code> object. Each <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailTopicConfig.html">GuardrailTopicConfig</a> object in the <code>topicsConfig</code> list pertains to one topic.</p>
- *                <ul>
- *                   <li>
- *                      <p>Give a <code>name</code> and <code>description</code> so that the guardrail can properly identify the topic.</p>
- *                   </li>
- *                   <li>
- *                      <p>Specify <code>DENY</code> in the <code>type</code> field.</p>
- *                   </li>
- *                   <li>
- *                      <p>(Optional) Provide up to five prompts that you would categorize as belonging to the topic in the <code>examples</code> list.</p>
- *                   </li>
- *                </ul>
+ *                <p>
+ *                   <b>Word filters</b> - Configure filters to block
+ *               undesirable words, phrases, and profanity. Such words can include offensive terms,
+ *               competitor names etc.</p>
  *             </li>
  *             <li>
- *                <p>Specify filter strengths for the harmful categories defined in Amazon Bedrock in the <code>contentPolicyConfig</code> object. Each <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a> object in the <code>filtersConfig</code> list pertains to a harmful category. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters">Content filters</a>. For more information about the fields in a content filter, see <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a>.</p>
- *                <ul>
- *                   <li>
- *                      <p>Specify the category in the <code>type</code> field.</p>
- *                   </li>
- *                   <li>
- *                      <p>Specify the strength of the filter for prompts in the <code>inputStrength</code> field and for model responses in the <code>strength</code> field of the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a>.</p>
- *                   </li>
- *                </ul>
- *             </li>
- *             <li>
- *                <p>(Optional) For security, include the ARN of a KMS key in the <code>kmsKeyId</code> field.</p>
- *             </li>
- *             <li>
- *                <p>(Optional) Attach any tags to the guardrail in the <code>tags</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/tagging">Tag resources</a>.</p>
+ *                <p>
+ *                   <b>Sensitive information filters</b> - Block or
+ *               mask sensitive information such as personally identifiable information (PII) or custom
+ *               regex in user inputs and model responses.</p>
  *             </li>
  *          </ul>
+ *          <p>In addition to the above policies, you can also configure the messages to be returned to
+ *         the user if a user input or model response is in violation of the policies defined in the guardrail.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html">Guardrails for Amazon Bedrock</a> in
+ *          the <i>Amazon Bedrock User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -125,6 +117,14 @@ declare const CreateGuardrailCommand_base: {
  *       },
  *     ],
  *   },
+ *   contextualGroundingPolicyConfig: { // GuardrailContextualGroundingPolicyConfig
+ *     filtersConfig: [ // GuardrailContextualGroundingFiltersConfig // required
+ *       { // GuardrailContextualGroundingFilterConfig
+ *         type: "GROUNDING" || "RELEVANCE", // required
+ *         threshold: Number("double"), // required
+ *       },
+ *     ],
+ *   },
  *   blockedInputMessaging: "STRING_VALUE", // required
  *   blockedOutputsMessaging: "STRING_VALUE", // required
  *   kmsKeyId: "STRING_VALUE",

package/dist-types/commands/GetGuardrailCommand.d.ts

@@ -96,6 +96,14 @@ declare const GetGuardrailCommand_base: {
  * //       },
  * //     ],
  * //   },
+ * //   contextualGroundingPolicy: { // GuardrailContextualGroundingPolicy
+ * //     filters: [ // GuardrailContextualGroundingFilters // required
+ * //       { // GuardrailContextualGroundingFilter
+ * //         type: "GROUNDING" || "RELEVANCE", // required
+ * //         threshold: Number("double"), // required
+ * //       },
+ * //     ],
+ * //   },
  * //   createdAt: new Date("TIMESTAMP"), // required
  * //   updatedAt: new Date("TIMESTAMP"), // required
  * //   statusReasons: [ // GuardrailStatusReasons

package/dist-types/commands/UpdateGuardrailCommand.d.ts

@@ -50,7 +50,7 @@ declare const UpdateGuardrailCommand_base: {
  *                </ul>
  *             </li>
  *             <li>
- *                <p>Specify filter strengths for the harmful categories defined in Amazon Bedrock in the <code>contentPolicyConfig</code> object. Each <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a> object in the <code>filtersConfig</code> list pertains to a harmful category. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters">Content filters</a>. For more information about the fields in a content filter, see <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a>.</p>
+ *                <p>Specify filter strengths for the harmful categories defined in Amazon Bedrock in the <code>contentPolicyConfig</code> object. Each <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a> object in the <code>filtersConfig</code> list pertains to a harmful category. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-content-filters">Content filters</a>. For more information about the fields in a content filter, see <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html">GuardrailContentFilterConfig</a>.</p>
  *                <ul>
  *                   <li>
  *                      <p>Specify the category in the <code>type</code> field.</p>
@@ -63,9 +63,6 @@ declare const UpdateGuardrailCommand_base: {
  *             <li>
  *                <p>(Optional) For security, include the ARN of a KMS key in the <code>kmsKeyId</code> field.</p>
  *             </li>
- *             <li>
- *                <p>(Optional) Attach any tags to the guardrail in the <code>tags</code> object. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/tagging">Tag resources</a>.</p>
- *             </li>
  *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -126,6 +123,14 @@ declare const UpdateGuardrailCommand_base: {
  *       },
  *     ],
  *   },
+ *   contextualGroundingPolicyConfig: { // GuardrailContextualGroundingPolicyConfig
+ *     filtersConfig: [ // GuardrailContextualGroundingFiltersConfig // required
+ *       { // GuardrailContextualGroundingFilterConfig
+ *         type: "GROUNDING" || "RELEVANCE", // required
+ *         threshold: Number("double"), // required
+ *       },
+ *     ],
+ *   },
  *   blockedInputMessaging: "STRING_VALUE", // required
  *   blockedOutputsMessaging: "STRING_VALUE", // required
  *   kmsKeyId: "STRING_VALUE",

package/dist-types/models/models_0.d.ts

@@ -752,19 +752,6 @@ export type GuardrailContentFilterType = (typeof GuardrailContentFilterType)[key
  *          multiple categories with varying confidence levels. For example, a single statement
  *          can be classified as <i>Hate</i> with HIGH confidence, <i>Insults</i> with LOW confidence, <i>Sexual</i> with NONE confidence, and <i>Violence</i> with MEDIUM confidence.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters.html">Guardrails content filters</a>.</p>
- *          <p>This data type is used in the following API operations:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax">CreateGuardrail request body</a>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax">UpdateGuardrail request body</a>
- *                </p>
- *             </li>
- *          </ul>
  * @public
  */
 export interface GuardrailContentFilterConfig {
@@ -790,19 +777,6 @@ export interface GuardrailContentFilterConfig {
 }
 /**
  * <p>Contains details about how to handle harmful content.</p>
- *          <p>This data type is used in the following API operations:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax">CreateGuardrail request body</a>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax">UpdateGuardrail request body</a>
- *                </p>
- *             </li>
- *          </ul>
  * @public
  */
 export interface GuardrailContentPolicyConfig {
@@ -812,6 +786,45 @@ export interface GuardrailContentPolicyConfig {
      */
     filtersConfig: GuardrailContentFilterConfig[] | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const GuardrailContextualGroundingFilterType: {
+    readonly GROUNDING: "GROUNDING";
+    readonly RELEVANCE: "RELEVANCE";
+};
+/**
+ * @public
+ */
+export type GuardrailContextualGroundingFilterType = (typeof GuardrailContextualGroundingFilterType)[keyof typeof GuardrailContextualGroundingFilterType];
+/**
+ * <p>The filter configuration details for the guardrails contextual grounding filter.</p>
+ * @public
+ */
+export interface GuardrailContextualGroundingFilterConfig {
+    /**
+     * <p>The filter details for the guardrails contextual grounding filter.</p>
+     * @public
+     */
+    type: GuardrailContextualGroundingFilterType | undefined;
+    /**
+     * <p>The threshold details for the guardrails contextual grounding filter.</p>
+     * @public
+     */
+    threshold: number | undefined;
+}
+/**
+ * <p>The policy configuration details for the guardrails contextual grounding policy.</p>
+ * @public
+ */
+export interface GuardrailContextualGroundingPolicyConfig {
+    /**
+     * <p>The filter configuration details for the guardrails contextual grounding policy.</p>
+     * @public
+     */
+    filtersConfig: GuardrailContextualGroundingFilterConfig[] | undefined;
+}
 /**
  * @public
  * @enum
@@ -872,6 +885,329 @@ export type GuardrailPiiEntityType = (typeof GuardrailPiiEntityType)[keyof typeo
 export interface GuardrailPiiEntityConfig {
     /**
      * <p>Configure guardrail type when the PII entity is detected.</p>
+     *          <p>The following PIIs are used to block or mask sensitive information:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <b>General</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>ADDRESS</b>
+     *                      </p>
+     *                      <p>A physical address, such as "100 Main Street, Anytown, USA"
+     *                      or "Suite #12, Building 123". An address can include information
+     *                      such as the street, building, location, city, state, country, county,
+     *                      zip code, precinct, and neighborhood. </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>AGE</b>
+     *                      </p>
+     *                      <p>An individual's age, including the quantity and unit of time. For
+     *                      example, in the phrase "I am 40 years old," Guarrails recognizes "40 years"
+     *                      as an age.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>NAME</b>
+     *                      </p>
+     *                      <p>An individual's name. This entity type does not include titles, such as
+     *                      Dr., Mr., Mrs., or Miss. guardrails doesn't apply this entity type to names that
+     *                      are part of organizations or addresses. For example, guardrails recognizes
+     *                      the "John Doe Organization" as an organization, and it recognizes "Jane Doe
+     *                      Street" as an address.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>EMAIL</b>
+     *                      </p>
+     *                      <p>An email address, such as <i>marymajor@email.com</i>.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>PHONE</b>
+     *                      </p>
+     *                      <p>A phone number. This entity type also includes fax and pager numbers.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>USERNAME</b>
+     *                      </p>
+     *                      <p>A user name that identifies an account, such as a login name, screen name,
+     *                      nick name, or handle.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>PASSWORD</b>
+     *                      </p>
+     *                      <p>An alphanumeric string that is used as a password, such as
+     *                      "*<i>very20special#pass*</i>".
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>DRIVER_ID</b>
+     *                      </p>
+     *                      <p>The number assigned to a driver's license, which is an official
+     *                      document permitting an individual to operate one or more motorized
+     *                      vehicles on a public road. A driver's license number consists of
+     *                      alphanumeric characters.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>LICENSE_PLATE</b>
+     *                      </p>
+     *                      <p>A license plate for a vehicle is issued by the state or country where
+     *                      the vehicle is registered. The format for passenger vehicles is typically
+     *                      five to eight digits, consisting of upper-case letters and numbers. The
+     *                      format varies depending on the location of the issuing state or country.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>VEHICLE_IDENTIFICATION_NUMBER</b>
+     *                      </p>
+     *                      <p>A Vehicle Identification Number (VIN) uniquely identifies a vehicle.
+     *                      VIN content and format are defined in the <i>ISO 3779</i> specification.
+     *                      Each country has specific codes and formats for VINs.
+     *                   </p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>Finance</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>REDIT_DEBIT_CARD_CVV</b>
+     *                      </p>
+     *                      <p>A three-digit card verification code (CVV) that is present on VISA,
+     *                   MasterCard, and Discover credit and debit cards. For American Express
+     *                   credit or debit cards, the CVV is a four-digit numeric code.
+     *                </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>CREDIT_DEBIT_CARD_EXPIRY</b>
+     *                      </p>
+     *                      <p>The expiration date for a credit or debit card. This number is usually
+     *                      four digits long and is often formatted as <i>month/year</i> or
+     *                      <i>MM/YY</i>. Guardrails recognizes expiration dates such as
+     *                      <i>01/21</i>, <i>01/2021</i>, and <i>Jan 2021</i>.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>CREDIT_DEBIT_CARD_NUMBER</b>
+     *                      </p>
+     *                      <p>The number for a credit or debit card. These numbers can vary from 13 to 16
+     *                      digits in length. However, Amazon Comprehend also recognizes credit or debit
+     *                      card numbers when only the last four digits are present.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>PIN</b>
+     *                      </p>
+     *                      <p>A four-digit personal identification number (PIN) with which you can
+     *                      access your bank account.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>INTERNATIONAL_BANK_ACCOUNT_NUMBER</b>
+     *                      </p>
+     *                      <p>An International Bank Account Number has specific formats in each country.
+     *                      For more information, see <a href="https://www.iban.com/structure">www.iban.com/structure</a>.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>SWIFT_CODE</b>
+     *                      </p>
+     *                      <p>A SWIFT code is a standard format of Bank Identifier Code (BIC) used to specify
+     *                      a particular bank or branch. Banks use these codes for money transfers such as
+     *                      international wire transfers.</p>
+     *                      <p>SWIFT codes consist of eight or 11 characters. The 11-digit codes refer to specific
+     *                      branches, while eight-digit codes (or 11-digit codes ending in 'XXX') refer to the
+     *                      head or primary office.</p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>IT</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>IP_ADDRESS</b>
+     *                      </p>
+     *                      <p>An IPv4 address, such as <i>198.51.100.0</i>.
+     *                </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>MAC_ADDRESS</b>
+     *                      </p>
+     *                      <p>A <i>media access control</i> (MAC) address is a unique identifier
+     *                      assigned to a network interface controller (NIC).
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>URL</b>
+     *                      </p>
+     *                      <p>A web address, such as <i>www.example.com</i>.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>AWS_ACCESS_KEY</b>
+     *                      </p>
+     *                      <p>A unique identifier that's associated with a secret access key;
+     *                      you use the access key ID and secret access key to sign programmatic
+     *                      Amazon Web Services requests cryptographically.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>AWS_SECRET_KEY</b>
+     *                      </p>
+     *                      <p>A unique identifier that's associated with an access key. You use the
+     *                      access key ID and secret access key to sign programmatic Amazon Web Services
+     *                      requests cryptographically.
+     *                   </p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>USA specific</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>US_BANK_ACCOUNT_NUMBER</b>
+     *                      </p>
+     *                      <p>A US bank account number, which is typically 10 to 12 digits long.
+     *                </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>US_BANK_ROUTING_NUMBER</b>
+     *                      </p>
+     *                      <p>A US bank account routing number. These are typically nine digits long,
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER</b>
+     *                      </p>
+     *                      <p>A US Individual Taxpayer Identification Number (ITIN) is a nine-digit number
+     *                      that starts with a "9" and contain a "7" or "8" as the fourth digit. An ITIN
+     *                      can be formatted with a space or a dash after the third and forth digits.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>US_PASSPORT_NUMBER</b>
+     *                      </p>
+     *                      <p>A US passport number. Passport numbers range from six to nine alphanumeric
+     *                      characters.
+     *                   </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>US_SOCIAL_SECURITY_NUMBER</b>
+     *                      </p>
+     *                      <p>A US Social Security Number (SSN) is a nine-digit number that is issued to
+     *                      US citizens, permanent residents, and temporary working residents.
+     *                   </p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>Canada specific</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>CA_HEALTH_NUMBER</b>
+     *                      </p>
+     *                      <p>A Canadian Health Service Number is a 10-digit unique identifier,
+     *                   required for individuals to access healthcare benefits.
+     *                </p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>CA_SOCIAL_INSURANCE_NUMBER</b>
+     *                      </p>
+     *                      <p>A Canadian Social Insurance Number (SIN) is a nine-digit unique identifier,
+     *                      required for individuals to access government programs and benefits.</p>
+     *                      <p>The SIN is formatted as three groups of three digits, such as
+     *                      <i>123-456-789</i>. A SIN can be validated through a simple
+     *                      check-digit process called the <a href="https://www.wikipedia.org/wiki/Luhn_algorithm">Luhn algorithm</a>.</p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>UK Specific</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>UK_NATIONAL_HEALTH_SERVICE_NUMBER</b>
+     *                      </p>
+     *                      <p>A UK National Health Service Number is a 10-17 digit number,
+     *                   such as <i>485 777 3456</i>. The current system formats the 10-digit
+     *                   number with spaces after the third and sixth digits. The final digit is an
+     *                   error-detecting checksum.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>UK_NATIONAL_INSURANCE_NUMBER</b>
+     *                      </p>
+     *                      <p>A UK National Insurance Number (NINO) provides individuals with access to National
+     *                      Insurance (social security) benefits. It is also used for some purposes in the UK
+     *                      tax system.</p>
+     *                      <p>The number is nine digits long and starts with two letters, followed by six
+     *                      numbers and one letter. A NINO can be formatted with a space or a dash after
+     *                      the two letters and after the second, forth, and sixth digits.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <b>UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER</b>
+     *                      </p>
+     *                      <p>A UK Unique Taxpayer Reference (UTR) is a 10-digit number that identifies a taxpayer or a business.
+     *                   </p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>Custom</b>
+     *                </p>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <b>Regex filter</b> - You can use
+     *                   a regular expressions to define patterns for a guardrail to recognize
+     *                   and act upon such as serial number, booking ID etc..</p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *          </ul>
      * @public
      */
     type: GuardrailPiiEntityType | undefined;
@@ -936,19 +1272,6 @@ export declare const GuardrailTopicType: {
 export type GuardrailTopicType = (typeof GuardrailTopicType)[keyof typeof GuardrailTopicType];
 /**
  * <p>Details about topics for the guardrail to identify and deny.</p>
- *          <p>This data type is used in the following API operations:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax">CreateGuardrail request body</a>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax">UpdateGuardrail request body</a>
- *                </p>
- *             </li>
- *          </ul>
  * @public
  */
 export interface GuardrailTopicConfig {
@@ -975,19 +1298,6 @@ export interface GuardrailTopicConfig {
 }
 /**
  * <p>Contains details about topics that the guardrail should identify and deny.</p>
- *          <p>This data type is used in the following API operations:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax">CreateGuardrail request body</a>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax">UpdateGuardrail request body</a>
- *                </p>
- *             </li>
- *          </ul>
  * @public
  */
 export interface GuardrailTopicPolicyConfig {
@@ -1080,6 +1390,11 @@ export interface CreateGuardrailRequest {
      * @public
      */
     sensitiveInformationPolicyConfig?: GuardrailSensitiveInformationPolicyConfig;
+    /**
+     * <p>The contextual grounding policy configuration used to create a guardrail.</p>
+     * @public
+     */
+    contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig;
     /**
      * <p>The message to return when the guardrail blocks a prompt.</p>
      * @public
@@ -1120,12 +1435,13 @@ export interface CreateGuardrailResponse {
      */
     guardrailId: string | undefined;
     /**
-     * <p>The ARN of the guardrail that was created.</p>
+     * <p>The ARN of the guardrail.</p>
      * @public
      */
     guardrailArn: string | undefined;
     /**
-     * <p>The version of the guardrail that was created. This value should be 1.</p>
+     * <p>The version of the guardrail that was created.
+     *          This value will always be <code>DRAFT</code>.</p>
      * @public
      */
     version: string | undefined;
@@ -1158,7 +1474,7 @@ export declare class TooManyTagsException extends __BaseException {
  */
 export interface CreateGuardrailVersionRequest {
     /**
-     * <p>The unique identifier of the guardrail.</p>
+     * <p>The unique identifier of the guardrail. This can be an ID or the ARN.</p>
      * @public
      */
     guardrailIdentifier: string | undefined;
@@ -1197,7 +1513,7 @@ export interface CreateGuardrailVersionResponse {
  */
 export interface DeleteGuardrailRequest {
     /**
-     * <p>The unique identifier of the guardrail.</p>
+     * <p>The unique identifier of the guardrail.  This can be an ID or the ARN.</p>
      * @public
      */
     guardrailIdentifier: string | undefined;
@@ -1217,7 +1533,7 @@ export interface DeleteGuardrailResponse {
  */
 export interface GetGuardrailRequest {
     /**
-     * <p>The unique identifier of the guardrail for which to get details.</p>
+     * <p>The unique identifier of the guardrail for which to get details.  This can be an ID or the ARN.</p>
      * @public
      */
     guardrailIdentifier: string | undefined;
@@ -1306,6 +1622,33 @@ export interface GuardrailContentPolicy {
      */
     filters?: GuardrailContentFilter[];
 }
+/**
+ * <p>The details for the guardrails contextual grounding filter.</p>
+ * @public
+ */
+export interface GuardrailContextualGroundingFilter {
+    /**
+     * <p>The filter type details for the guardrails contextual grounding filter.</p>
+     * @public
+     */
+    type: GuardrailContextualGroundingFilterType | undefined;
+    /**
+     * <p>The threshold details for the guardrails contextual grounding filter.</p>
+     * @public
+     */
+    threshold: number | undefined;
+}
+/**
+ * <p>The details for the guardrails contextual grounding policy.</p>
+ * @public
+ */
+export interface GuardrailContextualGroundingPolicy {
+    /**
+     * <p>The filter details for the guardrails contextual grounding policy.</p>
+     * @public
+     */
+    filters: GuardrailContextualGroundingFilter[] | undefined;
+}
 /**
  * <p>The PII entity configured for the guardrail.</p>
  * @public
@@ -1435,7 +1778,7 @@ export interface GuardrailTopicPolicy {
 }
 /**
  * <p>The managed word list that was configured for the guardrail.
- *          (This is a list of words that are pre-defined and managed by Guardrails only.)</p>
+ *          (This is a list of words that are pre-defined and managed by guardrails only.)</p>
  * @public
  */
 export interface GuardrailManagedWords {
@@ -1494,7 +1837,7 @@ export interface GetGuardrailResponse {
      */
     guardrailId: string | undefined;
     /**
-     * <p>The ARN of the guardrail that was created.</p>
+     * <p>The ARN of the guardrail.</p>
      * @public
      */
     guardrailArn: string | undefined;
@@ -1528,6 +1871,11 @@ export interface GetGuardrailResponse {
      * @public
      */
     sensitiveInformationPolicy?: GuardrailSensitiveInformationPolicy;
+    /**
+     * <p>The contextual grounding policy used in the guardrail.</p>
+     * @public
+     */
+    contextualGroundingPolicy?: GuardrailContextualGroundingPolicy;
     /**
      * <p>The date and time at which the guardrail was created.</p>
      * @public
@@ -1569,7 +1917,7 @@ export interface GetGuardrailResponse {
  */
 export interface ListGuardrailsRequest {
     /**
-     * <p>The unique identifier of the guardrail.</p>
+     * <p>The unique identifier of the guardrail.  This can be an ID or the ARN.</p>
      * @public
      */
     guardrailIdentifier?: string;
@@ -1658,7 +2006,7 @@ export interface ListGuardrailsResponse {
  */
 export interface UpdateGuardrailRequest {
     /**
-     * <p>The unique identifier of the guardrail</p>
+     * <p>The unique identifier of the guardrail.  This can be an ID or the ARN.</p>
      * @public
      */
     guardrailIdentifier: string | undefined;
@@ -1692,6 +2040,11 @@ export interface UpdateGuardrailRequest {
      * @public
      */
     sensitiveInformationPolicyConfig?: GuardrailSensitiveInformationPolicyConfig;
+    /**
+     * <p>The contextual grounding policy configuration used to update a guardrail.</p>
+     * @public
+     */
+    contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig;
     /**
      * <p>The message to return when the guardrail blocks a prompt.</p>
      * @public
@@ -1718,7 +2071,7 @@ export interface UpdateGuardrailResponse {
      */
     guardrailId: string | undefined;
     /**
-     * <p>The ARN of the guardrail that was created.</p>
+     * <p>The ARN of the guardrail.</p>
      * @public
      */
     guardrailArn: string | undefined;

package/dist-types/runtimeConfig.browser.d.ts

@@ -32,8 +32,8 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
         logger?: import("@smithy/types").Logger | undefined;
     }) => import("@smithy/types").EndpointV2;
     tls?: boolean | undefined;
-    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
+    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
     httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
     credentials?: import("@smithy/types").AwsCredentialIdentity | import("@smithy/types").AwsCredentialIdentityProvider | undefined;

package/dist-types/runtimeConfig.d.ts

@@ -32,8 +32,8 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
         logger?: import("@smithy/types").Logger | undefined;
     }) => import("@smithy/types").EndpointV2;
     tls?: boolean | undefined;
-    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
+    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
     httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
     credentials?: import("@smithy/types").AwsCredentialIdentity | import("@smithy/types").AwsCredentialIdentityProvider | undefined;

package/dist-types/runtimeConfig.native.d.ts

@@ -31,8 +31,8 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
         logger?: import("@smithy/types").Logger | undefined;
     }) => import("@smithy/types").EndpointV2;
     tls?: boolean | undefined;
-    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
+    retryStrategy?: import("@smithy/types").RetryStrategy | import("@smithy/types").RetryStrategyV2 | undefined;
     httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
     httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
     credentials?: import("@smithy/types").AwsCredentialIdentity | import("@smithy/types").AwsCredentialIdentityProvider | undefined;

package/dist-types/ts3.4/BedrockClient.d.ts

@@ -265,9 +265,9 @@ export type BedrockClientConfigType = Partial<
   ClientDefaults &
   RegionInputConfig &
   EndpointInputConfig<EndpointParameters> &
-  RetryInputConfig &
   HostHeaderInputConfig &
   UserAgentInputConfig &
+  RetryInputConfig &
   HttpAuthSchemeInputConfig &
   ClientInputEndpointParameters;
 export interface BedrockClientConfig extends BedrockClientConfigType {}
@@ -277,9 +277,9 @@ export type BedrockClientResolvedConfigType =
     RuntimeExtensionsConfig &
     RegionResolvedConfig &
     EndpointResolvedConfig<EndpointParameters> &
-    RetryResolvedConfig &
     HostHeaderResolvedConfig &
     UserAgentResolvedConfig &
+    RetryResolvedConfig &
     HttpAuthSchemeResolvedConfig &
     ClientResolvedEndpointParameters;
 export interface BedrockClientResolvedConfig

package/dist-types/ts3.4/models/models_0.d.ts

@@ -283,6 +283,19 @@ export interface GuardrailContentFilterConfig {
 export interface GuardrailContentPolicyConfig {
   filtersConfig: GuardrailContentFilterConfig[] | undefined;
 }
+export declare const GuardrailContextualGroundingFilterType: {
+  readonly GROUNDING: "GROUNDING";
+  readonly RELEVANCE: "RELEVANCE";
+};
+export type GuardrailContextualGroundingFilterType =
+  (typeof GuardrailContextualGroundingFilterType)[keyof typeof GuardrailContextualGroundingFilterType];
+export interface GuardrailContextualGroundingFilterConfig {
+  type: GuardrailContextualGroundingFilterType | undefined;
+  threshold: number | undefined;
+}
+export interface GuardrailContextualGroundingPolicyConfig {
+  filtersConfig: GuardrailContextualGroundingFilterConfig[] | undefined;
+}
 export declare const GuardrailSensitiveInformationAction: {
   readonly ANONYMIZE: "ANONYMIZE";
   readonly BLOCK: "BLOCK";
@@ -374,6 +387,7 @@ export interface CreateGuardrailRequest {
   contentPolicyConfig?: GuardrailContentPolicyConfig;
   wordPolicyConfig?: GuardrailWordPolicyConfig;
   sensitiveInformationPolicyConfig?: GuardrailSensitiveInformationPolicyConfig;
+  contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig;
   blockedInputMessaging: string | undefined;
   blockedOutputsMessaging: string | undefined;
   kmsKeyId?: string;
@@ -420,6 +434,13 @@ export interface GuardrailContentFilter {
 export interface GuardrailContentPolicy {
   filters?: GuardrailContentFilter[];
 }
+export interface GuardrailContextualGroundingFilter {
+  type: GuardrailContextualGroundingFilterType | undefined;
+  threshold: number | undefined;
+}
+export interface GuardrailContextualGroundingPolicy {
+  filters: GuardrailContextualGroundingFilter[] | undefined;
+}
 export interface GuardrailPiiEntity {
   type: GuardrailPiiEntityType | undefined;
   action: GuardrailSensitiveInformationAction | undefined;
@@ -474,6 +495,7 @@ export interface GetGuardrailResponse {
   contentPolicy?: GuardrailContentPolicy;
   wordPolicy?: GuardrailWordPolicy;
   sensitiveInformationPolicy?: GuardrailSensitiveInformationPolicy;
+  contextualGroundingPolicy?: GuardrailContextualGroundingPolicy;
   createdAt: Date | undefined;
   updatedAt: Date | undefined;
   statusReasons?: string[];
@@ -509,6 +531,7 @@ export interface UpdateGuardrailRequest {
   contentPolicyConfig?: GuardrailContentPolicyConfig;
   wordPolicyConfig?: GuardrailWordPolicyConfig;
   sensitiveInformationPolicyConfig?: GuardrailSensitiveInformationPolicyConfig;
+  contextualGroundingPolicyConfig?: GuardrailContextualGroundingPolicyConfig;
   blockedInputMessaging: string | undefined;
   blockedOutputsMessaging: string | undefined;
   kmsKeyId?: string;

package/dist-types/ts3.4/runtimeConfig.browser.d.ts

@@ -56,11 +56,11 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
     }
   ) => import("@smithy/types").EndpointV2;
   tls?: boolean | undefined;
+  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   retryStrategy?:
     | import("@smithy/types").RetryStrategy
     | import("@smithy/types").RetryStrategyV2
     | undefined;
-  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
   httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
   credentials?:

package/dist-types/ts3.4/runtimeConfig.d.ts

@@ -60,11 +60,11 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
     }
   ) => import("@smithy/types").EndpointV2;
   tls?: boolean | undefined;
+  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   retryStrategy?:
     | import("@smithy/types").RetryStrategy
     | import("@smithy/types").RetryStrategyV2
     | undefined;
-  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
   httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
   credentials?:

package/dist-types/ts3.4/runtimeConfig.native.d.ts

@@ -50,11 +50,11 @@ export declare const getRuntimeConfig: (config: BedrockClientConfig) => {
     }
   ) => import("@smithy/types").EndpointV2;
   tls?: boolean | undefined;
+  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   retryStrategy?:
     | import("@smithy/types").RetryStrategy
     | import("@smithy/types").RetryStrategyV2
     | undefined;
-  customUserAgent?: string | import("@smithy/types").UserAgent | undefined;
   httpAuthSchemes: import("@smithy/types").HttpAuthScheme[];
   httpAuthSchemeProvider: import("./auth/httpAuthSchemeProvider").BedrockHttpAuthSchemeProvider;
   credentials?:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-bedrock",
   "description": "AWS SDK for JavaScript Bedrock Client for Node.js, Browser and React Native",
-  "version": "3.613.0",
+  "version": "3.616.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-bedrock",
@@ -20,41 +20,41 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/client-sso-oidc": "3.613.0",
-    "@aws-sdk/client-sts": "3.613.0",
-    "@aws-sdk/core": "3.609.0",
-    "@aws-sdk/credential-provider-node": "3.613.0",
-    "@aws-sdk/middleware-host-header": "3.609.0",
+    "@aws-sdk/client-sso-oidc": "3.616.0",
+    "@aws-sdk/client-sts": "3.616.0",
+    "@aws-sdk/core": "3.616.0",
+    "@aws-sdk/credential-provider-node": "3.616.0",
+    "@aws-sdk/middleware-host-header": "3.616.0",
     "@aws-sdk/middleware-logger": "3.609.0",
-    "@aws-sdk/middleware-recursion-detection": "3.609.0",
-    "@aws-sdk/middleware-user-agent": "3.609.0",
-    "@aws-sdk/region-config-resolver": "3.609.0",
+    "@aws-sdk/middleware-recursion-detection": "3.616.0",
+    "@aws-sdk/middleware-user-agent": "3.616.0",
+    "@aws-sdk/region-config-resolver": "3.614.0",
     "@aws-sdk/types": "3.609.0",
-    "@aws-sdk/util-endpoints": "3.609.0",
+    "@aws-sdk/util-endpoints": "3.614.0",
     "@aws-sdk/util-user-agent-browser": "3.609.0",
-    "@aws-sdk/util-user-agent-node": "3.609.0",
-    "@smithy/config-resolver": "^3.0.4",
-    "@smithy/core": "^2.2.4",
-    "@smithy/fetch-http-handler": "^3.2.0",
+    "@aws-sdk/util-user-agent-node": "3.614.0",
+    "@smithy/config-resolver": "^3.0.5",
+    "@smithy/core": "^2.2.7",
+    "@smithy/fetch-http-handler": "^3.2.2",
     "@smithy/hash-node": "^3.0.3",
     "@smithy/invalid-dependency": "^3.0.3",
-    "@smithy/middleware-content-length": "^3.0.3",
-    "@smithy/middleware-endpoint": "^3.0.4",
-    "@smithy/middleware-retry": "^3.0.7",
+    "@smithy/middleware-content-length": "^3.0.4",
+    "@smithy/middleware-endpoint": "^3.0.5",
+    "@smithy/middleware-retry": "^3.0.10",
     "@smithy/middleware-serde": "^3.0.3",
     "@smithy/middleware-stack": "^3.0.3",
-    "@smithy/node-config-provider": "^3.1.3",
-    "@smithy/node-http-handler": "^3.1.1",
-    "@smithy/protocol-http": "^4.0.3",
-    "@smithy/smithy-client": "^3.1.5",
+    "@smithy/node-config-provider": "^3.1.4",
+    "@smithy/node-http-handler": "^3.1.3",
+    "@smithy/protocol-http": "^4.0.4",
+    "@smithy/smithy-client": "^3.1.8",
     "@smithy/types": "^3.3.0",
     "@smithy/url-parser": "^3.0.3",
     "@smithy/util-base64": "^3.0.0",
     "@smithy/util-body-length-browser": "^3.0.0",
     "@smithy/util-body-length-node": "^3.0.0",
-    "@smithy/util-defaults-mode-browser": "^3.0.7",
-    "@smithy/util-defaults-mode-node": "^3.0.7",
-    "@smithy/util-endpoints": "^2.0.4",
+    "@smithy/util-defaults-mode-browser": "^3.0.10",
+    "@smithy/util-defaults-mode-node": "^3.0.10",
+    "@smithy/util-endpoints": "^2.0.5",
     "@smithy/util-middleware": "^3.0.3",
     "@smithy/util-retry": "^3.0.3",
     "@smithy/util-utf8": "^3.0.0",