@giveitsmaller/contracts 0.2.0 → 0.3.0

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

@@ -0,0 +1,98 @@
+/**
+ * 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.7.1
+ *
+ *
+ * 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 { DeliverySelection } from './DeliverySelection.js';
+/**
+ * Workflow-level delivery configuration per
+ * [ADR-0003](../docs/decisions/0003-delivery-mode.md). Optional —
+ * when absent, the workflow defaults to
+ * `mode: individual, selection.type: terminal` (current V1
+ * behaviour).
+ *
+ * **Validator rules (runtime-enforced; spec documents):**
+ * 1. If `selection.type: explicit` AND any job in `jobs[]` has
+ *    `deliver: true`, the request is rejected with HTTP 422 —
+ *    these two promotion mechanisms are mutually exclusive.
+ * 2. If `mode != individual`, `bundle_format` is required.
+ *
+ * @export
+ * @interface Delivery
+ */
+export interface Delivery {
+    /**
+     * Delivery mode.
+     * @type {DeliveryModeEnum}
+     * @memberof Delivery
+     */
+    mode?: DeliveryModeEnum;
+    /**
+     * Required when `mode != individual`. Format of the bundle
+     * output. Validator rule encoded in description per repo
+     * convention; runtime returns 422 if missing.
+     *
+     * @type {DeliveryBundleFormatEnum}
+     * @memberof Delivery
+     */
+    bundleFormat?: DeliveryBundleFormatEnum;
+    /**
+     * Optional bundle filename (without extension; server adds
+     * `.zip` / `.tar.gz` as appropriate). Server generates one
+     * from workflow_id when omitted.
+     *
+     * @type {string}
+     * @memberof Delivery
+     */
+    bundleFilename?: string;
+    /**
+     * When `true`, embed a `manifest.json` inside the bundle
+     * describing each output (job_id, operation, original
+     * filename, size, etc.). The manifest's exact wire shape is
+     * runtime-defined and not pinned in this spec; consumers
+     * should treat it as an additive JSON object whose schema
+     * may evolve in minor versions.
+     *
+     * @type {boolean}
+     * @memberof Delivery
+     */
+    includeMetadata?: boolean;
+    /**
+     * How to pick outputs. Default `terminal` (leaves only).
+     *
+     * @type {DeliverySelection}
+     * @memberof Delivery
+     */
+    selection?: DeliverySelection;
+}
+/**
+ * @export
+ */
+export declare const DeliveryModeEnum: {
+    readonly individual: "individual";
+    readonly bundle: "bundle";
+    readonly both: "both";
+};
+export type DeliveryModeEnum = typeof DeliveryModeEnum[keyof typeof DeliveryModeEnum];
+/**
+ * @export
+ */
+export declare const DeliveryBundleFormatEnum: {
+    readonly zip: "zip";
+    readonly tar_gz: "tar_gz";
+};
+export type DeliveryBundleFormatEnum = typeof DeliveryBundleFormatEnum[keyof typeof DeliveryBundleFormatEnum];
+/**
+ * Check if a given object implements the Delivery interface.
+ */
+export declare function instanceOfDelivery(value: object): value is Delivery;
+export declare function DeliveryFromJSON(json: any): Delivery;
+export declare function DeliveryFromJSONTyped(json: any, ignoreDiscriminator: boolean): Delivery;
+export declare function DeliveryToJSON(json: any): Delivery;
+export declare function DeliveryToJSONTyped(value?: Delivery | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/Delivery.js

@@ -0,0 +1,65 @@
+/* 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { DeliverySelectionFromJSON, DeliverySelectionToJSON, } from './DeliverySelection.js';
+/**
+ * @export
+ */
+export const DeliveryModeEnum = {
+    individual: 'individual',
+    bundle: 'bundle',
+    both: 'both'
+};
+/**
+ * @export
+ */
+export const DeliveryBundleFormatEnum = {
+    zip: 'zip',
+    tar_gz: 'tar_gz'
+};
+/**
+ * Check if a given object implements the Delivery interface.
+ */
+export function instanceOfDelivery(value) {
+    return true;
+}
+export function DeliveryFromJSON(json) {
+    return DeliveryFromJSONTyped(json, false);
+}
+export function DeliveryFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'mode': json['mode'] == null ? undefined : json['mode'],
+        'bundleFormat': json['bundle_format'] == null ? undefined : json['bundle_format'],
+        'bundleFilename': json['bundle_filename'] == null ? undefined : json['bundle_filename'],
+        'includeMetadata': json['include_metadata'] == null ? undefined : json['include_metadata'],
+        'selection': json['selection'] == null ? undefined : DeliverySelectionFromJSON(json['selection']),
+    };
+}
+export function DeliveryToJSON(json) {
+    return DeliveryToJSONTyped(json, false);
+}
+export function DeliveryToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'mode': value['mode'],
+        'bundle_format': value['bundleFormat'],
+        'bundle_filename': value['bundleFilename'],
+        'include_metadata': value['includeMetadata'],
+        'selection': DeliverySelectionToJSON(value['selection']),
+    };
+}

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

@@ -0,0 +1,44 @@
+/**
+ * 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Reference to a specific job's operation output for explicit
+ * delivery selection. Distinct from `JobInputV2` (which carries
+ * per-input options for multi-input ops); this shape is dedicated
+ * per [ADR-0003](../docs/decisions/0003-delivery-mode.md) §"DeliveryOutputRef schema".
+ *
+ * @export
+ * @interface DeliveryOutputRef
+ */
+export interface DeliveryOutputRef {
+    /**
+     * Job ref within the workflow (matches `JobOutputSource.from` semantics).
+     * @type {string}
+     * @memberof DeliveryOutputRef
+     */
+    ref: string;
+    /**
+     * Optional operation type filter when the job has multiple
+     * operations. Omit to select the last operation's output.
+     *
+     * @type {string}
+     * @memberof DeliveryOutputRef
+     */
+    operation?: string;
+}
+/**
+ * Check if a given object implements the DeliveryOutputRef interface.
+ */
+export declare function instanceOfDeliveryOutputRef(value: object): value is DeliveryOutputRef;
+export declare function DeliveryOutputRefFromJSON(json: any): DeliveryOutputRef;
+export declare function DeliveryOutputRefFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeliveryOutputRef;
+export declare function DeliveryOutputRefToJSON(json: any): DeliveryOutputRef;
+export declare function DeliveryOutputRefToJSONTyped(value?: DeliveryOutputRef | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/DeliveryOutputRef.js

@@ -0,0 +1,45 @@
+/* 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Check if a given object implements the DeliveryOutputRef interface.
+ */
+export function instanceOfDeliveryOutputRef(value) {
+    if (!('ref' in value) || value['ref'] === undefined)
+        return false;
+    return true;
+}
+export function DeliveryOutputRefFromJSON(json) {
+    return DeliveryOutputRefFromJSONTyped(json, false);
+}
+export function DeliveryOutputRefFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'ref': json['ref'],
+        'operation': json['operation'] == null ? undefined : json['operation'],
+    };
+}
+export function DeliveryOutputRefToJSON(json) {
+    return DeliveryOutputRefToJSONTyped(json, false);
+}
+export function DeliveryOutputRefToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'ref': value['ref'],
+        'operation': value['operation'],
+    };
+}

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

@@ -0,0 +1,77 @@
+/**
+ * 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.7.1
+ *
+ *
+ * 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 { DeliveryPlanOutput } from './DeliveryPlanOutput.js';
+/**
+ * Response-side delivery plan emitted in `WorkflowCreateResponse`.
+ * Tells callers what they will receive (`outputs[]`) and what
+ * was hidden (`hidden_outputs[]`) so frontends render the right
+ * UI before the workflow runs.
+ *
+ * Both `outputs[]` and `hidden_outputs[]` are always present;
+ * the server emits `[]` rather than omitting the field when a
+ * category is empty.
+ *
+ * @export
+ * @interface DeliveryPlan
+ */
+export interface DeliveryPlan {
+    /**
+     *
+     * @type {DeliveryPlanModeEnum}
+     * @memberof DeliveryPlan
+     */
+    mode: DeliveryPlanModeEnum;
+    /**
+     *
+     * @type {DeliveryPlanSelectionTypeEnum}
+     * @memberof DeliveryPlan
+     */
+    selectionType: DeliveryPlanSelectionTypeEnum;
+    /**
+     * Outputs that will be delivered. Empty `[]` is permitted.
+     * @type {Array<DeliveryPlanOutput>}
+     * @memberof DeliveryPlan
+     */
+    outputs: Array<DeliveryPlanOutput>;
+    /**
+     * Outputs hidden by the selection rule. Empty `[]` is permitted.
+     * @type {Array<DeliveryPlanOutput>}
+     * @memberof DeliveryPlan
+     */
+    hiddenOutputs: Array<DeliveryPlanOutput>;
+}
+/**
+ * @export
+ */
+export declare const DeliveryPlanModeEnum: {
+    readonly individual: "individual";
+    readonly bundle: "bundle";
+    readonly both: "both";
+};
+export type DeliveryPlanModeEnum = typeof DeliveryPlanModeEnum[keyof typeof DeliveryPlanModeEnum];
+/**
+ * @export
+ */
+export declare const DeliveryPlanSelectionTypeEnum: {
+    readonly terminal: "terminal";
+    readonly all_outputs: "all_outputs";
+    readonly explicit: "explicit";
+};
+export type DeliveryPlanSelectionTypeEnum = typeof DeliveryPlanSelectionTypeEnum[keyof typeof DeliveryPlanSelectionTypeEnum];
+/**
+ * Check if a given object implements the DeliveryPlan interface.
+ */
+export declare function instanceOfDeliveryPlan(value: object): value is DeliveryPlan;
+export declare function DeliveryPlanFromJSON(json: any): DeliveryPlan;
+export declare function DeliveryPlanFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeliveryPlan;
+export declare function DeliveryPlanToJSON(json: any): DeliveryPlan;
+export declare function DeliveryPlanToJSONTyped(value?: DeliveryPlan | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/DeliveryPlan.js

@@ -0,0 +1,72 @@
+/* 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { DeliveryPlanOutputFromJSON, DeliveryPlanOutputToJSON, } from './DeliveryPlanOutput.js';
+/**
+ * @export
+ */
+export const DeliveryPlanModeEnum = {
+    individual: 'individual',
+    bundle: 'bundle',
+    both: 'both'
+};
+/**
+ * @export
+ */
+export const DeliveryPlanSelectionTypeEnum = {
+    terminal: 'terminal',
+    all_outputs: 'all_outputs',
+    explicit: 'explicit'
+};
+/**
+ * Check if a given object implements the DeliveryPlan interface.
+ */
+export function instanceOfDeliveryPlan(value) {
+    if (!('mode' in value) || value['mode'] === undefined)
+        return false;
+    if (!('selectionType' in value) || value['selectionType'] === undefined)
+        return false;
+    if (!('outputs' in value) || value['outputs'] === undefined)
+        return false;
+    if (!('hiddenOutputs' in value) || value['hiddenOutputs'] === undefined)
+        return false;
+    return true;
+}
+export function DeliveryPlanFromJSON(json) {
+    return DeliveryPlanFromJSONTyped(json, false);
+}
+export function DeliveryPlanFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'mode': json['mode'],
+        'selectionType': json['selection_type'],
+        'outputs': (json['outputs'].map(DeliveryPlanOutputFromJSON)),
+        'hiddenOutputs': (json['hidden_outputs'].map(DeliveryPlanOutputFromJSON)),
+    };
+}
+export function DeliveryPlanToJSON(json) {
+    return DeliveryPlanToJSONTyped(json, false);
+}
+export function DeliveryPlanToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'mode': value['mode'],
+        'selection_type': value['selectionType'],
+        'outputs': (value['outputs'].map(DeliveryPlanOutputToJSON)),
+        'hidden_outputs': (value['hiddenOutputs'].map(DeliveryPlanOutputToJSON)),
+    };
+}

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

@@ -0,0 +1,53 @@
+/**
+ * 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.7.1
+ *
+ *
+ * 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 { DeliveryPlanReason } from './DeliveryPlanReason.js';
+/**
+ * One entry in `DeliveryPlan.outputs` or `DeliveryPlan.hidden_outputs`.
+ * @export
+ * @interface DeliveryPlanOutput
+ */
+export interface DeliveryPlanOutput {
+    /**
+     * UUID v7 format identifier (time-ordered)
+     * @type {string}
+     * @memberof DeliveryPlanOutput
+     */
+    jobId: string;
+    /**
+     * Operation type within the job (e.g. `compress`, `merge`).
+     * @type {string}
+     * @memberof DeliveryPlanOutput
+     */
+    operation?: string;
+    /**
+     *
+     * @type {DeliveryPlanReason}
+     * @memberof DeliveryPlanOutput
+     */
+    reason: DeliveryPlanReason;
+    /**
+     * Set when `reason: consumed_by`. The id of the downstream
+     * job that consumes this output.
+     *
+     * @type {string}
+     * @memberof DeliveryPlanOutput
+     */
+    consumedByJobId?: string;
+}
+/**
+ * Check if a given object implements the DeliveryPlanOutput interface.
+ */
+export declare function instanceOfDeliveryPlanOutput(value: object): value is DeliveryPlanOutput;
+export declare function DeliveryPlanOutputFromJSON(json: any): DeliveryPlanOutput;
+export declare function DeliveryPlanOutputFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeliveryPlanOutput;
+export declare function DeliveryPlanOutputToJSON(json: any): DeliveryPlanOutput;
+export declare function DeliveryPlanOutputToJSONTyped(value?: DeliveryPlanOutput | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/DeliveryPlanOutput.js

@@ -0,0 +1,52 @@
+/* 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { DeliveryPlanReasonFromJSON, DeliveryPlanReasonToJSON, } from './DeliveryPlanReason.js';
+/**
+ * Check if a given object implements the DeliveryPlanOutput interface.
+ */
+export function instanceOfDeliveryPlanOutput(value) {
+    if (!('jobId' in value) || value['jobId'] === undefined)
+        return false;
+    if (!('reason' in value) || value['reason'] === undefined)
+        return false;
+    return true;
+}
+export function DeliveryPlanOutputFromJSON(json) {
+    return DeliveryPlanOutputFromJSONTyped(json, false);
+}
+export function DeliveryPlanOutputFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'jobId': json['job_id'],
+        'operation': json['operation'] == null ? undefined : json['operation'],
+        'reason': DeliveryPlanReasonFromJSON(json['reason']),
+        'consumedByJobId': json['consumed_by_job_id'] == null ? undefined : json['consumed_by_job_id'],
+    };
+}
+export function DeliveryPlanOutputToJSON(json) {
+    return DeliveryPlanOutputToJSONTyped(json, false);
+}
+export function DeliveryPlanOutputToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'job_id': value['jobId'],
+        'operation': value['operation'],
+        'reason': DeliveryPlanReasonToJSON(value['reason']),
+        'consumed_by_job_id': value['consumedByJobId'],
+    };
+}

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

@@ -0,0 +1,35 @@
+/**
+ * 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Why a given output appears in `outputs[]` or `hidden_outputs[]`
+ * of `DeliveryPlan`:
+ * - `leaf_terminal`: terminal job output (no outgoing edges).
+ * - `consumed_by`: intermediate output consumed by a downstream
+ *   job; the consuming job's id is set in `consumed_by_job_id`
+ *   on the same `DeliveryPlanOutput` entry.
+ * - `deliver_flag`: promoted via per-job `deliver: true`.
+ * - `explicit_selection`: listed in `delivery.selection.refs[]`.
+ *
+ * @export
+ */
+export declare const DeliveryPlanReason: {
+    readonly leaf_terminal: "leaf_terminal";
+    readonly consumed_by: "consumed_by";
+    readonly deliver_flag: "deliver_flag";
+    readonly explicit_selection: "explicit_selection";
+};
+export type DeliveryPlanReason = typeof DeliveryPlanReason[keyof typeof DeliveryPlanReason];
+export declare function instanceOfDeliveryPlanReason(value: any): boolean;
+export declare function DeliveryPlanReasonFromJSON(json: any): DeliveryPlanReason;
+export declare function DeliveryPlanReasonFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeliveryPlanReason;
+export declare function DeliveryPlanReasonToJSON(value?: DeliveryPlanReason | null): any;
+export declare function DeliveryPlanReasonToJSONTyped(value: any, ignoreDiscriminator: boolean): DeliveryPlanReason;