@scenario-labs/sdk 2.2.1 → 2.4.0-alpha.1

package/lib/models.d.ts

@@ -4,6 +4,7 @@ import type { GenerateRunModelParams, GenerateRunModelResponse } from "../resour
 import { Models, type ModelRetrieveParams, type ModelRetrieveResponse } from "../resources/models/models.js";
 import { Train, type TrainTriggerParams, type TrainTriggerResponse } from "../resources/models/train.js";
 import { type WithJob } from "./job.js";
+import { type Scope } from "./scope.js";
 import type { Scenario } from "./scenario.js";
 /**
  * Enhanced Model entity with helper methods.
@@ -18,15 +19,20 @@ import type { Scenario } from "./scenario.js";
  */
 export declare class ModelEntity {
     /** @internal */ readonly _client: Scenario;
+    /** @internal scope captured from the retrieve call — replayed when `.run()` is invoked without an explicit query override. */
+    readonly _scope?: Scope;
     /**
      * Generate with this model. Shortcut for
      * `client.generate.runModel(this.id, params)`.
      *
      * Returns an enhanced response where `response.job` has `.wait()`.
+     * If the model was fetched with a `projectId` scope (per-call override or
+     * client default), that scope is reused unless overridden by
+     * `options.query`.
      */
     run(this: ModelEntity & ModelRetrieveResponse.Model, params: GenerateRunModelParams, options?: RequestOptions): APIPromise<WithJob<GenerateRunModelResponse>>;
-    /** @internal Create a ModelEntity wrapping raw model data. */
-    static from(client: Scenario, data: ModelRetrieveResponse.Model): ModelRetrieveResponse.Model & ModelEntity;
+    /** @internal Create a ModelEntity wrapping raw model data, optionally remembering the originating scope. */
+    static from(client: Scenario, data: ModelRetrieveResponse.Model, scope?: Scope): ModelRetrieveResponse.Model & ModelEntity;
 }
 /** Enhanced retrieve response where `model` has `.run()` on top of its original fields. */
 export type EnhancedModelRetrieveResponse = Omit<ModelRetrieveResponse, 'model'> & {

package/lib/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,+BAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,iCAA8B;AAC9F,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,sCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,qCAAkC;AACtG,OAAO,EAAE,KAAK,OAAO,EAAc,iBAAc;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAmB;AAE3C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IAEpD;;;;;OAKG;IACH,GAAG,CACD,IAAI,EAAE,WAAW,GAAG,qBAAqB,CAAC,KAAK,EAC/C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAIhD,8DAA8D;IAC9D,MAAM,CAAC,IAAI,CACT,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,qBAAqB,CAAC,KAAK,GAChC,qBAAqB,CAAC,KAAK,GAAG,WAAW;CAK7C;AAED,2FAA2F;AAC3F,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAAG;IACjF,KAAK,EAAE,qBAAqB,CAAC,KAAK,GAAG,WAAW,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAC7B,OAAO,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAG7C;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,MAAM;IAC/B,KAAK,EAAE,aAAa,CAAmC;IAEvD,QAAQ,CACf,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,6BAA6B,CAAC;CAM7C"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,+BAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,iCAA8B;AAC9F,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,sCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,qCAAkC;AACtG,OAAO,EAAE,KAAK,OAAO,EAAc,iBAAc;AACjD,OAAO,EAAE,KAAK,KAAK,EAA6B,mBAAgB;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAmB;AAE3C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IACpD,8HAA8H;IAC9H,SAAiB,MAAM,CAAC,EAAE,KAAK,CAAC;IAEhC;;;;;;;;OAQG;IACH,GAAG,CACD,IAAI,EAAE,WAAW,GAAG,qBAAqB,CAAC,KAAK,EAC/C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAIhD,4GAA4G;IAC5G,MAAM,CAAC,IAAI,CACT,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,qBAAqB,CAAC,KAAK,EACjC,KAAK,CAAC,EAAE,KAAK,GACZ,qBAAqB,CAAC,KAAK,GAAG,WAAW;CAM7C;AAED,2FAA2F;AAC3F,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAAG;IACjF,KAAK,EAAE,qBAAqB,CAAC,KAAK,GAAG,WAAW,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAC7B,OAAO,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAG7C;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,MAAM;IAC/B,KAAK,EAAE,aAAa,CAAmC;IAEvD,QAAQ,CACf,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,6BAA6B,CAAC;CAQ7C"}

package/lib/models.js

@@ -4,6 +4,7 @@ exports.EnhancedModels = exports.EnhancedTrain = exports.ModelEntity = void 0;
 const models_1 = require("../resources/models/models.js");
 const train_1 = require("../resources/models/train.js");
 const job_1 = require("./job.js");
+const scope_1 = require("./scope.js");
 /**
  * Enhanced Model entity with helper methods.
  * Has all original model fields plus `.run()`.
@@ -21,14 +22,19 @@ class ModelEntity {
      * `client.generate.runModel(this.id, params)`.
      *
      * Returns an enhanced response where `response.job` has `.wait()`.
+     * If the model was fetched with a `projectId` scope (per-call override or
+     * client default), that scope is reused unless overridden by
+     * `options.query`.
      */
     run(params, options) {
-        return this._client.generate.runModel(this.id, params, options);
+        return this._client.generate.runModel(this.id, params, (0, scope_1.withScope)(this._scope, options));
     }
-    /** @internal Create a ModelEntity wrapping raw model data. */
-    static from(client, data) {
+    /** @internal Create a ModelEntity wrapping raw model data, optionally remembering the originating scope. */
+    static from(client, data, scope) {
         const entity = Object.assign(Object.create(ModelEntity.prototype), data);
         Object.defineProperty(entity, '_client', { value: client, enumerable: false });
+        if (scope)
+            Object.defineProperty(entity, '_scope', { value: scope, enumerable: false });
         return entity;
     }
 }
@@ -39,7 +45,7 @@ exports.ModelEntity = ModelEntity;
  */
 class EnhancedTrain extends train_1.Train {
     trigger(modelID, params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.trigger(modelID, params, options));
+        return (0, job_1.enhanceJob)(this._client, super.trigger(modelID, params, options), options);
     }
 }
 exports.EnhancedTrain = EnhancedTrain;
@@ -52,9 +58,11 @@ exports.EnhancedTrain = EnhancedTrain;
 class EnhancedModels extends models_1.Models {
     train = new EnhancedTrain(this._client);
     retrieve(modelID, query = {}, options) {
+        const client = this._client;
+        const scope = (0, scope_1.effectiveScope)(options, client.projectId);
         return super.retrieve(modelID, query, options)._thenUnwrap((data) => ({
             ...data,
-            model: ModelEntity.from(this._client, data.model),
+            model: ModelEntity.from(client, data.model, scope),
         }));
     }
 }

package/lib/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":";;;AAGA,0DAA0G;AAC1G,wDAAsG;AACtG,kCAAiD;AAIjD;;;;;;;;;;GAUG;AACH,MAAa,WAAW;IAGtB;;;;;OAKG;IACH,GAAG,CAED,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,IAAI,CACT,MAAgB,EAChB,IAAiC;QAEjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA1BD,kCA0BC;AAOD;;;GAGG;AACH,MAAa,aAAc,SAAQ,aAAK;IAC7B,OAAO,CACd,OAAe,EACf,MAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF;AARD,sCAQC;AAED;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,eAAM;IAC/B,KAAK,GAAkB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,QAAQ,CACf,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAmB,EAAE,IAAI,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAbD,wCAaC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":";;;AAGA,0DAA0G;AAC1G,wDAAsG;AACtG,kCAAiD;AACjD,sCAAgE;AAIhE;;;;;;;;;;GAUG;AACH,MAAa,WAAW;IAKtB;;;;;;;;OAQG;IACH,GAAG,CAED,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAA,iBAAS,EAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,4GAA4G;IAC5G,MAAM,CAAC,IAAI,CACT,MAAgB,EAChB,IAAiC,EACjC,KAAa;QAEb,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,KAAK;YAAE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAjCD,kCAiCC;AAOD;;;GAGG;AACH,MAAa,aAAc,SAAQ,aAAK;IAC7B,OAAO,CACd,OAAe,EACf,MAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;CACF;AARD,sCAQC;AAED;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,eAAM;IAC/B,KAAK,GAAkB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,QAAQ,CACf,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAmB,CAAC;QACxC,MAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;SACnD,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAfD,wCAeC"}

package/lib/models.mjs

@@ -1,6 +1,7 @@
 import { Models } from "../resources/models/models.mjs";
 import { Train } from "../resources/models/train.mjs";
 import { enhanceJob } from "./job.mjs";
+import { effectiveScope, withScope } from "./scope.mjs";
 /**
  * Enhanced Model entity with helper methods.
  * Has all original model fields plus `.run()`.
@@ -18,14 +19,19 @@ export class ModelEntity {
      * `client.generate.runModel(this.id, params)`.
      *
      * Returns an enhanced response where `response.job` has `.wait()`.
+     * If the model was fetched with a `projectId` scope (per-call override or
+     * client default), that scope is reused unless overridden by
+     * `options.query`.
      */
     run(params, options) {
-        return this._client.generate.runModel(this.id, params, options);
+        return this._client.generate.runModel(this.id, params, withScope(this._scope, options));
     }
-    /** @internal Create a ModelEntity wrapping raw model data. */
-    static from(client, data) {
+    /** @internal Create a ModelEntity wrapping raw model data, optionally remembering the originating scope. */
+    static from(client, data, scope) {
         const entity = Object.assign(Object.create(ModelEntity.prototype), data);
         Object.defineProperty(entity, '_client', { value: client, enumerable: false });
+        if (scope)
+            Object.defineProperty(entity, '_scope', { value: scope, enumerable: false });
         return entity;
     }
 }
@@ -35,7 +41,7 @@ export class ModelEntity {
  */
 export class EnhancedTrain extends Train {
     trigger(modelID, params, options) {
-        return enhanceJob(this._client, super.trigger(modelID, params, options));
+        return enhanceJob(this._client, super.trigger(modelID, params, options), options);
     }
 }
 /**
@@ -47,9 +53,11 @@ export class EnhancedTrain extends Train {
 export class EnhancedModels extends Models {
     train = new EnhancedTrain(this._client);
     retrieve(modelID, query = {}, options) {
+        const client = this._client;
+        const scope = effectiveScope(options, client.projectId);
         return super.retrieve(modelID, query, options)._thenUnwrap((data) => ({
             ...data,
-            model: ModelEntity.from(this._client, data.model),
+            model: ModelEntity.from(client, data.model, scope),
         }));
     }
 }

package/lib/models.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAwD,uCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAsD,sCAAkC;AACtG,OAAO,EAAgB,UAAU,EAAE,kBAAc;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IAGtB;;;;;OAKG;IACH,GAAG,CAED,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,IAAI,CACT,MAAgB,EAChB,IAAiC;QAEjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,OAAO,CACd,OAAe,EACf,MAA0B,EAC1B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,MAAM;IAC/B,KAAK,GAAkB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,QAAQ,CACf,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAmB,EAAE,IAAI,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}
+{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAwD,uCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAsD,sCAAkC;AACtG,OAAO,EAAgB,UAAU,EAAE,kBAAc;AACjD,OAAO,EAAc,cAAc,EAAE,SAAS,EAAE,oBAAgB;AAIhE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IAKtB;;;;;;;;OAQG;IACH,GAAG,CAED,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,4GAA4G;IAC5G,MAAM,CAAC,IAAI,CACT,MAAgB,EAChB,IAAiC,EACjC,KAAa;QAEb,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,KAAK;YAAE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,OAAO,CACd,OAAe,EACf,MAA0B,EAC1B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,MAAM;IAC/B,KAAK,GAAkB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,QAAQ,CACf,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAmB,CAAC;QACxC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;SACnD,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/lib/scenario.d.mts

@@ -1,10 +1,26 @@
-import { Scenario as BaseScenario } from "../client.mjs";
+import { Scenario as BaseScenario, type ClientOptions as BaseClientOptions } from "../client.mjs";
 import { EnhancedAssets } from "./asset.mjs";
 import { EnhancedGenerate } from "./generate.mjs";
 import { EnhancedJobs } from "./job.mjs";
 import { EnhancedModels } from "./models.mjs";
 import { EnhancedUploads } from "./upload.mjs";
 import { EnhancedWorkflows } from "./workflow.mjs";
+export interface ClientOptions extends BaseClientOptions {
+    /**
+     * Default project to scope every request to (sent as `?projectId=...`).
+     *
+     * Useful with `bearerAuth` when the user belongs to multiple projects —
+     * the server derives the team from the project, so `teamId` doesn't need
+     * to be configured at construction time. With `apiKey` auth, the project
+     * is already implied by the key and this option is unnecessary.
+     *
+     * Per-call `options.query.projectId` overrides this default for a single
+     * request. SDK helpers (`.wait()`, `model.run()`, ...) reuse the scope
+     * effective on the originating call, so an action created in project A
+     * keeps polling in project A even if the client default changes later.
+     */
+    projectId?: string | null | undefined;
+}
 /**
  * Enhanced Scenario client.
  *
@@ -16,23 +32,19 @@ import { EnhancedWorkflows } from "./workflow.mjs";
  * ```ts
  * import Scenario from '@scenario-labs/sdk';
  *
- * const client = new Scenario({ apiKey: '...' });
+ * // With API key — project is implied by the key.
+ * const client = new Scenario({ apiKey: '...', apiSecret: '...' });
+ *
+ * // With bearer JWT — pin a default project for all requests.
+ * const client = new Scenario({ bearerAuth: jwt, projectId: 'proj_abc' });
  *
- * // All generated methods work as-is
- * const list = await client.assets.list({});
+ * // Per-call override (one request only):
+ * await client.uploads.uploadFile(params, { query: { projectId: 'proj_other' } });
  *
- * // Enhanced: response.job.wait()
+ * // Enhanced: response.job.wait() — auto-reuses the scope of the call that produced the job
  * const run = await client.workflows.run(workflowId, { body });
  * const completed = await run.job.wait();
  *
- * // Enhanced: response.workflow.findNode()
- * const wf = await client.workflows.retrieve(workflowId);
- * wf.workflow.findNode('final_image');
- *
- * // Enhanced: generate job.wait()
- * const gen = await client.generate.runModel(modelId, { body });
- * const done = await gen.job.wait();
- *
  * // Enhanced: upload.wait()
  * const res = await client.uploads.retrieve(uploadId);
  * const imported = await res.upload.wait();
@@ -49,5 +61,8 @@ export declare class Scenario extends BaseScenario {
     uploads: EnhancedUploads;
     assets: EnhancedAssets;
     jobs: EnhancedJobs;
+    /** The default project this client scopes every request to, or `null` if unset. */
+    readonly projectId: string | null;
+    constructor(options?: ClientOptions);
 }
 //# sourceMappingURL=scenario.d.mts.map

package/lib/scenario.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.mts","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,sBAAkB;AACrD,OAAO,EAAE,cAAc,EAAE,oBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,uBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,kBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,qBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,uBAAmB;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAC/B,SAAS,EAAE,iBAAiB,CAA+B;IAC3D,QAAQ,EAAE,gBAAgB,CAA8B;IACxD,MAAM,EAAE,cAAc,CAA4B;IAClD,OAAO,EAAE,eAAe,CAA6B;IACrD,MAAM,EAAE,cAAc,CAA4B;IAClD,IAAI,EAAE,YAAY,CAA0B;CACtD"}
+{"version":3,"file":"scenario.d.mts","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,KAAK,aAAa,IAAI,iBAAiB,EAAE,sBAAkB;AAC9F,OAAO,EAAE,cAAc,EAAE,oBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,uBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,kBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,qBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,uBAAmB;AAE/C,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAC/B,SAAS,EAAE,iBAAiB,CAA+B;IAC3D,QAAQ,EAAE,gBAAgB,CAA8B;IACxD,MAAM,EAAE,cAAc,CAA4B;IAClD,OAAO,EAAE,eAAe,CAA6B;IACrD,MAAM,EAAE,cAAc,CAA4B;IAClD,IAAI,EAAE,YAAY,CAA0B;IAErD,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtB,OAAO,GAAE,aAAkB;CAexC"}

package/lib/scenario.d.ts

@@ -1,10 +1,26 @@
-import { Scenario as BaseScenario } from "../client.js";
+import { Scenario as BaseScenario, type ClientOptions as BaseClientOptions } from "../client.js";
 import { EnhancedAssets } from "./asset.js";
 import { EnhancedGenerate } from "./generate.js";
 import { EnhancedJobs } from "./job.js";
 import { EnhancedModels } from "./models.js";
 import { EnhancedUploads } from "./upload.js";
 import { EnhancedWorkflows } from "./workflow.js";
+export interface ClientOptions extends BaseClientOptions {
+    /**
+     * Default project to scope every request to (sent as `?projectId=...`).
+     *
+     * Useful with `bearerAuth` when the user belongs to multiple projects —
+     * the server derives the team from the project, so `teamId` doesn't need
+     * to be configured at construction time. With `apiKey` auth, the project
+     * is already implied by the key and this option is unnecessary.
+     *
+     * Per-call `options.query.projectId` overrides this default for a single
+     * request. SDK helpers (`.wait()`, `model.run()`, ...) reuse the scope
+     * effective on the originating call, so an action created in project A
+     * keeps polling in project A even if the client default changes later.
+     */
+    projectId?: string | null | undefined;
+}
 /**
  * Enhanced Scenario client.
  *
@@ -16,23 +32,19 @@ import { EnhancedWorkflows } from "./workflow.js";
  * ```ts
  * import Scenario from '@scenario-labs/sdk';
  *
- * const client = new Scenario({ apiKey: '...' });
+ * // With API key — project is implied by the key.
+ * const client = new Scenario({ apiKey: '...', apiSecret: '...' });
+ *
+ * // With bearer JWT — pin a default project for all requests.
+ * const client = new Scenario({ bearerAuth: jwt, projectId: 'proj_abc' });
  *
- * // All generated methods work as-is
- * const list = await client.assets.list({});
+ * // Per-call override (one request only):
+ * await client.uploads.uploadFile(params, { query: { projectId: 'proj_other' } });
  *
- * // Enhanced: response.job.wait()
+ * // Enhanced: response.job.wait() — auto-reuses the scope of the call that produced the job
  * const run = await client.workflows.run(workflowId, { body });
  * const completed = await run.job.wait();
  *
- * // Enhanced: response.workflow.findNode()
- * const wf = await client.workflows.retrieve(workflowId);
- * wf.workflow.findNode('final_image');
- *
- * // Enhanced: generate job.wait()
- * const gen = await client.generate.runModel(modelId, { body });
- * const done = await gen.job.wait();
- *
  * // Enhanced: upload.wait()
  * const res = await client.uploads.retrieve(uploadId);
  * const imported = await res.upload.wait();
@@ -49,5 +61,8 @@ export declare class Scenario extends BaseScenario {
     uploads: EnhancedUploads;
     assets: EnhancedAssets;
     jobs: EnhancedJobs;
+    /** The default project this client scopes every request to, or `null` if unset. */
+    readonly projectId: string | null;
+    constructor(options?: ClientOptions);
 }
 //# sourceMappingURL=scenario.d.ts.map

package/lib/scenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,qBAAkB;AACrD,OAAO,EAAE,cAAc,EAAE,mBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,sBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,oBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,oBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,sBAAmB;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAC/B,SAAS,EAAE,iBAAiB,CAA+B;IAC3D,QAAQ,EAAE,gBAAgB,CAA8B;IACxD,MAAM,EAAE,cAAc,CAA4B;IAClD,OAAO,EAAE,eAAe,CAA6B;IACrD,MAAM,EAAE,cAAc,CAA4B;IAClD,IAAI,EAAE,YAAY,CAA0B;CACtD"}
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,KAAK,aAAa,IAAI,iBAAiB,EAAE,qBAAkB;AAC9F,OAAO,EAAE,cAAc,EAAE,mBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,sBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,oBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,oBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,sBAAmB;AAE/C,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAC/B,SAAS,EAAE,iBAAiB,CAA+B;IAC3D,QAAQ,EAAE,gBAAgB,CAA8B;IACxD,MAAM,EAAE,cAAc,CAA4B;IAClD,OAAO,EAAE,eAAe,CAA6B;IACrD,MAAM,EAAE,cAAc,CAA4B;IAClD,IAAI,EAAE,YAAY,CAA0B;IAErD,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtB,OAAO,GAAE,aAAkB;CAexC"}

package/lib/scenario.js

@@ -19,23 +19,19 @@ const workflow_1 = require("./workflow.js");
  * ```ts
  * import Scenario from '@scenario-labs/sdk';
  *
- * const client = new Scenario({ apiKey: '...' });
+ * // With API key — project is implied by the key.
+ * const client = new Scenario({ apiKey: '...', apiSecret: '...' });
  *
- * // All generated methods work as-is
- * const list = await client.assets.list({});
+ * // With bearer JWT — pin a default project for all requests.
+ * const client = new Scenario({ bearerAuth: jwt, projectId: 'proj_abc' });
  *
- * // Enhanced: response.job.wait()
+ * // Per-call override (one request only):
+ * await client.uploads.uploadFile(params, { query: { projectId: 'proj_other' } });
+ *
+ * // Enhanced: response.job.wait() — auto-reuses the scope of the call that produced the job
  * const run = await client.workflows.run(workflowId, { body });
  * const completed = await run.job.wait();
  *
- * // Enhanced: response.workflow.findNode()
- * const wf = await client.workflows.retrieve(workflowId);
- * wf.workflow.findNode('final_image');
- *
- * // Enhanced: generate job.wait()
- * const gen = await client.generate.runModel(modelId, { body });
- * const done = await gen.job.wait();
- *
  * // Enhanced: upload.wait()
  * const res = await client.uploads.retrieve(uploadId);
  * const imported = await res.upload.wait();
@@ -52,6 +48,29 @@ class Scenario extends client_1.Scenario {
     uploads = new upload_1.EnhancedUploads(this);
     assets = new asset_1.EnhancedAssets(this);
     jobs = new job_1.EnhancedJobs(this);
+    /** The default project this client scopes every request to, or `null` if unset. */
+    projectId;
+    constructor(options = {}) {
+        const { projectId, defaultQuery, ...rest } = options;
+        // Strip any stale projectId from defaultQuery so the typed field is the
+        // single source of truth (matters when `withOptions` reconstructs the client).
+        const cleanedDefaultQuery = stripKey(defaultQuery, 'projectId');
+        super({
+            ...rest,
+            // Pass projectId through so it lands in `_options` and survives a
+            // `withOptions()` round-trip. The base ClientOptions doesn't declare
+            // this field, hence the cast.
+            projectId,
+            defaultQuery: projectId ? { ...cleanedDefaultQuery, projectId } : cleanedDefaultQuery,
+        });
+        this.projectId = projectId ?? null;
+    }
 }
 exports.Scenario = Scenario;
+function stripKey(obj, key) {
+    if (!obj || !(key in obj))
+        return obj;
+    const { [key]: _omit, ...rest } = obj;
+    return rest;
+}
 //# sourceMappingURL=scenario.js.map

package/lib/scenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":";;;AAAA,yCAAqD;AACrD,sCAAyC;AACzC,4CAA8C;AAC9C,kCAAqC;AACrC,wCAA0C;AAC1C,wCAA2C;AAC3C,4CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAa,QAAS,SAAQ,iBAAY;IAC/B,SAAS,GAAsB,IAAI,4BAAiB,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,GAAqB,IAAI,2BAAgB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,GAAmB,IAAI,uBAAc,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,GAAoB,IAAI,wBAAe,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,GAAmB,IAAI,sBAAc,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,GAAiB,IAAI,kBAAY,CAAC,IAAI,CAAC,CAAC;CACtD;AAPD,4BAOC"}
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":";;;AAAA,yCAA8F;AAC9F,sCAAyC;AACzC,4CAA8C;AAC9C,kCAAqC;AACrC,wCAA0C;AAC1C,wCAA2C;AAC3C,4CAA+C;AAmB/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAa,QAAS,SAAQ,iBAAY;IAC/B,SAAS,GAAsB,IAAI,4BAAiB,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,GAAqB,IAAI,2BAAgB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,GAAmB,IAAI,uBAAc,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,GAAoB,IAAI,wBAAe,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,GAAmB,IAAI,sBAAc,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,GAAiB,IAAI,kBAAY,CAAC,IAAI,CAAC,CAAC;IAErD,mFAAmF;IAC1E,SAAS,CAAgB;IAElC,YAAY,UAAyB,EAAE;QACrC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACrD,wEAAwE;QACxE,+EAA+E;QAC/E,MAAM,mBAAmB,GAAG,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAChE,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,kEAAkE;YAClE,qEAAqE;YACrE,8BAA8B;YAC9B,SAAS;YACT,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,mBAAmB;SACjE,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,CAAC;IACrC,CAAC;CACF;AA1BD,4BA0BC;AAED,SAAS,QAAQ,CAAmB,GAAkB,EAAE,GAAW;IACjE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,GAA8B,CAAC;IACjE,OAAO,IAAkB,CAAC;AAC5B,CAAC"}

package/lib/scenario.mjs

@@ -16,23 +16,19 @@ import { EnhancedWorkflows } from "./workflow.mjs";
  * ```ts
  * import Scenario from '@scenario-labs/sdk';
  *
- * const client = new Scenario({ apiKey: '...' });
+ * // With API key — project is implied by the key.
+ * const client = new Scenario({ apiKey: '...', apiSecret: '...' });
  *
- * // All generated methods work as-is
- * const list = await client.assets.list({});
+ * // With bearer JWT — pin a default project for all requests.
+ * const client = new Scenario({ bearerAuth: jwt, projectId: 'proj_abc' });
  *
- * // Enhanced: response.job.wait()
+ * // Per-call override (one request only):
+ * await client.uploads.uploadFile(params, { query: { projectId: 'proj_other' } });
+ *
+ * // Enhanced: response.job.wait() — auto-reuses the scope of the call that produced the job
  * const run = await client.workflows.run(workflowId, { body });
  * const completed = await run.job.wait();
  *
- * // Enhanced: response.workflow.findNode()
- * const wf = await client.workflows.retrieve(workflowId);
- * wf.workflow.findNode('final_image');
- *
- * // Enhanced: generate job.wait()
- * const gen = await client.generate.runModel(modelId, { body });
- * const done = await gen.job.wait();
- *
  * // Enhanced: upload.wait()
  * const res = await client.uploads.retrieve(uploadId);
  * const imported = await res.upload.wait();
@@ -49,5 +45,28 @@ export class Scenario extends BaseScenario {
     uploads = new EnhancedUploads(this);
     assets = new EnhancedAssets(this);
     jobs = new EnhancedJobs(this);
+    /** The default project this client scopes every request to, or `null` if unset. */
+    projectId;
+    constructor(options = {}) {
+        const { projectId, defaultQuery, ...rest } = options;
+        // Strip any stale projectId from defaultQuery so the typed field is the
+        // single source of truth (matters when `withOptions` reconstructs the client).
+        const cleanedDefaultQuery = stripKey(defaultQuery, 'projectId');
+        super({
+            ...rest,
+            // Pass projectId through so it lands in `_options` and survives a
+            // `withOptions()` round-trip. The base ClientOptions doesn't declare
+            // this field, hence the cast.
+            projectId,
+            defaultQuery: projectId ? { ...cleanedDefaultQuery, projectId } : cleanedDefaultQuery,
+        });
+        this.projectId = projectId ?? null;
+    }
+}
+function stripKey(obj, key) {
+    if (!obj || !(key in obj))
+        return obj;
+    const { [key]: _omit, ...rest } = obj;
+    return rest;
 }
 //# sourceMappingURL=scenario.mjs.map

package/lib/scenario.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.mjs","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,sBAAkB;AACrD,OAAO,EAAE,cAAc,EAAE,oBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,uBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,kBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,qBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,uBAAmB;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IAC/B,SAAS,GAAsB,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,GAAqB,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,GAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,GAAoB,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,GAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,GAAiB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CACtD"}
+{"version":3,"file":"scenario.mjs","sourceRoot":"","sources":["../src/lib/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAA2C,sBAAkB;AAC9F,OAAO,EAAE,cAAc,EAAE,oBAAgB;AACzC,OAAO,EAAE,gBAAgB,EAAE,uBAAmB;AAC9C,OAAO,EAAE,YAAY,EAAE,kBAAc;AACrC,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,OAAO,EAAE,eAAe,EAAE,qBAAiB;AAC3C,OAAO,EAAE,iBAAiB,EAAE,uBAAmB;AAmB/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IAC/B,SAAS,GAAsB,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,GAAqB,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,GAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,GAAoB,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,GAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,GAAiB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAErD,mFAAmF;IAC1E,SAAS,CAAgB;IAElC,YAAY,UAAyB,EAAE;QACrC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACrD,wEAAwE;QACxE,+EAA+E;QAC/E,MAAM,mBAAmB,GAAG,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAChE,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,kEAAkE;YAClE,qEAAqE;YACrE,8BAA8B;YAC9B,SAAS;YACT,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,mBAAmB;SACjE,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,CAAC;IACrC,CAAC;CACF;AAED,SAAS,QAAQ,CAAmB,GAAkB,EAAE,GAAW;IACjE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,GAA8B,CAAC;IACjE,OAAO,IAAkB,CAAC;AAC5B,CAAC"}

package/lib/scope.d.mts

@@ -0,0 +1,41 @@
+import type { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Per-request project scope.
+ *
+ * With API-key auth, the server resolves the project from the key. With
+ * bearer (JWT) auth a user can belong to multiple projects, so callers must
+ * specify which one to act on by passing `projectId` as a query param
+ * (the server derives `teamId` from it — no need to send it explicitly).
+ *
+ * SDK helpers like `Job.wait()` and `Upload.wait()` make follow-up calls
+ * internally — they capture the scope effective on the originating call and
+ * forward it on each retry, so an action created in project A always polls
+ * in project A even if the client default changes between calls.
+ */
+export interface Scope {
+    projectId?: string;
+}
+/** Extract `projectId` from a `RequestOptions.query`. Returns `undefined` if absent. */
+export declare function extractScope(options?: RequestOptions): Scope | undefined;
+/**
+ * Resolve the effective scope for an outgoing call:
+ *   1. If the per-call options carry a `projectId` query — use that (the explicit override wins).
+ *   2. Otherwise, fall back to the client's default `projectId`.
+ *   3. If neither is set (e.g. API-key auth with implicit scope), return `undefined`.
+ *
+ * Returns the snapshot we want to *capture on an enhanced entity* so that
+ * follow-up helper calls (`.wait()`, `entity.run()`, ...) reuse the same
+ * scope and stay in sync with the call that produced them.
+ */
+export declare function effectiveScope(options: RequestOptions | undefined, fallbackProjectId: string | null | undefined): Scope | undefined;
+/**
+ * Read the client's default `projectId` without repeating the structural
+ * cast at every call site. The base generated `Scenario` type doesn't
+ * declare `projectId` — only the enhanced one in `./scenario` does — so
+ * `lib/` modules that import `Scenario` from `'../client'` use this helper
+ * instead of duplicating the same cast inline.
+ */
+export declare function clientProjectId(client: unknown): string | null | undefined;
+/** Build a `RequestOptions` that adds the scope as a query param, merging into any existing query. */
+export declare function withScope(scope: Scope | undefined, options?: RequestOptions): RequestOptions | undefined;
+//# sourceMappingURL=scope.d.mts.map

package/lib/scope.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.mts","sourceRoot":"","sources":["../src/lib/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,KAAK;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,GAAG,SAAS,CAMxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC3C,KAAK,GAAG,SAAS,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1E;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAOxG"}

package/lib/scope.d.ts

@@ -0,0 +1,41 @@
+import type { RequestOptions } from "../internal/request-options.js";
+/**
+ * Per-request project scope.
+ *
+ * With API-key auth, the server resolves the project from the key. With
+ * bearer (JWT) auth a user can belong to multiple projects, so callers must
+ * specify which one to act on by passing `projectId` as a query param
+ * (the server derives `teamId` from it — no need to send it explicitly).
+ *
+ * SDK helpers like `Job.wait()` and `Upload.wait()` make follow-up calls
+ * internally — they capture the scope effective on the originating call and
+ * forward it on each retry, so an action created in project A always polls
+ * in project A even if the client default changes between calls.
+ */
+export interface Scope {
+    projectId?: string;
+}
+/** Extract `projectId` from a `RequestOptions.query`. Returns `undefined` if absent. */
+export declare function extractScope(options?: RequestOptions): Scope | undefined;
+/**
+ * Resolve the effective scope for an outgoing call:
+ *   1. If the per-call options carry a `projectId` query — use that (the explicit override wins).
+ *   2. Otherwise, fall back to the client's default `projectId`.
+ *   3. If neither is set (e.g. API-key auth with implicit scope), return `undefined`.
+ *
+ * Returns the snapshot we want to *capture on an enhanced entity* so that
+ * follow-up helper calls (`.wait()`, `entity.run()`, ...) reuse the same
+ * scope and stay in sync with the call that produced them.
+ */
+export declare function effectiveScope(options: RequestOptions | undefined, fallbackProjectId: string | null | undefined): Scope | undefined;
+/**
+ * Read the client's default `projectId` without repeating the structural
+ * cast at every call site. The base generated `Scenario` type doesn't
+ * declare `projectId` — only the enhanced one in `./scenario` does — so
+ * `lib/` modules that import `Scenario` from `'../client'` use this helper
+ * instead of duplicating the same cast inline.
+ */
+export declare function clientProjectId(client: unknown): string | null | undefined;
+/** Build a `RequestOptions` that adds the scope as a query param, merging into any existing query. */
+export declare function withScope(scope: Scope | undefined, options?: RequestOptions): RequestOptions | undefined;
+//# sourceMappingURL=scope.d.ts.map

package/lib/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/lib/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,KAAK;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK,GAAG,SAAS,CAMxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC3C,KAAK,GAAG,SAAS,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1E;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAOxG"}

package/lib/scope.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractScope = extractScope;
+exports.effectiveScope = effectiveScope;
+exports.clientProjectId = clientProjectId;
+exports.withScope = withScope;
+/** Extract `projectId` from a `RequestOptions.query`. Returns `undefined` if absent. */
+function extractScope(options) {
+    const query = options?.query;
+    if (!query)
+        return undefined;
+    const projectId = typeof query['projectId'] === 'string' ? query['projectId'] : undefined;
+    if (!projectId)
+        return undefined;
+    return { projectId };
+}
+/**
+ * Resolve the effective scope for an outgoing call:
+ *   1. If the per-call options carry a `projectId` query — use that (the explicit override wins).
+ *   2. Otherwise, fall back to the client's default `projectId`.
+ *   3. If neither is set (e.g. API-key auth with implicit scope), return `undefined`.
+ *
+ * Returns the snapshot we want to *capture on an enhanced entity* so that
+ * follow-up helper calls (`.wait()`, `entity.run()`, ...) reuse the same
+ * scope and stay in sync with the call that produced them.
+ */
+function effectiveScope(options, fallbackProjectId) {
+    const override = extractScope(options);
+    if (override)
+        return override;
+    if (fallbackProjectId)
+        return { projectId: fallbackProjectId };
+    return undefined;
+}
+/**
+ * Read the client's default `projectId` without repeating the structural
+ * cast at every call site. The base generated `Scenario` type doesn't
+ * declare `projectId` — only the enhanced one in `./scenario` does — so
+ * `lib/` modules that import `Scenario` from `'../client'` use this helper
+ * instead of duplicating the same cast inline.
+ */
+function clientProjectId(client) {
+    return client.projectId;
+}
+/** Build a `RequestOptions` that adds the scope as a query param, merging into any existing query. */
+function withScope(scope, options) {
+    if (!scope?.projectId)
+        return options;
+    const existingQuery = options?.query ?? {};
+    return {
+        ...options,
+        query: { ...existingQuery, projectId: scope.projectId },
+    };
+}
+//# sourceMappingURL=scope.js.map

package/lib/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/lib/scope.ts"],"names":[],"mappings":";;AAoBA,oCAMC;AAYD,wCAQC;AASD,0CAEC;AAGD,8BAOC;AAhDD,wFAAwF;AACxF,SAAgB,YAAY,CAAC,OAAwB;IACnD,MAAM,KAAK,GAAG,OAAO,EAAE,KAA4C,CAAC;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,OAAmC,EACnC,iBAA4C;IAE5C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,iBAAiB;QAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,MAAe;IAC7C,OAAQ,MAAwC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,sGAAsG;AACtG,SAAgB,SAAS,CAAC,KAAwB,EAAE,OAAwB;IAC1E,IAAI,CAAC,KAAK,EAAE,SAAS;QAAE,OAAO,OAAO,CAAC;IACtC,MAAM,aAAa,GAAI,OAAO,EAAE,KAA6C,IAAI,EAAE,CAAC;IACpF,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,EAAE,GAAG,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;KACxD,CAAC;AACJ,CAAC"}