revox 0.3.0 → 0.4.0

data/rbi/revox/models/assistant_clone_response.rbi

@@ -142,14 +142,6 @@ module Revox
         sig { returns(T.nilable(String)) }
         attr_accessor :email_notification_address
 
-        # The language used for the notification email content. One of "en" or "fr".
-        sig do
-          returns(
-            Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::TaggedSymbol
-          )
-        end
-        attr_accessor :email_notification_language
-
         # Which call outcomes trigger an email notification. E.g. ["interested",
         # "completed", "none"]. Use "none" when outcome is null.
         sig do
@@ -185,8 +177,8 @@ module Revox
         sig { returns(T.nilable(String)) }
         attr_accessor :from_phone_number
 
-        # Warm or cold transfer when transfer_phone_number is set; null when transfer is
-        # not configured.
+        # Warm or cold transfer when transfer_destinations is non-empty; null when
+        # transfer is not configured.
         sig do
           returns(
             T.nilable(
@@ -249,6 +241,11 @@ module Revox
         end
         attr_writer :position
 
+        # URL fetched before an inbound call is answered to resolve the assistant's prompt
+        # variables. Null when no lookup is configured.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :precall_lookup_url
+
         sig { returns(String) }
         attr_accessor :prompt
 
@@ -368,9 +365,18 @@ module Revox
         sig { returns(Float) }
         attr_accessor :thinking_sound_volume
 
-        # Phone number to transfer calls to when users request to speak to a human agent.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :transfer_phone_number
+        # Where calls can be transferred to when users ask to speak to a human. Null or
+        # empty when transfer is not configured.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                Revox::Models::AssistantCloneResponse::Assistant::TransferDestination
+              ]
+            )
+          )
+        end
+        attr_accessor :transfer_destinations
 
         sig do
           returns(
@@ -476,6 +482,12 @@ module Revox
         end
         attr_writer :faq_items
 
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :is_inbound_receptionist
+
+        sig { params(is_inbound_receptionist: T::Boolean).void }
+        attr_writer :is_inbound_receptionist
+
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :is_realestate_assistant
 
@@ -520,8 +532,6 @@ module Revox
                 ]
               ),
             email_notification_address: T.nilable(String),
-            email_notification_language:
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::OrSymbol,
             email_notification_outcomes:
               T.nilable(
                 T::Array[
@@ -555,6 +565,7 @@ module Revox
               T.nilable(
                 Revox::Models::AssistantCloneResponse::Assistant::Position::OrHash
               ),
+            precall_lookup_url: T.nilable(String),
             prompt: String,
             prompt_flow:
               T.nilable(
@@ -585,7 +596,12 @@ module Revox
               ),
             thinking_sound_probability: Float,
             thinking_sound_volume: Float,
-            transfer_phone_number: T.nilable(String),
+            transfer_destinations:
+              T.nilable(
+                T::Array[
+                  Revox::Models::AssistantCloneResponse::Assistant::TransferDestination::OrHash
+                ]
+              ),
             type:
               Revox::Models::AssistantCloneResponse::Assistant::Type::OrSymbol,
             updated_at: T.anything,
@@ -609,6 +625,7 @@ module Revox
               T::Array[
                 Revox::Models::AssistantCloneResponse::Assistant::FaqItem::OrHash
               ],
+            is_inbound_receptionist: T::Boolean,
             is_realestate_assistant: T::Boolean,
             pending_faq_count: Float
           ).returns(T.attached_class)
@@ -637,8 +654,6 @@ module Revox
           # outcome. Accepts a single email or a comma-separated list (e.g. "alice@x.com,
           # bob@y.com").
           email_notification_address:,
-          # The language used for the notification email content. One of "en" or "fr".
-          email_notification_language:,
           # Which call outcomes trigger an email notification. E.g. ["interested",
           # "completed", "none"]. Use "none" when outcome is null.
           email_notification_outcomes:,
@@ -650,8 +665,8 @@ module Revox
           # Override the default outbound phone number for calls placed with this assistant.
           # When null, the organization's default phone number is used.
           from_phone_number:,
-          # Warm or cold transfer when transfer_phone_number is set; null when transfer is
-          # not configured.
+          # Warm or cold transfer when transfer_destinations is non-empty; null when
+          # transfer is not configured.
           human_transfer_mode:,
           # Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
           # skip turns to navigate phone menus.
@@ -670,6 +685,9 @@ module Revox
           name:,
           organization_id:,
           position:,
+          # URL fetched before an inbound call is answered to resolve the assistant's prompt
+          # variables. Null when no lookup is configured.
+          precall_lookup_url:,
           prompt:,
           prompt_flow:,
           slack:,
@@ -701,8 +719,9 @@ module Revox
           thinking_sound_probability:,
           # Volume of the thinking sound (0 = silent, 1 = max).
           thinking_sound_volume:,
-          # Phone number to transfer calls to when users request to speak to a human agent.
-          transfer_phone_number:,
+          # Where calls can be transferred to when users ask to speak to a human. Null or
+          # empty when transfer is not configured.
+          transfer_destinations:,
           type:,
           updated_at:,
           voice:,
@@ -721,6 +740,7 @@ module Revox
           # The user who created the assistant.
           created_by: nil,
           faq_items: nil,
+          is_inbound_receptionist: nil,
           is_realestate_assistant: nil,
           pending_faq_count: nil
         )
@@ -759,8 +779,6 @@ module Revox
                   ]
                 ),
               email_notification_address: T.nilable(String),
-              email_notification_language:
-                Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::TaggedSymbol,
               email_notification_outcomes:
                 T.nilable(
                   T::Array[
@@ -789,6 +807,7 @@ module Revox
                 T.nilable(
                   Revox::Models::AssistantCloneResponse::Assistant::Position
                 ),
+              precall_lookup_url: T.nilable(String),
               prompt: String,
               prompt_flow:
                 T.nilable(
@@ -819,7 +838,12 @@ module Revox
                 ),
               thinking_sound_probability: Float,
               thinking_sound_volume: Float,
-              transfer_phone_number: T.nilable(String),
+              transfer_destinations:
+                T.nilable(
+                  T::Array[
+                    Revox::Models::AssistantCloneResponse::Assistant::TransferDestination
+                  ]
+                ),
               type:
                 Revox::Models::AssistantCloneResponse::Assistant::Type::TaggedSymbol,
               updated_at: T.anything,
@@ -843,6 +867,7 @@ module Revox
                 T::Array[
                   Revox::Models::AssistantCloneResponse::Assistant::FaqItem
                 ],
+              is_inbound_receptionist: T::Boolean,
               is_realestate_assistant: T::Boolean,
               pending_faq_count: Float
             }
@@ -883,21 +908,6 @@ module Revox
               :requested_callback_later,
               Revox::Models::AssistantCloneResponse::Assistant::AfterCallSMSOutcome::TaggedSymbol
             )
-          REQUESTED_CALLBACK_NEW_NUMBER =
-            T.let(
-              :requested_callback_new_number,
-              Revox::Models::AssistantCloneResponse::Assistant::AfterCallSMSOutcome::TaggedSymbol
-            )
-          DO_NOT_CONTACT =
-            T.let(
-              :do_not_contact,
-              Revox::Models::AssistantCloneResponse::Assistant::AfterCallSMSOutcome::TaggedSymbol
-            )
-          AI_AVERSE =
-            T.let(
-              :ai_averse,
-              Revox::Models::AssistantCloneResponse::Assistant::AfterCallSMSOutcome::TaggedSymbol
-            )
           NONE =
             T.let(
               :none,
@@ -1166,7 +1176,8 @@ module Revox
             sig { returns(String) }
             attr_accessor :calling_window_start_time
 
-            # Delay between retry attempts in seconds. Default: 7200 (2 hours).
+            # Delay between retry attempts in seconds. 0 retries as soon as the calling window
+            # allows. Default: 7200 (2 hours).
             sig { returns(Integer) }
             attr_accessor :retry_delay_seconds
 
@@ -1186,7 +1197,8 @@ module Revox
               # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
               # Examples: '09:00', '10am'. Default: '10:00'.
               calling_window_start_time:,
-              # Delay between retry attempts in seconds. Default: 7200 (2 hours).
+              # Delay between retry attempts in seconds. 0 retries as soon as the calling window
+              # allows. Default: 7200 (2 hours).
               retry_delay_seconds:
             )
             end
@@ -1569,41 +1581,6 @@ module Revox
           end
         end
 
-        # The language used for the notification email content. One of "en" or "fr".
-        module EmailNotificationLanguage
-          extend Revox::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(
-                Symbol,
-                Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage
-              )
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          EN =
-            T.let(
-              :en,
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::TaggedSymbol
-            )
-          FR =
-            T.let(
-              :fr,
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[
-                Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationLanguage::TaggedSymbol
-              ]
-            )
-          end
-          def self.values
-          end
-        end
-
         module EmailNotificationOutcome
           extend Revox::Internal::Type::Enum
 
@@ -1636,21 +1613,6 @@ module Revox
               :requested_callback_later,
               Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationOutcome::TaggedSymbol
             )
-          REQUESTED_CALLBACK_NEW_NUMBER =
-            T.let(
-              :requested_callback_new_number,
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationOutcome::TaggedSymbol
-            )
-          DO_NOT_CONTACT =
-            T.let(
-              :do_not_contact,
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationOutcome::TaggedSymbol
-            )
-          AI_AVERSE =
-            T.let(
-              :ai_averse,
-              Revox::Models::AssistantCloneResponse::Assistant::EmailNotificationOutcome::TaggedSymbol
-            )
           NONE =
             T.let(
               :none,
@@ -1707,8 +1669,8 @@ module Revox
           end
         end
 
-        # Warm or cold transfer when transfer_phone_number is set; null when transfer is
-        # not configured.
+        # Warm or cold transfer when transfer_destinations is non-empty; null when
+        # transfer is not configured.
         module HumanTransferMode
           extend Revox::Internal::Type::Enum
 
@@ -2306,9 +2268,17 @@ module Revox
               )
             end
 
-          # The Slack channel ID where the notification will be posted.
-          sig { returns(String) }
-          attr_accessor :channel_id
+          # The Slack channels eligible to receive the notification. When more than one is
+          # configured, the agent prompt may define routing rules to narrow it down per
+          # call; with no such rules every channel here is notified.
+          sig do
+            returns(
+              T::Array[
+                Revox::Models::AssistantCloneResponse::Assistant::Slack::Channel
+              ]
+            )
+          end
+          attr_accessor :channels
 
           # The Nango connection ID linking the org's Slack workspace to Revox.
           sig { returns(String) }
@@ -2325,45 +2295,43 @@ module Revox
           end
           attr_accessor :outcomes
 
-          # Human-readable Slack channel name, cached for display in the UI.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :channel_name
-
           # Optional message template. Supports {{summary}}, {{outcome}}, {{phone}},
           # {{call_url}}, {{assistant_name}}, {{campaign_name}}, {{first_name}},
-          # {{last_name}}, {{email}}, {{company}}, {{contact_name}}, {{contact_line}}, plus
-          # prompt_variables and structured_output keys. When null/empty a default template
-          # is used.
+          # {{last_name}}, {{email}}, {{company}}, {{job_title}}, {{contact_name}},
+          # {{contact_line}}, plus prompt_variables and structured_output keys. When
+          # null/empty a default template is used.
           sig { returns(T.nilable(String)) }
           attr_accessor :template
 
           sig do
             params(
-              channel_id: String,
+              channels:
+                T::Array[
+                  Revox::Models::AssistantCloneResponse::Assistant::Slack::Channel::OrHash
+                ],
               connection_id: String,
               outcomes:
                 T::Array[
                   Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::OrSymbol
                 ],
-              channel_name: T.nilable(String),
               template: T.nilable(String)
             ).returns(T.attached_class)
           end
           def self.new(
-            # The Slack channel ID where the notification will be posted.
-            channel_id:,
+            # The Slack channels eligible to receive the notification. When more than one is
+            # configured, the agent prompt may define routing rules to narrow it down per
+            # call; with no such rules every channel here is notified.
+            channels:,
             # The Nango connection ID linking the org's Slack workspace to Revox.
             connection_id:,
             # Which call outcomes trigger a Slack notification (e.g. ['interested', 'none']).
             # Use 'none' to notify when outcome is null.
             outcomes:,
-            # Human-readable Slack channel name, cached for display in the UI.
-            channel_name: nil,
             # Optional message template. Supports {{summary}}, {{outcome}}, {{phone}},
             # {{call_url}}, {{assistant_name}}, {{campaign_name}}, {{first_name}},
-            # {{last_name}}, {{email}}, {{company}}, {{contact_name}}, {{contact_line}}, plus
-            # prompt_variables and structured_output keys. When null/empty a default template
-            # is used.
+            # {{last_name}}, {{email}}, {{company}}, {{job_title}}, {{contact_name}},
+            # {{contact_line}}, plus prompt_variables and structured_output keys. When
+            # null/empty a default template is used.
             template: nil
           )
           end
@@ -2371,13 +2339,15 @@ module Revox
           sig do
             override.returns(
               {
-                channel_id: String,
+                channels:
+                  T::Array[
+                    Revox::Models::AssistantCloneResponse::Assistant::Slack::Channel
+                  ],
                 connection_id: String,
                 outcomes:
                   T::Array[
                     Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::TaggedSymbol
                   ],
-                channel_name: T.nilable(String),
                 template: T.nilable(String)
               }
             )
@@ -2385,6 +2355,43 @@ module Revox
           def to_hash
           end
 
+          class Channel < Revox::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Revox::Models::AssistantCloneResponse::Assistant::Slack::Channel,
+                  Revox::Internal::AnyHash
+                )
+              end
+
+            # The Slack channel ID (e.g. 'C01234567').
+            sig { returns(String) }
+            attr_accessor :id
+
+            # Human-readable Slack channel name, cached for display in the UI and given to the
+            # LLM when the agent prompt routes by channel name.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :name
+
+            sig do
+              params(id: String, name: T.nilable(String)).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # The Slack channel ID (e.g. 'C01234567').
+              id:,
+              # Human-readable Slack channel name, cached for display in the UI and given to the
+              # LLM when the agent prompt routes by channel name.
+              name: nil
+            )
+            end
+
+            sig { override.returns({ id: String, name: T.nilable(String) }) }
+            def to_hash
+            end
+          end
+
           module Outcome
             extend Revox::Internal::Type::Enum
 
@@ -2417,21 +2424,6 @@ module Revox
                 :requested_callback_later,
                 Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::TaggedSymbol
               )
-            REQUESTED_CALLBACK_NEW_NUMBER =
-              T.let(
-                :requested_callback_new_number,
-                Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::TaggedSymbol
-              )
-            DO_NOT_CONTACT =
-              T.let(
-                :do_not_contact,
-                Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::TaggedSymbol
-              )
-            AI_AVERSE =
-              T.let(
-                :ai_averse,
-                Revox::Models::AssistantCloneResponse::Assistant::Slack::Outcome::TaggedSymbol
-              )
             NONE =
               T.let(
                 :none,
@@ -2744,6 +2736,34 @@ module Revox
           end
         end
 
+        class TransferDestination < Revox::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Revox::Models::AssistantCloneResponse::Assistant::TransferDestination,
+                Revox::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :label
+
+          sig { returns(String) }
+          attr_accessor :phone_number
+
+          sig do
+            params(label: String, phone_number: String).returns(
+              T.attached_class
+            )
+          end
+          def self.new(label:, phone_number:)
+          end
+
+          sig { override.returns({ label: String, phone_number: String }) }
+          def to_hash
+          end
+        end
+
         module Type
           extend Revox::Internal::Type::Enum
 
@@ -2824,7 +2844,7 @@ module Revox
           attr_writer :model
 
           # The speed of the voice. Range depends on provider: Cartesia 0.6–1.5, ElevenLabs
-          # 0.7–1.2. Default is 1.0.
+          # 0.7–1.2, Gradium 0.6–1.5. Default is 1.0.
           sig { returns(T.nilable(Float)) }
           attr_reader :speed
 
@@ -2859,7 +2879,7 @@ module Revox
             # for other providers.
             model: nil,
             # The speed of the voice. Range depends on provider: Cartesia 0.6–1.5, ElevenLabs
-            # 0.7–1.2. Default is 1.0.
+            # 0.7–1.2, Gradium 0.6–1.5. Default is 1.0.
             speed: nil,
             # Volume of the voice (Cartesia only). 0.5–2.0, default 1.0. Ignored for other
             # providers.
@@ -2906,6 +2926,11 @@ module Revox
                 :elevenlabs,
                 Revox::Models::AssistantCloneResponse::Assistant::Voice::Provider::TaggedSymbol
               )
+            GRADIUM =
+              T.let(
+                :gradium,
+                Revox::Models::AssistantCloneResponse::Assistant::Voice::Provider::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -3136,21 +3161,6 @@ module Revox
                 :requested_callback_later,
                 Revox::Models::AssistantCloneResponse::Assistant::Zoho::Outcome::TaggedSymbol
               )
-            REQUESTED_CALLBACK_NEW_NUMBER =
-              T.let(
-                :requested_callback_new_number,
-                Revox::Models::AssistantCloneResponse::Assistant::Zoho::Outcome::TaggedSymbol
-              )
-            DO_NOT_CONTACT =
-              T.let(
-                :do_not_contact,
-                Revox::Models::AssistantCloneResponse::Assistant::Zoho::Outcome::TaggedSymbol
-              )
-            AI_AVERSE =
-              T.let(
-                :ai_averse,
-                Revox::Models::AssistantCloneResponse::Assistant::Zoho::Outcome::TaggedSymbol
-              )
             NONE =
               T.let(
                 :none,