@scenario-labs/sdk 3.1.0 → 3.3.0

package/src/resources/models/examples.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import { omitUndefined } from '../../internal/utils/values';
 
 export class Examples extends APIResource {
   /**
@@ -16,9 +17,9 @@ export class Examples extends APIResource {
   ): APIPromise<ExampleUpdateResponse> {
     const { originalAssets, projectId, ...body } = params;
     return this._client.put(path`/models/${modelID}/examples`, {
-      query: { originalAssets, projectId },
       body,
       ...options,
+      query: { originalAssets, projectId, ...omitUndefined(options?.query) },
     });
   }
 
@@ -30,7 +31,10 @@ export class Examples extends APIResource {
     query: ExampleListParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ExampleListResponse> {
-    return this._client.get(path`/models/${modelID}/examples`, { query, ...options });
+    return this._client.get(path`/models/${modelID}/examples`, {
+      ...options,
+      query: { ...query, ...omitUndefined(options?.query) },
+    });
   }
 }
 
@@ -299,6 +303,66 @@ export namespace ExampleUpdateResponse {
        */
       originalFileUrl?: string;
 
+      /**
+       * The mime type of the original file url.
+       *
+       * The original file is stored under a key that carries no extension, so this is
+       * the only way to know which format `originalFileUrl` serves (e.g. an HDRi skybox
+       * exposes a JPEG preview as `url` and its `.exr` or `.hdr` file as the original).
+       * Omitted when the stored format could not be determined.
+       */
+      originalMimeType?:
+        | 'application/gzip'
+        | 'application/json'
+        | 'application/octet-stream'
+        | 'application/pdf'
+        | 'application/safetensors'
+        | 'application/vnd.autodesk.fbx'
+        | 'application/x-authorware-bin'
+        | 'application/x-zip-compressed'
+        | 'application/x.autodesk.fbx'
+        | 'application/zip'
+        | 'audio/flac'
+        | 'audio/m4a'
+        | 'audio/mpeg'
+        | 'audio/ogg'
+        | 'audio/wav'
+        | 'image/aces'
+        | 'image/avif'
+        | 'image/bmp'
+        | 'image/gif'
+        | 'image/heic'
+        | 'image/jpeg'
+        | 'image/png'
+        | 'image/svg+xml'
+        | 'image/tiff'
+        | 'image/vnd.radiance'
+        | 'image/webp'
+        | 'image/x-exr'
+        | 'model/glb'
+        | 'model/gltf+json'
+        | 'model/gltf-binary'
+        | 'model/ksplat'
+        | 'model/mtl'
+        | 'model/obj'
+        | 'model/ply'
+        | 'model/sog'
+        | 'model/splat'
+        | 'model/spz'
+        | 'model/stl'
+        | 'model/vnd.collada+xml'
+        | 'model/vnd.ms-package.3dmanufacturing-3dmodel+xml'
+        | 'model/x-3d-vox'
+        | 'model/x-blender'
+        | 'model/x-fbx'
+        | 'model/x-maya-ascii'
+        | 'model/x-maya-binary'
+        | 'model/x3d+xml'
+        | 'text/plain'
+        | 'video/mp4'
+        | 'video/quicktime'
+        | 'video/webm';
+
       /**
        * The output index of the asset within a job This index is an positive integer
        * that starts at 0 It is used to differentiate between multiple outputs of the
@@ -314,12 +378,12 @@ export namespace ExampleUpdateResponse {
       preview?: Asset.Preview;
 
       /**
-       * SlopGuard detection result, computed asynchronously after generation.
+       * Quality Gate result, computed asynchronously after generation.
        *
        * `details` (the per-dimension reasons and suggestions) is returned only when the
-       * asset is read with `withSlopGuardDetails=true`.
+       * asset is read with `withQualityGateDetails=true`.
        */
-      slopGuard?: Asset.SlopGuard;
+      qualityGate?: Asset.QualityGate;
 
       /**
        * The asset's thumbnail.
@@ -527,6 +591,12 @@ export namespace ExampleUpdateResponse {
          */
         factor?: number;
 
+        /**
+         * The name its parent's files reference it by (an OBJ's MTL, an MTL's texture),
+         * kept as delivered.
+         */
+        fileName?: string;
+
         filterSpeckle?: number;
 
         /**
@@ -616,6 +686,11 @@ export namespace ExampleUpdateResponse {
          */
         invert?: boolean;
 
+        /**
+         * Its own references (an OBJ's `mtllib`, an MTL's maps) were kept as delivered.
+         */
+        keepsFileNames?: boolean;
+
         /**
          * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
          */
@@ -1238,12 +1313,12 @@ export namespace ExampleUpdateResponse {
       }
 
       /**
-       * SlopGuard detection result, computed asynchronously after generation.
+       * Quality Gate result, computed asynchronously after generation.
        *
        * `details` (the per-dimension reasons and suggestions) is returned only when the
-       * asset is read with `withSlopGuardDetails=true`.
+       * asset is read with `withQualityGateDetails=true`.
        */
-      export interface SlopGuard {
+      export interface QualityGate {
         /**
          * ISO-8601 timestamp of when scoring ran
          */
@@ -1277,13 +1352,13 @@ export namespace ExampleUpdateResponse {
         /**
          * Per-dimension reasons and suggestions, as produced by the detector.
          *
-         * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+         * Returned only when the asset is read with `withQualityGateDetails=true` by the
          * project that owns it — the brief-compliance text paraphrases that project's
          * brief, so a cross-project read of a public asset gets the summary alone. Also
          * omitted when the archived verdict is unavailable (asset scored by an older
          * version, or an unreadable archive).
          */
-        details?: SlopGuard.Details;
+        details?: QualityGate.Details;
 
         /**
          * Error message when status is 'error' (truncated)
@@ -1306,11 +1381,11 @@ export namespace ExampleUpdateResponse {
         verdict?: 'fail' | 'pass' | 'warn';
       }
 
-      export namespace SlopGuard {
+      export namespace QualityGate {
         /**
          * Per-dimension reasons and suggestions, as produced by the detector.
          *
-         * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+         * Returned only when the asset is read with `withQualityGateDetails=true` by the
          * project that owns it — the brief-compliance text paraphrases that project's
          * brief, so a cross-project read of a public asset gets the summary alone. Also
          * omitted when the archived verdict is unavailable (asset scored by an older
@@ -1913,6 +1988,7 @@ export namespace ExampleUpdateResponse {
             | 'remove-background'
             | 'transform'
             | 'user-approval'
+            | 'user-selection'
             | 'workflow';
 
           /**
@@ -1943,14 +2019,15 @@ export namespace ExampleUpdateResponse {
           includeOutputsInWorkflowJob?: true;
 
           /**
-           * The inputs of the node.
+           * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+           * bound how many items the user may pick (defaults: 1 and 100); conditional
+           * connections may be present as additional inputs.
            */
           inputs?: Array<Flow.Input>;
 
           /**
-           * 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.
+           * Statically-configured items for a List node, or the frozen candidate list of a
+           * UserSelection node. The values can be strings, numbers, or asset IDs.
            */
           items?: Array<string>;
 
@@ -2099,7 +2176,9 @@ export namespace ExampleUpdateResponse {
              * 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
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -2127,8 +2206,9 @@ export namespace ExampleUpdateResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -2145,8 +2225,9 @@ export namespace ExampleUpdateResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -2226,8 +2307,7 @@ export namespace ExampleUpdateResponse {
              * - \`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
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -2326,7 +2406,9 @@ export namespace ExampleUpdateResponse {
                * 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
+               * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+               * a model does not declare one, \`image\` is returned, which is the kind used at
+               * generation time.
                */
               kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -2354,8 +2436,9 @@ export namespace ExampleUpdateResponse {
               maxDuration?: number;
 
               /**
-               * The maximum allowed length for \`string\` inputs. Also applies to each item in
-               * \`string_array\`.
+               * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+               * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+               * ITEMS instead — the length of each item is not constrained.
                */
               maxLength?: number;
 
@@ -2372,8 +2455,9 @@ export namespace ExampleUpdateResponse {
               min?: number;
 
               /**
-               * The minimum allowed length for string inputs. Also applies to each item in
-               * \`string_array\`.
+               * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+               * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+               * ITEMS instead — the length of each item is not constrained.
                */
               minLength?: number;
 
@@ -2453,8 +2537,7 @@ export namespace ExampleUpdateResponse {
                * - \`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
+               * - \`conditional\`: Input is required when other inputs have specific values
                *
                * By default, the input is not required.
                */
@@ -2511,8 +2594,7 @@ export namespace ExampleUpdateResponse {
                * - \`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
+               * - \`conditional\`: Input is required when other inputs have specific values
                *
                * By default, the input is not required.
                */
@@ -2523,12 +2605,9 @@ export namespace ExampleUpdateResponse {
                 always?: boolean;
 
                 /**
-                 * 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
+                 * Makes this input required when other inputs have one of the listed values
                  */
-                conditionalValues?: unknown;
+                conditional?: Required.Conditional;
 
                 /**
                  * Makes this input required when another input is defined:
@@ -2546,6 +2625,26 @@ export namespace ExampleUpdateResponse {
                  */
                 ifNotDefined?: unknown;
               }
+
+              export namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                export interface Conditional {
+                  /**
+                   * The conditions to check:
+                   *
+                   * - Key: name of the input to check
+                   * - Value: values of that input that satisfy the condition
+                   */
+                  values: unknown;
+
+                  /**
+                   * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                   */
+                  operator?: 'and' | 'or';
+                }
+              }
             }
 
             /**
@@ -2586,8 +2685,7 @@ export namespace ExampleUpdateResponse {
              * - \`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
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -2598,12 +2696,9 @@ export namespace ExampleUpdateResponse {
               always?: boolean;
 
               /**
-               * 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
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -2621,6 +2716,26 @@ export namespace ExampleUpdateResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -2678,7 +2793,7 @@ export namespace ExampleUpdateResponse {
 
         /**
          * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-         * top of the generation itself, such as `slop-detection`.
+         * top of the generation itself, such as `quality-gate`.
          *
          * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
          * values here.
@@ -2708,7 +2823,7 @@ export namespace ExampleUpdateResponse {
       export namespace Billing {
         /**
          * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-         * top of the generation itself, such as `slop-detection`.
+         * top of the generation itself, such as `quality-gate`.
          *
          * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
          * values here.
@@ -2728,7 +2843,7 @@ export namespace ExampleUpdateResponse {
         export interface CuCostDetails {
           'ip-detection'?: number;
 
-          'slop-detection'?: number;
+          'quality-gate'?: number;
         }
       }
     }
@@ -3000,6 +3115,66 @@ export namespace ExampleListResponse {
        */
       originalFileUrl?: string;
 
+      /**
+       * The mime type of the original file url.
+       *
+       * The original file is stored under a key that carries no extension, so this is
+       * the only way to know which format `originalFileUrl` serves (e.g. an HDRi skybox
+       * exposes a JPEG preview as `url` and its `.exr` or `.hdr` file as the original).
+       * Omitted when the stored format could not be determined.
+       */
+      originalMimeType?:
+        | 'application/gzip'
+        | 'application/json'
+        | 'application/octet-stream'
+        | 'application/pdf'
+        | 'application/safetensors'
+        | 'application/vnd.autodesk.fbx'
+        | 'application/x-authorware-bin'
+        | 'application/x-zip-compressed'
+        | 'application/x.autodesk.fbx'
+        | 'application/zip'
+        | 'audio/flac'
+        | 'audio/m4a'
+        | 'audio/mpeg'
+        | 'audio/ogg'
+        | 'audio/wav'
+        | 'image/aces'
+        | 'image/avif'
+        | 'image/bmp'
+        | 'image/gif'
+        | 'image/heic'
+        | 'image/jpeg'
+        | 'image/png'
+        | 'image/svg+xml'
+        | 'image/tiff'
+        | 'image/vnd.radiance'
+        | 'image/webp'
+        | 'image/x-exr'
+        | 'model/glb'
+        | 'model/gltf+json'
+        | 'model/gltf-binary'
+        | 'model/ksplat'
+        | 'model/mtl'
+        | 'model/obj'
+        | 'model/ply'
+        | 'model/sog'
+        | 'model/splat'
+        | 'model/spz'
+        | 'model/stl'
+        | 'model/vnd.collada+xml'
+        | 'model/vnd.ms-package.3dmanufacturing-3dmodel+xml'
+        | 'model/x-3d-vox'
+        | 'model/x-blender'
+        | 'model/x-fbx'
+        | 'model/x-maya-ascii'
+        | 'model/x-maya-binary'
+        | 'model/x3d+xml'
+        | 'text/plain'
+        | 'video/mp4'
+        | 'video/quicktime'
+        | 'video/webm';
+
       /**
        * The output index of the asset within a job This index is an positive integer
        * that starts at 0 It is used to differentiate between multiple outputs of the
@@ -3015,12 +3190,12 @@ export namespace ExampleListResponse {
       preview?: Asset.Preview;
 
       /**
-       * SlopGuard detection result, computed asynchronously after generation.
+       * Quality Gate result, computed asynchronously after generation.
        *
        * `details` (the per-dimension reasons and suggestions) is returned only when the
-       * asset is read with `withSlopGuardDetails=true`.
+       * asset is read with `withQualityGateDetails=true`.
        */
-      slopGuard?: Asset.SlopGuard;
+      qualityGate?: Asset.QualityGate;
 
       /**
        * The asset's thumbnail.
@@ -3228,6 +3403,12 @@ export namespace ExampleListResponse {
          */
         factor?: number;
 
+        /**
+         * The name its parent's files reference it by (an OBJ's MTL, an MTL's texture),
+         * kept as delivered.
+         */
+        fileName?: string;
+
         filterSpeckle?: number;
 
         /**
@@ -3317,6 +3498,11 @@ export namespace ExampleListResponse {
          */
         invert?: boolean;
 
+        /**
+         * Its own references (an OBJ's `mtllib`, an MTL's maps) were kept as delivered.
+         */
+        keepsFileNames?: boolean;
+
         /**
          * How polished is the surface? 0 is like a rough surface, 1 is like a mirror
          */
@@ -3939,12 +4125,12 @@ export namespace ExampleListResponse {
       }
 
       /**
-       * SlopGuard detection result, computed asynchronously after generation.
+       * Quality Gate result, computed asynchronously after generation.
        *
        * `details` (the per-dimension reasons and suggestions) is returned only when the
-       * asset is read with `withSlopGuardDetails=true`.
+       * asset is read with `withQualityGateDetails=true`.
        */
-      export interface SlopGuard {
+      export interface QualityGate {
         /**
          * ISO-8601 timestamp of when scoring ran
          */
@@ -3978,13 +4164,13 @@ export namespace ExampleListResponse {
         /**
          * Per-dimension reasons and suggestions, as produced by the detector.
          *
-         * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+         * Returned only when the asset is read with `withQualityGateDetails=true` by the
          * project that owns it — the brief-compliance text paraphrases that project's
          * brief, so a cross-project read of a public asset gets the summary alone. Also
          * omitted when the archived verdict is unavailable (asset scored by an older
          * version, or an unreadable archive).
          */
-        details?: SlopGuard.Details;
+        details?: QualityGate.Details;
 
         /**
          * Error message when status is 'error' (truncated)
@@ -4007,11 +4193,11 @@ export namespace ExampleListResponse {
         verdict?: 'fail' | 'pass' | 'warn';
       }
 
-      export namespace SlopGuard {
+      export namespace QualityGate {
         /**
          * Per-dimension reasons and suggestions, as produced by the detector.
          *
-         * Returned only when the asset is read with `withSlopGuardDetails=true` by the
+         * Returned only when the asset is read with `withQualityGateDetails=true` by the
          * project that owns it — the brief-compliance text paraphrases that project's
          * brief, so a cross-project read of a public asset gets the summary alone. Also
          * omitted when the archived verdict is unavailable (asset scored by an older
@@ -4614,6 +4800,7 @@ export namespace ExampleListResponse {
             | 'remove-background'
             | 'transform'
             | 'user-approval'
+            | 'user-selection'
             | 'workflow';
 
           /**
@@ -4644,14 +4831,15 @@ export namespace ExampleListResponse {
           includeOutputsInWorkflowJob?: true;
 
           /**
-           * The inputs of the node.
+           * The inputs of the node. For a user-selection node, the array input's `min`/`max`
+           * bound how many items the user may pick (defaults: 1 and 100); conditional
+           * connections may be present as additional inputs.
            */
           inputs?: Array<Flow.Input>;
 
           /**
-           * 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.
+           * Statically-configured items for a List node, or the frozen candidate list of a
+           * UserSelection node. The values can be strings, numbers, or asset IDs.
            */
           items?: Array<string>;
 
@@ -4800,7 +4988,9 @@ export namespace ExampleListResponse {
              * 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
+             * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+             * a model does not declare one, \`image\` is returned, which is the kind used at
+             * generation time.
              */
             kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -4828,8 +5018,9 @@ export namespace ExampleListResponse {
             maxDuration?: number;
 
             /**
-             * The maximum allowed length for \`string\` inputs. Also applies to each item in
-             * \`string_array\`.
+             * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             maxLength?: number;
 
@@ -4846,8 +5037,9 @@ export namespace ExampleListResponse {
             min?: number;
 
             /**
-             * The minimum allowed length for string inputs. Also applies to each item in
-             * \`string_array\`.
+             * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+             * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+             * ITEMS instead — the length of each item is not constrained.
              */
             minLength?: number;
 
@@ -4927,8 +5119,7 @@ export namespace ExampleListResponse {
              * - \`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
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -5027,7 +5218,9 @@ export namespace ExampleListResponse {
                * 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
+               * data:kind, prefix \`file\` and \`file_array\` inputs always expose a kind: when
+               * a model does not declare one, \`image\` is returned, which is the kind used at
+               * generation time.
                */
               kind?: '3d' | 'audio' | 'document' | 'image' | 'image-hdr' | 'json' | 'text' | 'video';
 
@@ -5055,8 +5248,9 @@ export namespace ExampleListResponse {
               maxDuration?: number;
 
               /**
-               * The maximum allowed length for \`string\` inputs. Also applies to each item in
-               * \`string_array\`.
+               * The maximum allowed length for \`string\` and \`model\` inputs, in characters.
+               * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+               * ITEMS instead — the length of each item is not constrained.
                */
               maxLength?: number;
 
@@ -5073,8 +5267,9 @@ export namespace ExampleListResponse {
               min?: number;
 
               /**
-               * The minimum allowed length for string inputs. Also applies to each item in
-               * \`string_array\`.
+               * The minimum allowed length for \`string\` and \`model\` inputs, in characters.
+               * For the array types (\`string_array\`, \`model_array\`) it bounds the NUMBER OF
+               * ITEMS instead — the length of each item is not constrained.
                */
               minLength?: number;
 
@@ -5154,8 +5349,7 @@ export namespace ExampleListResponse {
                * - \`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
+               * - \`conditional\`: Input is required when other inputs have specific values
                *
                * By default, the input is not required.
                */
@@ -5212,8 +5406,7 @@ export namespace ExampleListResponse {
                * - \`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
+               * - \`conditional\`: Input is required when other inputs have specific values
                *
                * By default, the input is not required.
                */
@@ -5224,12 +5417,9 @@ export namespace ExampleListResponse {
                 always?: boolean;
 
                 /**
-                 * 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
+                 * Makes this input required when other inputs have one of the listed values
                  */
-                conditionalValues?: unknown;
+                conditional?: Required.Conditional;
 
                 /**
                  * Makes this input required when another input is defined:
@@ -5247,6 +5437,26 @@ export namespace ExampleListResponse {
                  */
                 ifNotDefined?: unknown;
               }
+
+              export namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                export interface Conditional {
+                  /**
+                   * The conditions to check:
+                   *
+                   * - Key: name of the input to check
+                   * - Value: values of that input that satisfy the condition
+                   */
+                  values: unknown;
+
+                  /**
+                   * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                   */
+                  operator?: 'and' | 'or';
+                }
+              }
             }
 
             /**
@@ -5287,8 +5497,7 @@ export namespace ExampleListResponse {
              * - \`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
+             * - \`conditional\`: Input is required when other inputs have specific values
              *
              * By default, the input is not required.
              */
@@ -5299,12 +5508,9 @@ export namespace ExampleListResponse {
               always?: boolean;
 
               /**
-               * 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
+               * Makes this input required when other inputs have one of the listed values
                */
-              conditionalValues?: unknown;
+              conditional?: Required.Conditional;
 
               /**
                * Makes this input required when another input is defined:
@@ -5322,6 +5528,26 @@ export namespace ExampleListResponse {
                */
               ifNotDefined?: unknown;
             }
+
+            export namespace Required {
+              /**
+               * Makes this input required when other inputs have one of the listed values
+               */
+              export interface Conditional {
+                /**
+                 * The conditions to check:
+                 *
+                 * - Key: name of the input to check
+                 * - Value: values of that input that satisfy the condition
+                 */
+                values: unknown;
+
+                /**
+                 * How the conditions combine: \`and\` (all must match) or \`or\` (any must match)
+                 */
+                operator?: 'and' | 'or';
+              }
+            }
           }
 
           /**
@@ -5379,7 +5605,7 @@ export namespace ExampleListResponse {
 
         /**
          * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-         * top of the generation itself, such as `slop-detection`.
+         * top of the generation itself, such as `quality-gate`.
          *
          * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
          * values here.
@@ -5409,7 +5635,7 @@ export namespace ExampleListResponse {
       export namespace Billing {
         /**
          * Compute Units charged for the ADD-ONS of this job, per action — the fees paid on
-         * top of the generation itself, such as `slop-detection`.
+         * top of the generation itself, such as `quality-gate`.
          *
          * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
          * values here.
@@ -5429,7 +5655,7 @@ export namespace ExampleListResponse {
         export interface CuCostDetails {
           'ip-detection'?: number;
 
-          'slop-detection'?: number;
+          'quality-gate'?: number;
         }
       }
     }