twilio-ruby 5.15.1 → 5.58.1

data/lib/twilio-ruby/rest/autopilot/v1/assistant/query.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -17,7 +17,9 @@ module Twilio
             ##
             # Initialize the QueryList
             # @param [Version] version Version that contains the resource
-            # @param [String] assistant_sid The unique ID of the parent Assistant.
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
             # @return [QueryList] QueryList
             def initialize(version, assistant_sid: nil)
               super(version)
@@ -31,12 +33,16 @@ module Twilio
             # Lists QueryInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] language An ISO language-country string that specifies the
-            #   language used for this query. For example: en-US.
-            # @param [String] model_build The Model Build Sid or unique name of the Model
-            #   Build to be queried.
-            # @param [String] status A string that described the query status. The values can
-            #   be: `pending_review`, `reviewed`, `discarded`
+            # @param [String] language The {ISO
+            #   language-country}[https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html]
+            #   string that specifies the language used by the Query resources to read. For
+            #   example: `en-US`.
+            # @param [String] model_build The SID or unique name of the {Model
+            #   Build}[https://www.twilio.com/docs/autopilot/api/model-build] to be queried.
+            # @param [String] status The status of the resources to read. Can be:
+            #   `pending-review`, `reviewed`, or `discarded`
+            # @param [String] dialogue_sid The SID of the
+            #   {Dialogue}[https://www.twilio.com/docs/autopilot/api/dialogue].
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -44,11 +50,12 @@ module Twilio
             #    but a limit is defined, stream() will attempt to read the limit with the most
             #    efficient page size, i.e. min(limit, 1000)
             # @return [Array] Array of up to limit results
-            def list(language: :unset, model_build: :unset, status: :unset, limit: nil, page_size: nil)
+            def list(language: :unset, model_build: :unset, status: :unset, dialogue_sid: :unset, limit: nil, page_size: nil)
               self.stream(
                   language: language,
                   model_build: model_build,
                   status: status,
+                  dialogue_sid: dialogue_sid,
                   limit: limit,
                   page_size: page_size
               ).entries
@@ -58,12 +65,16 @@ module Twilio
             # Streams QueryInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] language An ISO language-country string that specifies the
-            #   language used for this query. For example: en-US.
-            # @param [String] model_build The Model Build Sid or unique name of the Model
-            #   Build to be queried.
-            # @param [String] status A string that described the query status. The values can
-            #   be: `pending_review`, `reviewed`, `discarded`
+            # @param [String] language The {ISO
+            #   language-country}[https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html]
+            #   string that specifies the language used by the Query resources to read. For
+            #   example: `en-US`.
+            # @param [String] model_build The SID or unique name of the {Model
+            #   Build}[https://www.twilio.com/docs/autopilot/api/model-build] to be queried.
+            # @param [String] status The status of the resources to read. Can be:
+            #   `pending-review`, `reviewed`, or `discarded`
+            # @param [String] dialogue_sid The SID of the
+            #   {Dialogue}[https://www.twilio.com/docs/autopilot/api/dialogue].
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -71,13 +82,14 @@ module Twilio
             #    but a limit is defined, stream() will attempt to read the limit with the most
             #    efficient page size, i.e. min(limit, 1000)
             # @return [Enumerable] Enumerable that will yield up to limit results
-            def stream(language: :unset, model_build: :unset, status: :unset, limit: nil, page_size: nil)
+            def stream(language: :unset, model_build: :unset, status: :unset, dialogue_sid: :unset, limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
               page = self.page(
                   language: language,
                   model_build: model_build,
                   status: status,
+                  dialogue_sid: dialogue_sid,
                   page_size: limits[:page_size],
               )
 
@@ -101,30 +113,33 @@ module Twilio
             ##
             # Retrieve a single page of QueryInstance records from the API.
             # Request is executed immediately.
-            # @param [String] language An ISO language-country string that specifies the
-            #   language used for this query. For example: en-US.
-            # @param [String] model_build The Model Build Sid or unique name of the Model
-            #   Build to be queried.
-            # @param [String] status A string that described the query status. The values can
-            #   be: `pending_review`, `reviewed`, `discarded`
+            # @param [String] language The {ISO
+            #   language-country}[https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html]
+            #   string that specifies the language used by the Query resources to read. For
+            #   example: `en-US`.
+            # @param [String] model_build The SID or unique name of the {Model
+            #   Build}[https://www.twilio.com/docs/autopilot/api/model-build] to be queried.
+            # @param [String] status The status of the resources to read. Can be:
+            #   `pending-review`, `reviewed`, or `discarded`
+            # @param [String] dialogue_sid The SID of the
+            #   {Dialogue}[https://www.twilio.com/docs/autopilot/api/dialogue].
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
             # @return [Page] Page of QueryInstance
-            def page(language: :unset, model_build: :unset, status: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+            def page(language: :unset, model_build: :unset, status: :unset, dialogue_sid: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
               params = Twilio::Values.of({
                   'Language' => language,
                   'ModelBuild' => model_build,
                   'Status' => status,
+                  'DialogueSid' => dialogue_sid,
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               QueryPage.new(@version, response, @solution)
             end
 
@@ -142,18 +157,19 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of QueryInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] language An ISO language-country string that specifies the
-            #   language used for this query. For example: en-US.
-            # @param [String] query A user-provided string that uniquely identifies this
-            #   resource as an alternative to the sid. It can be up to 2048 characters long.
-            # @param [String] tasks Constraints the query to a set of tasks. Useful when you
-            #   need to constrain the paths the user can take. Tasks should be comma separated
-            #   *task-unique-name-1*, *task-unique-name-2*
-            # @param [String] model_build The Model Build Sid or unique name of the Model
-            #   Build to be queried.
-            # @return [QueryInstance] Newly created QueryInstance
+            # Create the QueryInstance
+            # @param [String] language The {ISO
+            #   language-country}[https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html]
+            #   string that specifies the language used for the new query. For example: `en-US`.
+            # @param [String] query The end-user's natural language input. It can be up to
+            #   2048 characters long.
+            # @param [String] tasks The list of tasks to limit the new query to. Tasks are
+            #   expressed as a comma-separated list of task `unique_name` values. For example,
+            #   `task-unique_name-1, task-unique_name-2`. Listing specific tasks is useful to
+            #   constrain the paths that a user can take.
+            # @param [String] model_build The SID or unique name of the {Model
+            #   Build}[https://www.twilio.com/docs/autopilot/api/model-build] to be queried.
+            # @return [QueryInstance] Created QueryInstance
             def create(language: nil, query: nil, tasks: :unset, model_build: :unset)
               data = Twilio::Values.of({
                   'Language' => language,
@@ -162,11 +178,7 @@ module Twilio
                   'ModelBuild' => model_build,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               QueryInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
             end
@@ -215,8 +227,11 @@ module Twilio
             ##
             # Initialize the QueryContext
             # @param [Version] version Version that contains the resource
-            # @param [String] assistant_sid The assistant_sid
-            # @param [String] sid The sid
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource to fetch.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Query resource to fetch.
             # @return [QueryContext] QueryContext
             def initialize(version, assistant_sid, sid)
               super(version)
@@ -227,43 +242,35 @@ module Twilio
             end
 
             ##
-            # Fetch a QueryInstance
+            # Fetch the QueryInstance
             # @return [QueryInstance] Fetched QueryInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               QueryInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], sid: @solution[:sid], )
             end
 
             ##
             # Update the QueryInstance
-            # @param [String] sample_sid The sample_sid
-            # @param [String] status A string that described the query status. The values can
-            #   be: `pending_review`, `reviewed`, `discarded`
+            # @param [String] sample_sid The SID of an optional reference to the
+            #   {Sample}[https://www.twilio.com/docs/autopilot/api/task-sample] created from the
+            #   query.
+            # @param [String] status The new status of the resource. Can be: `pending-review`,
+            #   `reviewed`, or `discarded`
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)
               data = Twilio::Values.of({'SampleSid' => sample_sid, 'Status' => status, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               QueryInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the QueryInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the QueryInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -272,6 +279,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Autopilot.V1.QueryContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Autopilot.V1.QueryContext #{context}>"
+            end
           end
 
           ##
@@ -281,8 +295,11 @@ module Twilio
             # Initialize the QueryInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] assistant_sid The unique ID of the parent Assistant.
-            # @param [String] sid The sid
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Query resource to fetch.
             # @return [QueryInstance] QueryInstance
             def initialize(version, payload, assistant_sid: nil, sid: nil)
               super(version)
@@ -302,6 +319,7 @@ module Twilio
                   'status' => payload['status'],
                   'url' => payload['url'],
                   'source_channel' => payload['source_channel'],
+                  'dialogue_sid' => payload['dialogue_sid'],
               }
 
               # Context
@@ -321,85 +339,91 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique ID of the Account that created this Query.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [Time] The date that this resource was created
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date that this resource was last updated
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [Hash] The natural language analysis results which include the Task recognized, the confidence score and a list of identified Fields.
+            # @return [Hash] The natural language analysis results that include the Task recognized and a list of identified Fields
             def results
               @properties['results']
             end
 
             ##
-            # @return [String] An ISO language-country string that specifies the language used for this query. For example: en-US
+            # @return [String] The ISO language-country string that specifies the language used by the Query
             def language
               @properties['language']
             end
 
             ##
-            # @return [String] The unique ID of the Model Build queried.
+            # @return [String] The SID of the {Model Build}[https://www.twilio.com/docs/autopilot/api/model-build] queried
             def model_build_sid
               @properties['model_build_sid']
             end
 
             ##
-            # @return [String] The end-user's natural language input.
+            # @return [String] The end-user's natural language input
             def query
               @properties['query']
             end
 
             ##
-            # @return [String] An optional reference to the Sample created from this query.
+            # @return [String] The SID of an optional reference to the Sample created from the query
             def sample_sid
               @properties['sample_sid']
             end
 
             ##
-            # @return [String] The unique ID of the parent Assistant.
+            # @return [String] The SID of the Assistant that is the parent of the resource
             def assistant_sid
               @properties['assistant_sid']
             end
 
             ##
-            # @return [String] A 34 character string that uniquely identifies this resource.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] A string that describes the query status. The values can be: `pending_review`, `reviewed`, `discarded`
+            # @return [String] The status of the Query
             def status
               @properties['status']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the Query resource
             def url
               @properties['url']
             end
 
             ##
-            # @return [String] The communication channel where this end-user input came from
+            # @return [String] The communication channel from where the end-user input came
             def source_channel
               @properties['source_channel']
             end
 
             ##
-            # Fetch a QueryInstance
+            # @return [String] The SID of the {Dialogue}[https://www.twilio.com/docs/autopilot/api/dialogue].
+            def dialogue_sid
+              @properties['dialogue_sid']
+            end
+
+            ##
+            # Fetch the QueryInstance
             # @return [QueryInstance] Fetched QueryInstance
             def fetch
               context.fetch
@@ -407,17 +431,19 @@ module Twilio
 
             ##
             # Update the QueryInstance
-            # @param [String] sample_sid The sample_sid
-            # @param [String] status A string that described the query status. The values can
-            #   be: `pending_review`, `reviewed`, `discarded`
+            # @param [String] sample_sid The SID of an optional reference to the
+            #   {Sample}[https://www.twilio.com/docs/autopilot/api/task-sample] created from the
+            #   query.
+            # @param [String] status The new status of the resource. Can be: `pending-review`,
+            #   `reviewed`, or `discarded`
             # @return [QueryInstance] Updated QueryInstance
             def update(sample_sid: :unset, status: :unset)
               context.update(sample_sid: sample_sid, status: status, )
             end
 
             ##
-            # Deletes the QueryInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the QueryInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end

data/lib/twilio-ruby/rest/autopilot/v1/assistant/style_sheet.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -17,7 +17,9 @@ module Twilio
             ##
             # Initialize the StyleSheetList
             # @param [Version] version Version that contains the resource
-            # @param [String] assistant_sid The unique ID of the Assistant
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
             # @return [StyleSheetList] StyleSheetList
             def initialize(version, assistant_sid: nil)
               super(version)
@@ -70,7 +72,9 @@ module Twilio
             ##
             # Initialize the StyleSheetContext
             # @param [Version] version Version that contains the resource
-            # @param [String] assistant_sid The unique ID of the Assistant
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource to fetch.
             # @return [StyleSheetContext] StyleSheetContext
             def initialize(version, assistant_sid)
               super(version)
@@ -81,32 +85,22 @@ module Twilio
             end
 
             ##
-            # Fetch a StyleSheetInstance
+            # Fetch the StyleSheetInstance
             # @return [StyleSheetInstance] Fetched StyleSheetInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               StyleSheetInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
             end
 
             ##
             # Update the StyleSheetInstance
-            # @param [Hash] style_sheet The JSON Style sheet string
+            # @param [Hash] style_sheet The JSON string that describes the style sheet object.
             # @return [StyleSheetInstance] Updated StyleSheetInstance
             def update(style_sheet: :unset)
               data = Twilio::Values.of({'StyleSheet' => Twilio.serialize_object(style_sheet), })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               StyleSheetInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
             end
@@ -117,6 +111,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Autopilot.V1.StyleSheetContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Autopilot.V1.StyleSheetContext #{context}>"
+            end
           end
 
           ##
@@ -126,7 +127,9 @@ module Twilio
             # Initialize the StyleSheetInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] assistant_sid The unique ID of the Assistant
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
             # @return [StyleSheetInstance] StyleSheetInstance
             def initialize(version, payload, assistant_sid: nil)
               super(version)
@@ -156,31 +159,31 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique ID of the Account that created this Assistant
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The unique ID of the Assistant
+            # @return [String] The SID of the Assistant that is the parent of the resource
             def assistant_sid
               @properties['assistant_sid']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the StyleSheet resource
             def url
               @properties['url']
             end
 
             ##
-            # @return [Hash] The JSON style sheet object
+            # @return [Hash] The JSON string that describes the style sheet object
             def data
               @properties['data']
             end
 
             ##
-            # Fetch a StyleSheetInstance
+            # Fetch the StyleSheetInstance
             # @return [StyleSheetInstance] Fetched StyleSheetInstance
             def fetch
               context.fetch
@@ -188,7 +191,7 @@ module Twilio
 
             ##
             # Update the StyleSheetInstance
-            # @param [Hash] style_sheet The JSON Style sheet string
+            # @param [Hash] style_sheet The JSON string that describes the style sheet object.
             # @return [StyleSheetInstance] Updated StyleSheetInstance
             def update(style_sheet: :unset)
               context.update(style_sheet: style_sheet, )