@scenario-labs/sdk 3.2.0 → 3.3.1

package/resources/models/scores.d.ts

@@ -0,0 +1,278 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Scores extends APIResource {
+    /**
+     * Get the prompt scores for the given `modelId`
+     */
+    retrievePrompt(modelID: string, query?: ScoreRetrievePromptParams | null | undefined, options?: RequestOptions): APIPromise<ScoreRetrievePromptResponse>;
+    /**
+     * Get the training dataset scores for the given `modelId`
+     */
+    retrieveTrainingDataset(modelID: string, query?: ScoreRetrieveTrainingDatasetParams | null | undefined, options?: RequestOptions): APIPromise<ScoreRetrieveTrainingDatasetResponse>;
+}
+export interface ScoreRetrievePromptResponse {
+    /**
+     * Different components used to compute the final score
+     */
+    details: ScoreRetrievePromptResponse.Details;
+    /**
+     * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
+     */
+    modelId: string;
+    /**
+     * The prompt's score for the input modelId
+     *
+     * The score is a number between 0 and 1. The higher the score, the better the
+     * prompt is for the model
+     */
+    score: number;
+    /**
+     * The status of the prompt's score
+     *
+     * Details if all the necessary data is present to compute the score
+     */
+    status: 'complete' | 'incomplete' | 'unknown';
+    /**
+     * Present only if the prompt has one or more syntax errors
+     *
+     * The API checks several syntax errors in the prompt
+     */
+    syntaxError?: 'Prompt weight should be between 0 and 2' | 'Prompt weight symbol should be - or + with a maximum length of 5. Ex: --, ++, ---, +++++' | "Unsupported prompt syntax: '[to:when], [from::when]'" | "Unsupported prompt syntax: 'word:<weight>' or '(word):<weight>'. Please use 'word<weight>' or '(word)<weight>' instead" | 'Unsupported prompt syntax: --(s|c)ref' | 'Unsupported prompt syntax: <name:weight> or <lora:name:weight>' | 'Unsupported url in prompt';
+}
+export declare namespace ScoreRetrievePromptResponse {
+    /**
+     * Different components used to compute the final score
+     */
+    interface Details {
+        /**
+         * The Dice-Sørensen similarity between the prompt and each captions from the
+         * model's training images
+         *
+         * The values are between 0 and 1. The higher the value, the more similar the
+         * prompt is to the training images' captions
+         */
+        captionsSimilarity: Details.CaptionsSimilarity;
+        /**
+         * The cosine similarity between the prompt and the model's caption embedding
+         *
+         * The value is a number between -1 and 1. The higher the value, the more similar
+         * the prompt is to the model's caption embedding
+         */
+        embeddingSimilarity: number;
+        /**
+         * The Dice-Sørensen similarity between the prompt and each prompts from the
+         * model's examples
+         *
+         * The values are between 0 and 1. The higher the value, the more similar the
+         * prompt is to the prompts' examples
+         */
+        promptsSimilarity?: Details.PromptsSimilarity;
+    }
+    namespace Details {
+        /**
+         * The Dice-Sørensen similarity between the prompt and each captions from the
+         * model's training images
+         *
+         * The values are between 0 and 1. The higher the value, the more similar the
+         * prompt is to the training images' captions
+         */
+        interface CaptionsSimilarity {
+            mean: number;
+            median: number;
+            min: number;
+        }
+        /**
+         * The Dice-Sørensen similarity between the prompt and each prompts from the
+         * model's examples
+         *
+         * The values are between 0 and 1. The higher the value, the more similar the
+         * prompt is to the prompts' examples
+         */
+        interface PromptsSimilarity {
+            mean: number;
+            median: number;
+            min: number;
+        }
+    }
+}
+export interface ScoreRetrieveTrainingDatasetResponse {
+    /**
+     * Different components used to compute the final score
+     */
+    details: ScoreRetrieveTrainingDatasetResponse.Details;
+    /**
+     * The model ID (example: "model_eyVcnFJcR92BxBkz7N6g5w")
+     */
+    modelId: string;
+    /**
+     * The training dataset's score for the input modelId
+     *
+     * The score is a number between 0 and 1. The higher the score, the most chance the
+     * model has to train well
+     */
+    score: number;
+    /**
+     * The status of the training dataset's score
+     *
+     * Details if all the necessary data is present to compute the score
+     */
+    status: 'complete' | 'incomplete' | 'unknown';
+    /**
+     * Present only if their is a warning between the assets of the couples
+     */
+    assetCouplesWarnings?: Array<ScoreRetrieveTrainingDatasetResponse.AssetCouplesWarning>;
+    /**
+     * Present only if the training image assets of the modelId have one or more
+     * warnings
+     */
+    assetsWarnings?: Array<ScoreRetrieveTrainingDatasetResponse.AssetsWarning>;
+}
+export declare namespace ScoreRetrieveTrainingDatasetResponse {
+    /**
+     * Different components used to compute the final score
+     */
+    interface Details {
+        /**
+         * For each couple of assets in the training dataset, the distance between the
+         * captions
+         */
+        assetCouplesCaptionsDistance: Array<Details.AssetCouplesCaptionsDistance>;
+        /**
+         * For each couple of assets in the training dataset, the similarity between the
+         * assets
+         */
+        assetCouplesSimilarity: Array<Details.AssetCouplesSimilarity>;
+        /**
+         * For each asset, the similarity with the model's embedding (excluding the current
+         * asset)
+         */
+        assetsEmbeddingSimilarity: Array<Details.AssetsEmbeddingSimilarity>;
+        /**
+         * The min, mean, median of the assetsEmbeddingSimilarity
+         */
+        assetsSimilarity: Details.AssetsSimilarity;
+        /**
+         * The min, mean, median of the assetCouplesCaptionsDistance
+         */
+        couplesCaptionsDistance: Details.CouplesCaptionsDistance;
+        /**
+         * The min, mean, median of the assetCouplesSimilarity
+         */
+        couplesSimilarity: Details.CouplesSimilarity;
+        /**
+         * Takes into account all missing data and warnings to compute a metadata score
+         */
+        metadataScore: number;
+    }
+    namespace Details {
+        interface AssetCouplesCaptionsDistance {
+            /**
+             * The couple of AssetIds (example: ['asset_GTrL3mq4SXWyMxkOHRxlpw',
+             * 'asset_6VrLs8nC1DHWCfKGaVne0gBn'])
+             */
+            couple: Array<string>;
+            /**
+             * The Dice-Sørensen distance between the captions of the assetIds of the couple.
+             */
+            distance: number;
+        }
+        interface AssetCouplesSimilarity {
+            /**
+             * The couple of AssetIds (example: ['asset_GTrL3mq4SXWyMxkOHRxlpw',
+             * 'asset_6VrLs8nC1DHWCfKGaVne0gBn'])
+             */
+            couple: Array<string>;
+            /**
+             * The cosine similarity between the assetIds of the couple.
+             *
+             * The value is a number between -1 and 1. The higher the value, the more similar
+             * the assets are to each other
+             */
+            similarity: number;
+        }
+        interface AssetsEmbeddingSimilarity {
+            /**
+             * The AssetId associated with their similarity (example:
+             * "asset_GTrL3mq4SXWyMxkOHRxlpw")
+             */
+            assetId: string;
+            /**
+             * The cosine similarity between the assetId and the model's embedding minus the
+             * asset's embedding
+             *
+             * The value is a number between -1 and 1. The higher the value, the more similar
+             * the asset is to the model's embedding
+             */
+            similarity: number;
+        }
+        /**
+         * The min, mean, median of the assetsEmbeddingSimilarity
+         */
+        interface AssetsSimilarity {
+            mean: number;
+            median: number;
+            min: number;
+        }
+        /**
+         * The min, mean, median of the assetCouplesCaptionsDistance
+         */
+        interface CouplesCaptionsDistance {
+            mean: number;
+            median: number;
+            min: number;
+        }
+        /**
+         * The min, mean, median of the assetCouplesSimilarity
+         */
+        interface CouplesSimilarity {
+            mean: number;
+            median: number;
+            min: number;
+        }
+    }
+    interface AssetCouplesWarning {
+        /**
+         * The couple of AssetIds (example: ['asset_GTrL3mq4SXWyMxkOHRxlpw',
+         * 'asset_6VrLs8nC1DHWCfKGaVne0gBn'])
+         */
+        couple: Array<string>;
+        /**
+         * An indicative message concerning the couple of assets
+         */
+        message: Array<'Captions are identical' | 'Captions are too close' | 'Empty caption' | 'Missing caption' | 'Missing metadata' | 'Same asset' | 'Similarity is too high' | 'Similarity with other assets is too low' | 'Width and height must be larger than 1024'>;
+    }
+    interface AssetsWarning {
+        /**
+         * The AssetId which has a warning (example: "asset_GTrL3mq4SXWyMxkOHRxlpw")
+         */
+        assetId: string;
+        /**
+         * An indicative message concerning the asset
+         */
+        message: Array<'Captions are identical' | 'Captions are too close' | 'Empty caption' | 'Missing caption' | 'Missing metadata' | 'Same asset' | 'Similarity is too high' | 'Similarity with other assets is too low' | 'Width and height must be larger than 1024'>;
+    }
+}
+export interface ScoreRetrievePromptParams {
+    /**
+     * The projectId used for ownership resource management. Either to assert ownership
+     * or to set the owner of the resource(s)
+     */
+    projectId?: string;
+    /**
+     * The prompt to score against the model. Required — the call returns 400 without
+     * it.
+     */
+    prompt?: string;
+}
+export interface ScoreRetrieveTrainingDatasetParams {
+    /**
+     * The projectId used for ownership resource management. Either to assert ownership
+     * or to set the owner of the resource(s)
+     */
+    projectId?: string;
+}
+export declare namespace Scores {
+    export { type ScoreRetrievePromptResponse as ScoreRetrievePromptResponse, type ScoreRetrieveTrainingDatasetResponse as ScoreRetrieveTrainingDatasetResponse, type ScoreRetrievePromptParams as ScoreRetrievePromptParams, type ScoreRetrieveTrainingDatasetParams as ScoreRetrieveTrainingDatasetParams, };
+}
+//# sourceMappingURL=scores.d.ts.map

package/resources/models/scores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.d.ts","sourceRoot":"","sources":["../../src/resources/models/scores.ts"],"names":[],"mappings":"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"}

package/resources/models/scores.js

@@ -0,0 +1,29 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scores = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+const values_1 = require("../../internal/utils/values.js");
+class Scores extends resource_1.APIResource {
+    /**
+     * Get the prompt scores for the given `modelId`
+     */
+    retrievePrompt(modelID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/models/${modelID}/scores/prompt`, {
+            ...options,
+            query: { ...query, ...(0, values_1.omitUndefined)(options?.query) },
+        });
+    }
+    /**
+     * Get the training dataset scores for the given `modelId`
+     */
+    retrieveTrainingDataset(modelID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/models/${modelID}/scores/training-dataset`, {
+            ...options,
+            query: { ...query, ...(0, values_1.omitUndefined)(options?.query) },
+        });
+    }
+}
+exports.Scores = Scores;
+//# sourceMappingURL=scores.js.map

package/resources/models/scores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.js","sourceRoot":"","sources":["../../src/resources/models/scores.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AACjD,2DAA4D;AAE5D,MAAa,MAAO,SAAQ,sBAAW;IACrC;;OAEG;IACH,cAAc,CACZ,OAAe,EACf,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,gBAAgB,EAAE;YAC9D,GAAG,OAAO;YACV,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,IAAA,sBAAa,EAAC,OAAO,EAAE,KAAK,CAAC,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,uBAAuB,CACrB,OAAe,EACf,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,0BAA0B,EAAE;YACxE,GAAG,OAAO;YACV,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,IAAA,sBAAa,EAAC,OAAO,EAAE,KAAK,CAAC,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AA5BD,wBA4BC"}

package/resources/models/scores.mjs

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+import { omitUndefined } from "../../internal/utils/values.mjs";
+export class Scores extends APIResource {
+    /**
+     * Get the prompt scores for the given `modelId`
+     */
+    retrievePrompt(modelID, query = {}, options) {
+        return this._client.get(path `/models/${modelID}/scores/prompt`, {
+            ...options,
+            query: { ...query, ...omitUndefined(options?.query) },
+        });
+    }
+    /**
+     * Get the training dataset scores for the given `modelId`
+     */
+    retrieveTrainingDataset(modelID, query = {}, options) {
+        return this._client.get(path `/models/${modelID}/scores/training-dataset`, {
+            ...options,
+            query: { ...query, ...omitUndefined(options?.query) },
+        });
+    }
+}
+//# sourceMappingURL=scores.mjs.map

package/resources/models/scores.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.mjs","sourceRoot":"","sources":["../../src/resources/models/scores.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AACjD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAE5D,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,cAAc,CACZ,OAAe,EACf,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,OAAO,gBAAgB,EAAE;YAC9D,GAAG,OAAO;YACV,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,uBAAuB,CACrB,OAAe,EACf,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,OAAO,0BAA0B,EAAE;YACxE,GAAG,OAAO;YACV,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/models/train.d.mts

@@ -72,8 +72,8 @@ export declare namespace TrainActionResponse {
          */
         updatedAt: string;
         /**
-         * The access restrictions of the model 0: Free plan 25: Creator plan 50: Pro plan
-         * 75: Team plan 100: Enterprise plan
+         * The access restrictions of the model 0: Free plan 25: Starter plan 50: Pro plan
+         * 75: Max plan 100: Enterprise plan
          */
         accessRestrictions?: 0 | 100 | 25 | 50 | 75;
         /**
@@ -113,6 +113,11 @@ export declare namespace TrainActionResponse {
          * it by modelId with GET /models/{modelId}
          */
         inputs?: Array<Model.Input>;
+        /**
+         * The ID of the job that trained the model, returned to the model owner only
+         * (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+         */
+        jobId?: string;
         /**
          * The model keyword, this is a legacy parameter, please use conceptPrompt in
          * parameters
@@ -405,8 +410,7 @@ export declare namespace TrainActionResponse {
              * - \`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.
              */
@@ -424,8 +428,7 @@ export declare namespace TrainActionResponse {
              * - \`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.
              */
@@ -435,12 +438,9 @@ export declare namespace TrainActionResponse {
                  */
                 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:
                  *
@@ -456,6 +456,24 @@ export declare namespace TrainActionResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * The parameters of the model
@@ -1171,7 +1189,7 @@ export declare namespace TrainTriggerResponse {
                 /**
                  * The type of the job for the node.
                  */
-                type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'workflow';
+                type: 'custom-model' | 'for-each' | 'generate-prompt' | 'list' | 'logic' | 'model' | 'remove-background' | 'transform' | 'user-approval' | 'user-selection' | 'workflow';
                 /**
                  * List of produced assets for this node.
                  */
@@ -1196,13 +1214,14 @@ export declare namespace TrainTriggerResponse {
                  */
                 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>;
                 /**
@@ -1403,8 +1422,7 @@ export declare namespace TrainTriggerResponse {
                      * - \`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.
                      */
@@ -1565,8 +1583,7 @@ export declare namespace TrainTriggerResponse {
                          * - \`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.
                          */
@@ -1616,8 +1633,7 @@ export declare namespace TrainTriggerResponse {
                          * - \`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.
                          */
@@ -1627,12 +1643,9 @@ export declare namespace TrainTriggerResponse {
                              */
                             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:
                              *
@@ -1648,6 +1661,24 @@ export declare namespace TrainTriggerResponse {
                              */
                             ifNotDefined?: unknown;
                         }
+                        namespace Required {
+                            /**
+                             * Makes this input required when other inputs have one of the listed values
+                             */
+                            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';
+                            }
+                        }
                     }
                     /**
                      * The reference to another input or output of the same workflow. Must have at
@@ -1683,8 +1714,7 @@ export declare namespace TrainTriggerResponse {
                      * - \`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.
                      */
@@ -1694,12 +1724,9 @@ export declare namespace TrainTriggerResponse {
                          */
                         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:
                          *
@@ -1715,6 +1742,24 @@ export declare namespace TrainTriggerResponse {
                          */
                         ifNotDefined?: unknown;
                     }
+                    namespace Required {
+                        /**
+                         * Makes this input required when other inputs have one of the listed values
+                         */
+                        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';
+                        }
+                    }
                 }
                 /**
                  * The logic of the node. Only available for logic nodes.
@@ -1862,8 +1907,8 @@ export declare namespace TrainTriggerResponse {
          */
         updatedAt: string;
         /**
-         * The access restrictions of the model 0: Free plan 25: Creator plan 50: Pro plan
-         * 75: Team plan 100: Enterprise plan
+         * The access restrictions of the model 0: Free plan 25: Starter plan 50: Pro plan
+         * 75: Max plan 100: Enterprise plan
          */
         accessRestrictions?: 0 | 100 | 25 | 50 | 75;
         /**
@@ -1903,6 +1948,11 @@ export declare namespace TrainTriggerResponse {
          * it by modelId with GET /models/{modelId}
          */
         inputs?: Array<Model.Input>;
+        /**
+         * The ID of the job that trained the model, returned to the model owner only
+         * (example: "job_ocZCnG1Df35XRL1QyCZSRxAG8")
+         */
+        jobId?: string;
         /**
          * The model keyword, this is a legacy parameter, please use conceptPrompt in
          * parameters
@@ -2195,8 +2245,7 @@ export declare namespace TrainTriggerResponse {
              * - \`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.
              */
@@ -2214,8 +2263,7 @@ export declare namespace TrainTriggerResponse {
              * - \`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.
              */
@@ -2225,12 +2273,9 @@ export declare namespace TrainTriggerResponse {
                  */
                 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:
                  *
@@ -2246,6 +2291,24 @@ export declare namespace TrainTriggerResponse {
                  */
                 ifNotDefined?: unknown;
             }
+            namespace Required {
+                /**
+                 * Makes this input required when other inputs have one of the listed values
+                 */
+                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';
+                }
+            }
         }
         /**
          * The parameters of the model