telnyx 5.118.0 → 5.120.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f714336df7942dbd4bc8eea5ddeb82d990b9301b707f0cf2bd4d1722fe7bc62
-  data.tar.gz: 98fbe10db719704fc24b6cc1bf8e87bab5587e92fa80b13435dd00197202520d
+  metadata.gz: 7a656a53fa4d6d7859952723e3f213ba6ba97617e54f963077e93c1aae0c30bb
+  data.tar.gz: de70b45c695607e3081f869b92eb07a78e4ebefd8c51d54ac2fe9e8022342542
 SHA512:
-  metadata.gz: ec89bc2ff72804269668cead90a7e9ae942478d94e86aec25773617091db165ea4b673feda8f39f2f79b0e558baaa23cceeca063d3f615c869149602b855d401
-  data.tar.gz: 9e372a81a5c437f0cde9306e2c32de19b4f605b6a350141cef28cb1e546eff81f07daf53af5ec1ea2181966a845486d01df63d23355611d18f08eacf5f88a6d7
+  metadata.gz: 53bd897ac7b5648db78ef3cdcec615d3e84604fd39abd0cf76814f6ca533ac3039eb1cb3af6070e78d114b4ae285675f7961daf7edf6e69adf81609cadaf5176
+  data.tar.gz: e49688c8d1737b05c6782ab0082eb89e0aa2da83a4615e532e19db298a9c8361001b71179b431c5894f007f2135ac5c9dba4debaaeb1564678477b7e3ecce71d

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 5.120.0 (2026-05-27)
+
+Full Changelog: [v5.119.0...v5.120.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.119.0...v5.120.0)
+
+### Features
+
+* TELAPPS-531: document Rime ArcanaV3 and Coda voice models ([c8a9586](https://github.com/team-telnyx/telnyx-ruby/commit/c8a9586fc5b5692dc63cdc1aea10e9791da41438))
+
+
+### Documentation
+
+* add voice sdk debug call report spec ([bceac1a](https://github.com/team-telnyx/telnyx-ruby/commit/bceac1a1fbb0aeaf687d2b31b56013c8d08077d6))
+
+## 5.119.0 (2026-05-26)
+
+Full Changelog: [v5.118.0...v5.119.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.118.0...v5.119.0)
+
+### Features
+
+* TELAPPS-523: document stop_on_conversation_end on assistant recording_settings ([f4731b7](https://github.com/team-telnyx/telnyx-ruby/commit/f4731b7ed76a54314a06c738fe2f3f10f3b5a9ac))
+
 ## 5.118.0 (2026-05-22)
 
 Full Changelog: [v5.117.0...v5.118.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.117.0...v5.118.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.118.0"
+gem "telnyx", "~> 5.120.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -663,6 +663,11 @@ module Telnyx
     # @return [Telnyx::Resources::UacConnections]
     attr_reader :uac_connections
 
+    # Retrieve raw Voice SDK call report stats payloads for WebRTC call
+    # troubleshooting.
+    # @return [Telnyx::Resources::VoiceSDKCallReports]
+    attr_reader :voice_sdk_call_reports
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -936,6 +941,7 @@ module Telnyx
       @terms_of_service = Telnyx::Resources::TermsOfService.new(client: self)
       @pronunciation_dicts = Telnyx::Resources::PronunciationDicts.new(client: self)
       @uac_connections = Telnyx::Resources::UacConnections.new(client: self)
+      @voice_sdk_call_reports = Telnyx::Resources::VoiceSDKCallReports.new(client: self)
     end
   end
 end

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

@@ -171,7 +171,15 @@ module Telnyx
                    enum: -> { Telnyx::AI::TelephonySettings::RecordingSettings::Format },
                    api_name: :format
 
-          # @!method initialize(channels: nil, enabled: nil, file_format: nil)
+          # @!attribute stop_on_conversation_end
+          #   When enabled, the call recording will stop when the conversation ends (for
+          #   example, when the assistant hangs up or the call is transferred). When disabled,
+          #   recording continues until the call itself ends.
+          #
+          #   @return [Boolean, nil]
+          optional :stop_on_conversation_end, Telnyx::Internal::Type::Boolean
+
+          # @!method initialize(channels: nil, enabled: nil, file_format: nil, stop_on_conversation_end: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::TelephonySettings::RecordingSettings} for more details.
           #
@@ -182,6 +190,8 @@ module Telnyx
           #   @param enabled [Boolean] Whether call recording is enabled. When set to false, calls will not be recorded
           #
           #   @param file_format [Symbol, Telnyx::Models::AI::TelephonySettings::RecordingSettings::Format] The format of the recording file.
+          #
+          #   @param stop_on_conversation_end [Boolean] When enabled, the call recording will stop when the conversation ends (for examp
 
           # The number of channels for the recording. 'single' for mono, 'dual' for stereo.
           #

data/lib/telnyx/models/calls/action_gather_using_speak_params.rb

@@ -52,8 +52,8 @@ module Telnyx
         #     `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
         #     to configure speed, volume, pitch, and language_boost.
         #   - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-        #     Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-        #     voice_speed.
+        #     Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+        #     `voice_settings` to configure voice_speed.
         #   - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
         #     `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
         #     `voice_settings` to configure precision, sample_rate, and format.

data/lib/telnyx/models/calls/action_speak_params.rb

@@ -52,8 +52,8 @@ module Telnyx
         #     `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
         #     to configure speed, volume, pitch, and language_boost.
         #   - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-        #     Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-        #     voice_speed.
+        #     Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+        #     `voice_settings` to configure voice_speed.
         #   - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
         #     `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
         #     `voice_settings` to configure precision, sample_rate, and format.

data/lib/telnyx/models/conferences/action_speak_params.rb

@@ -52,8 +52,8 @@ module Telnyx
         #     `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
         #     to configure speed, volume, pitch, and language_boost.
         #   - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-        #     Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-        #     voice_speed.
+        #     Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+        #     `voice_settings` to configure voice_speed.
         #   - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
         #     `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
         #     `voice_settings` to configure precision, sample_rate, and format.

data/lib/telnyx/models/inbound_message_payload.rb

@@ -67,6 +67,12 @@ module Telnyx
       #   @return [String, nil]
       optional :messaging_profile_id, String
 
+      # @!attribute num_chars
+      #   The number of characters in the message text
+      #
+      #   @return [Integer, nil]
+      optional :num_chars, Integer
+
       # @!attribute organization_id
       #   Unique identifier for a messaging profile.
       #
@@ -165,7 +171,7 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String, nil?: true
 
-      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, webhook_failover_url: nil, webhook_url: nil)
+      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, num_chars: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, webhook_failover_url: nil, webhook_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::InboundMessagePayload} for more details.
       #
@@ -191,6 +197,8 @@ module Telnyx
       #
       #   @param messaging_profile_id [String] Unique identifier for a messaging profile.
       #
+      #   @param num_chars [Integer] The number of characters in the message text
+      #
       #   @param organization_id [String] Unique identifier for a messaging profile.
       #
       #   @param parts [Integer] Number of parts into which the message's body must be split.

data/lib/telnyx/models/message_cancel_scheduled_response.rb

@@ -69,6 +69,12 @@ module Telnyx
       #   @return [String, nil]
       optional :messaging_profile_id, String
 
+      # @!attribute num_chars
+      #   The number of characters in the message text
+      #
+      #   @return [Integer, nil]
+      optional :num_chars, Integer
+
       # @!attribute organization_id
       #   The id of the organization the messaging profile belongs to.
       #
@@ -178,7 +184,7 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String, nil?: true
 
-      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, smart_encoding_applied: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, webhook_failover_url: nil, webhook_url: nil)
+      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, num_chars: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, smart_encoding_applied: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, webhook_failover_url: nil, webhook_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::MessageCancelScheduledResponse} for more details.
       #
@@ -204,6 +210,8 @@ module Telnyx
       #
       #   @param messaging_profile_id [String] Unique identifier for a messaging profile.
       #
+      #   @param num_chars [Integer] The number of characters in the message text
+      #
       #   @param organization_id [String] The id of the organization the messaging profile belongs to.
       #
       #   @param parts [Integer] Number of parts into which the message's body must be split.

data/lib/telnyx/models/outbound_message_payload.rb

@@ -67,6 +67,12 @@ module Telnyx
       #   @return [String, nil]
       optional :messaging_profile_id, String
 
+      # @!attribute num_chars
+      #   The number of characters in the message text
+      #
+      #   @return [Integer, nil]
+      optional :num_chars, Integer
+
       # @!attribute organization_id
       #   The id of the organization the messaging profile belongs to.
       #
@@ -184,7 +190,7 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String, nil?: true
 
-      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, smart_encoding_applied: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, wait_seconds: nil, webhook_failover_url: nil, webhook_url: nil)
+      # @!method initialize(id: nil, cc: nil, completed_at: nil, cost: nil, cost_breakdown: nil, direction: nil, encoding: nil, errors: nil, from: nil, media: nil, messaging_profile_id: nil, num_chars: nil, organization_id: nil, parts: nil, received_at: nil, record_type: nil, sent_at: nil, smart_encoding_applied: nil, subject: nil, tags: nil, tcr_campaign_billable: nil, tcr_campaign_id: nil, tcr_campaign_registered: nil, text: nil, to: nil, type: nil, valid_until: nil, wait_seconds: nil, webhook_failover_url: nil, webhook_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::OutboundMessagePayload} for more details.
       #
@@ -210,6 +216,8 @@ module Telnyx
       #
       #   @param messaging_profile_id [String] Unique identifier for a messaging profile.
       #
+      #   @param num_chars [Integer] The number of characters in the message text
+      #
       #   @param organization_id [String] The id of the organization the messaging profile belongs to.
       #
       #   @param parts [Integer] Number of parts into which the message's body must be split.

data/lib/telnyx/models/voice_sdk_call_report_list_params.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::VoiceSDKCallReports#list
+    class VoiceSDKCallReportListParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute page_number
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!attribute sort
+      #   Set the order of the results by creation date. `asc` and `created_at` sort
+      #   oldest reports first; `desc` and `-created_at` sort newest reports first. If not
+      #   given, results are sorted by creation date in descending order.
+      #
+      #   @return [Symbol, Telnyx::Models::VoiceSDKCallReportListParams::Sort, nil]
+      optional :sort, enum: -> { Telnyx::VoiceSDKCallReportListParams::Sort }
+
+      # @!method initialize(page_number: nil, page_size: nil, sort: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::VoiceSDKCallReportListParams} for more details.
+      #
+      #   @param page_number [Integer]
+      #
+      #   @param page_size [Integer]
+      #
+      #   @param sort [Symbol, Telnyx::Models::VoiceSDKCallReportListParams::Sort] Set the order of the results by creation date. `asc` and `created_at` sort oldes
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      # Set the order of the results by creation date. `asc` and `created_at` sort
+      # oldest reports first; `desc` and `-created_at` sort newest reports first. If not
+      # given, results are sorted by creation date in descending order.
+      module Sort
+        extend Telnyx::Internal::Type::Enum
+
+        ASC = :asc
+        DESC = :desc
+        CREATED_AT = :created_at
+        CREATED_AT_DESC = :"-created_at"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/voice_sdk_call_report_list_response.rb

@@ -0,0 +1,385 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::VoiceSDKCallReports#list
+    class VoiceSDKCallReportListResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute call_id
+      #   Unique call identifier.
+      #
+      #   @return [String, nil]
+      optional :call_id, String
+
+      # @!attribute call_report_id
+      #   User-scoped storage grouping identifier derived from the authenticated user.
+      #   This is not a unique per-call report identifier and may be shared by multiple
+      #   calls for the same user.
+      #
+      #   @return [String, nil]
+      optional :call_report_id, String
+
+      # @!attribute created_at
+      #   Creation timestamp when present.
+      #
+      #   @return [Time, nil]
+      optional :created_at, Time
+
+      # @!attribute flush_reason
+      #   Reason the SDK flushed this stats report segment, for example an intermediate
+      #   socket-close flush.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :flush_reason,
+               Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+               api_name: :flushReason
+
+      # @!attribute logs
+      #   Raw logs payload emitted by the Voice SDK and stored without normalization. Live
+      #   responses commonly return an array of log entries, but object-shaped log
+      #   payloads are also allowed for compatibility.
+      #
+      #   @return [Array<Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0>, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries, nil]
+      optional :logs, union: -> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs }
+
+      # @!attribute organization_id
+      #   Organization associated with the stored call report when provided by the Voice
+      #   SDK reporting path.
+      #
+      #   @return [String, nil]
+      optional :organization_id, String
+
+      # @!attribute segment
+      #   Zero-based stats segment index when the SDK sends segmented or intermediate
+      #   reports.
+      #
+      #   @return [Integer, nil]
+      optional :segment, Integer
+
+      # @!attribute stats
+      #   Raw stats payload emitted by the Voice SDK and stored without normalization. The
+      #   exact shape can vary by SDK platform and version. Live responses commonly return
+      #   an array of interval snapshots, but object-shaped stats payloads are also
+      #   allowed for compatibility.
+      #
+      #   @return [Array<Hash{Symbol=>Object}>, Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember1, nil]
+      optional :stats, union: -> { Telnyx::Models::VoiceSDKCallReportListResponse::Stats }
+
+      # @!attribute stored_at
+      #   Time when the call report was stored.
+      #
+      #   @return [Time, nil]
+      optional :stored_at, Time
+
+      # @!attribute summary
+      #   High-level call metadata.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :summary, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+      # @!attribute telnyx_leg_id
+      #   Telnyx call leg identifier for correlating the report with call-control, SIP,
+      #   and media troubleshooting data.
+      #
+      #   @return [String, nil]
+      optional :telnyx_leg_id, String
+
+      # @!attribute telnyx_session_id
+      #   Telnyx RTC session identifier for correlating the report with Voice SDK
+      #   signaling and media-session logs.
+      #
+      #   @return [String, nil]
+      optional :telnyx_session_id, String
+
+      # @!attribute user_agent
+      #   Voice SDK user agent string reported by the client. This is the preferred
+      #   SDK/platform/version dimension when present.
+      #
+      #   @return [String, nil]
+      optional :user_agent, String
+
+      # @!attribute user_id
+      #   Authenticated user that owns the call report.
+      #
+      #   @return [String, nil]
+      optional :user_id, String
+
+      # @!attribute version
+      #   Legacy SDK version value when the client reports one separately from the user
+      #   agent.
+      #
+      #   @return [String, nil]
+      optional :version, String
+
+      # @!attribute voice_sdk_id
+      #   Voice SDK instance identifier.
+      #
+      #   @return [String, nil]
+      optional :voice_sdk_id, String
+
+      # @!attribute voice_sdk_id_decoded
+      #   Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :voice_sdk_id_decoded, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+      # @!attribute voice_sdk_session_id
+      #   Voice SDK session correlation identifier used to group stats segments for the
+      #   same SDK session.
+      #
+      #   @return [String, nil]
+      optional :voice_sdk_session_id, String
+
+      # @!method initialize(call_id: nil, call_report_id: nil, created_at: nil, flush_reason: nil, logs: nil, organization_id: nil, segment: nil, stats: nil, stored_at: nil, summary: nil, telnyx_leg_id: nil, telnyx_session_id: nil, user_agent: nil, user_id: nil, version: nil, voice_sdk_id: nil, voice_sdk_id_decoded: nil, voice_sdk_session_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::VoiceSDKCallReportListResponse} for more details.
+      #
+      #   A raw call report stats JSON payload. The schema is intentionally permissive
+      #   because Voice SDK clients can add fields over time.
+      #
+      #   @param call_id [String] Unique call identifier.
+      #
+      #   @param call_report_id [String] User-scoped storage grouping identifier derived from the authenticated user. Thi
+      #
+      #   @param created_at [Time] Creation timestamp when present.
+      #
+      #   @param flush_reason [Hash{Symbol=>Object}] Reason the SDK flushed this stats report segment, for example an intermediate so
+      #
+      #   @param logs [Array<Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0>, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries] Raw logs payload emitted by the Voice SDK and stored without normalization. Live
+      #
+      #   @param organization_id [String] Organization associated with the stored call report when provided by the Voice S
+      #
+      #   @param segment [Integer] Zero-based stats segment index when the SDK sends segmented or intermediate repo
+      #
+      #   @param stats [Array<Hash{Symbol=>Object}>, Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember1] Raw stats payload emitted by the Voice SDK and stored without normalization. The
+      #
+      #   @param stored_at [Time] Time when the call report was stored.
+      #
+      #   @param summary [Hash{Symbol=>Object}] High-level call metadata.
+      #
+      #   @param telnyx_leg_id [String] Telnyx call leg identifier for correlating the report with call-control, SIP, an
+      #
+      #   @param telnyx_session_id [String] Telnyx RTC session identifier for correlating the report with Voice SDK signalin
+      #
+      #   @param user_agent [String] Voice SDK user agent string reported by the client. This is the preferred SDK/pl
+      #
+      #   @param user_id [String] Authenticated user that owns the call report.
+      #
+      #   @param version [String] Legacy SDK version value when the client reports one separately from the user ag
+      #
+      #   @param voice_sdk_id [String] Voice SDK instance identifier.
+      #
+      #   @param voice_sdk_id_decoded [Hash{Symbol=>Object}] Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.
+      #
+      #   @param voice_sdk_session_id [String] Voice SDK session correlation identifier used to group stats segments for the sa
+
+      # Raw logs payload emitted by the Voice SDK and stored without normalization. Live
+      # responses commonly return an array of log entries, but object-shaped log
+      # payloads are also allowed for compatibility.
+      #
+      # @see Telnyx::Models::VoiceSDKCallReportListResponse#logs
+      module Logs
+        extend Telnyx::Internal::Type::Union
+
+        # Raw log entries emitted by the Voice SDK.
+        variant -> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0Array }
+
+        # Raw logs object emitted by the Voice SDK when logs are grouped under an entries field.
+        variant -> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries }
+
+        class UnionMember0 < Telnyx::Internal::Type::BaseModel
+          # @!attribute context
+          #   Raw structured context attached to the log entry.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :context, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute level
+          #   Log level emitted by the SDK.
+          #
+          #   @return [Symbol, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0::Level, nil]
+          optional :level, enum: -> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0::Level }
+
+          # @!attribute message
+          #   Log message.
+          #
+          #   @return [String, nil]
+          optional :message, String
+
+          # @!attribute timestamp
+          #   Time when the log entry was emitted.
+          #
+          #   @return [Time, nil]
+          optional :timestamp, Time
+
+          # @!method initialize(context: nil, level: nil, message: nil, timestamp: nil)
+          #   A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+          #
+          #   @param context [Hash{Symbol=>Object}] Raw structured context attached to the log entry.
+          #
+          #   @param level [Symbol, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0::Level] Log level emitted by the SDK.
+          #
+          #   @param message [String] Log message.
+          #
+          #   @param timestamp [Time] Time when the log entry was emitted.
+
+          # Log level emitted by the SDK.
+          #
+          # @see Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0#level
+          module Level
+            extend Telnyx::Internal::Type::Enum
+
+            DEBUG = :debug
+            INFO = :info
+            WARN = :warn
+            ERROR = :error
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class Entries < Telnyx::Internal::Type::BaseModel
+          # @!attribute entries
+          #   Raw log entries when the SDK groups logs under an entries field.
+          #
+          #   @return [Array<Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry>, nil]
+          optional :entries,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry] }
+
+          # @!method initialize(entries: nil)
+          #   Raw logs object emitted by the Voice SDK when logs are grouped under an entries
+          #   field.
+          #
+          #   @param entries [Array<Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry>] Raw log entries when the SDK groups logs under an entries field.
+
+          class Entry < Telnyx::Internal::Type::BaseModel
+            # @!attribute context
+            #   Raw structured context attached to the log entry.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :context, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+            # @!attribute level
+            #   Log level emitted by the SDK.
+            #
+            #   @return [Symbol, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry::Level, nil]
+            optional :level, enum: -> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry::Level }
+
+            # @!attribute message
+            #   Log message.
+            #
+            #   @return [String, nil]
+            optional :message, String
+
+            # @!attribute timestamp
+            #   Time when the log entry was emitted.
+            #
+            #   @return [Time, nil]
+            optional :timestamp, Time
+
+            # @!method initialize(context: nil, level: nil, message: nil, timestamp: nil)
+            #   A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+            #
+            #   @param context [Hash{Symbol=>Object}] Raw structured context attached to the log entry.
+            #
+            #   @param level [Symbol, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry::Level] Log level emitted by the SDK.
+            #
+            #   @param message [String] Log message.
+            #
+            #   @param timestamp [Time] Time when the log entry was emitted.
+
+            # Log level emitted by the SDK.
+            #
+            # @see Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries::Entry#level
+            module Level
+              extend Telnyx::Internal::Type::Enum
+
+              DEBUG = :debug
+              INFO = :info
+              WARN = :warn
+              ERROR = :error
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(Array<Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0>, Telnyx::Models::VoiceSDKCallReportListResponse::Logs::Entries)]
+
+        # @type [Telnyx::Internal::Type::Converter]
+        UnionMember0Array =
+          Telnyx::Internal::Type::ArrayOf[-> { Telnyx::Models::VoiceSDKCallReportListResponse::Logs::UnionMember0 }]
+      end
+
+      # Raw stats payload emitted by the Voice SDK and stored without normalization. The
+      # exact shape can vary by SDK platform and version. Live responses commonly return
+      # an array of interval snapshots, but object-shaped stats payloads are also
+      # allowed for compatibility.
+      #
+      # @see Telnyx::Models::VoiceSDKCallReportListResponse#stats
+      module Stats
+        extend Telnyx::Internal::Type::Union
+
+        # Raw interval stats snapshots emitted by the Voice SDK.
+        variant -> { Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember0Array }
+
+        # Raw stats object emitted by the Voice SDK.
+        variant -> { Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember1 }
+
+        class UnionMember1 < Telnyx::Internal::Type::BaseModel
+          # @!attribute audio
+          #   Raw audio stats such as inbound/outbound packet, byte, jitter, packet-loss,
+          #   bitrate, and audio-level metrics.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :audio, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute connection
+          #   Raw connection stats such as round-trip time, packets, and bytes sent or
+          #   received.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :connection, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute ice
+          #   Raw ICE candidate-pair information, including selected pair, local/remote
+          #   candidates, state, and nomination data when provided by the SDK.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :ice, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute transport
+          #   Raw transport stats such as ICE state, DTLS state, SRTP cipher, TLS version, and
+          #   selected-candidate-pair changes.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :transport, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!method initialize(audio: nil, connection: nil, ice: nil, transport: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember1} for more
+          #   details.
+          #
+          #   Raw stats object emitted by the Voice SDK.
+          #
+          #   @param audio [Hash{Symbol=>Object}] Raw audio stats such as inbound/outbound packet, byte, jitter, packet-loss, bitr
+          #
+          #   @param connection [Hash{Symbol=>Object}] Raw connection stats such as round-trip time, packets, and bytes sent or receive
+          #
+          #   @param ice [Hash{Symbol=>Object}] Raw ICE candidate-pair information, including selected pair, local/remote candid
+          #
+          #   @param transport [Hash{Symbol=>Object}] Raw transport stats such as ICE state, DTLS state, SRTP cipher, TLS version, and
+        end
+
+        # @!method self.variants
+        #   @return [Array(Array<Hash{Symbol=>Object}>, Telnyx::Models::VoiceSDKCallReportListResponse::Stats::UnionMember1)]
+
+        # @type [Telnyx::Internal::Type::Converter]
+        UnionMember0Array =
+          Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
+      end
+    end
+  end
+end