chore(guardrails): Add support for input/output modalities in Bedrock guardrails content filter (#1076)

* chore(cdk): upgrade base version to 2.189 and add input output modalities for guardrails

Author: krokoko

.projen/deps.json

@@ -29,7 +29,7 @@ import {
 const GITHUB_USER = 'awslabs';
 const PUBLICATION_NAMESPACE = 'cdklabs';
 const PROJECT_NAME = 'generative-ai-cdk-constructs';
-const CDK_VERSION: string = '2.188.0';
+const CDK_VERSION: string = '2.189.0';
 
 function camelCaseIt(input: string): string {
   // Hypens and dashes to spaces and then CamelCase...

.projenrc.ts

@@ -1,3 +1,7 @@
+# CDK Generative AI Constructs V0.1.302 (2025-04-11)
+
+Based on CDK library version 2.189.0
+
 # CDK Generative AI Constructs V0.1.300 (2025-04-04)
 
 Based on CDK library version 2.188.0

CHANGELOG.md

@@ -16,7 +16,7 @@ Default output format [None]: json
 ```
 
 - [Node](https://nodejs.org/en) >= v20.9.0
-- [AWS CDK](https://github.com/aws/aws-cdk/releases/tag/v2.188.0) >= 2.188.0
+- [AWS CDK](https://github.com/aws/aws-cdk/releases/tag/v2.189.0) >= 2.189.0
 - [Python](https://www.python.org/downloads/) >=3.9
 - [Projen](https://github.com/projen/projen) >= 0.91.5
 - [Yarn](https://classic.yarnpkg.com/lang/en/docs/cli/install/) >= 1.22.19

DEVELOPER_GUIDE.md

@@ -30,6 +30,7 @@
 - [InferenceProfileType](enumerations/InferenceProfileType.md)
 - [KnowledgeBaseType](enumerations/KnowledgeBaseType.md)
 - [ManagedWordFilterType](enumerations/ManagedWordFilterType.md)
+- [ModalityType](enumerations/ModalityType.md)
 - [OrchestrationType](enumerations/OrchestrationType.md)
 - [ParsingModality](enumerations/ParsingModality.md)
 - [ParsingStategyType](enumerations/ParsingStategyType.md)

apidocs/@cdklabs/namespaces/bedrock/README.md

@@ -0,0 +1,25 @@
+[**@cdklabs/generative-ai-cdk-constructs**](../../../../README.md)
+
+***
+
+[@cdklabs/generative-ai-cdk-constructs](../../../../README.md) / [bedrock](../README.md) / ModalityType
+
+# Enumeration: ModalityType
+
+The type of modality that can be used in content filters.
+
+## Enumeration Members
+
+### IMAGE
+
+> **IMAGE**: `"IMAGE"`
+
+Image modality for content filters.
+
+***
+
+### TEXT
+
+> **TEXT**: `"TEXT"`
+
+Text modality for content filters.

apidocs/@cdklabs/namespaces/bedrock/enumerations/ModalityType.md

@@ -10,6 +10,20 @@ Interface to declare a content filter.
 
 ## Properties
 
+### inputModalities?
+
+> `readonly` `optional` **inputModalities**: [`ModalityType`](../enumerations/ModalityType.md)[]
+
+The input modalities to apply the content filter to.
+
+#### Default
+
+```ts
+undefined - Applies to text modality
+```
+
+***
+
 ### inputStrength
 
 > `readonly` **inputStrength**: [`ContentFilterStrength`](../enumerations/ContentFilterStrength.md)
@@ -18,6 +32,20 @@ The strength of the content filter to apply to prompts / user input.
 
 ***
 
+### outputModalities?
+
+> `readonly` `optional` **outputModalities**: [`ModalityType`](../enumerations/ModalityType.md)[]
+
+The output modalities to apply the content filter to.
+
+#### Default
+
+```ts
+undefined - Applies to text modality
+```
+
+***
+
 ### outputStrength
 
 > `readonly` **outputStrength**: [`ContentFilterStrength`](../enumerations/ContentFilterStrength.md)

apidocs/@cdklabs/namespaces/bedrock/interfaces/ContentFilter.md

@@ -82,6 +82,8 @@ guardrail.addContentFilter({
   type: ContentFilterType.SEXUAL,
   inputStrength: ContentFilterStrength.HIGH,
   outputStrength: ContentFilterStrength.MEDIUM,
+  inputModalities: [ModalityType.TEXT, ModalityType.IMAGE],
+  outputModalities: [ModalityType.TEXT],
 });
 ```
 
@@ -92,6 +94,8 @@ guardrail.add_content_filter(
   type=ContentFilterType.SEXUAL,
   input_strength=ContentFilterStrength.HIGH,
   output_strength=ContentFilterStrength.MEDIUM,
+  input_modalities=[ModalityType.TEXT, ModalityType.IMAGE],
+  output_modalities=[ModalityType.TEXT],
 );
 ```
 
@@ -111,6 +115,11 @@ Available content filter strengths:
 - `MEDIUM`: Moderate filtering
 - `HIGH`: Strict filtering
 
+Available modality types:
+
+- `TEXT`: Text modality for content filters
+- `IMAGE`: Image modality for content filters
+
 ### Denied Topics
 
 Denied topics allow you to 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.

package.json

@@ -26,6 +26,20 @@ export enum ContentFilterStrength {
   HIGH = 'HIGH',
 }
 
+/**
+ * The type of modality that can be used in content filters.
+ */
+export enum ModalityType {
+  /**
+   * Text modality for content filters.
+   */
+  TEXT = 'TEXT',
+  /**
+   * Image modality for content filters.
+   */
+  IMAGE = 'IMAGE',
+}
+
 /**
  * The type of harmful category usable in a content filter.
  */
@@ -82,6 +96,16 @@ export interface ContentFilter {
    * The strength of the content filter to apply to model responses.
    */
   readonly outputStrength: ContentFilterStrength;
+  /**
+   * The input modalities to apply the content filter to.
+   * @default undefined - Applies to text modality
+   */
+  readonly inputModalities?: ModalityType[];
+  /**
+   * The output modalities to apply the content filter to.
+   * @default undefined - Applies to text modality
+   */
+  readonly outputModalities?: ModalityType[];
 }
 
 /******************************************************************************