@nodaro/sdk 2.33.0 → 2.38.0

package/dist/entries/client.js

@@ -1,53 +1,55 @@
-export { NodaroClient, createClient } from '../chunk-JSCC2N7N.js';
+export { NodaroClient, createClient } from '../chunk-AVOQ5DG4.js';
+import '../chunk-ERLXU47J.js';
+import '../chunk-T7N7DFQJ.js';
 import '../chunk-YN6CBIIB.js';
-import '../chunk-ZXJQSFIA.js';
+import '../chunk-JUON5NXA.js';
 import '../chunk-Z5GLY4R3.js';
+import '../chunk-NNHWH7ER.js';
 import '../chunk-Y6VDCZPB.js';
 import '../chunk-WVFAQBS7.js';
-import '../chunk-VV4TZG5S.js';
-import '../chunk-6OGGJQVA.js';
-import '../chunk-DPSMVOM3.js';
-import '../chunk-T3SYREY4.js';
-import '../chunk-ERLXU47J.js';
-import '../chunk-T7N7DFQJ.js';
+import '../chunk-AUKHMT53.js';
+import '../chunk-ILG5DHQQ.js';
+import '../chunk-QGOEQGAE.js';
+import '../chunk-YSZM3N7Q.js';
+import '../chunk-WY4QRJZW.js';
+import '../chunk-WEQWU2IC.js';
 import '../chunk-BLA44UCM.js';
 import '../chunk-K4RQOSJH.js';
 import '../chunk-H7VQTG4M.js';
-import '../chunk-E2ZXHS6E.js';
+import '../chunk-OIPPTBW4.js';
 import '../chunk-AJVSMNPZ.js';
 import '../chunk-IHKIYVZQ.js';
 import '../chunk-NCCBS6GU.js';
-import '../chunk-NNHWH7ER.js';
+import '../chunk-DQAYIVVS.js';
 import '../chunk-Y6V6CBY5.js';
 import '../chunk-YVU2M7MI.js';
 import '../chunk-JTAW54UM.js';
-import '../chunk-6ECW23GA.js';
+import '../chunk-ZDSC6KBT.js';
 import '../chunk-Z7LGWNI7.js';
 import '../chunk-7LSFG2AF.js';
 import '../chunk-ALSLZG3U.js';
-import '../chunk-WEQWU2IC.js';
+import '../chunk-Z7UZ3FD3.js';
 import '../chunk-Z3ZKFI2M.js';
 import '../chunk-JDEZHITT.js';
-import '../chunk-E5BM4BLO.js';
+import '../chunk-7IWVDWSP.js';
 import '../chunk-P6E4QDJN.js';
 import '../chunk-E37CVHWW.js';
 import '../chunk-TVENC6PH.js';
-import '../chunk-4NLVBYMW.js';
+import '../chunk-4WRDR4GN.js';
 import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
-import '../chunk-I6CXC345.js';
-import '../chunk-JMOKD6ZP.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-Y5CYFNNW.js';
+import '../chunk-D2ILCSOQ.js';
+import '../chunk-7CUWAVWB.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-Q6HY2Q5V.js';
+import '../chunk-L6T44A3G.js';
 import '../chunk-CK3AMMSC.js';
-import '../chunk-4CXB7RA6.js';
+import '../chunk-IGMWFEFB.js';
 import '../chunk-65E3JBFZ.js';
-import '../chunk-5A7J24LN.js';
-import '../chunk-JGS6YBDW.js';
-import '../chunk-53SXNN3A.js';
+import '../chunk-FQNCIP6K.js';
 import '../chunk-3QFTP5P5.js';
 import '../chunk-J4WFSKY6.js';
+import '../chunk-ED3ZOX3M.js';
 import '../chunk-KG4R454Z.js';
 import '../chunk-EJSGJDZY.js';
-import '../chunk-4WRDR4GN.js';
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/entries/copilot.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
 require('../chunk-W33CKW6Q.cjs');
-var chunkNLQQHJ25_cjs = require('../chunk-NLQQHJ25.cjs');
-require('../chunk-KNMW722T.cjs');
-require('../chunk-N6GLZOE4.cjs');
+var chunkOSMKIRKI_cjs = require('../chunk-OSMKIRKI.cjs');
+require('../chunk-FRQJNGJS.cjs');
+require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CopilotResource", {
   enumerable: true,
-  get: function () { return chunkNLQQHJ25_cjs.CopilotResource; }
+  get: function () { return chunkOSMKIRKI_cjs.CopilotResource; }
 });
 //# sourceMappingURL=copilot.cjs.map
 //# sourceMappingURL=copilot.cjs.map

package/dist/entries/copilot.js

@@ -1,6 +1,6 @@
 import '../chunk-ELSOVJPF.js';
-export { CopilotResource } from '../chunk-I6CXC345.js';
-import '../chunk-JMOKD6ZP.js';
-import '../chunk-JGS6YBDW.js';
+export { CopilotResource } from '../chunk-D2ILCSOQ.js';
+import '../chunk-7CUWAVWB.js';
+import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=copilot.js.map
 //# sourceMappingURL=copilot.js.map

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunk56NJIP7P_cjs = require('../chunk-56NJIP7P.cjs');
-require('../chunk-N6GLZOE4.cjs');
+var chunkIISVYX5J_cjs = require('../chunk-IISVYX5J.cjs');
+require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunk56NJIP7P_cjs.CallbackAuth; }
+  get: function () { return chunkIISVYX5J_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunk56NJIP7P_cjs.NodaroClientCore; }
+  get: function () { return chunkIISVYX5J_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunk56NJIP7P_cjs.StaticTokenAuth; }
+  get: function () { return chunkIISVYX5J_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunk56NJIP7P_cjs.supabaseAuth; }
+  get: function () { return chunkIISVYX5J_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-Y5CYFNNW.js';
-import '../chunk-JGS6YBDW.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-Q6HY2Q5V.js';
+import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/creatures.d.cts

@@ -2,7 +2,7 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-J8ByUN8z.cjs';
+import { l as GenerationSessionParams } from '../nodes-BDUk5Aej.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -14,7 +14,7 @@ import '@nodaro/shared/scene3d';
 import '@nodaro/shared/credits';
 import './jobs.cjs';
 import './errors.cjs';
-import '../studio-productions-DUHvdSvk.cjs';
+import '../studio-productions-r2-VZsKj.cjs';
 import '@nodaro/shared/model-catalog';
 import '@nodaro/prompts/prompt-builder';
 

package/dist/entries/creatures.d.ts

@@ -2,7 +2,7 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-C-wrO6Sg.js';
+import { l as GenerationSessionParams } from '../nodes-9WpYNWtS.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -14,7 +14,7 @@ import '@nodaro/shared/scene3d';
 import '@nodaro/shared/credits';
 import './jobs.js';
 import './errors.js';
-import '../studio-productions-vbCNSbtf.js';
+import '../studio-productions-DtTE8mdl.js';
 import '@nodaro/shared/model-catalog';
 import '@nodaro/prompts/prompt-builder';
 

package/dist/entries/credits.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-ALUUBPDG.cjs');
-var chunkGB724HW2_cjs = require('../chunk-GB724HW2.cjs');
+var chunkPQ7OKM3E_cjs = require('../chunk-PQ7OKM3E.cjs');
 
 
 
 Object.defineProperty(exports, "CreditsResource", {
   enumerable: true,
-  get: function () { return chunkGB724HW2_cjs.CreditsResource; }
+  get: function () { return chunkPQ7OKM3E_cjs.CreditsResource; }
 });
 //# sourceMappingURL=credits.cjs.map
 //# sourceMappingURL=credits.cjs.map

package/dist/entries/credits.d.cts

@@ -107,6 +107,40 @@ interface ModelCostsResult {
     data: Record<string, number>;
     missing: string[];
     errors: string[];
+    /**
+     * Why each identifier in `errors` has no price — today only
+     * `llm_model_unpriced`: a metered LLM price key whose model has no rate on
+     * the lane it would be served on (it cannot be run). Omitted when `errors`
+     * is empty.
+     */
+    errorCodes?: Record<string, ModelCostError>;
+    /**
+     * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:
+     * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,
+     * `<feature>:<model>[:direct]`), charged on what the call actually uses.
+     * Show these as `~N`. Omitted when there are none, so a batch of fixed ids
+     * answers exactly as it always has. A metered key that lands in `missing`
+     * instead means the server is not pricing LLM calls per model — show no
+     * price for it.
+     */
+    estimates?: string[];
+}
+/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */
+interface ModelCostError {
+    /** Today only `llm_model_unpriced`; open to codes a newer server may add. */
+    code: "llm_model_unpriced" | (string & {});
+    /** A sentence to show the user. */
+    message: string;
+}
+/**
+ * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one
+ * identifier is charged. `estimate: true` marks a metered LLM price key's
+ * figure as an estimate (show it as `~N`); such an answer is never cached.
+ */
+interface ModelCostResult {
+    model: string;
+    creditCost: number;
+    estimate?: true;
 }
 /**
  * The two browser signals a claim reports — SHA-256 hex digests computed by
@@ -189,7 +223,8 @@ declare class CreditsResource {
      * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
      * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
      * (the route's request limit). Preserves the `{ data, missing, errors }`
-     * fault-isolation shape verbatim (see {@link ModelCostsResult}).
+     * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a
+     * metered LLM price key was asked (see {@link ModelCostsResult}).
      */
     modelCosts(ids: string[]): Promise<ModelCostsResult>;
     /**
@@ -234,4 +269,4 @@ declare class CreditsResource {
     markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult>;
 }
 
-export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };
+export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };

package/dist/entries/credits.d.ts

@@ -107,6 +107,40 @@ interface ModelCostsResult {
     data: Record<string, number>;
     missing: string[];
     errors: string[];
+    /**
+     * Why each identifier in `errors` has no price — today only
+     * `llm_model_unpriced`: a metered LLM price key whose model has no rate on
+     * the lane it would be served on (it cannot be run). Omitted when `errors`
+     * is empty.
+     */
+    errorCodes?: Record<string, ModelCostError>;
+    /**
+     * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:
+     * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,
+     * `<feature>:<model>[:direct]`), charged on what the call actually uses.
+     * Show these as `~N`. Omitted when there are none, so a batch of fixed ids
+     * answers exactly as it always has. A metered key that lands in `missing`
+     * instead means the server is not pricing LLM calls per model — show no
+     * price for it.
+     */
+    estimates?: string[];
+}
+/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */
+interface ModelCostError {
+    /** Today only `llm_model_unpriced`; open to codes a newer server may add. */
+    code: "llm_model_unpriced" | (string & {});
+    /** A sentence to show the user. */
+    message: string;
+}
+/**
+ * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one
+ * identifier is charged. `estimate: true` marks a metered LLM price key's
+ * figure as an estimate (show it as `~N`); such an answer is never cached.
+ */
+interface ModelCostResult {
+    model: string;
+    creditCost: number;
+    estimate?: true;
 }
 /**
  * The two browser signals a claim reports — SHA-256 hex digests computed by
@@ -189,7 +223,8 @@ declare class CreditsResource {
      * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
      * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
      * (the route's request limit). Preserves the `{ data, missing, errors }`
-     * fault-isolation shape verbatim (see {@link ModelCostsResult}).
+     * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a
+     * metered LLM price key was asked (see {@link ModelCostsResult}).
      */
     modelCosts(ids: string[]): Promise<ModelCostsResult>;
     /**
@@ -234,4 +269,4 @@ declare class CreditsResource {
     markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult>;
 }
 
-export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };
+export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };

package/dist/entries/credits.js

@@ -1,4 +1,4 @@
 import '../chunk-V4GPQ6Y2.js';
-export { CreditsResource } from '../chunk-4CXB7RA6.js';
+export { CreditsResource } from '../chunk-IGMWFEFB.js';
 //# sourceMappingURL=credits.js.map
 //# sourceMappingURL=credits.js.map

package/dist/entries/edit.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var chunk6T54F65Q_cjs = require('../chunk-6T54F65Q.cjs');
-var chunkRHJRLXKY_cjs = require('../chunk-RHJRLXKY.cjs');
-require('../chunk-N6GLZOE4.cjs');
+var chunk7XOK277W_cjs = require('../chunk-7XOK277W.cjs');
+require('../chunk-FM2KM5TY.cjs');
 
 
 
@@ -12,23 +12,23 @@ Object.defineProperty(exports, "unwrapEditPlanOutput", {
 });
 Object.defineProperty(exports, "CLIP_PACK_MAX_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunkRHJRLXKY_cjs.CLIP_PACK_MAX_TARGET_SEC; }
+  get: function () { return chunk7XOK277W_cjs.CLIP_PACK_MAX_TARGET_SEC; }
 });
 Object.defineProperty(exports, "CLIP_PACK_MIN_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunkRHJRLXKY_cjs.CLIP_PACK_MIN_TARGET_SEC; }
+  get: function () { return chunk7XOK277W_cjs.CLIP_PACK_MIN_TARGET_SEC; }
 });
 Object.defineProperty(exports, "EditResource", {
   enumerable: true,
-  get: function () { return chunkRHJRLXKY_cjs.EditResource; }
+  get: function () { return chunk7XOK277W_cjs.EditResource; }
 });
 Object.defineProperty(exports, "TRAILER_FORMATS", {
   enumerable: true,
-  get: function () { return chunkRHJRLXKY_cjs.TRAILER_FORMATS; }
+  get: function () { return chunk7XOK277W_cjs.TRAILER_FORMATS; }
 });
 Object.defineProperty(exports, "USE_CASE_NODE_TYPES", {
   enumerable: true,
-  get: function () { return chunkRHJRLXKY_cjs.USE_CASE_NODE_TYPES; }
+  get: function () { return chunk7XOK277W_cjs.USE_CASE_NODE_TYPES; }
 });
 //# sourceMappingURL=edit.cjs.map
 //# sourceMappingURL=edit.cjs.map

package/dist/entries/edit.d.cts

@@ -545,6 +545,9 @@ interface UseCaseEstimate {
     stepsCredits: number;
     /** The per-run fee. */
     feeCredits: number;
+    /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
+     *  total is one: show it `~N`. Absent for a fixed figure. */
+    estimate?: true;
     /** The recording's length, in seconds. */
     durationSec: number | null;
 }

package/dist/entries/edit.d.ts

@@ -545,6 +545,9 @@ interface UseCaseEstimate {
     stepsCredits: number;
     /** The per-run fee. */
     feeCredits: number;
+    /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
+     *  total is one: show it `~N`. Absent for a fixed figure. */
+    estimate?: true;
     /** The recording's length, in seconds. */
     durationSec: number | null;
 }

package/dist/entries/edit.js

@@ -1,5 +1,5 @@
 export { unwrapEditPlanOutput } from '../chunk-UKB64254.js';
-export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-5A7J24LN.js';
-import '../chunk-JGS6YBDW.js';
+export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-Z7UZ3FD3.js';
+import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=edit.js.map
 //# sourceMappingURL=edit.js.map

package/dist/entries/errors.cjs

@@ -1,93 +1,101 @@
 'use strict';
 
 require('../chunk-A2ZAFAWC.cjs');
-var chunkN6GLZOE4_cjs = require('../chunk-N6GLZOE4.cjs');
+var chunkFM2KM5TY_cjs = require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "AlreadyRunningError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.AlreadyRunningError; }
+  get: function () { return chunkFM2KM5TY_cjs.AlreadyRunningError; }
 });
 Object.defineProperty(exports, "AppRunVersionChangedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.AppRunVersionChangedError; }
+  get: function () { return chunkFM2KM5TY_cjs.AppRunVersionChangedError; }
+});
+Object.defineProperty(exports, "CREDIT_CAP_CODES", {
+  enumerable: true,
+  get: function () { return chunkFM2KM5TY_cjs.CREDIT_CAP_CODES; }
 });
 Object.defineProperty(exports, "ContinuationPreviewPendingError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.ContinuationPreviewPendingError; }
+  get: function () { return chunkFM2KM5TY_cjs.ContinuationPreviewPendingError; }
 });
 Object.defineProperty(exports, "ContinuationRefusedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.ContinuationRefusedError; }
+  get: function () { return chunkFM2KM5TY_cjs.ContinuationRefusedError; }
+});
+Object.defineProperty(exports, "CreditCapExceededError", {
+  enumerable: true,
+  get: function () { return chunkFM2KM5TY_cjs.CreditCapExceededError; }
 });
 Object.defineProperty(exports, "ForbiddenError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.ForbiddenError; }
+  get: function () { return chunkFM2KM5TY_cjs.ForbiddenError; }
 });
 Object.defineProperty(exports, "InsufficientCreditsError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.InsufficientCreditsError; }
+  get: function () { return chunkFM2KM5TY_cjs.InsufficientCreditsError; }
 });
 Object.defineProperty(exports, "JobAbortedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.JobAbortedError; }
+  get: function () { return chunkFM2KM5TY_cjs.JobAbortedError; }
 });
 Object.defineProperty(exports, "JobBlockedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.JobBlockedError; }
+  get: function () { return chunkFM2KM5TY_cjs.JobBlockedError; }
 });
 Object.defineProperty(exports, "JobFailedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.JobFailedError; }
+  get: function () { return chunkFM2KM5TY_cjs.JobFailedError; }
 });
 Object.defineProperty(exports, "JobHeldError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.JobHeldError; }
+  get: function () { return chunkFM2KM5TY_cjs.JobHeldError; }
 });
 Object.defineProperty(exports, "JobTimeoutError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.JobTimeoutError; }
+  get: function () { return chunkFM2KM5TY_cjs.JobTimeoutError; }
 });
 Object.defineProperty(exports, "NodaroError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.NodaroError; }
+  get: function () { return chunkFM2KM5TY_cjs.NodaroError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.NotFoundError; }
+  get: function () { return chunkFM2KM5TY_cjs.NotFoundError; }
 });
 Object.defineProperty(exports, "RateLimitedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.RateLimitedError; }
+  get: function () { return chunkFM2KM5TY_cjs.RateLimitedError; }
 });
 Object.defineProperty(exports, "StorageExceededError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.StorageExceededError; }
+  get: function () { return chunkFM2KM5TY_cjs.StorageExceededError; }
 });
 Object.defineProperty(exports, "StudioOpError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.StudioOpError; }
+  get: function () { return chunkFM2KM5TY_cjs.StudioOpError; }
 });
 Object.defineProperty(exports, "StudioPreviewAppliedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.StudioPreviewAppliedError; }
+  get: function () { return chunkFM2KM5TY_cjs.StudioPreviewAppliedError; }
 });
 Object.defineProperty(exports, "StudioPreviewUnavailable", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.StudioPreviewUnavailable; }
+  get: function () { return chunkFM2KM5TY_cjs.StudioPreviewUnavailable; }
 });
 Object.defineProperty(exports, "UnauthorizedError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.UnauthorizedError; }
+  get: function () { return chunkFM2KM5TY_cjs.UnauthorizedError; }
 });
 Object.defineProperty(exports, "WorkflowConflictError", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.WorkflowConflictError; }
+  get: function () { return chunkFM2KM5TY_cjs.WorkflowConflictError; }
 });
 Object.defineProperty(exports, "throwFromResponse", {
   enumerable: true,
-  get: function () { return chunkN6GLZOE4_cjs.throwFromResponse; }
+  get: function () { return chunkFM2KM5TY_cjs.throwFromResponse; }
 });
 //# sourceMappingURL=errors.cjs.map
 //# sourceMappingURL=errors.cjs.map

package/dist/entries/errors.d.cts

@@ -1,4 +1,4 @@
-import { x as StudioOpsResponse } from '../studio-productions-DUHvdSvk.cjs';
+import { x as StudioOpsResponse } from '../studio-productions-r2-VZsKj.cjs';
 import '../developer-apps-zSQXWmEG.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
@@ -6,7 +6,15 @@ import '@nodaro/shared/organizations';
 declare class NodaroError extends Error {
     readonly code: string;
     readonly status: number;
-    constructor(message: string, code: string, status: number);
+    /**
+     * Every other field of the server's error envelope (`{ error: { code,
+     * message, … } }`), as it was sent: for example a trend refusal's `slot`, a
+     * publish refusal's `reasons`, a validation error's `issues`. Empty when the
+     * envelope had nothing else, or for an error the SDK made itself. A copy —
+     * changing it changes nothing else.
+     */
+    readonly details: Readonly<Record<string, unknown>>;
+    constructor(message: string, code: string, status: number, details?: Readonly<Record<string, unknown>>);
 }
 declare class UnauthorizedError extends NodaroError {
     constructor(message?: string);
@@ -21,10 +29,38 @@ declare class NotFoundError extends NodaroError {
 declare class RateLimitedError extends NodaroError {
     constructor(message?: string);
 }
+/**
+ * HTTP 402: the run costs more than the caller may spend. `code` is the
+ * refusal's own code — `insufficient_credits` for the caller's own balance, or
+ * another 402 code such as `free_video_limit`. A spending cap someone else set
+ * (a workspace budget, a member cap, a per-user allowance) is the subclass
+ * {@link CreditCapExceededError}, so `instanceof InsufficientCreditsError`
+ * still catches every 402.
+ */
 declare class InsufficientCreditsError extends NodaroError {
     readonly required?: number | undefined;
     readonly available?: number | undefined;
-    constructor(message?: string, required?: number | undefined, available?: number | undefined);
+    constructor(message?: string, required?: number | undefined, available?: number | undefined, code?: string);
+}
+/** The 402 codes of a spending cap set by someone other than the caller. */
+type CreditCapCode = "budget_exceeded" | "member_cap_exceeded" | "user_allowance_exceeded";
+/**
+ * The 402 codes {@link CreditCapExceededError} carries: the workspace's budget
+ * (`budget_exceeded`), the caller's cap in that workspace
+ * (`member_cap_exceeded`), the deployment's per-user allowance
+ * (`user_allowance_exceeded`).
+ */
+declare const CREDIT_CAP_CODES: ReadonlySet<CreditCapCode>;
+/**
+ * HTTP 402 from a spending cap, not from the caller's own balance: topping up
+ * does not help — whoever set the cap (the workspace's owner, the deployment's
+ * operator) has to raise it. An {@link InsufficientCreditsError}, so existing
+ * catches keep working; `code` says which cap. `available`, when sent, is what
+ * the cap has left.
+ */
+declare class CreditCapExceededError extends InsufficientCreditsError {
+    readonly code: CreditCapCode;
+    constructor(code: CreditCapCode, message?: string, required?: number, available?: number);
 }
 declare class StorageExceededError extends NodaroError {
     readonly limitBytes?: number | undefined;
@@ -329,10 +365,12 @@ interface ApiErrorBody {
     required?: unknown;
     /** …and what the caller has (withheld on a deployment-paid instance). */
     balance?: unknown;
+    /** A per-user allowance's 402: what the allowance has left. */
+    remaining?: unknown;
     /** `app_run_version_changed`: the version the run ran, and the one the caller is on. */
     runVersion?: unknown;
     appVersion?: unknown;
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { AlreadyRunningError, AppRunVersionChangedError, ContinuationPreviewPendingError, ContinuationRefusedError, ForbiddenError, type HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, type WorkflowConflictCode, WorkflowConflictError, throwFromResponse };
+export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, type CreditCapCode, CreditCapExceededError, ForbiddenError, type HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, type WorkflowConflictCode, WorkflowConflictError, throwFromResponse };