@nodaro/sdk 1.16.0 → 1.17.0

package/dist/index.d.cts

@@ -141,7 +141,8 @@ declare class WorkflowsResource {
     update(id: string, input: UpdateWorkflowInput): Promise<{
         data: Workflow;
     }>;
-    /** Delete a workflow. Returns `{ success: true }`. */
+    /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
+     *  when the id doesn't exist or isn't yours (the delete is not silent). */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -455,7 +456,10 @@ interface NodeDescriptor {
     category: NodeCategory;
     description: string;
     outputType: OutputType;
-    /** Credit cost. Number when fixed, string range like "1-8" when model-dependent, undefined if free. */
+    /** Credit cost. Number when fixed, string range like "1-8" when
+     *  model-dependent. Undefined when the node is free — or on editions
+     *  without a credit system (community/business omit the field entirely;
+     *  it is meaningful on Cloud only). */
     creditCost?: number | string;
     /** Input fields the node exposes for user override (subset of full config). */
     inputSchema?: NodeInputSchema;
@@ -463,6 +467,16 @@ interface NodeDescriptor {
     providers?: string[];
     /** Capability flags such as "supports-reference-image" or "supports-end-frame". */
     capabilities?: string[];
+    /** Hard duration ceiling in seconds (e.g. Generate Video Pro's env-configured cap). */
+    maxDurationSec?: number;
+    /** Providers whose segment-duration menu is sparse (off-menu values snap to the nearest entry). */
+    sparseProviders?: string[];
+    /** Per-provider resolution tiers, e.g. `{ "minimax-h3": ["2K", "768P"] }`. */
+    providerResolutions?: Record<string, string[]>;
+    /** Per-provider map of display resolution → the literal wire value the API expects. */
+    providerResolutionWire?: Record<string, Record<string, string>>;
+    /** Generate Video Pro: the deployed engine accepts the `soundtrack` input (original-audio replay). */
+    soundtrack?: boolean;
 }
 /**
  * Result of a direct node execution. Most node types return `{ jobId }` and
@@ -736,7 +750,8 @@ declare class DeveloperAppsResource {
     update(id: string, input: UpdateDeveloperAppInput): Promise<{
         data: DeveloperApp;
     }>;
-    /** Delete a developer app. Returns `{ success: true }`. */
+    /** Delete a developer app. Returns `{ success: true }`. Throws
+     *  `NotFoundError` when the id doesn't exist or isn't yours. */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -3338,7 +3353,9 @@ interface ReduceInput {
     /**
      * Strategy-specific config. Defaults to `{}` server-side, which uses every
      * strategy's `defaultConfig`. Schemas (from `@nodaro/shared`):
-     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url" }`
+     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url", llmModel?: string }`
+     *     (`llmModel` = the judge model id from the LLM registry; omitted → the
+     *     feature default. Its tier sets the price: economy / standard / premium.)
      *   - `concat`: `{ separator?: string }`
      *   - `vote`: `{ caseSensitive?: boolean }`
      *   - `merge-json`: `{ strategy?: "deep" | "shallow" }`
@@ -4446,7 +4463,9 @@ interface ModelSummary {
     description: string;
     modes: string[];
     useCases: string[];
-    pricing: Array<{
+    /** Per-variant credit pricing. Cloud only — editions without a credit
+     *  system (community/business) omit the field entirely. */
+    pricing?: Array<{
         identifier: string;
         credits: number;
         note?: string;
@@ -4498,6 +4517,198 @@ declare class ModelsResource {
     list(opts?: ListModelsOptions): Promise<ModelsListResult>;
 }
 
+/**
+ * Cine shots — the Share → Remix record behind `/s/:id` share links.
+ * Mirrors the backend's `/v1/shots` wire contract (`shots.ts::toWire`);
+ * types are declared here so the SDK stays dependency-free — same
+ * convention as `ModelSummary` / `PickerCatalog`.
+ */
+/** An `@`-mention entity reference captured in the shot's prompt state. */
+interface ShotEntityRef {
+    entitySlug: string;
+    variantSlug?: string;
+    role?: string;
+    kind?: "character" | "location" | "object" | "creature";
+}
+type ShotMode = "single" | "multi-shot" | "frame-to-motion" | "storyboard";
+interface Shot {
+    id: string;
+    mode: ShotMode;
+    /** Opaque picker/builder selection state — round-tripped verbatim. */
+    selectionState: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    resultUrls?: string[];
+    visibility: "private" | "public";
+    schemaVersion: number;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateShotInput {
+    mode?: ShotMode;
+    selectionState?: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    /** Video model ids the shot targets (max 16). */
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    /**
+     * Result media URLs (max 32). Must be plain public http(s) URLs — the
+     * backend rejects signed URLs so a token can never leak into a share
+     * record.
+     */
+    resultUrls?: string[];
+    /** Rows default to private; sharing is an explicit "make public" action. */
+    visibility?: "private" | "public";
+}
+type UpdateShotInput = CreateShotInput;
+declare class ShotsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Create a shot record. Returns the new shot's id — an unguessable
+     *  capability string that doubles as the share-link path segment. */
+    create(input?: CreateShotInput): Promise<{
+        id: string;
+    }>;
+    /** Read a shot. Public shots are readable by anyone holding the id;
+     *  private shots resolve only for their owner (404 otherwise). */
+    get(id: string): Promise<{
+        shot: Shot;
+    }>;
+    /** Update an owned shot (any subset of fields, e.g. a visibility toggle). */
+    update(id: string, input: UpdateShotInput): Promise<{
+        shot: Shot;
+    }>;
+    /** Delete an owned shot. */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Recast — regenerate an analyzed source video with your own cast (the engine
+ * behind recast.nodaro.ai), plus the authored-script import lane ("movie as
+ * JSON", no source video).
+ *
+ * Cloud edition only: the `/v1/recast/*` and `/v1/video-analysis/import*`
+ * routes are served by the cloud plugin and 404 on self-hosted installs.
+ * Wire contract: docs/api-integration.md §13c/§13d and
+ * docs/mcp/recast-authoring.md. The interactive run is server-driven — poll
+ * `get()` and answer gates with `resolveGate()`; the platform advances every
+ * non-gate step itself.
+ */
+interface RecastScriptValidationError {
+    path: string;
+    message: string;
+    /** Written for an LLM repair loop — fix `path` using this and re-validate. */
+    hint?: string;
+}
+interface RecastScriptValidation {
+    valid: boolean;
+    errors: RecastScriptValidationError[];
+    warnings: string[];
+}
+interface RecastScriptImportResult {
+    /** A standard completed analysis job — feed it to `create()` as `analysisJobId`. */
+    jobId: string;
+    /** false when an identical script was already imported (idempotent re-import). */
+    created: boolean;
+    warnings: string[];
+    /** The document of record — WITH the server-derived fields; always prefer it
+     *  over your input. */
+    json: Record<string, unknown>;
+}
+interface CreateRecastInput {
+    /** Required: an existing workflow you own that the run attaches to. */
+    workflowId: string;
+    /** The source analysis job (from a video analysis or an authored-script import). */
+    analysisJobId: string;
+    /** Authored imports render `"faithful"` — exactly as written. */
+    fidelity?: string;
+    /** Required (`true`) for faithful renders of authored scripts. */
+    rightsAttested?: boolean;
+    resolution?: string;
+    segmentSec?: number;
+    renderMethod?: string;
+    /** Opt in to the interactive walk (pick-1-of-3 gates surfaced via `get()`). */
+    interactive?: boolean;
+    provider?: string;
+    /**
+     * Interactive gates the CLIENT can answer, e.g. `["sheet-gate"]`. The
+     * platform only opens a gate kind for runs whose create declared support
+     * for it — undeclared kinds are decided automatically.
+     */
+    clientCapabilities?: string[];
+}
+type EstimateRecastInput = Omit<CreateRecastInput, "workflowId" | "rightsAttested" | "clientCapabilities">;
+interface RecastEstimate {
+    totalCredits?: number;
+    breakdown?: Record<string, number>;
+    [key: string]: unknown;
+}
+/** Run snapshot — `status` plus, on interactive runs, the pending step. */
+interface RecastRunSnapshot {
+    status: string;
+    interactive?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ResolveRecastGateInput {
+    /** Which gate the picks answer. Defaults server-side to `"cast"`. */
+    gate?: "cast" | "sheet" | "anchors" | "music";
+    /** cast / sheet gates: the pick payload as surfaced by the pending gate. */
+    picks?: unknown;
+    /** anchors gate: which segment the anchor picks apply to. */
+    segment?: number;
+    anchorPicks?: {
+        start?: number;
+        end?: number;
+    };
+    /** music gate: which section the pick applies to. */
+    section?: number;
+    musicPick?: number | string;
+    /** Let the critic decide this and every remaining gate automatically. */
+    finishAuto?: boolean;
+}
+declare class RecastResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** The generated authoring guide (markdown): document contract, enum
+     *  vocabularies, bounds, audio rules, and a validated worked example. */
+    authoringSkill(): Promise<string>;
+    /** FREE validation of an authored script. Loop until `valid: true`. */
+    validateScript(script: Record<string, unknown>): Promise<RecastScriptValidation>;
+    /**
+     * Import a VALIDATED authored script as a completed analysis job.
+     * `rightsAttested: true` is required (403 otherwise) — authored recasts
+     * render Faithful, exactly as written, so only import work you own.
+     */
+    importScript(script: Record<string, unknown>, opts: {
+        rightsAttested: true;
+    }): Promise<RecastScriptImportResult>;
+    /** Quote a run (credits) before buying the plan. */
+    estimate(input: EstimateRecastInput): Promise<RecastEstimate>;
+    /** Create a run (buys the plan). Returns `{ recastId }`. */
+    create(input: CreateRecastInput): Promise<{
+        recastId: string;
+    }>;
+    /** Poll the run — status plus any pending interactive step. */
+    get(recastId: string): Promise<RecastRunSnapshot>;
+    /** Start rendering a `planned` run. Idempotent server-side. */
+    start(recastId: string, opts?: {
+        segmentSec?: number;
+        provider?: string;
+    }): Promise<{
+        gvpJobId?: string;
+    }>;
+    /** Answer a pending interactive gate (the pick itself is free). */
+    resolveGate(recastId: string, input: ResolveRecastGateInput): Promise<Record<string, unknown>>;
+}
+
 /**
  * The community-listing types are the single source of truth in
  * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
@@ -4812,6 +5023,8 @@ declare class NodaroClient {
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
     readonly models: ModelsResource;
+    readonly shots: ShotsResource;
+    readonly recast: RecastResource;
     readonly community: CommunityResource;
     readonly templates: TemplatesResource;
     readonly tutorials: TutorialsResource;
@@ -4916,4 +5129,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, 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 CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, 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 GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, 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 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, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, 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, 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 CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type EstimateRecastInput, 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 GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastEstimate, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, 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, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };

package/dist/index.d.ts

@@ -141,7 +141,8 @@ declare class WorkflowsResource {
     update(id: string, input: UpdateWorkflowInput): Promise<{
         data: Workflow;
     }>;
-    /** Delete a workflow. Returns `{ success: true }`. */
+    /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
+     *  when the id doesn't exist or isn't yours (the delete is not silent). */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -455,7 +456,10 @@ interface NodeDescriptor {
     category: NodeCategory;
     description: string;
     outputType: OutputType;
-    /** Credit cost. Number when fixed, string range like "1-8" when model-dependent, undefined if free. */
+    /** Credit cost. Number when fixed, string range like "1-8" when
+     *  model-dependent. Undefined when the node is free — or on editions
+     *  without a credit system (community/business omit the field entirely;
+     *  it is meaningful on Cloud only). */
     creditCost?: number | string;
     /** Input fields the node exposes for user override (subset of full config). */
     inputSchema?: NodeInputSchema;
@@ -463,6 +467,16 @@ interface NodeDescriptor {
     providers?: string[];
     /** Capability flags such as "supports-reference-image" or "supports-end-frame". */
     capabilities?: string[];
+    /** Hard duration ceiling in seconds (e.g. Generate Video Pro's env-configured cap). */
+    maxDurationSec?: number;
+    /** Providers whose segment-duration menu is sparse (off-menu values snap to the nearest entry). */
+    sparseProviders?: string[];
+    /** Per-provider resolution tiers, e.g. `{ "minimax-h3": ["2K", "768P"] }`. */
+    providerResolutions?: Record<string, string[]>;
+    /** Per-provider map of display resolution → the literal wire value the API expects. */
+    providerResolutionWire?: Record<string, Record<string, string>>;
+    /** Generate Video Pro: the deployed engine accepts the `soundtrack` input (original-audio replay). */
+    soundtrack?: boolean;
 }
 /**
  * Result of a direct node execution. Most node types return `{ jobId }` and
@@ -736,7 +750,8 @@ declare class DeveloperAppsResource {
     update(id: string, input: UpdateDeveloperAppInput): Promise<{
         data: DeveloperApp;
     }>;
-    /** Delete a developer app. Returns `{ success: true }`. */
+    /** Delete a developer app. Returns `{ success: true }`. Throws
+     *  `NotFoundError` when the id doesn't exist or isn't yours. */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -3338,7 +3353,9 @@ interface ReduceInput {
     /**
      * Strategy-specific config. Defaults to `{}` server-side, which uses every
      * strategy's `defaultConfig`. Schemas (from `@nodaro/shared`):
-     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url" }`
+     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url", llmModel?: string }`
+     *     (`llmModel` = the judge model id from the LLM registry; omitted → the
+     *     feature default. Its tier sets the price: economy / standard / premium.)
      *   - `concat`: `{ separator?: string }`
      *   - `vote`: `{ caseSensitive?: boolean }`
      *   - `merge-json`: `{ strategy?: "deep" | "shallow" }`
@@ -4446,7 +4463,9 @@ interface ModelSummary {
     description: string;
     modes: string[];
     useCases: string[];
-    pricing: Array<{
+    /** Per-variant credit pricing. Cloud only — editions without a credit
+     *  system (community/business) omit the field entirely. */
+    pricing?: Array<{
         identifier: string;
         credits: number;
         note?: string;
@@ -4498,6 +4517,198 @@ declare class ModelsResource {
     list(opts?: ListModelsOptions): Promise<ModelsListResult>;
 }
 
+/**
+ * Cine shots — the Share → Remix record behind `/s/:id` share links.
+ * Mirrors the backend's `/v1/shots` wire contract (`shots.ts::toWire`);
+ * types are declared here so the SDK stays dependency-free — same
+ * convention as `ModelSummary` / `PickerCatalog`.
+ */
+/** An `@`-mention entity reference captured in the shot's prompt state. */
+interface ShotEntityRef {
+    entitySlug: string;
+    variantSlug?: string;
+    role?: string;
+    kind?: "character" | "location" | "object" | "creature";
+}
+type ShotMode = "single" | "multi-shot" | "frame-to-motion" | "storyboard";
+interface Shot {
+    id: string;
+    mode: ShotMode;
+    /** Opaque picker/builder selection state — round-tripped verbatim. */
+    selectionState: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    resultUrls?: string[];
+    visibility: "private" | "public";
+    schemaVersion: number;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateShotInput {
+    mode?: ShotMode;
+    selectionState?: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    /** Video model ids the shot targets (max 16). */
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    /**
+     * Result media URLs (max 32). Must be plain public http(s) URLs — the
+     * backend rejects signed URLs so a token can never leak into a share
+     * record.
+     */
+    resultUrls?: string[];
+    /** Rows default to private; sharing is an explicit "make public" action. */
+    visibility?: "private" | "public";
+}
+type UpdateShotInput = CreateShotInput;
+declare class ShotsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Create a shot record. Returns the new shot's id — an unguessable
+     *  capability string that doubles as the share-link path segment. */
+    create(input?: CreateShotInput): Promise<{
+        id: string;
+    }>;
+    /** Read a shot. Public shots are readable by anyone holding the id;
+     *  private shots resolve only for their owner (404 otherwise). */
+    get(id: string): Promise<{
+        shot: Shot;
+    }>;
+    /** Update an owned shot (any subset of fields, e.g. a visibility toggle). */
+    update(id: string, input: UpdateShotInput): Promise<{
+        shot: Shot;
+    }>;
+    /** Delete an owned shot. */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Recast — regenerate an analyzed source video with your own cast (the engine
+ * behind recast.nodaro.ai), plus the authored-script import lane ("movie as
+ * JSON", no source video).
+ *
+ * Cloud edition only: the `/v1/recast/*` and `/v1/video-analysis/import*`
+ * routes are served by the cloud plugin and 404 on self-hosted installs.
+ * Wire contract: docs/api-integration.md §13c/§13d and
+ * docs/mcp/recast-authoring.md. The interactive run is server-driven — poll
+ * `get()` and answer gates with `resolveGate()`; the platform advances every
+ * non-gate step itself.
+ */
+interface RecastScriptValidationError {
+    path: string;
+    message: string;
+    /** Written for an LLM repair loop — fix `path` using this and re-validate. */
+    hint?: string;
+}
+interface RecastScriptValidation {
+    valid: boolean;
+    errors: RecastScriptValidationError[];
+    warnings: string[];
+}
+interface RecastScriptImportResult {
+    /** A standard completed analysis job — feed it to `create()` as `analysisJobId`. */
+    jobId: string;
+    /** false when an identical script was already imported (idempotent re-import). */
+    created: boolean;
+    warnings: string[];
+    /** The document of record — WITH the server-derived fields; always prefer it
+     *  over your input. */
+    json: Record<string, unknown>;
+}
+interface CreateRecastInput {
+    /** Required: an existing workflow you own that the run attaches to. */
+    workflowId: string;
+    /** The source analysis job (from a video analysis or an authored-script import). */
+    analysisJobId: string;
+    /** Authored imports render `"faithful"` — exactly as written. */
+    fidelity?: string;
+    /** Required (`true`) for faithful renders of authored scripts. */
+    rightsAttested?: boolean;
+    resolution?: string;
+    segmentSec?: number;
+    renderMethod?: string;
+    /** Opt in to the interactive walk (pick-1-of-3 gates surfaced via `get()`). */
+    interactive?: boolean;
+    provider?: string;
+    /**
+     * Interactive gates the CLIENT can answer, e.g. `["sheet-gate"]`. The
+     * platform only opens a gate kind for runs whose create declared support
+     * for it — undeclared kinds are decided automatically.
+     */
+    clientCapabilities?: string[];
+}
+type EstimateRecastInput = Omit<CreateRecastInput, "workflowId" | "rightsAttested" | "clientCapabilities">;
+interface RecastEstimate {
+    totalCredits?: number;
+    breakdown?: Record<string, number>;
+    [key: string]: unknown;
+}
+/** Run snapshot — `status` plus, on interactive runs, the pending step. */
+interface RecastRunSnapshot {
+    status: string;
+    interactive?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ResolveRecastGateInput {
+    /** Which gate the picks answer. Defaults server-side to `"cast"`. */
+    gate?: "cast" | "sheet" | "anchors" | "music";
+    /** cast / sheet gates: the pick payload as surfaced by the pending gate. */
+    picks?: unknown;
+    /** anchors gate: which segment the anchor picks apply to. */
+    segment?: number;
+    anchorPicks?: {
+        start?: number;
+        end?: number;
+    };
+    /** music gate: which section the pick applies to. */
+    section?: number;
+    musicPick?: number | string;
+    /** Let the critic decide this and every remaining gate automatically. */
+    finishAuto?: boolean;
+}
+declare class RecastResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** The generated authoring guide (markdown): document contract, enum
+     *  vocabularies, bounds, audio rules, and a validated worked example. */
+    authoringSkill(): Promise<string>;
+    /** FREE validation of an authored script. Loop until `valid: true`. */
+    validateScript(script: Record<string, unknown>): Promise<RecastScriptValidation>;
+    /**
+     * Import a VALIDATED authored script as a completed analysis job.
+     * `rightsAttested: true` is required (403 otherwise) — authored recasts
+     * render Faithful, exactly as written, so only import work you own.
+     */
+    importScript(script: Record<string, unknown>, opts: {
+        rightsAttested: true;
+    }): Promise<RecastScriptImportResult>;
+    /** Quote a run (credits) before buying the plan. */
+    estimate(input: EstimateRecastInput): Promise<RecastEstimate>;
+    /** Create a run (buys the plan). Returns `{ recastId }`. */
+    create(input: CreateRecastInput): Promise<{
+        recastId: string;
+    }>;
+    /** Poll the run — status plus any pending interactive step. */
+    get(recastId: string): Promise<RecastRunSnapshot>;
+    /** Start rendering a `planned` run. Idempotent server-side. */
+    start(recastId: string, opts?: {
+        segmentSec?: number;
+        provider?: string;
+    }): Promise<{
+        gvpJobId?: string;
+    }>;
+    /** Answer a pending interactive gate (the pick itself is free). */
+    resolveGate(recastId: string, input: ResolveRecastGateInput): Promise<Record<string, unknown>>;
+}
+
 /**
  * The community-listing types are the single source of truth in
  * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
@@ -4812,6 +5023,8 @@ declare class NodaroClient {
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
     readonly models: ModelsResource;
+    readonly shots: ShotsResource;
+    readonly recast: RecastResource;
     readonly community: CommunityResource;
     readonly templates: TemplatesResource;
     readonly tutorials: TutorialsResource;
@@ -4916,4 +5129,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, 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 CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, 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 GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, 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 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, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, 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, 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 CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type EstimateRecastInput, 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 GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastEstimate, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, 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, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };