@giveitsmaller/contracts 0.2.3 → 0.4.0

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

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Effect of a workflow cancel on outstanding credit
+ * reservations.
+ * - `unspent_reservation_released`: caller refunded for the
+ *   unspent portion of the original reservation; refund
+ *   appears as a separate `CreditTransaction` (`type: refund`,
+ *   `reference_type: workflow`, `reference_id` matching the
+ *   cancelled workflow).
+ * - `none`: no refund issued (all reserved credits already
+ *   consumed by completed jobs at cancel time, OR the
+ *   workflow was already terminal in a previous cancel — the
+ *   idempotent re-cancel path).
+ *
+ * @export
+ */
+export declare const WorkflowCancelBillingEffect: {
+    readonly unspent_reservation_released: "unspent_reservation_released";
+    readonly none: "none";
+};
+export type WorkflowCancelBillingEffect = typeof WorkflowCancelBillingEffect[keyof typeof WorkflowCancelBillingEffect];
+export declare function instanceOfWorkflowCancelBillingEffect(value: any): boolean;
+export declare function WorkflowCancelBillingEffectFromJSON(json: any): WorkflowCancelBillingEffect;
+export declare function WorkflowCancelBillingEffectFromJSONTyped(json: any, ignoreDiscriminator: boolean): WorkflowCancelBillingEffect;
+export declare function WorkflowCancelBillingEffectToJSON(value?: WorkflowCancelBillingEffect | null): any;
+export declare function WorkflowCancelBillingEffectToJSONTyped(value: any, ignoreDiscriminator: boolean): WorkflowCancelBillingEffect;

package/dist/openapi/models/WorkflowCancelBillingEffect.js

@@ -0,0 +1,54 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Effect of a workflow cancel on outstanding credit
+ * reservations.
+ * - `unspent_reservation_released`: caller refunded for the
+ *   unspent portion of the original reservation; refund
+ *   appears as a separate `CreditTransaction` (`type: refund`,
+ *   `reference_type: workflow`, `reference_id` matching the
+ *   cancelled workflow).
+ * - `none`: no refund issued (all reserved credits already
+ *   consumed by completed jobs at cancel time, OR the
+ *   workflow was already terminal in a previous cancel — the
+ *   idempotent re-cancel path).
+ *
+ * @export
+ */
+export const WorkflowCancelBillingEffect = {
+    unspent_reservation_released: 'unspent_reservation_released',
+    none: 'none'
+};
+export function instanceOfWorkflowCancelBillingEffect(value) {
+    for (const key in WorkflowCancelBillingEffect) {
+        if (Object.prototype.hasOwnProperty.call(WorkflowCancelBillingEffect, key)) {
+            if (WorkflowCancelBillingEffect[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function WorkflowCancelBillingEffectFromJSON(json) {
+    return WorkflowCancelBillingEffectFromJSONTyped(json, false);
+}
+export function WorkflowCancelBillingEffectFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function WorkflowCancelBillingEffectToJSON(value) {
+    return value;
+}
+export function WorkflowCancelBillingEffectToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -0,0 +1,66 @@
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { WorkflowCancelBillingEffect } from './WorkflowCancelBillingEffect.js';
+/**
+ * Response body for `POST /api/workflows/{id}/cancel`. Per
+ * ticket [I24 `e50uXLcl`](https://trello.com/c/e50uXLcl).
+ *
+ * @export
+ * @interface WorkflowCancelResponse
+ */
+export interface WorkflowCancelResponse {
+    /**
+     * UUID v7 format identifier (time-ordered)
+     * @type {string}
+     * @memberof WorkflowCancelResponse
+     */
+    workflowId: string;
+    /**
+     * Always `cancelled` on a 200 response. The `WorkflowStatus`
+     * enum carries the broader state space; this response is
+     * constrained to the cancel outcome.
+     *
+     * @type {WorkflowCancelResponseStatusEnum}
+     * @memberof WorkflowCancelResponse
+     */
+    status: WorkflowCancelResponseStatusEnum;
+    /**
+     * ISO-8601 timestamp the cancel was applied. Idempotent —
+     * a re-cancel of an already-cancelled workflow returns the
+     * original `cancelled_at`.
+     *
+     * @type {Date}
+     * @memberof WorkflowCancelResponse
+     */
+    cancelledAt: Date;
+    /**
+     *
+     * @type {WorkflowCancelBillingEffect}
+     * @memberof WorkflowCancelResponse
+     */
+    billingEffect: WorkflowCancelBillingEffect;
+}
+/**
+ * @export
+ */
+export declare const WorkflowCancelResponseStatusEnum: {
+    readonly cancelled: "cancelled";
+};
+export type WorkflowCancelResponseStatusEnum = typeof WorkflowCancelResponseStatusEnum[keyof typeof WorkflowCancelResponseStatusEnum];
+/**
+ * Check if a given object implements the WorkflowCancelResponse interface.
+ */
+export declare function instanceOfWorkflowCancelResponse(value: object): value is WorkflowCancelResponse;
+export declare function WorkflowCancelResponseFromJSON(json: any): WorkflowCancelResponse;
+export declare function WorkflowCancelResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): WorkflowCancelResponse;
+export declare function WorkflowCancelResponseToJSON(json: any): WorkflowCancelResponse;
+export declare function WorkflowCancelResponseToJSONTyped(value?: WorkflowCancelResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/WorkflowCancelResponse.js

@@ -0,0 +1,62 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { WorkflowCancelBillingEffectFromJSON, WorkflowCancelBillingEffectToJSON, } from './WorkflowCancelBillingEffect.js';
+/**
+ * @export
+ */
+export const WorkflowCancelResponseStatusEnum = {
+    cancelled: 'cancelled'
+};
+/**
+ * Check if a given object implements the WorkflowCancelResponse interface.
+ */
+export function instanceOfWorkflowCancelResponse(value) {
+    if (!('workflowId' in value) || value['workflowId'] === undefined)
+        return false;
+    if (!('status' in value) || value['status'] === undefined)
+        return false;
+    if (!('cancelledAt' in value) || value['cancelledAt'] === undefined)
+        return false;
+    if (!('billingEffect' in value) || value['billingEffect'] === undefined)
+        return false;
+    return true;
+}
+export function WorkflowCancelResponseFromJSON(json) {
+    return WorkflowCancelResponseFromJSONTyped(json, false);
+}
+export function WorkflowCancelResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'workflowId': json['workflow_id'],
+        'status': json['status'],
+        'cancelledAt': (new Date(json['cancelled_at'])),
+        'billingEffect': WorkflowCancelBillingEffectFromJSON(json['billing_effect']),
+    };
+}
+export function WorkflowCancelResponseToJSON(json) {
+    return WorkflowCancelResponseToJSONTyped(json, false);
+}
+export function WorkflowCancelResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'workflow_id': value['workflowId'],
+        'status': value['status'],
+        'cancelled_at': value['cancelledAt'].toISOString(),
+        'billing_effect': WorkflowCancelBillingEffectToJSON(value['billingEffect']),
+    };
+}

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

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { WorkflowCancelResponse } from './WorkflowCancelResponse.js';
+/**
+ *
+ * @export
+ * @interface WorkflowCancelSuccessEnvelope
+ */
+export interface WorkflowCancelSuccessEnvelope {
+    /**
+     *
+     * @type {WorkflowCancelSuccessEnvelopeSuccessEnum}
+     * @memberof WorkflowCancelSuccessEnvelope
+     */
+    success: WorkflowCancelSuccessEnvelopeSuccessEnum;
+    /**
+     *
+     * @type {WorkflowCancelResponse}
+     * @memberof WorkflowCancelSuccessEnvelope
+     */
+    data: WorkflowCancelResponse;
+}
+/**
+ * @export
+ */
+export declare const WorkflowCancelSuccessEnvelopeSuccessEnum: {
+    readonly true: true;
+};
+export type WorkflowCancelSuccessEnvelopeSuccessEnum = typeof WorkflowCancelSuccessEnvelopeSuccessEnum[keyof typeof WorkflowCancelSuccessEnvelopeSuccessEnum];
+/**
+ * Check if a given object implements the WorkflowCancelSuccessEnvelope interface.
+ */
+export declare function instanceOfWorkflowCancelSuccessEnvelope(value: object): value is WorkflowCancelSuccessEnvelope;
+export declare function WorkflowCancelSuccessEnvelopeFromJSON(json: any): WorkflowCancelSuccessEnvelope;
+export declare function WorkflowCancelSuccessEnvelopeFromJSONTyped(json: any, ignoreDiscriminator: boolean): WorkflowCancelSuccessEnvelope;
+export declare function WorkflowCancelSuccessEnvelopeToJSON(json: any): WorkflowCancelSuccessEnvelope;
+export declare function WorkflowCancelSuccessEnvelopeToJSONTyped(value?: WorkflowCancelSuccessEnvelope | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/WorkflowCancelSuccessEnvelope.js

@@ -0,0 +1,54 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 2.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { WorkflowCancelResponseFromJSON, WorkflowCancelResponseToJSON, } from './WorkflowCancelResponse.js';
+/**
+ * @export
+ */
+export const WorkflowCancelSuccessEnvelopeSuccessEnum = {
+    true: true
+};
+/**
+ * Check if a given object implements the WorkflowCancelSuccessEnvelope interface.
+ */
+export function instanceOfWorkflowCancelSuccessEnvelope(value) {
+    if (!('success' in value) || value['success'] === undefined)
+        return false;
+    if (!('data' in value) || value['data'] === undefined)
+        return false;
+    return true;
+}
+export function WorkflowCancelSuccessEnvelopeFromJSON(json) {
+    return WorkflowCancelSuccessEnvelopeFromJSONTyped(json, false);
+}
+export function WorkflowCancelSuccessEnvelopeFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'success': json['success'],
+        'data': WorkflowCancelResponseFromJSON(json['data']),
+    };
+}
+export function WorkflowCancelSuccessEnvelopeToJSON(json) {
+    return WorkflowCancelSuccessEnvelopeToJSONTyped(json, false);
+}
+export function WorkflowCancelSuccessEnvelopeToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'success': value['success'],
+        'data': WorkflowCancelResponseToJSON(value['data']),
+    };
+}

package/dist/openapi/models/WorkflowCreateRequest.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, watermark, merge, archive, convert) - 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 (CDN-cacheable), health probes return flat objects, and `POST /api/contact` returns 204 with no body.
+ * 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.
  *
- * The version of the OpenAPI document: 2.0.0
+ * The version of the OpenAPI document: 2.12.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -11,8 +11,10 @@
  */
 import type { WorkflowEdge } from './WorkflowEdge.js';
 import type { CallbackEventType } from './CallbackEventType.js';
-import type { ExportConfig } from './ExportConfig.js';
+import type { Delivery } from './Delivery.js';
 import type { JobDefinition } from './JobDefinition.js';
+import type { WorkflowProcessing } from './WorkflowProcessing.js';
+import type { ExternalDestination } from './ExternalDestination.js';
 /**
  *
  * @export
@@ -60,11 +62,43 @@ export interface WorkflowCreateRequest {
      */
     callbackEvents?: Array<CallbackEventType>;
     /**
+     * Optional V2 export destination. When set, all operation
+     * outputs are copied to the customer-controlled destination
+     * in addition to GISL's own S3 storage. Per ADR-0005,
+     * `ExternalDestination` shares shape family with
+     * `ExternalSource` but uses write-permission-based scoping.
+     * Replaces V1 `ExportConfig` (deleted at V2 cutover).
      *
-     * @type {ExportConfig}
+     * @type {ExternalDestination}
      * @memberof WorkflowCreateRequest
      */
-    _export?: ExportConfig;
+    _export?: ExternalDestination;
+    /**
+     * Optional workflow-level delivery configuration per
+     * [ADR-0003](../docs/decisions/0003-delivery-mode.md). When
+     * absent, the workflow defaults to `mode: individual,
+     * selection.type: terminal` (current V1 behaviour). Coexists
+     * with the `archive` operation — `archive` stays first-class
+     * for power-user cases (subset bundles, multi-bundle workflows,
+     * archive chaining, explicit folder/naming control).
+     *
+     * @type {Delivery}
+     * @memberof WorkflowCreateRequest
+     */
+    delivery?: Delivery;
+    /**
+     * Optional workflow-level processing hints per ticket
+     * [I15-CONS](https://trello.com/c/YZpBKzOM). Caller-supplied
+     * logical-policy hint via `processing.class_hint`
+     * (`auto` / `short_form_only` / `long_form_allowed` /
+     * `long_form_preferred`); defaults to `auto` when omitted.
+     * Server is the final authority on routing — `class_hint`
+     * is advisory + policy-shaping, NOT a backend selector.
+     *
+     * @type {WorkflowProcessing}
+     * @memberof WorkflowCreateRequest
+     */
+    processing?: WorkflowProcessing;
 }
 /**
  * Check if a given object implements the WorkflowCreateRequest interface.

package/dist/openapi/models/WorkflowCreateRequest.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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, watermark, merge, archive, convert) - 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 (CDN-cacheable), health probes return flat objects, and `POST /api/contact` returns 204 with no body.
+ * 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.
  *
- * The version of the OpenAPI document: 2.0.0
+ * The version of the OpenAPI document: 2.12.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,8 +13,10 @@
  */
 import { WorkflowEdgeFromJSON, WorkflowEdgeToJSON, } from './WorkflowEdge.js';
 import { CallbackEventTypeFromJSON, CallbackEventTypeToJSON, } from './CallbackEventType.js';
-import { ExportConfigFromJSON, ExportConfigToJSON, } from './ExportConfig.js';
+import { DeliveryFromJSON, DeliveryToJSON, } from './Delivery.js';
 import { JobDefinitionFromJSON, JobDefinitionToJSON, } from './JobDefinition.js';
+import { WorkflowProcessingFromJSON, WorkflowProcessingToJSON, } from './WorkflowProcessing.js';
+import { ExternalDestinationFromJSON, ExternalDestinationToJSON, } from './ExternalDestination.js';
 /**
  * Check if a given object implements the WorkflowCreateRequest interface.
  */
@@ -35,7 +37,9 @@ export function WorkflowCreateRequestFromJSONTyped(json, ignoreDiscriminator) {
         'workflowEdges': json['workflow_edges'] == null ? undefined : (json['workflow_edges'].map(WorkflowEdgeFromJSON)),
         'callbackUrl': json['callback_url'] == null ? undefined : json['callback_url'],
         'callbackEvents': json['callback_events'] == null ? undefined : (json['callback_events'].map(CallbackEventTypeFromJSON)),
-        '_export': json['export'] == null ? undefined : ExportConfigFromJSON(json['export']),
+        '_export': json['export'] == null ? undefined : ExternalDestinationFromJSON(json['export']),
+        'delivery': json['delivery'] == null ? undefined : DeliveryFromJSON(json['delivery']),
+        'processing': json['processing'] == null ? undefined : WorkflowProcessingFromJSON(json['processing']),
     };
 }
 export function WorkflowCreateRequestToJSON(json) {
@@ -50,6 +54,8 @@ export function WorkflowCreateRequestToJSONTyped(value, ignoreDiscriminator = fa
         'workflow_edges': value['workflowEdges'] == null ? undefined : (value['workflowEdges'].map(WorkflowEdgeToJSON)),
         'callback_url': value['callbackUrl'],
         'callback_events': value['callbackEvents'] == null ? undefined : (value['callbackEvents'].map(CallbackEventTypeToJSON)),
-        'export': ExportConfigToJSON(value['_export']),
+        'export': ExternalDestinationToJSON(value['_export']),
+        'delivery': DeliveryToJSON(value['delivery']),
+        'processing': WorkflowProcessingToJSON(value['processing']),
     };
 }

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

@@ -1,15 +1,18 @@
 /**
  * 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, watermark, merge, archive, convert) - 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 (CDN-cacheable), health probes return flat objects, and `POST /api/contact` returns 204 with no body.
+ * 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.
  *
- * The version of the OpenAPI document: 2.0.0
+ * The version of the OpenAPI document: 2.12.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { DeliveryPlan } from './DeliveryPlan.js';
+import type { WorkflowWarning } from './WorkflowWarning.js';
 import type { JobResponse } from './JobResponse.js';
+import type { ProcessingPlan } from './ProcessingPlan.js';
 import type { WorkflowStatus } from './WorkflowStatus.js';
 /**
  *
@@ -29,12 +32,70 @@ export interface WorkflowCreateResponse {
      * @memberof WorkflowCreateResponse
      */
     status: WorkflowStatus;
+    /**
+     * ISO-8601 timestamp at which the workflow row was
+     * committed to the database (per ticket
+     * [Z1GEw5nG](https://trello.com/c/Z1GEw5nG)). The API
+     * always emits this field; spec catches up to behaviour
+     * shipping since `WorkflowController.php:147`.
+     *
+     * @type {Date}
+     * @memberof WorkflowCreateResponse
+     */
+    createdAt: Date;
     /**
      *
      * @type {Array<JobResponse>}
      * @memberof WorkflowCreateResponse
      */
     jobs: Array<JobResponse>;
+    /**
+     * Server-computed delivery plan per
+     * [ADR-0003](../docs/decisions/0003-delivery-mode.md). Always
+     * present (V2 cutover invariant); server emits empty
+     * `outputs: []` / `hidden_outputs: []` when applicable rather
+     * than omitting the field.
+     *
+     * @type {DeliveryPlan}
+     * @memberof WorkflowCreateResponse
+     */
+    deliveryPlan: DeliveryPlan;
+    /**
+     * Server-computed processing plan per ticket
+     * [I15-CONS](https://trello.com/c/YZpBKzOM) — F8 long-form
+     * video tier. Always present (V2 cutover invariant —
+     * mirrors `delivery_plan`); server emits `jobs: []` when
+     * the workflow has no compute jobs (e.g. archive-only)
+     * rather than omitting the field. Per-job entries surface
+     * `processing_class`, opaque `execution_pool` for display,
+     * and rough queue/processing time estimates so the
+     * frontend can preview routing decisions before the
+     * workflow runs. Estimation algorithm is server-side and
+     * deliberately opaque per plan v5 §F8.2.
+     *
+     * @type {ProcessingPlan}
+     * @memberof WorkflowCreateResponse
+     */
+    processingPlan: ProcessingPlan;
+    /**
+     * Advisory non-blocking warnings detected at
+     * workflow-create time per ticket
+     * [I25 `i5yCuSZc`](https://trello.com/c/i5yCuSZc) + plan
+     * v5 §F11. Always present (V2 cutover invariant — mirrors
+     * `delivery_plan` / `processing_plan`); server emits
+     * empty `[]` when no warnings detected. Workflow proceeds
+     * regardless — warnings do not block dispatch.
+     *
+     * SDKs MUST treat the `warning_type` enum as additive —
+     * ignore unknown values encountered at runtime
+     * (forward-compatible convention; same precedent as
+     * `ProgressStatus`, `ProcessingClassReason`,
+     * `WorkflowStatus`).
+     *
+     * @type {Array<WorkflowWarning>}
+     * @memberof WorkflowCreateResponse
+     */
+    warnings: Array<WorkflowWarning>;
     /**
      * HMAC-SHA256 signing key for webhook verification. Present only when
      * `callback_url` was provided in the request. This is the only time the