@nodaro/sdk 2.14.0 → 2.17.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,5 +1,5 @@
1
1
  import * as _nodaro_shared 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, CaptionLookId, SupportedFontName, TranscribeLane, CaptionStyle, OverlayAnchor, TranscribeProvider, Transcript, 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, Edl, EditPlanMode, EditPlanTier, MeOrganizations } 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, CaptionLookId, SupportedFontName, TranscribeLane, CaptionStyle, OverlayAnchor, VideoOverlayRequest, TranscribeProvider, Transcript, 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, Edl, EditPlanMode, EditPlanTier, MeOrganizations } from '@nodaro/shared';
3
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, ChapterSet, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EditPlanMode, EditPlanTier, Edl, EdlClipSet, 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, TranscribeLane, TranscribeProvider, Transcript, 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, unwrapEditPlanOutput } 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';
@@ -5166,6 +5166,25 @@ declare class MediaResource {
5166
5166
  }): Promise<{
5167
5167
  jobId: string;
5168
5168
  }>;
5169
+ /**
5170
+ * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
5171
+ * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
5172
+ * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
5173
+ * in seconds (no `end` = to the end of the video) and a placement: a
5174
+ * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
5175
+ * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
5176
+ * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
5177
+ * overrides the preset, and a layer with neither is a corner badge
5178
+ * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
5179
+ * 16:9 / 9:16 / 1:1 / 4:5 canvas
5180
+ * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
5181
+ * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
5182
+ * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
5183
+ * video's end, an animated image's first frame, re-encoded audio).
5184
+ */
5185
+ videoOverlay(input: VideoOverlayRequest): Promise<{
5186
+ jobId: string;
5187
+ }>;
5169
5188
  /**
5170
5189
  * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
5171
5190
  * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -5665,12 +5684,28 @@ interface PickerOption {
5665
5684
  icon?: string;
5666
5685
  /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */
5667
5686
  motion?: CharacterMotionMetadata;
5687
+ /**
5688
+ * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
5689
+ * Cloud only) rendered look preview — on the installation's own host, or the
5690
+ * Nodaro CDN for look previews. Absent when the option has no picture. Use it
5691
+ * as given: file names carry a content hash, so it can be cached for good.
5692
+ */
5693
+ imageUrl?: string;
5668
5694
  }
5669
5695
  interface PickerDimension {
5670
5696
  field: string;
5671
5697
  label: string;
5672
5698
  options: PickerOption[];
5673
5699
  }
5700
+ /** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
5701
+ interface PickerCatalogSection {
5702
+ /** English topic name, e.g. "Identity", "Beauty & Hair". */
5703
+ label: string;
5704
+ /** Node-data fields of the settings in this topic, in display order. */
5705
+ fields: string[];
5706
+ /** Absolute URL of the topic's round picture. Absent when it has none. */
5707
+ imageUrl?: string;
5708
+ }
5674
5709
  interface PickerCatalog {
5675
5710
  nodeType: string;
5676
5711
  label: string;
@@ -5690,6 +5725,8 @@ interface PickerCatalog {
5690
5725
  * fields beside its main picker (transition position/duration/intensity). */
5691
5726
  dimensions?: PickerDimension[];
5692
5727
  detail?: "compact" | "full";
5728
+ /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
5729
+ sections?: PickerCatalogSection[];
5693
5730
  }
5694
5731
  interface PickerCatalogSummary {
5695
5732
  nodeType: string;
@@ -5699,9 +5736,11 @@ interface PickerCatalogSummary {
5699
5736
  valueField?: string;
5700
5737
  fields?: string[];
5701
5738
  optionCount: number;
5739
+ /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */
5740
+ imageCount?: number;
5702
5741
  }
5703
5742
  interface GetPickerCatalogOptions {
5704
- /** "compact" (default) = id, label, category, term, icon; "full" additionally includes description + promptHint. */
5743
+ /** "compact" (default) = id, label, category, term, icon, imageUrl; "full" additionally includes description + promptHint. */
5705
5744
  detail?: "compact" | "full";
5706
5745
  /** single-dim: filter to one category. */
5707
5746
  category?: string;
@@ -5778,6 +5817,13 @@ interface ProjectedCatalogOption {
5778
5817
  */
5779
5818
  term?: string;
5780
5819
  icon?: string;
5820
+ /**
5821
+ * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
5822
+ * Cloud only) rendered look preview — on the installation's own host, or the
5823
+ * Nodaro CDN for look previews. Absent when the option has no picture. Use it
5824
+ * as given: file names carry a content hash, so it can be cached for good.
5825
+ */
5826
+ imageUrl?: string;
5781
5827
  }
5782
5828
  interface ProjectedCatalogDimension {
5783
5829
  field: string;
@@ -5797,17 +5843,35 @@ interface ProjectedCatalog {
5797
5843
  options?: ProjectedCatalogOption[];
5798
5844
  fields?: string[];
5799
5845
  dimensions?: ProjectedCatalogDimension[];
5846
+ /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
5847
+ sections?: ProjectedCatalogSection[];
5848
+ }
5849
+ /** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
5850
+ interface ProjectedCatalogSection {
5851
+ label: string;
5852
+ fields: string[];
5853
+ imageUrl?: string;
5854
+ }
5855
+ /**
5856
+ * `GET /v1/catalogs`. `data` is present only when the deployment registered
5857
+ * catalog packs (`curated: true`); with none the catalogs are the bundled
5858
+ * ones — read them per picker with `client.pickerCatalogs.get(nodeType)`.
5859
+ */
5860
+ interface CatalogsListResponse {
5861
+ curated: boolean;
5862
+ packs: number;
5863
+ version: number;
5864
+ data?: ProjectedCatalog[];
5800
5865
  }
5801
5866
  declare class CatalogsResource {
5802
5867
  private client;
5803
5868
  constructor(client: NodaroClient);
5804
5869
  /** Every catalog, projected & pack-composed (honors the deployment's
5805
- * registered vendored packs). Cached publicly 5 min. */
5870
+ * registered vendored packs). Cached publicly 5 min. `data` is absent
5871
+ * when the deployment registered no packs (`curated: false`). */
5806
5872
  list(opts?: {
5807
5873
  detail?: "compact" | "full";
5808
- }): Promise<{
5809
- data: ProjectedCatalog[];
5810
- }>;
5874
+ }): Promise<CatalogsListResponse>;
5811
5875
  }
5812
5876
 
5813
5877
  /**
@@ -7844,6 +7908,61 @@ interface SilenceDetectInput {
7844
7908
  */
7845
7909
  workflowId?: string;
7846
7910
  }
7911
+ /** One recording for {@link EditResource.audioSync}. */
7912
+ interface AudioSyncSource {
7913
+ /**
7914
+ * Your id for this recording (1–200 chars, unique within the request) —
7915
+ * echoed back as its offset's `sourceId`. Use the id your EDL gives the same
7916
+ * recording (`EdlSource.id`) and the result folds straight into it.
7917
+ */
7918
+ id: string;
7919
+ /** An audio OR video URL — the audio track is read either way. */
7920
+ url: string;
7921
+ }
7922
+ interface AudioSyncInput {
7923
+ /** The 2–6 recordings of one conversation to line up (camera files and/or a master mic). */
7924
+ sources: AudioSyncSource[];
7925
+ /**
7926
+ * The id of the source every offset is measured against (its own offset is
7927
+ * 0). Must be one of `sources`' ids; default: the first source.
7928
+ */
7929
+ reference?: string;
7930
+ /** Optionally associate this run with a workflow execution (display only). */
7931
+ workflowId?: string;
7932
+ }
7933
+ /** One recording's measured clock offset in an {@link AudioSyncResult}. */
7934
+ interface AudioSyncOffset {
7935
+ /** The recording's `id` from the request. */
7936
+ sourceId: string;
7937
+ /**
7938
+ * Where this recording sits on the reference's clock, in integer ms:
7939
+ * `referenceMs = sourceMs + offsetMs` (the EDL's D19 sign — the value
7940
+ * `EdlSource.offsetMs` takes when the reference is the master).
7941
+ */
7942
+ offsetMs: number;
7943
+ /** 0–1. Below 0.5 a `notes` line asks for a check by ear. */
7944
+ confidence: number;
7945
+ /**
7946
+ * Measured clock drift against the reference, in ms gained per hour; `null`
7947
+ * when the shared stretch was too short to measure it. Drift is reported,
7948
+ * never corrected — the offset is taken at the middle of the overlap.
7949
+ */
7950
+ driftMsPerHour: number | null;
7951
+ }
7952
+ /**
7953
+ * An audio-sync job's `output_data.json`. It is NOT what
7954
+ * {@link EditResource.audioSync} returns (that is `{ jobId }`); fetch the
7955
+ * finished job and read its `output_data.json`.
7956
+ */
7957
+ interface AudioSyncResult {
7958
+ /** Wire version of the payload. */
7959
+ version: number;
7960
+ /** The source every offset is measured against (its own offset is 0). */
7961
+ reference: string;
7962
+ offsets: AudioSyncOffset[];
7963
+ /** Human-readable warnings: low confidence, measured drift, no shared sound. */
7964
+ notes: string[];
7965
+ }
7847
7966
  interface ApplyEdlInput {
7848
7967
  /** The edit decision list to render. Media resolves from each `edl.sources[i].url`. */
7849
7968
  edl: Edl;
@@ -7934,8 +8053,8 @@ interface EditPlanInput {
7934
8053
  /**
7935
8054
  * Phase-1 editorial primitives for podcast / long-form video editing.
7936
8055
  *
7937
- * - {@link silenceDetect} and {@link applyEdl} are core nodes available on every
7938
- * edition.
8056
+ * - {@link silenceDetect}, {@link audioSync} and {@link applyEdl} are core nodes
8057
+ * available on every edition.
7939
8058
  * - {@link editPlan} is a Cloud-edition transcript-driven planner.
7940
8059
  * - {@link remapTranscript} is a PURE local transform (no request) — the same
7941
8060
  * remap `applyEdl` performs on its `transcript`, exposed for callers that hold
@@ -7952,6 +8071,16 @@ declare class EditResource {
7952
8071
  * Keyless — one ffmpeg pass over the source's audio proxy.
7953
8072
  */
7954
8073
  silenceDetect(input: SilenceDetectInput): Promise<EditJobResult>;
8074
+ /**
8075
+ * Measure how far apart the clocks of 2–6 recordings of one conversation are
8076
+ * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one
8077
+ * ffmpeg decode per source. The finished job's `output_data.json` is an
8078
+ * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6
8079
+ * sources, a repeated id, a `reference` that is not one of the ids) throws a
8080
+ * typed `NodaroError` (400, `code: "validation_error"`) before any credits
8081
+ * are reserved.
8082
+ */
8083
+ audioSync(input: AudioSyncInput): Promise<EditJobResult>;
7955
8084
  /**
7956
8085
  * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).
7957
8086
  * The EDL is validated at ingress — an unresolvable source or a picture-less
@@ -8376,4 +8505,4 @@ interface ApiErrorBody {
8376
8505
  }
8377
8506
  declare function throwFromResponse(status: number, body: ApiErrorBody): never;
8378
8507
 
8379
- export { type AccessTokenResponse, type AddCaptionsInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, 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, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, 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 EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, 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, type SilenceDetectInput, type SilenceRanges, 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 TranscribeJobOutput, type TranscribeWord, 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 };
8508
+ export { type AccessTokenResponse, type AddCaptionsInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type CatalogsListResponse, 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 EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, 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 PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type ProjectedCatalogSection, 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, type SilenceDetectInput, type SilenceRanges, 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 TranscribeJobOutput, type TranscribeWord, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as _nodaro_shared 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, CaptionLookId, SupportedFontName, TranscribeLane, CaptionStyle, OverlayAnchor, TranscribeProvider, Transcript, 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, Edl, EditPlanMode, EditPlanTier, MeOrganizations } 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, CaptionLookId, SupportedFontName, TranscribeLane, CaptionStyle, OverlayAnchor, VideoOverlayRequest, TranscribeProvider, Transcript, 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, Edl, EditPlanMode, EditPlanTier, MeOrganizations } from '@nodaro/shared';
3
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, ChapterSet, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EditPlanMode, EditPlanTier, Edl, EdlClipSet, 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, TranscribeLane, TranscribeProvider, Transcript, 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, unwrapEditPlanOutput } 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';
@@ -5166,6 +5166,25 @@ declare class MediaResource {
5166
5166
  }): Promise<{
5167
5167
  jobId: string;
5168
5168
  }>;
5169
+ /**
5170
+ * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
5171
+ * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
5172
+ * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
5173
+ * in seconds (no `end` = to the end of the video) and a placement: a
5174
+ * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
5175
+ * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
5176
+ * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
5177
+ * overrides the preset, and a layer with neither is a corner badge
5178
+ * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
5179
+ * 16:9 / 9:16 / 1:1 / 4:5 canvas
5180
+ * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
5181
+ * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
5182
+ * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
5183
+ * video's end, an animated image's first frame, re-encoded audio).
5184
+ */
5185
+ videoOverlay(input: VideoOverlayRequest): Promise<{
5186
+ jobId: string;
5187
+ }>;
5169
5188
  /**
5170
5189
  * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
5171
5190
  * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -5665,12 +5684,28 @@ interface PickerOption {
5665
5684
  icon?: string;
5666
5685
  /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */
5667
5686
  motion?: CharacterMotionMetadata;
5687
+ /**
5688
+ * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
5689
+ * Cloud only) rendered look preview — on the installation's own host, or the
5690
+ * Nodaro CDN for look previews. Absent when the option has no picture. Use it
5691
+ * as given: file names carry a content hash, so it can be cached for good.
5692
+ */
5693
+ imageUrl?: string;
5668
5694
  }
5669
5695
  interface PickerDimension {
5670
5696
  field: string;
5671
5697
  label: string;
5672
5698
  options: PickerOption[];
5673
5699
  }
5700
+ /** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
5701
+ interface PickerCatalogSection {
5702
+ /** English topic name, e.g. "Identity", "Beauty & Hair". */
5703
+ label: string;
5704
+ /** Node-data fields of the settings in this topic, in display order. */
5705
+ fields: string[];
5706
+ /** Absolute URL of the topic's round picture. Absent when it has none. */
5707
+ imageUrl?: string;
5708
+ }
5674
5709
  interface PickerCatalog {
5675
5710
  nodeType: string;
5676
5711
  label: string;
@@ -5690,6 +5725,8 @@ interface PickerCatalog {
5690
5725
  * fields beside its main picker (transition position/duration/intensity). */
5691
5726
  dimensions?: PickerDimension[];
5692
5727
  detail?: "compact" | "full";
5728
+ /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
5729
+ sections?: PickerCatalogSection[];
5693
5730
  }
5694
5731
  interface PickerCatalogSummary {
5695
5732
  nodeType: string;
@@ -5699,9 +5736,11 @@ interface PickerCatalogSummary {
5699
5736
  valueField?: string;
5700
5737
  fields?: string[];
5701
5738
  optionCount: number;
5739
+ /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */
5740
+ imageCount?: number;
5702
5741
  }
5703
5742
  interface GetPickerCatalogOptions {
5704
- /** "compact" (default) = id, label, category, term, icon; "full" additionally includes description + promptHint. */
5743
+ /** "compact" (default) = id, label, category, term, icon, imageUrl; "full" additionally includes description + promptHint. */
5705
5744
  detail?: "compact" | "full";
5706
5745
  /** single-dim: filter to one category. */
5707
5746
  category?: string;
@@ -5778,6 +5817,13 @@ interface ProjectedCatalogOption {
5778
5817
  */
5779
5818
  term?: string;
5780
5819
  icon?: string;
5820
+ /**
5821
+ * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
5822
+ * Cloud only) rendered look preview — on the installation's own host, or the
5823
+ * Nodaro CDN for look previews. Absent when the option has no picture. Use it
5824
+ * as given: file names carry a content hash, so it can be cached for good.
5825
+ */
5826
+ imageUrl?: string;
5781
5827
  }
5782
5828
  interface ProjectedCatalogDimension {
5783
5829
  field: string;
@@ -5797,17 +5843,35 @@ interface ProjectedCatalog {
5797
5843
  options?: ProjectedCatalogOption[];
5798
5844
  fields?: string[];
5799
5845
  dimensions?: ProjectedCatalogDimension[];
5846
+ /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
5847
+ sections?: ProjectedCatalogSection[];
5848
+ }
5849
+ /** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
5850
+ interface ProjectedCatalogSection {
5851
+ label: string;
5852
+ fields: string[];
5853
+ imageUrl?: string;
5854
+ }
5855
+ /**
5856
+ * `GET /v1/catalogs`. `data` is present only when the deployment registered
5857
+ * catalog packs (`curated: true`); with none the catalogs are the bundled
5858
+ * ones — read them per picker with `client.pickerCatalogs.get(nodeType)`.
5859
+ */
5860
+ interface CatalogsListResponse {
5861
+ curated: boolean;
5862
+ packs: number;
5863
+ version: number;
5864
+ data?: ProjectedCatalog[];
5800
5865
  }
5801
5866
  declare class CatalogsResource {
5802
5867
  private client;
5803
5868
  constructor(client: NodaroClient);
5804
5869
  /** Every catalog, projected & pack-composed (honors the deployment's
5805
- * registered vendored packs). Cached publicly 5 min. */
5870
+ * registered vendored packs). Cached publicly 5 min. `data` is absent
5871
+ * when the deployment registered no packs (`curated: false`). */
5806
5872
  list(opts?: {
5807
5873
  detail?: "compact" | "full";
5808
- }): Promise<{
5809
- data: ProjectedCatalog[];
5810
- }>;
5874
+ }): Promise<CatalogsListResponse>;
5811
5875
  }
5812
5876
 
5813
5877
  /**
@@ -7844,6 +7908,61 @@ interface SilenceDetectInput {
7844
7908
  */
7845
7909
  workflowId?: string;
7846
7910
  }
7911
+ /** One recording for {@link EditResource.audioSync}. */
7912
+ interface AudioSyncSource {
7913
+ /**
7914
+ * Your id for this recording (1–200 chars, unique within the request) —
7915
+ * echoed back as its offset's `sourceId`. Use the id your EDL gives the same
7916
+ * recording (`EdlSource.id`) and the result folds straight into it.
7917
+ */
7918
+ id: string;
7919
+ /** An audio OR video URL — the audio track is read either way. */
7920
+ url: string;
7921
+ }
7922
+ interface AudioSyncInput {
7923
+ /** The 2–6 recordings of one conversation to line up (camera files and/or a master mic). */
7924
+ sources: AudioSyncSource[];
7925
+ /**
7926
+ * The id of the source every offset is measured against (its own offset is
7927
+ * 0). Must be one of `sources`' ids; default: the first source.
7928
+ */
7929
+ reference?: string;
7930
+ /** Optionally associate this run with a workflow execution (display only). */
7931
+ workflowId?: string;
7932
+ }
7933
+ /** One recording's measured clock offset in an {@link AudioSyncResult}. */
7934
+ interface AudioSyncOffset {
7935
+ /** The recording's `id` from the request. */
7936
+ sourceId: string;
7937
+ /**
7938
+ * Where this recording sits on the reference's clock, in integer ms:
7939
+ * `referenceMs = sourceMs + offsetMs` (the EDL's D19 sign — the value
7940
+ * `EdlSource.offsetMs` takes when the reference is the master).
7941
+ */
7942
+ offsetMs: number;
7943
+ /** 0–1. Below 0.5 a `notes` line asks for a check by ear. */
7944
+ confidence: number;
7945
+ /**
7946
+ * Measured clock drift against the reference, in ms gained per hour; `null`
7947
+ * when the shared stretch was too short to measure it. Drift is reported,
7948
+ * never corrected — the offset is taken at the middle of the overlap.
7949
+ */
7950
+ driftMsPerHour: number | null;
7951
+ }
7952
+ /**
7953
+ * An audio-sync job's `output_data.json`. It is NOT what
7954
+ * {@link EditResource.audioSync} returns (that is `{ jobId }`); fetch the
7955
+ * finished job and read its `output_data.json`.
7956
+ */
7957
+ interface AudioSyncResult {
7958
+ /** Wire version of the payload. */
7959
+ version: number;
7960
+ /** The source every offset is measured against (its own offset is 0). */
7961
+ reference: string;
7962
+ offsets: AudioSyncOffset[];
7963
+ /** Human-readable warnings: low confidence, measured drift, no shared sound. */
7964
+ notes: string[];
7965
+ }
7847
7966
  interface ApplyEdlInput {
7848
7967
  /** The edit decision list to render. Media resolves from each `edl.sources[i].url`. */
7849
7968
  edl: Edl;
@@ -7934,8 +8053,8 @@ interface EditPlanInput {
7934
8053
  /**
7935
8054
  * Phase-1 editorial primitives for podcast / long-form video editing.
7936
8055
  *
7937
- * - {@link silenceDetect} and {@link applyEdl} are core nodes available on every
7938
- * edition.
8056
+ * - {@link silenceDetect}, {@link audioSync} and {@link applyEdl} are core nodes
8057
+ * available on every edition.
7939
8058
  * - {@link editPlan} is a Cloud-edition transcript-driven planner.
7940
8059
  * - {@link remapTranscript} is a PURE local transform (no request) — the same
7941
8060
  * remap `applyEdl` performs on its `transcript`, exposed for callers that hold
@@ -7952,6 +8071,16 @@ declare class EditResource {
7952
8071
  * Keyless — one ffmpeg pass over the source's audio proxy.
7953
8072
  */
7954
8073
  silenceDetect(input: SilenceDetectInput): Promise<EditJobResult>;
8074
+ /**
8075
+ * Measure how far apart the clocks of 2–6 recordings of one conversation are
8076
+ * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one
8077
+ * ffmpeg decode per source. The finished job's `output_data.json` is an
8078
+ * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6
8079
+ * sources, a repeated id, a `reference` that is not one of the ids) throws a
8080
+ * typed `NodaroError` (400, `code: "validation_error"`) before any credits
8081
+ * are reserved.
8082
+ */
8083
+ audioSync(input: AudioSyncInput): Promise<EditJobResult>;
7955
8084
  /**
7956
8085
  * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).
7957
8086
  * The EDL is validated at ingress — an unresolvable source or a picture-less
@@ -8376,4 +8505,4 @@ interface ApiErrorBody {
8376
8505
  }
8377
8506
  declare function throwFromResponse(status: number, body: ApiErrorBody): never;
8378
8507
 
8379
- export { type AccessTokenResponse, type AddCaptionsInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, 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, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, 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 EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, 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, type SilenceDetectInput, type SilenceRanges, 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 TranscribeJobOutput, type TranscribeWord, 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 };
8508
+ export { type AccessTokenResponse, type AddCaptionsInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type CatalogsListResponse, 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 EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, 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 PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type ProjectedCatalogSection, 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, type SilenceDetectInput, type SilenceRanges, 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 TranscribeJobOutput, type TranscribeWord, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
package/dist/index.js CHANGED
@@ -2342,6 +2342,25 @@ var MediaResource = class {
2342
2342
  slideshow(input) {
2343
2343
  return this.client.request("POST", "/v1/slideshow", { body: input });
2344
2344
  }
2345
+ /**
2346
+ * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
2347
+ * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
2348
+ * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
2349
+ * in seconds (no `end` = to the end of the video) and a placement: a
2350
+ * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
2351
+ * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
2352
+ * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
2353
+ * overrides the preset, and a layer with neither is a corner badge
2354
+ * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
2355
+ * 16:9 / 9:16 / 1:1 / 4:5 canvas
2356
+ * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
2357
+ * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
2358
+ * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
2359
+ * video's end, an animated image's first frame, re-encoded audio).
2360
+ */
2361
+ videoOverlay(input) {
2362
+ return this.client.request("POST", "/v1/video-overlay", { body: input });
2363
+ }
2345
2364
  /**
2346
2365
  * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
2347
2366
  * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -2605,7 +2624,8 @@ var CatalogsResource = class {
2605
2624
  }
2606
2625
  client;
2607
2626
  /** Every catalog, projected & pack-composed (honors the deployment's
2608
- * registered vendored packs). Cached publicly 5 min. */
2627
+ * registered vendored packs). Cached publicly 5 min. `data` is absent
2628
+ * when the deployment registered no packs (`curated: false`). */
2609
2629
  list(opts = {}) {
2610
2630
  const qs = opts.detail ? `?detail=${opts.detail}` : "";
2611
2631
  return this.client.request("GET", `/v1/catalogs${qs}`);
@@ -3547,6 +3567,24 @@ var EditResource = class {
3547
3567
  }
3548
3568
  });
3549
3569
  }
3570
+ /**
3571
+ * Measure how far apart the clocks of 2–6 recordings of one conversation are
3572
+ * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one
3573
+ * ffmpeg decode per source. The finished job's `output_data.json` is an
3574
+ * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6
3575
+ * sources, a repeated id, a `reference` that is not one of the ids) throws a
3576
+ * typed `NodaroError` (400, `code: "validation_error"`) before any credits
3577
+ * are reserved.
3578
+ */
3579
+ audioSync(input) {
3580
+ return this.client.request("POST", "/v1/audio-sync", {
3581
+ body: {
3582
+ sources: input.sources.map((s) => ({ id: s.id, url: s.url })),
3583
+ ...input.reference !== void 0 ? { reference: input.reference } : {},
3584
+ ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
3585
+ }
3586
+ });
3587
+ }
3550
3588
  /**
3551
3589
  * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).
3552
3590
  * The EDL is validated at ingress — an unresolvable source or a picture-less
@@ -3606,7 +3644,7 @@ var EditResource = class {
3606
3644
  return remapTranscriptThroughEdl(edl, transcript);
3607
3645
  }
3608
3646
  };
3609
- var SDK_VERSION = "2.14.0" ;
3647
+ var SDK_VERSION = "2.17.0" ;
3610
3648
  var CLIENT_HEADER = "X-Nodaro-Client";
3611
3649
  var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
3612
3650
  var NodaroClient = class _NodaroClient {