@nodaro/sdk 2.10.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,6 +1,6 @@
1
1
  import * as _nodaro_shared from '@nodaro/shared';
2
- 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, OverlayAnchor, 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';
3
- 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';
2
+ import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, NodeExecutionStateWire, 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, OverlayAnchor, CharacterMotionMetadata, 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';
3
+ 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, NodeExecutionStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, 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, nodeStateMayCarryOutput } from '@nodaro/shared';
4
4
  import { DirectionFields, SubjectFields, PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
5
5
  export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
6
6
 
@@ -565,19 +565,16 @@ type ExecutionTriggerType = "manual" | "webhook" | "schedule" | "app_run" | "sin
565
565
  /**
566
566
  * Per-node state inside an execution's `nodeStates` map. Keys are node IDs.
567
567
  *
568
- * Shape mirrors `services/workflow-engine/types.ts` plus the synthetic
569
- * single-node-job shape from `routes/workflow-execution.ts`.
568
+ * Extends the published wire contract in `@nodaro/shared`, which is what the
569
+ * orchestrator writes and the editor reads — so a field added there reaches
570
+ * SDK consumers as a typed field rather than through the index signature. The
571
+ * synthetic single-node-job shape from `routes/workflow-execution.ts` fits the
572
+ * same contract.
570
573
  */
571
- interface NodeExecutionState {
572
- status: string;
573
- nodeType?: string;
574
- jobId?: string | null;
575
- creditsUsed?: number;
576
- error?: string | null;
577
- startedAt?: string | null;
578
- completedAt?: string | null;
574
+ interface NodeExecutionState extends NodeExecutionStateWire {
579
575
  [key: string]: unknown;
580
576
  }
577
+
581
578
  /**
582
579
  * Workflow execution record. Returned by `get()` and `cancel()` (the cancel
583
580
  * endpoint returns `{ success: true }`, not the execution itself).
@@ -660,13 +657,48 @@ interface RetainedScene3DEditResult {
660
657
  scenePlan: Scene3DPlanV2;
661
658
  changeSummary: string;
662
659
  }
660
+ /**
661
+ * The kind of bytes a delivery descriptor names, and the usage it is pinned under.
662
+ *
663
+ * PAIRED, not two free enums: the platform refuses a pin whose usage is not the one its kind is
664
+ * defined to have, and a client that checks only one of the two would accept a mis-pinned
665
+ * artifact the server would then refuse. {@link SCENE3D_DELIVERY_ASSET_USAGE} is the map both
666
+ * halves are read from.
667
+ */
668
+ declare const SCENE3D_DELIVERY_ASSET_USAGE: {
669
+ readonly poster: "poster";
670
+ readonly "validation-report": "validation";
671
+ readonly "shot-still": "shot-still";
672
+ /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
673
+ readonly "source-json": "checkpoint";
674
+ };
675
+ type Scene3DDeliveryAssetKind = keyof typeof SCENE3D_DELIVERY_ASSET_USAGE;
676
+ /**
677
+ * One artifact a delivery pins, as a descriptor: opaque ids and digests only.
678
+ *
679
+ * Four kinds, and two of them are conditional:
680
+ *
681
+ * - `poster` and `validation-report` are on every delivery;
682
+ * - `shot-still` appears once per shot on a render that produced a contact sheet, and carries
683
+ * its own shot identity (`shotIndex`, `frame`, and the frame size);
684
+ * - `source-json` appears on ONE shape only — a `refused-authoring` delivery, published by a
685
+ * 3D Render Pro run whose recipe the compiler refused on every pass. It is the planner's last
686
+ * admitted recipe, and it is the only thing such a run leaves that names what was attempted.
687
+ * Reading it needs `edit` on the job's workflow (the same access the `.blend` export costs);
688
+ * a reader with less simply does not see the descriptor.
689
+ */
663
690
  interface Scene3DDeliveryAsset {
664
691
  assetId: string;
665
- kind: "poster" | "validation-report";
666
- usage: "poster" | "validation";
692
+ kind: Scene3DDeliveryAssetKind;
693
+ usage: (typeof SCENE3D_DELIVERY_ASSET_USAGE)[Scene3DDeliveryAssetKind];
667
694
  byteLength: number;
668
695
  sha256: string;
669
696
  viaRevisionId: string | null;
697
+ /** Set on a `shot-still` and absent on every other kind — never `null`. */
698
+ shotIndex?: number;
699
+ frame?: number;
700
+ width?: number;
701
+ height?: number;
670
702
  }
671
703
  /** Export evidence is retained separately from the immutable scene it rendered. */
672
704
  interface Scene3DDelivery {
@@ -824,9 +856,66 @@ interface RenderScene3DParams extends Record<string, unknown> {
824
856
  workflowId?: string;
825
857
  nodeId?: string;
826
858
  }
827
- /** Preserve the shared wire contract while allowing additive job metadata. */
859
+ /**
860
+ * Preserve the shared wire contract while allowing additive job metadata.
861
+ *
862
+ * A scene authored by an ADVANCED engine additionally reports what the run knows about its own
863
+ * answer, every field optional and all of them absent on the deterministic Basic lane:
864
+ * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION` (the planner's
865
+ * assumptions), `metadata.summary` (its description of what it authored), `repairPasses`
866
+ * (repairs actually run — `0` when the scene was accepted first time), `admissionRetries`
867
+ * (pre-build planner retries, which spend no repair pass), `mechanicalPasses` (repairs the engine
868
+ * applied from the compiler's own remedy with no planner call, counted APART from `repairPasses`
869
+ * on their own quoted allowance, each with a `REMEDY_AUTO_APPLIED` warning) and
870
+ * `restoredAssertions` (mandatory assertions put back after a planner answer re-shaped one the
871
+ * feedback had not named, each a `ASSERTION_RESTORED` warning).
872
+ *
873
+ * A scene that passed every mandatory assertion but did not get the visual reviewer's approval
874
+ * is delivered anyway, and `metadata.review` carries a verdict saying why. `verdict: "refused"`
875
+ * is the ADVISORY delivery — the reviewer objected once the repair budget was spent — with one
876
+ * `SCENE_REVIEW_REFUSED` warning per objection. `verdict: "unavailable"` is the UNREVIEWED
877
+ * delivery: the review produced no usable verdict after `attempts` asks — `reason: "provider"`
878
+ * when it never reached its provider, `"unusable"` when the provider answered with nothing usable
879
+ * (`Scene3DReviewUnavailableReason` in `@nodaro/shared`) — so nobody judged the scene, and
880
+ * `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE` (any objections under it came from
881
+ * review batches that answered usably first, and are not the whole verdict).
882
+ *
883
+ * `validation.status` stays `"passed"` on both, so `metadata.review` being present is the only
884
+ * reliable test — use `scene3DReviewVerdictOf` from `@nodaro/shared` rather than reading it by
885
+ * hand, and `scene3DReviewNote` rather than writing the sentence yourself: a message that says
886
+ * the reviewer refused a scene nobody reviewed invents an opinion.
887
+ */
828
888
  type Scene3DJobOutput = Readonly<Scene3DJobOutputAny> & Readonly<Record<string, unknown>>;
829
- /** The settled 3D Render Pro result, plus any additive job metadata. */
889
+ /**
890
+ * The settled 3D Render Pro result, plus any additive job metadata.
891
+ *
892
+ * On a run that AUTHORED, the result reports the run's own account of its answer:
893
+ * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION`, `metadata.summary`,
894
+ * `repairPasses` (`0` when accepted first time), `admissionRetries` (pre-build planner retries,
895
+ * which spend no repair pass), `mechanicalPasses` (repairs the engine authored itself from the
896
+ * compiler's own remedy, counted APART from `repairPasses` because they buy their own quoted
897
+ * allowance rather than spending one of your repairs) and `restoredAssertions`. A render-only
898
+ * export authored nothing, so it carries no summary and omits the counts rather than claiming `0`.
899
+ *
900
+ * The one case where `mechanicalPasses` IS a subset of `repairPasses` is a run quoted before that
901
+ * allowance existed — its quote carries no `mechanical` line. The discriminant is the quote, not
902
+ * the result, so read the quote you were given rather than deriving it from the two counts.
903
+ *
904
+ * A completed result may also be published without the visual reviewer's approval, and then
905
+ * `metadata.review` holds a verdict saying which way. `{ verdict: "refused", objections[],
906
+ * observed? }` is the ADVISORY delivery: every mandatory assertion passed, the reviewer still
907
+ * objected, and the scene was published once the repair budget was spent, with one
908
+ * `SCENE_REVIEW_REFUSED` warning per objection. `{ verdict: "unavailable", reason, attempts,
909
+ * objections[], observed? }` is the UNREVIEWED delivery: the review produced no usable verdict in
910
+ * `attempts` asks — `reason: "provider"` when it never reached its provider, `"unusable"` when the
911
+ * provider answered with nothing usable — so the assertion-passing scene was delivered with no
912
+ * verdict on it and `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE`. Objections on
913
+ * that arm are whatever review batches answered usably first — real, but not the whole verdict.
914
+ *
915
+ * `validation.status` is `"passed"` on both, so test for `metadata.review` — via
916
+ * `scene3DReviewVerdictOf` from `@nodaro/shared` — rather than for the status or the warnings,
917
+ * and render it with `scene3DReviewNote` rather than assuming a refusal.
918
+ */
830
919
  type Pro3DRenderJobOutput = Readonly<Pro3DRenderJobOutput$1> & Readonly<Record<string, unknown>>;
831
920
 
832
921
  type NodeCategory = "input" | "parameter" | "ai-image" | "ai-video" | "ai-audio" | "ai-text" | "processing" | "composition" | "trigger" | "output" | "control" | "entity" | "utility";
@@ -960,9 +1049,20 @@ interface GenerateVideoParams extends StructuredReferenceParams, ReferenceCaptio
960
1049
  provider?: string;
961
1050
  /** Start-frame image (image-to-video). */
962
1051
  imageUrl?: string;
1052
+ /** Closing frame, paired with `imageUrl` on models that support one. */
1053
+ endFrameUrl?: string;
963
1054
  referenceImageUrls?: string[];
964
1055
  referenceVideoUrls?: string[];
965
1056
  referenceAudioUrls?: string[];
1057
+ /** How a start/end frame is reshaped before the model sees it. Default
1058
+ * `"resolution"`: resize it to the pixel size that model actually renders,
1059
+ * which is what stops the provider reshaping it mid-clip. `"ratio"` corrects
1060
+ * only the aspect; `"original"` sends it untouched. */
1061
+ frameFit?: "original" | "ratio" | "resolution";
1062
+ /** Whether the frame travels as a real start frame or as a reference image
1063
+ * bound in the prompt as the opening frame. Default `"auto"`, which picks per
1064
+ * model. Ignored by models that take no reference images. */
1065
+ frameDelivery?: "auto" | "frame" | "reference";
966
1066
  [k: string]: unknown;
967
1067
  }
968
1068
  /**
@@ -1176,9 +1276,36 @@ declare class Scene3DResource {
1176
1276
  capabilities(): Promise<Scene3DCapabilities>;
1177
1277
  /** Current access to both the delivery and its source is required on every read. */
1178
1278
  getDelivery(jobId: string): Promise<Scene3DDelivery>;
1279
+ /**
1280
+ * The bytes of one descriptor the delivery listed.
1281
+ *
1282
+ * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which
1283
+ * is why a `shot-still` now works: the route has served stills since they existed, and this
1284
+ * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same
1285
+ * map; the server still decides whether THIS caller may read it.
1286
+ */
1179
1287
  deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: {
1180
1288
  signal?: AbortSignal;
1181
1289
  }): Promise<ArrayBuffer>;
1290
+ /**
1291
+ * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.
1292
+ *
1293
+ * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene
1294
+ * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's
1295
+ * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This
1296
+ * fetches it in one call — delivery, then the `source-json` descriptor's bytes.
1297
+ *
1298
+ * `null` means the delivery has no retained recipe to hand back: no pass ever cleared
1299
+ * admission, or this caller holds less than `edit` on the job's workflow and the descriptor
1300
+ * is therefore not listed for them.
1301
+ *
1302
+ * Read it to see what was attempted and to inform the next prompt. There is no input that
1303
+ * takes a recipe back: a refused run published no revision, so there is no `{kind:"scene"}`
1304
+ * source to re-run it from.
1305
+ */
1306
+ retainedRecipe(jobId: string, options?: {
1307
+ signal?: AbortSignal;
1308
+ }): Promise<unknown | null>;
1182
1309
  /** Persist deterministic overlays without an LLM or a generation charge. */
1183
1310
  applyEdits(revisionId: string, params: RetainedScene3DEditParams): Promise<RetainedScene3DEditResult>;
1184
1311
  /** Asset access is scoped to an exact retained revision, with fresh authentication. */
@@ -1223,9 +1350,21 @@ declare class Scene3DResource {
1223
1350
  *
1224
1351
  * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
1225
1352
  * (the exact composition it was rendered from), plus the revision, poster,
1226
- * validation and renderer metadata. Re-render that same `scenePlan` later
1227
- * with {@link render}, or with a `{kind:'scene'}` source; that costs no
1228
- * authoring.
1353
+ * validation and renderer metadata. A run that AUTHORED also reports its own
1354
+ * account of the answer — `metadata.summary`, `repairPasses`,
1355
+ * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from
1356
+ * the compiler's own remedy with no planner call, counted APART from
1357
+ * `repairPasses` on their own quoted allowance), `restoredAssertions`, and
1358
+ * any `SCENE_AUTHORING_ASSUMPTION` warnings. A
1359
+ * completed result whose `metadata.review` is present passed every mandatory
1360
+ * assertion but did NOT get the visual reviewer's approval: `verdict:
1361
+ * "refused"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`
1362
+ * warning; `verdict: "unavailable"` means the review produced no usable
1363
+ * verdict in `attempts` asks (`reason: "provider"` — never reached its
1364
+ * provider; `"unusable"` — it answered, unusably), so nobody judged the scene and
1365
+ * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same
1366
+ * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;
1367
+ * that costs no authoring.
1229
1368
  */
1230
1369
  renderProAndWait(params: Pro3DRenderParams | Pro3DRenderRunParams, options?: RunAndWaitOptions & Pro3DRenderRunOptions): Promise<Pro3DRenderJobOutput>;
1231
1370
  /**
@@ -4089,7 +4228,7 @@ declare class PromptHelperResource {
4089
4228
  /**
4090
4229
  * Read access to ElevenLabs voices: the premade catalog plus the shared
4091
4230
  * community Voice Library (both public GETs, no body), and the signed-in
4092
- * user's own voice clones (list / create-from-url / delete).
4231
+ * user's own pre-retirement voice clones (list / delete).
4093
4232
  */
4094
4233
  declare class VoicesResource {
4095
4234
  private client;
@@ -4112,10 +4251,11 @@ declare class VoicesResource {
4112
4251
  */
4113
4252
  listClones(): Promise<VoiceClone[]>;
4114
4253
  /**
4115
- * Clone a voice from an already-uploaded audio URL
4116
- * (`POST /v1/voice-clones/from-url`). Costs credits. Returns the create
4117
- * subset of `VoiceClone` (`elevenlabsVoiceId` is the id to use at
4118
- * text-to-speech time).
4254
+ * @deprecated Voice cloning is no longer offered on Nodaro (retired
4255
+ * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
4256
+ * rejects with that error. Clones created before the retirement are still
4257
+ * listed by {@link VoicesResource.listClones} and still work as voice ids.
4258
+ * For a new custom voice use {@link VoicesResource.design}.
4119
4259
  */
4120
4260
  createClone(input: {
4121
4261
  name: string;
@@ -4276,12 +4416,9 @@ declare class VoicesResource {
4276
4416
  jobId: string;
4277
4417
  }>;
4278
4418
  /**
4279
- * Clone a voice from an audio FILE you hold in memory
4280
- * (`POST /v1/voice-clones`, multipart) — the counterpart to
4281
- * {@link VoicesResource.createClone}, which clones from an already-uploaded
4282
- * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
4283
- * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
4284
- * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
4419
+ * @deprecated Voice cloning is no longer offered on Nodaro (retired
4420
+ * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
4421
+ * rejects with that error. See {@link VoicesResource.createClone}.
4285
4422
  */
4286
4423
  createCloneFromFile(input: {
4287
4424
  name: string;
@@ -5339,6 +5476,8 @@ interface PickerOption {
5339
5476
  */
5340
5477
  term?: string;
5341
5478
  icon?: string;
5479
+ /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */
5480
+ motion?: CharacterMotionMetadata;
5342
5481
  }
5343
5482
  interface PickerDimension {
5344
5483
  field: string;
@@ -7867,4 +8006,4 @@ interface ApiErrorBody {
7867
8006
  }
7868
8007
  declare function throwFromResponse(status: number, body: ApiErrorBody): never;
7869
8008
 
7870
- 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 CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, 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 DeveloperAppKind, 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 OverlayPlacement, 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 StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, 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 };
8009
+ 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 CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, 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 DeveloperAppKind, 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 OverlayPlacement, 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, SCENE3D_DELIVERY_ASSET_USAGE, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DDeliveryAssetKind, 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 StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, 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 };