@scenario-labs/sdk 2.7.0 → 3.0.0

package/src/resources/assets/assets.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../../core/resource';
 import * as DownloadAPI from './download';
 import {
   Download,
+  DownloadGetStatusParams,
   DownloadGetStatusResponse,
   DownloadRequestBatchParams,
   DownloadRequestBatchResponse,
@@ -45,8 +46,12 @@ export class Assets extends APIResource {
     params: AssetUpdateParams,
     options?: RequestOptions,
   ): APIPromise<AssetUpdateResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.put(path`/assets/${assetID}`, { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.put(path`/assets/${assetID}`, {
+      query: { originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -64,8 +69,9 @@ export class Assets extends APIResource {
   /**
    * Delete multiple assets
    */
-  deleteMultiple(body: AssetDeleteMultipleParams, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.delete('/assets', { body, ...options });
+  deleteMultiple(params: AssetDeleteMultipleParams, options?: RequestOptions): APIPromise<unknown> {
+    const { projectId, ...body } = params;
+    return this._client.delete('/assets', { query: { projectId }, body, ...options });
   }
 
   /**
@@ -76,16 +82,20 @@ export class Assets extends APIResource {
     params: AssetDuplicateParams,
     options?: RequestOptions,
   ): APIPromise<AssetDuplicateResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.post(path`/assets/${assetID}/copy`, { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.post(path`/assets/${assetID}/copy`, {
+      query: { originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
    * Get multiple assets by their IDs
    */
   getBulk(params: AssetGetBulkParams, options?: RequestOptions): APIPromise<AssetGetBulkResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.post('/assets/get-bulk', { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.post('/assets/get-bulk', { query: { originalAssets, projectId }, body, ...options });
   }
 
   /**
@@ -107,8 +117,12 @@ export class Assets extends APIResource {
    * Lock a canvas
    */
   lock(assetID: string, params: AssetLockParams, options?: RequestOptions): APIPromise<AssetLockResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.put(path`/assets/${assetID}/lock`, { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.put(path`/assets/${assetID}/lock`, {
+      query: { originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -119,8 +133,12 @@ export class Assets extends APIResource {
     params: AssetUnlockParams,
     options?: RequestOptions,
   ): APIPromise<AssetUnlockResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.put(path`/assets/${assetID}/unlock`, { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.put(path`/assets/${assetID}/unlock`, {
+      query: { originalAssets, projectId },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -128,18 +146,19 @@ export class Assets extends APIResource {
    */
   updateTags(
     assetID: string,
-    body: AssetUpdateTagsParams,
+    params: AssetUpdateTagsParams,
     options?: RequestOptions,
   ): APIPromise<AssetUpdateTagsResponse> {
-    return this._client.put(path`/assets/${assetID}/tags`, { body, ...options });
+    const { projectId, ...body } = params;
+    return this._client.put(path`/assets/${assetID}/tags`, { query: { projectId }, body, ...options });
   }
 
   /**
    * Upload an image or canvas
    */
   upload(params: AssetUploadParams, options?: RequestOptions): APIPromise<AssetUploadResponse> {
-    const { originalAssets, ...body } = params;
-    return this._client.post('/assets', { query: { originalAssets }, body, ...options });
+    const { originalAssets, projectId, ...body } = params;
+    return this._client.post('/assets', { query: { originalAssets, projectId }, body, ...options });
   }
 }
 
@@ -395,6 +414,14 @@ export namespace AssetRetrieveResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -1311,6 +1338,140 @@ export namespace AssetRetrieveResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -1572,6 +1733,14 @@ export namespace AssetUpdateResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -2488,6 +2657,140 @@ export namespace AssetUpdateResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -2744,6 +3047,14 @@ export interface AssetListResponse {
    */
   preview?: AssetListResponse.Preview;
 
+  /**
+   * SlopGuard detection result, computed asynchronously after generation.
+   *
+   * `details` (the per-dimension reasons and suggestions) is returned only when the
+   * asset is read with `withSlopGuardDetails=true`.
+   */
+  slopGuard?: AssetListResponse.SlopGuard;
+
   /**
    * The asset's thumbnail.
    *
@@ -3660,6 +3971,140 @@ export namespace AssetListResponse {
     url: string;
   }
 
+  /**
+   * SlopGuard detection result, computed asynchronously after generation.
+   *
+   * `details` (the per-dimension reasons and suggestions) is returned only when the
+   * asset is read with `withSlopGuardDetails=true`.
+   */
+  export interface SlopGuard {
+    /**
+     * ISO-8601 timestamp of when scoring ran
+     */
+    computedAt: string;
+
+    /**
+     * Whether scoring succeeded or errored
+     */
+    status: 'error' | 'scored';
+
+    /**
+     * Rubric/model version that produced this result
+     */
+    version: string;
+
+    /**
+     * Generic AI-quality sub-score
+     */
+    aiQualityScore?: number;
+
+    /**
+     * Ids of briefs that contributed
+     */
+    appliedBriefIds?: Array<string>;
+
+    /**
+     * Brief-compliance sub-score (omitted when no brief applied)
+     */
+    briefComplianceScore?: number;
+
+    /**
+     * Per-dimension reasons and suggestions, as produced by the detector.
+     *
+     * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+    /**
+     * Error message when status is 'error' (truncated)
+     */
+    error?: string;
+
+    /**
+     * 0–100 composite score (present when status is 'scored')
+     */
+    overallScore?: number;
+
+    /**
+     * Sensitivity used for the verdict
+     */
+    sensitivity?: 'high' | 'low' | 'medium';
+
+    /**
+     * pass / warn / fail (present when status is 'scored')
+     */
+    verdict?: 'fail' | 'pass' | 'warn';
+  }
+
+  export namespace SlopGuard {
+    /**
+     * Per-dimension reasons and suggestions, as produced by the detector.
+     *
+     * Returned only when the asset is read with `withSlopGuardDetails=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).
+     */
+    export interface Details {
+      /**
+       * Always-on generic AI-quality dimension
+       */
+      aiQuality: Details.AIQuality;
+
+      /**
+       * Brief-compliance dimension; omitted when no brief applied
+       */
+      briefCompliance?: Details.BriefCompliance;
+    }
+
+    export namespace Details {
+      /**
+       * Always-on generic AI-quality dimension
+       */
+      export interface AIQuality {
+        /**
+         * Why the image scored as it did
+         */
+        reasons: Array<string>;
+
+        /**
+         * 0–100; higher is better (more compliant / less AI-looking)
+         */
+        score: number;
+
+        /**
+         * Actionable suggestions to improve the score
+         */
+        suggestions: Array<string>;
+      }
+
+      /**
+       * Brief-compliance dimension; omitted when no brief applied
+       */
+      export interface BriefCompliance {
+        /**
+         * Why the image scored as it did
+         */
+        reasons: Array<string>;
+
+        /**
+         * 0–100; higher is better (more compliant / less AI-looking)
+         */
+        score: number;
+
+        /**
+         * Actionable suggestions to improve the score
+         */
+        suggestions: Array<string>;
+      }
+    }
+  }
+
   /**
    * The asset's thumbnail.
    *
@@ -3922,6 +4367,14 @@ export namespace AssetDuplicateResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -4839,23 +5292,157 @@ export namespace AssetDuplicateResponse {
     }
 
     /**
-     * The asset's thumbnail.
+     * SlopGuard detection result, computed asynchronously after generation.
      *
-     * Contains the assetId and the url of the thumbnail.
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
      */
-    export interface Thumbnail {
-      assetId: string;
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
 
-      url: string;
-    }
-  }
-}
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
 
-export interface AssetGetBulkResponse {
-  assets: Array<AssetGetBulkResponse.Asset>;
-}
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
 
-export namespace AssetGetBulkResponse {
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
+    /**
+     * The asset's thumbnail.
+     *
+     * Contains the assetId and the url of the thumbnail.
+     */
+    export interface Thumbnail {
+      assetId: string;
+
+      url: string;
+    }
+  }
+}
+
+export interface AssetGetBulkResponse {
+  assets: Array<AssetGetBulkResponse.Asset>;
+}
+
+export namespace AssetGetBulkResponse {
   export interface Asset {
     /**
      * The asset ID (example: "asset_GTrL3mq4SXWyMxkOHRxlpw")
@@ -5099,6 +5686,14 @@ export namespace AssetGetBulkResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -6015,6 +6610,140 @@ export namespace AssetGetBulkResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -6291,6 +7020,14 @@ export namespace AssetLockResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -7207,6 +7944,140 @@ export namespace AssetLockResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -7468,6 +8339,14 @@ export namespace AssetUnlockResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -8384,6 +9263,140 @@ export namespace AssetUnlockResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -8659,6 +9672,14 @@ export namespace AssetUploadResponse {
      */
     preview?: Asset.Preview;
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    slopGuard?: Asset.SlopGuard;
+
     /**
      * The asset's thumbnail.
      *
@@ -9575,6 +10596,140 @@ export namespace AssetUploadResponse {
       url: string;
     }
 
+    /**
+     * SlopGuard detection result, computed asynchronously after generation.
+     *
+     * `details` (the per-dimension reasons and suggestions) is returned only when the
+     * asset is read with `withSlopGuardDetails=true`.
+     */
+    export interface SlopGuard {
+      /**
+       * ISO-8601 timestamp of when scoring ran
+       */
+      computedAt: string;
+
+      /**
+       * Whether scoring succeeded or errored
+       */
+      status: 'error' | 'scored';
+
+      /**
+       * Rubric/model version that produced this result
+       */
+      version: string;
+
+      /**
+       * Generic AI-quality sub-score
+       */
+      aiQualityScore?: number;
+
+      /**
+       * Ids of briefs that contributed
+       */
+      appliedBriefIds?: Array<string>;
+
+      /**
+       * Brief-compliance sub-score (omitted when no brief applied)
+       */
+      briefComplianceScore?: number;
+
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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;
+
+      /**
+       * Error message when status is 'error' (truncated)
+       */
+      error?: string;
+
+      /**
+       * 0–100 composite score (present when status is 'scored')
+       */
+      overallScore?: number;
+
+      /**
+       * Sensitivity used for the verdict
+       */
+      sensitivity?: 'high' | 'low' | 'medium';
+
+      /**
+       * pass / warn / fail (present when status is 'scored')
+       */
+      verdict?: 'fail' | 'pass' | 'warn';
+    }
+
+    export namespace SlopGuard {
+      /**
+       * Per-dimension reasons and suggestions, as produced by the detector.
+       *
+       * Returned only when the asset is read with `withSlopGuardDetails=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).
+       */
+      export interface Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        aiQuality: Details.AIQuality;
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        briefCompliance?: Details.BriefCompliance;
+      }
+
+      export namespace Details {
+        /**
+         * Always-on generic AI-quality dimension
+         */
+        export interface AIQuality {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+
+        /**
+         * Brief-compliance dimension; omitted when no brief applied
+         */
+        export interface BriefCompliance {
+          /**
+           * Why the image scored as it did
+           */
+          reasons: Array<string>;
+
+          /**
+           * 0–100; higher is better (more compliant / less AI-looking)
+           */
+          score: number;
+
+          /**
+           * Actionable suggestions to improve the score
+           */
+          suggestions: Array<string>;
+        }
+      }
+    }
+
     /**
      * The asset's thumbnail.
      *
@@ -10534,6 +11689,27 @@ export namespace AssetUploadResponse {
 
       cuDiscount: number;
 
+      /**
+       * 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`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      cuCostDetails?: Billing.CuCostDetails;
+
       /**
        * When true, the credits charged for this job are not automatically refunded if
        * the generation fails, because the model used does not support refund-on-failure.
@@ -10541,6 +11717,33 @@ export namespace AssetUploadResponse {
        */
       disableRefund?: boolean;
     }
+
+    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`.
+       *
+       * `cuCost` above is the main action alone, so the job's total is `cuCost` plus the
+       * values here.
+       *
+       * Two caveats when displaying it:
+       *
+       * - These are a remaining refundable balance, not a receipt: a job that failed or
+       *   was cancelled has had its add-ons refunded, so they read 0 while `cuCost`
+       *   still shows the main action's original charge.
+       * - `ip-detection` is part of the shape but is never populated today: that fee is
+       *   charged outside the job and reported once, as
+       *   `ipDetection.creativeUnitsCharged`, in the response of the request that ran
+       *   it.
+       *
+       * Absent when the job paid for no add-on.
+       */
+      export interface CuCostDetails {
+        'ip-detection'?: number;
+
+        'slop-detection'?: number;
+      }
+    }
   }
 }
 
@@ -10550,10 +11753,24 @@ export interface AssetRetrieveParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Include the embedding in the response
    */
   withEmbedding?: boolean;
+
+  /**
+   * Include the per-dimension SlopGuard verdict (`slopGuard.details`: reasons and
+   * suggestions for each scored dimension). Honoured only when the asset belongs to
+   * the calling project, since the brief-compliance text paraphrases that project’s
+   * brief; ignored otherwise, including on public unauthenticated access.
+   */
+  withSlopGuardDetails?: boolean;
 }
 
 export interface AssetUpdateParams {
@@ -10562,6 +11779,12 @@ export interface AssetUpdateParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Body param: The new value for the canvas as a stringified JSON.
    */
@@ -10651,6 +11874,12 @@ export interface AssetListParams extends AssetsCursorParams {
    */
   privacy?: string;
 
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * List all the children assets that were generated from a specific root asset
    */
@@ -10896,9 +12125,15 @@ export interface AssetListParams extends AssetsCursorParams {
 
 export interface AssetDeleteMultipleParams {
   /**
-   * The ids of the assets to delete. (Max 100 at once)
+   * Body param: The ids of the assets to delete. (Max 100 at once)
    */
   assetIds: Array<string>;
+
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
 }
 
 export interface AssetDuplicateParams {
@@ -10907,6 +12142,12 @@ export interface AssetDuplicateParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Body param: The id of the project to copy the asset to. If not provided, the
    * asset will be copied to the canvas project.
@@ -10920,6 +12161,12 @@ export interface AssetGetBulkParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Body param: The list of asset ids the team has read access to. Limit of 200
    * assets.
@@ -10933,6 +12180,12 @@ export interface AssetListSnapshotsParams extends SnapshotsCursorParams {
    * value is 100, minimum value is 10
    */
   pageSize?: number;
+
+  /**
+   * The projectId used for ownership resource management. Either to assert ownership
+   * or to set the owner of the resource(s)
+   */
+  projectId?: string;
 }
 
 export interface AssetLockParams {
@@ -10945,6 +12198,12 @@ export interface AssetLockParams {
    * Query param: If set to true, returns the original asset without transformation
    */
   originalAssets?: boolean;
+
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
 }
 
 export interface AssetUnlockParams {
@@ -10953,6 +12212,12 @@ export interface AssetUnlockParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Body param: If true, no need to pass a lockId.
    */
@@ -10966,17 +12231,23 @@ export interface AssetUnlockParams {
 
 export interface AssetUpdateTagsParams {
   /**
-   * The list of tags to add
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
+  /**
+   * Body param: The list of tags to add
    */
   add?: Array<string>;
 
   /**
-   * The list of tags to delete
+   * Body param: The list of tags to delete
    */
   delete?: Array<string>;
 
   /**
-   * If true, the function will throw an error if:
+   * Body param: If true, the function will throw an error if:
    *
    * - one of the tags to add already exists
    * - one of the tags to delete is not found If false, the endpoint will behave as
@@ -10996,6 +12267,12 @@ export interface AssetUploadParams {
    */
   originalAssets?: boolean;
 
+  /**
+   * Query param: The projectId used for ownership resource management. Either to
+   * assert ownership or to set the owner of the resource(s)
+   */
+  projectId?: string;
+
   /**
    * Body param: The canvas to upload as a stringified JSON. Ignored if `image` is
    * provided.
@@ -11065,6 +12342,7 @@ export declare namespace Assets {
     type DownloadGetStatusResponse as DownloadGetStatusResponse,
     type DownloadRequestResponse as DownloadRequestResponse,
     type DownloadRequestBatchResponse as DownloadRequestBatchResponse,
+    type DownloadGetStatusParams as DownloadGetStatusParams,
     type DownloadRequestParams as DownloadRequestParams,
     type DownloadRequestBatchParams as DownloadRequestBatchParams,
   };