telnyx 5.160.0 → 5.161.0

data/lib/telnyx/models/transcript_completed_webhook_event.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class TranscriptCompletedWebhookEvent < Telnyx::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique event id; deduplicate deliveries on it.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute data
+      #   Finalized transcript details.
+      #
+      #   @return [Telnyx::Models::TranscriptCompletedWebhookEvent::Data]
+      required :data, -> { Telnyx::TranscriptCompletedWebhookEvent::Data }
+
+      # @!attribute event
+      #   Event type.
+      #
+      #   @return [Symbol, Telnyx::Models::TranscriptCompletedWebhookEvent::Event]
+      required :event, enum: -> { Telnyx::TranscriptCompletedWebhookEvent::Event }
+
+      # @!attribute occurred_at
+      #   When the event occurred.
+      #
+      #   @return [Time]
+      required :occurred_at, Time
+
+      # @!attribute version
+      #   Envelope version.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(id:, data:, event:, occurred_at:, version:)
+      #   @param id [String] Unique event id; deduplicate deliveries on it.
+      #
+      #   @param data [Telnyx::Models::TranscriptCompletedWebhookEvent::Data] Finalized transcript details.
+      #
+      #   @param event [Symbol, Telnyx::Models::TranscriptCompletedWebhookEvent::Event] Event type.
+      #
+      #   @param occurred_at [Time] When the event occurred.
+      #
+      #   @param version [String] Envelope version.
+
+      # @see Telnyx::Models::TranscriptCompletedWebhookEvent#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute ended_at
+        #   Session end time, or null when unavailable.
+        #
+        #   @return [Time, nil]
+        required :ended_at, Time, nil?: true
+
+        # @!attribute last_seq
+        #   Last transcript segment sequence number, or null for an empty transcript.
+        #
+        #   @return [Integer, nil]
+        required :last_seq, Integer, nil?: true
+
+        # @!attribute segment_count
+        #   Number of transcript segments observed during finalization.
+        #
+        #   @return [Integer]
+        required :segment_count, Integer
+
+        # @!attribute session_id
+        #   The meeting session this event belongs to.
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!method initialize(ended_at:, last_seq:, segment_count:, session_id:)
+        #   Finalized transcript details.
+        #
+        #   @param ended_at [Time, nil] Session end time, or null when unavailable.
+        #
+        #   @param last_seq [Integer, nil] Last transcript segment sequence number, or null for an empty transcript.
+        #
+        #   @param segment_count [Integer] Number of transcript segments observed during finalization.
+        #
+        #   @param session_id [String] The meeting session this event belongs to.
+      end
+
+      # Event type.
+      #
+      # @see Telnyx::Models::TranscriptCompletedWebhookEvent#event
+      module Event
+        extend Telnyx::Internal::Type::Enum
+
+        TRANSCRIPT_COMPLETED = :"transcript.completed"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/unsafe_unwrap_webhook_event.rb

@@ -11,6 +11,10 @@ module Telnyx
 
       variant -> { Telnyx::CallAIGatherPartialResultsWebhookEvent }
 
+      variant -> { Telnyx::ArtifactCompletedWebhookEvent }
+
+      variant -> { Telnyx::ArtifactFailedWebhookEvent }
+
       variant -> { Telnyx::CallAnsweredWebhookEvent }
 
       variant -> { Telnyx::CallBridgedWebhookEvent }
@@ -137,12 +141,18 @@ module Telnyx
 
       variant -> { Telnyx::NumberOrderStatusUpdateWebhookEvent }
 
+      variant -> { Telnyx::RecordingAvailableWebhookEvent }
+
       variant -> { Telnyx::ReplacedLinkClickWebhookEvent }
 
+      variant -> { Telnyx::SessionStatusChangedWebhookEvent }
+
+      variant -> { Telnyx::TranscriptCompletedWebhookEvent }
+
       variant -> { Telnyx::TranscriptionWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Telnyx::Models::CallAIGatherEndedWebhookEvent, Telnyx::Models::CallAIGatherMessageHistoryUpdatedWebhookEvent, Telnyx::Models::CallAIGatherPartialResultsWebhookEvent, Telnyx::Models::CallAnsweredWebhookEvent, Telnyx::Models::CallBridgedWebhookEvent, Telnyx::Models::CallConversationEndedWebhookEvent, Telnyx::Models::CallConversationInsightsGeneratedWebhookEvent, Telnyx::Models::CallCostWebhookEvent, Telnyx::Models::CallDeepfakeDetectionErrorWebhookEvent, Telnyx::Models::CallDeepfakeDetectionResultWebhookEvent, Telnyx::Models::CallDtmfReceivedWebhookEvent, Telnyx::Models::CallEnqueuedWebhookEvent, Telnyx::Models::CallForkStartedWebhookEvent, Telnyx::Models::CallForkStoppedWebhookEvent, Telnyx::Models::CallGatherEndedWebhookEvent, Telnyx::Models::CallHangupWebhookEvent, Telnyx::Models::CallHoldWebhookEvent, Telnyx::Models::CallInitiatedWebhookEvent, Telnyx::Models::CallLeftQueueWebhookEvent, Telnyx::Models::CallMachineDetectionEndedWebhookEvent, Telnyx::Models::CallMachineGreetingEndedWebhookEvent, Telnyx::Models::CallMachinePremiumDetectionEndedWebhookEvent, Telnyx::Models::CallMachinePremiumGreetingEndedWebhookEvent, Telnyx::Models::CallPaymentCompletedWebhookEvent, Telnyx::Models::CallPaymentProgressWebhookEvent, Telnyx::Models::CallPlaybackEndedWebhookEvent, Telnyx::Models::CallPlaybackStartedWebhookEvent, Telnyx::Models::CallRecordingErrorWebhookEvent, Telnyx::Models::CallRecordingSavedWebhookEvent, Telnyx::Models::CallRecordingTranscriptionSavedWebhookEvent, Telnyx::Models::CallReferCompletedWebhookEvent, Telnyx::Models::CallReferFailedWebhookEvent, Telnyx::Models::CallReferStartedWebhookEvent, Telnyx::Models::CallSiprecFailedWebhookEvent, Telnyx::Models::CallSiprecStartedWebhookEvent, Telnyx::Models::CallSiprecStoppedWebhookEvent, Telnyx::Models::CallSpeakEndedWebhookEvent, Telnyx::Models::CallSpeakStartedWebhookEvent, Telnyx::Models::CallStreamingFailedWebhookEvent, Telnyx::Models::CallStreamingStartedWebhookEvent, Telnyx::Models::CallStreamingStoppedWebhookEvent, Telnyx::Models::CallUnholdWebhookEvent, Telnyx::Models::CampaignStatusUpdate, Telnyx::Models::ConferenceCreatedWebhookEvent, Telnyx::Models::ConferenceEndedWebhookEvent, Telnyx::Models::ConferenceFloorChanged, Telnyx::Models::ConferenceParticipantJoinedWebhookEvent, Telnyx::Models::ConferenceParticipantLeftWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackEndedWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackStartedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakEndedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakStartedWebhookEvent, Telnyx::Models::ConferencePlaybackEndedWebhookEvent, Telnyx::Models::ConferencePlaybackStartedWebhookEvent, Telnyx::Models::ConferenceRecordingSavedWebhookEvent, Telnyx::Models::ConferenceSpeakEndedWebhookEvent, Telnyx::Models::ConferenceSpeakStartedWebhookEvent, Telnyx::Models::DeliveryUpdateWebhookEvent, Telnyx::Models::FaxDelivered, Telnyx::Models::FaxFailed, Telnyx::Models::FaxMediaProcessed, Telnyx::Models::FaxQueued, Telnyx::Models::FaxSendingStarted, Telnyx::Models::HostedNumberOrderEventWebhookEvent, Telnyx::Models::InboundMessageWebhookEvent, Telnyx::Models::NumberOrderStatusUpdateWebhookEvent, Telnyx::Models::ReplacedLinkClickWebhookEvent, Telnyx::Models::TranscriptionWebhookEvent)]
+      #   @return [Array(Telnyx::Models::CallAIGatherEndedWebhookEvent, Telnyx::Models::CallAIGatherMessageHistoryUpdatedWebhookEvent, Telnyx::Models::CallAIGatherPartialResultsWebhookEvent, Telnyx::Models::ArtifactCompletedWebhookEvent, Telnyx::Models::ArtifactFailedWebhookEvent, Telnyx::Models::CallAnsweredWebhookEvent, Telnyx::Models::CallBridgedWebhookEvent, Telnyx::Models::CallConversationEndedWebhookEvent, Telnyx::Models::CallConversationInsightsGeneratedWebhookEvent, Telnyx::Models::CallCostWebhookEvent, Telnyx::Models::CallDeepfakeDetectionErrorWebhookEvent, Telnyx::Models::CallDeepfakeDetectionResultWebhookEvent, Telnyx::Models::CallDtmfReceivedWebhookEvent, Telnyx::Models::CallEnqueuedWebhookEvent, Telnyx::Models::CallForkStartedWebhookEvent, Telnyx::Models::CallForkStoppedWebhookEvent, Telnyx::Models::CallGatherEndedWebhookEvent, Telnyx::Models::CallHangupWebhookEvent, Telnyx::Models::CallHoldWebhookEvent, Telnyx::Models::CallInitiatedWebhookEvent, Telnyx::Models::CallLeftQueueWebhookEvent, Telnyx::Models::CallMachineDetectionEndedWebhookEvent, Telnyx::Models::CallMachineGreetingEndedWebhookEvent, Telnyx::Models::CallMachinePremiumDetectionEndedWebhookEvent, Telnyx::Models::CallMachinePremiumGreetingEndedWebhookEvent, Telnyx::Models::CallPaymentCompletedWebhookEvent, Telnyx::Models::CallPaymentProgressWebhookEvent, Telnyx::Models::CallPlaybackEndedWebhookEvent, Telnyx::Models::CallPlaybackStartedWebhookEvent, Telnyx::Models::CallRecordingErrorWebhookEvent, Telnyx::Models::CallRecordingSavedWebhookEvent, Telnyx::Models::CallRecordingTranscriptionSavedWebhookEvent, Telnyx::Models::CallReferCompletedWebhookEvent, Telnyx::Models::CallReferFailedWebhookEvent, Telnyx::Models::CallReferStartedWebhookEvent, Telnyx::Models::CallSiprecFailedWebhookEvent, Telnyx::Models::CallSiprecStartedWebhookEvent, Telnyx::Models::CallSiprecStoppedWebhookEvent, Telnyx::Models::CallSpeakEndedWebhookEvent, Telnyx::Models::CallSpeakStartedWebhookEvent, Telnyx::Models::CallStreamingFailedWebhookEvent, Telnyx::Models::CallStreamingStartedWebhookEvent, Telnyx::Models::CallStreamingStoppedWebhookEvent, Telnyx::Models::CallUnholdWebhookEvent, Telnyx::Models::CampaignStatusUpdate, Telnyx::Models::ConferenceCreatedWebhookEvent, Telnyx::Models::ConferenceEndedWebhookEvent, Telnyx::Models::ConferenceFloorChanged, Telnyx::Models::ConferenceParticipantJoinedWebhookEvent, Telnyx::Models::ConferenceParticipantLeftWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackEndedWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackStartedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakEndedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakStartedWebhookEvent, Telnyx::Models::ConferencePlaybackEndedWebhookEvent, Telnyx::Models::ConferencePlaybackStartedWebhookEvent, Telnyx::Models::ConferenceRecordingSavedWebhookEvent, Telnyx::Models::ConferenceSpeakEndedWebhookEvent, Telnyx::Models::ConferenceSpeakStartedWebhookEvent, Telnyx::Models::DeliveryUpdateWebhookEvent, Telnyx::Models::FaxDelivered, Telnyx::Models::FaxFailed, Telnyx::Models::FaxMediaProcessed, Telnyx::Models::FaxQueued, Telnyx::Models::FaxSendingStarted, Telnyx::Models::HostedNumberOrderEventWebhookEvent, Telnyx::Models::InboundMessageWebhookEvent, Telnyx::Models::NumberOrderStatusUpdateWebhookEvent, Telnyx::Models::RecordingAvailableWebhookEvent, Telnyx::Models::ReplacedLinkClickWebhookEvent, Telnyx::Models::SessionStatusChangedWebhookEvent, Telnyx::Models::TranscriptCompletedWebhookEvent, Telnyx::Models::TranscriptionWebhookEvent)]
     end
   end
 end

data/lib/telnyx/models/unwrap_webhook_event.rb

@@ -11,6 +11,10 @@ module Telnyx
 
       variant -> { Telnyx::CallAIGatherPartialResultsWebhookEvent }
 
+      variant -> { Telnyx::ArtifactCompletedWebhookEvent }
+
+      variant -> { Telnyx::ArtifactFailedWebhookEvent }
+
       variant -> { Telnyx::CallAnsweredWebhookEvent }
 
       variant -> { Telnyx::CallBridgedWebhookEvent }
@@ -137,12 +141,18 @@ module Telnyx
 
       variant -> { Telnyx::NumberOrderStatusUpdateWebhookEvent }
 
+      variant -> { Telnyx::RecordingAvailableWebhookEvent }
+
       variant -> { Telnyx::ReplacedLinkClickWebhookEvent }
 
+      variant -> { Telnyx::SessionStatusChangedWebhookEvent }
+
+      variant -> { Telnyx::TranscriptCompletedWebhookEvent }
+
       variant -> { Telnyx::TranscriptionWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Telnyx::Models::CallAIGatherEndedWebhookEvent, Telnyx::Models::CallAIGatherMessageHistoryUpdatedWebhookEvent, Telnyx::Models::CallAIGatherPartialResultsWebhookEvent, Telnyx::Models::CallAnsweredWebhookEvent, Telnyx::Models::CallBridgedWebhookEvent, Telnyx::Models::CallConversationEndedWebhookEvent, Telnyx::Models::CallConversationInsightsGeneratedWebhookEvent, Telnyx::Models::CallCostWebhookEvent, Telnyx::Models::CallDeepfakeDetectionErrorWebhookEvent, Telnyx::Models::CallDeepfakeDetectionResultWebhookEvent, Telnyx::Models::CallDtmfReceivedWebhookEvent, Telnyx::Models::CallEnqueuedWebhookEvent, Telnyx::Models::CallForkStartedWebhookEvent, Telnyx::Models::CallForkStoppedWebhookEvent, Telnyx::Models::CallGatherEndedWebhookEvent, Telnyx::Models::CallHangupWebhookEvent, Telnyx::Models::CallHoldWebhookEvent, Telnyx::Models::CallInitiatedWebhookEvent, Telnyx::Models::CallLeftQueueWebhookEvent, Telnyx::Models::CallMachineDetectionEndedWebhookEvent, Telnyx::Models::CallMachineGreetingEndedWebhookEvent, Telnyx::Models::CallMachinePremiumDetectionEndedWebhookEvent, Telnyx::Models::CallMachinePremiumGreetingEndedWebhookEvent, Telnyx::Models::CallPaymentCompletedWebhookEvent, Telnyx::Models::CallPaymentProgressWebhookEvent, Telnyx::Models::CallPlaybackEndedWebhookEvent, Telnyx::Models::CallPlaybackStartedWebhookEvent, Telnyx::Models::CallRecordingErrorWebhookEvent, Telnyx::Models::CallRecordingSavedWebhookEvent, Telnyx::Models::CallRecordingTranscriptionSavedWebhookEvent, Telnyx::Models::CallReferCompletedWebhookEvent, Telnyx::Models::CallReferFailedWebhookEvent, Telnyx::Models::CallReferStartedWebhookEvent, Telnyx::Models::CallSiprecFailedWebhookEvent, Telnyx::Models::CallSiprecStartedWebhookEvent, Telnyx::Models::CallSiprecStoppedWebhookEvent, Telnyx::Models::CallSpeakEndedWebhookEvent, Telnyx::Models::CallSpeakStartedWebhookEvent, Telnyx::Models::CallStreamingFailedWebhookEvent, Telnyx::Models::CallStreamingStartedWebhookEvent, Telnyx::Models::CallStreamingStoppedWebhookEvent, Telnyx::Models::CallUnholdWebhookEvent, Telnyx::Models::CampaignStatusUpdate, Telnyx::Models::ConferenceCreatedWebhookEvent, Telnyx::Models::ConferenceEndedWebhookEvent, Telnyx::Models::ConferenceFloorChanged, Telnyx::Models::ConferenceParticipantJoinedWebhookEvent, Telnyx::Models::ConferenceParticipantLeftWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackEndedWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackStartedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakEndedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakStartedWebhookEvent, Telnyx::Models::ConferencePlaybackEndedWebhookEvent, Telnyx::Models::ConferencePlaybackStartedWebhookEvent, Telnyx::Models::ConferenceRecordingSavedWebhookEvent, Telnyx::Models::ConferenceSpeakEndedWebhookEvent, Telnyx::Models::ConferenceSpeakStartedWebhookEvent, Telnyx::Models::DeliveryUpdateWebhookEvent, Telnyx::Models::FaxDelivered, Telnyx::Models::FaxFailed, Telnyx::Models::FaxMediaProcessed, Telnyx::Models::FaxQueued, Telnyx::Models::FaxSendingStarted, Telnyx::Models::HostedNumberOrderEventWebhookEvent, Telnyx::Models::InboundMessageWebhookEvent, Telnyx::Models::NumberOrderStatusUpdateWebhookEvent, Telnyx::Models::ReplacedLinkClickWebhookEvent, Telnyx::Models::TranscriptionWebhookEvent)]
+      #   @return [Array(Telnyx::Models::CallAIGatherEndedWebhookEvent, Telnyx::Models::CallAIGatherMessageHistoryUpdatedWebhookEvent, Telnyx::Models::CallAIGatherPartialResultsWebhookEvent, Telnyx::Models::ArtifactCompletedWebhookEvent, Telnyx::Models::ArtifactFailedWebhookEvent, Telnyx::Models::CallAnsweredWebhookEvent, Telnyx::Models::CallBridgedWebhookEvent, Telnyx::Models::CallConversationEndedWebhookEvent, Telnyx::Models::CallConversationInsightsGeneratedWebhookEvent, Telnyx::Models::CallCostWebhookEvent, Telnyx::Models::CallDeepfakeDetectionErrorWebhookEvent, Telnyx::Models::CallDeepfakeDetectionResultWebhookEvent, Telnyx::Models::CallDtmfReceivedWebhookEvent, Telnyx::Models::CallEnqueuedWebhookEvent, Telnyx::Models::CallForkStartedWebhookEvent, Telnyx::Models::CallForkStoppedWebhookEvent, Telnyx::Models::CallGatherEndedWebhookEvent, Telnyx::Models::CallHangupWebhookEvent, Telnyx::Models::CallHoldWebhookEvent, Telnyx::Models::CallInitiatedWebhookEvent, Telnyx::Models::CallLeftQueueWebhookEvent, Telnyx::Models::CallMachineDetectionEndedWebhookEvent, Telnyx::Models::CallMachineGreetingEndedWebhookEvent, Telnyx::Models::CallMachinePremiumDetectionEndedWebhookEvent, Telnyx::Models::CallMachinePremiumGreetingEndedWebhookEvent, Telnyx::Models::CallPaymentCompletedWebhookEvent, Telnyx::Models::CallPaymentProgressWebhookEvent, Telnyx::Models::CallPlaybackEndedWebhookEvent, Telnyx::Models::CallPlaybackStartedWebhookEvent, Telnyx::Models::CallRecordingErrorWebhookEvent, Telnyx::Models::CallRecordingSavedWebhookEvent, Telnyx::Models::CallRecordingTranscriptionSavedWebhookEvent, Telnyx::Models::CallReferCompletedWebhookEvent, Telnyx::Models::CallReferFailedWebhookEvent, Telnyx::Models::CallReferStartedWebhookEvent, Telnyx::Models::CallSiprecFailedWebhookEvent, Telnyx::Models::CallSiprecStartedWebhookEvent, Telnyx::Models::CallSiprecStoppedWebhookEvent, Telnyx::Models::CallSpeakEndedWebhookEvent, Telnyx::Models::CallSpeakStartedWebhookEvent, Telnyx::Models::CallStreamingFailedWebhookEvent, Telnyx::Models::CallStreamingStartedWebhookEvent, Telnyx::Models::CallStreamingStoppedWebhookEvent, Telnyx::Models::CallUnholdWebhookEvent, Telnyx::Models::CampaignStatusUpdate, Telnyx::Models::ConferenceCreatedWebhookEvent, Telnyx::Models::ConferenceEndedWebhookEvent, Telnyx::Models::ConferenceFloorChanged, Telnyx::Models::ConferenceParticipantJoinedWebhookEvent, Telnyx::Models::ConferenceParticipantLeftWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackEndedWebhookEvent, Telnyx::Models::ConferenceParticipantPlaybackStartedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakEndedWebhookEvent, Telnyx::Models::ConferenceParticipantSpeakStartedWebhookEvent, Telnyx::Models::ConferencePlaybackEndedWebhookEvent, Telnyx::Models::ConferencePlaybackStartedWebhookEvent, Telnyx::Models::ConferenceRecordingSavedWebhookEvent, Telnyx::Models::ConferenceSpeakEndedWebhookEvent, Telnyx::Models::ConferenceSpeakStartedWebhookEvent, Telnyx::Models::DeliveryUpdateWebhookEvent, Telnyx::Models::FaxDelivered, Telnyx::Models::FaxFailed, Telnyx::Models::FaxMediaProcessed, Telnyx::Models::FaxQueued, Telnyx::Models::FaxSendingStarted, Telnyx::Models::HostedNumberOrderEventWebhookEvent, Telnyx::Models::InboundMessageWebhookEvent, Telnyx::Models::NumberOrderStatusUpdateWebhookEvent, Telnyx::Models::RecordingAvailableWebhookEvent, Telnyx::Models::ReplacedLinkClickWebhookEvent, Telnyx::Models::SessionStatusChangedWebhookEvent, Telnyx::Models::TranscriptCompletedWebhookEvent, Telnyx::Models::TranscriptionWebhookEvent)]
     end
   end
 end

data/lib/telnyx/models/web_search/research_citation.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module WebSearch
+      class ResearchCitation < Telnyx::Internal::Type::BaseModel
+        # @!attribute title
+        #   Title of the source page.
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!attribute url
+        #   Source URL.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute snippet
+        #   Relevant excerpt from the source (if available).
+        #
+        #   @return [String, nil]
+        optional :snippet, String
+
+        # @!method initialize(title:, url:, snippet: nil)
+        #   @param title [String] Title of the source page.
+        #
+        #   @param url [String] Source URL.
+        #
+        #   @param snippet [String] Relevant excerpt from the source (if available).
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search/research_create_params.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module WebSearch
+      # @see Telnyx::Resources::WebSearch::Research#create
+      class ResearchCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute query
+        #   The research question or topic.
+        #
+        #   @return [String]
+        required :query, String
+
+        # @!attribute background
+        #   When `true`, the research runs asynchronously. The response returns a `task_id`
+        #   immediately instead of waiting for the result. Poll
+        #   `GET /web_search/research/{task_id}` to check status.
+        #
+        #   @return [Boolean, nil]
+        optional :background, Telnyx::Internal::Type::Boolean
+
+        # @!attribute max_sources
+        #   Maximum number of sources to use.
+        #
+        #   @return [Integer, nil]
+        optional :max_sources, Integer
+
+        # @!attribute research_effort
+        #   Research depth level. `lite` is fastest, `deep` is most thorough.
+        #
+        #   @return [Symbol, Telnyx::Models::WebSearch::ResearchCreateParams::ResearchEffort, nil]
+        optional :research_effort, enum: -> { Telnyx::WebSearch::ResearchCreateParams::ResearchEffort }
+
+        # @!method initialize(query:, background: nil, max_sources: nil, research_effort: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::WebSearch::ResearchCreateParams} for more details.
+        #
+        #   @param query [String] The research question or topic.
+        #
+        #   @param background [Boolean] When `true`, the research runs asynchronously. The response returns a `task_id`
+        #
+        #   @param max_sources [Integer] Maximum number of sources to use.
+        #
+        #   @param research_effort [Symbol, Telnyx::Models::WebSearch::ResearchCreateParams::ResearchEffort] Research depth level. `lite` is fastest, `deep` is most thorough.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # Research depth level. `lite` is fastest, `deep` is most thorough.
+        module ResearchEffort
+          extend Telnyx::Internal::Type::Enum
+
+          LITE = :lite
+          STANDARD = :standard
+          DEEP = :deep
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search/research_create_response.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module WebSearch
+      # @see Telnyx::Resources::WebSearch::Research#create
+      class ResearchCreateResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   Synchronous research response (when `background` is false or unset).
+        #
+        #   @return [Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseSync, Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync, nil]
+        optional :data, union: -> { Telnyx::Models::WebSearch::ResearchCreateResponse::Data }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseSync, Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync] Synchronous research response (when `background` is false or unset).
+
+        # Synchronous research response (when `background` is false or unset).
+        #
+        # @see Telnyx::Models::WebSearch::ResearchCreateResponse#data
+        module Data
+          extend Telnyx::Internal::Type::Union
+
+          # Synchronous research response (when `background` is false or unset).
+          variant -> { Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseSync }
+
+          # Asynchronous research response (when `background` is true).
+          variant -> { Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync }
+
+          class ResearchResponseSync < Telnyx::Internal::Type::BaseModel
+            # @!attribute answer
+            #   The synthesized research answer.
+            #
+            #   @return [String]
+            required :answer, String
+
+            # @!attribute citations
+            #   Sources cited in the answer.
+            #
+            #   @return [Array<Telnyx::Models::WebSearch::ResearchCitation>, nil]
+            optional :citations, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::WebSearch::ResearchCitation] }
+
+            # @!method initialize(answer:, citations: nil)
+            #   Synchronous research response (when `background` is false or unset).
+            #
+            #   @param answer [String] The synthesized research answer.
+            #
+            #   @param citations [Array<Telnyx::Models::WebSearch::ResearchCitation>] Sources cited in the answer.
+          end
+
+          class ResearchResponseAsync < Telnyx::Internal::Type::BaseModel
+            # @!attribute status
+            #   Current status of the research task.
+            #
+            #   @return [Symbol, Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync::Status]
+            required :status,
+                     enum: -> { Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync::Status }
+
+            # @!attribute task_id
+            #   Unique identifier for the research task. Use this to poll the status.
+            #
+            #   @return [String]
+            required :task_id, String
+
+            # @!method initialize(status:, task_id:)
+            #   Asynchronous research response (when `background` is true).
+            #
+            #   @param status [Symbol, Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync::Status] Current status of the research task.
+            #
+            #   @param task_id [String] Unique identifier for the research task. Use this to poll the status.
+
+            # Current status of the research task.
+            #
+            # @see Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync#status
+            module Status
+              extend Telnyx::Internal::Type::Enum
+
+              PENDING = :pending
+              RUNNING = :running
+              COMPLETED = :completed
+              FAILED = :failed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseSync, Telnyx::Models::WebSearch::ResearchCreateResponse::Data::ResearchResponseAsync)]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search/research_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module WebSearch
+      # @see Telnyx::Resources::WebSearch::Research#retrieve
+      class ResearchRetrieveParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute task_id
+        #
+        #   @return [String]
+        required :task_id, String
+
+        # @!method initialize(task_id:, request_options: {})
+        #   @param task_id [String]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search/research_retrieve_response.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module WebSearch
+      # @see Telnyx::Resources::WebSearch::Research#retrieve
+      class ResearchRetrieveResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data, nil]
+        optional :data, -> { Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data]
+
+        # @see Telnyx::Models::WebSearch::ResearchRetrieveResponse#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute status
+          #   Current status of the research task.
+          #
+          #   @return [Symbol, Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data::Status]
+          required :status, enum: -> { Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data::Status }
+
+          # @!attribute task_id
+          #   The research task identifier.
+          #
+          #   @return [String]
+          required :task_id, String
+
+          # @!attribute answer
+          #   The synthesized research answer (present when status is `completed`).
+          #
+          #   @return [String, nil]
+          optional :answer, String
+
+          # @!attribute citations
+          #   Sources cited in the answer (present when status is `completed`).
+          #
+          #   @return [Array<Telnyx::Models::WebSearch::ResearchCitation>, nil]
+          optional :citations, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::WebSearch::ResearchCitation] }
+
+          # @!attribute error
+          #   Always present in poll responses; `null` unless the task failed.
+          #
+          #   @return [String, nil]
+          optional :error, String, nil?: true
+
+          # @!method initialize(status:, task_id:, answer: nil, citations: nil, error: nil)
+          #   @param status [Symbol, Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data::Status] Current status of the research task.
+          #
+          #   @param task_id [String] The research task identifier.
+          #
+          #   @param answer [String] The synthesized research answer (present when status is `completed`).
+          #
+          #   @param citations [Array<Telnyx::Models::WebSearch::ResearchCitation>] Sources cited in the answer (present when status is `completed`).
+          #
+          #   @param error [String, nil] Always present in poll responses; `null` unless the task failed.
+
+          # Current status of the research task.
+          #
+          # @see Telnyx::Models::WebSearch::ResearchRetrieveResponse::Data#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            PENDING = :pending
+            RUNNING = :running
+            COMPLETED = :completed
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search_contents_params.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::WebSearch#contents
+    class WebSearchContentsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute urls
+      #   List of URLs to retrieve content from (max 20 for public API).
+      #
+      #   @return [Array<String>]
+      required :urls, Telnyx::Internal::Type::ArrayOf[String]
+
+      # @!attribute crawl_timeout
+      #   Timeout for crawling each URL, in seconds (1-60).
+      #
+      #   @return [Integer, nil]
+      optional :crawl_timeout, Integer
+
+      # @!attribute formats
+      #   Content formats to return. If omitted, `html` and `metadata` are returned by
+      #   default. Retrieval is best-effort per URL: a format field appears only when that
+      #   content could be produced, and a freshly crawled page may also include `html`
+      #   even when not requested.
+      #
+      #   @return [Array<Symbol, Telnyx::Models::WebSearchContentsParams::Format>, nil]
+      optional :formats, -> { Telnyx::Internal::Type::ArrayOf[enum: Telnyx::WebSearchContentsParams::Format] }
+
+      # @!attribute max_age
+      #   Maximum age of cached content in seconds. `null` means no limit.
+      #
+      #   @return [Integer, nil]
+      optional :max_age, Integer, nil?: true
+
+      # @!method initialize(urls:, crawl_timeout: nil, formats: nil, max_age: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::WebSearchContentsParams} for more details.
+      #
+      #   @param urls [Array<String>] List of URLs to retrieve content from (max 20 for public API).
+      #
+      #   @param crawl_timeout [Integer] Timeout for crawling each URL, in seconds (1-60).
+      #
+      #   @param formats [Array<Symbol, Telnyx::Models::WebSearchContentsParams::Format>] Content formats to return. If omitted, `html` and `metadata` are returned by def
+      #
+      #   @param max_age [Integer, nil] Maximum age of cached content in seconds. `null` means no limit.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      module Format
+        extend Telnyx::Internal::Type::Enum
+
+        HTML = :html
+        MARKDOWN = :markdown
+        METADATA = :metadata
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/web_search_contents_response.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::WebSearch#contents
+    class WebSearchContentsResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::WebSearchContentsResponse::Data, nil]
+      optional :data, -> { Telnyx::Models::WebSearchContentsResponse::Data }
+
+      # @!method initialize(data: nil)
+      #   @param data [Telnyx::Models::WebSearchContentsResponse::Data]
+
+      # @see Telnyx::Models::WebSearchContentsResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute results
+        #
+        #   @return [Array<Telnyx::Models::WebSearchContentsResponse::Data::Result>, nil]
+        optional :results,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::WebSearchContentsResponse::Data::Result] }
+
+        # @!method initialize(results: nil)
+        #   @param results [Array<Telnyx::Models::WebSearchContentsResponse::Data::Result>]
+
+        class Result < Telnyx::Internal::Type::BaseModel
+          # @!attribute url
+          #   The source URL.
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!attribute html
+          #   Cleaned HTML content (if `html` format requested; may also be present on freshly
+          #   crawled pages).
+          #
+          #   @return [String, nil]
+          optional :html, String
+
+          # @!attribute markdown
+          #   Markdown content (if `markdown` format requested).
+          #
+          #   @return [String, nil]
+          optional :markdown, String
+
+          # @!attribute metadata
+          #   Page metadata (if `metadata` format requested).
+          #
+          #   @return [Telnyx::Models::WebSearchContentsResponse::Data::Result::Metadata, nil]
+          optional :metadata, -> { Telnyx::Models::WebSearchContentsResponse::Data::Result::Metadata }
+
+          # @!attribute title
+          #   Page title (if available).
+          #
+          #   @return [String, nil]
+          optional :title, String
+
+          # @!method initialize(url:, html: nil, markdown: nil, metadata: nil, title: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::WebSearchContentsResponse::Data::Result} for more details.
+          #
+          #   @param url [String] The source URL.
+          #
+          #   @param html [String] Cleaned HTML content (if `html` format requested; may also be present on freshly
+          #
+          #   @param markdown [String] Markdown content (if `markdown` format requested).
+          #
+          #   @param metadata [Telnyx::Models::WebSearchContentsResponse::Data::Result::Metadata] Page metadata (if `metadata` format requested).
+          #
+          #   @param title [String] Page title (if available).
+
+          # @see Telnyx::Models::WebSearchContentsResponse::Data::Result#metadata
+          class Metadata < Telnyx::Internal::Type::BaseModel
+            # @!attribute favicon_url
+            #   Favicon URL (if available).
+            #
+            #   @return [String, nil]
+            optional :favicon_url, String
+
+            # @!attribute site_name
+            #   Site name. Often empty.
+            #
+            #   @return [String, nil]
+            optional :site_name, String
+
+            # @!method initialize(favicon_url: nil, site_name: nil)
+            #   Page metadata (if `metadata` format requested).
+            #
+            #   @param favicon_url [String] Favicon URL (if available).
+            #
+            #   @param site_name [String] Site name. Often empty.
+          end
+        end
+      end
+    end
+  end
+end