vellum_ai 0.3.4

data/lib/vellum_ai/types/fulfilled_workflow_node_result_event.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "workflow_node_result_data"
+require_relative "node_output_compiled_value"
+require "json"
+
+module Vellum
+  # An event that indicates that the node has fulfilled its execution.
+  class FulfilledWorkflowNodeResultEvent
+    attr_reader :id, :node_id, :node_result_id, :ts, :data, :output_values, :additional_properties
+
+    # @param id [String]
+    # @param node_id [String]
+    # @param node_result_id [String]
+    # @param ts [DateTime]
+    # @param data [WorkflowNodeResultData]
+    # @param output_values [Array<NodeOutputCompiledValue>]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FulfilledWorkflowNodeResultEvent]
+    def initialize(id:, node_id:, node_result_id:, ts: nil, data: nil, output_values: nil, additional_properties: nil)
+      # @type [String]
+      @id = id
+      # @type [String]
+      @node_id = node_id
+      # @type [String]
+      @node_result_id = node_result_id
+      # @type [DateTime]
+      @ts = ts
+      # @type [WorkflowNodeResultData]
+      @data = data
+      # @type [Array<NodeOutputCompiledValue>]
+      @output_values = output_values
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FulfilledWorkflowNodeResultEvent
+    #
+    # @param json_object [JSON]
+    # @return [FulfilledWorkflowNodeResultEvent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      id = struct.id
+      node_id = struct.node_id
+      node_result_id = struct.node_result_id
+      ts = DateTime.parse(parsed_json["ts"])
+      if parsed_json["data"].nil?
+        data = nil
+      else
+        data = parsed_json["data"].to_json
+        data = WorkflowNodeResultData.from_json(json_object: data)
+      end
+      output_values = parsed_json["output_values"].map do |v|
+        v = v.to_json
+        NodeOutputCompiledValue.from_json(json_object: v)
+      end
+      new(id: id, node_id: node_id, node_result_id: node_result_id, ts: ts, data: data, output_values: output_values,
+          additional_properties: struct)
+    end
+
+    # Serialize an instance of FulfilledWorkflowNodeResultEvent to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      {
+        "id": @id,
+        "node_id": @node_id,
+        "node_result_id": @node_result_id,
+        "ts": @ts,
+        "data": @data,
+        "output_values": @output_values
+      }.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.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
+      obj.node_id.is_a?(String) != false || raise("Passed value for field obj.node_id is not the expected type, validation failed.")
+      obj.node_result_id.is_a?(String) != false || raise("Passed value for field obj.node_result_id is not the expected type, validation failed.")
+      obj.ts&.is_a?(DateTime) != false || raise("Passed value for field obj.ts is not the expected type, validation failed.")
+      obj.data.nil? || WorkflowNodeResultData.validate_raw(obj: obj.data)
+      obj.output_values&.is_a?(Array) != false || raise("Passed value for field obj.output_values is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/function_call.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "fulfilled_function_call"
+require_relative "rejected_function_call"
+
+module Vellum
+  class FunctionCall
+    attr_reader :member, :discriminant
+
+    private_class_method :new
+    alias kind_of? is_a?
+    # @param member [Object]
+    # @param discriminant [String]
+    # @return [FunctionCall]
+    def initialize(member:, discriminant:)
+      # @type [Object]
+      @member = member
+      # @type [String]
+      @discriminant = discriminant
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCall
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCall]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      member = case struct.state
+               when "FULFILLED"
+                 FulfilledFunctionCall.from_json(json_object: json_object)
+               when "REJECTED"
+                 RejectedFunctionCall.from_json(json_object: json_object)
+               else
+                 FulfilledFunctionCall.from_json(json_object: json_object)
+               end
+      new(member: member, discriminant: struct.state)
+    end
+
+    # For Union Types, to_json functionality is delegated to the wrapped member.
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      case @discriminant
+      when "FULFILLED"
+        { **@member.to_json, state: @discriminant }.to_json
+      when "REJECTED"
+        { **@member.to_json, state: @discriminant }.to_json
+      else
+        { "state": @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.state
+      when "FULFILLED"
+        FulfilledFunctionCall.validate_raw(obj: obj)
+      when "REJECTED"
+        RejectedFunctionCall.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 [FulfilledFunctionCall]
+    # @return [FunctionCall]
+    def self.fulfilled(member:)
+      new(member: member, discriminant: "FULFILLED")
+    end
+
+    # @param member [RejectedFunctionCall]
+    # @return [FunctionCall]
+    def self.rejected(member:)
+      new(member: member, discriminant: "REJECTED")
+    end
+  end
+end

data/lib/vellum_ai/types/function_call_chat_message_content.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "function_call_chat_message_content_value"
+require "json"
+
+module Vellum
+  # A function call value that is used in a chat message.
+  class FunctionCallChatMessageContent
+    attr_reader :value, :additional_properties
+
+    # @param value [FunctionCallChatMessageContentValue]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FunctionCallChatMessageContent]
+    def initialize(value:, additional_properties: nil)
+      # @type [FunctionCallChatMessageContentValue]
+      @value = value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCallChatMessageContent
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCallChatMessageContent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      if parsed_json["value"].nil?
+        value = nil
+      else
+        value = parsed_json["value"].to_json
+        value = FunctionCallChatMessageContentValue.from_json(json_object: value)
+      end
+      new(value: value, additional_properties: struct)
+    end
+
+    # Serialize an instance of FunctionCallChatMessageContent to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "value": @value }.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:)
+      FunctionCallChatMessageContentValue.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/function_call_chat_message_content_request.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "function_call_chat_message_content_value_request"
+require "json"
+
+module Vellum
+  # A function call value that is used in a chat message.
+  class FunctionCallChatMessageContentRequest
+    attr_reader :value, :additional_properties
+
+    # @param value [FunctionCallChatMessageContentValueRequest]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FunctionCallChatMessageContentRequest]
+    def initialize(value:, additional_properties: nil)
+      # @type [FunctionCallChatMessageContentValueRequest]
+      @value = value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCallChatMessageContentRequest
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCallChatMessageContentRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      if parsed_json["value"].nil?
+        value = nil
+      else
+        value = parsed_json["value"].to_json
+        value = FunctionCallChatMessageContentValueRequest.from_json(json_object: value)
+      end
+      new(value: value, additional_properties: struct)
+    end
+
+    # Serialize an instance of FunctionCallChatMessageContentRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "value": @value }.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:)
+      FunctionCallChatMessageContentValueRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/function_call_chat_message_content_value.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Vellum
+  # The final resolved function call value.
+  class FunctionCallChatMessageContentValue
+    attr_reader :name, :arguments, :id, :additional_properties
+
+    # @param name [String]
+    # @param arguments [Hash{String => String}]
+    # @param id [String]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FunctionCallChatMessageContentValue]
+    def initialize(name:, arguments:, id: nil, additional_properties: nil)
+      # @type [String]
+      @name = name
+      # @type [Hash{String => String}]
+      @arguments = arguments
+      # @type [String]
+      @id = id
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCallChatMessageContentValue
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCallChatMessageContentValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      JSON.parse(json_object)
+      name = struct.name
+      arguments = struct.arguments
+      id = struct.id
+      new(name: name, arguments: arguments, id: id, additional_properties: struct)
+    end
+
+    # Serialize an instance of FunctionCallChatMessageContentValue to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "name": @name, "arguments": @arguments, "id": @id }.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.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.arguments.is_a?(Hash) != false || raise("Passed value for field obj.arguments 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.")
+    end
+  end
+end

data/lib/vellum_ai/types/function_call_chat_message_content_value_request.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Vellum
+  # The final resolved function call value.
+  class FunctionCallChatMessageContentValueRequest
+    attr_reader :name, :arguments, :id, :additional_properties
+
+    # @param name [String]
+    # @param arguments [Hash{String => String}]
+    # @param id [String]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FunctionCallChatMessageContentValueRequest]
+    def initialize(name:, arguments:, id: nil, additional_properties: nil)
+      # @type [String]
+      @name = name
+      # @type [Hash{String => String}]
+      @arguments = arguments
+      # @type [String]
+      @id = id
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCallChatMessageContentValueRequest
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCallChatMessageContentValueRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      JSON.parse(json_object)
+      name = struct.name
+      arguments = struct.arguments
+      id = struct.id
+      new(name: name, arguments: arguments, id: id, additional_properties: struct)
+    end
+
+    # Serialize an instance of FunctionCallChatMessageContentValueRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "name": @name, "arguments": @arguments, "id": @id }.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.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.arguments.is_a?(Hash) != false || raise("Passed value for field obj.arguments 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.")
+    end
+  end
+end

data/lib/vellum_ai/types/function_call_enum.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Vellum
+  FUNCTION_CALL_ENUM = String
+end

data/lib/vellum_ai/types/function_call_variable_value.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "function_call"
+require "json"
+
+module Vellum
+  class FunctionCallVariableValue
+    attr_reader :value, :additional_properties
+
+    # @param value [FunctionCall]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [FunctionCallVariableValue]
+    def initialize(value:, additional_properties: nil)
+      # @type [FunctionCall]
+      @value = value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of FunctionCallVariableValue
+    #
+    # @param json_object [JSON]
+    # @return [FunctionCallVariableValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      if parsed_json["value"].nil?
+        value = nil
+      else
+        value = parsed_json["value"].to_json
+        value = FunctionCall.from_json(json_object: value)
+      end
+      new(value: value, additional_properties: struct)
+    end
+
+    # Serialize an instance of FunctionCallVariableValue to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "value": @value }.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:)
+      FunctionCall.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/generate_error_response.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Vellum
+  class GenerateErrorResponse
+    attr_reader :detail, :additional_properties
+
+    # @param detail [String] Details about why the request failed.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [GenerateErrorResponse]
+    def initialize(detail:, additional_properties: nil)
+      # @type [String] Details about why the request failed.
+      @detail = detail
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of GenerateErrorResponse
+    #
+    # @param json_object [JSON]
+    # @return [GenerateErrorResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      JSON.parse(json_object)
+      detail = struct.detail
+      new(detail: detail, additional_properties: struct)
+    end
+
+    # Serialize an instance of GenerateErrorResponse to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "detail": @detail }.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.detail.is_a?(String) != false || raise("Passed value for field obj.detail is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/generate_options_request.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative "logprobs_enum"
+require "json"
+
+module Vellum
+  class GenerateOptionsRequest
+    attr_reader :logprobs, :additional_properties
+
+    # @param logprobs [LOGPROBS_ENUM] Which logprobs to include, if any. Defaults to NONE.
+    #   - `ALL` - ALL
+    #   - `NONE` - NONE
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [GenerateOptionsRequest]
+    def initialize(logprobs: nil, additional_properties: nil)
+      # @type [LOGPROBS_ENUM] Which logprobs to include, if any. Defaults to NONE.
+      #   - `ALL` - ALL
+      #   - `NONE` - NONE
+      @logprobs = logprobs
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of GenerateOptionsRequest
+    #
+    # @param json_object [JSON]
+    # @return [GenerateOptionsRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      logprobs = LOGPROBS_ENUM.key(parsed_json["logprobs"]) || parsed_json["logprobs"]
+      new(logprobs: logprobs, additional_properties: struct)
+    end
+
+    # Serialize an instance of GenerateOptionsRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "logprobs": LOGPROBS_ENUM[@logprobs] || @logprobs }.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.logprobs&.is_a?(LOGPROBS_ENUM) != false || raise("Passed value for field obj.logprobs is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/generate_request.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require_relative "chat_message_request"
+require "json"
+
+module Vellum
+  class GenerateRequest
+    attr_reader :input_values, :chat_history, :external_ids, :additional_properties
+
+    # @param input_values [Hash{String => String}] Key/value pairs for each template variable defined in the deployment's prompt.
+    # @param chat_history [Array<ChatMessageRequest>] Optionally provide a list of chat messages that'll be used in place of the special {$chat_history} variable, if included in the prompt.
+    # @param external_ids [Array<String>] Optionally include a unique identifier for each generation, as represented outside of Vellum. Note that this should generally be a list of length one.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [GenerateRequest]
+    def initialize(input_values:, chat_history: nil, external_ids: nil, additional_properties: nil)
+      # @type [Hash{String => String}] Key/value pairs for each template variable defined in the deployment's prompt.
+      @input_values = input_values
+      # @type [Array<ChatMessageRequest>] Optionally provide a list of chat messages that'll be used in place of the special {$chat_history} variable, if included in the prompt.
+      @chat_history = chat_history
+      # @type [Array<String>] Optionally include a unique identifier for each generation, as represented outside of Vellum. Note that this should generally be a list of length one.
+      @external_ids = external_ids
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of GenerateRequest
+    #
+    # @param json_object [JSON]
+    # @return [GenerateRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      input_values = struct.input_values
+      chat_history = parsed_json["chat_history"].map do |v|
+        v = v.to_json
+        ChatMessageRequest.from_json(json_object: v)
+      end
+      external_ids = struct.external_ids
+      new(input_values: input_values, chat_history: chat_history, external_ids: external_ids,
+          additional_properties: struct)
+    end
+
+    # Serialize an instance of GenerateRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "input_values": @input_values, "chat_history": @chat_history, "external_ids": @external_ids }.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.input_values.is_a?(Hash) != false || raise("Passed value for field obj.input_values is not the expected type, validation failed.")
+      obj.chat_history&.is_a?(Array) != false || raise("Passed value for field obj.chat_history is not the expected type, validation failed.")
+      obj.external_ids&.is_a?(Array) != false || raise("Passed value for field obj.external_ids is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/generate_response.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "generate_result"
+require "json"
+
+module Vellum
+  class GenerateResponse
+    attr_reader :results, :additional_properties
+
+    # @param results [Array<GenerateResult>] The results of each generation request.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [GenerateResponse]
+    def initialize(results:, additional_properties: nil)
+      # @type [Array<GenerateResult>] The results of each generation request.
+      @results = results
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of GenerateResponse
+    #
+    # @param json_object [JSON]
+    # @return [GenerateResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      results = parsed_json["results"].map do |v|
+        v = v.to_json
+        GenerateResult.from_json(json_object: v)
+      end
+      new(results: results, additional_properties: struct)
+    end
+
+    # Serialize an instance of GenerateResponse to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "results": @results }.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.results.is_a?(Array) != false || raise("Passed value for field obj.results is not the expected type, validation failed.")
+    end
+  end
+end