@giveitsmaller/contracts 0.9.0 → 0.16.0

package/asyncapi/events.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: GISL Compression Events
-  version: 3.9.0
+  version: 3.18.0
   description: |
     Asynchronous event contracts for the GISL (Give It Smaller) compression service.
 
@@ -28,9 +28,10 @@ info:
       [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
-      `availability: beta` for its `audio` mime_group (worker live on
-      staging — [`vKI0CFDu`](https://trello.com/c/vKI0CFDu)); its
-      `image_gif`, `document_pdf`, and `video` mime_groups stay
+      `availability: beta` for its `audio` and `video` mime_groups
+      (workers live on staging — [`vKI0CFDu`](https://trello.com/c/vKI0CFDu);
+      video short-form only — `long_form` / `split-video-fargate` stays
+      planned); 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) —
@@ -68,7 +69,7 @@ info:
 
     **Notifications (Lambda -> API).** Lambda functions publish progress
     and result notifications to the FIFO SNS topic
-    `gisl-{env}-{region}-notifications-operations.fifo`. The API consumes
+    `gisl-{env}-{region}-notifications-jobs.fifo`. The API consumes
     from the corresponding FIFO SQS queue via a Raw Message Delivery
     subscription. This notification path is unchanged from previous
     releases.
@@ -209,19 +210,25 @@ channels:
         `ops-video-text-watermark` queue (gated by
         `availability: planned` until Lambda ships per
         [`4NrRPCgh`](https://trello.com/c/4NrRPCgh) — same gating)
-      - `operation_type = split` -> `ops-split` queue (the `audio`
-        mime_group is `availability: beta` — audio split traffic
-        reaches this queue; `image_gif` / `document_pdf` / `video`
-        stay `availability: planned` until their Lambdas ship per
-        [`vKI0CFDu`](https://trello.com/c/vKI0CFDu);
+      - `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` /
+        `document_pdf` stay `availability: planned` until their Lambdas
+        ship per [`vKI0CFDu`](https://trello.com/c/vKI0CFDu);
         long-form video splits route via `processing_class` to the
-        `split-video-fargate` worker, same OperationType, different
-        worker)
+        `split-video-fargate` worker — same OperationType, different
+        worker — and stay `availability: planned` until it ships)
       - `operation_type = audio_watermark` -> `ops-audio-watermark`
         queue (gated by `availability: planned` +
         `required_tier: enterprise` per
         [I20](https://trello.com/c/omiCq7Vn) — same 422 gating, plus
         a 403 `feature_tier_restricted` for non-enterprise callers)
+      - `operation_type = render_variants` -> `ops-render-variants`
+        queue (gated by `availability: planned` until the worker +
+        SNS subscription ship per
+        [`w3EwzHYd`](https://trello.com/c/w3EwzHYd) /
+        [`MNuDYJaY`](https://trello.com/c/MNuDYJaY) — same
+        `feature_not_available` 422 gating)
 
       The API's Option A publisher sets `operation_type` as the filter
       attribute and additionally sets `media_group` as an **informational**
@@ -394,6 +401,12 @@ channels:
       `thumbnail_document`, `thumbnail_office`), resolved from each
       operation's effective input MIME. Retirement of this legacy queue
       follows once no traffic remains.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-thumbnail
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -415,6 +428,12 @@ channels:
       `operation_type=thumbnail_image` on the SNS attribute (resolved from
       the operation's effective input MIME); the payload `operation_type`
       field stays `thumbnail`.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-thumbnail-image
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -436,6 +455,12 @@ channels:
       `operation_type=thumbnail_video` on the SNS attribute (resolved from
       the operation's effective input MIME); the payload `operation_type`
       field stays `thumbnail`.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-thumbnail-video
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -457,6 +482,12 @@ channels:
       `operation_type=thumbnail_document` on the SNS attribute (resolved
       from the operation's effective input MIME); the payload
       `operation_type` field stays `thumbnail`.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-thumbnail-document
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -479,6 +510,12 @@ channels:
       emits `operation_type=thumbnail_office` on the SNS attribute
       (resolved from the operation's effective input MIME); the payload
       `operation_type` field stays `thumbnail`.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-thumbnail-office
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -507,6 +544,12 @@ channels:
       queue. Video bases are NOT routed here — they go to
       `ops-video-watermark` for the dedicated `video_watermark`
       operation per ADR-0013. Per ADR-0004 + I4-CONS + I5 + ADR-0013.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-image-watermark
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -525,6 +568,12 @@ channels:
       (Liberation Sans) — supports `single` (one label at anchor) and
       `tiled` (Cinavia-style angled fill) modes. Backed by the
       operation-text-watermark Lambda. Per ADR-0004 + I4-CONS.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-text-watermark
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -544,6 +593,12 @@ channels:
       concat) — the `output_type` field on the request determines the
       encoding path internally, not the routing. Image collage and PDF
       concatenation are not supported by the V1 Lambda.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-merge
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -560,6 +615,12 @@ channels:
       Subscribed to the `operations` SNS topic with filter
       `operation_type = archive`. Media-agnostic: accepts mixed input
       types. Backed by the archive Lambda (`operation-archive`).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-archive
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -577,6 +638,12 @@ channels:
       `operation_type = convert`. Handles format conversion across all
       media types (image, video, audio, document). Backed by the convert
       Lambda (`operation-convert`).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-convert
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -602,6 +669,12 @@ channels:
       `operation-custom-luma` Lambda (cross-repo follow-up; not yet
       shipped).
       Per ADR-0004 + I29 (Trello EPUE5Vs1).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-custom-luma
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -634,6 +707,12 @@ channels:
       / "audio branding".
 
       Per ADR-0004 + I19 (Trello Xr3Z4GBF).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-audio-overlay
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -662,6 +741,12 @@ channels:
 
       Per ADR-0004 + ADR-0015
       ([`SlluxMBN`](https://trello.com/c/SlluxMBN)).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-audio-to-video
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -682,9 +767,10 @@ channels:
       (no operation-specific conditional needed in
       OperationRequestAttributes).
 
-      `availability: beta` for the `audio` mime_group (worker live on
-      staging — audio split traffic reaches this queue); the
-      `image_gif`, `document_pdf`, and `video` mime_groups stay
+      `availability: beta` for the `audio` and `video` mime_groups
+      (workers live on staging — audio + short-form video split traffic
+      reaches this queue; video `long_form` / `split-video-fargate` stays
+      planned); the `image_gif` and `document_pdf` mime_groups stay
       `availability: planned`, and the API rejects their
       workflow-create with `feature_not_available` (422) until those
       Lambdas ship. Backed by the `operation-split` Lambda (cross-repo
@@ -701,6 +787,12 @@ channels:
       MIME detection.
 
       Per ADR-0004 + ADR-0014.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-split
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -733,6 +825,12 @@ channels:
 
       Per ADR-0004 + ADR-0013
       ([`4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-video-watermark
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -763,6 +861,12 @@ channels:
 
       Per ADR-0004 + ADR-0013
       ([`4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-video-text-watermark
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -797,6 +901,37 @@ channels:
       own-watermarks-only extraction (declared in `openapi/api.yaml`).
 
       Per ADR-0004 + I20 (Trello omiCq7Vn).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-audio-watermark
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      operationRequest:
+        $ref: '#/components/messages/OperationRequestMessage'
+
+  opsRenderVariants:
+    address: gisl-{env}-{region}-ops-render-variants
+    description: |
+      SQS queue for render_variants operations (image fan-out — one
+      source image to N resized / re-encoded variants). Subscribed to the
+      `operations` SNS topic with filter `operation_type = render_variants`.
+      Backed by the render_variants Lambda (`operation-render-variants`).
+      No traffic reaches this queue while render_variants is
+      `availability: planned` (per ticket w3EwzHYd — same `feature_not_
+      available` 422 gating until the worker + this subscription ship).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-render-variants
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -938,6 +1073,18 @@ channels:
       region:
         description: AWS region abbreviation (euw1, use1, etc.)
 
+  opsRenderVariantsDlq:
+    address: gisl-{env}-{region}-ops-render-variants-dlq
+    description: |
+      DLQ for failed render_variants operations (per ticket w3EwzHYd).
+      Messages land here after 5 failed processing attempts. No traffic
+      reaches this queue while render_variants is `availability: planned`.
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
   opsAudioToVideoDlq:
     address: gisl-{env}-{region}-ops-audio-to-video-dlq
     description: |
@@ -986,9 +1133,9 @@ channels:
       DLQ for failed split operations (per ticket
       [`vKI0CFDu`](https://trello.com/c/vKI0CFDu) / ADR-0014).
       Messages land here after 5 failed processing attempts. Live for
-      the `split` `audio` mime_group (now `availability: beta`); the
-      `image_gif`, `document_pdf`, and `video` groups stay
-      `availability: planned` and carry no traffic yet.
+      the `split` `audio` + `video` mime_groups (now `availability: beta`,
+      video short-form only); the `image_gif` and `document_pdf` groups
+      stay `availability: planned` and carry no traffic yet.
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1041,6 +1188,12 @@ channels:
 
       Standard (non-FIFO) — each probe request is independent; no
       ordering guarantees are required across uploads.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-upload-probe
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1081,6 +1234,12 @@ channels:
       The sync `POST /api/uploads/{id}/probe` path does not publish
       here — sync results are returned inline via the Lambda
       RequestResponse return value.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-upload-probe-completions
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1107,8 +1266,8 @@ channels:
   # NOTIFICATIONS (Lambda -> API)
   # ============================================
 
-  notificationsOperationsTopic:
-    address: gisl-{env}-{region}-notifications-operations.fifo
+  notificationsJobsTopic:
+    address: gisl-{env}-{region}-notifications-jobs.fifo
     description: |
       FIFO SNS topic where Lambdas publish all operation notifications (progress and results).
       API subscribes via FIFO SQS with Raw Message Delivery enabled.
@@ -1116,6 +1275,13 @@ channels:
       **FIFO Publishing Requirements:**
       - MessageGroupId: Use operation_id (ensures ordering per operation)
       - MessageDeduplicationId: Not required (content-based deduplication enabled)
+    bindings:
+      sns:
+        name: gisl-{env}-{region}-notifications-jobs.fifo
+        ordering:
+          type: FIFO
+          contentBasedDeduplication: true
+        bindingVersion: '0.1.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1127,15 +1293,21 @@ channels:
       operationResult:
         $ref: '#/components/messages/OperationResultMessage'
 
-  notificationsOperationsQueue:
-    address: gisl-{env}-{region}-notifications-operations.fifo
+  notificationsJobsQueue:
+    address: gisl-{env}-{region}-notifications-jobs.fifo
     description: |
-      FIFO SQS queue subscribed to notifications-operations SNS topic.
+      FIFO SQS queue subscribed to notifications-jobs SNS topic.
       Receives both OperationProgress and OperationResult messages.
       Raw Message Delivery enabled (no SNS envelope).
 
       FIFO ensures message ordering per operation (operation_id used as MessageGroupId).
       This guarantees OperationProgress messages arrive before OperationResult.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-notifications-jobs.fifo
+          fifoQueue: true
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1147,8 +1319,8 @@ channels:
       operationResult:
         $ref: '#/components/messages/OperationResultMessage'
 
-  notificationsOperationsDlq:
-    address: gisl-{env}-{region}-notifications-operations-dlq.fifo
+  notificationsJobsDlq:
+    address: gisl-{env}-{region}-notifications-jobs-dlq.fifo
     description: DLQ for failed notification processing. Messages land here after 5 failed processing attempts.
     parameters:
       env:
@@ -1181,6 +1353,12 @@ channels:
       shared `JobRequestMessage` across the per-media `jobs-*` queues); per-queue
       `operation_type` is a publisher invariant documented here, not a separate
       message schema.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-compress-video-longform
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1211,6 +1389,12 @@ channels:
       `LongFormJobMessage` enum permits `{compress, merge}`; per-queue
       `operation_type` is a publisher invariant documented here, not a separate
       schema).
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-merge-video-longform-reencode
+          fifoQueue: false
+        bindingVersion: '0.2.0'
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1291,6 +1475,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/jobsImage'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-jobs-image
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process image compression job
     description: |
       The image compression Lambda consumes jobs for image inputs.
@@ -1305,6 +1495,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/jobsVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-jobs-video
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process video compression job
     description: |
       The video compression Lambda consumes jobs for video inputs.
@@ -1318,6 +1514,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/jobsAudio'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-jobs-audio
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process audio compression job
     description: |
       The audio compression Lambda consumes jobs for audio inputs.
@@ -1331,6 +1533,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/jobsDocument'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-jobs-document
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process document compression job
     description: |
       The document compression Lambda consumes jobs for document inputs.
@@ -1348,6 +1556,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsThumbnail'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-thumbnail
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process legacy thumbnail operation
     description: |
       The legacy thumbnail Lambda consumes thumbnail requests routed
@@ -1363,6 +1577,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsThumbnailImage'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-thumbnail-image
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process image thumbnail operation
     description: |
       The image thumbnail Lambda consumes thumbnail requests routed by
@@ -1375,6 +1595,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsThumbnailVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-thumbnail-video
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process video thumbnail operation
     description: |
       The video thumbnail Lambda consumes thumbnail requests routed by
@@ -1387,6 +1613,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsThumbnailDocument'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-thumbnail-document
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process document thumbnail operation
     description: |
       The document (PDF/EPUB) thumbnail Lambda consumes thumbnail
@@ -1400,6 +1632,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsThumbnailOffice'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-thumbnail-office
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process office document thumbnail operation
     description: |
       The office document (DOCX/XLSX/PPTX/ODT/ODS/ODP) thumbnail Lambda
@@ -1413,6 +1651,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsImageWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-image-watermark
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process image_watermark operation
     description: |
       The operation-image-watermark Lambda consumes image_watermark
@@ -1431,6 +1675,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsTextWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-text-watermark
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process text_watermark operation
     description: |
       The operation-text-watermark Lambda consumes text_watermark
@@ -1444,6 +1694,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsMerge'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-merge
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process merge operation
     description: |
       The merge Lambda consumes merge requests routed by
@@ -1459,6 +1715,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsArchive'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-archive
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process archive operation
     description: |
       The archive Lambda consumes archive requests routed by
@@ -1471,6 +1733,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsConvert'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-convert
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process convert operation
     description: |
       The convert Lambda consumes convert requests routed by
@@ -1483,6 +1751,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsCustomLuma'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-custom-luma
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process custom_luma operation
     description: |
       The `operation-custom-luma` Lambda (cross-repo follow-up — not
@@ -1500,6 +1774,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsAudioOverlay'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-audio-overlay
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process audio_overlay operation
     description: |
       The `operation-audio-overlay` Lambda (cross-repo follow-up —
@@ -1518,17 +1798,24 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsSplit'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-split
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process split operation
     description: |
       The `operation-split` Lambda (lambdas pre-launch epic Wave A)
       consumes split requests routed by `operation_type=split`. Its
-      `audio` path is live on staging (lambdas #161); the
-      `image_gif` / `document_pdf` / `video` workers remain a
-      cross-repo follow-up. Single-input —
+      `audio` + short-form `video` paths are live on staging (lambdas
+      #161 / [`vKI0CFDu`](https://trello.com/c/vKI0CFDu)); the
+      `image_gif` / `document_pdf` workers (and video `long_form` via
+      `split-video-fargate`) remain a cross-repo follow-up. Single-input —
       `media_group` derives from the input MIME prefix per the
       existing single-input rule. `availability: beta` for the `audio`
-      mime_group (worker live on staging); the `image_gif`,
-      `document_pdf`, and `video` mime_groups stay `availability:
+      and `video` (short-form) mime_groups (workers live on staging); the
+      `image_gif` and `document_pdf` mime_groups stay `availability:
       planned`, and the API rejects their workflow-create with
       `feature_not_available` (422) until those Lambdas ship.
       Long-form video splits route to a separate
@@ -1542,6 +1829,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsVideoWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-watermark
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process video_watermark operation
     description: |
       The `operation-video-watermark` Lambda (cross-repo follow-up —
@@ -1562,6 +1855,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsVideoTextWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-text-watermark
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process video_text_watermark operation
     description: |
       The `operation-video-text-watermark` Lambda (cross-repo
@@ -1581,6 +1880,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsAudioToVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-audio-to-video
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process audio_to_video operation
     description: |
       The `operation-audio-to-video` Lambda (cross-repo follow-up —
@@ -1601,6 +1906,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/opsAudioWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-audio-watermark
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Process audio_watermark operation
     description: |
       The `operation-audio-watermark` Lambda (cross-repo follow-up —
@@ -1615,6 +1926,29 @@ operations:
     messages:
       - $ref: '#/channels/opsAudioWatermark/messages/operationRequest'
 
+  consumeRenderVariantsOperation:
+    action: receive
+    channel:
+      $ref: '#/channels/opsRenderVariants'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-render-variants
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Process render_variants operation
+    description: |
+      The `operation-render-variants` Lambda (cross-repo follow-up —
+      not yet shipped) consumes render_variants requests routed by
+      `operation_type=render_variants`. Single-input image fan-out (one
+      source image to N resized / re-encoded variants). `availability:
+      planned`; the API rejects workflow-create with
+      `feature_not_available` (422) until the Lambda + this subscription
+      ship, so traffic does not reach this channel today. Per ticket
+      w3EwzHYd.
+    messages:
+      - $ref: '#/channels/opsRenderVariants/messages/operationRequest'
+
   # ============================================
   # NOTIFICATION OPERATIONS
   # ============================================
@@ -1622,37 +1956,67 @@ operations:
   publishOperationProgress:
     action: send
     channel:
-      $ref: '#/channels/notificationsOperationsTopic'
+      $ref: '#/channels/notificationsJobsTopic'
+    # Operation-level SNS binding: Microcks reads OPERATION bindings (not
+    # the channel binding) for protocol detection — without it the SEND op
+    # registers under Microcks' Kafka default and SNS conformance can't
+    # bind. The cli@6.0.0-bundled SNS 0.1.0 schema requires a non-empty
+    # consumers[] EVEN on send ops (the "consumers only for receive" rule
+    # is 1.0.0, which cli rejects), so we declare the topic's real consumer
+    # — the API FIFO SQS queue with raw message delivery. bindingVersion
+    # 0.1.0 mirrors the channel pin. Per z7VkTNmN producer pillar.
+    bindings:
+      sns:
+        consumers:
+          - protocol: sqs
+            endpoint:
+              name: gisl-{env}-{region}-notifications-jobs.fifo
+            rawMessageDelivery: true
+        bindingVersion: '0.1.0'
     summary: Publish operation progress update
     description: |
       Lambda publishes progress updates during operation processing.
       These are lightweight messages for real-time status tracking.
     messages:
-      - $ref: '#/channels/notificationsOperationsTopic/messages/operationProgress'
+      - $ref: '#/channels/notificationsJobsTopic/messages/operationProgress'
 
   publishOperationResult:
     action: send
     channel:
-      $ref: '#/channels/notificationsOperationsTopic'
+      $ref: '#/channels/notificationsJobsTopic'
+    bindings:
+      sns:
+        consumers:
+          - protocol: sqs
+            endpoint:
+              name: gisl-{env}-{region}-notifications-jobs.fifo
+            rawMessageDelivery: true
+        bindingVersion: '0.1.0'
     summary: Publish operation result
     description: |
       Lambda publishes the final result when operation completes or fails.
       This is a terminal message with full details.
     messages:
-      - $ref: '#/channels/notificationsOperationsTopic/messages/operationResult'
+      - $ref: '#/channels/notificationsJobsTopic/messages/operationResult'
 
   consumeOperationNotifications:
     action: receive
     channel:
-      $ref: '#/channels/notificationsOperationsQueue'
+      $ref: '#/channels/notificationsJobsQueue'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-notifications-jobs.fifo
+            fifoQueue: true
+        bindingVersion: '0.2.0'
     summary: Consume operation notifications
     description: |
       API worker consumes both progress and result notifications from SQS.
       - OperationProgress: Update Redis cache for real-time status (forwarded to frontend via SSE)
       - OperationResult: Update database Operation entity, derive Job/Workflow status
     messages:
-      - $ref: '#/channels/notificationsOperationsQueue/messages/operationProgress'
-      - $ref: '#/channels/notificationsOperationsQueue/messages/operationResult'
+      - $ref: '#/channels/notificationsJobsQueue/messages/operationProgress'
+      - $ref: '#/channels/notificationsJobsQueue/messages/operationResult'
 
   # ============================================
   # UPLOAD-PROBE OPERATIONS (per ticket vBlEurU7)
@@ -1681,6 +2045,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/uploadProbeQueue'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-upload-probe
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Consume an upload-probe request (async branch)
     description: |
       The upload-probe Lambda consumes from the SQS queue subscribed
@@ -1698,6 +2068,12 @@ operations:
     action: send
     channel:
       $ref: '#/channels/uploadProbeCompletionsQueue'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-upload-probe-completions
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Publish an upload-probe completion (async branch)
     description: |
       The upload-probe Lambda publishes the result of the async
@@ -1719,6 +2095,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/uploadProbeCompletionsQueue'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-upload-probe-completions
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Consume an upload-probe completion (async branch)
     description: |
       The API consumer worker reads completions from this queue and
@@ -1737,6 +2119,12 @@ operations:
     action: send
     channel:
       $ref: '#/channels/longformCompressVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-compress-video-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Publish a long-form video compression claim-check.
     description: |
       The API (`SqsLongFormOperationPublisherAdapter`) writes the full job
@@ -1750,6 +2138,12 @@ operations:
     action: send
     channel:
       $ref: '#/channels/longformMergeVideoReencode'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-merge-video-longform-reencode
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Publish a long-form merge re-encode claim-check.
     description: |
       As `publishLongFormCompressVideo`, for `operation_type = merge`
@@ -1765,6 +2159,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/longformCompressVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-compress-video-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Consume a long-form video compression claim-check.
     description: |
       A terraform-owned launcher (EventBridge Pipe, filter=none -> launcher
@@ -1779,6 +2179,12 @@ operations:
     action: receive
     channel:
       $ref: '#/channels/longformMergeVideoReencode'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-merge-video-longform-reencode
+            fifoQueue: false
+        bindingVersion: '0.2.0'
     summary: Consume a long-form merge re-encode claim-check.
     description: |
       As `consumeLongFormCompressVideo`, for `operation_type = merge`
@@ -2709,6 +3115,13 @@ components:
             Operation type used as the SNS filter attribute on the
             `operations` topic. The sole routing key for non-compression
             traffic.
+
+            **`passthrough` is deliberately excluded** from this enum: a
+            `passthrough` operation never goes on the wire. The API
+            self-completes a passthrough source job at publish (terminal
+            output = the upload bytes unchanged), so nothing is published
+            to SNS and there is no `ops-passthrough` queue. Per ticket
+            `4som89Uh`.
           enum:
             - thumbnail
             - thumbnail_image
@@ -2727,6 +3140,7 @@ components:
             - video_watermark
             - video_text_watermark
             - split
+            - render_variants
         media_group:
           type: string
           description: |
@@ -2884,6 +3298,11 @@ components:
         - operation_type
         - output_bucket
         - output_key_prefix
+      # No `passthrough` branch below: a passthrough source job is
+      # self-completed by the API at publish (output = upload bytes
+      # unchanged) and is never published as an OperationRequest message,
+      # so it has no single-input/multi-input required-field branch here.
+      # Per ticket 4som89Uh.
       allOf:
         - if:
             properties:
@@ -2896,6 +3315,7 @@ components:
                   - audio_watermark
                   - video_text_watermark
                   - split
+                  - render_variants
           then:
             required:
               - file_type
@@ -3174,6 +3594,33 @@ components:
             silently drop this sibling per-input audio override at the wire
             boundary.
           example: 0.5
+        trim_start:
+          type: number
+          minimum: 0
+          description: |
+            Per-input trim from the beginning, in seconds, applied to
+            this input BEFORE the transition/crossfade step. Mirrors
+            `merge.{video,audio}.per_input_options.trim_start` in
+            `schemas/operations/merge.yaml`; same "trim from beginning"
+            semantic as `compress` trim. No `maximum` — the upper bound
+            is the input's own duration, enforced by the worker, not
+            statically bounded at the wire. Wire slot added so the API
+            does not drop this per-input override at the boundary
+            (mirrors the crossfade_duration/gap_duration precedent).
+          example: 1.5
+        trim_end:
+          type: number
+          minimum: 0
+          description: |
+            Per-input trim from the end, in seconds, applied to this
+            input BEFORE the transition/crossfade step. Mirrors
+            `merge.{video,audio}.per_input_options.trim_end` in
+            `schemas/operations/merge.yaml`; same "trim from end"
+            semantic as `compress` trim. No `maximum` — bounded by the
+            input's own duration at the worker, not statically. Wire
+            slot added so the API does not drop this per-input override
+            at the boundary.
+          example: 2.0
 
     # ============================================
     # OPERATION PROGRESS SCHEMA
@@ -3419,6 +3866,8 @@ components:
 
         metrics:
           $ref: '#/components/schemas/OperationMetrics'
+        result_metadata:
+          $ref: '#/components/schemas/OperationResultMetadata'
 
         # Failure fields
         error_code:
@@ -3438,6 +3887,32 @@ components:
           description: Progress percentage when the operation failed (failed only)
           example: 10
 
+    OperationResultMetadata:
+      type: object
+      additionalProperties: false
+      description: |
+        Whitelisted, named operation-level result metadata — a **CLOSED**
+        set of declared keys carried on the wire result (Lambda → API). The
+        API persists only declared keys and serves only declared keys (a
+        whitelist projection on the read side), never the raw bag, so
+        internal diagnostics never leak. New keys are **additive named
+        cuts**. Twin of the OpenAPI `OperationResultMetadata` (wire ↔ read
+        parity — same named-prop shape). Distinct from the deliverable
+        output (`output_key` / `outputs[]`): small per-operation metadata,
+        not the file. Per ticket EurbZLMH (B1).
+      properties:
+        watermark_id:
+          type: string
+          format: uuid
+          description: |
+            UUIDv7 of the watermark embedded by an `audio_watermark`
+            operation (for later decode/verify). **Display-only / not yet
+            populated** — gated on the audio_watermark Lambda (EvPl5fkH, B3)
+            + the watermark registry (B2, deferred). The field + whitelist
+            ship now (additive) so the pipeline + read projection land
+            without a later contract bump; absent until B3 is live.
+          example: "018f9c42-5d6b-7481-b3df-9fd0a0a5e112"
+
     OperationResultOutputEntry:
       type: object
       description: |
@@ -3463,9 +3938,11 @@ components:
           not: { required: [page_index] }
         - title: Unindexed
           description: |
-            Output without an explicit indexing field. Reserved for future
-            operations that index by something other than page/position.
-            Schema-valid but not currently emitted by any operation.
+            Output without a page/position indexing field. Covers legacy
+            single-output entries AND `render_variants` variant outputs (the
+            latter carry the optional `target_id` correlation field — the
+            image-fan-out addressing contract — but are not page/position
+            indexed). Per ADR-0009 §D2.
           not:
             anyOf:
               - required: [page_index]
@@ -3502,6 +3979,18 @@ components:
             strip, chapter split). Mutually exclusive with `page_index`.
             Per ADR-0009 §D2.
           example: 0
+        target_id:
+          type: string
+          pattern: '^[A-Za-z0-9._-]+$'
+          maxLength: 64
+          description: |
+            The caller-assigned `id` of the `render_variants` target that
+            produced this output, echoed verbatim — the addressing contract
+            for image fan-out. Carried on the `Unindexed` branch (variant
+            outputs are not page/position indexed); no operation emits
+            `target_id` together with `page_index` / `position`. Per ticket
+            `w3EwzHYd`.
+          example: "thumb-2x"
 
     # ============================================
     # WORKFLOW STATE CHANGED (per ticket I24)
@@ -4162,11 +4651,19 @@ components:
           `processing_class`. `media_group` derives from the input
           MIME prefix per the existing single-input rule (no
           operation-specific conditional needed). `availability: beta`
-          for the `audio` mime_group (`image_gif` / `document_pdf` /
-          `video` stay `planned`); routes via `operation_type=split`
+          for the `audio` and `video` (short-form) mime_groups
+          (`image_gif` / `document_pdf` and video `long_form` stay
+          `planned`); routes via `operation_type=split`
           to `ops-split`.
           Per ADR-0004 + ADR-0014
           ([`vKI0CFDu`](https://trello.com/c/vKI0CFDu)).
+
+        Note: the `passthrough` OpenAPI operation is **deliberately
+        absent** from this payload enum. A passthrough source job is
+        self-completed by the API at publish (its output is the upload
+        bytes unchanged) and is never dispatched as an
+        `OperationRequest` message — so it carries no wire payload and
+        needs no SNS routing value. Per ticket `4som89Uh`.
       enum:
         - compress
         - thumbnail
@@ -4182,6 +4679,7 @@ components:
         - video_watermark
         - video_text_watermark
         - split
+        - render_variants
 
     MediaGroup:
       type: string