@giveitsmaller/contracts 0.48.0 → 0.51.0

package/accepted-options/accepted-options.json

@@ -167,7 +167,6 @@
         "accepted_options": {
           "*": [
             "font_subsetting",
-            "image_quality",
             "quality",
             "strip_unused_css"
           ]
@@ -177,7 +176,6 @@
       "document_odf": {
         "accepted_options": {
           "*": [
-            "image_quality",
             "quality",
             "strip_metadata",
             "strip_unused_styles"
@@ -188,7 +186,6 @@
       "document_office": {
         "accepted_options": {
           "*": [
-            "image_quality",
             "quality",
             "strip_hidden_data",
             "strip_macros",
@@ -218,7 +215,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
             "metadata",
             "output_format",
             "quality",
@@ -229,7 +225,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
             "metadata",
             "output_format",
             "quality",
@@ -240,7 +235,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
             "metadata",
             "output_format",
             "quality",
@@ -251,7 +245,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
             "metadata",
             "output_format",
             "quality",
@@ -272,6 +265,7 @@
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -285,6 +279,7 @@
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -298,6 +293,7 @@
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -311,6 +307,7 @@
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ]
@@ -326,12 +323,12 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "progressive",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -342,12 +339,12 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "progressive",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -358,12 +355,12 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "progressive",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -374,12 +371,12 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "progressive",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ]
@@ -393,8 +390,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
-            "lossy",
             "metadata",
             "optimization_level",
             "output_format",
@@ -406,8 +401,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
-            "lossy",
             "metadata",
             "optimization_level",
             "output_format",
@@ -419,8 +412,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
-            "lossy",
             "metadata",
             "optimization_level",
             "output_format",
@@ -432,8 +423,6 @@
             "color_profile",
             "fit",
             "height",
-            "keep_metadata",
-            "lossy",
             "metadata",
             "optimization_level",
             "output_format",
@@ -447,23 +436,19 @@
         "accepted_options": {
           "auto": [
             "metadata",
-            "output_format",
-            "quality"
+            "output_format"
           ],
           "original": [
             "metadata",
-            "output_format",
-            "quality"
+            "output_format"
           ],
           "smallest": [
             "metadata",
-            "output_format",
-            "quality"
+            "output_format"
           ],
           "webp": [
             "metadata",
-            "output_format",
-            "quality"
+            "output_format"
           ]
         },
         "output_format_option": "output_format"
@@ -476,11 +461,11 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -490,11 +475,11 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -504,11 +489,11 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
@@ -518,11 +503,11 @@
             "encoding_mode",
             "fit",
             "height",
-            "keep_metadata",
             "lossless",
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ]
@@ -716,7 +701,6 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "quality",
             "width"
@@ -726,7 +710,6 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "width"
           ],
@@ -736,14 +719,12 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "quality",
             "width"
           ],
           "mp4": [
             "fit",
-            "metadata",
             "output_format"
           ],
           "png": [
@@ -751,7 +732,6 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "width"
           ],
@@ -760,13 +740,11 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "width"
           ],
           "webm": [
             "fit",
-            "metadata",
             "output_format"
           ],
           "webp": [
@@ -774,7 +752,6 @@
             "color_profile",
             "fit",
             "height",
-            "metadata",
             "output_format",
             "quality",
             "width"
@@ -821,6 +798,18 @@
             "trim_start",
             "width"
           ],
+          "mkv": [
+            "crf",
+            "output_format",
+            "trim_end",
+            "trim_start"
+          ],
+          "mov": [
+            "crf",
+            "output_format",
+            "trim_end",
+            "trim_start"
+          ],
           "mp4": [
             "crf",
             "output_format",
@@ -865,7 +854,8 @@
             "margin_x",
             "margin_y",
             "opacity",
-            "overlay_width"
+            "overlay_width",
+            "overlays"
           ]
         },
         "output_format_option": null
@@ -1121,19 +1111,6 @@
         },
         "output_format_option": null
       },
-      "image_svg": {
-        "accepted_options": {
-          "*": [
-            "background",
-            "fit",
-            "format",
-            "height",
-            "quality",
-            "width"
-          ]
-        },
-        "output_format_option": null
-      },
       "video": {
         "accepted_options": {
           "*": [
@@ -1183,5 +1160,5 @@
       }
     }
   },
-  "schema_version": "2.135.0"
+  "schema_version": "2.152.0"
 }

package/accepted-options/image-output-routes.json

@@ -115,20 +115,20 @@
           "honored_options": [
             "auto_orient",
             "avif_speed",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
           "input_mime": "image/avif",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "color_profile"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         },
         "gif": {
@@ -144,9 +144,7 @@
           ],
           "input_mime": "image/gif",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "keep_metadata"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         },
         "jpeg": {
@@ -162,14 +160,13 @@
             "output_format",
             "progressive",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
           "input_mime": "image/jpeg",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "keep_metadata"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         },
         "png": {
@@ -186,17 +183,13 @@
           ],
           "input_mime": "image/png",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "keep_metadata",
-            "lossy"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         },
         "svg": {
           "honored_options": [
             "metadata",
-            "output_format",
-            "quality"
+            "output_format"
           ],
           "input_mime": "image/svg+xml",
           "planned_options": [],
@@ -215,9 +208,7 @@
           ],
           "input_mime": "image/tiff",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "keep_metadata"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         },
         "webp": {
@@ -231,14 +222,13 @@
             "metadata",
             "output_format",
             "quality",
+            "quality_preset",
             "target_size_bytes",
             "width"
           ],
           "input_mime": "image/webp",
           "max_output_pixels": 16000000,
-          "planned_options": [
-            "keep_metadata"
-          ],
+          "planned_options": [],
           "source_op": "compress"
         }
       }
@@ -256,5 +246,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.135.0"
+  "schema_version": "2.152.0"
 }

package/asyncapi/events.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: GISL Compression Events
-  version: 3.24.0
+  version: 3.25.1
   description: |
     Asynchronous event contracts for the GISL (Give It Smaller) compression service.
 
@@ -1708,13 +1708,17 @@ operations:
     description: |
       The operation-image-watermark Lambda consumes image_watermark
       requests routed by `operation_type=image_watermark`. Multi-input
-      (Path B with role: base + overlay per JobInputV2.role).
+      (Path B, role-based): one `base` + 1-8 `overlay` inputs per
+      `JobInputV2.role` (`input` min 2 / max 9; multi-overlay via the
+      index-aligned `overlays[]` option, LIVE 2026-07-01 — the flat
+      single-overlay options remain the 1-overlay back-compat path).
 
-      Stable for image bases today; animated GIF (`image_gif` group) and
-      video bases (`video` group) are advertised as `planned` in the
-      schema (I5 — Trello AKZiOXnd) and dispatch returns
+      Stable for jpeg/png/webp + tiff/bmp image bases; animated GIF
+      (`image_gif` group) is advertised as `planned` and dispatch returns
       `feature_not_available` (422) at the API edge until Lambda support
-      ships. Per ADR-0004 + I4-CONS + I5.
+      ships. Video bases are NOT supported (there is no `video` group) —
+      use `video_watermark`. Multi-overlay (`overlays[]`) is jpeg/png/webp
+      only. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
     messages:
       - $ref: '#/channels/opsImageWatermark/messages/operationRequest'
 
@@ -4247,11 +4251,14 @@ components:
           minimum: 1
           maximum: 100
           description: |
-            The quality the encode-measure loop settled on for a `target_size`
-            encode (compress.image / compress.video `encoding_mode: target_size`).
-            Present ONLY for a `target_size` operation — absent for `quality` mode
-            and non-compress ops. Pairs with `target_size_met`. Fulfils the
-            `target_size_bytes` contract that "the result reports the chosen quality".
+            The encoder quality the search settled on — for a `target_size` encode
+            (compress.image / compress.video `encoding_mode: target_size`) OR an
+            `auto_quality` encode (compress.image jpeg/webp/avif, where it is the
+            quality that met the `quality_preset` perceptual target). Present for
+            `target_size` and `auto_quality` operations; absent for `quality` mode and
+            non-compress ops. For `target_size` it pairs with `target_size_met`; for
+            `auto_quality` it pairs with `measured_quality`. Fulfils the contract that
+            "the result reports the chosen quality".
           example: 66
         target_size_met:
           type: boolean
@@ -4261,6 +4268,29 @@ components:
             was unreachable at minimum quality), NOT a failure — the operation still
             `completed`. Present ONLY for a `target_size` operation.
           example: true
+        measured_quality:
+          type: number
+          format: float
+          minimum: 0
+          maximum: 1
+          description: |
+            The achieved perceptual-quality score (0.0–1.0) for an
+            `encoding_mode: auto_quality` encode — the worker's measured result of the
+            perceptual-target search that backs `quality_preset` (compress.image
+            jpeg/webp/avif). Present ONLY for an `auto_quality` operation. Pairs with
+            `chosen_quality` (the encoder quality the search settled on).
+            METRIC-AGNOSTIC by design: the producing metric is named in
+            `quality_metric`, so the worker can evolve it without a contract change
+            (mirrors the `re_encode_reason` opacity precedent). Per ticket PQMWCqfR.
+          example: 0.9501
+        quality_metric:
+          type: string
+          description: |
+            The perceptual metric that produced `measured_quality` — a FREE-FORM
+            string (NOT an enum) so the worker can change or upgrade the metric
+            without contract churn (mirrors `re_encode_reason`). Present ONLY for an
+            `auto_quality` operation. Current value: `ssim`.
+          example: ssim
         duration_ms:
           type: integer
           format: int64