safetykit 0.49.0 → 0.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffe5ac9eeb7e3772d15ac6cd4050b50ce60db643f95f7a372568f8d063584730
-  data.tar.gz: 6a2fd2adb3656d26d80c6f3dd9dd6d21d21f716d8d47c96a79575c4d3c68ce91
+  metadata.gz: edca5667de202b072736d856befde1d6dc5c05159172501817845236aef204f0
+  data.tar.gz: 80ab0c4d50b502d7bc63be3358cb7ce94f3075a1d30b7f2716a3e33ca9c90aeb
 SHA512:
-  metadata.gz: 0f7d6ee8836e86ed525ef0a6f40321dbc75fa6e97b2065ec5e9eec16a32146f241c3774008b8b28965dc4e95d6576e74cbfa4fde0930a051b787fcdfb6347ae6
-  data.tar.gz: ccd6fbacb38d4935fb20d07aeb125a75a0601e5244b491e55e094fd11d980f3837aa5acb59bd5263778c27125f56ed0448a9754501a6eaf9c73b1bd8e03ca882
+  metadata.gz: 47729951a4064258d19e89c45cbbcdbda4e4a9a1ef7672114047c0bf7cc974b8298f5221c8c1d18e8285d9749f8cc1789900d07895c29df45fcf0048ff917b6d
+  data.tar.gz: 3eb38d4ff7ed1cfae936e0bddf738063776594954a2e8c36ba68ca37caf528e364234636c9202eb3e6b029e7de827d74c1a8f43d1c7dc159f69cd6e889e8c654

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.51.0 (2026-08-05)
+
+Full Changelog: [v0.50.0...v0.51.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.50.0...v0.51.0)
+
+### Features
+
+* **api:** api update ([3a57f4e](https://github.com/GetSafetyKit/safetykit-ruby/commit/3a57f4e95d35ddb799c71c06db72ccedbd171560))
+
+## 0.50.0 (2026-08-01)
+
+Full Changelog: [v0.49.0...v0.50.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.49.0...v0.50.0)
+
+### Features
+
+* **api:** api update ([0f2676b](https://github.com/GetSafetyKit/safetykit-ruby/commit/0f2676b4f1b89391e398e1ae101f70de5bd07772))
+
 ## 0.49.0 (2026-07-31)
 
 Full Changelog: [v0.48.0...v0.49.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.48.0...v0.49.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "safetykit", "~> 0.49.0"
+gem "safetykit", "~> 0.51.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/client.rb

@@ -42,6 +42,11 @@ module SafetyKit
     # @return [SafetyKit::Resources::Async]
     attr_reader :async
 
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    # @return [SafetyKit::Resources::Content]
+    attr_reader :content
+
     # Submit end-user deletion requests. Accepted requests are processed
     # asynchronously.
     # @return [SafetyKit::Resources::DeletionRequests]
@@ -128,6 +133,7 @@ module SafetyKit
       @agent_decisions = SafetyKit::Resources::AgentDecisions.new(client: self)
       @access_tokens = SafetyKit::Resources::AccessTokens.new(client: self)
       @async = SafetyKit::Resources::Async.new(client: self)
+      @content = SafetyKit::Resources::Content.new(client: self)
       @deletion_requests = SafetyKit::Resources::DeletionRequests.new(client: self)
       @client_sessions = SafetyKit::Resources::ClientSessions.new(client: self)
       @beta = SafetyKit::Resources::Beta.new(client: self)

data/lib/safety_kit/models/content_create_params.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Content#create
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      # @!attribute entity_id
+      #   Your stable identifier for the entity this content belongs to, such as a user,
+      #   listing, or message thread.
+      #
+      #   @return [String]
+      required :entity_id, String
+
+      # @!attribute content_id
+      #   Your identifier for this piece of content — the same content_id you send on
+      #   /v1/events. When provided, the event this call records deduplicates against the
+      #   same upload posted through the events API, so sending both never double-counts
+      #   the content.
+      #
+      #   @return [String, nil]
+      optional :content_id, String
+
+      # @!attribute images
+      #   Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      #   most 4 images. The full request body must stay under 6MB, which allows roughly
+      #   4.4MB of raw image bytes after base64 inflation.
+      #
+      #   @return [Array<String>, nil]
+      optional :images, SafetyKit::Internal::Type::ArrayOf[String]
+
+      # @!attribute metadata
+      #   Additional product context for this content. At most 8KB when serialized.
+      #
+      #   @return [Hash{Symbol=>Object, nil}, nil]
+      optional :metadata, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!attribute text
+      #   User-authored text to classify. At most 20000 characters.
+      #
+      #   @return [String, nil]
+      optional :text, String
+
+      # @!method initialize(entity_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::ContentCreateParams} for more details.
+      #
+      #   @param entity_id [String] Your stable identifier for the entity this content belongs to, such as a user, l
+      #
+      #   @param content_id [String] Your identifier for this piece of content — the same content_id you send on /v1/
+      #
+      #   @param images [Array<String>] Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      #
+      #   @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content. At most 8KB when serialized.
+      #
+      #   @param text [String] User-authored text to classify. At most 20000 characters.
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/safety_kit/models/content_create_response.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Content#create
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute content_id
+      #   SafetyKit identifier for the classified content.
+      #
+      #   @return [String]
+      required :content_id, String
+
+      # @!attribute decision
+      #   SafetyKit's decision for the submitted content: approve (no violation found),
+      #   reject (violating), or review (needs human review).
+      #
+      #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Decision]
+      required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Decision }
+
+      # @!attribute entity_id
+      #   The entity_id from the request.
+      #
+      #   @return [String]
+      required :entity_id, String
+
+      # @!attribute escalation
+      #   Escalation outcome for this request: none (the request never entered the
+      #   escalation band), completed (the escalated verdict is reflected in decision), or
+      #   timed_out (escalation did not finish in budget, so decision is a provisional
+      #   review).
+      #
+      #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Escalation]
+      required :escalation, enum: -> { SafetyKit::Models::ContentCreateResponse::Escalation }
+
+      # @!attribute mirrored
+      #   Whether SafetyKit mirrored the submitted content for later review.
+      #
+      #   @return [Boolean]
+      required :mirrored, SafetyKit::Internal::Type::Boolean
+
+      # @!attribute reference_set_matches
+      #   Reference set matches found for the submitted content.
+      #
+      #   @return [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>]
+      required :reference_set_matches,
+               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch] }
+
+      # @!attribute scores
+      #   Classifier scores produced for the submitted content.
+      #
+      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Score>]
+      required :scores,
+               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::Score] }
+
+      # @!method initialize(content_id:, decision:, entity_id:, escalation:, mirrored:, reference_set_matches:, scores:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::ContentCreateResponse} for more details.
+      #
+      #   Synchronous classification result for the submitted content.
+      #
+      #   @param content_id [String] SafetyKit identifier for the classified content.
+      #
+      #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Decision] SafetyKit's decision for the submitted content: approve (no violation found), re
+      #
+      #   @param entity_id [String] The entity_id from the request.
+      #
+      #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Escalation] Escalation outcome for this request: none (the request never entered the escalat
+      #
+      #   @param mirrored [Boolean] Whether SafetyKit mirrored the submitted content for later review.
+      #
+      #   @param reference_set_matches [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>] Reference set matches found for the submitted content.
+      #
+      #   @param scores [Array<SafetyKit::Models::ContentCreateResponse::Score>] Classifier scores produced for the submitted content.
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      #
+      # @see SafetyKit::Models::ContentCreateResponse#decision
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        APPROVE = :approve
+        REJECT = :reject
+        REVIEW = :review
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Escalation outcome for this request: none (the request never entered the
+      # escalation band), completed (the escalated verdict is reflected in decision), or
+      # timed_out (escalation did not finish in budget, so decision is a provisional
+      # review).
+      #
+      # @see SafetyKit::Models::ContentCreateResponse#escalation
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        NONE = :none
+        COMPLETED = :completed
+        TIMED_OUT = :timed_out
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
+        # @!attribute set_id
+        #   Identifier of the matched reference set.
+        #
+        #   @return [String]
+        required :set_id, String
+
+        # @!attribute similarity
+        #   Similarity between the submitted content and the matched reference set entry.
+        #
+        #   @return [Float]
+        required :similarity, Float
+
+        # @!method initialize(set_id:, similarity:)
+        #   Reference set match found for the submitted content.
+        #
+        #   @param set_id [String] Identifier of the matched reference set.
+        #
+        #   @param similarity [Float] Similarity between the submitted content and the matched reference set entry.
+      end
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        # @!attribute classifier_id
+        #   Identifier of the classifier that produced this score.
+        #
+        #   @return [String]
+        required :classifier_id, String
+
+        # @!attribute score
+        #   Classifier score between 0 and 1. Higher means more likely violating.
+        #
+        #   @return [Float]
+        required :score, Float
+
+        # @!attribute version
+        #   Version of the classifier that produced this score.
+        #
+        #   @return [String]
+        required :version, String
+
+        # @!method initialize(classifier_id:, score:, version:)
+        #   Score produced by one classifier for the submitted content.
+        #
+        #   @param classifier_id [String] Identifier of the classifier that produced this score.
+        #
+        #   @param score [Float] Classifier score between 0 and 1. Higher means more likely violating.
+        #
+        #   @param version [String] Version of the classifier that produced this score.
+      end
+    end
+  end
+end

data/lib/safety_kit/models/stream_add_frame_params.rb

@@ -37,7 +37,15 @@ module SafetyKit
       #   @return [String, nil]
       optional :frame_id, String
 
-      # @!method initialize(namespace:, image_data_uri:, stream_id:, timestamp:, frame_id: nil, request_options: {})
+      # @!attribute metadata
+      #   Arbitrary key-value metadata to associate with this frame, at most 8192 bytes
+      #   when serialized. If a violation is detected on this frame, the metadata is
+      #   echoed back verbatim in the live_video.violation_detected webhook.
+      #
+      #   @return [Hash{Symbol=>Object, nil}, nil]
+      optional :metadata, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!method initialize(namespace:, image_data_uri:, stream_id:, timestamp:, frame_id: nil, metadata: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::StreamAddFrameParams} for more details.
       #
@@ -51,6 +59,8 @@ module SafetyKit
       #
       #   @param frame_id [String]
       #
+      #   @param metadata [Hash{Symbol=>Object, nil}] Arbitrary key-value metadata to associate with this frame, at most 8192 bytes wh
+      #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/safety_kit/models.rb

@@ -49,6 +49,8 @@ module SafetyKit
 
   ClientSessionCreateSessionParams = SafetyKit::Models::ClientSessionCreateSessionParams
 
+  ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   DataAddParams = SafetyKit::Models::DataAddParams
 
   DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/lib/safety_kit/resources/content.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Resources
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    class Content
+      # Some parameter documentations has been truncated, see
+      # {SafetyKit::Models::ContentCreateParams} for more details.
+      #
+      # Classify a piece of content synchronously. Send user-authored text, images, or
+      # both, and receive a decision (approve, reject, or review) with classifier scores
+      # and reference set matches in the response. The full request body must stay under
+      # 6MB, which allows roughly 4.4MB of raw image bytes after base64 inflation.
+      #
+      # @overload create(entity_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      #
+      # @param entity_id [String] Your stable identifier for the entity this content belongs to, such as a user, l
+      #
+      # @param content_id [String] Your identifier for this piece of content — the same content_id you send on /v1/
+      #
+      # @param images [Array<String>] Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      #
+      # @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content. At most 8KB when serialized.
+      #
+      # @param text [String] User-authored text to classify. At most 20000 characters.
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::ContentCreateResponse]
+      #
+      # @see SafetyKit::Models::ContentCreateParams
+      def create(params)
+        parsed, options = SafetyKit::ContentCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/content",
+          body: parsed,
+          model: SafetyKit::Models::ContentCreateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SafetyKit::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/safety_kit/resources/streams.rb

@@ -43,7 +43,7 @@ module SafetyKit
       # ignored by downstream processing. This method returns immediately after the
       # frame has been accepted for processing.
       #
-      # @overload add_frame(namespace, image_data_uri:, stream_id:, timestamp:, frame_id: nil, request_options: {})
+      # @overload add_frame(namespace, image_data_uri:, stream_id:, timestamp:, frame_id: nil, metadata: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into
       #
@@ -55,6 +55,8 @@ module SafetyKit
       #
       # @param frame_id [String]
       #
+      # @param metadata [Hash{Symbol=>Object, nil}] Arbitrary key-value metadata to associate with this frame, at most 8192 bytes wh
+      #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [SafetyKit::Models::StreamAddFrameResponse]

data/lib/safety_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SafetyKit
-  VERSION = "0.49.0"
+  VERSION = "0.51.0"
 end

data/lib/safety_kit.rb

@@ -62,6 +62,8 @@ require_relative "safety_kit/models/beta/event_create_params"
 require_relative "safety_kit/models/beta/event_create_response"
 require_relative "safety_kit/models/client_session_create_session_params"
 require_relative "safety_kit/models/client_session_create_session_response"
+require_relative "safety_kit/models/content_create_params"
+require_relative "safety_kit/models/content_create_response"
 require_relative "safety_kit/models/data_add_params"
 require_relative "safety_kit/models/data_add_response"
 require_relative "safety_kit/models/data_create_upload_url_params"
@@ -88,6 +90,7 @@ require_relative "safety_kit/resources/async"
 require_relative "safety_kit/resources/beta"
 require_relative "safety_kit/resources/beta/events"
 require_relative "safety_kit/resources/client_sessions"
+require_relative "safety_kit/resources/content"
 require_relative "safety_kit/resources/data"
 require_relative "safety_kit/resources/deletion_requests"
 require_relative "safety_kit/resources/streams"

data/rbi/safety_kit/client.rbi

@@ -37,6 +37,11 @@ module SafetyKit
     sig { returns(SafetyKit::Resources::Async) }
     attr_reader :async
 
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    sig { returns(SafetyKit::Resources::Content) }
+    attr_reader :content
+
     # Submit end-user deletion requests. Accepted requests are processed
     # asynchronously.
     sig { returns(SafetyKit::Resources::DeletionRequests) }

data/rbi/safety_kit/models/content_create_params.rbi

@@ -0,0 +1,99 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SafetyKit::ContentCreateParams, SafetyKit::Internal::AnyHash)
+        end
+
+      # Your stable identifier for the entity this content belongs to, such as a user,
+      # listing, or message thread.
+      sig { returns(String) }
+      attr_accessor :entity_id
+
+      # Your identifier for this piece of content — the same content_id you send on
+      # /v1/events. When provided, the event this call records deduplicates against the
+      # same upload posted through the events API, so sending both never double-counts
+      # the content.
+      sig { returns(T.nilable(String)) }
+      attr_reader :content_id
+
+      sig { params(content_id: String).void }
+      attr_writer :content_id
+
+      # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      # most 4 images. The full request body must stay under 6MB, which allows roughly
+      # 4.4MB of raw image bytes after base64 inflation.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :images
+
+      sig { params(images: T::Array[String]).void }
+      attr_writer :images
+
+      # Additional product context for this content. At most 8KB when serialized.
+      sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, T.nilable(T.anything)]).void }
+      attr_writer :metadata
+
+      # User-authored text to classify. At most 20000 characters.
+      sig { returns(T.nilable(String)) }
+      attr_reader :text
+
+      sig { params(text: String).void }
+      attr_writer :text
+
+      sig do
+        params(
+          entity_id: String,
+          content_id: String,
+          images: T::Array[String],
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
+          text: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Your stable identifier for the entity this content belongs to, such as a user,
+        # listing, or message thread.
+        entity_id:,
+        # Your identifier for this piece of content — the same content_id you send on
+        # /v1/events. When provided, the event this call records deduplicates against the
+        # same upload posted through the events API, so sending both never double-counts
+        # the content.
+        content_id: nil,
+        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+        # most 4 images. The full request body must stay under 6MB, which allows roughly
+        # 4.4MB of raw image bytes after base64 inflation.
+        images: nil,
+        # Additional product context for this content. At most 8KB when serialized.
+        metadata: nil,
+        # User-authored text to classify. At most 20000 characters.
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            entity_id: String,
+            content_id: String,
+            images: T::Array[String],
+            metadata: T::Hash[Symbol, T.nilable(T.anything)],
+            text: String,
+            request_options: SafetyKit::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/content_create_response.rbi

@@ -0,0 +1,278 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::ContentCreateResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      # SafetyKit identifier for the classified content.
+      sig { returns(String) }
+      attr_accessor :content_id
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      sig do
+        returns(
+          SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+        )
+      end
+      attr_accessor :decision
+
+      # The entity_id from the request.
+      sig { returns(String) }
+      attr_accessor :entity_id
+
+      # Escalation outcome for this request: none (the request never entered the
+      # escalation band), completed (the escalated verdict is reflected in decision), or
+      # timed_out (escalation did not finish in budget, so decision is a provisional
+      # review).
+      sig do
+        returns(
+          SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+        )
+      end
+      attr_accessor :escalation
+
+      # Whether SafetyKit mirrored the submitted content for later review.
+      sig { returns(T::Boolean) }
+      attr_accessor :mirrored
+
+      # Reference set matches found for the submitted content.
+      sig do
+        returns(
+          T::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
+        )
+      end
+      attr_accessor :reference_set_matches
+
+      # Classifier scores produced for the submitted content.
+      sig { returns(T::Array[SafetyKit::Models::ContentCreateResponse::Score]) }
+      attr_accessor :scores
+
+      # Synchronous classification result for the submitted content.
+      sig do
+        params(
+          content_id: String,
+          decision:
+            SafetyKit::Models::ContentCreateResponse::Decision::OrSymbol,
+          entity_id: String,
+          escalation:
+            SafetyKit::Models::ContentCreateResponse::Escalation::OrSymbol,
+          mirrored: T::Boolean,
+          reference_set_matches:
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch::OrHash
+            ],
+          scores:
+            T::Array[SafetyKit::Models::ContentCreateResponse::Score::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # SafetyKit identifier for the classified content.
+        content_id:,
+        # SafetyKit's decision for the submitted content: approve (no violation found),
+        # reject (violating), or review (needs human review).
+        decision:,
+        # The entity_id from the request.
+        entity_id:,
+        # Escalation outcome for this request: none (the request never entered the
+        # escalation band), completed (the escalated verdict is reflected in decision), or
+        # timed_out (escalation did not finish in budget, so decision is a provisional
+        # review).
+        escalation:,
+        # Whether SafetyKit mirrored the submitted content for later review.
+        mirrored:,
+        # Reference set matches found for the submitted content.
+        reference_set_matches:,
+        # Classifier scores produced for the submitted content.
+        scores:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            content_id: String,
+            decision:
+              SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol,
+            entity_id: String,
+            escalation:
+              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol,
+            mirrored: T::Boolean,
+            reference_set_matches:
+              T::Array[
+                SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch
+              ],
+            scores: T::Array[SafetyKit::Models::ContentCreateResponse::Score]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::Models::ContentCreateResponse::Decision)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APPROVE =
+          T.let(
+            :approve,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+        REJECT =
+          T.let(
+            :reject,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+        REVIEW =
+          T.let(
+            :review,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Escalation outcome for this request: none (the request never entered the
+      # escalation band), completed (the escalated verdict is reflected in decision), or
+      # timed_out (escalation did not finish in budget, so decision is a provisional
+      # review).
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::Models::ContentCreateResponse::Escalation)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NONE =
+          T.let(
+            :none,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+        COMPLETED =
+          T.let(
+            :completed,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+        TIMED_OUT =
+          T.let(
+            :timed_out,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # Identifier of the matched reference set.
+        sig { returns(String) }
+        attr_accessor :set_id
+
+        # Similarity between the submitted content and the matched reference set entry.
+        sig { returns(Float) }
+        attr_accessor :similarity
+
+        # Reference set match found for the submitted content.
+        sig do
+          params(set_id: String, similarity: Float).returns(T.attached_class)
+        end
+        def self.new(
+          # Identifier of the matched reference set.
+          set_id:,
+          # Similarity between the submitted content and the matched reference set entry.
+          similarity:
+        )
+        end
+
+        sig { override.returns({ set_id: String, similarity: Float }) }
+        def to_hash
+        end
+      end
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::Models::ContentCreateResponse::Score,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # Identifier of the classifier that produced this score.
+        sig { returns(String) }
+        attr_accessor :classifier_id
+
+        # Classifier score between 0 and 1. Higher means more likely violating.
+        sig { returns(Float) }
+        attr_accessor :score
+
+        # Version of the classifier that produced this score.
+        sig { returns(String) }
+        attr_accessor :version
+
+        # Score produced by one classifier for the submitted content.
+        sig do
+          params(classifier_id: String, score: Float, version: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Identifier of the classifier that produced this score.
+          classifier_id:,
+          # Classifier score between 0 and 1. Higher means more likely violating.
+          score:,
+          # Version of the classifier that produced this score.
+          version:
+        )
+        end
+
+        sig do
+          override.returns(
+            { classifier_id: String, score: Float, version: String }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/stream_add_frame_params.rbi

@@ -34,6 +34,15 @@ module SafetyKit
       sig { params(frame_id: String).void }
       attr_writer :frame_id
 
+      # Arbitrary key-value metadata to associate with this frame, at most 8192 bytes
+      # when serialized. If a violation is detected on this frame, the metadata is
+      # echoed back verbatim in the live_video.violation_detected webhook.
+      sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, T.nilable(T.anything)]).void }
+      attr_writer :metadata
+
       sig do
         params(
           namespace: String,
@@ -41,6 +50,7 @@ module SafetyKit
           stream_id: String,
           timestamp: Integer,
           frame_id: String,
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -55,6 +65,10 @@ module SafetyKit
         stream_id:,
         timestamp:,
         frame_id: nil,
+        # Arbitrary key-value metadata to associate with this frame, at most 8192 bytes
+        # when serialized. If a violation is detected on this frame, the metadata is
+        # echoed back verbatim in the live_video.violation_detected webhook.
+        metadata: nil,
         request_options: {}
       )
       end
@@ -67,6 +81,7 @@ module SafetyKit
             stream_id: String,
             timestamp: Integer,
             frame_id: String,
+            metadata: T::Hash[Symbol, T.nilable(T.anything)],
             request_options: SafetyKit::RequestOptions
           }
         )

data/rbi/safety_kit/models.rbi

@@ -14,6 +14,8 @@ module SafetyKit
   ClientSessionCreateSessionParams =
     SafetyKit::Models::ClientSessionCreateSessionParams
 
+  ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   DataAddParams = SafetyKit::Models::DataAddParams
 
   DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/rbi/safety_kit/resources/content.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module SafetyKit
+  module Resources
+    # 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 a decision (approve, reject, or review) with classifier scores
+      # and reference set matches in the response. The full request body must stay under
+      # 6MB, which allows roughly 4.4MB of raw image bytes after base64 inflation.
+      sig do
+        params(
+          entity_id: String,
+          content_id: String,
+          images: T::Array[String],
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
+          text: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::ContentCreateResponse)
+      end
+      def create(
+        # Your stable identifier for the entity this content belongs to, such as a user,
+        # listing, or message thread.
+        entity_id:,
+        # Your identifier for this piece of content — the same content_id you send on
+        # /v1/events. When provided, the event this call records deduplicates against the
+        # same upload posted through the events API, so sending both never double-counts
+        # the content.
+        content_id: nil,
+        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+        # most 4 images. The full request body must stay under 6MB, which allows roughly
+        # 4.4MB of raw image bytes after base64 inflation.
+        images: nil,
+        # Additional product context for this content. At most 8KB when serialized.
+        metadata: nil,
+        # User-authored text to classify. At most 20000 characters.
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: SafetyKit::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/safety_kit/resources/streams.rbi

@@ -38,6 +38,7 @@ module SafetyKit
           stream_id: String,
           timestamp: Integer,
           frame_id: String,
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(SafetyKit::Models::StreamAddFrameResponse)
       end
@@ -52,6 +53,10 @@ module SafetyKit
         stream_id:,
         timestamp:,
         frame_id: nil,
+        # Arbitrary key-value metadata to associate with this frame, at most 8192 bytes
+        # when serialized. If a violation is detected on this frame, the metadata is
+        # echoed back verbatim in the live_video.violation_detected webhook.
+        metadata: nil,
         request_options: {}
       )
       end

data/sig/safety_kit/client.rbs

@@ -20,6 +20,8 @@ module SafetyKit
 
     attr_reader async: SafetyKit::Resources::Async
 
+    attr_reader content: SafetyKit::Resources::Content
+
     attr_reader deletion_requests: SafetyKit::Resources::DeletionRequests
 
     attr_reader client_sessions: SafetyKit::Resources::ClientSessions

data/sig/safety_kit/models/content_create_params.rbs

@@ -0,0 +1,54 @@
+module SafetyKit
+  module Models
+    type content_create_params =
+      {
+        entity_id: String,
+        content_id: String,
+        images: ::Array[String],
+        metadata: ::Hash[Symbol, top?],
+        text: String
+      }
+      & SafetyKit::Internal::Type::request_parameters
+
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_accessor entity_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?
+
+      def text=: (String) -> String
+
+      def initialize: (
+        entity_id: String,
+        ?content_id: String,
+        ?images: ::Array[String],
+        ?metadata: ::Hash[Symbol, top?],
+        ?text: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        entity_id: String,
+        content_id: String,
+        images: ::Array[String],
+        metadata: ::Hash[Symbol, top?],
+        text: String,
+        request_options: SafetyKit::RequestOptions
+      }
+    end
+  end
+end

data/sig/safety_kit/models/content_create_response.rbs

@@ -0,0 +1,104 @@
+module SafetyKit
+  module Models
+    type content_create_response =
+      {
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      }
+
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor content_id: String
+
+      attr_accessor decision: SafetyKit::Models::ContentCreateResponse::decision
+
+      attr_accessor entity_id: String
+
+      attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::escalation
+
+      attr_accessor mirrored: bool
+
+      attr_accessor reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
+
+      attr_accessor scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+
+      def initialize: (
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      ) -> void
+
+      def to_hash: -> {
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      }
+
+      type decision = :approve | :reject | :review
+
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        APPROVE: :approve
+        REJECT: :reject
+        REVIEW: :review
+
+        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::decision]
+      end
+
+      type escalation = :none | :completed | :timed_out
+
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        NONE: :none
+        COMPLETED: :completed
+        TIMED_OUT: :timed_out
+
+        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::escalation]
+      end
+
+      type reference_set_match = { set_id: String, similarity: Float }
+
+      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
+        attr_accessor set_id: String
+
+        attr_accessor similarity: Float
+
+        def initialize: (set_id: String, similarity: Float) -> void
+
+        def to_hash: -> { set_id: String, similarity: Float }
+      end
+
+      type score = { classifier_id: String, score: Float, version: String }
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        attr_accessor classifier_id: String
+
+        attr_accessor score: Float
+
+        attr_accessor version: String
+
+        def initialize: (
+          classifier_id: String,
+          score: Float,
+          version: String
+        ) -> void
+
+        def to_hash: -> { classifier_id: String, score: Float, version: String }
+      end
+    end
+  end
+end

data/sig/safety_kit/models/stream_add_frame_params.rbs

@@ -6,7 +6,8 @@ module SafetyKit
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
-        frame_id: String
+        frame_id: String,
+        metadata: ::Hash[Symbol, top?]
       }
       & SafetyKit::Internal::Type::request_parameters
 
@@ -26,12 +27,17 @@ module SafetyKit
 
       def frame_id=: (String) -> String
 
+      attr_reader metadata: ::Hash[Symbol, top?]?
+
+      def metadata=: (::Hash[Symbol, top?]) -> ::Hash[Symbol, top?]
+
       def initialize: (
         namespace: String,
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
         ?frame_id: String,
+        ?metadata: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts
       ) -> void
 
@@ -41,6 +47,7 @@ module SafetyKit
         stream_id: String,
         timestamp: Integer,
         frame_id: String,
+        metadata: ::Hash[Symbol, top?],
         request_options: SafetyKit::RequestOptions
       }
     end

data/sig/safety_kit/models.rbs

@@ -9,6 +9,8 @@ module SafetyKit
 
   class ClientSessionCreateSessionParams = SafetyKit::Models::ClientSessionCreateSessionParams
 
+  class ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   class DataAddParams = SafetyKit::Models::DataAddParams
 
   class DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/sig/safety_kit/resources/content.rbs

@@ -0,0 +1,16 @@
+module SafetyKit
+  module Resources
+    class Content
+      def create: (
+        entity_id: String,
+        ?content_id: String,
+        ?images: ::Array[String],
+        ?metadata: ::Hash[Symbol, top?],
+        ?text: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::ContentCreateResponse
+
+      def initialize: (client: SafetyKit::Client) -> void
+    end
+  end
+end

data/sig/safety_kit/resources/streams.rbs

@@ -14,6 +14,7 @@ module SafetyKit
         stream_id: String,
         timestamp: Integer,
         ?frame_id: String,
+        ?metadata: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::StreamAddFrameResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.49.0
+  version: 0.51.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-31 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -79,6 +79,8 @@ files:
 - lib/safety_kit/models/beta/event_create_response.rb
 - lib/safety_kit/models/client_session_create_session_params.rb
 - lib/safety_kit/models/client_session_create_session_response.rb
+- lib/safety_kit/models/content_create_params.rb
+- lib/safety_kit/models/content_create_response.rb
 - lib/safety_kit/models/data_add_params.rb
 - lib/safety_kit/models/data_add_response.rb
 - lib/safety_kit/models/data_create_upload_url_params.rb
@@ -105,6 +107,7 @@ files:
 - lib/safety_kit/resources/beta.rb
 - lib/safety_kit/resources/beta/events.rb
 - lib/safety_kit/resources/client_sessions.rb
+- lib/safety_kit/resources/content.rb
 - lib/safety_kit/resources/data.rb
 - lib/safety_kit/resources/deletion_requests.rb
 - lib/safety_kit/resources/streams.rb
@@ -139,6 +142,8 @@ files:
 - rbi/safety_kit/models/beta/event_create_response.rbi
 - rbi/safety_kit/models/client_session_create_session_params.rbi
 - rbi/safety_kit/models/client_session_create_session_response.rbi
+- rbi/safety_kit/models/content_create_params.rbi
+- rbi/safety_kit/models/content_create_response.rbi
 - rbi/safety_kit/models/data_add_params.rbi
 - rbi/safety_kit/models/data_add_response.rbi
 - rbi/safety_kit/models/data_create_upload_url_params.rbi
@@ -165,6 +170,7 @@ files:
 - rbi/safety_kit/resources/beta.rbi
 - rbi/safety_kit/resources/beta/events.rbi
 - rbi/safety_kit/resources/client_sessions.rbi
+- rbi/safety_kit/resources/content.rbi
 - rbi/safety_kit/resources/data.rbi
 - rbi/safety_kit/resources/deletion_requests.rbi
 - rbi/safety_kit/resources/streams.rbi
@@ -198,6 +204,8 @@ files:
 - sig/safety_kit/models/beta/event_create_response.rbs
 - sig/safety_kit/models/client_session_create_session_params.rbs
 - sig/safety_kit/models/client_session_create_session_response.rbs
+- sig/safety_kit/models/content_create_params.rbs
+- sig/safety_kit/models/content_create_response.rbs
 - sig/safety_kit/models/data_add_params.rbs
 - sig/safety_kit/models/data_add_response.rbs
 - sig/safety_kit/models/data_create_upload_url_params.rbs
@@ -224,6 +232,7 @@ files:
 - sig/safety_kit/resources/beta.rbs
 - sig/safety_kit/resources/beta/events.rbs
 - sig/safety_kit/resources/client_sessions.rbs
+- sig/safety_kit/resources/content.rbs
 - sig/safety_kit/resources/data.rbs
 - sig/safety_kit/resources/deletion_requests.rbs
 - sig/safety_kit/resources/streams.rbs