telnyx 5.167.0 → 5.169.0

data/lib/telnyx/models/ai/typesafe/v1_systemone_params.rb

@@ -0,0 +1,268 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Typesafe
+        # @see Telnyx::Resources::AI::Typesafe::V1#systemone
+        class V1SystemoneParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute questions
+          #   Between 1 and 64 named questions. Each key identifies the corresponding answer.
+          #
+          #   @return [Hash{Symbol=>Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score}]
+          required :questions,
+                   -> { Telnyx::Internal::Type::HashOf[union: Telnyx::AI::Typesafe::V1SystemoneParams::Question] }
+
+          # @!attribute state
+          #   Shared context evaluated by every question.
+          #
+          #   @return [String, Hash{Symbol=>Object}, Array<Object>]
+          required :state, union: -> { Telnyx::AI::Typesafe::V1SystemoneParams::State }
+
+          # @!method initialize(questions:, state:, request_options: {})
+          #   @param questions [Hash{Symbol=>Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score}] Between 1 and 64 named questions. Each key identifies the corresponding answer.
+          #
+          #   @param state [String, Hash{Symbol=>Object}, Array<Object>] Shared context evaluated by every question.
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+          # A choice, yes/no, or ordered-score question.
+          module Question
+            extend Telnyx::Internal::Type::Union
+
+            discriminator :type
+
+            # Select one of the supplied options.
+            variant :choice, -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Choice }
+
+            # Evaluate a yes/no question. Omit criteria to use Yes and No descriptions.
+            variant :noul, -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Noul }
+
+            # Rate the state against an ordered rubric.
+            variant :score, -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Score }
+
+            class Choice < Telnyx::Internal::Type::BaseModel
+              # @!attribute criteria
+              #   Between 2 and 64 option keys mapped to description strings or null. A null
+              #   description uses the option key as its text.
+              #
+              #   @return [Hash{Symbol=>String, nil}]
+              required :criteria, Telnyx::Internal::Type::HashOf[String, nil?: true]
+
+              # @!attribute instructions
+              #   Required instructions describing what to decide about the shared state.
+              #
+              #   @return [String, Hash{Symbol=>Object}, Array<Object>]
+              required :instructions,
+                       union: -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Choice::Instructions }
+
+              # @!attribute type
+              #   Question type.
+              #
+              #   @return [Symbol, :choice]
+              required :type, const: :choice
+
+              # @!method initialize(criteria:, instructions:, type: :choice)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice} for more
+              #   details.
+              #
+              #   Select one of the supplied options.
+              #
+              #   @param criteria [Hash{Symbol=>String, nil}] Between 2 and 64 option keys mapped to description strings or null. A null descr
+              #
+              #   @param instructions [String, Hash{Symbol=>Object}, Array<Object>] Required instructions describing what to decide about the shared state.
+              #
+              #   @param type [Symbol, :choice] Question type.
+
+              # Required instructions describing what to decide about the shared state.
+              #
+              # @see Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice#instructions
+              module Instructions
+                extend Telnyx::Internal::Type::Union
+
+                variant String
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice::Instructions::UnionMember1Map }
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice::Instructions::UnionMember2Array }
+
+                # @!method self.variants
+                #   @return [Array(String, Hash{Symbol=>Object}, Array<Object>)]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember1Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember2Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+              end
+            end
+
+            class Noul < Telnyx::Internal::Type::BaseModel
+              # @!attribute instructions
+              #   Required instructions describing what to decide about the shared state.
+              #
+              #   @return [String, Hash{Symbol=>Object}, Array<Object>]
+              required :instructions,
+                       union: -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Noul::Instructions }
+
+              # @!attribute type
+              #   Question type.
+              #
+              #   @return [Symbol, :noul]
+              required :type, const: :noul
+
+              # @!attribute criteria
+              #   Optional descriptions for the positive and negative outcomes. Descriptions must
+              #   be strings.
+              #
+              #   @return [Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul::Criteria, nil]
+              optional :criteria, -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Noul::Criteria }
+
+              # @!method initialize(instructions:, criteria: nil, type: :noul)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul} for more
+              #   details.
+              #
+              #   Evaluate a yes/no question. Omit criteria to use Yes and No descriptions.
+              #
+              #   @param instructions [String, Hash{Symbol=>Object}, Array<Object>] Required instructions describing what to decide about the shared state.
+              #
+              #   @param criteria [Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul::Criteria] Optional descriptions for the positive and negative outcomes. Descriptions must
+              #
+              #   @param type [Symbol, :noul] Question type.
+
+              # Required instructions describing what to decide about the shared state.
+              #
+              # @see Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul#instructions
+              module Instructions
+                extend Telnyx::Internal::Type::Union
+
+                variant String
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul::Instructions::UnionMember1Map }
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul::Instructions::UnionMember2Array }
+
+                # @!method self.variants
+                #   @return [Array(String, Hash{Symbol=>Object}, Array<Object>)]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember1Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember2Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+              end
+
+              # @see Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul#criteria
+              class Criteria < Telnyx::Internal::Type::BaseModel
+                # @!attribute false_
+                #   Description of the negative outcome.
+                #
+                #   @return [String, nil]
+                optional :false_, String, api_name: :false
+
+                # @!attribute true_
+                #   Description of the positive outcome.
+                #
+                #   @return [String, nil]
+                optional :true_, String, api_name: :true
+
+                # @!method initialize(false_: nil, true_: nil)
+                #   Optional descriptions for the positive and negative outcomes. Descriptions must
+                #   be strings.
+                #
+                #   @param false_ [String] Description of the negative outcome.
+                #
+                #   @param true_ [String] Description of the positive outcome.
+              end
+            end
+
+            class Score < Telnyx::Internal::Type::BaseModel
+              # @!attribute criteria
+              #   Between 2 and 64 description strings in ascending score order. Indices start at
+              #   zero.
+              #
+              #   @return [Array<String>]
+              required :criteria, Telnyx::Internal::Type::ArrayOf[String]
+
+              # @!attribute instructions
+              #   Required instructions describing what to decide about the shared state.
+              #
+              #   @return [String, Hash{Symbol=>Object}, Array<Object>]
+              required :instructions,
+                       union: -> { Telnyx::AI::Typesafe::V1SystemoneParams::Question::Score::Instructions }
+
+              # @!attribute type
+              #   Question type.
+              #
+              #   @return [Symbol, :score]
+              required :type, const: :score
+
+              # @!method initialize(criteria:, instructions:, type: :score)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score} for more
+              #   details.
+              #
+              #   Rate the state against an ordered rubric.
+              #
+              #   @param criteria [Array<String>] Between 2 and 64 description strings in ascending score order. Indices start at
+              #
+              #   @param instructions [String, Hash{Symbol=>Object}, Array<Object>] Required instructions describing what to decide about the shared state.
+              #
+              #   @param type [Symbol, :score] Question type.
+
+              # Required instructions describing what to decide about the shared state.
+              #
+              # @see Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score#instructions
+              module Instructions
+                extend Telnyx::Internal::Type::Union
+
+                variant String
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score::Instructions::UnionMember1Map }
+
+                variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score::Instructions::UnionMember2Array }
+
+                # @!method self.variants
+                #   @return [Array(String, Hash{Symbol=>Object}, Array<Object>)]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember1Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+                # @type [Telnyx::Internal::Type::Converter]
+                UnionMember2Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+              end
+            end
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneParams::Question::Score)]
+          end
+
+          # Shared context evaluated by every question.
+          module State
+            extend Telnyx::Internal::Type::Union
+
+            variant String
+
+            variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::State::UnionMember1Map }
+
+            variant -> { Telnyx::Models::AI::Typesafe::V1SystemoneParams::State::UnionMember2Array }
+
+            # @!method self.variants
+            #   @return [Array(String, Hash{Symbol=>Object}, Array<Object>)]
+
+            # @type [Telnyx::Internal::Type::Converter]
+            UnionMember1Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+            # @type [Telnyx::Internal::Type::Converter]
+            UnionMember2Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/typesafe/v1_systemone_response.rb

@@ -0,0 +1,222 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Typesafe
+        # @see Telnyx::Resources::AI::Typesafe::V1#systemone
+        class V1SystemoneResponse < Telnyx::Internal::Type::BaseModel
+          # @!attribute answers
+          #   Answers keyed by exactly the question IDs in the request. Each answer type
+          #   matches its question.
+          #
+          #   @return [Hash{Symbol=>Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Score}]
+          required :answers,
+                   -> { Telnyx::Internal::Type::HashOf[union: Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer] }
+
+          # @!attribute usage
+          #   Token usage for the completed evaluation.
+          #
+          #   @return [Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Usage]
+          required :usage, -> { Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Usage }
+
+          response_only do
+            # @!attribute model
+            #   Opaque Telnyx-controlled identifier retained for TypeSafe SDK response
+            #   compatibility. It is not a selectable model name or a guarantee of a particular
+            #   underlying model.
+            #
+            #   @return [String]
+            required :model, String
+          end
+
+          # @!method initialize(answers:, model:, usage:)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::Typesafe::V1SystemoneResponse} for more details.
+          #
+          #   A complete synchronous evaluation. Answers are returned directly without a data
+          #   wrapper.
+          #
+          #   @param answers [Hash{Symbol=>Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Score}] Answers keyed by exactly the question IDs in the request. Each answer type match
+          #
+          #   @param model [String] Opaque Telnyx-controlled identifier retained for TypeSafe SDK response compatibi
+          #
+          #   @param usage [Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Usage] Token usage for the completed evaluation.
+
+          # An answer whose type matches its question.
+          module Answer
+            extend Telnyx::Internal::Type::Union
+
+            discriminator :type
+
+            # A selected option and the distribution across all supplied option keys.
+            variant :choice, -> { Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Choice }
+
+            # A yes/no score with no separate confidence or probabilities fields.
+            variant :noul, -> { Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Noul }
+
+            # An expected rating over the ordered criteria.
+            variant :score, -> { Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Score }
+
+            class Choice < Telnyx::Internal::Type::BaseModel
+              # @!attribute choice
+              #   The option key with the highest relative score. Ties favor the first option in
+              #   request order.
+              #
+              #   @return [String]
+              required :choice, String
+
+              # @!attribute confidence
+              #   Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+              #   and N is the number of options. Zero indicates a uniform distribution; one
+              #   indicates concentration on one option. This is neither the winning probability
+              #   nor calibrated correctness.
+              #
+              #   @return [Float]
+              required :confidence, Float
+
+              # @!attribute probabilities
+              #   Relative scores normalized across the supplied options, summing approximately
+              #   to 1. These are not calibrated probabilities of correctness.
+              #
+              #   @return [Hash{Symbol=>Float}]
+              required :probabilities, Telnyx::Internal::Type::HashOf[Float]
+
+              # @!attribute type
+              #   Answer type.
+              #
+              #   @return [Symbol, :choice]
+              required :type, const: :choice
+
+              # @!method initialize(choice:, confidence:, probabilities:, type: :choice)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Choice} for more
+              #   details.
+              #
+              #   A selected option and the distribution across all supplied option keys.
+              #
+              #   @param choice [String] The option key with the highest relative score. Ties favor the first option in r
+              #
+              #   @param confidence [Float] Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+              #   an
+              #
+              #   @param probabilities [Hash{Symbol=>Float}] Relative scores normalized across the supplied options, summing approximately to
+              #
+              #   @param type [Symbol, :choice] Answer type.
+            end
+
+            class Noul < Telnyx::Internal::Type::BaseModel
+              # @!attribute noul
+              #   Score of the positive outcome. Values near 1 favor yes; values near 0 favor no.
+              #   This is a number, not a Boolean, and is not calibrated correctness.
+              #
+              #   @return [Float]
+              required :noul, Float
+
+              # @!attribute type
+              #   Answer type.
+              #
+              #   @return [Symbol, :noul]
+              required :type, const: :noul
+
+              # @!method initialize(noul:, type: :noul)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Noul} for more
+              #   details.
+              #
+              #   A yes/no score with no separate confidence or probabilities fields.
+              #
+              #   @param noul [Float] Score of the positive outcome. Values near 1 favor yes; values near 0 favor no.
+              #
+              #   @param type [Symbol, :noul] Answer type.
+            end
+
+            class Score < Telnyx::Internal::Type::BaseModel
+              # @!attribute confidence
+              #   Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+              #   and N is the number of options. Zero indicates a uniform distribution; one
+              #   indicates concentration on one option. This is neither the winning probability
+              #   nor calibrated correctness.
+              #
+              #   @return [Float]
+              required :confidence, Float
+
+              # @!attribute legend
+              #   Criterion descriptions keyed by stringified zero-based indices, such as "0",
+              #   "1", and "2".
+              #
+              #   @return [Hash{Symbol=>String}]
+              required :legend, Telnyx::Internal::Type::HashOf[String]
+
+              # @!attribute probabilities
+              #   Relative scores keyed by the same stringified indices as legend.
+              #
+              #   @return [Hash{Symbol=>Float}]
+              required :probabilities, Telnyx::Internal::Type::HashOf[Float]
+
+              # @!attribute score
+              #   Expected zero-based criterion index: sum(index \* probability). Ranges from 0 to
+              #   N-1 for N criteria; fractional values are valid.
+              #
+              #   @return [Float]
+              required :score, Float
+
+              # @!attribute type
+              #   Answer type.
+              #
+              #   @return [Symbol, :score]
+              required :type, const: :score
+
+              # @!method initialize(confidence:, legend:, probabilities:, score:, type: :score)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Score} for more
+              #   details.
+              #
+              #   An expected rating over the ordered criteria.
+              #
+              #   @param confidence [Float] Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+              #   an
+              #
+              #   @param legend [Hash{Symbol=>String}] Criterion descriptions keyed by stringified zero-based indices, such as "0", "1"
+              #
+              #   @param probabilities [Hash{Symbol=>Float}] Relative scores keyed by the same stringified indices as legend.
+              #
+              #   @param score [Float] Expected zero-based criterion index: sum(index \* probability). Ranges from 0 to
+              #
+              #   @param type [Symbol, :score] Answer type.
+            end
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Choice, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Noul, Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Answer::Score)]
+          end
+
+          # @see Telnyx::Models::AI::Typesafe::V1SystemoneResponse#usage
+          class Usage < Telnyx::Internal::Type::BaseModel
+            # @!attribute input_tokens
+            #   Input tokens processed, including shared-context preparation and question
+            #   evaluation. This can exceed the token count of the unique input text.
+            #
+            #   @return [Integer]
+            required :input_tokens, Integer
+
+            # @!attribute output_tokens
+            #   Output tokens used for the evaluation, including shared-context preparation.
+            #
+            #   @return [Integer]
+            required :output_tokens, Integer
+
+            # @!method initialize(input_tokens:, output_tokens:)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Typesafe::V1SystemoneResponse::Usage} for more details.
+            #
+            #   Token usage for the completed evaluation.
+            #
+            #   @param input_tokens [Integer] Input tokens processed, including shared-context preparation and question evalua
+            #
+            #   @param output_tokens [Integer] Output tokens used for the evaluation, including shared-context preparation.
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/bot_challenge_create_params.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::BotChallenge#create
+    class BotChallengeCreateParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute llm_model_name
+      #   Name of the LLM the client is using.
+      #
+      #   @return [String, nil]
+      optional :llm_model_name, String
+
+      # @!attribute llm_parameter_count
+      #   Parameter count of the client LLM.
+      #
+      #   @return [String, nil]
+      optional :llm_parameter_count, String
+
+      # @!attribute llm_quantization
+      #   Quantization of the client LLM.
+      #
+      #   @return [String, nil]
+      optional :llm_quantization, String
+
+      # @!method initialize(llm_model_name: nil, llm_parameter_count: nil, llm_quantization: nil, request_options: {})
+      #   @param llm_model_name [String] Name of the LLM the client is using.
+      #
+      #   @param llm_parameter_count [String] Parameter count of the client LLM.
+      #
+      #   @param llm_quantization [String] Quantization of the client LLM.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/bot_challenge_create_response.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::BotChallenge#create
+    class BotChallengeCreateResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::BotChallengeCreateResponse::Data]
+      required :data, -> { Telnyx::Models::BotChallengeCreateResponse::Data }
+
+      # @!method initialize(data:)
+      #   @param data [Telnyx::Models::BotChallengeCreateResponse::Data]
+
+      # @see Telnyx::Models::BotChallengeCreateResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute challenge_type
+        #   Type of challenge.
+        #
+        #   @return [Symbol, Telnyx::Models::BotChallengeCreateResponse::Data::ChallengeType]
+        required :challenge_type, enum: -> { Telnyx::Models::BotChallengeCreateResponse::Data::ChallengeType }
+
+        # @!attribute nonce
+        #   Single-use challenge identifier. Submit it as `bot_challenge_nonce` on the
+        #   signup request.
+        #
+        #   @return [String]
+        required :nonce, String
+
+        # @!attribute privacy_policy_url
+        #   Current privacy-policy URL. Echo this back on the signup request.
+        #
+        #   @return [String]
+        required :privacy_policy_url, String
+
+        # @!attribute problem
+        #   Problem text to solve. Math problems are obfuscated and end with an unobfuscated
+        #   rounding instruction; string and binary problems are returned as-is.
+        #
+        #   @return [String]
+        required :problem, String
+
+        # @!attribute terms_and_conditions_url
+        #   Current terms-and-conditions URL. Echo this back on the signup request.
+        #
+        #   @return [String]
+        required :terms_and_conditions_url, String
+
+        # @!attribute precision
+        #   Decimal places expected in the answer. Present only for math challenges.
+        #
+        #   @return [Integer, nil]
+        optional :precision, Integer
+
+        # @!method initialize(challenge_type:, nonce:, privacy_policy_url:, problem:, terms_and_conditions_url:, precision: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::BotChallengeCreateResponse::Data} for more details.
+        #
+        #   @param challenge_type [Symbol, Telnyx::Models::BotChallengeCreateResponse::Data::ChallengeType] Type of challenge.
+        #
+        #   @param nonce [String] Single-use challenge identifier. Submit it as `bot_challenge_nonce` on the signu
+        #
+        #   @param privacy_policy_url [String] Current privacy-policy URL. Echo this back on the signup request.
+        #
+        #   @param problem [String] Problem text to solve. Math problems are obfuscated and end with an unobfuscated
+        #
+        #   @param terms_and_conditions_url [String] Current terms-and-conditions URL. Echo this back on the signup request.
+        #
+        #   @param precision [Integer] Decimal places expected in the answer. Present only for math challenges.
+
+        # Type of challenge.
+        #
+        # @see Telnyx::Models::BotChallengeCreateResponse::Data#challenge_type
+        module ChallengeType
+          extend Telnyx::Internal::Type::Enum
+
+          MATH = :math
+          STRING = :string
+          BINARY = :binary
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/bot_session_list_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::BotSessions#list
+    class BotSessionListParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute email
+      #   Email address associated with the magic link token.
+      #
+      #   @return [String]
+      required :email, String
+
+      # @!attribute portal_redirect_token
+      #   Single-use portal redirect (magic link) token, a UUIDv7 sent to the account
+      #   owner's email.
+      #
+      #   @return [String]
+      required :portal_redirect_token, String
+
+      # @!method initialize(email:, portal_redirect_token:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::BotSessionListParams} for more details.
+      #
+      #   @param email [String] Email address associated with the magic link token.
+      #
+      #   @param portal_redirect_token [String] Single-use portal redirect (magic link) token, a UUIDv7 sent to the account owne
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/bot_session_list_response.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::BotSessions#list
+    class BotSessionListResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::BotSessionListResponse::Data]
+      required :data, -> { Telnyx::Models::BotSessionListResponse::Data }
+
+      # @!method initialize(data:)
+      #   @param data [Telnyx::Models::BotSessionListResponse::Data]
+
+      # @see Telnyx::Models::BotSessionListResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute api_v2_token
+        #   API v2 session token for the signed-in user. Use it as a bearer token on
+        #   authenticated endpoints.
+        #
+        #   @return [String]
+        required :api_v2_token, String
+
+        # @!method initialize(api_v2_token:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::BotSessionListResponse::Data} for more details.
+        #
+        #   @param api_v2_token [String] API v2 session token for the signed-in user. Use it as a bearer token on authent
+      end
+    end
+  end
+end