vellum_ai 1.10.8 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce3b072bd934564cef4ce8389a1fd4efc9be44dc698613bbc448fb1191f18a78
-  data.tar.gz: 123d7c862c7ba0a013d559d36fcf75731b0748008a1eb99a5788c0a2eeb665a6
+  metadata.gz: ccd1ca7ad21297e3886feaa9a31a00d06ca1a68f4d33454b9496f9fce2283e31
+  data.tar.gz: 6cbf944cf1ea593d32bee316e1dc89ba34e73f1847dab9952151cebce3c84b1e
 SHA512:
-  metadata.gz: b20c1d84e654ea8033b78327101ddf352e42b636816655f02c2ac4634f6b8302a59726a2ba03a85ec0adc7004c9b95750ea13c72a729c9aca53e132e42dd3eb1
-  data.tar.gz: 6e6414f64d011a5bc20b71f40786432523f7aaf5fa9f0022675b9310d6697f94df122a0464c1a33e9dfa4506645778ad09c17f7032b40c8e6ebd43e977d260ef
+  metadata.gz: 4cd470bfd9abd70f0d114aeed273e423e6f27097ed5158e6e666945e9f29148d3619906e7950ed661ebef862711d6a1c1c2b564760c6f2e172087087048025ed
+  data.tar.gz: 4a017b28dd6158ab7b994b545cd96a58823af8835cb00358d4078dc0ed6dd63451613419e7cda59598923824ddb6983f5b7d3bc42a611c3aa284f9b585b277b4

data/lib/requests.rb

@@ -56,7 +56,7 @@ end
     end
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.10.8' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.11.0' }
       headers["X-API-KEY"] = ((@api_key.is_a? Method) ? @api_key.call : @api_key) unless @api_key.nil?
  headers
     end
@@ -107,7 +107,7 @@ end
     end
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.10.8' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.11.0' }
       headers["X-API-KEY"] = ((@api_key.is_a? Method) ? @api_key.call : @api_key) unless @api_key.nil?
  headers
     end

data/lib/types_export.rb

@@ -187,6 +187,7 @@ require_relative "vellum_ai/types/rejected_execute_prompt_response"
 require_relative "vellum_ai/types/execute_prompt_response"
 require_relative "vellum_ai/types/components_schemas_composio_execute_tool_request"
 require_relative "vellum_ai/types/components_schemas_composio_execute_tool_response"
+require_relative "vellum_ai/types/execute_workflow_async_response"
 require_relative "vellum_ai/types/execute_workflow_response"
 require_relative "vellum_ai/types/fulfilled_execute_workflow_workflow_result_event"
 require_relative "vellum_ai/types/rejected_execute_workflow_workflow_result_event"
@@ -704,6 +705,7 @@ require_relative "vellum_ai/types/workflow_result_event_output_data_array"
 require_relative "vellum_ai/types/workflow_result_event_output_data_function_call"
 require_relative "vellum_ai/types/workflow_result_event_output_data_error"
 require_relative "vellum_ai/types/workflow_result_event_output_data"
+require_relative "vellum_ai/types/workflow_result_event_state"
 require_relative "vellum_ai/types/workflow_sandbox_display_data"
 require_relative "vellum_ai/types/workflow_sandbox_example"
 require_relative "vellum_ai/types/workflow_stream_event"

data/lib/vellum_ai/types/execute_workflow_async_response.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+# The response from an async Workflow Deployment execution.
+  class ExecuteWorkflowAsyncResponse
+  # @return [String] The ID of the workflow execution.
+    attr_reader :execution_id
+  # @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 execution_id [String] The ID of the workflow execution.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    def initialize(execution_id:, additional_properties: nil)
+      @execution_id = execution_id
+      @additional_properties = additional_properties
+      @_field_set = { "execution_id": execution_id }
+    end
+# Deserialize a JSON object to an instance of ExecuteWorkflowAsyncResponse
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      execution_id = parsed_json["execution_id"]
+      new(execution_id: execution_id, additional_properties: struct)
+    end
+# Serialize an instance of ExecuteWorkflowAsyncResponse to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_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.execution_id.is_a?(String) != false || raise("Passed value for field obj.execution_id is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_node_result_event_state.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 module Vellum
-# * `INITIATED` - Initiated
-#  * `STREAMING` - Streaming
-#  * `FULFILLED` - Fulfilled
-#  * `REJECTED` - Rejected
+# * `INITIATED` - INITIATED
+#  * `STREAMING` - STREAMING
+#  * `FULFILLED` - FULFILLED
+#  * `REJECTED` - REJECTED
   class WorkflowNodeResultEventState
 
     INITIATED = "INITIATED"

data/lib/vellum_ai/types/workflow_result_event.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
-require_relative "workflow_node_result_event_state"
+require_relative "workflow_result_event_state"
 require "date"
 require_relative "workflow_result_event_output_data"
 require_relative "workflow_event_error"
@@ -12,7 +12,7 @@ module Vellum
   class WorkflowResultEvent
   # @return [String] 
     attr_reader :id
-  # @return [Vellum::WorkflowNodeResultEventState] 
+  # @return [Vellum::WorkflowResultEventState] 
     attr_reader :state
   # @return [DateTime] 
     attr_reader :ts
@@ -33,7 +33,7 @@ module Vellum
     OMIT = Object.new
 
     # @param id [String] 
-    # @param state [Vellum::WorkflowNodeResultEventState] 
+    # @param state [Vellum::WorkflowResultEventState] 
     # @param ts [DateTime] 
     # @param output [Vellum::WorkflowResultEventOutputData] 
     # @param error [Vellum::WorkflowEventError] 
@@ -113,7 +113,7 @@ end
     # @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.state.is_a?(Vellum::WorkflowNodeResultEventState) != false || raise("Passed value for field obj.state is not the expected type, validation failed.")
+      obj.state.is_a?(Vellum::WorkflowResultEventState) != false || raise("Passed value for field obj.state 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.output.nil? || Vellum::WorkflowResultEventOutputData.validate_raw(obj: obj.output)
       obj.error.nil? || Vellum::WorkflowEventError.validate_raw(obj: obj.error)

data/lib/vellum_ai/types/workflow_result_event_state.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Vellum
+# * `INITIATED` - Initiated
+#  * `STREAMING` - Streaming
+#  * `FULFILLED` - Fulfilled
+#  * `REJECTED` - Rejected
+#  * `PENDING` - Pending
+  class WorkflowResultEventState
+
+    INITIATED = "INITIATED"
+    STREAMING = "STREAMING"
+    FULFILLED = "FULFILLED"
+    REJECTED = "REJECTED"
+    PENDING = "PENDING"
+
+  end
+end

data/lib/vellum_ai.rb

@@ -44,6 +44,7 @@ require_relative "vellum_ai/types/execute_prompt_response"
 require_relative "vellum_ai/types/workflow_request_input_request"
 require_relative "vellum_ai/types/workflow_expand_meta_request"
 require_relative "vellum_ai/types/execute_workflow_response"
+require_relative "vellum_ai/types/execute_workflow_async_response"
 require_relative "vellum_ai/types/generate_request"
 require_relative "vellum_ai/types/generate_options_request"
 require_relative "vellum_ai/types/generate_response"
@@ -348,6 +349,53 @@ end
 end
       Vellum::ExecuteWorkflowResponse.from_json(json_object: response.body)
     end
+# Executes a deployed Workflow asynchronously and returns the execution ID.
+    #
+    # @param inputs [Array<Hash>] The list of inputs defined in the Workflow's Deployment with their corresponding
+#  values.Request of type Array<Vellum::WorkflowRequestInputRequest>, as a Hash
+    # @param workflow_deployment_id [String] The ID of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_name.
+    # @param workflow_deployment_name [String] The name of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_id.
+    # @param release_tag [String] Optionally specify a release tag if you want to pin to a specific release of the
+#  Workflow Deployment
+    # @param external_id [String] Optionally include a unique identifier for tracking purposes. Must be unique
+#  within a given Workspace.
+    # @param previous_execution_id [String] The ID of a previous Workflow Execution to reference for initial State loading.
+    # @param metadata [Hash{String => Object}] Arbitrary JSON metadata associated with this request. Can be used to capture
+#  additional monitoring data such as user id, session id, etc. for future
+#  analysis.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.execute_workflow_async(inputs: [{ name: "x", type: "STRING", value: "value" }, { name: "x", type: "STRING", value: "value" }])
+    def execute_workflow_async(inputs:, workflow_deployment_id: nil, workflow_deployment_name: nil, release_tag: nil, external_id: nil, previous_execution_id: nil, metadata: nil, request_options: nil)
+      response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.api_key.nil?
+    req.headers["X-API-KEY"] = request_options.api_key
+  end
+  unless request_options&.api_version.nil?
+    req.headers["X-API-Version"] = request_options.api_version
+  else
+    req.headers["X-API-Version"] = "2025-07-30"
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), inputs: inputs, workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, release_tag: release_tag, external_id: external_id, previous_execution_id: previous_execution_id, metadata: metadata }.compact
+  req.url "#{@request_client.get_url(environment: Predict, request_options: request_options)}/v1/execute-workflow-async"
+end
+      Vellum::ExecuteWorkflowAsyncResponse.from_json(json_object: response.body)
+    end
 # Generate a completion using a previously defined deployment.
 #  Important: This endpoint is DEPRECATED and has been superseded by
 #  [execute-prompt](/api-reference/api-reference/execute-prompt).
@@ -820,6 +868,53 @@ end
 end
       Vellum::ExecuteWorkflowResponse.from_json(json_object: response.body)
     end
+# Executes a deployed Workflow asynchronously and returns the execution ID.
+    #
+    # @param inputs [Array<Hash>] The list of inputs defined in the Workflow's Deployment with their corresponding
+#  values.Request of type Array<Vellum::WorkflowRequestInputRequest>, as a Hash
+    # @param workflow_deployment_id [String] The ID of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_name.
+    # @param workflow_deployment_name [String] The name of the Workflow Deployment. Must provide either this or
+#  workflow_deployment_id.
+    # @param release_tag [String] Optionally specify a release tag if you want to pin to a specific release of the
+#  Workflow Deployment
+    # @param external_id [String] Optionally include a unique identifier for tracking purposes. Must be unique
+#  within a given Workspace.
+    # @param previous_execution_id [String] The ID of a previous Workflow Execution to reference for initial State loading.
+    # @param metadata [Hash{String => Object}] Arbitrary JSON metadata associated with this request. Can be used to capture
+#  additional monitoring data such as user id, session id, etc. for future
+#  analysis.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::ExecuteWorkflowAsyncResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.execute_workflow_async(inputs: [{ name: "x", type: "STRING", value: "value" }, { name: "x", type: "STRING", value: "value" }])
+    def execute_workflow_async(inputs:, workflow_deployment_id: nil, workflow_deployment_name: nil, release_tag: nil, external_id: nil, previous_execution_id: nil, metadata: nil, request_options: nil)
+      response = @async_request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.api_key.nil?
+    req.headers["X-API-KEY"] = request_options.api_key
+  end
+  unless request_options&.api_version.nil?
+    req.headers["X-API-Version"] = request_options.api_version
+  else
+    req.headers["X-API-Version"] = "2025-07-30"
+  end
+  req.headers = { **(req.headers || {}), **@async_request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), inputs: inputs, workflow_deployment_id: workflow_deployment_id, workflow_deployment_name: workflow_deployment_name, release_tag: release_tag, external_id: external_id, previous_execution_id: previous_execution_id, metadata: metadata }.compact
+  req.url "#{@async_request_client.get_url(environment: Predict, request_options: request_options)}/v1/execute-workflow-async"
+end
+      Vellum::ExecuteWorkflowAsyncResponse.from_json(json_object: response.body)
+    end
 # Generate a completion using a previously defined deployment.
 #  Important: This endpoint is DEPRECATED and has been superseded by
 #  [execute-prompt](/api-reference/api-reference/execute-prompt).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vellum_ai
 version: !ruby/object:Gem::Version
-  version: 1.10.8
+  version: 1.11.0
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -291,6 +291,7 @@ files:
 - lib/vellum_ai/types/execute_api_response_json.rb
 - lib/vellum_ai/types/execute_prompt_event.rb
 - lib/vellum_ai/types/execute_prompt_response.rb
+- lib/vellum_ai/types/execute_workflow_async_response.rb
 - lib/vellum_ai/types/execute_workflow_response.rb
 - lib/vellum_ai/types/execute_workflow_workflow_result_event.rb
 - lib/vellum_ai/types/execution_array_vellum_value.rb
@@ -856,6 +857,7 @@ files:
 - lib/vellum_ai/types/workflow_result_event_output_data_number.rb
 - lib/vellum_ai/types/workflow_result_event_output_data_search_results.rb
 - lib/vellum_ai/types/workflow_result_event_output_data_string.rb
+- lib/vellum_ai/types/workflow_result_event_state.rb
 - lib/vellum_ai/types/workflow_sandbox_display_data.rb
 - lib/vellum_ai/types/workflow_sandbox_example.rb
 - lib/vellum_ai/types/workflow_sandbox_parent_context.rb