deeprails 0.18.0 → 0.24.0

data/lib/deeprails/models/monitor_retrieve_params.rb

@@ -7,6 +7,11 @@ module Deeprails
       extend Deeprails::Internal::Type::RequestParameters::Converter
       include Deeprails::Internal::Type::RequestParameters
 
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
       # @!attribute limit
       #   Limit the number of returned evaluations associated with this monitor. Defaults
       #   to 10.
@@ -14,10 +19,12 @@ module Deeprails
       #   @return [Integer, nil]
       optional :limit, Integer
 
-      # @!method initialize(limit: nil, request_options: {})
+      # @!method initialize(monitor_id:, limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Deeprails::Models::MonitorRetrieveParams} for more details.
       #
+      #   @param monitor_id [String]
+      #
       #   @param limit [Integer] Limit the number of returned evaluations associated with this monitor. Defaults
       #
       #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]

data/lib/deeprails/models/monitor_submit_event_params.rb

@@ -7,10 +7,15 @@ module Deeprails
       extend Deeprails::Internal::Type::RequestParameters::Converter
       include Deeprails::Internal::Type::RequestParameters
 
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
       # @!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
-      #   ground_truth_adherence guardrail metric, `ground_truth` should be provided.
+      #   contain a `user_prompt` field. For ground_truth_adherence guardrail metric,
+      #   `ground_truth` should be provided.
       #
       #   @return [Deeprails::Models::MonitorSubmitEventParams::ModelInput]
       required :model_input, -> { Deeprails::MonitorSubmitEventParams::ModelInput }
@@ -30,16 +35,21 @@ module Deeprails
       # @!attribute run_mode
       #   Run mode for the monitor event. The run mode allows the user to optimize for
       #   speed, accuracy, and cost by determining which models are used to evaluate the
-      #   event. Available run modes include `precision_plus`, `precision`, `smart`, and
-      #   `economy`. Defaults to `smart`.
+      #   event. Available run modes (fastest to most thorough): `super_fast`, `fast`,
+      #   `precision`, `precision_codex`, `precision_max`, and `precision_max_codex`.
+      #   Defaults to `fast`. Note: `super_fast` does not support Web Search or File
+      #   Search — if your monitor has these capabilities enabled, use a different run
+      #   mode or edit the monitor to disable them.
       #
       #   @return [Symbol, Deeprails::Models::MonitorSubmitEventParams::RunMode, nil]
       optional :run_mode, enum: -> { Deeprails::MonitorSubmitEventParams::RunMode }
 
-      # @!method initialize(model_input:, model_output:, nametag: nil, run_mode: nil, request_options: {})
+      # @!method initialize(monitor_id:, 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 monitor_id [String]
+      #
       #   @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.
@@ -51,6 +61,23 @@ module Deeprails
       #   @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}]
 
       class ModelInput < Deeprails::Internal::Type::BaseModel
+        # @!attribute user_prompt
+        #   The user prompt used to generate the output.
+        #
+        #   @return [String]
+        required :user_prompt, String
+
+        # @!attribute context
+        #   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.
+        #
+        #   @return [Array<Deeprails::Models::MonitorSubmitEventParams::ModelInput::Context>, nil]
+        optional :context,
+                 -> { Deeprails::Internal::Type::ArrayOf[Deeprails::MonitorSubmitEventParams::ModelInput::Context] }
+
         # @!attribute ground_truth
         #   The ground truth for evaluating Ground Truth Adherence guardrail.
         #
@@ -63,35 +90,58 @@ module Deeprails
         #   @return [String, nil]
         optional :system_prompt, String
 
-        # @!attribute user_prompt
-        #   The user prompt used to generate the output.
+        # @!method initialize(user_prompt:, context: nil, ground_truth: nil, system_prompt: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Deeprails::Models::MonitorSubmitEventParams::ModelInput} for more details.
         #
-        #   @return [String, nil]
-        optional :user_prompt, String
-
-        # @!method initialize(ground_truth: nil, system_prompt: nil, user_prompt: nil)
         #   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
-        #   ground_truth_adherence guardrail metric, `ground_truth` should be provided.
+        #   contain a `user_prompt` field. For ground_truth_adherence guardrail metric,
+        #   `ground_truth` should be provided.
+        #
+        #   @param user_prompt [String] The user prompt used to generate the output.
+        #
+        #   @param context [Array<Deeprails::Models::MonitorSubmitEventParams::ModelInput::Context>] Any structured information that directly relates to the model’s input and expect
         #
         #   @param ground_truth [String] The ground truth for evaluating Ground Truth Adherence guardrail.
         #
         #   @param system_prompt [String] The system prompt used to generate the output.
-        #
-        #   @param user_prompt [String] The user prompt used to generate the output.
+
+        class Context < Deeprails::Internal::Type::BaseModel
+          # @!attribute content
+          #   The content of the message.
+          #
+          #   @return [String, nil]
+          optional :content, String
+
+          # @!attribute role
+          #   The role of the speaker.
+          #
+          #   @return [String, nil]
+          optional :role, String
+
+          # @!method initialize(content: nil, role: nil)
+          #   @param content [String] The content of the message.
+          #
+          #   @param role [String] The role of the speaker.
+        end
       end
 
       # Run mode for the monitor event. The run mode allows the user to optimize for
       # speed, accuracy, and cost by determining which models are used to evaluate the
-      # event. Available run modes include `precision_plus`, `precision`, `smart`, and
-      # `economy`. Defaults to `smart`.
+      # event. Available run modes (fastest to most thorough): `super_fast`, `fast`,
+      # `precision`, `precision_codex`, `precision_max`, and `precision_max_codex`.
+      # Defaults to `fast`. Note: `super_fast` does not support Web Search or File
+      # Search — if your monitor has these capabilities enabled, use a different run
+      # mode or edit the monitor to disable them.
       module RunMode
         extend Deeprails::Internal::Type::Enum
 
-        PRECISION_PLUS = :precision_plus
+        SUPER_FAST = :super_fast
+        FAST = :fast
         PRECISION = :precision
-        SMART = :smart
-        ECONOMY = :economy
+        PRECISION_CODEX = :precision_codex
+        PRECISION_MAX = :precision_max
+        PRECISION_MAX_CODEX = :precision_max_codex
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/deeprails/models/monitor_update_params.rb

@@ -7,14 +7,34 @@ module Deeprails
       extend Deeprails::Internal::Type::RequestParameters::Converter
       include Deeprails::Internal::Type::RequestParameters
 
+      # @!attribute monitor_id
+      #
+      #   @return [String]
+      required :monitor_id, String
+
       # @!attribute description
-      #   Description of the monitor.
+      #   New description of the monitor.
       #
       #   @return [String, nil]
       optional :description, String
 
+      # @!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 guardrail_metrics
+      #   An array of the new guardrail metrics that model input and output pairs will be
+      #   evaluated on.
+      #
+      #   @return [Array<Symbol, Deeprails::Models::MonitorUpdateParams::GuardrailMetric>, nil]
+      optional :guardrail_metrics,
+               -> { Deeprails::Internal::Type::ArrayOf[enum: Deeprails::MonitorUpdateParams::GuardrailMetric] }
+
       # @!attribute name
-      #   Name of the monitor.
+      #   New name of the monitor.
       #
       #   @return [String, nil]
       optional :name, String
@@ -26,18 +46,46 @@ module Deeprails
       #   @return [Symbol, Deeprails::Models::MonitorUpdateParams::Status, nil]
       optional :status, enum: -> { Deeprails::MonitorUpdateParams::Status }
 
-      # @!method initialize(description: nil, name: nil, status: nil, request_options: {})
+      # @!attribute web_search
+      #   Whether to enable web search for this monitor's evaluations.
+      #
+      #   @return [Boolean, nil]
+      optional :web_search, Deeprails::Internal::Type::Boolean
+
+      # @!method initialize(monitor_id:, description: nil, file_search: nil, guardrail_metrics: nil, name: nil, status: nil, web_search: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Deeprails::Models::MonitorUpdateParams} for more details.
       #
-      #   @param description [String] Description of the monitor.
+      #   @param monitor_id [String]
+      #
+      #   @param description [String] New description of the monitor.
+      #
+      #   @param file_search [Array<String>] An array of file IDs to search in the monitor's evaluations. Files must be uploa
       #
-      #   @param name [String] Name of the monitor.
+      #   @param guardrail_metrics [Array<Symbol, Deeprails::Models::MonitorUpdateParams::GuardrailMetric>] An array of the new guardrail metrics that model input and output pairs will be
+      #
+      #   @param name [String] New name of the monitor.
       #
       #   @param status [Symbol, Deeprails::Models::MonitorUpdateParams::Status] Status of the monitor. Can be `active` or `inactive`. Inactive monitors no lon
       #
+      #   @param web_search [Boolean] Whether to enable web search for this monitor's evaluations.
+      #
       #   @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
+
       # Status of the monitor. Can be `active` or `inactive`. Inactive monitors no
       # longer record and evaluate events.
       module Status

data/lib/deeprails/models/workflow_event_detail_response.rb

@@ -4,6 +4,11 @@ module Deeprails
   module Models
     # @see Deeprails::Resources::Defend#retrieve_event
     class WorkflowEventDetailResponse < Deeprails::Internal::Type::BaseModel
+      # @!attribute analysis_of_failures
+      #
+      #   @return [Array<String>]
+      required :analysis_of_failures, Deeprails::Internal::Type::ArrayOf[String]
+
       # @!attribute evaluation_history
       #   History of evaluations for the event.
       #
@@ -44,13 +49,24 @@ module Deeprails
       required :improvement_action, enum: -> { Deeprails::WorkflowEventDetailResponse::ImprovementAction }
 
       # @!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 [Symbol, Deeprails::Models::WorkflowEventDetailResponse::ImprovementToolStatus, nil]
       required :improvement_tool_status,
                enum: -> { Deeprails::WorkflowEventDetailResponse::ImprovementToolStatus },
                nil?: true
 
+      # @!attribute key_improvements
+      #
+      #   @return [Array<Deeprails::Models::WorkflowEventDetailResponse::KeyImprovement>]
+      required :key_improvements,
+               -> { Deeprails::Internal::Type::ArrayOf[Deeprails::WorkflowEventDetailResponse::KeyImprovement] }
+
       # @!attribute status
       #   Status of the event.
       #
@@ -78,8 +94,8 @@ module Deeprails
                -> { Deeprails::Internal::Type::HashOf[enum: Deeprails::WorkflowEventDetailResponse::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::WorkflowEventDetailResponse::Capability>, nil]
       optional :capabilities,
@@ -99,10 +115,19 @@ module Deeprails
       #   @return [Array<Deeprails::Models::WorkflowEventDetailResponse::File>, nil]
       optional :files, -> { Deeprails::Internal::Type::ArrayOf[Deeprails::WorkflowEventDetailResponse::File] }
 
-      # @!method initialize(evaluation_history:, evaluation_result:, event_id:, filtered:, improved_model_output:, improvement_action:, improvement_tool_status:, status:, threshold_type:, workflow_id:, automatic_hallucination_tolerance_levels: nil, capabilities: nil, custom_hallucination_threshold_values: nil, files: nil)
+      # @!attribute max_improvement_attempts
+      #   The maximum number of improvement attempts to be applied to one event before it
+      #   is considered failed.
+      #
+      #   @return [Integer, nil]
+      optional :max_improvement_attempts, Integer
+
+      # @!method initialize(analysis_of_failures:, evaluation_history:, evaluation_result:, event_id:, filtered:, improved_model_output:, improvement_action:, improvement_tool_status:, key_improvements:, status:, threshold_type:, workflow_id:, automatic_hallucination_tolerance_levels: nil, capabilities: nil, custom_hallucination_threshold_values: nil, files: nil, max_improvement_attempts: nil)
       #   Some parameter documentations has been truncated, see
       #   {Deeprails::Models::WorkflowEventDetailResponse} for more details.
       #
+      #   @param analysis_of_failures [Array<String>]
+      #
       #   @param evaluation_history [Array<Deeprails::Models::WorkflowEventDetailResponse::EvaluationHistory>] History of evaluations for the event.
       #
       #   @param evaluation_result [Hash{Symbol=>Object}] Evaluation result consisting of average scores and rationales for each of the ev
@@ -115,7 +140,9 @@ module Deeprails
       #
       #   @param improvement_action [Symbol, Deeprails::Models::WorkflowEventDetailResponse::ImprovementAction] Type of improvement action used to improve the event.
       #
-      #   @param improvement_tool_status [Symbol, Deeprails::Models::WorkflowEventDetailResponse::ImprovementToolStatus, nil] Status of the improvement tool used to improve the event.
+      #   @param improvement_tool_status [Symbol, Deeprails::Models::WorkflowEventDetailResponse::ImprovementToolStatus, nil] Status of the improvement tool used to improve the event. `improvement_required`
+      #
+      #   @param key_improvements [Array<Deeprails::Models::WorkflowEventDetailResponse::KeyImprovement>]
       #
       #   @param status [Symbol, Deeprails::Models::WorkflowEventDetailResponse::Status] Status of the event.
       #
@@ -125,13 +152,20 @@ module Deeprails
       #
       #   @param automatic_hallucination_tolerance_levels [Hash{Symbol=>Symbol, Deeprails::Models::WorkflowEventDetailResponse::AutomaticHallucinationToleranceLevel}] Mapping of guardrail metric names to tolerance values. Values are strings (`low`
       #
-      #   @param capabilities [Array<Deeprails::Models::WorkflowEventDetailResponse::Capability>] Extended AI capabilities available to the event, if any. Can be `web_search` and
+      #   @param capabilities [Array<Deeprails::Models::WorkflowEventDetailResponse::Capability>] Extended AI capabilities available to the event, if any. Can be `web_search`, `f
       #
       #   @param custom_hallucination_threshold_values [Hash{Symbol=>Float}] Mapping of guardrail metric names to threshold values. Values are floating point
       #
       #   @param files [Array<Deeprails::Models::WorkflowEventDetailResponse::File>] List of files available to the event, if any. Will only be present if `file_sear
+      #
+      #   @param max_improvement_attempts [Integer] The maximum number of improvement attempts to be applied to one event before it
 
       class EvaluationHistory < Deeprails::Internal::Type::BaseModel
+        # @!attribute analysis_of_failures
+        #
+        #   @return [String, nil]
+        optional :analysis_of_failures, String
+
         # @!attribute attempt
         #
         #   @return [String, nil]
@@ -167,6 +201,17 @@ module Deeprails
         #   @return [Array<String>, nil]
         optional :guardrail_metrics, Deeprails::Internal::Type::ArrayOf[String]
 
+        # @!attribute improvement_tool_status
+        #
+        #   @return [Symbol, Deeprails::Models::WorkflowEventDetailResponse::EvaluationHistory::ImprovementToolStatus, nil]
+        optional :improvement_tool_status,
+                 enum: -> { Deeprails::WorkflowEventDetailResponse::EvaluationHistory::ImprovementToolStatus }
+
+        # @!attribute key_improvements
+        #
+        #   @return [Array<String>, nil]
+        optional :key_improvements, Deeprails::Internal::Type::ArrayOf[String]
+
         # @!attribute model_input
         #
         #   @return [Hash{Symbol=>Object}, nil]
@@ -177,11 +222,6 @@ module Deeprails
         #   @return [String, nil]
         optional :model_output, String
 
-        # @!attribute modified_at
-        #
-        #   @return [Time, nil]
-        optional :modified_at, Time
-
         # @!attribute nametag
         #
         #   @return [String, nil]
@@ -197,7 +237,8 @@ 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, nametag: nil, progress: nil, run_mode: nil)
+        #   @param analysis_of_failures [String]
         #   @param attempt [String]
         #   @param created_at [Time]
         #   @param error_message [String]
@@ -205,12 +246,26 @@ module Deeprails
         #   @param evaluation_status [String]
         #   @param evaluation_total_cost [Float]
         #   @param guardrail_metrics [Array<String>]
+        #   @param improvement_tool_status [Symbol, Deeprails::Models::WorkflowEventDetailResponse::EvaluationHistory::ImprovementToolStatus]
+        #   @param key_improvements [Array<String>]
         #   @param model_input [Hash{Symbol=>Object}]
         #   @param model_output [String]
-        #   @param modified_at [Time]
         #   @param nametag [String]
         #   @param progress [Integer]
         #   @param run_mode [String]
+
+        # @see Deeprails::Models::WorkflowEventDetailResponse::EvaluationHistory#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
 
       # Type of improvement action used to improve the event.
@@ -227,20 +282,36 @@ module Deeprails
         #   @return [Array<Symbol>]
       end
 
-      # 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!
       #
       # @see Deeprails::Models::WorkflowEventDetailResponse#improvement_tool_status
       module ImprovementToolStatus
         extend Deeprails::Internal::Type::Enum
 
         IMPROVED = :improved
-        FAILED_ON_MAX_RETRIES = :"failed on max retries"
+        IMPROVEMENT_FAILED = :improvement_failed
+        NO_IMPROVEMENT_REQUIRED = :no_improvement_required
         IMPROVEMENT_REQUIRED = :improvement_required
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
+      class KeyImprovement < Deeprails::Internal::Type::BaseModel
+        # @!attribute key_improvement
+        #
+        #   @return [Array<String>, nil]
+        optional :key_improvement, Deeprails::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(key_improvement: nil)
+        #   @param key_improvement [Array<String>]
+      end
+
       # Status of the event.
       #
       # @see Deeprails::Models::WorkflowEventDetailResponse#status
@@ -304,10 +375,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
     end
   end

data/lib/deeprails/models/workflow_event_response.rb

@@ -4,6 +4,12 @@ module Deeprails
   module Models
     # @see Deeprails::Resources::Defend#submit_event
     class WorkflowEventResponse < Deeprails::Internal::Type::BaseModel
+      # @!attribute billing_request_id
+      #   The ID of the billing request for the event.
+      #
+      #   @return [String]
+      required :billing_request_id, String
+
       # @!attribute created_at
       #   The time the event was created in UTC.
       #
@@ -28,7 +34,9 @@ module Deeprails
       #   @return [String]
       required :workflow_id, String
 
-      # @!method initialize(created_at:, event_id:, status:, workflow_id:)
+      # @!method initialize(billing_request_id:, created_at:, event_id:, status:, workflow_id:)
+      #   @param billing_request_id [String] The ID of the billing request for the event.
+      #
       #   @param created_at [Time] The time the event was created in UTC.
       #
       #   @param event_id [String] A unique workflow event ID.

data/lib/deeprails/models.rb

@@ -49,6 +49,8 @@ module Deeprails
 
   DefendRetrieveWorkflowParams = Deeprails::Models::DefendRetrieveWorkflowParams
 
+  DefendSubmitAndStreamEventParams = Deeprails::Models::DefendSubmitAndStreamEventParams
+
   DefendSubmitEventParams = Deeprails::Models::DefendSubmitEventParams
 
   DefendUpdateResponse = Deeprails::Models::DefendUpdateResponse

data/lib/deeprails/resources/defend.rb

@@ -9,7 +9,7 @@ module Deeprails
       # Use this endpoint to create a new guardrail workflow by specifying guardrail
       # thresholds, an improvement action, and optional extended capabilities.
       #
-      # @overload create_workflow(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: {})
+      # @overload create_workflow(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: {})
       #
       # @param improvement_action [Symbol, Deeprails::Models::DefendCreateWorkflowParams::ImprovementAction] The action used to improve outputs that fail one or more guardrail metrics for t
       #
@@ -19,6 +19,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.
@@ -90,15 +92,59 @@ module Deeprails
       # @see Deeprails::Models::DefendRetrieveWorkflowParams
       def retrieve_workflow(workflow_id, params = {})
         parsed, options = Deeprails::DefendRetrieveWorkflowParams.dump_request(params)
+        query = Deeprails::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["defend/%1$s", workflow_id],
-          query: parsed,
+          query: query,
           model: Deeprails::DefendResponse,
           options: options
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Deeprails::Models::DefendSubmitAndStreamEventParams} for more details.
+      #
+      # Use this endpoint to submit a model input and output pair to a workflow for
+      # evaluation with streaming responses.
+      #
+      # @overload submit_and_stream_event_streaming(workflow_id, model_input:, model_output:, model_used:, run_mode:, stream: nil, nametag: nil, request_options: {})
+      #
+      # @param workflow_id [String] Path param: The ID of the workflow to create the event for.
+      #
+      # @param model_input [Hash{Symbol=>Object}] Body param: The input provided to the model (e.g., prompt, messages).
+      #
+      # @param model_output [String] Body param: The output generated by the model to be evaluated.
+      #
+      # @param model_used [String] Body param: The model that generated the output (e.g., "gpt-4", "claude-3").
+      #
+      # @param run_mode [Symbol, Deeprails::Models::DefendSubmitAndStreamEventParams::RunMode] Body param: The evaluation run mode. Streaming is supported on all run modes exc
+      #
+      # @param stream [Boolean] Query param: Enable SSE streaming for real-time token feedback. Supported on all
+      #
+      # @param nametag [String] Body param: Optional tag to identify this event.
+      #
+      # @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Deeprails::Internal::Stream<String>]
+      #
+      # @see Deeprails::Models::DefendSubmitAndStreamEventParams
+      def submit_and_stream_event_streaming(workflow_id, params)
+        query_params = [:stream]
+        parsed, options = Deeprails::DefendSubmitAndStreamEventParams.dump_request(params)
+        query = Deeprails::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :post,
+          path: ["defend/%1$s/events?stream=true", workflow_id],
+          query: query,
+          headers: {"accept" => "text/event-stream"},
+          body: parsed.except(*query_params),
+          stream: Deeprails::Internal::Stream,
+          model: String,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Deeprails::Models::DefendSubmitEventParams} for more details.
       #
@@ -135,15 +181,34 @@ module Deeprails
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Deeprails::Models::DefendUpdateWorkflowParams} for more details.
+      #
       # Use this endpoint to update an existing defend workflow if its details change.
       #
-      # @overload update_workflow(workflow_id, description: nil, name: nil, request_options: {})
+      # @overload update_workflow(workflow_id, automatic_hallucination_tolerance_levels: nil, context_awareness: nil, custom_hallucination_threshold_values: nil, description: nil, file_search: nil, improvement_action: nil, max_improvement_attempts: nil, name: nil, threshold_type: nil, web_search: nil, request_options: {})
       #
       # @param workflow_id [String] The ID of the workflow to edit.
       #
-      # @param description [String] Description for the workflow.
+      # @param automatic_hallucination_tolerance_levels [Hash{Symbol=>Symbol, Deeprails::Models::DefendUpdateWorkflowParams::AutomaticHallucinationToleranceLevel}] New mapping of guardrail metrics to hallucination tolerance levels
       #
-      # @param name [String] Name of the workflow.
+      # @param context_awareness [Boolean] Whether to enable context awareness for this workflow's evaluations.
+      #
+      # @param custom_hallucination_threshold_values [Hash{Symbol=>Float}] New mapping of guardrail metrics to floating point threshold values to be used w
+      #
+      # @param description [String] New 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 improvement_action [Symbol, Deeprails::Models::DefendUpdateWorkflowParams::ImprovementAction] The new action used to improve outputs that fail one or more guardrail metrics f
+      #
+      # @param max_improvement_attempts [Integer] Max. number of improvement action attempts until a given event passes the guardr
+      #
+      # @param name [String] New name for the workflow.
+      #
+      # @param threshold_type [Symbol, Deeprails::Models::DefendUpdateWorkflowParams::ThresholdType] New type of thresholds to use for the workflow, either `automatic` or `custom`.
+      #
+      # @param web_search [Boolean] Whether to enable web search for this workflow's evaluations.
       #
       # @param request_options [Deeprails::RequestOptions, Hash{Symbol=>Object}, nil]
       #