vellum_ai 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36f0ab9495f1ea446fa365253333b38203348cae8da68350c95bc18e15a30c7b
-  data.tar.gz: 8dc2fdc539cd2aa69207d6234d2813eb11c10db3d5c03ec5bc7effdab45390f9
+  metadata.gz: f3207156e6a125a3be3b1865611e192432ef980d2cec14a17b1188a08688eab4
+  data.tar.gz: 181f8c5ddb435cc230af2e842f9fe2b01cbcd5a9105b2481e20ea116e4ea4cfd
 SHA512:
-  metadata.gz: 4eedebc43e24762fa8e9c4dfe7fbfe1dc43d9fc9c19b45c15c53f0d44c8f738676e611b38fb4b92d5307d226903922ff38e749e31953e75e2f69417446f13dc9
-  data.tar.gz: 568b5c1c566e3850f057f3945b965384f97d32a1e65124cf7cfd8f2f9050299131e635a53fae9aef58f53c3c592c8716fa5bd542f134a05d515a2d74c059d47f
+  metadata.gz: 69238e5ab6fb2994454740dd24180151bf06b75b4a91ee7c694a489afd0e38d9c9c33a846e49ff37fb073a30caca200419c63f6d0a26f0aa414049c0e029ee77
+  data.tar.gz: 21175d2006453c495cb65288193abe50cd736d31190b9bc4736d39e8a36a315ed5f4de5c3f0534e6a41ca6a8165b927659c248785d6b2a17c32258927cfc55e4

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.2.0' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.2.1' }
       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.2.0' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.2.1' }
       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

@@ -127,8 +127,10 @@ require_relative "vellum_ai/types/entity_visibility"
 require_relative "vellum_ai/types/environment_enum"
 require_relative "vellum_ai/types/ephemeral_prompt_cache_config"
 require_relative "vellum_ai/types/ephemeral_prompt_cache_config_type_enum"
+require_relative "vellum_ai/types/error_detail_response"
 require_relative "vellum_ai/types/error_vellum_value"
 require_relative "vellum_ai/types/error_vellum_value_request"
+require_relative "vellum_ai/types/event_create_response"
 require_relative "vellum_ai/types/execute_api_response_json"
 require_relative "vellum_ai/types/execute_api_response"
 require_relative "vellum_ai/types/initiated_execute_prompt_event"
@@ -557,6 +559,7 @@ require_relative "vellum_ai/types/workflow_deployment_release_workflow_version"
 require_relative "vellum_ai/types/workflow_event_error"
 require_relative "vellum_ai/types/workflow_initialization_error"
 require_relative "vellum_ai/types/workflow_error"
+require_relative "vellum_ai/types/workflow_event"
 require_relative "vellum_ai/types/workflow_event_execution_read"
 require_relative "vellum_ai/types/workflow_execution_actual"
 require_relative "vellum_ai/types/workflow_execution_detail"

data/lib/vellum_ai/events/client.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/workflow_event"
+require_relative "../types/event_create_response"
+require "async"
+require_relative "../../requests"
+
+module Vellum
+  class EventsClient
+  # @return [Vellum::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::EventsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Accept an event and publish it to ClickHouse for analytics processing.
+    #
+    # @param request [Vellum::NodeExecutionInitiatedEvent, Vellum::NodeExecutionStreamingEvent, Vellum::NodeExecutionFulfilledEvent, Vellum::NodeExecutionRejectedEvent, Vellum::NodeExecutionPausedEvent, Vellum::NodeExecutionResumedEvent, Vellum::WorkflowExecutionInitiatedEvent, Vellum::WorkflowExecutionStreamingEvent, Vellum::WorkflowExecutionRejectedEvent, Vellum::WorkflowExecutionFulfilledEvent, Vellum::WorkflowExecutionPausedEvent, Vellum::WorkflowExecutionResumedEvent, Vellum::WorkflowExecutionSnapshottedEvent] 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::EventCreateResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.events.create(request: { name: "node.execution.initiated", body: { node_definition: { name: "name", module_: ["module", "module"], id: "id" }, inputs: { "inputs": {"key":"value"} } }, id: "id", timestamp: DateTime.parse("2024-01-15T09:30:00.000Z"), trace_id: "trace_id", span_id: "span_id" })
+    def create(request:, 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 || {}), **(request_options&.additional_body_parameters || {}) }.compact
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/monitoring/v1/events"
+end
+      Vellum::EventCreateResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncEventsClient
+  # @return [Vellum::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::AsyncEventsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Accept an event and publish it to ClickHouse for analytics processing.
+    #
+    # @param request [Vellum::NodeExecutionInitiatedEvent, Vellum::NodeExecutionStreamingEvent, Vellum::NodeExecutionFulfilledEvent, Vellum::NodeExecutionRejectedEvent, Vellum::NodeExecutionPausedEvent, Vellum::NodeExecutionResumedEvent, Vellum::WorkflowExecutionInitiatedEvent, Vellum::WorkflowExecutionStreamingEvent, Vellum::WorkflowExecutionRejectedEvent, Vellum::WorkflowExecutionFulfilledEvent, Vellum::WorkflowExecutionPausedEvent, Vellum::WorkflowExecutionResumedEvent, Vellum::WorkflowExecutionSnapshottedEvent] 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::EventCreateResponse]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.events.create(request: { name: "node.execution.initiated", body: { node_definition: { name: "name", module_: ["module", "module"], id: "id" }, inputs: { "inputs": {"key":"value"} } }, id: "id", timestamp: DateTime.parse("2024-01-15T09:30:00.000Z"), trace_id: "trace_id", span_id: "span_id" })
+    def create(request:, request_options: nil)
+      Async do
+        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 || {}), **(request_options&.additional_body_parameters || {}) }.compact
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/monitoring/v1/events"
+end
+        Vellum::EventCreateResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/vellum_ai/types/error_detail_response.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+  class ErrorDetailResponse
+  # @return [String] Message informing the user of the error.
+    attr_reader :detail
+  # @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 detail [String] Message informing the user of the error.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ErrorDetailResponse]
+    def initialize(detail:, additional_properties: nil)
+      @detail = detail
+      @additional_properties = additional_properties
+      @_field_set = { "detail": detail }
+    end
+# Deserialize a JSON object to an instance of ErrorDetailResponse
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ErrorDetailResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      detail = parsed_json["detail"]
+      new(detail: detail, additional_properties: struct)
+    end
+# Serialize an instance of ErrorDetailResponse 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.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/event_create_response.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+# Response serializer for successful event creation.
+  class EventCreateResponse
+  # @return [Boolean] Indicates whether the event was published successfully.
+    attr_reader :success
+  # @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 success [Boolean] Indicates whether the event was published successfully.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::EventCreateResponse]
+    def initialize(success: OMIT, additional_properties: nil)
+      @success = success if success != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "success": success }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of EventCreateResponse
+    #
+    # @param json_object [String] 
+    # @return [Vellum::EventCreateResponse]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      success = parsed_json["success"]
+      new(success: success, additional_properties: struct)
+    end
+# Serialize an instance of EventCreateResponse 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.success&.is_a?(Boolean) != false || raise("Passed value for field obj.success is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/execution_thinking_vellum_value.rb

@@ -28,13 +28,15 @@ module Vellum
     # @param value [Vellum::StringVellumValue] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::ExecutionThinkingVellumValue]
-    def initialize(id:, name:, type:, value:, additional_properties: nil)
+    def initialize(id:, name:, type:, value: OMIT, additional_properties: nil)
       @id = id
       @name = name
       @type = type
-      @value = value
+      @value = value if value != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "id": id, "name": name, "type": type, "value": value }
+      @_field_set = { "id": id, "name": name, "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of ExecutionThinkingVellumValue
     #
@@ -76,7 +78,7 @@ module Vellum
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
-      Vellum::StringVellumValue.validate_raw(obj: obj.value)
+      obj.value.nil? || Vellum::StringVellumValue.validate_raw(obj: obj.value)
     end
   end
 end

data/lib/vellum_ai/types/thinking_vellum_value.rb

@@ -22,11 +22,13 @@ module Vellum
     # @param value [Vellum::StringVellumValue] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::ThinkingVellumValue]
-    def initialize(type:, value:, additional_properties: nil)
+    def initialize(type:, value: OMIT, additional_properties: nil)
       @type = type
-      @value = value
+      @value = value if value != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "type": type, "value": value }
+      @_field_set = { "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of ThinkingVellumValue
     #
@@ -62,7 +64,7 @@ module Vellum
     # @return [Void]
     def self.validate_raw(obj:)
       obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
-      Vellum::StringVellumValue.validate_raw(obj: obj.value)
+      obj.value.nil? || Vellum::StringVellumValue.validate_raw(obj: obj.value)
     end
   end
 end

data/lib/vellum_ai/types/thinking_vellum_value_request.rb

@@ -22,11 +22,13 @@ module Vellum
     # @param value [Vellum::StringVellumValueRequest] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::ThinkingVellumValueRequest]
-    def initialize(type:, value:, additional_properties: nil)
+    def initialize(type:, value: OMIT, additional_properties: nil)
       @type = type
-      @value = value
+      @value = value if value != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "type": type, "value": value }
+      @_field_set = { "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of ThinkingVellumValueRequest
     #
@@ -62,7 +64,7 @@ module Vellum
     # @return [Void]
     def self.validate_raw(obj:)
       obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
-      Vellum::StringVellumValueRequest.validate_raw(obj: obj.value)
+      obj.value.nil? || Vellum::StringVellumValueRequest.validate_raw(obj: obj.value)
     end
   end
 end

data/lib/vellum_ai/types/workflow_event.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+require "json"
+require_relative "node_execution_initiated_event"
+require_relative "node_execution_streaming_event"
+require_relative "node_execution_fulfilled_event"
+require_relative "node_execution_rejected_event"
+require_relative "node_execution_paused_event"
+require_relative "node_execution_resumed_event"
+require_relative "workflow_execution_initiated_event"
+require_relative "workflow_execution_streaming_event"
+require_relative "workflow_execution_rejected_event"
+require_relative "workflow_execution_fulfilled_event"
+require_relative "workflow_execution_paused_event"
+require_relative "workflow_execution_resumed_event"
+require_relative "workflow_execution_snapshotted_event"
+
+module Vellum
+  class WorkflowEvent
+
+
+# Deserialize a JSON object to an instance of WorkflowEvent
+    #
+    # @param json_object [String] 
+    # @return [Vellum::WorkflowEvent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      begin
+        Vellum::NodeExecutionInitiatedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionInitiatedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::NodeExecutionStreamingEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionStreamingEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::NodeExecutionFulfilledEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionFulfilledEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::NodeExecutionRejectedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionRejectedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::NodeExecutionPausedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionPausedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::NodeExecutionResumedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::NodeExecutionResumedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionInitiatedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionInitiatedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionStreamingEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionStreamingEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionRejectedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionRejectedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionFulfilledEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionFulfilledEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionPausedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionPausedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionResumedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionResumedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::WorkflowExecutionSnapshottedEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::WorkflowExecutionSnapshottedEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+ return struct
+    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:)
+      begin
+        return Vellum::NodeExecutionInitiatedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::NodeExecutionStreamingEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::NodeExecutionFulfilledEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::NodeExecutionRejectedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::NodeExecutionPausedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::NodeExecutionResumedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionInitiatedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionStreamingEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionRejectedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionFulfilledEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionPausedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionResumedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::WorkflowExecutionSnapshottedEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      raise("Passed value matched no type within the union, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai.rb

@@ -3,6 +3,7 @@ require_relative "environment"
 require_relative "types_export"
 require_relative "vellum_ai/types/api_version_enum"
 require_relative "requests"
+require_relative "vellum_ai/events/client"
 require_relative "vellum_ai/ad_hoc/client"
 require_relative "vellum_ai/container_images/client"
 require_relative "vellum_ai/deployments/client"
@@ -49,6 +50,8 @@ require_relative "requests"
 
 module Vellum
   class Client
+  # @return [Vellum::EventsClient] 
+    attr_reader :events
   # @return [Vellum::AdHocClient] 
     attr_reader :ad_hoc
   # @return [Vellum::ContainerImagesClient] 
@@ -105,6 +108,7 @@ module Vellum
   api_key: api_key,
   api_version: api_version
 )
+      @events = Vellum::EventsClient.new(request_client: @request_client)
       @ad_hoc = Vellum::AdHocClient.new(request_client: @request_client)
       @container_images = Vellum::ContainerImagesClient.new(request_client: @request_client)
       @deployments = Vellum::DeploymentsClient.new(request_client: @request_client)
@@ -502,6 +506,8 @@ end
     end
   end
   class AsyncClient
+  # @return [Vellum::AsyncEventsClient] 
+    attr_reader :events
   # @return [Vellum::AsyncAdHocClient] 
     attr_reader :ad_hoc
   # @return [Vellum::AsyncContainerImagesClient] 
@@ -558,6 +564,7 @@ end
   api_key: api_key,
   api_version: api_version
 )
+      @events = Vellum::AsyncEventsClient.new(request_client: @async_request_client)
       @ad_hoc = Vellum::AsyncAdHocClient.new(request_client: @async_request_client)
       @container_images = Vellum::AsyncContainerImagesClient.new(request_client: @async_request_client)
       @deployments = Vellum::AsyncDeploymentsClient.new(request_client: @async_request_client)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vellum_ai
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2025-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -145,6 +145,7 @@ files:
 - lib/vellum_ai/document_indexes/client.rb
 - lib/vellum_ai/document_indexes/types/document_indexes_list_request_status.rb
 - lib/vellum_ai/documents/client.rb
+- lib/vellum_ai/events/client.rb
 - lib/vellum_ai/folder_entities/client.rb
 - lib/vellum_ai/folder_entities/types/folder_entities_list_request_entity_status.rb
 - lib/vellum_ai/metric_definitions/client.rb
@@ -250,9 +251,11 @@ files:
 - lib/vellum_ai/types/environment_enum.rb
 - lib/vellum_ai/types/ephemeral_prompt_cache_config.rb
 - lib/vellum_ai/types/ephemeral_prompt_cache_config_type_enum.rb
+- lib/vellum_ai/types/error_detail_response.rb
 - lib/vellum_ai/types/error_input.rb
 - lib/vellum_ai/types/error_vellum_value.rb
 - lib/vellum_ai/types/error_vellum_value_request.rb
+- lib/vellum_ai/types/event_create_response.rb
 - lib/vellum_ai/types/execute_api_request_bearer_token.rb
 - lib/vellum_ai/types/execute_api_request_body.rb
 - lib/vellum_ai/types/execute_api_request_headers_value.rb
@@ -690,6 +693,7 @@ files:
 - lib/vellum_ai/types/workflow_deployment_release_workflow_deployment.rb
 - lib/vellum_ai/types/workflow_deployment_release_workflow_version.rb
 - lib/vellum_ai/types/workflow_error.rb
+- lib/vellum_ai/types/workflow_event.rb
 - lib/vellum_ai/types/workflow_event_error.rb
 - lib/vellum_ai/types/workflow_event_execution_read.rb
 - lib/vellum_ai/types/workflow_execution_actual.rb