vellum_ai 0.3.4

data/lib/vellum_ai/types/vellum_image.rb

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

data/lib/vellum_ai/types/vellum_image_request.rb

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

data/lib/vellum_ai/types/vellum_variable.rb

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

data/lib/vellum_ai/types/vellum_variable_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Vellum
+  # @type [VELLUM_VARIABLE_TYPE]
+  VELLUM_VARIABLE_TYPE = {
+    string: "STRING",
+    number: "NUMBER",
+    json: "JSON",
+    chat_history: "CHAT_HISTORY",
+    search_results: "SEARCH_RESULTS",
+    error: "ERROR",
+    array: "ARRAY",
+    function_call: "FUNCTION_CALL",
+    image: "IMAGE"
+  }.freeze
+end

data/lib/vellum_ai/types/workflow_event_error.rb

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

data/lib/vellum_ai/types/workflow_execution_actual_chat_history_request.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative "chat_message_request"
+require "json"
+
+module Vellum
+  class WorkflowExecutionActualChatHistoryRequest
+    attr_reader :output_id, :output_key, :quality, :timestamp, :desired_output_value, :additional_properties
+
+    # @param output_id [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    # @param output_key [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    # @param quality [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    # @param timestamp [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    # @param desired_output_value [Array<ChatMessageRequest>] Optionally provide the value that the output ideally should have been.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [WorkflowExecutionActualChatHistoryRequest]
+    def initialize(output_id: nil, output_key: nil, quality: nil, timestamp: nil, desired_output_value: nil,
+                   additional_properties: nil)
+      # @type [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+      @output_id = output_id
+      # @type [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+      @output_key = output_key
+      # @type [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+      @quality = quality
+      # @type [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+      @timestamp = timestamp
+      # @type [Array<ChatMessageRequest>] Optionally provide the value that the output ideally should have been.
+      @desired_output_value = desired_output_value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of WorkflowExecutionActualChatHistoryRequest
+    #
+    # @param json_object [JSON]
+    # @return [WorkflowExecutionActualChatHistoryRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      output_id = struct.output_id
+      output_key = struct.output_key
+      quality = struct.quality
+      timestamp = struct.timestamp
+      desired_output_value = parsed_json["desired_output_value"].map do |v|
+        v = v.to_json
+        ChatMessageRequest.from_json(json_object: v)
+      end
+      new(output_id: output_id, output_key: output_key, quality: quality, timestamp: timestamp,
+          desired_output_value: desired_output_value, additional_properties: struct)
+    end
+
+    # Serialize an instance of WorkflowExecutionActualChatHistoryRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      {
+        "output_id": @output_id,
+        "output_key": @output_key,
+        "quality": @quality,
+        "timestamp": @timestamp,
+        "desired_output_value": @desired_output_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:)
+      obj.output_id&.is_a?(String) != false || raise("Passed value for field obj.output_id is not the expected type, validation failed.")
+      obj.output_key&.is_a?(String) != false || raise("Passed value for field obj.output_key is not the expected type, validation failed.")
+      obj.quality&.is_a?(Float) != false || raise("Passed value for field obj.quality is not the expected type, validation failed.")
+      obj.timestamp&.is_a?(Float) != false || raise("Passed value for field obj.timestamp is not the expected type, validation failed.")
+      obj.desired_output_value&.is_a?(Array) != false || raise("Passed value for field obj.desired_output_value is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_execution_actual_json_request.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Vellum
+  class WorkflowExecutionActualJsonRequest
+    attr_reader :output_id, :output_key, :quality, :timestamp, :desired_output_value, :additional_properties
+
+    # @param output_id [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    # @param output_key [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    # @param quality [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    # @param timestamp [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    # @param desired_output_value [Hash{String => String}] Optionally provide the value that the output ideally should have been.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [WorkflowExecutionActualJsonRequest]
+    def initialize(output_id: nil, output_key: nil, quality: nil, timestamp: nil, desired_output_value: nil,
+                   additional_properties: nil)
+      # @type [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+      @output_id = output_id
+      # @type [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+      @output_key = output_key
+      # @type [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+      @quality = quality
+      # @type [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+      @timestamp = timestamp
+      # @type [Hash{String => String}] Optionally provide the value that the output ideally should have been.
+      @desired_output_value = desired_output_value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of WorkflowExecutionActualJsonRequest
+    #
+    # @param json_object [JSON]
+    # @return [WorkflowExecutionActualJsonRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      JSON.parse(json_object)
+      output_id = struct.output_id
+      output_key = struct.output_key
+      quality = struct.quality
+      timestamp = struct.timestamp
+      desired_output_value = struct.desired_output_value
+      new(output_id: output_id, output_key: output_key, quality: quality, timestamp: timestamp,
+          desired_output_value: desired_output_value, additional_properties: struct)
+    end
+
+    # Serialize an instance of WorkflowExecutionActualJsonRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      {
+        "output_id": @output_id,
+        "output_key": @output_key,
+        "quality": @quality,
+        "timestamp": @timestamp,
+        "desired_output_value": @desired_output_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:)
+      obj.output_id&.is_a?(String) != false || raise("Passed value for field obj.output_id is not the expected type, validation failed.")
+      obj.output_key&.is_a?(String) != false || raise("Passed value for field obj.output_key is not the expected type, validation failed.")
+      obj.quality&.is_a?(Float) != false || raise("Passed value for field obj.quality is not the expected type, validation failed.")
+      obj.timestamp&.is_a?(Float) != false || raise("Passed value for field obj.timestamp is not the expected type, validation failed.")
+      obj.desired_output_value&.is_a?(Hash) != false || raise("Passed value for field obj.desired_output_value is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_execution_actual_string_request.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Vellum
+  class WorkflowExecutionActualStringRequest
+    attr_reader :output_id, :output_key, :quality, :timestamp, :desired_output_value, :additional_properties
+
+    # @param output_id [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+    # @param output_key [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+    # @param quality [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+    # @param timestamp [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+    # @param desired_output_value [String] Optionally provide the value that the output ideally should have been.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [WorkflowExecutionActualStringRequest]
+    def initialize(output_id: nil, output_key: nil, quality: nil, timestamp: nil, desired_output_value: nil,
+                   additional_properties: nil)
+      # @type [String] The Vellum-generated ID of a workflow output. Must provide either this or output_key. output_key is typically preferred.
+      @output_id = output_id
+      # @type [String] The user-defined name of a workflow output. Must provide either this or output_id. Should correspond to the `Name` specified in a Final Output Node. Generally preferred over output_id.
+      @output_key = output_key
+      # @type [Float] Optionally provide a decimal number between 0.0 and 1.0 (inclusive) representing the quality of the output. 0 is the worst, 1 is the best.
+      @quality = quality
+      # @type [Float] Optionally provide the timestamp representing when this feedback was collected. Used for reporting purposes.
+      @timestamp = timestamp
+      # @type [String] Optionally provide the value that the output ideally should have been.
+      @desired_output_value = desired_output_value
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of WorkflowExecutionActualStringRequest
+    #
+    # @param json_object [JSON]
+    # @return [WorkflowExecutionActualStringRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      JSON.parse(json_object)
+      output_id = struct.output_id
+      output_key = struct.output_key
+      quality = struct.quality
+      timestamp = struct.timestamp
+      desired_output_value = struct.desired_output_value
+      new(output_id: output_id, output_key: output_key, quality: quality, timestamp: timestamp,
+          desired_output_value: desired_output_value, additional_properties: struct)
+    end
+
+    # Serialize an instance of WorkflowExecutionActualStringRequest to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      {
+        "output_id": @output_id,
+        "output_key": @output_key,
+        "quality": @quality,
+        "timestamp": @timestamp,
+        "desired_output_value": @desired_output_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:)
+      obj.output_id&.is_a?(String) != false || raise("Passed value for field obj.output_id is not the expected type, validation failed.")
+      obj.output_key&.is_a?(String) != false || raise("Passed value for field obj.output_key is not the expected type, validation failed.")
+      obj.quality&.is_a?(Float) != false || raise("Passed value for field obj.quality is not the expected type, validation failed.")
+      obj.timestamp&.is_a?(Float) != false || raise("Passed value for field obj.timestamp is not the expected type, validation failed.")
+      obj.desired_output_value&.is_a?(String) != false || raise("Passed value for field obj.desired_output_value is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_execution_event_error_code.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Vellum
+  # @type [WORKFLOW_EXECUTION_EVENT_ERROR_CODE]
+  WORKFLOW_EXECUTION_EVENT_ERROR_CODE = {
+    workflow_initialization: "WORKFLOW_INITIALIZATION",
+    node_execution_count_limit_reached: "NODE_EXECUTION_COUNT_LIMIT_REACHED",
+    internal_server_error: "INTERNAL_SERVER_ERROR",
+    node_execution: "NODE_EXECUTION",
+    llm_provider: "LLM_PROVIDER",
+    invalid_template: "INVALID_TEMPLATE"
+  }.freeze
+end

data/lib/vellum_ai/types/workflow_execution_event_type.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Vellum
+  # @type [WORKFLOW_EXECUTION_EVENT_TYPE]
+  WORKFLOW_EXECUTION_EVENT_TYPE = { node: "NODE", workflow: "WORKFLOW" }.freeze
+end

data/lib/vellum_ai/types/workflow_execution_node_result_event.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative "workflow_node_result_event"
+require "json"
+
+module Vellum
+  # A NODE-level event emitted from the workflow's execution.
+  class WorkflowExecutionNodeResultEvent
+    attr_reader :execution_id, :run_id, :external_id, :data, :additional_properties
+
+    # @param execution_id [String]
+    # @param run_id [String]
+    # @param external_id [String]
+    # @param data [WorkflowNodeResultEvent]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [WorkflowExecutionNodeResultEvent]
+    def initialize(execution_id:, data:, run_id: nil, external_id: nil, additional_properties: nil)
+      # @type [String]
+      @execution_id = execution_id
+      # @type [String]
+      @run_id = run_id
+      # @type [String]
+      @external_id = external_id
+      # @type [WorkflowNodeResultEvent]
+      @data = data
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of WorkflowExecutionNodeResultEvent
+    #
+    # @param json_object [JSON]
+    # @return [WorkflowExecutionNodeResultEvent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      execution_id = struct.execution_id
+      run_id = struct.run_id
+      external_id = struct.external_id
+      if parsed_json["data"].nil?
+        data = nil
+      else
+        data = parsed_json["data"].to_json
+        data = WorkflowNodeResultEvent.from_json(json_object: data)
+      end
+      new(execution_id: execution_id, run_id: run_id, external_id: external_id, data: data,
+          additional_properties: struct)
+    end
+
+    # Serialize an instance of WorkflowExecutionNodeResultEvent to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "execution_id": @execution_id, "run_id": @run_id, "external_id": @external_id, "data": @data }.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.execution_id.is_a?(String) != false || raise("Passed value for field obj.execution_id is not the expected type, validation failed.")
+      obj.run_id&.is_a?(String) != false || raise("Passed value for field obj.run_id is not the expected type, validation failed.")
+      obj.external_id&.is_a?(String) != false || raise("Passed value for field obj.external_id is not the expected type, validation failed.")
+      WorkflowNodeResultEvent.validate_raw(obj: obj.data)
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_execution_workflow_result_event.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative "workflow_result_event"
+require "json"
+
+module Vellum
+  # A WORKFLOW-level event emitted from the workflow's execution.
+  class WorkflowExecutionWorkflowResultEvent
+    attr_reader :execution_id, :run_id, :external_id, :data, :additional_properties
+
+    # @param execution_id [String]
+    # @param run_id [String]
+    # @param external_id [String]
+    # @param data [WorkflowResultEvent]
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [WorkflowExecutionWorkflowResultEvent]
+    def initialize(execution_id:, data:, run_id: nil, external_id: nil, additional_properties: nil)
+      # @type [String]
+      @execution_id = execution_id
+      # @type [String]
+      @run_id = run_id
+      # @type [String]
+      @external_id = external_id
+      # @type [WorkflowResultEvent]
+      @data = data
+      # @type [OpenStruct] Additional properties unmapped to the current class definition
+      @additional_properties = additional_properties
+    end
+
+    # Deserialize a JSON object to an instance of WorkflowExecutionWorkflowResultEvent
+    #
+    # @param json_object [JSON]
+    # @return [WorkflowExecutionWorkflowResultEvent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      execution_id = struct.execution_id
+      run_id = struct.run_id
+      external_id = struct.external_id
+      if parsed_json["data"].nil?
+        data = nil
+      else
+        data = parsed_json["data"].to_json
+        data = WorkflowResultEvent.from_json(json_object: data)
+      end
+      new(execution_id: execution_id, run_id: run_id, external_id: external_id, data: data,
+          additional_properties: struct)
+    end
+
+    # Serialize an instance of WorkflowExecutionWorkflowResultEvent to a JSON object
+    #
+    # @return [JSON]
+    def to_json(*_args)
+      { "execution_id": @execution_id, "run_id": @run_id, "external_id": @external_id, "data": @data }.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.execution_id.is_a?(String) != false || raise("Passed value for field obj.execution_id is not the expected type, validation failed.")
+      obj.run_id&.is_a?(String) != false || raise("Passed value for field obj.run_id is not the expected type, validation failed.")
+      obj.external_id&.is_a?(String) != false || raise("Passed value for field obj.external_id is not the expected type, validation failed.")
+      WorkflowResultEvent.validate_raw(obj: obj.data)
+    end
+  end
+end