@nodaro/sdk 2.33.0 → 2.38.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { AppRun, AppRunResult, AppRunResumePlan, AppRunResumeRefusalCode, AppRunResumeResult, AppRunResumeStep, AppsResource, DeleteAppRunResult, ListAppRunsParams, ListAppsParams, ListAppsResult, PublishedApp, PublishedAppDetail, ResumeAppRunOptions, RunAppOptions } from './entries/apps.js';
 export { AudioResource, TranscribeJobOutput, TranscribeWord } from './entries/audio.js';
 export { BillingAccountSummary, BillingMoney, BillingMonthlyPrice, BillingPlan, BillingPlanPrices, BillingPlansResult, BillingPriceCredits, BillingResource, BillingSubscription, BillingSubscriptionResult, BillingSurface, BillingTopUp, BillingUsageCategory, BillingYearlyPrice } from './entries/billing.js';
+export { CastSwapEstimate, CastSwapFaceMasking, CastSwapFaceMaskingZone, CastSwapFullQualityEstimate, CastSwapFullQualityParams, CastSwapFullQualityRefusalCode, CastSwapFullQualityResult, CastSwapLocationRole, CastSwapParams, CastSwapPersonRole, CastSwapPetRole, CastSwapProductRole, CastSwapReference, CastSwapResource, CastSwapRole, CastSwapRolePreviewSettings, CastSwapRunOptions, CastSwapTraitSource } from './entries/cast-swap.js';
 export { CatalogsListResponse, CatalogsResource, ProjectedCatalog, ProjectedCatalogDimension, ProjectedCatalogOption, ProjectedCatalogSection } from './entries/catalogs.js';
 export { ApprovePortraitResult, Character, CharacterDetail, CharacterTrainingState, CharacterTrainingStatus, CharacterUsage, CharactersResource, DuplicateCharacterInput, GenerateAssetInput, GenerateCharacterInput, GenerateCharacterResult, GenerateMotionInput, GetCharacterOptions, ListCharactersParams, ListCharactersResult, RecaptionResult, ReferencePhoto, ReferencePhotoKind, TrainCharacterInput, TrainCharacterRefusalCode, TrainCharacterResult, UpsertCharacterInput, UpsertCharacterResult, buildPersonSeedPrompt } from './entries/characters.js';
 export { NodaroClient, createClient } from './entries/client.js';
@@ -12,13 +13,13 @@ export { ActionCard, ActionCardKind, ActionCardPriority, AdviceFamily, AdviceRec
 export { CompetitorsResource } from './entries/competitors.js';
 export { CopilotMemorySavedFrameData, CopilotMessage, CopilotMessagePart, CopilotMetadataFrameData, CopilotModelTier, CopilotResource, CopilotRunMode, CopilotRunProposalFrameData, CopilotRunProposalNode, CopilotStreamFrame, CopilotStreamOptions, CopilotSurface, CopilotThread, CopilotThreadWorkflow, CopilotToolCallFrameData, CopilotWiredAsset, CopilotWorkflowCreatedFrameData, CopilotWorkflowUpdateFrameData, CreateCopilotThreadInput } from './entries/copilot.js';
 export { ApproveCreatureMainImageResult, CREATURE_ASSET_TYPES, CreateCreatureInput, Creature, CreatureAssetType, CreatureDetail, CreatureReferencePhoto, CreatureReferencePhotoKind, CreatureVoice, CreaturesResource, GenerateCreatureAssetInput, GenerateCreatureAssetResult, GenerateCreatureInput, GenerateCreatureMotionInput, GenerateCreatureMotionResult, GenerateCreatureResult, ListCreaturesParams, RecaptionCreatureResult, UpdateCreatureInput, UpdateCreatureResult, UpsertCreatureInput, UpsertCreatureResult } from './entries/creatures.js';
-export { CreditTransaction, CreditTransactionsOptions, CreditTransactionsPage, CreditsResource, FreeGrantState, ModelCostsResult, SignupGrantClaimResult, SignupKeys, UserBalance, WelcomeOfferClaimInput, WelcomeOfferClaimResult, WelcomeOfferSeenResult, WelcomeOfferState } from './entries/credits.js';
+export { CreditTransaction, CreditTransactionsOptions, CreditTransactionsPage, CreditsResource, FreeGrantState, ModelCostError, ModelCostResult, ModelCostsResult, SignupGrantClaimResult, SignupKeys, UserBalance, WelcomeOfferClaimInput, WelcomeOfferClaimResult, WelcomeOfferSeenResult, WelcomeOfferState } from './entries/credits.js';
 export { ChapterSet, EditPlanMode, EditPlanTier, Edl, EdlClipSet, SpeakerMapResult, Transcript, unwrapEditPlanOutput } from '@nodaro/shared/edl';
 export { ApplyEdlInput, AudioSyncInput, AudioSyncOffset, AudioSyncResult, AudioSyncSource, CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, CameraSwitchInput, ClipPackEmphasis, ClipPackInput, EditJobResult, EditPlanInput, EditPlanSource, EditResource, EpisodeChaptersInput, EpisodeTrailerInput, SilenceDetectInput, SilenceRanges, SpeakerLayoutInput, SpeakerMapInput, SpeakerMapSource, TRAILER_FORMATS, TightenEpisodeEstimate, TightenEpisodeInput, TightenEpisodeJobResult, TrailerFormat, UseCaseContinueInput, UseCaseEstimate, UseCaseJobResult, UseCaseRecordingsInput, UseCaseRequestOptions } from './entries/edit.js';
-export { AlreadyRunningError, AppRunVersionChangedError, ContinuationPreviewPendingError, ContinuationRefusedError, ForbiddenError, HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictCode, WorkflowConflictError, throwFromResponse } from './entries/errors.js';
+export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapCode, CreditCapExceededError, ForbiddenError, HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictCode, WorkflowConflictError, throwFromResponse } from './entries/errors.js';
 export { CancelExecutionParams, ExecutionStatus, ExecutionTriggerType, ExecutionsResource, ListExecutionsForWorkflowParams, ListExecutionsPage, NodeExecutionState, WorkflowExecution, WorkflowExecutionSummary } from './entries/executions.js';
 export { BrowseGalleryParams, GalleryItem, GalleryMediaType, GalleryPage, GalleryResource, ToggleFavoriteResult } from './entries/gallery.js';
-export { CancelJobResult, CreditStatus, DeleteJobResult, Job, JobErrorHint, JobRating, JobRatingFilter, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, RateJobResult, SafetyBlockHint } from './entries/jobs.js';
+export { CancelJobResult, CreditStatus, CreditsHint, DeleteJobResult, InputRefusedHint, Job, JobErrorHint, JobFromUploadParams, JobRating, JobRatingFilter, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, RateJobResult, SafetyBlockHint } from './entries/jobs.js';
 export { LibraryAsset, LibraryResource, ListLibraryParams, ListLibraryResult } from './entries/library.js';
 export { LlmResource, LlmStructuredInput, LlmStructuredJobInput, LlmStructuredJobOutput, LlmStructuredResult } from './entries/llm.js';
 export { ApproveMainImageResult, CreateLocationInput, GenerateLocationAssetInput, GenerateLocationInput, GenerateLocationMotionInput, GenerateLocationResult, GenerateSurroundContinuationInput, ListLocationsParams, Location, LocationDetail, LocationReferencePhoto, LocationReferencePhotoKind, LocationsResource, RecaptionLocationResult, UpdateLocationInput, UpdateLocationResult } from './entries/locations.js';
@@ -30,7 +31,7 @@ export { CreateNodePresetGroupInput, CreateNodePresetInput, FactoryPresetEntry,
 export { ConnectedReference, DescribedReference, GenericEdge, GenericNode } from '@nodaro/shared/types';
 export { VideoCharacterReference, VideoCharacterVoice } from '@nodaro/shared/video';
 export { AudioFxPreset, GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, d as EditScene3DParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, j as GenerateScene3DParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, P as Pro3DRenderJobOutput, u as Pro3DRenderParams, v as Pro3DRenderQuote, w as Pro3DRenderRunOptions, x as Pro3DRenderRunParams, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, z as RenderScene3DParams, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, Y as Scene3DDeliveryAssetKind, Z as Scene3DJobOutput, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from './nodes-C-wrO6Sg.js';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, d as EditScene3DParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, j as GenerateScene3DParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, P as Pro3DRenderJobOutput, u as Pro3DRenderParams, v as Pro3DRenderQuote, w as Pro3DRenderRunOptions, x as Pro3DRenderRunParams, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, z as RenderScene3DParams, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, Y as Scene3DDeliveryAssetKind, Z as Scene3DJobOutput, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from './nodes-9WpYNWtS.js';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { 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, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, ImageToImageAttachColumn, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 export { AccessTokenResponse, ExchangeCodeInput, OAuthAppInfo, OAuthResource } from './entries/oauth.js';
@@ -52,8 +53,9 @@ export { CreateSessionInput, GenerationSession, ListSessionItemsParams, ListSess
 export { CreateShotInput, Shot, ShotEntityRef, ShotMode, ShotsResource, UpdateShotInput } from './entries/shots.js';
 export { StudioDocumentJson, StudioEditInput, StudioGenerationReply, StudioKeyframeAcceptanceInput, StudioKeyframeGenerationInput, StudioKeyframeRecord, StudioProductionCapabilities, StudioProductionRecord, StudioProductionReply, StudioResource, StudioShotGenerationInput } from './entries/studio.js';
 export { BrowseTemplatesParams, BrowseTemplatesResult, CloneTemplateParams, CloneTemplateResult, Template, TemplateBrowseCard, TemplateSort, TemplatesResource } from './entries/templates.js';
+export { ListTrendRunsParams, ListTrendsParams, TrendCard, TrendChips, TrendChoice, TrendDetail, TrendDetailSlot, TrendEstimate, TrendExample, TrendPage, TrendResolution, TrendRun, TrendRunDisplaySlot, TrendRunOptions, TrendRunRequest, TrendRunSlot, TrendSlotKind, TrendTag, TrendsResource } from './entries/trends.js';
 export { TutorialCategory, TutorialFlowItem, TutorialVideoItem, TutorialsResource } from './entries/tutorials.js';
-export { UploadResult, UploadsResource } from './entries/uploads.js';
+export { UploadJsonResult, UploadResult, UploadsResource } from './entries/uploads.js';
 export { ContinueVideoProResult, StopVideoProResult, VideoProResource } from './entries/video-pro.js';
 export { DubbingInput, VcpAnalysis, VcpAnalysisSpeaker, VcpAnalyzeInput, VcpExportInput, VcpExportTrack, VoiceChangerProInput, VoiceChangerProVoice, VoiceDesignInput, VoiceRemixInput, VoicesResource } from './entries/voices.js';
 export { C as CreateWebhookEndpointInput, a as CreatedWebhookEndpoint, J as JobWebhookEvent, L as ListWebhookDeliveriesParams, P as PingWebhookEvent, R as RotateWebhookSecretInput, b as RotatedWebhookSecret, U as UpdateWebhookEndpointInput, W as WebhookDelivery, c as WebhookDeliveryPage, d as WebhookDeliveryStatus, e as WebhookEndpoint, f as WebhookEvent, g as WebhookEventType, h as WebhookJobEvent, i as WebhooksResource } from './webhooks-BJawEIz8.js';
@@ -62,7 +64,7 @@ export { ExecutionOutcome, NodeExecutionStatus, NodeSkipReason, OUTPUT_BEARING_N
 export { AddCollaboratorInput, Collaborator, CreateWorkflowInput, DroppedCollaborator, ListWorkflowsParams, RenderFinalParams, RenderFinalQuote, RunWorkflowOptions, RunWorkflowParams, RunWorkflowResult, SharedWorkflow, UpdateWorkflowInput, Workflow, WorkflowsResource } from './entries/workflows.js';
 export { CreateWorkspaceInput, WorkspacesResource } from './entries/workspaces.js';
 export { AnimateSubGate, ChatEnabledStage, PipelineInput, PipelineMode, PipelineStageName, PipelineStatus, ProposedChange, SharedVoice, SubGateName, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse } from '@nodaro/shared/pipeline';
-export { G as GetProductionOptions, L as ListStudioProductionsOptions, S as StudioClientRequestId, a as StudioCloneRequest, b as StudioCreateProductionRequest, c as StudioDescribeRequest, d as StudioExportPlanOptions, e as StudioExportPlanResponse, f as StudioExportStep, g as StudioFrameRequest, h as StudioGenerateEstimate, i as StudioGenerateOptions, j as StudioGenerateRequest, k as StudioGenerateResponse, l as StudioGenerateResult, m as StudioImportSummary, n as StudioJobStartedResponse, o as StudioListProductionsResponse, p as StudioMediaResponse, q as StudioMusicRequest, r as StudioOpClass, s as StudioOpsDryRunReceipt, t as StudioOpsDryRunResponse, u as StudioOpsImpact, v as StudioOpsReceipt, w as StudioOpsRequest, x as StudioOpsResponse, y as StudioPlanIssue, z as StudioProduction, A as StudioProductionDetail, B as StudioProductionResponse, C as StudioProductionsResource, D as StudioReconcileResponse, E as StudioRevoiceRequest, F as StudioSkillResponse, H as StudioValidatePlanResponse, I as StudioVideoLane, J as StudioVoiceRequest, K as isStudioGenerateEstimate } from './studio-productions-vbCNSbtf.js';
+export { G as GetProductionOptions, L as ListStudioProductionsOptions, S as StudioClientRequestId, a as StudioCloneRequest, b as StudioCreateProductionRequest, c as StudioDescribeRequest, d as StudioExportPlanOptions, e as StudioExportPlanResponse, f as StudioExportStep, g as StudioFrameRequest, h as StudioGenerateEstimate, i as StudioGenerateOptions, j as StudioGenerateRequest, k as StudioGenerateResponse, l as StudioGenerateResult, m as StudioImportSummary, n as StudioJobStartedResponse, o as StudioListProductionsResponse, p as StudioMediaResponse, q as StudioMusicRequest, r as StudioOpClass, s as StudioOpsDryRunReceipt, t as StudioOpsDryRunResponse, u as StudioOpsImpact, v as StudioOpsReceipt, w as StudioOpsRequest, x as StudioOpsResponse, y as StudioOpsText, z as StudioPlanIssue, A as StudioProduction, B as StudioProductionDetail, C as StudioProductionResponse, D as StudioProductionsResource, E as StudioReconcileResponse, F as StudioRevoiceRequest, H as StudioSkillResponse, I as StudioValidatePlanResponse, J as StudioVideoLane, K as StudioVoiceRequest, M as isStudioGenerateEstimate } from './studio-productions-DtTE8mdl.js';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, buildPersonHints } from '@nodaro/prompts/person';
 import '@nodaro/shared/captions';
 import '@nodaro/prompts/presets';

package/dist/index.js

@@ -1,14 +1,17 @@
+import './chunk-VPAUN75Q.js';
+import './chunk-MEKI37WI.js';
 export { WebhookSignatureError, verifyWebhookSignature } from './chunk-VGTRKXF2.js';
 import './chunk-PGYQ754I.js';
 import './chunk-FHEYAW5H.js';
+import './chunk-CRCPRZFN.js';
 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-MEKI37WI.js';
+import './chunk-HLHR3R4P.js';
 import './chunk-QVQCKOBM.js';
 import './chunk-IQ6KWSXP.js';
 import './chunk-KZQKFBRN.js';
@@ -16,7 +19,7 @@ import './chunk-7A7HYFGM.js';
 export { RECAST_SEGMENT_PACKS } from './chunk-RJIJVVXS.js';
 import './chunk-6JFNBAKV.js';
 import './chunk-OJDBSKC2.js';
-import './chunk-CRCPRZFN.js';
+import './chunk-ES2E65HT.js';
 import './chunk-OMH7ATOQ.js';
 import './chunk-37Y5QAVA.js';
 import './chunk-NX67YIF3.js';
@@ -24,7 +27,7 @@ export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from './chunk-ZYPH2FPT.js';
 import './chunk-X7RDNMN7.js';
 import './chunk-OLPA44QJ.js';
 export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from './chunk-RKVRCNMB.js';
-import './chunk-HLHR3R4P.js';
+export { unwrapEditPlanOutput } from './chunk-UKB64254.js';
 import './chunk-CJFIOVBA.js';
 import './chunk-OPR4TULG.js';
 import './chunk-C22RJDW3.js';
@@ -32,7 +35,7 @@ import './chunk-I3TYBAOX.js';
 import './chunk-A3THLBFG.js';
 import './chunk-UIFFNTUX.js';
 import './chunk-HFBR6G36.js';
-import './chunk-ES2E65HT.js';
+import './chunk-Z5OMWAQX.js';
 import './chunk-GAZJ2PA3.js';
 import './chunk-GD24ZRFD.js';
 import './chunk-ELSOVJPF.js';
@@ -40,63 +43,64 @@ import './chunk-AUDHV3OE.js';
 import './chunk-EXLAHZKF.js';
 import './chunk-V4GPQ6Y2.js';
 import './chunk-YOOZB4RL.js';
-export { unwrapEditPlanOutput } from './chunk-UKB64254.js';
 import './chunk-3PPSGM5X.js';
 import './chunk-HRXXGGSJ.js';
 import './chunk-M6Y5TOYE.js';
+import './chunk-KARJ7P7Y.js';
 import './chunk-SUCHGNYT.js';
 import './chunk-SLPD47SR.js';
-export { NodaroClient, createClient } from './chunk-JSCC2N7N.js';
+export { NodaroClient, createClient } from './chunk-AVOQ5DG4.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 { VoicesResource } from './chunk-T7N7DFQJ.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 { SCENE3D_DELIVERY_ASSET_USAGE, Scene3DResource } from './chunk-NNHWH7ER.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-6ECW23GA.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 { PALETTE_DIRECTION_PREFIX, PalettesResource, paletteDirectionId } from './chunk-WEQWU2IC.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 { MediaResource } from './chunk-4NLVBYMW.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-Y5CYFNNW.js';
+export { CopilotResource } from './chunk-D2ILCSOQ.js';
+import './chunk-7CUWAVWB.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-Q6HY2Q5V.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 { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from './chunk-5A7J24LN.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 { 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-ED3ZOX3M.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';
-import './chunk-Z5OMWAQX.js';
-export { CollectionsResource } from './chunk-4WRDR4GN.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -521,6 +521,25 @@ interface VideoToVideoParams extends GenerationSessionParams {
     promptExtend?: boolean;
     /** Seedance 2.5 only: a 480p draft, finalized later with `video-upscale`. */
     draft?: boolean;
+    /**
+     * Seedance edit only (refused on other models): more images the edit can use.
+     * They follow `referenceImageUrl` when it is sent, so with it they are
+     * `{image:2}`, `{image:3}`, …, without it `{image:1}`, `{image:2}`, ….
+     * The model's cap applies (30 images on `seedance-2-5`).
+     */
+    referenceImageUrls?: string[];
+    /**
+     * Seedance edit only (refused on other models): extra clips the edit can use.
+     * Do not repeat `videoUrl` here: the source clip is `{video:1}`, these are
+     * `{video:2}`, `{video:3}`, …. The source counts toward the model's cap
+     * (10 clips on `seedance-2-5`), and every clip's length is priced.
+     */
+    referenceVideoUrls?: string[];
+    /**
+     * Seedance edit only (refused on other models): audio the edit can use,
+     * `{audio:1}`, `{audio:2}`, …. The model's cap applies (10 on `seedance-2-5`).
+     */
+    referenceAudioUrls?: string[];
     [k: string]: unknown;
 }
 /** One way the platform shaped the price — shown so a client can explain it. */
@@ -611,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`. */
@@ -997,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;
 }
 /**
@@ -1156,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.
      */
@@ -1274,6 +1305,9 @@ declare class NodesResource {
     quote(type: "text-to-video", params: TextToVideoParams): Promise<NodeQuote>;
     quote(type: "generate-video", params: GenerateVideoParams): Promise<NodeQuote>;
     quote(type: "video-to-video", params: VideoToVideoParams): Promise<NodeQuote>;
+    /** A Seedance 2.5 draft's 1080p finalize (`seedance-2-5-hd`) is priced from
+     *  the draft itself, including the clips it was made with. */
+    quote(type: "video-upscale", params: VideoUpscaleParams): Promise<NodeQuote>;
     quote(type: string, params?: Record<string, unknown>): Promise<NodeQuote>;
     /**
      * Run a single async node to completion: {@link run} it, extract the

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

@@ -521,6 +521,25 @@ interface VideoToVideoParams extends GenerationSessionParams {
     promptExtend?: boolean;
     /** Seedance 2.5 only: a 480p draft, finalized later with `video-upscale`. */
     draft?: boolean;
+    /**
+     * Seedance edit only (refused on other models): more images the edit can use.
+     * They follow `referenceImageUrl` when it is sent, so with it they are
+     * `{image:2}`, `{image:3}`, …, without it `{image:1}`, `{image:2}`, ….
+     * The model's cap applies (30 images on `seedance-2-5`).
+     */
+    referenceImageUrls?: string[];
+    /**
+     * Seedance edit only (refused on other models): extra clips the edit can use.
+     * Do not repeat `videoUrl` here: the source clip is `{video:1}`, these are
+     * `{video:2}`, `{video:3}`, …. The source counts toward the model's cap
+     * (10 clips on `seedance-2-5`), and every clip's length is priced.
+     */
+    referenceVideoUrls?: string[];
+    /**
+     * Seedance edit only (refused on other models): audio the edit can use,
+     * `{audio:1}`, `{audio:2}`, …. The model's cap applies (10 on `seedance-2-5`).
+     */
+    referenceAudioUrls?: string[];
     [k: string]: unknown;
 }
 /** One way the platform shaped the price — shown so a client can explain it. */
@@ -611,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`. */
@@ -997,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;
 }
 /**
@@ -1156,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.
      */
@@ -1274,6 +1305,9 @@ declare class NodesResource {
     quote(type: "text-to-video", params: TextToVideoParams): Promise<NodeQuote>;
     quote(type: "generate-video", params: GenerateVideoParams): Promise<NodeQuote>;
     quote(type: "video-to-video", params: VideoToVideoParams): Promise<NodeQuote>;
+    /** A Seedance 2.5 draft's 1080p finalize (`seedance-2-5-hd`) is priced from
+     *  the draft itself, including the clips it was made with. */
+    quote(type: "video-upscale", params: VideoUpscaleParams): Promise<NodeQuote>;
     quote(type: string, params?: Record<string, unknown>): Promise<NodeQuote>;
     /**
      * Run a single async node to completion: {@link run} it, extract the

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.33.0",
+  "version": "2.38.0",
   "description": "Typed REST client for the Nodaro API — workflows, jobs, executions, apps, characters, and more.",
   "type": "module",
   "license": "Apache-2.0",
@@ -35,6 +35,11 @@
       "import": "./dist/entries/billing.js",
       "require": "./dist/entries/billing.cjs"
     },
+    "./cast-swap": {
+      "types": "./dist/entries/cast-swap.d.ts",
+      "import": "./dist/entries/cast-swap.js",
+      "require": "./dist/entries/cast-swap.cjs"
+    },
     "./catalogs": {
       "types": "./dist/entries/catalogs.d.ts",
       "import": "./dist/entries/catalogs.js",
@@ -235,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",
@@ -297,7 +307,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@nodaro/shared": "^3.37.0",
+    "@nodaro/shared": "^3.38.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"]}