aws-sdk-bedrockagentcore 1.56.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb7b52155366ef862784c13760dd432f6b3d131e90f7b1dd3022d0d6d35b1560
-  data.tar.gz: f6c1676399424a71b00b8a8ceb53a00b22e4cb1b4547c593e858a90937956054
+  metadata.gz: 330e5b287a6debd1f0295bb8a4492d69cc59a54f865010889d6ffecbc9e3d1db
+  data.tar.gz: 76a2dd331bc84aeb0866b0c586d8474feeb8f356969a32ac2c5749eeb99ad31a
 SHA512:
-  metadata.gz: f794c438005da7371edc77ada944fd8a181bb1655d875399f1eb18bb311b3f53b84aec98b42fce9342575ce493d06308c4c8848992fcd391b03a7880148c057f
-  data.tar.gz: d24f39255446db5b0c233f7fc0b73303b781a90725a70ae41c47338a44440aa5d316d37d8b6fad887d7410236297f286a89df1ccf9e664a1ef8cd652d9d3d6f4
+  metadata.gz: ec68d5f9e08dfe1435c77807afaf29a4620ca31d2306291c77b5d2cfc90955ef86fca46c2295f09b751b860f818385739e60b68fcbff80e2849c860988220910
+  data.tar.gz: 41d2432ee157100ddf20d841266ae440a30cc1e4566005478e71365f9ebbc5fc6f467c4fb357cae5fe2bc1c9443a8e875307ff4b2bdc2095c1726ef7eeb58f58

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.58.0 (2026-10-12)
+------------------
+
+* Feature - AgentCore Memory now supports Long-Term Memory Time-to-Live on Batch APIs.
+
+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.58.0

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

@@ -502,6 +502,15 @@ module Aws::BedrockAgentCore
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Types::RecordExpirySpecification] :record_expiry_specification
+    #   The record expiry (long-term memory time-to-live) applied to every
+    #   record created by this request. Set `recordExpiryDurationDays` to the
+    #   number of days after which the records expire. Only the expiry
+    #   provided here is applied; the records' strategy association has no
+    #   effect on their expiry. If you do not provide this value, the records
+    #   do not expire. The `REMOVE` action does not apply when creating
+    #   records.
+    #
     # @return [Types::BatchCreateMemoryRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BatchCreateMemoryRecordsOutput#successful_records #successful_records} => Array<Types::MemoryRecordOutput>
@@ -531,6 +540,10 @@ module Aws::BedrockAgentCore
     #       },
     #     ],
     #     client_token: "String",
+    #     record_expiry_specification: {
+    #       record_expiry_duration_days: 1,
+    #       action: "REMOVE", # accepts REMOVE
+    #     },
     #   })
     #
     # @example Response structure
@@ -618,6 +631,28 @@ module Aws::BedrockAgentCore
     #   A list of memory record update inputs to be processed in the batch
     #   operation.
     #
+    # @option params [Types::RecordExpirySpecification] :record_expiry_specification
+    #   The record expiry (long-term memory time-to-live) applied to every
+    #   record updated by this request. Set `recordExpiryDurationDays` to
+    #   configure or overwrite the number of days after which the records
+    #   expire, or set `action` to `REMOVE` to clear a previously configured
+    #   expiry so that the records no longer expire.
+    #
+    #   When you do not provide this value, the service determines each
+    #   record's expiry from its current state:
+    #
+    #   * If the record already has an expiry configured, the service resets
+    #     and reapplies the expiry based on the last applied
+    #     `recordExpiryDurationDays`.
+    #
+    #   * If the record does not have an expiry configured, no expiry is
+    #     applied and the record remains non-expiring. This is the outcome
+    #     regardless of whether the record's strategy configures an expiry.
+    #
+    #   Providing an explicit `recordExpiryDurationDays` always takes
+    #   precedence: it overwrites an existing expiry, or sets one on a record
+    #   that previously had none.
+    #
     # @return [Types::BatchUpdateMemoryRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BatchUpdateMemoryRecordsOutput#successful_records #successful_records} => Array<Types::MemoryRecordOutput>
@@ -647,6 +682,10 @@ module Aws::BedrockAgentCore
     #         },
     #       },
     #     ],
+    #     record_expiry_specification: {
+    #       record_expiry_duration_days: 1,
+    #       action: "REMOVE", # accepts REMOVE
+    #     },
     #   })
     #
     # @example Response structure
@@ -2107,12 +2146,14 @@ module Aws::BedrockAgentCore
     #   resp.memory_record.namespaces #=> Array
     #   resp.memory_record.namespaces[0] #=> String
     #   resp.memory_record.created_at #=> Time
+    #   resp.memory_record.timestamp #=> Time
     #   resp.memory_record.metadata #=> Hash
     #   resp.memory_record.metadata["MetadataKey"].string_value #=> String
     #   resp.memory_record.metadata["MetadataKey"].string_list_value #=> Array
     #   resp.memory_record.metadata["MetadataKey"].string_list_value[0] #=> String
     #   resp.memory_record.metadata["MetadataKey"].number_value #=> Float
     #   resp.memory_record.metadata["MetadataKey"].date_time_value #=> Time
+    #   resp.memory_record.expires_at #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/GetMemoryRecord AWS API Documentation
     #
@@ -3851,6 +3892,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 +3931,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 +3970,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 +4054,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 +4161,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 +4190,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 +4213,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 = {})
@@ -4758,6 +4816,7 @@ module Aws::BedrockAgentCore
     #   resp.memory_record_summaries[0].namespaces[0] #=> String
     #   resp.memory_record_summaries[0].created_at #=> Time
     #   resp.memory_record_summaries[0].score #=> Float
+    #   resp.memory_record_summaries[0].timestamp #=> Time
     #   resp.memory_record_summaries[0].metadata #=> Hash
     #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_value #=> String
     #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_list_value #=> Array
@@ -5185,6 +5244,7 @@ module Aws::BedrockAgentCore
     #   resp.memory_record_summaries[0].namespaces[0] #=> String
     #   resp.memory_record_summaries[0].created_at #=> Time
     #   resp.memory_record_summaries[0].score #=> Float
+    #   resp.memory_record_summaries[0].timestamp #=> Time
     #   resp.memory_record_summaries[0].metadata #=> Hash
     #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_value #=> String
     #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_list_value #=> Array
@@ -6566,7 +6626,7 @@ module Aws::BedrockAgentCore
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentcore'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.58.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')
@@ -626,6 +633,9 @@ module Aws::BedrockAgentCore
     RecommendationSummaryList = Shapes::ListShape.new(name: 'RecommendationSummaryList')
     RecommendationToolName = Shapes::StringShape.new(name: 'RecommendationToolName')
     RecommendationType = Shapes::StringShape.new(name: 'RecommendationType')
+    RecordExpiryAction = Shapes::StringShape.new(name: 'RecordExpiryAction')
+    RecordExpiryDurationDays = Shapes::IntegerShape.new(name: 'RecordExpiryDurationDays')
+    RecordExpirySpecification = Shapes::UnionShape.new(name: 'RecordExpirySpecification')
     RegistryArn = Shapes::StringShape.new(name: 'RegistryArn')
     RegistryIdentifier = Shapes::StringShape.new(name: 'RegistryIdentifier')
     RegistryRecordArn = Shapes::StringShape.new(name: 'RegistryRecordArn')
@@ -922,6 +932,7 @@ module Aws::BedrockAgentCore
     BatchCreateMemoryRecordsInput.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, required: true, location: "uri", location_name: "memoryId"))
     BatchCreateMemoryRecordsInput.add_member(:records, Shapes::ShapeRef.new(shape: MemoryRecordsCreateInputList, required: true, location_name: "records"))
     BatchCreateMemoryRecordsInput.add_member(:client_token, Shapes::ShapeRef.new(shape: String, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
+    BatchCreateMemoryRecordsInput.add_member(:record_expiry_specification, Shapes::ShapeRef.new(shape: RecordExpirySpecification, location_name: "recordExpirySpecification"))
     BatchCreateMemoryRecordsInput.struct_class = Types::BatchCreateMemoryRecordsInput
 
     BatchCreateMemoryRecordsOutput.add_member(:successful_records, Shapes::ShapeRef.new(shape: MemoryRecordsOutputList, required: true, location_name: "successfulRecords"))
@@ -957,6 +968,7 @@ module Aws::BedrockAgentCore
 
     BatchUpdateMemoryRecordsInput.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, required: true, location: "uri", location_name: "memoryId"))
     BatchUpdateMemoryRecordsInput.add_member(:records, Shapes::ShapeRef.new(shape: MemoryRecordsUpdateInputList, required: true, location_name: "records"))
+    BatchUpdateMemoryRecordsInput.add_member(:record_expiry_specification, Shapes::ShapeRef.new(shape: RecordExpirySpecification, location_name: "recordExpirySpecification"))
     BatchUpdateMemoryRecordsInput.struct_class = Types::BatchUpdateMemoryRecordsInput
 
     BatchUpdateMemoryRecordsOutput.add_member(:successful_records, Shapes::ShapeRef.new(shape: MemoryRecordsOutputList, required: true, location_name: "successfulRecords"))
@@ -1905,6 +1917,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 +1967,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 +2313,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)
@@ -2515,7 +2536,9 @@ module Aws::BedrockAgentCore
     MemoryRecord.add_member(:memory_strategy_id, Shapes::ShapeRef.new(shape: MemoryStrategyId, required: true, location_name: "memoryStrategyId"))
     MemoryRecord.add_member(:namespaces, Shapes::ShapeRef.new(shape: NamespacesList, required: true, location_name: "namespaces"))
     MemoryRecord.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "createdAt"))
+    MemoryRecord.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "timestamp"))
     MemoryRecord.add_member(:metadata, Shapes::ShapeRef.new(shape: MemoryRecordMetadataMap, location_name: "metadata"))
+    MemoryRecord.add_member(:expires_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "expiresAt"))
     MemoryRecord.struct_class = Types::MemoryRecord
 
     MemoryRecordCreateInput.add_member(:request_identifier, Shapes::ShapeRef.new(shape: RequestIdentifier, required: true, location_name: "requestIdentifier"))
@@ -2570,6 +2593,7 @@ module Aws::BedrockAgentCore
     MemoryRecordSummary.add_member(:namespaces, Shapes::ShapeRef.new(shape: NamespacesList, required: true, location_name: "namespaces"))
     MemoryRecordSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "createdAt"))
     MemoryRecordSummary.add_member(:score, Shapes::ShapeRef.new(shape: Double, location_name: "score"))
+    MemoryRecordSummary.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "timestamp"))
     MemoryRecordSummary.add_member(:metadata, Shapes::ShapeRef.new(shape: MemoryRecordMetadataMap, location_name: "metadata"))
     MemoryRecordSummary.struct_class = Types::MemoryRecordSummary
 
@@ -2875,6 +2899,14 @@ module Aws::BedrockAgentCore
 
     RecommendationSummaryList.member = Shapes::ShapeRef.new(shape: RecommendationSummary)
 
+    RecordExpirySpecification.add_member(:record_expiry_duration_days, Shapes::ShapeRef.new(shape: RecordExpiryDurationDays, location_name: "recordExpiryDurationDays"))
+    RecordExpirySpecification.add_member(:action, Shapes::ShapeRef.new(shape: RecordExpiryAction, location_name: "action"))
+    RecordExpirySpecification.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    RecordExpirySpecification.add_member_subclass(:record_expiry_duration_days, Types::RecordExpirySpecification::RecordExpiryDurationDays)
+    RecordExpirySpecification.add_member_subclass(:action, Types::RecordExpirySpecification::Action)
+    RecordExpirySpecification.add_member_subclass(:unknown, Types::RecordExpirySpecification::Unknown)
+    RecordExpirySpecification.struct_class = Types::RecordExpirySpecification
+
     RegistryRecordSummary.add_member(:registry_arn, Shapes::ShapeRef.new(shape: RegistryArn, required: true, location_name: "registryArn"))
     RegistryRecordSummary.add_member(:record_arn, Shapes::ShapeRef.new(shape: RegistryRecordArn, required: true, location_name: "recordArn"))
     RegistryRecordSummary.add_member(:record_id, Shapes::ShapeRef.new(shape: RegistryRecordId, required: true, location_name: "recordId"))

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

@@ -403,12 +403,23 @@ module Aws::BedrockAgentCore
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] record_expiry_specification
+    #   The record expiry (long-term memory time-to-live) applied to every
+    #   record created by this request. Set `recordExpiryDurationDays` to
+    #   the number of days after which the records expire. Only the expiry
+    #   provided here is applied; the records' strategy association has no
+    #   effect on their expiry. If you do not provide this value, the
+    #   records do not expire. The `REMOVE` action does not apply when
+    #   creating records.
+    #   @return [Types::RecordExpirySpecification]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/BatchCreateMemoryRecordsInput AWS API Documentation
     #
     class BatchCreateMemoryRecordsInput < Struct.new(
       :memory_id,
       :records,
-      :client_token)
+      :client_token,
+      :record_expiry_specification)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -563,11 +574,35 @@ module Aws::BedrockAgentCore
     #   operation.
     #   @return [Array<Types::MemoryRecordUpdateInput>]
     #
+    # @!attribute [rw] record_expiry_specification
+    #   The record expiry (long-term memory time-to-live) applied to every
+    #   record updated by this request. Set `recordExpiryDurationDays` to
+    #   configure or overwrite the number of days after which the records
+    #   expire, or set `action` to `REMOVE` to clear a previously configured
+    #   expiry so that the records no longer expire.
+    #
+    #   When you do not provide this value, the service determines each
+    #   record's expiry from its current state:
+    #
+    #   * If the record already has an expiry configured, the service resets
+    #     and reapplies the expiry based on the last applied
+    #     `recordExpiryDurationDays`.
+    #
+    #   * If the record does not have an expiry configured, no expiry is
+    #     applied and the record remains non-expiring. This is the outcome
+    #     regardless of whether the record's strategy configures an expiry.
+    #
+    #   Providing an explicit `recordExpiryDurationDays` always takes
+    #   precedence: it overwrites an existing expiry, or sets one on a
+    #   record that previously had none.
+    #   @return [Types::RecordExpirySpecification]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/BatchUpdateMemoryRecordsInput AWS API Documentation
     #
     class BatchUpdateMemoryRecordsInput < Struct.new(
       :memory_id,
-      :records)
+      :records,
+      :record_expiry_specification)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4768,6 +4803,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 +5028,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 +5059,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
 
@@ -5107,7 +5184,8 @@ module Aws::BedrockAgentCore
     #   @return [Types::HarnessSkillGitSource]
     #
     # @!attribute [rw] aws_skills
-    #   AWS Skills baked into the Harness's underlying Runtime.
+    #   Amazon Web Services Skills baked into the Harness's underlying
+    #   Runtime.
     #   @return [Types::HarnessSkillAwsSkillsSource]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/HarnessSkill AWS API Documentation
@@ -5129,7 +5207,7 @@ module Aws::BedrockAgentCore
       class Unknown < HarnessSkill; end
     end
 
-    # Passed to show that AWS Skills should be included.
+    # Passed to show that Amazon Web Services Skills should be included.
     #
     # @!attribute [rw] paths
     #   Optionally filter allowed skills with glob syntax, e.g.,
@@ -7393,10 +7471,27 @@ module Aws::BedrockAgentCore
     #   The timestamp when the memory record was created.
     #   @return [Time]
     #
+    # @!attribute [rw] timestamp
+    #   The timestamp based on which the memory record was ingested. This
+    #   reflects the time of the source content that the record was derived
+    #   from, which can differ from `createdAt`, the time the record itself
+    #   was written.
+    #   @return [Time]
+    #
     # @!attribute [rw] metadata
     #   A map of metadata key-value pairs associated with a memory record.
     #   @return [Hash<String,Types::MemoryRecordMetadataValue>]
     #
+    # @!attribute [rw] expires_at
+    #   The timestamp at which the memory record expires and becomes
+    #   eligible for deletion. This value is set when a record expiry
+    #   (long-term memory time-to-live) applies to the record, either from
+    #   the strategy the record belongs to or from a record expiry provided
+    #   on the batch request that created or updated it. If the record has
+    #   no expiry configured, this value is not present and the record does
+    #   not expire.
+    #   @return [Time]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/MemoryRecord AWS API Documentation
     #
     class MemoryRecord < Struct.new(
@@ -7405,7 +7500,9 @@ module Aws::BedrockAgentCore
       :memory_strategy_id,
       :namespaces,
       :created_at,
-      :metadata)
+      :timestamp,
+      :metadata,
+      :expires_at)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -7620,6 +7717,13 @@ module Aws::BedrockAgentCore
     #   search query.
     #   @return [Float]
     #
+    # @!attribute [rw] timestamp
+    #   The timestamp based on which the memory record was ingested. This
+    #   reflects the time of the source content that the record was derived
+    #   from, which can differ from `createdAt`, the time the record itself
+    #   was written.
+    #   @return [Time]
+    #
     # @!attribute [rw] metadata
     #   A map of metadata key-value pairs associated with a memory record.
     #   @return [Hash<String,Types::MemoryRecordMetadataValue>]
@@ -7633,6 +7737,7 @@ module Aws::BedrockAgentCore
       :namespaces,
       :created_at,
       :score,
+      :timestamp,
       :metadata)
       SENSITIVE = []
       include Aws::Structure
@@ -8864,6 +8969,41 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # Specifies the record expiry (long-term memory time-to-live) applied to
+    # the records in a batch request. Provide exactly one of
+    # `recordExpiryDurationDays` or `action`. Set `recordExpiryDurationDays`
+    # to configure or update the expiry, or set `action` to `REMOVE` to
+    # remove a previously configured expiry.
+    #
+    # @note RecordExpirySpecification is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] record_expiry_duration_days
+    #   The duration, in days, after which the records in this request
+    #   expire. The minimum is 31 days.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] action
+    #   The action to apply to the existing record expiry configuration. Set
+    #   to `REMOVE` to remove a previously configured expiry so that the
+    #   records no longer expire. This value does not apply when creating
+    #   records.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/RecordExpirySpecification AWS API Documentation
+    #
+    class RecordExpirySpecification < Struct.new(
+      :record_expiry_duration_days,
+      :action,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class RecordExpiryDurationDays < RecordExpirySpecification; end
+      class Action < RecordExpirySpecification; end
+      class Unknown < RecordExpirySpecification; end
+    end
+
     # Summary information about a registry record.
     #
     # @!attribute [rw] registry_arn
@@ -11631,7 +11771,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.58.0'
 
 end
 

data/sig/client.rbs

@@ -106,7 +106,11 @@ module Aws
                                                }]?
                                            }
                                          ],
-                                         ?client_token: ::String
+                                         ?client_token: ::String,
+                                         ?record_expiry_specification: {
+                                           record_expiry_duration_days: ::Integer?,
+                                           action: ("REMOVE")?
+                                         }
                                        ) -> _BatchCreateMemoryRecordsResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _BatchCreateMemoryRecordsResponseSuccess
 
@@ -152,7 +156,11 @@ module Aws
                                                  date_time_value: ::Time?
                                                }]?
                                            }
-                                         ]
+                                         ],
+                                         ?record_expiry_specification: {
+                                           record_expiry_duration_days: ::Integer?,
+                                           action: ("REMOVE")?
+                                         }
                                        ) -> _BatchUpdateMemoryRecordsResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _BatchUpdateMemoryRecordsResponseSuccess
 
@@ -1016,6 +1024,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

@@ -130,6 +130,7 @@ module Aws::BedrockAgentCore
       attr_accessor memory_id: ::String
       attr_accessor records: ::Array[Types::MemoryRecordCreateInput]
       attr_accessor client_token: ::String
+      attr_accessor record_expiry_specification: Types::RecordExpirySpecification
       SENSITIVE: []
     end
 
@@ -175,6 +176,7 @@ module Aws::BedrockAgentCore
     class BatchUpdateMemoryRecordsInput
       attr_accessor memory_id: ::String
       attr_accessor records: ::Array[Types::MemoryRecordUpdateInput]
+      attr_accessor record_expiry_specification: Types::RecordExpirySpecification
       SENSITIVE: []
     end
 
@@ -1431,6 +1433,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 +1473,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 +1508,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
@@ -2226,7 +2239,9 @@ module Aws::BedrockAgentCore
       attr_accessor memory_strategy_id: ::String
       attr_accessor namespaces: ::Array[::String]
       attr_accessor created_at: ::Time
+      attr_accessor timestamp: ::Time
       attr_accessor metadata: ::Hash[::String, Types::MemoryRecordMetadataValue]
+      attr_accessor expires_at: ::Time
       SENSITIVE: []
     end
 
@@ -2304,6 +2319,7 @@ module Aws::BedrockAgentCore
       attr_accessor namespaces: ::Array[::String]
       attr_accessor created_at: ::Time
       attr_accessor score: ::Float
+      attr_accessor timestamp: ::Time
       attr_accessor metadata: ::Hash[::String, Types::MemoryRecordMetadataValue]
       SENSITIVE: []
     end
@@ -2697,6 +2713,20 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class RecordExpirySpecification
+      attr_accessor record_expiry_duration_days: ::Integer
+      attr_accessor action: ("REMOVE")
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class RecordExpiryDurationDays < RecordExpirySpecification
+      end
+      class Action < RecordExpirySpecification
+      end
+      class Unknown < RecordExpirySpecification
+      end
+    end
+
     class RegistryRecordSummary
       attr_accessor registry_arn: ::String
       attr_accessor record_arn: ::String
@@ -3449,7 +3479,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.58.0
 platform: ruby
 authors:
 - Amazon Web Services