aws-sdk-bedrockagentruntime 1.88.0 → 1.89.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0818a6409c26b6829283dfdb1e1fd2d70236226bdc11f829846e7ae41393130b'
-  data.tar.gz: 548f3e0b6aa790c36f57e8171f89977f357034c846c8bbfff685632e69fc6357
+  metadata.gz: 7ef227c8d78abb9057d66abbdf5731e2d2033074eec8d22c5cef7037a5f94d4c
+  data.tar.gz: 270cc2869b21ab59cc1733d71f85f61c1932cb28a14246ecfc2dc98f64d4f9ce
 SHA512:
-  metadata.gz: 31744d38ba58bc0f1726bab3e5740778917b4fcc474aa76eb65239ea7b95e7eba61e571eea5a8ff366c61bc88d65c53ffd7ba2830da09223fbc072f9b7b18078
-  data.tar.gz: c022a7f9e098c09159259515c8506705fd5c28e43d43e773786c8e7ad86a04d7aa297b3328970c72e899b170728f5025dc8bc585e3274ec66b3c07efbcf38439
+  metadata.gz: 40b7d55d8e5bdf2e33694d56e93419dbd0972b5c5416339c2079db2f9ee9cbe6d118907482fe67cfae57f614c896c4847f16b0016135b0af0b47118eec1ca0c8
+  data.tar.gz: daafadf01f7311e466a066230429a695406ef1f6714f03c21acae4e539c6020f307b411d820757b8c64ad852a2f6038a0f0e331eb36541c34c145c44a385cea6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.89.0 (2026-10-30)
+------------------
+
+* Feature - Adds the CodeExecution step and codeExecution action to AgenticRetrieveStream trace events, showing when the agent runs code and which documents it reads.
+
 1.88.0 (2026-10-29)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.88.0
+1.89.0

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

@@ -945,6 +945,9 @@ module Aws::BedrockAgentRuntime
     #
     #   # For :trace_event event available at #on_trace_event_event callback and response eventstream enumerator:
     #   event.attributes.actions #=> Array
+    #   event.attributes.actions[0].code_execution.documents #=> Array
+    #   event.attributes.actions[0].code_execution.documents[0].document_id #=> String
+    #   event.attributes.actions[0].code_execution.documents[0].source_retriever.identifier #=> String
     #   event.attributes.actions[0].full_document_expansion.document_id #=> String
     #   event.attributes.actions[0].full_document_expansion.source_retriever.identifier #=> String
     #   event.attributes.actions[0].memory_retrieve.input_query.text #=> String
@@ -970,7 +973,7 @@ module Aws::BedrockAgentRuntime
     #   event.attributes.retrieval_response[0].metadata #=> Hash
     #   event.attributes.retrieval_response[0].source_retriever.identifier #=> String
     #   event.attributes.status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED"
-    #   event.attributes.step #=> String, one of "Planning", "Retrieval", "SpeculativeRetrieval", "FullDocumentExpansion", "SessionHistoryLoad"
+    #   event.attributes.step #=> String, one of "Planning", "Retrieval", "SpeculativeRetrieval", "FullDocumentExpansion", "SessionHistoryLoad", "CodeExecution"
     #   event.attributes.warnings #=> Array
     #   event.attributes.warnings[0].guardrail.action #=> String, one of "INTERVENED", "NONE"
     #   event.attributes.warnings[0].guardrail.id #=> String
@@ -8489,7 +8492,7 @@ module Aws::BedrockAgentRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentruntime'
-      context[:gem_version] = '1.88.0'
+      context[:gem_version] = '1.89.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -59,6 +59,9 @@ module Aws::BedrockAgentRuntime
     AgenticRetrieveCitationList = Shapes::ListShape.new(name: 'AgenticRetrieveCitationList')
     AgenticRetrieveCitationReference = Shapes::StructureShape.new(name: 'AgenticRetrieveCitationReference')
     AgenticRetrieveCitationReferenceList = Shapes::ListShape.new(name: 'AgenticRetrieveCitationReferenceList')
+    AgenticRetrieveCodeExecutionDetails = Shapes::StructureShape.new(name: 'AgenticRetrieveCodeExecutionDetails')
+    AgenticRetrieveCodeExecutionDocument = Shapes::StructureShape.new(name: 'AgenticRetrieveCodeExecutionDocument')
+    AgenticRetrieveCodeExecutionDocumentList = Shapes::ListShape.new(name: 'AgenticRetrieveCodeExecutionDocumentList')
     AgenticRetrieveConfiguration = Shapes::StructureShape.new(name: 'AgenticRetrieveConfiguration')
     AgenticRetrieveConfigurationMaxAgentIterationInteger = Shapes::IntegerShape.new(name: 'AgenticRetrieveConfigurationMaxAgentIterationInteger')
     AgenticRetrieveFailure = Shapes::StructureShape.new(name: 'AgenticRetrieveFailure')
@@ -793,6 +796,7 @@ module Aws::BedrockAgentRuntime
 
     AgentTraces.member = Shapes::ShapeRef.new(shape: TracePart, event: true)
 
+    AgenticRetrieveAction.add_member(:code_execution, Shapes::ShapeRef.new(shape: AgenticRetrieveCodeExecutionDetails, location_name: "codeExecution"))
     AgenticRetrieveAction.add_member(:full_document_expansion, Shapes::ShapeRef.new(shape: AgenticRetrieveFullDocExpansionDetails, location_name: "fullDocumentExpansion"))
     AgenticRetrieveAction.add_member(:memory_retrieve, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryRetrieveDetails, location_name: "memoryRetrieve"))
     AgenticRetrieveAction.add_member(:retrieve, Shapes::ShapeRef.new(shape: AgenticRetrieveActionDetails, location_name: "retrieve"))
@@ -830,6 +834,15 @@ module Aws::BedrockAgentRuntime
 
     AgenticRetrieveCitationReferenceList.member = Shapes::ShapeRef.new(shape: AgenticRetrieveCitationReference)
 
+    AgenticRetrieveCodeExecutionDetails.add_member(:documents, Shapes::ShapeRef.new(shape: AgenticRetrieveCodeExecutionDocumentList, location_name: "documents"))
+    AgenticRetrieveCodeExecutionDetails.struct_class = Types::AgenticRetrieveCodeExecutionDetails
+
+    AgenticRetrieveCodeExecutionDocument.add_member(:document_id, Shapes::ShapeRef.new(shape: String, location_name: "documentId"))
+    AgenticRetrieveCodeExecutionDocument.add_member(:source_retriever, Shapes::ShapeRef.new(shape: AgenticRetrieveSourceRetriever, location_name: "sourceRetriever"))
+    AgenticRetrieveCodeExecutionDocument.struct_class = Types::AgenticRetrieveCodeExecutionDocument
+
+    AgenticRetrieveCodeExecutionDocumentList.member = Shapes::ShapeRef.new(shape: AgenticRetrieveCodeExecutionDocument)
+
     AgenticRetrieveConfiguration.add_member(:foundation_model_configuration, Shapes::ShapeRef.new(shape: FoundationModelConfiguration, location_name: "foundationModelConfiguration"))
     AgenticRetrieveConfiguration.add_member(:foundation_model_type, Shapes::ShapeRef.new(shape: FoundationModelType, location_name: "foundationModelType"))
     AgenticRetrieveConfiguration.add_member(:max_agent_iteration, Shapes::ShapeRef.new(shape: AgenticRetrieveConfigurationMaxAgentIterationInteger, location_name: "maxAgentIteration"))

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

@@ -380,6 +380,10 @@ module Aws::BedrockAgentRuntime
 
     # An action taken during agentic retrieval.
     #
+    # @!attribute [rw] code_execution
+    #   The details of code that the agent chose to run.
+    #   @return [Types::AgenticRetrieveCodeExecutionDetails]
+    #
     # @!attribute [rw] full_document_expansion
     #   Details of a full document expansion action.
     #   @return [Types::AgenticRetrieveFullDocExpansionDetails]
@@ -396,6 +400,7 @@ module Aws::BedrockAgentRuntime
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveAction AWS API Documentation
     #
     class AgenticRetrieveAction < Struct.new(
+      :code_execution,
       :full_document_expansion,
       :memory_retrieve,
       :retrieve)
@@ -532,6 +537,42 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
+    # The details of code that the agent chose to run in an isolated
+    # sandbox. The record includes the documents that the code reads. The
+    # corresponding CodeExecution step reports the outcome.
+    #
+    # @!attribute [rw] documents
+    #   The documents that the code reads. This field is present when the
+    #   code reads documents.
+    #   @return [Array<Types::AgenticRetrieveCodeExecutionDocument>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveCodeExecutionDetails AWS API Documentation
+    #
+    class AgenticRetrieveCodeExecutionDetails < Struct.new(
+      :documents)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A document that a code execution action reads.
+    #
+    # @!attribute [rw] document_id
+    #   The identifier of the document.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_retriever
+    #   The source retriever associated with the document.
+    #   @return [Types::AgenticRetrieveSourceRetriever]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveCodeExecutionDocument AWS API Documentation
+    #
+    class AgenticRetrieveCodeExecutionDocument < Struct.new(
+      :document_id,
+      :source_retriever)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration settings for the agentic retrieval operation.
     #
     # @!attribute [rw] foundation_model_configuration

data/lib/aws-sdk-bedrockagentruntime.rb

@@ -56,7 +56,7 @@ module Aws::BedrockAgentRuntime
   autoload :Endpoints, 'aws-sdk-bedrockagentruntime/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentruntime/event_streams'
 
-  GEM_VERSION = '1.88.0'
+  GEM_VERSION = '1.89.0'
 
 end
 

data/sig/types.rbs

@@ -101,6 +101,7 @@ module Aws::BedrockAgentRuntime
     end
 
     class AgenticRetrieveAction
+      attr_accessor code_execution: Types::AgenticRetrieveCodeExecutionDetails
       attr_accessor full_document_expansion: Types::AgenticRetrieveFullDocExpansionDetails
       attr_accessor memory_retrieve: Types::AgenticRetrieveMemoryRetrieveDetails
       attr_accessor retrieve: Types::AgenticRetrieveActionDetails
@@ -147,6 +148,17 @@ module Aws::BedrockAgentRuntime
       SENSITIVE: []
     end
 
+    class AgenticRetrieveCodeExecutionDetails
+      attr_accessor documents: ::Array[Types::AgenticRetrieveCodeExecutionDocument]
+      SENSITIVE: []
+    end
+
+    class AgenticRetrieveCodeExecutionDocument
+      attr_accessor document_id: ::String
+      attr_accessor source_retriever: Types::AgenticRetrieveSourceRetriever
+      SENSITIVE: []
+    end
+
     class AgenticRetrieveConfiguration
       attr_accessor foundation_model_configuration: Types::FoundationModelConfiguration
       attr_accessor foundation_model_type: ("CUSTOM" | "MANAGED")
@@ -355,7 +367,7 @@ module Aws::BedrockAgentRuntime
       attr_accessor retrieval_metadata: ::Array[Types::AgenticRetrieveSourceMetadata]
       attr_accessor retrieval_response: ::Array[Types::AgenticRetrieveTraceResultItem]
       attr_accessor status: ("IN_PROGRESS" | "SUCCEEDED" | "FAILED")
-      attr_accessor step: ("Planning" | "Retrieval" | "SpeculativeRetrieval" | "FullDocumentExpansion" | "SessionHistoryLoad")
+      attr_accessor step: ("Planning" | "Retrieval" | "SpeculativeRetrieval" | "FullDocumentExpansion" | "SessionHistoryLoad" | "CodeExecution")
       attr_accessor warnings: ::Array[Types::AgenticRetrieveWarning]
       SENSITIVE: []
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentruntime
 version: !ruby/object:Gem::Version
-  version: 1.88.0
+  version: 1.89.0
 platform: ruby
 authors:
 - Amazon Web Services