safetykit 0.59.0 → 0.61.0

data/rbi/safety_kit/models/async_create_async_params.rbi

@@ -6177,10 +6177,6 @@ module SafetyKit
           sig { returns(String) }
           attr_accessor :event_name
 
-          # One or more label categories supplied with the report or moderation decision.
-          sig { returns(T::Array[String]) }
-          attr_accessor :labels
-
           # Stable identifier within source_type. Examples: moderator@example.com or
           # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
           # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -6275,6 +6271,14 @@ module SafetyKit
           sig { params(idempotency_key: String).void }
           attr_writer :idempotency_key
 
+          # Label categories the decision determined apply to the target. At least one of
+          # labels or negative_labels is required.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :labels
+
+          sig { params(labels: T::Array[String]).void }
+          attr_writer :labels
+
           # Non-PII product context for filtering, segmentation, and debugging. Values may
           # be strings, numbers, booleans, or arrays of those scalar values.
           sig do
@@ -6300,6 +6304,15 @@ module SafetyKit
           end
           attr_writer :metadata
 
+          # Label categories the decision explicitly reviewed and determined do NOT apply to
+          # the target, such as a manual review that clears a user reported for spam. A
+          # label cannot appear in both labels and negative_labels.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :negative_labels
+
+          sig { params(negative_labels: T::Array[String]).void }
+          attr_writer :negative_labels
+
           # Reusable resources observed during the event. Use this for emails, phone
           # numbers, names, addresses, social handles, URLs, payment identifiers,
           # caller-defined ids, or similar identifiers.
@@ -6346,11 +6359,12 @@ module SafetyKit
 
           # A moderation label or decision from an automated enforcement system or manual
           # review workflow. Do not send user_id; use source_type and source_id for
-          # attribution.
+          # attribution. Use labels for categories the decision applied and negative_labels
+          # for categories the decision explicitly reviewed and determined do not apply; at
+          # least one of the two is required.
           sig do
             params(
               event_name: String,
-              labels: T::Array[String],
               source_id: String,
               source_type:
                 SafetyKit::AsyncCreateAsyncParams::Body::ModerationDecisionEventRequest::SourceType::OrSymbol,
@@ -6368,11 +6382,13 @@ module SafetyKit
                 ],
               content_id: String,
               idempotency_key: String,
+              labels: T::Array[String],
               metadata:
                 T::Hash[
                   Symbol,
                   SafetyKit::AsyncCreateAsyncParams::Body::ModerationDecisionEventRequest::Metadata::Variants
                 ],
+              negative_labels: T::Array[String],
               resources_used:
                 T::Array[
                   T.any(
@@ -6388,8 +6404,6 @@ module SafetyKit
             # Stable, low-cardinality product action name. Use snake_case and put dynamic
             # values in typed fields, content, resources_used, or metadata.
             event_name:,
-            # One or more label categories supplied with the report or moderation decision.
-            labels:,
             # Stable identifier within source_type. Examples: moderator@example.com or
             # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
             # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -6416,9 +6430,16 @@ module SafetyKit
             # Optional caller-provided key used to make retries of this individual event
             # idempotent. Reuse the same key only for retries of the same logical event.
             idempotency_key: nil,
+            # Label categories the decision determined apply to the target. At least one of
+            # labels or negative_labels is required.
+            labels: nil,
             # Non-PII product context for filtering, segmentation, and debugging. Values may
             # be strings, numbers, booleans, or arrays of those scalar values.
             metadata: nil,
+            # Label categories the decision explicitly reviewed and determined do NOT apply to
+            # the target, such as a manual review that clears a user reported for spam. A
+            # label cannot appear in both labels and negative_labels.
+            negative_labels: nil,
             # Reusable resources observed during the event. Use this for emails, phone
             # numbers, names, addresses, social handles, URLs, payment identifiers,
             # caller-defined ids, or similar identifiers.
@@ -6434,7 +6455,6 @@ module SafetyKit
             override.returns(
               {
                 event_name: String,
-                labels: T::Array[String],
                 source_id: String,
                 source_type:
                   SafetyKit::AsyncCreateAsyncParams::Body::ModerationDecisionEventRequest::SourceType::OrSymbol,
@@ -6452,11 +6472,13 @@ module SafetyKit
                   ],
                 content_id: String,
                 idempotency_key: String,
+                labels: T::Array[String],
                 metadata:
                   T::Hash[
                     Symbol,
                     SafetyKit::AsyncCreateAsyncParams::Body::ModerationDecisionEventRequest::Metadata::Variants
                   ],
+                negative_labels: T::Array[String],
                 resources_used:
                   T::Array[
                     T.any(
@@ -12904,10 +12926,6 @@ module SafetyKit
             sig { returns(String) }
             attr_accessor :event_name
 
-            # One or more label categories supplied with the report or moderation decision.
-            sig { returns(T::Array[String]) }
-            attr_accessor :labels
-
             # Stable identifier within source_type. Examples: moderator@example.com or
             # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
             # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -12998,6 +13016,14 @@ module SafetyKit
             sig { params(idempotency_key: String).void }
             attr_writer :idempotency_key
 
+            # Label categories the decision determined apply to the target. At least one of
+            # labels or negative_labels is required.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :labels
+
+            sig { params(labels: T::Array[String]).void }
+            attr_writer :labels
+
             # Non-PII product context for filtering, segmentation, and debugging. Values may
             # be strings, numbers, booleans, or arrays of those scalar values.
             sig do
@@ -13023,6 +13049,15 @@ module SafetyKit
             end
             attr_writer :metadata
 
+            # Label categories the decision explicitly reviewed and determined do NOT apply to
+            # the target, such as a manual review that clears a user reported for spam. A
+            # label cannot appear in both labels and negative_labels.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :negative_labels
+
+            sig { params(negative_labels: T::Array[String]).void }
+            attr_writer :negative_labels
+
             # Reusable resources observed during the event. Use this for emails, phone
             # numbers, names, addresses, social handles, URLs, payment identifiers,
             # caller-defined ids, or similar identifiers.
@@ -13069,11 +13104,12 @@ module SafetyKit
 
             # A moderation label or decision from an automated enforcement system or manual
             # review workflow. Do not send user_id; use source_type and source_id for
-            # attribution.
+            # attribution. Use labels for categories the decision applied and negative_labels
+            # for categories the decision explicitly reviewed and determined do not apply; at
+            # least one of the two is required.
             sig do
               params(
                 event_name: String,
-                labels: T::Array[String],
                 source_id: String,
                 source_type:
                   SafetyKit::AsyncCreateAsyncParams::Body::UnionMember8::ModerationDecision::SourceType::OrSymbol,
@@ -13089,11 +13125,13 @@ module SafetyKit
                   ],
                 content_id: String,
                 idempotency_key: String,
+                labels: T::Array[String],
                 metadata:
                   T::Hash[
                     Symbol,
                     SafetyKit::AsyncCreateAsyncParams::Body::UnionMember8::ModerationDecision::Metadata::Variants
                   ],
+                negative_labels: T::Array[String],
                 resources_used:
                   T::Array[
                     T.any(
@@ -13110,8 +13148,6 @@ module SafetyKit
               # Stable, low-cardinality product action name. Use snake_case and put dynamic
               # values in typed fields, content, resources_used, or metadata.
               event_name:,
-              # One or more label categories supplied with the report or moderation decision.
-              labels:,
               # Stable identifier within source_type. Examples: moderator@example.com or
               # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
               # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -13137,9 +13173,16 @@ module SafetyKit
               # Optional caller-provided key used to make retries of this individual event
               # idempotent. Reuse the same key only for retries of the same logical event.
               idempotency_key: nil,
+              # Label categories the decision determined apply to the target. At least one of
+              # labels or negative_labels is required.
+              labels: nil,
               # Non-PII product context for filtering, segmentation, and debugging. Values may
               # be strings, numbers, booleans, or arrays of those scalar values.
               metadata: nil,
+              # Label categories the decision explicitly reviewed and determined do NOT apply to
+              # the target, such as a manual review that clears a user reported for spam. A
+              # label cannot appear in both labels and negative_labels.
+              negative_labels: nil,
               # Reusable resources observed during the event. Use this for emails, phone
               # numbers, names, addresses, social handles, URLs, payment identifiers,
               # caller-defined ids, or similar identifiers.
@@ -13156,7 +13199,6 @@ module SafetyKit
               override.returns(
                 {
                   event_name: String,
-                  labels: T::Array[String],
                   source_id: String,
                   source_type:
                     SafetyKit::AsyncCreateAsyncParams::Body::UnionMember8::ModerationDecision::SourceType::OrSymbol,
@@ -13173,11 +13215,13 @@ module SafetyKit
                     ],
                   content_id: String,
                   idempotency_key: String,
+                  labels: T::Array[String],
                   metadata:
                     T::Hash[
                       Symbol,
                       SafetyKit::AsyncCreateAsyncParams::Body::UnionMember8::ModerationDecision::Metadata::Variants
                     ],
+                  negative_labels: T::Array[String],
                   resources_used:
                     T::Array[
                       T.any(

data/rbi/safety_kit/models/beta/event_create_params.rbi

@@ -6182,10 +6182,6 @@ module SafetyKit
             sig { returns(String) }
             attr_accessor :event_name
 
-            # One or more label categories supplied with the report or moderation decision.
-            sig { returns(T::Array[String]) }
-            attr_accessor :labels
-
             # Stable identifier within source_type. Examples: moderator@example.com or
             # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
             # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -6280,6 +6276,14 @@ module SafetyKit
             sig { params(idempotency_key: String).void }
             attr_writer :idempotency_key
 
+            # Label categories the decision determined apply to the target. At least one of
+            # labels or negative_labels is required.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :labels
+
+            sig { params(labels: T::Array[String]).void }
+            attr_writer :labels
+
             # Non-PII product context for filtering, segmentation, and debugging. Values may
             # be strings, numbers, booleans, or arrays of those scalar values.
             sig do
@@ -6305,6 +6309,15 @@ module SafetyKit
             end
             attr_writer :metadata
 
+            # Label categories the decision explicitly reviewed and determined do NOT apply to
+            # the target, such as a manual review that clears a user reported for spam. A
+            # label cannot appear in both labels and negative_labels.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :negative_labels
+
+            sig { params(negative_labels: T::Array[String]).void }
+            attr_writer :negative_labels
+
             # Reusable resources observed during the event. Use this for emails, phone
             # numbers, names, addresses, social handles, URLs, payment identifiers,
             # caller-defined ids, or similar identifiers.
@@ -6351,11 +6364,12 @@ module SafetyKit
 
             # A moderation label or decision from an automated enforcement system or manual
             # review workflow. Do not send user_id; use source_type and source_id for
-            # attribution.
+            # attribution. Use labels for categories the decision applied and negative_labels
+            # for categories the decision explicitly reviewed and determined do not apply; at
+            # least one of the two is required.
             sig do
               params(
                 event_name: String,
-                labels: T::Array[String],
                 source_id: String,
                 source_type:
                   SafetyKit::Beta::EventCreateParams::Body::ModerationDecisionEventRequest::SourceType::OrSymbol,
@@ -6373,11 +6387,13 @@ module SafetyKit
                   ],
                 content_id: String,
                 idempotency_key: String,
+                labels: T::Array[String],
                 metadata:
                   T::Hash[
                     Symbol,
                     SafetyKit::Beta::EventCreateParams::Body::ModerationDecisionEventRequest::Metadata::Variants
                   ],
+                negative_labels: T::Array[String],
                 resources_used:
                   T::Array[
                     T.any(
@@ -6393,8 +6409,6 @@ module SafetyKit
               # Stable, low-cardinality product action name. Use snake_case and put dynamic
               # values in typed fields, content, resources_used, or metadata.
               event_name:,
-              # One or more label categories supplied with the report or moderation decision.
-              labels:,
               # Stable identifier within source_type. Examples: moderator@example.com or
               # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
               # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -6421,9 +6435,16 @@ module SafetyKit
               # Optional caller-provided key used to make retries of this individual event
               # idempotent. Reuse the same key only for retries of the same logical event.
               idempotency_key: nil,
+              # Label categories the decision determined apply to the target. At least one of
+              # labels or negative_labels is required.
+              labels: nil,
               # Non-PII product context for filtering, segmentation, and debugging. Values may
               # be strings, numbers, booleans, or arrays of those scalar values.
               metadata: nil,
+              # Label categories the decision explicitly reviewed and determined do NOT apply to
+              # the target, such as a manual review that clears a user reported for spam. A
+              # label cannot appear in both labels and negative_labels.
+              negative_labels: nil,
               # Reusable resources observed during the event. Use this for emails, phone
               # numbers, names, addresses, social handles, URLs, payment identifiers,
               # caller-defined ids, or similar identifiers.
@@ -6439,7 +6460,6 @@ module SafetyKit
               override.returns(
                 {
                   event_name: String,
-                  labels: T::Array[String],
                   source_id: String,
                   source_type:
                     SafetyKit::Beta::EventCreateParams::Body::ModerationDecisionEventRequest::SourceType::OrSymbol,
@@ -6457,11 +6477,13 @@ module SafetyKit
                     ],
                   content_id: String,
                   idempotency_key: String,
+                  labels: T::Array[String],
                   metadata:
                     T::Hash[
                       Symbol,
                       SafetyKit::Beta::EventCreateParams::Body::ModerationDecisionEventRequest::Metadata::Variants
                     ],
+                  negative_labels: T::Array[String],
                   resources_used:
                     T::Array[
                       T.any(
@@ -12923,10 +12945,6 @@ module SafetyKit
               sig { returns(String) }
               attr_accessor :event_name
 
-              # One or more label categories supplied with the report or moderation decision.
-              sig { returns(T::Array[String]) }
-              attr_accessor :labels
-
               # Stable identifier within source_type. Examples: moderator@example.com or
               # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
               # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -13017,6 +13035,14 @@ module SafetyKit
               sig { params(idempotency_key: String).void }
               attr_writer :idempotency_key
 
+              # Label categories the decision determined apply to the target. At least one of
+              # labels or negative_labels is required.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :labels
+
+              sig { params(labels: T::Array[String]).void }
+              attr_writer :labels
+
               # Non-PII product context for filtering, segmentation, and debugging. Values may
               # be strings, numbers, booleans, or arrays of those scalar values.
               sig do
@@ -13042,6 +13068,15 @@ module SafetyKit
               end
               attr_writer :metadata
 
+              # Label categories the decision explicitly reviewed and determined do NOT apply to
+              # the target, such as a manual review that clears a user reported for spam. A
+              # label cannot appear in both labels and negative_labels.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :negative_labels
+
+              sig { params(negative_labels: T::Array[String]).void }
+              attr_writer :negative_labels
+
               # Reusable resources observed during the event. Use this for emails, phone
               # numbers, names, addresses, social handles, URLs, payment identifiers,
               # caller-defined ids, or similar identifiers.
@@ -13088,11 +13123,12 @@ module SafetyKit
 
               # A moderation label or decision from an automated enforcement system or manual
               # review workflow. Do not send user_id; use source_type and source_id for
-              # attribution.
+              # attribution. Use labels for categories the decision applied and negative_labels
+              # for categories the decision explicitly reviewed and determined do not apply; at
+              # least one of the two is required.
               sig do
                 params(
                   event_name: String,
-                  labels: T::Array[String],
                   source_id: String,
                   source_type:
                     SafetyKit::Beta::EventCreateParams::Body::UnionMember8::ModerationDecision::SourceType::OrSymbol,
@@ -13108,11 +13144,13 @@ module SafetyKit
                     ],
                   content_id: String,
                   idempotency_key: String,
+                  labels: T::Array[String],
                   metadata:
                     T::Hash[
                       Symbol,
                       SafetyKit::Beta::EventCreateParams::Body::UnionMember8::ModerationDecision::Metadata::Variants
                     ],
+                  negative_labels: T::Array[String],
                   resources_used:
                     T::Array[
                       T.any(
@@ -13129,8 +13167,6 @@ module SafetyKit
                 # Stable, low-cardinality product action name. Use snake_case and put dynamic
                 # values in typed fields, content, resources_used, or metadata.
                 event_name:,
-                # One or more label categories supplied with the report or moderation decision.
-                labels:,
                 # Stable identifier within source_type. Examples: moderator@example.com or
                 # 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator,
                 # automated_review_v2026_06_04 for automation, or <vendor_name>-v2.1 for vendor.
@@ -13156,9 +13192,16 @@ module SafetyKit
                 # Optional caller-provided key used to make retries of this individual event
                 # idempotent. Reuse the same key only for retries of the same logical event.
                 idempotency_key: nil,
+                # Label categories the decision determined apply to the target. At least one of
+                # labels or negative_labels is required.
+                labels: nil,
                 # Non-PII product context for filtering, segmentation, and debugging. Values may
                 # be strings, numbers, booleans, or arrays of those scalar values.
                 metadata: nil,
+                # Label categories the decision explicitly reviewed and determined do NOT apply to
+                # the target, such as a manual review that clears a user reported for spam. A
+                # label cannot appear in both labels and negative_labels.
+                negative_labels: nil,
                 # Reusable resources observed during the event. Use this for emails, phone
                 # numbers, names, addresses, social handles, URLs, payment identifiers,
                 # caller-defined ids, or similar identifiers.
@@ -13175,7 +13218,6 @@ module SafetyKit
                 override.returns(
                   {
                     event_name: String,
-                    labels: T::Array[String],
                     source_id: String,
                     source_type:
                       SafetyKit::Beta::EventCreateParams::Body::UnionMember8::ModerationDecision::SourceType::OrSymbol,
@@ -13192,11 +13234,13 @@ module SafetyKit
                       ],
                     content_id: String,
                     idempotency_key: String,
+                    labels: T::Array[String],
                     metadata:
                       T::Hash[
                         Symbol,
                         SafetyKit::Beta::EventCreateParams::Body::UnionMember8::ModerationDecision::Metadata::Variants
                       ],
+                    negative_labels: T::Array[String],
                     resources_used:
                       T::Array[
                         T.any(

data/rbi/safety_kit/models/content_create_params.rbi

@@ -11,7 +11,9 @@ module SafetyKit
           T.any(SafetyKit::ContentCreateParams, SafetyKit::Internal::AnyHash)
         end
 
-      # Content parts to classify together. At most 20 images.
+      # Content parts to classify together. At most 20 images. Text parts may total
+      # 128,000 characters. Text is classified in overlapping windows and a label
+      # matches when any window matches.
       sig do
         returns(
           T::Array[
@@ -76,7 +78,9 @@ module SafetyKit
         ).returns(T.attached_class)
       end
       def self.new(
-        # Content parts to classify together. At most 20 images.
+        # Content parts to classify together. At most 20 images. Text parts may total
+        # 128,000 characters. Text is classified in overlapping windows and a label
+        # matches when any window matches.
         content:,
         # Your stable identifier for the user this content belongs to.
         user_id:,
@@ -133,7 +137,7 @@ module SafetyKit
               )
             end
 
-          # User-authored text to classify.
+          # User-authored text to classify. At most 16,000 characters per part.
           sig { returns(String) }
           attr_accessor :text
 
@@ -160,7 +164,7 @@ module SafetyKit
             ).returns(T.attached_class)
           end
           def self.new(
-            # User-authored text to classify.
+            # User-authored text to classify. At most 16,000 characters per part.
             text:,
             type:,
             # Your name for where this part came from.

data/rbi/safety_kit/resources/content.rbi

@@ -31,7 +31,9 @@ module SafetyKit
         ).returns(SafetyKit::Models::ContentCreateResponse)
       end
       def create(
-        # Body param: Content parts to classify together. At most 20 images.
+        # Body param: Content parts to classify together. At most 20 images. Text parts
+        # may total 128,000 characters. Text is classified in overlapping windows and a
+        # label matches when any window matches.
         content:,
         # Body param: Your stable identifier for the user this content belongs to.
         user_id:,