telnyx 5.168.0 → 5.169.0

data/lib/telnyx/models/ai/privacy_settings.rb

@@ -15,11 +15,30 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :data_retention, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(data_retention: nil)
+        # @!attribute in_transit_data_locality
+        #   Requires every model call made for a web chat turn to be received and served
+        #   inside your organization's data-locality region, rather than only stored there.
+        #   Applies to web chat only — voice and messaging assistants are unaffected.
+        #   Enabling it requires a data-locality region with in-region inference (USA, EU,
+        #   AUS, UAE; see
+        #   [Inference regions](https://developers.telnyx.com/docs/inference/models/regions))
+        #   and Telnyx-hosted models for the assistant, its fallback, and any
+        #   conversation-flow node that overrides the model; the request is rejected
+        #   otherwise. Once enabled, send chat requests to your region's API hostname: a
+        #   request entering the platform in another region is rejected rather than
+        #   forwarded, because forwarding it would already have moved the content across the
+        #   border. Defaults to false.
+        #
+        #   @return [Boolean, nil]
+        optional :in_transit_data_locality, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(data_retention: nil, in_transit_data_locality: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::PrivacySettings} for more details.
         #
         #   @param data_retention [Boolean] If true, conversation history and insights will be stored. If false, they will n
+        #
+        #   @param in_transit_data_locality [Boolean] Requires every model call made for a web chat turn to be received and served ins
       end
     end
   end

data/lib/telnyx/models/ai/retrieval_tool.rb

@@ -14,9 +14,29 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::RetrievalTool::Type]
         required :type, enum: -> { Telnyx::AI::RetrievalTool::Type }
 
-        # @!method initialize(retrieval:, type:)
+        response_only do
+          # @!attribute shared
+          #   Whether this tool comes from the shared Tools Library. Responses merge shared
+          #   tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+          #   Read-only: set by the server, not accepted in requests. When updating an
+          #   assistant, omit `shared: true` tools from the request `tools` array and manage
+          #   them through `tool_ids` instead — re-sending their definitions creates an inline
+          #   duplicate (rejected with error code 10015 when the type allows only one instance
+          #   per assistant).
+          #
+          #   @return [Boolean, nil]
+          optional :shared, Telnyx::Internal::Type::Boolean
+        end
+
+        # @!method initialize(retrieval:, type:, shared: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::RetrievalTool} for more details.
+        #
         #   @param retrieval [Telnyx::Models::AI::BucketIDs]
+        #
         #   @param type [Symbol, Telnyx::Models::AI::RetrievalTool::Type]
+        #
+        #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
 
         # @see Telnyx::Models::AI::RetrievalTool#type
         module Type

data/lib/telnyx/models/ai/telephony_settings.rb

@@ -32,15 +32,18 @@ module Telnyx
         optional :fallback_destination, String
 
         # @!attribute noise_suppression
-        #   The noise suppression engine to use. Use 'disabled' to turn off noise
-        #   suppression.
+        #   The noise suppression engine to use. 'aicoustics' is STT-optimized and
+        #   recommended for AI assistants (configure through noise_suppression_config). Use
+        #   'disabled' to turn off noise suppression.
         #
         #   @return [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppression, nil]
         optional :noise_suppression, enum: -> { Telnyx::AI::TelephonySettings::NoiseSuppression }
 
         # @!attribute noise_suppression_config
-        #   Configuration for noise suppression. Only applicable when noise_suppression is
-        #   'deepfilternet'.
+        #   Configuration for noise suppression. Applicable fields depend on the engine:
+        #   'attenuation_limit' and 'mode' only when noise_suppression is 'deepfilternet';
+        #   'family', 'size' and 'enhancement_level' only when noise_suppression is
+        #   'aicoustics'.
         #
         #   @return [Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig, nil]
         optional :noise_suppression_config, -> { Telnyx::AI::TelephonySettings::NoiseSuppressionConfig }
@@ -119,9 +122,9 @@ module Telnyx
         #
         #   @param fallback_destination [String] Destination number or SIP URI to transfer the caller to when the AI conversation
         #
-        #   @param noise_suppression [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppression] The noise suppression engine to use. Use 'disabled' to turn off noise suppressio
+        #   @param noise_suppression [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppression] The noise suppression engine to use. 'aicoustics' is STT-optimized and recommend
         #
-        #   @param noise_suppression_config [Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig] Configuration for noise suppression. Only applicable when noise_suppression is '
+        #   @param noise_suppression_config [Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig] Configuration for noise suppression. Applicable fields depend on the engine: 'at
         #
         #   @param recording_settings [Telnyx::Models::AI::TelephonySettings::RecordingSettings] Configuration for call recording format and channel settings.
         #
@@ -137,13 +140,15 @@ module Telnyx
         #
         #   @param voicemail_detection [Telnyx::Models::AI::TelephonySettings::VoicemailDetection] Configuration for voicemail detection (AMD - Answering Machine Detection) on out
 
-        # The noise suppression engine to use. Use 'disabled' to turn off noise
-        # suppression.
+        # The noise suppression engine to use. 'aicoustics' is STT-optimized and
+        # recommended for AI assistants (configure through noise_suppression_config). Use
+        # 'disabled' to turn off noise suppression.
         #
         # @see Telnyx::Models::AI::TelephonySettings#noise_suppression
         module NoiseSuppression
           extend Telnyx::Internal::Type::Enum
 
+          AICOUSTICS = :aicoustics
           KRISP = :krisp
           DEEPFILTERNET = :deepfilternet
           DISABLED = :disabled
@@ -155,26 +160,76 @@ module Telnyx
         # @see Telnyx::Models::AI::TelephonySettings#noise_suppression_config
         class NoiseSuppressionConfig < Telnyx::Internal::Type::BaseModel
           # @!attribute attenuation_limit
-          #   Attenuation limit for noise suppression. Range: 0-100.
+          #   Attenuation limit for noise suppression. Range: 0-100. Only applicable when
+          #   noise_suppression is 'deepfilternet'.
           #
           #   @return [Integer, nil]
           optional :attenuation_limit, Integer
 
+          # @!attribute enhancement_level
+          #   AiCoustics enhancement intensity. Range: 0-1. Only applicable when
+          #   noise_suppression is 'aicoustics'.
+          #
+          #   @return [Float, nil]
+          optional :enhancement_level, Float
+
+          # @!attribute family
+          #   AiCoustics model family optimized for Voice AI and STT. Only applicable when
+          #   noise_suppression is 'aicoustics'.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Family, nil]
+          optional :family, enum: -> { Telnyx::AI::TelephonySettings::NoiseSuppressionConfig::Family }
+
           # @!attribute mode
-          #   Mode for noise suppression configuration.
+          #   Mode for noise suppression configuration. Only applicable when noise_suppression
+          #   is 'deepfilternet'.
           #
           #   @return [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Mode, nil]
           optional :mode, enum: -> { Telnyx::AI::TelephonySettings::NoiseSuppressionConfig::Mode }
 
-          # @!method initialize(attenuation_limit: nil, mode: nil)
-          #   Configuration for noise suppression. Only applicable when noise_suppression is
-          #   'deepfilternet'.
+          # @!attribute size
+          #   AiCoustics model size. 'vf' tracks the latest model release; 'vf_2_0_l' is
+          #   pinned to version 2.0 for consistent, predictable behavior. Only applicable when
+          #   noise_suppression is 'aicoustics'.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Size, nil]
+          optional :size, enum: -> { Telnyx::AI::TelephonySettings::NoiseSuppressionConfig::Size }
+
+          # @!method initialize(attenuation_limit: nil, enhancement_level: nil, family: nil, mode: nil, size: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig} for more
+          #   details.
           #
-          #   @param attenuation_limit [Integer] Attenuation limit for noise suppression. Range: 0-100.
+          #   Configuration for noise suppression. Applicable fields depend on the engine:
+          #   'attenuation_limit' and 'mode' only when noise_suppression is 'deepfilternet';
+          #   'family', 'size' and 'enhancement_level' only when noise_suppression is
+          #   'aicoustics'.
           #
-          #   @param mode [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Mode] Mode for noise suppression configuration.
+          #   @param attenuation_limit [Integer] Attenuation limit for noise suppression. Range: 0-100. Only applicable when nois
+          #
+          #   @param enhancement_level [Float] AiCoustics enhancement intensity. Range: 0-1. Only applicable when noise_suppres
+          #
+          #   @param family [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Family] AiCoustics model family optimized for Voice AI and STT. Only applicable when noi
+          #
+          #   @param mode [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Mode] Mode for noise suppression configuration. Only applicable when noise_suppression
+          #
+          #   @param size [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig::Size] AiCoustics model size. 'vf' tracks the latest model release; 'vf_2_0_l' is pinne
 
-          # Mode for noise suppression configuration.
+          # AiCoustics model family optimized for Voice AI and STT. Only applicable when
+          # noise_suppression is 'aicoustics'.
+          #
+          # @see Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig#family
+          module Family
+            extend Telnyx::Internal::Type::Enum
+
+            QUAIL = :quail
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Mode for noise suppression configuration. Only applicable when noise_suppression
+          # is 'deepfilternet'.
           #
           # @see Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig#mode
           module Mode
@@ -185,6 +240,21 @@ module Telnyx
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # AiCoustics model size. 'vf' tracks the latest model release; 'vf_2_0_l' is
+          # pinned to version 2.0 for consistent, predictable behavior. Only applicable when
+          # noise_suppression is 'aicoustics'.
+          #
+          # @see Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig#size
+          module Size
+            extend Telnyx::Internal::Type::Enum
+
+            VF = :vf
+            VF_2_0_L = :vf_2_0_l
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @see Telnyx::Models::AI::TelephonySettings#recording_settings

data/lib/telnyx/models/ai/tool_node.rb

@@ -40,7 +40,7 @@ module Telnyx
         #   responses so clients can render the node without a follow-up fetch. Ignored on
         #   input — set `shared_tool_id`.
         #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
+        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
         optional :tool, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute type
@@ -63,7 +63,7 @@ module Telnyx
         #
         #   @param position [Telnyx::Models::AI::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
         #
-        #   @param tool [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Full tool definition resolved from `shared_tool_id` server-side. Populated on re
+        #   @param tool [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Full tool definition resolved from `shared_tool_id` server-side. Populated on re
         #
         #   @param type [Symbol, Telnyx::Models::AI::ToolNode::Type] Node kind discriminator. Always `tool` for a tool node.
 

data/lib/telnyx/models/ai/transcription_settings.rb

@@ -41,14 +41,17 @@ module Telnyx
         #   - `deepgram/nova-3` is multilingual with automatic language detection.
         #   - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
         #   - `azure/fast` is a multilingual Azure transcription model.
-        #   - `assemblyai/universal-streaming` is a multilingual streaming model with
-        #     configurable turn detection.
+        #   - `assemblyai/universal-3-5-pro` is a multilingual streaming model with
+        #     configurable turn detection. The legacy alias `assemblyai/universal-streaming`
+        #     is still accepted and resolves to the same model.
         #   - `xai/grok-stt` is a multilingual Grok STT model.
         #   - `soniox/stt-rt-v4` and `soniox/stt-rt-v5` are multilingual streaming models
         #     with automatic language detection, configurable endpointing, term biasing
         #     (`context`), and `language_hints`.
         #   - `nvidia/parakeet-v3` is a multilingual transcription model with automatic
         #     language detection.
+        #   - `omi-health/omi-med-stt-v1` is an English-only medical transcription model
+        #     (Parakeet-based).
         #   - `humain/realtime` is a streaming model with native Arabic and Arabic/English
         #     code-switching support.
         #   - `reson8/turns` is a turn-based streaming model covering 10 European languages
@@ -91,14 +94,17 @@ module Telnyx
         # - `deepgram/nova-3` is multilingual with automatic language detection.
         # - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
         # - `azure/fast` is a multilingual Azure transcription model.
-        # - `assemblyai/universal-streaming` is a multilingual streaming model with
-        #   configurable turn detection.
+        # - `assemblyai/universal-3-5-pro` is a multilingual streaming model with
+        #   configurable turn detection. The legacy alias `assemblyai/universal-streaming`
+        #   is still accepted and resolves to the same model.
         # - `xai/grok-stt` is a multilingual Grok STT model.
         # - `soniox/stt-rt-v4` and `soniox/stt-rt-v5` are multilingual streaming models
         #   with automatic language detection, configurable endpointing, term biasing
         #   (`context`), and `language_hints`.
         # - `nvidia/parakeet-v3` is a multilingual transcription model with automatic
         #   language detection.
+        # - `omi-health/omi-med-stt-v1` is an English-only medical transcription model
+        #   (Parakeet-based).
         # - `humain/realtime` is a streaming model with native Arabic and Arabic/English
         #   code-switching support.
         # - `reson8/turns` is a turn-based streaming model covering 10 European languages
@@ -113,11 +119,13 @@ module Telnyx
           DEEPGRAM_NOVA_3 = :"deepgram/nova-3"
           DEEPGRAM_NOVA_2 = :"deepgram/nova-2"
           AZURE_FAST = :"azure/fast"
+          ASSEMBLYAI_UNIVERSAL_3_5_PRO = :"assemblyai/universal-3-5-pro"
           ASSEMBLYAI_UNIVERSAL_STREAMING = :"assemblyai/universal-streaming"
           XAI_GROK_STT = :"xai/grok-stt"
           SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
           SONIOX_STT_RT_V5 = :"soniox/stt-rt-v5"
           NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
+          OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"
           HUMAIN_REALTIME = :"humain/realtime"
           RESON8_TURNS = :"reson8/turns"
           COHERE_AR_STT = :"cohere/ar-stt"

data/lib/telnyx/models/ai/transcription_settings_config.rb

@@ -33,9 +33,9 @@ module Telnyx
         optional :enable_endpoint_detection, Telnyx::Internal::Type::Boolean
 
         # @!attribute end_of_turn_confidence_threshold
-        #   Available only for assemblyai/universal-streaming. Confidence level required to
-        #   trigger an end of turn. Higher values require more certainty before ending a
-        #   turn.
+        #   Available only for assemblyai/universal-3-5-pro (and its legacy alias
+        #   assemblyai/universal-streaming). Confidence level required to trigger an end of
+        #   turn. Higher values require more certainty before ending a turn.
         #
         #   @return [Float, nil]
         optional :end_of_turn_confidence_threshold, Float
@@ -90,16 +90,17 @@ module Telnyx
         optional :max_endpoint_delay_ms, Integer
 
         # @!attribute max_turn_silence
-        #   Available only for assemblyai/universal-streaming. Maximum duration of silence
-        #   in milliseconds before forcing an end of turn.
+        #   Available only for assemblyai/universal-3-5-pro (and its legacy alias
+        #   assemblyai/universal-streaming). Maximum duration of silence in milliseconds
+        #   before forcing an end of turn.
         #
         #   @return [Integer, nil]
         optional :max_turn_silence, Integer
 
         # @!attribute min_turn_silence
-        #   Available only for assemblyai/universal-streaming. Minimum duration of silence
-        #   in milliseconds before a turn can end. Must be less than or equal to
-        #   max_turn_silence.
+        #   Available only for assemblyai/universal-3-5-pro (and its legacy alias
+        #   assemblyai/universal-streaming). Minimum duration of silence in milliseconds
+        #   before a turn can end. Must be less than or equal to max_turn_silence.
         #
         #   @return [Integer, nil]
         optional :min_turn_silence, Integer
@@ -124,7 +125,7 @@ module Telnyx
         #
         #   @param enable_endpoint_detection [Boolean] Available only for soniox/stt-rt-v4 and soniox/stt-rt-v5. When true, Soniox emit
         #
-        #   @param end_of_turn_confidence_threshold [Float] Available only for assemblyai/universal-streaming. Confidence level required to
+        #   @param end_of_turn_confidence_threshold [Float] Available only for assemblyai/universal-3-5-pro (and its legacy alias assemblyai
         #
         #   @param eot_threshold [Float] Available only for deepgram/flux. Confidence required to trigger an end of turn.
         #
@@ -138,9 +139,9 @@ module Telnyx
         #
         #   @param max_endpoint_delay_ms [Integer] Available only for soniox/stt-rt-v4 and soniox/stt-rt-v5. Maximum silence (in mi
         #
-        #   @param max_turn_silence [Integer] Available only for assemblyai/universal-streaming. Maximum duration of silence i
+        #   @param max_turn_silence [Integer] Available only for assemblyai/universal-3-5-pro (and its legacy alias assemblyai
         #
-        #   @param min_turn_silence [Integer] Available only for assemblyai/universal-streaming. Minimum duration of silence i
+        #   @param min_turn_silence [Integer] Available only for assemblyai/universal-3-5-pro (and its legacy alias assemblyai
         #
         #   @param numerals [Boolean]
         #

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