revox 0.3.0 → 0.4.0

data/rbi/revox/models/assistant_retrieve_response.rbi

@@ -102,14 +102,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::AssistantRetrieveResponse::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
@@ -145,8 +137,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(
@@ -203,6 +195,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
 
@@ -310,9 +307,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::AssistantRetrieveResponse::TransferDestination
+            ]
+          )
+        )
+      end
+      attr_accessor :transfer_destinations
 
       sig do
         returns(Revox::Models::AssistantRetrieveResponse::Type::TaggedSymbol)
@@ -396,6 +402,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
 
@@ -440,8 +452,6 @@ module Revox
               ]
             ),
           email_notification_address: T.nilable(String),
-          email_notification_language:
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationLanguage::OrSymbol,
           email_notification_outcomes:
             T.nilable(
               T::Array[
@@ -475,6 +485,7 @@ module Revox
             T.nilable(
               Revox::Models::AssistantRetrieveResponse::Position::OrHash
             ),
+          precall_lookup_url: T.nilable(String),
           prompt: String,
           prompt_flow:
             T.nilable(
@@ -503,7 +514,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::AssistantRetrieveResponse::TransferDestination::OrHash
+              ]
+            ),
           type: Revox::Models::AssistantRetrieveResponse::Type::OrSymbol,
           updated_at: T.anything,
           voice:
@@ -520,6 +536,7 @@ module Revox
             ),
           faq_items:
             T::Array[Revox::Models::AssistantRetrieveResponse::FaqItem::OrHash],
+          is_inbound_receptionist: T::Boolean,
           is_realestate_assistant: T::Boolean,
           pending_faq_count: Float
         ).returns(T.attached_class)
@@ -548,8 +565,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:,
@@ -561,8 +576,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.
@@ -581,6 +596,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:,
@@ -612,8 +630,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:,
@@ -632,6 +651,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
       )
@@ -666,8 +686,6 @@ module Revox
                 T::Array[Revox::Models::AssistantRetrieveResponse::CustomTool]
               ),
             email_notification_address: T.nilable(String),
-            email_notification_language:
-              Revox::Models::AssistantRetrieveResponse::EmailNotificationLanguage::TaggedSymbol,
             email_notification_outcomes:
               T.nilable(
                 T::Array[
@@ -694,6 +712,7 @@ module Revox
             organization_id: String,
             position:
               T.nilable(Revox::Models::AssistantRetrieveResponse::Position),
+            precall_lookup_url: T.nilable(String),
             prompt: String,
             prompt_flow:
               T.nilable(Revox::Models::AssistantRetrieveResponse::PromptFlow),
@@ -717,7 +736,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::AssistantRetrieveResponse::TransferDestination
+                ]
+              ),
             type: Revox::Models::AssistantRetrieveResponse::Type::TaggedSymbol,
             updated_at: T.anything,
             voice: T.nilable(Revox::Models::AssistantRetrieveResponse::Voice),
@@ -730,6 +754,7 @@ module Revox
               T.nilable(Revox::Models::AssistantRetrieveResponse::CreatedBy),
             faq_items:
               T::Array[Revox::Models::AssistantRetrieveResponse::FaqItem],
+            is_inbound_receptionist: T::Boolean,
             is_realestate_assistant: T::Boolean,
             pending_faq_count: Float
           }
@@ -770,21 +795,6 @@ module Revox
             :requested_callback_later,
             Revox::Models::AssistantRetrieveResponse::AfterCallSMSOutcome::TaggedSymbol
           )
-        REQUESTED_CALLBACK_NEW_NUMBER =
-          T.let(
-            :requested_callback_new_number,
-            Revox::Models::AssistantRetrieveResponse::AfterCallSMSOutcome::TaggedSymbol
-          )
-        DO_NOT_CONTACT =
-          T.let(
-            :do_not_contact,
-            Revox::Models::AssistantRetrieveResponse::AfterCallSMSOutcome::TaggedSymbol
-          )
-        AI_AVERSE =
-          T.let(
-            :ai_averse,
-            Revox::Models::AssistantRetrieveResponse::AfterCallSMSOutcome::TaggedSymbol
-          )
         NONE =
           T.let(
             :none,
@@ -1053,7 +1063,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
 
@@ -1073,7 +1084,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
@@ -1456,41 +1468,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::AssistantRetrieveResponse::EmailNotificationLanguage
-            )
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        EN =
-          T.let(
-            :en,
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationLanguage::TaggedSymbol
-          )
-        FR =
-          T.let(
-            :fr,
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationLanguage::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Revox::Models::AssistantRetrieveResponse::EmailNotificationLanguage::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-
       module EmailNotificationOutcome
         extend Revox::Internal::Type::Enum
 
@@ -1523,21 +1500,6 @@ module Revox
             :requested_callback_later,
             Revox::Models::AssistantRetrieveResponse::EmailNotificationOutcome::TaggedSymbol
           )
-        REQUESTED_CALLBACK_NEW_NUMBER =
-          T.let(
-            :requested_callback_new_number,
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationOutcome::TaggedSymbol
-          )
-        DO_NOT_CONTACT =
-          T.let(
-            :do_not_contact,
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationOutcome::TaggedSymbol
-          )
-        AI_AVERSE =
-          T.let(
-            :ai_averse,
-            Revox::Models::AssistantRetrieveResponse::EmailNotificationOutcome::TaggedSymbol
-          )
         NONE =
           T.let(
             :none,
@@ -1594,8 +1556,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
 
@@ -2189,9 +2151,15 @@ 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::AssistantRetrieveResponse::Slack::Channel]
+          )
+        end
+        attr_accessor :channels
 
         # The Nango connection ID linking the org's Slack workspace to Revox.
         sig { returns(String) }
@@ -2208,45 +2176,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::AssistantRetrieveResponse::Slack::Channel::OrHash
+              ],
             connection_id: String,
             outcomes:
               T::Array[
                 Revox::Models::AssistantRetrieveResponse::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
@@ -2254,13 +2220,15 @@ module Revox
         sig do
           override.returns(
             {
-              channel_id: String,
+              channels:
+                T::Array[
+                  Revox::Models::AssistantRetrieveResponse::Slack::Channel
+                ],
               connection_id: String,
               outcomes:
                 T::Array[
                   Revox::Models::AssistantRetrieveResponse::Slack::Outcome::TaggedSymbol
                 ],
-              channel_name: T.nilable(String),
               template: T.nilable(String)
             }
           )
@@ -2268,6 +2236,43 @@ module Revox
         def to_hash
         end
 
+        class Channel < Revox::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Revox::Models::AssistantRetrieveResponse::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
 
@@ -2300,21 +2305,6 @@ module Revox
               :requested_callback_later,
               Revox::Models::AssistantRetrieveResponse::Slack::Outcome::TaggedSymbol
             )
-          REQUESTED_CALLBACK_NEW_NUMBER =
-            T.let(
-              :requested_callback_new_number,
-              Revox::Models::AssistantRetrieveResponse::Slack::Outcome::TaggedSymbol
-            )
-          DO_NOT_CONTACT =
-            T.let(
-              :do_not_contact,
-              Revox::Models::AssistantRetrieveResponse::Slack::Outcome::TaggedSymbol
-            )
-          AI_AVERSE =
-            T.let(
-              :ai_averse,
-              Revox::Models::AssistantRetrieveResponse::Slack::Outcome::TaggedSymbol
-            )
           NONE =
             T.let(
               :none,
@@ -2624,6 +2614,32 @@ module Revox
         end
       end
 
+      class TransferDestination < Revox::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Revox::Models::AssistantRetrieveResponse::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
 
@@ -2701,7 +2717,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
 
@@ -2736,7 +2752,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.
@@ -2783,6 +2799,11 @@ module Revox
               :elevenlabs,
               Revox::Models::AssistantRetrieveResponse::Voice::Provider::TaggedSymbol
             )
+          GRADIUM =
+            T.let(
+              :gradium,
+              Revox::Models::AssistantRetrieveResponse::Voice::Provider::TaggedSymbol
+            )
 
           sig do
             override.returns(
@@ -3011,21 +3032,6 @@ module Revox
               :requested_callback_later,
               Revox::Models::AssistantRetrieveResponse::Zoho::Outcome::TaggedSymbol
             )
-          REQUESTED_CALLBACK_NEW_NUMBER =
-            T.let(
-              :requested_callback_new_number,
-              Revox::Models::AssistantRetrieveResponse::Zoho::Outcome::TaggedSymbol
-            )
-          DO_NOT_CONTACT =
-            T.let(
-              :do_not_contact,
-              Revox::Models::AssistantRetrieveResponse::Zoho::Outcome::TaggedSymbol
-            )
-          AI_AVERSE =
-            T.let(
-              :ai_averse,
-              Revox::Models::AssistantRetrieveResponse::Zoho::Outcome::TaggedSymbol
-            )
           NONE =
             T.let(
               :none,