@giveitsmaller/contracts 0.2.3 → 0.3.0

package/dist/openapi/models/FeatureViolation.js

@@ -0,0 +1,63 @@
+/* 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 { UserTierFromJSON, UserTierToJSON, } from './UserTier.js';
+import { AvailabilityValueFromJSON, AvailabilityValueToJSON, } from './AvailabilityValue.js';
+/**
+ * Check if a given object implements the FeatureViolation interface.
+ */
+export function instanceOfFeatureViolation(value) {
+    if (!('feature' in value) || value['feature'] === undefined)
+        return false;
+    if (!('availability' in value) || value['availability'] === undefined)
+        return false;
+    return true;
+}
+export function FeatureViolationFromJSON(json) {
+    return FeatureViolationFromJSONTyped(json, false);
+}
+export function FeatureViolationFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'feature': json['feature'],
+        'availability': AvailabilityValueFromJSON(json['availability']),
+        'eta': json['eta'] == null ? undefined : json['eta'],
+        'requiredTier': json['required_tier'] == null ? undefined : UserTierFromJSON(json['required_tier']),
+        'documentationUrl': json['documentation_url'] == null ? undefined : json['documentation_url'],
+        'messageKey': json['message_key'] == null ? undefined : json['message_key'],
+        'message': json['message'] == null ? undefined : json['message'],
+        'locale': json['locale'] == null ? undefined : json['locale'],
+        'messageParams': json['message_params'] == null ? undefined : json['message_params'],
+    };
+}
+export function FeatureViolationToJSON(json) {
+    return FeatureViolationToJSONTyped(json, false);
+}
+export function FeatureViolationToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'feature': value['feature'],
+        'availability': AvailabilityValueToJSON(value['availability']),
+        'eta': value['eta'],
+        'required_tier': UserTierToJSON(value['requiredTier']),
+        'documentation_url': value['documentationUrl'],
+        'message_key': value['messageKey'],
+        'message': value['message'],
+        'locale': value['locale'],
+        'message_params': value['messageParams'],
+    };
+}

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

@@ -1,32 +1,143 @@
 /**
  * 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.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 { WorkflowSource } from './WorkflowSource.js';
+import type { OperationDefinition } from './OperationDefinition.js';
+import type { JobInputV2 } from './JobInputV2.js';
 /**
- * @type JobDefinition
- * A job within a workflow. Each job must have exactly one source:
- * - `file_id`: Direct reference to an uploaded file
- * - `source`: Reference another job's output (single-input downstream)
- * - `inputs`: Reference multiple job outputs (multi-input: merge/archive)
+ * V2 job within a workflow. Per [ADR-0004](../docs/decisions/0004-job-shape.md).
  *
- * Future versions will add `url` and `import` source types for external
- * file references (V2).
+ * **Source shape (mutually exclusive):**
+ * - `source` (single-input): a `WorkflowSource` value (4-leaf
+ *   discriminated union: `upload` / `external_import` / `connection` /
+ *   `job_output`). Used by single-input operations (compress, thumbnail,
+ *   text_watermark, convert).
+ * - `inputs[]` (multi-input): array of `JobInputV2` entries. Each entry
+ *   carries its own `source` plus an optional `role`
+ *   (image_watermark, custom_luma, audio_overlay) and
+ *   `per_input_options`. Used by multi-input operations (merge,
+ *   archive, image_watermark, custom_luma, audio_overlay).
  *
- * For single-input jobs with `file_id`, `operations` defaults to
- * `[{ "type": "compress" }]` if omitted. Multi-input jobs must specify
- * operations explicitly.
+ * Exactly one of `source` or `inputs` is required.
+ *
+ * **`id` is optional.** When omitted, the server auto-generates `job_N`
+ * (positional, 0-indexed). Required only when this job is referenced
+ * by:
+ * - Another job's `source.from` (`JobOutputSource.from`) or
+ *   `inputs[].source.from`
+ * - `workflow_edges[].from` / `.to`
+ * - `delivery.selection.explicit.refs[].ref` (delivery_plan, ticket I8-CONS)
+ *
+ * User-supplied IDs matching the reserved pattern `^job_\d+$` are
+ * rejected — this avoids collisions with the auto-generated naming
+ * scheme.
+ *
+ * **Server computes `depends_on`** from `JobOutputSource.from`
+ * references at job-level and inputs[]-level. `workflow_edges` is
+ * rarely needed and is preserved as an optional override for
+ * non-typical DAG topologies (e.g. side-effect dependencies that
+ * don't surface as `from` references).
+ *
+ * **Role validation per operation type** (runtime enforcement;
+ * contract documents the rule):
+ * - `image_watermark`: exactly one input with `role: base` AND one
+ *   with `role: overlay` (per [I4-CONS](https://trello.com/c/2dZiW1BF)).
+ * - `custom_luma`: exactly one input with `role: base` AND one
+ *   with `role: transition_mask` (per
+ *   [I29](https://trello.com/c/EPUE5Vs1)).
+ * - `audio_overlay`: exactly one input with `role: base` AND one
+ *   with `role: overlay` (per
+ *   [I19](https://trello.com/c/Xr3Z4GBF)). The `overlay` role
+ *   label is shared with `image_watermark` — semantics differ
+ *   by operation type.
+ * - `text_watermark`: single-input via `source` (not `inputs[]`); no
+ *   `role` field.
+ * - `merge` / `archive`: no `role` field on inputs (all inputs
+ *   share the same role).
+ *
+ * **Greenfield V2.0 cutover.** V1 `JobDefinition` (with required
+ * `ref` field and three-way `file_id`/`source`/`inputs` mutex) is
+ * replaced wholesale per ADR-0004 §"Greenfield V2.0 cutover". V1
+ * `JobSource` and `JobInput` schemas are deleted; their job-output
+ * and per-input semantics live in `JobOutputSource` and
+ * `JobInputV2` respectively.
  *
  * @export
+ * @interface JobDefinition
+ */
+export interface JobDefinition {
+    /**
+     * Optional local identifier within the workflow. Auto-generated
+     * `job_N` when omitted. Required when referenced by other jobs,
+     * workflow_edges, or delivery_plan. Reserved pattern `^job_\d+$`
+     * — user-supplied IDs matching this pattern are rejected at the
+     * JSON-Schema layer via the negative lookahead in the `pattern`
+     * below.
+     *
+     * @type {string}
+     * @memberof JobDefinition
+     */
+    id?: string;
+    /**
+     *
+     * @type {WorkflowSource}
+     * @memberof JobDefinition
+     */
+    source?: WorkflowSource;
+    /**
+     * Multi-input list for `merge`, `archive`, `image_watermark`,
+     * `custom_luma`, and `audio_overlay`. Each entry is a
+     * `JobInputV2` with its own `WorkflowSource`. Mutually
+     * exclusive with `source`.
+     *
+     * @type {Array<JobInputV2>}
+     * @memberof JobDefinition
+     */
+    inputs?: Array<JobInputV2>;
+    /**
+     * Ordered list of operations. Executed sequentially — each
+     * operation consumes the previous operation's output; all
+     * intermediate and final outputs are kept.
+     *
+     * Multi-input jobs (with `inputs[]`) must have exactly one
+     * operation, and it must be a multi-input type (`merge`,
+     * `archive`, `image_watermark`, `custom_luma`, or
+     * `audio_overlay`).
+     *
+     * @type {Array<OperationDefinition>}
+     * @memberof JobDefinition
+     */
+    operations?: Array<OperationDefinition>;
+    /**
+     * Per-job hide-intermediates promotion flag per
+     * [ADR-0003](../docs/decisions/0003-delivery-mode.md) §"Per-job
+     * deliver flag". When `true`, this job's output is promoted
+     * into the deliverable set even if it's an intermediate (not
+     * a leaf terminal).
+     *
+     * Mutually exclusive with `delivery.selection.type: explicit`
+     * at the workflow level — the validator rejects a workflow
+     * that combines explicit selection with any per-job
+     * `deliver: true`.
+     *
+     * @type {boolean}
+     * @memberof JobDefinition
+     */
+    deliver?: boolean;
+}
+/**
+ * Check if a given object implements the JobDefinition interface.
  */
-export type JobDefinition = any;
+export declare function instanceOfJobDefinition(value: object): value is JobDefinition;
 export declare function JobDefinitionFromJSON(json: any): JobDefinition;
 export declare function JobDefinitionFromJSONTyped(json: any, ignoreDiscriminator: boolean): JobDefinition;
-export declare function JobDefinitionToJSON(json: any): any;
+export declare function JobDefinitionToJSON(json: any): JobDefinition;
 export declare function JobDefinitionToJSONTyped(value?: JobDefinition | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/JobDefinition.js

@@ -2,15 +2,24 @@
 /* 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.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 { WorkflowSourceFromJSON, WorkflowSourceToJSON, } from './WorkflowSource.js';
+import { OperationDefinitionFromJSON, OperationDefinitionToJSON, } from './OperationDefinition.js';
+import { JobInputV2FromJSON, JobInputV2ToJSON, } from './JobInputV2.js';
+/**
+ * Check if a given object implements the JobDefinition interface.
+ */
+export function instanceOfJobDefinition(value) {
+    return true;
+}
 export function JobDefinitionFromJSON(json) {
     return JobDefinitionFromJSONTyped(json, false);
 }
@@ -18,7 +27,13 @@ export function JobDefinitionFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
-    return {};
+    return {
+        'id': json['id'] == null ? undefined : json['id'],
+        'source': json['source'] == null ? undefined : WorkflowSourceFromJSON(json['source']),
+        'inputs': json['inputs'] == null ? undefined : (json['inputs'].map(JobInputV2FromJSON)),
+        'operations': json['operations'] == null ? undefined : (json['operations'].map(OperationDefinitionFromJSON)),
+        'deliver': json['deliver'] == null ? undefined : json['deliver'],
+    };
 }
 export function JobDefinitionToJSON(json) {
     return JobDefinitionToJSONTyped(json, false);
@@ -27,5 +42,11 @@ export function JobDefinitionToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }
-    return {};
+    return {
+        'id': value['id'],
+        'source': WorkflowSourceToJSON(value['source']),
+        'inputs': value['inputs'] == null ? undefined : (value['inputs'].map(JobInputV2ToJSON)),
+        'operations': value['operations'] == null ? undefined : (value['operations'].map(OperationDefinitionToJSON)),
+        'deliver': value['deliver'],
+    };
 }

package/dist/openapi/models/JobDownload.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.7.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/models/JobDownload.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.7.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

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

@@ -0,0 +1,89 @@
+/**
+ * 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 { WorkflowSource } from './WorkflowSource.js';
+/**
+ * V2 multi-input entry per [ADR-0004](../docs/decisions/0004-job-shape.md)
+ * §"JobInputV2". Replaces V1 `JobInput`. Each entry carries its own
+ * `source` (a `WorkflowSource` value — same union used at
+ * `JobDefinition.source`), so multi-input jobs can mix uploads,
+ * external imports, vault connections, and upstream job outputs
+ * within a single inputs[] array.
+ *
+ * @export
+ * @interface JobInputV2
+ */
+export interface JobInputV2 {
+    /**
+     *
+     * @type {WorkflowSource}
+     * @memberof JobInputV2
+     */
+    source: WorkflowSource;
+    /**
+     * Role for role-based multi-input operations:
+     * - `image_watermark`: REQUIRED; values `base` (the source
+     *   image) or `overlay` (the watermark). Exactly one of each
+     *   per job (per [I4-CONS](https://trello.com/c/2dZiW1BF)).
+     * - `custom_luma`: REQUIRED; values `base` (the source video)
+     *   or `transition_mask` (the caller-uploaded luma matte).
+     *   Exactly one of each per job (per
+     *   [I29](https://trello.com/c/EPUE5Vs1)).
+     * - `audio_overlay`: REQUIRED; values `base` (the primary
+     *   audio or video track) or `overlay` (the secondary audio
+     *   asset to mix in). Exactly one of each per job (per
+     *   [I19](https://trello.com/c/Xr3Z4GBF)). Reuses the
+     *   `overlay` value already declared for `image_watermark`
+     *   — semantics differ by operation type, but the same
+     *   role label keeps the enum compact.
+     * - `merge` / `archive`: omit (all inputs share the same role).
+     *
+     * `text_watermark` is single-input via `JobDefinition.source`
+     * (not `inputs[]`); `role` does not apply there.
+     *
+     * Future operations may widen this enum.
+     *
+     * @type {JobInputV2RoleEnum}
+     * @memberof JobInputV2
+     */
+    role?: JobInputV2RoleEnum;
+    /**
+     * Per-input option overrides. Preserved from V1 merge semantics
+     * (e.g. transition override for a specific join point). Keys
+     * are operation option names; values are the override values.
+     * The operation schema in `schemas/operations/*.yaml` defines
+     * which options are overridable per-input via the
+     * `per_input_options` block.
+     *
+     * @type {{ [key: string]: any; }}
+     * @memberof JobInputV2
+     */
+    perInputOptions?: {
+        [key: string]: any;
+    };
+}
+/**
+ * @export
+ */
+export declare const JobInputV2RoleEnum: {
+    readonly base: "base";
+    readonly overlay: "overlay";
+    readonly transition_mask: "transition_mask";
+};
+export type JobInputV2RoleEnum = typeof JobInputV2RoleEnum[keyof typeof JobInputV2RoleEnum];
+/**
+ * Check if a given object implements the JobInputV2 interface.
+ */
+export declare function instanceOfJobInputV2(value: object): value is JobInputV2;
+export declare function JobInputV2FromJSON(json: any): JobInputV2;
+export declare function JobInputV2FromJSONTyped(json: any, ignoreDiscriminator: boolean): JobInputV2;
+export declare function JobInputV2ToJSON(json: any): JobInputV2;
+export declare function JobInputV2ToJSONTyped(value?: JobInputV2 | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/JobInputV2.js

@@ -0,0 +1,56 @@
+/* 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 { WorkflowSourceFromJSON, WorkflowSourceToJSON, } from './WorkflowSource.js';
+/**
+ * @export
+ */
+export const JobInputV2RoleEnum = {
+    base: 'base',
+    overlay: 'overlay',
+    transition_mask: 'transition_mask'
+};
+/**
+ * Check if a given object implements the JobInputV2 interface.
+ */
+export function instanceOfJobInputV2(value) {
+    if (!('source' in value) || value['source'] === undefined)
+        return false;
+    return true;
+}
+export function JobInputV2FromJSON(json) {
+    return JobInputV2FromJSONTyped(json, false);
+}
+export function JobInputV2FromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'source': WorkflowSourceFromJSON(json['source']),
+        'role': json['role'] == null ? undefined : json['role'],
+        'perInputOptions': json['per_input_options'] == null ? undefined : json['per_input_options'],
+    };
+}
+export function JobInputV2ToJSON(json) {
+    return JobInputV2ToJSONTyped(json, false);
+}
+export function JobInputV2ToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'source': WorkflowSourceToJSON(value['source']),
+        'role': value['role'],
+        'per_input_options': value['perInputOptions'],
+    };
+}

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

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+/**
+ * References the output of an upstream job in the same workflow.
+ * Used to chain operations: workflow runs job A first, then job B
+ * consumes job A's output via this source. The server computes
+ * `depends_on` edges from these `from` references.
+ *
+ * @export
+ * @interface JobOutputSource
+ */
+export interface JobOutputSource {
+    /**
+     *
+     * @type {JobOutputSourceTypeEnum}
+     * @memberof JobOutputSource
+     */
+    type: JobOutputSourceTypeEnum;
+    /**
+     * Upstream job ref (must be defined in the same workflow).
+     * @type {string}
+     * @memberof JobOutputSource
+     */
+    from: string;
+    /**
+     * Optional operation type filter when the upstream job has
+     * multiple operations (e.g. `from: enhance, operation: thumbnail`).
+     *
+     * @type {string}
+     * @memberof JobOutputSource
+     */
+    operation?: string;
+}
+/**
+ * @export
+ */
+export declare const JobOutputSourceTypeEnum: {
+    readonly job_output: "job_output";
+};
+export type JobOutputSourceTypeEnum = typeof JobOutputSourceTypeEnum[keyof typeof JobOutputSourceTypeEnum];
+/**
+ * Check if a given object implements the JobOutputSource interface.
+ */
+export declare function instanceOfJobOutputSource(value: object): value is JobOutputSource;
+export declare function JobOutputSourceFromJSON(json: any): JobOutputSource;
+export declare function JobOutputSourceFromJSONTyped(json: any, ignoreDiscriminator: boolean): JobOutputSource;
+export declare function JobOutputSourceToJSON(json: any): JobOutputSource;
+export declare function JobOutputSourceToJSONTyped(value?: JobOutputSource | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/JobOutputSource.js

@@ -0,0 +1,55 @@
+/* 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.
+ */
+/**
+ * @export
+ */
+export const JobOutputSourceTypeEnum = {
+    job_output: 'job_output'
+};
+/**
+ * Check if a given object implements the JobOutputSource interface.
+ */
+export function instanceOfJobOutputSource(value) {
+    if (!('type' in value) || value['type'] === undefined)
+        return false;
+    if (!('from' in value) || value['from'] === undefined)
+        return false;
+    return true;
+}
+export function JobOutputSourceFromJSON(json) {
+    return JobOutputSourceFromJSONTyped(json, false);
+}
+export function JobOutputSourceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'type': json['type'],
+        'from': json['from'],
+        'operation': json['operation'] == null ? undefined : json['operation'],
+    };
+}
+export function JobOutputSourceToJSON(json) {
+    return JobOutputSourceToJSONTyped(json, false);
+}
+export function JobOutputSourceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'type': value['type'],
+        'from': value['from'],
+        'operation': value['operation'],
+    };
+}