@scenario-labs/sdk 3.2.0 → 3.3.1

package/resources/workflows.mjs

@@ -2,34 +2,46 @@
 import { APIResource } from "../core/resource.mjs";
 import { WorkflowsCursor } from "../core/pagination.mjs";
 import { path } from "../internal/utils/path.mjs";
+import { omitUndefined } from "../internal/utils/values.mjs";
 export class Workflows extends APIResource {
     /**
      * Create workflow
      */
     create(params, options) {
         const { projectId, ...body } = params;
-        return this._client.post('/workflows', { query: { projectId }, body, ...options });
+        return this._client.post('/workflows', {
+            body,
+            ...options,
+            query: { projectId, ...omitUndefined(options?.query) },
+        });
     }
     /**
      * Get workflow by ID
      */
     retrieve(workflowID, query = {}, options) {
-        return this._client.get(path `/workflows/${workflowID}`, { query, ...options });
+        return this._client.get(path `/workflows/${workflowID}`, {
+            ...options,
+            query: { ...query, ...omitUndefined(options?.query) },
+        });
     }
     /**
      * Update workflow
      */
     update(workflowID, params, options) {
         const { projectId, ...body } = params;
-        return this._client.put(path `/workflows/${workflowID}`, { query: { projectId }, body, ...options });
+        return this._client.put(path `/workflows/${workflowID}`, {
+            body,
+            ...options,
+            query: { projectId, ...omitUndefined(options?.query) },
+        });
     }
     /**
      * List workflows
      */
     list(query = {}, options) {
         return this._client.getAPIList('/workflows', (WorkflowsCursor), {
-            query,
             ...options,
+            query: { ...query, ...omitUndefined(options?.query) },
         });
     }
     /**
@@ -37,14 +49,20 @@ export class Workflows extends APIResource {
      */
     delete(workflowID, params = {}, options) {
         const { projectId } = params ?? {};
-        return this._client.delete(path `/workflows/${workflowID}`, { query: { projectId }, ...options });
+        return this._client.delete(path `/workflows/${workflowID}`, {
+            ...options,
+            query: { projectId, ...omitUndefined(options?.query) },
+        });
     }
     /**
      * Get all unique tags from workflows in a project (all privacy levels). Optionally
      * filter by status.
      */
     getTags(query = {}, options) {
-        return this._client.get('/workflows/tags', { query, ...options });
+        return this._client.get('/workflows/tags', {
+            ...options,
+            query: { ...query, ...omitUndefined(options?.query) },
+        });
     }
     /**
      * Run a workflow
@@ -52,9 +70,9 @@ export class Workflows extends APIResource {
     run(workflowID, params, options) {
         const { body, dryRun, projectId } = params;
         return this._client.put(path `/workflows/${workflowID}/run`, {
-            query: { dryRun, projectId },
             body: body,
             ...options,
+            query: { dryRun, projectId, ...omitUndefined(options?.query) },
         });
     }
     /**
@@ -66,9 +84,22 @@ export class Workflows extends APIResource {
     userApproval(workflowID, params, options) {
         const { projectId, ...body } = params;
         return this._client.put(path `/workflows/${workflowID}/user-approval`, {
-            query: { projectId },
             body,
             ...options,
+            query: { projectId, ...omitUndefined(options?.query) },
+        });
+    }
+    /**
+     * Respond to a user-selection node in a workflow. Pass action="select" with
+     * selectedIndices to pick items and resume the workflow, or action="reject" to
+     * mark the node Rejected and cancel the workflow.
+     */
+    userSelection(workflowID, params, options) {
+        const { projectId, ...body } = params;
+        return this._client.put(path `/workflows/${workflowID}/user-selection`, {
+            body,
+            ...options,
+            query: { projectId, ...omitUndefined(options?.query) },
         });
     }
     /**

package/resources/workflows.mjs.map

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

package/src/client.ts

@@ -25,12 +25,18 @@ import {
   JobsCursorResponse,
   type ModelsCursorParams,
   ModelsCursorResponse,
+  type ProjectsCursorParams,
+  ProjectsCursorResponse,
+  type RecommendationsCursorParams,
+  RecommendationsCursorResponse,
   type SearchHitsOffsetParams,
   SearchHitsOffsetResponse,
   type SnapshotsCursorParams,
   SnapshotsCursorResponse,
   type TagsCursorParams,
   TagsCursorResponse,
+  type ThreadsCursorParams,
+  ThreadsCursorResponse,
   type WorkflowsCursorParams,
   WorkflowsCursorResponse,
 } from './core/pagination';
@@ -47,10 +53,14 @@ import {
   GenerateDetectResponse,
   GenerateEmbedParams,
   GenerateEmbedResponse,
+  GenerateIPDetectionParams,
+  GenerateIPDetectionResponse,
   GeneratePatchParams,
   GeneratePatchResponse,
   GeneratePromptParams,
   GeneratePromptResponse,
+  GenerateQualityGateParams,
+  GenerateQualityGateResponse,
   GenerateRunModelParams,
   GenerateRunModelResponse,
   GenerateTranslateParams,
@@ -67,6 +77,12 @@ import {
   Jobs,
 } from './resources/jobs';
 import { Oscu, OscuRetrievePricesResponse } from './resources/oscu';
+import {
+  RecommendationListModelsParams,
+  RecommendationListModelsResponse,
+  RecommendationListModelsResponsesRecommendationsCursor,
+  Recommendations,
+} from './resources/recommendations';
 import {
   Search,
   SearchAssetSearchParams,
@@ -109,6 +125,8 @@ import {
   WorkflowUpdateResponse,
   WorkflowUserApprovalParams,
   WorkflowUserApprovalResponse,
+  WorkflowUserSelectionParams,
+  WorkflowUserSelectionResponse,
   Workflows,
 } from './resources/workflows';
 import {
@@ -179,6 +197,28 @@ import {
   Models,
 } from './resources/models/models';
 import { Pricing } from './resources/pricing/pricing';
+import {
+  ProjectCreateParams,
+  ProjectCreateResponse,
+  ProjectDeleteResponse,
+  ProjectListParams,
+  ProjectListResponse,
+  ProjectListResponsesProjectsCursor,
+  ProjectRetrieveResponse,
+  ProjectUpdateParams,
+  ProjectUpdateResponse,
+  Projects,
+} from './resources/projects/projects';
+import {
+  TeamDeleteInvitationsParams,
+  TeamDeleteInvitationsResponse,
+  TeamListResponse,
+  TeamRetrieveLimitsResponse,
+  TeamRetrieveResponse,
+  TeamUpdateParams,
+  TeamUpdateResponse,
+  Teams,
+} from './resources/teams/teams';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -981,8 +1021,11 @@ export class Scenario {
   models: API.Models = new API.Models(this);
   oscu: API.Oscu = new API.Oscu(this);
   pricing: API.Pricing = new API.Pricing(this);
+  projects: API.Projects = new API.Projects(this);
+  recommendations: API.Recommendations = new API.Recommendations(this);
   search: API.Search = new API.Search(this);
   tags: API.Tags = new API.Tags(this);
+  teams: API.Teams = new API.Teams(this);
   uploads: API.Uploads = new API.Uploads(this);
   usages: API.Usages = new API.Usages(this);
   workflows: API.Workflows = new API.Workflows(this);
@@ -995,8 +1038,11 @@ Scenario.Jobs = Jobs;
 Scenario.Models = Models;
 Scenario.Oscu = Oscu;
 Scenario.Pricing = Pricing;
+Scenario.Projects = Projects;
+Scenario.Recommendations = Recommendations;
 Scenario.Search = Search;
 Scenario.Tags = Tags;
+Scenario.Teams = Teams;
 Scenario.Uploads = UploadsAPIUploads;
 Scenario.Usages = Usages;
 Scenario.Workflows = Workflows;
@@ -1034,6 +1080,24 @@ export declare namespace Scenario {
     type WorkflowsCursorResponse as WorkflowsCursorResponse,
   };
 
+  export import ThreadsCursor = Pagination.ThreadsCursor;
+  export {
+    type ThreadsCursorParams as ThreadsCursorParams,
+    type ThreadsCursorResponse as ThreadsCursorResponse,
+  };
+
+  export import ProjectsCursor = Pagination.ProjectsCursor;
+  export {
+    type ProjectsCursorParams as ProjectsCursorParams,
+    type ProjectsCursorResponse as ProjectsCursorResponse,
+  };
+
+  export import RecommendationsCursor = Pagination.RecommendationsCursor;
+  export {
+    type RecommendationsCursorParams as RecommendationsCursorParams,
+    type RecommendationsCursorResponse as RecommendationsCursorResponse,
+  };
+
   export import SearchHitsOffset = Pagination.SearchHitsOffset;
   export {
     type SearchHitsOffsetParams as SearchHitsOffsetParams,
@@ -1089,16 +1153,20 @@ export declare namespace Scenario {
     type GenerateDescribeStyleResponse as GenerateDescribeStyleResponse,
     type GenerateDetectResponse as GenerateDetectResponse,
     type GenerateEmbedResponse as GenerateEmbedResponse,
+    type GenerateIPDetectionResponse as GenerateIPDetectionResponse,
     type GeneratePatchResponse as GeneratePatchResponse,
     type GeneratePromptResponse as GeneratePromptResponse,
+    type GenerateQualityGateResponse as GenerateQualityGateResponse,
     type GenerateRunModelResponse as GenerateRunModelResponse,
     type GenerateTranslateResponse as GenerateTranslateResponse,
     type GenerateCaptionParams as GenerateCaptionParams,
     type GenerateDescribeStyleParams as GenerateDescribeStyleParams,
     type GenerateDetectParams as GenerateDetectParams,
     type GenerateEmbedParams as GenerateEmbedParams,
+    type GenerateIPDetectionParams as GenerateIPDetectionParams,
     type GeneratePatchParams as GeneratePatchParams,
     type GeneratePromptParams as GeneratePromptParams,
+    type GenerateQualityGateParams as GenerateQualityGateParams,
     type GenerateRunModelParams as GenerateRunModelParams,
     type GenerateTranslateParams as GenerateTranslateParams,
   };
@@ -1145,6 +1213,26 @@ export declare namespace Scenario {
 
   export { Pricing as Pricing };
 
+  export {
+    Projects as Projects,
+    type ProjectCreateResponse as ProjectCreateResponse,
+    type ProjectRetrieveResponse as ProjectRetrieveResponse,
+    type ProjectUpdateResponse as ProjectUpdateResponse,
+    type ProjectListResponse as ProjectListResponse,
+    type ProjectDeleteResponse as ProjectDeleteResponse,
+    type ProjectListResponsesProjectsCursor as ProjectListResponsesProjectsCursor,
+    type ProjectCreateParams as ProjectCreateParams,
+    type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
+  };
+
+  export {
+    Recommendations as Recommendations,
+    type RecommendationListModelsResponse as RecommendationListModelsResponse,
+    type RecommendationListModelsResponsesRecommendationsCursor as RecommendationListModelsResponsesRecommendationsCursor,
+    type RecommendationListModelsParams as RecommendationListModelsParams,
+  };
+
   export {
     Search as Search,
     type SearchAssetSearchResponse as SearchAssetSearchResponse,
@@ -1165,6 +1253,17 @@ export declare namespace Scenario {
     type TagListParams as TagListParams,
   };
 
+  export {
+    Teams as Teams,
+    type TeamRetrieveResponse as TeamRetrieveResponse,
+    type TeamUpdateResponse as TeamUpdateResponse,
+    type TeamListResponse as TeamListResponse,
+    type TeamDeleteInvitationsResponse as TeamDeleteInvitationsResponse,
+    type TeamRetrieveLimitsResponse as TeamRetrieveLimitsResponse,
+    type TeamUpdateParams as TeamUpdateParams,
+    type TeamDeleteInvitationsParams as TeamDeleteInvitationsParams,
+  };
+
   export {
     UploadsAPIUploads as Uploads,
     type UploadCreateResponse as UploadCreateResponse,
@@ -1191,6 +1290,7 @@ export declare namespace Scenario {
     type WorkflowGetTagsResponse as WorkflowGetTagsResponse,
     type WorkflowRunResponse as WorkflowRunResponse,
     type WorkflowUserApprovalResponse as WorkflowUserApprovalResponse,
+    type WorkflowUserSelectionResponse as WorkflowUserSelectionResponse,
     type WorkflowListResponsesWorkflowsCursor as WorkflowListResponsesWorkflowsCursor,
     type WorkflowCreateParams as WorkflowCreateParams,
     type WorkflowRetrieveParams as WorkflowRetrieveParams,
@@ -1200,6 +1300,7 @@ export declare namespace Scenario {
     type WorkflowGetTagsParams as WorkflowGetTagsParams,
     type WorkflowRunParams as WorkflowRunParams,
     type WorkflowUserApprovalParams as WorkflowUserApprovalParams,
+    type WorkflowUserSelectionParams as WorkflowUserSelectionParams,
     type WorkflowApproveUserParams as WorkflowApproveUserParams,
   };
 }

package/src/core/pagination.ts

@@ -436,6 +436,150 @@ export class WorkflowsCursor<Item> extends AbstractPage<Item> implements Workflo
   }
 }
 
+export interface ThreadsCursorResponse<Item> {
+  nextPaginationToken: string;
+
+  threads: Array<Item>;
+}
+
+export interface ThreadsCursorParams {
+  paginationToken?: string;
+}
+
+export class ThreadsCursor<Item> extends AbstractPage<Item> implements ThreadsCursorResponse<Item> {
+  nextPaginationToken: string;
+
+  threads: Array<Item>;
+
+  constructor(
+    client: Scenario,
+    response: Response,
+    body: ThreadsCursorResponse<Item>,
+    options: FinalRequestOptions,
+  ) {
+    super(client, response, body, options);
+
+    this.nextPaginationToken = body.nextPaginationToken || '';
+    this.threads = body.threads || [];
+  }
+
+  getPaginatedItems(): Item[] {
+    return this.threads ?? [];
+  }
+
+  nextPageRequestOptions(): PageRequestOptions | null {
+    const cursor = this.nextPaginationToken;
+    if (!cursor) {
+      return null;
+    }
+
+    return {
+      ...this.options,
+      query: {
+        ...maybeObj(this.options.query),
+        paginationToken: cursor,
+      },
+    };
+  }
+}
+
+export interface ProjectsCursorResponse<Item> {
+  nextPaginationToken: string;
+
+  projects: Array<Item>;
+}
+
+export interface ProjectsCursorParams {
+  paginationToken?: string;
+}
+
+export class ProjectsCursor<Item> extends AbstractPage<Item> implements ProjectsCursorResponse<Item> {
+  nextPaginationToken: string;
+
+  projects: Array<Item>;
+
+  constructor(
+    client: Scenario,
+    response: Response,
+    body: ProjectsCursorResponse<Item>,
+    options: FinalRequestOptions,
+  ) {
+    super(client, response, body, options);
+
+    this.nextPaginationToken = body.nextPaginationToken || '';
+    this.projects = body.projects || [];
+  }
+
+  getPaginatedItems(): Item[] {
+    return this.projects ?? [];
+  }
+
+  nextPageRequestOptions(): PageRequestOptions | null {
+    const cursor = this.nextPaginationToken;
+    if (!cursor) {
+      return null;
+    }
+
+    return {
+      ...this.options,
+      query: {
+        ...maybeObj(this.options.query),
+        paginationToken: cursor,
+      },
+    };
+  }
+}
+
+export interface RecommendationsCursorResponse<Item> {
+  models: Array<Item>;
+
+  nextToken: string;
+}
+
+export interface RecommendationsCursorParams {
+  nextToken?: string;
+}
+
+export class RecommendationsCursor<Item>
+  extends AbstractPage<Item>
+  implements RecommendationsCursorResponse<Item>
+{
+  models: Array<Item>;
+
+  nextToken: string;
+
+  constructor(
+    client: Scenario,
+    response: Response,
+    body: RecommendationsCursorResponse<Item>,
+    options: FinalRequestOptions,
+  ) {
+    super(client, response, body, options);
+
+    this.models = body.models || [];
+    this.nextToken = body.nextToken || '';
+  }
+
+  getPaginatedItems(): Item[] {
+    return this.models ?? [];
+  }
+
+  nextPageRequestOptions(): PageRequestOptions | null {
+    const cursor = this.nextToken;
+    if (!cursor) {
+      return null;
+    }
+
+    return {
+      ...this.options,
+      query: {
+        ...maybeObj(this.options.query),
+        nextToken: cursor,
+      },
+    };
+  }
+}
+
 export interface SearchHitsOffsetResponse<Item> {
   estimatedTotalHits: number;
 

package/src/internal/utils/values.ts

@@ -21,6 +21,16 @@ export function maybeObj(x: unknown): object {
   return x ?? {};
 }
 
+/**
+ * Returns a copy of the object's own enumerable entries, without the ones whose value is
+ * `undefined`. Used to merge `options.query` over the typed query params: like
+ * `options.headers`, an `undefined` value means "leave it", not "erase it".
+ */
+export function omitUndefined(obj: object | null | undefined): Record<string, unknown> {
+  if (!obj) return {};
+  return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+}
+
 // https://stackoverflow.com/a/34491287
 export function isEmptyObj(obj: Object | null | undefined): boolean {
   if (!obj) return true;

package/src/lib/asset.ts

@@ -12,7 +12,7 @@ import {
 export class AssetMethods {
   /**
    * Fetch the asset's content as bytes, using the signed `url` field on the
-   * asset. Works in Node ≥18 and in browsers with no extra setup.
+   * asset. Works in Node.js and in browsers with no extra setup.
    *
    * This is a thin wrapper around `fetch(asset.url)` — use `asset.url`
    * directly if you need streaming or a Response object.

package/src/lib/generate.ts

@@ -29,35 +29,35 @@ export class EnhancedGenerate extends Generate {
     params: GenerateCaptionParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateCaptionResponse>> {
-    return enhanceJob(this._client, super.caption(params, options), options);
+    return enhanceJob(this._client, super.caption(params, options));
   }
 
   override describeStyle(
     params: GenerateDescribeStyleParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateDescribeStyleResponse>> {
-    return enhanceJob(this._client, super.describeStyle(params, options), options);
+    return enhanceJob(this._client, super.describeStyle(params, options));
   }
 
   override detect(
     params: GenerateDetectParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateDetectResponse>> {
-    return enhanceJob(this._client, super.detect(params, options), options);
+    return enhanceJob(this._client, super.detect(params, options));
   }
 
   override embed(
     params: GenerateEmbedParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateEmbedResponse>> {
-    return enhanceJob(this._client, super.embed(params, options), options);
+    return enhanceJob(this._client, super.embed(params, options));
   }
 
   override patch(
     params: GeneratePatchParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GeneratePatchResponse>> {
-    return enhanceJob(this._client, super.patch(params, options), options);
+    return enhanceJob(this._client, super.patch(params, options));
   }
 
   override runModel(
@@ -65,13 +65,13 @@ export class EnhancedGenerate extends Generate {
     params: GenerateRunModelParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateRunModelResponse>> {
-    return enhanceJob(this._client, super.runModel(modelID, params, options), options);
+    return enhanceJob(this._client, super.runModel(modelID, params, options));
   }
 
   override translate(
     params: GenerateTranslateParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateTranslateResponse>> {
-    return enhanceJob(this._client, super.translate(params, options), options);
+    return enhanceJob(this._client, super.translate(params, options));
   }
 }

package/src/lib/job.ts

@@ -8,7 +8,7 @@ import {
   type JobTriggerActionParams,
   type JobTriggerActionResponse,
 } from '../resources/jobs';
-import { type Scope, clientProjectId, effectiveScope, withScope } from './scope';
+import { type Scope, clientProjectId, sentScope, withScope } from './scope';
 
 export interface WaitOptions {
   /** Polling interval in milliseconds. Default: 3000 */
@@ -91,12 +91,14 @@ export type WithJob<T extends { job: unknown }> = T & { job: JobMethods };
 export function enhanceJob<T extends { job: { jobId: string; status: string } }>(
   client: Scenario,
   promise: APIPromise<T>,
-  options?: RequestOptions,
 ): APIPromise<WithJob<T>> {
-  const scope = effectiveScope(options, clientProjectId(client));
-  return promise._thenUnwrap((data) => ({
+  return promise._thenUnwrap((data, props) => ({
     ...data,
-    job: Job.from(client, data.job as JobRetrieveResponse['job'], scope),
+    job: Job.from(
+      client,
+      data.job as JobRetrieveResponse['job'],
+      sentScope(props.options, clientProjectId(client)),
+    ),
   }));
 }
 
@@ -113,7 +115,7 @@ export class EnhancedJobs extends Jobs {
     query: JobRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<WithJob<JobRetrieveResponse>> {
-    return enhanceJob(this._client, super.retrieve(jobID, query, options), options);
+    return enhanceJob(this._client, super.retrieve(jobID, query, options));
   }
 
   override triggerAction(
@@ -121,7 +123,7 @@ export class EnhancedJobs extends Jobs {
     params: JobTriggerActionParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<JobTriggerActionResponse>> {
-    return enhanceJob(this._client, super.triggerAction(jobID, params, options), options);
+    return enhanceJob(this._client, super.triggerAction(jobID, params, options));
   }
 }
 

package/src/lib/models.ts

@@ -4,7 +4,7 @@ import type { GenerateRunModelParams, GenerateRunModelResponse } from '../resour
 import { Models, type ModelRetrieveParams, type ModelRetrieveResponse } from '../resources/models/models';
 import { Train, type TrainTriggerParams, type TrainTriggerResponse } from '../resources/models/train';
 import { type WithJob, enhanceJob } from './job';
-import { type Scope, effectiveScope, withScope } from './scope';
+import { type Scope, hasExplicitProjectId, sentScope, withScope } from './scope';
 // Type-only import to break the circular `scenario.ts` ↔ `models.ts` graph at runtime.
 import type { Scenario } from './scenario';
 
@@ -38,7 +38,10 @@ export class ModelEntity {
     params: GenerateRunModelParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<GenerateRunModelResponse>> {
-    return this._client.generate.runModel(this.id, params, withScope(this._scope, options));
+    // The captured scope is only a fallback: an explicit `params.projectId` or
+    // `options.query.projectId` on this call wins.
+    const scope = hasExplicitProjectId(options, params) ? undefined : this._scope;
+    return this._client.generate.runModel(this.id, params, withScope(scope, options));
   }
 
   /** @internal Create a ModelEntity wrapping raw model data, optionally remembering the originating scope. */
@@ -69,7 +72,7 @@ export class EnhancedTrain extends Train {
     params: TrainTriggerParams,
     options?: RequestOptions,
   ): APIPromise<WithJob<TrainTriggerResponse>> {
-    return enhanceJob(this._client, super.trigger(modelID, params, options), options);
+    return enhanceJob(this._client, super.trigger(modelID, params, options));
   }
 }
 
@@ -88,10 +91,9 @@ export class EnhancedModels extends Models {
     options?: RequestOptions,
   ): APIPromise<EnhancedModelRetrieveResponse> {
     const client = this._client as Scenario;
-    const scope = effectiveScope(options, client.projectId);
-    return super.retrieve(modelID, query, options)._thenUnwrap((data) => ({
+    return super.retrieve(modelID, query, options)._thenUnwrap((data, props) => ({
       ...data,
-      model: ModelEntity.from(client, data.model, scope),
+      model: ModelEntity.from(client, data.model, sentScope(props.options, client.projectId)),
     }));
   }
 }