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

package/lib/auth-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh.d.ts","sourceRoot":"","sources":["../src/lib/auth-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACrC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,KAAK,CA2Cd;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB"}

package/lib/auth-refresh.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withBearerRefresh = withBearerRefresh;
+/**
+ * Wrap `fetch` so that AWS API Gateway authorizer rejections (i.e. expired
+ * bearer JWTs) automatically trigger a refresh + retry.
+ *
+ * Use case: bearer (JWT) auth only. Clerk session tokens default to ~60s
+ * validity, so any single SDK call that outlives that window — typically a
+ * `.wait()` poll on a long job, or a slow `uploadFile()` — risks getting a
+ * 403 mid-flight even though the user is still authenticated. This wrapper
+ * intercepts those 403s, calls a caller-provided refresh callback to mint a
+ * fresh JWT, and retries the same request transparently.
+ *
+ * Not applicable to API-key auth: API keys are long-lived credentials and
+ * don't expire mid-session.
+ *
+ * Detection: AWS API Gateway sets `x-amzn-errortype: AccessDeniedException`
+ * on authorizer rejections. Real downstream permission denials return 403
+ * *without* that header — those are propagated unchanged so we don't refresh
+ * pointlessly on a genuine "you don't have access" response.
+ *
+ * @example
+ * ```ts
+ * import { Scenario, withBearerRefresh } from '@scenario-labs/sdk';
+ *
+ * const client = new Scenario({
+ *   bearerAuth: initialJwt,
+ *   fetch: withBearerRefresh(async () => {
+ *     // app-specific: re-mint a JWT from Clerk, your IdP, etc.
+ *     return await mintFreshJwt();
+ *   }),
+ * });
+ *
+ * // Long-running poll — JWT can expire mid-flight, wrapper handles it:
+ * const job = await client.workflows.run(wfId, { body }).then(r => r.job);
+ * const completed = await job.wait({ timeoutMs: 600_000 });
+ * ```
+ */
+function withBearerRefresh(refresh, options) {
+    const inner = options?.fetch ?? globalThis.fetch;
+    const maxRefreshes = options?.maxRefreshes ?? 2;
+    let refreshCount = 0;
+    // Concurrent requests that all hit a gateway 403 must share a single
+    // refresh — otherwise each call mints its own JWT, wastes the refresh
+    // budget, and risks token-version races. We coalesce them onto one
+    // in-flight promise (single-flight).
+    let inflightRefresh = null;
+    return async (input, init) => {
+        const response = await inner(input, init);
+        const isAuthorizerReject = response.status === 403 && response.headers.get('x-amzn-errortype') === 'AccessDeniedException';
+        if (!isAuthorizerReject)
+            return response;
+        // Budget only blocks NEW refreshes — followers awaiting an in-flight
+        // refresh aren't paying for it, so let them through.
+        if (refreshCount >= maxRefreshes && inflightRefresh === null)
+            return response;
+        if (inflightRefresh === null) {
+            // Leader for this round: charge the budget now (not on result) so
+            // followers awaiting the same promise don't each increment.
+            refreshCount += 1;
+            inflightRefresh = refresh().finally(() => {
+                inflightRefresh = null;
+            });
+        }
+        const freshJwt = await inflightRefresh;
+        if (!freshJwt) {
+            // Refresh failed — propagate the original 403 with its body intact so
+            // the SDK / caller can still read the error message. Draining here
+            // would leave them with an empty/closed stream.
+            return response;
+        }
+        // Refresh succeeded; we're about to retry. Drain the rejected response's
+        // body so we don't leak the underlying socket.
+        response.body?.cancel().catch(() => undefined);
+        const newHeaders = new Headers(init?.headers);
+        newHeaders.set('Authorization', `Bearer ${freshJwt}`);
+        return inner(input, { ...init, headers: newHeaders });
+    };
+}
+//# sourceMappingURL=auth-refresh.js.map

package/lib/auth-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh.js","sourceRoot":"","sources":["../src/lib/auth-refresh.ts"],"names":[],"mappings":";;AAoCA,8CA8CC;AAlFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,SAAgB,iBAAiB,CAC/B,OAAqC,EACrC,OAA8B;IAE9B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC;IAChD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,qCAAqC;IACrC,IAAI,eAAe,GAAkC,IAAI,CAAC;IAE1D,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,kBAAkB,GACtB,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,uBAAuB,CAAC;QAClG,IAAI,CAAC,kBAAkB;YAAE,OAAO,QAAQ,CAAC;QACzC,qEAAqE;QACrE,qDAAqD;QACrD,IAAI,YAAY,IAAI,YAAY,IAAI,eAAe,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QAE9E,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,kEAAkE;YAClE,4DAA4D;YAC5D,YAAY,IAAI,CAAC,CAAC;YAClB,eAAe,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvC,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,sEAAsE;YACtE,mEAAmE;YACnE,gDAAgD;YAChD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yEAAyE;QACzE,+CAA+C;QAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC"}

package/lib/auth-refresh.mjs

@@ -0,0 +1,78 @@
+/**
+ * Wrap `fetch` so that AWS API Gateway authorizer rejections (i.e. expired
+ * bearer JWTs) automatically trigger a refresh + retry.
+ *
+ * Use case: bearer (JWT) auth only. Clerk session tokens default to ~60s
+ * validity, so any single SDK call that outlives that window — typically a
+ * `.wait()` poll on a long job, or a slow `uploadFile()` — risks getting a
+ * 403 mid-flight even though the user is still authenticated. This wrapper
+ * intercepts those 403s, calls a caller-provided refresh callback to mint a
+ * fresh JWT, and retries the same request transparently.
+ *
+ * Not applicable to API-key auth: API keys are long-lived credentials and
+ * don't expire mid-session.
+ *
+ * Detection: AWS API Gateway sets `x-amzn-errortype: AccessDeniedException`
+ * on authorizer rejections. Real downstream permission denials return 403
+ * *without* that header — those are propagated unchanged so we don't refresh
+ * pointlessly on a genuine "you don't have access" response.
+ *
+ * @example
+ * ```ts
+ * import { Scenario, withBearerRefresh } from '@scenario-labs/sdk';
+ *
+ * const client = new Scenario({
+ *   bearerAuth: initialJwt,
+ *   fetch: withBearerRefresh(async () => {
+ *     // app-specific: re-mint a JWT from Clerk, your IdP, etc.
+ *     return await mintFreshJwt();
+ *   }),
+ * });
+ *
+ * // Long-running poll — JWT can expire mid-flight, wrapper handles it:
+ * const job = await client.workflows.run(wfId, { body }).then(r => r.job);
+ * const completed = await job.wait({ timeoutMs: 600_000 });
+ * ```
+ */
+export function withBearerRefresh(refresh, options) {
+    const inner = options?.fetch ?? globalThis.fetch;
+    const maxRefreshes = options?.maxRefreshes ?? 2;
+    let refreshCount = 0;
+    // Concurrent requests that all hit a gateway 403 must share a single
+    // refresh — otherwise each call mints its own JWT, wastes the refresh
+    // budget, and risks token-version races. We coalesce them onto one
+    // in-flight promise (single-flight).
+    let inflightRefresh = null;
+    return async (input, init) => {
+        const response = await inner(input, init);
+        const isAuthorizerReject = response.status === 403 && response.headers.get('x-amzn-errortype') === 'AccessDeniedException';
+        if (!isAuthorizerReject)
+            return response;
+        // Budget only blocks NEW refreshes — followers awaiting an in-flight
+        // refresh aren't paying for it, so let them through.
+        if (refreshCount >= maxRefreshes && inflightRefresh === null)
+            return response;
+        if (inflightRefresh === null) {
+            // Leader for this round: charge the budget now (not on result) so
+            // followers awaiting the same promise don't each increment.
+            refreshCount += 1;
+            inflightRefresh = refresh().finally(() => {
+                inflightRefresh = null;
+            });
+        }
+        const freshJwt = await inflightRefresh;
+        if (!freshJwt) {
+            // Refresh failed — propagate the original 403 with its body intact so
+            // the SDK / caller can still read the error message. Draining here
+            // would leave them with an empty/closed stream.
+            return response;
+        }
+        // Refresh succeeded; we're about to retry. Drain the rejected response's
+        // body so we don't leak the underlying socket.
+        response.body?.cancel().catch(() => undefined);
+        const newHeaders = new Headers(init?.headers);
+        newHeaders.set('Authorization', `Bearer ${freshJwt}`);
+        return inner(input, { ...init, headers: newHeaders });
+    };
+}
+//# sourceMappingURL=auth-refresh.mjs.map

package/lib/auth-refresh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-refresh.mjs","sourceRoot":"","sources":["../src/lib/auth-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAqC,EACrC,OAA8B;IAE9B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC;IAChD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,qCAAqC;IACrC,IAAI,eAAe,GAAkC,IAAI,CAAC;IAE1D,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,kBAAkB,GACtB,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,uBAAuB,CAAC;QAClG,IAAI,CAAC,kBAAkB;YAAE,OAAO,QAAQ,CAAC;QACzC,qEAAqE;QACrE,qDAAqD;QACrD,IAAI,YAAY,IAAI,YAAY,IAAI,eAAe,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QAE9E,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,kEAAkE;YAClE,4DAA4D;YAC5D,YAAY,IAAI,CAAC,CAAC;YAClB,eAAe,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvC,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,sEAAsE;YACtE,mEAAmE;YACnE,gDAAgD;YAChD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yEAAyE;QACzE,+CAA+C;QAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC"}

package/lib/generate.js

@@ -10,25 +10,25 @@ const job_1 = require("./job.js");
  */
 class EnhancedGenerate extends generate_1.Generate {
     caption(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.caption(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.caption(params, options), options);
     }
     describeStyle(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.describeStyle(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.describeStyle(params, options), options);
     }
     detect(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.detect(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.detect(params, options), options);
     }
     embed(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.embed(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.embed(params, options), options);
     }
     patch(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.patch(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.patch(params, options), options);
     }
     runModel(modelID, params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.runModel(modelID, params, options));
+        return (0, job_1.enhanceJob)(this._client, super.runModel(modelID, params, options), options);
     }
     translate(params, options) {
-        return (0, job_1.enhanceJob)(this._client, super.translate(params, options));
+        return (0, job_1.enhanceJob)(this._client, super.translate(params, options), options);
     }
 }
 exports.EnhancedGenerate = EnhancedGenerate;

package/lib/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/lib/generate.ts"],"names":[],"mappings":";;;AAEA,uDAgB+B;AAC/B,kCAAiD;AAEjD;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,mBAAQ;IACnC,OAAO,CACd,MAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAEQ,aAAa,CACpB,MAAmC,EACnC,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAEQ,MAAM,CACb,MAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAEQ,QAAQ,CACf,OAAe,EACf,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEQ,SAAS,CAChB,MAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;CACF;AAlDD,4CAkDC"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/lib/generate.ts"],"names":[],"mappings":";;;AAEA,uDAgB+B;AAC/B,kCAAiD;AAEjD;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,mBAAQ;IACnC,OAAO,CACd,MAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAEQ,aAAa,CACpB,MAAmC,EACnC,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAEQ,MAAM,CACb,MAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEQ,QAAQ,CACf,OAAe,EACf,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAEQ,SAAS,CAChB,MAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF;AAlDD,4CAkDC"}

package/lib/generate.mjs

@@ -7,25 +7,25 @@ import { enhanceJob } from "./job.mjs";
  */
 export class EnhancedGenerate extends Generate {
     caption(params, options) {
-        return enhanceJob(this._client, super.caption(params, options));
+        return enhanceJob(this._client, super.caption(params, options), options);
     }
     describeStyle(params, options) {
-        return enhanceJob(this._client, super.describeStyle(params, options));
+        return enhanceJob(this._client, super.describeStyle(params, options), options);
     }
     detect(params, options) {
-        return enhanceJob(this._client, super.detect(params, options));
+        return enhanceJob(this._client, super.detect(params, options), options);
     }
     embed(params, options) {
-        return enhanceJob(this._client, super.embed(params, options));
+        return enhanceJob(this._client, super.embed(params, options), options);
     }
     patch(params, options) {
-        return enhanceJob(this._client, super.patch(params, options));
+        return enhanceJob(this._client, super.patch(params, options), options);
     }
     runModel(modelID, params, options) {
-        return enhanceJob(this._client, super.runModel(modelID, params, options));
+        return enhanceJob(this._client, super.runModel(modelID, params, options), options);
     }
     translate(params, options) {
-        return enhanceJob(this._client, super.translate(params, options));
+        return enhanceJob(this._client, super.translate(params, options), options);
     }
 }
 //# sourceMappingURL=generate.mjs.map

package/lib/generate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../src/lib/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,GAeT,kCAA8B;AAC/B,OAAO,EAAgB,UAAU,EAAE,kBAAc;AAEjD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACnC,OAAO,CACd,MAA6B,EAC7B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAEQ,aAAa,CACpB,MAAmC,EACnC,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAEQ,MAAM,CACb,MAA4B,EAC5B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAEQ,QAAQ,CACf,OAAe,EACf,MAA8B,EAC9B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEQ,SAAS,CAChB,MAA+B,EAC/B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}
+{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../src/lib/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,GAeT,kCAA8B;AAC/B,OAAO,EAAgB,UAAU,EAAE,kBAAc;AAEjD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IACnC,OAAO,CACd,MAA6B,EAC7B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAEQ,aAAa,CACpB,MAAmC,EACnC,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAEQ,MAAM,CACb,MAA4B,EAC5B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEQ,KAAK,CACZ,MAA2B,EAC3B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEQ,QAAQ,CACf,OAAe,EACf,MAA8B,EAC9B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAEQ,SAAS,CAChB,MAA+B,EAC/B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/lib/job.d.mts

@@ -2,15 +2,24 @@ import type { Scenario } from "../client.mjs";
 import type { APIPromise } from "../core/api-promise.mjs";
 import type { RequestOptions } from "../internal/request-options.mjs";
 import { Jobs, type JobRetrieveResponse, type JobTriggerActionParams, type JobTriggerActionResponse } from "../resources/jobs.mjs";
+import { type Scope } from "./scope.mjs";
 export interface WaitOptions {
     /** Polling interval in milliseconds. Default: 3000 */
     intervalMs?: number;
     /** Maximum wait time in milliseconds. Default: 120000 */
     timeoutMs?: number;
+    /**
+     * Override the project scope used for the polling requests. Defaults to
+     * the scope captured on the job (per-call override on the originating
+     * call, else the client's default project).
+     */
+    projectId?: string;
 }
 /** Job methods added on top of the original job fields. */
 export declare class JobMethods {
     /** @internal */ readonly _client: Scenario;
+    /** @internal scope captured from the originating call — replayed on every `.wait()` poll. */
+    readonly _scope?: Scope;
     /**
      * Poll until the job reaches a terminal status (success, failure, or canceled).
      *
@@ -22,8 +31,8 @@ export declare class JobMethods {
      * ```
      */
     wait(this: Job, options?: WaitOptions): Promise<Job>;
-    /** @internal Create a Job from raw job data. */
-    static from(client: Scenario, data: JobRetrieveResponse['job']): Job;
+    /** @internal Create a Job from raw job data, optionally remembering the originating scope. */
+    static from(client: Scenario, data: JobRetrieveResponse['job'], scope?: Scope): Job;
 }
 /** A job with all original fields plus `.wait()`. */
 export type Job = JobRetrieveResponse.Job & JobMethods;
@@ -39,13 +48,16 @@ export type WithJob<T extends {
 };
 /**
  * @internal Wrap `_thenUnwrap` to replace `response.job` with an enhanced Job.
+ * Captures the effective scope (per-call override or client default) so
+ * `.wait()` can replay it on every poll — keeping follow-up calls in sync
+ * with the project the job was originally created in.
  */
 export declare function enhanceJob<T extends {
     job: {
         jobId: string;
         status: string;
     };
-}>(client: Scenario, promise: APIPromise<T>): APIPromise<WithJob<T>>;
+}>(client: Scenario, promise: APIPromise<T>, options?: RequestOptions): APIPromise<WithJob<T>>;
 /**
  * Enhanced Jobs resource. `retrieve` and `triggerAction` responses' `job`
  * field gains a `.wait()` helper — previously only job-creating endpoints

package/lib/job.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"job.d.mts","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAkB;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,gCAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAClE,OAAO,EACL,IAAI,EACJ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,8BAA0B;AAE3B,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IAEpD;;;;;;;;;OASG;IACG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAmB1D,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,GAAG;CAKrE;AAED,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,GAAG,UAAU,CAAC;AACvD,eAAO,MAAM,GAAG,mBAAa,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1E;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAC7E,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAKxB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI3F,aAAa,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAGjD"}
+{"version":3,"file":"job.d.mts","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAkB;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,gCAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAClE,OAAO,EACL,IAAI,EACJ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,8BAA0B;AAC3B,OAAO,EAAE,KAAK,KAAK,EAA8C,oBAAgB;AAEjF,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IACpD,6FAA6F;IAC7F,SAAiB,MAAM,CAAC,EAAE,KAAK,CAAC;IAEhC;;;;;;;;;OASG;IACG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB1D,8FAA8F;IAC9F,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;CAMpF;AAED,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,GAAG,UAAU,CAAC;AACvD,eAAO,MAAM,GAAG,mBAAa,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAC7E,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAMxB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI3F,aAAa,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAGjD"}

package/lib/job.d.ts

@@ -2,15 +2,24 @@ import type { Scenario } from "../client.js";
 import type { APIPromise } from "../core/api-promise.js";
 import type { RequestOptions } from "../internal/request-options.js";
 import { Jobs, type JobRetrieveResponse, type JobTriggerActionParams, type JobTriggerActionResponse } from "../resources/jobs.js";
+import { type Scope } from "./scope.js";
 export interface WaitOptions {
     /** Polling interval in milliseconds. Default: 3000 */
     intervalMs?: number;
     /** Maximum wait time in milliseconds. Default: 120000 */
     timeoutMs?: number;
+    /**
+     * Override the project scope used for the polling requests. Defaults to
+     * the scope captured on the job (per-call override on the originating
+     * call, else the client's default project).
+     */
+    projectId?: string;
 }
 /** Job methods added on top of the original job fields. */
 export declare class JobMethods {
     /** @internal */ readonly _client: Scenario;
+    /** @internal scope captured from the originating call — replayed on every `.wait()` poll. */
+    readonly _scope?: Scope;
     /**
      * Poll until the job reaches a terminal status (success, failure, or canceled).
      *
@@ -22,8 +31,8 @@ export declare class JobMethods {
      * ```
      */
     wait(this: Job, options?: WaitOptions): Promise<Job>;
-    /** @internal Create a Job from raw job data. */
-    static from(client: Scenario, data: JobRetrieveResponse['job']): Job;
+    /** @internal Create a Job from raw job data, optionally remembering the originating scope. */
+    static from(client: Scenario, data: JobRetrieveResponse['job'], scope?: Scope): Job;
 }
 /** A job with all original fields plus `.wait()`. */
 export type Job = JobRetrieveResponse.Job & JobMethods;
@@ -39,13 +48,16 @@ export type WithJob<T extends {
 };
 /**
  * @internal Wrap `_thenUnwrap` to replace `response.job` with an enhanced Job.
+ * Captures the effective scope (per-call override or client default) so
+ * `.wait()` can replay it on every poll — keeping follow-up calls in sync
+ * with the project the job was originally created in.
  */
 export declare function enhanceJob<T extends {
     job: {
         jobId: string;
         status: string;
     };
-}>(client: Scenario, promise: APIPromise<T>): APIPromise<WithJob<T>>;
+}>(client: Scenario, promise: APIPromise<T>, options?: RequestOptions): APIPromise<WithJob<T>>;
 /**
  * Enhanced Jobs resource. `retrieve` and `triggerAction` responses' `job`
  * field gains a `.wait()` helper — previously only job-creating endpoints

package/lib/job.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAkB;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,+BAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAClE,OAAO,EACL,IAAI,EACJ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,6BAA0B;AAE3B,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IAEpD;;;;;;;;;OASG;IACG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAmB1D,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,GAAG;CAKrE;AAED,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,GAAG,UAAU,CAAC;AACvD,eAAO,MAAM,GAAG,mBAAa,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1E;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAC7E,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAKxB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI3F,aAAa,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAGjD"}
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAkB;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,+BAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,uCAAoC;AAClE,OAAO,EACL,IAAI,EACJ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,6BAA0B;AAC3B,OAAO,EAAE,KAAK,KAAK,EAA8C,mBAAgB;AAEjF,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,gBAAgB,CAAC,SAAiB,OAAO,EAAE,QAAQ,CAAC;IACpD,6FAA6F;IAC7F,SAAiB,MAAM,CAAC,EAAE,KAAK,CAAC;IAEhC;;;;;;;;;OASG;IACG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB1D,8FAA8F;IAC9F,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;CAMpF;AAED,qDAAqD;AACrD,MAAM,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,GAAG,UAAU,CAAC;AACvD,eAAO,MAAM,GAAG,mBAAa,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAC7E,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAMxB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI3F,aAAa,CACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAGjD"}

package/lib/job.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnhancedJobs = exports.Job = exports.JobMethods = void 0;
 exports.enhanceJob = enhanceJob;
 const jobs_1 = require("../resources/jobs.js");
+const scope_1 = require("./scope.js");
 const TERMINAL_STATUSES = new Set(['success', 'failure', 'canceled']);
 /** Job methods added on top of the original job fields. */
 class JobMethods {
@@ -19,21 +20,24 @@ class JobMethods {
     async wait(options) {
         const intervalMs = options?.intervalMs ?? 3_000;
         const timeoutMs = options?.timeoutMs ?? 120_000;
+        const scope = waitOverrideScope(options) ?? this._scope;
         let elapsed = 0;
         while (elapsed < timeoutMs) {
-            const response = await this._client.jobs.retrieve(this.jobId);
+            const response = await this._client.jobs.retrieve(this.jobId, (0, scope_1.withScope)(scope));
             if (TERMINAL_STATUSES.has(response.job.status)) {
-                return exports.Job.from(this._client, response.job);
+                return exports.Job.from(this._client, response.job, scope);
             }
             await new Promise((resolve) => setTimeout(resolve, intervalMs));
             elapsed += intervalMs;
         }
         throw new Error(`Job ${this.jobId} did not complete within ${timeoutMs / 1_000}s`);
     }
-    /** @internal Create a Job from raw job data. */
-    static from(client, data) {
+    /** @internal Create a Job from raw job data, optionally remembering the originating scope. */
+    static from(client, data, scope) {
         const job = Object.assign(Object.create(JobMethods.prototype), data);
         Object.defineProperty(job, '_client', { value: client, enumerable: false });
+        if (scope)
+            Object.defineProperty(job, '_scope', { value: scope, enumerable: false });
         return job;
     }
 }
@@ -41,11 +45,15 @@ exports.JobMethods = JobMethods;
 exports.Job = JobMethods;
 /**
  * @internal Wrap `_thenUnwrap` to replace `response.job` with an enhanced Job.
+ * Captures the effective scope (per-call override or client default) so
+ * `.wait()` can replay it on every poll — keeping follow-up calls in sync
+ * with the project the job was originally created in.
  */
-function enhanceJob(client, promise) {
+function enhanceJob(client, promise, options) {
+    const scope = (0, scope_1.effectiveScope)(options, (0, scope_1.clientProjectId)(client));
     return promise._thenUnwrap((data) => ({
         ...data,
-        job: exports.Job.from(client, data.job),
+        job: exports.Job.from(client, data.job, scope),
     }));
 }
 /**
@@ -57,11 +65,17 @@ function enhanceJob(client, promise) {
  */
 class EnhancedJobs extends jobs_1.Jobs {
     retrieve(jobID, options) {
-        return enhanceJob(this._client, super.retrieve(jobID, options));
+        return enhanceJob(this._client, super.retrieve(jobID, options), options);
     }
     triggerAction(jobID, params, options) {
-        return enhanceJob(this._client, super.triggerAction(jobID, params, options));
+        return enhanceJob(this._client, super.triggerAction(jobID, params, options), options);
     }
 }
 exports.EnhancedJobs = EnhancedJobs;
+/** Resolve the scope override carried by a `WaitOptions`, if any. */
+function waitOverrideScope(options) {
+    if (!options?.projectId)
+        return undefined;
+    return { projectId: options.projectId };
+}
 //# sourceMappingURL=job.js.map

package/lib/job.js.map

@@ -1 +1 @@
-{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":";;;AA2EA,gCAQC;AAhFD,+CAK2B;AAW3B,MAAM,iBAAiB,GAAmB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtF,2DAA2D;AAC3D,MAAa,UAAU;IAGrB;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAY,OAAqB;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC;QAChD,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,OAAO,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE9D,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,OAAO,WAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,UAAU,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,4BAA4B,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,MAAgB,EAAE,IAAgC;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,CAAQ,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAtCD,gCAsCC;AAIY,QAAA,GAAG,GAAG,UAAU,CAAC;AAQ9B;;GAEG;AACH,SAAgB,UAAU,CACxB,MAAgB,EAChB,OAAsB;IAEtB,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,IAAI;QACP,GAAG,EAAE,WAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAiC,CAAC;KAC9D,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAa,YAAa,SAAQ,WAAI;IAC3B,QAAQ,CAAC,KAAa,EAAE,OAAwB;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAEQ,aAAa,CACpB,KAAa,EACb,MAA8B,EAC9B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;CACF;AAZD,oCAYC"}
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"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"}

package/lib/job.mjs

@@ -1,4 +1,5 @@
 import { Jobs, } from "../resources/jobs.mjs";
+import { clientProjectId, effectiveScope, withScope } from "./scope.mjs";
 const TERMINAL_STATUSES = new Set(['success', 'failure', 'canceled']);
 /** Job methods added on top of the original job fields. */
 export class JobMethods {
@@ -15,32 +16,39 @@ export class JobMethods {
     async wait(options) {
         const intervalMs = options?.intervalMs ?? 3_000;
         const timeoutMs = options?.timeoutMs ?? 120_000;
+        const scope = waitOverrideScope(options) ?? this._scope;
         let elapsed = 0;
         while (elapsed < timeoutMs) {
-            const response = await this._client.jobs.retrieve(this.jobId);
+            const response = await this._client.jobs.retrieve(this.jobId, withScope(scope));
             if (TERMINAL_STATUSES.has(response.job.status)) {
-                return Job.from(this._client, response.job);
+                return Job.from(this._client, response.job, scope);
             }
             await new Promise((resolve) => setTimeout(resolve, intervalMs));
             elapsed += intervalMs;
         }
         throw new Error(`Job ${this.jobId} did not complete within ${timeoutMs / 1_000}s`);
     }
-    /** @internal Create a Job from raw job data. */
-    static from(client, data) {
+    /** @internal Create a Job from raw job data, optionally remembering the originating scope. */
+    static from(client, data, scope) {
         const job = Object.assign(Object.create(JobMethods.prototype), data);
         Object.defineProperty(job, '_client', { value: client, enumerable: false });
+        if (scope)
+            Object.defineProperty(job, '_scope', { value: scope, enumerable: false });
         return job;
     }
 }
 export const Job = JobMethods;
 /**
  * @internal Wrap `_thenUnwrap` to replace `response.job` with an enhanced Job.
+ * Captures the effective scope (per-call override or client default) so
+ * `.wait()` can replay it on every poll — keeping follow-up calls in sync
+ * with the project the job was originally created in.
  */
-export function enhanceJob(client, promise) {
+export function enhanceJob(client, promise, options) {
+    const scope = effectiveScope(options, clientProjectId(client));
     return promise._thenUnwrap((data) => ({
         ...data,
-        job: Job.from(client, data.job),
+        job: Job.from(client, data.job, scope),
     }));
 }
 /**
@@ -52,10 +60,16 @@ export function enhanceJob(client, promise) {
  */
 export class EnhancedJobs extends Jobs {
     retrieve(jobID, options) {
-        return enhanceJob(this._client, super.retrieve(jobID, options));
+        return enhanceJob(this._client, super.retrieve(jobID, options), options);
     }
     triggerAction(jobID, params, options) {
-        return enhanceJob(this._client, super.triggerAction(jobID, params, options));
+        return enhanceJob(this._client, super.triggerAction(jobID, params, options), options);
     }
 }
+/** Resolve the scope override carried by a `WaitOptions`, if any. */
+function waitOverrideScope(options) {
+    if (!options?.projectId)
+        return undefined;
+    return { projectId: options.projectId };
+}
 //# sourceMappingURL=job.mjs.map

package/lib/job.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"job.mjs","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,IAAI,GAIL,8BAA0B;AAW3B,MAAM,iBAAiB,GAAmB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtF,2DAA2D;AAC3D,MAAM,OAAO,UAAU;IAGrB;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAY,OAAqB;QACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC;QAChD,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,OAAO,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE9D,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,UAAU,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,4BAA4B,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,MAAgB,EAAE,IAAgC;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,CAAQ,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAID,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAC;AAQ9B;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAAgB,EAChB,OAAsB;IAEtB,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,IAAI;QACP,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAiC,CAAC;KAC9D,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,IAAI;IAC3B,QAAQ,CAAC,KAAa,EAAE,OAAwB;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAEQ,aAAa,CACpB,KAAa,EACb,MAA8B,EAC9B,OAAwB;QAExB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;CACF"}
+{"version":3,"file":"job.mjs","sourceRoot":"","sources":["../src/lib/job.ts"],"names":[],"mappings":"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"}

package/lib/models.d.mts

@@ -4,6 +4,7 @@ import type { GenerateRunModelParams, GenerateRunModelResponse } from "../resour
 import { Models, type ModelRetrieveParams, type ModelRetrieveResponse } from "../resources/models/models.mjs";
 import { Train, type TrainTriggerParams, type TrainTriggerResponse } from "../resources/models/train.mjs";
 import { type WithJob } from "./job.mjs";
+import { type Scope } from "./scope.mjs";
 import type { Scenario } from "./scenario.mjs";
 /**
  * Enhanced Model entity with helper methods.
@@ -18,15 +19,20 @@ import type { Scenario } from "./scenario.mjs";
  */
 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.mts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.mts","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gCAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,kCAA8B;AAC9F,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,uCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,sCAAkC;AACtG,OAAO,EAAE,KAAK,OAAO,EAAc,kBAAc;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,uBAAmB;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.mts","sourceRoot":"","sources":["../src/lib/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gCAA4B;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAoC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,kCAA8B;AAC9F,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,uCAAmC;AAC1G,OAAO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,sCAAkC;AACtG,OAAO,EAAE,KAAK,OAAO,EAAc,kBAAc;AACjD,OAAO,EAAE,KAAK,KAAK,EAA6B,oBAAgB;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,uBAAmB;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"}