vellum_ai 1.11.0 → 1.11.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccd1ca7ad21297e3886feaa9a31a00d06ca1a68f4d33454b9496f9fce2283e31
-  data.tar.gz: 6cbf944cf1ea593d32bee316e1dc89ba34e73f1847dab9952151cebce3c84b1e
+  metadata.gz: 53eb525cec2e014edbf9577d5d7b0707370e6cc1bfb62ca9f9ccd350dbaa5ba6
+  data.tar.gz: ea4aaf0240913c409b2c7d4e3eb3cb7403be68173ccd6d19496baa66b459b52b
 SHA512:
-  metadata.gz: 4cd470bfd9abd70f0d114aeed273e423e6f27097ed5158e6e666945e9f29148d3619906e7950ed661ebef862711d6a1c1c2b564760c6f2e172087087048025ed
-  data.tar.gz: 4a017b28dd6158ab7b994b545cd96a58823af8835cb00358d4078dc0ed6dd63451613419e7cda59598923824ddb6983f5b7d3bc42a611c3aa284f9b585b277b4
+  metadata.gz: 336ad28b692f1750a6c652c8808c4dbe91e026fbcf1d4682f8868eb6e5334a0c14cd1f56214b51262effd7b209edda31c7ebb50d2dcc63242e5c7883b9c89d4d
+  data.tar.gz: 7655b92f055ab5f79f8f985663395c67b4747ab8fb2f759836d275196f79b7cca212ee0ac17bd2e402bca681ac9df134915cb0316a9051e2857b4dee6454ccef

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

@@ -450,6 +450,7 @@ require_relative "vellum_ai/types/release_tag_release"
 require_relative "vellum_ai/types/release_tag_source"
 require_relative "vellum_ai/types/replace_test_suite_test_case_request"
 require_relative "vellum_ai/types/rich_text_child_block"
+require_relative "vellum_ai/types/runner_config_request"
 require_relative "vellum_ai/types/sandbox_scenario"
 require_relative "vellum_ai/types/scenario_input_string_variable_value"
 require_relative "vellum_ai/types/scenario_input_json_variable_value"

data/lib/vellum_ai/ad_hoc/client.rb

@@ -33,6 +33,7 @@ module Vellum
     #   * :extensions (Hash)
     #     * :color (String) 
     #     * :description (String) 
+    #   * :schema (Hash{String => Object}) 
     # @param parameters [Hash] Request of type Vellum::PromptParameters, as a Hash
     #   * :stop (Array<String>) 
     #   * :temperature (Float) 
@@ -121,6 +122,7 @@ end
     #   * :extensions (Hash)
     #     * :color (String) 
     #     * :description (String) 
+    #   * :schema (Hash{String => Object}) 
     # @param parameters [Hash] Request of type Vellum::PromptParameters, as a Hash
     #   * :stop (Array<String>) 
     #   * :temperature (Float) 

data/lib/vellum_ai/documents/client.rb

@@ -189,13 +189,15 @@ end
 #  to be re-indexed.
     # @param label [String] A human-friendly name for this document. Typically the filename.
     # @param contents [String, IO] 
+    # @param url [String] A URL from which the document can be downloaded. Either contents or url must be
+#  provided.
     # @param keywords [Array<String>] Optionally include a list of keywords that'll be associated with this document.
 #  Used when performing keyword searches.
     # @param metadata [String] A stringified JSON object containing any metadata associated with the document
 #  that you'd like to filter upon later.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadDocumentResponse]
-    def upload(add_to_index_names: nil, external_id: nil, label:, contents:, keywords: nil, metadata: nil, request_options: nil)
+    def upload(add_to_index_names: nil, external_id: nil, label:, contents: nil, url: nil, keywords: 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
@@ -212,7 +214,9 @@ end
   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 || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: Vellum::FileUtilities.as_faraday_multipart(file_like: contents), keywords: keywords, metadata: metadata }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: unless contents.nil?
+  Vellum::FileUtilities.as_faraday_multipart(file_like: contents)
+end, url: url, keywords: keywords, metadata: metadata }.compact
   req.url "#{@request_client.get_url(environment: Documents, request_options: request_options)}/v1/upload-document"
 end
       Vellum::UploadDocumentResponse.from_json(json_object: response.body)
@@ -402,13 +406,15 @@ end
 #  to be re-indexed.
     # @param label [String] A human-friendly name for this document. Typically the filename.
     # @param contents [String, IO] 
+    # @param url [String] A URL from which the document can be downloaded. Either contents or url must be
+#  provided.
     # @param keywords [Array<String>] Optionally include a list of keywords that'll be associated with this document.
 #  Used when performing keyword searches.
     # @param metadata [String] A stringified JSON object containing any metadata associated with the document
 #  that you'd like to filter upon later.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadDocumentResponse]
-    def upload(add_to_index_names: nil, external_id: nil, label:, contents:, keywords: nil, metadata: nil, request_options: nil)
+    def upload(add_to_index_names: nil, external_id: nil, label:, contents: nil, url: nil, keywords: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -426,7 +432,9 @@ end
   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 || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: Vellum::FileUtilities.as_faraday_multipart(file_like: contents), keywords: keywords, metadata: metadata }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), add_to_index_names: add_to_index_names, external_id: external_id, label: label, contents: unless contents.nil?
+  Vellum::FileUtilities.as_faraday_multipart(file_like: contents)
+end, url: url, keywords: keywords, metadata: metadata }.compact
   req.url "#{@request_client.get_url(environment: Documents, request_options: request_options)}/v1/upload-document"
 end
         Vellum::UploadDocumentResponse.from_json(json_object: response.body)

data/lib/vellum_ai/types/integration_name.rb

@@ -10,19 +10,29 @@ module Vellum
 #  * `CODA` - Coda
 #  * `HUBSPOT` - Hubspot
 #  * `INTERCOM` - Intercom
+#  * `INSTAGRAM` - Instagram
 #  * `LINEAR` - Linear
 #  * `LINKUP` - Linkup
 #  * `LISTENNOTES` - Listen Notes
 #  * `LMNT` - LMNT
 #  * `LINKEDIN` - LinkedIn
 #  * `MAILCHIMP` - Mailchimp
+#  * `MIRO` - Miro
 #  * `MEM0` - Mem0
+#  * `MONDAY` - Monday
 #  * `NEON` - Neon
 #  * `GITHUB` - Github
 #  * `GOOGLE_SHEETS` - Google Sheets
 #  * `GOOGLE_CALENDAR` - Google Calendar
 #  * `GOOGLE_DRIVE` - Google Drive
 #  * `GMAIL` - Gmail
+#  * `GOOGLE_ADS` - Google Ads
+#  * `GOOGLE_ANALYTICS` - Google Analytics
+#  * `GOOGLE_DOCS` - Google Docs
+#  * `GOOGLE_PHOTOS` - Google Photos
+#  * `GOOGLE_SEARCH_CONSOLE` - Google Search Console
+#  * `GOOGLE_SLIDES` - Google Slides
+#  * `GOOGLE_TASKS` - Google Tasks
 #  * `ACCULYNX` - AccuLynx
 #  * `AFFINITY` - Affinity
 #  * `AGENCYZOOM` - AgencyZoom
@@ -62,16 +72,19 @@ module Vellum
 #  * `SERPAPI` - Serp Api
 #  * `SHARE_POINT` - SharePoint
 #  * `SHORTCUT` - Shortcut
+#  * `SPOTIFY` - Spotify
 #  * `STRIPE` - Stripe
 #  * `SUPABASE` - Supabase
 #  * `TAVILY` - Tavily
 #  * `TELEGRAM` - Telegram
+#  * `TODOIST` - Todoist
 #  * `WEBFLOW` - Webflow
 #  * `YOUSEARCH` - You Search
 #  * `ZENDESK` - Zendesk
 #  * `ZENROWS` - ZenRows
 #  * `DROPBOX` - Dropbox
 #  * `EVENTBRITE` - Eventbrite
+#  * `FACEBOOK` - Facebook
 #  * `CONFLUENCE` - Confluence
 #  * `COINBASE` - Coinbase
 #  * `DISCORD` - Discord
@@ -88,19 +101,29 @@ module Vellum
     CODA = "CODA"
     HUBSPOT = "HUBSPOT"
     INTERCOM = "INTERCOM"
+    INSTAGRAM = "INSTAGRAM"
     LINEAR = "LINEAR"
     LINKUP = "LINKUP"
     LISTENNOTES = "LISTENNOTES"
     LMNT = "LMNT"
     LINKEDIN = "LINKEDIN"
     MAILCHIMP = "MAILCHIMP"
+    MIRO = "MIRO"
     MEM_0 = "MEM0"
+    MONDAY = "MONDAY"
     NEON = "NEON"
     GITHUB = "GITHUB"
     GOOGLE_SHEETS = "GOOGLE_SHEETS"
     GOOGLE_CALENDAR = "GOOGLE_CALENDAR"
     GOOGLE_DRIVE = "GOOGLE_DRIVE"
     GMAIL = "GMAIL"
+    GOOGLE_ADS = "GOOGLE_ADS"
+    GOOGLE_ANALYTICS = "GOOGLE_ANALYTICS"
+    GOOGLE_DOCS = "GOOGLE_DOCS"
+    GOOGLE_PHOTOS = "GOOGLE_PHOTOS"
+    GOOGLE_SEARCH_CONSOLE = "GOOGLE_SEARCH_CONSOLE"
+    GOOGLE_SLIDES = "GOOGLE_SLIDES"
+    GOOGLE_TASKS = "GOOGLE_TASKS"
     ACCULYNX = "ACCULYNX"
     AFFINITY = "AFFINITY"
     AGENCYZOOM = "AGENCYZOOM"
@@ -140,16 +163,19 @@ module Vellum
     SERPAPI = "SERPAPI"
     SHARE_POINT = "SHARE_POINT"
     SHORTCUT = "SHORTCUT"
+    SPOTIFY = "SPOTIFY"
     STRIPE = "STRIPE"
     SUPABASE = "SUPABASE"
     TAVILY = "TAVILY"
     TELEGRAM = "TELEGRAM"
+    TODOIST = "TODOIST"
     WEBFLOW = "WEBFLOW"
     YOUSEARCH = "YOUSEARCH"
     ZENDESK = "ZENDESK"
     ZENROWS = "ZENROWS"
     DROPBOX = "DROPBOX"
     EVENTBRITE = "EVENTBRITE"
+    FACEBOOK = "FACEBOOK"
     CONFLUENCE = "CONFLUENCE"
     COINBASE = "COINBASE"
     DISCORD = "DISCORD"

data/lib/vellum_ai/types/runner_config_request.rb

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

data/lib/vellum_ai/types/vellum_audio.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumAudio
-  # @return [String] A valid data URL containing the audio data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the audio data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumAudio]

data/lib/vellum_ai/types/vellum_audio_request.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumAudioRequest
-  # @return [String] A valid data URL containing the audio data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the audio data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumAudioRequest]

data/lib/vellum_ai/types/vellum_code_resource_definition.rb

@@ -8,6 +8,8 @@ module Vellum
     attr_reader :name
   # @return [Array<String>] The module that this resource is defined in.
     attr_reader :module_
+  # @return [Boolean] Whether this node should be excluded from monitoring views.
+    attr_reader :exclude_from_monitoring
   # @return [String] 
     attr_reader :id
   # @return [OpenStruct] Additional properties unmapped to the current class definition
@@ -20,15 +22,19 @@ module Vellum
 
     # @param name [String] 
     # @param module_ [Array<String>] The module that this resource is defined in.
+    # @param exclude_from_monitoring [Boolean] Whether this node should be excluded from monitoring views.
     # @param id [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumCodeResourceDefinition]
-    def initialize(name:, module_:, id:, additional_properties: nil)
+    def initialize(name:, module_:, exclude_from_monitoring: OMIT, id:, additional_properties: nil)
       @name = name
       @module_ = module_
+      @exclude_from_monitoring = exclude_from_monitoring if exclude_from_monitoring != OMIT
       @id = id
       @additional_properties = additional_properties
-      @_field_set = { "name": name, "module": module_, "id": id }
+      @_field_set = { "name": name, "module": module_, "exclude_from_monitoring": exclude_from_monitoring, "id": id }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of VellumCodeResourceDefinition
     #
@@ -39,10 +45,12 @@ module Vellum
       parsed_json = JSON.parse(json_object)
       name = parsed_json["name"]
       module_ = parsed_json["module"]
+      exclude_from_monitoring = parsed_json["exclude_from_monitoring"]
       id = parsed_json["id"]
       new(
         name: name,
         module_: module_,
+        exclude_from_monitoring: exclude_from_monitoring,
         id: id,
         additional_properties: struct
       )
@@ -62,6 +70,7 @@ module Vellum
     def self.validate_raw(obj:)
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.module_.is_a?(Array) != false || raise("Passed value for field obj.module_ is not the expected type, validation failed.")
+      obj.exclude_from_monitoring&.is_a?(Boolean) != false || raise("Passed value for field obj.exclude_from_monitoring is not the expected type, validation failed.")
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
     end
   end

data/lib/vellum_ai/types/vellum_document.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumDocument
-  # @return [String] A valid data URL containing the document data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the document data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumDocument]

data/lib/vellum_ai/types/vellum_document_request.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumDocumentRequest
-  # @return [String] A valid data URL containing the document data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the document data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumDocumentRequest]

data/lib/vellum_ai/types/vellum_image.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumImage
-  # @return [String] A valid data URL containing the image data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the image data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumImage]

data/lib/vellum_ai/types/vellum_image_request.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumImageRequest
-  # @return [String] A valid data URL containing the image data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the image data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumImageRequest]

data/lib/vellum_ai/types/vellum_variable.rb

@@ -19,6 +19,8 @@ module Vellum
     attr_reader :default
   # @return [Vellum::VellumVariableExtensions] 
     attr_reader :extensions
+  # @return [Hash{String => Object}] 
+    attr_reader :schema
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -33,17 +35,19 @@ module Vellum
     # @param required [Boolean] 
     # @param default [Vellum::VellumValue] 
     # @param extensions [Vellum::VellumVariableExtensions] 
+    # @param schema [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumVariable]
-    def initialize(id:, key:, type:, required: OMIT, default: OMIT, extensions: OMIT, additional_properties: nil)
+    def initialize(id:, key:, type:, required: OMIT, default: OMIT, extensions: OMIT, schema: OMIT, additional_properties: nil)
       @id = id
       @key = key
       @type = type
       @required = required if required != OMIT
       @default = default if default != OMIT
       @extensions = extensions if extensions != OMIT
+      @schema = schema if schema != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "id": id, "key": key, "type": type, "required": required, "default": default, "extensions": extensions }.reject do | _k, v |
+      @_field_set = { "id": id, "key": key, "type": type, "required": required, "default": default, "extensions": extensions, "schema": schema }.reject do | _k, v |
   v == OMIT
 end
     end
@@ -70,6 +74,7 @@ end
       else
         extensions = nil
       end
+      schema = parsed_json["schema"]
       new(
         id: id,
         key: key,
@@ -77,6 +82,7 @@ end
         required: required,
         default: default,
         extensions: extensions,
+        schema: schema,
         additional_properties: struct
       )
     end
@@ -99,6 +105,7 @@ end
       obj.required&.is_a?(Boolean) != false || raise("Passed value for field obj.required is not the expected type, validation failed.")
       obj.default.nil? || Vellum::VellumValue.validate_raw(obj: obj.default)
       obj.extensions.nil? || Vellum::VellumVariableExtensions.validate_raw(obj: obj.extensions)
+      obj.schema&.is_a?(Hash) != false || raise("Passed value for field obj.schema is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/types/vellum_variable_type.rb

@@ -15,6 +15,7 @@ module Vellum
 #  * `DOCUMENT` - DOCUMENT
 #  * `NULL` - NULL
 #  * `THINKING` - THINKING
+#  * `REFERENCE` - REFERENCE
   class VellumVariableType
 
     STRING = "STRING"
@@ -31,6 +32,7 @@ module Vellum
     DOCUMENT = "DOCUMENT"
     NULL = "NULL"
     THINKING = "THINKING"
+    REFERENCE = "REFERENCE"
 
   end
 end

data/lib/vellum_ai/types/vellum_video.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumVideo
-  # @return [String] A valid data URL containing the video data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the video data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumVideo]

data/lib/vellum_ai/types/vellum_video_request.rb

@@ -4,7 +4,16 @@ require "json"
 
 module Vellum
   class VellumVideoRequest
-  # @return [String] A valid data URL containing the video data.
+  # @return [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     attr_reader :src
   # @return [Hash{String => Object}] 
     attr_reader :metadata
@@ -16,7 +25,16 @@ module Vellum
 
     OMIT = Object.new
 
-    # @param src [String] A valid data URL containing the video data.
+    # @param src [String] The reference to the source data. This can be one of the following formats:
+#  1. A base64-encoded data URL (e.g.,
+#  'data:application/pdf;base64,JVBERi0xLjQKJcfs...').
+#  2. A url pointing to a file accessible over HTTP or HTTPS.
+#  3. A reference to a file that's been previously uploaded to Vellum, in the form
+#  of 'vellum:uploaded-file:{uploaded_file_id}'.
+#  You can use the Uploaded Files API to retrieve the url of the uploaded file
+#  given its ID. See
+#  https://docs.vellum.ai/developers/client-sdk/uploaded-files/retrieve for
+#  details.
     # @param metadata [Hash{String => Object}] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::VellumVideoRequest]

data/lib/vellum_ai/uploaded_files/client.rb

@@ -48,6 +48,9 @@ end
 # Retrieve a previously uploaded file by its ID
     #
     # @param id [String] A UUID string identifying this uploaded file.
+    # @param expiry_seconds [Integer] The number of seconds until the signed URL expires. Must be > 0 and <= 2592000
+#  (30 days). Non-numeric or out-of-range values fall back to the default (604800
+#  seconds or 7 days).
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadedFileRead]
     # @example
@@ -57,7 +60,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.uploaded_files.retrieve(id: "id")
-    def retrieve(id:, request_options: nil)
+    def retrieve(id:, expiry_seconds: 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
@@ -71,9 +74,7 @@ end
     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.params = { **(request_options&.additional_query_parameters || {}), "expiry_seconds": expiry_seconds }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -152,6 +153,9 @@ end
 # Retrieve a previously uploaded file by its ID
     #
     # @param id [String] A UUID string identifying this uploaded file.
+    # @param expiry_seconds [Integer] The number of seconds until the signed URL expires. Must be > 0 and <= 2592000
+#  (30 days). Non-numeric or out-of-range values fall back to the default (604800
+#  seconds or 7 days).
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::UploadedFileRead]
     # @example
@@ -161,7 +165,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.uploaded_files.retrieve(id: "id")
-    def retrieve(id:, request_options: nil)
+    def retrieve(id:, expiry_seconds: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -176,9 +180,7 @@ end
     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.params = { **(request_options&.additional_query_parameters || {}), "expiry_seconds": expiry_seconds }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end

data/lib/vellum_ai/workflows/client.rb

@@ -5,6 +5,7 @@ require_relative "../types/workflow_push_deployment_config_request"
 require_relative "../types/dataset_row_push_request"
 require_relative "../types/workflow_push_response"
 require_relative "../../core/file_utilities"
+require_relative "../types/runner_config_request"
 require "json"
 require "async"
 require "async"
@@ -141,6 +142,12 @@ end
     #
     # @param files [Hash{String => Object}] 
     # @param module_ [String] 
+    # @param runner_config [Hash] Request of type Vellum::RunnerConfigRequest, as a Hash
+    #   * :container_image_name (String) 
+    #   * :container_image_tag (String) 
+    #   * :codegen_version (String) 
+    #   * :sdk_version (String) 
+    #   * :is_deployment_inlining_enabled (Boolean) 
     # @param request_options [Vellum::RequestOptions] 
     # @return [Hash{String => Object}]
     # @example
@@ -150,7 +157,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.workflows.serialize_workflow_files(files: { "files": {"key":"value"} })
-    def serialize_workflow_files(files:, module_: nil, request_options: nil)
+    def serialize_workflow_files(files:, module_: nil, runner_config: 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
@@ -167,7 +174,7 @@ end
   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 || {}), files: files, module: module_ }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), files: files, module: module_, runner_config: runner_config }.compact
   req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflows/serialize"
 end
       parsed_json = JSON.parse(response.body)
@@ -308,6 +315,12 @@ end
     #
     # @param files [Hash{String => Object}] 
     # @param module_ [String] 
+    # @param runner_config [Hash] Request of type Vellum::RunnerConfigRequest, as a Hash
+    #   * :container_image_name (String) 
+    #   * :container_image_tag (String) 
+    #   * :codegen_version (String) 
+    #   * :sdk_version (String) 
+    #   * :is_deployment_inlining_enabled (Boolean) 
     # @param request_options [Vellum::RequestOptions] 
     # @return [Hash{String => Object}]
     # @example
@@ -317,7 +330,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.workflows.serialize_workflow_files(files: { "files": {"key":"value"} })
-    def serialize_workflow_files(files:, module_: nil, request_options: nil)
+    def serialize_workflow_files(files:, module_: nil, runner_config: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -335,7 +348,7 @@ end
   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 || {}), files: files, module: module_ }.compact
+  req.body = { **(request_options&.additional_body_parameters || {}), files: files, module: module_, runner_config: runner_config }.compact
   req.url "#{@request_client.get_url(environment: Default, request_options: request_options)}/v1/workflows/serialize"
 end
         parsed_json = JSON.parse(response.body)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vellum_ai
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.11.7
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-20 00:00:00.000000000 Z
+date: 2025-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -571,6 +571,7 @@ files:
 - lib/vellum_ai/types/replace_test_suite_test_case_request.rb
 - lib/vellum_ai/types/rich_text_child_block.rb
 - lib/vellum_ai/types/rich_text_prompt_block.rb
+- lib/vellum_ai/types/runner_config_request.rb
 - lib/vellum_ai/types/sandbox_scenario.rb
 - lib/vellum_ai/types/scenario_input.rb
 - lib/vellum_ai/types/scenario_input_audio_variable_value.rb