@nodaro/sdk 2.9.0 → 2.11.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 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, OverlayAnchor, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
-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 { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, NodeExecutionStateWire, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, ModelInputAdjustment, ConnectedReference, DescribedReference, Scene3DAssetRef, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, OverlayAnchor, 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, NodeExecutionStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView, nodeStateMayCarryOutput } from '@nodaro/shared';
 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';
 
@@ -565,19 +565,16 @@ type ExecutionTriggerType = "manual" | "webhook" | "schedule" | "app_run" | "sin
 /**
  * Per-node state inside an execution's `nodeStates` map. Keys are node IDs.
  *
- * Shape mirrors `services/workflow-engine/types.ts` plus the synthetic
- * single-node-job shape from `routes/workflow-execution.ts`.
+ * Extends the published wire contract in `@nodaro/shared`, which is what the
+ * orchestrator writes and the editor reads — so a field added there reaches
+ * SDK consumers as a typed field rather than through the index signature. The
+ * synthetic single-node-job shape from `routes/workflow-execution.ts` fits the
+ * same contract.
  */
-interface NodeExecutionState {
-    status: string;
-    nodeType?: string;
-    jobId?: string | null;
-    creditsUsed?: number;
-    error?: string | null;
-    startedAt?: string | null;
-    completedAt?: string | null;
+interface NodeExecutionState extends NodeExecutionStateWire {
     [key: string]: unknown;
 }
+
 /**
  * Workflow execution record. Returned by `get()` and `cancel()` (the cancel
  * endpoint returns `{ success: true }`, not the execution itself).
@@ -660,19 +657,67 @@ interface RetainedScene3DEditResult {
     scenePlan: Scene3DPlanV2;
     changeSummary: string;
 }
+/**
+ * The kind of bytes a delivery descriptor names, and the usage it is pinned under.
+ *
+ * PAIRED, not two free enums: the platform refuses a pin whose usage is not the one its kind is
+ * defined to have, and a client that checks only one of the two would accept a mis-pinned
+ * artifact the server would then refuse. {@link SCENE3D_DELIVERY_ASSET_USAGE} is the map both
+ * halves are read from.
+ */
+declare const SCENE3D_DELIVERY_ASSET_USAGE: {
+    readonly poster: "poster";
+    readonly "validation-report": "validation";
+    readonly "shot-still": "shot-still";
+    /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
+    readonly "source-json": "checkpoint";
+};
+type Scene3DDeliveryAssetKind = keyof typeof SCENE3D_DELIVERY_ASSET_USAGE;
+/**
+ * One artifact a delivery pins, as a descriptor: opaque ids and digests only.
+ *
+ * Four kinds, and two of them are conditional:
+ *
+ * - `poster` and `validation-report` are on every delivery;
+ * - `shot-still` appears once per shot on a render that produced a contact sheet, and carries
+ *   its own shot identity (`shotIndex`, `frame`, and the frame size);
+ * - `source-json` appears on ONE shape only — a `refused-authoring` delivery, published by a
+ *   3D Render Pro run whose recipe the compiler refused on every pass. It is the planner's last
+ *   admitted recipe, and it is the only thing such a run leaves that names what was attempted.
+ *   Reading it needs `edit` on the job's workflow (the same access the `.blend` export costs);
+ *   a reader with less simply does not see the descriptor.
+ */
 interface Scene3DDeliveryAsset {
     assetId: string;
-    kind: "poster" | "validation-report";
-    usage: "poster" | "validation";
+    kind: Scene3DDeliveryAssetKind;
+    usage: (typeof SCENE3D_DELIVERY_ASSET_USAGE)[Scene3DDeliveryAssetKind];
     byteLength: number;
     sha256: string;
     viaRevisionId: string | null;
+    /** Set on a `shot-still` and absent on every other kind — never `null`. */
+    shotIndex?: number;
+    frame?: number;
+    width?: number;
+    height?: number;
 }
 /** Export evidence is retained separately from the immutable scene it rendered. */
 interface Scene3DDelivery {
     deliveryId: string;
-    sceneRevisionId: string;
-    sourcePlanSha256: string;
+    /**
+     * Null on a `refused-authoring` delivery and on that alone.
+     *
+     * A Pro run whose recipe the compiler refused on every pass still retains the refusal
+     * report, but nothing was ever compiled, so no scene revision was published. The field is
+     * null rather than absent so the shape stays one shape; read `sourceKind` to tell why.
+     */
+    sceneRevisionId: string | null;
+    /**
+     * What this delivery was made from. Absent when read from a deployment that predates the
+     * refused lane, where every delivery necessarily had a scene behind it.
+     */
+    sourceKind?: "retained-revision" | "job-output" | "refused-authoring";
+    /** Null when there is no plan to hash — see `sceneRevisionId`. */
+    sourcePlanSha256: string | null;
     sourceContentHash: string | null;
     sourceJobId: string | null;
     workflowId: string | null;
@@ -811,9 +856,66 @@ interface RenderScene3DParams extends Record<string, unknown> {
     workflowId?: string;
     nodeId?: string;
 }
-/** Preserve the shared wire contract while allowing additive job metadata. */
+/**
+ * Preserve the shared wire contract while allowing additive job metadata.
+ *
+ * A scene authored by an ADVANCED engine additionally reports what the run knows about its own
+ * answer, every field optional and all of them absent on the deterministic Basic lane:
+ * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION` (the planner's
+ * assumptions), `metadata.summary` (its description of what it authored), `repairPasses`
+ * (repairs actually run — `0` when the scene was accepted first time), `admissionRetries`
+ * (pre-build planner retries, which spend no repair pass), `mechanicalPasses` (repairs the engine
+ * applied from the compiler's own remedy with no planner call, counted APART from `repairPasses`
+ * on their own quoted allowance, each with a `REMEDY_AUTO_APPLIED` warning) and
+ * `restoredAssertions` (mandatory assertions put back after a planner answer re-shaped one the
+ * feedback had not named, each a `ASSERTION_RESTORED` warning).
+ *
+ * A scene that passed every mandatory assertion but did not get the visual reviewer's approval
+ * is delivered anyway, and `metadata.review` carries a verdict saying why. `verdict: "refused"`
+ * is the ADVISORY delivery — the reviewer objected once the repair budget was spent — with one
+ * `SCENE_REVIEW_REFUSED` warning per objection. `verdict: "unavailable"` is the UNREVIEWED
+ * delivery: the review produced no usable verdict after `attempts` asks — `reason: "provider"`
+ * when it never reached its provider, `"unusable"` when the provider answered with nothing usable
+ * (`Scene3DReviewUnavailableReason` in `@nodaro/shared`) — so nobody judged the scene, and
+ * `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE` (any objections under it came from
+ * review batches that answered usably first, and are not the whole verdict).
+ *
+ * `validation.status` stays `"passed"` on both, so `metadata.review` being present is the only
+ * reliable test — use `scene3DReviewVerdictOf` from `@nodaro/shared` rather than reading it by
+ * hand, and `scene3DReviewNote` rather than writing the sentence yourself: a message that says
+ * the reviewer refused a scene nobody reviewed invents an opinion.
+ */
 type Scene3DJobOutput = Readonly<Scene3DJobOutputAny> & Readonly<Record<string, unknown>>;
-/** The settled 3D Render Pro result, plus any additive job metadata. */
+/**
+ * The settled 3D Render Pro result, plus any additive job metadata.
+ *
+ * On a run that AUTHORED, the result reports the run's own account of its answer:
+ * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION`, `metadata.summary`,
+ * `repairPasses` (`0` when accepted first time), `admissionRetries` (pre-build planner retries,
+ * which spend no repair pass), `mechanicalPasses` (repairs the engine authored itself from the
+ * compiler's own remedy, counted APART from `repairPasses` because they buy their own quoted
+ * allowance rather than spending one of your repairs) and `restoredAssertions`. A render-only
+ * export authored nothing, so it carries no summary and omits the counts rather than claiming `0`.
+ *
+ * The one case where `mechanicalPasses` IS a subset of `repairPasses` is a run quoted before that
+ * allowance existed — its quote carries no `mechanical` line. The discriminant is the quote, not
+ * the result, so read the quote you were given rather than deriving it from the two counts.
+ *
+ * A completed result may also be published without the visual reviewer's approval, and then
+ * `metadata.review` holds a verdict saying which way. `{ verdict: "refused", objections[],
+ * observed? }` is the ADVISORY delivery: every mandatory assertion passed, the reviewer still
+ * objected, and the scene was published once the repair budget was spent, with one
+ * `SCENE_REVIEW_REFUSED` warning per objection. `{ verdict: "unavailable", reason, attempts,
+ * objections[], observed? }` is the UNREVIEWED delivery: the review produced no usable verdict in
+ * `attempts` asks — `reason: "provider"` when it never reached its provider, `"unusable"` when the
+ * provider answered with nothing usable — so the assertion-passing scene was delivered with no
+ * verdict on it and `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE`. Objections on
+ * that arm are whatever review batches answered usably first — real, but not the whole verdict.
+ *
+ * `validation.status` is `"passed"` on both, so test for `metadata.review` — via
+ * `scene3DReviewVerdictOf` from `@nodaro/shared` — rather than for the status or the warnings,
+ * and render it with `scene3DReviewNote` rather than assuming a refusal.
+ */
 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";
@@ -1163,9 +1265,36 @@ declare class Scene3DResource {
     capabilities(): Promise<Scene3DCapabilities>;
     /** Current access to both the delivery and its source is required on every read. */
     getDelivery(jobId: string): Promise<Scene3DDelivery>;
+    /**
+     * The bytes of one descriptor the delivery listed.
+     *
+     * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which
+     * is why a `shot-still` now works: the route has served stills since they existed, and this
+     * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same
+     * map; the server still decides whether THIS caller may read it.
+     */
     deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: {
         signal?: AbortSignal;
     }): Promise<ArrayBuffer>;
+    /**
+     * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.
+     *
+     * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene
+     * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's
+     * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This
+     * fetches it in one call — delivery, then the `source-json` descriptor's bytes.
+     *
+     * `null` means the delivery has no retained recipe to hand back: no pass ever cleared
+     * admission, or this caller holds less than `edit` on the job's workflow and the descriptor
+     * is therefore not listed for them.
+     *
+     * Read it to see what was attempted and to inform the next prompt. There is no input that
+     * takes a recipe back: a refused run published no revision, so there is no `{kind:"scene"}`
+     * source to re-run it from.
+     */
+    retainedRecipe(jobId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<unknown | null>;
     /** 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. */
@@ -1210,9 +1339,21 @@ declare class Scene3DResource {
      *
      * 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.
+     * validation and renderer metadata. A run that AUTHORED also reports its own
+     * account of the answer — `metadata.summary`, `repairPasses`,
+     * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from
+     * the compiler's own remedy with no planner call, counted APART from
+     * `repairPasses` on their own quoted allowance), `restoredAssertions`, and
+     * any `SCENE_AUTHORING_ASSUMPTION` warnings. A
+     * completed result whose `metadata.review` is present passed every mandatory
+     * assertion but did NOT get the visual reviewer's approval: `verdict:
+     * "refused"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`
+     * warning; `verdict: "unavailable"` means the review produced no usable
+     * verdict in `attempts` asks (`reason: "provider"` — never reached its
+     * provider; `"unusable"` — it answered, unusably), so nobody judged the scene and
+     * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. 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>;
     /**
@@ -4076,7 +4217,7 @@ declare class PromptHelperResource {
 /**
  * Read access to ElevenLabs voices: the premade catalog plus the shared
  * community Voice Library (both public GETs, no body), and the signed-in
- * user's own voice clones (list / create-from-url / delete).
+ * user's own pre-retirement voice clones (list / delete).
  */
 declare class VoicesResource {
     private client;
@@ -4099,10 +4240,11 @@ declare class VoicesResource {
      */
     listClones(): Promise<VoiceClone[]>;
     /**
-     * Clone a voice from an already-uploaded audio URL
-     * (`POST /v1/voice-clones/from-url`). Costs credits. Returns the create
-     * subset of `VoiceClone` (`elevenlabsVoiceId` is the id to use at
-     * text-to-speech time).
+     * @deprecated Voice cloning is no longer offered on Nodaro (retired
+     * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
+     * rejects with that error. Clones created before the retirement are still
+     * listed by {@link VoicesResource.listClones} and still work as voice ids.
+     * For a new custom voice use {@link VoicesResource.design}.
      */
     createClone(input: {
         name: string;
@@ -4263,12 +4405,9 @@ declare class VoicesResource {
         jobId: string;
     }>;
     /**
-     * Clone a voice from an audio FILE you hold in memory
-     * (`POST /v1/voice-clones`, multipart) — the counterpart to
-     * {@link VoicesResource.createClone}, which clones from an already-uploaded
-     * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
-     * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
-     * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
+     * @deprecated Voice cloning is no longer offered on Nodaro (retired
+     * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
+     * rejects with that error. See {@link VoicesResource.createClone}.
      */
     createCloneFromFile(input: {
         name: string;
@@ -4586,6 +4725,16 @@ interface LlmStructuredJobInput extends LlmStructuredInput {
         llmModel?: string;
         selectionMode?: "choose" | "combine";
     };
+    /** Draft from THIS finished `video-analysis` job of yours instead of
+     *  analyzing `videoUrl` again: no second analysis, no second analysis
+     *  charge — a retry after a failed draft, another model, different
+     *  notes. `videoUrl` may still ride beside it as the record of the source.
+     *  422 when the job is not yours, does not exist, or is not a finished,
+     *  readable video analysis (`analysis_not_found` / `not_analysis` /
+     *  `analysis_failed` / `analysis_not_ready` / `invalid_analysis` — never a
+     *  404, which means the route itself is absent). Not combinable with
+     *  `videoAnalysis`. */
+    analysisJobId?: string;
 }
 /** `output_data` of an `llm-structured` job as it progresses: `stage` while
  *  running (`analyzing` only for movie runs), then the result. */
@@ -7844,4 +7993,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 CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppKind, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type OverlayPlacement, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppKind, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type OverlayPlacement, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, SCENE3D_DELIVERY_ASSET_USAGE, type SafetyBlockHint, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DDeliveryAssetKind, type Scene3DJobOutput, Scene3DResource, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };