aws-sdk-bedrockagentcore 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c047c703a0ae7e8f52fc6a21180661f2d490769b7839784702a4e12075fa7524
-  data.tar.gz: b05100a80f4adeca168ba2b441e6f733d741c6809cfe5a17e0a943f5c7653c1f
+  metadata.gz: 6cf6efdb1b8b291989d092843e5e81a80a3c2b916143e8ff904352b48370257b
+  data.tar.gz: 750aef105630b948d1d83b8420432e371fe279136a51e201f4ec48277f5f7282
 SHA512:
-  metadata.gz: b2b3fecd3b8dfe858fb8aedb18f71bd8134fb4f1cc54629204823abef71a6c4097cd842cc5d3b730cb96a1d253047943ed09b59b988c144a01085de22d274fcc
-  data.tar.gz: 77788c54c669de649cfa1ca453103efa529a3c0b6b68d11baa1cc7669abb2b583c6f876b12ad0c608c1756534b8e58db175ba1da4062ac1a0502f16fa72cf3cf
+  metadata.gz: fa246e0407cb4393fb348a5ee50285372bd55418e712e5d3ce1572604a7d4876904638526a1b3350343b8b2115efa8a082d9b185a2ec947ebc9296db4ba784f0
+  data.tar.gz: 9e9ccdaabb657bcd1f9fdd03f109eb1b4ce2cbd5d0cbb97bf6f4c2a6a7d7d92f338e333964809234962fc365703f2eb5e9c4da5e7164053d115aab454d0bbb95

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.20.0 (2026-03-16)
+------------------
+
+* Feature - Provide support to perform deterministic operations on agent runtime through shell command executions via the new InvokeAgentRuntimeCommand API
+
 1.19.0 (2026-02-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

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

@@ -1456,9 +1456,11 @@ module Aws::BedrockAgentCore
     # Sends a request to an agent or tool hosted in an Amazon Bedrock
     # AgentCore Runtime and receives responses in real-time.
     #
-    # To invoke an agent you must specify the AgentCore Runtime ARN and
-    # provide a payload containing your request. You can optionally specify
-    # a qualifier to target a specific version or endpoint of the agent.
+    # To invoke an agent, you can specify either the AgentCore Runtime ARN
+    # or the agent ID with an account ID, and provide a payload containing
+    # your request. When you use the agent ID instead of the full ARN, you
+    # don't need to URL-encode the identifier. You can optionally specify a
+    # qualifier to target a specific endpoint of the agent.
     #
     # This operation supports streaming responses, allowing you to receive
     # partial responses as they become available. We recommend using
@@ -1522,19 +1524,20 @@ module Aws::BedrockAgentCore
     #   Additional context information for distributed tracing.
     #
     # @option params [required, String] :agent_runtime_arn
-    #   The Amazon Web Services Resource Name (ARN) of the agent runtime to
-    #   invoke. The ARN uniquely identifies the agent runtime resource in
-    #   Amazon Bedrock AgentCore.
+    #   The identifier of the agent runtime to invoke. You can specify either
+    #   the full Amazon Web Services Resource Name (ARN) or the agent ID. If
+    #   you use the agent ID, you must also provide the `accountId` query
+    #   parameter.
     #
     # @option params [String] :qualifier
-    #   The qualifier to use for the agent runtime. This can be a version
-    #   number or an endpoint name that points to a specific version. If not
-    #   specified, Amazon Bedrock AgentCore uses the default version of the
-    #   agent runtime.
+    #   The qualifier to use for the agent runtime. This is an endpoint name
+    #   that points to a specific version. If not specified, Amazon Bedrock
+    #   AgentCore uses the default endpoint of the agent runtime.
     #
     # @option params [String] :account_id
     #   The identifier of the Amazon Web Services account for the agent
-    #   runtime resource.
+    #   runtime resource. This parameter is required when you specify an agent
+    #   ID instead of the full ARN for `agentRuntimeArn`.
     #
     # @option params [required, String, StringIO, File] :payload
     #   The input data to send to the agent runtime. The format of this data
@@ -1596,6 +1599,302 @@ module Aws::BedrockAgentCore
       req.send_request(options, &block)
     end
 
+    # Executes a command in a runtime session container. Returns streaming
+    # output with contentStart, contentDelta, and contentStop events.
+    #
+    # @option params [String] :content_type
+    #   The MIME type of the input data in the request payload. This tells the
+    #   agent runtime how to interpret the payload data. Common values include
+    #   application/json for JSON data.
+    #
+    # @option params [String] :accept
+    #   The desired MIME type for the response from the agent runtime command.
+    #   This tells the agent runtime what format to use for the response data.
+    #   Common values include application/json for JSON data.
+    #
+    # @option params [String] :runtime_session_id
+    #   Runtime session identifier
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [String] :trace_id
+    #   The trace identifier for request tracking.
+    #
+    # @option params [String] :trace_parent
+    #   The parent trace information for distributed tracing.
+    #
+    # @option params [String] :trace_state
+    #   The trace state information for distributed tracing.
+    #
+    # @option params [String] :baggage
+    #   Additional context information for distributed tracing.
+    #
+    # @option params [required, String] :agent_runtime_arn
+    #   ARN of the agent runtime
+    #
+    # @option params [String] :qualifier
+    #   Version or alias qualifier
+    #
+    # @option params [String] :account_id
+    #   Account ID (12 digits)
+    #
+    # @option params [required, Types::InvokeAgentRuntimeCommandRequestBody] :body
+    #   Request body containing command and timeout
+    #
+    # @return [Types::InvokeAgentRuntimeCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::InvokeAgentRuntimeCommandResponse#runtime_session_id #runtime_session_id} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#trace_id #trace_id} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#trace_parent #trace_parent} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#trace_state #trace_state} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#baggage #baggage} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#content_type #content_type} => String
+    #   * {Types::InvokeAgentRuntimeCommandResponse#status_code #status_code} => Integer
+    #   * {Types::InvokeAgentRuntimeCommandResponse#stream #stream} => Types::InvokeAgentRuntimeCommandStreamOutput
+    #
+    # @example EventStream Operation Example
+    #
+    #   # You can process the event once it arrives immediately, or wait until the
+    #   # full response is complete and iterate through the eventstream enumerator.
+    #
+    #   # To interact with event immediately, you need to register invoke_agent_runtime_command
+    #   # with callbacks. Callbacks can be registered for specific events or for all
+    #   # events, including error events.
+    #
+    #   # Callbacks can be passed into the `:event_stream_handler` option or within a
+    #   # block statement attached to the #invoke_agent_runtime_command call directly. Hybrid
+    #   # pattern of both is also supported.
+    #
+    #   # `:event_stream_handler` option takes in either a Proc object or
+    #   # Aws::BedrockAgentCore::EventStreams::InvokeAgentRuntimeCommandStreamOutput object.
+    #
+    #   # Usage pattern a): Callbacks with a block attached to #invoke_agent_runtime_command
+    #   # Example for registering callbacks for all event types and an error event
+    #   client.invoke_agent_runtime_command(
+    #     # params input
+    #   ) do |stream|
+    #     stream.on_error_event do |event|
+    #       # catch unmodeled error event in the stream
+    #       raise event
+    #       # => Aws::Errors::EventError
+    #       # event.event_type => :error
+    #       # event.error_code => String
+    #       # event.error_message => String
+    #     end
+    #
+    #     stream.on_event do |event|
+    #       # process all events arrive
+    #       puts event.event_type
+    #       # ...
+    #     end
+    #   end
+    #
+    #   # Usage pattern b): Pass in `:event_stream_handler` for #invoke_agent_runtime_command
+    #   #  1) Create a Aws::BedrockAgentCore::EventStreams::InvokeAgentRuntimeCommandStreamOutput object
+    #   #  Example for registering callbacks with specific events
+    #
+    #   handler = Aws::BedrockAgentCore::EventStreams::InvokeAgentRuntimeCommandStreamOutput.new
+    #   handler.on_chunk_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::chunk
+    #   end
+    #   handler.on_access_denied_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::accessDeniedException
+    #   end
+    #   handler.on_internal_server_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::internalServerException
+    #   end
+    #   handler.on_resource_not_found_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::resourceNotFoundException
+    #   end
+    #   handler.on_service_quota_exceeded_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::serviceQuotaExceededException
+    #   end
+    #   handler.on_throttling_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::throttlingException
+    #   end
+    #   handler.on_validation_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::validationException
+    #   end
+    #   handler.on_runtime_client_error_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::runtimeClientError
+    #   end
+    #
+    #   client.invoke_agent_runtime_command(
+    #     # params inputs
+    #     event_stream_handler: handler
+    #   )
+    #
+    #   #  2) Use a Ruby Proc object
+    #   #  Example for registering callbacks with specific events
+    #   handler = Proc.new do |stream|
+    #     stream.on_chunk_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::chunk
+    #     end
+    #     stream.on_access_denied_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::accessDeniedException
+    #     end
+    #     stream.on_internal_server_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::internalServerException
+    #     end
+    #     stream.on_resource_not_found_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::resourceNotFoundException
+    #     end
+    #     stream.on_service_quota_exceeded_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::serviceQuotaExceededException
+    #     end
+    #     stream.on_throttling_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::throttlingException
+    #     end
+    #     stream.on_validation_exception_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::validationException
+    #     end
+    #     stream.on_runtime_client_error_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::runtimeClientError
+    #     end
+    #   end
+    #
+    #   client.invoke_agent_runtime_command(
+    #     # params inputs
+    #     event_stream_handler: handler
+    #   )
+    #
+    #   #  Usage pattern c): Hybrid pattern of a) and b)
+    #   handler = Aws::BedrockAgentCore::EventStreams::InvokeAgentRuntimeCommandStreamOutput.new
+    #   handler.on_chunk_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::chunk
+    #   end
+    #   handler.on_access_denied_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::accessDeniedException
+    #   end
+    #   handler.on_internal_server_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::internalServerException
+    #   end
+    #   handler.on_resource_not_found_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::resourceNotFoundException
+    #   end
+    #   handler.on_service_quota_exceeded_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::serviceQuotaExceededException
+    #   end
+    #   handler.on_throttling_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::throttlingException
+    #   end
+    #   handler.on_validation_exception_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::validationException
+    #   end
+    #   handler.on_runtime_client_error_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::runtimeClientError
+    #   end
+    #
+    #   client.invoke_agent_runtime_command(
+    #     # params input
+    #     event_stream_handler: handler
+    #   ) do |stream|
+    #     stream.on_error_event do |event|
+    #       # catch unmodeled error event in the stream
+    #       raise event
+    #       # => Aws::Errors::EventError
+    #       # event.event_type => :error
+    #       # event.error_code => String
+    #       # event.error_message => String
+    #     end
+    #   end
+    #
+    #   # You can also iterate through events after the response complete.
+    #   # Events are available at
+    #   resp.stream # => Enumerator
+    #   # For parameter input example, please refer to following request syntax.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.invoke_agent_runtime_command({
+    #     content_type: "MimeType",
+    #     accept: "MimeType",
+    #     runtime_session_id: "SessionType",
+    #     trace_id: "InvokeAgentRuntimeCommandRequestTraceIdString",
+    #     trace_parent: "InvokeAgentRuntimeCommandRequestTraceParentString",
+    #     trace_state: "InvokeAgentRuntimeCommandRequestTraceStateString",
+    #     baggage: "InvokeAgentRuntimeCommandRequestBaggageString",
+    #     agent_runtime_arn: "String", # required
+    #     qualifier: "String",
+    #     account_id: "InvokeAgentRuntimeCommandRequestAccountIdString",
+    #     body: { # required
+    #       command: "InvokeAgentRuntimeCommandRequestBodyCommandString", # required
+    #       timeout: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.runtime_session_id #=> String
+    #   resp.trace_id #=> String
+    #   resp.trace_parent #=> String
+    #   resp.trace_state #=> String
+    #   resp.baggage #=> String
+    #   resp.content_type #=> String
+    #   resp.status_code #=> Integer
+    #   # All events are available at resp.stream:
+    #   resp.stream #=> Enumerator
+    #   resp.stream.event_types #=> [:chunk, :access_denied_exception, :internal_server_exception, :resource_not_found_exception, :service_quota_exceeded_exception, :throttling_exception, :validation_exception, :runtime_client_error]
+    #
+    #   # For :chunk event available at #on_chunk_event callback and response eventstream enumerator:
+    #   event.content_delta.stdout #=> String
+    #   event.content_delta.stderr #=> String
+    #   event.content_stop.exit_code #=> Integer
+    #   event.content_stop.status #=> String, one of "COMPLETED", "TIMED_OUT"
+    #
+    #   # For :access_denied_exception event available at #on_access_denied_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   # For :internal_server_exception event available at #on_internal_server_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   # For :resource_not_found_exception event available at #on_resource_not_found_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   # For :service_quota_exceeded_exception event available at #on_service_quota_exceeded_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   # For :throttling_exception event available at #on_throttling_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    #   # For :validation_exception event available at #on_validation_exception_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #   event.reason #=> String, one of "CannotParse", "FieldValidationFailed", "IdempotentParameterMismatchException", "EventInOtherSession", "ResourceConflict"
+    #   event.field_list #=> Array
+    #   event.field_list[0].name #=> String
+    #   event.field_list[0].message #=> String
+    #
+    #   # For :runtime_client_error event available at #on_runtime_client_error_event callback and response eventstream enumerator:
+    #   event.message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeAgentRuntimeCommand AWS API Documentation
+    #
+    # @overload invoke_agent_runtime_command(params = {})
+    # @param [Hash] params ({})
+    def invoke_agent_runtime_command(params = {}, options = {}, &block)
+      params = params.dup
+      event_stream_handler = case handler = params.delete(:event_stream_handler)
+        when EventStreams::InvokeAgentRuntimeCommandStreamOutput then handler
+        when Proc then EventStreams::InvokeAgentRuntimeCommandStreamOutput.new.tap(&handler)
+        when nil then EventStreams::InvokeAgentRuntimeCommandStreamOutput.new
+        else
+          msg = "expected :event_stream_handler to be a block or "\
+                "instance of Aws::BedrockAgentCore::EventStreams::InvokeAgentRuntimeCommandStreamOutput"\
+                ", got `#{handler.inspect}` instead"
+          raise ArgumentError, msg
+        end
+
+      yield(event_stream_handler) if block_given?
+
+      req = build_request(:invoke_agent_runtime_command, params)
+
+      req.context[:event_stream_handler] = event_stream_handler
+      req.handlers.add(Aws::Binary::DecodeHandler, priority: 95)
+
+      req.send_request(options, &block)
+    end
+
     # Executes code within an active code interpreter session in Amazon
     # Bedrock AgentCore. This operation processes the provided code, runs it
     # in a secure environment, and returns the execution results including
@@ -2625,10 +2924,10 @@ module Aws::BedrockAgentCore
     #   manage the session. The name does not need to be unique.
     #
     # @option params [Integer] :session_timeout_seconds
-    #   The time in seconds after which the session automatically terminates
-    #   if there is no activity. The default value is 3600 seconds (1 hour).
-    #   The minimum allowed value is 60 seconds, and the maximum allowed value
-    #   is 28800 seconds (8 hours).
+    #   The duration in seconds (time-to-live) after which the session
+    #   automatically terminates, regardless of ongoing activity. Defaults to
+    #   3600 seconds (1 hour). Recommended minimum: 60 seconds. Maximum
+    #   allowed: 28,800 seconds (8 hours).
     #
     # @option params [Types::ViewPort] :view_port
     #   The dimensions of the browser viewport for this session. This
@@ -2776,10 +3075,10 @@ module Aws::BedrockAgentCore
     #   and manage the session. The name does not need to be unique.
     #
     # @option params [Integer] :session_timeout_seconds
-    #   The time in seconds after which the session automatically terminates
-    #   if there is no activity. The default value is 900 seconds (15
-    #   minutes). The minimum allowed value is 60 seconds, and the maximum
-    #   allowed value is 28800 seconds (8 hours).
+    #   The duration in seconds (time-to-live) after which the session
+    #   automatically terminates, regardless of ongoing activity. Defaults to
+    #   900 seconds (15 minutes). Recommended minimum: 60 seconds. Maximum
+    #   allowed: 28,800 seconds (8 hours).
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier to ensure that the API request
@@ -3142,7 +3441,7 @@ module Aws::BedrockAgentCore
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentcore'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -57,6 +57,7 @@ module Aws::BedrockAgentCore
     CodeInterpreterSessionSummary = Shapes::StructureShape.new(name: 'CodeInterpreterSessionSummary')
     CodeInterpreterSessionTimeout = Shapes::IntegerShape.new(name: 'CodeInterpreterSessionTimeout')
     CodeInterpreterStreamOutput = Shapes::StructureShape.new(name: 'CodeInterpreterStreamOutput')
+    CommandExecutionStatus = Shapes::StringShape.new(name: 'CommandExecutionStatus')
     CompleteResourceTokenAuthRequest = Shapes::StructureShape.new(name: 'CompleteResourceTokenAuthRequest')
     CompleteResourceTokenAuthResponse = Shapes::StructureShape.new(name: 'CompleteResourceTokenAuthResponse')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -64,6 +65,9 @@ module Aws::BedrockAgentCore
     ContentBlock = Shapes::StructureShape.new(name: 'ContentBlock')
     ContentBlockList = Shapes::ListShape.new(name: 'ContentBlockList')
     ContentBlockType = Shapes::StringShape.new(name: 'ContentBlockType')
+    ContentDeltaEvent = Shapes::StructureShape.new(name: 'ContentDeltaEvent')
+    ContentStartEvent = Shapes::StructureShape.new(name: 'ContentStartEvent')
+    ContentStopEvent = Shapes::StructureShape.new(name: 'ContentStopEvent')
     ContentTextString = Shapes::StringShape.new(name: 'ContentTextString')
     Context = Shapes::UnionShape.new(name: 'Context')
     Conversational = Shapes::StructureShape.new(name: 'Conversational')
@@ -136,6 +140,16 @@ module Aws::BedrockAgentCore
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     InvalidInputException = Shapes::StructureShape.new(name: 'InvalidInputException')
+    InvokeAgentRuntimeCommandRequest = Shapes::StructureShape.new(name: 'InvokeAgentRuntimeCommandRequest')
+    InvokeAgentRuntimeCommandRequestAccountIdString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestAccountIdString')
+    InvokeAgentRuntimeCommandRequestBaggageString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestBaggageString')
+    InvokeAgentRuntimeCommandRequestBody = Shapes::StructureShape.new(name: 'InvokeAgentRuntimeCommandRequestBody')
+    InvokeAgentRuntimeCommandRequestBodyCommandString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestBodyCommandString')
+    InvokeAgentRuntimeCommandRequestTraceIdString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestTraceIdString')
+    InvokeAgentRuntimeCommandRequestTraceParentString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestTraceParentString')
+    InvokeAgentRuntimeCommandRequestTraceStateString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeCommandRequestTraceStateString')
+    InvokeAgentRuntimeCommandResponse = Shapes::StructureShape.new(name: 'InvokeAgentRuntimeCommandResponse')
+    InvokeAgentRuntimeCommandStreamOutput = Shapes::StructureShape.new(name: 'InvokeAgentRuntimeCommandStreamOutput')
     InvokeAgentRuntimeRequest = Shapes::StructureShape.new(name: 'InvokeAgentRuntimeRequest')
     InvokeAgentRuntimeRequestAccountIdString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeRequestAccountIdString')
     InvokeAgentRuntimeRequestBaggageString = Shapes::StringShape.new(name: 'InvokeAgentRuntimeRequestBaggageString')
@@ -216,6 +230,7 @@ module Aws::BedrockAgentCore
     ResourceLocation = Shapes::UnionShape.new(name: 'ResourceLocation')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourceOauth2ReturnUrlType = Shapes::StringShape.new(name: 'ResourceOauth2ReturnUrlType')
+    ResponseChunk = Shapes::StructureShape.new(name: 'ResponseChunk')
     ResponseStream = Shapes::BlobShape.new(name: 'ResponseStream', streaming: true)
     RetrieveMemoryRecordsInput = Shapes::StructureShape.new(name: 'RetrieveMemoryRecordsInput')
     RetrieveMemoryRecordsOutput = Shapes::StructureShape.new(name: 'RetrieveMemoryRecordsOutput')
@@ -426,6 +441,16 @@ module Aws::BedrockAgentCore
 
     ContentBlockList.member = Shapes::ShapeRef.new(shape: ContentBlock)
 
+    ContentDeltaEvent.add_member(:stdout, Shapes::ShapeRef.new(shape: String, location_name: "stdout"))
+    ContentDeltaEvent.add_member(:stderr, Shapes::ShapeRef.new(shape: String, location_name: "stderr"))
+    ContentDeltaEvent.struct_class = Types::ContentDeltaEvent
+
+    ContentStartEvent.struct_class = Types::ContentStartEvent
+
+    ContentStopEvent.add_member(:exit_code, Shapes::ShapeRef.new(shape: Integer, required: true, location_name: "exitCode"))
+    ContentStopEvent.add_member(:status, Shapes::ShapeRef.new(shape: CommandExecutionStatus, required: true, location_name: "status"))
+    ContentStopEvent.struct_class = Types::ContentStopEvent
+
     Context.add_member(:span_context, Shapes::ShapeRef.new(shape: SpanContext, location_name: "spanContext"))
     Context.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     Context.add_member_subclass(:span_context, Types::Context::SpanContext)
@@ -680,6 +705,47 @@ module Aws::BedrockAgentCore
     InvalidInputException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     InvalidInputException.struct_class = Types::InvalidInputException
 
+    InvokeAgentRuntimeCommandRequest.add_member(:content_type, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Content-Type"))
+    InvokeAgentRuntimeCommandRequest.add_member(:accept, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Accept"))
+    InvokeAgentRuntimeCommandRequest.add_member(:runtime_session_id, Shapes::ShapeRef.new(shape: SessionType, location: "header", location_name: "X-Amzn-Bedrock-AgentCore-Runtime-Session-Id", metadata: {"idempotencyToken" => true}))
+    InvokeAgentRuntimeCommandRequest.add_member(:trace_id, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestTraceIdString, location: "header", location_name: "X-Amzn-Trace-Id"))
+    InvokeAgentRuntimeCommandRequest.add_member(:trace_parent, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestTraceParentString, location: "header", location_name: "traceparent"))
+    InvokeAgentRuntimeCommandRequest.add_member(:trace_state, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestTraceStateString, location: "header", location_name: "tracestate"))
+    InvokeAgentRuntimeCommandRequest.add_member(:baggage, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestBaggageString, location: "header", location_name: "baggage"))
+    InvokeAgentRuntimeCommandRequest.add_member(:agent_runtime_arn, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "agentRuntimeArn"))
+    InvokeAgentRuntimeCommandRequest.add_member(:qualifier, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "qualifier"))
+    InvokeAgentRuntimeCommandRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestAccountIdString, location: "querystring", location_name: "accountId"))
+    InvokeAgentRuntimeCommandRequest.add_member(:body, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestBody, required: true, location_name: "body"))
+    InvokeAgentRuntimeCommandRequest.struct_class = Types::InvokeAgentRuntimeCommandRequest
+    InvokeAgentRuntimeCommandRequest[:payload] = :body
+    InvokeAgentRuntimeCommandRequest[:payload_member] = InvokeAgentRuntimeCommandRequest.member(:body)
+
+    InvokeAgentRuntimeCommandRequestBody.add_member(:command, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequestBodyCommandString, required: true, location_name: "command"))
+    InvokeAgentRuntimeCommandRequestBody.add_member(:timeout, Shapes::ShapeRef.new(shape: Integer, location_name: "timeout"))
+    InvokeAgentRuntimeCommandRequestBody.struct_class = Types::InvokeAgentRuntimeCommandRequestBody
+
+    InvokeAgentRuntimeCommandResponse.add_member(:runtime_session_id, Shapes::ShapeRef.new(shape: SessionId, location: "header", location_name: "X-Amzn-Bedrock-AgentCore-Runtime-Session-Id"))
+    InvokeAgentRuntimeCommandResponse.add_member(:trace_id, Shapes::ShapeRef.new(shape: String, location: "header", location_name: "X-Amzn-Trace-Id"))
+    InvokeAgentRuntimeCommandResponse.add_member(:trace_parent, Shapes::ShapeRef.new(shape: String, location: "header", location_name: "traceparent"))
+    InvokeAgentRuntimeCommandResponse.add_member(:trace_state, Shapes::ShapeRef.new(shape: String, location: "header", location_name: "tracestate"))
+    InvokeAgentRuntimeCommandResponse.add_member(:baggage, Shapes::ShapeRef.new(shape: String, location: "header", location_name: "baggage"))
+    InvokeAgentRuntimeCommandResponse.add_member(:content_type, Shapes::ShapeRef.new(shape: String, required: true, location: "header", location_name: "Content-Type"))
+    InvokeAgentRuntimeCommandResponse.add_member(:status_code, Shapes::ShapeRef.new(shape: HttpResponseCode, location: "statusCode", location_name: "statusCode"))
+    InvokeAgentRuntimeCommandResponse.add_member(:stream, Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandStreamOutput, required: true, eventstream: true, location_name: "stream"))
+    InvokeAgentRuntimeCommandResponse.struct_class = Types::InvokeAgentRuntimeCommandResponse
+    InvokeAgentRuntimeCommandResponse[:payload] = :stream
+    InvokeAgentRuntimeCommandResponse[:payload_member] = InvokeAgentRuntimeCommandResponse.member(:stream)
+
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:chunk, Shapes::ShapeRef.new(shape: ResponseChunk, event: true, location_name: "chunk"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:access_denied_exception, Shapes::ShapeRef.new(shape: AccessDeniedException, location_name: "accessDeniedException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:internal_server_exception, Shapes::ShapeRef.new(shape: InternalServerException, location_name: "internalServerException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:resource_not_found_exception, Shapes::ShapeRef.new(shape: ResourceNotFoundException, location_name: "resourceNotFoundException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:service_quota_exceeded_exception, Shapes::ShapeRef.new(shape: ServiceQuotaExceededException, location_name: "serviceQuotaExceededException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:throttling_exception, Shapes::ShapeRef.new(shape: ThrottlingException, location_name: "throttlingException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:validation_exception, Shapes::ShapeRef.new(shape: ValidationException, location_name: "validationException"))
+    InvokeAgentRuntimeCommandStreamOutput.add_member(:runtime_client_error, Shapes::ShapeRef.new(shape: RuntimeClientError, location_name: "runtimeClientError"))
+    InvokeAgentRuntimeCommandStreamOutput.struct_class = Types::InvokeAgentRuntimeCommandStreamOutput
+
     InvokeAgentRuntimeRequest.add_member(:content_type, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Content-Type"))
     InvokeAgentRuntimeRequest.add_member(:accept, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Accept"))
     InvokeAgentRuntimeRequest.add_member(:mcp_session_id, Shapes::ShapeRef.new(shape: StringType, location: "header", location_name: "Mcp-Session-Id"))
@@ -936,6 +1002,11 @@ module Aws::BedrockAgentCore
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
+    ResponseChunk.add_member(:content_start, Shapes::ShapeRef.new(shape: ContentStartEvent, location_name: "contentStart"))
+    ResponseChunk.add_member(:content_delta, Shapes::ShapeRef.new(shape: ContentDeltaEvent, location_name: "contentDelta"))
+    ResponseChunk.add_member(:content_stop, Shapes::ShapeRef.new(shape: ContentStopEvent, location_name: "contentStop"))
+    ResponseChunk.struct_class = Types::ResponseChunk
+
     RetrieveMemoryRecordsInput.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, required: true, location: "uri", location_name: "memoryId"))
     RetrieveMemoryRecordsInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "namespace"))
     RetrieveMemoryRecordsInput.add_member(:search_criteria, Shapes::ShapeRef.new(shape: SearchCriteria, required: true, location_name: "searchCriteria"))
@@ -1453,6 +1524,21 @@ module Aws::BedrockAgentCore
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:invoke_agent_runtime_command, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "InvokeAgentRuntimeCommand"
+        o.http_method = "POST"
+        o.http_request_uri = "/runtimes/{agentRuntimeArn}/commands"
+        o.input = Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandRequest)
+        o.output = Shapes::ShapeRef.new(shape: InvokeAgentRuntimeCommandResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: RuntimeClientError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:invoke_code_interpreter, Seahorse::Model::Operation.new.tap do |o|
         o.name = "InvokeCodeInterpreter"
         o.http_method = "POST"

data/lib/aws-sdk-bedrockagentcore/event_streams.rb

@@ -9,6 +9,75 @@
 
 module Aws::BedrockAgentCore
   module EventStreams
+    class InvokeAgentRuntimeCommandStreamOutput
+
+      def initialize
+        @event_emitter = Aws::EventEmitter.new
+      end
+
+      def on_chunk_event(&block)
+        @event_emitter.on(:chunk, block) if block_given?
+      end
+
+      def on_access_denied_exception_event(&block)
+        @event_emitter.on(:access_denied_exception, block) if block_given?
+      end
+
+      def on_internal_server_exception_event(&block)
+        @event_emitter.on(:internal_server_exception, block) if block_given?
+      end
+
+      def on_resource_not_found_exception_event(&block)
+        @event_emitter.on(:resource_not_found_exception, block) if block_given?
+      end
+
+      def on_service_quota_exceeded_exception_event(&block)
+        @event_emitter.on(:service_quota_exceeded_exception, block) if block_given?
+      end
+
+      def on_throttling_exception_event(&block)
+        @event_emitter.on(:throttling_exception, block) if block_given?
+      end
+
+      def on_validation_exception_event(&block)
+        @event_emitter.on(:validation_exception, block) if block_given?
+      end
+
+      def on_runtime_client_error_event(&block)
+        @event_emitter.on(:runtime_client_error, block) if block_given?
+      end
+
+      def on_error_event(&block)
+        @event_emitter.on(:error, block) if block_given?
+      end
+
+      def on_initial_response_event(&block)
+        @event_emitter.on(:initial_response, block) if block_given?
+      end
+
+      def on_unknown_event(&block)
+        @event_emitter.on(:unknown_event, block) if block_given?
+      end
+
+      def on_event(&block)
+        on_chunk_event(&block)
+        on_access_denied_exception_event(&block)
+        on_internal_server_exception_event(&block)
+        on_resource_not_found_exception_event(&block)
+        on_service_quota_exceeded_exception_event(&block)
+        on_throttling_exception_event(&block)
+        on_validation_exception_event(&block)
+        on_runtime_client_error_event(&block)
+        on_error_event(&block)
+        on_initial_response_event(&block)
+        on_unknown_event(&block)
+      end
+
+      # @api private
+      # @return Aws::EventEmitter
+      attr_reader :event_emitter
+
+    end
     class CodeInterpreterStreamOutput
 
       def initialize

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

@@ -587,6 +587,50 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # Content event containing stdout or stderr output
+    #
+    # @!attribute [rw] stdout
+    #   Standard output content
+    #   @return [String]
+    #
+    # @!attribute [rw] stderr
+    #   Standard error content
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ContentDeltaEvent AWS API Documentation
+    #
+    class ContentDeltaEvent < Struct.new(
+      :stdout,
+      :stderr)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # First event indicating command execution has started
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ContentStartEvent AWS API Documentation
+    #
+    class ContentStartEvent < Aws::EmptyStructure; end
+
+    # Final event indicating command execution has completed
+    #
+    # @!attribute [rw] exit_code
+    #   Exit code: 0 = success, -1 = platform error, &gt;0 = command error
+    #   @return [Integer]
+    #
+    # @!attribute [rw] status
+    #   Execution status
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ContentStopEvent AWS API Documentation
+    #
+    class ContentStopEvent < Struct.new(
+      :exit_code,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The contextual information associated with an evaluation, including
     # span context details that identify the specific traces and sessions
     # being evaluated within the agent's execution flow.
@@ -1776,6 +1820,149 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # Request for InvokeAgentRuntimeCommand operation
+    #
+    # @!attribute [rw] content_type
+    #   The MIME type of the input data in the request payload. This tells
+    #   the agent runtime how to interpret the payload data. Common values
+    #   include application/json for JSON data.
+    #   @return [String]
+    #
+    # @!attribute [rw] accept
+    #   The desired MIME type for the response from the agent runtime
+    #   command. This tells the agent runtime what format to use for the
+    #   response data. Common values include application/json for JSON data.
+    #   @return [String]
+    #
+    # @!attribute [rw] runtime_session_id
+    #   Runtime session identifier
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_id
+    #   The trace identifier for request tracking.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_parent
+    #   The parent trace information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_state
+    #   The trace state information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] baggage
+    #   Additional context information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] agent_runtime_arn
+    #   ARN of the agent runtime
+    #   @return [String]
+    #
+    # @!attribute [rw] qualifier
+    #   Version or alias qualifier
+    #   @return [String]
+    #
+    # @!attribute [rw] account_id
+    #   Account ID (12 digits)
+    #   @return [String]
+    #
+    # @!attribute [rw] body
+    #   Request body containing command and timeout
+    #   @return [Types::InvokeAgentRuntimeCommandRequestBody]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeAgentRuntimeCommandRequest AWS API Documentation
+    #
+    class InvokeAgentRuntimeCommandRequest < Struct.new(
+      :content_type,
+      :accept,
+      :runtime_session_id,
+      :trace_id,
+      :trace_parent,
+      :trace_state,
+      :baggage,
+      :agent_runtime_arn,
+      :qualifier,
+      :account_id,
+      :body)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Request body for InvokeAgentRuntimeCommand
+    #
+    # @!attribute [rw] command
+    #   The command to execute in the runtime container
+    #   @return [String]
+    #
+    # @!attribute [rw] timeout
+    #   Command timeout in seconds (default: 300, min:1, max: 3600)
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeAgentRuntimeCommandRequestBody AWS API Documentation
+    #
+    class InvokeAgentRuntimeCommandRequestBody < Struct.new(
+      :command,
+      :timeout)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Response for InvokeAgentRuntimeCommand operation
+    #
+    # @!attribute [rw] runtime_session_id
+    #   Runtime session identifier
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_id
+    #   The trace identifier for request tracking.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_parent
+    #   The parent trace information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_state
+    #   The trace state information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] baggage
+    #   Additional context information for distributed tracing.
+    #   @return [String]
+    #
+    # @!attribute [rw] content_type
+    #   The MIME type of the response data. This indicates how to interpret
+    #   the response data. Common values include application/json for JSON
+    #   data.
+    #   @return [String]
+    #
+    # @!attribute [rw] status_code
+    #   The HTTP status code of the response. A status code of 200 indicates
+    #   a successful operation. Other status codes indicate various error
+    #   conditions.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] stream
+    #   Streaming output containing command execution events
+    #   @return [Types::InvokeAgentRuntimeCommandStreamOutput]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeAgentRuntimeCommandResponse AWS API Documentation
+    #
+    class InvokeAgentRuntimeCommandResponse < Struct.new(
+      :runtime_session_id,
+      :trace_id,
+      :trace_parent,
+      :trace_state,
+      :baggage,
+      :content_type,
+      :status_code,
+      :stream)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] content_type
     #   The MIME type of the input data in the payload. This tells the agent
     #   runtime how to interpret the payload data. Common values include
@@ -1824,21 +2011,22 @@ module Aws::BedrockAgentCore
     #   @return [String]
     #
     # @!attribute [rw] agent_runtime_arn
-    #   The Amazon Web Services Resource Name (ARN) of the agent runtime to
-    #   invoke. The ARN uniquely identifies the agent runtime resource in
-    #   Amazon Bedrock AgentCore.
+    #   The identifier of the agent runtime to invoke. You can specify
+    #   either the full Amazon Web Services Resource Name (ARN) or the agent
+    #   ID. If you use the agent ID, you must also provide the `accountId`
+    #   query parameter.
     #   @return [String]
     #
     # @!attribute [rw] qualifier
-    #   The qualifier to use for the agent runtime. This can be a version
-    #   number or an endpoint name that points to a specific version. If not
-    #   specified, Amazon Bedrock AgentCore uses the default version of the
-    #   agent runtime.
+    #   The qualifier to use for the agent runtime. This is an endpoint name
+    #   that points to a specific version. If not specified, Amazon Bedrock
+    #   AgentCore uses the default endpoint of the agent runtime.
     #   @return [String]
     #
     # @!attribute [rw] account_id
     #   The identifier of the Amazon Web Services account for the agent
-    #   runtime resource.
+    #   runtime resource. This parameter is required when you specify an
+    #   agent ID instead of the full ARN for `agentRuntimeArn`.
     #   @return [String]
     #
     # @!attribute [rw] payload
@@ -2915,6 +3103,32 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # Response chunk containing exactly one of: contentStart, contentDelta,
+    # or contentStop
+    #
+    # @!attribute [rw] content_start
+    #   First chunk - indicates command execution has started
+    #   @return [Types::ContentStartEvent]
+    #
+    # @!attribute [rw] content_delta
+    #   Middle chunks - stdout/stderr output
+    #   @return [Types::ContentDeltaEvent]
+    #
+    # @!attribute [rw] content_stop
+    #   Last chunk - indicates command execution has completed
+    #   @return [Types::ContentStopEvent]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ResponseChunk AWS API Documentation
+    #
+    class ResponseChunk < Struct.new(
+      :content_start,
+      :content_delta,
+      :content_stop,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] memory_id
     #   The identifier of the AgentCore Memory resource from which to
     #   retrieve memory records.
@@ -3022,7 +3236,8 @@ module Aws::BedrockAgentCore
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/RuntimeClientError AWS API Documentation
     #
     class RuntimeClientError < Struct.new(
-      :message)
+      :message,
+      :event_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3269,10 +3484,10 @@ module Aws::BedrockAgentCore
     #   @return [String]
     #
     # @!attribute [rw] session_timeout_seconds
-    #   The time in seconds after which the session automatically terminates
-    #   if there is no activity. The default value is 3600 seconds (1 hour).
-    #   The minimum allowed value is 60 seconds, and the maximum allowed
-    #   value is 28800 seconds (8 hours).
+    #   The duration in seconds (time-to-live) after which the session
+    #   automatically terminates, regardless of ongoing activity. Defaults
+    #   to 3600 seconds (1 hour). Recommended minimum: 60 seconds. Maximum
+    #   allowed: 28,800 seconds (8 hours).
     #   @return [Integer]
     #
     # @!attribute [rw] view_port
@@ -3380,10 +3595,10 @@ module Aws::BedrockAgentCore
     #   @return [String]
     #
     # @!attribute [rw] session_timeout_seconds
-    #   The time in seconds after which the session automatically terminates
-    #   if there is no activity. The default value is 900 seconds (15
-    #   minutes). The minimum allowed value is 60 seconds, and the maximum
-    #   allowed value is 28800 seconds (8 hours).
+    #   The duration in seconds (time-to-live) after which the session
+    #   automatically terminates, regardless of ongoing activity. Defaults
+    #   to 900 seconds (15 minutes). Recommended minimum: 60 seconds.
+    #   Maximum allowed: 28,800 seconds (8 hours).
     #   @return [Integer]
     #
     # @!attribute [rw] client_token
@@ -3914,7 +4129,8 @@ module Aws::BedrockAgentCore
     # @note UserIdentifier is a union - when making an API calls you must set exactly one of the members.
     #
     # @!attribute [rw] user_token
-    #   The OAuth2.0 token issued by the user’s identity provider
+    #   The OAuth2.0 token issued by the user’s identity provider that was
+    #   used to generate the workload access token
     #   @return [String]
     #
     # @!attribute [rw] user_id
@@ -4033,6 +4249,32 @@ module Aws::BedrockAgentCore
 
     end
 
+    # Streaming output for InvokeAgentRuntimeCommand operation Delivers
+    # typed events: contentStart (first), contentDelta (middle), contentStop
+    # (last)
+    #
+    # EventStream is an Enumerator of Events.
+    #  #event_types #=> Array, returns all modeled event types in the stream
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeAgentRuntimeCommandStreamOutput AWS API Documentation
+    #
+    class InvokeAgentRuntimeCommandStreamOutput < Enumerator
+
+      def event_types
+        [
+          :chunk,
+          :access_denied_exception,
+          :internal_server_exception,
+          :resource_not_found_exception,
+          :service_quota_exceeded_exception,
+          :throttling_exception,
+          :validation_exception,
+          :runtime_client_error
+        ]
+      end
+
+    end
+
   end
 end
 

data/lib/aws-sdk-bedrockagentcore.rb

@@ -56,7 +56,7 @@ module Aws::BedrockAgentCore
   autoload :Endpoints, 'aws-sdk-bedrockagentcore/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentcore/event_streams'
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.20.0'
 
 end
 

data/sig/client.rbs

@@ -405,6 +405,36 @@ module Aws
                                 ) ?{ (*untyped) -> void } -> _InvokeAgentRuntimeResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _InvokeAgentRuntimeResponseSuccess
 
+      interface _InvokeAgentRuntimeCommandResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::InvokeAgentRuntimeCommandResponse]
+        def runtime_session_id: () -> ::String
+        def trace_id: () -> ::String
+        def trace_parent: () -> ::String
+        def trace_state: () -> ::String
+        def baggage: () -> ::String
+        def content_type: () -> ::String
+        def status_code: () -> ::Integer
+        def stream: () -> Types::InvokeAgentRuntimeCommandStreamOutput
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockAgentCore/Client.html#invoke_agent_runtime_command-instance_method
+      def invoke_agent_runtime_command: (
+                                          ?content_type: ::String,
+                                          ?accept: ::String,
+                                          ?runtime_session_id: ::String,
+                                          ?trace_id: ::String,
+                                          ?trace_parent: ::String,
+                                          ?trace_state: ::String,
+                                          ?baggage: ::String,
+                                          agent_runtime_arn: ::String,
+                                          ?qualifier: ::String,
+                                          ?account_id: ::String,
+                                          body: {
+                                            command: ::String,
+                                            timeout: ::Integer?
+                                          }
+                                        ) ?{ (*untyped) -> void } -> _InvokeAgentRuntimeCommandResponseSuccess
+                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _InvokeAgentRuntimeCommandResponseSuccess
+
       interface _InvokeCodeInterpreterResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::InvokeCodeInterpreterResponse]
         def session_id: () -> ::String

data/sig/types.rbs

@@ -167,6 +167,21 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class ContentDeltaEvent
+      attr_accessor stdout: ::String
+      attr_accessor stderr: ::String
+      SENSITIVE: []
+    end
+
+    class ContentStartEvent < Aws::EmptyStructure
+    end
+
+    class ContentStopEvent
+      attr_accessor exit_code: ::Integer
+      attr_accessor status: ("COMPLETED" | "TIMED_OUT")
+      SENSITIVE: []
+    end
+
     class Context
       attr_accessor span_context: Types::SpanContext
       attr_accessor unknown: untyped
@@ -508,6 +523,39 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class InvokeAgentRuntimeCommandRequest
+      attr_accessor content_type: ::String
+      attr_accessor accept: ::String
+      attr_accessor runtime_session_id: ::String
+      attr_accessor trace_id: ::String
+      attr_accessor trace_parent: ::String
+      attr_accessor trace_state: ::String
+      attr_accessor baggage: ::String
+      attr_accessor agent_runtime_arn: ::String
+      attr_accessor qualifier: ::String
+      attr_accessor account_id: ::String
+      attr_accessor body: Types::InvokeAgentRuntimeCommandRequestBody
+      SENSITIVE: []
+    end
+
+    class InvokeAgentRuntimeCommandRequestBody
+      attr_accessor command: ::String
+      attr_accessor timeout: ::Integer
+      SENSITIVE: []
+    end
+
+    class InvokeAgentRuntimeCommandResponse
+      attr_accessor runtime_session_id: ::String
+      attr_accessor trace_id: ::String
+      attr_accessor trace_parent: ::String
+      attr_accessor trace_state: ::String
+      attr_accessor baggage: ::String
+      attr_accessor content_type: ::String
+      attr_accessor status_code: ::Integer
+      attr_accessor stream: Types::InvokeAgentRuntimeCommandStreamOutput
+      SENSITIVE: []
+    end
+
     class InvokeAgentRuntimeRequest
       attr_accessor content_type: ::String
       attr_accessor accept: ::String
@@ -834,6 +882,14 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class ResponseChunk
+      attr_accessor content_start: Types::ContentStartEvent
+      attr_accessor content_delta: Types::ContentDeltaEvent
+      attr_accessor content_stop: Types::ContentStopEvent
+      attr_accessor event_type: untyped
+      SENSITIVE: []
+    end
+
     class RetrieveMemoryRecordsInput
       attr_accessor memory_id: ::String
       attr_accessor namespace: ::String
@@ -867,6 +923,7 @@ module Aws::BedrockAgentCore
 
     class RuntimeClientError
       attr_accessor message: ::String
+      attr_accessor event_type: untyped
       SENSITIVE: []
     end
 
@@ -1135,5 +1192,9 @@ module Aws::BedrockAgentCore
     class CodeInterpreterStreamOutput < Enumerator[untyped, untyped]
       def event_types: () -> [:result, :access_denied_exception, :conflict_exception, :internal_server_exception, :resource_not_found_exception, :service_quota_exceeded_exception, :throttling_exception, :validation_exception]
     end
+
+    class InvokeAgentRuntimeCommandStreamOutput < Enumerator[untyped, untyped]
+      def event_types: () -> [:chunk, :access_denied_exception, :internal_server_exception, :resource_not_found_exception, :service_quota_exceeded_exception, :throttling_exception, :validation_exception, :runtime_client_error]
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentcore
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services