@nodaro/sdk 2.1.0 → 2.4.0

package/dist/index.d.ts

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