telnyx 5.171.0 → 5.173.0

data/rbi/telnyx/models/addresses/action_validate_response.rbi

@@ -53,7 +53,6 @@ module Telnyx
               )
             end
 
-          # Indicates whether an address is valid or invalid.
           sig do
             returns(
               Telnyx::Models::Addresses::ActionValidateResponse::Data::Result::TaggedSymbol
@@ -101,7 +100,6 @@ module Telnyx
             ).returns(T.attached_class)
           end
           def self.new(
-            # Indicates whether an address is valid or invalid.
             result:,
             # Provides normalized address when available.
             suggested:,
@@ -126,7 +124,6 @@ module Telnyx
           def to_hash
           end
 
-          # Indicates whether an address is valid or invalid.
           module Result
             extend Telnyx::Internal::Type::Enum
 
@@ -144,11 +141,6 @@ module Telnyx
                 :valid,
                 Telnyx::Models::Addresses::ActionValidateResponse::Data::Result::TaggedSymbol
               )
-            INVALID =
-              T.let(
-                :invalid,
-                Telnyx::Models::Addresses::ActionValidateResponse::Data::Result::TaggedSymbol
-              )
 
             sig do
               override.returns(
@@ -178,6 +170,14 @@ module Telnyx
             sig { params(administrative_area: String).void }
             attr_writer :administrative_area
 
+            # The borough of the address. This field is not used for addresses in the US but
+            # is used for some international addresses.
+            sig { returns(T.nilable(String)) }
+            attr_reader :borough
+
+            sig { params(borough: String).void }
+            attr_writer :borough
+
             # The two-character (ISO 3166-1 alpha-2) country code of the address.
             sig { returns(T.nilable(String)) }
             attr_reader :country_code
@@ -193,6 +193,10 @@ module Telnyx
             sig { params(extended_address: String).void }
             attr_writer :extended_address
 
+            # Latitude of the suggested address, when available.
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :latitude
+
             # The locality of the address. For US addresses, this corresponds to the city of
             # the address.
             sig { returns(T.nilable(String)) }
@@ -201,6 +205,18 @@ module Telnyx
             sig { params(locality: String).void }
             attr_writer :locality
 
+            # Longitude of the suggested address, when available.
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :longitude
+
+            # The neighborhood of the address. This field is not used for addresses in the US
+            # but is used for some international addresses.
+            sig { returns(T.nilable(String)) }
+            attr_reader :neighborhood
+
+            sig { params(neighborhood: String).void }
+            attr_writer :neighborhood
+
             # The postal code of the address.
             sig { returns(T.nilable(String)) }
             attr_reader :postal_code
@@ -219,9 +235,13 @@ module Telnyx
             sig do
               params(
                 administrative_area: String,
+                borough: String,
                 country_code: String,
                 extended_address: String,
+                latitude: T.nilable(Float),
                 locality: String,
+                longitude: T.nilable(Float),
+                neighborhood: String,
                 postal_code: String,
                 street_address: String
               ).returns(T.attached_class)
@@ -230,14 +250,24 @@ module Telnyx
               # The locality of the address. For US addresses, this corresponds to the state of
               # the address.
               administrative_area: nil,
+              # The borough of the address. This field is not used for addresses in the US but
+              # is used for some international addresses.
+              borough: nil,
               # The two-character (ISO 3166-1 alpha-2) country code of the address.
               country_code: nil,
               # Additional street address information about the address such as, but not limited
               # to, unit number or apartment number.
               extended_address: nil,
+              # Latitude of the suggested address, when available.
+              latitude: nil,
               # The locality of the address. For US addresses, this corresponds to the city of
               # the address.
               locality: nil,
+              # Longitude of the suggested address, when available.
+              longitude: nil,
+              # The neighborhood of the address. This field is not used for addresses in the US
+              # but is used for some international addresses.
+              neighborhood: nil,
               # The postal code of the address.
               postal_code: nil,
               # The primary street address information about the address.
@@ -249,9 +279,13 @@ module Telnyx
               override.returns(
                 {
                   administrative_area: String,
+                  borough: String,
                   country_code: String,
                   extended_address: String,
+                  latitude: T.nilable(Float),
                   locality: String,
+                  longitude: T.nilable(Float),
+                  neighborhood: String,
                   postal_code: String,
                   street_address: String
                 }

data/rbi/telnyx/models/ai/assistant_create_params.rbi

@@ -38,8 +38,10 @@ module Telnyx
         end
         attr_writer :a2a_agents
 
-        # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        # catalog supports six avatars and office, studio, or reception backgrounds.
+        # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        # avatar or an organization-owned custom avatar returned by the Avatars API.
+        # Discover the available stock catalog with GET /v2/ai/avatars and
+        # filter[avatar_type]=stock; follow meta.total_pages to load every page.
         sig { returns(T.nilable(Telnyx::AI::AvatarSettingsRequest)) }
         attr_reader :avatar_settings
 
@@ -321,6 +323,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf,
                   Telnyx::AI::AssistantTool::SendMessage,
                   Telnyx::AI::AssistantTool::SkipTurn,
+                  Telnyx::AI::AssistantTool::Vision,
                   Telnyx::AI::AssistantTool::Pay,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables
                 )
@@ -347,6 +350,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -446,6 +450,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -472,8 +477,10 @@ module Telnyx
           # fetches combined. An agent whose card cannot be fetched costs the assistant that
           # capability for the conversation; it does not fail the call.
           a2a_agents: nil,
-          # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-          # catalog supports six avatars and office, studio, or reception backgrounds.
+          # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+          # avatar or an organization-owned custom avatar returned by the Avatars API.
+          # Discover the available stock catalog with GET /v2/ai/avatars and
+          # filter[avatar_type]=stock; follow meta.total_pages to load every page.
           avatar_settings: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
@@ -628,6 +635,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf,
                     Telnyx::AI::AssistantTool::SendMessage,
                     Telnyx::AI::AssistantTool::SkipTurn,
+                    Telnyx::AI::AssistantTool::Vision,
                     Telnyx::AI::AssistantTool::Pay,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables
                   )

data/rbi/telnyx/models/ai/assistant_tool.rbi

@@ -24,6 +24,7 @@ module Telnyx
               Telnyx::AI::AssistantTool::SendDtmf,
               Telnyx::AI::AssistantTool::SendMessage,
               Telnyx::AI::AssistantTool::SkipTurn,
+              Telnyx::AI::AssistantTool::Vision,
               Telnyx::AI::AssistantTool::Pay,
               Telnyx::AI::AssistantTool::UpdateDynamicVariables
             )
@@ -719,6 +720,27 @@ module Telnyx
             end
             attr_accessor :targets
 
+            # Plays a short beep once the transfer completes and the calls are bridged, so the
+            # transfer destination knows the caller is now on the line. The warm transfer
+            # message plays before the bridge; this marks the moment the caller actually
+            # joins. Works with and without `warm_transfer_acceptance`.
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep
+                )
+              )
+            end
+            attr_reader :bridge_beep
+
+            sig do
+              params(
+                bridge_beep:
+                  Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::OrHash
+              ).void
+            end
+            attr_writer :bridge_beep
+
             # Custom headers to be added to the SIP INVITE for the transfer command.
             sig do
               returns(
@@ -832,6 +854,8 @@ module Telnyx
                 from: String,
                 targets:
                   Telnyx::AI::AssistantTool::Transfer::Transfer::Targets::Variants,
+                bridge_beep:
+                  Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::OrHash,
                 custom_headers:
                   T::Array[
                     Telnyx::AI::AssistantTool::Transfer::Transfer::CustomHeader::OrHash
@@ -854,6 +878,11 @@ module Telnyx
               # variable string like `{{ targets }}` where `targets` is returned by the dynamic
               # variables webhook and resolves to an array of target objects at runtime.
               targets:,
+              # Plays a short beep once the transfer completes and the calls are bridged, so the
+              # transfer destination knows the caller is now on the line. The warm transfer
+              # message plays before the bridge; this marks the moment the caller actually
+              # joins. Works with and without `warm_transfer_acceptance`.
+              bridge_beep: nil,
               # Custom headers to be added to the SIP INVITE for the transfer command.
               custom_headers: nil,
               # A description of the transfer tool. By default, Telnyx generates this
@@ -902,6 +931,8 @@ module Telnyx
                   from: String,
                   targets:
                     Telnyx::AI::AssistantTool::Transfer::Transfer::Targets::Variants,
+                  bridge_beep:
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep,
                   custom_headers:
                     T::Array[
                       Telnyx::AI::AssistantTool::Transfer::Transfer::CustomHeader
@@ -1062,6 +1093,110 @@ module Telnyx
                 )
             end
 
+            class BridgeBeep < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Whether to play the beep when the calls are bridged.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_reader :enabled
+
+              sig { params(enabled: T::Boolean).void }
+              attr_writer :enabled
+
+              # Who hears the beep. `self` plays it to the transfer destination only; `both`
+              # plays it to the destination and the original caller.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::OrSymbol
+                  )
+                )
+              end
+              attr_reader :target_legs
+
+              sig do
+                params(
+                  target_legs:
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::OrSymbol
+                ).void
+              end
+              attr_writer :target_legs
+
+              # Plays a short beep once the transfer completes and the calls are bridged, so the
+              # transfer destination knows the caller is now on the line. The warm transfer
+              # message plays before the bridge; this marks the moment the caller actually
+              # joins. Works with and without `warm_transfer_acceptance`.
+              sig do
+                params(
+                  enabled: T::Boolean,
+                  target_legs:
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::OrSymbol
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Whether to play the beep when the calls are bridged.
+                enabled: nil,
+                # Who hears the beep. `self` plays it to the transfer destination only; `both`
+                # plays it to the destination and the original caller.
+                target_legs: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    enabled: T::Boolean,
+                    target_legs:
+                      Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::OrSymbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              # Who hears the beep. `self` plays it to the transfer destination only; `both`
+              # plays it to the destination and the original caller.
+              module TargetLegs
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                SELF =
+                  T.let(
+                    :self,
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::TaggedSymbol
+                  )
+                BOTH =
+                  T.let(
+                    :both,
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
             class CustomHeader < Telnyx::Internal::Type::BaseModel
               OrHash =
                 T.type_alias do
@@ -1659,6 +1794,36 @@ module Telnyx
               end
               attr_writer :end_user_target_context_mode
 
+              # Fail closed when the acceptance consult cannot run. Off by default: if the
+              # consult cannot be set up for any reason — including where acceptance is
+              # unavailable at all (`gather_using_ai`, Conversation Relay or web calls, a
+              # conference, or additional invited participants) — the transfer degrades to a
+              # plain warm transfer (the warm transfer message is played to the destination as
+              # audio and the calls are bridged anyway). Set to true to treat those paths as a
+              # decline instead: the destination is disconnected without being asked, the
+              # assistant returns to the caller, and no bridge happens without an acceptance.
+              # Only consult-setup failures are affected; the destination must still explicitly
+              # accept on every consult that does run.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_reader :require_acceptance
+
+              sig { params(require_acceptance: T::Boolean).void }
+              attr_writer :require_acceptance
+
+              # How long, in seconds, the destination has to accept the transfer, counted from
+              # when the private consult starts (right after the destination answers, or after
+              # `warm_message_delay_ms`). The caller keeps hearing ringback the whole time. If
+              # no acceptance arrives in time, the destination is hung up and the assistant
+              # returns to the caller (the transfer fails as a timeout). Raise it for
+              # destinations that answer before a human is on the line, such as a call-center
+              # queue/ACD or an IVR playing hold audio; keep it as short as practical, since the
+              # caller waits on ringback until it expires.
+              sig { returns(T.nilable(Integer)) }
+              attr_reader :timeout_secs
+
+              sig { params(timeout_secs: Integer).void }
+              attr_writer :timeout_secs
+
               # Requires the transfer destination to accept the call before the caller is
               # bridged. When enabled, the assistant speaks privately with the destination after
               # they answer — delivering the warm transfer message and asking whether they take
@@ -1674,7 +1839,9 @@ module Telnyx
                 params(
                   enabled: T::Boolean,
                   end_user_target_context_mode:
-                    Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode::OrSymbol
+                    Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode::OrSymbol,
+                  require_acceptance: T::Boolean,
+                  timeout_secs: Integer
                 ).returns(T.attached_class)
               end
               def self.new(
@@ -1685,7 +1852,27 @@ module Telnyx
                 # exchange never reaches the conversation history, AI conversations, webhooks or
                 # insights, and the transfer tool result is rewritten with the outcome only. With
                 # `shared` the exchange stays in the conversation like any other messages.
-                end_user_target_context_mode: nil
+                end_user_target_context_mode: nil,
+                # Fail closed when the acceptance consult cannot run. Off by default: if the
+                # consult cannot be set up for any reason — including where acceptance is
+                # unavailable at all (`gather_using_ai`, Conversation Relay or web calls, a
+                # conference, or additional invited participants) — the transfer degrades to a
+                # plain warm transfer (the warm transfer message is played to the destination as
+                # audio and the calls are bridged anyway). Set to true to treat those paths as a
+                # decline instead: the destination is disconnected without being asked, the
+                # assistant returns to the caller, and no bridge happens without an acceptance.
+                # Only consult-setup failures are affected; the destination must still explicitly
+                # accept on every consult that does run.
+                require_acceptance: nil,
+                # How long, in seconds, the destination has to accept the transfer, counted from
+                # when the private consult starts (right after the destination answers, or after
+                # `warm_message_delay_ms`). The caller keeps hearing ringback the whole time. If
+                # no acceptance arrives in time, the destination is hung up and the assistant
+                # returns to the caller (the transfer fails as a timeout). Raise it for
+                # destinations that answer before a human is on the line, such as a call-center
+                # queue/ACD or an IVR playing hold audio; keep it as short as practical, since the
+                # caller waits on ringback until it expires.
+                timeout_secs: nil
               )
               end
 
@@ -1694,7 +1881,9 @@ module Telnyx
                   {
                     enabled: T::Boolean,
                     end_user_target_context_mode:
-                      Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode::OrSymbol
+                      Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode::OrSymbol,
+                    require_acceptance: T::Boolean,
+                    timeout_secs: Integer
                   }
                 )
               end
@@ -2898,6 +3087,76 @@ module Telnyx
           end
         end
 
+        class Vision < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::AssistantTool::Vision,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig { returns(T.nilable(Telnyx::AI::VisionToolParams)) }
+          attr_reader :vision
+
+          sig { params(vision: Telnyx::AI::VisionToolParams::OrHash).void }
+          attr_writer :vision
+
+          # 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).
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :shared
+
+          sig { params(shared: T::Boolean).void }
+          attr_writer :shared
+
+          # (BETA) Lets the assistant look at recent image frames the client sent into the
+          # conversation (for example webcam or screen-share frames). Frames are sent with
+          # `conversation.item.create` and `item.buffer: true`; they never trigger a
+          # response on their own. The assistant decides when to look and which frames it
+          # needs. Requires a model that supports image input.
+          sig do
+            params(
+              shared: T::Boolean,
+              vision: Telnyx::AI::VisionToolParams::OrHash,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # 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).
+            shared: nil,
+            vision: nil,
+            type: :vision
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                type: Symbol,
+                shared: T::Boolean,
+                vision: Telnyx::AI::VisionToolParams
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
         class Pay < Telnyx::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/telnyx/models/ai/assistant_update_params.rbi

@@ -34,8 +34,10 @@ module Telnyx
         end
         attr_writer :a2a_agents
 
-        # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        # catalog supports six avatars and office, studio, or reception backgrounds.
+        # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        # avatar or an organization-owned custom avatar returned by the Avatars API.
+        # Discover the available stock catalog with GET /v2/ai/avatars and
+        # filter[avatar_type]=stock; follow meta.total_pages to load every page.
         sig { returns(T.nilable(Telnyx::AI::AvatarSettingsRequest)) }
         attr_reader :avatar_settings
 
@@ -350,6 +352,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf,
                   Telnyx::AI::AssistantTool::SendMessage,
                   Telnyx::AI::AssistantTool::SkipTurn,
+                  Telnyx::AI::AssistantTool::Vision,
                   Telnyx::AI::AssistantTool::Pay,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables
                 )
@@ -376,6 +379,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -478,6 +482,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -502,8 +507,10 @@ module Telnyx
           # capability for the conversation; it does not fail the call. Omit this field to
           # leave the assistant's agents unchanged; send an empty array to remove them all.
           a2a_agents: nil,
-          # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-          # catalog supports six avatars and office, studio, or reception backgrounds.
+          # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+          # avatar or an organization-owned custom avatar returned by the Avatars API.
+          # Discover the available stock catalog with GET /v2/ai/avatars and
+          # filter[avatar_type]=stock; follow meta.total_pages to load every page.
           avatar_settings: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
@@ -679,6 +686,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf,
                     Telnyx::AI::AssistantTool::SendMessage,
                     Telnyx::AI::AssistantTool::SkipTurn,
+                    Telnyx::AI::AssistantTool::Vision,
                     Telnyx::AI::AssistantTool::Pay,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables
                   )

data/rbi/telnyx/models/ai/assistants/update_assistant.rbi

@@ -34,8 +34,10 @@ module Telnyx
           end
           attr_writer :a2a_agents
 
-          # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-          # catalog supports six avatars and office, studio, or reception backgrounds.
+          # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+          # avatar or an organization-owned custom avatar returned by the Avatars API.
+          # Discover the available stock catalog with GET /v2/ai/avatars and
+          # filter[avatar_type]=stock; follow meta.total_pages to load every page.
           sig { returns(T.nilable(Telnyx::AI::AvatarSettingsRequest)) }
           attr_reader :avatar_settings
 
@@ -348,6 +350,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf,
                     Telnyx::AI::AssistantTool::SendMessage,
                     Telnyx::AI::AssistantTool::SkipTurn,
+                    Telnyx::AI::AssistantTool::Vision,
                     Telnyx::AI::AssistantTool::Pay,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables
                   )
@@ -374,6 +377,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                     Telnyx::AI::AssistantTool::SendMessage::OrHash,
                     Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                    Telnyx::AI::AssistantTool::Vision::OrHash,
                     Telnyx::AI::AssistantTool::Pay::OrHash,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                   )
@@ -483,6 +487,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                     Telnyx::AI::AssistantTool::SendMessage::OrHash,
                     Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                    Telnyx::AI::AssistantTool::Vision::OrHash,
                     Telnyx::AI::AssistantTool::Pay::OrHash,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                   )
@@ -506,8 +511,10 @@ module Telnyx
             # capability for the conversation; it does not fail the call. Omit this field to
             # leave the assistant's agents unchanged; send an empty array to remove them all.
             a2a_agents: nil,
-            # **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-            # catalog supports six avatars and office, studio, or reception backgrounds.
+            # **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+            # avatar or an organization-owned custom avatar returned by the Avatars API.
+            # Discover the available stock catalog with GET /v2/ai/avatars and
+            # filter[avatar_type]=stock; follow meta.total_pages to load every page.
             avatar_settings: nil,
             # Conversation flow as supplied by API clients (create / update).
             #
@@ -678,6 +685,7 @@ module Telnyx
                       Telnyx::AI::AssistantTool::SendDtmf,
                       Telnyx::AI::AssistantTool::SendMessage,
                       Telnyx::AI::AssistantTool::SkipTurn,
+                      Telnyx::AI::AssistantTool::Vision,
                       Telnyx::AI::AssistantTool::Pay,
                       Telnyx::AI::AssistantTool::UpdateDynamicVariables
                     )