telnyx 5.171.0 → 5.174.0

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#list
+      class AvatarListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute filter_avatar_type
+        #   Return only stock or custom avatars.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::AvatarType, nil]
+        optional :filter_avatar_type, enum: -> { Telnyx::AI::AvatarType }
+
+        # @!attribute filter_id
+        #   Return the avatar with this exact ID.
+        #
+        #   @return [String, nil]
+        optional :filter_id, String
+
+        # @!attribute filter_name
+        #   Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        #   @return [String, nil]
+        optional :filter_name, String
+
+        # @!attribute page_number
+        #   Page number to retrieve, starting at 1.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Number of avatars to return per page.
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(filter_avatar_type: nil, filter_id: nil, filter_name: nil, page_number: nil, page_size: nil, request_options: {})
+        #   @param filter_avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Return only stock or custom avatars.
+        #
+        #   @param filter_id [String] Return the avatar with this exact ID.
+        #
+        #   @param filter_name [String] Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        #   @param page_number [Integer] Page number to retrieve, starting at 1.
+        #
+        #   @param page_size [Integer] Number of avatars to return per page.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#create
+      class AvatarResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::AI::Avatar]
+        required :data, -> { Telnyx::AI::Avatar }
+
+        # @!method initialize(data:)
+        #   @param data [Telnyx::Models::AI::Avatar]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#retrieve
+      class AvatarRetrieveParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute avatar_id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :avatar_id, String
+
+        # @!method initialize(avatar_id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AvatarRetrieveParams} for more details.
+        #
+        #   @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -5,10 +5,10 @@ module Telnyx
     module AI
       class AvatarSettingsRequest < Telnyx::Internal::Type::BaseModel
         # @!attribute avatar_id
-        #   The Telnyx avatar to render.
+        #   The Telnyx stock avatar or organization-owned custom avatar to render.
         #
-        #   @return [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::AvatarID]
-        required :avatar_id, enum: -> { Telnyx::AI::AvatarSettingsRequest::AvatarID }
+        #   @return [String]
+        required :avatar_id, String
 
         # @!attribute background_id
         #   The background to render.
@@ -33,10 +33,12 @@ module Telnyx
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AvatarSettingsRequest} for more details.
         #
-        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #   avatar or an organization-owned custom avatar returned by the Avatars API.
+        #   Discover the available stock catalog with GET /v2/ai/avatars and
+        #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
         #
-        #   @param avatar_id [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::AvatarID] The Telnyx avatar to render.
+        #   @param avatar_id [String] The Telnyx stock avatar or organization-owned custom avatar to render.
         #
         #   @param background_id [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::BackgroundID] The background to render.
         #
@@ -44,23 +46,6 @@ module Telnyx
         #
         #   @param provider [Symbol, :telnyx] Selects the Telnyx open-source avatar provider.
 
-        # The Telnyx avatar to render.
-        #
-        # @see Telnyx::Models::AI::AvatarSettingsRequest#avatar_id
-        module AvatarID
-          extend Telnyx::Internal::Type::Enum
-
-          ELENA = :elena
-          BEN = :ben
-          JORDAN = :jordan
-          LIN = :lin
-          AVERY = :avery
-          RAPHAEL = :raphael
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
         # The background to render.
         #
         # @see Telnyx::Models::AI::AvatarSettingsRequest#background_id
@@ -70,6 +55,7 @@ module Telnyx
           OFFICE = :office
           STUDIO = :studio
           RECEPTION = :reception
+          ILLUSTRATED_WORKSPACE = :illustrated_workspace
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # Whether the avatar is provided by Telnyx or was uploaded by the authenticated
+      # organization.
+      module AvatarType
+        extend Telnyx::Internal::Type::Enum
+
+        STOCK = :stock
+        CUSTOM = :custom
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#update
+      class AvatarUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute avatar_id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :avatar_id, String
+
+        # @!attribute name
+        #   New customer-facing name of the custom avatar.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(avatar_id:, name:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AvatarUpdateParams} for more details.
+        #
+        #   @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param name [String] New customer-facing name of the custom avatar.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -78,7 +78,7 @@ module Telnyx
         #   follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
         #   configure a node's tools.
         #
-        #   @return [Array<Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>, nil]
+        #   @return [Array<Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>, nil]
         optional :tools,
                  -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool]] }
 
@@ -132,7 +132,7 @@ module Telnyx
         #
         #   @param shared_tool_ids [Array<String>] IDs of shared (org-level) tools available at this node. Knowledge bases are atta
         #
-        #   @param tools [Array<Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
+        #   @param tools [Array<Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
         #
         #   @param tools_mode [Symbol, Telnyx::Models::AI::FlowNode::ToolsMode] How `shared_tool_ids` combine with the assistant-level tool set. `replace` (defa
         #

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

@@ -51,8 +51,10 @@ module Telnyx
         optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
 
         # @!attribute avatar_settings
-        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #   avatar or an organization-owned custom avatar returned by the Avatars API.
+        #   Discover the available stock catalog with GET /v2/ai/avatars and
+        #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
         #
         #   @return [Telnyx::Models::AI::TelnyxAvatarSettings, nil]
         optional :avatar_settings, -> { Telnyx::AI::TelnyxAvatarSettings }, nil?: true
@@ -234,7 +236,7 @@ module Telnyx
         #   changes. Each tool type except `function`, `webhook`, and `client_side_tool`
         #   allows at most one instance per assistant across both sources.
         #
-        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
+        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -298,7 +300,7 @@ module Telnyx
         #
         #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
         #
-        #   @param avatar_settings [Telnyx::Models::AI::TelnyxAvatarSettings, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+        #   @param avatar_settings [Telnyx::Models::AI::TelnyxAvatarSettings, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
         #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlow] Conversation flow as returned by the API.
         #
@@ -346,7 +348,7 @@ module Telnyx
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
-        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] The assistant's tools. Responses merge the assistant's shared Tools Library tool
+        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] The assistant's tools. Responses merge the assistant's shared Tools Library tool
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -11,11 +11,26 @@ module Telnyx
         #   @return [String, nil]
         optional :insight_group_id, String
 
-        # @!method initialize(insight_group_id: nil)
+        # @!attribute model
+        #   The model that generates the assistant's insights when a conversation ends. It
+        #   runs every insight in the group, Telnyx-managed insights included. Must be
+        #   `zai-org/GLM-5.3-Flash` or `meta-llama/Llama-3.3-70B-Instruct`; any other model
+        #   returns `422`. When omitted on create, it defaults to `zai-org/GLM-5.3-Flash`;
+        #   when omitted on update, the current model is kept. `null` uses Telnyx's default
+        #   insight models, which assistants created before this setting have. Insights of
+        #   messaging conversations, and insights regenerated later, always use Telnyx's
+        #   default insight models.
+        #
+        #   @return [String, nil]
+        optional :model, String, nil?: true
+
+        # @!method initialize(insight_group_id: nil, model: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::InsightSettings} for more details.
         #
         #   @param insight_group_id [String] Reference to an Insight Group. Insights in this group will be run automatically
+        #
+        #   @param model [String, nil] The model that generates the assistant's insights when a conversation ends. It r
       end
     end
   end

data/lib/telnyx/models/ai/memory/namespaces/namespace_settings.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class NamespaceSettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute summary
+            #   Settings that shape this namespace's summaries.
+            #
+            #   @return [Telnyx::Models::AI::Memory::Namespaces::SummarySettings, nil]
+            optional :summary, -> { Telnyx::AI::Memory::Namespaces::SummarySettings }
+
+            # @!method initialize(summary: nil)
+            #   A namespace's settings, grouped by what they affect.
+            #
+            #   @param summary [Telnyx::Models::AI::Memory::Namespaces::SummarySettings] Settings that shape this namespace's summaries.
+          end
+        end
+
+        NamespaceSettings = Namespaces::NamespaceSettings
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/namespace_settings_response.rb

@@ -10,49 +10,11 @@ module Telnyx
             # @!attribute data
             #   A namespace's settings, grouped by what they affect.
             #
-            #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data]
-            required :data, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data }
+            #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettings]
+            required :data, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettings }
 
             # @!method initialize(data:)
-            #   @param data [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data] A namespace's settings, grouped by what they affect.
-
-            # @see Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse#data
-            class Data < Telnyx::Internal::Type::BaseModel
-              # @!attribute summary
-              #   Settings that shape this namespace's summaries.
-              #
-              #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary, nil]
-              optional :summary, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary }
-
-              # @!method initialize(summary: nil)
-              #   A namespace's settings, grouped by what they affect.
-              #
-              #   @param summary [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary] Settings that shape this namespace's summaries.
-
-              # @see Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data#summary
-              class Summary < Telnyx::Internal::Type::BaseModel
-                # @!attribute instructions
-                #   Free-form instructions that influence how this namespace's summaries are
-                #   written, shared by every profile in the namespace. How you use them is up to you
-                #   -- they steer the outcome, so try a phrasing and see how the summary comes out.
-                #   Advisory: they steer the summary but never override or deny a profile's own
-                #   facts, and they do not affect recall. Null or empty means none are set, and
-                #   summaries use the neutral default. A change reaches each summary the next time
-                #   it is regenerated.
-                #
-                #   @return [String, nil]
-                optional :instructions, String, nil?: true
-
-                # @!method initialize(instructions: nil)
-                #   Some parameter documentations has been truncated, see
-                #   {Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary}
-                #   for more details.
-                #
-                #   Settings that shape this namespace's summaries.
-                #
-                #   @param instructions [String, nil] Free-form instructions that influence how this namespace's summaries are written
-              end
-            end
+            #   @param data [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettings] A namespace's settings, grouped by what they affect.
           end
         end
 

data/lib/telnyx/models/ai/memory/namespaces/summary_settings.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class SummarySettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute instructions
+            #   Free-form instructions that influence how this namespace's summaries are
+            #   written, shared by every profile in the namespace. How you use them is up to you
+            #   -- they steer the outcome, so try a phrasing and see how the summary comes out.
+            #   Advisory: they steer the summary but never override or deny a profile's own
+            #   facts, and they do not affect recall. Null or empty means none are set, and
+            #   summaries use the neutral default. A change reaches each summary the next time
+            #   it is regenerated.
+            #
+            #   @return [String, nil]
+            optional :instructions, String, nil?: true
+
+            # @!method initialize(instructions: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Memory::Namespaces::SummarySettings} for more details.
+            #
+            #   A namespace's summary settings, shared by every profile in it.
+            #
+            #   @param instructions [String, nil] Free-form instructions that influence how this namespace's summaries are written
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -32,13 +32,80 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :in_transit_data_locality, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(data_retention: nil, in_transit_data_locality: nil)
+        # @!attribute pii_redaction
+        #   Controls redaction of personally identifiable information (PII) from the
+        #   conversation history that is stored for this assistant. `disabled` (default)
+        #   stores content as-is. `redact` replaces detected PII with `<PII:type/>`
+        #   placeholders (e.g. `<PII:name/>`, `<PII:phone/>`) as the stored copies are
+        #   written: message content (user, assistant, and tool-result messages) and
+        #   tool-call arguments are redacted when written to conversation history, so the
+        #   stored transcript, its read-back via the history API, and any insights generated
+        #   from the stored messages contain the placeholders instead of the PII; response
+        #   bodies returned by webhook tools are redacted too, as stored in the webhook logs
+        #   — a per-conversation record separate from the transcript. In the Mission Control
+        #   Portal this field appears as a "PII Redaction" on/off toggle, where Enabled
+        #   corresponds to `redact`. Redaction runs when the stored copy is written, after
+        #   the LLM has generated its reply: the live conversation is not redacted, the
+        #   assistant's tools keep receiving the full (unredacted) values during the call,
+        #   and the LLM still sees full content in its context window. Call recordings
+        #   (including any recording layout configured under telephony settings) and the
+        #   payloads of messages/webhooks delivered during the call are never redacted by
+        #   this setting. The set of detected PII types (names, street addresses, phone
+        #   numbers, email addresses, government identifiers like SSN and driver's license
+        #   numbers, credit card and bank account numbers, IP addresses, dates of birth, and
+        #   other identifiers unique to a person) is fixed by Telnyx and cannot be
+        #   configured or extended per assistant. Assistants with `redact` cannot be used
+        #   for SMS/WhatsApp messaging (that combination is rejected with a 400 error);
+        #   voice and web chat are unaffected.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::PrivacySettings::PiiRedaction, nil]
+        optional :pii_redaction, enum: -> { Telnyx::AI::PrivacySettings::PiiRedaction }
+
+        # @!method initialize(data_retention: nil, in_transit_data_locality: nil, pii_redaction: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::PrivacySettings} for more details.
         #
         #   @param data_retention [Boolean] If true, conversation history and insights will be stored. If false, they will n
         #
         #   @param in_transit_data_locality [Boolean] Requires every model call made for a web chat turn to be received and served ins
+        #
+        #   @param pii_redaction [Symbol, Telnyx::Models::AI::PrivacySettings::PiiRedaction] Controls redaction of personally identifiable information (PII) from the convers
+
+        # Controls redaction of personally identifiable information (PII) from the
+        # conversation history that is stored for this assistant. `disabled` (default)
+        # stores content as-is. `redact` replaces detected PII with `<PII:type/>`
+        # placeholders (e.g. `<PII:name/>`, `<PII:phone/>`) as the stored copies are
+        # written: message content (user, assistant, and tool-result messages) and
+        # tool-call arguments are redacted when written to conversation history, so the
+        # stored transcript, its read-back via the history API, and any insights generated
+        # from the stored messages contain the placeholders instead of the PII; response
+        # bodies returned by webhook tools are redacted too, as stored in the webhook logs
+        # — a per-conversation record separate from the transcript. In the Mission Control
+        # Portal this field appears as a "PII Redaction" on/off toggle, where Enabled
+        # corresponds to `redact`. Redaction runs when the stored copy is written, after
+        # the LLM has generated its reply: the live conversation is not redacted, the
+        # assistant's tools keep receiving the full (unredacted) values during the call,
+        # and the LLM still sees full content in its context window. Call recordings
+        # (including any recording layout configured under telephony settings) and the
+        # payloads of messages/webhooks delivered during the call are never redacted by
+        # this setting. The set of detected PII types (names, street addresses, phone
+        # numbers, email addresses, government identifiers like SSN and driver's license
+        # numbers, credit card and bank account numbers, IP addresses, dates of birth, and
+        # other identifiers unique to a person) is fixed by Telnyx and cannot be
+        # configured or extended per assistant. Assistants with `redact` cannot be used
+        # for SMS/WhatsApp messaging (that combination is rejected with a 400 error);
+        # voice and web chat are unaffected.
+        #
+        # @see Telnyx::Models::AI::PrivacySettings#pii_redaction
+        module PiiRedaction
+          extend Telnyx::Internal::Type::Enum
+
+          DISABLED = :disabled
+          REDACT = :redact
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

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

@@ -88,9 +88,16 @@ module Telnyx
 
         # @!attribute time_limit_secs
         #   Maximum duration in seconds for the AI assistant to participate on the call.
-        #   When this limit is reached the assistant will be stopped. This limit does not
-        #   apply to portions of a call without an active assistant (for instance, a call
-        #   transferred to a human representative).
+        #   When this limit is reached the assistant will be stopped. Stopping the assistant
+        #   does not itself hang up the call, and what happens next depends on how the
+        #   assistant is running. On Call Control (ai_assistant_start) the call leg stays
+        #   connected and continues to be billed until it is hung up (for example with the
+        #   Hangup call command) or until the call ends for another reason. On TeXML, the
+        #   assistant's `<Connect><AIAssistant>` instruction ends; in the default TeXML
+        #   setup for assistants no instructions follow it, so the call is hung up. Your
+        #   application receives a call.conversation.ended webhook when the assistant stops.
+        #   This limit does not apply to portions of a call without an active assistant (for
+        #   instance, a call transferred to a human representative).
         #
         #   @return [Integer, nil]
         optional :time_limit_secs, Integer
@@ -105,9 +112,16 @@ module Telnyx
 
         # @!attribute user_idle_timeout_secs
         #   Maximum duration in seconds of end user silence on the call. When this limit is
-        #   reached the assistant will be stopped. This limit does not apply to portions of
-        #   a call without an active assistant (for instance, a call transferred to a human
-        #   representative).
+        #   reached the assistant will be stopped. Stopping the assistant does not itself
+        #   hang up the call, and what happens next depends on how the assistant is running.
+        #   On Call Control (ai_assistant_start) the call leg stays connected and continues
+        #   to be billed until it is hung up (for example with the Hangup call command) or
+        #   until the call ends for another reason. On TeXML, the assistant's
+        #   `<Connect><AIAssistant>` instruction ends; in the default TeXML setup for
+        #   assistants no instructions follow it, so the call is hung up. Your application
+        #   receives a call.conversation.ended webhook when the assistant stops. This limit
+        #   does not apply to portions of a call without an active assistant (for instance,
+        #   a call transferred to a human representative).
         #
         #   @return [Integer, nil]
         optional :user_idle_timeout_secs, Integer

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

@@ -5,10 +5,10 @@ module Telnyx
     module AI
       class TelnyxAvatarSettings < Telnyx::Internal::Type::BaseModel
         # @!attribute avatar_id
-        #   The Telnyx avatar to render.
+        #   The Telnyx stock avatar or organization-owned custom avatar to render.
         #
-        #   @return [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::AvatarID]
-        required :avatar_id, enum: -> { Telnyx::AI::TelnyxAvatarSettings::AvatarID }
+        #   @return [String]
+        required :avatar_id, String
 
         # @!attribute background_id
         #   The background to render.
@@ -33,10 +33,12 @@ module Telnyx
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::TelnyxAvatarSettings} for more details.
         #
-        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #   avatar or an organization-owned custom avatar returned by the Avatars API.
+        #   Discover the available stock catalog with GET /v2/ai/avatars and
+        #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
         #
-        #   @param avatar_id [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::AvatarID] The Telnyx avatar to render.
+        #   @param avatar_id [String] The Telnyx stock avatar or organization-owned custom avatar to render.
         #
         #   @param background_id [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::BackgroundID] The background to render.
         #
@@ -44,23 +46,6 @@ module Telnyx
         #
         #   @param provider [Symbol, :telnyx] Selects the Telnyx open-source avatar provider.
 
-        # The Telnyx avatar to render.
-        #
-        # @see Telnyx::Models::AI::TelnyxAvatarSettings#avatar_id
-        module AvatarID
-          extend Telnyx::Internal::Type::Enum
-
-          ELENA = :elena
-          BEN = :ben
-          JORDAN = :jordan
-          LIN = :lin
-          AVERY = :avery
-          RAPHAEL = :raphael
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
         # The background to render.
         #
         # @see Telnyx::Models::AI::TelnyxAvatarSettings#background_id
@@ -70,6 +55,7 @@ module Telnyx
           OFFICE = :office
           STUDIO = :studio
           RECEPTION = :reception
+          ILLUSTRATED_WORKSPACE = :illustrated_workspace
 
           # @!method self.values
           #   @return [Array<Symbol>]