@nodaro/sdk 2.1.0 → 2.2.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Scene3DJobOutputAny, Scene3DPlanV2, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
+import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
 export { AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared';
 import { DirectionFields, SubjectFields, PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
@@ -659,6 +659,27 @@ interface RetainedScene3DEditResult {
     scenePlan: Scene3DPlanV2;
     changeSummary: string;
 }
+interface Scene3DDeliveryAsset {
+    assetId: string;
+    kind: "poster" | "validation-report";
+    usage: "poster" | "validation";
+    byteLength: number;
+    sha256: string;
+    viaRevisionId: string | null;
+}
+/** Export evidence is retained separately from the immutable scene it rendered. */
+interface Scene3DDelivery {
+    deliveryId: string;
+    sceneRevisionId: string;
+    sourcePlanSha256: string;
+    sourceContentHash: string | null;
+    sourceJobId: string | null;
+    workflowId: string | null;
+    mode: "authored" | "render-only";
+    createdAt: string;
+    access: "view" | "edit" | "own";
+    assets: Scene3DDeliveryAsset[];
+}
 type Scene3DAuthoringEngine = "basic" | "blender-cloud" | "blender-local";
 interface Scene3DCapabilities {
     basic: {
@@ -671,6 +692,13 @@ interface Scene3DCapabilities {
         sceneSchemaVersions: number[];
         maxRepairPasses: number;
     };
+    /**
+     * What this deployment can serve for `pro-3d-render`, including which
+     * quality profiles, engines and aspect ratios a client may OFFER. Optional so
+     * a client of this version reads an older backend without throwing; absent
+     * means the node is unavailable.
+     */
+    pro?: Pro3DRenderCapabilities;
 }
 interface Scene3DEngineParams {
     /** Basic is the default. Discover optional engines through scene3d.capabilities(). */
@@ -709,6 +737,62 @@ interface EditScene3DParams extends Record<string, unknown>, Scene3DEngineParams
     workflowId?: string;
     nodeId?: string;
 }
+/**
+ * 3D Render Pro — ONE durable operation producing a composition and its MP4.
+ *
+ * `source` is a strict discriminated union, not a bag of optionals:
+ *  - `{kind:'prompt', prompt, references?}` authors a new scene;
+ *  - `{kind:'scene', revisionId, sourceJobId}` with NO `editPrompt` is the
+ *    render-only export — it spends no authoring or build credits, and OMIT
+ *    the field rather than sending `""`, which would buy an authoring pass;
+ *  - `{kind:'local-export', exportId, connectionId}` uses a paired desktop.
+ *
+ * There is no model or effort field: the planner is fixed and server-owned.
+ *
+ * `durationSeconds` / `fps` / `aspectRatio` on a `scene` source are an EXPLICIT
+ * re-time request. Omit them to keep the source's own timing; a conflicting
+ * override is rejected rather than silently applied.
+ */
+interface Pro3DRenderParams extends Record<string, unknown> {
+    source: Pro3DRenderSource;
+    /** Optional. An unknown or unavailable engine is rejected, never downgraded. */
+    engine?: Pro3DRenderEngine;
+    /** Names a paired desktop for a local run. */
+    localConnectionId?: string;
+    durationSeconds?: number;
+    fps?: number;
+    aspectRatio?: string;
+    quality?: Pro3DRenderQuality;
+    style?: Pro3DRenderStyle;
+    /** Correction budget, 0-2. Each pass is paid work. */
+    maxRepairPasses?: number;
+    /**
+     * Which scene-schema versions THIS client can render. A prompt or
+     * local-export source mints v2, so omitting 2 is refused for free; a scene
+     * source inherits its revision's version and is left to the server.
+     */
+    acceptedSceneSchemaVersions?: readonly number[];
+    workflowId?: string;
+    nodeId?: string;
+    /** Keep every artifact of this run out of publicly-readable storage. */
+    forcePrivate?: boolean;
+}
+/** A run additionally carries the quote it was priced under. */
+interface Pro3DRenderRunParams extends Pro3DRenderParams {
+    quoteId: string;
+}
+/** The quote's answer. `maxCredits` is a ceiling; quoting spends nothing. */
+type Pro3DRenderQuote = Readonly<Pro3DRenderQuote$1> & Readonly<Record<string, unknown>>;
+/** Per-call transport controls for the paid run. */
+interface Pro3DRenderRunOptions {
+    /**
+     * The `Idempotency-Key` the run is submitted under. Reuse the same value when
+     * retrying a call that timed out, so the run is not started twice; the SDK
+     * generates a fresh one per call when this is omitted, because two deliberate
+     * calls are two runs.
+     */
+    idempotencyKey?: string;
+}
 /** Render the exact scene revision through the existing render-video node. */
 interface RenderScene3DParams extends Record<string, unknown> {
     planType: "3d-scene";
@@ -718,6 +802,8 @@ interface RenderScene3DParams extends Record<string, unknown> {
 }
 /** Preserve the shared wire contract while allowing additive job metadata. */
 type Scene3DJobOutput = Readonly<Scene3DJobOutputAny> & Readonly<Record<string, unknown>>;
+/** The settled 3D Render Pro result, plus any additive job metadata. */
+type Pro3DRenderJobOutput = Readonly<Pro3DRenderJobOutput$1> & Readonly<Record<string, unknown>>;
 
 type NodeCategory = "input" | "parameter" | "ai-image" | "ai-video" | "ai-audio" | "ai-text" | "processing" | "composition" | "trigger" | "output" | "control" | "entity" | "utility";
 type OutputType = "text" | "image" | "video" | "audio" | "data" | "none";
@@ -945,6 +1031,18 @@ interface RunAndWaitOptions {
     readonly pollMs?: number;
     /** Wall-clock cap before giving up, in ms. Default ~15 min (900_000). */
     readonly maxMs?: number;
+    /**
+     * `Idempotency-Key` for the submit half. Reuse the same value when retrying a
+     * call that timed out, so the run is not started or charged twice. Omitted →
+     * no key, which is the historical behaviour for every node that does not
+     * require one.
+     */
+    readonly idempotencyKey?: string;
+}
+/** Per-call transport controls for {@link NodesResource.run}. */
+interface RunNodeOptions {
+    /** `Idempotency-Key` header. See {@link RunAndWaitOptions.idempotencyKey}. */
+    readonly idempotencyKey?: string;
 }
 /** One settled result from {@link NodesResource.runMany}. */
 interface RunManyResult {
@@ -984,11 +1082,12 @@ declare class NodesResource {
     run(type: "generate-3d-scene", params: GenerateScene3DParams): Promise<RunNodeResult>;
     run(type: "edit-3d-scene", params: EditScene3DParams): Promise<RunNodeResult>;
     run(type: "render-video", params: RenderScene3DParams): Promise<RunNodeResult>;
+    run(type: "pro-3d-render", params: Pro3DRenderRunParams, options?: RunNodeOptions): Promise<RunNodeResult>;
     run(type: "generate-image", params?: GenerateImageParams): Promise<RunNodeResult>;
     run(type: "generate-video", params?: GenerateVideoParams): Promise<RunNodeResult>;
     run(type: "text-to-video", params: TextToVideoParams): Promise<RunNodeResult>;
     run(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams): Promise<RunNodeResult>;
-    run(type: string, params?: Record<string, unknown>): Promise<RunNodeResult>;
+    run(type: string, params?: Record<string, unknown>, options?: RunNodeOptions): Promise<RunNodeResult>;
     /**
      * Run a single async node to completion: {@link run} it, extract the
      * `{ jobId }`, then client-poll `jobs.getStatus(jobId)` every `pollMs`
@@ -1019,11 +1118,12 @@ declare class NodesResource {
     runAndWait(type: "generate-3d-scene", params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     runAndWait(type: "edit-3d-scene", params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     runAndWait(type: "render-video", params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>;
+    runAndWait(type: "pro-3d-render", params: Pro3DRenderRunParams, options?: RunAndWaitOptions): Promise<Pro3DRenderJobOutput>;
     runAndWait(type: "generate-image", params?: GenerateImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "generate-video", params?: GenerateVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "text-to-video", params: TextToVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
-    runAndWait<T extends string>(type: T, params?: Record<string, unknown>, opts?: RunAndWaitOptions): Promise<T extends "generate-3d-scene" | "edit-3d-scene" ? Scene3DJobOutput : NodeJobOutput>;
+    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 : NodeJobOutput>;
     /**
      * Fan out N async runs of the same node `type` to completion concurrently —
      * the candidate-grid path (generate N stills/clips in parallel). Each runs
@@ -1050,6 +1150,11 @@ declare class Scene3DResource {
     private client;
     constructor(client: NodaroClient);
     capabilities(): Promise<Scene3DCapabilities>;
+    /** Current access to both the delivery and its source is required on every read. */
+    getDelivery(jobId: string): Promise<Scene3DDelivery>;
+    deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: {
+        signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
     /** Persist deterministic overlays without an LLM or a generation charge. */
     applyEdits(revisionId: string, params: RetainedScene3DEditParams): Promise<RetainedScene3DEditResult>;
     /** Asset access is scoped to an exact retained revision, with fresh authentication. */
@@ -1064,6 +1169,41 @@ declare class Scene3DResource {
     generateAndWait(params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     edit(params: EditScene3DParams): Promise<RunNodeResult>;
     editAndWait(params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
+    /**
+     * Price a 3D Render Pro request WITHOUT starting it.
+     *
+     * Takes the same body a run takes, minus the `quoteId`, and answers a
+     * ceiling (`maxCredits`), a `breakdown` to show, and the
+     * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+     * nothing — a quote is a price, not a purchase.
+     */
+    quotePro(params: Pro3DRenderParams): Promise<Pro3DRenderQuote>;
+    /**
+     * Submit a quoted 3D Render Pro run.
+     *
+     * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+     * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+     * supply your own, which you should when retrying a call that timed out.
+     *
+     * Availability is a property of the deployment: `capabilities().pro` says
+     * whether this install can serve it, and which controls you may offer.
+     */
+    runPro(params: Pro3DRenderRunParams, options?: Pro3DRenderRunOptions): Promise<RunNodeResult>;
+    /**
+     * Quote if needed, run, and wait — the whole operation in one call.
+     *
+     * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+     * this quotes the identical body first, so the run is admitted against a
+     * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+     * you already showed the user.
+     *
+     * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+     * (the exact composition it was rendered from), plus the revision, poster,
+     * validation and renderer metadata. Re-render that same `scenePlan` later
+     * with {@link render}, or with a `{kind:'scene'}` source; that costs no
+     * authoring.
+     */
+    renderProAndWait(params: Pro3DRenderParams | Pro3DRenderRunParams, options?: RunAndWaitOptions & Pro3DRenderRunOptions): Promise<Pro3DRenderJobOutput>;
     /** Uses the supplied immutable revision; never starts authoring or a rebuild. */
     render(params: RenderScene3DParams): Promise<RunNodeResult>;
     renderAndWait(params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>;
@@ -6841,4 +6981,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioImportSummary, type StudioJobStartedResponse, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, type StudioProduction, type StudioProductionDetail, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioImportSummary, type StudioJobStartedResponse, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, type StudioProduction, type StudioProductionDetail, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Scene3DJobOutputAny, Scene3DPlanV2, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
+import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
 export { AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared';
 import { DirectionFields, SubjectFields, PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
@@ -659,6 +659,27 @@ interface RetainedScene3DEditResult {
     scenePlan: Scene3DPlanV2;
     changeSummary: string;
 }
+interface Scene3DDeliveryAsset {
+    assetId: string;
+    kind: "poster" | "validation-report";
+    usage: "poster" | "validation";
+    byteLength: number;
+    sha256: string;
+    viaRevisionId: string | null;
+}
+/** Export evidence is retained separately from the immutable scene it rendered. */
+interface Scene3DDelivery {
+    deliveryId: string;
+    sceneRevisionId: string;
+    sourcePlanSha256: string;
+    sourceContentHash: string | null;
+    sourceJobId: string | null;
+    workflowId: string | null;
+    mode: "authored" | "render-only";
+    createdAt: string;
+    access: "view" | "edit" | "own";
+    assets: Scene3DDeliveryAsset[];
+}
 type Scene3DAuthoringEngine = "basic" | "blender-cloud" | "blender-local";
 interface Scene3DCapabilities {
     basic: {
@@ -671,6 +692,13 @@ interface Scene3DCapabilities {
         sceneSchemaVersions: number[];
         maxRepairPasses: number;
     };
+    /**
+     * What this deployment can serve for `pro-3d-render`, including which
+     * quality profiles, engines and aspect ratios a client may OFFER. Optional so
+     * a client of this version reads an older backend without throwing; absent
+     * means the node is unavailable.
+     */
+    pro?: Pro3DRenderCapabilities;
 }
 interface Scene3DEngineParams {
     /** Basic is the default. Discover optional engines through scene3d.capabilities(). */
@@ -709,6 +737,62 @@ interface EditScene3DParams extends Record<string, unknown>, Scene3DEngineParams
     workflowId?: string;
     nodeId?: string;
 }
+/**
+ * 3D Render Pro — ONE durable operation producing a composition and its MP4.
+ *
+ * `source` is a strict discriminated union, not a bag of optionals:
+ *  - `{kind:'prompt', prompt, references?}` authors a new scene;
+ *  - `{kind:'scene', revisionId, sourceJobId}` with NO `editPrompt` is the
+ *    render-only export — it spends no authoring or build credits, and OMIT
+ *    the field rather than sending `""`, which would buy an authoring pass;
+ *  - `{kind:'local-export', exportId, connectionId}` uses a paired desktop.
+ *
+ * There is no model or effort field: the planner is fixed and server-owned.
+ *
+ * `durationSeconds` / `fps` / `aspectRatio` on a `scene` source are an EXPLICIT
+ * re-time request. Omit them to keep the source's own timing; a conflicting
+ * override is rejected rather than silently applied.
+ */
+interface Pro3DRenderParams extends Record<string, unknown> {
+    source: Pro3DRenderSource;
+    /** Optional. An unknown or unavailable engine is rejected, never downgraded. */
+    engine?: Pro3DRenderEngine;
+    /** Names a paired desktop for a local run. */
+    localConnectionId?: string;
+    durationSeconds?: number;
+    fps?: number;
+    aspectRatio?: string;
+    quality?: Pro3DRenderQuality;
+    style?: Pro3DRenderStyle;
+    /** Correction budget, 0-2. Each pass is paid work. */
+    maxRepairPasses?: number;
+    /**
+     * Which scene-schema versions THIS client can render. A prompt or
+     * local-export source mints v2, so omitting 2 is refused for free; a scene
+     * source inherits its revision's version and is left to the server.
+     */
+    acceptedSceneSchemaVersions?: readonly number[];
+    workflowId?: string;
+    nodeId?: string;
+    /** Keep every artifact of this run out of publicly-readable storage. */
+    forcePrivate?: boolean;
+}
+/** A run additionally carries the quote it was priced under. */
+interface Pro3DRenderRunParams extends Pro3DRenderParams {
+    quoteId: string;
+}
+/** The quote's answer. `maxCredits` is a ceiling; quoting spends nothing. */
+type Pro3DRenderQuote = Readonly<Pro3DRenderQuote$1> & Readonly<Record<string, unknown>>;
+/** Per-call transport controls for the paid run. */
+interface Pro3DRenderRunOptions {
+    /**
+     * The `Idempotency-Key` the run is submitted under. Reuse the same value when
+     * retrying a call that timed out, so the run is not started twice; the SDK
+     * generates a fresh one per call when this is omitted, because two deliberate
+     * calls are two runs.
+     */
+    idempotencyKey?: string;
+}
 /** Render the exact scene revision through the existing render-video node. */
 interface RenderScene3DParams extends Record<string, unknown> {
     planType: "3d-scene";
@@ -718,6 +802,8 @@ interface RenderScene3DParams extends Record<string, unknown> {
 }
 /** Preserve the shared wire contract while allowing additive job metadata. */
 type Scene3DJobOutput = Readonly<Scene3DJobOutputAny> & Readonly<Record<string, unknown>>;
+/** The settled 3D Render Pro result, plus any additive job metadata. */
+type Pro3DRenderJobOutput = Readonly<Pro3DRenderJobOutput$1> & Readonly<Record<string, unknown>>;
 
 type NodeCategory = "input" | "parameter" | "ai-image" | "ai-video" | "ai-audio" | "ai-text" | "processing" | "composition" | "trigger" | "output" | "control" | "entity" | "utility";
 type OutputType = "text" | "image" | "video" | "audio" | "data" | "none";
@@ -945,6 +1031,18 @@ interface RunAndWaitOptions {
     readonly pollMs?: number;
     /** Wall-clock cap before giving up, in ms. Default ~15 min (900_000). */
     readonly maxMs?: number;
+    /**
+     * `Idempotency-Key` for the submit half. Reuse the same value when retrying a
+     * call that timed out, so the run is not started or charged twice. Omitted →
+     * no key, which is the historical behaviour for every node that does not
+     * require one.
+     */
+    readonly idempotencyKey?: string;
+}
+/** Per-call transport controls for {@link NodesResource.run}. */
+interface RunNodeOptions {
+    /** `Idempotency-Key` header. See {@link RunAndWaitOptions.idempotencyKey}. */
+    readonly idempotencyKey?: string;
 }
 /** One settled result from {@link NodesResource.runMany}. */
 interface RunManyResult {
@@ -984,11 +1082,12 @@ declare class NodesResource {
     run(type: "generate-3d-scene", params: GenerateScene3DParams): Promise<RunNodeResult>;
     run(type: "edit-3d-scene", params: EditScene3DParams): Promise<RunNodeResult>;
     run(type: "render-video", params: RenderScene3DParams): Promise<RunNodeResult>;
+    run(type: "pro-3d-render", params: Pro3DRenderRunParams, options?: RunNodeOptions): Promise<RunNodeResult>;
     run(type: "generate-image", params?: GenerateImageParams): Promise<RunNodeResult>;
     run(type: "generate-video", params?: GenerateVideoParams): Promise<RunNodeResult>;
     run(type: "text-to-video", params: TextToVideoParams): Promise<RunNodeResult>;
     run(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams): Promise<RunNodeResult>;
-    run(type: string, params?: Record<string, unknown>): Promise<RunNodeResult>;
+    run(type: string, params?: Record<string, unknown>, options?: RunNodeOptions): Promise<RunNodeResult>;
     /**
      * Run a single async node to completion: {@link run} it, extract the
      * `{ jobId }`, then client-poll `jobs.getStatus(jobId)` every `pollMs`
@@ -1019,11 +1118,12 @@ declare class NodesResource {
     runAndWait(type: "generate-3d-scene", params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     runAndWait(type: "edit-3d-scene", params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     runAndWait(type: "render-video", params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>;
+    runAndWait(type: "pro-3d-render", params: Pro3DRenderRunParams, options?: RunAndWaitOptions): Promise<Pro3DRenderJobOutput>;
     runAndWait(type: "generate-image", params?: GenerateImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "generate-video", params?: GenerateVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "text-to-video", params: TextToVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
-    runAndWait<T extends string>(type: T, params?: Record<string, unknown>, opts?: RunAndWaitOptions): Promise<T extends "generate-3d-scene" | "edit-3d-scene" ? Scene3DJobOutput : NodeJobOutput>;
+    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 : NodeJobOutput>;
     /**
      * Fan out N async runs of the same node `type` to completion concurrently —
      * the candidate-grid path (generate N stills/clips in parallel). Each runs
@@ -1050,6 +1150,11 @@ declare class Scene3DResource {
     private client;
     constructor(client: NodaroClient);
     capabilities(): Promise<Scene3DCapabilities>;
+    /** Current access to both the delivery and its source is required on every read. */
+    getDelivery(jobId: string): Promise<Scene3DDelivery>;
+    deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: {
+        signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
     /** Persist deterministic overlays without an LLM or a generation charge. */
     applyEdits(revisionId: string, params: RetainedScene3DEditParams): Promise<RetainedScene3DEditResult>;
     /** Asset access is scoped to an exact retained revision, with fresh authentication. */
@@ -1064,6 +1169,41 @@ declare class Scene3DResource {
     generateAndWait(params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
     edit(params: EditScene3DParams): Promise<RunNodeResult>;
     editAndWait(params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput>;
+    /**
+     * Price a 3D Render Pro request WITHOUT starting it.
+     *
+     * Takes the same body a run takes, minus the `quoteId`, and answers a
+     * ceiling (`maxCredits`), a `breakdown` to show, and the
+     * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+     * nothing — a quote is a price, not a purchase.
+     */
+    quotePro(params: Pro3DRenderParams): Promise<Pro3DRenderQuote>;
+    /**
+     * Submit a quoted 3D Render Pro run.
+     *
+     * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+     * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+     * supply your own, which you should when retrying a call that timed out.
+     *
+     * Availability is a property of the deployment: `capabilities().pro` says
+     * whether this install can serve it, and which controls you may offer.
+     */
+    runPro(params: Pro3DRenderRunParams, options?: Pro3DRenderRunOptions): Promise<RunNodeResult>;
+    /**
+     * Quote if needed, run, and wait — the whole operation in one call.
+     *
+     * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+     * this quotes the identical body first, so the run is admitted against a
+     * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+     * you already showed the user.
+     *
+     * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+     * (the exact composition it was rendered from), plus the revision, poster,
+     * validation and renderer metadata. Re-render that same `scenePlan` later
+     * with {@link render}, or with a `{kind:'scene'}` source; that costs no
+     * authoring.
+     */
+    renderProAndWait(params: Pro3DRenderParams | Pro3DRenderRunParams, options?: RunAndWaitOptions & Pro3DRenderRunOptions): Promise<Pro3DRenderJobOutput>;
     /** Uses the supplied immutable revision; never starts authoring or a rebuild. */
     render(params: RenderScene3DParams): Promise<RunNodeResult>;
     renderAndWait(params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>;
@@ -6841,4 +6981,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioImportSummary, type StudioJobStartedResponse, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, type StudioProduction, type StudioProductionDetail, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioImportSummary, type StudioJobStartedResponse, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, type StudioProduction, type StudioProductionDetail, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };

package/dist/index.js

@@ -538,13 +538,19 @@ var NodesResource = class {
   get(type) {
     return this.client.request("GET", `/v1/nodes/${encodeURIComponent(type)}`);
   }
-  run(type, params = {}) {
+  run(type, params = {}, options = {}) {
     const route = type === "generate-3d-scene" ? "/v1/3d-scene/generate" : type === "edit-3d-scene" ? "/v1/3d-scene/edit" : type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : `/v1/${encodeURIComponent(type)}`;
-    return this.client.request("POST", route, { body: params });
+    return this.client.request("POST", route, {
+      body: params,
+      // Transport-level retry safety, opt-in per call. The platform reads the
+      // standard header, so a caller that reuses a key on a retry gets the
+      // same run back instead of a second charge.
+      ...options.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
+    });
   }
   async runAndWait(type, params = {}, opts = {}) {
     if (opts.signal?.aborted) throw new JobAbortedError();
-    const result = await this.run(type, params);
+    const result = await this.run(type, params, { idempotencyKey: opts.idempotencyKey });
     const jobId = extractJobId(result, type);
     return this.pollJob(jobId, type, opts);
   }
@@ -605,6 +611,10 @@ var NodesResource = class {
     }
   }
 };
+function newIdempotencyKey() {
+  const random = globalThis.crypto?.randomUUID?.();
+  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
+}
 var Scene3DResource = class {
   constructor(client) {
     this.client = client;
@@ -613,6 +623,22 @@ var Scene3DResource = class {
   capabilities() {
     return this.client.request("GET", "/v1/3d-scene/capabilities");
   }
+  /** Current access to both the delivery and its source is required on every read. */
+  getDelivery(jobId) {
+    return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
+  }
+  deliveryAssetBytes(jobId, asset, options) {
+    if (asset.kind !== "poster" && asset.kind !== "validation-report" || asset.usage !== (asset.kind === "poster" ? "poster" : "validation")) {
+      throw new Error("This asset is not available through the delivery endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene delivery asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
   /** Persist deterministic overlays without an LLM or a generation charge. */
   applyEdits(revisionId, params) {
     return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
@@ -649,6 +675,53 @@ var Scene3DResource = class {
   editAndWait(params, options) {
     return this.client.nodes.runAndWait("edit-3d-scene", params, options);
   }
+  /**
+   * Price a 3D Render Pro request WITHOUT starting it.
+   *
+   * Takes the same body a run takes, minus the `quoteId`, and answers a
+   * ceiling (`maxCredits`), a `breakdown` to show, and the
+   * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+   * nothing — a quote is a price, not a purchase.
+   */
+  quotePro(params) {
+    return this.client.request("POST", "/v1/pro-3d-render/quote", { body: params });
+  }
+  /**
+   * Submit a quoted 3D Render Pro run.
+   *
+   * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+   * supply your own, which you should when retrying a call that timed out.
+   *
+   * Availability is a property of the deployment: `capabilities().pro` says
+   * whether this install can serve it, and which controls you may offer.
+   */
+  runPro(params, options) {
+    return this.client.nodes.run("pro-3d-render", params, {
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Quote if needed, run, and wait — the whole operation in one call.
+   *
+   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+   * this quotes the identical body first, so the run is admitted against a
+   * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+   * you already showed the user.
+   *
+   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+   * (the exact composition it was rendered from), plus the revision, poster,
+   * validation and renderer metadata. Re-render that same `scenePlan` later
+   * with {@link render}, or with a `{kind:'scene'}` source; that costs no
+   * authoring.
+   */
+  async renderProAndWait(params, options) {
+    const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
+    return this.client.nodes.runAndWait("pro-3d-render", { ...params, quoteId }, {
+      ...options,
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
   /** Uses the supplied immutable revision; never starts authoring or a rebuild. */
   render(params) {
     return this.client.nodes.run("render-video", params);
@@ -3090,7 +3163,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.1.0" ;
+var SDK_VERSION = "2.2.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {