vapi_server_sdk 0.4.0 → 0.9.1

data/lib/vapi_server_sdk/types/sms_tool.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require_relative "sms_tool_messages_item"
+require "date"
+require_relative "open_ai_function"
+require "ostruct"
+require "json"
+
+module Vapi
+  class SmsTool
+    # @return [Array<Vapi::SmsToolMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
+    #  For some tools, this is auto-filled based on special fields like
+    #  `tool.destinations`. For others like the function tool, these can be custom
+    #  configured.
+    attr_reader :messages
+    # @return [String] This is the unique identifier for the tool.
+    attr_reader :id
+    # @return [String] This is the unique identifier for the organization that this tool belongs to.
+    attr_reader :org_id
+    # @return [DateTime] This is the ISO 8601 date-time string of when the tool was created.
+    attr_reader :created_at
+    # @return [DateTime] This is the ISO 8601 date-time string of when the tool was last updated.
+    attr_reader :updated_at
+    # @return [Vapi::OpenAiFunction] This is the function definition of the tool.
+    #  For `endCall`, `transferCall`, and `dtmf` tools, this is auto-filled based on
+    #  tool-specific fields like `tool.destinations`. But, even in those cases, you can
+    #  provide a custom function definition for advanced use cases.
+    #  An example of an advanced use case is if you want to customize the message
+    #  that's spoken for `endCall` tool. You can specify a function where it returns an
+    #  argument "reason". Then, in `messages` array, you can have many
+    #  "request-complete" messages. One of these messages will be triggered if the
+    #  `messages[].conditions` matches the "reason" argument.
+    attr_reader :function
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param messages [Array<Vapi::SmsToolMessagesItem>] These are the messages that will be spoken to the user as the tool is running.
+    #  For some tools, this is auto-filled based on special fields like
+    #  `tool.destinations`. For others like the function tool, these can be custom
+    #  configured.
+    # @param id [String] This is the unique identifier for the tool.
+    # @param org_id [String] This is the unique identifier for the organization that this tool belongs to.
+    # @param created_at [DateTime] This is the ISO 8601 date-time string of when the tool was created.
+    # @param updated_at [DateTime] This is the ISO 8601 date-time string of when the tool was last updated.
+    # @param function [Vapi::OpenAiFunction] This is the function definition of the tool.
+    #  For `endCall`, `transferCall`, and `dtmf` tools, this is auto-filled based on
+    #  tool-specific fields like `tool.destinations`. But, even in those cases, you can
+    #  provide a custom function definition for advanced use cases.
+    #  An example of an advanced use case is if you want to customize the message
+    #  that's spoken for `endCall` tool. You can specify a function where it returns an
+    #  argument "reason". Then, in `messages` array, you can have many
+    #  "request-complete" messages. One of these messages will be triggered if the
+    #  `messages[].conditions` matches the "reason" argument.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::SmsTool]
+    def initialize(id:, org_id:, created_at:, updated_at:, messages: OMIT, function: OMIT, additional_properties: nil)
+      @messages = messages if messages != OMIT
+      @id = id
+      @org_id = org_id
+      @created_at = created_at
+      @updated_at = updated_at
+      @function = function if function != OMIT
+      @additional_properties = additional_properties
+      @_field_set = {
+        "messages": messages,
+        "id": id,
+        "orgId": org_id,
+        "createdAt": created_at,
+        "updatedAt": updated_at,
+        "function": function
+      }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of SmsTool
+    #
+    # @param json_object [String]
+    # @return [Vapi::SmsTool]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      messages = parsed_json["messages"]&.map do |item|
+        item = item.to_json
+        Vapi::SmsToolMessagesItem.from_json(json_object: item)
+      end
+      id = parsed_json["id"]
+      org_id = parsed_json["orgId"]
+      created_at = (DateTime.parse(parsed_json["createdAt"]) unless parsed_json["createdAt"].nil?)
+      updated_at = (DateTime.parse(parsed_json["updatedAt"]) unless parsed_json["updatedAt"].nil?)
+      if parsed_json["function"].nil?
+        function = nil
+      else
+        function = parsed_json["function"].to_json
+        function = Vapi::OpenAiFunction.from_json(json_object: function)
+      end
+      new(
+        messages: messages,
+        id: id,
+        org_id: org_id,
+        created_at: created_at,
+        updated_at: updated_at,
+        function: function,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of SmsTool to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.messages&.is_a?(Array) != false || raise("Passed value for field obj.messages is not the expected type, validation failed.")
+      obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
+      obj.org_id.is_a?(String) != false || raise("Passed value for field obj.org_id is not the expected type, validation failed.")
+      obj.created_at.is_a?(DateTime) != false || raise("Passed value for field obj.created_at is not the expected type, validation failed.")
+      obj.updated_at.is_a?(DateTime) != false || raise("Passed value for field obj.updated_at is not the expected type, validation failed.")
+      obj.function.nil? || Vapi::OpenAiFunction.validate_raw(obj: obj.function)
+    end
+  end
+end

data/lib/vapi_server_sdk/types/sms_tool_messages_item.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "tool_message_start"
+require_relative "tool_message_complete"
+require_relative "tool_message_failed"
+require_relative "tool_message_delayed"
+
+module Vapi
+  class SmsToolMessagesItem
+    # @return [Object]
+    attr_reader :member
+    # @return [String]
+    attr_reader :discriminant
+
+    private_class_method :new
+    alias kind_of? is_a?
+
+    # @param member [Object]
+    # @param discriminant [String]
+    # @return [Vapi::SmsToolMessagesItem]
+    def initialize(member:, discriminant:)
+      @member = member
+      @discriminant = discriminant
+    end
+
+    # Deserialize a JSON object to an instance of SmsToolMessagesItem
+    #
+    # @param json_object [String]
+    # @return [Vapi::SmsToolMessagesItem]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      member = case struct.type
+               when "request-start"
+                 Vapi::ToolMessageStart.from_json(json_object: json_object)
+               when "request-complete"
+                 Vapi::ToolMessageComplete.from_json(json_object: json_object)
+               when "request-failed"
+                 Vapi::ToolMessageFailed.from_json(json_object: json_object)
+               when "request-response-delayed"
+                 Vapi::ToolMessageDelayed.from_json(json_object: json_object)
+               else
+                 Vapi::ToolMessageStart.from_json(json_object: json_object)
+               end
+      new(member: member, discriminant: struct.type)
+    end
+
+    # For Union Types, to_json functionality is delegated to the wrapped member.
+    #
+    # @return [String]
+    def to_json(*_args)
+      case @discriminant
+      when "request-start"
+        { **@member.to_json, type: @discriminant }.to_json
+      when "request-complete"
+        { **@member.to_json, type: @discriminant }.to_json
+      when "request-failed"
+        { **@member.to_json, type: @discriminant }.to_json
+      when "request-response-delayed"
+        { **@member.to_json, type: @discriminant }.to_json
+      else
+        { "type": @discriminant, value: @member }.to_json
+      end
+      @member.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      case obj.type
+      when "request-start"
+        Vapi::ToolMessageStart.validate_raw(obj: obj)
+      when "request-complete"
+        Vapi::ToolMessageComplete.validate_raw(obj: obj)
+      when "request-failed"
+        Vapi::ToolMessageFailed.validate_raw(obj: obj)
+      when "request-response-delayed"
+        Vapi::ToolMessageDelayed.validate_raw(obj: obj)
+      else
+        raise("Passed value matched no type within the union, validation failed.")
+      end
+    end
+
+    # For Union Types, is_a? functionality is delegated to the wrapped member.
+    #
+    # @param obj [Object]
+    # @return [Boolean]
+    def is_a?(obj)
+      @member.is_a?(obj)
+    end
+
+    # @param member [Vapi::ToolMessageStart]
+    # @return [Vapi::SmsToolMessagesItem]
+    def self.request_start(member:)
+      new(member: member, discriminant: "request-start")
+    end
+
+    # @param member [Vapi::ToolMessageComplete]
+    # @return [Vapi::SmsToolMessagesItem]
+    def self.request_complete(member:)
+      new(member: member, discriminant: "request-complete")
+    end
+
+    # @param member [Vapi::ToolMessageFailed]
+    # @return [Vapi::SmsToolMessagesItem]
+    def self.request_failed(member:)
+      new(member: member, discriminant: "request-failed")
+    end
+
+    # @param member [Vapi::ToolMessageDelayed]
+    # @return [Vapi::SmsToolMessagesItem]
+    def self.request_response_delayed(member:)
+      new(member: member, discriminant: "request-response-delayed")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/speechmatics_credential.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "date"
+require "ostruct"
+require "json"
+
+module Vapi
+  class SpeechmaticsCredential
+    # @return [String]
+    attr_reader :provider
+    # @return [String] This is not returned in the API.
+    attr_reader :api_key
+    # @return [String] This is the unique identifier for the credential.
+    attr_reader :id
+    # @return [String] This is the unique identifier for the org that this credential belongs to.
+    attr_reader :org_id
+    # @return [DateTime] This is the ISO 8601 date-time string of when the credential was created.
+    attr_reader :created_at
+    # @return [DateTime] This is the ISO 8601 date-time string of when the assistant was last updated.
+    attr_reader :updated_at
+    # @return [String] This is the name of credential. This is just for your reference.
+    attr_reader :name
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param provider [String]
+    # @param api_key [String] This is not returned in the API.
+    # @param id [String] This is the unique identifier for the credential.
+    # @param org_id [String] This is the unique identifier for the org that this credential belongs to.
+    # @param created_at [DateTime] This is the ISO 8601 date-time string of when the credential was created.
+    # @param updated_at [DateTime] This is the ISO 8601 date-time string of when the assistant was last updated.
+    # @param name [String] This is the name of credential. This is just for your reference.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::SpeechmaticsCredential]
+    def initialize(provider:, api_key:, id:, org_id:, created_at:, updated_at:, name: OMIT, additional_properties: nil)
+      @provider = provider
+      @api_key = api_key
+      @id = id
+      @org_id = org_id
+      @created_at = created_at
+      @updated_at = updated_at
+      @name = name if name != OMIT
+      @additional_properties = additional_properties
+      @_field_set = {
+        "provider": provider,
+        "apiKey": api_key,
+        "id": id,
+        "orgId": org_id,
+        "createdAt": created_at,
+        "updatedAt": updated_at,
+        "name": name
+      }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of SpeechmaticsCredential
+    #
+    # @param json_object [String]
+    # @return [Vapi::SpeechmaticsCredential]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      provider = parsed_json["provider"]
+      api_key = parsed_json["apiKey"]
+      id = parsed_json["id"]
+      org_id = parsed_json["orgId"]
+      created_at = (DateTime.parse(parsed_json["createdAt"]) unless parsed_json["createdAt"].nil?)
+      updated_at = (DateTime.parse(parsed_json["updatedAt"]) unless parsed_json["updatedAt"].nil?)
+      name = parsed_json["name"]
+      new(
+        provider: provider,
+        api_key: api_key,
+        id: id,
+        org_id: org_id,
+        created_at: created_at,
+        updated_at: updated_at,
+        name: name,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of SpeechmaticsCredential to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.provider.is_a?(String) != false || raise("Passed value for field obj.provider is not the expected type, validation failed.")
+      obj.api_key.is_a?(String) != false || raise("Passed value for field obj.api_key is not the expected type, validation failed.")
+      obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
+      obj.org_id.is_a?(String) != false || raise("Passed value for field obj.org_id is not the expected type, validation failed.")
+      obj.created_at.is_a?(DateTime) != false || raise("Passed value for field obj.created_at is not the expected type, validation failed.")
+      obj.updated_at.is_a?(DateTime) != false || raise("Passed value for field obj.updated_at is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/speechmatics_transcriber.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require_relative "speechmatics_transcriber_language"
+require_relative "fallback_transcriber_plan"
+require "ostruct"
+require "json"
+
+module Vapi
+  class SpeechmaticsTranscriber
+    # @return [String] This is the model that will be used for the transcription.
+    attr_reader :model
+    # @return [Vapi::SpeechmaticsTranscriberLanguage]
+    attr_reader :language
+    # @return [Vapi::FallbackTranscriberPlan] This is the plan for voice provider fallbacks in the event that the primary
+    #  voice provider fails.
+    attr_reader :fallback_plan
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param model [String] This is the model that will be used for the transcription.
+    # @param language [Vapi::SpeechmaticsTranscriberLanguage]
+    # @param fallback_plan [Vapi::FallbackTranscriberPlan] This is the plan for voice provider fallbacks in the event that the primary
+    #  voice provider fails.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::SpeechmaticsTranscriber]
+    def initialize(model: OMIT, language: OMIT, fallback_plan: OMIT, additional_properties: nil)
+      @model = model if model != OMIT
+      @language = language if language != OMIT
+      @fallback_plan = fallback_plan if fallback_plan != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "model": model, "language": language, "fallbackPlan": fallback_plan }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of SpeechmaticsTranscriber
+    #
+    # @param json_object [String]
+    # @return [Vapi::SpeechmaticsTranscriber]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      model = parsed_json["model"]
+      language = parsed_json["language"]
+      if parsed_json["fallbackPlan"].nil?
+        fallback_plan = nil
+      else
+        fallback_plan = parsed_json["fallbackPlan"].to_json
+        fallback_plan = Vapi::FallbackTranscriberPlan.from_json(json_object: fallback_plan)
+      end
+      new(
+        model: model,
+        language: language,
+        fallback_plan: fallback_plan,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of SpeechmaticsTranscriber to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.model&.is_a?(String) != false || raise("Passed value for field obj.model is not the expected type, validation failed.")
+      obj.language&.is_a?(Vapi::SpeechmaticsTranscriberLanguage) != false || raise("Passed value for field obj.language is not the expected type, validation failed.")
+      obj.fallback_plan.nil? || Vapi::FallbackTranscriberPlan.validate_raw(obj: obj.fallback_plan)
+    end
+  end
+end

data/lib/vapi_server_sdk/types/speechmatics_transcriber_language.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Vapi
+  class SpeechmaticsTranscriberLanguage
+    AUTO = "auto"
+    AR = "ar"
+    BA = "ba"
+    EU = "eu"
+    BE = "be"
+    BN = "bn"
+    BG = "bg"
+    YUE = "yue"
+    CA = "ca"
+    HR = "hr"
+    CS = "cs"
+    DA = "da"
+    NL = "nl"
+    EN = "en"
+    EO = "eo"
+    ET = "et"
+    FI = "fi"
+    FR = "fr"
+    GL = "gl"
+    DE = "de"
+    EL = "el"
+    HE = "he"
+    HI = "hi"
+    HU = "hu"
+    ID = "id"
+    IA = "ia"
+    GA = "ga"
+    IT = "it"
+    JA = "ja"
+    KO = "ko"
+    LV = "lv"
+    LT = "lt"
+    MS = "ms"
+    MT = "mt"
+    CMN = "cmn"
+    MR = "mr"
+    MN = "mn"
+    NO = "no"
+    FA = "fa"
+    PL = "pl"
+    PT = "pt"
+    RO = "ro"
+    RU = "ru"
+    SK = "sk"
+    SL = "sl"
+    ES = "es"
+    SW = "sw"
+    SV = "sv"
+    TA = "ta"
+    TH = "th"
+    TR = "tr"
+    UK = "uk"
+    UR = "ur"
+    UG = "ug"
+    VI = "vi"
+    CY = "cy"
+  end
+end

data/lib/vapi_server_sdk/types/start_speaking_plan.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "start_speaking_plan_smart_endpointing_enabled"
+require_relative "start_speaking_plan_smart_endpointing_plan"
 require_relative "start_speaking_plan_custom_endpointing_rules_item"
 require_relative "transcription_endpointing_plan"
 require "ostruct"
@@ -20,16 +22,16 @@ module Vapi
     #  value.
     #  @default 0.4
     attr_reader :wait_seconds
-    # @return [Boolean] This determines if a customer speech is considered done (endpointing) using a
-    #  Vapi custom-trained model on customer's speech. This is good for
-    #  middle-of-thought detection.
-    #  Once an endpoint is triggered, the request is sent to `assistant.model`.
-    #  Usage:
-    #  - If your conversations are long-form and you want assistant to wait smartly
-    #  even if customer pauses for a bit to think, you can use this instead.
-    #  This overrides `transcriptionEndpointingPlan`.
-    #  @default false
+    # @return [Vapi::StartSpeakingPlanSmartEndpointingEnabled]
     attr_reader :smart_endpointing_enabled
+    # @return [Vapi::StartSpeakingPlanSmartEndpointingPlan] This is the plan for smart endpointing. Pick between Vapi smart endpointing or
+    #  LiveKit smart endpointing (or nothing). We strongly recommend using livekit
+    #  endpointing when working in English. LiveKit endpointing is not supported in
+    #  other languages, yet.
+    #  If this is set, it will override and take precedence over
+    #  `transcriptionEndpointingPlan`.
+    #  This plan will still be overridden by any matching `customEndpointingRules`.
+    attr_reader :smart_endpointing_plan
     # @return [Array<Vapi::StartSpeakingPlanCustomEndpointingRulesItem>] These are the custom endpointing rules to set an endpointing timeout based on a
     #  regex on the customer's speech or the assistant's last message.
     #  Usage:
@@ -39,14 +41,22 @@ module Vapi
     #  "what's my account number?", you can set a longer timeout.
     #  - If you want to wait longer while customer is enumerating a list of numbers,
     #  you can set a longer timeout.
-    #  These override `transcriptionEndpointingPlan` and `smartEndpointingEnabled` when
-    #  a rule is matched.
+    #  These rules have the highest precedence and will override both
+    #  `smartEndpointingPlan` and `transcriptionEndpointingPlan` when a rule is
+    #  matched.
     #  The rules are evaluated in order and the first one that matches will be used.
+    #  Order of precedence for endpointing:
+    #  1. customEndpointingRules (if any match)
+    #  2. smartEndpointingPlan (if set)
+    #  3. transcriptionEndpointingPlan
     #  @default []
     attr_reader :custom_endpointing_rules
     # @return [Vapi::TranscriptionEndpointingPlan] This determines how a customer speech is considered done (endpointing) using the
     #  transcription of customer's speech.
     #  Once an endpoint is triggered, the request is sent to `assistant.model`.
+    #  Note: This plan is only used if `smartEndpointingPlan` is not set. If both are
+    #  provided, `smartEndpointingPlan` takes precedence.
+    #  This plan will also be overridden by any matching `customEndpointingRules`.
     attr_reader :transcription_endpointing_plan
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
@@ -68,15 +78,14 @@ module Vapi
     #  - If the assistant is accidentally jumping in too much, set this to a higher
     #  value.
     #  @default 0.4
-    # @param smart_endpointing_enabled [Boolean] This determines if a customer speech is considered done (endpointing) using a
-    #  Vapi custom-trained model on customer's speech. This is good for
-    #  middle-of-thought detection.
-    #  Once an endpoint is triggered, the request is sent to `assistant.model`.
-    #  Usage:
-    #  - If your conversations are long-form and you want assistant to wait smartly
-    #  even if customer pauses for a bit to think, you can use this instead.
-    #  This overrides `transcriptionEndpointingPlan`.
-    #  @default false
+    # @param smart_endpointing_enabled [Vapi::StartSpeakingPlanSmartEndpointingEnabled]
+    # @param smart_endpointing_plan [Vapi::StartSpeakingPlanSmartEndpointingPlan] This is the plan for smart endpointing. Pick between Vapi smart endpointing or
+    #  LiveKit smart endpointing (or nothing). We strongly recommend using livekit
+    #  endpointing when working in English. LiveKit endpointing is not supported in
+    #  other languages, yet.
+    #  If this is set, it will override and take precedence over
+    #  `transcriptionEndpointingPlan`.
+    #  This plan will still be overridden by any matching `customEndpointingRules`.
     # @param custom_endpointing_rules [Array<Vapi::StartSpeakingPlanCustomEndpointingRulesItem>] These are the custom endpointing rules to set an endpointing timeout based on a
     #  regex on the customer's speech or the assistant's last message.
     #  Usage:
@@ -86,25 +95,35 @@ module Vapi
     #  "what's my account number?", you can set a longer timeout.
     #  - If you want to wait longer while customer is enumerating a list of numbers,
     #  you can set a longer timeout.
-    #  These override `transcriptionEndpointingPlan` and `smartEndpointingEnabled` when
-    #  a rule is matched.
+    #  These rules have the highest precedence and will override both
+    #  `smartEndpointingPlan` and `transcriptionEndpointingPlan` when a rule is
+    #  matched.
     #  The rules are evaluated in order and the first one that matches will be used.
+    #  Order of precedence for endpointing:
+    #  1. customEndpointingRules (if any match)
+    #  2. smartEndpointingPlan (if set)
+    #  3. transcriptionEndpointingPlan
     #  @default []
     # @param transcription_endpointing_plan [Vapi::TranscriptionEndpointingPlan] This determines how a customer speech is considered done (endpointing) using the
     #  transcription of customer's speech.
     #  Once an endpoint is triggered, the request is sent to `assistant.model`.
+    #  Note: This plan is only used if `smartEndpointingPlan` is not set. If both are
+    #  provided, `smartEndpointingPlan` takes precedence.
+    #  This plan will also be overridden by any matching `customEndpointingRules`.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::StartSpeakingPlan]
-    def initialize(wait_seconds: OMIT, smart_endpointing_enabled: OMIT, custom_endpointing_rules: OMIT,
-                   transcription_endpointing_plan: OMIT, additional_properties: nil)
+    def initialize(wait_seconds: OMIT, smart_endpointing_enabled: OMIT, smart_endpointing_plan: OMIT,
+                   custom_endpointing_rules: OMIT, transcription_endpointing_plan: OMIT, additional_properties: nil)
       @wait_seconds = wait_seconds if wait_seconds != OMIT
       @smart_endpointing_enabled = smart_endpointing_enabled if smart_endpointing_enabled != OMIT
+      @smart_endpointing_plan = smart_endpointing_plan if smart_endpointing_plan != OMIT
       @custom_endpointing_rules = custom_endpointing_rules if custom_endpointing_rules != OMIT
       @transcription_endpointing_plan = transcription_endpointing_plan if transcription_endpointing_plan != OMIT
       @additional_properties = additional_properties
       @_field_set = {
         "waitSeconds": wait_seconds,
         "smartEndpointingEnabled": smart_endpointing_enabled,
+        "smartEndpointingPlan": smart_endpointing_plan,
         "customEndpointingRules": custom_endpointing_rules,
         "transcriptionEndpointingPlan": transcription_endpointing_plan
       }.reject do |_k, v|
@@ -120,7 +139,18 @@ module Vapi
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
       wait_seconds = parsed_json["waitSeconds"]
-      smart_endpointing_enabled = parsed_json["smartEndpointingEnabled"]
+      if parsed_json["smartEndpointingEnabled"].nil?
+        smart_endpointing_enabled = nil
+      else
+        smart_endpointing_enabled = parsed_json["smartEndpointingEnabled"].to_json
+        smart_endpointing_enabled = Vapi::StartSpeakingPlanSmartEndpointingEnabled.from_json(json_object: smart_endpointing_enabled)
+      end
+      if parsed_json["smartEndpointingPlan"].nil?
+        smart_endpointing_plan = nil
+      else
+        smart_endpointing_plan = parsed_json["smartEndpointingPlan"].to_json
+        smart_endpointing_plan = Vapi::StartSpeakingPlanSmartEndpointingPlan.from_json(json_object: smart_endpointing_plan)
+      end
       custom_endpointing_rules = parsed_json["customEndpointingRules"]&.map do |item|
         item = item.to_json
         Vapi::StartSpeakingPlanCustomEndpointingRulesItem.from_json(json_object: item)
@@ -134,6 +164,7 @@ module Vapi
       new(
         wait_seconds: wait_seconds,
         smart_endpointing_enabled: smart_endpointing_enabled,
+        smart_endpointing_plan: smart_endpointing_plan,
         custom_endpointing_rules: custom_endpointing_rules,
         transcription_endpointing_plan: transcription_endpointing_plan,
         additional_properties: struct
@@ -155,7 +186,8 @@ module Vapi
     # @return [Void]
     def self.validate_raw(obj:)
       obj.wait_seconds&.is_a?(Float) != false || raise("Passed value for field obj.wait_seconds is not the expected type, validation failed.")
-      obj.smart_endpointing_enabled&.is_a?(Boolean) != false || raise("Passed value for field obj.smart_endpointing_enabled is not the expected type, validation failed.")
+      obj.smart_endpointing_enabled.nil? || Vapi::StartSpeakingPlanSmartEndpointingEnabled.validate_raw(obj: obj.smart_endpointing_enabled)
+      obj.smart_endpointing_plan.nil? || Vapi::StartSpeakingPlanSmartEndpointingPlan.validate_raw(obj: obj.smart_endpointing_plan)
       obj.custom_endpointing_rules&.is_a?(Array) != false || raise("Passed value for field obj.custom_endpointing_rules is not the expected type, validation failed.")
       obj.transcription_endpointing_plan.nil? || Vapi::TranscriptionEndpointingPlan.validate_raw(obj: obj.transcription_endpointing_plan)
     end