revox 0.1.0 → 0.3.0

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,
@@ -51,6 +57,48 @@ module Revox
       def retrieve(id, request_options: {})
       end
 
+      # Update editable fields on a campaign. Draft campaigns support updating all
+      # fields including assistant, contacts, and settings. Non-draft campaigns only
+      # support renaming.
+      sig do
+        params(
+          id: String,
+          assistant_id: String,
+          call_retry_config:
+            T.nilable(Revox::CampaignUpdateParams::CallRetryConfig::OrHash),
+          contacts: T::Array[Revox::CampaignUpdateParams::Contact::OrHash],
+          from_phone_number: T.nilable(String),
+          max_concurrent_calls: T.nilable(Float),
+          name: String,
+          scheduled_at:
+            T.nilable(Revox::CampaignUpdateParams::ScheduledAt::Variants),
+          type: Revox::CampaignUpdateParams::Type::OrSymbol,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::CampaignUpdateResponse)
+      end
+      def update(
+        id,
+        # The ID of the assistant to use (draft only)
+        assistant_id: nil,
+        # Configuration for call retry behavior including time windows, delays, and max
+        # iterations. If not provided, defaults will be used.
+        call_retry_config: nil,
+        # Replace contact list (draft only)
+        contacts: nil,
+        # The phone number to use for outbound calls (draft only)
+        from_phone_number: nil,
+        # Maximum concurrent calls (draft only)
+        max_concurrent_calls: nil,
+        # Campaign display name
+        name: nil,
+        # Scheduled start time (draft only)
+        scheduled_at: nil,
+        # Campaign type (draft only)
+        type: nil,
+        request_options: {}
+      )
+      end
+
       # Retrieve all campaigns for your organization, including both active and
       # completed ones.
       sig do
@@ -95,28 +143,67 @@ 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
+
+      # Launch a previously saved draft campaign. This starts all calls immediately (or
+      # queues them if scheduled_at is set). The campaign must be in draft status.
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::CampaignLaunchResponse)
+      end
+      def launch(id, request_options: {})
+      end
+
+      # Pause a running campaign so no further calls are placed. In-progress calls are
+      # allowed to finish; pending and scheduled calls are held until the campaign is
+      # resumed. Scheduled retry timers keep counting down, so a call resumed before its
+      # time fires on schedule, while one resumed after its time fires at the next
+      # available calling window.
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::CampaignPauseResponse)
+      end
+      def pause(id, request_options: {})
+      end
+
+      # Resume a paused campaign. Held calls continue from where they left off; calls
+      # whose scheduled time passed during the pause are placed at the next available
+      # calling window.
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::CampaignResumeResponse)
+      end
+      def resume(id, request_options: {})
+      end
+
+      # Retrieve the "Statistiques" report for a campaign: the four-tile cascade funnel
+      # (appelés → eus en ligne → réels échanges → leads chauds), two secondary tiles,
+      # the distribution of exchanges by outcome, the list of hot leads, and
+      # data-extraction coverage. All counts are over distinct E.164-normalized phone
+      # numbers, and the outcome-based categories derive exclusively from calls.outcome.
+      # Cascade percentages are null when their denominator is zero.
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::CampaignStatisticsResponse)
+      end
+      def statistics(id, request_options: {})
       end
 
       # @api private

data/rbi/revox/resources/phone_numbers.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Revox
+  module Resources
+    class PhoneNumbers
+      # Update a phone number
+      sig do
+        params(
+          id: String,
+          inbound_assistant_id: T.nilable(String),
+          label: T.nilable(String),
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::PhoneNumberUpdateResponse)
+      end
+      def update(id, inbound_assistant_id: nil, label: nil, request_options: {})
+      end
+
+      # Get phone numbers
+      sig do
+        params(request_options: Revox::RequestOptions::OrHash).returns(
+          Revox::Models::PhoneNumberListResponse
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # Delete a phone number
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::PhoneNumberDeleteResponse)
+      end
+      def delete(id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Revox::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/revox/resources/users.rbi

@@ -3,8 +3,14 @@
 module Revox
   module Resources
     class Users
-      sig { returns(Revox::Resources::Users::Me) }
-      attr_reader :me
+      # Get the current authenticated user.
+      sig do
+        params(request_options: Revox::RequestOptions::OrHash).returns(
+          Revox::Models::UserRetrieveResponse
+        )
+      end
+      def retrieve(request_options: {})
+      end
 
       # @api private
       sig { params(client: Revox::Client).returns(T.attached_class) }

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,54 @@ 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.
+      # Delete a cloned voice. Only cloned voices can be deleted. Returns 409 if the
+      # voice is in use by an assistant.
+      sig do
+        params(
+          id: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::VoiceDeleteResponse)
+      end
+      def delete(
+        # The cloned voice ID to delete.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Clone a voice from an audio recording. Send audio as a base64-encoded string.
+      # The cloned voice will be available in GET /voices.
+      sig do
+        params(
+          audio: String,
+          content_type: Revox::VoiceCloneParams::ContentType::OrSymbol,
+          language: Revox::VoiceCloneParams::Language::OrSymbol,
+          name: String,
+          request_options: Revox::RequestOptions::OrHash
+        ).returns(Revox::Models::VoiceCloneResponse)
+      end
+      def clone_(
+        # Base64-encoded audio data (max ~7.5MB decoded)
+        audio:,
+        # MIME type of the audio
+        content_type:,
+        # Language of the voice
+        language:,
+        # Name for the cloned voice
+        name:,
+        request_options: {}
+      )
+      end
+
+      # 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 +85,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/client.rbs

@@ -10,8 +10,12 @@ module Revox
 
     attr_reader api_key: String
 
+    attr_reader auth_status: Revox::Resources::AuthStatus
+
     attr_reader campaigns: Revox::Resources::Campaigns
 
+    attr_reader phone_numbers: Revox::Resources::PhoneNumbers
+
     attr_reader assistants: Revox::Resources::Assistants
 
     attr_reader call: Revox::Resources::Call

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]]

data/sig/revox/models/assistant_clone_params.rbs

@@ -0,0 +1,20 @@
+module Revox
+  module Models
+    type assistant_clone_params =
+      { id: String } & Revox::Internal::Type::request_parameters
+
+    class AssistantCloneParams < Revox::Internal::Type::BaseModel
+      extend Revox::Internal::Type::RequestParameters::Converter
+      include Revox::Internal::Type::RequestParameters
+
+      attr_accessor id: String
+
+      def initialize: (
+        id: String,
+        ?request_options: Revox::request_opts
+      ) -> void
+
+      def to_hash: -> { id: String, request_options: Revox::RequestOptions }
+    end
+  end
+end