@nodaro/sdk 2.34.0 → 2.39.0

package/dist/index.js

@@ -1,3 +1,4 @@
+import './chunk-VPAUN75Q.js';
 import './chunk-MEKI37WI.js';
 export { WebhookSignatureError, verifyWebhookSignature } from './chunk-VGTRKXF2.js';
 import './chunk-PGYQ754I.js';
@@ -7,9 +8,9 @@ import './chunk-D3PW7AHZ.js';
 import './chunk-BKP6F2IX.js';
 import './chunk-PMTM26LL.js';
 import './chunk-LHRQXWI5.js';
+import './chunk-YCVRQZT3.js';
 import './chunk-VT237QF2.js';
 import './chunk-CGNVHN4V.js';
-import './chunk-VPAUN75Q.js';
 import './chunk-HLHR3R4P.js';
 import './chunk-QVQCKOBM.js';
 import './chunk-IQ6KWSXP.js';
@@ -48,56 +49,57 @@ import './chunk-M6Y5TOYE.js';
 import './chunk-KARJ7P7Y.js';
 import './chunk-SUCHGNYT.js';
 import './chunk-SLPD47SR.js';
-export { NodaroClient, createClient } from './chunk-CWH642B2.js';
+export { NodaroClient, createClient } from './chunk-CIUZMTER.js';
+export { VideoProResource } from './chunk-ERLXU47J.js';
 export { VoicesResource } from './chunk-T7N7DFQJ.js';
 export { WebhooksResource } from './chunk-YN6CBIIB.js';
-export { WorkflowsResource } from './chunk-ZXJQSFIA.js';
+export { WorkflowsResource } from './chunk-JUON5NXA.js';
 export { WorkspacesResource } from './chunk-Z5GLY4R3.js';
 export { SCENE3D_DELIVERY_ASSET_USAGE, Scene3DResource } from './chunk-NNHWH7ER.js';
 export { SessionsResource } from './chunk-Y6VDCZPB.js';
 export { ShotsResource } from './chunk-WVFAQBS7.js';
-export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from './chunk-VV4TZG5S.js';
-export { TemplatesResource } from './chunk-6OGGJQVA.js';
-export { TutorialsResource } from './chunk-DPSMVOM3.js';
-export { UploadsResource } from './chunk-T3SYREY4.js';
-export { VideoProResource } from './chunk-ERLXU47J.js';
+export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from './chunk-AUKHMT53.js';
+export { TemplatesResource } from './chunk-ILG5DHQQ.js';
+export { TrendsResource } from './chunk-QGOEQGAE.js';
+export { TutorialsResource } from './chunk-YSZM3N7Q.js';
+export { UploadsResource } from './chunk-WY4QRJZW.js';
 export { PALETTE_DIRECTION_PREFIX, PalettesResource, paletteDirectionId } from './chunk-WEQWU2IC.js';
 export { PickerCatalogsResource } from './chunk-BLA44UCM.js';
 export { PipelinesResource } from './chunk-K4RQOSJH.js';
 export { ProjectsResource } from './chunk-H7VQTG4M.js';
-export { PromptHelperResource } from './chunk-E2ZXHS6E.js';
+export { PromptHelperResource } from './chunk-OIPPTBW4.js';
 export { RecastResource } from './chunk-AJVSMNPZ.js';
 export { ReduceResource } from './chunk-IHKIYVZQ.js';
 export { SavedPostsResource } from './chunk-NCCBS6GU.js';
-export { MediaResource } from './chunk-4NLVBYMW.js';
+export { MediaResource } from './chunk-DQAYIVVS.js';
 export { ModelsResource } from './chunk-Y6V6CBY5.js';
 export { MOODBOARD_DIRECTION_PREFIX, MoodboardsResource, moodboardDirectionId } from './chunk-YVU2M7MI.js';
 export { PresetsResource } from './chunk-JTAW54UM.js';
-export { NodesResource } from './chunk-4JKI6JRC.js';
+export { NodesResource } from './chunk-ZDSC6KBT.js';
 export { OAuthResource } from './chunk-Z7LGWNI7.js';
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectsResource } from './chunk-7LSFG2AF.js';
 export { OrganizationsResource } from './chunk-ALSLZG3U.js';
-export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from './chunk-5A7J24LN.js';
+export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from './chunk-Z7UZ3FD3.js';
 export { ExecutionsResource, OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from './chunk-Z3ZKFI2M.js';
 export { GalleryResource } from './chunk-JDEZHITT.js';
-export { JobsResource } from './chunk-E5BM4BLO.js';
+export { JobsResource } from './chunk-7IWVDWSP.js';
 export { LibraryResource } from './chunk-P6E4QDJN.js';
 export { LlmResource } from './chunk-E37CVHWW.js';
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from './chunk-TVENC6PH.js';
 export { CollectionsResource } from './chunk-4WRDR4GN.js';
 export { CommunityResource } from './chunk-SFB4YLCS.js';
 export { CompetitorsResource } from './chunk-BU5A6K4C.js';
-export { CopilotResource } from './chunk-I6CXC345.js';
-import './chunk-JMOKD6ZP.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-VFMWBW2Q.js';
-export { AlreadyRunningError, AppRunVersionChangedError, ContinuationPreviewPendingError, ContinuationRefusedError, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from './chunk-JGS6YBDW.js';
+export { CopilotResource } from './chunk-D2ILCSOQ.js';
+import './chunk-7CUWAVWB.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-NU4QSOMH.js';
+export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from './chunk-L6T44A3G.js';
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CreaturesResource } from './chunk-CK3AMMSC.js';
-export { CreditsResource } from './chunk-4CXB7RA6.js';
+export { CreditsResource } from './chunk-IGMWFEFB.js';
 export { DeveloperAppsResource } from './chunk-65E3JBFZ.js';
-export { AppsResource } from './chunk-53SXNN3A.js';
+export { AppsResource } from './chunk-FQNCIP6K.js';
 export { AudioResource } from './chunk-3QFTP5P5.js';
 export { BillingResource } from './chunk-J4WFSKY6.js';
-export { CastSwapResource } from './chunk-GDXS4EJ5.js';
+export { CastSwapResource } from './chunk-AQHU7EI5.js';
 export { CatalogsResource } from './chunk-KG4R454Z.js';
 export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, CharactersResource, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints, buildPersonSeedPrompt } from './chunk-EJSGJDZY.js';
 //# sourceMappingURL=index.js.map

package/dist/{nodes-D2tbtzt7.d.ts → nodes-9WpYNWtS.d.ts}

@@ -630,6 +630,12 @@ interface NodeDescriptor {
      *  without a credit system (community/business omit the field entirely;
      *  it is meaningful on Cloud only). */
     creditCost?: number | string;
+    /** `creditCost` is an ESTIMATE: a metered LLM node's typical call on its
+     *  default model, charged its actual usage after the run (shown `~N`).
+     *  Absent for a fixed price, and under the tier-pricing rollback. A metered
+     *  LLM node whose default model has no price yet lists `creditCost:
+     *  "unpriced"` (a run on it is refused `llm_model_unpriced`). */
+    estimate?: true;
     /** A node charged per unit of its own measure (its `creditCost` is a word
      *  such as `"per-1000-frames"`): the charged price of one unit and how a run
      *  rounds. Cloud only, like `creditCost`. */
@@ -1016,6 +1022,10 @@ interface TextToVideoParams extends StructuredReferenceParams, ReferenceCaptionP
      *  { provider: "seedance-2-5-hd", sourceJobId })`: the same take, frame for
      *  frame, at 1080p. Drafts are kept about 7 days. */
     draft?: boolean;
+    /** Absent / `true`: a copyright refusal is retried once with a reworded
+     *  prompt. `false` = a copyright refusal fails the job instead of retrying
+     *  once with a reworded prompt. */
+    contentPolicyRewrite?: boolean;
     [k: string]: unknown;
 }
 /**
@@ -1175,7 +1185,9 @@ interface RunAndWaitOptions {
     readonly signal?: AbortSignal;
     /**
      * Also cancel the job when `signal` aborts after it was submitted
-     * (`POST /v1/jobs/:id/cancel`, which refunds its credit hold). Best effort:
+     * (`POST /v1/jobs/:id/cancel`, which refunds its credit hold — except a
+     * metered LLM job whose call has started: it answers `inFlight: true`,
+     * finishes, and is charged what it used). Best effort:
      * a failed cancel still rejects with the {@link JobAbortedError}. Default
      * `false` — aborting only stops waiting.
      */

package/dist/{nodes-CTujw6Qd.d.cts → nodes-BDUk5Aej.d.cts}

@@ -630,6 +630,12 @@ interface NodeDescriptor {
      *  without a credit system (community/business omit the field entirely;
      *  it is meaningful on Cloud only). */
     creditCost?: number | string;
+    /** `creditCost` is an ESTIMATE: a metered LLM node's typical call on its
+     *  default model, charged its actual usage after the run (shown `~N`).
+     *  Absent for a fixed price, and under the tier-pricing rollback. A metered
+     *  LLM node whose default model has no price yet lists `creditCost:
+     *  "unpriced"` (a run on it is refused `llm_model_unpriced`). */
+    estimate?: true;
     /** A node charged per unit of its own measure (its `creditCost` is a word
      *  such as `"per-1000-frames"`): the charged price of one unit and how a run
      *  rounds. Cloud only, like `creditCost`. */
@@ -1016,6 +1022,10 @@ interface TextToVideoParams extends StructuredReferenceParams, ReferenceCaptionP
      *  { provider: "seedance-2-5-hd", sourceJobId })`: the same take, frame for
      *  frame, at 1080p. Drafts are kept about 7 days. */
     draft?: boolean;
+    /** Absent / `true`: a copyright refusal is retried once with a reworded
+     *  prompt. `false` = a copyright refusal fails the job instead of retrying
+     *  once with a reworded prompt. */
+    contentPolicyRewrite?: boolean;
     [k: string]: unknown;
 }
 /**
@@ -1175,7 +1185,9 @@ interface RunAndWaitOptions {
     readonly signal?: AbortSignal;
     /**
      * Also cancel the job when `signal` aborts after it was submitted
-     * (`POST /v1/jobs/:id/cancel`, which refunds its credit hold). Best effort:
+     * (`POST /v1/jobs/:id/cancel`, which refunds its credit hold — except a
+     * metered LLM job whose call has started: it answers `inFlight: true`,
+     * finishes, and is charged what it used). Best effort:
      * a failed cancel still rejects with the {@link JobAbortedError}. Default
      * `false` — aborting only stops waiting.
      */

package/dist/{studio-productions-vbCNSbtf.d.ts → studio-productions-DtTE8mdl.d.ts}

@@ -145,6 +145,23 @@ interface StudioOpsImpact {
     /** Shots bound to any of those frames. */
     shotIds: string[];
 }
+/**
+ * A sentence as data: the id of the template a client words it from, and the
+ * values that fill the template's slots.
+ *
+ * It travels beside the English wording, never instead of it. A client that
+ * words the sentence in the person's language builds it from `template` and
+ * `vars`, and shows the English wording whenever it has no wording for
+ * `template` or `vars` does not fill it — so a template id it has never heard of
+ * costs nothing. A template id is permanent: a change to its slots or its
+ * meaning ships as a new id.
+ */
+interface StudioOpsText {
+    /** The template's id. */
+    template: string;
+    /** What fills the template's slots, by slot name. */
+    vars: Record<string, string | number>;
+}
 /**
  * One line of what an operation did, in the words a change log would use.
  *
@@ -156,6 +173,13 @@ interface StudioOpsReceipt {
     op: string;
     /** Past tense, naming the target the way a person would. */
     summary: string;
+    /**
+     * `summary` as data, for a client that words receipts in the person's
+     * language. `summary` is always present and always English; read `detail`
+     * only when you have wording for its template, and show `summary` when you do
+     * not. Absent when the studio service that answered predates it.
+     */
+    detail?: StudioOpsText;
     /** Ids the operation MINTED — never ids the caller supplied. */
     ids?: string[];
     /**
@@ -181,6 +205,14 @@ interface StudioOpsResponse {
      * batch; a refusal does.
      */
     warnings: string[];
+    /**
+     * `warnings` as data, by position: entry `i` words `warnings[i]`, and `null`
+     * means that warning has no wording but the English one. The service sends it
+     * only when it is exactly as long as `warnings`, so treat a list of any other
+     * length as absent. Absent too when the studio service that answered predates
+     * it.
+     */
+    warningDetails?: Array<StudioOpsText | null>;
 }
 /**
  * An operation's confirmation class — the vocabulary's own four letters.
@@ -229,6 +261,8 @@ interface StudioOpsDryRunResponse {
     receipts: StudioOpsDryRunReceipt[];
     /** The same things an apply would have said. */
     warnings: string[];
+    /** The same data behind them an apply would have sent: see {@link StudioOpsResponse.warningDetails}. */
+    warningDetails?: Array<StudioOpsText | null>;
 }
 /** What landing the finished jobs did. */
 interface StudioReconcileResponse {
@@ -569,4 +603,4 @@ declare class StudioProductionsResource {
     clone(productionId: string, input?: StudioCloneRequest): Promise<StudioProduction>;
 }
 
-export { type StudioProductionDetail as A, type StudioProductionResponse as B, StudioProductionsResource as C, type StudioReconcileResponse as D, type StudioRevoiceRequest as E, type StudioSkillResponse as F, type GetProductionOptions as G, type StudioValidatePlanResponse as H, type StudioVideoLane as I, type StudioVoiceRequest as J, isStudioGenerateEstimate as K, type ListStudioProductionsOptions as L, type StudioClientRequestId as S, type StudioCloneRequest as a, type StudioCreateProductionRequest as b, type StudioDescribeRequest as c, type StudioExportPlanOptions as d, type StudioExportPlanResponse as e, type StudioExportStep as f, type StudioFrameRequest as g, type StudioGenerateEstimate as h, type StudioGenerateOptions as i, type StudioGenerateRequest as j, type StudioGenerateResponse as k, type StudioGenerateResult as l, type StudioImportSummary as m, type StudioJobStartedResponse as n, type StudioListProductionsResponse as o, type StudioMediaResponse as p, type StudioMusicRequest as q, type StudioOpClass as r, type StudioOpsDryRunReceipt as s, type StudioOpsDryRunResponse as t, type StudioOpsImpact as u, type StudioOpsReceipt as v, type StudioOpsRequest as w, type StudioOpsResponse as x, type StudioPlanIssue as y, type StudioProduction as z };
+export { type StudioProduction as A, type StudioProductionDetail as B, type StudioProductionResponse as C, StudioProductionsResource as D, type StudioReconcileResponse as E, type StudioRevoiceRequest as F, type GetProductionOptions as G, type StudioSkillResponse as H, type StudioValidatePlanResponse as I, type StudioVideoLane as J, type StudioVoiceRequest as K, type ListStudioProductionsOptions as L, isStudioGenerateEstimate as M, type StudioClientRequestId as S, type StudioCloneRequest as a, type StudioCreateProductionRequest as b, type StudioDescribeRequest as c, type StudioExportPlanOptions as d, type StudioExportPlanResponse as e, type StudioExportStep as f, type StudioFrameRequest as g, type StudioGenerateEstimate as h, type StudioGenerateOptions as i, type StudioGenerateRequest as j, type StudioGenerateResponse as k, type StudioGenerateResult as l, type StudioImportSummary as m, type StudioJobStartedResponse as n, type StudioListProductionsResponse as o, type StudioMediaResponse as p, type StudioMusicRequest as q, type StudioOpClass as r, type StudioOpsDryRunReceipt as s, type StudioOpsDryRunResponse as t, type StudioOpsImpact as u, type StudioOpsReceipt as v, type StudioOpsRequest as w, type StudioOpsResponse as x, type StudioOpsText as y, type StudioPlanIssue as z };

package/dist/{studio-productions-DUHvdSvk.d.cts → studio-productions-r2-VZsKj.d.cts}

@@ -145,6 +145,23 @@ interface StudioOpsImpact {
     /** Shots bound to any of those frames. */
     shotIds: string[];
 }
+/**
+ * A sentence as data: the id of the template a client words it from, and the
+ * values that fill the template's slots.
+ *
+ * It travels beside the English wording, never instead of it. A client that
+ * words the sentence in the person's language builds it from `template` and
+ * `vars`, and shows the English wording whenever it has no wording for
+ * `template` or `vars` does not fill it — so a template id it has never heard of
+ * costs nothing. A template id is permanent: a change to its slots or its
+ * meaning ships as a new id.
+ */
+interface StudioOpsText {
+    /** The template's id. */
+    template: string;
+    /** What fills the template's slots, by slot name. */
+    vars: Record<string, string | number>;
+}
 /**
  * One line of what an operation did, in the words a change log would use.
  *
@@ -156,6 +173,13 @@ interface StudioOpsReceipt {
     op: string;
     /** Past tense, naming the target the way a person would. */
     summary: string;
+    /**
+     * `summary` as data, for a client that words receipts in the person's
+     * language. `summary` is always present and always English; read `detail`
+     * only when you have wording for its template, and show `summary` when you do
+     * not. Absent when the studio service that answered predates it.
+     */
+    detail?: StudioOpsText;
     /** Ids the operation MINTED — never ids the caller supplied. */
     ids?: string[];
     /**
@@ -181,6 +205,14 @@ interface StudioOpsResponse {
      * batch; a refusal does.
      */
     warnings: string[];
+    /**
+     * `warnings` as data, by position: entry `i` words `warnings[i]`, and `null`
+     * means that warning has no wording but the English one. The service sends it
+     * only when it is exactly as long as `warnings`, so treat a list of any other
+     * length as absent. Absent too when the studio service that answered predates
+     * it.
+     */
+    warningDetails?: Array<StudioOpsText | null>;
 }
 /**
  * An operation's confirmation class — the vocabulary's own four letters.
@@ -229,6 +261,8 @@ interface StudioOpsDryRunResponse {
     receipts: StudioOpsDryRunReceipt[];
     /** The same things an apply would have said. */
     warnings: string[];
+    /** The same data behind them an apply would have sent: see {@link StudioOpsResponse.warningDetails}. */
+    warningDetails?: Array<StudioOpsText | null>;
 }
 /** What landing the finished jobs did. */
 interface StudioReconcileResponse {
@@ -569,4 +603,4 @@ declare class StudioProductionsResource {
     clone(productionId: string, input?: StudioCloneRequest): Promise<StudioProduction>;
 }
 
-export { type StudioProductionDetail as A, type StudioProductionResponse as B, StudioProductionsResource as C, type StudioReconcileResponse as D, type StudioRevoiceRequest as E, type StudioSkillResponse as F, type GetProductionOptions as G, type StudioValidatePlanResponse as H, type StudioVideoLane as I, type StudioVoiceRequest as J, isStudioGenerateEstimate as K, type ListStudioProductionsOptions as L, type StudioClientRequestId as S, type StudioCloneRequest as a, type StudioCreateProductionRequest as b, type StudioDescribeRequest as c, type StudioExportPlanOptions as d, type StudioExportPlanResponse as e, type StudioExportStep as f, type StudioFrameRequest as g, type StudioGenerateEstimate as h, type StudioGenerateOptions as i, type StudioGenerateRequest as j, type StudioGenerateResponse as k, type StudioGenerateResult as l, type StudioImportSummary as m, type StudioJobStartedResponse as n, type StudioListProductionsResponse as o, type StudioMediaResponse as p, type StudioMusicRequest as q, type StudioOpClass as r, type StudioOpsDryRunReceipt as s, type StudioOpsDryRunResponse as t, type StudioOpsImpact as u, type StudioOpsReceipt as v, type StudioOpsRequest as w, type StudioOpsResponse as x, type StudioPlanIssue as y, type StudioProduction as z };
+export { type StudioProduction as A, type StudioProductionDetail as B, type StudioProductionResponse as C, StudioProductionsResource as D, type StudioReconcileResponse as E, type StudioRevoiceRequest as F, type GetProductionOptions as G, type StudioSkillResponse as H, type StudioValidatePlanResponse as I, type StudioVideoLane as J, type StudioVoiceRequest as K, type ListStudioProductionsOptions as L, isStudioGenerateEstimate as M, type StudioClientRequestId as S, type StudioCloneRequest as a, type StudioCreateProductionRequest as b, type StudioDescribeRequest as c, type StudioExportPlanOptions as d, type StudioExportPlanResponse as e, type StudioExportStep as f, type StudioFrameRequest as g, type StudioGenerateEstimate as h, type StudioGenerateOptions as i, type StudioGenerateRequest as j, type StudioGenerateResponse as k, type StudioGenerateResult as l, type StudioImportSummary as m, type StudioJobStartedResponse as n, type StudioListProductionsResponse as o, type StudioMediaResponse as p, type StudioMusicRequest as q, type StudioOpClass as r, type StudioOpsDryRunReceipt as s, type StudioOpsDryRunResponse as t, type StudioOpsImpact as u, type StudioOpsReceipt as v, type StudioOpsRequest as w, type StudioOpsResponse as x, type StudioOpsText as y, type StudioPlanIssue as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/sdk",
-  "version": "2.34.0",
+  "version": "2.39.0",
   "description": "Typed REST client for the Nodaro API — workflows, jobs, executions, apps, characters, and more.",
   "type": "module",
   "license": "Apache-2.0",
@@ -240,6 +240,11 @@
       "import": "./dist/entries/templates.js",
       "require": "./dist/entries/templates.cjs"
     },
+    "./trends": {
+      "types": "./dist/entries/trends.d.ts",
+      "import": "./dist/entries/trends.js",
+      "require": "./dist/entries/trends.cjs"
+    },
     "./tutorials": {
       "types": "./dist/entries/tutorials.d.ts",
       "import": "./dist/entries/tutorials.js",
@@ -302,7 +307,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@nodaro/shared": "^3.37.0",
+    "@nodaro/shared": "^3.39.0",
     "@nodaro/prompts": "^1.40.0"
   },
   "peerDependencies": {

package/dist/chunk-3QBH2VE2.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/jobs.ts"],"names":[],"mappings":";;;AAgMA,SAAS,UAAU,KAAA,EAAmE;AACpF,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,CAAM,KAAK,GAAG,CAAA;AAC3D;AAgCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAA,CAAK,MAAA,GAAyB,EAAC,EAA0B;AACvD,IAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAM,GAAG,MAAK,GAAI,MAAA;AAClC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,KAAA,EAAO,UAAA,EAAY;AAAA,MAC1D,KAAA,EAAO,EAAE,GAAG,IAAA,EAAM,MAAA,EAAQ,SAAA,CAAU,MAAM,CAAA,EAAG,IAAA,EAAM,SAAA,CAAU,IAAI,CAAA;AAAE,KACpE,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CAAK,IAAY,MAAA,EAAkD;AACjE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MAC5F,IAAA,EAAM,EAAE,MAAA;AAAO,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAAgD;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KACpC;AAAA,EACF;AACF","file":"chunk-3QBH2VE2.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the\n * platform's `backend/src/lib/job-status.ts` — nothing links the two at build\n * time, so a new member has to be added here in the same change.\n *\n * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the\n * deployment held the output for a human reviewer. Treat it like `processing`\n * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`\n * (approved), `failed` (rejected, carrying an `error_hint` with\n * `kind: \"policy-block\"`) or `cancelled` (a held job is cancellable like any\n * in-flight job). `credit_status` reads `\"reserved\"` for the whole hold. Only\n * appears on deployments that register a job policy; `runAndWait` throws\n * {@link JobHeldError} on the first held tick rather than waiting it out.\n */\nexport type JobStatus =\n  | \"pending\"\n  | \"queued\"\n  | \"processing\"\n  | \"pending_review\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n\n/**\n * A PROVIDER's verdict: the model's own safety filter refused the output.\n * `class` distinguishes a deterministic block (copyright/likeness — retrying\n * the same request never helps) from `safety`, whose filter is known to be\n * non-deterministic for some models: `retried` says whether the worker\n * already spent its one extra attempt, and `suggestedProvider` — present\n * only when the catalog declares a fallback for the model that failed — is a\n * real model id the SAME prompt/references can be retried on.\n */\nexport type SafetyBlockHint = {\n  kind: \"safety-block\"\n  class: \"copyright\" | \"likeness\" | \"safety\"\n  retried: boolean\n  suggestedProvider?: string\n}\n\n/**\n * A NODARO-side verdict, not a provider's: a job policy registered by the\n * deployment rejected the request (`hookPoint: \"request\"` — nothing ran, and\n * the call itself failed with {@link JobBlockedError}) or the finished output\n * (`hookPoint: \"result\"` — the result was blocked and never published).\n *\n * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's\n * machine text (scores, labels) never reaches it — so show it to the person\n * who made the request as-is. `policyId` identifies the deployment's policy,\n * not a Nodaro product feature. Only occurs on deployments that register a\n * job policy.\n */\nexport type PolicyBlockHint = {\n  kind: \"policy-block\"\n  policyId: string\n  reason: string\n  hookPoint: \"request\" | \"result\"\n}\n\n/**\n * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable\n * failure verdict, so a caller can act on it without parsing `error_message`\n * prose. One column, two verdict sources; `kind` is the discriminant.\n *\n * HAND-COPIED MIRROR of `ErrorHint` in the platform's\n * `backend/src/lib/safety-block.ts` (which names this file in its own\n * comment). Nothing links the two at build time: a new arm there has to be\n * pasted here verbatim in the same change, with a changeset.\n * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.\n */\nexport type JobErrorHint = SafetyBlockHint | PolicyBlockHint\n\n/**\n * The billing lifecycle of a job's credit reservation — `usage_logs.status`\n * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a\n * free run) or hasn't reserved credits yet.\n */\nexport type CreditStatus = \"reserved\" | \"committed\" | \"refunded\"\n\n/** A job owner's rating of their job — set with {@link JobsResource.rate}. */\nexport type JobRating = \"good\" | \"bad\"\n\n/**\n * The `rating` filter of {@link JobsResource.list}: one rating, any rating\n * (`\"rated\"`) or none (`\"unrated\"`).\n */\nexport type JobRatingFilter = JobRating | \"rated\" | \"unrated\"\n\n/**\n * Job record returned to non-admin SDK consumers. Field names are snake_case\n * to match the wire format (per the OpenAPI fix in Phase 1).\n *\n * Sensitive fields stripped server-side for non-admin callers:\n * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD\n * pricing is admin-only across api/sdk/mcp — non-admin consumers see\n * only the `credits` abstraction. Server-only nested job data (including\n * Recast's private remux base) is stripped for every caller, including admins.\n */\nexport interface Job {\n  id: string\n  status: JobStatus\n  progress: number\n  user_id: string\n  input_data: unknown\n  output_data: unknown\n  error_message: string | null\n  /** Present on a failed job the worker classified as a provider\n   *  content-policy block (`kind: \"safety-block\"`) or that a deployment's job\n   *  policy rejected (`kind: \"policy-block\"`); absent/null otherwise.\n   *  User-safe by construction — narrow on `kind` before reading the rest. */\n  error_hint?: JobErrorHint | null\n  /** PR9: the job's credit reservation lifecycle, derived server-side from\n   *  `usage_logs.status`. `null` when there is no usage log to report. Never\n   *  changes the meaning of `credits` (the reserved amount) below. */\n  credit_status?: CreditStatus | null\n  /** The credits HELD when the job was accepted. Never changes — a job can\n   *  settle below it; read {@link Job.credits_charged} for what it cost. */\n  credits: number | null\n  /**\n   * What the job actually cost once its hold settled. Can be lower than\n   * `credits` (the unused part goes back to the balance), `0` when the hold was\n   * refunded, `null` while the job is still running or when it reserved\n   * nothing of its own. Sum this — not `credits` — to total spend. Returned by\n   * `get()` and `list()`.\n   */\n  credits_charged?: number | null\n  job_type: string | null\n  created_at: string\n  started_at: string | null\n  completed_at: string | null\n  /**\n   * Provenance: which kind of caller created the job — one of\n   * `\"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"`.\n   * `source_detail` narrows it (origin host, `extension/<name>` label,\n   * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;\n   * lets a library view label or filter media by origin.\n   */\n  source?: string | null\n  source_detail?: string | null\n  /** The generation session this job was born in (the `sessionId` sent with\n   *  the generation request), or null. See `client.sessions`. */\n  session_id?: string | null\n  /**\n   * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).\n   * Returned by `get()` and `list()`. Absent from an older server, and when\n   * the server could not read it for a moment — treat absent as unknown,\n   * never as `false`.\n   */\n  favorited?: boolean\n  /**\n   * The owner's rating of the job ({@link JobsResource.rate}), or `null` when\n   * unrated. Returned by `get()` and `list()`; absent like `favorited`.\n   */\n  rating?: JobRating | null\n}\n\nexport interface CancelJobResult {\n  success: true\n  cancelled: number\n}\n\nexport interface DeleteJobResult {\n  success: true\n}\n\nexport interface ListJobsParams {\n  /** One status or several (a job matching any of them). An unknown status is a 400. */\n  status?: JobStatus | readonly JobStatus[]\n  /** Exact match on `input_data.type` — the route that created the job\n   *  (`\"llm-structured\"`, `\"video-analysis\"`, …). One value or several (up to 20). */\n  type?: string | readonly string[]\n  /** Exact match on `input_data.origin` — the client app that sent it. */\n  origin?: string\n  /** `true`: only jobs you favorited; `false`: only jobs you did not. */\n  favorited?: boolean\n  /** Your rating: `\"good\"`, `\"bad\"`, any (`\"rated\"`) or none (`\"unrated\"`). */\n  rating?: JobRatingFilter\n  /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */\n  batchId?: string\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `next`. */\n  cursor?: string\n}\n\n/** What {@link JobsResource.rate} answers: the job's rating now. */\nexport interface RateJobResult {\n  data: { jobId: string; rating: JobRating | null }\n}\n\n/** A list filter value as the query string carries it: several are comma-separated. */\nfunction listParam(value: string | readonly string[] | undefined): string | undefined {\n  if (value === undefined) return undefined\n  return typeof value === \"string\" ? value : value.join(\",\")\n}\n\nexport interface ListJobsPage {\n  /**\n   * A page may hold fewer than `limit` rows — even none — and still carry a\n   * `next`. Page on `next`, never on `data.length`.\n   */\n  data: Job[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\n/**\n * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the\n * `input_data` JSONB and cost columns. Its `output_data` still goes\n * through the server-only nested-field redaction. Intended for poll loops that\n * only need progress/output/error, and when the job finished.\n */\nexport interface JobStatusResult {\n  id: string\n  status: JobStatus\n  progress?: number\n  output_data?: unknown\n  error_message?: string | null\n  /** PR9: see {@link Job.error_hint}. */\n  error_hint?: JobErrorHint | null\n  /** PR9: see {@link Job.credit_status}. */\n  credit_status?: CreditStatus | null\n  /** When the job finished, on the server's clock; null until it has. */\n  completed_at?: string | null\n}\n\nexport class JobsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Get a single job by ID. */\n  get(id: string): Promise<{ data: Job }> {\n    return this.client.request(\"GET\", `/v1/jobs/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and\n   * `origin` filter on the job's own `input_data`, which every job carries —\n   * a client app lists its runs with `{ type: \"llm-structured\", origin: \"studio\" }`.\n   * `status` and `type` take one value or a list; `favorited` and `rating`\n   * filter on your own marks. Every filter combines with AND, and each job\n   * carries `favorited` and `rating`.\n   */\n  list(params: ListJobsParams = {}): Promise<ListJobsPage> {\n    const { status, type, ...rest } = params\n    return this.client.request<ListJobsPage>(\"GET\", \"/v1/jobs\", {\n      query: { ...rest, status: listParam(status), type: listParam(type) },\n    })\n  }\n\n  /**\n   * Rate one of your jobs `\"good\"` or `\"bad\"`, or clear the rating with\n   * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone\n   * else's job is a `NotFoundError`. The rating reads back as `Job.rating`\n   * and filters {@link list}. OAuth apps need the `assets:write` scope.\n   */\n  rate(id: string, rating: JobRating | null): Promise<RateJobResult> {\n    return this.client.request<RateJobResult>(\"PUT\", `/v1/jobs/${encodeURIComponent(id)}/rating`, {\n      body: { rating },\n    })\n  }\n\n  /**\n   * Get the lean status of a single job (poll-loop friendly).\n   * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/\n   * output_data/error_message, with far less wire/CPU cost than `get()`.\n   * Same auth + ownership semantics as {@link get}.\n   */\n  getStatus(id: string): Promise<{ data: JobStatusResult }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/jobs/${encodeURIComponent(id)}/status`,\n    )\n  }\n\n  /**\n   * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.\n   * Refunds any reserved credit holds.\n   */\n  cancel(id: string): Promise<CancelJobResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/jobs/${encodeURIComponent(id)}/cancel`,\n    )\n  }\n\n  /**\n   * Delete a job and the private media it produced. Server route is\n   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;\n   * a job that is still running is deleted as-is — cancel it first when its\n   * worker should stop ({@link cancel}).\n   */\n  delete(id: string): Promise<DeleteJobResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/jobs/${encodeURIComponent(id)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-4CXB7RA6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";AAmLA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,MAAM,OAAA,GAAgC;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,KAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,OAAA,GAAqC,EAAC,EAAoC;AACrF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,KAAA,EAAO,0BAAA,EAA4B;AAAA,MACpF,OAAO,EAAE,KAAA,EAAO,QAAQ,KAAA,EAAO,MAAA,EAAQ,QAAQ,MAAA;AAAO,KACvD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAW,GAAA,EAA0C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,yBAAA,EAA2B;AAAA,MAC9E,MAAM,EAAE,MAAA,EAAQ,IAAI,KAAA,CAAM,CAAA,EAAG,iBAAiB,CAAA;AAAE,KACjD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,gBAAA,CAAiB,IAAA,GAAmB,EAAC,EAAoC;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAA,EAAkC;AAAA,MAC3F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,iBAAA,CAAkB,KAAA,GAAgC,EAAC,EAAqC;AACtF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MAC7F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,oBAAA,GAAwD;AACtD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAgC,CAAA;AAAA,EAC7F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASF","file":"chunk-4CXB7RA6.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s\n * `data` field. Mirrors the canonical `UserBalance` from the backend billing\n * module (`backend/src/ee/billing/credits.ts`), the source of truth: keep this\n * in sync if that interface changes.\n */\nexport interface UserBalance {\n  total: number\n  subscription: number\n  topup: number\n  dailySpent: number\n  dailyLimit: number | null\n  monthlyAllocation: number\n  /** Stored billing tier. Display should prefer `effectiveTier`. */\n  tier: string\n  /** Derived entitlement tier: \"payg\" when stored-free with purchased credits. */\n  effectiveTier: string\n  features: Record<string, unknown>\n  periodEnd: string | null\n  /** Credits earned for app usage (free tier only — earned by running flows). */\n  appCreditsAllowance: number\n  /** Present when a deployment uses an external shared wallet. Raw credits;\n   * null means unavailable. Do not substitute the personal `total` balance. */\n  externalWallet?: { available: number | null }\n  /**\n   * Where the account's free signup grant stands. `\"withheld\"` means the\n   * account works but the grant did not land — show the activation path.\n   * Absent where the deployment has no signup grant.\n   */\n  freeGrantState?: FreeGrantState\n  /**\n   * Present only with `freeGrantState: \"withheld\"`, when the claim showed no\n   * browser signals at all: the app may say \"free credits need a regular\n   * browser — reload\", because a reload in one judges the account again.\n   */\n  freeGrantNotice?: \"browser_unmeasured\"\n  /**\n   * The welcome-credits opt-in. PRESENT only while the deployment has the\n   * offer switched on — absent means \"no popup, no banner, no block\".\n   */\n  welcomeOffer?: WelcomeOfferState\n}\n\n/** Where an account's free signup grant stands. */\nexport type FreeGrantState = \"unclaimed\" | \"granted\" | \"withheld\" | \"revoked\"\n\n/** `UserBalance.welcomeOffer` — what an app needs to show the welcome offer. */\nexport interface WelcomeOfferState {\n  /** The one-time popup was already shown (see `markWelcomeOfferSeen`). */\n  popupSeen: boolean\n  /**\n   * The account already has its credits (granted elsewhere) but still owes\n   * the email consent: the web apps block creation until it is given — the\n   * claim records it.\n   */\n  consentPending: boolean\n  /** The credits a claim grants. Name this figure in the offer; never hard-code it. */\n  credits: number\n}\n\n/** What `claimWelcomeOffer` sends: the browser signals plus the app answering. */\nexport interface WelcomeOfferClaimInput extends SignupKeys {\n  /**\n   * The answering app's slug (lowercase letters, digits and `-`, up to 40\n   * characters), recorded with the consent. A value outside that grammar is\n   * stored as absent, never refused.\n   */\n  sourceApp?: string\n  /**\n   * The interface language the user answered in — the id of a language Nodaro\n   * ships, such as `\"en\"`, `\"ja\"` or `\"pt-BR\"`. Matched exactly and\n   * case-sensitively: `\"en-US\"` or `\"pt-br\"` is stored as absent, never refused.\n   * Recorded with the consent as the language of the LATEST consent: a later\n   * \"yes\" in another language replaces it.\n   */\n  locale?: string\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/claim`. */\nexport interface WelcomeOfferClaimResult {\n  /** The email consent is recorded. */\n  consent: \"granted\"\n  /** Where the free grant stands after the claim — `\"withheld\"` when the abuse gate refused it. */\n  grant: FreeGrantState\n  /** The grant's figure. A grant tops the subscription credits UP TO it (it is not added on top), so a claim that lands it leaves the subscription credits at no less than this. */\n  credits: number\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/seen`. */\nexport interface WelcomeOfferSeenResult {\n  ok: true\n}\n\n/**\n * Result of `POST /v1/credits/model-costs` — a batch cost lookup for editor\n * cost previews. `data` maps each priced identifier → its credit cost.\n *\n * Per-model fault isolation (the route runs the lookups under\n * `Promise.allSettled`): identifiers with no pricing row are reported in\n * `missing` (undisplayable until an operator seeds a price) and lookup\n * failures in `errors`, instead of failing the whole batch. Callers typically\n * render `'—'` for any identifier that lands in `missing`. The hard-fail\n * policy still triggers at reservation time when the user actually runs the\n * node — this preview lookup is intentionally lenient.\n */\nexport interface ModelCostsResult {\n  data: Record<string, number>\n  missing: string[]\n  errors: string[]\n}\n\n/**\n * The two browser signals a claim reports — SHA-256 hex digests computed by\n * `@nodaro/sdk/signup-signals` (`collectSignupKeys`). Either may be absent:\n * a browser that cannot be measured still claims, and the server treats the\n * absence as what it is. Any other value is stored as absent server-side.\n */\nexport interface SignupKeys {\n  browserKey?: string\n  deviceKey?: string\n}\n\n/** The answer of `POST /v1/credits/claim-signup-grant`. */\nexport interface SignupGrantClaimResult {\n  /** Where the account's free grant stands after this call. */\n  state: FreeGrantState\n  /** True only when THIS call moved the credits — a repeat is `false` with the same state. */\n  granted: boolean\n}\n\n/**\n * One row of `GET /v1/credits/transactions` — a run's reservation and how it\n * settled.\n *\n * Which amount to read: a run first HOLDS credits and is then settled — charged\n * all or part of the hold, the rest returned. `credits_charged` is what the run\n * cost (`null` while the hold is still open, `0` once refunded); sum it for\n * spend. `credits_reserved` is the hold, which never changes. `credits_used`\n * is the same hold under its original name, kept for existing integrations.\n */\nexport interface CreditTransaction {\n  id: string\n  /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */\n  created_at: string\n  /** Settled charge; `null` while `status` is `\"reserved\"`, `0` when refunded. */\n  credits_charged: number | null\n  /** The hold taken when the run was accepted. */\n  credits_reserved: number | null\n  /** The hold, under its original name. Prefer `credits_charged`. */\n  credits_used: number | null\n  /** The model or operation the credits were for. */\n  action: string | null\n  provider: string | null\n  /** Reservation lifecycle: `\"reserved\"`, `\"committed\"` or `\"refunded\"`. */\n  status: string | null\n  /** The caller's own billing details for the run (model, which pool paid, …). */\n  metadata: Record<string, unknown>\n  /** `\"workspace\"` when a class or team budget paid, not your balance. */\n  payer: \"user\" | \"workspace\"\n  workspaceId: string | null\n}\n\n/** A page of {@link CreditTransaction}s, newest first. */\nexport interface CreditTransactionsPage {\n  data: CreditTransaction[]\n  /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n  nextCursor: string | null\n}\n\nexport interface CreditTransactionsOptions {\n  /** Rows per page, 1–50 (server default 20). */\n  limit?: number\n  /** The `nextCursor` of the previous page. */\n  cursor?: string\n}\n\n/** Max identifiers per `model-costs` batch — the route caps the request at 50. */\nconst MODEL_COSTS_LIMIT = 50\n\nexport class CreditsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/user/credits` → the authenticated user's credit balance and tier\n   * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's\n   * other typed errors on the usual statuses.\n   */\n  async balance(): Promise<UserBalance> {\n    const res = await this.client.request<{ data: UserBalance }>(\n      \"GET\",\n      \"/v1/user/credits\",\n    )\n    return res.data\n  }\n\n  /**\n   * `GET /v1/credits/transactions` → one page of the caller's credit\n   * transactions, newest first, with `nextCursor` for the next page (`null`\n   * at the end). Read `credits_charged` for what each run cost — it can be\n   * below the hold (`credits_reserved`) and is `null` while the hold is open.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  transactions(options: CreditTransactionsOptions = {}): Promise<CreditTransactionsPage> {\n    return this.client.request<CreditTransactionsPage>(\"GET\", \"/v1/credits/transactions\", {\n      query: { limit: options.limit, cursor: options.cursor },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor\n   * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers\n   * (the route's request limit). Preserves the `{ data, missing, errors }`\n   * fault-isolation shape verbatim (see {@link ModelCostsResult}).\n   */\n  modelCosts(ids: string[]): Promise<ModelCostsResult> {\n    return this.client.request<ModelCostsResult>(\"POST\", \"/v1/credits/model-costs\", {\n      body: { models: ids.slice(0, MODEL_COSTS_LIMIT) },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup\n   * grant, once, with the browser signals of the page making the claim.\n   *\n   * Call it once per page load as soon as the session is known, and never\n   * wait on it for rendering: it is idempotent (a decided account answers\n   * with its state and `granted: false`), it costs the user nothing when it\n   * fails (the next load asks again), and the signals are what make the\n   * claim worth sending — collect them with `collectSignupKeys()` from\n   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  claimSignupGrant(keys: SignupKeys = {}): Promise<SignupGrantClaimResult> {\n    return this.client.request<SignupGrantClaimResult>(\"POST\", \"/v1/credits/claim-signup-grant\", {\n      body: keys,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/claim` → the user's \"yes\" to the welcome\n   * offer, as ONE server action: the marketing-email consent is recorded,\n   * then the free signup grant is claimed with that consent. The abuse gate\n   * still decides — consent is necessary, not sufficient — so read `grant`:\n   * `\"granted\"` (the grant has landed: this call topped the subscription credits up to `credits` — not added on top — or it had landed before), `\"withheld\"` (refused), `\"revoked\"` (taken back earlier; nothing moves), `\"unclaimed\"` (nothing moved — treat as a failure and let the user retry).\n   * Pass the browser signals from `collectSignupKeys()` and your app's slug.\n   *\n   * **Browser session only.** Usable from a first-party web app signed in\n   * with a Supabase session (the consent is a person's choice in a browser);\n   * an API key or OAuth app token is refused with 403. 409\n   * `welcome_offer_disabled` while the deployment has the offer off — show\n   * it only when `balance().welcomeOffer` is present. Cloud-only route: a\n   * self-hosted instance answers 404.\n   */\n  claimWelcomeOffer(input: WelcomeOfferClaimInput = {}): Promise<WelcomeOfferClaimResult> {\n    return this.client.request<WelcomeOfferClaimResult>(\"POST\", \"/v1/credits/welcome-offer/claim\", {\n      body: input,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome\n   * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every\n   * app. Idempotent (the first stamp wins); a failed call only means the popup\n   * may show once more, so callers usually ignore errors.\n   *\n   * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API\n   * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is\n   * off, 404 on a self-hosted instance.\n   */\n  markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult> {\n    return this.client.request<WelcomeOfferSeenResult>(\"POST\", \"/v1/credits/welcome-offer/seen\")\n  }\n\n  // NOTE: no `estimate(...)` helper. The backend exposes\n  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {\n  // totalCredits, nodeCount } }`), but no consumer has a settled shape for it\n  // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than\n  // calling an estimate endpoint). Adding it now would be inventing an API\n  // surface ahead of a real caller, so it's deliberately omitted — add it when\n  // a consumer needs it, shaped to that need.\n}\n"]}

package/dist/chunk-4JKI6JRC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/nodes.ts"],"names":[],"mappings":"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","file":"chunk-4JKI6JRC.js","sourcesContent":["import type { GenerateScene3DParams, EditScene3DParams, RenderScene3DParams, Scene3DJobOutput, Pro3DRenderRunParams, Pro3DRenderJobOutput } from \"./scene3d-types.js\"\nimport type { ImageToImageParams, EditImageParams, SplitImageParams, SplitImageResult, GenerateMaskParams, GenerateMaskJobOutput, ImageJobStarted } from \"./nodes-image-params.js\"\nimport type { VideoToVideoParams, NodeQuote } from \"./nodes-video-params.js\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { JobStatusResult, JobsResource } from \"./jobs.js\"\nimport { JobAbortedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError } from \"../errors.js\"\nimport { NODE_RUN_ROUTES, NODE_TYPES_WITHOUT_RUN_ROUTE, nodeRunRoute } from \"@nodaro/shared/nodes\"\nimport {\n  SOCIAL_POST_NODE_PLATFORM,\n  type SocialPost,\n  type SocialPlatform,\n  type SocialSearchMode,\n  type SocialSearchParams\n} from \"@nodaro/shared/social\"\nimport type { ConnectedReference, DescribedReference } from \"@nodaro/shared/types\"\nimport type { VideoCharacterReference } from \"@nodaro/shared/video\"\nimport type { ModelInputAdjustment } from \"@nodaro/shared/model-catalog\"\nimport type { VideoDepthProvider, VideoDepthModelSize, VideoDepthColormap, VideoDepthResolution } from \"@nodaro/shared/media\"\nimport type { DirectionFields, SubjectFields } from \"@nodaro/prompts/prompt-builder\"\n\nexport type NodeCategory =\n  | \"input\"\n  | \"parameter\"\n  | \"ai-image\"\n  | \"ai-video\"\n  | \"ai-audio\"\n  | \"ai-text\"\n  | \"processing\"\n  | \"composition\"\n  | \"trigger\"\n  | \"output\"\n  | \"control\"\n  | \"entity\"\n  | \"utility\"\n\nexport type OutputType = \"text\" | \"image\" | \"video\" | \"audio\" | \"data\" | \"none\"\n\n/**\n * Field shape inside a node's `inputSchema.fields[]`. Mirrors\n * `backend/src/lib/node-registry.ts`.\n */\nexport interface NodeInputField {\n  key: string\n  type: string\n  required?: boolean\n  options?: string[]\n}\n\nexport interface NodeInputSchema {\n  fields: NodeInputField[]\n}\n\n/**\n * A per-unit price on a node descriptor. A run of N units is charged\n * `ceil(N × creditsPerUnit)`, rounded up once — so `GET /v1/credits/model-cost`\n * for `identifier` (one unit, rounded up: the least a run pays) times N can come\n * to more. `<identifier>:<N>u` is the exact price of N units; for a whole run\n * use `POST /v1/credits/estimate-workflow`.\n */\nexport interface NodeCreditRate {\n  /** The price id the rate is read from. */\n  identifier: string\n  /** What one unit is, as a token (`\"1000-frames\"`: one started block of 1,000 sampled frames). */\n  unit: string\n  /** The credits one unit adds to a run's total — exact, not rounded. */\n  creditsPerUnit: number\n  /** The fewest units a run is charged for. */\n  minUnits: number\n  /** `\"ceil-run-total\"`: the run's total is rounded up to a whole credit once, never per unit. */\n  rounding: \"ceil-run-total\"\n  /** The rule in words. */\n  note: string\n}\n\n/**\n * Node descriptor returned by `GET /v1/nodes` and `GET /v1/nodes/:type`.\n * Mirrors `backend/src/lib/node-registry.ts#NodeDescriptor`.\n */\nexport interface NodeDescriptor {\n  type: string\n  label: string\n  category: NodeCategory\n  description: string\n  outputType: OutputType\n  /** The credits a run is charged, the figure on the node's Run button.\n   *  Number when fixed, string range like \"10-80\" when model-dependent.\n   *  Undefined when the node is free — or on editions\n   *  without a credit system (community/business omit the field entirely;\n   *  it is meaningful on Cloud only). */\n  creditCost?: number | string\n  /** A node charged per unit of its own measure (its `creditCost` is a word\n   *  such as `\"per-1000-frames\"`): the charged price of one unit and how a run\n   *  rounds. Cloud only, like `creditCost`. */\n  creditRate?: NodeCreditRate\n  /** Input fields the node exposes for user override (subset of full config). */\n  inputSchema?: NodeInputSchema\n  /** For AI nodes: list of provider IDs supported. */\n  providers?: string[]\n  /** Capability flags such as \"supports-reference-image\" or \"supports-end-frame\". */\n  capabilities?: string[]\n  /** Hard duration ceiling in seconds (e.g. Generate Video Pro's env-configured cap). */\n  maxDurationSec?: number\n  /** Providers whose segment-duration menu is sparse (off-menu values snap to the nearest entry). */\n  sparseProviders?: string[]\n  /** Per-provider resolution tiers, e.g. `{ \"minimax-h3\": [\"2K\", \"768P\"] }`. */\n  providerResolutions?: Record<string, string[]>\n  /** Per-provider map of display resolution → the literal wire value the API expects. */\n  providerResolutionWire?: Record<string, Record<string, string>>\n  /** Generate Video Pro: the deployed engine accepts the `soundtrack` input (original-audio replay). */\n  soundtrack?: boolean\n}\n\n/**\n * Result of a direct node execution. Most node types return `{ jobId }` and\n * are processed asynchronously by a worker — the caller polls\n * `client.jobs.get(jobId)` until status is `completed`/`failed`.\n *\n * Some node types (`meta-ads-scrape`, for one) answer synchronously and\n * return their full result body. The shape is route-specific; consumers\n * should branch on the presence of `jobId`.\n */\n/**\n * One parameter the server corrected because the chosen model does not accept\n * the value you sent (e.g. `gpt-image-2` has no 3:2 aspect ratio). The run\n * proceeds with the corrected value rather than failing — this is how you find\n * out what it actually used.\n *\n * Re-exports `@nodaro/shared`'s `ModelInputAdjustment` — the same shape the\n * server's `normalizeModelInput` / `resolveNormalizedImageGen` populate — under\n * the SDK's naming convention, rather than declaring a second copy of the\n * fields.\n */\nexport type RunNodeAdjustment = ModelInputAdjustment\n\n/**\n * WHO is in the shot, as picker-catalog option ids — the `subject` field of\n * `generate-image` (and `text-to-video`). The platform writes the wording from\n * the ids you send; you never write prompt text for the subject. It composes\n * with `prompt`: the subject clauses are folded in right after your prompt and\n * ahead of any `direction`.\n *\n * A flat map of field → id(s):\n * - **Keys** are the platform's own picker field names — every Person field\n *   (`type`, `age`, `ethnicity`, `hairBase`, `lipState`, …), every Styling\n *   field (`makeup`, `jewelry`, `outerwear`, …), and the prop keys `heldProp`,\n *   `material` and `animal`. They and their ids come from the picker catalogs:\n *   `pickerCatalogs.get(\"person\")` / `get(\"styling\")` list each dimension's\n *   `field` with its `options[].id`; `get(\"held-prop\")`, `get(\"material\")` and\n *   `get(\"animal\")` write their `options[].id` to the catalog's `valueField`.\n * - **Values** are one id or a list of ids. Ids past a dimension's own cap are\n *   dropped, not rejected.\n * - **One number:** `customAge` (years, rounded and clamped to 0–120), read only\n *   when `age` is `\"age-custom\"`. A number on any other key does nothing.\n * - **Bounds** (without `presetId`): at most 128 keys, 64 characters per key,\n *   8 ids per key and 100 characters per id — a map over any of them is a 400\n *   `validation_error`. Unknown keys and unknown ids within them are skipped,\n *   and the job's `input_data.subject` records the ids that were used.\n * - **With `presetId`** your `subject` replaces the preset's own and is folded\n *   into the preset's prompt, as `direction` and `structured` are: an over-long\n *   key, id or list is dropped rather than rejected, and `input_data` does not\n *   record the subject.\n *\n * Same type as `@nodaro/prompts`' `SubjectFields`, under the SDK's name.\n */\nexport type Subject = SubjectFields\n\n/**\n * Something you asked for that the run did not send, with why — e.g.\n * `moodboard_images_not_sent`: some of a `moodboard:<id>` direction's images\n * did not fit the model's reference limit after your own references. The run\n * goes ahead; the same warnings are kept on the job's `input_data.warnings`.\n */\nexport interface RunNodeWarning {\n  code: string\n  message: string\n}\n\nexport type RunNodeResult =\n  | { jobId: string; usageLogId?: string; adjustments?: RunNodeAdjustment[]; warnings?: RunNodeWarning[]; [k: string]: unknown }\n  | Record<string, unknown>\n\n/**\n * Structured references — the editor's wired-reference shape — shared by\n * `generate-image` and `generate-video`. The route assembles them server-side\n * into per-ref `@image_N` directives and resolves `{image:N}` prompt tokens, so\n * a direct SDK run binds inline references exactly like the canvas. Pass the\n * same `ConnectedReference[]` the editor builds; the route dedupes + caps them\n * to the provider's image-reference limit.\n */\nexport interface StructuredReferenceParams {\n  /** Wired references assembled server-side (deduped + capped per provider). */\n  connectedReferences?: ConnectedReference[]\n  /**\n   * References you can NAME and DESCRIBE but have no media for — a cast role no\n   * entity is bound to yet, a character that exists only in the script. They\n   * carry no url, so nothing is attached and no `@image_N` seat is used: each\n   * becomes a `<Name> — <description>.` line, and a name left in the prompt\n   * prose reaches the model as a real, described subject. Up to 10.\n   */\n  describedReferences?: DescribedReference[]\n  /** Reorder the assembled reference list by stable ref ids; renumbers `@image_N`. */\n  referenceOrder?: string[]\n}\n\n/**\n * Captions for a node's video / audio rail references — INDEX-ALIGNED with\n * `referenceVideoUrls` / `referenceAudioUrls`, so `referenceVideoCaptions[0]`\n * describes `referenceVideoUrls[0]`. Each renders as `@video_N: <caption>.` /\n * `@audio_N: <caption>.` in the assembled prompt and is bounded by the number of\n * rail references that actually ship, so a caption can never bind a slot the\n * payload dropped. A blank entry is a hole in the alignment, not a line.\n */\nexport interface ReferenceCaptionParams {\n  referenceVideoCaptions?: string[]\n  referenceAudioCaptions?: string[]\n}\n\n/**\n * Typed request body for `nodes.run(\"text-to-speech\", …)` / `runAndWait`.\n * Common fields are typed; any other route field passes through.\n */\nexport interface TextToSpeechParams extends GenerationSessionParams {\n  text: string\n  /** A premade voice NAME (Rachel, George, …) or a library / custom voice id. */\n  voice?: string\n  voiceType?: \"premade\" | \"custom\" | \"library\"\n  /** `elevenlabs-v4` (the default), `elevenlabs-v3`, `elevenlabs-v4-turbo`, `elevenlabs-turbo`, `elevenlabs-multilingual`. */\n  provider?: string\n  stability?: number\n  similarityBoost?: number\n  style?: number\n  speed?: number\n  languageCode?: string\n  /**\n   * Continuity across clips: the line spoken just BEFORE this one in the finished piece\n   * (the previous clip's text). Context, not spoken — a model that stitches (v4, Turbo, Multilingual; not v3) carries the\n   * intonation across the cut; others ignore it. Up to 1,000 characters (a 400 above, on a model that stitches).\n   */\n  previousText?: string\n  /** The line spoken just AFTER this one. Same rule as `previousText`. */\n  nextText?: string\n  [k: string]: unknown\n}\n\n/**\n * Fields every job-creating request accepts beside its own params, on any\n * route: the platform stamps them on the job it creates. Typed on every\n * generation params type.\n */\nexport interface GenerationSessionParams {\n  /** A session from `client.sessions.create()` — the job is born in it and\n   *  shows in its feed. Must be one of yours (404 otherwise). */\n  sessionId?: string\n  /** Your app's slug (`create-image`, …): stored on the job, and what\n   *  `jobs.list({ origin })` filters on. Lowercase letters, digits, dashes. */\n  origin?: string\n}\n\n/**\n * Typed request body for `nodes.run(\"generate-image\", …)` / `runAndWait`.\n * Common fields are typed; any other route field passes through via the index\n * signature (the route Zod-validates the full body).\n *\n * `count` above 1 or `models` makes several jobs in one call: the answer is a\n * {@link GenerateImageBatchResult}, and {@link NodesResource.runBatchAndWait}\n * (not `runAndWait`) waits for it.\n */\nexport interface GenerateImageParams extends StructuredReferenceParams, GenerationSessionParams {\n  prompt?: string\n  /**\n   * Apply a node preset (a factory id like `\"generate-image/cinematic-still\"`, from\n   * `presets.listFactory(\"generate-image\")`, or one of yours) exactly as the editor does:\n   * its prompt and pre/post text, placeholder defaults, style, negative prompt and\n   * levers. Fields you pass override it; your `prompt` is wrapped in its pre/post text.\n   */\n  presetId?: string\n  /** Values for the preset's placeholders that have no default, e.g. `{ BRAND: \"Acme\" }`.\n   *  Without them such a preset answers 400 `preset_variables_required`, naming them. */\n  presetVariables?: Record<string, string>\n  /** The prompt as your user typed it, when `prompt` is a version your app\n   *  expanded (filled-in fields, resolved references). Stored on the job as\n   *  `input_data.userPrompt` to show what the user wrote; never sent to the\n   *  model. Defaults to `prompt`. */\n  userPrompt?: string\n  /** Pre & post text wrapped around `prompt` (a preset's words), joined the\n   *  same way every AI prompt node joins them. */\n  promptPrefix?: string\n  promptSuffix?: string\n  provider?: string\n  /** How many images to make, 1–4 — each its own job, one image each, under\n   *  its own Idempotency-Key (`<key>:<i>`). With `models`, per model. */\n  count?: number\n  /** 2–4 distinct image model ids: the same request runs on each, instead of\n   *  `provider`. models × count is at most 8. With `presetId`, the preset is\n   *  applied once per model. */\n  models?: string[]\n  /** With `count`, image i gets `seed + i` — one seed would draw the same image every time. */\n  seed?: number\n  /** Flat reference image URLs — appended after `connectedReferences`. */\n  referenceImageUrls?: string[]\n  negativePrompt?: string\n  /**\n   * Cinematic direction as catalog IDS — the route renders the wording. Two\n   * keys also take one of YOUR saved resources:\n   * - `colorLook: \"palette:<id>\"` (`paletteDirectionId(id)`) — the palette's\n   *   colours, each by an everyday name and its hex, go into the prompt;\n   * - `style: \"moodboard:<id>\"` (`moodboardDirectionId(id)`) — the moodboard's\n   *   description goes into the prompt and its images go to the model as style\n   *   references, after your own references and up to the model's reference\n   *   limit (the answer's `warnings` says when some did not fit). Its images\n   *   are references, so on models priced per reference the run costs what is\n   *   sent.\n   * A malformed one answers 400; one that is not yours (or was deleted) 404\n   * `direction_not_found`. The job keeps the id, so a re-run resolves it again.\n   * Not combinable with `presetId` yet (400 `validation_error`).\n   */\n  direction?: DirectionFields\n  /**\n   * WHO is in the shot — person, styling and props as picker-catalog ids\n   * ({@link Subject}). The platform writes the wording and folds it in after\n   * `prompt`, ahead of `direction`. With `presetId`, it replaces the preset's own\n   * and is folded into the preset's prompt (over-long values dropped, not 400).\n   */\n  subject?: Subject\n  /**\n   * The image to edit. Alone, the run is image-to-image on it (a text-to-image\n   * model runs as its image-to-image sibling); with `maskUrl`, an inpaint.\n   */\n  baseImageUrl?: string\n  /**\n   * Inpaint mask — white = the area to change, black = keep (what\n   * `generate-mask` writes). Needs a base: `baseImageUrl`, else the first\n   * `referenceImageUrls` entry. Works on EVERY image model: the result's masked\n   * area is composited back over the base, so everything outside the mask is\n   * the base's own pixels. On the models whose `IMAGE_MASK_MODE` is `\"prompt\"`\n   * (`@nodaro/shared`) the masked area's position is also described in the\n   * prompt; the rest rely on the composite alone. (A model that takes the mask\n   * itself is on `image-to-image` — `I2I_MASK_SUPPORT`.)\n   */\n  maskUrl?: string\n  /** 0–1: how far the result may move from the base (taken by the models in `I2I_STRENGTH_SUPPORT`). */\n  strength?: number\n  /** 0–20: prompt adherence (taken by the models in `GUIDANCE_SCALE_SUPPORT`). */\n  guidanceScale?: number\n  [k: string]: unknown\n}\n\n/** One model's share of a generate-image batch. */\nexport interface GenerateImageBatchGroup {\n  /** The model id as requested. */\n  model: string\n  jobIds: string[]\n  /** Credits held for this model's images; absent where nothing is charged. */\n  credits?: number\n  /** Parameters corrected for this model, as on a single call. */\n  adjustments?: RunNodeAdjustment[]\n  /** Something asked for that was not sent on this model (e.g. a moodboard past its reference limit), as on a single call. */\n  warnings?: RunNodeWarning[]\n}\n\n/**\n * What `nodes.run(\"generate-image\", …)` answers when `count` is above 1 or\n * `models` is set: every job, grouped by model. The whole batch was checked\n * against the balance and created, charged and queued together — or not at\n * all (`InsufficientCreditsError`'s `required` is then the batch's total).\n */\nexport interface GenerateImageBatchResult {\n  /** The first job — so code reading the single-image answer keeps working. */\n  jobId: string\n  /** Every job: model by model, then image by image. */\n  jobIds: string[]\n  /** On every job of the batch as `input_data.batchId`; `jobs.list({ batchId })` lists them. */\n  batchId: string\n  groups: GenerateImageBatchGroup[]\n  /** The groups' credits summed; absent where nothing is charged. */\n  totalCredits?: number\n  /** Every job already existed and this request charged nothing: a repeat of an earlier request with the same Idempotency-Key. */\n  deduped?: true\n}\n\n/**\n * One job of a batch once {@link NodesResource.runBatchAndWait} stops waiting\n * for it: its output, or the typed error that ended the wait — a\n * `JobFailedError` (failed or cancelled), `JobHeldError` (held for review) or\n * `JobTimeoutError`. One job's error never discards the others' images.\n */\nexport type BatchJobOutcome =\n  | { readonly jobId: string; readonly model: string; readonly status: \"completed\"; readonly output: NodeJobOutput }\n  | { readonly jobId: string; readonly model: string; readonly status: \"error\"; readonly error: NodaroError }\n\n/** What {@link NodesResource.runBatchAndWait} resolves. */\nexport interface GenerateImageBatchOutput {\n  /** The submit's answer: the ids, the groups, the credits. */\n  readonly batch: GenerateImageBatchResult\n  /** Every job, in `batch.jobIds` order. */\n  readonly results: readonly BatchJobOutcome[]\n}\n\n/**\n * Typed request body for `nodes.run(\"generate-video\", …)` / `runAndWait`.\n * Common fields are typed; any other route field passes through.\n */\nexport interface GenerateVideoParams extends StructuredReferenceParams, ReferenceCaptionParams, GenerationSessionParams {\n  prompt?: string\n  provider?: string\n  /** Start-frame image (image-to-video). */\n  imageUrl?: string\n  /** Closing frame, paired with `imageUrl` on models that support one. */\n  endFrameUrl?: string\n  referenceImageUrls?: string[]\n  referenceVideoUrls?: string[]\n  referenceAudioUrls?: string[]\n  /**\n   * Identity inputs that keep a real person's face — a portrait + description\n   * per person, up to 3. Only models with a dedicated character channel take\n   * them (Gemini Omni: `gemini-omni-video`, `gemini-omni-flash`); any other\n   * model answers `400`. Distinct from `referenceImageUrls`, which a multimodal\n   * model treats as loose context. Cannot be combined with a start frame\n   * (`imageUrl`); each character uses 1 of the model's 7 input units (2 with a\n   * `bodyImageUrl`). Adds no credit charge. Give a character a `voice` to pin one\n   * voice persona (a Gemini preset + optional description / example line) across\n   * clips — up to 3 distinct voices a request.\n   */\n  characterReferences?: VideoCharacterReference[]\n  /** How a start/end frame is reshaped before the model sees it. Default\n   *  `\"resolution\"`: resize it to the pixel size that model actually renders,\n   *  which is what stops the provider reshaping it mid-clip. `\"ratio\"` corrects\n   *  only the aspect; `\"original\"` sends it untouched. */\n  frameFit?: \"original\" | \"ratio\" | \"resolution\"\n  /** Whether the frame travels as a real start frame or as a reference image\n   *  bound in the prompt as the opening frame. Default `\"auto\"`, which picks per\n   *  model. Ignored by models that take no reference images. */\n  frameDelivery?: \"auto\" | \"frame\" | \"reference\"\n  /** Seedance Draft (`seedance-2-5` only; ignored elsewhere): render a 480p\n   *  DRAFT — it costs the same as a 480p run and any `resolution` is replaced\n   *  by 480p. Finalize the take you like with `nodes.run(\"video-upscale\",\n   *  { provider: \"seedance-2-5-hd\", sourceJobId })`: the same take, frame for\n   *  frame, at 1080p. Drafts are kept about 7 days. */\n  draft?: boolean\n  [k: string]: unknown\n}\n\n/**\n * Typed request body for `nodes.run(\"text-to-video\", …)` / `runAndWait` — the\n * PROMPT-ONLY video lane (`POST /v1/text-to-video`).\n *\n * Which lane takes what: `text-to-video` renders from text (plus optional\n * references) and `prompt` is REQUIRED; frames belong to `generate-video`\n * alone, which is the image-to-video lane (`imageUrl` start frame, `endFrameUrl`\n * closing frame) and where a prompt is optional. A model with no text-to-video\n * mode answers this lane with a `400 image_required` naming itself.\n *\n * Common fields are typed; any other route field passes through.\n */\nexport interface TextToVideoParams extends StructuredReferenceParams, ReferenceCaptionParams, GenerationSessionParams {\n  prompt: string\n  provider?: string\n  duration?: number\n  /** Native audio toggle, on the models that render sound. */\n  sound?: boolean\n  negativePrompt?: string\n  aspectRatio?: string\n  resolution?: string\n  seed?: number\n  referenceImageUrls?: string[]\n  referenceVideoUrls?: string[]\n  referenceAudioUrls?: string[]\n  /** Identity inputs that keep a real person's face — see {@link GenerateVideoParams.characterReferences}. */\n  characterReferences?: VideoCharacterReference[]\n  /** Cinematic direction as catalog IDS — the route renders the wording. */\n  direction?: DirectionFields\n  /** WHO is in the shot as picker-catalog ids ({@link Subject}), folded ahead of the direction clauses. */\n  subject?: Subject\n  /** Seedance Draft (`seedance-2-5` only; ignored elsewhere): render a 480p\n   *  DRAFT — it costs the same as a 480p run and any `resolution` is replaced\n   *  by 480p. Finalize the take you like with `nodes.run(\"video-upscale\",\n   *  { provider: \"seedance-2-5-hd\", sourceJobId })`: the same take, frame for\n   *  frame, at 1080p. Drafts are kept about 7 days. */\n  draft?: boolean\n  [k: string]: unknown\n}\n\n/**\n * Typed request body for `nodes.run(\"video-upscale\", …)` / `runAndWait`.\n *\n * - `topaz` (default): upscale any `videoUrl` by `upscaleFactor`.\n * - `veo-1080p` / `veo-4k`: re-render a VEO generation by its `taskId`.\n * - `seedance-2-5-hd`: finalize a Seedance 2.5 DRAFT (a `draft: true` run) —\n *   the same take re-rendered at 1080p at the draft's own length. Name the\n *   draft by `sourceJobId` (its job id) or `taskId` (its providerTaskId). The\n *   price comes from the draft (its length, and whether it used a reference\n *   video), never from this body. A foreign, unfinished or non-draft source is\n *   refused with a 4xx before anything is charged.\n *\n * Any other route field passes through.\n */\nexport interface VideoUpscaleParams extends GenerationSessionParams {\n  provider?: \"topaz\" | \"veo-1080p\" | \"veo-4k\" | \"seedance-2-5-hd\"\n  videoUrl?: string\n  upscaleFactor?: \"1\" | \"2\" | \"4\"\n  taskId?: string\n  sourceJobId?: string\n  [k: string]: unknown\n}\n\n/**\n * Typed request body for `nodes.run(\"assemble-narrated-video\", …)` / `runAndWait`.\n * Assembles blocks of video with audio narration into a single composed video.\n */\nexport interface AssembleNarratedVideoParams extends GenerationSessionParams {\n  blocks: { videoUrl: string; audioUrl?: string }[]\n  voiceVolume?: number\n  clipAudioVolume?: number\n  maxSlowdown?: number\n  trimStartFrames?: number\n  trimEndFrames?: number\n  [k: string]: unknown\n}\n\n/**\n * Typed request body for `nodes.run(\"video-depth\", …)` / `runAndWait` — turns a\n * video into a depth video (`POST /v1/video-depth`, near is bright, far is\n * dark). The completed job writes `videoUrl` (MP4) and `thumbnailUrl`.\n *\n * Two providers: `video-depth-anything` (the default, temporally consistent)\n * honours every lever below; `depth-anything-frames` (Depth Anything per\n * frame) takes `modelSize` and `colormap` only, and renders only `grayscale` /\n * `inferno`. A lever the chosen provider does not take is dropped and a\n * colormap it cannot render becomes `grayscale` — coerced, never rejected (a\n * value outside the vocabularies below is still a `400 validation_error`).\n *\n * The clip is measured before any credits are reserved. Too long answers\n * `400 video_too_long` (`video-depth-anything`: more than 2,400 frames or\n * 300 s; `depth-anything-frames`: more than 80 s); a clip that cannot be read\n * answers `400 video_unreadable`; a provider the deployment has turned off\n * answers `403 model_not_available`.\n *\n * Common fields are typed; any other route field passes through.\n */\nexport interface VideoDepthParams extends GenerationSessionParams {\n  /** The source video — a public http(s) URL. */\n  videoUrl: string\n  /** Default `video-depth-anything`. */\n  provider?: VideoDepthProvider\n  /** `small` / `base` / `large` (the default) — larger is more detailed and slower. */\n  modelSize?: VideoDepthModelSize\n  /** Default `grayscale`. `depth-anything-frames` renders only `grayscale` / `inferno`. */\n  colormap?: VideoDepthColormap\n  /** `video-depth-anything` only. Default `auto`. */\n  resolution?: VideoDepthResolution\n  /** `video-depth-anything` only: render the original and the depth next to each other. */\n  sideBySide?: boolean\n  [k: string]: unknown\n}\n\n/**\n * The `output_data` shape a finalized generation job writes. Every async\n * generation node persists one (or more) of these media URLs to\n * `jobs.output_data` on completion — `generate-image` → `imageUrl`,\n * `generate-video` / `combine-videos` / `merge-video-audio` / `video-upscale` /\n * `video-depth` → `videoUrl` (+ `thumbnailUrl`), `text-to-speech` / `generate-music` →\n * `audioUrl` (a `text-to-speech` run with `withTimestamps: true` on a model\n * that returns timings, and every `text-to-dialogue` run on one, also carries\n * `transcript`). Resolved by {@link NodesResource.runAndWait}. Extra fields may be\n * present, so the index signature is open.\n */\n/**\n * The completed `social-search` job's `output_data`: EVERY post the search\n * found, in the order it asked for (Social Search, Nodaro Cloud). Picking the\n * posts a workflow passes on is an editor step; a direct caller gets them all.\n */\nexport interface SocialSearchJobOutput extends NodeJobOutput {\n  readonly json: readonly SocialPost[]\n  readonly platform: SocialPlatform\n  readonly mode: SocialSearchMode\n  readonly query: string\n  /** Non-fatal notes (\"only part of the results could be loaded\"). */\n  readonly warnings?: readonly string[]\n}\n\nexport interface NodeJobOutput {\n  /** `text-to-speech` / `generate-music` / audio nodes write here. For\n   *  `audio-separation` this is the primary stem (vocals). */\n  readonly audioUrl?: string\n  /** `audio-separation` (Demucs) per-stem URLs. `vocalUrl`/`instrumentalUrl`\n   *  in vocal/instrumental mode; the rest in full-stems mode. */\n  readonly vocalUrl?: string\n  readonly instrumentalUrl?: string\n  readonly drumsUrl?: string\n  readonly bassUrl?: string\n  readonly otherUrl?: string\n  readonly guitarUrl?: string\n  readonly pianoUrl?: string\n  /** `generate-video` / `combine-videos` / `merge-video-audio` / `video-upscale` / `video-depth` write here. */\n  readonly videoUrl?: string\n  /** `generate-image` / `edit-image` / `extract-frame` write here. */\n  readonly imageUrl?: string\n  /** Every image, when the job made more than one; `imageUrl` is the first. */\n  readonly imageUrls?: readonly string[]\n  /**\n   * The output's pixel size. On an image job: the size of `imageUrl` as it is\n   * stored — what you download, a free-tier watermark included — with EXIF\n   * orientation applied, so the size a browser shows. Lay a grid tile out\n   * before the image loads, or show and sort by size.\n   *\n   * Present on image jobs completed after this release (and on the jobs that\n   * always recorded it: image overlay, video overlay, video mask, mask\n   * composite). Absent when the size could not be read — never half a size.\n   */\n  readonly width?: number\n  readonly height?: number\n  /**\n   * Beside `imageUrls`: each image with its pixel size, index-aligned\n   * (`images[i]` is `imageUrls[i]`). Present on image jobs completed after\n   * this release when at least one size was read; an entry whose size could\n   * not be read has its `url` and no `width` / `height`.\n   */\n  readonly images?: readonly JobOutputImage[]\n  /** Poster frame for video outputs. */\n  readonly thumbnailUrl?: string\n  readonly [k: string]: unknown\n}\n\n/** One image of a job that made several — see {@link NodeJobOutput.images}. */\nexport interface JobOutputImage {\n  readonly url: string\n  /** Pixel size as stored, EXIF orientation applied. Absent when it could not be read. */\n  readonly width?: number\n  readonly height?: number\n}\n\n/** Options for {@link NodesResource.runAndWait} and {@link NodesResource.runMany}. */\nexport interface RunAndWaitOptions {\n  /**\n   * Abort the run/poll loop. Aborting (or passing an already-aborted signal)\n   * stops polling and rejects with {@link JobAbortedError}, whose `jobId`\n   * names the job once it was submitted. Aborting stops the WAITING only: the\n   * job keeps running and is charged, unless {@link cancelOnAbort} is set.\n   */\n  readonly signal?: AbortSignal\n  /**\n   * Also cancel the job when `signal` aborts after it was submitted\n   * (`POST /v1/jobs/:id/cancel`, which refunds its credit hold). Best effort:\n   * a failed cancel still rejects with the {@link JobAbortedError}. Default\n   * `false` — aborting only stops waiting.\n   */\n  readonly cancelOnAbort?: boolean\n  /** Called with each lean status the poll loop observes (running → terminal). */\n  readonly onProgress?: (status: JobStatusResult) => void\n  /** Poll interval in ms. Default 2000. */\n  readonly pollMs?: number\n  /** Wall-clock cap before giving up, in ms. Default ~15 min (900_000). */\n  readonly maxMs?: number\n  /**\n   * `Idempotency-Key` for the submit half. Reuse the same value when retrying a\n   * call that timed out, so the run is not started or charged twice. Omitted →\n   * no key, which is the historical behaviour for every node that does not\n   * require one.\n   */\n  readonly idempotencyKey?: string\n}\n\n/** Per-call transport controls for {@link NodesResource.run}. */\nexport interface RunNodeOptions {\n  /** `Idempotency-Key` header. See {@link RunAndWaitOptions.idempotencyKey}. */\n  readonly idempotencyKey?: string\n}\n\n/** One settled result from {@link NodesResource.runMany}. */\nexport interface RunManyResult {\n  readonly jobId: string\n  readonly output: NodeJobOutput\n}\n\n// Terminal statuses (poll loop stops on these) are handled explicitly in\n// `pollJob`: `completed` resolves output_data, `failed`/`cancelled` throw a\n// JobFailedError — matching studio's `completed | failed | cancelled` set.\nconst DEFAULT_POLL_MS = 2000\n/** Safety cap so a stuck job can't poll forever (~15 min at 2s). */\nconst DEFAULT_MAX_MS = 15 * 60 * 1000\n\nconst sleep = (ms: number, signal?: AbortSignal): Promise<void> =>\n  new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new JobAbortedError())\n      return\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort)\n      resolve()\n    }, ms)\n    function onAbort() {\n      clearTimeout(timer)\n      reject(new JobAbortedError())\n    }\n    signal?.addEventListener(\"abort\", onAbort, { once: true })\n  })\n\n/** The error for a node type that cannot be run on its own. */\nfunction notRunnable(type: string, why: string): NodaroError {\n  return new NodaroError(`Node type \"${type}\" has no route of its own to run it directly: ${why}.`, \"node_not_runnable\", 0)\n}\n\n/** A 404 for the route itself (the server has no such path), not for a missing resource. */\nconst isRouteNotFound = (err: unknown): boolean => err instanceof NotFoundError && /^Route\\b.*\\bnot found\\b/i.test(err.message)\n\n/** Pull a `{ jobId }` off a run result, or throw a labelled JobFailedError. */\nfunction extractJobId(result: RunNodeResult, label: string): string {\n  if (result && typeof result === \"object\" && \"jobId\" in result) {\n    const jobId = (result as { jobId: unknown }).jobId\n    if (typeof jobId === \"string\") return jobId\n  }\n  // No jobId means the node ran inline/synchronously (meta-ads-scrape, etc.) or\n  // the route shape changed — runAndWait is for async jobs, so this is an error.\n  throw new JobFailedError(`${label} did not return a jobId`, \"\")\n}\n\n/** Whether a generate-image request makes several jobs: `count` above 1, or `models`. */\nfunction isImageBatchRequest(type: string, params: Record<string, unknown>): boolean {\n  if (type !== \"generate-image\") return false\n  return (typeof params.count === \"number\" && params.count > 1) || Array.isArray(params.models)\n}\n\n/** The job ids of a batch answer (several jobs from one call), or null for a single job. */\nfunction batchJobIds(result: RunNodeResult): string[] | null {\n  const ids = (result as { jobIds?: unknown } | null)?.jobIds\n  return Array.isArray(ids) && ids.every((id) => typeof id === \"string\") ? (ids as string[]) : null\n}\n\n/** A wait-for-one-job method asked to wait for a batch. */\nfunction batchRefusal(detail: string): NodaroError {\n  return new NodaroError(\n    `${detail}: this waits for one job — use nodes.runBatchAndWait() for a batch (count above 1, or models).`,\n    \"batch_requires_run_batch_and_wait\",\n    0,\n  )\n}\n\n/** The batch answer of a generate-image call, checked, or null. */\nfunction batchResultOf(result: RunNodeResult): GenerateImageBatchResult | null {\n  const r = result as Partial<GenerateImageBatchResult> | null\n  if (!r || typeof r.batchId !== \"string\" || !batchJobIds(result) || !Array.isArray(r.groups)) return null\n  return r as GenerateImageBatchResult\n}\n\nexport class NodesResource {\n  /** Runs poll through `jobs`, so the client must carry that resource too. */\n  constructor(private client: NodaroClientCore & { readonly jobs: JobsResource }) {}\n\n  /** List all known node descriptors. Server caches publicly for 5 minutes. */\n  list(): Promise<{ data: NodeDescriptor[] }> {\n    return this.client.request(\"GET\", \"/v1/nodes\")\n  }\n\n  /** Get a single node descriptor by type slug (e.g. \"generate-image\"). */\n  get(type: string): Promise<{ data: NodeDescriptor }> {\n    return this.client.request(\"GET\", `/v1/nodes/${encodeURIComponent(type)}`)\n  }\n\n  /**\n   * Run a single node directly without wrapping it in a workflow. Posts\n   * `params` as the request body to the node's API route. Most use\n   * `POST /v1/<type>`; the rest are listed in `NODE_RUN_ROUTES` (exported by\n   * `@nodaro/shared`): scene authoring uses `/v1/3d-scene/generate|edit`,\n   * `llm-chat` uses `/v1/llm-chat/generate`, the Suno nodes `/v1/suno/…`, the\n   * social post nodes `/v1/social/publish` (a per-platform node fills in its\n   * `platform` when you leave it out), and render-video with a planType uses\n   * `/v1/render-video/plan`.\n   *\n   * A node type with no route of its own (`NODE_TYPES_WITHOUT_RUN_ROUTE`, e.g.\n   * `modify-image`, which runs through `image-to-image`) rejects with a\n   * {@link NodaroError} of code `node_not_runnable` naming what to run\n   * instead, without calling the API. A type that runs only inside a workflow\n   * (an input, trigger, utility or parameter node such as `upload-image`)\n   * rejects the same way once the API answers that it has no such route; a\n   * 404 about a missing resource stays a `NotFoundError`.\n   *\n   * This is the SDK equivalent of the MCP server's verb tools — and the\n   * path the Nodaro CLI uses for `nodaro nodes run <type>`.\n   *\n   * Most node types are async: the response includes `{ jobId }` and the\n   * actual generation runs on a worker. Poll `client.jobs.get(jobId)` until\n   * completed. Synchronous node types (`meta-ads-scrape`, etc.) return their\n   * full result without a `jobId` field.\n   *\n   * @param type    Node type slug — must match an entry in the registry\n   *                returned by `list()` (e.g. \"generate-image\").\n   * @param params  Request body. Field names must match the node's\n   *                `inputSchema` (see `get(type).inputSchema`).\n   */\n  run(type: \"generate-3d-scene\", params: GenerateScene3DParams): Promise<RunNodeResult>\n  run(type: \"edit-3d-scene\", params: EditScene3DParams): Promise<RunNodeResult>\n  run(type: \"render-video\", params: RenderScene3DParams): Promise<RunNodeResult>\n  run(type: \"pro-3d-render\", params: Pro3DRenderRunParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"generate-image\", params: GenerateImageParams & ({ count: 2 | 3 | 4 } | { models: string[] }), options?: RunNodeOptions): Promise<GenerateImageBatchResult>\n  run(type: \"generate-image\", params?: GenerateImageParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"text-to-speech\", params: TextToSpeechParams): Promise<RunNodeResult>\n  run(type: \"generate-video\", params?: GenerateVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"text-to-video\", params: TextToVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"video-to-video\", params: VideoToVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"video-upscale\", params: VideoUpscaleParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"assemble-narrated-video\", params?: AssembleNarratedVideoParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"social-search\", params: SocialSearchParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"video-depth\", params: VideoDepthParams, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: \"image-to-image\", params: ImageToImageParams, options?: RunNodeOptions): Promise<ImageJobStarted>\n  run(type: \"edit-image\", params: EditImageParams, options?: RunNodeOptions): Promise<ImageJobStarted>\n  run(type: \"generate-mask\", params: GenerateMaskParams, options?: RunNodeOptions): Promise<ImageJobStarted>\n  /** Synchronous and free: answers the tiles, no job. */\n  run(type: \"split-image\", params: SplitImageParams, options?: RunNodeOptions): Promise<SplitImageResult>\n  run(type: string, params?: Record<string, unknown>, options?: RunNodeOptions): Promise<RunNodeResult>\n  run(type: string, params: Record<string, unknown> = {}, options: RunNodeOptions = {}): Promise<RunNodeResult | GenerateImageBatchResult> {\n    // The route comes from the table the platform's workflow engine uses\n    // too; only render-video's plan route depends on the body.\n    const route = type === \"render-video\" && typeof params.planType === \"string\" ? \"/v1/render-video/plan\" : nodeRunRoute(type)\n    if (!route) return Promise.reject(notRunnable(type, NODE_TYPES_WITHOUT_RUN_ROUTE[type]!))\n    // A per-platform social node publishes through the shared route, which\n    // needs the platform the node type stands for.\n    const platform = SOCIAL_POST_NODE_PLATFORM[type]\n    const body = platform && params.platform === undefined ? { ...params, platform } : params\n    // Only a type on the `/v1/<type>` convention is relabelled: a listed\n    // route that 404s means a platform that predates it, not a node that\n    // cannot run.\n    const conventional = !Object.prototype.hasOwnProperty.call(NODE_RUN_ROUTES, type)\n    return this.client\n      .request<RunNodeResult>(\"POST\", route, {\n        body,\n        // Transport-level retry safety, opt-in per call. The platform reads the\n        // standard header, so a caller that reuses a key on a retry gets the\n        // same run back instead of a second charge.\n        ...(options.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n      })\n      .catch((err: unknown) => {\n        if (conventional && isRouteNotFound(err)) throw notRunnable(type, \"it runs only inside a workflow (client.workflows.run)\")\n        throw err\n      })\n  }\n\n  /**\n   * The price of a run before it starts (`POST /v1/quote`). Send exactly the\n   * body you would send to {@link run}: the platform prices it with the same\n   * code the run route reserves with — validation, measuring reference clips,\n   * the price id and the credit amount — but starts nothing and charges\n   * nothing.\n   *\n   * `reserve` is what the run will hold when it starts; `expected`, when\n   * present, is what it should actually cost (a Seedance edit renders the\n   * source clip's length). A run settles to what was generated, never above\n   * `reserve`. Rejects with the same `400` the run would answer for an\n   * invalid body. Typed for the video lanes; any other node type takes its\n   * run body as-is.\n   *\n   * @param type    Node type slug, as for {@link run}.\n   * @param params  The run body.\n   */\n  quote(type: \"text-to-video\", params: TextToVideoParams): Promise<NodeQuote>\n  quote(type: \"generate-video\", params: GenerateVideoParams): Promise<NodeQuote>\n  quote(type: \"video-to-video\", params: VideoToVideoParams): Promise<NodeQuote>\n  /** A Seedance 2.5 draft's 1080p finalize (`seedance-2-5-hd`) is priced from\n   *  the draft itself, including the clips it was made with. */\n  quote(type: \"video-upscale\", params: VideoUpscaleParams): Promise<NodeQuote>\n  quote(type: string, params?: Record<string, unknown>): Promise<NodeQuote>\n  async quote(type: string, params: Record<string, unknown> = {}): Promise<NodeQuote> {\n    const res = await this.client.request<{ data: NodeQuote }>(\"POST\", \"/v1/quote\", { body: { type, params } })\n    return res.data\n  }\n\n  /**\n   * Run a single async node to completion: {@link run} it, extract the\n   * `{ jobId }`, then client-poll `jobs.getStatus(jobId)` every `pollMs`\n   * (default 2000) until a terminal status, up to `maxMs` (default ~15 min).\n   *\n   * Resolves the job's typed `output_data` ({@link NodeJobOutput}) on\n   * `completed`. Throws (all typed, catchable by `instanceof`):\n   * - {@link InsufficientCreditsError} / {@link StorageExceededError} etc. —\n   *   surfaced by the underlying {@link run} on 402/413/… before any poll.\n   * - {@link JobFailedError} — terminal `failed`/`cancelled` (carries the\n   *   job's `error_message` + `jobId`).\n   * - {@link JobTimeoutError} — `maxMs` deadline exceeded before terminal.\n   * - {@link JobAbortedError} — `signal` fired (or was already aborted);\n   *   polling stops immediately.\n   * - {@link JobHeldError} — the job entered `pending_review` on a deployment\n   *   that registers a job policy. Ends the poll on the FIRST held tick (that\n   *   status waits on a human, not on the job) and does NOT cancel it.\n   * - {@link JobBlockedError} — a 422 from {@link run} before any poll: the\n   *   deployment's job policy refused the request outright.\n   *\n   * Polling is fully client-side (no server function blocks) — the same model\n   * thin clients use, lifted out of their hand-rolled run→poll loops.\n   *\n   * @param type    Node type slug (e.g. \"generate-video\"). See {@link run}.\n   * @param params  Request body — field names match the node's `inputSchema`.\n   * @param opts    `signal` / `onProgress` / `pollMs` / `maxMs`.\n   */\n  runAndWait(type: \"generate-3d-scene\", params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>\n  runAndWait(type: \"edit-3d-scene\", params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>\n  runAndWait(type: \"render-video\", params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"pro-3d-render\", params: Pro3DRenderRunParams, options?: RunAndWaitOptions): Promise<Pro3DRenderJobOutput>\n  runAndWait(type: \"generate-image\", params?: GenerateImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"text-to-speech\", params: TextToSpeechParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"generate-video\", params?: GenerateVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"text-to-video\", params: TextToVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"video-to-video\", params: VideoToVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"video-upscale\", params: VideoUpscaleParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"assemble-narrated-video\", params?: AssembleNarratedVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"social-search\", params: SocialSearchParams, opts?: RunAndWaitOptions): Promise<SocialSearchJobOutput>\n  runAndWait(type: \"video-depth\", params: VideoDepthParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"image-to-image\", params: ImageToImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"edit-image\", params: EditImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>\n  runAndWait(type: \"generate-mask\", params: GenerateMaskParams, opts?: RunAndWaitOptions): Promise<GenerateMaskJobOutput>\n  runAndWait<T extends string>(type: T, params?: Record<string, unknown>, opts?: RunAndWaitOptions): Promise<T extends \"pro-3d-render\" ? Pro3DRenderJobOutput : T extends \"generate-3d-scene\" | \"edit-3d-scene\" ? Scene3DJobOutput : T extends \"generate-mask\" ? GenerateMaskJobOutput : NodeJobOutput>\n  async runAndWait(\n    type: string,\n    params: Record<string, unknown> = {},\n    opts: RunAndWaitOptions = {},\n  ): Promise<NodeJobOutput> {\n    if (opts.signal?.aborted) throw new JobAbortedError()\n    // A batch would be waited on as its first job alone — refused before\n    // anything is submitted or charged.\n    if (isImageBatchRequest(type, params)) throw batchRefusal(`${type} with count above 1 or models makes several jobs`)\n    const result = await this.run(type, params, { idempotencyKey: opts.idempotencyKey })\n    const ids = batchJobIds(result)\n    if (ids && ids.length > 1) throw batchRefusal(`${type} started ${ids.length} jobs (${ids.join(\", \")}), which keep running`)\n    const jobId = extractJobId(result, type)\n    return this.pollJob(jobId, type, opts)\n  }\n\n  /**\n   * Run a generate-image BATCH — `count` above 1 and/or `models` — to the end:\n   * submit it once ({@link run}, with your `idempotencyKey` if any), then wait\n   * for every job at once, each the way {@link runAndWait} waits.\n   *\n   * Resolves `{ batch, results }`: the submit's answer\n   * ({@link GenerateImageBatchResult} — ids, groups by model, credits) and one\n   * {@link BatchJobOutcome} per job, in `batch.jobIds` order — its output, or the\n   * typed error that ended the wait for it. One image failing never discards the\n   * others. Rejects only before any job exists (the submit's own errors, e.g.\n   * `InsufficientCreditsError` with the batch total as `required`), and on\n   * `signal` ({@link JobAbortedError}; `cancelOnAbort` cancels every job).\n   *\n   * A request for one image is refused before anything is sent (code\n   * `not_a_batch`) — wait for it with {@link runAndWait}.\n   */\n  async runBatchAndWait(\n    type: \"generate-image\",\n    params: GenerateImageParams,\n    opts: RunAndWaitOptions = {},\n  ): Promise<GenerateImageBatchOutput> {\n    if (opts.signal?.aborted) throw new JobAbortedError()\n    if (!isImageBatchRequest(type, params)) {\n      throw new NodaroError(\n        \"runBatchAndWait waits for a batch — count above 1, or models; wait for one image with nodes.runAndWait().\",\n        \"not_a_batch\",\n        0,\n      )\n    }\n    const result = await this.run(type, params, { idempotencyKey: opts.idempotencyKey })\n    const batch = batchResultOf(result)\n    if (!batch) throw new JobFailedError(`${type} did not answer with a batch`, \"\")\n    const modelOf = new Map(batch.groups.flatMap((group) => group.jobIds.map((id) => [id, group.model] as const)))\n    const results = await Promise.all(\n      batch.jobIds.map(async (jobId): Promise<BatchJobOutcome> => {\n        const model = modelOf.get(jobId) ?? \"\"\n        try {\n          return { jobId, model, status: \"completed\", output: await this.pollJob(jobId, type, opts) }\n        } catch (err) {\n          if (err instanceof JobAbortedError || !(err instanceof NodaroError)) throw err\n          return { jobId, model, status: \"error\", error: err }\n        }\n      }),\n    )\n    return { batch, results }\n  }\n\n  /**\n   * Fan out N async runs of the same node `type` to completion concurrently —\n   * the candidate-grid path (generate N stills/clips in parallel). Each runs\n   * via {@link runAndWait}; resolves once ALL settle, to an array of\n   * `{ jobId, output }` in input order. Rejects (and the rejection wins) if any\n   * single run rejects — same typed errors as {@link runAndWait}, including\n   * {@link JobHeldError} when one candidate is held for review while the\n   * others complete. A shared `signal` aborts the whole batch.\n   *\n   * @param type        Node type slug, applied to every entry.\n   * @param paramsList  One request body per candidate.\n   * @param opts        Shared `signal` / `cancelOnAbort` / `onProgress` / `pollMs` / `maxMs`.\n   */\n  async runMany(\n    type: string,\n    paramsList: Record<string, unknown>[],\n    opts: RunAndWaitOptions = {},\n  ): Promise<RunManyResult[]> {\n    if (opts.signal?.aborted) throw new JobAbortedError()\n    // Each entry is waited on as one job: a batch entry is refused up front.\n    if (paramsList.some((params) => isImageBatchRequest(type, params))) {\n      throw batchRefusal(`a ${type} entry with count above 1 or models makes several jobs`)\n    }\n    return Promise.all(\n      paramsList.map(async (params) => {\n        if (opts.signal?.aborted) throw new JobAbortedError()\n        const result = await this.run(type, params)\n        const jobId = extractJobId(result, type)\n        const output = await this.pollJob(jobId, type, opts)\n        return { jobId, output }\n      }),\n    )\n  }\n\n  /** {@link pollUntilSettled}, plus what an abort does to the job: it keeps\n   *  running unless `cancelOnAbort` asks to cancel it too, and the rejection\n   *  always names it (an abort landing mid-sleep carries no id of its own). */\n  private async pollJob(\n    jobId: string,\n    label: string,\n    opts: RunAndWaitOptions,\n  ): Promise<NodeJobOutput> {\n    try {\n      return await this.pollUntilSettled(jobId, label, opts)\n    } catch (err) {\n      if (!(err instanceof JobAbortedError)) throw err\n      if (opts.cancelOnAbort) await this.client.jobs.cancel(jobId).catch(() => undefined)\n      throw err.jobId ? err : new JobAbortedError(err.message, jobId)\n    }\n  }\n\n  /** Poll an already-kicked job id until it stops moving; resolve output_data\n   *  or throw. Two non-terminal statuses end the loop: an abort, and\n   *  `pending_review` (a job policy held the output for a human — see\n   *  {@link JobHeldError}). */\n  private async pollUntilSettled(\n    jobId: string,\n    label: string,\n    opts: RunAndWaitOptions,\n  ): Promise<NodeJobOutput> {\n    const pollMs = opts.pollMs ?? DEFAULT_POLL_MS\n    const maxMs = opts.maxMs ?? DEFAULT_MAX_MS\n    const deadline = Date.now() + maxMs\n    for (;;) {\n      if (opts.signal?.aborted) throw new JobAbortedError(undefined, jobId)\n      const { data } = await this.client.jobs.getStatus(jobId)\n      opts.onProgress?.(data)\n      if (data.status === \"completed\") {\n        return (data.output_data ?? {}) as NodeJobOutput\n      }\n      if (data.status === \"failed\" || data.status === \"cancelled\") {\n        throw new JobFailedError(\n          data.error_message ?? `${label} ${data.status}`,\n          jobId,\n          data.status,\n        )\n      }\n      // `pending_review` is in-flight but PARKED ON A HUMAN — it does not\n      // progress on its own, so continuing the loop would burn `maxMs` (15 min\n      // by default) and then report a `JobTimeoutError` that misdescribes what\n      // happened. End here instead, without cancelling: the output exists, the\n      // reservation stays reserved, and a reviewer resolves it.\n      if (data.status === \"pending_review\") {\n        throw new JobHeldError(`${label} is awaiting review`, jobId)\n      }\n      if (Date.now() > deadline) {\n        throw new JobTimeoutError(`${label} timed out`, jobId, maxMs)\n      }\n      await sleep(pollMs, opts.signal)\n    }\n  }\n}\n"]}

package/dist/chunk-53SXNN3A.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/apps.ts"],"names":[],"mappings":"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","file":"chunk-53SXNN3A.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A published app — a workflow wrapped in a curated input/output presentation.\n * Returned by the public `/v1/apps/browse` endpoint.\n */\nexport interface PublishedApp {\n  id: string\n  slug: string\n  name: string\n  description?: string | null\n  creatorId: string\n  creatorName?: string | null\n  thumbnailUrl?: string | null\n  category?: string | null\n  isFeatured?: boolean\n  runCount?: number\n  /** The listed price per run; when `perMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits?: number | null\n  /**\n   * Credits per minute of the recording the app is given, when its price\n   * follows that recording's length: the price is `estimatedCredits` plus\n   * this per minute. 0 or absent when the price does not depend on a\n   * recording's length.\n   */\n  perMinuteCredits?: number\n  /**\n   * Credits for each item beyond the creator's saved items of a list input\n   * the app's user fills: the price is the listed one plus this per further\n   * item. 0 or absent when the app has no such input.\n   */\n  perItemCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` (with `perMinuteCredits` /\n   * `perItemCredits`) is \"from\" — the app's saved settings — and these are\n   * \"up to\": the most a run can cost over the choices the app's user has (every\n   * exposed field, at the creator's restricted values where set). Present only\n   * when they differ from \"from\"; absent on an app published before the range\n   * existed until its next publish.\n   */\n  maxEstimatedCredits?: number\n  maxPerMinuteCredits?: number\n  maxPerItemCredits?: number\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListAppsParams {\n  /** Substring search across app name + description. */\n  search?: string\n  /** Page size; backend caps at 50. */\n  limit?: number\n  /** Cursor token returned by the previous page. */\n  cursor?: string\n  /** Filter to a single category slug. */\n  category?: string\n}\n\nexport interface ListAppsResult {\n  data: PublishedApp[]\n  nextCursor?: string | null\n}\n\n/**\n * App detail — includes the input schema (required + optional fields end users\n * fill in) and the output mapping (which workflow nodes produce which display\n * cards).\n */\nexport interface PublishedAppDetail extends PublishedApp {\n  inputSchema: Record<string, unknown>\n  outputs: Array<{ nodeId: string; label: string; type: string }>\n  /**\n   * The app run alone: the listed price less its Render final part (run and\n   * charged separately) — fixed, per minute of the recording and per further\n   * list item. Absent from a server that predates them; read the listed\n   * `estimatedCredits` / `perMinuteCredits` / `perItemCredits` instead.\n   */\n  runEstimatedCredits?: number\n  runPerMinuteCredits?: number\n  runPerItemCredits?: number\n  /**\n   * Whether this server charges Edit Plan per started minute of the recording\n   * (otherwise in 15/30/60/90/120/180-minute steps). Absent from a server that\n   * predates it: read it as the steps.\n   */\n  editPlanPerMinute?: boolean\n}\n\nexport interface AppRunResult {\n  /** The execution-id that was started — poll via client.executions.get(). */\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** App-run id (distinct from executionId — used by listRuns/getRun). */\n  runId?: string\n}\n\nexport interface AppRun {\n  id: string\n  appSlug: string\n  executionId: string\n  status: \"pending\" | \"running\" | \"completed\" | \"failed\" | \"cancelled\"\n  inputs: Record<string, unknown>\n  outputs?: Array<{ nodeId: string; type: string; url?: string; text?: string }>\n  startedAt: string\n  finishedAt?: string | null\n}\n\nexport interface ListAppRunsParams {\n  limit?: number\n  cursor?: string\n}\n\n/**\n * Result of a soft-delete (archive) operation. The run is moved to the user's\n * archive in the Nodaro UI; restoration and permanent deletion are UI-only by\n * design — SDK / MCP / API delete callers can't accidentally destroy data.\n */\nexport interface DeleteAppRunResult {\n  success: true\n  archived: true\n}\n\n/** Advanced per-run options for `apps.run`. */\nexport interface RunAppOptions {\n  /**\n   * Raw node-data overrides keyed by node id → field → value, merged onto the\n   * app's workflow for THIS run only. Reaches fields that are NOT exposed as app\n   * inputs — e.g. `{ [nodeId]: { promptPrefix: \"…\", promptSuffix: \"…\" } }` to\n   * wrap the end user's prompt with text they never see.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n}\n\n/** Options for `apps.resume` — the Retry of a failed app run. */\nexport interface ResumeAppRunOptions {\n  /** Answer what the Retry would run and charge, and start nothing. */\n  dryRun?: boolean\n  /**\n   * The app version you expect the Retry to run — the one starting over would\n   * run. Absent: the app's latest. A run of another version is refused with\n   * `app_run_version_changed`; send the run's own version (the refusal's\n   * `runVersion`) to continue on it anyway.\n   */\n  version?: number\n}\n\n/** One step a Retry runs again. */\nexport interface AppRunResumeStep {\n  nodeId: string\n  type: string\n  /** The node's label, or `null` when it has none. */\n  label: string | null\n}\n\n/** What a Retry would do (`apps.resume(…, { dryRun: true })`); nothing is started. */\nexport interface AppRunResumePlan {\n  runId: string\n  /** The failed execution the Retry continues. */\n  continuesExecutionId: string\n  /** The app version the Retry runs (the run's own). */\n  appVersion: number | null\n  /** Every node the Retry runs, in graph order. */\n  nodeIds: string[]\n  /** The steps that run again. */\n  steps: AppRunResumeStep[]\n  /** What the Retry is expected to charge, the creator's fee included; `null` without credits. */\n  estimatedCredits: number | null\n  /** Clips handed back at no cost. */\n  reusedClips: number\n  /** Whether your balance and your app credits cover what the Retry holds while it runs; `null` without credits. */\n  sufficient: boolean | null\n  /** Your spendable balance; `null` without credits. */\n  available: number | null\n  /** Your app credits, present only when they are what stops the Retry (it would be refused `insufficient_app_credits`). */\n  appCreditsAllowance?: number\n}\n\n/**\n * A Retry that started. `deduped: true` when a concurrent double press reached\n * the same Retry; a second call made while the first is pending is refused\n * with `already_running` (`AlreadyRunningError`) instead.\n */\nexport interface AppRunResumeResult {\n  /** The Retry's execution — the run now points at it. Poll via client.executions.get(). */\n  executionId: string\n  runId: string\n  status: \"pending\"\n  /** Every node the Retry runs. */\n  nodeIds: string[]\n  /** `true` when a concurrent press had already started this Retry. */\n  deduped?: true\n}\n\n/**\n * The `code` the server gives an `apps.resume` refusal. Nothing is written or\n * billed when a Retry is refused. How each arrives:\n * - `app_run_version_changed` as `AppRunVersionChangedError`;\n * - `already_running` as `AlreadyRunningError` (with the live `executionId`);\n * - `not_found` and `continuation_not_found` as `NotFoundError`, whose `code`\n *   is always `not_found` (the server's message is kept);\n * - `insufficient_credits` and `insufficient_app_credits` as\n *   `InsufficientCreditsError`, whose `code` is always `insufficient_credits`\n *   (the server's message says which);\n * - the rest as `NodaroError` carrying this code.\n */\nexport type AppRunResumeRefusalCode =\n  /** No such run of yours under this app. */\n  | \"not_found\"\n  /** The run's execution is not yours. */\n  | \"continuation_not_found\"\n  /** A malformed run id or body, or a component's run (continued by the run that called it). */\n  | \"validation_error\"\n  /** The app version the run ran is gone: start the run over. */\n  | \"app_run_version_unavailable\"\n  /** The app is on another version than the run ran: start over, or send `version` = the run's. */\n  | \"app_run_version_changed\"\n  /** The run's execution ran another workflow, or another version of it (rare). */\n  | \"continuation_workflow_mismatch\"\n  | \"continuation_version_mismatch\"\n  /** The run did not fail (it completed or was stopped): start it over. */\n  | \"continuation_not_failed\"\n  /** The run is still running, a Retry of it is pending, or it was started again elsewhere. */\n  | \"already_running\"\n  /** Nothing is left to retry: every step completed (409), or the app runs no step (400). */\n  | \"continuation_subset_required\"\n  /** An input the run applied sets a field the app does not let a runner set. */\n  | \"locked_field\"\n  /**\n   * The Retry would stop at a Preview with nobody to review it: retry it from the app page.\n   * (The same refusal arrives under the other preview refusal codes when a review-on use-case\n   * node holds the run; `isPreviewRefusalCode` in `@nodaro/shared/nodes` asks for all of them.)\n   */\n  | \"preview_review_required\"\n  /** Your app credits cannot cover it. */\n  | \"insufficient_app_credits\"\n  /** Your balance cannot cover it. */\n  | \"insufficient_credits\"\n  /** Billing is briefly unavailable for a workspace run (503): try again shortly. */\n  | \"billing_unavailable\"\n\nexport class AppsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List published apps. Public — no auth required for community apps. */\n  list(params: ListAppsParams = {}): Promise<ListAppsResult> {\n    const qs = new URLSearchParams()\n    if (params.search) qs.set(\"search\", params.search)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.category) qs.set(\"category\", params.category)\n    const query = qs.toString()\n    return this.client.request(\"GET\", `/v1/apps/browse${query ? `?${query}` : \"\"}`)\n  }\n\n  /** Get one app's metadata + input schema by slug. */\n  get(slug: string): Promise<{ data: PublishedAppDetail }> {\n    return this.client.request(\"GET\", `/v1/app/${encodeURIComponent(slug)}`)\n  }\n\n  /**\n   * Trigger an app run with the given input values. The keys in `inputs` must\n   * match the app's input-schema field names (see `get(slug).inputSchema`).\n   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).\n   * Returns the execution-id for status polling via client.executions.get().\n   */\n  run(\n    slug: string,\n    inputs: Record<string, unknown> = {},\n    opts: RunAppOptions = {},\n  ): Promise<AppRunResult> {\n    return this.client.request(\"POST\", `/v1/app/${encodeURIComponent(slug)}/run`, {\n      body: { inputs, ...(opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {}) },\n    })\n  }\n\n  /** List past runs for an app (the caller must own the app or the runs). */\n  listRuns(slug: string, params: ListAppRunsParams = {}): Promise<{ data: AppRun[]; nextCursor?: string | null }> {\n    const qs = new URLSearchParams()\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** Get one app-run by id. */\n  getRun(slug: string, runId: string): Promise<{ data: AppRun }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n\n  /**\n   * Retry a FAILED app run from where it stopped: only the steps it did not\n   * complete run, and only those are charged; every step it completed hands\n   * on its result. It runs the version the run ran, with the inputs the run\n   * applied (it takes none of its own). The run's execution moves to the\n   * Retry's.\n   *\n   * `{ dryRun: true }` answers what the Retry would run and charge\n   * ({@link AppRunResumePlan}) and starts nothing — show it before a Retry.\n   * Refusals are listed in {@link AppRunResumeRefusalCode}; to run with other\n   * inputs or on the app's current version, start over with\n   * `run(slug, inputs)` instead.\n   *\n   * @param slug   The published app's slug.\n   * @param runId  The run's UUID (`AppRunResult.runId`, `AppRun.id`).\n   */\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions & { dryRun: true }): Promise<{ data: AppRunResumePlan }>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions & { dryRun?: false }): Promise<AppRunResumeResult>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions): Promise<{ data: AppRunResumePlan } | AppRunResumeResult>\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions = {}): Promise<{ data: AppRunResumePlan } | AppRunResumeResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,\n      {\n        body: {\n          ...(opts.dryRun ? { dryRun: true } : {}),\n          ...(opts.version !== undefined ? { version: opts.version } : {}),\n        },\n      },\n    )\n  }\n\n  /**\n   * Archive (soft-delete) a published-app run. The run is hidden from the\n   * default run list and can be restored or permanently deleted from the\n   * archive view at https://app.nodaro.ai/archived-runs.\n   *\n   * @param slug   The published app's slug (the last path segment of its URL).\n   * @param runId  The run's UUID.\n   */\n  deleteRun(slug: string, runId: string): Promise<DeleteAppRunResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n}\n"]}