deeprails 0.18.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54176c43a05bdde5394a3f0f01c37c0f1485e5e29049174c0d480debcd6b5f04
-  data.tar.gz: 8bd890ce30a2c75f3abc6e46261f7df60179bc4d2802a44db4eb27e1fb6e4bf7
+  metadata.gz: 27fa10a22615062a47a7c91fd063f80d87318da5d6bb5e375174fd9cb4b7e6b7
+  data.tar.gz: 24192097ccfe647482b666ece995279bc428774789bff6a62f678bb5da37356d
 SHA512:
-  metadata.gz: 2ee61755f2763bbdf7b29e5a2c9f2890863c85e16e5a32175251360f21ccb6128c1af96ac04feb026c00ee19ad0a5fc631c382e9a8a91c0af7e1cb485795093e
-  data.tar.gz: 1509a75d3b7a7565fe47ab1cb831de2445eaa8c08769b78f3d66d13ab9530752d8b1d41898d495b77aac678e4d7aaac59c58bde46a491bff8ea036bc2cca5826
+  metadata.gz: 1648800bce667593e627487f6f46b9a70d5958327d002178b9cd84f330e8399d37709774488bec9e84402afc1b9553c7512497eb31237c570e4cf55f1563ec36
+  data.tar.gz: 37dc7effa1649426ac95e881aafc84fed9b7c1dad3490969a8c4e9df6ad575ff54b7b37f21d98df82cdab0c7210cb02e86f54ab6cb261a9e50b6b15af5783cc0

data/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 0.23.0 (2026-01-20)
+
+Full Changelog: [v0.22.0...v0.23.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.22.0...v0.23.0)
+
+### Features
+
+* **api:** manual updates ([dbfbe16](https://github.com/deeprails/deeprails-ruby-sdk/commit/dbfbe16ac8b8bef8066b3a1b12ffc1d1b6e793d3))
+
+
+### Chores
+
+* **internal:** codegen related update ([3cae355](https://github.com/deeprails/deeprails-ruby-sdk/commit/3cae35599062af95a670c3bb23ab52ee5ccb5fe6))
+* **internal:** codegen related update ([cbd8b12](https://github.com/deeprails/deeprails-ruby-sdk/commit/cbd8b12f0ddfd8f0ec1e15930095ede2a5bc1fe1))
+* **internal:** update `actions/checkout` version ([b24ab56](https://github.com/deeprails/deeprails-ruby-sdk/commit/b24ab5603ff3fc351e833ecc41522c6a4065908e))
+
+## 0.22.0 (2025-12-23)
+
+Full Changelog: [v0.21.0...v0.22.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.21.0...v0.22.0)
+
+### Features
+
+* **api:** add key improvements and analysis of failures ([8cc372b](https://github.com/deeprails/deeprails-ruby-sdk/commit/8cc372b0f1cf6b6c7d5f55b6f90d3a27ac74b76c))
+
+
+### Bug Fixes
+
+* calling `break` out of streams should be instantaneous ([5f7ac38](https://github.com/deeprails/deeprails-ruby-sdk/commit/5f7ac38fa7016361c356072867dc3a025b3c3a92))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([f7b4a02](https://github.com/deeprails/deeprails-ruby-sdk/commit/f7b4a026be2ddc89a52eedc4643c7e2e51f76e5d))
+
+## 0.21.0 (2025-12-15)
+
+Full Changelog: [v0.20.0...v0.21.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.20.0...v0.21.0)
+
+### Features
+
+* **api:** add precision plus codex ([d67ca44](https://github.com/deeprails/deeprails-ruby-sdk/commit/d67ca4443d30fad4211caf43f0d7a63adf4f8b2b))
+
+## 0.20.0 (2025-12-07)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** Expand update endpoints ([faaf87b](https://github.com/deeprails/deeprails-ruby-sdk/commit/faaf87bc835773fe50e20c43a8ca59b69f4d3b2e))
+* **api:** manual updates ([b8a55ea](https://github.com/deeprails/deeprails-ruby-sdk/commit/b8a55eafa68bed34063f8745a8d460266d1a30d1))
+
+## 0.19.0 (2025-12-07)
+
+Full Changelog: [v0.18.1...v0.19.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.18.1...v0.19.0)
+
+### Features
+
+* **api:** added context_awareness and context ([9562c79](https://github.com/deeprails/deeprails-ruby-sdk/commit/9562c797fdfd5fdb45b28a4b428b005017998c55))
+
+## 0.18.1 (2025-11-21)
+
+Full Changelog: [v0.18.0...v0.18.1](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.18.0...v0.18.1)
+
+### Chores
+
+* explicitly require "base64" gem ([99d2fb5](https://github.com/deeprails/deeprails-ruby-sdk/commit/99d2fb51770004bb14a8f15370956852481eb233))
+
 ## 0.18.0 (2025-11-20)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/deeprails/deeprails-ruby-sdk/compare/v0.17.0...v0.18.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.18.0"
+gem "deeprails", "~> 0.23.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/deeprails/internal/stream.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   stream.each do |event|
+    #     puts(event)
+    #   end
+    class Stream
+      include Deeprails::Internal::Type::BaseStream
+
+      # @api private
+      #
+      # @return [Enumerable<generic<Elem>>]
+      private def iterator
+        @iterator ||= Deeprails::Internal::Util.chain_fused(@stream) do |y|
+          @stream.each do |msg|
+            next if (data = msg.fetch(:data)).nil?
+            decoded = JSON.parse(data, symbolize_names: true)
+            unwrapped = Deeprails::Internal::Util.dig(decoded, @unwrap)
+            y << Deeprails::Internal::Type::Converter.coerce(@model, unwrapped)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/deeprails/internal/transport/base_client.rb

@@ -549,7 +549,9 @@ module Deeprails
                 )
               ),
               page: T.nilable(T::Class[Deeprails::Internal::Type::BasePage[Deeprails::Internal::Type::BaseModel]]),
-              stream: T.nilable(T::Class[T.anything]),
+              stream: T.nilable(
+                T::Class[Deeprails::Internal::Type::BaseStream[T.anything, Deeprails::Internal::Type::BaseModel]]
+              ),
               model: T.nilable(Deeprails::Internal::Type::Converter::Input),
               options: T.nilable(Deeprails::RequestOptions::OrHash)
             }

data/lib/deeprails/internal/transport/pooled_net_requester.rb

@@ -153,17 +153,19 @@ module Deeprails
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure

data/lib/deeprails/internal/type/base_stream.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Internal
+    module Type
+      # @api private
+      #
+      # @generic Elem
+      #
+      # This module provides a base implementation for streaming responses in the SDK.
+      #
+      # @see https://rubyapi.org/3.2/o/enumerable
+      module BaseStream
+        include Enumerable
+
+        # @return [Integer]
+        attr_reader :status
+
+        # @return [Hash{String=>String}]
+        attr_reader :headers
+
+        # @api public
+        #
+        # @return [void]
+        def close = Deeprails::Internal::Util.close_fused!(@iterator)
+
+        # @api private
+        #
+        # @return [Enumerable<generic<Elem>>]
+        private def iterator = (raise NotImplementedError)
+
+        # @api public
+        #
+        # @param blk [Proc]
+        #
+        # @yieldparam [generic<Elem>]
+        # @return [void]
+        def each(&blk)
+          unless block_given?
+            raise ArgumentError.new("A block must be given to ##{__method__}")
+          end
+          @iterator.each(&blk)
+        end
+
+        # @api public
+        #
+        # @return [Enumerator<generic<Elem>>]
+        def to_enum = @iterator
+
+        alias_method :enum_for, :to_enum
+
+        # @api private
+        #
+        # @param model [Class, Deeprails::Internal::Type::Converter]
+        # @param url [URI::Generic]
+        # @param status [Integer]
+        # @param headers [Hash{String=>String}]
+        # @param response [Net::HTTPResponse]
+        # @param unwrap [Symbol, Integer, Array<Symbol, Integer>, Proc]
+        # @param stream [Enumerable<Object>]
+        def initialize(model:, url:, status:, headers:, response:, unwrap:, stream:)
+          @model = model
+          @url = url
+          @status = status
+          @headers = headers
+          @response = response
+          @unwrap = unwrap
+          @stream = stream
+          @iterator = iterator
+        end
+
+        # @api private
+        #
+        # @return [String]
+        def inspect
+          model = Deeprails::Internal::Type::Converter.inspect(@model, depth: 1)
+
+          "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
+        end
+      end
+    end
+  end
+end

data/lib/deeprails/internal/util.rb

@@ -657,7 +657,8 @@ module Deeprails
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in Deeprails::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +668,11 @@ module Deeprails
           in Deeprails::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/deeprails/models/defend_create_workflow_params.rb

@@ -43,6 +43,17 @@ module Deeprails
       optional :automatic_hallucination_tolerance_levels,
                -> { Deeprails::Internal::Type::HashOf[enum: Deeprails::DefendCreateWorkflowParams::AutomaticHallucinationToleranceLevel] }
 
+      # @!attribute context_awareness
+      #   Context includes any structured information that directly relates to the model’s
+      #   input and expected output—e.g., the recent turn-by-turn history between an AI
+      #   tutor and a student, facts or state passed through an agentic workflow, or other
+      #   domain-specific signals your system already knows and wants the model to
+      #   condition on. This field determines whether to enable context awareness for this
+      #   workflow's evaluations. Defaults to false.
+      #
+      #   @return [Boolean, nil]
+      optional :context_awareness, Deeprails::Internal::Type::Boolean
+
       # @!attribute custom_hallucination_threshold_values
       #   Mapping of guardrail metrics to floating point threshold values. Possible
       #   metrics are `correctness`, `completeness`, `instruction_adherence`,
@@ -77,7 +88,7 @@ module Deeprails
       #   @return [Boolean, nil]
       optional :web_search, Deeprails::Internal::Type::Boolean
 
-      # @!method initialize(improvement_action:, name:, threshold_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: {})
+      # @!method initialize(improvement_action:, name:, threshold_type:, automatic_hallucination_tolerance_levels: nil, context_awareness: 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.
       #
@@ -89,6 +100,8 @@ module Deeprails
       #
       #   @param automatic_hallucination_tolerance_levels [Hash{Symbol=>Symbol, Deeprails::Models::DefendCreateWorkflowParams::AutomaticHallucinationToleranceLevel}] Mapping of guardrail metrics to hallucination tolerance levels
       #
+      #   @param context_awareness [Boolean] Context includes any structured information that directly relates to the model’s
+      #
       #   @param custom_hallucination_threshold_values [Hash{Symbol=>Float}] Mapping of guardrail metrics to floating point threshold values. Possible metric
       #
       #   @param description [String] Description for the workflow.

data/lib/deeprails/models/defend_response.rb

@@ -13,8 +13,8 @@ module Deeprails
                -> { Deeprails::Internal::Type::HashOf[enum: Deeprails::DefendResponse::AutomaticHallucinationToleranceLevel] }
 
       # @!attribute capabilities
-      #   Extended AI capabilities available to the event, if any. Can be `web_search`
-      #   and/or `file_search`.
+      #   Extended AI capabilities available to the event, if any. Can be `web_search`,
+      #   `file_search`, and/or `context_awareness`.
       #
       #   @return [Array<Deeprails::Models::DefendResponse::Capability>]
       required :capabilities, -> { Deeprails::Internal::Type::ArrayOf[Deeprails::DefendResponse::Capability] }
@@ -101,7 +101,7 @@ module Deeprails
       #
       #   @param automatic_hallucination_tolerance_levels [Hash{Symbol=>Symbol, Deeprails::Models::DefendResponse::AutomaticHallucinationToleranceLevel}] Mapping of guardrail metric names to tolerance values. Values can be strings (`l
       #
-      #   @param capabilities [Array<Deeprails::Models::DefendResponse::Capability>] Extended AI capabilities available to the event, if any. Can be `web_search` and
+      #   @param capabilities [Array<Deeprails::Models::DefendResponse::Capability>] Extended AI capabilities available to the event, if any. Can be `web_search`, `f
       #
       #   @param created_at [Time] The time the workflow was created in UTC.
       #
@@ -149,6 +149,12 @@ module Deeprails
       end
 
       class Event < Deeprails::Internal::Type::BaseModel
+        # @!attribute billing_request_id
+        #   The ID of the billing request for the event.
+        #
+        #   @return [String, nil]
+        optional :billing_request_id, String
+
         # @!attribute evaluations
         #   An array of evaluations for this event.
         #
@@ -169,21 +175,46 @@ module Deeprails
         optional :improved_model_output, String
 
         # @!attribute improvement_tool_status
-        #   Status of the improvement tool used to improve the event.
+        #   Status of the improvement tool used to improve the event. `improvement_required`
+        #   indicates that the evaluation is complete and the improvement action is needed
+        #   but is not taking place. `improved` and `improvement_failed` indicate when the
+        #   improvement action concludes, successfully and unsuccessfully, respectively.
+        #   `no_improvement_required` means that the first evaluation passed all its
+        #   metrics!
         #
-        #   @return [String, nil]
-        optional :improvement_tool_status, String
+        #   @return [Symbol, Deeprails::Models::DefendResponse::Event::ImprovementToolStatus, nil]
+        optional :improvement_tool_status, enum: -> { Deeprails::DefendResponse::Event::ImprovementToolStatus }
+
+        # @!attribute status
+        #   Status of the event.
+        #
+        #   @return [Symbol, Deeprails::Models::DefendResponse::Event::Status, nil]
+        optional :status, enum: -> { Deeprails::DefendResponse::Event::Status }
 
-        # @!method initialize(evaluations: nil, event_id: nil, improved_model_output: nil, improvement_tool_status: nil)
+        # @!method initialize(billing_request_id: nil, evaluations: nil, event_id: nil, improved_model_output: nil, improvement_tool_status: nil, status: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Deeprails::Models::DefendResponse::Event} for more details.
+        #
+        #   @param billing_request_id [String] The ID of the billing request for the event.
+        #
         #   @param evaluations [Array<Deeprails::Models::DefendResponse::Event::Evaluation>] An array of evaluations for this event.
         #
         #   @param event_id [String] A unique workflow event ID.
         #
         #   @param improved_model_output [String] Improved model output after improvement tool was applied.
         #
-        #   @param improvement_tool_status [String] Status of the improvement tool used to improve the event.
+        #   @param improvement_tool_status [Symbol, Deeprails::Models::DefendResponse::Event::ImprovementToolStatus] Status of the improvement tool used to improve the event. `improvement_required`
+        #
+        #   @param status [Symbol, Deeprails::Models::DefendResponse::Event::Status] Status of the event.
 
         class Evaluation < Deeprails::Internal::Type::BaseModel
+          # @!attribute analysis_of_failures
+          #   Analysis of the failures of the model_output according to the guardrail metrics
+          #   evaluated.
+          #
+          #   @return [String, nil]
+          optional :analysis_of_failures, String
+
           # @!attribute attempt
           #   The attempt number or identifier for this evaluation.
           #
@@ -226,6 +257,24 @@ module Deeprails
           #   @return [Array<String>, nil]
           optional :guardrail_metrics, Deeprails::Internal::Type::ArrayOf[String]
 
+          # @!attribute improvement_tool_status
+          #   Status of the improvement tool used to improve the event. `improvement_required`
+          #   indicates that the evaluation is complete and the improvement action is needed
+          #   but is not taking place. `improved` and `improvement_failed` indicate when the
+          #   improvement action concludes, successfully and unsuccessfully, respectively.
+          #   `no_improvement_required` means that the first evaluation passed all its
+          #   metrics!
+          #
+          #   @return [Symbol, Deeprails::Models::DefendResponse::Event::Evaluation::ImprovementToolStatus, nil]
+          optional :improvement_tool_status,
+                   enum: -> { Deeprails::DefendResponse::Event::Evaluation::ImprovementToolStatus }
+
+          # @!attribute key_improvements
+          #   A list of key improvements made to the model_output to address the failures.
+          #
+          #   @return [Array<String>, nil]
+          optional :key_improvements, Deeprails::Internal::Type::ArrayOf[String]
+
           # @!attribute model_input
           #   The model input used for the evaluation.
           #
@@ -262,7 +311,12 @@ module Deeprails
           #   @return [String, nil]
           optional :run_mode, String
 
-          # @!method initialize(attempt: nil, created_at: nil, error_message: nil, evaluation_result: nil, evaluation_status: nil, evaluation_total_cost: nil, guardrail_metrics: nil, model_input: nil, model_output: nil, modified_at: nil, nametag: nil, progress: nil, run_mode: nil)
+          # @!method initialize(analysis_of_failures: nil, attempt: nil, created_at: nil, error_message: nil, evaluation_result: nil, evaluation_status: nil, evaluation_total_cost: nil, guardrail_metrics: nil, improvement_tool_status: nil, key_improvements: nil, model_input: nil, model_output: nil, modified_at: nil, nametag: nil, progress: nil, run_mode: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Deeprails::Models::DefendResponse::Event::Evaluation} for more details.
+          #
+          #   @param analysis_of_failures [String] Analysis of the failures of the model_output according to the guardrail metrics
+          #
           #   @param attempt [String] The attempt number or identifier for this evaluation.
           #
           #   @param created_at [Time] The time the evaluation was created in UTC.
@@ -277,6 +331,10 @@ module Deeprails
           #
           #   @param guardrail_metrics [Array<String>] An array of guardrail metrics evaluated.
           #
+          #   @param improvement_tool_status [Symbol, Deeprails::Models::DefendResponse::Event::Evaluation::ImprovementToolStatus] Status of the improvement tool used to improve the event. `improvement_required`
+          #
+          #   @param key_improvements [Array<String>] A list of key improvements made to the model_output to address the failures.
+          #
           #   @param model_input [Hash{Symbol=>Object}] The model input used for the evaluation.
           #
           #   @param model_output [String] The model output that was evaluated.
@@ -288,6 +346,60 @@ module Deeprails
           #   @param progress [Integer] Evaluation progress (0-100).
           #
           #   @param run_mode [String] Run mode used for the evaluation.
+
+          # Status of the improvement tool used to improve the event. `improvement_required`
+          # indicates that the evaluation is complete and the improvement action is needed
+          # but is not taking place. `improved` and `improvement_failed` indicate when the
+          # improvement action concludes, successfully and unsuccessfully, respectively.
+          # `no_improvement_required` means that the first evaluation passed all its
+          # metrics!
+          #
+          # @see Deeprails::Models::DefendResponse::Event::Evaluation#improvement_tool_status
+          module ImprovementToolStatus
+            extend Deeprails::Internal::Type::Enum
+
+            IMPROVED = :improved
+            IMPROVEMENT_FAILED = :improvement_failed
+            NO_IMPROVEMENT_REQUIRED = :no_improvement_required
+            IMPROVEMENT_REQUIRED = :improvement_required
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Status of the improvement tool used to improve the event. `improvement_required`
+        # indicates that the evaluation is complete and the improvement action is needed
+        # but is not taking place. `improved` and `improvement_failed` indicate when the
+        # improvement action concludes, successfully and unsuccessfully, respectively.
+        # `no_improvement_required` means that the first evaluation passed all its
+        # metrics!
+        #
+        # @see Deeprails::Models::DefendResponse::Event#improvement_tool_status
+        module ImprovementToolStatus
+          extend Deeprails::Internal::Type::Enum
+
+          IMPROVED = :improved
+          IMPROVEMENT_FAILED = :improvement_failed
+          NO_IMPROVEMENT_REQUIRED = :no_improvement_required
+          IMPROVEMENT_REQUIRED = :improvement_required
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Status of the event.
+        #
+        # @see Deeprails::Models::DefendResponse::Event#status
+        module Status
+          extend Deeprails::Internal::Type::Enum
+
+          COMPLETED = :completed
+          FAILED = :failed
+          IN_PROGRESS = :in_progress
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
         end
       end
 
@@ -307,10 +419,22 @@ module Deeprails
         #   @return [Integer, nil]
         optional :file_size, Integer
 
-        # @!method initialize(file_id: nil, file_name: nil, file_size: nil)
+        # @!attribute presigned_url
+        #
+        #   @return [String, nil]
+        optional :presigned_url, String
+
+        # @!attribute presigned_url_expires_at
+        #
+        #   @return [Time, nil]
+        optional :presigned_url_expires_at, Time
+
+        # @!method initialize(file_id: nil, file_name: nil, file_size: nil, presigned_url: nil, presigned_url_expires_at: nil)
         #   @param file_id [String]
         #   @param file_name [String]
         #   @param file_size [Integer]
+        #   @param presigned_url [String]
+        #   @param presigned_url_expires_at [Time]
       end
 
       # Status of the selected workflow. May be `inactive` or `active`. Inactive

data/lib/deeprails/models/defend_submit_and_stream_event_params.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Models
+    # @see Deeprails::Resources::Defend#submit_and_stream_event_streaming
+    class DefendSubmitAndStreamEventParams < Deeprails::Internal::Type::BaseModel
+      extend Deeprails::Internal::Type::RequestParameters::Converter
+      include Deeprails::Internal::Type::RequestParameters
+
+      # @!attribute model_input
+      #   The input provided to the model (e.g., prompt, messages).
+      #
+      #   @return [Hash{Symbol=>Object}]
+      required :model_input, Deeprails::Internal::Type::HashOf[Deeprails::Internal::Type::Unknown]
+
+      # @!attribute model_output
+      #   The output generated by the model to be evaluated.
+      #
+      #   @return [String]
+      required :model_output, String
+
+      # @!attribute model_used
+      #   The model that generated the output (e.g., "gpt-4", "claude-3").
+      #
+      #   @return [String]
+      required :model_used, String
+
+      # @!attribute run_mode
+      #   The evaluation run mode. Streaming only supports fast, precision, and
+      #   precision_codex.
+      #
+      #   @return [Symbol, Deeprails::Models::DefendSubmitAndStreamEventParams::RunMode]
+      required :run_mode, enum: -> { Deeprails::DefendSubmitAndStreamEventParams::RunMode }
+
+      # @!attribute stream
+      #   Enable SSE streaming for real-time token feedback. Only supported for
+      #   single-model run modes (fast, precision, precision_codex).
+      #
+      #   @return [Boolean, nil]
+      optional :stream, Deeprails::Internal::Type::Boolean
+
+      # @!attribute nametag
+      #   Optional tag to identify this event.
+      #
+      #   @return [String, nil]
+      optional :nametag, String
+
+      # @!method initialize(model_input:, model_output:, model_used:, run_mode:, stream: nil, nametag: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Deeprails::Models::DefendSubmitAndStreamEventParams} for more details.
+      #
+      #   @param model_input [Hash{Symbol=>Object}] The input provided to the model (e.g., prompt, messages).
+      #
+      #   @param model_output [String] The output generated by the model to be evaluated.
+      #
+      #   @param model_used [String] The model that generated the output (e.g., "gpt-4", "claude-3").
+      #
+      #   @param run_mode [Symbol, Deeprails::Models::DefendSubmitAndStreamEventParams::RunMode] The evaluation run mode. Streaming only supports fast, precision, and
+      #   precision\_
+      #
+      #   @param stream [Boolean] Enable SSE streaming for real-time token feedback. Only supported for single-mod
+      #
+      #   @param nametag [String] Optional tag to identify this event.
+      #
+      #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
+
+      # The evaluation run mode. Streaming only supports fast, precision, and
+      # precision_codex.
+      module RunMode
+        extend Deeprails::Internal::Type::Enum
+
+        FAST = :fast
+        PRECISION = :precision
+        PRECISION_CODEX = :precision_codex
+        PRECISION_MAX = :precision_max
+        PRECISION_MAX_CODEX = :precision_max_codex
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/deeprails/models/defend_submit_and_stream_event_response.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Deeprails
+  module Models
+    DefendSubmitAndStreamEventResponse = String
+  end
+end