revox 0.1.0 → 0.2.0

data/rbi/revox/resources/assistants.rbi

@@ -12,32 +12,81 @@ module Revox
         params(
           name: String,
           prompt: String,
+          after_call_sms_outcomes:
+            T.nilable(
+              T::Array[
+                Revox::AssistantCreateParams::AfterCallSMSOutcome::OrSymbol
+              ]
+            ),
+          after_call_sms_prompt: T.nilable(String),
           background_sound:
             T.nilable(Revox::AssistantCreateParams::BackgroundSound::OrSymbol),
-          calendly: Revox::AssistantCreateParams::Calendly::OrHash,
+          background_sound_volume: Float,
+          calendly: T.nilable(Revox::AssistantCreateParams::Calendly::OrHash),
           call_retry_config:
             Revox::AssistantCreateParams::CallRetryConfig::OrHash,
+          cartesia_dictionary_pronunciation_id: T.nilable(String),
+          custom_tools:
+            T.nilable(
+              T::Array[Revox::AssistantCreateParams::CustomTool::OrHash]
+            ),
+          email_notification_address: T.nilable(String),
+          email_notification_language:
+            Revox::AssistantCreateParams::EmailNotificationLanguage::OrSymbol,
+          email_notification_outcomes:
+            T.nilable(
+              T::Array[
+                Revox::AssistantCreateParams::EmailNotificationOutcome::OrSymbol
+              ]
+            ),
           end_of_call_sentence: String,
           faq_items: T::Array[Revox::AssistantCreateParams::FaqItem::OrHash],
           first_sentence: String,
           first_sentence_delay_ms: Integer,
           first_sentence_mode:
             Revox::AssistantCreateParams::FirstSentenceMode::OrSymbol,
+          from_phone_number: T.nilable(String),
+          human_transfer_mode:
+            T.nilable(
+              Revox::AssistantCreateParams::HumanTransferMode::OrSymbol
+            ),
           ivr_navigation_enabled: T::Boolean,
           llm_model:
             T.any(
               Revox::AssistantCreateParams::LlmModel::UnionMember0::OrHash,
-              Revox::AssistantCreateParams::LlmModel::UnionMember1::OrHash
+              Revox::AssistantCreateParams::LlmModel::UnionMember1::OrHash,
+              Revox::AssistantCreateParams::LlmModel::UnionMember2::OrHash,
+              Revox::AssistantCreateParams::LlmModel::UnionMember3::OrHash
             ),
+          logo_url: T.nilable(String),
           max_call_duration_secs: Float,
+          max_duration_end_message: T.nilable(String),
+          position: T.nilable(Revox::AssistantCreateParams::Position::OrHash),
+          prompt_flow:
+            T.nilable(Revox::AssistantCreateParams::PromptFlow::OrHash),
+          slack: T.nilable(Revox::AssistantCreateParams::Slack::OrHash),
+          sms_enabled: T::Boolean,
+          sms_template: T.nilable(String),
           structured_output_config:
             T::Array[
               Revox::AssistantCreateParams::StructuredOutputConfig::OrHash
             ],
+          structured_output_prompt: T.nilable(String),
+          stt_context:
+            T.nilable(Revox::AssistantCreateParams::SttContext::OrHash),
+          stt_model: Revox::AssistantCreateParams::SttModel::OrSymbol,
+          thinking_sound:
+            T.nilable(Revox::AssistantCreateParams::ThinkingSound::OrSymbol),
+          thinking_sound_probability: Float,
+          thinking_sound_volume: Float,
           transfer_phone_number: T.nilable(String),
+          type: Revox::AssistantCreateParams::Type::OrSymbol,
           voice: Revox::AssistantCreateParams::Voice::OrHash,
           voicemail_message: T.nilable(String),
+          voicemail_sms_prompt: T.nilable(String),
+          warm_transfer_summary_instructions: T.nilable(String),
           webhook_url: String,
+          zoho: T.nilable(Revox::AssistantCreateParams::Zoho::OrHash),
           request_options: Revox::RequestOptions::OrHash
         ).returns(Revox::Models::AssistantCreateResponse)
       end
@@ -45,13 +94,37 @@ module Revox
         name:,
         # The prompt to use for the call. This will be given to the LLM (gpt-4.1)
         prompt:,
-        # The background sound to play during the call. Useful to give the impression that
-        # your AI agent is in an office, in the street, or anywhere else you want.
+        # Which call outcomes trigger the after-call SMS. When empty or null, no
+        # after-call SMS is sent. E.g. ["interested", "completed", "none"]. Use "none"
+        # when outcome is null.
+        after_call_sms_outcomes: nil,
+        # Prompt / instructions for the after-call SMS. Supports {{variable}}
+        # placeholders. When null, no after-call SMS is sent.
+        after_call_sms_prompt: nil,
+        # Ambient background sound to play during the call. null/omitted disables it.
         background_sound: nil,
+        # Volume of the ambient background sound (0 = silent, 1 = max).
+        background_sound_volume: nil,
         calendly: nil,
         # Configuration for call retry behavior including time windows, delays, and max
         # iterations. If not provided, defaults will be used.
         call_retry_config: nil,
+        # Optional Cartesia pronunciation dictionary ID to use for this assistant's calls.
+        # Set null to unlink it.
+        cartesia_dictionary_pronunciation_id: nil,
+        # Custom API tools the assistant can call during conversations. Each tool defines
+        # an HTTP endpoint with variable substitution.
+        custom_tools: nil,
+        # Email address(es) to receive notifications when a call ends with a matching
+        # outcome. Accepts a single email or a comma-separated list (e.g. "alice@x.com,
+        # bob@y.com").
+        email_notification_address: nil,
+        # The language used for the notification email content. One of "en" or "fr".
+        # Defaults to "en".
+        email_notification_language: nil,
+        # Which call outcomes trigger an email notification. E.g. ["interested",
+        # "completed", "none"]. Use "none" when outcome is null.
+        email_notification_outcomes: nil,
         # Optional message to say when the agent decides to end the call.
         end_of_call_sentence: nil,
         # FAQ items to associate with this assistant. When provided, replaces all existing
@@ -66,27 +139,92 @@ module Revox
         # first_sentence will be spoken exactly as provided. "none" means the agent will
         # not speak first and will wait for the user.
         first_sentence_mode: nil,
+        # Override the default outbound phone number for calls placed with this assistant.
+        # Must be a phone number owned by the organization in E.164 format (e.g.
+        # +1234567890). When null, the organization's default phone number is used.
+        from_phone_number: nil,
+        # When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER;
+        # trunk must allow REFER/PSTN). Omit or null when transfer is disabled.
+        human_transfer_mode: nil,
         # Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
         # skip turns to navigate phone menus.
         ivr_navigation_enabled: nil,
         llm_model: nil,
+        # Public URL of the brand logo shown on the assistant's demo page. Upload a new
+        # logo via POST /assistants/:id/logo. Set explicitly to null to clear it.
+        logo_url: nil,
         # The maximum duration of the call in seconds. This is the maximum time the call
         # will be allowed to run.
         max_call_duration_secs: nil,
+        # Optional message the agent will say, without being interruptible, when the call
+        # reaches its max duration. Kept short so it fits inside the farewell buffer. If
+        # not set, the call ends silently.
+        max_duration_end_message: nil,
+        # Canvas position of this assistant's node in its multi-step flow editor.
+        position: nil,
+        # Visual prompt constructor data (nodes, edges, positions). Used by the UI to
+        # re-open the visual editor. Does not affect call behavior — the flattened prompt
+        # field is what the LLM receives.
+        prompt_flow: nil,
+        # Slack notification config. When set, posts a message to the chosen channel after
+        # a call ends with one of the configured outcomes.
+        slack: nil,
+        # Enable SMS tool during calls. When enabled, the agent can send SMS messages to
+        # the user on the call.
+        sms_enabled: nil,
+        # Hardcoded SMS template to send during calls. When set, this exact text is sent
+        # instead of letting the agent generate the message. Supports {{variable}}
+        # placeholders.
+        sms_template: nil,
         # The structured output config to use for the call. This is used to extract the
         # data from the call (like email, name, company name, etc.).
         structured_output_config: nil,
+        # Custom prompt for structured data extraction. If not provided, a default prompt
+        # is used. Available variables: {{transcript}}, {{call_direction}},
+        # {{user_phone_number}}, {{agent_phone_number}}.
+        structured_output_prompt: nil,
+        # Assistant-level speech-to-text context: structured `general` key/value pairs
+        # plus a list of domain `terms`. Prompt-derived context is merged in without
+        # replacing existing entries.
+        stt_context: nil,
+        # Transcriber (speech-to-text) model. Defaults to the newest Soniox realtime model
+        # when omitted.
+        stt_model: nil,
+        # Audio clip to play while the agent is processing a response. One of the built-in
+        # LiveKit audio clips; null/omitted disables it.
+        thinking_sound: nil,
+        # Probability [0..1] that the thinking sound plays on any given turn; otherwise
+        # the agent is silent while thinking.
+        thinking_sound_probability: nil,
+        # Volume of the thinking sound (0 = silent, 1 = max).
+        thinking_sound_volume: nil,
         # Phone number to transfer calls to when users request to speak to a human agent
         # in E.164 format (e.g. +1234567890).
         transfer_phone_number: nil,
+        # Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step'
+        # orchestrates a flow of sub-assistants, 'sub-assistant' is a step inside a
+        # multi-step flow (hidden from the assistants list). Flow transitions are managed
+        # via the /assistants/:id/edges endpoints, not on the assistant itself.
+        type: nil,
         # The voice to use for the call. You can get the list of voices using the /voices
         # endpoint
         voice: nil,
         # If set, when voicemail is detected the agent will speak this message then hang
         # up; if null, hang up immediately.
         voicemail_message: nil,
+        # SMS message to send when the call reaches voicemail. Supports {{variable}}
+        # placeholders. When null, no SMS is sent on voicemail.
+        voicemail_sms_prompt: nil,
+        # When using warm transfer: extra instructions for the supervisor handoff summary.
+        # If null or empty, the API uses the product default briefing when the call is
+        # loaded for the agent.
+        warm_transfer_summary_instructions: nil,
         # The webhook URL to call when the call is completed.
         webhook_url: nil,
+        # Zoho CRM integration config. When set, upserts the prospect (keyed on phone)
+        # into the chosen module and attaches a Note with the call summary after a call
+        # ends with one of the configured outcomes.
+        zoho: nil,
         request_options: {}
       )
       end
@@ -111,46 +249,119 @@ module Revox
       sig do
         params(
           id: String,
+          after_call_sms_outcomes:
+            T.nilable(
+              T::Array[
+                Revox::AssistantUpdateParams::AfterCallSMSOutcome::OrSymbol
+              ]
+            ),
+          after_call_sms_prompt: T.nilable(String),
           background_sound:
             T.nilable(Revox::AssistantUpdateParams::BackgroundSound::OrSymbol),
-          calendly: Revox::AssistantUpdateParams::Calendly::OrHash,
+          background_sound_volume: Float,
+          calendly: T.nilable(Revox::AssistantUpdateParams::Calendly::OrHash),
           call_retry_config:
             Revox::AssistantUpdateParams::CallRetryConfig::OrHash,
+          cartesia_dictionary_pronunciation_id: T.nilable(String),
+          custom_tools:
+            T.nilable(
+              T::Array[Revox::AssistantUpdateParams::CustomTool::OrHash]
+            ),
+          email_notification_address: T.nilable(String),
+          email_notification_language:
+            Revox::AssistantUpdateParams::EmailNotificationLanguage::OrSymbol,
+          email_notification_outcomes:
+            T.nilable(
+              T::Array[
+                Revox::AssistantUpdateParams::EmailNotificationOutcome::OrSymbol
+              ]
+            ),
           end_of_call_sentence: String,
           faq_items: T::Array[Revox::AssistantUpdateParams::FaqItem::OrHash],
           first_sentence: String,
           first_sentence_delay_ms: Integer,
           first_sentence_mode:
             Revox::AssistantUpdateParams::FirstSentenceMode::OrSymbol,
+          from_phone_number: T.nilable(String),
+          human_transfer_mode:
+            T.nilable(
+              Revox::AssistantUpdateParams::HumanTransferMode::OrSymbol
+            ),
           ivr_navigation_enabled: T::Boolean,
           llm_model:
             T.any(
               Revox::AssistantUpdateParams::LlmModel::UnionMember0::OrHash,
-              Revox::AssistantUpdateParams::LlmModel::UnionMember1::OrHash
+              Revox::AssistantUpdateParams::LlmModel::UnionMember1::OrHash,
+              Revox::AssistantUpdateParams::LlmModel::UnionMember2::OrHash,
+              Revox::AssistantUpdateParams::LlmModel::UnionMember3::OrHash
             ),
+          logo_url: T.nilable(String),
           max_call_duration_secs: Float,
+          max_duration_end_message: T.nilable(String),
           name: String,
+          position: T.nilable(Revox::AssistantUpdateParams::Position::OrHash),
           prompt: String,
+          prompt_flow:
+            T.nilable(Revox::AssistantUpdateParams::PromptFlow::OrHash),
+          slack: T.nilable(Revox::AssistantUpdateParams::Slack::OrHash),
+          sms_enabled: T::Boolean,
+          sms_template: T.nilable(String),
           structured_output_config:
             T::Array[
               Revox::AssistantUpdateParams::StructuredOutputConfig::OrHash
             ],
+          structured_output_prompt: T.nilable(String),
+          stt_context:
+            T.nilable(Revox::AssistantUpdateParams::SttContext::OrHash),
+          stt_model: Revox::AssistantUpdateParams::SttModel::OrSymbol,
+          thinking_sound:
+            T.nilable(Revox::AssistantUpdateParams::ThinkingSound::OrSymbol),
+          thinking_sound_probability: Float,
+          thinking_sound_volume: Float,
           transfer_phone_number: T.nilable(String),
+          type: Revox::AssistantUpdateParams::Type::OrSymbol,
           voice: Revox::AssistantUpdateParams::Voice::OrHash,
           voicemail_message: T.nilable(String),
+          voicemail_sms_prompt: T.nilable(String),
+          warm_transfer_summary_instructions: T.nilable(String),
           webhook_url: String,
+          zoho: T.nilable(Revox::AssistantUpdateParams::Zoho::OrHash),
           request_options: Revox::RequestOptions::OrHash
         ).returns(Revox::Models::AssistantUpdateResponse)
       end
       def update(
         id,
-        # The background sound to play during the call. Useful to give the impression that
-        # your AI agent is in an office, in the street, or anywhere else you want.
+        # Which call outcomes trigger the after-call SMS. When empty or null, no
+        # after-call SMS is sent. E.g. ["interested", "completed", "none"]. Use "none"
+        # when outcome is null.
+        after_call_sms_outcomes: nil,
+        # Prompt / instructions for the after-call SMS. Supports {{variable}}
+        # placeholders. When null, no after-call SMS is sent.
+        after_call_sms_prompt: nil,
+        # Ambient background sound to play during the call. null/omitted disables it.
         background_sound: nil,
+        # Volume of the ambient background sound (0 = silent, 1 = max).
+        background_sound_volume: nil,
         calendly: nil,
         # Configuration for call retry behavior including time windows, delays, and max
         # iterations. If not provided, defaults will be used.
         call_retry_config: nil,
+        # Optional Cartesia pronunciation dictionary ID to use for this assistant's calls.
+        # Set null to unlink it.
+        cartesia_dictionary_pronunciation_id: nil,
+        # Custom API tools the assistant can call during conversations. Each tool defines
+        # an HTTP endpoint with variable substitution.
+        custom_tools: nil,
+        # Email address(es) to receive notifications when a call ends with a matching
+        # outcome. Accepts a single email or a comma-separated list (e.g. "alice@x.com,
+        # bob@y.com").
+        email_notification_address: nil,
+        # The language used for the notification email content. One of "en" or "fr".
+        # Defaults to "en".
+        email_notification_language: nil,
+        # Which call outcomes trigger an email notification. E.g. ["interested",
+        # "completed", "none"]. Use "none" when outcome is null.
+        email_notification_outcomes: nil,
         # Optional message to say when the agent decides to end the call.
         end_of_call_sentence: nil,
         # FAQ items to associate with this assistant. When provided, replaces all existing
@@ -165,30 +376,95 @@ module Revox
         # first_sentence will be spoken exactly as provided. "none" means the agent will
         # not speak first and will wait for the user.
         first_sentence_mode: nil,
+        # Override the default outbound phone number for calls placed with this assistant.
+        # Must be a phone number owned by the organization in E.164 format (e.g.
+        # +1234567890). When null, the organization's default phone number is used.
+        from_phone_number: nil,
+        # When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER;
+        # trunk must allow REFER/PSTN). Omit or null when transfer is disabled.
+        human_transfer_mode: nil,
         # Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
         # skip turns to navigate phone menus.
         ivr_navigation_enabled: nil,
         llm_model: nil,
+        # Public URL of the brand logo shown on the assistant's demo page. Upload a new
+        # logo via POST /assistants/:id/logo. Set explicitly to null to clear it.
+        logo_url: nil,
         # The maximum duration of the call in seconds. This is the maximum time the call
         # will be allowed to run.
         max_call_duration_secs: nil,
+        # Optional message the agent will say, without being interruptible, when the call
+        # reaches its max duration. Kept short so it fits inside the farewell buffer. If
+        # not set, the call ends silently.
+        max_duration_end_message: nil,
         name: nil,
+        # Canvas position of this assistant's node in its multi-step flow editor.
+        position: nil,
         # The prompt to use for the call. This will be given to the LLM (gpt-4.1)
         prompt: nil,
+        # Visual prompt constructor data (nodes, edges, positions). Used by the UI to
+        # re-open the visual editor. Does not affect call behavior — the flattened prompt
+        # field is what the LLM receives.
+        prompt_flow: nil,
+        # Slack notification config. When set, posts a message to the chosen channel after
+        # a call ends with one of the configured outcomes.
+        slack: nil,
+        # Enable SMS tool during calls. When enabled, the agent can send SMS messages to
+        # the user on the call.
+        sms_enabled: nil,
+        # Hardcoded SMS template to send during calls. When set, this exact text is sent
+        # instead of letting the agent generate the message. Supports {{variable}}
+        # placeholders.
+        sms_template: nil,
         # The structured output config to use for the call. This is used to extract the
         # data from the call (like email, name, company name, etc.).
         structured_output_config: nil,
+        # Custom prompt for structured data extraction. If not provided, a default prompt
+        # is used. Available variables: {{transcript}}, {{call_direction}},
+        # {{user_phone_number}}, {{agent_phone_number}}.
+        structured_output_prompt: nil,
+        # Assistant-level speech-to-text context: structured `general` key/value pairs
+        # plus a list of domain `terms`. Prompt-derived context is merged in without
+        # replacing existing entries.
+        stt_context: nil,
+        # Transcriber (speech-to-text) model. Defaults to the newest Soniox realtime model
+        # when omitted.
+        stt_model: nil,
+        # Audio clip to play while the agent is processing a response. One of the built-in
+        # LiveKit audio clips; null/omitted disables it.
+        thinking_sound: nil,
+        # Probability [0..1] that the thinking sound plays on any given turn; otherwise
+        # the agent is silent while thinking.
+        thinking_sound_probability: nil,
+        # Volume of the thinking sound (0 = silent, 1 = max).
+        thinking_sound_volume: nil,
         # Phone number to transfer calls to when users request to speak to a human agent
         # in E.164 format (e.g. +1234567890).
         transfer_phone_number: nil,
+        # Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step'
+        # orchestrates a flow of sub-assistants, 'sub-assistant' is a step inside a
+        # multi-step flow (hidden from the assistants list). Flow transitions are managed
+        # via the /assistants/:id/edges endpoints, not on the assistant itself.
+        type: nil,
         # The voice to use for the call. You can get the list of voices using the /voices
         # endpoint
         voice: nil,
         # If set, when voicemail is detected the agent will speak this message then hang
         # up; if null, hang up immediately.
         voicemail_message: nil,
+        # SMS message to send when the call reaches voicemail. Supports {{variable}}
+        # placeholders. When null, no SMS is sent on voicemail.
+        voicemail_sms_prompt: nil,
+        # When using warm transfer: extra instructions for the supervisor handoff summary.
+        # If null or empty, the API uses the product default briefing when the call is
+        # loaded for the agent.
+        warm_transfer_summary_instructions: nil,
         # The webhook URL to call when the call is completed.
         webhook_url: nil,
+        # Zoho CRM integration config. When set, upserts the prospect (keyed on phone)
+        # into the chosen module and attaches a Note with the call summary after a call
+        # ends with one of the configured outcomes.
+        zoho: nil,
         request_options: {}
       )
       end

data/rbi/revox/resources/call.rbi

@@ -68,27 +68,6 @@ module Revox
       )
       end
 
-      # Retrieve a paginated list of call attempts. Each entry includes the call status,
-      # phone number, assistant used, transcript, and timestamps. Use the page and
-      # page_size query parameters to navigate through results.
-      sig do
-        params(
-          page: Integer,
-          page_size: Integer,
-          statuses: T::Array[Revox::CallListParams::Status::OrSymbol],
-          request_options: Revox::RequestOptions::OrHash
-        ).returns(Revox::Models::CallListResponse)
-      end
-      def list(
-        # The page number you want to get. Starting at 0.
-        page:,
-        # The number of calls to return per page.
-        page_size:,
-        statuses: nil,
-        request_options: {}
-      )
-      end
-
       # @api private
       sig { params(client: Revox::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/revox/resources/campaigns.rbi

@@ -3,14 +3,15 @@
 module Revox
   module Resources
     class Campaigns
-      # Create a new outbound calling campaign and launch it immediately. If
-      # scheduled_at is set, all calls will be queued until the specified time instead
-      # of starting right away.
+      # Create a new outbound calling campaign. By default the campaign launches
+      # immediately. Set launch to false to save as a draft for later review.
       sig do
         params(
           assistant_id: String,
           contacts: T::Array[Revox::CampaignCreateParams::Contact::OrHash],
+          launch: T::Boolean,
           name: String,
+          type: Revox::CampaignCreateParams::Type::OrSymbol,
           call_retry_config:
             Revox::CampaignCreateParams::CallRetryConfig::OrHash,
           from_phone_number: String,
@@ -24,8 +25,13 @@ module Revox
         assistant_id:,
         # The list of contacts to call
         contacts:,
+        # Whether to launch the campaign immediately. Set to false to save as a draft.
+        launch:,
         # The name of the campaign
         name:,
+        # Campaign type. 'jump_in' campaigns only dial while someone is on the campaign
+        # page and auto-pause when unattended.
+        type:,
         # Override retry configuration for calls in this campaign. If not provided, uses
         # the assistant's retry config.
         call_retry_config: nil,
@@ -95,28 +101,15 @@ module Revox
       def export_rows(id, request_options: {})
       end
 
-      # Retrieve a paginated list of rows (contacts) for a given campaign. Supports
-      # filtering by text query, call statuses, and call result.
+      # Retrieve all contact rows for a campaign. Useful for loading draft campaign data
+      # for editing.
       sig do
         params(
           id: String,
-          page: Float,
-          page_size: Float,
-          query: String,
-          result: Revox::CampaignGetRowsParams::Result::OrSymbol,
-          statuses: String,
           request_options: Revox::RequestOptions::OrHash
         ).returns(Revox::Models::CampaignGetRowsResponse)
       end
-      def get_rows(
-        id,
-        page:,
-        page_size:,
-        query: nil,
-        result: nil,
-        statuses: nil,
-        request_options: {}
-      )
+      def get_rows(id, request_options: {})
       end
 
       # @api private

data/rbi/revox/resources/voices.rbi

@@ -3,8 +3,7 @@
 module Revox
   module Resources
     class Voices
-      # Retrieve details for a single voice by its unique ID and provider. Returns the
-      # voice name, description, and provider metadata.
+      # Retrieve details for a single voice by its unique ID and provider.
       sig do
         params(
           id: String,
@@ -20,10 +19,8 @@ module Revox
       )
       end
 
-      # Retrieve the full catalog of voices available for AI calls. The list includes
-      # voices from Cartesia and ElevenLabs, each with a name, language, accent, and
-      # provider-specific ID. Use this endpoint to browse voices before assigning one to
-      # an assistant or a call.
+      # Retrieve all voices available for AI calls, including preset voices from
+      # Cartesia/ElevenLabs and your organization's cloned voices.
       sig do
         params(request_options: Revox::RequestOptions::OrHash).returns(
           Revox::Models::VoiceListResponse
@@ -32,13 +29,15 @@ module Revox
       def list(request_options: {})
       end
 
-      # Generate a short audio preview for a given voice. Provide the voice ID and
-      # provider, and the API returns an audio/mpeg stream you can play back to hear how
-      # the voice sounds before assigning it to an assistant.
+      # Generate a short audio preview for a given voice.
       sig do
         params(
           provider: Revox::VoicePreviewParams::Provider::OrSymbol,
           voice_id: String,
+          model: Revox::VoicePreviewParams::Model::OrSymbol,
+          speed: Float,
+          text: String,
+          volume: Float,
           request_options: Revox::RequestOptions::OrHash
         ).void
       end
@@ -47,6 +46,15 @@ module Revox
         provider:,
         # The voice ID to generate a preview for.
         voice_id:,
+        # Cartesia model for the preview. Defaults to sonic-3. Ignored for other
+        # providers.
+        model: nil,
+        # Speed for preview. Cartesia 0.6–1.5, ElevenLabs 0.7–1.2. Default 1.0.
+        speed: nil,
+        # Custom text for the preview. If omitted, a short default is used.
+        text: nil,
+        # Volume for Cartesia preview (0.5–2.0). Ignored for other providers.
+        volume: nil,
         request_options: {}
       )
       end

data/sig/revox/internal/util.rbs

@@ -45,8 +45,12 @@ module Revox
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]