telnyx 5.174.0 → 5.175.0

data/rbi/telnyx/models/calendar_connections/calendar_meeting.rbi

@@ -0,0 +1,390 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module CalendarConnections
+      class CalendarMeeting < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::CalendarConnections::CalendarMeeting,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # Tracked calendar meeting ID.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Calendar attendees; identity fields are cleared after the retention window.
+        sig do
+          returns(
+            T::Array[Telnyx::CalendarConnections::CalendarMeeting::Attendee]
+          )
+        end
+        attr_accessor :attendees
+
+        # Effective policy decision, not proof that the bot has joined.
+        sig { returns(T::Boolean) }
+        attr_accessor :bot_will_join
+
+        # Explicit override; null follows the connection policy.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :bot_will_join_override
+
+        # Scheduling decision.
+        sig do
+          returns(
+            Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+          )
+        end
+        attr_accessor :decision
+
+        # Event end time.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :end_time
+
+        # Whether the connected calendar user is not the organizer.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :is_external_organizer
+
+        sig do
+          returns(
+            T.nilable(Telnyx::CalendarConnections::CalendarMeeting::Organizer)
+          )
+        end
+        attr_reader :organizer
+
+        sig do
+          params(
+            organizer:
+              T.nilable(
+                Telnyx::CalendarConnections::CalendarMeeting::Organizer::OrHash
+              )
+          ).void
+        end
+        attr_writer :organizer
+
+        # Detected meeting platform.
+        sig do
+          returns(
+            Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+          )
+        end
+        attr_accessor :platform
+
+        # Linked meeting session ID, or null until one exists.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :session_id
+
+        # Event start time.
+        sig { returns(Time) }
+        attr_accessor :start_time
+
+        sig do
+          params(
+            id: String,
+            attendees:
+              T::Array[
+                Telnyx::CalendarConnections::CalendarMeeting::Attendee::OrHash
+              ],
+            bot_will_join: T::Boolean,
+            bot_will_join_override: T.nilable(T::Boolean),
+            decision:
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::OrSymbol,
+            end_time: T.nilable(Time),
+            is_external_organizer: T.nilable(T::Boolean),
+            organizer:
+              T.nilable(
+                Telnyx::CalendarConnections::CalendarMeeting::Organizer::OrHash
+              ),
+            platform:
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::OrSymbol,
+            session_id: T.nilable(String),
+            start_time: Time
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Tracked calendar meeting ID.
+          id:,
+          # Calendar attendees; identity fields are cleared after the retention window.
+          attendees:,
+          # Effective policy decision, not proof that the bot has joined.
+          bot_will_join:,
+          # Explicit override; null follows the connection policy.
+          bot_will_join_override:,
+          # Scheduling decision.
+          decision:,
+          # Event end time.
+          end_time:,
+          # Whether the connected calendar user is not the organizer.
+          is_external_organizer:,
+          organizer:,
+          # Detected meeting platform.
+          platform:,
+          # Linked meeting session ID, or null until one exists.
+          session_id:,
+          # Event start time.
+          start_time:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              attendees:
+                T::Array[
+                  Telnyx::CalendarConnections::CalendarMeeting::Attendee
+                ],
+              bot_will_join: T::Boolean,
+              bot_will_join_override: T.nilable(T::Boolean),
+              decision:
+                Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol,
+              end_time: T.nilable(Time),
+              is_external_organizer: T.nilable(T::Boolean),
+              organizer:
+                T.nilable(
+                  Telnyx::CalendarConnections::CalendarMeeting::Organizer
+                ),
+              platform:
+                Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol,
+              session_id: T.nilable(String),
+              start_time: Time
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Attendee < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::CalendarConnections::CalendarMeeting::Attendee,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Display name.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :display_name
+
+          # Email address.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :email
+
+          # Whether attendance is optional.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :optional
+
+          # Calendar RSVP status.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :response_status
+
+          # Whether this is the connected calendar user.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :self_
+
+          sig do
+            params(
+              display_name: T.nilable(String),
+              email: T.nilable(String),
+              optional: T.nilable(T::Boolean),
+              response_status: T.nilable(String),
+              self_: T.nilable(T::Boolean)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Display name.
+            display_name:,
+            # Email address.
+            email:,
+            # Whether attendance is optional.
+            optional:,
+            # Calendar RSVP status.
+            response_status:,
+            # Whether this is the connected calendar user.
+            self_:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                display_name: T.nilable(String),
+                email: T.nilable(String),
+                optional: T.nilable(T::Boolean),
+                response_status: T.nilable(String),
+                self_: T.nilable(T::Boolean)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        # Scheduling decision.
+        module Decision
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Telnyx::CalendarConnections::CalendarMeeting::Decision
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :pending,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          SCHEDULED =
+            T.let(
+              :scheduled,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          SKIPPED_POLICY =
+            T.let(
+              :skipped_policy,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          SKIPPED_NO_URL =
+            T.let(
+              :skipped_no_url,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          SKIPPED_DUPLICATE =
+            T.let(
+              :skipped_duplicate,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          SKIPPED_UNSUPPORTED =
+            T.let(
+              :skipped_unsupported,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+          CANCELLED =
+            T.let(
+              :cancelled,
+              Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Telnyx::CalendarConnections::CalendarMeeting::Decision::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class Organizer < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::CalendarConnections::CalendarMeeting::Organizer,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Display name.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :display_name
+
+          # Email address.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :email
+
+          # Whether this is the connected calendar user.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :self_
+
+          sig do
+            params(
+              display_name: T.nilable(String),
+              email: T.nilable(String),
+              self_: T.nilable(T::Boolean)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Display name.
+            display_name:,
+            # Email address.
+            email:,
+            # Whether this is the connected calendar user.
+            self_:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                display_name: T.nilable(String),
+                email: T.nilable(String),
+                self_: T.nilable(T::Boolean)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        # Detected meeting platform.
+        module Platform
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Telnyx::CalendarConnections::CalendarMeeting::Platform
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ZOOM =
+            T.let(
+              :zoom,
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+            )
+          GOOGLE_MEET =
+            T.let(
+              :google_meet,
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+            )
+          TEAMS =
+            T.let(
+              :teams,
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+            )
+          WEBEX =
+            T.let(
+              :webex,
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+            )
+          UNKNOWN =
+            T.let(
+              :unknown,
+              Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Telnyx::CalendarConnections::CalendarMeeting::Platform::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/calendar_connections/meeting_list_params.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module CalendarConnections
+      class MeetingListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::CalendarConnections::MeetingListParams,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Window start; defaults to now.
+        sig { returns(T.nilable(Time)) }
+        attr_reader :from
+
+        sig { params(from: Time).void }
+        attr_writer :from
+
+        # Window end; defaults to seven days from now.
+        sig { returns(T.nilable(Time)) }
+        attr_reader :to
+
+        sig { params(to: Time).void }
+        attr_writer :to
+
+        sig do
+          params(
+            id: String,
+            from: Time,
+            to: Time,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # Window start; defaults to now.
+          from: nil,
+          # Window end; defaults to seven days from now.
+          to: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              from: Time,
+              to: Time,
+              request_options: Telnyx::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/calendar_connections/meeting_list_response.rbi

@@ -0,0 +1,36 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module CalendarConnections
+      class MeetingListResponse < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::CalendarConnections::MeetingListResponse,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T::Array[Telnyx::CalendarConnections::CalendarMeeting]) }
+        attr_accessor :data
+
+        sig do
+          params(
+            data: T::Array[Telnyx::CalendarConnections::CalendarMeeting::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(data:)
+        end
+
+        sig do
+          override.returns(
+            { data: T::Array[Telnyx::CalendarConnections::CalendarMeeting] }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/calendar_connections/meeting_update_params.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module CalendarConnections
+      class MeetingUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::CalendarConnections::MeetingUpdateParams,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(String) }
+        attr_accessor :meeting_id
+
+        # True opts in, false opts out, null follows connection policy. A supported
+        # meeting URL is still required.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :bot_will_join
+
+        sig do
+          params(
+            id: String,
+            meeting_id: String,
+            bot_will_join: T.nilable(T::Boolean),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          meeting_id:,
+          # True opts in, false opts out, null follows connection policy. A supported
+          # meeting URL is still required.
+          bot_will_join:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              meeting_id: String,
+              bot_will_join: T.nilable(T::Boolean),
+              request_options: Telnyx::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/calendar_connections/meeting_update_response.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module CalendarConnections
+      class MeetingUpdateResponse < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::CalendarConnections::MeetingUpdateResponse,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Telnyx::CalendarConnections::CalendarMeeting) }
+        attr_reader :data
+
+        sig do
+          params(
+            data: Telnyx::CalendarConnections::CalendarMeeting::OrHash
+          ).void
+        end
+        attr_writer :data
+
+        sig do
+          params(
+            data: Telnyx::CalendarConnections::CalendarMeeting::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(data:)
+        end
+
+        sig do
+          override.returns(
+            { data: Telnyx::CalendarConnections::CalendarMeeting }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/call_analyzed_webhook_event.rbi

@@ -256,7 +256,7 @@ module Telnyx
             params(
               cost:
                 T.any(
-                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::OrHash,
+                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::OrHash,
                   String
                 )
             ).void
@@ -353,7 +353,7 @@ module Telnyx
                 ),
               cost:
                 T.any(
-                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::OrHash,
+                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::OrHash,
                   String
                 ),
               duration_sec: Integer,
@@ -580,16 +580,16 @@ module Telnyx
             Variants =
               T.type_alias do
                 T.any(
-                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0,
+                  Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown,
                   String
                 )
               end
 
-            class UnionMember0 < Telnyx::Internal::Type::BaseModel
+            class CallCostBreakdown < Telnyx::Internal::Type::BaseModel
               OrHash =
                 T.type_alias do
                   T.any(
-                    Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0,
+                    Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown,
                     Telnyx::Internal::AnyHash
                   )
                 end
@@ -599,7 +599,7 @@ module Telnyx
                 returns(
                   T.nilable(
                     T::Array[
-                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::Breakdown
+                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::Breakdown
                     ]
                   )
                 )
@@ -610,7 +610,7 @@ module Telnyx
                 params(
                   breakdown:
                     T::Array[
-                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::Breakdown::OrHash
+                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::Breakdown::OrHash
                     ]
                 ).void
               end
@@ -630,17 +630,12 @@ module Telnyx
               sig { params(total: String).void }
               attr_writer :total
 
-              # The session's cost breakdown from Session Analysis, covering every product
-              # billed on the call: the AI Voice Assistant engine minutes
-              # (`ai-voice-assistant`), LLM inference tokens (`inference`), and call-control,
-              # SIP trunking, and recording lines. If cost data could not be retrieved after
-              # retries, this field carries the placeholder string `No cost data available.`
-              # instead of an object.
+              # The itemized cost of the call.
               sig do
                 params(
                   breakdown:
                     T::Array[
-                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::Breakdown::OrHash
+                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::Breakdown::OrHash
                     ],
                   currency: String,
                   total: String
@@ -661,7 +656,7 @@ module Telnyx
                   {
                     breakdown:
                       T::Array[
-                        Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::Breakdown
+                        Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::Breakdown
                       ],
                     currency: String,
                     total: String
@@ -675,7 +670,7 @@ module Telnyx
                 OrHash =
                   T.type_alias do
                     T.any(
-                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::UnionMember0::Breakdown,
+                      Telnyx::CallAnalyzedWebhookEvent::Data::Payload::Cost::CallCostBreakdown::Breakdown,
                       Telnyx::Internal::AnyHash
                     )
                   end