safetykit 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d3e22c6034377a433089f18c5a408d81f894f42a5eeeeaa13cb69bbcac81199
-  data.tar.gz: a70d67b29c010cdf2084fa4947cf01c8892860cc855333b96894a97441bbd95a
+  metadata.gz: 5e0ceaab8746b00a918c7006835419aefcbdff8b6cd50d20567bf907bd0b82e0
+  data.tar.gz: 628d7da1fcd1a8234c98ec4a86e90ae4862dc6e86032d943f181583d804950f2
 SHA512:
-  metadata.gz: 539f52387ecc462d3e88ad6bcbfbeb516ed5dc265590107735d889d1fd363b40f584674917ca971f567bfa5800c0ce9448f359155ff3cf8b91b6955384f47ad9
-  data.tar.gz: f63ac91cf0e2dd7efa4751e1dc761c6c81f4e66189c0a5df8d2c155e3e1de966bf2137d27684aa3a09af15ad78c643782d41a0adfc048bed72e138ffa591eea3
+  metadata.gz: 418e1bcd00e9f805018625bd35b0c44002dbd837adca0bbaaafa3a3982f1186be23fb82f3d9a41c141ceb02f5b2fbdf93810df5985f2102ab71e9db35137191c
+  data.tar.gz: ff08113e45da678d61cd550faad5bd97cc3aa8732ead23e83f72c2b25ef6e1ea4cd70b238859737586b22aeb5596be847206ca886ce33ee65b8ddd372d908b86

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.14.0 (2026-06-03)
+
+Full Changelog: [v0.13.1...v0.14.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.13.1...v0.14.0)
+
+### Features
+
+* **api:** api update ([41de279](https://github.com/GetSafetyKit/safetykit-ruby/commit/41de279191911e02d47b795d2aa4f0f657423c36))
+
 ## 0.13.1 (2026-06-02)
 
 Full Changelog: [v0.13.0...v0.13.1](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.13.0...v0.13.1)

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.13.1"
+gem "safetykit", "~> 0.14.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/agent_decision_create_agent_decision_params.rb

@@ -8,14 +8,13 @@ module SafetyKit
       include SafetyKit::Internal::Type::RequestParameters
 
       # @!attribute content_type
-      #   The dataapi namespace of the content being reviewed
+      #   The SafetyKit data namespace or content type for the content being reviewed
       #
       #   @return [String]
       required :content_type, String
 
       # @!attribute decision
-      #   The human reviewer's verdict on whether the content violates the specified
-      #   policy ('match'/'no_match').
+      #   The human reviewer's verdict for the policy category.
       #
       #   @return [String]
       required :decision, String
@@ -28,37 +27,46 @@ module SafetyKit
       required :policy_id, String
 
       # @!attribute reference_id
-      #   The external id for the content being reviewed
+      #   Stable identifier for the content object in your system
       #
       #   @return [String]
       required :reference_id, String
 
       # @!attribute action
-      #   The correct enforcement action for this content (e.g. 'reduce_visibility',
-      #   'unpublish')
+      #   Optional correct enforcement action for this content, such as
+      #   'reduce_visibility' or 'unpublish'
       #
       #   @return [String, nil]
       optional :action, String
 
+      # @!attribute agent_type
+      #   Optional type of review that produced this decision, such as 'appeal',
+      #   'bpo_review', or 'policy_expert'
+      #
+      #   @return [String, nil]
+      optional :agent_type, String
+
       # @!attribute comment
       #   Additional context or details from the human reviewer
       #
       #   @return [String, nil]
       optional :comment, String, nil?: true
 
-      # @!method initialize(content_type:, decision:, policy_id:, reference_id:, action: nil, comment: nil, request_options: {})
+      # @!method initialize(content_type:, decision:, policy_id:, reference_id:, action: nil, agent_type: nil, comment: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::AgentDecisionCreateAgentDecisionParams} for more details.
       #
-      #   @param content_type [String] The dataapi namespace of the content being reviewed
+      #   @param content_type [String] The SafetyKit data namespace or content type for the content being reviewed
       #
-      #   @param decision [String] The human reviewer's verdict on whether the content violates the specified polic
+      #   @param decision [String] The human reviewer's verdict for the policy category.
       #
       #   @param policy_id [String] The SafetyKit policy category ID that was evaluated, as configured for your acco
       #
-      #   @param reference_id [String] The external id for the content being reviewed
+      #   @param reference_id [String] Stable identifier for the content object in your system
+      #
+      #   @param action [String] Optional correct enforcement action for this content, such as 'reduce_visibility
       #
-      #   @param action [String] The correct enforcement action for this content (e.g. 'reduce_visibility', 'unpu
+      #   @param agent_type [String] Optional type of review that produced this decision, such as 'appeal', 'bpo_revi
       #
       #   @param comment [String, nil] Additional context or details from the human reviewer
       #

data/lib/safety_kit/models/agent_decision_create_agent_decision_response.rb

@@ -5,7 +5,7 @@ module SafetyKit
     # @see SafetyKit::Resources::AgentDecisions#create_agent_decision
     class AgentDecisionCreateAgentDecisionResponse < SafetyKit::Internal::Type::BaseModel
       # @!attribute safetykit_correct
-      #   Whether the SafetyKit decision matched the agent decision
+      #   Whether SafetyKit's decision matched the submitted agent decision
       #
       #   @return [Boolean]
       required :safetykit_correct, SafetyKit::Internal::Type::Boolean, api_name: :safetykitCorrect
@@ -13,7 +13,7 @@ module SafetyKit
       # @!method initialize(safetykit_correct:)
       #   Response confirming the agent decision was recorded
       #
-      #   @param safetykit_correct [Boolean] Whether the SafetyKit decision matched the agent decision
+      #   @param safetykit_correct [Boolean] Whether SafetyKit's decision matched the submitted agent decision
     end
   end
 end

data/lib/safety_kit/resources/agent_decisions.rb

@@ -9,22 +9,24 @@ module SafetyKit
       # {SafetyKit::Models::AgentDecisionCreateAgentDecisionParams} for more details.
       #
       # Record a human reviewer's final verdict for content that SafetyKit has
-      # previously reviewed. This ground truth feedback allows SafetyKit to improve the
-      # accuracy of automated decisions. Each call provides feedback on whether a given
-      # piece of content violates a specific policy category. If content is reviewed for
-      # multiple policies, send one call per policy.
+      # previously reviewed. This feedback lets SafetyKit measure and improve automated
+      # decisions over time. Each request provides feedback for one content object and
+      # one policy category. If a content object is reviewed for multiple policy
+      # categories, send one request per policy category.
       #
-      # @overload create_agent_decision(content_type:, decision:, policy_id:, reference_id:, action: nil, comment: nil, request_options: {})
+      # @overload create_agent_decision(content_type:, decision:, policy_id:, reference_id:, action: nil, agent_type: nil, comment: nil, request_options: {})
       #
-      # @param content_type [String] The dataapi namespace of the content being reviewed
+      # @param content_type [String] The SafetyKit data namespace or content type for the content being reviewed
       #
-      # @param decision [String] The human reviewer's verdict on whether the content violates the specified polic
+      # @param decision [String] The human reviewer's verdict for the policy category.
       #
       # @param policy_id [String] The SafetyKit policy category ID that was evaluated, as configured for your acco
       #
-      # @param reference_id [String] The external id for the content being reviewed
+      # @param reference_id [String] Stable identifier for the content object in your system
       #
-      # @param action [String] The correct enforcement action for this content (e.g. 'reduce_visibility', 'unpu
+      # @param action [String] Optional correct enforcement action for this content, such as 'reduce_visibility
+      #
+      # @param agent_type [String] Optional type of review that produced this decision, such as 'appeal', 'bpo_revi
       #
       # @param comment [String, nil] Additional context or details from the human reviewer
       #

data/lib/safety_kit/version.rb

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

data/rbi/safety_kit/models/agent_decision_create_agent_decision_params.rbi

@@ -14,12 +14,11 @@ module SafetyKit
           )
         end
 
-      # The dataapi namespace of the content being reviewed
+      # The SafetyKit data namespace or content type for the content being reviewed
       sig { returns(String) }
       attr_accessor :content_type
 
-      # The human reviewer's verdict on whether the content violates the specified
-      # policy ('match'/'no_match').
+      # The human reviewer's verdict for the policy category.
       sig { returns(String) }
       attr_accessor :decision
 
@@ -28,18 +27,26 @@ module SafetyKit
       sig { returns(String) }
       attr_accessor :policy_id
 
-      # The external id for the content being reviewed
+      # Stable identifier for the content object in your system
       sig { returns(String) }
       attr_accessor :reference_id
 
-      # The correct enforcement action for this content (e.g. 'reduce_visibility',
-      # 'unpublish')
+      # Optional correct enforcement action for this content, such as
+      # 'reduce_visibility' or 'unpublish'
       sig { returns(T.nilable(String)) }
       attr_reader :action
 
       sig { params(action: String).void }
       attr_writer :action
 
+      # Optional type of review that produced this decision, such as 'appeal',
+      # 'bpo_review', or 'policy_expert'
+      sig { returns(T.nilable(String)) }
+      attr_reader :agent_type
+
+      sig { params(agent_type: String).void }
+      attr_writer :agent_type
+
       # Additional context or details from the human reviewer
       sig { returns(T.nilable(String)) }
       attr_accessor :comment
@@ -51,24 +58,27 @@ module SafetyKit
           policy_id: String,
           reference_id: String,
           action: String,
+          agent_type: String,
           comment: T.nilable(String),
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # The dataapi namespace of the content being reviewed
+        # The SafetyKit data namespace or content type for the content being reviewed
         content_type:,
-        # The human reviewer's verdict on whether the content violates the specified
-        # policy ('match'/'no_match').
+        # The human reviewer's verdict for the policy category.
         decision:,
         # The SafetyKit policy category ID that was evaluated, as configured for your
         # account
         policy_id:,
-        # The external id for the content being reviewed
+        # Stable identifier for the content object in your system
         reference_id:,
-        # The correct enforcement action for this content (e.g. 'reduce_visibility',
-        # 'unpublish')
+        # Optional correct enforcement action for this content, such as
+        # 'reduce_visibility' or 'unpublish'
         action: nil,
+        # Optional type of review that produced this decision, such as 'appeal',
+        # 'bpo_review', or 'policy_expert'
+        agent_type: nil,
         # Additional context or details from the human reviewer
         comment: nil,
         request_options: {}
@@ -83,6 +93,7 @@ module SafetyKit
             policy_id: String,
             reference_id: String,
             action: String,
+            agent_type: String,
             comment: T.nilable(String),
             request_options: SafetyKit::RequestOptions
           }

data/rbi/safety_kit/models/agent_decision_create_agent_decision_response.rbi

@@ -11,14 +11,14 @@ module SafetyKit
           )
         end
 
-      # Whether the SafetyKit decision matched the agent decision
+      # Whether SafetyKit's decision matched the submitted agent decision
       sig { returns(T::Boolean) }
       attr_accessor :safetykit_correct
 
       # Response confirming the agent decision was recorded
       sig { params(safetykit_correct: T::Boolean).returns(T.attached_class) }
       def self.new(
-        # Whether the SafetyKit decision matched the agent decision
+        # Whether SafetyKit's decision matched the submitted agent decision
         safetykit_correct:
       )
       end

data/rbi/safety_kit/resources/agent_decisions.rbi

@@ -6,10 +6,10 @@ module SafetyKit
     # accuracy of SafetyKit's automated decisions over time.
     class AgentDecisions
       # Record a human reviewer's final verdict for content that SafetyKit has
-      # previously reviewed. This ground truth feedback allows SafetyKit to improve the
-      # accuracy of automated decisions. Each call provides feedback on whether a given
-      # piece of content violates a specific policy category. If content is reviewed for
-      # multiple policies, send one call per policy.
+      # previously reviewed. This feedback lets SafetyKit measure and improve automated
+      # decisions over time. Each request provides feedback for one content object and
+      # one policy category. If a content object is reviewed for multiple policy
+      # categories, send one request per policy category.
       sig do
         params(
           content_type: String,
@@ -17,24 +17,27 @@ module SafetyKit
           policy_id: String,
           reference_id: String,
           action: String,
+          agent_type: String,
           comment: T.nilable(String),
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(SafetyKit::Models::AgentDecisionCreateAgentDecisionResponse)
       end
       def create_agent_decision(
-        # The dataapi namespace of the content being reviewed
+        # The SafetyKit data namespace or content type for the content being reviewed
         content_type:,
-        # The human reviewer's verdict on whether the content violates the specified
-        # policy ('match'/'no_match').
+        # The human reviewer's verdict for the policy category.
         decision:,
         # The SafetyKit policy category ID that was evaluated, as configured for your
         # account
         policy_id:,
-        # The external id for the content being reviewed
+        # Stable identifier for the content object in your system
         reference_id:,
-        # The correct enforcement action for this content (e.g. 'reduce_visibility',
-        # 'unpublish')
+        # Optional correct enforcement action for this content, such as
+        # 'reduce_visibility' or 'unpublish'
         action: nil,
+        # Optional type of review that produced this decision, such as 'appeal',
+        # 'bpo_review', or 'policy_expert'
+        agent_type: nil,
         # Additional context or details from the human reviewer
         comment: nil,
         request_options: {}

data/sig/safety_kit/models/agent_decision_create_agent_decision_params.rbs

@@ -7,6 +7,7 @@ module SafetyKit
         policy_id: String,
         reference_id: String,
         action: String,
+        agent_type: String,
         comment: String?
       }
       & SafetyKit::Internal::Type::request_parameters
@@ -27,6 +28,10 @@ module SafetyKit
 
       def action=: (String) -> String
 
+      attr_reader agent_type: String?
+
+      def agent_type=: (String) -> String
+
       attr_accessor comment: String?
 
       def initialize: (
@@ -35,6 +40,7 @@ module SafetyKit
         policy_id: String,
         reference_id: String,
         ?action: String,
+        ?agent_type: String,
         ?comment: String?,
         ?request_options: SafetyKit::request_opts
       ) -> void
@@ -45,6 +51,7 @@ module SafetyKit
         policy_id: String,
         reference_id: String,
         action: String,
+        agent_type: String,
         comment: String?,
         request_options: SafetyKit::RequestOptions
       }

data/sig/safety_kit/resources/agent_decisions.rbs

@@ -7,6 +7,7 @@ module SafetyKit
         policy_id: String,
         reference_id: String,
         ?action: String,
+        ?agent_type: String,
         ?comment: String?,
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::AgentDecisionCreateAgentDecisionResponse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-02 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi