pingram 1.0.39 → 1.0.40

data/lib/pingram/models/{bind_number_response_agent_spec_conversation.rb → agent_agent_conversation.rb}

@@ -14,22 +14,26 @@ require 'date'
 require 'time'
 
 module Pingram
-  class BindNumberResponseAgentSpecConversation < ApiModelBase
+  # Turn-taking and call limits. Each omitted field uses its default.
+  class AgentAgentConversation < ApiModelBase
+    # How the agent decides the caller has finished speaking. Default: semantic.
     attr_accessor :turn_detection
 
+    # Silence before the agent treats the turn as finished, in milliseconds. Default: 500.
     attr_accessor :min_end_of_turn_silence_ms
 
+    # Whether the caller can interrupt the agent. Default: true.
     attr_accessor :allow_interruptions
 
+    # How long the caller must speak to count as an interruption, in milliseconds. Default: 300.
     attr_accessor :min_interruption_duration_ms
 
+    # Seconds of silence before the agent hangs up. 0 never hangs up. Default: 30.
     attr_accessor :silence_timeout_seconds
 
+    # Maximum call length in seconds. Default: 600.
     attr_accessor :max_call_length_seconds
 
-    # When true (default), the agent may invoke the built-in end_call action.
-    attr_accessor :agent_can_end_call
-
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -60,8 +64,7 @@ module Pingram
         :'allow_interruptions' => :'allowInterruptions',
         :'min_interruption_duration_ms' => :'minInterruptionDurationMs',
         :'silence_timeout_seconds' => :'silenceTimeoutSeconds',
-        :'max_call_length_seconds' => :'maxCallLengthSeconds',
-        :'agent_can_end_call' => :'agentCanEndCall'
+        :'max_call_length_seconds' => :'maxCallLengthSeconds'
       }
     end
 
@@ -83,8 +86,7 @@ module Pingram
         :'allow_interruptions' => :'Boolean',
         :'min_interruption_duration_ms' => :'Float',
         :'silence_timeout_seconds' => :'Float',
-        :'max_call_length_seconds' => :'Float',
-        :'agent_can_end_call' => :'Boolean'
+        :'max_call_length_seconds' => :'Float'
       }
     end
 
@@ -98,56 +100,40 @@ module Pingram
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::BindNumberResponseAgentSpecConversation` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::AgentAgentConversation` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::BindNumberResponseAgentSpecConversation`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::AgentAgentConversation`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
       if attributes.key?(:'turn_detection')
         self.turn_detection = attributes[:'turn_detection']
-      else
-        self.turn_detection = nil
       end
 
       if attributes.key?(:'min_end_of_turn_silence_ms')
         self.min_end_of_turn_silence_ms = attributes[:'min_end_of_turn_silence_ms']
-      else
-        self.min_end_of_turn_silence_ms = nil
       end
 
       if attributes.key?(:'allow_interruptions')
         self.allow_interruptions = attributes[:'allow_interruptions']
-      else
-        self.allow_interruptions = nil
       end
 
       if attributes.key?(:'min_interruption_duration_ms')
         self.min_interruption_duration_ms = attributes[:'min_interruption_duration_ms']
-      else
-        self.min_interruption_duration_ms = nil
       end
 
       if attributes.key?(:'silence_timeout_seconds')
         self.silence_timeout_seconds = attributes[:'silence_timeout_seconds']
-      else
-        self.silence_timeout_seconds = nil
       end
 
       if attributes.key?(:'max_call_length_seconds')
         self.max_call_length_seconds = attributes[:'max_call_length_seconds']
-      else
-        self.max_call_length_seconds = nil
-      end
-
-      if attributes.key?(:'agent_can_end_call')
-        self.agent_can_end_call = attributes[:'agent_can_end_call']
       end
     end
 
@@ -156,30 +142,6 @@ module Pingram
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @turn_detection.nil?
-        invalid_properties.push('invalid value for "turn_detection", turn_detection cannot be nil.')
-      end
-
-      if @min_end_of_turn_silence_ms.nil?
-        invalid_properties.push('invalid value for "min_end_of_turn_silence_ms", min_end_of_turn_silence_ms cannot be nil.')
-      end
-
-      if @allow_interruptions.nil?
-        invalid_properties.push('invalid value for "allow_interruptions", allow_interruptions cannot be nil.')
-      end
-
-      if @min_interruption_duration_ms.nil?
-        invalid_properties.push('invalid value for "min_interruption_duration_ms", min_interruption_duration_ms cannot be nil.')
-      end
-
-      if @silence_timeout_seconds.nil?
-        invalid_properties.push('invalid value for "silence_timeout_seconds", silence_timeout_seconds cannot be nil.')
-      end
-
-      if @max_call_length_seconds.nil?
-        invalid_properties.push('invalid value for "max_call_length_seconds", max_call_length_seconds cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -187,14 +149,8 @@ module Pingram
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @turn_detection.nil?
       turn_detection_validator = EnumAttributeValidator.new('String', ["semantic", "vad"])
       return false unless turn_detection_validator.valid?(@turn_detection)
-      return false if @min_end_of_turn_silence_ms.nil?
-      return false if @allow_interruptions.nil?
-      return false if @min_interruption_duration_ms.nil?
-      return false if @silence_timeout_seconds.nil?
-      return false if @max_call_length_seconds.nil?
       true
     end
 
@@ -208,56 +164,6 @@ module Pingram
       @turn_detection = turn_detection
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] min_end_of_turn_silence_ms Value to be assigned
-    def min_end_of_turn_silence_ms=(min_end_of_turn_silence_ms)
-      if min_end_of_turn_silence_ms.nil?
-        fail ArgumentError, 'min_end_of_turn_silence_ms cannot be nil'
-      end
-
-      @min_end_of_turn_silence_ms = min_end_of_turn_silence_ms
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] allow_interruptions Value to be assigned
-    def allow_interruptions=(allow_interruptions)
-      if allow_interruptions.nil?
-        fail ArgumentError, 'allow_interruptions cannot be nil'
-      end
-
-      @allow_interruptions = allow_interruptions
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] min_interruption_duration_ms Value to be assigned
-    def min_interruption_duration_ms=(min_interruption_duration_ms)
-      if min_interruption_duration_ms.nil?
-        fail ArgumentError, 'min_interruption_duration_ms cannot be nil'
-      end
-
-      @min_interruption_duration_ms = min_interruption_duration_ms
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] silence_timeout_seconds Value to be assigned
-    def silence_timeout_seconds=(silence_timeout_seconds)
-      if silence_timeout_seconds.nil?
-        fail ArgumentError, 'silence_timeout_seconds cannot be nil'
-      end
-
-      @silence_timeout_seconds = silence_timeout_seconds
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] max_call_length_seconds Value to be assigned
-    def max_call_length_seconds=(max_call_length_seconds)
-      if max_call_length_seconds.nil?
-        fail ArgumentError, 'max_call_length_seconds cannot be nil'
-      end
-
-      @max_call_length_seconds = max_call_length_seconds
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -268,8 +174,7 @@ module Pingram
           allow_interruptions == o.allow_interruptions &&
           min_interruption_duration_ms == o.min_interruption_duration_ms &&
           silence_timeout_seconds == o.silence_timeout_seconds &&
-          max_call_length_seconds == o.max_call_length_seconds &&
-          agent_can_end_call == o.agent_can_end_call
+          max_call_length_seconds == o.max_call_length_seconds
     end
 
     # @see the `==` method
@@ -281,7 +186,7 @@ module Pingram
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [turn_detection, min_end_of_turn_silence_ms, allow_interruptions, min_interruption_duration_ms, silence_timeout_seconds, max_call_length_seconds, agent_can_end_call].hash
+      [turn_detection, min_end_of_turn_silence_ms, allow_interruptions, min_interruption_duration_ms, silence_timeout_seconds, max_call_length_seconds].hash
     end
 
     # Builds the object from hash

data/lib/pingram/models/agent_agent_model.rb

@@ -0,0 +1,108 @@
+=begin
+#Pingram
+
+#Internal API for notification delivery and management
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Pingram
+  # Configuration for which model processes the call, including its voice settings. `model` chooses the realtime model. `voiceId` must be a voice offered by that model.
+  module AgentAgentModel
+    class << self
+      # List of class defined in oneOf (OpenAPI v3)
+      def openapi_one_of
+        [
+          :'GoogleGemini31FlashLivePreview',
+          :'OpenaiGptLive1',
+          :'OpenaiGptRealtime21',
+          :'OpenaiGptRealtime21Mini',
+          :'XaiGrokVoiceLatest'
+        ]
+      end
+
+      # Builds the object
+      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @return [Object] Returns the model or the data itself
+      def build(data)
+        # Go through the list of oneOf items and attempt to identify the appropriate one.
+        # Note:
+        # - We do not attempt to check whether exactly one item matches.
+        # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+        #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+        # - TODO: scalar values are de facto behaving as if they were nullable.
+        # - TODO: logging when debugging is set.
+        openapi_one_of.each do |klass|
+          begin
+            next if klass == :AnyType # "nullable: true"
+            return find_and_cast_into_type(klass, data)
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+        end
+
+        openapi_one_of.include?(:AnyType) ? data : nil
+      end
+
+      private
+
+      SchemaMismatchError = Class.new(StandardError)
+
+      # Note: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+      def find_and_cast_into_type(klass, data)
+        return if data.nil?
+
+        case klass.to_s
+        when 'Boolean'
+          return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+        when 'Float'
+          return data if data.instance_of?(Float)
+        when 'Integer'
+          return data if data.instance_of?(Integer)
+        when 'Time'
+          return Time.parse(data)
+        when 'Date'
+          return Date.iso8601(data)
+        when 'String'
+          return data if data.instance_of?(String)
+        when 'Object' # "type: object"
+          return data if data.instance_of?(Hash)
+        when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+          if data.instance_of?(Array)
+            sub_type = Regexp.last_match[:sub_type]
+            return data.map { |item| find_and_cast_into_type(sub_type, item) }
+          end
+        when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+          if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+            sub_type = Regexp.last_match[:sub_type]
+            return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+          end
+        else # model
+          const = Pingram.const_get(klass)
+          if const
+            if const.respond_to?(:openapi_one_of) # nested oneOf model
+              model = const.build(data)
+              return model if model
+            else
+              # raise if data contains keys that are not known to the model
+              raise if const.respond_to?(:acceptable_attributes) && !(data.keys - const.acceptable_attributes).empty?
+              model = const.build_from_hash(data)
+              return model if model
+            end
+          end
+        end
+
+        raise # if no match by now, raise
+      rescue
+        raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
+      end
+    end
+  end
+
+end

data/lib/pingram/models/{bind_number_response_agent_spec_tools_inner.rb → agent_agent_tools_inner.rb}

@@ -14,16 +14,18 @@ require 'date'
 require 'time'
 
 module Pingram
-  module BindNumberResponseAgentSpecToolsInner
+  module AgentAgentToolsInner
     class << self
       # List of class defined in oneOf (OpenAPI v3)
       def openapi_one_of
         [
           :'Custom',
+          :'Disconnect',
           :'Dtmf',
           :'Knowledge',
           :'Mcp',
-          :'Transfer'
+          :'Transfer',
+          :'Weather'
         ]
       end
 

data/lib/pingram/models/{bind_number_response_agent_spec_variables_inner.rb → agent_agent_variables_inner.rb}

@@ -14,11 +14,14 @@ require 'date'
 require 'time'
 
 module Pingram
-  class BindNumberResponseAgentSpecVariablesInner < ApiModelBase
+  class AgentAgentVariablesInner < ApiModelBase
+    # Placeholder name used inside {{name}} tags.
     attr_accessor :name
 
+    # What the value means. Passed to the model with the filled value.
     attr_accessor :description
 
+    # Used when the call does not pass this variable.
     attr_accessor :default_value
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -59,14 +62,14 @@ module Pingram
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::BindNumberResponseAgentSpecVariablesInner` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::AgentAgentVariablesInner` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::BindNumberResponseAgentSpecVariablesInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::AgentAgentVariablesInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }

data/lib/pingram/models/{bind_number_request.rb → arm_voice_inbound_claim_request.rb}

@@ -14,13 +14,14 @@ require 'date'
 require 'time'
 
 module Pingram
-  class BindNumberRequest < ApiModelBase
-    attr_accessor :phone_number
+  # Playground request that arms the shared test number for the signed-in user's phone.
+  class ArmVoiceInboundClaimRequest < ApiModelBase
+    attr_accessor :inbound
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'phone_number' => :'phoneNumber'
+        :'inbound' => :'inbound'
       }
     end
 
@@ -37,7 +38,7 @@ module Pingram
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'phone_number' => :'String'
+        :'inbound' => :'ArmVoiceInboundClaimRequestInbound'
       }
     end
 
@@ -51,22 +52,22 @@ module Pingram
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::BindNumberRequest` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Pingram::ArmVoiceInboundClaimRequest` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::BindNumberRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Pingram::ArmVoiceInboundClaimRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'phone_number')
-        self.phone_number = attributes[:'phone_number']
+      if attributes.key?(:'inbound')
+        self.inbound = attributes[:'inbound']
       else
-        self.phone_number = nil
+        self.inbound = nil
       end
     end
 
@@ -75,8 +76,8 @@ module Pingram
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @phone_number.nil?
-        invalid_properties.push('invalid value for "phone_number", phone_number cannot be nil.')
+      if @inbound.nil?
+        invalid_properties.push('invalid value for "inbound", inbound cannot be nil.')
       end
 
       invalid_properties
@@ -86,18 +87,18 @@ module Pingram
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @phone_number.nil?
+      return false if @inbound.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] phone_number Value to be assigned
-    def phone_number=(phone_number)
-      if phone_number.nil?
-        fail ArgumentError, 'phone_number cannot be nil'
+    # @param [Object] inbound Value to be assigned
+    def inbound=(inbound)
+      if inbound.nil?
+        fail ArgumentError, 'inbound cannot be nil'
       end
 
-      @phone_number = phone_number
+      @inbound = inbound
     end
 
     # Checks equality by comparing each attribute.
@@ -105,7 +106,7 @@ module Pingram
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          phone_number == o.phone_number
+          inbound == o.inbound
     end
 
     # @see the `==` method
@@ -117,7 +118,7 @@ module Pingram
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [phone_number].hash
+      [inbound].hash
     end
 
     # Builds the object from hash

data/lib/pingram/models/{bind_number_response_agent_spec_model.rb → arm_voice_inbound_claim_request_inbound.rb}

@@ -14,14 +14,15 @@ require 'date'
 require 'time'
 
 module Pingram
-  # Speech pipeline. Prefer s2s mode (e.g. `openai:gpt-realtime` with voice `marin`).
-  module BindNumberResponseAgentSpecModel
+  module ArmVoiceInboundClaimRequestInbound
     class << self
       # List of class defined in oneOf (OpenAPI v3)
       def openapi_one_of
         [
-          :'Chained',
-          :'S2s'
+          :'Agent',
+          :'Disabled',
+          :'Script',
+          :'Transfer1'
         ]
       end