vellum_ai 0.3.14 → 0.14.74

data/lib/vellum_ai/test_suites/client.rb

@@ -1,130 +1,248 @@
 # frozen_string_literal: true
-
 require_relative "../../requests"
-require_relative "../types/named_test_case_variable_value_request"
+require_relative "../types/paginated_test_suite_test_case_list"
+require_relative "../types/upsert_test_suite_test_case_request"
 require_relative "../types/test_suite_test_case"
 require "async"
+require "async"
+require "async"
+require_relative "../../requests"
 
 module Vellum
   class TestSuitesClient
+  # @return [Vellum::RequestClient] 
     attr_reader :request_client
 
-    # @param request_client [RequestClient]
-    # @return [TestSuitesClient]
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::TestSuitesClient]
     def initialize(request_client:)
-      # @type [RequestClient]
       @request_client = request_client
     end
-
-    # Upserts a new test case for a test suite, keying off of the optionally provided test case id.
+# List the Test Cases associated with a Test Suite
     #
-    # If an id is provided and has a match, the test case will be updated. If no id is provided or no match
-    # is found, a new test case will be appended to the end.
-    #
-    # Note that a full replacement of the test case is performed, so any fields not provided will be removed
-    # or overwritten with default values.
+    # @param id [String] Either the Test Suites' ID or its unique name
+    # @param limit [Integer] Number of results to return per page.
+    # @param offset [Integer] The initial index from which to return the results.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::PaginatedTestSuiteTestCaseList]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.list_test_suite_test_cases(id: "id")
+    def list_test_suite_test_cases(id:, limit: nil, offset: nil, request_options: nil)
+      response = @request_client.conn.get 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
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "limit": limit, "offset": offset }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/test-suites/#{id}/test-cases"
+end
+      Vellum::PaginatedTestSuiteTestCaseList.from_json(json_object: response.body)
+    end
+# Upserts a new test case for a test suite, keying off of the optionally provided
+#  test case id.
+#  If an id is provided and has a match, the test case will be updated. If no id is
+#  provided or no match
+#  is found, a new test case will be appended to the end.
+#  Note that a full replacement of the test case is performed, so any fields not
+#  provided will be removed
+#  or overwritten with default values.
     #
-    # @param id [String] A UUID string identifying this test suite.
-    # @param upsert_test_suite_test_case_request_id [String]
-    # @param label [String]
-    # @param input_values [Array<Hash>] Request of type Array<NamedTestCaseVariableValueRequest>, as a Hash
-    # @param evaluation_values [Array<Hash>] Request of type Array<NamedTestCaseVariableValueRequest>, as a Hash
-    # @param request_options [RequestOptions]
-    # @return [TestSuiteTestCase]
-    def upsert_test_suite_test_case(id:, input_values:, evaluation_values:,
-                                    upsert_test_suite_test_case_request_id: nil, label: nil, request_options: nil)
-      response = @request_client.conn.post do |req|
-        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
-        req.headers["X_API_KEY"] = request_options.api_key unless request_options&.api_key.nil?
-        req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
-        req.body = {
-          **(request_options&.additional_body_parameters || {}),
-          id: upsert_test_suite_test_case_request_id,
-          label: label,
-          input_values: input_values,
-          evaluation_values: evaluation_values
-        }.compact
-        req.url "#{@request_client.default_environment[:Default]}/v1/test-suites/#{id}/test-cases"
-      end
-      TestSuiteTestCase.from_json(json_object: response.body)
+    # @param id [String] Either the Test Suites' ID or its unique name
+    # @param request [Hash] Request of type Vellum::UpsertTestSuiteTestCaseRequest, as a Hash
+    #   * :id (String) 
+    #   * :external_id (String) 
+    #   * :label (String) 
+    #   * :input_values (Array<Vellum::NamedTestCaseVariableValueRequest>) 
+    #   * :evaluation_values (Array<Vellum::NamedTestCaseVariableValueRequest>) 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::TestSuiteTestCase]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.upsert_test_suite_test_case(id: "id", request: { label: "Test Case 1", input_values: [{ type: "STRING", value: "What are your favorite colors?", name: "var_1" }], evaluation_values: [{ type: "ARRAY", value: [{ type: "STRING", value: "Red" }, { type: "STRING", value: "Green" }, { type: "STRING", value: "Blue" }], name: "var_2" }] })
+    def upsert_test_suite_test_case(id:, 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
+  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)}/v1/test-suites/#{id}/test-cases"
+end
+      Vellum::TestSuiteTestCase.from_json(json_object: response.body)
     end
-
-    # Deletes an existing test case for a test suite, keying off of the test case id.
+# Deletes an existing test case for a test suite, keying off of the test case id.
     #
-    # @param id [String] A UUID string identifying this test suite.
+    # @param id [String] Either the Test Suites' ID or its unique name
     # @param test_case_id [String] An id identifying the test case that you'd like to delete
-    # @param request_options [RequestOptions]
+    # @param request_options [Vellum::RequestOptions] 
     # @return [Void]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.delete_test_suite_test_case(id: "id", test_case_id: "test_case_id")
     def delete_test_suite_test_case(id:, test_case_id:, request_options: nil)
-      @request_client.conn.delete do |req|
-        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
-        req.headers["X_API_KEY"] = request_options.api_key unless request_options&.api_key.nil?
-        req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
-        req.url "#{@request_client.default_environment[:Default]}/v1/test-suites/#{id}/test-cases/#{test_case_id}"
-      end
+      response = @request_client.conn.delete 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
+  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
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/test-suites/#{id}/test-cases/#{test_case_id}"
+end
     end
   end
-
   class AsyncTestSuitesClient
+  # @return [Vellum::AsyncRequestClient] 
     attr_reader :request_client
 
-    # @param request_client [AsyncRequestClient]
-    # @return [AsyncTestSuitesClient]
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::AsyncTestSuitesClient]
     def initialize(request_client:)
-      # @type [AsyncRequestClient]
       @request_client = request_client
     end
-
-    # Upserts a new test case for a test suite, keying off of the optionally provided test case id.
-    #
-    # If an id is provided and has a match, the test case will be updated. If no id is provided or no match
-    # is found, a new test case will be appended to the end.
+# List the Test Cases associated with a Test Suite
     #
-    # Note that a full replacement of the test case is performed, so any fields not provided will be removed
-    # or overwritten with default values.
+    # @param id [String] Either the Test Suites' ID or its unique name
+    # @param limit [Integer] Number of results to return per page.
+    # @param offset [Integer] The initial index from which to return the results.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::PaginatedTestSuiteTestCaseList]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.list_test_suite_test_cases(id: "id")
+    def list_test_suite_test_cases(id:, limit: nil, offset: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get 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
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "limit": limit, "offset": offset }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/test-suites/#{id}/test-cases"
+end
+        Vellum::PaginatedTestSuiteTestCaseList.from_json(json_object: response.body)
+      end
+    end
+# Upserts a new test case for a test suite, keying off of the optionally provided
+#  test case id.
+#  If an id is provided and has a match, the test case will be updated. If no id is
+#  provided or no match
+#  is found, a new test case will be appended to the end.
+#  Note that a full replacement of the test case is performed, so any fields not
+#  provided will be removed
+#  or overwritten with default values.
     #
-    # @param id [String] A UUID string identifying this test suite.
-    # @param upsert_test_suite_test_case_request_id [String]
-    # @param label [String]
-    # @param input_values [Array<Hash>] Request of type Array<NamedTestCaseVariableValueRequest>, as a Hash
-    # @param evaluation_values [Array<Hash>] Request of type Array<NamedTestCaseVariableValueRequest>, as a Hash
-    # @param request_options [RequestOptions]
-    # @return [TestSuiteTestCase]
-    def upsert_test_suite_test_case(id:, input_values:, evaluation_values:,
-                                    upsert_test_suite_test_case_request_id: nil, label: nil, request_options: nil)
+    # @param id [String] Either the Test Suites' ID or its unique name
+    # @param request [Hash] Request of type Vellum::UpsertTestSuiteTestCaseRequest, as a Hash
+    #   * :id (String) 
+    #   * :external_id (String) 
+    #   * :label (String) 
+    #   * :input_values (Array<Vellum::NamedTestCaseVariableValueRequest>) 
+    #   * :evaluation_values (Array<Vellum::NamedTestCaseVariableValueRequest>) 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::TestSuiteTestCase]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.upsert_test_suite_test_case(id: "id", request: { label: "Test Case 1", input_values: [{ type: "STRING", value: "What are your favorite colors?", name: "var_1" }], evaluation_values: [{ type: "ARRAY", value: [{ type: "STRING", value: "Red" }, { type: "STRING", value: "Green" }, { type: "STRING", value: "Blue" }], name: "var_2" }] })
+    def upsert_test_suite_test_case(id:, request:, request_options: nil)
       Async do
-        response = @request_client.conn.post do |req|
-          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
-          req.headers["X_API_KEY"] = request_options.api_key unless request_options&.api_key.nil?
-          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
-          req.body = {
-            **(request_options&.additional_body_parameters || {}),
-            id: upsert_test_suite_test_case_request_id,
-            label: label,
-            input_values: input_values,
-            evaluation_values: evaluation_values
-          }.compact
-          req.url "#{@request_client.default_environment[:Default]}/v1/test-suites/#{id}/test-cases"
-        end
-        TestSuiteTestCase.from_json(json_object: response.body)
+        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
+  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)}/v1/test-suites/#{id}/test-cases"
+end
+        Vellum::TestSuiteTestCase.from_json(json_object: response.body)
       end
     end
-
-    # Deletes an existing test case for a test suite, keying off of the test case id.
+# Deletes an existing test case for a test suite, keying off of the test case id.
     #
-    # @param id [String] A UUID string identifying this test suite.
+    # @param id [String] Either the Test Suites' ID or its unique name
     # @param test_case_id [String] An id identifying the test case that you'd like to delete
-    # @param request_options [RequestOptions]
+    # @param request_options [Vellum::RequestOptions] 
     # @return [Void]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.test_suites.delete_test_suite_test_case(id: "id", test_case_id: "test_case_id")
     def delete_test_suite_test_case(id:, test_case_id:, request_options: nil)
       Async do
-        @request_client.conn.delete do |req|
-          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
-          req.headers["X_API_KEY"] = request_options.api_key unless request_options&.api_key.nil?
-          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
-          req.url "#{@request_client.default_environment[:Default]}/v1/test-suites/#{id}/test-cases/#{test_case_id}"
-        end
+        response = @request_client.conn.delete 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
+  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
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/test-suites/#{id}/test-cases/#{test_case_id}"
+end
       end
     end
   end
-end
+end

data/lib/vellum_ai/types/ad_hoc_execute_prompt_event.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+require "json"
+require_relative "initiated_ad_hoc_execute_prompt_event"
+require_relative "streaming_ad_hoc_execute_prompt_event"
+require_relative "fulfilled_ad_hoc_execute_prompt_event"
+require_relative "rejected_ad_hoc_execute_prompt_event"
+
+module Vellum
+  class AdHocExecutePromptEvent
+
+
+# Deserialize a JSON object to an instance of AdHocExecutePromptEvent
+    #
+    # @param json_object [String] 
+    # @return [Vellum::AdHocExecutePromptEvent]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      begin
+        Vellum::InitiatedAdHocExecutePromptEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::InitiatedAdHocExecutePromptEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::StreamingAdHocExecutePromptEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::StreamingAdHocExecutePromptEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::FulfilledAdHocExecutePromptEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::FulfilledAdHocExecutePromptEvent.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::RejectedAdHocExecutePromptEvent.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::RejectedAdHocExecutePromptEvent.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::InitiatedAdHocExecutePromptEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::StreamingAdHocExecutePromptEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::FulfilledAdHocExecutePromptEvent.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::RejectedAdHocExecutePromptEvent.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/types/ad_hoc_expand_meta.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+  class AdHocExpandMeta
+  # @return [Boolean] If enabled, the response will include model host cost tracking. This may
+#  increase latency for some model hosts.
+    attr_reader :cost
+  # @return [Boolean] If enabled, the response will include the model identifier representing the ML
+#  Model invoked by the Prompt.
+    attr_reader :model_name
+  # @return [Boolean] If enabled, the response will include model host usage tracking. This may
+#  increase latency for some model hosts.
+    attr_reader :usage
+  # @return [Boolean] If enabled, the response will include the reason provided by the model for why
+#  the execution finished.
+    attr_reader :finish_reason
+  # @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 cost [Boolean] If enabled, the response will include model host cost tracking. This may
+#  increase latency for some model hosts.
+    # @param model_name [Boolean] If enabled, the response will include the model identifier representing the ML
+#  Model invoked by the Prompt.
+    # @param usage [Boolean] If enabled, the response will include model host usage tracking. This may
+#  increase latency for some model hosts.
+    # @param finish_reason [Boolean] If enabled, the response will include the reason provided by the model for why
+#  the execution finished.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::AdHocExpandMeta]
+    def initialize(cost: OMIT, model_name: OMIT, usage: OMIT, finish_reason: OMIT, additional_properties: nil)
+      @cost = cost if cost != OMIT
+      @model_name = model_name if model_name != OMIT
+      @usage = usage if usage != OMIT
+      @finish_reason = finish_reason if finish_reason != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "cost": cost, "model_name": model_name, "usage": usage, "finish_reason": finish_reason }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of AdHocExpandMeta
+    #
+    # @param json_object [String] 
+    # @return [Vellum::AdHocExpandMeta]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      cost = parsed_json["cost"]
+      model_name = parsed_json["model_name"]
+      usage = parsed_json["usage"]
+      finish_reason = parsed_json["finish_reason"]
+      new(
+        cost: cost,
+        model_name: model_name,
+        usage: usage,
+        finish_reason: finish_reason,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of AdHocExpandMeta 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.cost&.is_a?(Boolean) != false || raise("Passed value for field obj.cost is not the expected type, validation failed.")
+      obj.model_name&.is_a?(Boolean) != false || raise("Passed value for field obj.model_name is not the expected type, validation failed.")
+      obj.usage&.is_a?(Boolean) != false || raise("Passed value for field obj.usage is not the expected type, validation failed.")
+      obj.finish_reason&.is_a?(Boolean) != false || raise("Passed value for field obj.finish_reason is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/ad_hoc_fulfilled_prompt_execution_meta.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+require_relative "finish_reason_enum"
+require_relative "ml_model_usage"
+require_relative "price"
+require "ostruct"
+require "json"
+
+module Vellum
+# The subset of the metadata tracked by Vellum during prompt execution that the
+#  request opted into with `expand_meta`.
+  class AdHocFulfilledPromptExecutionMeta
+  # @return [Integer] 
+    attr_reader :latency
+  # @return [Vellum::FinishReasonEnum] 
+    attr_reader :finish_reason
+  # @return [Vellum::MlModelUsage] 
+    attr_reader :usage
+  # @return [Vellum::Price] 
+    attr_reader :cost
+  # @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 latency [Integer] 
+    # @param finish_reason [Vellum::FinishReasonEnum] 
+    # @param usage [Vellum::MlModelUsage] 
+    # @param cost [Vellum::Price] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::AdHocFulfilledPromptExecutionMeta]
+    def initialize(latency: OMIT, finish_reason: OMIT, usage: OMIT, cost: OMIT, additional_properties: nil)
+      @latency = latency if latency != OMIT
+      @finish_reason = finish_reason if finish_reason != OMIT
+      @usage = usage if usage != OMIT
+      @cost = cost if cost != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "latency": latency, "finish_reason": finish_reason, "usage": usage, "cost": cost }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of AdHocFulfilledPromptExecutionMeta
+    #
+    # @param json_object [String] 
+    # @return [Vellum::AdHocFulfilledPromptExecutionMeta]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      latency = parsed_json["latency"]
+      finish_reason = parsed_json["finish_reason"]
+      unless parsed_json["usage"].nil?
+        usage = parsed_json["usage"].to_json
+        usage = Vellum::MlModelUsage.from_json(json_object: usage)
+      else
+        usage = nil
+      end
+      unless parsed_json["cost"].nil?
+        cost = parsed_json["cost"].to_json
+        cost = Vellum::Price.from_json(json_object: cost)
+      else
+        cost = nil
+      end
+      new(
+        latency: latency,
+        finish_reason: finish_reason,
+        usage: usage,
+        cost: cost,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of AdHocFulfilledPromptExecutionMeta 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.latency&.is_a?(Integer) != false || raise("Passed value for field obj.latency is not the expected type, validation failed.")
+      obj.finish_reason&.is_a?(Vellum::FinishReasonEnum) != false || raise("Passed value for field obj.finish_reason is not the expected type, validation failed.")
+      obj.usage.nil? || Vellum::MlModelUsage.validate_raw(obj: obj.usage)
+      obj.cost.nil? || Vellum::Price.validate_raw(obj: obj.cost)
+    end
+  end
+end