vapi_server_sdk 0.1.0 → 0.2.0

data/lib/vapi_server_sdk/types/together_ai_model.rb

@@ -2,7 +2,7 @@
 
 require_relative "open_ai_message"
 require_relative "together_ai_model_tools_item"
-require_relative "knowledge_base"
+require_relative "create_custom_knowledge_base_dto"
 require "ostruct"
 require "json"
 
@@ -18,13 +18,15 @@ module Vapi
     #  tools, use `tools`.
     #  Both `tools` and `toolIds` can be used together.
     attr_reader :tool_ids
+    # @return [Vapi::CreateCustomKnowledgeBaseDto] These are the options for the knowledge base.
+    attr_reader :knowledge_base
+    # @return [String] This is the ID of the knowledge base the model will use.
+    attr_reader :knowledge_base_id
     # @return [String] This is the name of the model. Ex. cognitivecomputations/dolphin-mixtral-8x7b
     attr_reader :model
     # @return [Float] This is the temperature that will be used for calls. Default is 0 to leverage
     #  caching for lower latency.
     attr_reader :temperature
-    # @return [Vapi::KnowledgeBase] These are the options for the knowledge base.
-    attr_reader :knowledge_base
     # @return [Float] This is the max number of tokens that the assistant will be allowed to generate
     #  in each turn of the conversation. Default is 250.
     attr_reader :max_tokens
@@ -55,10 +57,11 @@ module Vapi
     # @param tool_ids [Array<String>] These are the tools that the assistant can use during the call. To use transient
     #  tools, use `tools`.
     #  Both `tools` and `toolIds` can be used together.
+    # @param knowledge_base [Vapi::CreateCustomKnowledgeBaseDto] These are the options for the knowledge base.
+    # @param knowledge_base_id [String] This is the ID of the knowledge base the model will use.
     # @param model [String] This is the name of the model. Ex. cognitivecomputations/dolphin-mixtral-8x7b
     # @param temperature [Float] This is the temperature that will be used for calls. Default is 0 to leverage
     #  caching for lower latency.
-    # @param knowledge_base [Vapi::KnowledgeBase] These are the options for the knowledge base.
     # @param max_tokens [Float] This is the max number of tokens that the assistant will be allowed to generate
     #  in each turn of the conversation. Default is 250.
     # @param emotion_recognition_enabled [Boolean] This determines whether we detect user's emotion while they speak and send it as
@@ -73,14 +76,15 @@ module Vapi
     #  @default 0
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::TogetherAiModel]
-    def initialize(model:, messages: OMIT, tools: OMIT, tool_ids: OMIT, temperature: OMIT, knowledge_base: OMIT,
-                   max_tokens: OMIT, emotion_recognition_enabled: OMIT, num_fast_turns: OMIT, additional_properties: nil)
+    def initialize(model:, messages: OMIT, tools: OMIT, tool_ids: OMIT, knowledge_base: OMIT, knowledge_base_id: OMIT,
+                   temperature: OMIT, max_tokens: OMIT, emotion_recognition_enabled: OMIT, num_fast_turns: OMIT, additional_properties: nil)
       @messages = messages if messages != OMIT
       @tools = tools if tools != OMIT
       @tool_ids = tool_ids if tool_ids != OMIT
+      @knowledge_base = knowledge_base if knowledge_base != OMIT
+      @knowledge_base_id = knowledge_base_id if knowledge_base_id != OMIT
       @model = model
       @temperature = temperature if temperature != OMIT
-      @knowledge_base = knowledge_base if knowledge_base != OMIT
       @max_tokens = max_tokens if max_tokens != OMIT
       @emotion_recognition_enabled = emotion_recognition_enabled if emotion_recognition_enabled != OMIT
       @num_fast_turns = num_fast_turns if num_fast_turns != OMIT
@@ -89,9 +93,10 @@ module Vapi
         "messages": messages,
         "tools": tools,
         "toolIds": tool_ids,
+        "knowledgeBase": knowledge_base,
+        "knowledgeBaseId": knowledge_base_id,
         "model": model,
         "temperature": temperature,
-        "knowledgeBase": knowledge_base,
         "maxTokens": max_tokens,
         "emotionRecognitionEnabled": emotion_recognition_enabled,
         "numFastTurns": num_fast_turns
@@ -116,14 +121,15 @@ module Vapi
         Vapi::TogetherAiModelToolsItem.from_json(json_object: item)
       end
       tool_ids = parsed_json["toolIds"]
-      model = parsed_json["model"]
-      temperature = parsed_json["temperature"]
       if parsed_json["knowledgeBase"].nil?
         knowledge_base = nil
       else
         knowledge_base = parsed_json["knowledgeBase"].to_json
-        knowledge_base = Vapi::KnowledgeBase.from_json(json_object: knowledge_base)
+        knowledge_base = Vapi::CreateCustomKnowledgeBaseDto.from_json(json_object: knowledge_base)
       end
+      knowledge_base_id = parsed_json["knowledgeBaseId"]
+      model = parsed_json["model"]
+      temperature = parsed_json["temperature"]
       max_tokens = parsed_json["maxTokens"]
       emotion_recognition_enabled = parsed_json["emotionRecognitionEnabled"]
       num_fast_turns = parsed_json["numFastTurns"]
@@ -131,9 +137,10 @@ module Vapi
         messages: messages,
         tools: tools,
         tool_ids: tool_ids,
+        knowledge_base: knowledge_base,
+        knowledge_base_id: knowledge_base_id,
         model: model,
         temperature: temperature,
-        knowledge_base: knowledge_base,
         max_tokens: max_tokens,
         emotion_recognition_enabled: emotion_recognition_enabled,
         num_fast_turns: num_fast_turns,
@@ -158,9 +165,10 @@ module Vapi
       obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
       obj.tools&.is_a?(Array) != false || raise("Passed value for field obj.tools is not the expected type, validation failed.")
       obj.tool_ids&.is_a?(Array) != false || raise("Passed value for field obj.tool_ids is not the expected type, validation failed.")
+      obj.knowledge_base.nil? || Vapi::CreateCustomKnowledgeBaseDto.validate_raw(obj: obj.knowledge_base)
+      obj.knowledge_base_id&.is_a?(String) != false || raise("Passed value for field obj.knowledge_base_id is not the expected type, validation failed.")
       obj.model.is_a?(String) != false || raise("Passed value for field obj.model is not the expected type, validation failed.")
       obj.temperature&.is_a?(Float) != false || raise("Passed value for field obj.temperature is not the expected type, validation failed.")
-      obj.knowledge_base.nil? || Vapi::KnowledgeBase.validate_raw(obj: obj.knowledge_base)
       obj.max_tokens&.is_a?(Float) != false || raise("Passed value for field obj.max_tokens is not the expected type, validation failed.")
       obj.emotion_recognition_enabled&.is_a?(Boolean) != false || raise("Passed value for field obj.emotion_recognition_enabled is not the expected type, validation failed.")
       obj.num_fast_turns&.is_a?(Float) != false || raise("Passed value for field obj.num_fast_turns is not the expected type, validation failed.")

data/lib/vapi_server_sdk/types/tool_message_complete.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "text_content"
 require_relative "tool_message_complete_role"
 require_relative "condition"
 require "ostruct"
@@ -7,6 +8,15 @@ require "json"
 
 module Vapi
   class ToolMessageComplete
+    # @return [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
+    attr_reader :contents
     # @return [Vapi::ToolMessageCompleteRole] This is optional and defaults to "assistant".
     #  When role=assistant, `content` is said out loud.
     #  When role=system, `content` is passed to the model in a system message. Example:
@@ -42,6 +52,14 @@ module Vapi
 
     OMIT = Object.new
 
+    # @param contents [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
     # @param role [Vapi::ToolMessageCompleteRole] This is optional and defaults to "assistant".
     #  When role=assistant, `content` is said out loud.
     #  When role=system, `content` is passed to the model in a system message. Example:
@@ -67,14 +85,16 @@ module Vapi
     #  in order for this message to be triggered.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::ToolMessageComplete]
-    def initialize(content:, role: OMIT, end_call_after_spoken_enabled: OMIT, conditions: OMIT,
+    def initialize(contents: OMIT, role: OMIT, end_call_after_spoken_enabled: OMIT, content: OMIT, conditions: OMIT,
                    additional_properties: nil)
+      @contents = contents if contents != OMIT
       @role = role if role != OMIT
       @end_call_after_spoken_enabled = end_call_after_spoken_enabled if end_call_after_spoken_enabled != OMIT
-      @content = content
+      @content = content if content != OMIT
       @conditions = conditions if conditions != OMIT
       @additional_properties = additional_properties
       @_field_set = {
+        "contents": contents,
         "role": role,
         "endCallAfterSpokenEnabled": end_call_after_spoken_enabled,
         "content": content,
@@ -91,6 +111,10 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      contents = parsed_json["contents"]&.map do |item|
+        item = item.to_json
+        Vapi::TextContent.from_json(json_object: item)
+      end
       role = parsed_json["role"]
       end_call_after_spoken_enabled = parsed_json["endCallAfterSpokenEnabled"]
       content = parsed_json["content"]
@@ -99,6 +123,7 @@ module Vapi
         Vapi::Condition.from_json(json_object: item)
       end
       new(
+        contents: contents,
         role: role,
         end_call_after_spoken_enabled: end_call_after_spoken_enabled,
         content: content,
@@ -121,9 +146,10 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
+      obj.contents&.is_a?(Array) != false || raise("Passed value for field obj.contents is not the expected type, validation failed.")
       obj.role&.is_a?(Vapi::ToolMessageCompleteRole) != false || raise("Passed value for field obj.role is not the expected type, validation failed.")
       obj.end_call_after_spoken_enabled&.is_a?(Boolean) != false || raise("Passed value for field obj.end_call_after_spoken_enabled is not the expected type, validation failed.")
-      obj.content.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
+      obj.content&.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
       obj.conditions&.is_a?(Array) != false || raise("Passed value for field obj.conditions is not the expected type, validation failed.")
     end
   end

data/lib/vapi_server_sdk/types/tool_message_delayed.rb

@@ -1,11 +1,21 @@
 # frozen_string_literal: true
 
+require_relative "text_content"
 require_relative "condition"
 require "ostruct"
 require "json"
 
 module Vapi
   class ToolMessageDelayed
+    # @return [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
+    attr_reader :contents
     # @return [Float] The number of milliseconds to wait for the server response before saying this
     #  message.
     attr_reader :timing_milliseconds
@@ -22,6 +32,14 @@ module Vapi
 
     OMIT = Object.new
 
+    # @param contents [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
     # @param timing_milliseconds [Float] The number of milliseconds to wait for the server response before saying this
     #  message.
     # @param content [String] This is the content that the assistant says when this message is triggered.
@@ -29,12 +47,15 @@ module Vapi
     #  in order for this message to be triggered.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::ToolMessageDelayed]
-    def initialize(content:, timing_milliseconds: OMIT, conditions: OMIT, additional_properties: nil)
+    def initialize(contents: OMIT, timing_milliseconds: OMIT, content: OMIT, conditions: OMIT,
+                   additional_properties: nil)
+      @contents = contents if contents != OMIT
       @timing_milliseconds = timing_milliseconds if timing_milliseconds != OMIT
-      @content = content
+      @content = content if content != OMIT
       @conditions = conditions if conditions != OMIT
       @additional_properties = additional_properties
       @_field_set = {
+        "contents": contents,
         "timingMilliseconds": timing_milliseconds,
         "content": content,
         "conditions": conditions
@@ -50,6 +71,10 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      contents = parsed_json["contents"]&.map do |item|
+        item = item.to_json
+        Vapi::TextContent.from_json(json_object: item)
+      end
       timing_milliseconds = parsed_json["timingMilliseconds"]
       content = parsed_json["content"]
       conditions = parsed_json["conditions"]&.map do |item|
@@ -57,6 +82,7 @@ module Vapi
         Vapi::Condition.from_json(json_object: item)
       end
       new(
+        contents: contents,
         timing_milliseconds: timing_milliseconds,
         content: content,
         conditions: conditions,
@@ -78,8 +104,9 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
+      obj.contents&.is_a?(Array) != false || raise("Passed value for field obj.contents is not the expected type, validation failed.")
       obj.timing_milliseconds&.is_a?(Float) != false || raise("Passed value for field obj.timing_milliseconds is not the expected type, validation failed.")
-      obj.content.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
+      obj.content&.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
       obj.conditions&.is_a?(Array) != false || raise("Passed value for field obj.conditions is not the expected type, validation failed.")
     end
   end

data/lib/vapi_server_sdk/types/tool_message_failed.rb

@@ -1,11 +1,21 @@
 # frozen_string_literal: true
 
+require_relative "text_content"
 require_relative "condition"
 require "ostruct"
 require "json"
 
 module Vapi
   class ToolMessageFailed
+    # @return [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
+    attr_reader :contents
     # @return [Boolean] This is an optional boolean that if true, the call will end after the message is
     #  spoken. Default is false.
     #  @default false
@@ -23,6 +33,14 @@ module Vapi
 
     OMIT = Object.new
 
+    # @param contents [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
     # @param end_call_after_spoken_enabled [Boolean] This is an optional boolean that if true, the call will end after the message is
     #  spoken. Default is false.
     #  @default false
@@ -31,12 +49,15 @@ module Vapi
     #  in order for this message to be triggered.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::ToolMessageFailed]
-    def initialize(content:, end_call_after_spoken_enabled: OMIT, conditions: OMIT, additional_properties: nil)
+    def initialize(contents: OMIT, end_call_after_spoken_enabled: OMIT, content: OMIT, conditions: OMIT,
+                   additional_properties: nil)
+      @contents = contents if contents != OMIT
       @end_call_after_spoken_enabled = end_call_after_spoken_enabled if end_call_after_spoken_enabled != OMIT
-      @content = content
+      @content = content if content != OMIT
       @conditions = conditions if conditions != OMIT
       @additional_properties = additional_properties
       @_field_set = {
+        "contents": contents,
         "endCallAfterSpokenEnabled": end_call_after_spoken_enabled,
         "content": content,
         "conditions": conditions
@@ -52,6 +73,10 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      contents = parsed_json["contents"]&.map do |item|
+        item = item.to_json
+        Vapi::TextContent.from_json(json_object: item)
+      end
       end_call_after_spoken_enabled = parsed_json["endCallAfterSpokenEnabled"]
       content = parsed_json["content"]
       conditions = parsed_json["conditions"]&.map do |item|
@@ -59,6 +84,7 @@ module Vapi
         Vapi::Condition.from_json(json_object: item)
       end
       new(
+        contents: contents,
         end_call_after_spoken_enabled: end_call_after_spoken_enabled,
         content: content,
         conditions: conditions,
@@ -80,8 +106,9 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
+      obj.contents&.is_a?(Array) != false || raise("Passed value for field obj.contents is not the expected type, validation failed.")
       obj.end_call_after_spoken_enabled&.is_a?(Boolean) != false || raise("Passed value for field obj.end_call_after_spoken_enabled is not the expected type, validation failed.")
-      obj.content.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
+      obj.content&.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
       obj.conditions&.is_a?(Array) != false || raise("Passed value for field obj.conditions is not the expected type, validation failed.")
     end
   end

data/lib/vapi_server_sdk/types/tool_message_start.rb

@@ -1,11 +1,21 @@
 # frozen_string_literal: true
 
+require_relative "text_content"
 require_relative "condition"
 require "ostruct"
 require "json"
 
 module Vapi
   class ToolMessageStart
+    # @return [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
+    attr_reader :contents
     # @return [String] This is the content that the assistant says when this message is triggered.
     attr_reader :content
     # @return [Array<Vapi::Condition>] This is an optional array of conditions that the tool call arguments must meet
@@ -19,16 +29,25 @@ module Vapi
 
     OMIT = Object.new
 
+    # @param contents [Array<Vapi::TextContent>] This is an alternative to the `content` property. It allows to specify variants
+    #  of the same content, one per language.
+    #  Usage:
+    #  - If your assistants are multilingual, you can provide content for each
+    #  language.
+    #  - If you don't provide content for a language, the first item in the array will
+    #  be automatically translated to the active language at that moment.
+    #  This will override the `content` property.
     # @param content [String] This is the content that the assistant says when this message is triggered.
     # @param conditions [Array<Vapi::Condition>] This is an optional array of conditions that the tool call arguments must meet
     #  in order for this message to be triggered.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::ToolMessageStart]
-    def initialize(content:, conditions: OMIT, additional_properties: nil)
-      @content = content
+    def initialize(contents: OMIT, content: OMIT, conditions: OMIT, additional_properties: nil)
+      @contents = contents if contents != OMIT
+      @content = content if content != OMIT
       @conditions = conditions if conditions != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "content": content, "conditions": conditions }.reject do |_k, v|
+      @_field_set = { "contents": contents, "content": content, "conditions": conditions }.reject do |_k, v|
         v == OMIT
       end
     end
@@ -40,12 +59,17 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      contents = parsed_json["contents"]&.map do |item|
+        item = item.to_json
+        Vapi::TextContent.from_json(json_object: item)
+      end
       content = parsed_json["content"]
       conditions = parsed_json["conditions"]&.map do |item|
         item = item.to_json
         Vapi::Condition.from_json(json_object: item)
       end
       new(
+        contents: contents,
         content: content,
         conditions: conditions,
         additional_properties: struct
@@ -66,7 +90,8 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.content.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
+      obj.contents&.is_a?(Array) != false || raise("Passed value for field obj.contents is not the expected type, validation failed.")
+      obj.content&.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
       obj.conditions&.is_a?(Array) != false || raise("Passed value for field obj.conditions is not the expected type, validation failed.")
     end
   end

data/lib/vapi_server_sdk/types/transfer_destination_assistant.rb

@@ -1,12 +1,26 @@
 # frozen_string_literal: true
 
+require_relative "transfer_destination_assistant_message"
 require_relative "transfer_mode"
 require "ostruct"
 require "json"
 
 module Vapi
   class TransferDestinationAssistant
-    # @return [Vapi::TransferMode] This is the mode to use for the transfer. Default is `rolling-history`.
+    # @return [Vapi::TransferDestinationAssistantMessage] This is spoken to the customer before connecting them to the destination.
+    #  Usage:
+    #  - If this is not provided and transfer tool messages is not provided, default is
+    #  "Transferring the call now".
+    #  - If set to "", nothing is spoken. This is useful when you want to silently
+    #  transfer. This is especially useful when transferring between assistants in a
+    #  squad. In this scenario, you likely also want to set
+    #  `assistant.firstMessageMode=assistant-speaks-first-with-model-generated-message`
+    #  for the destination assistant.
+    #  This accepts a string or a ToolMessageStart class. Latter is useful if you want
+    #  to specify multiple messages for different languages through the `contents`
+    #  field.
+    attr_reader :message
+    # @return [Vapi::TransferMode] This is the mode to use for the transfer. Defaults to `rolling-history`.
     #  - `rolling-history`: This is the default mode. It keeps the entire conversation
     #  history and appends the new assistant's system message on transfer.
     #  Example:
@@ -25,8 +39,8 @@ module Vapi
     #  user: i need help with my account
     #  assistant: (destination.message)
     #  system: assistant2 system message
-    #  assistant: assistant2 first message (or model generated if firstMessageMode is
-    #  set to `assistant-speaks-first-with-model-generated-message`)
+    #  assistant: assistant2 first message (or model generated if firstMessageMode
+    #  is set to `assistant-speaks-first-with-model-generated-message`)
     #  - `swap-system-message-in-history`: This replaces the original system message
     #  with the new assistant's system message on transfer.
     #  Example:
@@ -44,20 +58,27 @@ module Vapi
     #  assistant: how can i help?
     #  user: i need help with my account
     #  assistant: (destination.message)
-    #  assistant: assistant2 first message (or model generated if firstMessageMode is
-    #  set to `assistant-speaks-first-with-model-generated-message`)
+    #  assistant: assistant2 first message (or model generated if firstMessageMode
+    #  is set to `assistant-speaks-first-with-model-generated-message`)
+    #  - `delete-history`: This deletes the entire conversation history on transfer.
+    #  Example:
+    #  Pre-transfer:
+    #  system: assistant1 system message
+    #  assistant: assistant1 first message
+    #  user: hey, good morning
+    #  assistant: how can i help?
+    #  user: i need help with my account
+    #  assistant: (destination.message)
+    #  Post-transfer:
+    #  system: assistant2 system message
+    #  assistant: assistant2 first message
+    #  user: Yes, please
+    #  assistant: how can i help?
+    #  user: i need help with my account
+    #  @default 'rolling-history'
     attr_reader :transfer_mode
     # @return [String] This is the assistant to transfer the call to.
     attr_reader :assistant_name
-    # @return [String] This is the message to say before transferring the call to the destination.
-    #  If this is not provided and transfer tool messages is not provided, default is
-    #  "Transferring the call now".
-    #  If set to "", nothing is spoken. This is useful when you want to silently
-    #  transfer. This is especially useful when transferring between assistants in a
-    #  squad. In this scenario, you likely also want to set
-    #  `assistant.firstMessageMode=assistant-speaks-first-with-model-generated-message`
-    #  for the destination assistant.
-    attr_reader :message
     # @return [String] This is the description of the destination, used by the AI to choose when and
     #  how to transfer the call.
     attr_reader :description
@@ -69,7 +90,19 @@ module Vapi
 
     OMIT = Object.new
 
-    # @param transfer_mode [Vapi::TransferMode] This is the mode to use for the transfer. Default is `rolling-history`.
+    # @param message [Vapi::TransferDestinationAssistantMessage] This is spoken to the customer before connecting them to the destination.
+    #  Usage:
+    #  - If this is not provided and transfer tool messages is not provided, default is
+    #  "Transferring the call now".
+    #  - If set to "", nothing is spoken. This is useful when you want to silently
+    #  transfer. This is especially useful when transferring between assistants in a
+    #  squad. In this scenario, you likely also want to set
+    #  `assistant.firstMessageMode=assistant-speaks-first-with-model-generated-message`
+    #  for the destination assistant.
+    #  This accepts a string or a ToolMessageStart class. Latter is useful if you want
+    #  to specify multiple messages for different languages through the `contents`
+    #  field.
+    # @param transfer_mode [Vapi::TransferMode] This is the mode to use for the transfer. Defaults to `rolling-history`.
     #  - `rolling-history`: This is the default mode. It keeps the entire conversation
     #  history and appends the new assistant's system message on transfer.
     #  Example:
@@ -88,8 +121,8 @@ module Vapi
     #  user: i need help with my account
     #  assistant: (destination.message)
     #  system: assistant2 system message
-    #  assistant: assistant2 first message (or model generated if firstMessageMode is
-    #  set to `assistant-speaks-first-with-model-generated-message`)
+    #  assistant: assistant2 first message (or model generated if firstMessageMode
+    #  is set to `assistant-speaks-first-with-model-generated-message`)
     #  - `swap-system-message-in-history`: This replaces the original system message
     #  with the new assistant's system message on transfer.
     #  Example:
@@ -107,31 +140,39 @@ module Vapi
     #  assistant: how can i help?
     #  user: i need help with my account
     #  assistant: (destination.message)
-    #  assistant: assistant2 first message (or model generated if firstMessageMode is
-    #  set to `assistant-speaks-first-with-model-generated-message`)
+    #  assistant: assistant2 first message (or model generated if firstMessageMode
+    #  is set to `assistant-speaks-first-with-model-generated-message`)
+    #  - `delete-history`: This deletes the entire conversation history on transfer.
+    #  Example:
+    #  Pre-transfer:
+    #  system: assistant1 system message
+    #  assistant: assistant1 first message
+    #  user: hey, good morning
+    #  assistant: how can i help?
+    #  user: i need help with my account
+    #  assistant: (destination.message)
+    #  Post-transfer:
+    #  system: assistant2 system message
+    #  assistant: assistant2 first message
+    #  user: Yes, please
+    #  assistant: how can i help?
+    #  user: i need help with my account
+    #  @default 'rolling-history'
     # @param assistant_name [String] This is the assistant to transfer the call to.
-    # @param message [String] This is the message to say before transferring the call to the destination.
-    #  If this is not provided and transfer tool messages is not provided, default is
-    #  "Transferring the call now".
-    #  If set to "", nothing is spoken. This is useful when you want to silently
-    #  transfer. This is especially useful when transferring between assistants in a
-    #  squad. In this scenario, you likely also want to set
-    #  `assistant.firstMessageMode=assistant-speaks-first-with-model-generated-message`
-    #  for the destination assistant.
     # @param description [String] This is the description of the destination, used by the AI to choose when and
     #  how to transfer the call.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::TransferDestinationAssistant]
-    def initialize(assistant_name:, transfer_mode: OMIT, message: OMIT, description: OMIT, additional_properties: nil)
+    def initialize(assistant_name:, message: OMIT, transfer_mode: OMIT, description: OMIT, additional_properties: nil)
+      @message = message if message != OMIT
       @transfer_mode = transfer_mode if transfer_mode != OMIT
       @assistant_name = assistant_name
-      @message = message if message != OMIT
       @description = description if description != OMIT
       @additional_properties = additional_properties
       @_field_set = {
+        "message": message,
         "transferMode": transfer_mode,
         "assistantName": assistant_name,
-        "message": message,
         "description": description
       }.reject do |_k, v|
         v == OMIT
@@ -145,14 +186,19 @@ module Vapi
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      if parsed_json["message"].nil?
+        message = nil
+      else
+        message = parsed_json["message"].to_json
+        message = Vapi::TransferDestinationAssistantMessage.from_json(json_object: message)
+      end
       transfer_mode = parsed_json["transferMode"]
       assistant_name = parsed_json["assistantName"]
-      message = parsed_json["message"]
       description = parsed_json["description"]
       new(
+        message: message,
         transfer_mode: transfer_mode,
         assistant_name: assistant_name,
-        message: message,
         description: description,
         additional_properties: struct
       )
@@ -172,9 +218,9 @@ module Vapi
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
+      obj.message.nil? || Vapi::TransferDestinationAssistantMessage.validate_raw(obj: obj.message)
       obj.transfer_mode&.is_a?(Vapi::TransferMode) != false || raise("Passed value for field obj.transfer_mode is not the expected type, validation failed.")
       obj.assistant_name.is_a?(String) != false || raise("Passed value for field obj.assistant_name is not the expected type, validation failed.")
-      obj.message&.is_a?(String) != false || raise("Passed value for field obj.message is not the expected type, validation failed.")
       obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
     end
   end