deeprails 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0db85ba4c5a974e1efaa1db27b1888cbbf8ae21c5b1d15b4d75733f662c42a8a
-  data.tar.gz: 1ff3fc484f0032e6dddae533e803d7f591d270527428abba892879e5110105d3
+  metadata.gz: e97d49d00ebc0ed03f3be4d2e391e5091fdaf9cbb1fcd743e5800844c8f233c3
+  data.tar.gz: 98898cc7823efe565ccd8f7519318d9af31fd9f3197c870e467c53cdc67ceaea
 SHA512:
-  metadata.gz: 12ba483e35868225c32653c0f8d3d464944d29e76633f52616e2557a613355222f886caae2aa3c908d535d5e693c92349ec5a8ebe5404c82ecd8d156ade46a96
-  data.tar.gz: 68678894ea182b88ad6dd35b1cbedf1c2f86c210a7769180f2ac82d71f2687a1c96ecd8ca032e0541acd38bee83e0447cbb4fd5ff09f50d9c6fd8f8ea163ec0b
+  metadata.gz: 13b913ddb0433f6de13a5ea8a990b1ef1de1e308012fed87ffde7f42a21596508a280f56401e159a9c8a1a86b9b31d9825a13d35cd4d08486666bb4c57f434a7
+  data.tar.gz: 1326ee104ab1202895c1d3eb667be76c933584fad15979b01505ad6bdf06c07a433762d986e5a9a51fc928070d59f196f3c9bb52d36ae34d27c231a20c0a055e

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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.10.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.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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Deeprails
-  VERSION = "0.9.0"
+  VERSION = "0.10.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

data/rbi/deeprails/models/file_upload_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Deeprails
+  module Models
+    class FileUploadParams < Deeprails::Internal::Type::BaseModel
+      extend Deeprails::Internal::Type::RequestParameters::Converter
+      include Deeprails::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Deeprails::FileUploadParams, Deeprails::Internal::AnyHash)
+        end
+
+      # The contents of the file to upload.
+      sig { returns(Deeprails::Internal::FileInput) }
+      attr_accessor :file
+
+      sig do
+        params(
+          file: Deeprails::Internal::FileInput,
+          request_options: Deeprails::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The contents of the file to upload.
+        file:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            file: Deeprails::Internal::FileInput,
+            request_options: Deeprails::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/deeprails/models.rbi

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

data/rbi/deeprails/resources/defend.rbi

@@ -18,7 +18,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(Deeprails::DefendResponse)
       end
@@ -48,9 +50,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

data/rbi/deeprails/resources/files.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Deeprails
+  module Resources
+    class Files
+      # Use this endpoint to upload a file to the DeepRails API
+      sig do
+        params(
+          file: Deeprails::Internal::FileInput,
+          request_options: Deeprails::RequestOptions::OrHash
+        ).returns(Deeprails::FileResponse)
+      end
+      def upload(
+        # The contents of the file to upload.
+        file:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Deeprails::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/deeprails/client.rbs

@@ -14,6 +14,8 @@ module Deeprails
 
     attr_reader monitor: Deeprails::Resources::Monitor
 
+    attr_reader files: Deeprails::Resources::Files
+
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (

data/sig/deeprails/models/defend_create_workflow_params.rbs

@@ -8,7 +8,9 @@ module Deeprails
         automatic_hallucination_tolerance_levels: ::Hash[Symbol, Deeprails::Models::DefendCreateWorkflowParams::automatic_hallucination_tolerance_level],
         custom_hallucination_threshold_values: ::Hash[Symbol, Float],
         description: String,
-        max_improvement_attempts: Integer
+        file_search: ::Array[String],
+        max_improvement_attempts: Integer,
+        web_search: bool
       }
       & Deeprails::Internal::Type::request_parameters
 
@@ -38,10 +40,18 @@ module Deeprails
 
       def description=: (String) -> String
 
+      attr_reader file_search: ::Array[String]?
+
+      def file_search=: (::Array[String]) -> ::Array[String]
+
       attr_reader max_improvement_attempts: Integer?
 
       def max_improvement_attempts=: (Integer) -> Integer
 
+      attr_reader web_search: bool?
+
+      def web_search=: (bool) -> bool
+
       def initialize: (
         improvement_action: Deeprails::Models::DefendCreateWorkflowParams::improvement_action,
         name: String,
@@ -49,7 +59,9 @@ module Deeprails
         ?automatic_hallucination_tolerance_levels: ::Hash[Symbol, Deeprails::Models::DefendCreateWorkflowParams::automatic_hallucination_tolerance_level],
         ?custom_hallucination_threshold_values: ::Hash[Symbol, Float],
         ?description: String,
+        ?file_search: ::Array[String],
         ?max_improvement_attempts: Integer,
+        ?web_search: bool,
         ?request_options: Deeprails::request_opts
       ) -> void
 
@@ -60,7 +72,9 @@ module Deeprails
         automatic_hallucination_tolerance_levels: ::Hash[Symbol, Deeprails::Models::DefendCreateWorkflowParams::automatic_hallucination_tolerance_level],
         custom_hallucination_threshold_values: ::Hash[Symbol, Float],
         description: String,
+        file_search: ::Array[String],
         max_improvement_attempts: Integer,
+        web_search: bool,
         request_options: Deeprails::RequestOptions
       }
 

data/sig/deeprails/models/file_response.rbs

@@ -0,0 +1,50 @@
+module Deeprails
+  module Models
+    type file_response =
+      {
+        created_at: Time,
+        file_id: String,
+        file_name: String,
+        file_path: String,
+        updated_at: Time
+      }
+
+    class FileResponse < Deeprails::Internal::Type::BaseModel
+      attr_reader created_at: Time?
+
+      def created_at=: (Time) -> Time
+
+      attr_reader file_id: String?
+
+      def file_id=: (String) -> String
+
+      attr_reader file_name: String?
+
+      def file_name=: (String) -> String
+
+      attr_reader file_path: String?
+
+      def file_path=: (String) -> String
+
+      attr_reader updated_at: Time?
+
+      def updated_at=: (Time) -> Time
+
+      def initialize: (
+        ?created_at: Time,
+        ?file_id: String,
+        ?file_name: String,
+        ?file_path: String,
+        ?updated_at: Time
+      ) -> void
+
+      def to_hash: -> {
+        created_at: Time,
+        file_id: String,
+        file_name: String,
+        file_path: String,
+        updated_at: Time
+      }
+    end
+  end
+end

data/sig/deeprails/models/file_upload_params.rbs

@@ -0,0 +1,24 @@
+module Deeprails
+  module Models
+    type file_upload_params =
+      { file: Deeprails::Internal::file_input }
+      & Deeprails::Internal::Type::request_parameters
+
+    class FileUploadParams < Deeprails::Internal::Type::BaseModel
+      extend Deeprails::Internal::Type::RequestParameters::Converter
+      include Deeprails::Internal::Type::RequestParameters
+
+      attr_accessor file: Deeprails::Internal::file_input
+
+      def initialize: (
+        file: Deeprails::Internal::file_input,
+        ?request_options: Deeprails::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        file: Deeprails::Internal::file_input,
+        request_options: Deeprails::RequestOptions
+      }
+    end
+  end
+end

data/sig/deeprails/models.rbs

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

data/sig/deeprails/resources/defend.rbs

@@ -8,7 +8,9 @@ module Deeprails
         ?automatic_hallucination_tolerance_levels: ::Hash[Symbol, Deeprails::Models::DefendCreateWorkflowParams::automatic_hallucination_tolerance_level],
         ?custom_hallucination_threshold_values: ::Hash[Symbol, Float],
         ?description: String,
+        ?file_search: ::Array[String],
         ?max_improvement_attempts: Integer,
+        ?web_search: bool,
         ?request_options: Deeprails::request_opts
       ) -> Deeprails::DefendResponse
 

data/sig/deeprails/resources/files.rbs

@@ -0,0 +1,12 @@
+module Deeprails
+  module Resources
+    class Files
+      def upload: (
+        file: Deeprails::Internal::file_input,
+        ?request_options: Deeprails::request_opts
+      ) -> Deeprails::FileResponse
+
+      def initialize: (client: Deeprails::Client) -> void
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deeprails
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Deeprails
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-29 00:00:00.000000000 Z
+date: 2025-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -61,6 +61,8 @@ files:
 - lib/deeprails/models/defend_retrieve_workflow_params.rb
 - lib/deeprails/models/defend_submit_event_params.rb
 - lib/deeprails/models/defend_update_workflow_params.rb
+- lib/deeprails/models/file_response.rb
+- lib/deeprails/models/file_upload_params.rb
 - lib/deeprails/models/monitor_create_params.rb
 - lib/deeprails/models/monitor_detail_response.rb
 - lib/deeprails/models/monitor_event_response.rb
@@ -71,6 +73,7 @@ files:
 - lib/deeprails/models/workflow_event_response.rb
 - lib/deeprails/request_options.rb
 - lib/deeprails/resources/defend.rb
+- lib/deeprails/resources/files.rb
 - lib/deeprails/resources/monitor.rb
 - lib/deeprails/version.rb
 - manifest.yaml
@@ -99,6 +102,8 @@ files:
 - rbi/deeprails/models/defend_retrieve_workflow_params.rbi
 - rbi/deeprails/models/defend_submit_event_params.rbi
 - rbi/deeprails/models/defend_update_workflow_params.rbi
+- rbi/deeprails/models/file_response.rbi
+- rbi/deeprails/models/file_upload_params.rbi
 - rbi/deeprails/models/monitor_create_params.rbi
 - rbi/deeprails/models/monitor_detail_response.rbi
 - rbi/deeprails/models/monitor_event_response.rbi
@@ -109,6 +114,7 @@ files:
 - rbi/deeprails/models/workflow_event_response.rbi
 - rbi/deeprails/request_options.rbi
 - rbi/deeprails/resources/defend.rbi
+- rbi/deeprails/resources/files.rbi
 - rbi/deeprails/resources/monitor.rbi
 - rbi/deeprails/version.rbi
 - sig/deeprails/client.rbs
@@ -136,6 +142,8 @@ files:
 - sig/deeprails/models/defend_retrieve_workflow_params.rbs
 - sig/deeprails/models/defend_submit_event_params.rbs
 - sig/deeprails/models/defend_update_workflow_params.rbs
+- sig/deeprails/models/file_response.rbs
+- sig/deeprails/models/file_upload_params.rbs
 - sig/deeprails/models/monitor_create_params.rbs
 - sig/deeprails/models/monitor_detail_response.rbs
 - sig/deeprails/models/monitor_event_response.rbs
@@ -146,6 +154,7 @@ files:
 - sig/deeprails/models/workflow_event_response.rbs
 - sig/deeprails/request_options.rbs
 - sig/deeprails/resources/defend.rbs
+- sig/deeprails/resources/files.rbs
 - sig/deeprails/resources/monitor.rbs
 - sig/deeprails/version.rbs
 homepage: https://gemdocs.org/gems/deeprails