telnyx 5.169.0 → 5.170.0

data/rbi/telnyx/resources/ai/memory/namespaces/settings.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        class Namespaces
+          # How a namespace's summaries are written.
+          class Settings
+            # What is currently set for this namespace. `instructions: null` means none are
+            # set and summaries use the neutral default.
+            sig do
+              params(
+                namespace: String,
+                request_options: Telnyx::RequestOptions::OrHash
+              ).returns(
+                Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse
+              )
+            end
+            def list(
+              # The namespace. `default` exists for every organization.
+              namespace,
+              request_options: {}
+            )
+            end
+
+            # Only the fields you send are changed; anything omitted is left as it is, so `{}`
+            # changes nothing. Sending `instructions: null`, or an empty or whitespace-only
+            # string, clears them and returns summaries to the neutral default.
+            #
+            # Instructions are capped at 2000 characters. A longer note is refused rather than
+            # truncated, because a note cut mid-sentence is a worse steer than none. A change
+            # reaches each summary the next time that summary is regenerated, not immediately.
+            sig do
+              params(
+                namespace: String,
+                summary:
+                  T.nilable(
+                    Telnyx::AI::Memory::Namespaces::SettingPatchAllParams::Summary::OrHash
+                  ),
+                request_options: Telnyx::RequestOptions::OrHash
+              ).returns(
+                Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse
+              )
+            end
+            def patch_all(
+              # The namespace. `default` exists for every organization.
+              namespace,
+              # A partial update to a namespace's summary settings.
+              #
+              # Only the fields present in the request are changed; the rest are left as they
+              # are. Sending `instructions: null` (or empty) clears the instructions.
+              summary: nil,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: Telnyx::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/memory/namespaces.rbi

@@ -0,0 +1,37 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        # Whether a write has finished.
+        class Namespaces
+          sig { returns(Telnyx::Resources::AI::Memory::Namespaces::Profiles) }
+          attr_reader :profiles
+
+          # How a namespace's summaries are written.
+          sig { returns(Telnyx::Resources::AI::Memory::Namespaces::Settings) }
+          attr_reader :settings
+
+          # Whether a write has finished. Both `ingest` and `remember` return an
+          # `operation_id`, and a memory is not recallable until its operation completes —
+          # extraction, embedding and consolidation all run first.
+          sig do
+            params(
+              operation_id: String,
+              namespace: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(Telnyx::Models::AI::Memory::NamespaceRetrieveResponse)
+          end
+          def retrieve(operation_id, namespace:, request_options: {})
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/memory.rbi

@@ -0,0 +1,18 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Memory
+        # Whether a write has finished.
+        sig { returns(Telnyx::Resources::AI::Memory::Namespaces) }
+        attr_reader :namespaces
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/typesafe/v1.rbi

@@ -5,27 +5,31 @@ module Telnyx
     class AI
       class Typesafe
         # Beta API for evaluating shared context with typed questions and structured
-        # answers. Telnyx manages model selection.
+        # answers using Flash or Pro.
         class V1
-          # **Beta API.** Telnyx controls model selection.
+          # **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+          # telnyx/decision-pro for decisions that require long context, including inputs
+          # beyond Jev’s 32k per-decision limit. Omitted model defaults to
+          # telnyx/decision-flash.
           #
           # Evaluate shared context using named choice, noul (yes/no), and score questions.
-          # Returns TypeSafe System One-compatible answer shapes, an opaque compatibility
-          # identifier, and token usage. See the
+          # Returns TypeSafe System One-compatible answer shapes, the selected public model
+          # alias, and token usage. See the
           # [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
           # for examples and compatibility limits.
           #
           # The supported request subset requires instructions for every question, string
           # descriptions for criteria (or null for choice descriptions), 1–64 questions, and
-          # 2–64 options for choice and score questions. The SDK-supplied model value is
-          # ignored and cannot select a model. Other unknown fields are rejected. The
-          # endpoint is synchronous and does not stream.
+          # 2–64 options for choice and score questions. The model field accepts only
+          # telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+          # unknown fields are rejected. The endpoint is synchronous and does not stream.
           #
           # Use the TypeSafe Python SDK with base_url set to
           # https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
-          # /v1/systemone. Compatibility covers this operation and the documented request
-          # subset; it does not include TypeSafe model listing. Scores describe relative
-          # preference, not calibrated correctness.
+          # /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+          # default model is not supported. Compatibility covers this operation and the
+          # documented request subset; it does not include TypeSafe model listing. Scores
+          # describe relative preference, not calibrated correctness.
           sig do
             params(
               questions:
@@ -38,6 +42,7 @@ module Telnyx
                   )
                 ],
               state: Telnyx::AI::Typesafe::V1SystemoneParams::State::Variants,
+              model: Telnyx::AI::Typesafe::V1SystemoneParams::Model::OrSymbol,
               request_options: Telnyx::RequestOptions::OrHash
             ).returns(Telnyx::Models::AI::Typesafe::V1SystemoneResponse)
           end
@@ -46,6 +51,11 @@ module Telnyx
             questions:,
             # Shared context evaluated by every question.
             state:,
+            # Public model alias. telnyx/decision-flash offers the lowest cost and latency;
+            # telnyx/decision-pro supports decisions that require long context, including
+            # inputs beyond Jev’s 32k per-decision limit. Applies to every question in the
+            # request. Other values are rejected.
+            model: nil,
             request_options: {}
           )
           end

data/rbi/telnyx/resources/ai/typesafe.rbi

@@ -5,7 +5,7 @@ module Telnyx
     class AI
       class Typesafe
         # Beta API for evaluating shared context with typed questions and structured
-        # answers. Telnyx manages model selection.
+        # answers using Flash or Pro.
         sig { returns(Telnyx::Resources::AI::Typesafe::V1) }
         attr_reader :v1
 

data/rbi/telnyx/resources/ai.rbi

@@ -58,6 +58,9 @@ module Telnyx
       sig { returns(Telnyx::Resources::AI::Typesafe) }
       attr_reader :typesafe
 
+      sig { returns(Telnyx::Resources::AI::Memory) }
+      attr_reader :memory
+
       # Performs semantic vector search across conversation history records.
       #
       # **How it works:**

data/rbi/telnyx/resources/calls/actions.rbi

@@ -467,7 +467,8 @@ module Telnyx
                 Telnyx::Calls::AwsVoiceSettings::OrHash,
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionGatherUsingAIResponse)
@@ -547,6 +548,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -686,7 +693,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionGatherUsingSpeakResponse)
@@ -740,6 +748,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -1208,7 +1222,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionSpeakResponse)
@@ -1262,6 +1277,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -1423,7 +1444,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionStartConversationRelayResponse)
@@ -1526,6 +1548,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:

data/rbi/telnyx/resources/conferences/actions.rbi

@@ -534,7 +534,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Conferences::ActionSpeakResponse)
@@ -588,6 +589,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:

data/rbi/telnyx/resources/email_blocks/imports.rbi

@@ -13,9 +13,23 @@ module Telnyx
         # - header-only / all-blank / undetectable provider → `400` Returns `202` with the
         #   import record (status `pending`); an Oban worker (`EmailBlockImportWorker`,
         #   max_attempts 3) transitions `pending → processing → completed | failed`.
-        #   `block_ttl_days` applies only to imported `manual_block` rows; other reasons
-        #   get `expires_at: nil`. Provider is auto-detected from the CSV header
-        #   (`sendgrid` / `mailgun` / `ses` / `generic`).
+        #
+        # Native Telnyx exports are detected by the stable first-12-column header
+        # signature (`id` … `group_id`) and are restored with their original `from`,
+        # `domain_id`, `group_id`, `source`, `status`, `expires_at`, plus
+        # `bounce_category`, `dsn_code`, and `meta` when present (`scope` is re-derived
+        # from `domain_id`/`from`; the exported `scope` cell must be a valid enum value).
+        # Lifecycle changes reconcile through the same create path as the API: a row
+        # already in the requested state restores its mutable backup fields without a new
+        # audit event, and a real transition (e.g. tombstone → active) appends the
+        # matching lifecycle event. `block_ttl_days` is not applied to native rows — their
+        # exported `expires_at` is preserved verbatim.
+        #
+        # Competitor and generic imports (SendGrid / Mailgun / SES / generic) remain
+        # account-scoped (`from`, `domain_id`, `group_id`, `scope` are not read) and
+        # `block_ttl_days` applies only to imported `manual_block` rows; other reasons get
+        # `expires_at: nil`. Provider is auto-detected from the CSV header (`sendgrid` /
+        # `mailgun` / `ses` / `generic`).
         sig do
           params(
             file: Telnyx::Internal::FileInput,

data/rbi/telnyx/resources/email_blocks.rbi

@@ -158,9 +158,11 @@ module Telnyx
       # stream `ORDER BY created_at ASC, id ASC` with no pagination.
       #
       # CSV columns:
-      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id`.
-      # The CSV carries the `group_id` column so group-scoped suppressions' group link
-      # survives the export (empty for account-scope rows).
+      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id,bounce_category,dsn_code, meta`
+      # (15 columns). The first 12 columns are the stable native signature;
+      # `bounce_category`, `dsn_code`, and `meta` are optional backup fields (empty when
+      # unset). The CSV carries the `group_id` column so group-scoped suppressions'
+      # group link survives the export (empty for account-scope rows).
       sig do
         params(
           filter_created_after: Time,

data/rbi/telnyx/resources/email_domains.rbi

@@ -167,6 +167,28 @@ module Telnyx
       )
       end
 
+      # Generates a new DKIM key for the domain, activates it, and retires the previous
+      # key. The response includes the updated DKIM DNS records the customer must
+      # publish. Selectors are fixed, so rotation replaces the TXT value at the existing
+      # `<selector>._domainkey.<domain>` host rather than adding a second record —
+      # `old_selector_retained` is false and the new TXT value must be published
+      # promptly, since signing switches to the new key immediately and the old TXT
+      # value will no longer match. The previous key is retired to a `retiring` state
+      # (retained, not revoked) so it can be revoked after the DNS propagation grace
+      # period.
+      sig do
+        params(
+          domain_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::EmailDomainRotateDkimResponse)
+      end
+      def rotate_dkim(
+        # Email domain UUID
+        domain_id,
+        request_options: {}
+      )
+      end
+
       # Checks the published DNS records against the records required for the email
       # domain and returns the latest verification results.
       sig do

data/rbi/telnyx/resources/email_events.rbi

@@ -5,21 +5,30 @@ module Telnyx
     # Retrieve account-level email events and event statistics.
     class EmailEvents
       # Lists account-level email events sorted oldest first by
-      # `occurred_at asc, id asc`.
+      # `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+      # and an additive canonical_event_type. Gateway rejection renders email.failed
+      # with canonical email.gw_reject; ambiguous injection timeout renders
+      # email.injection_timeout in both; MTA expiration renders email.bounced with
+      # canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+      # daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+      # matching webhook delivery. Scheduled is the cardinality exception: account
+      # polling retains one message-scoped scheduled row with its stored event ID, while
+      # scheduled webhook publication fans out per recipient with derived IDs; reconcile
+      # scheduled events by message ID, event type, and occurrence time rather than
+      # event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+      # polling and webhook delivery. Legacy names are derived from stored rows; an
+      # AdminBounce row stored as failed renders email.failed in polling while its
+      # webhook retains email.bounced, both with canonical email.failed.
       sig do
         params(
           email_id: String,
           event_type: Telnyx::EmailEventListParams::EventType::Variants,
           from: Time,
-          page_cursor: String,
           page_size: Integer,
+          page_cursor: String,
           to: Time,
           request_options: Telnyx::RequestOptions::OrHash
-        ).returns(
-          Telnyx::Internal::EmailCursorPagination[
-            Telnyx::Models::EmailEventListResponse
-          ]
-        )
+        ).returns(Telnyx::Models::EmailEventListResponse)
       end
       def list(
         # Filter events for a specific email message UUID. Invalid UUID values are
@@ -28,14 +37,26 @@ module Telnyx
         # Comma-separated list of event types to include. Also accepts repeated query
         # parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
         # no matches.
+        #
+        # Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+        # value keeps matching the rows it matched pre-rename — no widening: `failed` also
+        # matches the rows that now store the canonical names of the outcomes it covered
+        # (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+        # `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+        # never matched `bounced`, so `expired` is deliberately not a `bounced`
+        # expansion). A canonical value matches its own rows plus legacy rows whose
+        # recorded payload evidence proves that outcome (`expired` also surfaces legacy
+        # `bounced` rows with `bounce_category: transient`). The additive
+        # `canonical_event_type` field in each response row names the canonical outcome.
         event_type: nil,
         # Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
         from: nil,
-        # Opaque URL-safe Base64 cursor returned by a previous list response.
-        page_cursor: nil,
         # Number of results to return. Defaults to 25; maximum is 100. Invalid values are
         # clamped to the valid range.
         page_size: nil,
+        # Opaque URL-safe Base64 cursor returned by a previous event list response. The
+        # legacy `page[after]` and flat `page_cursor` forms are also accepted.
+        page_cursor: nil,
         # Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
         # to `from + 30 days`.
         to: nil,