@giveitsmaller/contracts 0.70.0 → 0.73.0

package/README.md

@@ -5,8 +5,8 @@
 
 | | |
 |---|---|
-| Package version | `0.70.0` |
-| Generated from spec | **`v2.201.0`** |
+| Package version | `0.73.0` |
+| Generated from spec | **`v2.208.0`** |
 
 ## Two version lines, and they are not comparable
 

package/accepted-options/accepted-options.json

@@ -1214,5 +1214,5 @@
       }
     }
   },
-  "schema_version": "2.201.0"
+  "schema_version": "2.208.0"
 }

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

@@ -246,5 +246,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.201.0"
+  "schema_version": "2.208.0"
 }

package/asyncapi/events.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: GISL Compression Events
-  version: 3.28.0
+  version: 3.29.0
   description: |
     Asynchronous event contracts for the GISL (Give It Smaller) compression service.
 
@@ -21,13 +21,23 @@ info:
       video_watermark, video_text_watermark, split). Filter attribute:
       `operation_type`. Subscriptions: one queue per operation type,
       plus four thumbnail sub-type queues during the migration window.
-      `custom_luma`, `audio_overlay`, `audio_watermark`, and
-      `video_text_watermark` are `availability: planned`
-      (per [I29](https://trello.com/c/EPUE5Vs1) +
+      `custom_luma`, `audio_overlay` and `audio_watermark` are
+      `availability: planned` (per [I29](https://trello.com/c/EPUE5Vs1) +
       [I19](https://trello.com/c/Xr3Z4GBF) +
-      [I20](https://trello.com/c/omiCq7Vn) +
-      [`4NrRPCgh`](https://trello.com/c/4NrRPCgh)) — their queues are
-      declared but receive no traffic until Lambda ships. `split` is
+      [I20](https://trello.com/c/omiCq7Vn)) — their queues are declared
+      but receive no traffic UNTIL LAMBDA SHIPS.
+
+      ⚠️ `audio_to_video`, `video_watermark` and `video_text_watermark` are
+      ALSO `availability: planned` but for the OPPOSITE REASON, and they are
+      listed separately so the two are not confused: their Lambdas SHIPPED
+      and run. They were WITHDRAWN 2026-09-15 because none can finish the
+      ceiling this contract advertised inside its own encode cap. Grouping
+      them with the not-yet-built operations would tell a reader to wait for
+      a worker that already exists. Workflow-create returns 422
+      `feature_not_available`, so NO NEW traffic is published for them; an
+      already-accepted workflow is not cancelled — availability is checked at
+      create — so these queues can still receive in-flight work, which fails
+      only if it exceeds the cap. `split` is
       `availability: beta` for its `audio` and `video` mime_groups
       (workers live on staging — [`vKI0CFDu`](https://trello.com/c/vKI0CFDu);
       video activates BOTH classes — `long_form` / `split-video-fargate`
@@ -36,9 +46,6 @@ info:
       incomplete, 4GB+ speed-up unmeasured, fan-out flag-gated dark);
       its `image_gif` and `document_pdf` mime_groups stay
       `availability: planned`.
-      `audio_to_video` and `video_watermark` are `availability: beta`
-      (Wave A activation [`c3uthIP4`](https://trello.com/c/c3uthIP4) —
-      backends live; the API accepts + publishes, traffic flows).
       `audio_watermark` additionally requires `enterprise` tier.
 
     **Publisher branching rule** (implemented in `compression_api`'s
@@ -204,18 +211,22 @@ channels:
         [I19](https://trello.com/c/Xr3Z4GBF) — same `feature_not_
         available` 422 gating)
       - `operation_type = audio_to_video` -> `ops-audio-to-video` queue
-        (`availability: beta` — Wave A activated per
-        [`SlluxMBN`](https://trello.com/c/SlluxMBN) +
-        [`c3uthIP4`](https://trello.com/c/c3uthIP4); backend live, traffic
-        flows)
+        (`availability: planned` — WITHDRAWN 2026-09-15; the backend is
+        live but cannot serve the advertised ceiling, so workflow-create
+        422s and NO NEW traffic is routed here. In-flight work accepted
+        before the withdrawal still arrives, per
+        [`SlluxMBN`](https://trello.com/c/SlluxMBN))
       - `operation_type = video_watermark` -> `ops-video-watermark`
-        queue (`availability: beta` — Wave A activated per
-        [`4NrRPCgh`](https://trello.com/c/4NrRPCgh) +
-        [`c3uthIP4`](https://trello.com/c/c3uthIP4); backend live)
+        queue (`availability: planned` — WITHDRAWN 2026-09-15; the backend
+        is live but cannot serve the advertised ceiling, so workflow-create
+        422s and NO NEW traffic is routed here. In-flight work accepted
+        before the withdrawal still arrives, per
+        [`4NrRPCgh`](https://trello.com/c/4NrRPCgh))
       - `operation_type = video_text_watermark` ->
-        `ops-video-text-watermark` queue (gated by
-        `availability: planned` until Lambda ships per
-        [`4NrRPCgh`](https://trello.com/c/4NrRPCgh) — same gating)
+        `ops-video-text-watermark` queue (`availability: planned` —
+        WITHDRAWN 2026-09-15. ⚠️ NOT "until Lambda ships": the Lambda
+        SHIPPED and runs; it is the advertised ceiling it cannot serve, per
+        [`4NrRPCgh`](https://trello.com/c/4NrRPCgh))
       - `operation_type = split` -> `ops-split` queue (the `audio` and
         `video` mime_groups are `availability: beta` — audio + short-form
         video split traffic reaches this queue; `image_gif` /
@@ -768,12 +779,12 @@ channels:
     address: gisl-{env}-{region}-ops-custom-luma
     description: |
       SQS queue for custom_luma operations (caller-uploaded luma matte
-      transition; pro-tier paid feature). Subscribed to the
+      transition; credit-metered, no tier gate). Subscribed to the
       `operations` SNS topic with filter `operation_type = custom_luma`.
       Multi-input (Path B with `role: base` + `role: transition_mask`
       per `JobInputV2.role`).
 
-      `custom_luma` is `availability: planned` + `required_tier: pro`
+      `custom_luma` is `availability: planned` (no tier gate)
       per the operation schema; the API rejects workflow-create with
       `feature_not_available` (422) until the Lambda ships, so traffic
       does not reach this queue today. Backed by the
@@ -924,13 +935,16 @@ channels:
       (Path B with `role: base` video + `role: overlay` image,
       exactly one of each per `per_role_cardinality`).
 
-      `availability: beta` per the operation schema (Wave A activated,
-      [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the API accepts +
-      publishes, so traffic flows to this queue (MUST NOT 422). The
-      `short_form` processing class is beta; `long_form` stays planned
-      (no live Fargate worker). Backed by the `operation-video-watermark`
-      Lambda (live; lambdas pre-launch epic Wave A, ticket
-      [DbpJpVtm](https://trello.com/c/DbpJpVtm)).
+      `availability: planned` per the operation schema — WITHDRAWN
+      2026-09-15. Workflow-create returns `feature_not_available` (422), so
+      NO NEW traffic reaches this queue. ⚠️ Work accepted BEFORE the
+      withdrawal still arrives here — availability gates at create, not
+      retroactively — and fails only if it exceeds the worker's 600 s
+      encode cap; work far enough inside it still completes. Both
+      `short_form` and `long_form` are `planned`. Backed by the
+      `operation-video-watermark` Lambda, which is LIVE and runs: what it
+      cannot do is finish the advertised ceiling inside its own 600 s cap
+      ([DbpJpVtm](https://trello.com/c/DbpJpVtm)).
 
       Distinct from `image_watermark` (pure-Rust image-only) — see
       ADR-0013 for the split rationale. Audio stream-copy passthrough.
@@ -961,12 +975,15 @@ channels:
       `operation_type = video_text_watermark`. Single-input — text
       and styling come from options.
 
-      `availability: planned` per the operation schema; the API
-      rejects workflow-create with `feature_not_available` (422)
-      until the Lambda ships, so traffic does not reach this queue
-      today. Backed by the `operation-video-text-watermark` Lambda
-      (cross-repo follow-up — lambdas pre-launch epic Wave A,
-      ticket [mQdunjv6](https://trello.com/c/mQdunjv6)).
+      `availability: planned` per the operation schema — WITHDRAWN
+      2026-09-15. ⚠️ NOT "until the Lambda ships": the Lambda SHIPPED and
+      runs. It was withdrawn because it cannot finish the advertised
+      ceiling inside its own 600 s encode cap. Workflow-create returns
+      `feature_not_available` (422) for consumers vendoring >= 2.203.0, so
+      no NEW traffic is routed here — but work accepted BEFORE the
+      withdrawal still arrives, because availability gates at create and
+      not retroactively. Backed by the `operation-video-text-watermark`
+      Lambda (live; ticket [mQdunjv6](https://trello.com/c/mQdunjv6)).
 
       Distinct from `text_watermark` (pure-Rust image drawtext) —
       see ADR-0013. Audio stream-copy passthrough.
@@ -1230,8 +1247,10 @@ channels:
       DLQ for failed audio_to_video operations (per ticket
       [`SlluxMBN`](https://trello.com/c/SlluxMBN) / ADR-0015).
       Messages land here after 5 failed processing attempts.
-      audio_to_video is `availability: beta` (Wave A activated) so
-      this queue now receives real failures.
+      audio_to_video is `availability: planned` (WITHDRAWN 2026-09-15), so
+      workflow-create publishes nothing new here. ⚠️ This queue can still
+      receive failures from work accepted BEFORE the withdrawal — availability
+      gates at create, not retroactively.
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1244,8 +1263,10 @@ channels:
       DLQ for failed video_watermark operations (per ticket
       [`4NrRPCgh`](https://trello.com/c/4NrRPCgh) / ADR-0013).
       Messages land here after 5 failed processing attempts.
-      video_watermark is `availability: beta` (Wave A activated) so
-      this queue now receives real failures.
+      video_watermark is `availability: planned` (WITHDRAWN 2026-09-15), so
+      workflow-create publishes nothing new here. ⚠️ This queue can still
+      receive failures from work accepted BEFORE the withdrawal — availability
+      gates at create, not retroactively.
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1257,9 +1278,19 @@ channels:
     description: |
       DLQ for failed video_text_watermark operations (per ticket
       [`4NrRPCgh`](https://trello.com/c/4NrRPCgh) / ADR-0013).
-      Messages land here after 5 failed processing attempts. No
-      traffic reaches this queue while video_text_watermark is
-      `availability: planned`.
+      Messages land here after 5 failed processing attempts.
+      video_text_watermark is `availability: planned` (WITHDRAWN
+      2026-09-15), so workflow-create publishes nothing NEW. ⚠️ This queue
+      can still receive failures from work accepted BEFORE the withdrawal
+      — availability gates at create, not retroactively. ⛔ Do NOT read a
+      message here as proof of the cap: this queue takes ANY message that
+      failed 5 processing attempts, so corrupt input, invalid options and
+      storage errors land here exactly as a cap timeout does. Nor does
+      pre-withdrawal work fail as a class — work far enough inside the
+      600 s cap still completes, and nothing measured says where that
+      boundary is. A DLQ description reading "no
+      traffic reaches this queue" is wrong in the direction that gets an
+      alarm ignored.
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -2009,7 +2040,7 @@ operations:
       yet shipped) consumes custom_luma requests routed by
       `operation_type=custom_luma`. Multi-input (Path B with
       `role: base` + `role: transition_mask` per `JobInputV2.role`).
-      `availability: planned` + `required_tier: pro`; the API rejects
+      `availability: planned` (no tier gate); the API rejects
       workflow-create with `feature_not_available` (422) until the
       Lambda ships, so traffic does not reach this channel today.
       Per ADR-0004 + I29 (Trello EPUE5Vs1).
@@ -2092,10 +2123,14 @@ operations:
       video_watermark requests routed by
       `operation_type=video_watermark`. Multi-input role-based with
       `role: base` video + `role: overlay` image (exactly one of
-      each per `per_role_cardinality`). `availability: beta` (Wave A
-      activated, [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the API
-      accepts + publishes (MUST NOT 422), so traffic flows to this
-      channel. `short_form` is beta; `long_form` stays planned.
+      each per `per_role_cardinality`). `availability: planned` — WITHDRAWN 2026-09-15.
+      Workflow-create 422s with `feature_not_available`, so NO NEW traffic
+      reaches this channel. ⚠️ Work accepted BEFORE the withdrawal still
+      arrives here — availability gates at create, not retroactively — and
+      it is NOT thereby doomed: the withdrawal rests on ONE measured point
+      (the same source plus a PNG overlay, KILLED at 606 s, no output, on
+      3008 MB) and work far enough inside the 600 s cap still completes.
+      `short_form` and `long_form` are both `planned`.
       Per ADR-0004 + ADR-0013
       ([`4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
     messages:
@@ -2114,13 +2149,20 @@ operations:
     summary: Process video_text_watermark operation
     description: |
       The `operation-video-text-watermark` Lambda (cross-repo
-      follow-up — lambdas pre-launch epic Wave A, not yet shipped)
-      consumes video_text_watermark requests routed by
+      follow-up — lambdas pre-launch epic Wave A, live) consumes
+      video_text_watermark requests routed by
       `operation_type=video_text_watermark`. Single-input — text
       and styling come from options (no `role` field on the source
-      entry). `availability: planned`; the API rejects workflow-
-      create with `feature_not_available` (422) until the Lambda
-      ships, so traffic does not reach this channel today.
+      entry). `availability: planned` — WITHDRAWN 2026-09-15.
+      Workflow-create 422s with `feature_not_available`, so NO NEW traffic
+      reaches this channel. ⚠️ Work accepted BEFORE the withdrawal still
+      arrives here — availability gates at create, not retroactively — and
+      it is NOT thereby doomed: the withdrawal rests on ONE measured point
+      (435 MB / 300 s real 1080p, KILLED at 604 s, no output) and work far
+      enough inside the 600 s cap still completes. Nothing measured says
+      where the boundary is.
+      ⚠️ NOT "until the Lambda ships": the Lambda SHIPPED and runs — it is
+      the advertised ceiling it cannot serve.
       Per ADR-0004 + ADR-0013
       ([`4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
     messages:
@@ -2144,9 +2186,18 @@ operations:
       `operation_type=audio_to_video`. Multi-input role-based with
       role asymmetry (Path B with `role: base` audio REQUIRED +
       `role: overlay` image OPTIONAL per `per_role_cardinality`).
-      `availability: beta` (Wave A activated,
-      [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the API accepts +
-      publishes (MUST NOT 422), so traffic flows to this channel.
+      `availability: planned` — WITHDRAWN 2026-09-15.
+      Workflow-create 422s with `feature_not_available`, so NO NEW traffic
+      reaches this channel. ⚠️ Work accepted BEFORE the withdrawal still
+      arrives here — availability gates at create, not retroactively — and
+      it is NOT thereby doomed: unlike its two siblings this withdrawal is
+      ARITHMETIC ON COMPLETED CELLS — 60 s and 120 s both finished with
+      output — so accepted work fails only when its OUTPUT DURATION exceeds
+      ~1976 s ON THE INPUT THE RATE WAS MEASURED WITH (a real photographic
+      1080p still plus looped real audio), where 0.300 s/s plus a 7 s fixed
+      cost reaches the 600 s cap. ⛔ The driver is the STILL'S RESOLUTION: a
+      4K still is roughly 4x the rate (UNMEASURED), and nothing constrains
+      the overlay's resolution.
       Per ADR-0004 + ADR-0015
       ([`SlluxMBN`](https://trello.com/c/SlluxMBN)).
     messages:
@@ -2609,8 +2660,10 @@ components:
           minimum `sources` count (1 for audio_to_video; 2 for all
           other role-based ops today). custom_luma and audio_overlay
           are `availability: planned` so workflow-create rejects with
-          422 today (audio_to_video and video_watermark are now `beta` —
-          Wave A activated).
+          422 today — and audio_to_video and video_watermark REJOINED
+          that set on 2026-09-15 when they were withdrawn on measured
+          evidence. (`video_text_watermark` was withdrawn in the same cut
+          but is SINGLE-input, so it is not part of this role-based set.)
 
         **Migration window note.** During the thumbnail sub-type
         migration, both `operation_type=thumbnail` (legacy) and
@@ -3283,6 +3336,10 @@ components:
     PerMimeAvailability:
       type: object
       description: |
+        **CLOSED TO NEW DECLARATIONS since 2026-09-18** ([`DquOfy7f`](https://trello.com/c/DquOfy7f)).
+        Retained for compatibility only; `scripts/check-per-mime-availability.py`
+        fails on any declaration. Use a parallel mime_group instead.
+
         Map of MIME-type → `PerValueAvailabilityEntry`. Mirrors the
         OpenAPI `PerMimeAvailability` schema so SDK generators
         consuming both specs emit a single typed binding.
@@ -3635,8 +3692,10 @@ components:
         entries may include per-input overrides (e.g. transition type).
         Merge also requires `output_type`. custom_luma and audio_overlay
         are `availability: planned` so workflow-create rejects with 422
-        today (audio_to_video + video_watermark are now `beta` — Wave A
-        activated, backends live); the wire shape is contract-defined.
+        today — and audio_to_video + video_watermark REJOINED that set on
+        2026-09-15, withdrawn on measured evidence; the wire shape is
+        contract-defined. (`video_text_watermark` was withdrawn in the same
+        cut; it is SINGLE-input and is listed as such above.)
 
         Note: `media_group` is **not** a field in this payload. It exists
         only as an SNS MessageAttribute on the non-compression branch; on
@@ -5241,8 +5300,8 @@ components:
         - `custom_luma`: Apply a caller-uploaded luma matte to a base
           video for a custom luma-matte transition effect. Multi-input
           (Path B with `role: base` + `role: transition_mask` per
-          `JobInputV2.role`). `availability: planned` +
-          `required_tier: pro` per the operation schema; the API
+          `JobInputV2.role`). `availability: planned`
+          (no tier gate) per the operation schema; the API
           rejects workflow-create with `feature_not_available` (422)
           until the Lambda ships, so traffic does not reach SNS today.
           When Lambda support lands, routes via
@@ -5274,10 +5333,12 @@ components:
           the first OPTIONAL role on the contract — `role: base`
           audio required, `role: overlay` image 0..1 per
           `per_role_cardinality`). When overlay is omitted, the video
-          uses a solid background colour. `availability: beta` (Wave A,
-          [`c3uthIP4`](https://trello.com/c/c3uthIP4)) — the Lambda
-          backend is live, so the API accepts + publishes (MUST NOT 422);
-          traffic flows to SNS. `media_group` is derived
+          uses a solid background colour. `availability: planned` —
+          WITHDRAWN 2026-09-15: the Lambda is live but cannot serve the
+          advertised ceiling, so workflow-create 422s and NO NEW traffic
+          reaches SNS. ⚠️ Work accepted BEFORE the withdrawal still flows —
+          availability gates at create, not retroactively.
+          `media_group` is derived
           from the `base` role input MIME prefix per ADR-0015 (always
           `audio` for audio_to_video). Routes via
           `operation_type=audio_to_video` to `ops-audio-to-video`.
@@ -5288,9 +5349,10 @@ components:
           of each per `per_role_cardinality { base: 1/1, overlay:
           1/1 }`). Re-encode required; audio stream-copy passthrough.
           Distinct from `image_watermark` (pure-Rust/image-only —
-          see ADR-0013). `availability: beta` (Wave A, `c3uthIP4` —
-          Lambda backend live; `short_form` beta, `long_form` stays
-          `planned`); routes via
+          see ADR-0013). `availability: planned` — WITHDRAWN 2026-09-15:
+          the Lambda is live but cannot serve the advertised ceiling, so
+          workflow-create 422s and no new traffic reaches SNS. Both
+          `short_form` and `long_form` are `planned`; routes via
           `operation_type=video_watermark` to `ops-video-watermark`.
           Per ADR-0004 + ADR-0013
           ([`4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
@@ -5300,7 +5362,9 @@ components:
           tiled) + `anchor` + `margin` vocab as `text_watermark`.
           Re-encode required; audio stream-copy passthrough.
           Distinct from `text_watermark` (image-only drawtext path
-          — see ADR-0013). `availability: planned`; routes via
+          — see ADR-0013). `availability: planned` — WITHDRAWN
+          2026-09-15; the Lambda SHIPPED and runs, and it is the advertised
+          ceiling it cannot serve. Routes via
           `operation_type=video_text_watermark` to
           `ops-video-text-watermark`. Per ADR-0004 + ADR-0013.
         - `split`: Fan one input file into N outputs across GIF /