deeprails 0.11.0 → 0.12.0

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/deeprails/internal/transport/base_client.rbi

@@ -176,6 +176,11 @@ module Deeprails
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/deeprails/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Deeprails
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/deeprails/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module Deeprails
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: Deeprails::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -276,9 +276,13 @@ module Deeprails
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                Deeprails::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end

data/rbi/deeprails/models/defend_create_response.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Deeprails
+  module Models
+    class DefendCreateResponse < Deeprails::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Deeprails::DefendCreateResponse, Deeprails::Internal::AnyHash)
+        end
+
+      # The time the workflow was created in UTC.
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # Status of the selected workflow. May be `inactive` or `active`. Inactive
+      # workflows will not accept events.
+      sig { returns(Deeprails::DefendCreateResponse::Status::TaggedSymbol) }
+      attr_accessor :status
+
+      # A unique workflow ID.
+      sig { returns(String) }
+      attr_accessor :workflow_id
+
+      sig do
+        params(
+          created_at: Time,
+          status: Deeprails::DefendCreateResponse::Status::OrSymbol,
+          workflow_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The time the workflow was created in UTC.
+        created_at:,
+        # Status of the selected workflow. May be `inactive` or `active`. Inactive
+        # workflows will not accept events.
+        status:,
+        # A unique workflow ID.
+        workflow_id:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            created_at: Time,
+            status: Deeprails::DefendCreateResponse::Status::TaggedSymbol,
+            workflow_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Status of the selected workflow. May be `inactive` or `active`. Inactive
+      # workflows will not accept events.
+      module Status
+        extend Deeprails::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Deeprails::DefendCreateResponse::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        INACTIVE =
+          T.let(
+            :inactive,
+            Deeprails::DefendCreateResponse::Status::TaggedSymbol
+          )
+        ACTIVE =
+          T.let(:active, Deeprails::DefendCreateResponse::Status::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Deeprails::DefendCreateResponse::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/deeprails/models/defend_create_workflow_params.rbi

@@ -14,11 +14,11 @@ module Deeprails
           )
         end
 
-      # The action used to improve outputs that fail one or guardrail metrics for the
-      # workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the user's
-      # input prompt with minor induced variance. FixIt attempts to directly address the
-      # shortcomings of the output using the guardrail failure rationale. Do Nothing
-      # does not attempt any improvement.
+      # The action used to improve outputs that fail one or more guardrail metrics for
+      # the workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the
+      # user's input prompt with minor induced variance. FixIt attempts to directly
+      # address the shortcomings of the output using the guardrail failure rationale. Do
+      # Nothing does not attempt any improvement.
       sig do
         returns(
           Deeprails::DefendCreateWorkflowParams::ImprovementAction::OrSymbol
@@ -35,8 +35,10 @@ module Deeprails
       # qualitative tolerance for the metrics, whereas custom metrics allow the user to
       # set the threshold for each metric as a floating point number between 0.0 and
       # 1.0.
-      sig { returns(Deeprails::DefendCreateWorkflowParams::Type::OrSymbol) }
-      attr_accessor :type
+      sig do
+        returns(Deeprails::DefendCreateWorkflowParams::ThresholdType::OrSymbol)
+      end
+      attr_accessor :threshold_type
 
       # Mapping of guardrail metrics to hallucination tolerance levels (either `low`,
       # `medium`, or `high`). Possible metrics are `completeness`,
@@ -93,7 +95,7 @@ module Deeprails
       sig { params(file_search: T::Array[String]).void }
       attr_writer :file_search
 
-      # Max. number of improvement action retries until a given event passes the
+      # Max. number of improvement action attempts until a given event passes the
       # guardrails. Defaults to 10.
       sig { returns(T.nilable(Integer)) }
       attr_reader :max_improvement_attempts
@@ -113,7 +115,8 @@ module Deeprails
           improvement_action:
             Deeprails::DefendCreateWorkflowParams::ImprovementAction::OrSymbol,
           name: String,
-          type: Deeprails::DefendCreateWorkflowParams::Type::OrSymbol,
+          threshold_type:
+            Deeprails::DefendCreateWorkflowParams::ThresholdType::OrSymbol,
           automatic_hallucination_tolerance_levels:
             T::Hash[
               Symbol,
@@ -128,11 +131,11 @@ module Deeprails
         ).returns(T.attached_class)
       end
       def self.new(
-        # The action used to improve outputs that fail one or guardrail metrics for the
-        # workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the user's
-        # input prompt with minor induced variance. FixIt attempts to directly address the
-        # shortcomings of the output using the guardrail failure rationale. Do Nothing
-        # does not attempt any improvement.
+        # The action used to improve outputs that fail one or more guardrail metrics for
+        # the workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the
+        # user's input prompt with minor induced variance. FixIt attempts to directly
+        # address the shortcomings of the output using the guardrail failure rationale. Do
+        # Nothing does not attempt any improvement.
         improvement_action:,
         # Name of the workflow.
         name:,
@@ -141,7 +144,7 @@ module Deeprails
         # qualitative tolerance for the metrics, whereas custom metrics allow the user to
         # set the threshold for each metric as a floating point number between 0.0 and
         # 1.0.
-        type:,
+        threshold_type:,
         # Mapping of guardrail metrics to hallucination tolerance levels (either `low`,
         # `medium`, or `high`). Possible metrics are `completeness`,
         # `instruction_adherence`, `context_adherence`, `ground_truth_adherence`, or
@@ -156,7 +159,7 @@ module Deeprails
         # 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
+        # Max. number of improvement action attempts 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.
@@ -171,7 +174,8 @@ module Deeprails
             improvement_action:
               Deeprails::DefendCreateWorkflowParams::ImprovementAction::OrSymbol,
             name: String,
-            type: Deeprails::DefendCreateWorkflowParams::Type::OrSymbol,
+            threshold_type:
+              Deeprails::DefendCreateWorkflowParams::ThresholdType::OrSymbol,
             automatic_hallucination_tolerance_levels:
               T::Hash[
                 Symbol,
@@ -189,11 +193,11 @@ module Deeprails
       def to_hash
       end
 
-      # The action used to improve outputs that fail one or guardrail metrics for the
-      # workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the user's
-      # input prompt with minor induced variance. FixIt attempts to directly address the
-      # shortcomings of the output using the guardrail failure rationale. Do Nothing
-      # does not attempt any improvement.
+      # The action used to improve outputs that fail one or more guardrail metrics for
+      # the workflow events. May be `regen`, `fixit`, or `do_nothing`. ReGen runs the
+      # user's input prompt with minor induced variance. FixIt attempts to directly
+      # address the shortcomings of the output using the guardrail failure rationale. Do
+      # Nothing does not attempt any improvement.
       module ImprovementAction
         extend Deeprails::Internal::Type::Enum
 
@@ -238,29 +242,31 @@ module Deeprails
       # qualitative tolerance for the metrics, whereas custom metrics allow the user to
       # set the threshold for each metric as a floating point number between 0.0 and
       # 1.0.
-      module Type
+      module ThresholdType
         extend Deeprails::Internal::Type::Enum
 
         TaggedSymbol =
           T.type_alias do
-            T.all(Symbol, Deeprails::DefendCreateWorkflowParams::Type)
+            T.all(Symbol, Deeprails::DefendCreateWorkflowParams::ThresholdType)
           end
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         AUTOMATIC =
           T.let(
             :automatic,
-            Deeprails::DefendCreateWorkflowParams::Type::TaggedSymbol
+            Deeprails::DefendCreateWorkflowParams::ThresholdType::TaggedSymbol
           )
         CUSTOM =
           T.let(
             :custom,
-            Deeprails::DefendCreateWorkflowParams::Type::TaggedSymbol
+            Deeprails::DefendCreateWorkflowParams::ThresholdType::TaggedSymbol
           )
 
         sig do
           override.returns(
-            T::Array[Deeprails::DefendCreateWorkflowParams::Type::TaggedSymbol]
+            T::Array[
+              Deeprails::DefendCreateWorkflowParams::ThresholdType::TaggedSymbol
+            ]
           )
         end
         def self.values