@scenario-labs/sdk 0.3.0 → 1.0.0

package/src/resources/jobs.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { JobsCursor, type JobsCursorParams, PagePromise } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -19,8 +20,11 @@ export class Jobs extends APIResource {
    * view of all operations running on the platform along with their status and
    * results.
    */
-  list(query: JobListParams | null | undefined = {}, options?: RequestOptions): APIPromise<JobListResponse> {
-    return this._client.get('/jobs', { query, ...options });
+  list(
+    query: JobListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<JobListResponsesJobsCursor, JobListResponse> {
+    return this._client.getAPIList('/jobs', JobsCursor<JobListResponse>, { query, ...options });
   }
 
   /**
@@ -36,6 +40,8 @@ export class Jobs extends APIResource {
   }
 }
 
+export type JobListResponsesJobsCursor = JobsCursor<JobListResponse>;
+
 export interface JobRetrieveResponse {
   job: JobRetrieveResponse.Job;
 }
@@ -989,302 +995,525 @@ export namespace JobRetrieveResponse {
 }
 
 export interface JobListResponse {
-  jobs: Array<JobListResponse.Job>;
+  /**
+   * The job creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+   */
+  createdAt: string;
+
+  /**
+   * The job ID (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+   */
+  jobId: string;
+
+  /**
+   * The type of job
+   */
+  jobType:
+    | 'assets-download'
+    | 'canvas-export'
+    | 'caption'
+    | 'caption-llava'
+    | 'custom'
+    | 'describe-style'
+    | 'detection'
+    | 'embed'
+    | 'flux'
+    | 'flux-model-training'
+    | 'generate-prompt'
+    | 'image-generation'
+    | 'image-prompt-editing'
+    | 'inference'
+    | 'mesh-preview-rendering'
+    | 'model-download'
+    | 'model-import'
+    | 'model-training'
+    | 'musubi-model-training'
+    | 'openai-image-generation'
+    | 'patch-image'
+    | 'pixelate'
+    | 'reframe'
+    | 'remove-background'
+    | 'repaint'
+    | 'restyle'
+    | 'segment'
+    | 'skybox-3d'
+    | 'skybox-base-360'
+    | 'skybox-hdri'
+    | 'skybox-upscale-360'
+    | 'texture'
+    | 'translate'
+    | 'upload'
+    | 'upscale'
+    | 'upscale-skybox'
+    | 'upscale-texture'
+    | 'vectorize'
+    | 'workflow';
+
+  /**
+   * Metadata of the job with some additional information
+   */
+  metadata: JobListResponse.Metadata;
+
+  /**
+   * Progress of the job (between 0 and 1)
+   */
+  progress: number;
+
+  /**
+   * The current status of the job
+   */
+  status:
+    | 'canceled'
+    | 'failure'
+    | 'finalizing'
+    | 'in-progress'
+    | 'pending'
+    | 'queued'
+    | 'success'
+    | 'warming-up';
+
+  /**
+   * The history of the different statuses the job went through with the ISO string
+   * date of when the job reached each statuses.
+   */
+  statusHistory: Array<JobListResponse.StatusHistory>;
+
+  /**
+   * The job last update date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+   */
+  updatedAt: string;
+
+  /**
+   * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
+   */
+  authorId?: string;
+
+  /**
+   * The billing of the job
+   */
+  billing?: JobListResponse.Billing;
 
   /**
-   * A token to query the next page of jobs
+   * The owner ID (example: "team_U3Qmc8PCdWXwAQJ4Dvw4tV6D")
    */
-  nextPaginationToken?: string;
+  ownerId?: string;
 }
 
 export namespace JobListResponse {
-  export interface Job {
+  /**
+   * Metadata of the job with some additional information
+   */
+  export interface Metadata {
     /**
-     * The job creation date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     * List of produced assets for this job
      */
-    createdAt: string;
+    assetIds?: Array<string>;
 
     /**
-     * The job ID (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+     * Eventual error for the job
      */
-    jobId: string;
+    error?: string | null;
 
     /**
-     * The type of job
+     * The flow of the job. Only available for workflow jobs.
      */
-    jobType:
-      | 'assets-download'
-      | 'canvas-export'
-      | 'caption'
-      | 'caption-llava'
-      | 'custom'
-      | 'describe-style'
-      | 'detection'
-      | 'embed'
-      | 'flux'
-      | 'flux-model-training'
-      | 'generate-prompt'
-      | 'image-generation'
-      | 'image-prompt-editing'
-      | 'inference'
-      | 'mesh-preview-rendering'
-      | 'model-download'
-      | 'model-import'
-      | 'model-training'
-      | 'musubi-model-training'
-      | 'openai-image-generation'
-      | 'patch-image'
-      | 'pixelate'
-      | 'reframe'
-      | 'remove-background'
-      | 'repaint'
-      | 'restyle'
-      | 'segment'
-      | 'skybox-3d'
-      | 'skybox-base-360'
-      | 'skybox-hdri'
-      | 'skybox-upscale-360'
-      | 'texture'
-      | 'translate'
-      | 'upload'
-      | 'upscale'
-      | 'upscale-skybox'
-      | 'upscale-texture'
-      | 'vectorize'
-      | 'workflow';
+    flow?: Array<Metadata.Flow>;
 
     /**
-     * Metadata of the job with some additional information
+     * Actionable hint for the user explaining what went wrong and how to resolve it.
      */
-    metadata: Job.Metadata;
+    hint?: string;
 
     /**
-     * Progress of the job (between 0 and 1)
+     * The inputs for the job
      */
-    progress: number;
+    input?: { [key: string]: unknown };
 
     /**
-     * The current status of the job
+     * May contain the output of the job for specific custom models jobs. Only
+     * available for custom models which generate non-assets outputs. Example: LLM text
+     * results.
      */
-    status:
-      | 'canceled'
-      | 'failure'
-      | 'finalizing'
-      | 'in-progress'
-      | 'pending'
-      | 'queued'
-      | 'success'
-      | 'warming-up';
+    output?: { [key: string]: unknown };
 
     /**
-     * The history of the different statuses the job went through with the ISO string
-     * date of when the job reached each statuses.
+     * For voice-clone jobs: the ID of the model being trained.
      */
-    statusHistory: Array<Job.StatusHistory>;
+    outputModelId?: string;
 
     /**
-     * The job last update date as an ISO string (example: "2023-02-03T11:19:41.579Z")
+     * The workflow ID of the job if job is part of a workflow.
      */
-    updatedAt: string;
+    workflowId?: string;
 
     /**
-     * The author user ID (example: "dcf121faaa1a0a0bbbd9ca1b73d62aea")
+     * The workflow job ID of the job if job is part of a workflow job.
      */
-    authorId?: string;
+    workflowJobId?: string;
+  }
 
-    /**
-     * The billing of the job
-     */
-    billing?: Job.Billing;
+  export namespace Metadata {
+    export interface Flow {
+      /**
+       * The id of the node.
+       */
+      id: string;
 
-    /**
-     * The owner ID (example: "team_U3Qmc8PCdWXwAQJ4Dvw4tV6D")
-     */
-    ownerId?: string;
-  }
+      /**
+       * The status of the node. Only available for WorkflowJob nodes.
+       */
+      status: 'failure' | 'pending' | 'processing' | 'skipped' | 'success';
 
-  export namespace Job {
-    /**
-     * Metadata of the job with some additional information
-     */
-    export interface Metadata {
       /**
-       * List of produced assets for this job
+       * The type of the job for the node.
        */
-      assetIds?: Array<string>;
+      type:
+        | 'custom-model'
+        | 'for-each'
+        | 'generate-prompt'
+        | 'list'
+        | 'logic'
+        | 'model'
+        | 'remove-background'
+        | 'transform'
+        | 'user-approval'
+        | 'workflow';
 
       /**
-       * Eventual error for the job
+       * List of produced assets for this node.
        */
-      error?: string | null;
+      assets?: Array<Flow.Asset>;
 
       /**
-       * The flow of the job. Only available for workflow jobs.
+       * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
+       * `count` times regardless of array input. When not set, the loop iterates over
+       * the resolved array input. Only available for ForEach nodes.
        */
-      flow?: Array<Metadata.Flow>;
+      count?: number;
 
       /**
-       * Actionable hint for the user explaining what went wrong and how to resolve it.
+       * The nodes that this node depends on. Only available for nodes that have
+       * dependencies. Mainly used for user approval nodes.
        */
-      hint?: string;
+      dependsOn?: Array<string>;
 
       /**
-       * The inputs for the job
+       * If true, the outputs of this node will be included in the workflow job's final
+       * output. Only applicable to producing nodes (custom-model, inference, etc.). By
+       * default, only last nodes (nodes not referenced by other nodes) contribute to
+       * outputs. Set this to true to also include intermediate nodes in the final
+       * output. Note: This should only be set to `true` or left undefined.
        */
-      input?: { [key: string]: unknown };
+      includeOutputsInWorkflowJob?: true;
 
       /**
-       * May contain the output of the job for specific custom models jobs. Only
-       * available for custom models which generate non-assets outputs. Example: LLM text
-       * results.
+       * The inputs of the node.
        */
-      output?: { [key: string]: unknown };
+      inputs?: Array<Flow.Input>;
 
       /**
-       * For voice-clone jobs: the ID of the model being trained.
+       * Statically-configured items for a List node. The node outputs this array as-is
+       * when executed. Only available for List nodes. The values can be strings,
+       * numbers, or asset IDs.
        */
-      outputModelId?: string;
+      items?: Array<string>;
 
       /**
-       * The workflow ID of the job if job is part of a workflow.
+       * Zero-based index of the iteration this node copy belongs to. Set on
+       * dynamically-created copies of loop body nodes.
        */
-      workflowId?: string;
+      iterationIndex?: number;
 
       /**
-       * The workflow job ID of the job if job is part of a workflow job.
+       * If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is
+       * only available for nodes started. A node "Pending" for a running workflow job is
+       * not started.
        */
-      workflowJobId?: string;
+      jobId?: string;
+
+      /**
+       * The logic of the node. Only available for logic nodes.
+       */
+      logic?: Flow.Logic;
+
+      /**
+       * The type of the logic for the node. Only available for logic nodes.
+       */
+      logicType?: 'if-else';
+
+      /**
+       * IDs of the body template nodes that belong to this ForEach loop. At runtime
+       * these templates are cloned once per iteration and marked Skipped. Only available
+       * for ForEach nodes.
+       */
+      loopBodyNodeIds?: Array<string>;
+
+      /**
+       * ID of the ForEach node that spawned this iteration copy. Set on
+       * dynamically-created copies of loop body nodes.
+       */
+      loopNodeId?: string;
+
+      /**
+       * The model id for the node. Mainly used for custom model tasks.
+       */
+      modelId?: string;
+
+      /**
+       * The output of the node. Only available for logic nodes.
+       */
+      output?: unknown;
+
+      /**
+       * The workflow id for the node. Mainly used for workflow tasks.
+       */
+      workflowId?: string;
     }
 
-    export namespace Metadata {
-      export interface Flow {
-        /**
-         * The id of the node.
-         */
-        id: string;
+    export namespace Flow {
+      export interface Asset {
+        assetId: string;
+
+        url: string;
+      }
 
+      /**
+       * This is used to run the flow.
+       */
+      export interface Input {
         /**
-         * The status of the node. Only available for WorkflowJob nodes.
+         * The name that must be user to call the model through the API
          */
-        status: 'failure' | 'pending' | 'processing' | 'skipped' | 'success';
+        name: string;
 
         /**
-         * The type of the job for the node.
+         * The data type of the input
          */
         type:
-          | 'custom-model'
-          | 'for-each'
-          | 'generate-prompt'
-          | 'list'
-          | 'logic'
+          | 'boolean'
+          | 'file'
+          | 'file_array'
+          | 'inputs_array'
           | 'model'
-          | 'remove-background'
-          | 'transform'
-          | 'user-approval'
-          | 'workflow';
+          | 'model_array'
+          | 'number'
+          | 'number_array'
+          | 'string'
+          | 'string_array';
 
         /**
-         * List of produced assets for this node.
+         * The allowed values for the input. For \`string\` or \`number\` types, creates a
+         * single-select dropdown. For \`string_array\` type, creates a multi-select
+         * dropdown.
          */
-        assets?: Array<Flow.Asset>;
+        allowedValues?: Array<unknown>;
 
         /**
-         * Fixed number of iterations for a ForEach node. When set, the loop runs exactly
-         * `count` times regardless of array input. When not set, the loop iterates over
-         * the resolved array input. Only available for ForEach nodes.
+         * Specifies the background behavior for the input. Only available for \`file\` and
+         * \`file_array\` input types with kind \`image\`.
          */
-        count?: number;
+        backgroundBehavior?: 'opaque' | 'transparent';
 
         /**
-         * The nodes that this node depends on. Only available for nodes that have
-         * dependencies. Mainly used for user approval nodes.
+         * Whether the input is a color or not. Only available for \`string\` input type.
          */
-        dependsOn?: Array<string>;
+        color?: boolean;
 
         /**
-         * If true, the outputs of this node will be included in the workflow job's final
-         * output. Only applicable to producing nodes (custom-model, inference, etc.). By
-         * default, only last nodes (nodes not referenced by other nodes) contribute to
-         * outputs. Set this to true to also include intermediate nodes in the final
-         * output. Note: This should only be set to `true` or left undefined.
+         * Whether this input affects the model's cost calculation
          */
-        includeOutputsInWorkflowJob?: true;
+        costImpact?: boolean;
 
         /**
-         * The inputs of the node.
+         * The default value for the input
          */
-        inputs?: Array<Flow.Input>;
+        default?: unknown;
 
         /**
-         * Statically-configured items for a List node. The node outputs this array as-is
-         * when executed. Only available for List nodes. The values can be strings,
-         * numbers, or asset IDs.
+         * Help text displayed in the UI to provide additional information about the input
          */
-        items?: Array<string>;
+        description?: string;
 
         /**
-         * Zero-based index of the iteration this node copy belongs to. Set on
-         * dynamically-created copies of loop body nodes.
+         * Used to visually group inputs together in the UI. Inputs with the same group
+         * value appear consecutively in the UI.
          */
-        iterationIndex?: number;
+        group?: string;
 
         /**
-         * If the flow is part of a WorkflowJob, this is the jobId for the node. jobId is
-         * only available for nodes started. A node "Pending" for a running workflow job is
-         * not started.
+         * Hint text displayed in the UI as a tooltip to guide the user
          */
-        jobId?: string;
+        hint?: string;
 
         /**
-         * The logic of the node. Only available for logic nodes.
+         * The list of inputs which form an object within a container array. All inputs are
+         * the same as the current object. This is only available for type inputs_array
+         * inputs.
          */
-        logic?: Flow.Logic;
+        inputs?: Array<{ [key: string]: unknown }>;
 
         /**
-         * The type of the logic for the node. Only available for logic nodes.
+         * The configured items for inputs_array type inputs. Each item is an array of
+         * SubNodeInput that need ref/value resolution. Only available for inputs_array
+         * type.
          */
-        logicType?: 'if-else';
+        items?: Array<Array<Input.Item>>;
 
         /**
-         * IDs of the body template nodes that belong to this ForEach loop. At runtime
-         * these templates are cloned once per iteration and marked Skipped. Only available
-         * for ForEach nodes.
+         * The asset kind of the input. Only taken into account for \`file\` and
+         * \`file_array\` input types. If model provides multiple kinds, the input will be
+         * not able to create the asset on the flight on API side with dataurl without
+         * data:kind, prefix
          */
-        loopBodyNodeIds?: Array<string>;
+        kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
 
         /**
-         * ID of the ForEach node that spawned this iteration copy. Set on
-         * dynamically-created copies of loop body nodes.
+         * The label displayed in the UI for this input
          */
-        loopNodeId?: string;
+        label?: string;
 
         /**
-         * The model id for the node. Mainly used for custom model tasks.
+         * The name of the file input field to use as the mask source
          */
-        modelId?: string;
+        maskFrom?: string;
 
         /**
-         * The output of the node. Only available for logic nodes.
+         * The maximum allowed value. Only available for \`number\` and \`array\` input
+         * types.
          */
-        output?: unknown;
+        max?: number;
 
         /**
-         * The workflow id for the node. Mainly used for workflow tasks.
+         * The maximum allowed length for \`string\` inputs. Also applies to each item in
+         * \`string_array\`.
          */
-        workflowId?: string;
-      }
+        maxLength?: number;
 
-      export namespace Flow {
-        export interface Asset {
-          assetId: string;
+        /**
+         * The maximum allowed file size in bytes. Only applies to \`file\` and
+         * \`file_array\` input types. Validated against \`asset.properties.size\` at job
+         * creation time.
+         */
+        maxSize?: number;
 
-          url: string;
-        }
+        /**
+         * The minimum allowed value. Only available for \`number\` and array input types.
+         */
+        min?: number;
 
         /**
-         * This is used to run the flow.
+         * The minimum allowed length for string inputs. Also applies to each item in
+         * \`string_array\`.
          */
-        export interface Input {
+        minLength?: number;
+
+        /**
+         * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+         * available for \`model_array\` input type.
+         */
+        modelTypes?: Array<
+          | 'custom'
+          | 'elevenlabs-voice'
+          | 'flux.1'
+          | 'flux.1-composition'
+          | 'flux.1-kontext-dev'
+          | 'flux.1-kontext-lora'
+          | 'flux.1-krea-dev'
+          | 'flux.1-krea-lora'
+          | 'flux.1-lora'
+          | 'flux.1-pro'
+          | 'flux.1.1-pro-ultra'
+          | 'flux.2-dev-edit-lora'
+          | 'flux.2-dev-lora'
+          | 'flux.2-klein-4b-edit-lora'
+          | 'flux.2-klein-4b-lora'
+          | 'flux.2-klein-9b-edit-lora'
+          | 'flux.2-klein-9b-lora'
+          | 'flux.2-klein-base-4b-edit-lora'
+          | 'flux.2-klein-base-4b-lora'
+          | 'flux.2-klein-base-9b-edit-lora'
+          | 'flux.2-klein-base-9b-lora'
+          | 'flux1.1-pro'
+          | 'gpt-image-1'
+          | 'qwen-image-2512-lora'
+          | 'qwen-image-edit-2509-lora'
+          | 'qwen-image-edit-2511-lora'
+          | 'qwen-image-edit-lora'
+          | 'qwen-image-lora'
+          | 'sd-1_5'
+          | 'sd-1_5-composition'
+          | 'sd-1_5-lora'
+          | 'sd-xl'
+          | 'sd-xl-composition'
+          | 'sd-xl-lora'
+          | 'zimage-de-turbo-lora'
+          | 'zimage-lora'
+          | 'zimage-turbo-lora'
+        >;
+
+        /**
+         * Whether this input represents a parent asset to assign to the produced assets.
+         * Only available for \`file\` and \`file_array\` input types.
+         *
+         * For \`file_array\`, the parent asset is the first item in the array.
+         */
+        parent?: boolean;
+
+        /**
+         * Placeholder text for the input. Only available for 'string' input type.
+         */
+        placeholder?: string;
+
+        /**
+         * Whether the input is a prompt. When true, displays as a text area with prompt
+         * spark feature. Only available for \`string\` input type.
+         */
+        prompt?: boolean;
+
+        /**
+         * Whether the input is used with prompt spark. Only available for \`string\` input
+         * type.
+         */
+        promptSpark?: boolean;
+
+        /**
+         * The reference to another input or output of the same workflow. Must have at
+         * least one of node or conditional.
+         */
+        ref?: Input.Ref;
+
+        /**
+         * Set of rules that describes when this input is required:
+         *
+         * - \`always\`: Input is always required
+         * - \`ifNotDefined\`: Input is required when another specified input is not
+         *   defined
+         * - \`ifDefined\`: Input is required when another specified input is defined
+         * - \`conditionalValues\`: Input is required when another input has a specific
+         *   value
+         *
+         * By default, the input is not required.
+         */
+        required?: Input.Required;
+
+        /**
+         * The step increment for numeric inputs. Only available for \`number\` input type.
+         */
+        step?: number;
+
+        /**
+         * The value of the input. This is the value of the input that will be used to run
+         * the node. Only available for flows managed by a WorkflowJob.
+         */
+        value?: unknown;
+      }
+
+      export namespace Input {
+        /**
+         * A sub-input within an inputs_array item. Same as NodeInput but without the
+         * recursive items field.
+         */
+        export interface Item {
           /**
            * The name that must be user to call the model through the API
            */
@@ -1356,13 +1585,6 @@ export namespace JobListResponse {
            */
           inputs?: Array<{ [key: string]: unknown }>;
 
-          /**
-           * The configured items for inputs_array type inputs. Each item is an array of
-           * SubNodeInput that need ref/value resolution. Only available for inputs_array
-           * type.
-           */
-          items?: Array<Array<Input.Item>>;
-
           /**
            * The asset kind of the input. Only taken into account for \`file\` and
            * \`file_array\` input types. If model provides multiple kinds, the input will be
@@ -1405,415 +1627,114 @@ export namespace JobListResponse {
            */
           min?: number;
 
-          /**
-           * The minimum allowed length for string inputs. Also applies to each item in
-           * \`string_array\`.
-           */
-          minLength?: number;
-
-          /**
-           * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
-           * available for \`model_array\` input type.
-           */
-          modelTypes?: Array<
-            | 'custom'
-            | 'elevenlabs-voice'
-            | 'flux.1'
-            | 'flux.1-composition'
-            | 'flux.1-kontext-dev'
-            | 'flux.1-kontext-lora'
-            | 'flux.1-krea-dev'
-            | 'flux.1-krea-lora'
-            | 'flux.1-lora'
-            | 'flux.1-pro'
-            | 'flux.1.1-pro-ultra'
-            | 'flux.2-dev-edit-lora'
-            | 'flux.2-dev-lora'
-            | 'flux.2-klein-4b-edit-lora'
-            | 'flux.2-klein-4b-lora'
-            | 'flux.2-klein-9b-edit-lora'
-            | 'flux.2-klein-9b-lora'
-            | 'flux.2-klein-base-4b-edit-lora'
-            | 'flux.2-klein-base-4b-lora'
-            | 'flux.2-klein-base-9b-edit-lora'
-            | 'flux.2-klein-base-9b-lora'
-            | 'flux1.1-pro'
-            | 'gpt-image-1'
-            | 'qwen-image-2512-lora'
-            | 'qwen-image-edit-2509-lora'
-            | 'qwen-image-edit-2511-lora'
-            | 'qwen-image-edit-lora'
-            | 'qwen-image-lora'
-            | 'sd-1_5'
-            | 'sd-1_5-composition'
-            | 'sd-1_5-lora'
-            | 'sd-xl'
-            | 'sd-xl-composition'
-            | 'sd-xl-lora'
-            | 'zimage-de-turbo-lora'
-            | 'zimage-lora'
-            | 'zimage-turbo-lora'
-          >;
-
-          /**
-           * Whether this input represents a parent asset to assign to the produced assets.
-           * Only available for \`file\` and \`file_array\` input types.
-           *
-           * For \`file_array\`, the parent asset is the first item in the array.
-           */
-          parent?: boolean;
-
-          /**
-           * Placeholder text for the input. Only available for 'string' input type.
-           */
-          placeholder?: string;
-
-          /**
-           * Whether the input is a prompt. When true, displays as a text area with prompt
-           * spark feature. Only available for \`string\` input type.
-           */
-          prompt?: boolean;
-
-          /**
-           * Whether the input is used with prompt spark. Only available for \`string\` input
-           * type.
-           */
-          promptSpark?: boolean;
-
-          /**
-           * The reference to another input or output of the same workflow. Must have at
-           * least one of node or conditional.
-           */
-          ref?: Input.Ref;
-
-          /**
-           * Set of rules that describes when this input is required:
-           *
-           * - \`always\`: Input is always required
-           * - \`ifNotDefined\`: Input is required when another specified input is not
-           *   defined
-           * - \`ifDefined\`: Input is required when another specified input is defined
-           * - \`conditionalValues\`: Input is required when another input has a specific
-           *   value
-           *
-           * By default, the input is not required.
-           */
-          required?: Input.Required;
-
-          /**
-           * The step increment for numeric inputs. Only available for \`number\` input type.
-           */
-          step?: number;
-
-          /**
-           * The value of the input. This is the value of the input that will be used to run
-           * the node. Only available for flows managed by a WorkflowJob.
-           */
-          value?: unknown;
-        }
-
-        export namespace Input {
-          /**
-           * A sub-input within an inputs_array item. Same as NodeInput but without the
-           * recursive items field.
-           */
-          export interface Item {
-            /**
-             * The name that must be user to call the model through the API
-             */
-            name: string;
-
-            /**
-             * The data type of the input
-             */
-            type:
-              | 'boolean'
-              | 'file'
-              | 'file_array'
-              | 'inputs_array'
-              | 'model'
-              | 'model_array'
-              | 'number'
-              | 'number_array'
-              | 'string'
-              | 'string_array';
-
-            /**
-             * The allowed values for the input. For \`string\` or \`number\` types, creates a
-             * single-select dropdown. For \`string_array\` type, creates a multi-select
-             * dropdown.
-             */
-            allowedValues?: Array<unknown>;
-
-            /**
-             * Specifies the background behavior for the input. Only available for \`file\` and
-             * \`file_array\` input types with kind \`image\`.
-             */
-            backgroundBehavior?: 'opaque' | 'transparent';
-
-            /**
-             * Whether the input is a color or not. Only available for \`string\` input type.
-             */
-            color?: boolean;
-
-            /**
-             * Whether this input affects the model's cost calculation
-             */
-            costImpact?: boolean;
-
-            /**
-             * The default value for the input
-             */
-            default?: unknown;
-
-            /**
-             * Help text displayed in the UI to provide additional information about the input
-             */
-            description?: string;
-
-            /**
-             * Used to visually group inputs together in the UI. Inputs with the same group
-             * value appear consecutively in the UI.
-             */
-            group?: string;
-
-            /**
-             * Hint text displayed in the UI as a tooltip to guide the user
-             */
-            hint?: string;
-
-            /**
-             * The list of inputs which form an object within a container array. All inputs are
-             * the same as the current object. This is only available for type inputs_array
-             * inputs.
-             */
-            inputs?: Array<{ [key: string]: unknown }>;
-
-            /**
-             * The asset kind of the input. Only taken into account for \`file\` and
-             * \`file_array\` input types. If model provides multiple kinds, the input will be
-             * not able to create the asset on the flight on API side with dataurl without
-             * data:kind, prefix
-             */
-            kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'video';
-
-            /**
-             * The label displayed in the UI for this input
-             */
-            label?: string;
-
-            /**
-             * The name of the file input field to use as the mask source
-             */
-            maskFrom?: string;
-
-            /**
-             * The maximum allowed value. Only available for \`number\` and \`array\` input
-             * types.
-             */
-            max?: number;
-
-            /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
-             */
-            maxLength?: number;
-
-            /**
-             * The maximum allowed file size in bytes. Only applies to \`file\` and
-             * \`file_array\` input types. Validated against \`asset.properties.size\` at job
-             * creation time.
-             */
-            maxSize?: number;
-
-            /**
-             * The minimum allowed value. Only available for \`number\` and array input types.
-             */
-            min?: number;
-
-            /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
-             */
-            minLength?: number;
-
-            /**
-             * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
-             * available for \`model_array\` input type.
-             */
-            modelTypes?: Array<
-              | 'custom'
-              | 'elevenlabs-voice'
-              | 'flux.1'
-              | 'flux.1-composition'
-              | 'flux.1-kontext-dev'
-              | 'flux.1-kontext-lora'
-              | 'flux.1-krea-dev'
-              | 'flux.1-krea-lora'
-              | 'flux.1-lora'
-              | 'flux.1-pro'
-              | 'flux.1.1-pro-ultra'
-              | 'flux.2-dev-edit-lora'
-              | 'flux.2-dev-lora'
-              | 'flux.2-klein-4b-edit-lora'
-              | 'flux.2-klein-4b-lora'
-              | 'flux.2-klein-9b-edit-lora'
-              | 'flux.2-klein-9b-lora'
-              | 'flux.2-klein-base-4b-edit-lora'
-              | 'flux.2-klein-base-4b-lora'
-              | 'flux.2-klein-base-9b-edit-lora'
-              | 'flux.2-klein-base-9b-lora'
-              | 'flux1.1-pro'
-              | 'gpt-image-1'
-              | 'qwen-image-2512-lora'
-              | 'qwen-image-edit-2509-lora'
-              | 'qwen-image-edit-2511-lora'
-              | 'qwen-image-edit-lora'
-              | 'qwen-image-lora'
-              | 'sd-1_5'
-              | 'sd-1_5-composition'
-              | 'sd-1_5-lora'
-              | 'sd-xl'
-              | 'sd-xl-composition'
-              | 'sd-xl-lora'
-              | 'zimage-de-turbo-lora'
-              | 'zimage-lora'
-              | 'zimage-turbo-lora'
-            >;
-
-            /**
-             * Whether this input represents a parent asset to assign to the produced assets.
-             * Only available for \`file\` and \`file_array\` input types.
-             *
-             * For \`file_array\`, the parent asset is the first item in the array.
-             */
-            parent?: boolean;
-
-            /**
-             * Placeholder text for the input. Only available for 'string' input type.
-             */
-            placeholder?: string;
-
-            /**
-             * Whether the input is a prompt. When true, displays as a text area with prompt
-             * spark feature. Only available for \`string\` input type.
-             */
-            prompt?: boolean;
-
-            /**
-             * Whether the input is used with prompt spark. Only available for \`string\` input
-             * type.
-             */
-            promptSpark?: boolean;
-
-            /**
-             * The reference to another input or output of the same workflow. Must have at
-             * least one of node or conditional.
-             */
-            ref?: Item.Ref;
-
-            /**
-             * Set of rules that describes when this input is required:
-             *
-             * - \`always\`: Input is always required
-             * - \`ifNotDefined\`: Input is required when another specified input is not
-             *   defined
-             * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
-             *
-             * By default, the input is not required.
-             */
-            required?: Item.Required;
-
-            /**
-             * The step increment for numeric inputs. Only available for \`number\` input type.
-             */
-            step?: number;
+          /**
+           * The minimum allowed length for string inputs. Also applies to each item in
+           * \`string_array\`.
+           */
+          minLength?: number;
 
-            /**
-             * The value of the input. This is the value of the input that will be used to run
-             * the node. Only available for flows managed by a WorkflowJob.
-             */
-            value?: unknown;
-          }
+          /**
+           * The allowed model types for this input. Example: \`["flux.1-lora"]\`. Only
+           * available for \`model_array\` input type.
+           */
+          modelTypes?: Array<
+            | 'custom'
+            | 'elevenlabs-voice'
+            | 'flux.1'
+            | 'flux.1-composition'
+            | 'flux.1-kontext-dev'
+            | 'flux.1-kontext-lora'
+            | 'flux.1-krea-dev'
+            | 'flux.1-krea-lora'
+            | 'flux.1-lora'
+            | 'flux.1-pro'
+            | 'flux.1.1-pro-ultra'
+            | 'flux.2-dev-edit-lora'
+            | 'flux.2-dev-lora'
+            | 'flux.2-klein-4b-edit-lora'
+            | 'flux.2-klein-4b-lora'
+            | 'flux.2-klein-9b-edit-lora'
+            | 'flux.2-klein-9b-lora'
+            | 'flux.2-klein-base-4b-edit-lora'
+            | 'flux.2-klein-base-4b-lora'
+            | 'flux.2-klein-base-9b-edit-lora'
+            | 'flux.2-klein-base-9b-lora'
+            | 'flux1.1-pro'
+            | 'gpt-image-1'
+            | 'qwen-image-2512-lora'
+            | 'qwen-image-edit-2509-lora'
+            | 'qwen-image-edit-2511-lora'
+            | 'qwen-image-edit-lora'
+            | 'qwen-image-lora'
+            | 'sd-1_5'
+            | 'sd-1_5-composition'
+            | 'sd-1_5-lora'
+            | 'sd-xl'
+            | 'sd-xl-composition'
+            | 'sd-xl-lora'
+            | 'zimage-de-turbo-lora'
+            | 'zimage-lora'
+            | 'zimage-turbo-lora'
+          >;
 
-          export namespace Item {
-            /**
-             * The reference to another input or output of the same workflow. Must have at
-             * least one of node or conditional.
-             */
-            export interface Ref {
-              /**
-               * The conditional nodes to reference. If the conditional nodes are successful, the
-               * node will be successful. If the conditional nodes are skipped, the node will be
-               * skipped. Contains an array of node ids used to check the status of the nodes.
-               */
-              conditional?: Array<string>;
+          /**
+           * Whether this input represents a parent asset to assign to the produced assets.
+           * Only available for \`file\` and \`file_array\` input types.
+           *
+           * For \`file_array\`, the parent asset is the first item in the array.
+           */
+          parent?: boolean;
 
-              /**
-               * This is the desired node output value if ref is an if/else node.
-               */
-              equal?: string;
+          /**
+           * Placeholder text for the input. Only available for 'string' input type.
+           */
+          placeholder?: string;
 
-              /**
-               * The name of the input or output to reference. If the type is 'workflow', the
-               * name is the name of the input of the workflow is required If the type is 'node',
-               * the name is not mandatory, except if you want all outputs of the node. To get
-               * all outputs of a node, you can use the name 'all'.
-               */
-              name?: string;
+          /**
+           * Whether the input is a prompt. When true, displays as a text area with prompt
+           * spark feature. Only available for \`string\` input type.
+           */
+          prompt?: boolean;
 
-              /**
-               * The node id or 'workflow' if the source is a workflow input.
-               */
-              node?: string;
-            }
+          /**
+           * Whether the input is used with prompt spark. Only available for \`string\` input
+           * type.
+           */
+          promptSpark?: boolean;
 
-            /**
-             * Set of rules that describes when this input is required:
-             *
-             * - \`always\`: Input is always required
-             * - \`ifNotDefined\`: Input is required when another specified input is not
-             *   defined
-             * - \`ifDefined\`: Input is required when another specified input is defined
-             * - \`conditionalValues\`: Input is required when another input has a specific
-             *   value
-             *
-             * By default, the input is not required.
-             */
-            export interface Required {
-              /**
-               * Whether the input is always required
-               */
-              always?: boolean;
+          /**
+           * The reference to another input or output of the same workflow. Must have at
+           * least one of node or conditional.
+           */
+          ref?: Item.Ref;
 
-              /**
-               * Makes this input required when another input has a specific value:
-               *
-               * - Key: name of the input to check
-               * - Value: operation and allowed values that trigger the requirement
-               */
-              conditionalValues?: unknown;
+          /**
+           * Set of rules that describes when this input is required:
+           *
+           * - \`always\`: Input is always required
+           * - \`ifNotDefined\`: Input is required when another specified input is not
+           *   defined
+           * - \`ifDefined\`: Input is required when another specified input is defined
+           * - \`conditionalValues\`: Input is required when another input has a specific
+           *   value
+           *
+           * By default, the input is not required.
+           */
+          required?: Item.Required;
 
-              /**
-               * Makes this input required when another input is defined:
-               *
-               * - Key: name of the input that must be defined
-               * - Value: message to display when this input is required
-               */
-              ifDefined?: unknown;
+          /**
+           * The step increment for numeric inputs. Only available for \`number\` input type.
+           */
+          step?: number;
 
-              /**
-               * Makes this input required when another input is not defined:
-               *
-               * - Key: name of the input that must be undefined
-               * - Value: message to display when this input is required
-               */
-              ifNotDefined?: unknown;
-            }
-          }
+          /**
+           * The value of the input. This is the value of the input that will be used to run
+           * the node. Only available for flows managed by a WorkflowJob.
+           */
+          value?: unknown;
+        }
 
+        export namespace Item {
           /**
            * The reference to another input or output of the same workflow. Must have at
            * least one of node or conditional.
@@ -1890,59 +1811,133 @@ export namespace JobListResponse {
         }
 
         /**
-         * The logic of the node. Only available for logic nodes.
+         * The reference to another input or output of the same workflow. Must have at
+         * least one of node or conditional.
          */
-        export interface Logic {
+        export interface Ref {
           /**
-           * The cases of the logic. Only available for if/else nodes.
+           * The conditional nodes to reference. If the conditional nodes are successful, the
+           * node will be successful. If the conditional nodes are skipped, the node will be
+           * skipped. Contains an array of node ids used to check the status of the nodes.
            */
-          cases?: Array<Logic.Case>;
+          conditional?: Array<string>;
 
           /**
-           * The default case of the logic. Contains the id/output of the node to execute if
-           * no case is matched. Only available for if/else nodes.
+           * This is the desired node output value if ref is an if/else node.
            */
-          default?: string;
+          equal?: string;
 
           /**
-           * The transform of the logic. Only available for transform nodes.
+           * The name of the input or output to reference. If the type is 'workflow', the
+           * name is the name of the input of the workflow is required If the type is 'node',
+           * the name is not mandatory, except if you want all outputs of the node. To get
+           * all outputs of a node, you can use the name 'all'.
            */
-          transform?: string;
+          name?: string;
+
+          /**
+           * The node id or 'workflow' if the source is a workflow input.
+           */
+          node?: string;
         }
 
-        export namespace Logic {
-          export interface Case {
-            condition: string;
+        /**
+         * Set of rules that describes when this input is required:
+         *
+         * - \`always\`: Input is always required
+         * - \`ifNotDefined\`: Input is required when another specified input is not
+         *   defined
+         * - \`ifDefined\`: Input is required when another specified input is defined
+         * - \`conditionalValues\`: Input is required when another input has a specific
+         *   value
+         *
+         * By default, the input is not required.
+         */
+        export interface Required {
+          /**
+           * Whether the input is always required
+           */
+          always?: boolean;
 
-            value: string;
-          }
+          /**
+           * Makes this input required when another input has a specific value:
+           *
+           * - Key: name of the input to check
+           * - Value: operation and allowed values that trigger the requirement
+           */
+          conditionalValues?: unknown;
+
+          /**
+           * Makes this input required when another input is defined:
+           *
+           * - Key: name of the input that must be defined
+           * - Value: message to display when this input is required
+           */
+          ifDefined?: unknown;
+
+          /**
+           * Makes this input required when another input is not defined:
+           *
+           * - Key: name of the input that must be undefined
+           * - Value: message to display when this input is required
+           */
+          ifNotDefined?: unknown;
         }
       }
-    }
 
-    export interface StatusHistory {
-      date: string;
+      /**
+       * The logic of the node. Only available for logic nodes.
+       */
+      export interface Logic {
+        /**
+         * The cases of the logic. Only available for if/else nodes.
+         */
+        cases?: Array<Logic.Case>;
 
-      status:
-        | 'canceled'
-        | 'failure'
-        | 'finalizing'
-        | 'in-progress'
-        | 'pending'
-        | 'queued'
-        | 'success'
-        | 'warming-up';
-    }
+        /**
+         * The default case of the logic. Contains the id/output of the node to execute if
+         * no case is matched. Only available for if/else nodes.
+         */
+        default?: string;
 
-    /**
-     * The billing of the job
-     */
-    export interface Billing {
-      cuCost: number;
+        /**
+         * The transform of the logic. Only available for transform nodes.
+         */
+        transform?: string;
+      }
 
-      cuDiscount: number;
+      export namespace Logic {
+        export interface Case {
+          condition: string;
+
+          value: string;
+        }
+      }
     }
   }
+
+  export interface StatusHistory {
+    date: string;
+
+    status:
+      | 'canceled'
+      | 'failure'
+      | 'finalizing'
+      | 'in-progress'
+      | 'pending'
+      | 'queued'
+      | 'success'
+      | 'warming-up';
+  }
+
+  /**
+   * The billing of the job
+   */
+  export interface Billing {
+    cuCost: number;
+
+    cuDiscount: number;
+  }
 }
 
 export interface JobTriggerActionResponse {
@@ -2897,7 +2892,7 @@ export namespace JobTriggerActionResponse {
   }
 }
 
-export interface JobListParams {
+export interface JobListParams extends JobsCursorParams {
   /**
    * The authorId of the jobs to return. Optional.
    */
@@ -2914,11 +2909,6 @@ export interface JobListParams {
    */
   pageSize?: number;
 
-  /**
-   * A token you received in a previous request to query the next page of items
-   */
-  paginationToken?: string;
-
   /**
    * The status of the jobs to return. Optional.
    */
@@ -3035,6 +3025,7 @@ export declare namespace Jobs {
     type JobRetrieveResponse as JobRetrieveResponse,
     type JobListResponse as JobListResponse,
     type JobTriggerActionResponse as JobTriggerActionResponse,
+    type JobListResponsesJobsCursor as JobListResponsesJobsCursor,
     type JobListParams as JobListParams,
     type JobTriggerActionParams as JobTriggerActionParams,
   };