aws-sdk-bedrockruntime 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca1f2e9df0100f06e3bc0f31d305ff82c3e9642b99d2bac8926869ef74a27832
-  data.tar.gz: ddac8114e682d559799c345af4f9c7bdf3c46aa7fe1a3fbd515ba357b8a07e5e
+  metadata.gz: 5862bdfbd9b0c0e6f73b50e0634bbd28365979915a69acc172ad46da94625bf1
+  data.tar.gz: 2a26d1fc84073607038a3b2348e94b8ede6c84123b7c388bdc2b40bd5385751c
 SHA512:
-  metadata.gz: 713b147a86dd62555318bbccf3b18a464d8c9adffe9676c83daf3fdb07d6fa9e1d23962113124908ea1f2f54840aff67a90c785c81599ceac38f9163a4cba43a
-  data.tar.gz: 1bfe5c081028a50fa682ff19eaa221851a1f6a648dc23f55206d3eb32eac816dff3dced5f77cf54d510876291e9e8e9d340b64be5d87289919ba3cd01c7e3429
+  metadata.gz: ad0426abbab3f12a405da055f07973a73b65dacdcf843d7e4e1b3bf19a6410bfd4dc5e896921ca718550c7d7675196af9a17dcdd72a0cf20f88660e0795a65a5
+  data.tar.gz: 8cce902c4baa88c39f96d7b43bab1c6c2596855953757b8412bf1fa1e8dcc06052fdc85f29ef0afd72a6d3fa58000e8f867869f4bd87d03f2e880b2fafc691f4

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.42.0 (2025-03-31)
+------------------
+
+* Feature - Add Prompt Caching support to Converse and ConverseStream APIs
+
 1.41.0 (2025-03-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.41.0
+1.42.0

data/lib/aws-sdk-bedrockruntime/client.rb

@@ -869,6 +869,9 @@ module Aws::BedrockRuntime
     #                 },
     #               },
     #             },
+    #             cache_point: {
+    #               type: "default", # required, accepts default
+    #             },
     #             reasoning_content: {
     #               reasoning_text: {
     #                 text: "String", # required
@@ -895,6 +898,9 @@ module Aws::BedrockRuntime
     #             },
     #           },
     #         },
+    #         cache_point: {
+    #           type: "default", # required, accepts default
+    #         },
     #       },
     #     ],
     #     inference_config: {
@@ -914,6 +920,9 @@ module Aws::BedrockRuntime
     #               },
     #             },
     #           },
+    #           cache_point: {
+    #             type: "default", # required, accepts default
+    #           },
     #         },
     #       ],
     #       tool_choice: {
@@ -981,6 +990,7 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].guard_content.text.qualifiers[0] #=> String, one of "grounding_source", "query", "guard_content"
     #   resp.output.message.content[0].guard_content.image.format #=> String, one of "png", "jpeg"
     #   resp.output.message.content[0].guard_content.image.source.bytes #=> String
+    #   resp.output.message.content[0].cache_point.type #=> String, one of "default"
     #   resp.output.message.content[0].reasoning_content.reasoning_text.text #=> String
     #   resp.output.message.content[0].reasoning_content.reasoning_text.signature #=> String
     #   resp.output.message.content[0].reasoning_content.redacted_content #=> String
@@ -988,6 +998,8 @@ module Aws::BedrockRuntime
     #   resp.usage.input_tokens #=> Integer
     #   resp.usage.output_tokens #=> Integer
     #   resp.usage.total_tokens #=> Integer
+    #   resp.usage.cache_read_input_tokens #=> Integer
+    #   resp.usage.cache_write_input_tokens #=> Integer
     #   resp.metrics.latency_ms #=> Integer
     #   resp.trace.guardrail.model_output #=> Array
     #   resp.trace.guardrail.model_output[0] #=> String
@@ -1535,6 +1547,9 @@ module Aws::BedrockRuntime
     #                 },
     #               },
     #             },
+    #             cache_point: {
+    #               type: "default", # required, accepts default
+    #             },
     #             reasoning_content: {
     #               reasoning_text: {
     #                 text: "String", # required
@@ -1561,6 +1576,9 @@ module Aws::BedrockRuntime
     #             },
     #           },
     #         },
+    #         cache_point: {
+    #           type: "default", # required, accepts default
+    #         },
     #       },
     #     ],
     #     inference_config: {
@@ -1580,6 +1598,9 @@ module Aws::BedrockRuntime
     #               },
     #             },
     #           },
+    #           cache_point: {
+    #             type: "default", # required, accepts default
+    #           },
     #         },
     #       ],
     #       tool_choice: {
@@ -1646,6 +1667,8 @@ module Aws::BedrockRuntime
     #   event.usage.input_tokens #=> Integer
     #   event.usage.output_tokens #=> Integer
     #   event.usage.total_tokens #=> Integer
+    #   event.usage.cache_read_input_tokens #=> Integer
+    #   event.usage.cache_write_input_tokens #=> Integer
     #   event.metrics.latency_ms #=> Integer
     #   event.trace.guardrail.model_output #=> Array
     #   event.trace.guardrail.model_output[0] #=> String
@@ -2475,7 +2498,7 @@ module Aws::BedrockRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-bedrockruntime/client_api.rb

@@ -31,6 +31,8 @@ module Aws::BedrockRuntime
     AutoToolChoice = Shapes::StructureShape.new(name: 'AutoToolChoice')
     Blob = Shapes::BlobShape.new(name: 'Blob')
     Body = Shapes::BlobShape.new(name: 'Body')
+    CachePointBlock = Shapes::StructureShape.new(name: 'CachePointBlock')
+    CachePointType = Shapes::StringShape.new(name: 'CachePointType')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     ContentBlock = Shapes::UnionShape.new(name: 'ContentBlock')
     ContentBlockDelta = Shapes::UnionShape.new(name: 'ContentBlockDelta')
@@ -220,6 +222,8 @@ module Aws::BedrockRuntime
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp', timestampFormat: "iso8601")
     TokenUsage = Shapes::StructureShape.new(name: 'TokenUsage')
+    TokenUsageCacheReadInputTokensInteger = Shapes::IntegerShape.new(name: 'TokenUsageCacheReadInputTokensInteger')
+    TokenUsageCacheWriteInputTokensInteger = Shapes::IntegerShape.new(name: 'TokenUsageCacheWriteInputTokensInteger')
     TokenUsageInputTokensInteger = Shapes::IntegerShape.new(name: 'TokenUsageInputTokensInteger')
     TokenUsageOutputTokensInteger = Shapes::IntegerShape.new(name: 'TokenUsageOutputTokensInteger')
     TokenUsageTotalTokensInteger = Shapes::IntegerShape.new(name: 'TokenUsageTotalTokensInteger')
@@ -289,6 +293,9 @@ module Aws::BedrockRuntime
 
     AutoToolChoice.struct_class = Types::AutoToolChoice
 
+    CachePointBlock.add_member(:type, Shapes::ShapeRef.new(shape: CachePointType, required: true, location_name: "type"))
+    CachePointBlock.struct_class = Types::CachePointBlock
+
     ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     ConflictException.struct_class = Types::ConflictException
 
@@ -299,6 +306,7 @@ module Aws::BedrockRuntime
     ContentBlock.add_member(:tool_use, Shapes::ShapeRef.new(shape: ToolUseBlock, location_name: "toolUse"))
     ContentBlock.add_member(:tool_result, Shapes::ShapeRef.new(shape: ToolResultBlock, location_name: "toolResult"))
     ContentBlock.add_member(:guard_content, Shapes::ShapeRef.new(shape: GuardrailConverseContentBlock, location_name: "guardContent"))
+    ContentBlock.add_member(:cache_point, Shapes::ShapeRef.new(shape: CachePointBlock, location_name: "cachePoint"))
     ContentBlock.add_member(:reasoning_content, Shapes::ShapeRef.new(shape: ReasoningContentBlock, location_name: "reasoningContent"))
     ContentBlock.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     ContentBlock.add_member_subclass(:text, Types::ContentBlock::Text)
@@ -308,6 +316,7 @@ module Aws::BedrockRuntime
     ContentBlock.add_member_subclass(:tool_use, Types::ContentBlock::ToolUse)
     ContentBlock.add_member_subclass(:tool_result, Types::ContentBlock::ToolResult)
     ContentBlock.add_member_subclass(:guard_content, Types::ContentBlock::GuardContent)
+    ContentBlock.add_member_subclass(:cache_point, Types::ContentBlock::CachePoint)
     ContentBlock.add_member_subclass(:reasoning_content, Types::ContentBlock::ReasoningContent)
     ContentBlock.add_member_subclass(:unknown, Types::ContentBlock::Unknown)
     ContentBlock.struct_class = Types::ContentBlock
@@ -813,9 +822,11 @@ module Aws::BedrockRuntime
 
     SystemContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "text"))
     SystemContentBlock.add_member(:guard_content, Shapes::ShapeRef.new(shape: GuardrailConverseContentBlock, location_name: "guardContent"))
+    SystemContentBlock.add_member(:cache_point, Shapes::ShapeRef.new(shape: CachePointBlock, location_name: "cachePoint"))
     SystemContentBlock.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     SystemContentBlock.add_member_subclass(:text, Types::SystemContentBlock::Text)
     SystemContentBlock.add_member_subclass(:guard_content, Types::SystemContentBlock::GuardContent)
+    SystemContentBlock.add_member_subclass(:cache_point, Types::SystemContentBlock::CachePoint)
     SystemContentBlock.add_member_subclass(:unknown, Types::SystemContentBlock::Unknown)
     SystemContentBlock.struct_class = Types::SystemContentBlock
 
@@ -833,11 +844,15 @@ module Aws::BedrockRuntime
     TokenUsage.add_member(:input_tokens, Shapes::ShapeRef.new(shape: TokenUsageInputTokensInteger, required: true, location_name: "inputTokens"))
     TokenUsage.add_member(:output_tokens, Shapes::ShapeRef.new(shape: TokenUsageOutputTokensInteger, required: true, location_name: "outputTokens"))
     TokenUsage.add_member(:total_tokens, Shapes::ShapeRef.new(shape: TokenUsageTotalTokensInteger, required: true, location_name: "totalTokens"))
+    TokenUsage.add_member(:cache_read_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheReadInputTokensInteger, location_name: "cacheReadInputTokens"))
+    TokenUsage.add_member(:cache_write_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheWriteInputTokensInteger, location_name: "cacheWriteInputTokens"))
     TokenUsage.struct_class = Types::TokenUsage
 
     Tool.add_member(:tool_spec, Shapes::ShapeRef.new(shape: ToolSpecification, location_name: "toolSpec"))
+    Tool.add_member(:cache_point, Shapes::ShapeRef.new(shape: CachePointBlock, location_name: "cachePoint"))
     Tool.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     Tool.add_member_subclass(:tool_spec, Types::Tool::ToolSpec)
+    Tool.add_member_subclass(:cache_point, Types::Tool::CachePoint)
     Tool.add_member_subclass(:unknown, Types::Tool::Unknown)
     Tool.struct_class = Types::Tool
 

data/lib/aws-sdk-bedrockruntime/types.rb

@@ -208,6 +208,21 @@ module Aws::BedrockRuntime
     #
     class AutoToolChoice < Aws::EmptyStructure; end
 
+    # Defines a section of content to be cached for reuse in subsequent API
+    # calls.
+    #
+    # @!attribute [rw] type
+    #   Specifies the type of cache point within the CachePointBlock.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CachePointBlock AWS API Documentation
+    #
+    class CachePointBlock < Struct.new(
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Error occurred because of a conflict while performing an operation.
     #
     # @!attribute [rw] message
@@ -270,6 +285,10 @@ module Aws::BedrockRuntime
     #   the *Amazon Bedrock User Guide*.      </p>
     #   @return [Types::GuardrailConverseContentBlock]
     #
+    # @!attribute [rw] cache_point
+    #   CachePoint to include in the message.
+    #   @return [Types::CachePointBlock]
+    #
     # @!attribute [rw] reasoning_content
     #   Contains content regarding the reasoning that is carried out by the
     #   model. Reasoning refers to a Chain of Thought (CoT) that the model
@@ -286,6 +305,7 @@ module Aws::BedrockRuntime
       :tool_use,
       :tool_result,
       :guard_content,
+      :cache_point,
       :reasoning_content,
       :unknown)
       SENSITIVE = [:reasoning_content]
@@ -299,6 +319,7 @@ module Aws::BedrockRuntime
       class ToolUse < ContentBlock; end
       class ToolResult < ContentBlock; end
       class GuardContent < ContentBlock; end
+      class CachePoint < ContentBlock; end
       class ReasoningContent < ContentBlock; end
       class Unknown < ContentBlock; end
     end
@@ -2698,11 +2719,16 @@ module Aws::BedrockRuntime
     #   [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #   @return [Types::GuardrailConverseContentBlock]
     #
+    # @!attribute [rw] cache_point
+    #   CachePoint to include in the system prompt.
+    #   @return [Types::CachePointBlock]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SystemContentBlock AWS API Documentation
     #
     class SystemContentBlock < Struct.new(
       :text,
       :guard_content,
+      :cache_point,
       :unknown)
       SENSITIVE = []
       include Aws::Structure
@@ -2710,6 +2736,7 @@ module Aws::BedrockRuntime
 
       class Text < SystemContentBlock; end
       class GuardContent < SystemContentBlock; end
+      class CachePoint < SystemContentBlock; end
       class Unknown < SystemContentBlock; end
     end
 
@@ -2766,12 +2793,22 @@ module Aws::BedrockRuntime
     #   The total of input tokens and tokens generated by the model.
     #   @return [Integer]
     #
+    # @!attribute [rw] cache_read_input_tokens
+    #   The number of input tokens read from the cache for the request.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] cache_write_input_tokens
+    #   The number of input tokens written to the cache for the request.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/TokenUsage AWS API Documentation
     #
     class TokenUsage < Struct.new(
       :input_tokens,
       :output_tokens,
-      :total_tokens)
+      :total_tokens,
+      :cache_read_input_tokens,
+      :cache_write_input_tokens)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2790,16 +2827,22 @@ module Aws::BedrockRuntime
     #   The specfication for the tool.
     #   @return [Types::ToolSpecification]
     #
+    # @!attribute [rw] cache_point
+    #   CachePoint to include in the tool configuration.
+    #   @return [Types::CachePointBlock]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/Tool AWS API Documentation
     #
     class Tool < Struct.new(
       :tool_spec,
+      :cache_point,
       :unknown)
       SENSITIVE = []
       include Aws::Structure
       include Aws::Structure::Union
 
       class ToolSpec < Tool; end
+      class CachePoint < Tool; end
       class Unknown < Tool; end
     end
 

data/lib/aws-sdk-bedrockruntime.rb

@@ -56,7 +56,7 @@ module Aws::BedrockRuntime
   autoload :Endpoints, 'aws-sdk-bedrockruntime/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
 
-  GEM_VERSION = '1.41.0'
+  GEM_VERSION = '1.42.0'
 
 end
 

data/sig/client.rbs

@@ -204,6 +204,9 @@ module Aws
                                   }
                                 }?
                               }?,
+                              cache_point: {
+                                type: ("default")
+                              }?,
                               reasoning_content: {
                                 reasoning_text: {
                                   text: ::String,
@@ -229,6 +232,9 @@ module Aws
                                 bytes: ::String?
                               }
                             }?
+                          }?,
+                          cache_point: {
+                            type: ("default")
                           }?
                         },
                       ],
@@ -248,6 +254,9 @@ module Aws
                                 json: {
                                 }?
                               }
+                            }?,
+                            cache_point: {
+                              type: ("default")
                             }?
                           },
                         ],
@@ -367,6 +376,9 @@ module Aws
                                          }
                                        }?
                                      }?,
+                                     cache_point: {
+                                       type: ("default")
+                                     }?,
                                      reasoning_content: {
                                        reasoning_text: {
                                          text: ::String,
@@ -392,6 +404,9 @@ module Aws
                                        bytes: ::String?
                                      }
                                    }?
+                                 }?,
+                                 cache_point: {
+                                   type: ("default")
                                  }?
                                },
                              ],
@@ -411,6 +426,9 @@ module Aws
                                        json: {
                                        }?
                                      }
+                                   }?,
+                                   cache_point: {
+                                     type: ("default")
                                    }?
                                  },
                                ],

data/sig/types.rbs

@@ -67,6 +67,11 @@ module Aws::BedrockRuntime
     class AutoToolChoice < Aws::EmptyStructure
     end
 
+    class CachePointBlock
+      attr_accessor type: ("default")
+      SENSITIVE: []
+    end
+
     class ConflictException
       attr_accessor message: ::String
       SENSITIVE: []
@@ -80,6 +85,7 @@ module Aws::BedrockRuntime
       attr_accessor tool_use: Types::ToolUseBlock
       attr_accessor tool_result: Types::ToolResultBlock
       attr_accessor guard_content: Types::GuardrailConverseContentBlock
+      attr_accessor cache_point: Types::CachePointBlock
       attr_accessor reasoning_content: Types::ReasoningContentBlock
       attr_accessor unknown: untyped
       SENSITIVE: [:reasoning_content]
@@ -98,6 +104,8 @@ module Aws::BedrockRuntime
       end
       class GuardContent < ContentBlock
       end
+      class CachePoint < ContentBlock
+      end
       class ReasoningContent < ContentBlock
       end
       class Unknown < ContentBlock
@@ -740,6 +748,7 @@ module Aws::BedrockRuntime
     class SystemContentBlock
       attr_accessor text: ::String
       attr_accessor guard_content: Types::GuardrailConverseContentBlock
+      attr_accessor cache_point: Types::CachePointBlock
       attr_accessor unknown: untyped
       SENSITIVE: []
 
@@ -747,6 +756,8 @@ module Aws::BedrockRuntime
       end
       class GuardContent < SystemContentBlock
       end
+      class CachePoint < SystemContentBlock
+      end
       class Unknown < SystemContentBlock
       end
     end
@@ -767,16 +778,21 @@ module Aws::BedrockRuntime
       attr_accessor input_tokens: ::Integer
       attr_accessor output_tokens: ::Integer
       attr_accessor total_tokens: ::Integer
+      attr_accessor cache_read_input_tokens: ::Integer
+      attr_accessor cache_write_input_tokens: ::Integer
       SENSITIVE: []
     end
 
     class Tool
       attr_accessor tool_spec: Types::ToolSpecification
+      attr_accessor cache_point: Types::CachePointBlock
       attr_accessor unknown: untyped
       SENSITIVE: []
 
       class ToolSpec < Tool
       end
+      class CachePoint < Tool
+      end
       class Unknown < Tool
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockruntime
 version: !ruby/object:Gem::Version
-  version: 1.41.0
+  version: 1.42.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-28 00:00:00.000000000 Z
+date: 2025-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core