@giveitsmaller/contracts 0.53.0 → 0.55.0

package/openapi/api.yaml

@@ -89,7 +89,7 @@ info:
     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.
-  version: 2.154.0
+  version: 2.162.0
   contact:
     name: API Support
 
@@ -10089,6 +10089,22 @@ components:
             commit, paused/resumed state change, etc.). The API
             always emits this field; spec catches up to behaviour
             shipping since `WorkflowController.php:178-179`.
+        completed_at:
+          type: string
+          format: date-time
+          description: |
+            ISO-8601 timestamp at which the workflow reached a TERMINAL
+            status (`completed` / `failed` / `partially_failed` /
+            `cancelled` / `expired`) — the authoritative completion instant.
+            Unlike `updated_at`, this does NOT move once set: a later
+            credit-settlement (or any other post-terminal row update) bumps
+            `updated_at` but never `completed_at`, so `completed_at` is the
+            reliable basis for a run's wall-clock duration
+            (`completed_at − created_at`).
+            OPTIONAL (additive) — absent while the workflow is non-terminal
+            (`pending` / `in_progress` / `paused_insufficient_credits`) and
+            for legacy rows with no recorded completion instant. Per ticket
+            [`gpXrJwuI`](https://trello.com/c/gpXrJwuI).
         jobs:
           type: array
           items:
@@ -10260,6 +10276,19 @@ components:
           type: string
           format: date-time
           description: ISO-8601 workflow-creation timestamp (the list sort key, DESC).
+        completed_at:
+          type: string
+          format: date-time
+          description: |
+            ISO-8601 timestamp at which the workflow reached a TERMINAL
+            status — the authoritative completion instant, stable once set (a
+            later credit-settlement update never moves it, unlike a plain
+            last-updated timestamp). The list row derives a run's wall-clock
+            duration from `completed_at − created_at`.
+            OPTIONAL (additive) — absent while the workflow is non-terminal
+            and for legacy rows with no recorded completion instant. Mirrors
+            `WorkflowStatusResponse.completed_at`. Per ticket
+            [`gpXrJwuI`](https://trello.com/c/gpXrJwuI).
         jobs:
           type: array
           items:
@@ -10818,6 +10847,29 @@ components:
             $ref: '#/components/schemas/JobDownload'
         bundle:
           $ref: '#/components/schemas/DownloadBundle'
+        retention_expires_at:
+          type: string
+          format: date-time
+          description: |
+            When this workflow's downloadable outputs are purged and the
+            download links stop working (RFC 3339 / ISO-8601). Server-computed
+            as the workflow's `created_at` plus the account's effective
+            **download-retention window** (per-tier: free 7 days / paid 30 days
+            / enterprise custom — ticket
+            [`G58ei6Z9`](https://trello.com/c/G58ei6Z9)). Lets consumers render
+            a proactive "Downloads available until <date>" affordance without
+            waiting for the list to empty.
+
+            **This is the retention (data-lifecycle) expiry, distinct from
+            `bundle.expires_at`** — that field is the short-lived expiry of a
+            single pre-signed bundle URL, whereas this is when the underlying
+            deliverables themselves are removed.
+
+            Optional. **Absent** when not applicable — no retention window
+            configured, or the workflow's outputs are not yet retained. The
+            enterprise window is per-account (not a public constant), so this
+            expiry cannot be derived client-side and is only available when the
+            server emits it; consumers read it if present.
 
     DownloadBundle:
       type: object

package/operation-capabilities/operation-capabilities.json

@@ -104,7 +104,7 @@
         {
           "availability": "stable",
           "constraint_id": "compress.video.target_size.container",
-          "message": "target_size encoding is mp4/MOV-only; not yet available for {output_format} output. Use crf.",
+          "message": "target_size encoding is mp4/MOV-only; not yet available for {output_container} output. Use crf.",
           "when": {
             "all": [
               {
@@ -112,7 +112,7 @@
                 "field": "compress.encoding_mode"
               },
               {
-                "field": "output_format",
+                "field": "output_container",
                 "in": [
                   "webm",
                   "ogg"
@@ -167,6 +167,25 @@
             ]
           },
           "wire_code": "feature_not_available"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.speed.longform",
+          "eval_scope": "api",
+          "message": "Speed adjustment is not yet available for long-form video. Adjust a short-form clip, or chain a split op.",
+          "when": {
+            "all": [
+              {
+                "equals": "long_form",
+                "field": "processing_class"
+              },
+              {
+                "field": "compress.speed",
+                "isSet": true
+              }
+            ]
+          },
+          "wire_code": "feature_not_available"
         }
       ],
       "input": {
@@ -214,6 +233,139 @@
             ]
           },
           "wire_code": "invalid_options"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.codec_container.webm",
+          "message": "WebM output supports the vp9 or av1 codec; {compress.codec} is incompatible.",
+          "when": {
+            "all": [
+              {
+                "field": "output_container",
+                "in": [
+                  "webm"
+                ]
+              },
+              {
+                "field": "compress.codec",
+                "isSet": true
+              },
+              {
+                "field": "compress.codec",
+                "in": [
+                  "h264",
+                  "h265"
+                ]
+              }
+            ]
+          },
+          "wire_code": "invalid_options"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.codec_container.mp4",
+          "message": "MP4 output supports the h264, h265 or av1 codec; {compress.codec} is incompatible.",
+          "when": {
+            "all": [
+              {
+                "field": "output_container",
+                "in": [
+                  "mp4"
+                ]
+              },
+              {
+                "field": "compress.codec",
+                "isSet": true
+              },
+              {
+                "field": "compress.codec",
+                "in": [
+                  "vp9"
+                ]
+              }
+            ]
+          },
+          "wire_code": "invalid_options"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.codec_container.mov",
+          "message": "MOV output supports the h264 or h265 codec; {compress.codec} is incompatible.",
+          "when": {
+            "all": [
+              {
+                "field": "output_container",
+                "in": [
+                  "mov"
+                ]
+              },
+              {
+                "field": "compress.codec",
+                "isSet": true
+              },
+              {
+                "field": "compress.codec",
+                "in": [
+                  "vp9",
+                  "av1"
+                ]
+              }
+            ]
+          },
+          "wire_code": "invalid_options"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.audio_codec_container.webm",
+          "message": "WebM output supports opus or vorbis audio; {compress.audio_codec} is incompatible.",
+          "when": {
+            "all": [
+              {
+                "field": "output_container",
+                "in": [
+                  "webm"
+                ]
+              },
+              {
+                "field": "compress.audio_codec",
+                "isSet": true
+              },
+              {
+                "field": "compress.audio_codec",
+                "in": [
+                  "aac"
+                ]
+              }
+            ]
+          },
+          "wire_code": "invalid_options"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.audio_codec_container.mp4_mov",
+          "message": "MP4/MOV output supports aac or opus audio; {compress.audio_codec} is incompatible.",
+          "when": {
+            "all": [
+              {
+                "field": "output_container",
+                "in": [
+                  "mp4",
+                  "mov"
+                ]
+              },
+              {
+                "field": "compress.audio_codec",
+                "isSet": true
+              },
+              {
+                "field": "compress.audio_codec",
+                "in": [
+                  "vorbis"
+                ]
+              }
+            ]
+          },
+          "wire_code": "invalid_options"
         }
       ],
       "produces": {
@@ -580,5 +732,5 @@
       "isAnimated": "maybe"
     }
   },
-  "schema_version": "2.154.0"
+  "schema_version": "2.162.0"
 }

package/operations/schemas/compress.yaml

@@ -935,9 +935,17 @@ operation:
             max_input_size_bytes: 524288000        # 500 MiB
             max_output_size_bytes: 524288000
         long_form:
-          # planned -> beta (CON-1, ADR-0011): staging/internal proving
-          # gate before the stable claim (CON-2a). Per-tier caps per D3.
-          availability: beta
+          # planned -> beta (CON-1, ADR-0011) -> stable (CON-2a, 29eZATH0):
+          # staging-proven 2026-07-07 via long-form-compress-shrink.spec.ts
+          # (efficient-HEVC real-presigned-path run: routed long_form +
+          # terminal completed + 62.9% shrink — the BiubmEEJ source-relative
+          # maxrate cap engaged; a plain CRF pass would have inflated 2.43x).
+          # ADR-0006 Form-B (staging run + lambdas file:// cap-logic CI). The
+          # beta->stable flip is an API NO-OP: routing is band-INDEPENDENT
+          # (pure 300s duration + 256MiB size floor), and the eligibility gate
+          # treats beta==stable (only `planned` differs) — API-confirmed.
+          # Per-tier caps per D3.
+          availability: stable
           required_tier: pro
           constraints:                            # baseline = Pro (lowest permitted tier)
             max_input_duration: "PT12H"
@@ -1124,6 +1132,30 @@ operation:
             seconds from the end; with `trim_start` the kept clip is
             [`trim_start`, input_duration − `trim_end`]. See `trim_start`
             (short-form only; long-form is not supported).
+        speed:
+          type: float
+          min: 0.25
+          max: 4.0
+          default: 1.0
+          availability: planned
+          # SHORT-FORM only, mirroring trim: the long-form (Fargate) path does not
+          # apply speed, so it is rejected at create via the
+          # compress.video.speed.longform scope-exclude rather than silently
+          # ignored. `planned` (advertised-ahead, FE-hidden per the bare-planned-
+          # hide rule) until the encoder half lands (lambdas, parallel build) and
+          # it flips per ADR-0006 proof. Name/range/pitch/fps-order settled WITH
+          # lambdas — a pre-flip rename is cheap while planned. Audio pitch is
+          # PRESERVED via ffmpeg `atempo` (tempo-shift, NOT `asetrate` resample).
+          description: >
+            Playback speed multiplier. 1.0 = unchanged (default), 2.0 = twice as
+            fast (half the output duration), 0.5 = half speed (double the
+            duration); range 0.25–4.0. Audio PITCH IS PRESERVED (a tempo-shift,
+            not a resample — ffmpeg `atempo` semantics), so a 2.0x clip sounds
+            sped up, not chipmunked. Applied BEFORE an explicit `fps`: speed
+            re-times the stream, then `fps` (if set) resamples the retimed stream
+            to the target rate. SHORT-FORM only — long-form video returns
+            `feature_not_available` (adjust a short clip, or chain a `split`); see
+            the compress.video.speed.longform constraint.
 
     document_pdf:
       mimes:

package/operations/schemas/merge.yaml

@@ -165,10 +165,14 @@ operation:
             max_total_duration: "PT5M"
             max_total_input_size_bytes: 1073741824   # 1 GiB combined
         long_form_re_encode:
-          # planned -> beta (CON-1, ADR-0011): staging proving gate before
-          # stable (CON-2b). Binding cap = max_total_duration (24h single-
-          # pass budget, SPIKE-0); size is the per-tier secondary cap.
-          availability: beta
+          # planned -> beta (CON-1, ADR-0011) -> stable (CON-2b, HWNXo1kk):
+          # staging-proven 2026-07-07 via long-form-merge.spec.ts Phase 2
+          # (uniform VP9 -> mp4 forces a VP9->h264 transcode; routing-class
+          # persisted to merge-fargate + terminal completed + output codec
+          # != vp9 = Form-B ADR-0006 conformance). Binding cap =
+          # max_total_duration (24h single-pass budget, SPIKE-0); size is the
+          # per-tier secondary cap.
+          availability: stable
           required_tier: pro
           constraints:                              # baseline = Pro (lowest permitted)
             max_total_duration: "PT24H"              # 24h (was PT12H) — binding Enterprise ceiling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.53.0",
+  "version": "0.55.0",
   "description": "Generated contract types for GISL (Give It Smaller)",
   "license": "MIT",
   "type": "module",