calmlens 0.18.2 → 0.18.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b4f99dcd969ce76160d706032300d1a1a7c0387e57f7cf87b48c44be060bcc7
-  data.tar.gz: 3616af1b33e0c8da7b3dca72aa9a737e413160be42962f58220c918ea8896315
+  metadata.gz: 3c938e439d92c33cdb3117354d680f702856acd600a262b41e221913effd2af9
+  data.tar.gz: a5b8999981f5fa0f5586f6eeaad4f2293011a25673f985622d70a2b7c6e48afd
 SHA512:
-  metadata.gz: 291ccbb5dd86660f0c74867987ceb2f703fdcce5d9eb088ef064761933da68106ab965298adb7978463f7cea158b2e9c4c7e1a0d55e89c27d330ded225c7d76e
-  data.tar.gz: 04a08273729d5859d3a542938edcf3ac0fbac78b6125ef67033a37156339576d61dc11bfb43341ca308fd80a2bff3e4dadf4e70841ebb2f7aaa5ece4f5c5b823
+  metadata.gz: cccc112f1003066fcbb1faa9e7fbcb729be199e70cb8869b632b3f6f50ce71ce67163baf61f88cdbde14f0cfc4c718dd7852a730dc77559c8904c81fecbefeb6
+  data.tar.gz: 1d74c52c7ba36c8a7db31d6647579c698fe27f573a7662bc26108fb2864d647b6ee9453419aa802ef0f3da6f3867b0df563c42b7900e2b672f219d2c257104e9

data/lib/calmlens/version.rb

@@ -2,5 +2,5 @@
 
 module CalmLens
   # The gem version. The gemspec and the User-Agent header read it from here.
-  VERSION = '0.18.2'
+  VERSION = '0.18.3'
 end

data/sig/types.rbs

@@ -139,6 +139,8 @@ module CalmLens
     ?"personDetection" => person_detection_result,
     ?"faceDetection" => face_detection_result,
     ?"linkDetection" => link_detection_result,
+    # Preview. Where the asset's links lead; present when the project's policy acts on links.
+    ?"linkSafety" => link_safety_result,
     ?"aiGeneratedDetection" => ai_generated_detection_result,
     # Where OCR found text, and personal information within it; redaction transforms blur these regions.
     ?"textRegions" => Array[text_region],
@@ -165,6 +167,9 @@ module CalmLens
     "flaggedCategories" => Array[String], "regions" => Array[regional_decision],
     ?"explanationComplete" => bool,
     ?"categories" => Hash[String, category_policy_score],
+    # Preview. What the policy's link-safety section made of the asset's links; absent when the
+    # policy doesn't act on links.
+    ?"linkSafety" => link_safety_decision,
     ?"raw" => moderation_raw
   }
   # ASSET_CONTENT_SCHEMA. `format` is the MIME type.
@@ -300,6 +305,59 @@ module CalmLens
     ?"links" => Array[detected_link],
     ?"reason" => not_evaluated_reason
   }
+  # Link safety (preview, LinkSafety.ts).
+  # What a link's destination is: `safe` when every reputation check passed, `adult` or `gambling`
+  # from its domain's content categories, `phishing` or `malware` from a threat list or the domain's
+  # security risks, and `unresolved` when a short link could not be followed or a check failed.
+  type link_safety_verdict = "safe" | "adult" | "gambling" | "phishing" | "malware" | "unresolved"
+  # The verdicts a policy can act on.
+  type flagged_link_verdict = "phishing" | "malware" | "adult" | "gambling" | "unresolved"
+  # What a link does to its asset, weakest first. Purging content over a link is never offered.
+  type link_safety_action = "allow" | "limit" | "age-restrict" | "block"
+  # One reputation check of a link's destination: its domain's categories, or a threat-list lookup
+  # of the destination URL. `failed` makes the link `unresolved`; `labels` is what the check reported.
+  type link_safety_evidence = {
+    "check" => "domain-categories" | "threat-lists",
+    "status" => "checked" | "failed",
+    "labels" => Array[String]
+  }
+  # A link in the asset and what its destination is. `finalUrl` is where it leads after `redirects`
+  # redirects, or `null` when a short link could not be followed.
+  type checked_link = {
+    "url" => String,
+    "finalUrl" => String?,
+    "redirects" => Integer,
+    "source" => "qr-code" | "text",
+    "verdict" => link_safety_verdict,
+    "evidence" => Array[link_safety_evidence]
+  }
+  # Preview. `status: "evaluated"` carries `links`; `"not-evaluated"` carries `reason`.
+  type link_safety_result = {
+    "status" => "evaluated" | "not-evaluated",
+    "stage" => processing_feature_stage,
+    ?"links" => Array[checked_link],
+    ?"reason" => not_evaluated_reason
+  }
+  # Preview. LINK_SAFETY_SETTINGS_SCHEMA: the action for an asset with a link of each verdict (a
+  # verdict left out is allowed), and optionally an action for every link whose destination is
+  # outside `allowedDomains` (bare lowercase domains, which also cover their subdomains).
+  type link_safety_settings = {
+    "verdictActions" => {
+      ?"phishing" => link_safety_action,
+      ?"malware" => link_safety_action,
+      ?"adult" => link_safety_action,
+      ?"gambling" => link_safety_action,
+      ?"unresolved" => link_safety_action
+    },
+    ?"offPlatformLinks" => { "action" => "limit" | "age-restrict" | "block", "allowedDomains" => Array[String] }
+  }
+  # Preview. The strongest action the asset's links take, the indexes into
+  # `classification.linkSafety.links` of the links that take it, and the settings in force.
+  type link_safety_decision = {
+    "action" => link_safety_action,
+    "links" => Array[Integer],
+    "settings" => link_safety_settings
+  }
   type provenance_signal = { "kind" => "c2pa" | "iptc-digital-source-type" | "generator-metadata", "value" => String }
   # `status: "evaluated"` carries `provenance` and `signals`; `"not-evaluated"` carries `reason`.
   type ai_generated_detection_result = {
@@ -317,6 +375,7 @@ module CalmLens
     ?"personDetection" => person_detection_result,
     ?"faceDetection" => face_detection_result,
     ?"linkDetection" => link_detection_result,
+    ?"linkSafety" => link_safety_result,
     ?"aiGeneratedDetection" => ai_generated_detection_result
   }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: calmlens
 version: !ruby/object:Gem::Version
-  version: 0.18.2
+  version: 0.18.3
 platform: ruby
 authors:
 - CalmLens