@giveitsmaller/contracts 0.41.0 → 0.42.0

package/dist/operations/thumbnail.metadata.js

@@ -28,6 +28,35 @@ export const thumbnailMetadata = {
                 quality: {
                     per_value_availability: {},
                 },
+                background: {
+                    per_value_availability: {},
+                },
+            },
+            per_input_options: {},
+        },
+        image_svg: {
+            availability: 'planned',
+            processing_class: {},
+            per_mime_availability: {},
+            options: {
+                width: {
+                    per_value_availability: {},
+                },
+                height: {
+                    per_value_availability: {},
+                },
+                fit: {
+                    per_value_availability: {},
+                },
+                format: {
+                    per_value_availability: {},
+                },
+                quality: {
+                    per_value_availability: {},
+                },
+                background: {
+                    per_value_availability: {},
+                },
             },
             per_input_options: {},
         },

package/dist/operations/video_watermark.metadata.js

@@ -4,7 +4,7 @@ export const videoWatermarkMetadata = {
     features: {
         multi_overlay_stack: {
             availability: 'planned',
-            description: 'Allow up to 8 overlay inputs per job (currently capped at 1 overlay). Per-overlay placement via JobInputV2.per_input_options. Lambda-side support not yet confirmed; tagged planned per ADR-0001 §1.4. Mirrors the same-named feature on `image_watermark`. ',
+            description: 'Allow up to 8 overlay inputs per job (currently capped at 1 overlay). Per-overlay placement via per-input placement options. Backend support not yet confirmed; tagged planned. Mirrors the same-named feature on `image_watermark`. ',
         },
     },
     mime_groups: {

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.117.0
+  version: 2.123.0
   contact:
     name: API Support
 
@@ -7198,8 +7198,8 @@ components:
         - thumbnail_office: Office document (DOCX/XLSX/PPTX/ODT/ODS/ODP)
           thumbnail sub-type. Backed by a dedicated LibreOffice Lambda.
           Emitted by the publisher for office-document inputs.
-        - image_watermark: Image overlay onto a base IMAGE asset. Multi-input (Path B with role: base + overlay). Each input is a `MultiInputSource` (external_import / connection / job_output — no upload-direct); an uploaded base or overlay enters via a `passthrough` source job referenced by `job_output`. Stable for static-image bases (jpeg/png/webp); animated GIF is advertised as `planned` via the `image_gif` mime_group — dispatch returns `feature_not_available` (422) until Lambda support ships. Video bases are NOT supported by image_watermark — use the dedicated `video_watermark` operation per ADR-0013. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
-        - text_watermark: Text overlay rendered onto an image (Liberation Sans). Single-input. Per ADR-0004 + I4-CONS.
+        - image_watermark: Image overlay onto a base IMAGE asset. Multi-input (Path B with role: base + overlay). Each input is a `MultiInputSource` (external_import / connection / job_output — no upload-direct); an uploaded base or overlay enters via a `passthrough` source job referenced by `job_output`. Stable for static-image bases (jpeg/png/webp); animated GIF (`image_gif`), TIFF (`image_tiff`) and BMP (`image_bmp`) bases are advertised as `planned` via parallel mime_groups — dispatch returns `feature_not_available` (422) until Lambda support ships. Video bases are NOT supported by image_watermark — use the dedicated `video_watermark` operation per ADR-0013. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
+        - text_watermark: Text overlay rendered onto an image (Liberation Sans). Single-input. Stable for jpeg/png/webp; TIFF (`image_tiff`) and BMP (`image_bmp`) inputs are advertised as `planned` — dispatch returns `feature_not_available` (422) until Lambda support ships. Per ADR-0004 + I4-CONS.
         - merge: Concatenate/combine multiple files into one (images, video, audio). Multi-input. Image inputs merge into animated GIF or slideshow video; image collage/grid and PDF concatenation are not supported by the V1 Lambda.
         - archive: Bundle files into ZIP/tar.gz (all types). Multi-input.
         - convert: Change file format (all types)

package/operation-capabilities/operation-capabilities.json

@@ -515,5 +515,5 @@
       "isAnimated": "maybe"
     }
   },
-  "schema_version": "2.117.0"
+  "schema_version": "2.123.0"
 }

package/operations/schemas/archive.yaml

@@ -27,4 +27,4 @@ operation:
         # is advertised-ahead `planned` (returns feature_not_available) until the
         # worker implements per-source subfoldering. Honesty pass 2026-06-20.
         by_job: { availability: planned }
-      description: "flat = all files together at the top level (default); by_job = a separate subfolder for each source (planned — not yet honored by the worker)"
+      description: "flat = all files together at the top level (default); by_job = a separate subfolder for each source (planned — not yet supported)"

package/operations/schemas/audio_overlay.yaml

@@ -15,12 +15,12 @@ operation:
     operation (planned per ticket I20).
 
     Multi-input (Path B with `role: base` + `role: overlay` per
-    `JobInputV2.role`). `min_inputs: 2 = max_inputs: 2` for V2.0;
+    the input role). `min_inputs: 2 = max_inputs: 2` for V2.0;
     multi-overlay support is advertised as a planned feature
-    (`features.multi_overlay_stack`) but Lambda-side implementation
+    (`features.multi_overlay_stack`) but Backend implementation
     deferred.
 
-    Each input is a `MultiInputSource` — imported externally,
+    Each input is imported externally,
     referenced from a vault connection, or an upstream `job_output`
     (uploads are NOT referenced directly inside inputs[]). An uploaded
     overlay or base enters via a `passthrough` source job referenced by
@@ -31,9 +31,7 @@ operation:
     the video's audio track and the visual track passes through
     untouched.
 
-    Per ADR-0001 §1.3 (Tension 1 — `planned` operations return
-    `feature_not_available` 422 until Lambda support ships). Per
-    ADR-0004 §"V2 JobDefinition" + plan v5 §F1 round 6.
+    `planned` — not yet supported.
   default: false
   input_model: multi
   sole_op: true   # bypasses V1 chain validation — must be the only operation in its job (ADR-0025)
@@ -58,9 +56,9 @@ operation:
       description: |
         Allow up to 8 overlay inputs per job (currently capped at 1
         overlay). Per-overlay placement via
-        `JobInputV2.per_input_options`. Lambda-side support not yet
-        confirmed; tagged `planned` per ADR-0001 §1.4. Mirrors the
-        same-named feature on `image_watermark`.
+        per-input placement options. Backend support not yet
+        confirmed; tagged `planned`. Mirrors the same-named feature on
+        `image_watermark`.
 
     sync_to_silence:
       availability: planned
@@ -71,7 +69,7 @@ operation:
         silence detection runs at workflow-create time; the actual
         overlay start position is reported on
         `OperationMetrics.overlay_anchor_ms`. Gates two extra
-        options: `silence_threshold_db` and `min_silence_ms`. Lambda
+        options: `silence_threshold_db` and `min_silence_ms`. backend
         support not yet shipped.
 
   mime_groups:
@@ -400,7 +398,7 @@ operation:
             - `create_silent`: synthesise a silent base track at the
               video's framerate and mix the overlay into that.
             - `replace`: same as `create_silent` but signals intent
-              ("the overlay IS the audio track"), letting Lambda
+              ("the overlay IS the audio track"), letting backend
               skip the base-track synthesis when the overlay covers
               the full video duration.
 

package/operations/schemas/audio_to_video.yaml

@@ -14,9 +14,7 @@ operation:
     OPTIONAL `overlay` (still image, 0..1). When `overlay` is
     omitted, the video uses a solid `background_color`. The
     machine-readable cardinality lives in `per_role_cardinality`
-    on this schema (per ADR-0015). API consumption site:
-    `OperationInputRoleValidator` (rule table) consumed by
-    `SchemaValidationService.php` in `compression_api`.
+    on this schema.
 
     **Input vs output asymmetry.** The single `mime_groups.audio`
     block keys the INPUT MIME family (the `base` role input is
@@ -25,15 +23,13 @@ operation:
     the `audio_overlay.video` group pattern (input-keyed).
 
     Re-encode required (audio → video composition always re-encodes).
-    Lower framerate + FFmpeg `-tune stillimage` keeps file size
-    tiny when the overlay is a still image (the common case).
+    A lower framerate plus still-image tuning keeps file size tiny
+    when the overlay is a still image (the common case).
 
-    Per ticket [`SlluxMBN`](https://trello.com/c/SlluxMBN) +
-    ADR-0015. Activated to `availability: beta` (Wave A, ticket
-    [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the cross-repo
-    Lambda backend is live (API accepts + publishes), so this is
-    shape-stable + opt-in for callers and MUST NOT return
-    `feature_not_available` — it may still change with notice while beta.
+    Activated to `availability: beta`: the backend is live (API
+    accepts + publishes), so this is shape-stable + opt-in for callers
+    and MUST NOT return `feature_not_available` — it may still change
+    with notice while beta.
 
   default: false
   input_model: multi

package/operations/schemas/audio_watermark.yaml

@@ -27,11 +27,7 @@ operation:
     + audited; the decoder will refuse to extract from media the
     caller did not mark themselves) — pin per spike S11 acceptance.
 
-    Per ADR-0001 §1.3 (Tension 1 — `planned` operations return
-    `feature_not_available` 422 until Lambda support ships).
-    Per plan v5 §F1 round 6 (codex narrowed methods enum from 5 to 3,
-    dropping `spread_spectrum` / `echo_hiding` / `phase_coding` —
-    textbook families, not product choices).
+    `planned` — not yet supported.
   default: false
   input_model: single