deeprails 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0db85ba4c5a974e1efaa1db27b1888cbbf8ae21c5b1d15b4d75733f662c42a8a
-  data.tar.gz: 1ff3fc484f0032e6dddae533e803d7f591d270527428abba892879e5110105d3
+  metadata.gz: 27710c0ec0510319e5002b296aa2eecb635640fee1a38423cf43e8792abd1c9a
+  data.tar.gz: 372425505cca1a9bfea94c6adbe93c99cf13cfdf26ea4506ae934e0049486acd
 SHA512:
-  metadata.gz: 12ba483e35868225c32653c0f8d3d464944d29e76633f52616e2557a613355222f886caae2aa3c908d535d5e693c92349ec5a8ebe5404c82ecd8d156ade46a96
-  data.tar.gz: 68678894ea182b88ad6dd35b1cbedf1c2f86c210a7769180f2ac82d71f2687a1c96ecd8ca032e0541acd38bee83e0447cbb4fd5ff09f50d9c6fd8f8ea163ec0b
+  metadata.gz: 03e5bbb5226ef22805593349a2ccd1e4f888405bcb15b19eadc01fcd0e001d88a1b096ccfabc467f8b5cd6de6217d5dfc13122911a41b9866fb4467282e9d14f
+  data.tar.gz: 2bfd88ef33139e1ac30af2d3d4098e55061f6712736e61598908e972612cf1053eff0ba1cacc052c2a3e8522742617d320ae1fc471000ef9fc4f4749ad121fb8

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.11.0 (2025-11-02)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** restructure monitor service ([9682519](https://github.com/deeprails/deeprails-ruby-sdk/commit/968251927003819495ee8c2e5ec9c9276f0a298d))
+
+## 0.10.0 (2025-10-30)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** Add file and web search as extended ai capabilities ([9c3e153](https://github.com/deeprails/deeprails-ruby-sdk/commit/9c3e153565a92a3e4228ffd1193cff119f7acbfe))
+* **api:** manual updates ([7c6bd65](https://github.com/deeprails/deeprails-ruby-sdk/commit/7c6bd65a0fdafc880b467aa2ab5bc587d300bf76))
+
 ## 0.9.0 (2025-10-29)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.8.0...v0.9.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "deeprails", "~> 0.9.0"
+gem "deeprails", "~> 0.11.0"
 ```
 
 <!-- x-release-please-end -->
@@ -40,6 +40,28 @@ defend_response = deeprails.defend.create_workflow(
 puts(defend_response.workflow_id)
 ```
 
+### File uploads
+
+Request parameters that correspond to file uploads can be passed as raw contents, a [`Pathname`](https://rubyapi.org/3.2/o/pathname) instance, [`StringIO`](https://rubyapi.org/3.2/o/stringio), or more.
+
+```ruby
+require "pathname"
+
+# Use `Pathname` to send the filename and/or avoid paging a large file into memory:
+file_response = deeprails.files.upload(file: Pathname("/path/to/file"))
+
+# Alternatively, pass file contents or a `StringIO` directly:
+file_response = deeprails.files.upload(file: File.read("/path/to/file"))
+
+# Or, to control the filename and/or content type:
+file = Deeprails::FilePart.new(File.read("/path/to/file"), filename: "/path/to/file", content_type: "…")
+file_response = deeprails.files.upload(file: file)
+
+puts(file_response.file_id)
+```
+
+Note that you can also pass a raw `IO` descriptor, but this disables retries, as the library can't be sure if the descriptor is a file or pipe (which cannot be rewound).
+
 ### Handling errors
 
 When the library is unable to connect to the API, or if the API returns a non-success status code (i.e., 4xx or 5xx response), a subclass of `Deeprails::Errors::APIError` will be thrown:

data/lib/deeprails/client.rb

@@ -24,6 +24,9 @@ module Deeprails
     # @return [Deeprails::Resources::Monitor]
     attr_reader :monitor
 
+    # @return [Deeprails::Resources::Files]
+    attr_reader :files
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -73,6 +76,7 @@ module Deeprails
 
       @defend = Deeprails::Resources::Defend.new(client: self)
       @monitor = Deeprails::Resources::Monitor.new(client: self)
+      @files = Deeprails::Resources::Files.new(client: self)
     end
   end
 end

data/lib/deeprails/models/defend_create_workflow_params.rb

@@ -57,6 +57,13 @@ module Deeprails
       #   @return [String, nil]
       optional :description, String
 
+      # @!attribute file_search
+      #   An array of file IDs to search in the workflow's evaluations. Files must be
+      #   uploaded via the DeepRails API first.
+      #
+      #   @return [Array<String>, nil]
+      optional :file_search, Deeprails::Internal::Type::ArrayOf[String]
+
       # @!attribute max_improvement_attempts
       #   Max. number of improvement action retries until a given event passes the
       #   guardrails. Defaults to 10.
@@ -64,7 +71,13 @@ module Deeprails
       #   @return [Integer, nil]
       optional :max_improvement_attempts, Integer
 
-      # @!method initialize(improvement_action:, name:, type:, automatic_hallucination_tolerance_levels: nil, custom_hallucination_threshold_values: nil, description: nil, max_improvement_attempts: nil, request_options: {})
+      # @!attribute web_search
+      #   Whether to enable web search for this workflow's evaluations. Defaults to false.
+      #
+      #   @return [Boolean, nil]
+      optional :web_search, Deeprails::Internal::Type::Boolean
+
+      # @!method initialize(improvement_action:, name:, type:, automatic_hallucination_tolerance_levels: nil, custom_hallucination_threshold_values: nil, description: nil, file_search: nil, max_improvement_attempts: nil, web_search: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Deeprails::Models::DefendCreateWorkflowParams} for more details.
       #
@@ -80,8 +93,12 @@ module Deeprails
       #
       #   @param description [String] Description for the workflow.
       #
+      #   @param file_search [Array<String>] An array of file IDs to search in the workflow's evaluations. Files must be uplo
+      #
       #   @param max_improvement_attempts [Integer] Max. number of improvement action retries until a given event passes the guardra
       #
+      #   @param web_search [Boolean] Whether to enable web search for this workflow's evaluations. Defaults to false.
+      #
       #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
 
       # The action used to improve outputs that fail one or guardrail metrics for the

data/lib/deeprails/models/file_response.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Models
+    # @see Deeprails::Resources::Files#upload
+    class FileResponse < Deeprails::Internal::Type::BaseModel
+      # @!attribute created_at
+      #   The time the file was created in UTC.
+      #
+      #   @return [Time, nil]
+      optional :created_at, Time
+
+      # @!attribute file_id
+      #   A unique file ID.
+      #
+      #   @return [String, nil]
+      optional :file_id, String
+
+      # @!attribute file_name
+      #   Name of the file.
+      #
+      #   @return [String, nil]
+      optional :file_name, String
+
+      # @!attribute file_path
+      #   Path to the s3 bucket where the file is stored.
+      #
+      #   @return [String, nil]
+      optional :file_path, String
+
+      # @!attribute updated_at
+      #   The most recent time the file was modified in UTC.
+      #
+      #   @return [Time, nil]
+      optional :updated_at, Time
+
+      # @!method initialize(created_at: nil, file_id: nil, file_name: nil, file_path: nil, updated_at: nil)
+      #   @param created_at [Time] The time the file was created in UTC.
+      #
+      #   @param file_id [String] A unique file ID.
+      #
+      #   @param file_name [String] Name of the file.
+      #
+      #   @param file_path [String] Path to the s3 bucket where the file is stored.
+      #
+      #   @param updated_at [Time] The most recent time the file was modified in UTC.
+    end
+  end
+end

data/lib/deeprails/models/file_upload_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Models
+    # @see Deeprails::Resources::Files#upload
+    class FileUploadParams < Deeprails::Internal::Type::BaseModel
+      extend Deeprails::Internal::Type::RequestParameters::Converter
+      include Deeprails::Internal::Type::RequestParameters
+
+      # @!attribute file
+      #   The contents of the file to upload.
+      #
+      #   @return [Pathname, StringIO, IO, String, Deeprails::FilePart]
+      required :file, Deeprails::Internal::Type::FileInput
+
+      # @!method initialize(file:, request_options: {})
+      #   @param file [Pathname, StringIO, IO, String, Deeprails::FilePart] The contents of the file to upload.
+      #
+      #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/deeprails/models/monitor_create_params.rb

@@ -7,6 +7,16 @@ module Deeprails
       extend Deeprails::Internal::Type::RequestParameters::Converter
       include Deeprails::Internal::Type::RequestParameters
 
+      # @!attribute guardrail_metrics
+      #   An array of guardrail metrics that the model input and output pair will be
+      #   evaluated on. For non-enterprise users, these will be limited to `correctness`,
+      #   `completeness`, `instruction_adherence`, `context_adherence`,
+      #   `ground_truth_adherence`, and/or `comprehensive_safety`.
+      #
+      #   @return [Array<Symbol, Deeprails::Models::MonitorCreateParams::GuardrailMetric>]
+      required :guardrail_metrics,
+               -> { Deeprails::Internal::Type::ArrayOf[enum: Deeprails::MonitorCreateParams::GuardrailMetric] }
+
       # @!attribute name
       #   Name of the new monitor.
       #
@@ -19,12 +29,48 @@ module Deeprails
       #   @return [String, nil]
       optional :description, String
 
-      # @!method initialize(name:, description: nil, request_options: {})
+      # @!attribute file_search
+      #   An array of file IDs to search in the monitor's evaluations. Files must be
+      #   uploaded via the DeepRails API first.
+      #
+      #   @return [Array<String>, nil]
+      optional :file_search, Deeprails::Internal::Type::ArrayOf[String]
+
+      # @!attribute web_search
+      #   Whether to enable web search for this monitor's evaluations. Defaults to false.
+      #
+      #   @return [Boolean, nil]
+      optional :web_search, Deeprails::Internal::Type::Boolean
+
+      # @!method initialize(guardrail_metrics:, name:, description: nil, file_search: nil, web_search: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Deeprails::Models::MonitorCreateParams} for more details.
+      #
+      #   @param guardrail_metrics [Array<Symbol, Deeprails::Models::MonitorCreateParams::GuardrailMetric>] An array of guardrail metrics that the model input and output pair will be evalu
+      #
       #   @param name [String] Name of the new monitor.
       #
       #   @param description [String] Description of the new monitor.
       #
+      #   @param file_search [Array<String>] An array of file IDs to search in the monitor's evaluations. Files must be uploa
+      #
+      #   @param web_search [Boolean] Whether to enable web search for this monitor's evaluations. Defaults to false.
+      #
       #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
+
+      module GuardrailMetric
+        extend Deeprails::Internal::Type::Enum
+
+        CORRECTNESS = :correctness
+        COMPLETENESS = :completeness
+        INSTRUCTION_ADHERENCE = :instruction_adherence
+        CONTEXT_ADHERENCE = :context_adherence
+        GROUND_TRUTH_ADHERENCE = :ground_truth_adherence
+        COMPREHENSIVE_SAFETY = :comprehensive_safety
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/deeprails/models/monitor_submit_event_params.rb

@@ -7,16 +7,6 @@ module Deeprails
       extend Deeprails::Internal::Type::RequestParameters::Converter
       include Deeprails::Internal::Type::RequestParameters
 
-      # @!attribute guardrail_metrics
-      #   An array of guardrail metrics that the model input and output pair will be
-      #   evaluated on. For non-enterprise users, these will be limited to `correctness`,
-      #   `completeness`, `instruction_adherence`, `context_adherence`,
-      #   `ground_truth_adherence`, and/or `comprehensive_safety`.
-      #
-      #   @return [Array<Symbol, Deeprails::Models::MonitorSubmitEventParams::GuardrailMetric>]
-      required :guardrail_metrics,
-               -> { Deeprails::Internal::Type::ArrayOf[enum: Deeprails::MonitorSubmitEventParams::GuardrailMetric] }
-
       # @!attribute model_input
       #   A dictionary of inputs sent to the LLM to generate output. The dictionary must
       #   contain at least a `user_prompt` field or a `system_prompt` field. For
@@ -31,12 +21,6 @@ module Deeprails
       #   @return [String]
       required :model_output, String
 
-      # @!attribute model_used
-      #   Model ID used to generate the output, like `gpt-4o` or `o3`.
-      #
-      #   @return [String, nil]
-      optional :model_used, String
-
       # @!attribute nametag
       #   An optional, user-defined tag for the event.
       #
@@ -52,38 +36,20 @@ module Deeprails
       #   @return [Symbol, Deeprails::Models::MonitorSubmitEventParams::RunMode, nil]
       optional :run_mode, enum: -> { Deeprails::MonitorSubmitEventParams::RunMode }
 
-      # @!method initialize(guardrail_metrics:, model_input:, model_output:, model_used: nil, nametag: nil, run_mode: nil, request_options: {})
+      # @!method initialize(model_input:, model_output:, nametag: nil, run_mode: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Deeprails::Models::MonitorSubmitEventParams} for more details.
       #
-      #   @param guardrail_metrics [Array<Symbol, Deeprails::Models::MonitorSubmitEventParams::GuardrailMetric>] An array of guardrail metrics that the model input and output pair will be evalu
-      #
       #   @param model_input [Deeprails::Models::MonitorSubmitEventParams::ModelInput] A dictionary of inputs sent to the LLM to generate output. The dictionary must c
       #
       #   @param model_output [String] Output generated by the LLM to be evaluated.
       #
-      #   @param model_used [String] Model ID used to generate the output, like `gpt-4o` or `o3`.
-      #
       #   @param nametag [String] An optional, user-defined tag for the event.
       #
       #   @param run_mode [Symbol, Deeprails::Models::MonitorSubmitEventParams::RunMode] Run mode for the monitor event. The run mode allows the user to optimize for sp
       #
       #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
 
-      module GuardrailMetric
-        extend Deeprails::Internal::Type::Enum
-
-        CORRECTNESS = :correctness
-        COMPLETENESS = :completeness
-        INSTRUCTION_ADHERENCE = :instruction_adherence
-        CONTEXT_ADHERENCE = :context_adherence
-        GROUND_TRUTH_ADHERENCE = :ground_truth_adherence
-        COMPREHENSIVE_SAFETY = :comprehensive_safety
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
-
       class ModelInput < Deeprails::Internal::Type::BaseModel
         # @!attribute ground_truth
         #   The ground truth for evaluating Ground Truth Adherence guardrail.

data/lib/deeprails/models.rb

@@ -51,6 +51,10 @@ module Deeprails
 
   DefendUpdateWorkflowParams = Deeprails::Models::DefendUpdateWorkflowParams
 
+  FileResponse = Deeprails::Models::FileResponse
+
+  FileUploadParams = Deeprails::Models::FileUploadParams
+
   MonitorCreateParams = Deeprails::Models::MonitorCreateParams
 
   MonitorDetailResponse = Deeprails::Models::MonitorDetailResponse

data/lib/deeprails/resources/defend.rb

@@ -9,7 +9,7 @@ module Deeprails
       # Use this endpoint to create a new guardrail workflow with optional guardrail
       # thresholds and improvement actions
       #
-      # @overload create_workflow(improvement_action:, name:, type:, automatic_hallucination_tolerance_levels: nil, custom_hallucination_threshold_values: nil, description: nil, max_improvement_attempts: nil, request_options: {})
+      # @overload create_workflow(improvement_action:, name:, type:, automatic_hallucination_tolerance_levels: nil, custom_hallucination_threshold_values: nil, description: nil, file_search: nil, max_improvement_attempts: nil, web_search: nil, request_options: {})
       #
       # @param improvement_action [Symbol, Deeprails::Models::DefendCreateWorkflowParams::ImprovementAction] The action used to improve outputs that fail one or guardrail metrics for the wo
       #
@@ -23,8 +23,12 @@ module Deeprails
       #
       # @param description [String] Description for the workflow.
       #
+      # @param file_search [Array<String>] An array of file IDs to search in the workflow's evaluations. Files must be uplo
+      #
       # @param max_improvement_attempts [Integer] Max. number of improvement action retries until a given event passes the guardra
       #
+      # @param web_search [Boolean] Whether to enable web search for this workflow's evaluations. Defaults to false.
+      #
       # @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Deeprails::Models::DefendResponse]

data/lib/deeprails/resources/files.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Resources
+    class Files
+      # Use this endpoint to upload a file to the DeepRails API
+      #
+      # @overload upload(file:, request_options: {})
+      #
+      # @param file [Pathname, StringIO, IO, String, Deeprails::FilePart] The contents of the file to upload.
+      #
+      # @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Deeprails::Models::FileResponse]
+      #
+      # @see Deeprails::Models::FileUploadParams
+      def upload(params)
+        parsed, options = Deeprails::FileUploadParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "files/upload",
+          headers: {"content-type" => "multipart/form-data"},
+          body: parsed,
+          model: Deeprails::FileResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Deeprails::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/deeprails/resources/monitor.rb

@@ -3,15 +3,24 @@
 module Deeprails
   module Resources
     class Monitor
+      # Some parameter documentations has been truncated, see
+      # {Deeprails::Models::MonitorCreateParams} for more details.
+      #
       # Use this endpoint to create a new monitor to evaluate model inputs and outputs
       # using guardrails
       #
-      # @overload create(name:, description: nil, request_options: {})
+      # @overload create(guardrail_metrics:, name:, description: nil, file_search: nil, web_search: nil, request_options: {})
+      #
+      # @param guardrail_metrics [Array<Symbol, Deeprails::Models::MonitorCreateParams::GuardrailMetric>] An array of guardrail metrics that the model input and output pair will be evalu
       #
       # @param name [String] Name of the new monitor.
       #
       # @param description [String] Description of the new monitor.
       #
+      # @param file_search [Array<String>] An array of file IDs to search in the monitor's evaluations. Files must be uploa
+      #
+      # @param web_search [Boolean] Whether to enable web search for this monitor's evaluations. Defaults to false.
+      #
       # @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Deeprails::Models::MonitorResponse]
@@ -91,18 +100,14 @@ module Deeprails
       # Use this endpoint to submit a model input and output pair to a monitor for
       # evaluation
       #
-      # @overload submit_event(monitor_id, guardrail_metrics:, model_input:, model_output:, model_used: nil, nametag: nil, run_mode: nil, request_options: {})
+      # @overload submit_event(monitor_id, model_input:, model_output:, nametag: nil, run_mode: nil, request_options: {})
       #
       # @param monitor_id [String] The ID of the monitor associated with this event.
       #
-      # @param guardrail_metrics [Array<Symbol, Deeprails::Models::MonitorSubmitEventParams::GuardrailMetric>] An array of guardrail metrics that the model input and output pair will be evalu
-      #
       # @param model_input [Deeprails::Models::MonitorSubmitEventParams::ModelInput] A dictionary of inputs sent to the LLM to generate output. The dictionary must c
       #
       # @param model_output [String] Output generated by the LLM to be evaluated.
       #
-      # @param model_used [String] Model ID used to generate the output, like `gpt-4o` or `o3`.
-      #
       # @param nametag [String] An optional, user-defined tag for the event.
       #
       # @param run_mode [Symbol, Deeprails::Models::MonitorSubmitEventParams::RunMode] Run mode for the monitor event. The run mode allows the user to optimize for sp

data/lib/deeprails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Deeprails
-  VERSION = "0.9.0"
+  VERSION = "0.11.0"
 end

data/lib/deeprails.rb

@@ -56,6 +56,8 @@ require_relative "deeprails/models/defend_retrieve_event_params"
 require_relative "deeprails/models/defend_retrieve_workflow_params"
 require_relative "deeprails/models/defend_submit_event_params"
 require_relative "deeprails/models/defend_update_workflow_params"
+require_relative "deeprails/models/file_response"
+require_relative "deeprails/models/file_upload_params"
 require_relative "deeprails/models/monitor_create_params"
 require_relative "deeprails/models/monitor_detail_response"
 require_relative "deeprails/models/monitor_event_response"
@@ -66,4 +68,5 @@ require_relative "deeprails/models/monitor_update_params"
 require_relative "deeprails/models/workflow_event_response"
 require_relative "deeprails/models"
 require_relative "deeprails/resources/defend"
+require_relative "deeprails/resources/files"
 require_relative "deeprails/resources/monitor"

data/rbi/deeprails/client.rbi

@@ -19,6 +19,9 @@ module Deeprails
     sig { returns(Deeprails::Resources::Monitor) }
     attr_reader :monitor
 
+    sig { returns(Deeprails::Resources::Files) }
+    attr_reader :files
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/deeprails/models/defend_create_workflow_params.rbi

@@ -85,6 +85,14 @@ module Deeprails
       sig { params(description: String).void }
       attr_writer :description
 
+      # An array of file IDs to search in the workflow's evaluations. Files must be
+      # uploaded via the DeepRails API first.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :file_search
+
+      sig { params(file_search: T::Array[String]).void }
+      attr_writer :file_search
+
       # Max. number of improvement action retries until a given event passes the
       # guardrails. Defaults to 10.
       sig { returns(T.nilable(Integer)) }
@@ -93,6 +101,13 @@ module Deeprails
       sig { params(max_improvement_attempts: Integer).void }
       attr_writer :max_improvement_attempts
 
+      # Whether to enable web search for this workflow's evaluations. Defaults to false.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :web_search
+
+      sig { params(web_search: T::Boolean).void }
+      attr_writer :web_search
+
       sig do
         params(
           improvement_action:
@@ -106,7 +121,9 @@ module Deeprails
             ],
           custom_hallucination_threshold_values: T::Hash[Symbol, Float],
           description: String,
+          file_search: T::Array[String],
           max_improvement_attempts: Integer,
+          web_search: T::Boolean,
           request_options: Deeprails::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -136,9 +153,14 @@ module Deeprails
         custom_hallucination_threshold_values: nil,
         # Description for the workflow.
         description: nil,
+        # An array of file IDs to search in the workflow's evaluations. Files must be
+        # uploaded via the DeepRails API first.
+        file_search: nil,
         # Max. number of improvement action retries until a given event passes the
         # guardrails. Defaults to 10.
         max_improvement_attempts: nil,
+        # Whether to enable web search for this workflow's evaluations. Defaults to false.
+        web_search: nil,
         request_options: {}
       )
       end
@@ -157,7 +179,9 @@ module Deeprails
               ],
             custom_hallucination_threshold_values: T::Hash[Symbol, Float],
             description: String,
+            file_search: T::Array[String],
             max_improvement_attempts: Integer,
+            web_search: T::Boolean,
             request_options: Deeprails::RequestOptions
           }
         )

data/rbi/deeprails/models/file_response.rbi

@@ -0,0 +1,84 @@
+# typed: strong
+
+module Deeprails
+  module Models
+    class FileResponse < Deeprails::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Deeprails::FileResponse, Deeprails::Internal::AnyHash)
+        end
+
+      # The time the file was created in UTC.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :created_at
+
+      sig { params(created_at: Time).void }
+      attr_writer :created_at
+
+      # A unique file ID.
+      sig { returns(T.nilable(String)) }
+      attr_reader :file_id
+
+      sig { params(file_id: String).void }
+      attr_writer :file_id
+
+      # Name of the file.
+      sig { returns(T.nilable(String)) }
+      attr_reader :file_name
+
+      sig { params(file_name: String).void }
+      attr_writer :file_name
+
+      # Path to the s3 bucket where the file is stored.
+      sig { returns(T.nilable(String)) }
+      attr_reader :file_path
+
+      sig { params(file_path: String).void }
+      attr_writer :file_path
+
+      # The most recent time the file was modified in UTC.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: Time).void }
+      attr_writer :updated_at
+
+      sig do
+        params(
+          created_at: Time,
+          file_id: String,
+          file_name: String,
+          file_path: String,
+          updated_at: Time
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The time the file was created in UTC.
+        created_at: nil,
+        # A unique file ID.
+        file_id: nil,
+        # Name of the file.
+        file_name: nil,
+        # Path to the s3 bucket where the file is stored.
+        file_path: nil,
+        # The most recent time the file was modified in UTC.
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            created_at: Time,
+            file_id: String,
+            file_name: String,
+            file_path: String,
+            updated_at: Time
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end