safetykit 0.56.0 → 0.58.0

data/rbi/safety_kit/resources/content.rbi

@@ -5,9 +5,9 @@ module SafetyKit
     # Classify user-authored text and images synchronously and receive a decision in
     # the response.
     class Content
-      # Classify a piece of content synchronously. Send user-authored text, images, or
-      # both, and receive per-policy results in the response. Requests have a maximum
-      # size of 6MB.
+      # Classify a piece of content synchronously. Send text and image parts and receive
+      # per-label results in the response. Requests have a maximum size of 6MB. API
+      # version 2026-08-11; see the API versioning guide for superseded versions.
       #
       # Errors: 400 for an invalid body or images, with the failing field in the
       # message. 401 for a missing or invalid API key. 413 for requests over 6MB. 503
@@ -15,26 +15,33 @@ module SafetyKit
       # not processed and is safe to retry.
       sig do
         params(
+          content:
+            T::Array[
+              T.any(
+                SafetyKit::ContentCreateParams::Content::UnionMember0::OrHash,
+                SafetyKit::ContentCreateParams::Content::UnionMember1::OrHash
+              )
+            ],
           user_id: String,
           content_id: String,
-          images: T::Array[String],
           metadata: T::Hash[Symbol, T.nilable(T.anything)],
-          text: String,
+          safety_kit_version:
+            SafetyKit::ContentCreateParams::SafetyKitVersion::OrSymbol,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(SafetyKit::Models::ContentCreateResponse)
       end
       def create(
-        # Your stable identifier for the user this content belongs to.
+        # Body param: Content parts to classify together. At most 20 images.
+        content:,
+        # Body param: Your stable identifier for the user this content belongs to.
         user_id:,
-        # Your content identifier.
+        # Body param: Your content identifier.
         content_id: nil,
-        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-        # most 5MB each.
-        images: nil,
-        # Additional product context for this content. At most 8KB when serialized.
+        # Body param: Additional product context for this content. At most 8KB when
+        # serialized.
         metadata: nil,
-        # User-authored text to classify.
-        text: nil,
+        # Header param: The API version this operation is defined against.
+        safety_kit_version: nil,
         request_options: {}
       )
       end

data/rbi/safety_kit/resources/streams.rbi

@@ -5,6 +5,12 @@ module SafetyKit
     # Ingest and monitor livestream content.
     class Streams
       # Monitor the livestream at the given stream URL. This method returns immediately.
+      #
+      # Errors: 400 for an invalid body, with the reason in the message. 401 for a
+      # missing Authorization header. 403 for an invalid API key. 429 when the rate
+      # limit is exceeded. 5xx for transient internal failures. Retry 429 and 5xx with
+      # exponential backoff. Do not retry other 4xx errors, they indicate a problem with
+      # the request.
       sig do
         params(
           namespace: String,
@@ -31,6 +37,13 @@ module SafetyKit
       # Duplicate or out-of-order frame timestamps are accepted at the API boundary but
       # ignored by downstream processing. This method returns immediately after the
       # frame has been accepted for processing.
+      #
+      # Errors: 400 for an invalid body or an image that fails validation, with the
+      # reason in the message. 401 for a missing Authorization header. 403 for an
+      # invalid API key. 429 when the rate limit is exceeded. 5xx for transient internal
+      # failures. Retry 429 and 5xx with exponential backoff. Frame ingestion is
+      # idempotent, so a retried request that already succeeded is ignored. Do not retry
+      # other 4xx errors, they indicate a problem with the request.
       sig do
         params(
           namespace: String,
@@ -67,6 +80,13 @@ module SafetyKit
       # monotonically increasing within a stream so transcript context lines up
       # correctly with later frames. This method returns immediately after the
       # transcript has been accepted for processing.
+      #
+      # Errors: 400 for an invalid body, with the reason in the message. 401 for a
+      # missing Authorization header. 403 for an invalid API key. 429 when the rate
+      # limit is exceeded. 5xx for transient internal failures. Retry 429 and 5xx with
+      # exponential backoff. Transcript ingestion is idempotent, so a retried request
+      # that already succeeded is ignored. Do not retry other 4xx errors, they indicate
+      # a problem with the request.
       sig do
         params(
           namespace: String,

data/sig/safety_kit/models/content_create_params.rbs

@@ -2,11 +2,11 @@ module SafetyKit
   module Models
     type content_create_params =
       {
+        content: ::Array[SafetyKit::Models::ContentCreateParams::content],
         user_id: String,
         content_id: String,
-        images: ::Array[String],
         metadata: ::Hash[Symbol, top?],
-        text: String
+        safety_kit_version: SafetyKit::Models::ContentCreateParams::safety_kit_version
       }
       & SafetyKit::Internal::Type::request_parameters
 
@@ -14,41 +14,171 @@ module SafetyKit
       extend SafetyKit::Internal::Type::RequestParameters::Converter
       include SafetyKit::Internal::Type::RequestParameters
 
+      attr_accessor content: ::Array[SafetyKit::Models::ContentCreateParams::content]
+
       attr_accessor user_id: String
 
       attr_reader content_id: String?
 
       def content_id=: (String) -> String
 
-      attr_reader images: ::Array[String]?
-
-      def images=: (::Array[String]) -> ::Array[String]
-
       attr_reader metadata: ::Hash[Symbol, top?]?
 
       def metadata=: (::Hash[Symbol, top?]) -> ::Hash[Symbol, top?]
 
-      attr_reader text: String?
+      attr_reader safety_kit_version: SafetyKit::Models::ContentCreateParams::safety_kit_version?
 
-      def text=: (String) -> String
+      def safety_kit_version=: (
+        SafetyKit::Models::ContentCreateParams::safety_kit_version
+      ) -> SafetyKit::Models::ContentCreateParams::safety_kit_version
 
       def initialize: (
+        content: ::Array[SafetyKit::Models::ContentCreateParams::content],
         user_id: String,
         ?content_id: String,
-        ?images: ::Array[String],
         ?metadata: ::Hash[Symbol, top?],
-        ?text: String,
+        ?safety_kit_version: SafetyKit::Models::ContentCreateParams::safety_kit_version,
         ?request_options: SafetyKit::request_opts
       ) -> void
 
       def to_hash: -> {
+        content: ::Array[SafetyKit::Models::ContentCreateParams::content],
         user_id: String,
         content_id: String,
-        images: ::Array[String],
         metadata: ::Hash[Symbol, top?],
-        text: String,
+        safety_kit_version: SafetyKit::Models::ContentCreateParams::safety_kit_version,
         request_options: SafetyKit::RequestOptions
       }
+
+      type content =
+        SafetyKit::ContentCreateParams::Content::UnionMember0
+        | SafetyKit::ContentCreateParams::Content::UnionMember1
+
+      module Content
+        extend SafetyKit::Internal::Type::Union
+
+        type union_member0 =
+          {
+            text: String,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember0::type_,
+            key: String
+          }
+
+        class UnionMember0 < SafetyKit::Internal::Type::BaseModel
+          attr_accessor text: String
+
+          attr_accessor type: SafetyKit::Models::ContentCreateParams::Content::UnionMember0::type_
+
+          attr_reader key: String?
+
+          def key=: (String) -> String
+
+          def initialize: (
+            text: String,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember0::type_,
+            ?key: String
+          ) -> void
+
+          def to_hash: -> {
+            text: String,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember0::type_,
+            key: String
+          }
+
+          type type_ = :text
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TEXT: :text
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateParams::Content::UnionMember0::type_]
+          end
+        end
+
+        type union_member1 =
+          {
+            source: SafetyKit::ContentCreateParams::Content::UnionMember1::Source,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::type_,
+            key: String
+          }
+
+        class UnionMember1 < SafetyKit::Internal::Type::BaseModel
+          attr_accessor source: SafetyKit::ContentCreateParams::Content::UnionMember1::Source
+
+          attr_accessor type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::type_
+
+          attr_reader key: String?
+
+          def key=: (String) -> String
+
+          def initialize: (
+            source: SafetyKit::ContentCreateParams::Content::UnionMember1::Source,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::type_,
+            ?key: String
+          ) -> void
+
+          def to_hash: -> {
+            source: SafetyKit::ContentCreateParams::Content::UnionMember1::Source,
+            type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::type_,
+            key: String
+          }
+
+          type source =
+            {
+              data: String,
+              type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::type_
+            }
+
+          class Source < SafetyKit::Internal::Type::BaseModel
+            attr_accessor data: String
+
+            attr_accessor type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::type_
+
+            def initialize: (
+              data: String,
+              type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::type_
+            ) -> void
+
+            def to_hash: -> {
+              data: String,
+              type: SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::type_
+            }
+
+            type type_ = :base64
+
+            module Type
+              extend SafetyKit::Internal::Type::Enum
+
+              BASE64: :base64
+
+              def self?.values: -> ::Array[SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::type_]
+            end
+          end
+
+          type type_ = :image
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            IMAGE: :image
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateParams::Content::UnionMember1::type_]
+          end
+        end
+
+        def self?.variants: -> ::Array[SafetyKit::Models::ContentCreateParams::content]
+      end
+
+      type safety_kit_version = :"2026-08-11"
+
+      module SafetyKitVersion
+        extend SafetyKit::Internal::Type::Enum
+
+        SAFETY_KIT_VERSION_2026_08_11: :"2026-08-11"
+
+        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateParams::safety_kit_version]
+      end
     end
   end
 end

data/sig/safety_kit/models/content_create_response.rbs

@@ -3,105 +3,199 @@ module SafetyKit
     type content_create_response =
       {
         content_id: String,
-        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
-        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        user_id: String
+        labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
+        user_id: String,
+        version: String
       }
 
     class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
       attr_accessor content_id: String
 
-      attr_accessor policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy]
-
-      attr_accessor reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
+      attr_accessor labels: ::Array[SafetyKit::Models::ContentCreateResponse::label]
 
       attr_accessor user_id: String
 
+      attr_accessor version: String
+
       def initialize: (
         content_id: String,
-        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
-        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        user_id: String
+        labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
+        user_id: String,
+        version: String
       ) -> void
 
       def to_hash: -> {
         content_id: String,
-        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
-        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        user_id: String
+        labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
+        user_id: String,
+        version: String
       }
 
-      type policy =
-        {
-          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
-          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
-          policy_id: String,
-          score: Float,
-          version: String
-        }
+      type label =
+        SafetyKit::Models::ContentCreateResponse::Label::UnionMember0
+        | SafetyKit::Models::ContentCreateResponse::Label::UnionMember1
 
-      class Policy < SafetyKit::Internal::Type::BaseModel
-        attr_accessor decision: SafetyKit::Models::ContentCreateResponse::Policy::decision
+      module Label
+        extend SafetyKit::Internal::Type::Union
 
-        attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation
+        type union_member0 =
+          {
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::escalation,
+            label: String,
+            score: Float?,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::type_
+          }
 
-        attr_accessor policy_id: String
+        class UnionMember0 < SafetyKit::Internal::Type::BaseModel
+          attr_accessor decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::decision
 
-        attr_accessor score: Float
+          attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::escalation
 
-        attr_accessor version: String
+          attr_accessor label: String
 
-        def initialize: (
-          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
-          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
-          policy_id: String,
-          score: Float,
-          version: String
-        ) -> void
+          attr_accessor score: Float?
 
-        def to_hash: -> {
-          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
-          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
-          policy_id: String,
-          score: Float,
-          version: String
-        }
+          attr_accessor type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::type_
 
-        type decision = :match | :not_match | :review
+          def initialize: (
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::escalation,
+            label: String,
+            score: Float?,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::type_
+          ) -> void
 
-        module Decision
-          extend SafetyKit::Internal::Type::Enum
+          def to_hash: -> {
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::escalation,
+            label: String,
+            score: Float?,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::type_
+          }
 
-          MATCH: :match
-          NOT_MATCH: :not_match
-          REVIEW: :review
+          type decision = :match | :not_match | :review
 
-          def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Policy::decision]
-        end
+          module Decision
+            extend SafetyKit::Internal::Type::Enum
+
+            MATCH: :match
+            NOT_MATCH: :not_match
+            REVIEW: :review
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::decision]
+          end
+
+          type escalation = :none | :completed | :error
+
+          module Escalation
+            extend SafetyKit::Internal::Type::Enum
+
+            NONE: :none
+            COMPLETED: :completed
+            ERROR: :error
 
-        type escalation = :none | :completed | :error
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::escalation]
+          end
 
-        module Escalation
-          extend SafetyKit::Internal::Type::Enum
+          type type_ = :classifier
 
-          NONE: :none
-          COMPLETED: :completed
-          ERROR: :error
+          module Type
+            extend SafetyKit::Internal::Type::Enum
 
-          def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Policy::escalation]
+            CLASSIFIER: :classifier
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::type_]
+          end
         end
-      end
 
-      type reference_set_match = { set_id: String, similarity: Float }
+        type union_member1 =
+          {
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::escalation,
+            label: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::label,
+            score: Float,
+            set_id: String,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::type_
+          }
+
+        class UnionMember1 < SafetyKit::Internal::Type::BaseModel
+          attr_accessor decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::decision
+
+          attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::escalation
+
+          attr_accessor label: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::label
+
+          attr_accessor score: Float
+
+          attr_accessor set_id: String
+
+          attr_accessor type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::type_
 
-      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
-        attr_accessor set_id: String
+          def initialize: (
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::escalation,
+            label: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::label,
+            score: Float,
+            set_id: String,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::type_
+          ) -> void
 
-        attr_accessor similarity: Float
+          def to_hash: -> {
+            decision: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::decision,
+            escalation: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::escalation,
+            label: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::label,
+            score: Float,
+            set_id: String,
+            type: SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::type_
+          }
 
-        def initialize: (set_id: String, similarity: Float) -> void
+          type decision = :match | :not_match | :review
+
+          module Decision
+            extend SafetyKit::Internal::Type::Enum
+
+            MATCH: :match
+            NOT_MATCH: :not_match
+            REVIEW: :review
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::decision]
+          end
+
+          type escalation = :none | :completed | :error
+
+          module Escalation
+            extend SafetyKit::Internal::Type::Enum
+
+            NONE: :none
+            COMPLETED: :completed
+            ERROR: :error
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::escalation]
+          end
+
+          type label = :reference_set_match
+
+          module Label
+            extend SafetyKit::Internal::Type::Enum
+
+            REFERENCE_SET_MATCH: :reference_set_match
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::label]
+          end
+
+          type type_ = :similarity
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            SIMILARITY: :similarity
+
+            def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::type_]
+          end
+        end
 
-        def to_hash: -> { set_id: String, similarity: Float }
+        def self?.variants: -> ::Array[SafetyKit::Models::ContentCreateResponse::label]
       end
     end
   end

data/sig/safety_kit/resources/content.rbs

@@ -2,11 +2,11 @@ module SafetyKit
   module Resources
     class Content
       def create: (
+        content: ::Array[SafetyKit::Models::ContentCreateParams::content],
         user_id: String,
         ?content_id: String,
-        ?images: ::Array[String],
         ?metadata: ::Hash[Symbol, top?],
-        ?text: String,
+        ?safety_kit_version: SafetyKit::Models::ContentCreateParams::safety_kit_version,
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::ContentCreateResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.56.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-07 00:00:00.000000000 Z
+date: 2026-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi