calmlens 0.1.0 → 0.17.1

data/sig/types.rbs

@@ -20,53 +20,73 @@ module CalmLens
     ?idempotency_key: String,
     ?timeout: number,
     ?open_timeout: number,
-    ?max_retries: Integer
+    ?upload_timeout: number,
+    ?max_retries: Integer,
+    ?max_response_bytes: Integer
   }
 
   # ---- Assets (Asset.ts) ----------------------------------------------------------------------
 
   # Where the asset is in the pipeline.
-  type asset_processing_status = "uploading" | "processing" | "done" | "failed"
-  # The moderation decision in force: a reviewer's when there is one, else the automated one.
-  type asset_moderation_status = "pending" | "approved" | "rejected"
-  # What the policy did with flagged content (never `ignore`, unlike `flagged_content_action`).
-  type asset_moderation_action = "alert" | "hide" | "purge"
-  type asset_reviewer_action = "approved" | "rejected"
+  type asset_classification_status = "pending" | "processing" | "completed" | "failed"
+  # A moderation decision, which also decides delivery: served to anyone with access (`allowed`),
+  # served like `allowed` but marked so your app reduces its reach (`limited`), only through signed
+  # URLs or API keys (`age-restricted`), not served (`blocked`), or not served with the stored
+  # content deleted (`purged`).
+  type asset_moderation_decision = "allowed" | "limited" | "age-restricted" | "blocked" | "purged"
+  # The decision in force: `pending` until classification decides, then a reviewer's decision when
+  # there is one, else the policy's.
+  type asset_moderation_status = "pending" | asset_moderation_decision
   # Whether CalmLens holds the content: only until processing finishes, retained, or deleted.
   type asset_content_status = "temporary" | "stored" | "removed"
   type asset_content_removal_reason = "policy" | "retention" | "requested" | "parent-removed" | "disposed"
+  # Why processing failed, while the classification status is `failed`.
+  type asset_classification_failure_reason = "file-too-large" | "duration-limit" | "resolution-limit" | "unsupported-format" | "undecodable-content" | "multiple-tracks" | "type-mismatch" | "free-upload-limit" | "child-failed" | "processing-error"
   type asset_type = "image" | "video" | "audio" | "plaintext-document" | "multimedia-document" | "website" | "file"
   type asset_visibility = "public" | "private"
-  # FLAGGED_CONTENT_ACTION_SCHEMA in Project.ts.
-  type flagged_content_action = "ignore" | "alert" | "hide" | "purge"
+  # FLAGGED_CONTENT_ACTION_SCHEMA in PolicyRule.ts.
+  type flagged_content_action = "allow" | "limit" | "age-restrict" | "block" | "purge"
 
   # A custom metadata item. `value` is any JSON value you chose.
   type metadata_item = { "id" => String, "value" => json_value }
   # A metadata item to send. Keys inside `metadata` are sent unchanged, so use `id:` and `value:`.
   type metadata_item_input = { id: String, value: json_input }
+  # An earlier post in the conversation, as the API returns it.
+  type moderation_context_item = { "text" => String, ?"authorId" => String }
+  # Earlier posts in the conversation, oldest first.
+  type moderation_context = { "items" => Array[moderation_context_item] }
+  # An earlier post to send. `author_id` is your identifier for who wrote it.
+  type moderation_context_item_input = { text: String, ?author_id: String }
+  # Earlier posts to send, oldest first; only the posts CalmLens uses are sent.
+  type moderation_context_input = { items: Array[moderation_context_item_input] }
 
   # ProcessingFeatures.ts: optional analyses to run, keyed by feature. Every feature is off unless
   # `enabled` is true.
   type processing_features_input = {
     ?ocr: { enabled: bool }?,
     ?person_detection: { enabled: bool }?,
-    ?face_detection: { enabled: bool, ?age_estimation: bool }?
+    ?face_detection: { enabled: bool, ?age_estimation: bool }?,
+    ?link_detection: { enabled: bool }?
   }
   type processing_options_input = {
     ?keep_content_after_processing: bool?,
-    ?flagged_content_policy: { action: flagged_content_action }?,
+    # Overrides the project's `storeSensitiveMetadata` setting: false removes embedded EXIF, XMP and
+    # IPTC metadata before the image is stored; true stores it as uploaded.
+    ?store_sensitive_metadata: bool?,
     ?features: processing_features_input?
   }
 
   type processing_features = {
     ?"ocr" => { "enabled" => bool }?,
     ?"personDetection" => { "enabled" => bool }?,
-    ?"faceDetection" => { "enabled" => bool, ?"ageEstimation" => bool }?
+    ?"faceDetection" => { "enabled" => bool, ?"ageEstimation" => bool }?,
+    ?"linkDetection" => { "enabled" => bool }?,
+    ?"aiGeneratedDetection" => { "enabled" => bool }?
   }
   # The processing options an asset was uploaded with.
   type processing_options = {
     ?"keepContentAfterProcessing" => bool?,
-    ?"flaggedContentPolicy" => { "action" => flagged_content_action }?,
+    ?"storeSensitiveMetadata" => bool?,
     ?"features" => processing_features?
   }
 
@@ -77,37 +97,75 @@ module CalmLens
     ?"sha384" => String?,
     ?"sha512" => String?
   }
-  type image_data = { ?"perceptualHash" => String?, ?"width" => Integer?, ?"height" => Integer? }
-  type preview_image = {
-    "fileFormat" => String?,
+  # The picture served at the rendered resource; it remains after the content is removed.
+  type asset_image = {
+    "width" => Integer?,
+    "height" => Integer?,
     "thumbhash" => String?,
     "averageColor" => String?,
-    "width" => Integer?,
-    "height" => Integer?
+    "perceptualHash" => String?,
+    # How much detail `perceptualHash` captured, from 0 to 100; hashes below 50 match unrelated pictures.
+    "perceptualHashQuality" => Integer?
   }
   type safety_hold = { "placedAt" => Integer, "reason" => "suspected-illegal-content", ?"disposedAt" => Integer? }
   # `type: "string"` carries the text in `content`; `type: "document"` stores it under `id`.
   type extracted_text = { "type" => "string" | "document", ?"content" => String, ?"id" => String }
-
-  # ASSET_PROCESSING_SCHEMA. Epoch times are milliseconds.
-  type asset_processing = {
-    "status" => asset_processing_status,
+  # Descriptive metadata embedded in an uploaded image. `capturedAt` is ISO 8601, with a UTC offset
+  # only when the file records one. `digitalSourceType` is the IPTC code the file declares, such as
+  # `digitalCapture`. `containsLocation` says whether the uploaded file embedded GPS coordinates;
+  # `creator` and `location` are sensitive and recorded only when `storeSensitiveMetadata` is on.
+  type file_metadata_location = { "latitude" => number, "longitude" => number }
+  type file_metadata = {
+    "capturedAt" => String?,
+    "cameraMake" => String?,
+    "cameraModel" => String?,
+    "lensModel" => String?,
+    "software" => String?,
+    "creator" => String?,
+    "copyright" => String?,
+    "digitalSourceType" => String?,
+    "containsLocation" => bool,
+    "location" => file_metadata_location?
+  }
+
+  type asset_upload = { "status" => "uploading" | "completed", "updatedAt" => Integer?, "partsReceived" => Integer? }
+  type asset_classification = {
+    "status" => asset_classification_status,
+    # `null` unless `status` is `failed`.
+    "failureReason" => asset_classification_failure_reason?,
     "updatedAt" => Integer?,
-    # Parts of a multipart upload received so far; null otherwise.
-    "uploadPartsReceived" => Integer?
+    "completedAt" => Integer?,
+    "moderation" => asset_moderation,
+    ?"personDetection" => person_detection_result,
+    ?"faceDetection" => face_detection_result,
+    ?"linkDetection" => link_detection_result,
+    ?"aiGeneratedDetection" => ai_generated_detection_result,
+    # Where OCR found text, and personal information within it; redaction transforms blur these regions.
+    ?"textRegions" => Array[text_region],
+    ?"labels" => Array[classification_label]?
+  }
+  type asset_review = {
+    "id" => String,
+    "decision" => asset_moderation_decision,
+    "note" => String?,
+    ?"reviewerName" => String?,
+    ?"reviewerEmail" => String?,
+    "reviewedAt" => Integer,
+    "appliedToAsset" => bool
   }
-  # ASSET_MODERATION_SCHEMA. `action` is kept after a reviewer decides.
+  type regional_decision = { "region" => String, "action" => String, "rule" => String, ?"category" => String }
+  type test_regional_action = { "region" => String, "action" => String }
   type asset_moderation = {
+    ?"testCategoryActions" => Hash[String, String],
+    ?"testRegionalActions" => Array[test_regional_action],
+    "manualReviews" => Array[asset_review],
     "status" => asset_moderation_status,
-    "action" => asset_moderation_action?,
-    # Why automated moderation rejected the asset.
-    "note" => String?,
-    "reviewerAction" => asset_reviewer_action?,
-    "reviewerNote" => String?,
-    "reviewerUserId" => String?,
-    "reviewedAt" => Integer?,
-    "decidedAt" => Integer?,
-    "report" => classification_report?
+    ?"automatedAction" => flagged_content_action,
+    ?"source" => String, ?"rule" => String,
+    "flaggedCategories" => Array[String], "regions" => Array[regional_decision],
+    ?"explanationComplete" => bool,
+    ?"categories" => Hash[String, category_policy_score],
+    ?"raw" => moderation_raw
   }
   # ASSET_CONTENT_SCHEMA. `format` is the MIME type.
   type asset_content = {
@@ -119,15 +177,16 @@ module CalmLens
     "extension" => String?,
     "sizeInBytes" => Integer?,
     "checksums" => checksums?,
-    "image" => image_data?,
-    "previewImage" => preview_image?,
-    "extractedText" => extracted_text?
+    "image" => asset_image?,
+    "extractedText" => extracted_text?,
+    # Metadata embedded in an uploaded image; `null` when it declares none, for other asset types,
+    # once the content is removed and while the asset is held.
+    "fileMetadata" => file_metadata?
   }
 
   type asset = {
     "id" => String,
     "projectId" => String,
-    ?"userId" => String?,
     ?"parentId" => String?,
     ?"folderId" => String?,
     ?"uploadPresetId" => String?,
@@ -139,11 +198,14 @@ module CalmLens
     ?"externalUrl" => String?,
     "type" => asset_type,
     ?"metadata" => Array[metadata_item]?,
+    ?"authorId" => String?,
+    # The earlier posts CalmLens used; null once the content is removed.
+    ?"context" => moderation_context?,
     ?"tags" => Array[String]?,
     ?"processingOptions" => processing_options?,
     ?"visibility" => asset_visibility?,
-    "processing" => asset_processing,
-    "moderation" => asset_moderation,
+    "upload" => asset_upload,
+    "classification" => asset_classification,
     "content" => asset_content
   }
 
@@ -163,69 +225,18 @@ module CalmLens
     ?"likelihood" => likelihood,
     ?"reason" => not_evaluated_reason
   }
-  # MODERATION_QUALIFIERS in ModerationPolicyDimensions.ts.
-  type qualifier_results = {
-    ?"sexual-nudity" => qualifier_result,
-    ?"sexual-activity" => qualifier_result,
-    ?"sexual-explicit-language" => qualifier_result,
-    ?"sexual-solicitation" => qualifier_result,
-    ?"sexual-historical" => qualifier_result,
-    ?"sexual-documentary" => qualifier_result,
-    ?"sexual-educational" => qualifier_result,
-    ?"sexual-fictional" => qualifier_result,
-    ?"sexual-support-prevention" => qualifier_result,
-    ?"violence-attack" => qualifier_result,
-    ?"violence-threat" => qualifier_result,
-    ?"violence-preparation" => qualifier_result,
-    ?"violence-encouragement" => qualifier_result,
-    ?"violence-injury" => qualifier_result,
-    ?"violence-violent-death" => qualifier_result,
-    ?"violence-natural-death" => qualifier_result,
-    ?"violence-graphic" => qualifier_result,
-    ?"violence-historical" => qualifier_result,
-    ?"violence-documentary" => qualifier_result,
-    ?"violence-educational" => qualifier_result,
-    ?"violence-fictional" => qualifier_result,
-    ?"violence-support-prevention" => qualifier_result,
-    ?"self-harm-thoughts" => qualifier_result,
-    ?"self-harm-preparation" => qualifier_result,
-    ?"self-harm-act" => qualifier_result,
-    ?"self-harm-methods" => qualifier_result,
-    ?"self-harm-encouragement" => qualifier_result,
-    ?"self-harm-documentary" => qualifier_result,
-    ?"self-harm-educational" => qualifier_result,
-    ?"self-harm-fictional" => qualifier_result,
-    ?"self-harm-support-prevention" => qualifier_result,
-    ?"harassment-abuse" => qualifier_result,
-    ?"harassment-intimidation" => qualifier_result,
-    ?"harassment-threat" => qualifier_result,
-    ?"harassment-sexual" => qualifier_result,
-    ?"harassment-encouragement" => qualifier_result,
-    ?"harassment-fictional" => qualifier_result,
-    ?"hate-abuse" => qualifier_result,
-    ?"hate-dehumanization" => qualifier_result,
-    ?"hate-inferiority" => qualifier_result,
-    ?"hate-exclusion" => qualifier_result,
-    ?"hate-threat" => qualifier_result,
-    ?"hate-historical" => qualifier_result,
-    ?"hate-fictional" => qualifier_result,
-    ?"criminal-activity-demonstration" => qualifier_result,
-    ?"criminal-activity-preparation" => qualifier_result,
-    ?"criminal-activity-request" => qualifier_result,
-    ?"criminal-activity-instructions" => qualifier_result,
-    ?"criminal-activity-promotion" => qualifier_result,
-    ?"criminal-activity-substances" => qualifier_result,
-    ?"criminal-activity-fraud" => qualifier_result,
-    ?"criminal-activity-fictional" => qualifier_result
-  }
+  # qualifier_results is generated in qualifiers.rbs.
+
   # `status: "evaluated"` or `"partial"` carries `likelihood` and `score`; `"not-evaluated"`
   # carries `reason`.
+  type policy_condition_result = { "status" => "evaluated" | "not-evaluated", ?"score" => number, ?"reason" => not_evaluated_reason }
   type category_report = {
     "status" => "evaluated" | "partial" | "not-evaluated",
     ?"likelihood" => likelihood,
     ?"score" => number,
     ?"reason" => not_evaluated_reason,
-    ?"qualifiers" => qualifier_results
+    ?"qualifiers" => qualifier_results,
+    ?"policyConditions" => Hash[String, policy_condition_result]
   }
   type classification_categories = {
     "sexual" => category_report,
@@ -233,7 +244,9 @@ module CalmLens
     "self-harm" => category_report,
     "harassment" => category_report,
     "hate" => category_report,
-    "criminal-activity" => category_report
+    "criminal-activity" => category_report,
+    "personal-information" => category_report,
+    "profanity" => category_report
   }
   type classification_label = {
     "description" => String,
@@ -276,33 +289,60 @@ module CalmLens
     ?"faces" => Array[detected_face],
     ?"reason" => not_evaluated_reason
   }
-  # Results of the features requested in `processingOptions.features`. OCR produces a text child
+  type detected_qr_code = { "value" => String, "box" => bounding_box }
+  # A web link found in a QR code or in the text OCR extracted.
+  type detected_link = { "url" => String, "source" => "qr-code" | "text" }
+  # `status: "evaluated"` carries `qrCodes` and `links`; `"not-evaluated"` carries `reason`.
+  type link_detection_result = {
+    "status" => "evaluated" | "not-evaluated",
+    "stage" => processing_feature_stage,
+    ?"qrCodes" => Array[detected_qr_code],
+    ?"links" => Array[detected_link],
+    ?"reason" => not_evaluated_reason
+  }
+  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 = {
+    "status" => "evaluated" | "not-evaluated",
+    "stage" => processing_feature_stage,
+    ?"provenance" => "ai-generated" | "ai-edited" | "unknown",
+    ?"signals" => Array[provenance_signal],
+    ?"reason" => not_evaluated_reason
+  }
+  # Where OCR found text in an image, and whether it is personal information.
+  type text_region = { "box" => bounding_box, "personalInformation" => bool }
+  # Results of the features requested in `processingOptions.features`. OCR stores extracted text on the image
   # asset instead of a result here.
   type processing_feature_results = {
     ?"personDetection" => person_detection_result,
-    ?"faceDetection" => face_detection_result
+    ?"faceDetection" => face_detection_result,
+    ?"linkDetection" => link_detection_result,
+    ?"aiGeneratedDetection" => ai_generated_detection_result
   }
 
   # How strongly each assessed category meets the policy and what the policy does with it.
-  type report_policy = {
-    "score" => number,
-    "categories" => Hash[String, { "score" => number, "action" => String }]
+  type policy_rule_snapshot = {
+    "when" => Array[String], "action" => flagged_content_action,
+    ?"name" => String, ?"match" => "all", ?"unless" => Array[String]
   }
-
-  type classification_report = {
-    "processedAt" => Integer,
+  type category_policy_source = { "kind" => String, ?"index" => Integer, ?"indexes" => Array[Integer] }
+  type category_policy_settings_snapshot = {
+    "categoryAction" => flagged_content_action,
+    "allowances" => Array[policy_rule_snapshot], "restrictions" => Array[policy_rule_snapshot]
+  }
+  type category_policy_score = {
+    "score" => number, "action" => flagged_content_action,
+    ?"source" => category_policy_source, ?"settings" => category_policy_settings_snapshot
+  }
+  type moderation_raw = {
     "categories" => classification_categories,
-    "score" => number,
-    ?"notes" => String?,
-    ?"media" => media_report,
-    ?"labels" => Array[classification_label]?,
-    ?"features" => processing_feature_results,
-    ?"policy" => report_policy
+    ?"timeline" => media_report,
+    ?"hashMatches" => Array[hash_match]
   }
 
   # ---- Pages and search (Page.ts, AssetSearch.ts) --------------------------------------------
 
-  type order_direction = "ASC" | "DESC"
+  type order_direction = "asc" | "desc"
   type order_input = { field: String, direction: order_direction }
   type order = { "field" => String, "direction" => order_direction }
 
@@ -316,7 +356,7 @@ module CalmLens
 
   type asset_search_mode = "keyword" | "semantic" | "hybrid"
   type asset_search_match_field = "name" | "id" | "externalId" | "description" | "tags" | "type" | "content.format" |
-                                  "content.extension" | "moderation.status" | "visual" | "transcript"
+                                  "content.extension" | "classification.moderation.status" | "visual" | "transcript"
   type asset_search_result = { "asset" => asset, "score" => number, "matchedFields" => Array[asset_search_match_field] }
   type asset_search_response = {
     "query" => String,
@@ -324,30 +364,51 @@ module CalmLens
     "semanticStatus" => "disabled" | "ready" | "indexing" | "unavailable"
   }
 
+  type asset_batch_operation = "delete" | "remove-content"
+  type batch_assets_response = { "queued" => bool }
   type signed_url = { "url" => String, "expiresAt" => Integer }
 
   # ---- Transforms and lenses (AssetTransform.ts, Lens.ts) -------------------------------------
 
+  # <generated: image-transform-options>
+  # Generated by packages/sdk-contract/generate.ts from IMAGE_TRANSFORM_OPTIONS_SCHEMA; do not edit.
   type image_format = "jpg" | "png" | "webp" | "avif" | "gif"
+  type image_quality_level = "low" | "medium" | "high"
   type image_fit = "scale-down" | "contain" | "pad" | "squeeze" | "cover" | "crop"
+  type image_flip = "h" | "v" | "hv"
+  type image_segment = "foreground"
   type image_gravity_side = "face" | "left" | "right" | "top" | "bottom" | "center" | "auto" | "entropy"
+  type image_gravity_mode = "remainder" | "box-center"
 
   # IMAGE_TRANSFORM_OPTIONS_SCHEMA, as options to send.
   type image_transform_options_input = {
     ?format: image_format,
     ?width: Integer,
     ?height: Integer,
+    ?dpr: number,
+    ?anim: bool,
     ?background: String,
     ?blur: number,
-    ?border: { ?color: String, ?width: number },
+    ?redact: {
+      ?text: bool,
+      ?personalInformation: bool
+    },
+    ?border: {
+      ?color: String,
+      ?width: number
+    },
     ?brightness: number,
     ?contrast: number,
-    ?quality: Integer,
+    ?quality: Integer | image_quality_level,
     ?fit: image_fit,
-    ?flip: "h" | "v" | "hv",
+    ?flip: image_flip,
     ?gamma: number,
-    ?segment: "foreground",
-    ?gravity: image_gravity_side | { mode: "remainder" | "box-center", ?x: number, ?y: number },
+    ?segment: image_segment,
+    ?gravity: image_gravity_side | {
+      mode: image_gravity_mode,
+      ?x: number,
+      ?y: number
+    },
     ?rotate: 0 | 90 | 180 | 270,
     ?saturation: number,
     ?sharpen: number,
@@ -358,7 +419,11 @@ module CalmLens
       ?right: number,
       ?width: number,
       ?height: number,
-      ?border: bool | { ?color: String, ?tolerance: number, ?keep: number }
+      ?border: bool | {
+        ?color: String,
+        ?tolerance: number,
+        ?keep: number
+      }
     }
   }
   # IMAGE_TRANSFORM_OPTIONS_SCHEMA, as the API returns it in a lens.
@@ -366,17 +431,30 @@ module CalmLens
     ?"format" => image_format,
     ?"width" => Integer,
     ?"height" => Integer,
+    ?"dpr" => number,
+    ?"anim" => bool,
     ?"background" => String,
     ?"blur" => number,
-    ?"border" => { ?"color" => String, ?"width" => number },
+    ?"redact" => {
+      ?"text" => bool,
+      ?"personalInformation" => bool
+    },
+    ?"border" => {
+      ?"color" => String,
+      ?"width" => number
+    },
     ?"brightness" => number,
     ?"contrast" => number,
-    ?"quality" => Integer,
+    ?"quality" => Integer | image_quality_level,
     ?"fit" => image_fit,
-    ?"flip" => "h" | "v" | "hv",
+    ?"flip" => image_flip,
     ?"gamma" => number,
-    ?"segment" => "foreground",
-    ?"gravity" => image_gravity_side | { "mode" => "remainder" | "box-center", ?"x" => number, ?"y" => number },
+    ?"segment" => image_segment,
+    ?"gravity" => image_gravity_side | {
+      "mode" => image_gravity_mode,
+      ?"x" => number,
+      ?"y" => number
+    },
     ?"rotate" => 0 | 90 | 180 | 270,
     ?"saturation" => number,
     ?"sharpen" => number,
@@ -387,15 +465,20 @@ module CalmLens
       ?"right" => number,
       ?"width" => number,
       ?"height" => number,
-      ?"border" => bool | { ?"color" => String, ?"tolerance" => number, ?"keep" => number }
+      ?"border" => bool | {
+        ?"color" => String,
+        ?"tolerance" => number,
+        ?"keep" => number
+      }
     }
   }
+  # </generated: image-transform-options>
 
   # One structured transform step. `imageTransform` is the only transform type.
   type transform_step_input = { type: "imageTransform", ?options: image_transform_options_input }
   type transform_step = { "type" => "imageTransform", ?"options" => image_transform_options }
-  # A selector String such as `imageTransform[format=png,width=1024]`, or structured steps, which
-  # the SDK serializes into a selector.
+  # A selector String with one step per path segment, such as `fit=cover,width=1024/blur=12`, or
+  # structured steps, which the SDK serializes into a selector.
   type transform_input = String | transform_step_input | Array[transform_step_input]
 
   type lens_type = "image" | "video" | "audio" | "document" | "website"
@@ -412,7 +495,6 @@ module CalmLens
   type lens = {
     "id" => String,
     ?"projectId" => String?,
-    ?"userId" => String?,
     "version" => Integer,
     "identifier" => String,
     "name" => String,
@@ -435,13 +517,56 @@ module CalmLens
     ?"updatedAt" => Integer
   }
 
+  # ---- Hash lists (HashList.ts) ----------------------------------------------------------------
+
+  type hash_list_action = "flag" | "block"
+
+  type hash_list = {
+    "id" => String,
+    "projectId" => String,
+    "name" => String,
+    ?"description" => String?,
+    "action" => hash_list_action,
+    "createdAt" => Integer,
+    ?"updatedAt" => Integer
+  }
+
+  # A hash list entry an image matched. `distance` is the number of differing bits (0 is the same
+  # picture); `action` is `block` when the match was close enough for a block list to block.
+  type hash_match = {
+    "source" => "hash-list",
+    "listId" => String,
+    "entryId" => String,
+    "distance" => Integer,
+    "action" => hash_list_action
+  }
+
+  type hash_list_entry = {
+    "id" => String,
+    "projectId" => String,
+    "hashListId" => String,
+    "hash" => String,
+    "quality" => number?,
+    ?"label" => String?,
+    ?"sourceAssetId" => String?,
+    "createdAt" => Integer
+  }
+
+  type hash_list_entry_page = {
+    "items" => Array[hash_list_entry],
+    "hasMore" => bool,
+    "nextCursor" => String?,
+    "pageSize" => Integer,
+    "ordering" => Array[order]
+  }
+
   # ---- Events and webhooks (Event.ts, EventCatalog.ts, WebhookPayload.ts) ----------------------
 
   # EVENT_TYPES in EventCatalog.ts. Ignore types your code does not handle. Webhook, Slack and email
   # deliveries and the public events feed leave out facts that hold personal or account data.
-  type event_type = "asset.uploaded" | "asset.flagged" | "asset.approved" | "asset.rejected" |
-                    "asset.failed" | "asset.deleted" | "asset.content-removed" | "asset.retried" |
-                    "asset.review-requested" | "usage.limit-reached" | "usage.spend-limit-reached" |
+  type event_type = "asset.uploaded" | "asset.classified" | "asset.allowed" | "asset.limited" |
+                    "asset.age-restricted" | "asset.blocked" | "asset.purged" | "asset.failed" | "asset.deleted" | "asset.content-removed" | "asset.retried" |
+                    "asset.review-requested" | "asset.hash-matched" | "usage.limit-reached" | "usage.spend-limit-reached" |
                     "upload-preset.daily-limit-reached" | "project.member-joined" | "project.member-removed" |
                     "project.member-role-changed" | "project.invitation-sent" | "api-key.created" |
                     "api-key.revoked" | "connector.failing" | "appeal.submitted" | "appeal.resolved"
@@ -457,41 +582,31 @@ module CalmLens
   # Snapshot of the asset's processing, moderation and content status when the event was created.
   type event_asset = {
     "id" => String,
+    ?"uploadPresetId" => String?,
     ?"externalId" => String?,
-    "processing" => { "status" => asset_processing_status },
-    "moderation" => { "status" => asset_moderation_status, "action" => asset_moderation_action? },
+    "upload" => { "status" => "uploading" | "completed" },
+    "classification" => { "status" => asset_classification_status, "moderation" => { "status" => asset_moderation_status } },
     "content" => { "status" => asset_content_status }
   }
+  # An `events.list` item, and the body of its webhook delivery.
   type event = {
     "id" => String,
     "projectId" => String,
-    ?"userId" => String?,
     "type" => event_type,
     "severity" => event_severity,
     "title" => String,
-    ?"description" => String?,
-    ?"assetId" => String?,
-    ?"asset" => event_asset?,
+    "description" => String?,
+    "assetId" => String?,
+    "asset" => event_asset?,
     "facts" => Array[event_fact],
-    ?"notify" => bool?,
-    "createdAt" => Integer,
-    ?"updatedAt" => Integer,
-    ?"readAt" => Integer?
-  }
-  type events_page = { "events" => Array[event], "cursor" => String, "hasMore" => bool }
-
-  # WEBHOOK_EVENT_DATA_SCHEMA: the event fields a webhook delivery carries under `data`.
-  type webhook_event_data = {
-    "severity" => event_severity,
-    "title" => String,
-    ?"description" => String?,
-    ?"assetId" => String?,
-    ?"asset" => event_asset?,
-    "facts" => Array[event_fact]
+    "createdAt" => Integer
   }
+  # Unlike other lists, `nextCursor` is never nil: keep it to receive later events.
+  type events_page = { "items" => Array[event], "nextCursor" => String, "hasMore" => bool }
 
   # ---- Method options -------------------------------------------------------------------------
 
+  type viewer_claims = { ?region: String, ?age_confirmed: bool }
   type asset_id_options = { asset_id: String, ?request_options: request_options }
   # `timeout` is the whole wait in seconds (default 60).
   type wait_for_decision_options = { asset_id: String, ?timeout: number, ?request_options: request_options }
@@ -506,7 +621,7 @@ module CalmLens
     ?cursor: String,
     ?page_size: Integer,
     ?ordering: Array[order_input],
-    # An RSQL filter such as `moderation.status==approved`.
+    # An RSQL filter such as `classification.moderation.status==allowed`.
     ?filter: String?,
     ?folder_id: String?,
     ?request_options: request_options
@@ -529,10 +644,22 @@ module CalmLens
     ?visibility: asset_visibility?,
     ?request_options: request_options
   }
+  type batch_assets_options = { asset_ids: Array[String], operation: asset_batch_operation, ?request_options: request_options }
   type move_asset_options = { asset_id: String, folder_id: String?, ?request_options: request_options }
+  type explain_asset_options = { asset_id: String, ?rerun: bool, ?request_options: request_options }
+  # A reviewer's decision. `note` is 1 to 1499 characters; purging also needs `confirm_purge: true`.
+  type decide_asset_options = {
+    asset_id: String,
+    decision: "allowed" | "limited" | "age-restricted" | "blocked" | "purged",
+    note: String,
+    ?confirm_purge: bool,
+    ?request_options: request_options
+  }
   type create_signed_url_options = {
+    ?viewer_claims: viewer_claims,
     asset_id: String,
-    ?resource: "content" | "preview",
+    # Defaults to `rendered` on the server; `original` takes no lens or transform.
+    ?resource: "original" | "rendered",
     ?expires_in_seconds: Integer,
     # A lens runs before any additional transforms.
     ?lens: String,
@@ -554,7 +681,7 @@ module CalmLens
                    | { part_number: Integer, base64: String, ?is_final: bool, ?size_in_bytes: Integer }
                    | { part_number: Integer, data: String | Transport::_Reader, ?is_final: bool, ?size_in_bytes: Integer }
 
-  # Options of {Assets#create} and {Assets#moderate}: the shared asset fields with exactly one of
+  # Options of {Assets#create} and {Assets#classify}: the shared asset fields with exactly one of
   # `content:` (a whole file), `part:` (the first part of a multipart upload) or `url:` (a page or
   # file CalmLens fetches).
   type upload_options = {
@@ -563,6 +690,8 @@ module CalmLens
                           ?description: String?,
                           ?visibility: asset_visibility?,
                           ?metadata: Array[metadata_item_input]?,
+                          ?author_id: String,
+                          ?context: moderation_context_input,
                           ?external_id: String?,
                           ?external_url: String?,
                           ?folder_id: String?,
@@ -577,6 +706,8 @@ module CalmLens
                           ?description: String?,
                           ?visibility: asset_visibility?,
                           ?metadata: Array[metadata_item_input]?,
+                          ?author_id: String,
+                          ?context: moderation_context_input,
                           ?external_id: String?,
                           ?external_url: String?,
                           ?folder_id: String?,
@@ -590,6 +721,8 @@ module CalmLens
                           ?description: String?,
                           ?visibility: asset_visibility?,
                           ?metadata: Array[metadata_item_input]?,
+                          ?author_id: String,
+                          ?context: moderation_context_input,
                           ?external_id: String?,
                           ?external_url: String?,
                           ?folder_id: String?,
@@ -599,13 +732,15 @@ module CalmLens
                         }
   type upload_part_options = { asset_id: String, part: upload_part, ?queue: bool, ?request_options: request_options }
 
-  # Options of {Text#moderate}: the text, with the shared asset fields. `name` defaults to `text`.
+  # Options of {Text#classify}: the text, with the shared asset fields. `name` defaults to `text`.
   type moderate_text_options = {
     text: String,
     ?name: String,
     ?description: String?,
     ?visibility: asset_visibility?,
     ?metadata: Array[metadata_item_input]?,
+    ?author_id: String,
+    ?context: moderation_context_input,
     ?external_id: String?,
     ?external_url: String?,
     ?folder_id: String?,
@@ -623,13 +758,50 @@ module CalmLens
   }
   type signed_upload_token = { "token" => String, "expiresAt" => Integer }
 
-  type list_folders_options = { ?request_options: request_options }
+  type folder_order_input = { field: "name" | "createdAt", direction: order_direction }
+  type list_folders_options = {
+    ?parent_id: String,
+    ?cursor: String,
+    # 1 to 100, default 50.
+    ?page_size: Integer,
+    # At most one entry; the default is `name` ascending.
+    ?ordering: Array[folder_order_input],
+    ?search: String,
+    ?request_options: request_options
+  }
+  type folder_page = {
+    "items" => Array[folder],
+    "ancestors" => Array[folder],
+    "hasMore" => bool,
+    "nextCursor" => String?,
+    "pageSize" => Integer,
+    "ordering" => Array[order]
+  }
   type folder_id_options = { folder_id: String, ?request_options: request_options }
   type create_folder_options = { name: String, ?parent_id: String?, ?request_options: request_options }
   type update_folder_options = { folder_id: String, ?name: String, ?request_options: request_options }
   type move_folder_options = { folder_id: String, parent_id: String?, ?request_options: request_options }
+  # 1 to 100 lists per page, default 50.
+  type list_hash_lists_options = { ?cursor: String, ?page_size: Integer, ?request_options: request_options }
+  type hash_list_page = {
+    "items" => Array[hash_list],
+    "hasMore" => bool,
+    "nextCursor" => String?,
+    "pageSize" => Integer,
+    "ordering" => Array[order]
+  }
+  type hash_list_id_options = { hash_list_id: String, ?request_options: request_options }
+  type create_hash_list_options = { name: String, action: hash_list_action, ?description: String?, ?request_options: request_options }
+  type update_hash_list_options = { hash_list_id: String, ?name: String, ?description: String?, ?action: hash_list_action,
+                                    ?request_options: request_options }
+  type list_hash_list_entries_options = { hash_list_id: String, ?cursor: String, ?page_size: Integer,
+                                          ?request_options: request_options }
+  type add_hash_list_entry_options = { hash_list_id: String, ?hash: String, ?quality: number, ?asset_id: String, ?label: String,
+                                       ?request_options: request_options }
+  type hash_list_entry_id_options = { entry_id: String, ?request_options: request_options }
 
-  type list_events_options = { ?after: String, ?limit: Integer, ?request_options: request_options }
+  # `page_size` is 1 to 100, default 50.
+  type list_events_options = { ?cursor: String, ?page_size: Integer, ?request_options: request_options }
 
   type ensure_lenses_options = { lenses: Array[lens_definition], ?request_options: request_options }
   type ensure_lens_options = {
@@ -644,16 +816,22 @@ module CalmLens
   }
 
   type asset_url_options = {
+    ?viewer_claims: viewer_claims,
     # The asset ID or external ID.
     asset_identifier: String,
-    ?resource: "content" | "preview",
+    # `rendered` is the default. `original` takes no lens or transform; `placeholder` is a small blurred PNG
+    # and takes no lens, transform or age_confirmed.
+    ?resource: "original" | "rendered" | "placeholder",
     # A lens runs before any additional transforms.
     ?lens: String,
-    ?transform: transform_input
+    ?transform: transform_input,
+    # Appends `?ageConfirmed=true`, so a public `age-restricted` asset is served from this URL. Set it
+    # only where your app has already decided the viewer may see age-restricted content.
   }
   type serve_options = {
+    ?viewer_claims: viewer_claims,
     asset_identifier: String,
-    ?resource: "content" | "preview",
+    ?resource: "original" | "rendered" | "placeholder",
     ?lens: String,
     ?transform: transform_input,
     ?init: { ?method: "GET" | "HEAD", ?headers: Hash[String, String] },
@@ -672,8 +850,8 @@ module CalmLens
     ?asset: {
       id: String,
       ?external_id: String?,
-      processing: { status: asset_processing_status },
-      moderation: { status: asset_moderation_status, action: asset_moderation_action? },
+      upload: { status: "uploading" | "completed" },
+      classification: { status: asset_classification_status, moderation: { status: asset_moderation_status } },
       content: { status: asset_content_status }
     }?,
     ?facts: Array[event_fact_input],