@nodaro/sdk 2.2.0 → 2.5.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as _nodaro_shared from '@nodaro/shared';
 import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
 export { AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared';
 import { DirectionFields, SubjectFields, PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
@@ -710,6 +711,8 @@ interface Scene3DEngineParams {
 }
 /** Structured authoring inputs; reference roles are interpreted by the platform. */
 interface GenerateScene3DParams extends Record<string, unknown>, Scene3DEngineParams {
+    /** Existing GLBs selected by immutable revision/artifact IDs. Requires an import-capable advanced engine. */
+    inputAssets?: readonly _nodaro_shared.Scene3DInputAsset[];
     prompt: string;
     durationSeconds?: number;
     fps?: number;
@@ -4676,6 +4679,65 @@ declare class MediaResource {
     }): Promise<{
         jobId: string;
     }>;
+    /**
+     * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
+     * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
+     * Every layer position/size is a PERCENT of the base image: `anchor` (nine
+     * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
+     * the base width/height; negative on a right/bottom anchor moves inward),
+     * `width` (% of the base width, default 25 — height follows the layer's
+     * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
+     * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
+     * `shadow` and `roundedCorners`. The output keeps the base's pixel size
+     * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
+     * finished image.
+     */
+    imageOverlay(input: {
+        imageUrl: string;
+        layers: Array<{
+            imageUrl: string;
+            anchor?: "top-left" | "top" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom" | "bottom-right";
+            x?: number;
+            y?: number;
+            width?: number;
+            height?: number;
+            opacity?: number;
+            rotation?: number;
+            blend?: "over" | "multiply" | "screen";
+            fit?: "contain" | "cover" | "stretch";
+            shadow?: {
+                blur: number;
+                offsetX: number;
+                offsetY: number;
+                color: string;
+                opacity: number;
+            };
+            roundedCorners?: number;
+            zIndex?: number;
+            /** "image" (default, needs imageUrl) | "text" | "qr" | "shape" — see @nodaro/shared image-overlay-layers. */
+            kind?: "image" | "text" | "qr" | "shape";
+            text?: Record<string, unknown>;
+            qr?: Record<string, unknown>;
+            shape?: Record<string, unknown>;
+            effects?: Record<string, unknown>;
+        }>;
+        canvas?: {
+            width: number;
+            height: number;
+            backgroundColor?: string;
+        };
+        baseFit?: "contain" | "cover";
+        outputFormat?: "png" | "jpg" | "webp";
+        /** Extra platform renders (see OVERLAY_PLATFORMS in @nodaro/shared); returned as output `variants[]`. */
+        variants?: string[];
+        /** The mask the job also emits as output `maskUrl` (white = may change). Default "around". */
+        maskMode?: "none" | "layers" | "around" | "outside";
+        maskSpread?: number;
+        /** Fills every QR layer whose `qr.fromInput` is true — the node's QR link handle. */
+        qrText?: string;
+    }): Promise<{
+        jobId: string;
+    }>;
     /**
      * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
      * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
@@ -6152,10 +6214,275 @@ declare class StudioProductionsResource {
      */
     clone(productionId: string, input?: StudioCloneRequest): Promise<StudioProduction>;
 }
-/** `client.studio` — the studio's own surface on the platform. */
+
+/** Public response/transport contracts only; document validation and planning
+ * remain in the private Studio codec on the server. */
+type StudioDocumentJson = Record<string, unknown>;
+interface StudioProductionCapabilities {
+    planVersions: number[];
+    operations: {
+        readKeyframes: boolean;
+        saveEditorState?: boolean;
+        editableSharedCopies?: boolean;
+        revisionedSharing?: boolean;
+        cloneLinkedProductions?: boolean;
+        importPlannedBundles?: boolean;
+        importLinkedBundles?: boolean;
+        appendPlannedBundles?: boolean;
+        appendLinkedBundles?: boolean;
+        editKeyframes: boolean;
+        generateKeyframes: boolean;
+        acceptKeyframes: boolean;
+        rejectKeyframes?: boolean;
+        editSequencePlans?: boolean;
+        generateLinkedClips: boolean;
+        retakeLinkedClips?: boolean;
+    };
+    sourceFrameReferences: boolean;
+    automaticAcceptance: false;
+    unattendedGeneration: false;
+}
+interface StudioKeyframeRecord {
+    id: string;
+    label: string;
+    revision: number;
+    nodeId: string;
+    parentKeyframeId?: string;
+    previewResultKey: string | null;
+    previewUrl: string | null;
+    acceptedResultKey: string | null;
+    acceptedUrl: string | null;
+    count: number;
+    pending: Array<{
+        jobId: string;
+        startedAt: string;
+    }>;
+    /** Owner-only working state. Recorded acceptance is not an execution grant. */
+    plan?: StudioDocumentJson;
+    acceptance?: StudioDocumentJson;
+    results?: StudioDocumentJson[];
+}
+interface StudioProductionRecord {
+    id: string;
+    name: string;
+    version: number;
+    updatedAt: string;
+    thumbnailUrl: string | null;
+    shared: boolean;
+    archived: boolean;
+    requiredCapabilities?: string[];
+    keyframes?: StudioKeyframeRecord[];
+    sequences?: StudioDocumentJson[];
+    shots: StudioDocumentJson[];
+    pending: {
+        stills: number;
+        clips: number;
+        keyframes?: number;
+        music: boolean;
+        draft: StudioDocumentJson | null;
+    };
+    [field: string]: unknown;
+}
+interface StudioProductionReply {
+    production: StudioProductionRecord;
+    capabilities?: StudioProductionCapabilities;
+    warnings?: unknown[];
+    [field: string]: unknown;
+}
+interface StudioEditInput {
+    ops: ReadonlyArray<{
+        op: string;
+        [field: string]: unknown;
+    }>;
+    baseVersion?: number;
+    strict?: boolean;
+    clientRequestId?: string;
+}
+interface StudioKeyframeGenerationInput {
+    keyframeId: string;
+    expectedRevision: number;
+    clientRequestId?: string;
+    overrides?: StudioDocumentJson;
+}
+interface StudioKeyframeAcceptanceInput {
+    keyframeId: string;
+    expectedRevision: number;
+    resultKey: string;
+    expectedAcceptedResultKey: string | null;
+    requirementChecks: Array<{
+        requirementId: string;
+        outcome: "pass" | "waived";
+    }>;
+    waivedReason?: string;
+}
+interface StudioShotGenerationInput {
+    kind: "still" | "clip";
+    shotId: string;
+    clientRequestId?: string;
+    count?: number;
+    mode?: "start" | "references";
+    dryRun?: boolean;
+    /** Linked clips only: require the exact inputs returned by a reviewed quote. */
+    expectedInputHash?: string;
+    /** Retake a native linked take using its original request and retained endpoints. */
+    retakeResultKey?: string;
+    overrides?: StudioDocumentJson;
+}
+type StudioGenerationReply = {
+    jobIds: string[];
+    production?: StudioProductionRecord;
+    deduped?: true;
+    lane?: string;
+    [field: string]: unknown;
+} | {
+    dryRun: true;
+    provider: string;
+    count: number;
+    credits: number | null;
+    lane?: string;
+    /** Linked-clip quotes include normalized settings and accepted endpoint pins. */
+    inputHash?: string;
+    endpointPins?: StudioDocumentJson;
+    creditIdentifier?: string;
+    duration?: number;
+    resolution?: string;
+    aspectRatio?: string;
+    sound?: boolean;
+};
+/** Cloud plugin routes. Check capabilities before exposing dependency controls.
+ * Reads do not reconcile jobs, submit media or accept generated candidates. */
 declare class StudioResource {
+    private readonly client;
     readonly productions: StudioProductionsResource;
     constructor(client: NodaroClient);
+    capabilities(): Promise<{
+        data: StudioProductionCapabilities;
+    }>;
+    skill(): Promise<{
+        data: StudioDocumentJson;
+    }>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+        includeArchived?: boolean;
+    }): Promise<{
+        data: {
+            data: Array<{
+                id: string;
+                name: string;
+                version: number;
+                updatedAt: string;
+                thumbnailUrl: string | null;
+                shared: boolean;
+                archived: boolean;
+                shotCount: number;
+            }>;
+            nextCursor?: string;
+        };
+    }>;
+    get(id: string, options?: {
+        detail?: "summary" | "full";
+        shotId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    validatePlan(plan: StudioDocumentJson): Promise<{
+        data: {
+            valid: boolean;
+            errors: StudioDocumentJson[];
+            warnings: StudioDocumentJson[];
+            summary?: StudioDocumentJson;
+        };
+    }>;
+    create(input: {
+        name?: string;
+        plan?: StudioDocumentJson;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Import a portable document through the compatible server writer.
+     * Retained frame media requires an authorized source; acceptance never transfers. */
+    importBundle(input: {
+        bundle: StudioDocumentJson;
+        projectId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Append a bundle's scenes and frame closure under an exact destination revision. */
+    appendBundle(id: string, input: {
+        bundle: StudioDocumentJson;
+        expectedVersion: number;
+        afterShotId?: string;
+        applyFilm?: boolean;
+    }): Promise<{
+        data: {
+            production: StudioProductionRecord;
+            importedShotIds: string[];
+            importedKeyframeIds: string[];
+        };
+    }>;
+    /** Copy a saved production. Linked copies retain verified inputs, remap
+     * dependencies and require fresh frame acceptance; they start no media jobs. */
+    clone(id: string, input?: {
+        name?: string;
+        projectId?: string;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    edit(id: string, input: StudioEditInput): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    /** Audience-authorized sharing; an expected revision prevents publication
+     * of concurrent edits the caller has not reviewed. */
+    setShared(id: string, input: {
+        shared: boolean;
+        allowEditableCopy?: boolean;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Save ordinary editor fields against the loaded revision. Protected frame
+     * and job state can only change through their dedicated semantic actions. */
+    saveEditorState(id: string, input: {
+        expectedVersion: number;
+        graph: object;
+        clientRequestId?: string;
+    }): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    generateKeyframe(id: string, input: StudioKeyframeGenerationInput): Promise<{
+        data: Exclude<StudioGenerationReply, {
+            dryRun: true;
+        }>;
+    }>;
+    generateShot(id: string, input: StudioShotGenerationInput): Promise<{
+        data: StudioGenerationReply;
+    }>;
+    /** A separate explicit review action; generation never calls this method. */
+    acceptKeyframe(id: string, input: StudioKeyframeAcceptanceInput, concurrency?: Pick<StudioEditInput, "baseVersion" | "strict" | "clientRequestId">): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    reconcile(id: string): Promise<{
+        data: StudioProductionReply & {
+            landed: string[];
+            pending: string[];
+            failed: string[];
+            version: number;
+        };
+    }>;
 }
 
 /**
@@ -6981,4 +7308,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioImportSummary, type StudioJobStartedResponse, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, type StudioProduction, type StudioProductionDetail, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type 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, StudioOpError, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, 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 };

package/dist/index.js

@@ -2138,6 +2138,22 @@ var MediaResource = class {
   imageCollage(input) {
     return this.client.request("POST", "/v1/image-collage", { body: input });
   }
+  /**
+   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
+   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
+   * Every layer position/size is a PERCENT of the base image: `anchor` (nine
+   * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
+   * the base width/height; negative on a right/bottom anchor moves inward),
+   * `width` (% of the base width, default 25 — height follows the layer's
+   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
+   * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
+   * `shadow` and `roundedCorners`. The output keeps the base's pixel size
+   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
+   * finished image.
+   */
+  imageOverlay(input) {
+    return this.client.request("POST", "/v1/image-overlay", { body: input });
+  }
   /**
    * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
    * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
@@ -2543,7 +2559,7 @@ var RecastResource = class {
   }
 };
 
-// src/resources/studio.ts
+// src/resources/studio-productions.ts
 function isStudioGenerateEstimate(result) {
   return result.dryRun === true;
 }
@@ -2775,11 +2791,80 @@ var StudioProductionsResource = class {
     return res.data.production;
   }
 };
+
+// src/resources/studio.ts
+var root = "/v1/studio/productions";
+var path = (id) => `${root}/${encodeURIComponent(id)}`;
 var StudioResource = class {
-  productions;
   constructor(client) {
+    this.client = client;
     this.productions = new StudioProductionsResource(client);
   }
+  client;
+  productions;
+  capabilities() {
+    return this.client.request("GET", `${root}/capabilities`);
+  }
+  skill() {
+    return this.client.request("GET", `${root}/skill`);
+  }
+  list(options = {}) {
+    return this.client.request("GET", root, { query: options });
+  }
+  get(id, options = {}) {
+    return this.client.request("GET", path(id), { query: { detail: options.detail, shot_id: options.shotId } });
+  }
+  validatePlan(plan) {
+    return this.client.request("POST", `${root}/validate`, { body: { plan } });
+  }
+  create(input) {
+    return this.client.request("POST", root, { body: input });
+  }
+  /** Import a portable document through the compatible server writer.
+   * Retained frame media requires an authorized source; acceptance never transfers. */
+  importBundle(input) {
+    return this.client.request("POST", `${root}/import-bundle`, { body: input });
+  }
+  /** Append a bundle's scenes and frame closure under an exact destination revision. */
+  appendBundle(id, input) {
+    return this.client.request("POST", `${path(id)}/import-bundle`, { body: input });
+  }
+  /** Copy a saved production. Linked copies retain verified inputs, remap
+   * dependencies and require fresh frame acceptance; they start no media jobs. */
+  clone(id, input = {}) {
+    return this.client.request("POST", `${path(id)}/clone`, { body: input });
+  }
+  edit(id, input) {
+    return this.client.request("POST", `${path(id)}/ops`, { body: input });
+  }
+  /** Audience-authorized sharing; an expected revision prevents publication
+   * of concurrent edits the caller has not reviewed. */
+  setShared(id, input) {
+    return this.client.request("POST", `${path(id)}/share`, { body: input });
+  }
+  /** Save ordinary editor fields against the loaded revision. Protected frame
+   * and job state can only change through their dedicated semantic actions. */
+  saveEditorState(id, input) {
+    return this.edit(id, {
+      baseVersion: input.expectedVersion,
+      strict: true,
+      ...input.clientRequestId ? { clientRequestId: input.clientRequestId } : {},
+      ops: [{ op: "save_editor_state", expectedVersion: input.expectedVersion, graph: input.graph }]
+    });
+  }
+  generateKeyframe(id, input) {
+    return this.client.request("POST", `${path(id)}/generate`, { body: { ...input, kind: "keyframe" } });
+  }
+  generateShot(id, input) {
+    return this.client.request("POST", `${path(id)}/generate`, { body: input });
+  }
+  /** A separate explicit review action; generation never calls this method. */
+  acceptKeyframe(id, input, concurrency = {}) {
+    return this.edit(id, { ...concurrency, ops: [{ ...input, op: "accept_keyframe_result" }] });
+  }
+  reconcile(id) {
+    return this.client.request("POST", `${path(id)}/reconcile`, { body: {} });
+  }
 };
 
 // src/resources/community.ts
@@ -3163,7 +3248,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.2.0" ;
+var SDK_VERSION = "2.5.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3295,8 +3380,8 @@ var NodaroClient = class _NodaroClient {
    * stalled CSV stream aborts, it does not hang forever). Both the JSON path
    * ({@link request}) and the text path ({@link requestText}) go through here.
    */
-  async send(method, path, options, read) {
-    const url = this.buildUrl(path, options.query);
+  async send(method, path2, options, read) {
+    const url = this.buildUrl(path2, options.query);
     const token = await this.auth.getToken();
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
     const headers = {
@@ -3336,14 +3421,14 @@ var NodaroClient = class _NodaroClient {
     }
   }
   /** Authenticated, bounded binary reads through the normal timeout/error transport. */
-  async requestBytes(method, path, options) {
+  async requestBytes(method, path2, options) {
     if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 1) throw new Error("maxBytes must be a positive integer");
-    return this.send(method, path, options, (response) => readBinaryResponse(response, options.maxBytes));
+    return this.send(method, path2, options, (response) => readBinaryResponse(response, options.maxBytes));
   }
-  async request(method, path, options = {}) {
+  async request(method, path2, options = {}) {
     return this.send(
       method,
-      path,
+      path2,
       options,
       async (res) => (
         // 204 No Content
@@ -3356,8 +3441,8 @@ var NodaroClient = class _NodaroClient {
    * are still the JSON envelope and throw the same typed errors, and the read is
    * bounded by the same timeout as the request.
    */
-  async requestText(method, path, options = {}) {
-    return this.send(method, path, options, (res) => res.text());
+  async requestText(method, path2, options = {}) {
+    return this.send(method, path2, options, (res) => res.text());
   }
   /**
    * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
@@ -3376,9 +3461,9 @@ var NodaroClient = class _NodaroClient {
     const res = await this.request("GET", "/v1/me");
     return res.data;
   }
-  buildUrl(path, query) {
+  buildUrl(path2, query) {
     const base = this.baseUrl || (typeof window !== "undefined" ? window.location.origin : "http://placeholder");
-    const url = new URL(path, base);
+    const url = new URL(path2, base);
     const fullUrl = this.baseUrl ? url.toString() : url.pathname + url.search;
     if (query) {
       const u = new URL(this.baseUrl ? fullUrl : fullUrl, base);