@giveitsmaller/contracts 0.5.0 → 0.8.0

package/asyncapi/events.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: GISL Compression Events
-  version: 3.2.0
+  version: 3.3.0
   description: |
     Asynchronous event contracts for the GISL (Give It Smaller) compression service.
 
@@ -1112,6 +1112,79 @@ channels:
       region:
         description: AWS region abbreviation (euw1, use1, etc.)
 
+  # ============================================
+  # LONG-FORM CLAIM-CHECK QUEUES (direct-to-SQS, Fargate-processed)
+  # ============================================
+  # Distinct delivery mechanism from the SNS-fanout jobs/ops families:
+  # the API publishes a LongFormJobMessage claim-check DIRECTLY to these
+  # per-op-class SQS queues (no SNS topic, no filter routing). A
+  # terraform-owned launcher (EventBridge Pipe, filter=none) consumes
+  # and forks a Fargate task. Two classes are live (compress, merge);
+  # split-video-longform (queue provisioned, publisher deferred per
+  # rcwvUKhI) and audio-overlay-longform (reserve-name-only, no queue)
+  # are NOT modeled as channels — they carry no traffic yet.
+
+  longformCompressVideo:
+    address: gisl-{env}-{region}-ops-compress-video-longform
+    description: |
+      SQS queue for long-form video compression jobs (`compress.video.long_form`,
+      `availability: beta`). The API publishes a `LongFormJobMessage` claim-check
+      here directly (NOT via SNS); a terraform-owned launcher reads the spec from
+      S3 (`pointer`) and runs a Fargate task. `max_receive_count = 2` (ADR-0007).
+
+      On this queue the publisher always sets `operation_type: compress`. The
+      shared `LongFormJobMessage` enum permits `{compress, merge}` (mirroring the
+      shared `JobRequestMessage` across the per-media `jobs-*` queues); per-queue
+      `operation_type` is a publisher invariant documented here, not a separate
+      message schema.
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      longFormJob:
+        $ref: '#/components/messages/LongFormJobMessage'
+
+  longformCompressVideoDlq:
+    address: gisl-{env}-{region}-ops-compress-video-longform-dlq
+    description: DLQ for failed long-form video compression jobs. Messages land here after 2 failed processing attempts (ADR-0007).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
+  longformMergeVideoReencode:
+    address: gisl-{env}-{region}-ops-merge-video-longform-reencode
+    description: |
+      SQS queue for long-form merge re-encode jobs (`merge.video.long_form_re_encode`,
+      `availability: beta`). The API publishes a `LongFormJobMessage` claim-check
+      here directly (NOT via SNS); a terraform-owned launcher reads the spec from
+      S3 (`pointer`) and runs a Fargate task. `max_receive_count = 2` (ADR-0007).
+
+      On this queue the publisher always sets `operation_type: merge` (shared
+      `LongFormJobMessage` enum permits `{compress, merge}`; per-queue
+      `operation_type` is a publisher invariant documented here, not a separate
+      schema).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      longFormJob:
+        $ref: '#/components/messages/LongFormJobMessage'
+
+  longformMergeVideoReencodeDlq:
+    address: gisl-{env}-{region}-ops-merge-video-longform-reencode-dlq
+    description: DLQ for failed long-form merge re-encode jobs. Messages land here after 2 failed processing attempts (ADR-0007).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
 operations:
   # ============================================
   # PUBLISH OPERATIONS (API -> SNS)
@@ -1606,6 +1679,64 @@ operations:
     messages:
       - $ref: '#/channels/uploadProbeCompletionsQueue/messages/uploadProbeCompletion'
 
+  # ============================================
+  # LONG-FORM CLAIM-CHECK PRODUCERS (API -> SQS, direct)
+  # ============================================
+
+  publishLongFormCompressVideo:
+    action: send
+    channel:
+      $ref: '#/channels/longformCompressVideo'
+    summary: Publish a long-form video compression claim-check.
+    description: |
+      The API (`SqsLongFormOperationPublisherAdapter`) writes the full job
+      spec to S3 and publishes a `LongFormJobMessage` claim-check **directly**
+      to this SQS queue (NOT via SNS — no message attributes). `operation_type`
+      is `compress`, `processing_class` is `long_form`.
+    messages:
+      - $ref: '#/channels/longformCompressVideo/messages/longFormJob'
+
+  publishLongFormMergeVideoReencode:
+    action: send
+    channel:
+      $ref: '#/channels/longformMergeVideoReencode'
+    summary: Publish a long-form merge re-encode claim-check.
+    description: |
+      As `publishLongFormCompressVideo`, for `operation_type = merge`
+      (`merge.video.long_form_re_encode`). Direct-to-SQS claim-check; no SNS.
+    messages:
+      - $ref: '#/channels/longformMergeVideoReencode/messages/longFormJob'
+
+  # ============================================
+  # LONG-FORM CLAIM-CHECK CONSUMERS (launcher -> Fargate)
+  # ============================================
+
+  consumeLongFormCompressVideo:
+    action: receive
+    channel:
+      $ref: '#/channels/longformCompressVideo'
+    summary: Consume a long-form video compression claim-check.
+    description: |
+      A terraform-owned launcher (EventBridge Pipe, filter=none -> launcher
+      Lambda) reads the `LongFormJobMessage` from this queue, resolves the
+      full job spec from S3 via `pointer`, and runs a Fargate task. The
+      launcher forks on `operation_type` (`compress`) + `processing_class`
+      (`long_form`). Failures redrive to the DLQ after `max_receive_count = 2`.
+    messages:
+      - $ref: '#/channels/longformCompressVideo/messages/longFormJob'
+
+  consumeLongFormMergeVideoReencode:
+    action: receive
+    channel:
+      $ref: '#/channels/longformMergeVideoReencode'
+    summary: Consume a long-form merge re-encode claim-check.
+    description: |
+      As `consumeLongFormCompressVideo`, for `operation_type = merge`
+      (`merge.video.long_form_re_encode`). The launcher resolves the spec
+      from S3 via `pointer` and runs the merge-re-encode Fargate task.
+    messages:
+      - $ref: '#/channels/longformMergeVideoReencode/messages/longFormJob'
+
 components:
   messages:
     # ============================================
@@ -1912,6 +2043,48 @@ components:
             options:
               format: "zip"
 
+    # ============================================
+    # LONG-FORM CLAIM-CHECK JOB MESSAGE (direct-to-SQS, no SNS)
+    # ============================================
+
+    LongFormJobMessage:
+      name: LongFormJob
+      title: Long-Form Claim-Check Job Message
+      summary: Claim-check job message for long-form (Fargate) operations
+      description: |
+        Published by the API **directly to a per-op-class long-form SQS queue**
+        (not via SNS) and consumed by a terraform-owned launcher (EventBridge
+        Pipe, filter=none -> launcher Lambda -> ECS RunTask). The launcher reads
+        the message body, resolves the full job spec from S3 via `pointer`, and
+        forks the Fargate task on `operation_type` + `processing_class`.
+
+        **No SNS message attributes / headers** — long-form does not flow
+        through an SNS topic, so unlike `JobRequestMessage` /
+        `OperationRequestMessage` this message carries no `headers` block.
+
+        See the `LongFormJobMessage` schema for the claim-check field set and
+        the `processing_class` ratification rationale.
+      contentType: application/json
+      payload:
+        $ref: '#/components/schemas/LongFormJobMessage'
+      examples:
+        - name: Long-form video compression
+          summary: compress.video.long_form claim-check
+          payload:
+            pointer: "job-specs/018f9c42-5d6b-7481-b3df-9fd0a0a5e112.json"
+            job_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e112"
+            operation_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e200"
+            operation_type: "compress"
+            processing_class: "long_form"
+        - name: Long-form merge re-encode
+          summary: merge.video.long_form_re_encode claim-check
+          payload:
+            pointer: "job-specs/018f9c42-5d6b-7481-b3df-9fd0a0a5e113.json"
+            job_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e113"
+            operation_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e201"
+            operation_type: "merge"
+            processing_class: "long_form"
+
     # ============================================
     # OPERATION PROGRESS MESSAGE
     # ============================================
@@ -2795,6 +2968,93 @@ components:
             Not used in V1 — all outputs go to GISL-managed S3 buckets.
           additionalProperties: true
 
+    LongFormJobMessage:
+      type: object
+      description: |
+        Claim-check job message for long-form (Fargate-processed) operations.
+        Emitted by the API **directly to the per-op-class long-form SQS queues**
+        (NOT via SNS) — see the `longformCompressVideo` / `longformMergeVideoReencode`
+        channels. The full job spec is written to S3 and this message carries only
+        a `pointer` (the claim check) plus routing/identity fields; the consumer
+        (a terraform-owned launcher Lambda fronting a Fargate worker, invoked via
+        an EventBridge Pipe with no filter) reads the spec from S3 and forks the
+        task on `operation_type` + `processing_class`.
+
+        Distinct from `OperationRequest` (the SNS-routed short-form payload):
+        long-form has its own dedicated SQS queues, carries no SNS message
+        attributes/headers, and uses a claim-check body. `processing_class` is
+        ratified here — and ONLY here — as the logical long-form discriminator
+        (per [ADR-0014](../docs/decisions/0014-split-operation.md) §D10 and
+        `schemas/FORMAT.md` §F8). The physical worker / `execution_pool` /
+        backend-dotted form (e.g. `compress.video.long_form`) is deliberately
+        NOT on the wire — the launcher mints it internally.
+
+        **Live `operation_type` subset: `compress`, `merge`** — the two
+        long-form classes flipped to `availability: beta` (CON-1). `split`
+        long-form (queue provisioned, publisher deferred —
+        [`rcwvUKhI`](https://trello.com/c/rcwvUKhI)) and `audio_overlay`
+        long-form (reserve-name-only, no queue) are NOT yet produced and are
+        therefore absent from this enum; they get added when their publishers
+        ship.
+
+        **Scope: the API producer's first-publish.** This schema models the
+        message the API publishes to the long-form queues — the 5 fields above.
+        It is intentionally an **open object** (no `additionalProperties: false`):
+        these queues may also carry downstream-produced messages (e.g. a
+        `FargateRunner` retry republish of chained long-form ops) whose body
+        shape is owned by the worker/lambdas contract, NOT this schema. Those
+        are out of scope here and are not constrained by `LongFormJobMessage`;
+        consumers validating against this schema MUST tolerate additional or
+        differently-shaped redriven messages. The producer contract this schema
+        pins is the **required** set.
+      required:
+        - pointer
+        - job_id
+        - operation_id
+        - operation_type
+        - processing_class
+      properties:
+        pointer:
+          type: string
+          pattern: '^job-specs/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.json$'
+          description: |
+            Claim-check pointer to the full job spec: an S3 object **key**
+            (NOT a full `s3://` URI, NOT a `{bucket,key}` object), resolved
+            relative to the **input bucket** — the bucket is not encoded in
+            the pointer; the consumer resolves it from its own input-bucket
+            config. Const prefix `job-specs/`; the object is `<jobId>.json`
+            (UUID v7).
+          example: "job-specs/018f9c42-5d6b-7481-b3df-9fd0a0a5e112.json"
+        job_id:
+          type: string
+          format: uuid
+          description: Parent job identifier (UUID v7).
+          example: "018f9c42-5d6b-7481-b3df-9fd0a0a5e112"
+        operation_id:
+          type: string
+          format: uuid
+          description: Unique operation identifier (UUID v7).
+          example: "018f9c42-5d6b-7481-b3df-9fd0a0a5e200"
+        operation_type:
+          type: string
+          enum:
+            - compress
+            - merge
+          description: |
+            Coarse operation verb for the long-form job. Deliberately a
+            call-site subset of `OperationType` — only the long-form classes
+            the API actually publishes today (`compress`, `merge`). NOT the
+            full `OperationType` enum (which would over-promise the wire).
+        processing_class:
+          type: string
+          const: long_form
+          description: |
+            Logical processing class — always the literal `long_form` on this
+            wire (never `short_form` / `blocked`; those exist only on the
+            upload-probe response and HTTP plan surfaces). The launcher forks
+            on this field; do not confuse it with the backend worker identity,
+            which stays off the wire per `schemas/FORMAT.md` §F8.
+
     SourceEntry:
       type: object
       description: |
@@ -3567,12 +3827,22 @@ components:
           description: Container-reported duration (audio + video).
         width:
           type: integer
+          format: int64
           minimum: 1
-          description: Pixel width (image + video; best-effort document).
+          description: |
+            Pixel width (image + video; best-effort document). Declared
+            `int64` so Rust SDK generators emit `i64` instead of the
+            default `i32`; `i32` is fine for everything ffmpeg/libcaesium
+            handles today but the format hint keeps the door open for
+            scientific / RAW imagery without future SDK churn (per
+            ticket [`0sTmbUsc`](https://trello.com/c/0sTmbUsc)).
         height:
           type: integer
+          format: int64
           minimum: 1
-          description: Pixel height (image + video; best-effort document).
+          description: |
+            Pixel height (image + video; best-effort document). See
+            `width` for the `format: int64` rationale.
         codec:
           type: string
           description: |
@@ -3607,12 +3877,16 @@ components:
             `29.97`, `23.976`).
         bitrate_bps:
           type: integer
+          format: int64
           minimum: 0
           description: |
             Overall stream bitrate, **bits per second**. Units in
             the field name, mirroring `duration_seconds`, so SDKs
             avoid the kbps-vs-bps guessing trap. Container-reported
-            for video + audio.
+            for video + audio. Declared `int64` so Rust SDK
+            generators emit `i64` instead of `i32`; `i32` caps at
+            ~2.1 Gbps which is tight for future 4K/8K/RAW workloads
+            (per ticket [`0sTmbUsc`](https://trello.com/c/0sTmbUsc)).
         audio_layout:
           type: string
           description: |

package/availability/availability.json

@@ -1,5 +1,182 @@
 {
-  "capabilities_version": 38,
+  "capabilities_version": 53,
+  "endpoints": {
+    "GET /api/operations/schema": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "getOperationsSchema",
+      "required_tier": null
+    },
+    "GET /api/uploads/multipart/{uploadId}/status": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "multipartStatus",
+      "required_tier": null
+    },
+    "GET /api/uploads/{id}/metadata": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "getUploadMetadata",
+      "required_tier": null
+    },
+    "GET /api/v2/credits/balance": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "getCreditsBalance",
+      "required_tier": null
+    },
+    "GET /api/v2/credits/usage": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "getCreditsUsage",
+      "required_tier": null
+    },
+    "GET /api/workflows/{id}/downloads": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "getWorkflowDownloads",
+      "required_tier": null
+    },
+    "GET /api/workflows/{id}/events": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "streamWorkflowEvents",
+      "required_tier": null
+    },
+    "GET /api/workflows/{id}/status": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "getWorkflowStatus",
+      "required_tier": null
+    },
+    "GET /healthz": {
+      "auth": "anonymous",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "liveness",
+      "required_tier": null
+    },
+    "GET /readyz": {
+      "auth": "anonymous",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "readiness",
+      "required_tier": null
+    },
+    "POST /api/audio-watermark/decode": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "decodeAudioWatermark",
+      "required_tier": null
+    },
+    "POST /api/auth/login": {
+      "auth": "anonymous",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "loginUser",
+      "required_tier": null
+    },
+    "POST /api/auth/logout": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "logoutUser",
+      "required_tier": null
+    },
+    "POST /api/contact": {
+      "auth": "anonymous",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "submitContact",
+      "required_tier": null
+    },
+    "POST /api/external-imports": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "createExternalImport",
+      "required_tier": null
+    },
+    "POST /api/operations/{id}/retry": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "retryOperation",
+      "required_tier": null
+    },
+    "POST /api/uploads": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "uploadFile",
+      "required_tier": null
+    },
+    "POST /api/uploads/multipart/complete": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "multipartComplete",
+      "required_tier": null
+    },
+    "POST /api/uploads/multipart/initiate": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": false,
+      "operation_id": "multipartInitiate",
+      "required_tier": null
+    },
+    "POST /api/uploads/multipart/{uploadId}/keepalive": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "multipartKeepalive",
+      "required_tier": null
+    },
+    "POST /api/uploads/multipart/{uploadId}/presign": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "multipartPresign",
+      "required_tier": null
+    },
+    "POST /api/uploads/{id}/probe": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "probeUpload",
+      "required_tier": null
+    },
+    "POST /api/workflows": {
+      "auth": "optional",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "createWorkflow",
+      "required_tier": null
+    },
+    "POST /api/workflows/{id}/cancel": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "cancelWorkflow",
+      "required_tier": null
+    },
+    "POST /api/workflows/{id}/resume": {
+      "auth": "required",
+      "availability": "stable",
+      "identity_scoped": true,
+      "operation_id": "resumeWorkflow",
+      "required_tier": null
+    }
+  },
   "environment": "baseline",
   "generated_at": null,
   "operations": {
@@ -781,10 +958,7 @@
             "image/webp",
             "image/svg+xml",
             "image/tiff",
-            "image/bmp",
-            "image/vnd.microsoft.icon",
-            "image/avif",
-            "image/heic"
+            "image/avif"
           ],
           "options": {
             "auto_orient": {
@@ -1118,7 +1292,7 @@
             },
             "pages": {
               "default": "1",
-              "description": "Page selection (e.g. '1-5,8'). Each page produces a separate output file.",
+              "description": "Page selection (e.g. '1-5,8'). Each resolved page produces a\nseparate output file. **Maximum 200 resolved entries per\nrequest** \u2014 aligns with the `OperationResult.outputs[]`\n`maxItems: 200` cap per ADR-0009 \u00a7D5\n(`docs/decisions/0009-multi-output-result-envelope.md`).\nExpressions resolving to more than 200 entries (e.g.\n`'1-201'`, `'1-100,102-205'`) are out of contract.\nDuplicate or overlapping entries (e.g. `'1,1'`,\n`'1-100,50-150'`) are counted toward the cap as parsed;\ndeduplication, if any, is a runtime concern and is NOT part\nof this contract. Enforcement at the API edge validator and\nthe Lambda runtime is tracked under WgCqnMRa follow-ups\n(cross-repo: API + Lambdas `bFlEXizR`).\n",
               "type": "string"
             }
           }
@@ -1780,7 +1954,14 @@
                   "always"
                 ]
               },
-              "description": "CRF (quality-targeted) vs target_size (two-pass to fixed file size).\n`target_size` is currently `codec=h264` only \u2014 libx265 / libvpx-vp9 / libsvtav1 each\nrequire a different two-pass invocation and are tracked as separate per-codec\nLambda follow-ups. The contract narrows `target_size_bytes.depends_on` with\n`codec: [h264]`, which rejects `encoding_mode=target_size + codec \u2208 {h265, vp9, av1}`\nas `invalid_options` **when `target_size_bytes` is present in the request**. Fully\ngating `encoding_mode=target_size` itself on codec (so that omitting\n`target_size_bytes` is also rejected) awaits a `per_value_depends_on` schema\nvocab extension (ticket bsV3FWM5); Lambda continues to catch the residual\n`target_size + non-h264 + no target_size_bytes` case in the meantime.\n",
+              "description": "CRF (quality-targeted) vs target_size (two-pass to fixed file size).\n`target_size` is currently `codec=h264` only \u2014 libx265 / libvpx-vp9 / libsvtav1 each\nrequire a different two-pass invocation and are tracked as separate per-codec\nLambda follow-ups. The `per_value_depends_on` block above gates\n`encoding_mode=target_size` itself on `codec \u2208 [h264]`, so a request with\n`encoding_mode=target_size + codec \u2208 {h265, vp9, av1}` is rejected as\n`invalid_options` regardless of whether `target_size_bytes` is supplied \u2014\nclosing the gap left by the previous option-level `depends_on` (which only\ntriggered when `target_size_bytes` was present in the payload). Per ticket\n[`bsV3FWM5`](https://trello.com/c/bsV3FWM5).\n",
+              "per_value_depends_on": {
+                "target_size": {
+                  "codec": [
+                    "h264"
+                  ]
+                }
+              },
               "type": "enum",
               "values": [
                 "crf",
@@ -1845,16 +2026,13 @@
             },
             "target_size_bytes": {
               "depends_on": {
-                "codec": [
-                  "h264"
-                ],
                 "encoding_mode": "target_size",
                 "re_encode_mode": [
                   "auto",
                   "always"
                 ]
               },
-              "description": "Two-pass target file size in bytes (minimum 1 MiB). Required when\n`encoding_mode=target_size`. h264-only today; see `encoding_mode` description\nfor per-codec rollout status.\n\nPractical floor: a ~100 kbps post-AAC video bitrate (i.e. `target_size_bytes`\ncorresponding to less than ~100 kbps of video after subtracting the 160 kbps\nAAC audio track over the merged duration) is silently floored by libx264 and\nthe resulting file will not honour the requested `target_size_bytes`.\nPublishers targeting very small outputs should size accordingly.\n",
+              "description": "Two-pass target file size in bytes (minimum 1 MiB). Required when\n`encoding_mode=target_size`. h264-only \u2014 the codec gate now lives on\n`encoding_mode.per_value_depends_on.target_size.codec` (per ticket\n[`bsV3FWM5`](https://trello.com/c/bsV3FWM5)); this option's own\n`depends_on` no longer duplicates it.\n\nPractical floor: a ~100 kbps post-AAC video bitrate (i.e. `target_size_bytes`\ncorresponding to less than ~100 kbps of video after subtracting the 160 kbps\nAAC audio track over the merged duration) is silently floored by libx264 and\nthe resulting file will not honour the requested `target_size_bytes`.\nPublishers targeting very small outputs should size accordingly.\n",
               "min": 1048576,
               "type": "integer"
             },
@@ -2892,7 +3070,7 @@
       }
     }
   },
-  "schema_version": "2.15.3",
+  "schema_version": "2.21.0",
   "source_commit": null,
   "user_tier": null
 }

package/dist/asyncapi/AnonymousSchema_253.d.ts

@@ -0,0 +1,5 @@
+declare enum AnonymousSchema_253 {
+    COMPRESS = "compress",
+    MERGE = "merge"
+}
+export default AnonymousSchema_253;

package/dist/asyncapi/AnonymousSchema_253.js

@@ -0,0 +1,6 @@
+var AnonymousSchema_253;
+(function (AnonymousSchema_253) {
+    AnonymousSchema_253["COMPRESS"] = "compress";
+    AnonymousSchema_253["MERGE"] = "merge";
+})(AnonymousSchema_253 || (AnonymousSchema_253 = {}));
+export default AnonymousSchema_253;

package/dist/asyncapi/LongFormJobMessage.d.ts

@@ -0,0 +1,10 @@
+import AnonymousSchema_253 from './AnonymousSchema_253.js';
+interface LongFormJobMessage {
+    'pointer': string;
+    'job_id': string;
+    'operation_id': string;
+    'operation_type': AnonymousSchema_253;
+    'processing_class': 'long_form';
+    'additionalProperties'?: Record<string, any>;
+}
+export default LongFormJobMessage;

package/dist/asyncapi/LongFormJobMessage.js

@@ -0,0 +1 @@
+export {};

package/dist/asyncapi/index.d.ts

@@ -1,6 +1,8 @@
+export { default as AnonymousSchema_253 } from './AnonymousSchema_253.js';
 export { default as ErrorCode } from './ErrorCode.js';
 export { default as Failure } from './Failure.js';
 export { default as JobInputRole } from './JobInputRole.js';
+export { default as LongFormJobMessage } from './LongFormJobMessage.js';
 export { default as MergeOutputType } from './MergeOutputType.js';
 export { default as MultiOutputCompletion } from './MultiOutputCompletion.js';
 export { default as NotificationsOperationsQueue } from './NotificationsOperationsQueue.js';

package/dist/asyncapi/index.js

@@ -1,3 +1,4 @@
+export { default as AnonymousSchema_253 } from './AnonymousSchema_253.js';
 export { default as ErrorCode } from './ErrorCode.js';
 export { default as JobInputRole } from './JobInputRole.js';
 export { default as MergeOutputType } from './MergeOutputType.js';

package/dist/openapi/models/AudioWatermarkDecodeRequest.d.ts

@@ -1,8 +1,8 @@
 /**
  * GISL Compression API
- * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag/Last-Modified revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source of truth instead of hardcoding magic numbers. A runtime `GET /api/uploads/limits` endpoint for dynamic discovery (per-tier / per-environment overrides) is a deferred follow-up.
+ * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag/Last-Modified revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source of truth instead of hardcoding magic numbers. A runtime `GET /api/uploads/limits` endpoint for dynamic discovery (per-tier / per-environment overrides) is a deferred follow-up.
  *
- * The version of the OpenAPI document: 2.15.3
+ * The version of the OpenAPI document: 2.21.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).