telnyx 5.174.0 → 5.175.0

data/rbi/telnyx/models/meeting_session_recording_destination.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class MeetingSessionRecordingDestination < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::MeetingSessionRecordingDestination,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      # Existing accessible bucket. Consecutive dots and IPv4-address names are
+      # rejected.
+      sig { returns(String) }
+      attr_accessor :bucket
+
+      # Optional object-key prefix. One trailing slash is normalized. Empty path
+      # segments, . and .. segments are rejected.
+      sig { returns(T.nilable(String)) }
+      attr_reader :prefix
+
+      sig { params(prefix: String).void }
+      attr_writer :prefix
+
+      # Customer-owned Telnyx Storage destination for recording exports. Uses the
+      # authenticated organization and user; do not supply credentials, region,
+      # organization ID or object key.
+      sig { params(bucket: String, prefix: String).returns(T.attached_class) }
+      def self.new(
+        # Existing accessible bucket. Consecutive dots and IPv4-address names are
+        # rejected.
+        bucket:,
+        # Optional object-key prefix. One trailing slash is normalized. Empty path
+        # segments, . and .. segments are rejected.
+        prefix: nil
+      )
+      end
+
+      sig { override.returns({ bucket: String, prefix: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/meeting_session_recording_export.rbi

@@ -0,0 +1,115 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class MeetingSessionRecordingExport < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::MeetingSessionRecordingExport,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :bucket
+
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :bytes
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :exported_at
+
+      sig { returns(String) }
+      attr_accessor :key
+
+      sig { returns(String) }
+      attr_accessor :region
+
+      sig do
+        returns(Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol)
+      end
+      attr_accessor :status
+
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      # Customer Storage recording reference. Pending is not downloadable; exported
+      # means upload was verified; failed is terminal. Download with ordinary Storage
+      # authorization. No presigned URL is returned.
+      sig do
+        params(
+          bucket: String,
+          bytes: T.nilable(Integer),
+          exported_at: T.nilable(Time),
+          key: String,
+          region: String,
+          status: Telnyx::MeetingSessionRecordingExport::Status::OrSymbol,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        bucket:,
+        bytes:,
+        exported_at:,
+        key:,
+        region:,
+        status:,
+        type: :video
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            bucket: String,
+            bytes: T.nilable(Integer),
+            exported_at: T.nilable(Time),
+            key: String,
+            region: String,
+            status: Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Telnyx::MeetingSessionRecordingExport::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PENDING =
+          T.let(
+            :pending,
+            Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol
+          )
+        EXPORTED =
+          T.let(
+            :exported,
+            Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol
+          )
+        FAILED =
+          T.let(
+            :failed,
+            Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Telnyx::MeetingSessionRecordingExport::Status::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/meeting_session_response.rbi

@@ -8,9 +8,9 @@ module Telnyx
           T.any(Telnyx::MeetingSessionResponse, Telnyx::Internal::AnyHash)
         end
 
-      # Represents a meeting session. All serializer fields are present and required;
-      # nullable fields use null when absent. No actor, provider-bot, idempotency,
-      # routing, key, or internal fields are exposed.
+      # Represents a meeting session. Core serializer fields are required;
+      # platform-specific fields are optional. Nullable fields use null when absent. No
+      # actor, provider-bot, idempotency, routing, key, or internal fields are exposed.
       sig { returns(Telnyx::MeetingSession) }
       attr_reader :data
 
@@ -21,9 +21,9 @@ module Telnyx
         params(data: Telnyx::MeetingSession::OrHash).returns(T.attached_class)
       end
       def self.new(
-        # Represents a meeting session. All serializer fields are present and required;
-        # nullable fields use null when absent. No actor, provider-bot, idempotency,
-        # routing, key, or internal fields are exposed.
+        # Represents a meeting session. Core serializer fields are required;
+        # platform-specific fields are optional. Nullable fields use null when absent. No
+        # actor, provider-bot, idempotency, routing, key, or internal fields are exposed.
         data:
       )
       end

data/rbi/telnyx/models/meeting_session_retrieve_recordings_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class MeetingSessionRetrieveRecordingsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::MeetingSessionRetrieveRecordingsParams,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: Telnyx::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/meeting_session_retrieve_recordings_response.rbi

@@ -0,0 +1,116 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class MeetingSessionRetrieveRecordingsResponse < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::Models::MeetingSessionRetrieveRecordingsResponse,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      # Temporary download URLs for recordings held by the Meeting service, including
+      # Zoom and existing Google Meet and Teams recordings. Empty for customer Storage
+      # exports; use recording_export instead. Choose the download method from these
+      # fields rather than the platform alone.
+      sig do
+        returns(
+          T::Array[
+            Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data
+          ]
+        )
+      end
+      attr_accessor :data
+
+      # Customer Storage recording reference. Pending is not downloadable; exported
+      # means upload was verified; failed is terminal. Download with ordinary Storage
+      # authorization. No presigned URL is returned.
+      sig { returns(T.nilable(Telnyx::MeetingSessionRecordingExport)) }
+      attr_reader :recording_export
+
+      sig do
+        params(
+          recording_export:
+            T.nilable(Telnyx::MeetingSessionRecordingExport::OrHash)
+        ).void
+      end
+      attr_writer :recording_export
+
+      sig do
+        params(
+          data:
+            T::Array[
+              Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data::OrHash
+            ],
+          recording_export:
+            T.nilable(Telnyx::MeetingSessionRecordingExport::OrHash)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Temporary download URLs for recordings held by the Meeting service, including
+        # Zoom and existing Google Meet and Teams recordings. Empty for customer Storage
+        # exports; use recording_export instead. Choose the download method from these
+        # fields rather than the platform alone.
+        data:,
+        # Customer Storage recording reference. Pending is not downloadable; exported
+        # means upload was verified; failed is terminal. Download with ordinary Storage
+        # authorization. No presigned URL is returned.
+        recording_export: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data:
+              T::Array[
+                Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data
+              ],
+            recording_export: T.nilable(Telnyx::MeetingSessionRecordingExport)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :expires_at
+
+        sig { returns(String) }
+        attr_accessor :type
+
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            expires_at: T.nilable(Time),
+            type: String,
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(expires_at:, type:, url:)
+        end
+
+        sig do
+          override.returns(
+            { expires_at: T.nilable(Time), type: String, url: String }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/meeting_session_retrieve_transcript_response.rbi

@@ -78,9 +78,14 @@ module Telnyx
         sig { returns(T.nilable(Float)) }
         attr_accessor :relative_ts
 
+        # Monotonic transcript append cursor. This is separate from the event-history
+        # cursor and does not establish conversational turn order.
         sig { returns(Integer) }
         attr_accessor :seq
 
+        # Recorded participant or bot label, or null when unavailable. Labels are
+        # attribution, not verified identity. Segments from concurrent speakers can
+        # finalize in a different order from the conversation.
         sig { returns(T.nilable(String)) }
         attr_accessor :speaker_label
 
@@ -101,7 +106,12 @@ module Telnyx
           confidence:,
           occurred_at:,
           relative_ts:,
+          # Monotonic transcript append cursor. This is separate from the event-history
+          # cursor and does not establish conversational turn order.
           seq:,
+          # Recorded participant or bot label, or null when unavailable. Labels are
+          # attribution, not verified identity. Segments from concurrent speakers can
+          # finalize in a different order from the conversation.
           speaker_label:,
           text:
         )

data/rbi/telnyx/models/meeting_sessions/action_send_chat_params.rbi

@@ -18,7 +18,9 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :id
 
-        # Chat message text to send in the meeting.
+        # Message text, 1–4000 characters. On Google Meet and Teams, also at most 4096
+        # UTF-8 bytes and nonblank; control characters other than tab and line breaks are
+        # rejected. CRLF is normalized to LF.
         sig { returns(String) }
         attr_accessor :text
 
@@ -31,7 +33,9 @@ module Telnyx
         end
         def self.new(
           id:,
-          # Chat message text to send in the meeting.
+          # Message text, 1–4000 characters. On Google Meet and Teams, also at most 4096
+          # UTF-8 bytes and nonblank; control characters other than tab and line breaks are
+          # rejected. CRLF is normalized to LF.
           text:,
           request_options: {}
         )

data/rbi/telnyx/models/message_whatsapp_params.rbi

@@ -1855,10 +1855,10 @@ module Telnyx
                   end
 
                 # input data for the first screen. Must be a non-empty object when provided
-                sig { returns(T.nilable(T.anything)) }
+                sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
                 attr_reader :data
 
-                sig { params(data: T.anything).void }
+                sig { params(data: T::Hash[Symbol, T.anything]).void }
                 attr_writer :data
 
                 # ID of the first screen to show
@@ -1871,9 +1871,10 @@ module Telnyx
                 # optional initial screen and data. When omitted, the flow opens on its first
                 # entry screen. Must be omitted when flow_action is data_exchange
                 sig do
-                  params(data: T.anything, screen: String).returns(
-                    T.attached_class
-                  )
+                  params(
+                    data: T::Hash[Symbol, T.anything],
+                    screen: String
+                  ).returns(T.attached_class)
                 end
                 def self.new(
                   # input data for the first screen. Must be a non-empty object when provided
@@ -1883,7 +1884,11 @@ module Telnyx
                 )
                 end
 
-                sig { override.returns({ data: T.anything, screen: String }) }
+                sig do
+                  override.returns(
+                    { data: T::Hash[Symbol, T.anything], screen: String }
+                  )
+                end
                 def to_hash
                 end
               end
@@ -2662,10 +2667,12 @@ module Telnyx
                   end
 
                 # input data for the first screen of the flow
-                sig { returns(T.nilable(T.anything)) }
+                sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
                 attr_reader :flow_action_data
 
-                sig { params(flow_action_data: T.anything).void }
+                sig do
+                  params(flow_action_data: T::Hash[Symbol, T.anything]).void
+                end
                 attr_writer :flow_action_data
 
                 # business-generated identifier for the flow session. Returned in the flow
@@ -2679,7 +2686,7 @@ module Telnyx
                 # Flow button parameters. Used with type action on a flow button component
                 sig do
                   params(
-                    flow_action_data: T.anything,
+                    flow_action_data: T::Hash[Symbol, T.anything],
                     flow_token: String
                   ).returns(T.attached_class)
                 end
@@ -2694,7 +2701,10 @@ module Telnyx
 
                 sig do
                   override.returns(
-                    { flow_action_data: T.anything, flow_token: String }
+                    {
+                      flow_action_data: T::Hash[Symbol, T.anything],
+                      flow_token: String
+                    }
                   )
                 end
                 def to_hash

data/rbi/telnyx/models/number_lookup_retrieve_response.rbi

@@ -704,6 +704,11 @@ module Telnyx
           sig { returns(T.nilable(String)) }
           attr_accessor :caller_name
 
+          # The entity type of the phone number's owner, from the enhanced caller name data
+          # source — `Person` or `Business`. Null when not available.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :entity_type
+
           # A lookup-specific error code if the enhanced caller name could not be resolved;
           # otherwise null.
           sig { returns(T.nilable(String)) }
@@ -714,12 +719,16 @@ module Telnyx
           sig do
             params(
               caller_name: T.nilable(String),
+              entity_type: T.nilable(String),
               error_code: T.nilable(String)
             ).returns(T.attached_class)
           end
           def self.new(
             # The name associated with the phone number.
             caller_name: nil,
+            # The entity type of the phone number's owner, from the enhanced caller name data
+            # source — `Person` or `Business`. Null when not available.
+            entity_type: nil,
             # A lookup-specific error code if the enhanced caller name could not be resolved;
             # otherwise null.
             error_code: nil
@@ -728,7 +737,11 @@ module Telnyx
 
           sig do
             override.returns(
-              { caller_name: T.nilable(String), error_code: T.nilable(String) }
+              {
+                caller_name: T.nilable(String),
+                entity_type: T.nilable(String),
+                error_code: T.nilable(String)
+              }
             )
           end
           def to_hash

data/rbi/telnyx/models/pay_connector.rbi

@@ -183,10 +183,10 @@ module Telnyx
 
         # Stored username, when supplied. Required to be a nonblank string for basic
         # authentication.
-        sig { returns(T.nilable(T.anything)) }
+        sig { returns(T.nilable(String)) }
         attr_reader :username
 
-        sig { params(username: T.anything).void }
+        sig { params(username: String).void }
         attr_writer :username
 
         # Redacted stored configuration. Generic connector fields are shown here. Unknown
@@ -196,7 +196,7 @@ module Telnyx
             auth_type: Telnyx::PayConnector::Config::AuthType::OrSymbol,
             endpoint_url: String,
             timeout: Integer,
-            username: T.anything
+            username: String
           ).returns(T.attached_class)
         end
         def self.new(
@@ -221,7 +221,7 @@ module Telnyx
               auth_type: Telnyx::PayConnector::Config::AuthType::TaggedSymbol,
               endpoint_url: String,
               timeout: Integer,
-              username: T.anything
+              username: String
             }
           )
         end