google-cloud-dialogflow-v2 0.14.0 → 0.15.0

data/lib/google/cloud/dialogflow/v2/conversation_datasets/paths.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module ConversationDatasets
+          # Path helper methods for the ConversationDatasets API.
+          module Paths
+            ##
+            # Create a fully-qualified ConversationDataset resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/conversationDatasets/{conversation_dataset}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param conversation_dataset [String]
+            #
+            # @return [::String]
+            def conversation_dataset_path project:, location:, conversation_dataset:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/conversationDatasets/#{conversation_dataset}"
+            end
+
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/conversation_datasets.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/dialogflow/v2/version"
+
+require "google/cloud/dialogflow/v2/conversation_datasets/credentials"
+require "google/cloud/dialogflow/v2/conversation_datasets/paths"
+require "google/cloud/dialogflow/v2/conversation_datasets/operations"
+require "google/cloud/dialogflow/v2/conversation_datasets/client"
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        ##
+        # Conversation datasets.
+        #
+        # Conversation datasets contain raw conversation files and their
+        # customizable metadata that can be used for model training.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/dialogflow/v2/conversation_datasets"
+        #     client = ::Google::Cloud::Dialogflow::V2::ConversationDatasets::Client.new
+        #
+        module ConversationDatasets
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "conversation_datasets", "helpers.rb"
+require "google/cloud/dialogflow/v2/conversation_datasets/helpers" if ::File.file? helper_path

data/lib/google/cloud/dialogflow/v2/conversation_event_pb.rb

@@ -1,7 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/dialogflow/v2/conversation_event.proto
 
-require 'google/api/annotations_pb'
 require 'google/cloud/dialogflow/v2/participant_pb'
 require 'google/rpc/status_pb'
 require 'google/protobuf'

data/lib/google/cloud/dialogflow/v2/conversation_model_pb.rb

@@ -0,0 +1,205 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dialogflow/v2/conversation_model.proto
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/longrunning/operations_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/dialogflow/v2/conversation_model.proto", :syntax => :proto3) do
+    add_message "google.cloud.dialogflow.v2.ConversationModel" do
+      optional :name, :string, 1
+      optional :display_name, :string, 2
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+      repeated :datasets, :message, 4, "google.cloud.dialogflow.v2.InputDataset"
+      optional :state, :enum, 7, "google.cloud.dialogflow.v2.ConversationModel.State"
+      optional :language_code, :string, 19
+      oneof :model_metadata do
+        optional :article_suggestion_model_metadata, :message, 8, "google.cloud.dialogflow.v2.ArticleSuggestionModelMetadata"
+        optional :smart_reply_model_metadata, :message, 9, "google.cloud.dialogflow.v2.SmartReplyModelMetadata"
+      end
+    end
+    add_enum "google.cloud.dialogflow.v2.ConversationModel.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :CREATING, 1
+      value :UNDEPLOYED, 2
+      value :DEPLOYING, 3
+      value :DEPLOYED, 4
+      value :UNDEPLOYING, 5
+      value :DELETING, 6
+      value :FAILED, 7
+      value :PENDING, 8
+    end
+    add_enum "google.cloud.dialogflow.v2.ConversationModel.ModelType" do
+      value :MODEL_TYPE_UNSPECIFIED, 0
+      value :SMART_REPLY_DUAL_ENCODER_MODEL, 2
+      value :SMART_REPLY_BERT_MODEL, 6
+    end
+    add_message "google.cloud.dialogflow.v2.ConversationModelEvaluation" do
+      optional :name, :string, 1
+      optional :display_name, :string, 2
+      optional :evaluation_config, :message, 6, "google.cloud.dialogflow.v2.EvaluationConfig"
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+      oneof :metrics do
+        optional :smart_reply_metrics, :message, 5, "google.cloud.dialogflow.v2.SmartReplyMetrics"
+      end
+    end
+    add_message "google.cloud.dialogflow.v2.EvaluationConfig" do
+      repeated :datasets, :message, 3, "google.cloud.dialogflow.v2.InputDataset"
+      oneof :model_specific_config do
+        optional :smart_reply_config, :message, 2, "google.cloud.dialogflow.v2.EvaluationConfig.SmartReplyConfig"
+        optional :smart_compose_config, :message, 4, "google.cloud.dialogflow.v2.EvaluationConfig.SmartComposeConfig"
+      end
+    end
+    add_message "google.cloud.dialogflow.v2.EvaluationConfig.SmartReplyConfig" do
+      optional :allowlist_document, :string, 1
+      optional :max_result_count, :int32, 2
+    end
+    add_message "google.cloud.dialogflow.v2.EvaluationConfig.SmartComposeConfig" do
+      optional :allowlist_document, :string, 1
+      optional :max_result_count, :int32, 2
+    end
+    add_message "google.cloud.dialogflow.v2.InputDataset" do
+      optional :dataset, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.ArticleSuggestionModelMetadata" do
+      optional :training_model_type, :enum, 3, "google.cloud.dialogflow.v2.ConversationModel.ModelType"
+    end
+    add_message "google.cloud.dialogflow.v2.SmartReplyModelMetadata" do
+      optional :training_model_type, :enum, 6, "google.cloud.dialogflow.v2.ConversationModel.ModelType"
+    end
+    add_message "google.cloud.dialogflow.v2.SmartReplyMetrics" do
+      optional :allowlist_coverage, :float, 1
+      repeated :top_n_metrics, :message, 2, "google.cloud.dialogflow.v2.SmartReplyMetrics.TopNMetrics"
+      optional :conversation_count, :int64, 3
+    end
+    add_message "google.cloud.dialogflow.v2.SmartReplyMetrics.TopNMetrics" do
+      optional :n, :int32, 1
+      optional :recall, :float, 2
+    end
+    add_message "google.cloud.dialogflow.v2.CreateConversationModelRequest" do
+      optional :parent, :string, 1
+      optional :conversation_model, :message, 2, "google.cloud.dialogflow.v2.ConversationModel"
+    end
+    add_message "google.cloud.dialogflow.v2.GetConversationModelRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.ListConversationModelsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.dialogflow.v2.ListConversationModelsResponse" do
+      repeated :conversation_models, :message, 1, "google.cloud.dialogflow.v2.ConversationModel"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.dialogflow.v2.DeleteConversationModelRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.DeployConversationModelRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.UndeployConversationModelRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.GetConversationModelEvaluationRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.dialogflow.v2.ListConversationModelEvaluationsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.dialogflow.v2.ListConversationModelEvaluationsResponse" do
+      repeated :conversation_model_evaluations, :message, 1, "google.cloud.dialogflow.v2.ConversationModelEvaluation"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.dialogflow.v2.CreateConversationModelEvaluationRequest" do
+      optional :parent, :string, 1
+      optional :conversation_model_evaluation, :message, 2, "google.cloud.dialogflow.v2.ConversationModelEvaluation"
+    end
+    add_message "google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata" do
+      optional :conversation_model, :string, 1
+      optional :state, :enum, 2, "google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata.State"
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :PENDING, 1
+      value :SUCCEEDED, 2
+      value :FAILED, 3
+      value :CANCELLED, 4
+      value :CANCELLING, 5
+      value :TRAINING, 6
+    end
+    add_message "google.cloud.dialogflow.v2.DeployConversationModelOperationMetadata" do
+      optional :conversation_model, :string, 1
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.dialogflow.v2.UndeployConversationModelOperationMetadata" do
+      optional :conversation_model, :string, 1
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.dialogflow.v2.DeleteConversationModelOperationMetadata" do
+      optional :conversation_model, :string, 1
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_message "google.cloud.dialogflow.v2.CreateConversationModelEvaluationOperationMetadata" do
+      optional :conversation_model_evaluation, :string, 1
+      optional :conversation_model, :string, 4
+      optional :state, :enum, 2, "google.cloud.dialogflow.v2.CreateConversationModelEvaluationOperationMetadata.State"
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
+    add_enum "google.cloud.dialogflow.v2.CreateConversationModelEvaluationOperationMetadata.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :INITIALIZING, 1
+      value :RUNNING, 2
+      value :CANCELLED, 3
+      value :SUCCEEDED, 4
+      value :FAILED, 5
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        ConversationModel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ConversationModel").msgclass
+        ConversationModel::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ConversationModel.State").enummodule
+        ConversationModel::ModelType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ConversationModel.ModelType").enummodule
+        ConversationModelEvaluation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ConversationModelEvaluation").msgclass
+        EvaluationConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EvaluationConfig").msgclass
+        EvaluationConfig::SmartReplyConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EvaluationConfig.SmartReplyConfig").msgclass
+        EvaluationConfig::SmartComposeConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.EvaluationConfig.SmartComposeConfig").msgclass
+        InputDataset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.InputDataset").msgclass
+        ArticleSuggestionModelMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ArticleSuggestionModelMetadata").msgclass
+        SmartReplyModelMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SmartReplyModelMetadata").msgclass
+        SmartReplyMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SmartReplyMetrics").msgclass
+        SmartReplyMetrics::TopNMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.SmartReplyMetrics.TopNMetrics").msgclass
+        CreateConversationModelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelRequest").msgclass
+        GetConversationModelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.GetConversationModelRequest").msgclass
+        ListConversationModelsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListConversationModelsRequest").msgclass
+        ListConversationModelsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListConversationModelsResponse").msgclass
+        DeleteConversationModelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.DeleteConversationModelRequest").msgclass
+        DeployConversationModelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.DeployConversationModelRequest").msgclass
+        UndeployConversationModelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.UndeployConversationModelRequest").msgclass
+        GetConversationModelEvaluationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.GetConversationModelEvaluationRequest").msgclass
+        ListConversationModelEvaluationsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListConversationModelEvaluationsRequest").msgclass
+        ListConversationModelEvaluationsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.ListConversationModelEvaluationsResponse").msgclass
+        CreateConversationModelEvaluationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelEvaluationRequest").msgclass
+        CreateConversationModelOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata").msgclass
+        CreateConversationModelOperationMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata.State").enummodule
+        DeployConversationModelOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.DeployConversationModelOperationMetadata").msgclass
+        UndeployConversationModelOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.UndeployConversationModelOperationMetadata").msgclass
+        DeleteConversationModelOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.DeleteConversationModelOperationMetadata").msgclass
+        CreateConversationModelEvaluationOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelEvaluationOperationMetadata").msgclass
+        CreateConversationModelEvaluationOperationMetadata::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.CreateConversationModelEvaluationOperationMetadata.State").enummodule
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/conversation_model_services_pb.rb

@@ -0,0 +1,98 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/dialogflow/v2/conversation_model.proto for package 'google.cloud.dialogflow.v2'
+# Original file comments:
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/cloud/dialogflow/v2/conversation_model_pb'
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module ConversationModels
+          # Manages a collection of models for human agent assistant.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.dialogflow.v2.ConversationModels'
+
+            # Creates a model.
+            #
+            # This method is a [long-running
+            # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
+            # The returned `Operation` type has the following method-specific fields:
+            #
+            # - `metadata`: [CreateConversationModelOperationMetadata][google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata]
+            # - `response`: [ConversationModel][google.cloud.dialogflow.v2.ConversationModel]
+            rpc :CreateConversationModel, ::Google::Cloud::Dialogflow::V2::CreateConversationModelRequest, ::Google::Longrunning::Operation
+            # Gets conversation model.
+            rpc :GetConversationModel, ::Google::Cloud::Dialogflow::V2::GetConversationModelRequest, ::Google::Cloud::Dialogflow::V2::ConversationModel
+            # Lists conversation models.
+            rpc :ListConversationModels, ::Google::Cloud::Dialogflow::V2::ListConversationModelsRequest, ::Google::Cloud::Dialogflow::V2::ListConversationModelsResponse
+            # Deletes a model.
+            #
+            # This method is a [long-running
+            # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
+            # The returned `Operation` type has the following method-specific fields:
+            #
+            # - `metadata`: [DeleteConversationModelOperationMetadata][google.cloud.dialogflow.v2.DeleteConversationModelOperationMetadata]
+            # - `response`: An [Empty
+            #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+            rpc :DeleteConversationModel, ::Google::Cloud::Dialogflow::V2::DeleteConversationModelRequest, ::Google::Longrunning::Operation
+            # Deploys a model. If a model is already deployed, deploying it
+            # has no effect. A model can only serve prediction requests after it gets
+            # deployed. For article suggestion, custom model will not be used unless
+            # it is deployed.
+            #
+            # This method is a [long-running
+            # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
+            # The returned `Operation` type has the following method-specific fields:
+            #
+            # - `metadata`: [DeployConversationModelOperationMetadata][google.cloud.dialogflow.v2.DeployConversationModelOperationMetadata]
+            # - `response`: An [Empty
+            #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+            rpc :DeployConversationModel, ::Google::Cloud::Dialogflow::V2::DeployConversationModelRequest, ::Google::Longrunning::Operation
+            # Undeploys a model. If the model is not deployed this method has no effect.
+            # If the model is currently being used:
+            #   - For article suggestion, article suggestion will fallback to the default
+            #     model if model is undeployed.
+            #
+            # This method is a [long-running
+            # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
+            # The returned `Operation` type has the following method-specific fields:
+            #
+            # - `metadata`: [UndeployConversationModelOperationMetadata][google.cloud.dialogflow.v2.UndeployConversationModelOperationMetadata]
+            # - `response`: An [Empty
+            #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+            rpc :UndeployConversationModel, ::Google::Cloud::Dialogflow::V2::UndeployConversationModelRequest, ::Google::Longrunning::Operation
+            # Gets an evaluation of conversation model.
+            rpc :GetConversationModelEvaluation, ::Google::Cloud::Dialogflow::V2::GetConversationModelEvaluationRequest, ::Google::Cloud::Dialogflow::V2::ConversationModelEvaluation
+            # Lists evaluations of a conversation model.
+            rpc :ListConversationModelEvaluations, ::Google::Cloud::Dialogflow::V2::ListConversationModelEvaluationsRequest, ::Google::Cloud::Dialogflow::V2::ListConversationModelEvaluationsResponse
+            # Creates evaluation of a conversation model.
+            rpc :CreateConversationModelEvaluation, ::Google::Cloud::Dialogflow::V2::CreateConversationModelEvaluationRequest, ::Google::Longrunning::Operation
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end