telnyx 5.170.0 → 5.173.0

data/rbi/telnyx/models/ai/transcription_settings_config.rbi

@@ -43,9 +43,8 @@ module Telnyx
         sig { params(enable_endpoint_detection: T::Boolean).void }
         attr_writer :enable_endpoint_detection
 
-        # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-        # assemblyai/universal-streaming). Confidence level required to trigger an end of
-        # turn. Higher values require more certainty before ending a turn.
+        # Deprecated and ignored. Accepted for backwards compatibility. AssemblyAI turn
+        # detection is configured with min_turn_silence and max_turn_silence.
         sig { returns(T.nilable(Float)) }
         attr_reader :end_of_turn_confidence_threshold
 
@@ -76,10 +75,13 @@ module Telnyx
         sig { params(interim_results: T::Boolean).void }
         attr_writer :interim_results
 
-        # Available only for deepgram/nova-3 and deepgram/flux. A comma-separated list of
-        # key terms to boost for recognition during transcription. Helps improve accuracy
-        # for domain-specific terminology, proper nouns, or uncommon words. This field may
-        # be templated with
+        # A comma-separated list of key terms to boost for recognition during
+        # transcription, used by Deepgram, Reson8, Speechmatics Linden 1 and AssemblyAI
+        # models. Helps improve accuracy for domain-specific terminology, proper nouns, or
+        # uncommon words. At most 1000 characters in total. For
+        # assemblyai/universal-3-6-pro (and its legacy aliases
+        # assemblyai/universal-3-5-pro and assemblyai/universal-streaming), also at most
+        # 100 terms of up to 50 characters each. This field may be templated with
         # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
         # using mustache syntax (e.g. `Telnyx,{{customer_name}},VoIP`). Variables are
         # resolved at call time before the value is sent to the speech-to-text engine.
@@ -107,18 +109,19 @@ module Telnyx
         sig { params(max_endpoint_delay_ms: Integer).void }
         attr_writer :max_endpoint_delay_ms
 
-        # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-        # assemblyai/universal-streaming). Maximum duration of silence in milliseconds
-        # before forcing an end of turn.
+        # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+        # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Maximum
+        # duration of silence in milliseconds before forcing an end of turn.
         sig { returns(T.nilable(Integer)) }
         attr_reader :max_turn_silence
 
         sig { params(max_turn_silence: Integer).void }
         attr_writer :max_turn_silence
 
-        # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-        # assemblyai/universal-streaming). Minimum duration of silence in milliseconds
-        # before a turn can end. Must be less than or equal to max_turn_silence.
+        # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+        # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Minimum
+        # duration of silence in milliseconds before a turn can end. Must be less than or
+        # equal to max_turn_silence.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_turn_silence
 
@@ -131,6 +134,29 @@ module Telnyx
         sig { params(numerals: T::Boolean).void }
         attr_writer :numerals
 
+        # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+        # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Context about
+        # the conversation (domain, names, terms) to improve transcription; describe the
+        # content, do not give instructions. Leave empty unless needed. At most 1750
+        # characters.
+        sig { returns(T.nilable(String)) }
+        attr_reader :prompt
+
+        sig { params(prompt: String).void }
+        attr_writer :prompt
+
+        # Available only for speechmatics/linden-1. When true, filler words such as "um"
+        # and "uh" are removed from the transcript. Disfluency removal is supported only
+        # for `ar`, `cmn`, `da`, `de`, `el`, `en`, `es`, `fr`, `he`, `hi`, `hu`, `it`,
+        # `ja`, `nl`, `pl`, `pt`, and `ru`, determined by the base language (so `en-US`,
+        # `en-GB`, `en-AU`, `cmn-Hans`, and `cmn-Hant` are supported); for other
+        # languages, filler words remain in the transcript.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :remove_disfluencies
+
+        sig { params(remove_disfluencies: T::Boolean).void }
+        attr_writer :remove_disfluencies
+
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :smart_format
 
@@ -152,6 +178,8 @@ module Telnyx
             max_turn_silence: Integer,
             min_turn_silence: Integer,
             numerals: T::Boolean,
+            prompt: String,
+            remove_disfluencies: T::Boolean,
             smart_format: T::Boolean
           ).returns(T.attached_class)
         end
@@ -172,9 +200,8 @@ module Telnyx
           # emits end-of-utterance events at the cadence configured by
           # `max_endpoint_delay_ms`.
           enable_endpoint_detection: nil,
-          # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-          # assemblyai/universal-streaming). Confidence level required to trigger an end of
-          # turn. Higher values require more certainty before ending a turn.
+          # Deprecated and ignored. Accepted for backwards compatibility. AssemblyAI turn
+          # detection is configured with min_turn_silence and max_turn_silence.
           end_of_turn_confidence_threshold: nil,
           # Available only for deepgram/flux. Confidence required to trigger an end of turn.
           # Higher values = more reliable turn detection but slightly increased latency.
@@ -185,10 +212,13 @@ module Telnyx
           # Available only for soniox/stt-rt-v4 and soniox/stt-rt-v5. When true, Soniox
           # streams interim (non-final) results in addition to finalized transcripts.
           interim_results: nil,
-          # Available only for deepgram/nova-3 and deepgram/flux. A comma-separated list of
-          # key terms to boost for recognition during transcription. Helps improve accuracy
-          # for domain-specific terminology, proper nouns, or uncommon words. This field may
-          # be templated with
+          # A comma-separated list of key terms to boost for recognition during
+          # transcription, used by Deepgram, Reson8, Speechmatics Linden 1 and AssemblyAI
+          # models. Helps improve accuracy for domain-specific terminology, proper nouns, or
+          # uncommon words. At most 1000 characters in total. For
+          # assemblyai/universal-3-6-pro (and its legacy aliases
+          # assemblyai/universal-3-5-pro and assemblyai/universal-streaming), also at most
+          # 100 terms of up to 50 characters each. This field may be templated with
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
           # using mustache syntax (e.g. `Telnyx,{{customer_name}},VoIP`). Variables are
           # resolved at call time before the value is sent to the speech-to-text engine.
@@ -201,15 +231,29 @@ module Telnyx
           # milliseconds) before Soniox emits an end-of-utterance event. Only honored when
           # `enable_endpoint_detection` is true.
           max_endpoint_delay_ms: nil,
-          # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-          # assemblyai/universal-streaming). Maximum duration of silence in milliseconds
-          # before forcing an end of turn.
+          # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+          # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Maximum
+          # duration of silence in milliseconds before forcing an end of turn.
           max_turn_silence: nil,
-          # Available only for assemblyai/universal-3-5-pro (and its legacy alias
-          # assemblyai/universal-streaming). Minimum duration of silence in milliseconds
-          # before a turn can end. Must be less than or equal to max_turn_silence.
+          # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+          # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Minimum
+          # duration of silence in milliseconds before a turn can end. Must be less than or
+          # equal to max_turn_silence.
           min_turn_silence: nil,
           numerals: nil,
+          # Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+          # assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Context about
+          # the conversation (domain, names, terms) to improve transcription; describe the
+          # content, do not give instructions. Leave empty unless needed. At most 1750
+          # characters.
+          prompt: nil,
+          # Available only for speechmatics/linden-1. When true, filler words such as "um"
+          # and "uh" are removed from the transcript. Disfluency removal is supported only
+          # for `ar`, `cmn`, `da`, `de`, `el`, `en`, `es`, `fr`, `he`, `hi`, `hu`, `it`,
+          # `ja`, `nl`, `pl`, `pt`, and `ru`, determined by the base language (so `en-US`,
+          # `en-GB`, `en-AU`, `cmn-Hans`, and `cmn-Hant` are supported); for other
+          # languages, filler words remain in the transcript.
+          remove_disfluencies: nil,
           smart_format: nil
         )
         end
@@ -230,6 +274,8 @@ module Telnyx
               max_turn_silence: Integer,
               min_turn_silence: Integer,
               numerals: T::Boolean,
+              prompt: String,
+              remove_disfluencies: T::Boolean,
               smart_format: T::Boolean
             }
           )

data/rbi/telnyx/models/ai/vision_tool_params.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class VisionToolParams < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::AI::VisionToolParams, Telnyx::Internal::AnyHash)
+          end
+
+        # Frames received longer ago than this many seconds are not shown to the
+        # assistant, so it never describes a frozen or disconnected camera as live.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_frame_age_secs
+
+        sig { params(max_frame_age_secs: Integer).void }
+        attr_writer :max_frame_age_secs
+
+        sig { params(max_frame_age_secs: Integer).returns(T.attached_class) }
+        def self.new(
+          # Frames received longer ago than this many seconds are not shown to the
+          # assistant, so it never describes a frozen or disconnected camera as live.
+          max_frame_age_secs: nil
+        )
+        end
+
+        sig { override.returns({ max_frame_age_secs: Integer }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/voice_settings.rbi

@@ -120,9 +120,9 @@ module Telnyx
         sig { params(use_speaker_boost: T::Boolean).void }
         attr_writer :use_speaker_boost
 
-        # The speed of the voice in the range [0.25, 2.0]. 1.0 is deafult speed. Larger
-        # numbers make the voice faster, smaller numbers make it slower. This is only
-        # applicable for Telnyx Natural voices.
+        # The speed of the voice in the range [0.6, 1.5]. 1.0 is the default speed. Larger
+        # numbers make the voice faster, smaller numbers make it slower. Applies to Telnyx
+        # `Ultra` voices; values outside this range are rejected by the synthesis engine.
         sig { returns(T.nilable(Float)) }
         attr_reader :voice_speed
 
@@ -197,9 +197,9 @@ module Telnyx
           # Amplifies similarity to the original speaker voice. Increases computational load
           # and latency slightly. Only applicable when using ElevenLabs.
           use_speaker_boost: nil,
-          # The speed of the voice in the range [0.25, 2.0]. 1.0 is deafult speed. Larger
-          # numbers make the voice faster, smaller numbers make it slower. This is only
-          # applicable for Telnyx Natural voices.
+          # The speed of the voice in the range [0.6, 1.5]. 1.0 is the default speed. Larger
+          # numbers make the voice faster, smaller numbers make it slower. Applies to Telnyx
+          # `Ultra` voices; values outside this range are rejected by the synthesis engine.
           voice_speed: nil
         )
         end

data/rbi/telnyx/models/ai/websocket_settings.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class WebsocketSettings < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::AI::WebsocketSettings, Telnyx::Internal::AnyHash)
+          end
+
+        # Integration secret identifier whose value Telnyx sends as an
+        # `Authorization: Bearer <value>` header on the upgrade request. Resolved on every
+        # connection attempt, so a rotated secret is picked up by the next reconnect.
+        sig { returns(T.nilable(String)) }
+        attr_reader :auth_ref
+
+        sig { params(auth_ref: String).void }
+        attr_writer :auth_ref
+
+        # Whether Telnyx opens a WebSocket to `url` for each of this assistant's
+        # conversations. Defaults to `false`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :enabled
+
+        sig { params(enabled: T::Boolean).void }
+        attr_writer :enabled
+
+        # The `ws://` or `wss://` endpoint Telnyx connects to. Required when `enabled` is
+        # `true`. Must be externally reachable — localhost, private IP ranges and `.local`
+        # domains are rejected.
+        sig { returns(T.nilable(String)) }
+        attr_reader :url
+
+        sig { params(url: String).void }
+        attr_writer :url
+
+        # Streams conversation and telephony events to a WebSocket server you host, and
+        # accepts messages injected back into the conversation. Telnyx opens the
+        # connection as a client, once per conversation. Delivery is best effort
+        # throughout: while the connection is down events are dropped rather than queued,
+        # and no socket failure is ever allowed to affect the call. Beta feature.
+        sig do
+          params(auth_ref: String, enabled: T::Boolean, url: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Integration secret identifier whose value Telnyx sends as an
+          # `Authorization: Bearer <value>` header on the upgrade request. Resolved on every
+          # connection attempt, so a rotated secret is picked up by the next reconnect.
+          auth_ref: nil,
+          # Whether Telnyx opens a WebSocket to `url` for each of this assistant's
+          # conversations. Defaults to `false`.
+          enabled: nil,
+          # The `ws://` or `wss://` endpoint Telnyx connects to. Required when `enabled` is
+          # `true`. Must be externally reachable — localhost, private IP ranges and `.local`
+          # domains are rejected.
+          url: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            { auth_ref: String, enabled: T::Boolean, url: String }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/api_error.rbi

@@ -18,6 +18,13 @@ module Telnyx
       sig { params(description: String).void }
       attr_writer :description
 
+      # A human-readable explanation of the error.
+      sig { returns(T.nilable(String)) }
+      attr_reader :detail
+
+      sig { params(detail: String).void }
+      attr_writer :detail
+
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :meta
 
@@ -35,11 +42,20 @@ module Telnyx
           code: String,
           title: String,
           description: String,
+          detail: String,
           meta: T::Hash[Symbol, T.anything],
           source: Telnyx::APIError::Source::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(code:, title:, description: nil, meta: nil, source: nil)
+      def self.new(
+        code:,
+        title:,
+        description: nil,
+        # A human-readable explanation of the error.
+        detail: nil,
+        meta: nil,
+        source: nil
+      )
       end
 
       sig do
@@ -48,6 +64,7 @@ module Telnyx
             code: String,
             title: String,
             description: String,
+            detail: String,
             meta: T::Hash[Symbol, T.anything],
             source: Telnyx::APIError::Source
           }

data/rbi/telnyx/models/artifact_download_retrieve_params.rbi

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

data/rbi/telnyx/models/available_service.rbi

@@ -11,6 +11,8 @@ module Telnyx
       CLOUD_VPN = T.let(:cloud_vpn, Telnyx::AvailableService::TaggedSymbol)
       PRIVATE_WIRELESS_GATEWAY =
         T.let(:private_wireless_gateway, Telnyx::AvailableService::TaggedSymbol)
+      TAILSCALE_SUBNET_ROUTER =
+        T.let(:tailscale_subnet_router, Telnyx::AvailableService::TaggedSymbol)
       VIRTUAL_CROSS_CONNECT =
         T.let(:virtual_cross_connect, Telnyx::AvailableService::TaggedSymbol)
 

data/rbi/telnyx/models/billing_contact.rbi

@@ -8,16 +8,23 @@ module Telnyx
           T.any(Telnyx::BillingContact, Telnyx::Internal::AnyHash)
         end
 
+      # The email address of the person Telnyx should contact about billing for this
+      # account.
       sig { returns(String) }
       attr_accessor :email
 
+      # The first name of the person Telnyx should contact about billing for this
+      # account.
       sig { returns(String) }
       attr_accessor :first_name
 
+      # The last name of the person Telnyx should contact about billing for this
+      # account.
       sig { returns(String) }
       attr_accessor :last_name
 
-      # E.164 format with leading `+`.
+      # The phone number of the billing contact, in E.164 format, for example
+      # +12125551234.
       sig { returns(String) }
       attr_accessor :phone_number
 
@@ -30,10 +37,17 @@ module Telnyx
         ).returns(T.attached_class)
       end
       def self.new(
+        # The email address of the person Telnyx should contact about billing for this
+        # account.
         email:,
+        # The first name of the person Telnyx should contact about billing for this
+        # account.
         first_name:,
+        # The last name of the person Telnyx should contact about billing for this
+        # account.
         last_name:,
-        # E.164 format with leading `+`.
+        # The phone number of the billing contact, in E.164 format, for example
+        # +12125551234.
         phone_number:
       )
       end

data/rbi/telnyx/models/bpo_authorization_input.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class BpoAuthorizationInput < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Telnyx::BpoAuthorizationInput, Telnyx::Internal::AnyHash)
+        end
+
+      # Enterprise id of an approved BPO (Business Process Outsourcer) account on your
+      # organization to authorize for this DIR.
+      sig { returns(String) }
+      attr_accessor :bpo_enterprise_id
+
+      # Id of the signed Letter of Authorization document (uploaded via the Telnyx
+      # Documents API) in which the Brand Owner authorizes this BPO.
+      sig { returns(String) }
+      attr_accessor :loa_document_id
+
+      # One authorization to include when creating or updating a DIR: an approved BPO
+      # (Business Process Outsourcer) account plus the signed Letter of Authorization
+      # the Brand Owner granted it.
+      sig do
+        params(bpo_enterprise_id: String, loa_document_id: String).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # Enterprise id of an approved BPO (Business Process Outsourcer) account on your
+        # organization to authorize for this DIR.
+        bpo_enterprise_id:,
+        # Id of the signed Letter of Authorization document (uploaded via the Telnyx
+        # Documents API) in which the Brand Owner authorizes this BPO.
+        loa_document_id:
+      )
+      end
+
+      sig do
+        override.returns({ bpo_enterprise_id: String, loa_document_id: String })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/browser_session_create_params.rbi

@@ -0,0 +1,155 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class BrowserSessionCreateParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Telnyx::BrowserSessionCreateParams, Telnyx::Internal::AnyHash)
+        end
+
+      sig { returns(Telnyx::BrowserSessionCreateParams::Policy) }
+      attr_reader :policy
+
+      sig do
+        params(policy: Telnyx::BrowserSessionCreateParams::Policy::OrHash).void
+      end
+      attr_writer :policy
+
+      # Scoped to the organization. The same key and identical normalized policy,
+      # limits, and metadata replay the existing session (HTTP 201); a different request
+      # returns 409 idempotency_conflict. Replays do not restart terminal sessions.
+      sig { returns(T.nilable(String)) }
+      attr_reader :idempotency_key
+
+      sig { params(idempotency_key: String).void }
+      attr_writer :idempotency_key
+
+      sig { returns(T.nilable(Telnyx::BrowserSessionCreateParams::Limits)) }
+      attr_reader :limits
+
+      sig do
+        params(limits: Telnyx::BrowserSessionCreateParams::Limits::OrHash).void
+      end
+      attr_writer :limits
+
+      # Arbitrary key-value metadata.
+      sig { returns(T.nilable(T.anything)) }
+      attr_reader :metadata
+
+      sig { params(metadata: T.anything).void }
+      attr_writer :metadata
+
+      sig do
+        params(
+          policy: Telnyx::BrowserSessionCreateParams::Policy::OrHash,
+          idempotency_key: String,
+          limits: Telnyx::BrowserSessionCreateParams::Limits::OrHash,
+          metadata: T.anything,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        policy:,
+        # Scoped to the organization. The same key and identical normalized policy,
+        # limits, and metadata replay the existing session (HTTP 201); a different request
+        # returns 409 idempotency_conflict. Replays do not restart terminal sessions.
+        idempotency_key: nil,
+        limits: nil,
+        # Arbitrary key-value metadata.
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            policy: Telnyx::BrowserSessionCreateParams::Policy,
+            idempotency_key: String,
+            limits: Telnyx::BrowserSessionCreateParams::Limits,
+            metadata: T.anything,
+            request_options: Telnyx::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Policy < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::BrowserSessionCreateParams::Policy,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # Domain patterns the browser can navigate to. Exact match (example.com) or
+        # wildcard (\*.example.com). IP literals not allowed.
+        sig { returns(T::Array[String]) }
+        attr_accessor :allowed_domains
+
+        sig do
+          params(allowed_domains: T::Array[String]).returns(T.attached_class)
+        end
+        def self.new(
+          # Domain patterns the browser can navigate to. Exact match (example.com) or
+          # wildcard (\*.example.com). IP literals not allowed.
+          allowed_domains:
+        )
+        end
+
+        sig { override.returns({ allowed_domains: T::Array[String] }) }
+        def to_hash
+        end
+      end
+
+      class Limits < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::BrowserSessionCreateParams::Limits,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # Idle timeout in seconds. Must not exceed lifetime_s.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :idle_timeout_s
+
+        sig { params(idle_timeout_s: Integer).void }
+        attr_writer :idle_timeout_s
+
+        # Max session duration in seconds (60-1800).
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :lifetime_s
+
+        sig { params(lifetime_s: Integer).void }
+        attr_writer :lifetime_s
+
+        sig do
+          params(idle_timeout_s: Integer, lifetime_s: Integer).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Idle timeout in seconds. Must not exceed lifetime_s.
+          idle_timeout_s: nil,
+          # Max session duration in seconds (60-1800).
+          lifetime_s: nil
+        )
+        end
+
+        sig do
+          override.returns({ idle_timeout_s: Integer, lifetime_s: Integer })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end