vellum_ai 1.2.3 → 1.2.5

data/lib/vellum_ai/types/span_link_type_enum.rb

@@ -1,5 +1,14 @@
 # frozen_string_literal: true
 
 module Vellum
-  SPAN_LINK_TYPE_ENUM = String
+# * `TRIGGERED_BY` - TRIGGERED_BY
+#  * `PREVIOUS_SPAN` - PREVIOUS_SPAN
+#  * `ROOT_SPAN` - ROOT_SPAN
+  class SpanLinkTypeEnum
+
+    TRIGGERED_BY = "TRIGGERED_BY"
+    PREVIOUS_SPAN = "PREVIOUS_SPAN"
+    ROOT_SPAN = "ROOT_SPAN"
+
+  end
 end

data/lib/vellum_ai/types/test_case_audio_variable_value.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+require_relative "vellum_audio"
+require "ostruct"
+require "json"
+
+module Vellum
+# An audio value for a variable in a Test Case.
+  class TestCaseAudioVariableValue
+  # @return [String] 
+    attr_reader :variable_id
+  # @return [String] 
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumAudio] 
+    attr_reader :value
+  # @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 variable_id [String] 
+    # @param name [String] 
+    # @param type [String] 
+    # @param value [Vellum::VellumAudio] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::TestCaseAudioVariableValue]
+    def initialize(variable_id:, name: OMIT, type:, value:, additional_properties: nil)
+      @variable_id = variable_id
+      @name = name if name != OMIT
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "variable_id": variable_id, "name": name, "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of TestCaseAudioVariableValue
+    #
+    # @param json_object [String] 
+    # @return [Vellum::TestCaseAudioVariableValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      variable_id = parsed_json["variable_id"]
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumAudio.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        variable_id: variable_id,
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of TestCaseAudioVariableValue 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.variable_id.is_a?(String) != false || raise("Passed value for field obj.variable_id is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumAudio.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/test_case_document_variable_value.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+require_relative "vellum_document"
+require "ostruct"
+require "json"
+
+module Vellum
+# A document value for a variable in a Test Case.
+  class TestCaseDocumentVariableValue
+  # @return [String] 
+    attr_reader :variable_id
+  # @return [String] 
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumDocument] 
+    attr_reader :value
+  # @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 variable_id [String] 
+    # @param name [String] 
+    # @param type [String] 
+    # @param value [Vellum::VellumDocument] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::TestCaseDocumentVariableValue]
+    def initialize(variable_id:, name: OMIT, type:, value:, additional_properties: nil)
+      @variable_id = variable_id
+      @name = name if name != OMIT
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "variable_id": variable_id, "name": name, "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of TestCaseDocumentVariableValue
+    #
+    # @param json_object [String] 
+    # @return [Vellum::TestCaseDocumentVariableValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      variable_id = parsed_json["variable_id"]
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumDocument.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        variable_id: variable_id,
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of TestCaseDocumentVariableValue 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.variable_id.is_a?(String) != false || raise("Passed value for field obj.variable_id is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumDocument.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/test_case_image_variable_value.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+require_relative "vellum_image"
+require "ostruct"
+require "json"
+
+module Vellum
+# An image value for a variable in a Test Case.
+  class TestCaseImageVariableValue
+  # @return [String] 
+    attr_reader :variable_id
+  # @return [String] 
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumImage] 
+    attr_reader :value
+  # @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 variable_id [String] 
+    # @param name [String] 
+    # @param type [String] 
+    # @param value [Vellum::VellumImage] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::TestCaseImageVariableValue]
+    def initialize(variable_id:, name: OMIT, type:, value:, additional_properties: nil)
+      @variable_id = variable_id
+      @name = name if name != OMIT
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "variable_id": variable_id, "name": name, "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of TestCaseImageVariableValue
+    #
+    # @param json_object [String] 
+    # @return [Vellum::TestCaseImageVariableValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      variable_id = parsed_json["variable_id"]
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumImage.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        variable_id: variable_id,
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of TestCaseImageVariableValue 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.variable_id.is_a?(String) != false || raise("Passed value for field obj.variable_id is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumImage.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/test_case_variable_value.rb

@@ -8,6 +8,10 @@ require_relative "test_case_search_results_variable_value"
 require_relative "test_case_error_variable_value"
 require_relative "test_case_function_call_variable_value"
 require_relative "test_case_array_variable_value"
+require_relative "test_case_audio_variable_value"
+require_relative "test_case_image_variable_value"
+require_relative "test_case_video_variable_value"
+require_relative "test_case_document_variable_value"
 
 module Vellum
   class TestCaseVariableValue
@@ -95,6 +99,46 @@ end
   return Vellum::TestCaseArrayVariableValue.from_json(json_object: struct)
 else
   return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::TestCaseAudioVariableValue.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::TestCaseAudioVariableValue.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::TestCaseImageVariableValue.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::TestCaseImageVariableValue.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::TestCaseVideoVariableValue.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::TestCaseVideoVariableValue.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::TestCaseDocumentVariableValue.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::TestCaseDocumentVariableValue.from_json(json_object: struct)
+else
+  return nil
 end
       rescue StandardError
         # noop
@@ -148,6 +192,26 @@ end
       rescue StandardError
         # noop
       end
+      begin
+        return Vellum::TestCaseAudioVariableValue.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::TestCaseImageVariableValue.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::TestCaseVideoVariableValue.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::TestCaseDocumentVariableValue.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
       raise("Passed value matched no type within the union, validation failed.")
     end
   end

data/lib/vellum_ai/types/test_case_video_variable_value.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+require_relative "vellum_video"
+require "ostruct"
+require "json"
+
+module Vellum
+# A video value for a variable in a Test Case.
+  class TestCaseVideoVariableValue
+  # @return [String] 
+    attr_reader :variable_id
+  # @return [String] 
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumVideo] 
+    attr_reader :value
+  # @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 variable_id [String] 
+    # @param name [String] 
+    # @param type [String] 
+    # @param value [Vellum::VellumVideo] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::TestCaseVideoVariableValue]
+    def initialize(variable_id:, name: OMIT, type:, value:, additional_properties: nil)
+      @variable_id = variable_id
+      @name = name if name != OMIT
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "variable_id": variable_id, "name": name, "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of TestCaseVideoVariableValue
+    #
+    # @param json_object [String] 
+    # @return [Vellum::TestCaseVideoVariableValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      variable_id = parsed_json["variable_id"]
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumVideo.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        variable_id: variable_id,
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of TestCaseVideoVariableValue 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.variable_id.is_a?(String) != false || raise("Passed value for field obj.variable_id is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumVideo.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/video_input.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_video"
+require "ostruct"
+require "json"
+
+module Vellum
+# A user input representing a Vellum Video value
+  class VideoInput
+  # @return [String] The variable's name
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumVideo] 
+    attr_reader :value
+  # @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 name [String] The variable's name
+    # @param type [String] 
+    # @param value [Vellum::VellumVideo] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::VideoInput]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of VideoInput
+    #
+    # @param json_object [String] 
+    # @return [Vellum::VideoInput]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumVideo.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of VideoInput 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.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumVideo.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/workflow_push_deployment_config_request.rb

@@ -12,6 +12,8 @@ module Vellum
     attr_reader :description
   # @return [Array<String>] 
     attr_reader :release_tags
+  # @return [String] 
+    attr_reader :release_description
   # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
   # @return [Object] 
@@ -24,15 +26,17 @@ module Vellum
     # @param name [String] 
     # @param description [String] 
     # @param release_tags [Array<String>] 
+    # @param release_description [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vellum::WorkflowPushDeploymentConfigRequest]
-    def initialize(label: OMIT, name: OMIT, description: OMIT, release_tags: OMIT, additional_properties: nil)
+    def initialize(label: OMIT, name: OMIT, description: OMIT, release_tags: OMIT, release_description: OMIT, additional_properties: nil)
       @label = label if label != OMIT
       @name = name if name != OMIT
       @description = description if description != OMIT
       @release_tags = release_tags if release_tags != OMIT
+      @release_description = release_description if release_description != OMIT
       @additional_properties = additional_properties
-      @_field_set = { "label": label, "name": name, "description": description, "release_tags": release_tags }.reject do | _k, v |
+      @_field_set = { "label": label, "name": name, "description": description, "release_tags": release_tags, "release_description": release_description }.reject do | _k, v |
   v == OMIT
 end
     end
@@ -47,11 +51,13 @@ end
       name = parsed_json["name"]
       description = parsed_json["description"]
       release_tags = parsed_json["release_tags"]
+      release_description = parsed_json["release_description"]
       new(
         label: label,
         name: name,
         description: description,
         release_tags: release_tags,
+        release_description: release_description,
         additional_properties: struct
       )
     end
@@ -72,6 +78,7 @@ end
       obj.name&.is_a?(String) != false || raise("Passed value for field obj.name 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.release_tags&.is_a?(Array) != false || raise("Passed value for field obj.release_tags is not the expected type, validation failed.")
+      obj.release_description&.is_a?(String) != false || raise("Passed value for field obj.release_description is not the expected type, validation failed.")
     end
   end
 end

data/lib/vellum_ai/workflows/client.rb

@@ -23,14 +23,17 @@ module Vellum
     # @param exclude_display [Boolean] 
     # @param include_json [Boolean] 
     # @param include_sandbox [Boolean] 
+    # @param release_tag [String] Release tag to use when pulling from deployment (implies deployment-only lookup)
     # @param strict [Boolean] 
+    # @param version [String] Semantic version range to validate against the Workflow SDK version (e.g.,
+#  '>=1.0.0,<1.2.3')
     # @param request_options [Vellum::RequestOptions] 
     # @yield on_data[chunk, overall_received_bytes, env] Leverage the Faraday on_data callback which
 #  will receive tuples of strings, the sum of characters received so far, and the
 #  response environment. The latter will allow access to the response status,
 #  headers and reason, as well as the request info.
     # @return [Void]
-    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, strict: nil, request_options: nil, &on_data)
+    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, release_tag: nil, strict: nil, version: nil, request_options: nil, &on_data)
       response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
     req.options.timeout = request_options.timeout_in_seconds
@@ -45,7 +48,7 @@ module Vellum
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
   req.options.on_data = on_data
-  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "strict": strict }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "release_tag": release_tag, "strict": strict, "version": version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -59,6 +62,7 @@ end
     #   * :name (String) 
     #   * :description (String) 
     #   * :release_tags (Array<String>) 
+    #   * :release_description (String) 
     # @param artifact [String, IO] 
     # @param dry_run [Boolean] 
     # @param strict [Boolean] 
@@ -104,14 +108,17 @@ end
     # @param exclude_display [Boolean] 
     # @param include_json [Boolean] 
     # @param include_sandbox [Boolean] 
+    # @param release_tag [String] Release tag to use when pulling from deployment (implies deployment-only lookup)
     # @param strict [Boolean] 
+    # @param version [String] Semantic version range to validate against the Workflow SDK version (e.g.,
+#  '>=1.0.0,<1.2.3')
     # @param request_options [Vellum::RequestOptions] 
     # @yield on_data[chunk, overall_received_bytes, env] Leverage the Faraday on_data callback which
 #  will receive tuples of strings, the sum of characters received so far, and the
 #  response environment. The latter will allow access to the response status,
 #  headers and reason, as well as the request info.
     # @return [Void]
-    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, strict: nil, request_options: nil, &on_data)
+    def pull(id:, exclude_code: nil, exclude_display: nil, include_json: nil, include_sandbox: nil, release_tag: nil, strict: nil, version: nil, request_options: nil, &on_data)
       Async do
         response = @request_client.conn.get do | req |
   unless request_options&.timeout_in_seconds.nil?
@@ -127,7 +134,7 @@ end
   end
   req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
   req.options.on_data = on_data
-  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "strict": strict }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "exclude_code": exclude_code, "exclude_display": exclude_display, "include_json": include_json, "include_sandbox": include_sandbox, "release_tag": release_tag, "strict": strict, "version": version }.compact
   unless request_options.nil? || request_options&.additional_body_parameters.nil?
     req.body = { **(request_options&.additional_body_parameters || {}) }.compact
   end
@@ -142,6 +149,7 @@ end
     #   * :name (String) 
     #   * :description (String) 
     #   * :release_tags (Array<String>) 
+    #   * :release_description (String) 
     # @param artifact [String, IO] 
     # @param dry_run [Boolean] 
     # @param strict [Boolean]