telnyx 5.160.0 → 5.161.0

data/lib/telnyx/resources/web_search/research.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class WebSearch
+      # Deep research with citations and async task polling.
+      class Research
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::WebSearch::ResearchCreateParams} for more details.
+        #
+        # Starts a deep research task that runs multiple searches, reads sources, and
+        # synthesizes an answer with citations.
+        #
+        # ## Synchronous mode (default)
+        #
+        # When `background` is `false` or omitted, the request blocks until the research
+        # completes and returns the answer with citations. This can take up to 120 seconds
+        # depending on `research_effort`.
+        #
+        # ## Asynchronous mode
+        #
+        # When `background` is `true`, the request returns immediately with a `task_id`
+        # and `status: pending`. Poll `GET /web_search/research/{task_id}` to check when
+        # the research completes and retrieve the answer.
+        #
+        # @overload create(query:, background: nil, max_sources: nil, research_effort: nil, request_options: {})
+        #
+        # @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}, nil]
+        #
+        # @return [Telnyx::Models::WebSearch::ResearchCreateResponse]
+        #
+        # @see Telnyx::Models::WebSearch::ResearchCreateParams
+        def create(params)
+          parsed, options = Telnyx::WebSearch::ResearchCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "web_search/research",
+            body: parsed,
+            model: Telnyx::Models::WebSearch::ResearchCreateResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::WebSearch::ResearchRetrieveParams} for more details.
+        #
+        # Polls the status of a previously started asynchronous research task. When the
+        # status is `completed`, the response includes the answer and citations. When the
+        # status is `failed`, the response includes an error message.
+        #
+        # @overload retrieve(task_id, request_options: {})
+        #
+        # @param task_id [String] The research task ID returned by `POST /web_search/research` with `background: t
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::WebSearch::ResearchRetrieveResponse]
+        #
+        # @see Telnyx::Models::WebSearch::ResearchRetrieveParams
+        def retrieve(task_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["web_search/research/%1$s", task_id],
+            model: Telnyx::Models::WebSearch::ResearchRetrieveResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/web_search.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class WebSearch
+      # Deep research with citations and async task polling.
+      # @return [Telnyx::Resources::WebSearch::Research]
+      attr_reader :research
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::WebSearchCreateParams} for more details.
+      #
+      # Performs a real-time web search and returns structured, LLM-ready JSON results
+      # with titles, URLs, descriptions, and snippets. Supports filtering by domain,
+      # country, safe search, freshness, and live crawl.
+      #
+      # **Note:** `include_domains` and `exclude_domains` cannot be used in the same
+      # request. Use one or the other.
+      #
+      # @overload create(query:, count: nil, country: nil, exclude_domains: nil, freshness: nil, include_domains: nil, livecrawl: nil, safesearch: nil, request_options: {})
+      #
+      # @param query [String] The search query text.
+      #
+      # @param count [Integer] Number of results to return (1-100).
+      #
+      # @param country [String] Two-letter country code (ISO 3166-1 alpha-2) to bias results.
+      #
+      # @param exclude_domains [Array<String>] Exclude results from these domains (bare hostnames, e.g. `pinterest.com`).
+      #
+      # @param freshness [String] Time-based filter for results. Common values: `day`, `week`, `month`, `year`.
+      #
+      # @param include_domains [Array<String>] Restrict results to these domains (bare hostnames, e.g. `arxiv.org`).
+      #
+      # @param livecrawl [Boolean] When true, the provider crawls pages in real-time for fresh content. The boolean
+      #
+      # @param safesearch [Symbol, Telnyx::Models::WebSearchCreateParams::Safesearch] Safe search filter level.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::WebSearchCreateResponse]
+      #
+      # @see Telnyx::Models::WebSearchCreateParams
+      def create(params)
+        parsed, options = Telnyx::WebSearchCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "web_search",
+          body: parsed,
+          model: Telnyx::Models::WebSearchCreateResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::WebSearchContentsParams} for more details.
+      #
+      # Retrieves clean HTML or Markdown content from a list of URLs. Supports up to 20
+      # URLs per request (public API limit). Specify which formats to return: `html`,
+      # `markdown`, `metadata`.
+      #
+      # @overload contents(urls:, crawl_timeout: nil, formats: nil, max_age: nil, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Telnyx::Models::WebSearchContentsResponse]
+      #
+      # @see Telnyx::Models::WebSearchContentsParams
+      def contents(params)
+        parsed, options = Telnyx::WebSearchContentsParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "web_search/contents",
+          body: parsed,
+          model: Telnyx::Models::WebSearchContentsResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @research = Telnyx::Resources::WebSearch::Research.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/webhooks.rb

@@ -5,7 +5,7 @@ module Telnyx
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [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 [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]
       def unsafe_unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Telnyx::Internal::Type::Converter.coerce(Telnyx::Models::UnsafeUnwrapWebhookEvent, parsed)
@@ -17,7 +17,7 @@ module Telnyx
       #
       # @param key [String, nil] The webhook signing key
       #
-      # @return [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 [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]
       def unwrap(payload, headers:, key: @client.public_key)
         if key.nil?
           raise ArgumentError.new("Cannot verify a webhook without a key on either the client's public_key or passed in as an argument")

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.160.0"
+  VERSION = "5.161.0"
 end

data/lib/telnyx.rb

@@ -482,6 +482,8 @@ require_relative "telnyx/models/alphanumeric_sender_id_retrieve_params"
 require_relative "telnyx/models/alphanumeric_sender_id_retrieve_response"
 require_relative "telnyx/models/anchorsite_override"
 require_relative "telnyx/models/api_error"
+require_relative "telnyx/models/artifact_completed_webhook_event"
+require_relative "telnyx/models/artifact_failed_webhook_event"
 require_relative "telnyx/models/attachment_request"
 require_relative "telnyx/models/attempt"
 require_relative "telnyx/models/audit_event_list_params"
@@ -1464,6 +1466,32 @@ require_relative "telnyx/models/media_update_params"
 require_relative "telnyx/models/media_update_response"
 require_relative "telnyx/models/media_upload_params"
 require_relative "telnyx/models/media_upload_response"
+require_relative "telnyx/models/meeting_session"
+require_relative "telnyx/models/meeting_session_create_params"
+require_relative "telnyx/models/meeting_session_delete_params"
+require_relative "telnyx/models/meeting_session_delete_recording_media_params"
+require_relative "telnyx/models/meeting_session_delete_recording_media_response"
+require_relative "telnyx/models/meeting_session_list_params"
+require_relative "telnyx/models/meeting_session_list_response"
+require_relative "telnyx/models/meeting_session_response"
+require_relative "telnyx/models/meeting_session_retrieve_events_params"
+require_relative "telnyx/models/meeting_session_retrieve_events_response"
+require_relative "telnyx/models/meeting_session_retrieve_params"
+require_relative "telnyx/models/meeting_session_retrieve_recordings_params"
+require_relative "telnyx/models/meeting_session_retrieve_recordings_response"
+require_relative "telnyx/models/meeting_session_retrieve_transcript_params"
+require_relative "telnyx/models/meeting_session_retrieve_transcript_response"
+require_relative "telnyx/models/meeting_sessions/action_accepted_response"
+require_relative "telnyx/models/meeting_sessions/action_send_chat_params"
+require_relative "telnyx/models/meeting_sessions/action_speak_params"
+require_relative "telnyx/models/meeting_sessions/action_stop_speaking_params"
+require_relative "telnyx/models/meeting_sessions/artifact_create_params"
+require_relative "telnyx/models/meeting_sessions/artifact_list_params"
+require_relative "telnyx/models/meeting_sessions/artifact_list_response"
+require_relative "telnyx/models/meeting_sessions/artifact_retrieve_params"
+require_relative "telnyx/models/meeting_sessions/meeting_session_artifact"
+require_relative "telnyx/models/meeting_sessions/meeting_session_artifact_response"
+require_relative "telnyx/models/meeting_session_update_params"
 require_relative "telnyx/models/message_cancel_scheduled_params"
 require_relative "telnyx/models/message_cancel_scheduled_response"
 require_relative "telnyx/models/message_event"
@@ -2179,6 +2207,7 @@ require_relative "telnyx/models/rcs_card_content"
 require_relative "telnyx/models/rcs_content_info"
 require_relative "telnyx/models/rcs_suggestion"
 require_relative "telnyx/models/rcs_to_item"
+require_relative "telnyx/models/recording_available_webhook_event"
 require_relative "telnyx/models/recording_delete_params"
 require_relative "telnyx/models/recording_list_params"
 require_relative "telnyx/models/recording_response"
@@ -2296,6 +2325,7 @@ require_relative "telnyx/models/session_analysis/metadata_retrieve_response"
 require_relative "telnyx/models/session_analysis/parent_relationship_info"
 require_relative "telnyx/models/session_analysis_retrieve_params"
 require_relative "telnyx/models/session_analysis_retrieve_response"
+require_relative "telnyx/models/session_status_changed_webhook_event"
 require_relative "telnyx/models/seti_retrieve_black_box_test_results_params"
 require_relative "telnyx/models/seti_retrieve_black_box_test_results_response"
 require_relative "telnyx/models/settings"
@@ -2367,8 +2397,12 @@ require_relative "telnyx/models/sim_cards/action_bulk_set_public_ips_params"
 require_relative "telnyx/models/sim_cards/action_bulk_set_public_ips_response"
 require_relative "telnyx/models/sim_cards/action_disable_params"
 require_relative "telnyx/models/sim_cards/action_disable_response"
+require_relative "telnyx/models/sim_cards/action_disable_voice_params"
+require_relative "telnyx/models/sim_cards/action_disable_voice_response"
 require_relative "telnyx/models/sim_cards/action_enable_params"
 require_relative "telnyx/models/sim_cards/action_enable_response"
+require_relative "telnyx/models/sim_cards/action_enable_voice_params"
+require_relative "telnyx/models/sim_cards/action_enable_voice_response"
 require_relative "telnyx/models/sim_cards/action_list_params"
 require_relative "telnyx/models/sim_cards/action_remove_public_ip_params"
 require_relative "telnyx/models/sim_cards/action_remove_public_ip_response"
@@ -2424,6 +2458,7 @@ require_relative "telnyx/models/storage/cloudfs_filesystem_detail_response_wrapp
 require_relative "telnyx/models/storage/cloudfs_filesystem_response_wrapper"
 require_relative "telnyx/models/storage/cloudfs_filesystem_status"
 require_relative "telnyx/models/storage/cloudf_update_params"
+require_relative "telnyx/models/storage/edge_compute_pagination_meta"
 require_relative "telnyx/models/storage/kv_create_params"
 require_relative "telnyx/models/storage/kv_delete_params"
 require_relative "telnyx/models/storage/kv_list_params"
@@ -2451,6 +2486,14 @@ require_relative "telnyx/models/storage/migration_source_list_params"
 require_relative "telnyx/models/storage/migration_source_list_response"
 require_relative "telnyx/models/storage/migration_source_retrieve_params"
 require_relative "telnyx/models/storage/migration_source_retrieve_response"
+require_relative "telnyx/models/storage/sql_database"
+require_relative "telnyx/models/storage/sql_database_response_wrapper"
+require_relative "telnyx/models/storage/sqldb_create_params"
+require_relative "telnyx/models/storage/sqldb_delete_params"
+require_relative "telnyx/models/storage/sqldb_list_params"
+require_relative "telnyx/models/storage/sqldb_retrieve_params"
+require_relative "telnyx/models/storage/sqldbs/action_query_params"
+require_relative "telnyx/models/storage/sqldbs/action_query_response"
 require_relative "telnyx/models/storage_list_migration_source_coverage_params"
 require_relative "telnyx/models/storage_list_migration_source_coverage_response"
 require_relative "telnyx/models/stream_bidirectional_codec"
@@ -2595,6 +2638,7 @@ require_relative "telnyx/models/traffic_policy_profile_update_response"
 require_relative "telnyx/models/traffic_type"
 require_relative "telnyx/models/transcribe_client_event"
 require_relative "telnyx/models/transcribe_server_event"
+require_relative "telnyx/models/transcript_completed_webhook_event"
 require_relative "telnyx/models/transcription"
 require_relative "telnyx/models/transcription_webhook_event"
 require_relative "telnyx/models/transport_protocol"
@@ -2714,6 +2758,16 @@ require_relative "telnyx/models/webhook_delivery_retrieve_params"
 require_relative "telnyx/models/webhook_delivery_retrieve_response"
 require_relative "telnyx/models/webhook_unsafe_unwrap_params"
 require_relative "telnyx/models/webhook_unwrap_params"
+require_relative "telnyx/models/web_search/research_citation"
+require_relative "telnyx/models/web_search/research_create_params"
+require_relative "telnyx/models/web_search/research_create_response"
+require_relative "telnyx/models/web_search/research_retrieve_params"
+require_relative "telnyx/models/web_search/research_retrieve_response"
+require_relative "telnyx/models/web_search_contents_params"
+require_relative "telnyx/models/web_search_contents_response"
+require_relative "telnyx/models/web_search_create_params"
+require_relative "telnyx/models/web_search_create_response"
+require_relative "telnyx/models/web_search_result"
 require_relative "telnyx/models/well_known_retrieve_authorization_server_metadata_params"
 require_relative "telnyx/models/well_known_retrieve_authorization_server_metadata_response"
 require_relative "telnyx/models/well_known_retrieve_protected_resource_metadata_params"
@@ -2999,6 +3053,9 @@ require_relative "telnyx/resources/list"
 require_relative "telnyx/resources/managed_accounts"
 require_relative "telnyx/resources/managed_accounts/actions"
 require_relative "telnyx/resources/media"
+require_relative "telnyx/resources/meeting_sessions"
+require_relative "telnyx/resources/meeting_sessions/actions"
+require_relative "telnyx/resources/meeting_sessions/artifacts"
 require_relative "telnyx/resources/messages"
 require_relative "telnyx/resources/messages/rcs"
 require_relative "telnyx/resources/messaging"
@@ -3148,6 +3205,8 @@ require_relative "telnyx/resources/storage/kvs/keys"
 require_relative "telnyx/resources/storage/migrations"
 require_relative "telnyx/resources/storage/migrations/actions"
 require_relative "telnyx/resources/storage/migration_sources"
+require_relative "telnyx/resources/storage/sqldbs"
+require_relative "telnyx/resources/storage/sqldbs/actions"
 require_relative "telnyx/resources/sub_number_orders"
 require_relative "telnyx/resources/sub_number_orders_report"
 require_relative "telnyx/resources/telephony_credentials"
@@ -3191,6 +3250,8 @@ require_relative "telnyx/resources/voice_designs"
 require_relative "telnyx/resources/voice_sdk_call_reports"
 require_relative "telnyx/resources/webhook_deliveries"
 require_relative "telnyx/resources/webhooks"
+require_relative "telnyx/resources/web_search"
+require_relative "telnyx/resources/web_search/research"
 require_relative "telnyx/resources/well_known"
 require_relative "telnyx/resources/whatsapp"
 require_relative "telnyx/resources/whatsapp/business_accounts"

data/rbi/telnyx/client.rbi

@@ -725,6 +725,12 @@ module Telnyx
     sig { returns(Telnyx::Resources::Pricing) }
     attr_reader :pricing
 
+    sig { returns(Telnyx::Resources::WebSearch) }
+    attr_reader :web_search
+
+    sig { returns(Telnyx::Resources::MeetingSessions) }
+    attr_reader :meeting_sessions
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/telnyx/models/artifact_completed_webhook_event.rbi

@@ -0,0 +1,283 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class ArtifactCompletedWebhookEvent < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::ArtifactCompletedWebhookEvent,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      # Unique event id; deduplicate deliveries on it.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Completed artifact, including its generated content.
+      sig { returns(Telnyx::ArtifactCompletedWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(data: Telnyx::ArtifactCompletedWebhookEvent::Data::OrHash).void
+      end
+      attr_writer :data
+
+      # Event type.
+      sig do
+        returns(Telnyx::ArtifactCompletedWebhookEvent::Event::TaggedSymbol)
+      end
+      attr_accessor :event
+
+      # When the event occurred.
+      sig { returns(Time) }
+      attr_accessor :occurred_at
+
+      # Envelope version.
+      sig { returns(String) }
+      attr_accessor :version
+
+      sig do
+        params(
+          id: String,
+          data: Telnyx::ArtifactCompletedWebhookEvent::Data::OrHash,
+          event: Telnyx::ArtifactCompletedWebhookEvent::Event::OrSymbol,
+          occurred_at: Time,
+          version: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique event id; deduplicate deliveries on it.
+        id:,
+        # Completed artifact, including its generated content.
+        data:,
+        # Event type.
+        event:,
+        # When the event occurred.
+        occurred_at:,
+        # Envelope version.
+        version:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            data: Telnyx::ArtifactCompletedWebhookEvent::Data,
+            event: Telnyx::ArtifactCompletedWebhookEvent::Event::TaggedSymbol,
+            occurred_at: Time,
+            version: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::ArtifactCompletedWebhookEvent::Data,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # Id of the completed artifact.
+        sig { returns(String) }
+        attr_accessor :artifact_id
+
+        # Generated artifact content.
+        sig { returns(Telnyx::ArtifactCompletedWebhookEvent::Data::Content) }
+        attr_reader :content
+
+        sig do
+          params(
+            content:
+              Telnyx::ArtifactCompletedWebhookEvent::Data::Content::OrHash
+          ).void
+        end
+        attr_writer :content
+
+        # Model that generated the artifact.
+        sig do
+          returns(Telnyx::ArtifactCompletedWebhookEvent::Data::ModelProvenance)
+        end
+        attr_reader :model_provenance
+
+        sig do
+          params(
+            model_provenance:
+              Telnyx::ArtifactCompletedWebhookEvent::Data::ModelProvenance::OrHash
+          ).void
+        end
+        attr_writer :model_provenance
+
+        # The meeting session this event belongs to.
+        sig { returns(String) }
+        attr_accessor :session_id
+
+        # Type of the completed artifact.
+        sig do
+          returns(
+            Telnyx::ArtifactCompletedWebhookEvent::Data::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # Completed artifact, including its generated content.
+        sig do
+          params(
+            artifact_id: String,
+            content:
+              Telnyx::ArtifactCompletedWebhookEvent::Data::Content::OrHash,
+            model_provenance:
+              Telnyx::ArtifactCompletedWebhookEvent::Data::ModelProvenance::OrHash,
+            session_id: String,
+            type: Telnyx::ArtifactCompletedWebhookEvent::Data::Type::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Id of the completed artifact.
+          artifact_id:,
+          # Generated artifact content.
+          content:,
+          # Model that generated the artifact.
+          model_provenance:,
+          # The meeting session this event belongs to.
+          session_id:,
+          # Type of the completed artifact.
+          type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              artifact_id: String,
+              content: Telnyx::ArtifactCompletedWebhookEvent::Data::Content,
+              model_provenance:
+                Telnyx::ArtifactCompletedWebhookEvent::Data::ModelProvenance,
+              session_id: String,
+              type:
+                Telnyx::ArtifactCompletedWebhookEvent::Data::Type::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Content < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::ArtifactCompletedWebhookEvent::Data::Content,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Generated artifact text.
+          sig { returns(String) }
+          attr_accessor :text
+
+          # Generated artifact content.
+          sig { params(text: String).returns(T.attached_class) }
+          def self.new(
+            # Generated artifact text.
+            text:
+          )
+          end
+
+          sig { override.returns({ text: String }) }
+          def to_hash
+          end
+        end
+
+        class ModelProvenance < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::ArtifactCompletedWebhookEvent::Data::ModelProvenance,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :model
+
+          sig { returns(String) }
+          attr_accessor :provider
+
+          # Model that generated the artifact.
+          sig do
+            params(model: String, provider: String).returns(T.attached_class)
+          end
+          def self.new(model:, provider:)
+          end
+
+          sig { override.returns({ model: String, provider: String }) }
+          def to_hash
+          end
+        end
+
+        # Type of the completed artifact.
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Telnyx::ArtifactCompletedWebhookEvent::Data::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SUMMARY =
+            T.let(
+              :summary,
+              Telnyx::ArtifactCompletedWebhookEvent::Data::Type::TaggedSymbol
+            )
+          ACTION_ITEMS =
+            T.let(
+              :action_items,
+              Telnyx::ArtifactCompletedWebhookEvent::Data::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Telnyx::ArtifactCompletedWebhookEvent::Data::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      # Event type.
+      module Event
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Telnyx::ArtifactCompletedWebhookEvent::Event)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ARTIFACT_COMPLETED =
+          T.let(
+            :"artifact.completed",
+            Telnyx::ArtifactCompletedWebhookEvent::Event::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Telnyx::ArtifactCompletedWebhookEvent::Event::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end