vellum_ai 1.12.1 → 1.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59fb5cf45ad7757dbf20e3f4338b80bbcb13fc4b6721bddb792b8478bdc17aa3
-  data.tar.gz: 73affde7dfc3952a2cb7acb63540ce8d0e619a338383a8513d8f9503e450cc34
+  metadata.gz: 29fb112650285d7ff2fd4499a3e408ffa18d4add14a3a9b7980e6b8ab6fe1c2a
+  data.tar.gz: 53ffd1733e616a3598d20a737e019772356e452d00eed6007227dddf32ee5d7f
 SHA512:
-  metadata.gz: 52efea2ecb59e0e853fc42cafd95b110ab21bf6745b67e99a7e4fc547107887b2c612d55a9490e52c6b74cee84f929c9fe794893e32e61570abdd591b48bd0b2
-  data.tar.gz: f7bf8d85584ff6aa3a776fa1fcbaa77fec771ea3ee18fee41f2f8670edd0137a7cf997c6edd349dca34ff883f8c98a2371cc2d489feca5e626d7e44cb6e82462
+  metadata.gz: 520444d8c94059b758a4a7f02585add8c21c7a9803c1f919297448478c5d434b3dfcad807f4c84f92e08fd42346bedff044fee271532412e7e7ddb1eed1ac3f8
+  data.tar.gz: 337c579e5e3a363aa8dc8b813fe4ac11f9084a12ab0dced83736612e362b42a23f5c77642c979838ccf73eb4d0e23cf52eeb7ed9b392ec2f04030ef48de13391

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.12.1' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.12.2' }
       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.12.1' }
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'vellum_ai', "X-Fern-SDK-Version": '1.12.2' }
       headers["X-API-KEY"] = ((@api_key.is_a? Method) ? @api_key.call : @api_key) unless @api_key.nil?
  headers
     end

data/lib/vellum_ai/integration_providers/client.rb

@@ -22,6 +22,8 @@ module Vellum
     # @param integration_name [String] The integration name
     # @param integration_provider [String] The integration provider name
     # @param tool_name [String] The tool's unique name, as specified by the integration provider
+    # @param toolkit_version [String] The version of the toolkit to use. Pass 'latest' to get the latest version, or a
+#  specific version string to pin it. If not provided, uses the provider's default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_TOOL_DEFINITION]
     # @example
@@ -35,7 +37,7 @@ module Vellum
 #    integration_provider: "integration_provider",
 #    tool_name: "tool_name"
 #  )
-    def retrieve_integration_provider_tool_definition(integration_name:, integration_provider:, tool_name:, request_options: nil)
+    def retrieve_integration_provider_tool_definition(integration_name:, integration_provider:, tool_name:, toolkit_version: 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
@@ -49,9 +51,7 @@ module Vellum
     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 || {}), "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -68,6 +68,9 @@ end
     # @param limit [Integer] Number of results to return per page.
     # @param offset [Integer] The initial index from which to return the results.
     # @param search [String] The search term to filter the tools by
+    # @param toolkit_version [String] The version of the toolkit to lookup. Pass 'latest' to get the latest version,
+#  or a specific version string to pin it. If not provided, uses the provider's
+#  default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::PaginatedSlimToolDefinitionList]
     # @example
@@ -77,7 +80,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.integration_providers.list_integration_tools(integration_provider: "integration_provider")
-    def list_integration_tools(integration_provider:, important: nil, include_deprecated: nil, integration_name: nil, limit: nil, offset: nil, search: nil, request_options: nil)
+    def list_integration_tools(integration_provider:, important: nil, include_deprecated: nil, integration_name: nil, limit: nil, offset: nil, search: nil, toolkit_version: 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
@@ -91,7 +94,7 @@ end
     req.headers["X-API-Version"] = "2025-07-30"
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
-  req.params = { **(request_options&.additional_query_parameters || {}), "important": important, "include_deprecated": include_deprecated, "integration_name": integration_name, "limit": limit, "offset": offset, "search": search }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "important": important, "include_deprecated": include_deprecated, "integration_name": integration_name, "limit": limit, "offset": offset, "search": search, "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -115,6 +118,8 @@ end
     # @param integration_name [String] The integration name
     # @param integration_provider [String] The integration provider name
     # @param tool_name [String] The tool's unique name, as specified by the integration provider
+    # @param toolkit_version [String] The version of the toolkit to use. Pass 'latest' to get the latest version, or a
+#  specific version string to pin it. If not provided, uses the provider's default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_TOOL_DEFINITION]
     # @example
@@ -128,7 +133,7 @@ end
 #    integration_provider: "integration_provider",
 #    tool_name: "tool_name"
 #  )
-    def retrieve_integration_provider_tool_definition(integration_name:, integration_provider:, tool_name:, request_options: nil)
+    def retrieve_integration_provider_tool_definition(integration_name:, integration_provider:, tool_name:, toolkit_version: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -143,9 +148,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 || {}), "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -163,6 +166,9 @@ end
     # @param limit [Integer] Number of results to return per page.
     # @param offset [Integer] The initial index from which to return the results.
     # @param search [String] The search term to filter the tools by
+    # @param toolkit_version [String] The version of the toolkit to lookup. Pass 'latest' to get the latest version,
+#  or a specific version string to pin it. If not provided, uses the provider's
+#  default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::PaginatedSlimToolDefinitionList]
     # @example
@@ -172,7 +178,7 @@ end
 #    api_key: "YOUR_API_KEY"
 #  )
 #  api.integration_providers.list_integration_tools(integration_provider: "integration_provider")
-    def list_integration_tools(integration_provider:, important: nil, include_deprecated: nil, integration_name: nil, limit: nil, offset: nil, search: nil, request_options: nil)
+    def list_integration_tools(integration_provider:, important: nil, include_deprecated: nil, integration_name: nil, limit: nil, offset: nil, search: nil, toolkit_version: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -187,7 +193,7 @@ end
     req.headers["X-API-Version"] = "2025-07-30"
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
-  req.params = { **(request_options&.additional_query_parameters || {}), "important": important, "include_deprecated": include_deprecated, "integration_name": integration_name, "limit": limit, "offset": offset, "search": search }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "important": important, "include_deprecated": include_deprecated, "integration_name": integration_name, "limit": limit, "offset": offset, "search": search, "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end

data/lib/vellum_ai/integrations/client.rb

@@ -25,6 +25,8 @@ module Vellum
     # @param integration_name [String] The integration name
     # @param integration_provider [String] The integration provider name
     # @param tool_name [String] The tool's unique name, as specified by the integration provider
+    # @param toolkit_version [String] The version of the toolkit to use. Pass 'latest' to get the latest version, or a
+#  specific version string to pin it. If not provided, uses the provider's default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_TOOL_DEFINITION]
     # @example
@@ -38,7 +40,7 @@ module Vellum
 #    integration_provider: "integration_provider",
 #    tool_name: "tool_name"
 #  )
-    def retrieve_integration_tool_definition(integration_name:, integration_provider:, tool_name:, request_options: nil)
+    def retrieve_integration_tool_definition(integration_name:, integration_provider:, tool_name:, toolkit_version: 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
@@ -52,9 +54,7 @@ module Vellum
     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 || {}), "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -68,6 +68,7 @@ end
     # @param request [Hash] Request of type Vellum::COMPONENTS_SCHEMAS_COMPOSIO_EXECUTE_TOOL_REQUEST, as a Hash
     #   * :provider (String) 
     #   * :arguments (Hash{String => Object}) 
+    #   * :toolkit_version (String) 
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_EXECUTE_TOOL_RESPONSE]
     # @example
@@ -193,6 +194,8 @@ end
     # @param integration_name [String] The integration name
     # @param integration_provider [String] The integration provider name
     # @param tool_name [String] The tool's unique name, as specified by the integration provider
+    # @param toolkit_version [String] The version of the toolkit to use. Pass 'latest' to get the latest version, or a
+#  specific version string to pin it. If not provided, uses the provider's default.
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_TOOL_DEFINITION]
     # @example
@@ -206,7 +209,7 @@ end
 #    integration_provider: "integration_provider",
 #    tool_name: "tool_name"
 #  )
-    def retrieve_integration_tool_definition(integration_name:, integration_provider:, tool_name:, request_options: nil)
+    def retrieve_integration_tool_definition(integration_name:, integration_provider:, tool_name:, toolkit_version: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -221,9 +224,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 || {}), "toolkit_version": toolkit_version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -238,6 +239,7 @@ end
     # @param request [Hash] Request of type Vellum::COMPONENTS_SCHEMAS_COMPOSIO_EXECUTE_TOOL_REQUEST, as a Hash
     #   * :provider (String) 
     #   * :arguments (Hash{String => Object}) 
+    #   * :toolkit_version (String) 
     # @param request_options [Vellum::RequestOptions] 
     # @return [Vellum::COMPONENTS_SCHEMAS_COMPOSIO_EXECUTE_TOOL_RESPONSE]
     # @example

data/lib/vellum_ai/types/composio_execute_tool_request.rb

@@ -9,6 +9,8 @@ module Vellum
     attr_reader :provider
   # @return [Hash{String => Object}] 
     attr_reader :arguments
+  # @return [String] 
+    attr_reader :toolkit_version
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -19,13 +21,17 @@ module Vellum
 
     # @param provider [String] 
     # @param arguments [Hash{String => Object}] 
+    # @param toolkit_version [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::ComposioExecuteToolRequest]
-    def initialize(provider:, arguments:, additional_properties: nil)
+    def initialize(provider:, arguments:, toolkit_version: OMIT, additional_properties: nil)
       @provider = provider
       @arguments = arguments
+      @toolkit_version = toolkit_version if toolkit_version != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "provider": provider, "arguments": arguments }
+      @_field_set = { "provider": provider, "arguments": arguments, "toolkit_version": toolkit_version }.reject do | _k, v |
+  v == OMIT
+end
     end
 # Deserialize a JSON object to an instance of ComposioExecuteToolRequest
     #
@@ -36,9 +42,11 @@ module Vellum
       parsed_json = JSON.parse(json_object)
       provider = parsed_json["provider"]
       arguments = parsed_json["arguments"]
+      toolkit_version = parsed_json["toolkit_version"]
       new(
         provider: provider,
         arguments: arguments,
+        toolkit_version: toolkit_version,
         additional_properties: struct
       )
     end
@@ -57,6 +65,7 @@ module Vellum
     def self.validate_raw(obj:)
       obj.provider.is_a?(String) != false || raise("Passed value for field obj.provider is not the expected type, validation failed.")
       obj.arguments.is_a?(Hash) != false || raise("Passed value for field obj.arguments is not the expected type, validation failed.")
+      obj.toolkit_version&.is_a?(String) != false || raise("Passed value for field obj.toolkit_version is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/types/composio_tool_definition.rb

@@ -20,6 +20,8 @@ module Vellum
     attr_reader :input_parameters
   # @return [Hash{String => Object}] 
     attr_reader :output_parameters
+  # @return [String] 
+    attr_reader :toolkit_version
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -35,9 +37,10 @@ module Vellum
     # @param description [String] 
     # @param input_parameters [Hash{String => Object}] 
     # @param output_parameters [Hash{String => Object}] 
+    # @param toolkit_version [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::ComposioToolDefinition]
-    def initialize(provider:, integration:, name:, label:, description:, input_parameters:, output_parameters:, additional_properties: nil)
+    def initialize(provider:, integration:, name:, label:, description:, input_parameters:, output_parameters:, toolkit_version:, additional_properties: nil)
       @provider = provider
       @integration = integration
       @name = name
@@ -45,8 +48,9 @@ module Vellum
       @description = description
       @input_parameters = input_parameters
       @output_parameters = output_parameters
+      @toolkit_version = toolkit_version
       @additional_properties = additional_properties
-      @_field_set = { "provider": provider, "integration": integration, "name": name, "label": label, "description": description, "input_parameters": input_parameters, "output_parameters": output_parameters }
+      @_field_set = { "provider": provider, "integration": integration, "name": name, "label": label, "description": description, "input_parameters": input_parameters, "output_parameters": output_parameters, "toolkit_version": toolkit_version }
     end
 # Deserialize a JSON object to an instance of ComposioToolDefinition
     #
@@ -67,6 +71,7 @@ module Vellum
       description = parsed_json["description"]
       input_parameters = parsed_json["input_parameters"]
       output_parameters = parsed_json["output_parameters"]
+      toolkit_version = parsed_json["toolkit_version"]
       new(
         provider: provider,
         integration: integration,
@@ -75,6 +80,7 @@ module Vellum
         description: description,
         input_parameters: input_parameters,
         output_parameters: output_parameters,
+        toolkit_version: toolkit_version,
         additional_properties: struct
       )
     end
@@ -98,6 +104,7 @@ module Vellum
       obj.description.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
       obj.input_parameters.is_a?(Hash) != false || raise("Passed value for field obj.input_parameters is not the expected type, validation failed.")
       obj.output_parameters.is_a?(Hash) != false || raise("Passed value for field obj.output_parameters is not the expected type, validation failed.")
+      obj.toolkit_version.is_a?(String) != false || raise("Passed value for field obj.toolkit_version is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/types/slim_composio_tool_definition.rb

@@ -15,6 +15,8 @@ module Vellum
     attr_reader :label
   # @return [String] 
     attr_reader :description
+  # @return [String] 
+    attr_reader :toolkit_version
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -28,16 +30,18 @@ module Vellum
     # @param name [String] 
     # @param label [String] 
     # @param description [String] 
+    # @param toolkit_version [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::SlimComposioToolDefinition]
-    def initialize(provider:, integration:, name:, label:, description:, additional_properties: nil)
+    def initialize(provider:, integration:, name:, label:, description:, toolkit_version:, additional_properties: nil)
       @provider = provider
       @integration = integration
       @name = name
       @label = label
       @description = description
+      @toolkit_version = toolkit_version
       @additional_properties = additional_properties
-      @_field_set = { "provider": provider, "integration": integration, "name": name, "label": label, "description": description }
+      @_field_set = { "provider": provider, "integration": integration, "name": name, "label": label, "description": description, "toolkit_version": toolkit_version }
     end
 # Deserialize a JSON object to an instance of SlimComposioToolDefinition
     #
@@ -56,12 +60,14 @@ module Vellum
       name = parsed_json["name"]
       label = parsed_json["label"]
       description = parsed_json["description"]
+      toolkit_version = parsed_json["toolkit_version"]
       new(
         provider: provider,
         integration: integration,
         name: name,
         label: label,
         description: description,
+        toolkit_version: toolkit_version,
         additional_properties: struct
       )
     end
@@ -83,6 +89,7 @@ module Vellum
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.label.is_a?(String) != false || raise("Passed value for field obj.label is not the expected type, validation failed.")
       obj.description.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+      obj.toolkit_version.is_a?(String) != false || raise("Passed value for field obj.toolkit_version is not the expected type, validation failed.")
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vellum_ai
 version: !ruby/object:Gem::Version
-  version: 1.12.1
+  version: 1.12.2
 platform: ruby
 authors:
 - Vellum
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-22 00:00:00.000000000 Z
+date: 2025-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday