aws-sdk-bedrockagentcore 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb7b52155366ef862784c13760dd432f6b3d131e90f7b1dd3022d0d6d35b1560
-  data.tar.gz: f6c1676399424a71b00b8a8ceb53a00b22e4cb1b4547c593e858a90937956054
+  metadata.gz: 80eb8990a20e048a41ab853f5401b2b5f32d60f73c14c83676cdb308b21ca3f6
+  data.tar.gz: 36ff647c6656782b24e3f1f311d1b6a486e3e121debb20b384f418c08b5a390d
 SHA512:
-  metadata.gz: f794c438005da7371edc77ada944fd8a181bb1655d875399f1eb18bb311b3f53b84aec98b42fce9342575ce493d06308c4c8848992fcd391b03a7880148c057f
-  data.tar.gz: d24f39255446db5b0c233f7fc0b73303b781a90725a70ae41c47338a44440aa5d316d37d8b6fad887d7410236297f286a89df1ccf9e664a1ef8cd652d9d3d6f4
+  metadata.gz: 71bc461035b22c6181e84c8c721a7727f7c04aeec8c260ed445aeb93572a51cc0e60ae08ca3e0aa0f89cb901df3500f5934b5cf7a372fcfb798598a31fb6d1a5
+  data.tar.gz: 6c307e07d2804570e8ed7c969466d2572d8d51b388d1c3b8272c6d9f73c9dfbaca408a2bf68c9fdbfe6d21fb306b48f16ec65cb91d5883a4da1532d7cef17ed8

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.57.0 (2026-09-21)
+------------------
+
+* Feature - Amazon Bedrock AgentCore Harness now supports lifecycle hooks for invocations and tool calls, with Lambda, SNS, and EventBridge targets. This release also adds apiBase for custom OpenAI-compatible endpoints.
+
 1.56.0 (2026-09-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.56.0
+1.57.0

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

@@ -3851,6 +3851,9 @@ module Aws::BedrockAgentCore
     #   handler.on_runtime_client_error_event do |event|
     #     event # => Aws::BedrockAgentCore::Types::runtimeClientError
     #   end
+    #   handler.on_hook_event_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::hookEvent
+    #   end
     #
     #   client.invoke_harness(
     #     # params inputs
@@ -3887,6 +3890,9 @@ module Aws::BedrockAgentCore
     #     stream.on_runtime_client_error_event do |event|
     #       event # => Aws::BedrockAgentCore::Types::runtimeClientError
     #     end
+    #     stream.on_hook_event_event do |event|
+    #       event # => Aws::BedrockAgentCore::Types::hookEvent
+    #     end
     #   end
     #
     #   client.invoke_harness(
@@ -3923,6 +3929,9 @@ module Aws::BedrockAgentCore
     #   handler.on_runtime_client_error_event do |event|
     #     event # => Aws::BedrockAgentCore::Types::runtimeClientError
     #   end
+    #   handler.on_hook_event_event do |event|
+    #     event # => Aws::BedrockAgentCore::Types::hookEvent
+    #   end
     #
     #   client.invoke_harness(
     #     # params input
@@ -4004,6 +4013,7 @@ module Aws::BedrockAgentCore
     #       open_ai_model_config: {
     #         model_id: "ModelId", # required
     #         api_key_arn: "ApiKeyArn", # required
+    #         api_base: "HarnessOpenAiApiBase",
     #         max_tokens: 1,
     #         temperature: 1.0,
     #         top_p: 1.0,
@@ -4110,7 +4120,7 @@ module Aws::BedrockAgentCore
     #
     #   # All events are available at resp.stream:
     #   resp.stream #=> Enumerator
-    #   resp.stream.event_types #=> [:message_start, :content_block_start, :content_block_delta, :content_block_stop, :message_stop, :metadata, :internal_server_exception, :validation_exception, :runtime_client_error]
+    #   resp.stream.event_types #=> [:message_start, :content_block_start, :content_block_delta, :content_block_stop, :message_stop, :metadata, :internal_server_exception, :validation_exception, :runtime_client_error, :hook_event]
     #
     #   # For :message_start event available at #on_message_start_event callback and response eventstream enumerator:
     #   event.role #=> String, one of "user", "assistant"
@@ -4139,7 +4149,7 @@ module Aws::BedrockAgentCore
     #   event.content_block_index #=> Integer
     #
     #   # For :message_stop event available at #on_message_stop_event callback and response eventstream enumerator:
-    #   event.stop_reason #=> String, one of "end_turn", "tool_use", "tool_result", "max_tokens", "stop_sequence", "content_filtered", "malformed_model_output", "malformed_tool_use", "interrupted", "partial_turn", "model_context_window_exceeded", "max_iterations_exceeded", "max_output_tokens_exceeded", "timeout_exceeded"
+    #   event.stop_reason #=> String, one of "end_turn", "tool_use", "tool_result", "max_tokens", "stop_sequence", "content_filtered", "malformed_model_output", "malformed_tool_use", "interrupted", "partial_turn", "model_context_window_exceeded", "max_iterations_exceeded", "max_output_tokens_exceeded", "timeout_exceeded", "hook_stopped"
     #
     #   # For :metadata event available at #on_metadata_event callback and response eventstream enumerator:
     #   event.usage.input_tokens #=> Integer
@@ -4162,6 +4172,13 @@ module Aws::BedrockAgentCore
     #   # For :runtime_client_error event available at #on_runtime_client_error_event callback and response eventstream enumerator:
     #   event.message #=> String
     #
+    #   # For :hook_event event available at #on_hook_event_event callback and response eventstream enumerator:
+    #   event.hook_event_id #=> String
+    #   event.name #=> String
+    #   event.type #=> String, one of "before_tool_call", "after_tool_call", "before_invocation", "after_invocation"
+    #   event.decision #=> String, one of "allow", "deny"
+    #   event.reason #=> String
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InvokeHarness AWS API Documentation
     #
     # @overload invoke_harness(params = {})
@@ -6566,7 +6583,7 @@ module Aws::BedrockAgentCore
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentcore'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -315,6 +315,12 @@ module Aws::BedrockAgentCore
     HarnessEndpointName = Shapes::StringShape.new(name: 'HarnessEndpointName')
     HarnessGatewayOutboundAuth = Shapes::UnionShape.new(name: 'HarnessGatewayOutboundAuth')
     HarnessGeminiModelConfig = Shapes::StructureShape.new(name: 'HarnessGeminiModelConfig')
+    HarnessHookDecision = Shapes::StringShape.new(name: 'HarnessHookDecision')
+    HarnessHookEvent = Shapes::StructureShape.new(name: 'HarnessHookEvent')
+    HarnessHookEventId = Shapes::StringShape.new(name: 'HarnessHookEventId')
+    HarnessHookEventReasonString = Shapes::StringShape.new(name: 'HarnessHookEventReasonString')
+    HarnessHookEventType = Shapes::StringShape.new(name: 'HarnessHookEventType')
+    HarnessHookName = Shapes::StringShape.new(name: 'HarnessHookName')
     HarnessInlineFunctionConfig = Shapes::StructureShape.new(name: 'HarnessInlineFunctionConfig')
     HarnessInlineFunctionDescription = Shapes::StringShape.new(name: 'HarnessInlineFunctionDescription')
     HarnessLiteLlmApiBase = Shapes::StringShape.new(name: 'HarnessLiteLlmApiBase')
@@ -325,6 +331,7 @@ module Aws::BedrockAgentCore
     HarnessMessages = Shapes::ListShape.new(name: 'HarnessMessages')
     HarnessMetadataEvent = Shapes::StructureShape.new(name: 'HarnessMetadataEvent')
     HarnessModelConfiguration = Shapes::UnionShape.new(name: 'HarnessModelConfiguration')
+    HarnessOpenAiApiBase = Shapes::StringShape.new(name: 'HarnessOpenAiApiBase')
     HarnessOpenAiApiFormat = Shapes::StringShape.new(name: 'HarnessOpenAiApiFormat')
     HarnessOpenAiModelConfig = Shapes::StructureShape.new(name: 'HarnessOpenAiModelConfig')
     HarnessReasoningContentBlock = Shapes::UnionShape.new(name: 'HarnessReasoningContentBlock')
@@ -1905,6 +1912,13 @@ module Aws::BedrockAgentCore
     HarnessGeminiModelConfig.add_member(:additional_params, Shapes::ShapeRef.new(shape: Document, location_name: "additionalParams"))
     HarnessGeminiModelConfig.struct_class = Types::HarnessGeminiModelConfig
 
+    HarnessHookEvent.add_member(:hook_event_id, Shapes::ShapeRef.new(shape: HarnessHookEventId, required: true, location_name: "hookEventId"))
+    HarnessHookEvent.add_member(:name, Shapes::ShapeRef.new(shape: HarnessHookName, required: true, location_name: "name"))
+    HarnessHookEvent.add_member(:type, Shapes::ShapeRef.new(shape: HarnessHookEventType, required: true, location_name: "type"))
+    HarnessHookEvent.add_member(:decision, Shapes::ShapeRef.new(shape: HarnessHookDecision, location_name: "decision"))
+    HarnessHookEvent.add_member(:reason, Shapes::ShapeRef.new(shape: HarnessHookEventReasonString, location_name: "reason"))
+    HarnessHookEvent.struct_class = Types::HarnessHookEvent
+
     HarnessInlineFunctionConfig.add_member(:description, Shapes::ShapeRef.new(shape: HarnessInlineFunctionDescription, required: true, location_name: "description"))
     HarnessInlineFunctionConfig.add_member(:input_schema, Shapes::ShapeRef.new(shape: SensitiveJson, required: true, location_name: "inputSchema"))
     HarnessInlineFunctionConfig.struct_class = Types::HarnessInlineFunctionConfig
@@ -1948,6 +1962,7 @@ module Aws::BedrockAgentCore
 
     HarnessOpenAiModelConfig.add_member(:model_id, Shapes::ShapeRef.new(shape: ModelId, required: true, location_name: "modelId"))
     HarnessOpenAiModelConfig.add_member(:api_key_arn, Shapes::ShapeRef.new(shape: ApiKeyArn, required: true, location_name: "apiKeyArn"))
+    HarnessOpenAiModelConfig.add_member(:api_base, Shapes::ShapeRef.new(shape: HarnessOpenAiApiBase, location_name: "apiBase"))
     HarnessOpenAiModelConfig.add_member(:max_tokens, Shapes::ShapeRef.new(shape: MaxTokens, location_name: "maxTokens"))
     HarnessOpenAiModelConfig.add_member(:temperature, Shapes::ShapeRef.new(shape: Temperature, location_name: "temperature"))
     HarnessOpenAiModelConfig.add_member(:top_p, Shapes::ShapeRef.new(shape: TopP, location_name: "topP"))
@@ -2293,6 +2308,7 @@ module Aws::BedrockAgentCore
     InvokeHarnessStreamOutput.add_member(:internal_server_exception, Shapes::ShapeRef.new(shape: InternalServerException, location_name: "internalServerException"))
     InvokeHarnessStreamOutput.add_member(:validation_exception, Shapes::ShapeRef.new(shape: ValidationException, location_name: "validationException"))
     InvokeHarnessStreamOutput.add_member(:runtime_client_error, Shapes::ShapeRef.new(shape: RuntimeClientError, location_name: "runtimeClientError"))
+    InvokeHarnessStreamOutput.add_member(:hook_event, Shapes::ShapeRef.new(shape: HarnessHookEvent, event: true, location_name: "hookEvent"))
     InvokeHarnessStreamOutput.struct_class = Types::InvokeHarnessStreamOutput
 
     KeyList.member = Shapes::ShapeRef.new(shape: String)

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

@@ -189,6 +189,10 @@ module Aws::BedrockAgentCore
         @event_emitter.on(:runtime_client_error, block) if block_given?
       end
 
+      def on_hook_event_event(&block)
+        @event_emitter.on(:hook_event, block) if block_given?
+      end
+
       def on_error_event(&block)
         @event_emitter.on(:error, block) if block_given?
       end
@@ -211,6 +215,7 @@ module Aws::BedrockAgentCore
         on_internal_server_exception_event(&block)
         on_validation_exception_event(&block)
         on_runtime_client_error_event(&block)
+        on_hook_event_event(&block)
         on_error_event(&block)
         on_initial_response_event(&block)
         on_unknown_event(&block)

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

@@ -4768,6 +4768,43 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # A lifecycle hook event emitted in the invocation stream for visibility
+    # into hook decisions.
+    #
+    # @!attribute [rw] hook_event_id
+    #   The unique identifier for this hook event.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the hook that ran.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type of lifecycle hook event.
+    #   @return [String]
+    #
+    # @!attribute [rw] decision
+    #   The decision applied to the hook event. This field is present only
+    #   for blocking Lambda targets.
+    #   @return [String]
+    #
+    # @!attribute [rw] reason
+    #   The optional reason for the applied decision.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/HarnessHookEvent AWS API Documentation
+    #
+    class HarnessHookEvent < Struct.new(
+      :hook_event_id,
+      :name,
+      :type,
+      :decision,
+      :reason,
+      :event_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration for an inline function tool. When the agent calls this
     # tool, the tool call is returned to the caller for external execution.
     #
@@ -4956,6 +4993,10 @@ module Aws::BedrockAgentCore
     #   The ARN of your OpenAI API key on AgentCore Identity.
     #   @return [String]
     #
+    # @!attribute [rw] api_base
+    #   Optional custom endpoint URL for an OpenAI-compatible endpoint.
+    #   @return [String]
+    #
     # @!attribute [rw] max_tokens
     #   The maximum number of tokens to allow in the generated response per
     #   iteration.
@@ -4983,12 +5024,13 @@ module Aws::BedrockAgentCore
     class HarnessOpenAiModelConfig < Struct.new(
       :model_id,
       :api_key_arn,
+      :api_base,
       :max_tokens,
       :temperature,
       :top_p,
       :api_format,
       :additional_params)
-      SENSITIVE = []
+      SENSITIVE = [:api_base]
       include Aws::Structure
     end
 
@@ -11631,7 +11673,8 @@ module Aws::BedrockAgentCore
           :metadata,
           :internal_server_exception,
           :validation_exception,
-          :runtime_client_error
+          :runtime_client_error,
+          :hook_event
         ]
       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.56.0'
+  GEM_VERSION = '1.57.0'
 
 end
 

data/sig/client.rbs

@@ -1016,6 +1016,7 @@ module Aws
                               open_ai_model_config: {
                                 model_id: ::String,
                                 api_key_arn: ::String,
+                                api_base: ::String?,
                                 max_tokens: ::Integer?,
                                 temperature: ::Float?,
                                 top_p: ::Float?,

data/sig/types.rbs

@@ -1431,6 +1431,16 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class HarnessHookEvent
+      attr_accessor hook_event_id: ::String
+      attr_accessor name: ::String
+      attr_accessor type: ("before_tool_call" | "after_tool_call" | "before_invocation" | "after_invocation")
+      attr_accessor decision: ("allow" | "deny")
+      attr_accessor reason: ::String
+      attr_accessor event_type: untyped
+      SENSITIVE: []
+    end
+
     class HarnessInlineFunctionConfig
       attr_accessor description: ::String
       attr_accessor input_schema: untyped
@@ -1461,7 +1471,7 @@ module Aws::BedrockAgentCore
     end
 
     class HarnessMessageStopEvent
-      attr_accessor stop_reason: ("end_turn" | "tool_use" | "tool_result" | "max_tokens" | "stop_sequence" | "content_filtered" | "malformed_model_output" | "malformed_tool_use" | "interrupted" | "partial_turn" | "model_context_window_exceeded" | "max_iterations_exceeded" | "max_output_tokens_exceeded" | "timeout_exceeded")
+      attr_accessor stop_reason: ("end_turn" | "tool_use" | "tool_result" | "max_tokens" | "stop_sequence" | "content_filtered" | "malformed_model_output" | "malformed_tool_use" | "interrupted" | "partial_turn" | "model_context_window_exceeded" | "max_iterations_exceeded" | "max_output_tokens_exceeded" | "timeout_exceeded" | "hook_stopped")
       attr_accessor event_type: untyped
       SENSITIVE: []
     end
@@ -1496,12 +1506,13 @@ module Aws::BedrockAgentCore
     class HarnessOpenAiModelConfig
       attr_accessor model_id: ::String
       attr_accessor api_key_arn: ::String
+      attr_accessor api_base: ::String
       attr_accessor max_tokens: ::Integer
       attr_accessor temperature: ::Float
       attr_accessor top_p: ::Float
       attr_accessor api_format: ("chat_completions" | "responses")
       attr_accessor additional_params: untyped
-      SENSITIVE: []
+      SENSITIVE: [:api_base]
     end
 
     class HarnessReasoningContentBlock
@@ -3449,7 +3460,7 @@ module Aws::BedrockAgentCore
     end
 
     class InvokeHarnessStreamOutput < Enumerator[untyped, untyped]
-      def event_types: () -> [:message_start, :content_block_start, :content_block_delta, :content_block_stop, :message_stop, :metadata, :internal_server_exception, :validation_exception, :runtime_client_error]
+      def event_types: () -> [:message_start, :content_block_start, :content_block_delta, :content_block_stop, :message_stop, :metadata, :internal_server_exception, :validation_exception, :runtime_client_error, :hook_event]
     end
   end
 end

metadata

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