safetykit 0.63.0 → 0.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81fa21021d2817ee71454e1a16d72196e480b98e8eb09e0f063fcff447605b2d
-  data.tar.gz: 67b2272041f0e0be992e02b33b86dd59366d555abd50cc8d947f61facc4d972d
+  metadata.gz: 7a3a1b894c949b710e2b5e61a2915834fa2b9873bb5cb535601adf799249c47d
+  data.tar.gz: 9b7272b34376f16f382ef73f49a805bdd436127e22d185d417a97617dc62f341
 SHA512:
-  metadata.gz: 57f7fddc7d40035c8b6fc66541ea9ede92702b15fbb65a1be57456cb9155f0b024dddab69b65edbc3679ad3d3f9d0b2636418577b86fb94264bea5b48204aef9
-  data.tar.gz: d408e395d84ae8d79474b7be876fe09338f057c27ea3fe33f12102defa67204fd284a8b0b87af4df7dd1d861c356839a419228e09af7137b8c402c8c5e1ac5b1
+  metadata.gz: 5a5b3f912481787155ada90dc1d0c9cae11ac2067f2966b1464cdd7e0354f7b4d40480e6f2497a0acc7615580d741001e8cef3ed28c66af24280f0ba326580ea
+  data.tar.gz: a02a32981ebb483000fc384190ba833a530482c68c0baa50986b6eed5de658c17af0b4a9e3525335ca3cbdc9a011f06ba62664bf2756dc9ddd5448452210be1b

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.65.0 (2026-08-21)
+
+Full Changelog: [v0.64.0...v0.65.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.64.0...v0.65.0)
+
+### Features
+
+* **api:** api update ([ed87348](https://github.com/GetSafetyKit/safetykit-ruby/commit/ed87348ea0ce90f0bfe8b29dbfbac8e5a2c7da7c))
+
+## 0.64.0 (2026-08-20)
+
+Full Changelog: [v0.63.0...v0.64.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.63.0...v0.64.0)
+
+### Features
+
+* **api:** api update ([1931e07](https://github.com/GetSafetyKit/safetykit-ruby/commit/1931e07d454e90ef8fd8c67022ed2377e4d86293))
+
 ## 0.63.0 (2026-08-19)
 
 Full Changelog: [v0.62.0...v0.63.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.62.0...v0.63.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.63.0"
+gem "safetykit", "~> 0.65.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/data_get_settings_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#get_settings
+    class DataGetSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #   The namespace to ingest data into
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!method initialize(namespace:, request_options: {})
+      #   @param namespace [String] The namespace to ingest data into
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/safety_kit/models/data_get_settings_response.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#get_settings
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute namespace
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!attribute schema
+      #   The stored schema for this namespace, returned exactly as stored.
+      #
+      #   @return [Hash{Symbol=>Object, nil}]
+      required :schema, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!attribute settings
+      #   The stored namespace settings. Configure with guidance from SafetyKit.
+      #
+      #   @return [Hash{Symbol=>Object, nil}]
+      required :settings, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!attribute version
+      #   The current configuration version, incremented each time the configuration is
+      #   updated through the API or by SafetyKit. Send it as previous_version when
+      #   updating to detect intervening changes.
+      #
+      #   @return [Integer]
+      required :version, Integer
+
+      # @!method initialize(namespace:, schema:, settings:, version:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::DataGetSettingsResponse} for more details.
+      #
+      #   The namespace's stored configuration and its current version.
+      #
+      #   @param namespace [String]
+      #
+      #   @param schema [Hash{Symbol=>Object, nil}] The stored schema for this namespace, returned exactly as stored.
+      #
+      #   @param settings [Hash{Symbol=>Object, nil}] The stored namespace settings. Configure with guidance from SafetyKit.
+      #
+      #   @param version [Integer] The current configuration version, incremented each time the configuration is up
+    end
+  end
+end

data/lib/safety_kit/models/data_update_settings_params.rb

@@ -13,6 +13,15 @@ module SafetyKit
       #   @return [String]
       required :namespace, String
 
+      # @!attribute previous_version
+      #   The version returned by GET (or a prior update). When provided, the update is
+      #   rejected with 409 if the stored configuration has changed since that read, so a
+      #   stale sync cannot overwrite a newer update. Strongly recommended for automated
+      #   schema syncs.
+      #
+      #   @return [Integer, nil]
+      optional :previous_version, Integer
+
       # @!attribute schema
       #   New schema to store for this namespace. Omit to leave the existing schema
       #   unchanged.
@@ -27,12 +36,14 @@ module SafetyKit
       #   @return [Hash{Symbol=>Object, nil}, nil]
       optional :settings, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
 
-      # @!method initialize(namespace:, schema: nil, settings: nil, request_options: {})
+      # @!method initialize(namespace:, previous_version: nil, schema: nil, settings: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::DataUpdateSettingsParams} for more details.
       #
       #   @param namespace [String] The namespace to ingest data into
       #
+      #   @param previous_version [Integer] The version returned by GET (or a prior update). When provided, the update is re
+      #
       #   @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] New schema to store for this namespace. Omit to leave the existing schema unchan
       #
       #   @param settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing

data/lib/safety_kit/models/data_update_settings_response.rb

@@ -14,11 +14,24 @@ module SafetyKit
       #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
       required :status, enum: -> { SafetyKit::Models::DataUpdateSettingsResponse::Status }
 
-      # @!method initialize(namespace:, status:)
+      # @!attribute version
+      #   The configuration version after this update. Send it as previous_version on your
+      #   next update to detect intervening changes.
+      #
+      #   @return [Integer]
+      required :version, Integer
+
+      # @!method initialize(namespace:, status:, version:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::DataUpdateSettingsResponse} for more details.
+      #
       #   Namespace configuration was stored.
       #
       #   @param namespace [String]
+      #
       #   @param status [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
+      #
+      #   @param version [Integer] The configuration version after this update. Send it as previous_version on your
 
       # @see SafetyKit::Models::DataUpdateSettingsResponse#status
       module Status

data/lib/safety_kit/models/stream_add_frame_params.rb

@@ -33,6 +33,9 @@ module SafetyKit
       required :timestamp, Integer
 
       # @!attribute frame_id
+      #   Your identifier for this frame. If a violation is detected, it is echoed back in
+      #   the live_video.violation_detected webhook's frame_id and per-policy frame_ids
+      #   fields.
       #
       #   @return [String, nil]
       optional :frame_id, String
@@ -57,7 +60,7 @@ module SafetyKit
       #
       #   @param timestamp [Integer]
       #
-      #   @param frame_id [String]
+      #   @param frame_id [String] Your identifier for this frame. If a violation is detected, it is echoed back in
       #
       #   @param metadata [Hash{Symbol=>Object, nil}] Arbitrary key-value metadata to associate with this frame, at most 8192 bytes wh
       #

data/lib/safety_kit/models/stream_add_transcript_params.rb

@@ -29,11 +29,17 @@ module SafetyKit
       required :timestamp, Integer
 
       # @!attribute transcript_id
+      #   Your identifier for this transcript segment. If the segment is reviewed
+      #   alongside a detected violation, it is echoed back in the
+      #   live_video.violation_detected webhook's per-policy transcript_ids field.
       #
       #   @return [String, nil]
       optional :transcript_id, String
 
       # @!method initialize(namespace:, stream_id:, text:, timestamp:, transcript_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::StreamAddTranscriptParams} for more details.
+      #
       #   @param namespace [String] The namespace to ingest stream data into
       #
       #   @param stream_id [String]
@@ -42,7 +48,7 @@ module SafetyKit
       #
       #   @param timestamp [Integer]
       #
-      #   @param transcript_id [String]
+      #   @param transcript_id [String] Your identifier for this transcript segment. If the segment is reviewed alongsid
       #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/safety_kit/models.rb

@@ -57,6 +57,8 @@ module SafetyKit
 
   DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   DataObject = SafetyKit::Models::DataObject

data/lib/safety_kit/resources/data.rb

@@ -83,6 +83,28 @@ module SafetyKit
         )
       end
 
+      # Fetch the stored schema, settings, and configuration version for a namespace.
+      # Use the returned version as previous_version when updating so a stale update is
+      # rejected instead of overwriting a newer one.
+      #
+      # @overload get_settings(namespace, request_options: {})
+      #
+      # @param namespace [String] The namespace to ingest data into
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::DataGetSettingsResponse]
+      #
+      # @see SafetyKit::Models::DataGetSettingsParams
+      def get_settings(namespace, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/data/%1$s/settings", namespace],
+          model: SafetyKit::Models::DataGetSettingsResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Retrieve the status of a data ingestion request and, once complete, return
       # processed objects inline. If the processed output exceeds the 5 MiB inline
       # response limit, this endpoint returns an error instructing you to use the
@@ -116,14 +138,16 @@ module SafetyKit
       # Some parameter documentations has been truncated, see
       # {SafetyKit::Models::DataUpdateSettingsParams} for more details.
       #
-      # Update the schema and/or settings for a namespace. Only the fields provided are
-      # updated; omitted fields are left unchanged. Namespaces whose configuration is
+      # Update the schema and/or settings for a namespace. Each is replaced in full when
+      # provided and left unchanged when omitted. Namespaces whose configuration is
       # managed by SafetyKit cannot be updated through this endpoint.
       #
-      # @overload update_settings(namespace, schema: nil, settings: nil, request_options: {})
+      # @overload update_settings(namespace, previous_version: nil, schema: nil, settings: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest data into
       #
+      # @param previous_version [Integer] The version returned by GET (or a prior update). When provided, the update is re
+      #
       # @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] New schema to store for this namespace. Omit to leave the existing schema unchan
       #
       # @param settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing

data/lib/safety_kit/resources/streams.rb

@@ -66,7 +66,7 @@ module SafetyKit
       #
       # @param timestamp [Integer]
       #
-      # @param frame_id [String]
+      # @param frame_id [String] Your identifier for this frame. If a violation is detected, it is echoed back in
       #
       # @param metadata [Hash{Symbol=>Object, nil}] Arbitrary key-value metadata to associate with this frame, at most 8192 bytes wh
       #
@@ -86,6 +86,9 @@ module SafetyKit
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {SafetyKit::Models::StreamAddTranscriptParams} for more details.
+      #
       # Ingest a single transcript segment for a livestream using a relative timestamp
       # in milliseconds. The stream does not need to be created beforehand. Transcript
       # timestamps are relative milliseconds from stream start and should be
@@ -110,7 +113,7 @@ module SafetyKit
       #
       # @param timestamp [Integer]
       #
-      # @param transcript_id [String]
+      # @param transcript_id [String] Your identifier for this transcript segment. If the segment is reviewed alongsid
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/safety_kit/version.rb

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

data/lib/safety_kit.rb

@@ -70,6 +70,8 @@ require_relative "safety_kit/models/data_create_upload_url_params"
 require_relative "safety_kit/models/data_create_upload_url_response"
 require_relative "safety_kit/models/data_get_download_url_params"
 require_relative "safety_kit/models/data_get_download_url_response"
+require_relative "safety_kit/models/data_get_settings_params"
+require_relative "safety_kit/models/data_get_settings_response"
 require_relative "safety_kit/models/data_get_status_params"
 require_relative "safety_kit/models/data_get_status_response"
 require_relative "safety_kit/models/data_object"

data/rbi/safety_kit/models/data_get_settings_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataGetSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SafetyKit::DataGetSettingsParams, SafetyKit::Internal::AnyHash)
+        end
+
+      # The namespace to ingest data into
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      sig do
+        params(
+          namespace: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The namespace to ingest data into
+        namespace:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { namespace: String, request_options: SafetyKit::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/data_get_settings_response.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::DataGetSettingsResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      # The stored schema for this namespace, returned exactly as stored.
+      sig { returns(T::Hash[Symbol, T.nilable(T.anything)]) }
+      attr_accessor :schema
+
+      # The stored namespace settings. Configure with guidance from SafetyKit.
+      sig { returns(T::Hash[Symbol, T.nilable(T.anything)]) }
+      attr_accessor :settings
+
+      # The current configuration version, incremented each time the configuration is
+      # updated through the API or by SafetyKit. Send it as previous_version when
+      # updating to detect intervening changes.
+      sig { returns(Integer) }
+      attr_accessor :version
+
+      # The namespace's stored configuration and its current version.
+      sig do
+        params(
+          namespace: String,
+          schema: T::Hash[Symbol, T.nilable(T.anything)],
+          settings: T::Hash[Symbol, T.nilable(T.anything)],
+          version: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        namespace:,
+        # The stored schema for this namespace, returned exactly as stored.
+        schema:,
+        # The stored namespace settings. Configure with guidance from SafetyKit.
+        settings:,
+        # The current configuration version, incremented each time the configuration is
+        # updated through the API or by SafetyKit. Send it as previous_version when
+        # updating to detect intervening changes.
+        version:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            namespace: String,
+            schema: T::Hash[Symbol, T.nilable(T.anything)],
+            settings: T::Hash[Symbol, T.nilable(T.anything)],
+            version: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/data_update_settings_params.rbi

@@ -18,6 +18,16 @@ module SafetyKit
       sig { returns(String) }
       attr_accessor :namespace
 
+      # The version returned by GET (or a prior update). When provided, the update is
+      # rejected with 409 if the stored configuration has changed since that read, so a
+      # stale sync cannot overwrite a newer update. Strongly recommended for automated
+      # schema syncs.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :previous_version
+
+      sig { params(previous_version: Integer).void }
+      attr_writer :previous_version
+
       # New schema to store for this namespace. Omit to leave the existing schema
       # unchanged.
       sig do
@@ -48,6 +58,7 @@ module SafetyKit
       sig do
         params(
           namespace: String,
+          previous_version: Integer,
           schema:
             T::Hash[
               Symbol,
@@ -60,6 +71,11 @@ module SafetyKit
       def self.new(
         # The namespace to ingest data into
         namespace:,
+        # The version returned by GET (or a prior update). When provided, the update is
+        # rejected with 409 if the stored configuration has changed since that read, so a
+        # stale sync cannot overwrite a newer update. Strongly recommended for automated
+        # schema syncs.
+        previous_version: nil,
         # New schema to store for this namespace. Omit to leave the existing schema
         # unchanged.
         schema: nil,
@@ -74,6 +90,7 @@ module SafetyKit
         override.returns(
           {
             namespace: String,
+            previous_version: Integer,
             schema:
               T::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
             settings: T::Hash[Symbol, T.nilable(T.anything)],

data/rbi/safety_kit/models/data_update_settings_response.rbi

@@ -21,15 +21,27 @@ module SafetyKit
       end
       attr_accessor :status
 
+      # The configuration version after this update. Send it as previous_version on your
+      # next update to detect intervening changes.
+      sig { returns(Integer) }
+      attr_accessor :version
+
       # Namespace configuration was stored.
       sig do
         params(
           namespace: String,
           status:
-            SafetyKit::Models::DataUpdateSettingsResponse::Status::OrSymbol
+            SafetyKit::Models::DataUpdateSettingsResponse::Status::OrSymbol,
+          version: Integer
         ).returns(T.attached_class)
       end
-      def self.new(namespace:, status:)
+      def self.new(
+        namespace:,
+        status:,
+        # The configuration version after this update. Send it as previous_version on your
+        # next update to detect intervening changes.
+        version:
+      )
       end
 
       sig do
@@ -37,7 +49,8 @@ module SafetyKit
           {
             namespace: String,
             status:
-              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol,
+            version: Integer
           }
         )
       end

data/rbi/safety_kit/models/stream_add_frame_params.rbi

@@ -28,6 +28,9 @@ module SafetyKit
       sig { returns(Integer) }
       attr_accessor :timestamp
 
+      # Your identifier for this frame. If a violation is detected, it is echoed back in
+      # the live_video.violation_detected webhook's frame_id and per-policy frame_ids
+      # fields.
       sig { returns(T.nilable(String)) }
       attr_reader :frame_id
 
@@ -64,6 +67,9 @@ module SafetyKit
         image_data_uri:,
         stream_id:,
         timestamp:,
+        # Your identifier for this frame. If a violation is detected, it is echoed back in
+        # the live_video.violation_detected webhook's frame_id and per-policy frame_ids
+        # fields.
         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

data/rbi/safety_kit/models/stream_add_transcript_params.rbi

@@ -27,6 +27,9 @@ module SafetyKit
       sig { returns(Integer) }
       attr_accessor :timestamp
 
+      # Your identifier for this transcript segment. If the segment is reviewed
+      # alongside a detected violation, it is echoed back in the
+      # live_video.violation_detected webhook's per-policy transcript_ids field.
       sig { returns(T.nilable(String)) }
       attr_reader :transcript_id
 
@@ -49,6 +52,9 @@ module SafetyKit
         stream_id:,
         text:,
         timestamp:,
+        # Your identifier for this transcript segment. If the segment is reviewed
+        # alongside a detected violation, it is echoed back in the
+        # live_video.violation_detected webhook's per-policy transcript_ids field.
         transcript_id: nil,
         request_options: {}
       )

data/rbi/safety_kit/models.rbi

@@ -22,6 +22,8 @@ module SafetyKit
 
   DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   DataObject = SafetyKit::Models::DataObject

data/rbi/safety_kit/resources/data.rbi

@@ -62,6 +62,22 @@ module SafetyKit
       )
       end
 
+      # Fetch the stored schema, settings, and configuration version for a namespace.
+      # Use the returned version as previous_version when updating so a stale update is
+      # rejected instead of overwriting a newer one.
+      sig do
+        params(
+          namespace: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::DataGetSettingsResponse)
+      end
+      def get_settings(
+        # The namespace to ingest data into
+        namespace,
+        request_options: {}
+      )
+      end
+
       # Retrieve the status of a data ingestion request and, once complete, return
       # processed objects inline. If the processed output exceeds the 5 MiB inline
       # response limit, this endpoint returns an error instructing you to use the
@@ -82,12 +98,13 @@ module SafetyKit
       )
       end
 
-      # Update the schema and/or settings for a namespace. Only the fields provided are
-      # updated; omitted fields are left unchanged. Namespaces whose configuration is
+      # Update the schema and/or settings for a namespace. Each is replaced in full when
+      # provided and left unchanged when omitted. Namespaces whose configuration is
       # managed by SafetyKit cannot be updated through this endpoint.
       sig do
         params(
           namespace: String,
+          previous_version: Integer,
           schema:
             T::Hash[
               Symbol,
@@ -100,6 +117,11 @@ module SafetyKit
       def update_settings(
         # The namespace to ingest data into
         namespace,
+        # The version returned by GET (or a prior update). When provided, the update is
+        # rejected with 409 if the stored configuration has changed since that read, so a
+        # stale sync cannot overwrite a newer update. Strongly recommended for automated
+        # schema syncs.
+        previous_version: nil,
         # New schema to store for this namespace. Omit to leave the existing schema
         # unchanged.
         schema: nil,

data/rbi/safety_kit/resources/streams.rbi

@@ -65,6 +65,9 @@ module SafetyKit
         image_data_uri:,
         stream_id:,
         timestamp:,
+        # Your identifier for this frame. If a violation is detected, it is echoed back in
+        # the live_video.violation_detected webhook's frame_id and per-policy frame_ids
+        # fields.
         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
@@ -103,6 +106,9 @@ module SafetyKit
         stream_id:,
         text:,
         timestamp:,
+        # Your identifier for this transcript segment. If the segment is reviewed
+        # alongside a detected violation, it is echoed back in the
+        # live_video.violation_detected webhook's per-policy transcript_ids field.
         transcript_id: nil,
         request_options: {}
       )

data/sig/safety_kit/models/data_get_settings_params.rbs

@@ -0,0 +1,23 @@
+module SafetyKit
+  module Models
+    type data_get_settings_params =
+      { namespace: String } & SafetyKit::Internal::Type::request_parameters
+
+    class DataGetSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_accessor namespace: String
+
+      def initialize: (
+        namespace: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        request_options: SafetyKit::RequestOptions
+      }
+    end
+  end
+end

data/sig/safety_kit/models/data_get_settings_response.rbs

@@ -0,0 +1,35 @@
+module SafetyKit
+  module Models
+    type data_get_settings_response =
+      {
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      }
+
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor namespace: String
+
+      attr_accessor schema: ::Hash[Symbol, top?]
+
+      attr_accessor settings: ::Hash[Symbol, top?]
+
+      attr_accessor version: Integer
+
+      def initialize: (
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      }
+    end
+  end
+end

data/sig/safety_kit/models/data_update_settings_params.rbs

@@ -3,6 +3,7 @@ module SafetyKit
     type data_update_settings_params =
       {
         namespace: String,
+        previous_version: Integer,
         schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         settings: ::Hash[Symbol, top?]
       }
@@ -14,6 +15,10 @@ module SafetyKit
 
       attr_accessor namespace: String
 
+      attr_reader previous_version: Integer?
+
+      def previous_version=: (Integer) -> Integer
+
       attr_reader schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]?
 
       def schema=: (
@@ -26,6 +31,7 @@ module SafetyKit
 
       def initialize: (
         namespace: String,
+        ?previous_version: Integer,
         ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         ?settings: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts
@@ -33,6 +39,7 @@ module SafetyKit
 
       def to_hash: -> {
         namespace: String,
+        previous_version: Integer,
         schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         settings: ::Hash[Symbol, top?],
         request_options: SafetyKit::RequestOptions

data/sig/safety_kit/models/data_update_settings_response.rbs

@@ -3,7 +3,8 @@ module SafetyKit
     type data_update_settings_response =
       {
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       }
 
     class DataUpdateSettingsResponse < SafetyKit::Internal::Type::BaseModel
@@ -11,14 +12,18 @@ module SafetyKit
 
       attr_accessor status: SafetyKit::Models::DataUpdateSettingsResponse::status
 
+      attr_accessor version: Integer
+
       def initialize: (
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       ) -> void
 
       def to_hash: -> {
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       }
 
       type status = :updated

data/sig/safety_kit/models.rbs

@@ -17,6 +17,8 @@ module SafetyKit
 
   class DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  class DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   class DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   class DataObject = SafetyKit::Models::DataObject

data/sig/safety_kit/resources/data.rbs

@@ -18,6 +18,11 @@ module SafetyKit
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::DataGetDownloadURLResponse
 
+      def get_settings: (
+        String namespace,
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::DataGetSettingsResponse
+
       def get_status: (
         String request_id,
         namespace: String,
@@ -26,6 +31,7 @@ module SafetyKit
 
       def update_settings: (
         String namespace,
+        ?previous_version: Integer,
         ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         ?settings: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.63.0
+  version: 0.65.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -87,6 +87,8 @@ files:
 - lib/safety_kit/models/data_create_upload_url_response.rb
 - lib/safety_kit/models/data_get_download_url_params.rb
 - lib/safety_kit/models/data_get_download_url_response.rb
+- lib/safety_kit/models/data_get_settings_params.rb
+- lib/safety_kit/models/data_get_settings_response.rb
 - lib/safety_kit/models/data_get_status_params.rb
 - lib/safety_kit/models/data_get_status_response.rb
 - lib/safety_kit/models/data_object.rb
@@ -150,6 +152,8 @@ files:
 - rbi/safety_kit/models/data_create_upload_url_response.rbi
 - rbi/safety_kit/models/data_get_download_url_params.rbi
 - rbi/safety_kit/models/data_get_download_url_response.rbi
+- rbi/safety_kit/models/data_get_settings_params.rbi
+- rbi/safety_kit/models/data_get_settings_response.rbi
 - rbi/safety_kit/models/data_get_status_params.rbi
 - rbi/safety_kit/models/data_get_status_response.rbi
 - rbi/safety_kit/models/data_object.rbi
@@ -212,6 +216,8 @@ files:
 - sig/safety_kit/models/data_create_upload_url_response.rbs
 - sig/safety_kit/models/data_get_download_url_params.rbs
 - sig/safety_kit/models/data_get_download_url_response.rbs
+- sig/safety_kit/models/data_get_settings_params.rbs
+- sig/safety_kit/models/data_get_settings_response.rbs
 - sig/safety_kit/models/data_get_status_params.rbs
 - sig/safety_kit/models/data_get_status_response.rbs
 - sig/safety_kit/models/data_object.rbs