@giveitsmaller/contracts 0.80.0 → 0.82.0

package/README.md

@@ -5,8 +5,8 @@
 
 | | |
 |---|---|
-| Package version | `0.80.0` |
-| Generated from spec | **`v2.215.0`** |
+| Package version | `0.82.0` |
+| Generated from spec | **`v2.217.0`** |
 
 ## Two version lines, and they are not comparable
 

package/accepted-options/accepted-options.json

@@ -1214,5 +1214,5 @@
       }
     }
   },
-  "schema_version": "2.215.0"
+  "schema_version": "2.217.0"
 }

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

@@ -260,5 +260,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.215.0"
+  "schema_version": "2.217.0"
 }

package/anonymous-policy.yaml

@@ -0,0 +1,41 @@
+# Anonymous (account-less) policy — the ONE declaration of what a guest may do
+# (ticket UQ7zROTr; sdks u6Q9oxuI follow-up; owner decision 610(4), 2026-09-26:
+# guests stay images-only with the daily limit).
+#
+# Read by: the SDKs (gisl.anonymous() / Gisl::anonymous() pin their surface to
+# it), api (pins its constants to it: AnonymousOperationPolicy,
+# AnonymousUploadPolicy, TieredRateLimiterService), and
+# tests/test_anonymous_policy.py (holds the relations below).
+#
+# The refusals are declared in openapi `POST /api/workflows` 403
+# (AnonymousOperationNotAllowedResponse / AnonymousQuotaExhaustedResponse);
+# this file declares the POLICY that produces them, so a client can predict
+# the 403 instead of learning it.
+
+schema_version: "1.0.0"
+
+# Operations an anonymous caller may request at workflow-create. Anything else
+# answers 403 `anonymous_operation_not_allowed`.
+operations_allowed: [compress, convert, thumbnail]
+
+upload:
+  # Only images: any `image/*` MIME.
+  mime_prefixes: ["image/"]
+  # THE guest per-file cap: 10,000,000 B, the single-shot endpoint's own maximum
+  # (openapi UploadThresholds.single_shot_max_bytes). Guests upload single-shot
+  # only, so a larger cap would be unreachable. api lowers its
+  # AnonymousUploadPolicy from 10 MiB to this and pins to this file (xOaNkDll,
+  # 2026-09-26; owner decision 610(4): "images only, 10 MB").
+  max_file_bytes: 10000000
+  # Multipart initiate/status/presign/keepalive require authentication (api
+  # security.yaml + a defensive 401 in initiate); complete is unreachable
+  # without an initiated session.
+  multipart_allowed: false
+
+quota:
+  # Rolling 24 h, per client IP. The 31st create answers 403 `anonymous_quota_exhausted`.
+  workflow_creates_per_ip_per_24h: 30
+  # Per-minute rate limits (429 when exceeded).
+  per_minute:
+    upload: 5
+    workflow_create: 2

package/availability/availability.json

@@ -1,6 +1,6 @@
 {
   "capabilities_profile": "baseline",
-  "capabilities_version": 224,
+  "capabilities_version": 231,
   "endpoints": {
     "DELETE /api/auth/account": {
       "auth": "required",
@@ -251,7 +251,7 @@
       "required_tier": null
     },
     "POST /api/operations/{id}/retry": {
-      "auth": "optional",
+      "auth": "required",
       "availability": "stable",
       "identity_scoped": true,
       "operation_id": "retryOperation",
@@ -265,14 +265,14 @@
       "required_tier": null
     },
     "POST /api/uploads/multipart/complete": {
-      "auth": "optional",
+      "auth": "required",
       "availability": "stable",
       "identity_scoped": true,
       "operation_id": "multipartComplete",
       "required_tier": null
     },
     "POST /api/uploads/multipart/initiate": {
-      "auth": "optional",
+      "auth": "required",
       "availability": "stable",
       "identity_scoped": false,
       "operation_id": "multipartInitiate",
@@ -519,6 +519,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -537,6 +543,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -682,6 +692,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -700,6 +716,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -730,6 +750,9 @@
       "max_inputs": 2,
       "mime_groups": {
         "audio": {
+          "ceiling_basis": {
+            "max_input_duration": "unproven"
+          },
           "max_input_duration": "PT2H",
           "mimes": [
             "audio/mpeg",
@@ -859,6 +882,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -877,6 +906,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -936,6 +969,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -954,6 +993,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -1041,6 +1084,9 @@
           }
         },
         "document_epub": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 209715200,
           "mimes": [
             "application/epub+zip"
@@ -1066,6 +1112,9 @@
           }
         },
         "document_odf": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 209715200,
           "mimes": [
             "application/vnd.oasis.opendocument.text",
@@ -1093,6 +1142,9 @@
           }
         },
         "document_office": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 209715200,
           "mimes": [
             "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
@@ -1125,6 +1177,9 @@
           }
         },
         "image": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "unproven"
+          },
           "max_input_size_bytes": 524288000,
           "max_output_pixels": 16000000,
           "mimes": [
@@ -1249,6 +1304,9 @@
           }
         },
         "image_avif": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 20971520,
           "max_output_pixels": 16000000,
           "mimes": [
@@ -1420,7 +1478,12 @@
           }
         },
         "image_jpeg": {
-          "max_input_size_bytes": 524288000,
+          "ceiling_basis": {
+            "max_input_pixels": "proven",
+            "max_input_size_bytes": "proven"
+          },
+          "max_input_pixels": 90000000,
+          "max_input_size_bytes": 370000000,
           "max_output_pixels": 16000000,
           "mimes": [
             "image/jpeg"
@@ -1613,7 +1676,12 @@
           }
         },
         "image_png": {
-          "max_input_size_bytes": 524288000,
+          "ceiling_basis": {
+            "max_input_pixels": "unproven",
+            "max_input_size_bytes": "proven"
+          },
+          "max_input_pixels": 100000000,
+          "max_input_size_bytes": 360000000,
           "max_output_pixels": 16000000,
           "mimes": [
             "image/png"
@@ -1739,7 +1807,10 @@
           }
         },
         "image_svg": {
-          "max_input_size_bytes": 524288000,
+          "ceiling_basis": {
+            "max_input_size_bytes": "unproven"
+          },
+          "max_input_size_bytes": 1000000,
           "mimes": [
             "image/svg+xml"
           ],
@@ -1783,7 +1854,12 @@
           }
         },
         "image_webp": {
-          "max_input_size_bytes": 524288000,
+          "ceiling_basis": {
+            "max_input_pixels": "proven",
+            "max_input_size_bytes": "proven"
+          },
+          "max_input_pixels": 75000000,
+          "max_input_size_bytes": 270000000,
           "max_output_pixels": 16000000,
           "mimes": [
             "image/webp"
@@ -2129,6 +2205,12 @@
           "processing_class": {
             "long_form": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -2147,6 +2229,10 @@
             },
             "short_form": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_input_duration": "proven",
+                "max_input_size_bytes": "proven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -2663,6 +2749,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -2681,10 +2773,39 @@
             },
             "short_form": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
                 "max_output_size_bytes": 524288000
+              },
+              "resolution_bands": {
+                "gt_1080p": {
+                  "basis": "not_served"
+                },
+                "le_720p": {
+                  "basis": "proven",
+                  "constraints": {
+                    "max_input_duration": "PT2M25S"
+                  },
+                  "source": "9c5mOnq1-720p-145s"
+                },
+                "p1080": {
+                  "basis": "proven",
+                  "constraints": {
+                    "max_input_duration": "PT1M20S"
+                  },
+                  "source": "9c5mOnq1-1080p-80s"
+                },
+                "unknown": {
+                  "basis": "ruled",
+                  "constraints": {
+                    "max_input_duration": "PT2M25S"
+                  }
+                }
               }
             }
           }
@@ -2740,6 +2861,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -2758,6 +2885,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -3442,8 +3573,8 @@
               ]
             },
             "normalize_audio": {
-              "default": true,
-              "description": "Normalize audio levels across all clips. NOT available on the long-form path, which forces loudness normalisation off \u2014 a defaulted value is dropped and reported there rather than silently ignored.",
+              "default": false,
+              "description": "Normalize audio levels across all clips. Off by default (the server applies the default when the option is omitted). Known issue: at each join of video clips, audio may lead video by up to about 40 ms with the default (`false`); the offset is per join and does not add up across joins. With `true`, an offset of about 45 ms was measured at a single join; merges with more joins are not yet measured on that setting. Turning it on re-encodes every clip, which lowers the limit: about 120 seconds of combined 720p video was measured to fit, instead of 5 minutes. NOT available on the long-form path, which forces loudness normalisation off.",
               "per_class_availability": {
                 "long_form_re_encode": {
                   "availability": "planned"
@@ -3790,6 +3921,12 @@
           "processing_class": {
             "long_form_re_encode": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_total_duration": "unproven",
+                "max_total_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_total_input_size_bytes": "unproven",
+                "per_tier.max.max_total_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_total_duration": "PT24H",
                 "max_total_input_size_bytes": 5000000000
@@ -3839,9 +3976,13 @@
             },
             "short_form_concat": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_total_duration": "proven",
+                "max_total_input_size_bytes": "proven"
+              },
               "constraints": {
                 "max_total_duration": "PT5M",
-                "max_total_input_size_bytes": 1073741824
+                "max_total_input_size_bytes": 524288000
               }
             }
           }
@@ -4192,6 +4333,12 @@
           "processing_class": {
             "long_form": {
               "availability": "beta",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -4210,6 +4357,10 @@
             },
             "short_form": {
               "availability": "beta",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -4516,6 +4667,9 @@
       "input_model": "single",
       "mime_groups": {
         "document_epub": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 104857600,
           "max_output_pixels": 16000000,
           "mimes": [
@@ -4578,6 +4732,9 @@
           }
         },
         "document_office": {
+          "ceiling_basis": {
+            "max_input_size_bytes": "proven"
+          },
           "max_input_size_bytes": 157286400,
           "max_output_pixels": 16000000,
           "mimes": [
@@ -4857,6 +5014,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000
@@ -4872,9 +5035,13 @@
             },
             "short_form": {
               "availability": "stable",
+              "ceiling_basis": {
+                "max_input_duration": "proven",
+                "max_input_size_bytes": "proven"
+              },
               "constraints": {
-                "max_input_duration": "PT5M",
-                "max_input_size_bytes": 524288000
+                "max_input_duration": "PT30M",
+                "max_input_size_bytes": 950000000
               }
             }
           }
@@ -5004,6 +5171,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -5022,6 +5195,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -5135,6 +5312,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -5153,6 +5336,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -5260,6 +5447,12 @@
           "processing_class": {
             "long_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven",
+                "per_tier.enterprise.max_input_size_bytes": "unproven",
+                "per_tier.max.max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT12H",
                 "max_input_size_bytes": 5000000000,
@@ -5278,6 +5471,10 @@
             },
             "short_form": {
               "availability": "planned",
+              "ceiling_basis": {
+                "max_input_duration": "unproven",
+                "max_input_size_bytes": "unproven"
+              },
               "constraints": {
                 "max_input_duration": "PT5M",
                 "max_input_size_bytes": 524288000,
@@ -5301,7 +5498,7 @@
       "sole_op": true
     }
   },
-  "schema_version": "2.215.0",
+  "schema_version": "2.217.0",
   "source_commit": null,
   "user_tier": null,
   "workflow_features": {