vellum_ai 1.10.4 → 1.10.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 174f42402204c6ce53c3d0e7d41ef48ebbd64948d51da0e70910cf542ec22395
-  data.tar.gz: 458884696995dbe56a41274094d7d34f19c496296e9adcccb8e3eeb198fc3a8b
+  metadata.gz: 2d9d3a074bed53cbb7cf976508e41cffdc3737ee980f0930be1ebc92055b09df
+  data.tar.gz: a0315a68ac585bcc37fcb9b7fb68556f0ec5efa6a9fd9ac79fdec0cc87a87aec
 SHA512:
-  metadata.gz: 321127cb0bf1131a4d6c28cb192306ef96c9ffb475fb292374df0dd188a4521cd0cff1b6ebae2959d5cefb2a62fafe3d4945210c3457592bda9dafd034d42b10
-  data.tar.gz: ef3cb909a1bc183e3f90c5099d9657b9e97a9c7a8692a293babef16d05bf228ced17cc8aba5c30b9dd687778faeba3114b6d4dc5941a6a907f347d48eb23ec5e
+  metadata.gz: 5e85af35c343a5dc0e9c10e716ae9c0a0988fcacd4931a6ce57ec092311b9f5b6038af53f175ce6fdbc0af189d29fc8d4c227c6beed12b1bcaf9f742d4b3054c
+  data.tar.gz: 5e5279482d64437e18ffecd3173faf3fb78448028e751c1a7e9b994d65bd24ceb39e1a55a253a3c34c60d3d36ac7b535cdfaa08df8c364ffe33e43c9f96890b3

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

@@ -605,6 +605,7 @@ require_relative "vellum_ai/types/components_schemas_composio_tool_definition"
 require_relative "vellum_ai/types/unit_enum"
 require_relative "vellum_ai/types/update_active_workspace_response"
 require_relative "vellum_ai/types/upload_document_response"
+require_relative "vellum_ai/types/uploaded_file_read"
 require_relative "vellum_ai/types/upsert_test_suite_test_case_request"
 require_relative "vellum_ai/types/vellum_audio"
 require_relative "vellum_ai/types/vellum_audio_request"

data/lib/vellum_ai/types/uploaded_file_read.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Vellum
+# Represents a file that has been uploaded to a Vellum Workspace.
+  class UploadedFileRead
+  # @return [String] 
+    attr_reader :id
+  # @return [String] A signed URL to download the uploaded file.
+    attr_reader :file_url
+  # @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 id [String] 
+    # @param file_url [String] A signed URL to download the uploaded file.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::UploadedFileRead]
+    def initialize(id: OMIT, file_url: OMIT, additional_properties: nil)
+      @id = id if id != OMIT
+      @file_url = file_url if file_url != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "id": id, "file_url": file_url }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of UploadedFileRead
+    #
+    # @param json_object [String] 
+    # @return [Vellum::UploadedFileRead]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      id = parsed_json["id"]
+      file_url = parsed_json["file_url"]
+      new(
+        id: id,
+        file_url: file_url,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of UploadedFileRead 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.id&.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
+      obj.file_url&.is_a?(String) != false || raise("Passed value for field obj.file_url is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/uploaded_files/client.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/uploaded_file_read"
+require_relative "../../core/file_utilities"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Vellum
+  class UploadedFilesClient
+  # @return [Vellum::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::UploadedFilesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Upload a file to be used in the Workspace
+    #
+    # @param file [String, IO] 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::UploadedFileRead]
+    def create(file:, 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 || {}), file: Vellum::FileUtilities.as_faraday_multipart(file_like: file) }.compact
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/uploaded-files"
+end
+      Vellum::UploadedFileRead.from_json(json_object: response.body)
+    end
+# Retrieve a previously uploaded file by its ID
+    #
+    # @param id [String] A UUID string identifying this uploaded file.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::UploadedFileRead]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.uploaded_files.retrieve(id: "id")
+    def retrieve(id:, 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
+  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
+  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/uploaded-files/#{id}"
+end
+      Vellum::UploadedFileRead.from_json(json_object: response.body)
+    end
+  end
+  class AsyncUploadedFilesClient
+  # @return [Vellum::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Vellum::RequestClient] 
+    # @return [Vellum::AsyncUploadedFilesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Upload a file to be used in the Workspace
+    #
+    # @param file [String, IO] 
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::UploadedFileRead]
+    def create(file:, 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_options&.additional_body_parameters || {}), file: Vellum::FileUtilities.as_faraday_multipart(file_like: file) }.compact
+  req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/uploaded-files"
+end
+        Vellum::UploadedFileRead.from_json(json_object: response.body)
+      end
+    end
+# Retrieve a previously uploaded file by its ID
+    #
+    # @param id [String] A UUID string identifying this uploaded file.
+    # @param request_options [Vellum::RequestOptions] 
+    # @return [Vellum::UploadedFileRead]
+    # @example
+#  api = Vellum::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Vellum::Environment::PRODUCTION,
+#    api_key: "YOUR_API_KEY"
+#  )
+#  api.uploaded_files.retrieve(id: "id")
+    def retrieve(id:, 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
+  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
+  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/uploaded-files/#{id}"
+end
+        Vellum::UploadedFileRead.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/vellum_ai.rb

@@ -21,6 +21,7 @@ require_relative "vellum_ai/prompts/client"
 require_relative "vellum_ai/sandboxes/client"
 require_relative "vellum_ai/test_suite_runs/client"
 require_relative "vellum_ai/test_suites/client"
+require_relative "vellum_ai/uploaded_files/client"
 require_relative "vellum_ai/workflow_deployments/client"
 require_relative "vellum_ai/workflow_executions/client"
 require_relative "vellum_ai/workflow_sandboxes/client"
@@ -90,6 +91,8 @@ module Vellum
     attr_reader :test_suite_runs
   # @return [Vellum::TestSuitesClient] 
     attr_reader :test_suites
+  # @return [Vellum::UploadedFilesClient] 
+    attr_reader :uploaded_files
   # @return [Vellum::WorkflowDeploymentsClient] 
     attr_reader :workflow_deployments
   # @return [Vellum::WorkflowExecutionsClient] 
@@ -138,6 +141,7 @@ module Vellum
       @sandboxes = Vellum::SandboxesClient.new(request_client: @request_client)
       @test_suite_runs = Vellum::TestSuiteRunsClient.new(request_client: @request_client)
       @test_suites = Vellum::TestSuitesClient.new(request_client: @request_client)
+      @uploaded_files = Vellum::UploadedFilesClient.new(request_client: @request_client)
       @workflow_deployments = Vellum::WorkflowDeploymentsClient.new(request_client: @request_client)
       @workflow_executions = Vellum::WorkflowExecutionsClient.new(request_client: @request_client)
       @workflow_sandboxes = Vellum::WorkflowSandboxesClient.new(request_client: @request_client)
@@ -559,6 +563,8 @@ end
     attr_reader :test_suite_runs
   # @return [Vellum::AsyncTestSuitesClient] 
     attr_reader :test_suites
+  # @return [Vellum::AsyncUploadedFilesClient] 
+    attr_reader :uploaded_files
   # @return [Vellum::AsyncWorkflowDeploymentsClient] 
     attr_reader :workflow_deployments
   # @return [Vellum::AsyncWorkflowExecutionsClient] 
@@ -607,6 +613,7 @@ end
       @sandboxes = Vellum::AsyncSandboxesClient.new(request_client: @async_request_client)
       @test_suite_runs = Vellum::AsyncTestSuiteRunsClient.new(request_client: @async_request_client)
       @test_suites = Vellum::AsyncTestSuitesClient.new(request_client: @async_request_client)
+      @uploaded_files = Vellum::AsyncUploadedFilesClient.new(request_client: @async_request_client)
       @workflow_deployments = Vellum::AsyncWorkflowDeploymentsClient.new(request_client: @async_request_client)
       @workflow_executions = Vellum::AsyncWorkflowExecutionsClient.new(request_client: @async_request_client)
       @workflow_sandboxes = Vellum::AsyncWorkflowSandboxesClient.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.10.4
+  version: 1.10.5
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-13 00:00:00.000000000 Z
+date: 2025-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -733,6 +733,7 @@ files:
 - lib/vellum_ai/types/unit_enum.rb
 - lib/vellum_ai/types/update_active_workspace_response.rb
 - lib/vellum_ai/types/upload_document_response.rb
+- lib/vellum_ai/types/uploaded_file_read.rb
 - lib/vellum_ai/types/upsert_test_suite_test_case_request.rb
 - lib/vellum_ai/types/variable_prompt_block.rb
 - lib/vellum_ai/types/vellum_audio.rb
@@ -862,6 +863,7 @@ files:
 - lib/vellum_ai/types/workspace_display_config.rb
 - lib/vellum_ai/types/workspace_read.rb
 - lib/vellum_ai/types/workspace_secret_read.rb
+- lib/vellum_ai/uploaded_files/client.rb
 - lib/vellum_ai/workflow_deployments/client.rb
 - lib/vellum_ai/workflow_deployments/types/list_workflow_release_tags_request_source.rb
 - lib/vellum_ai/workflow_deployments/types/workflow_deployments_list_request_status.rb