@nodaro/sdk 2.28.0 → 2.31.0

package/dist/entries/recast.d.ts

@@ -0,0 +1,229 @@
+import { RecastSegmentPack } from '@nodaro/shared/apps';
+export { RECAST_SEGMENT_PACKS, RecastSegmentPack } from '@nodaro/shared/apps';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/organizations';
+
+/**
+ * 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;
+    /** How the render packs scenes into parts — a name, not seconds. */
+    segmentSec?: RecastSegmentPack;
+    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;
+}
+type RecastAudioLayerName = "music" | "video";
+interface RecastAudioMixControl {
+    /** Linear gain percentage. The server rounds and clamps this to 0–200. */
+    gain: number;
+    /** A muted lane has an effective wire gain of zero. */
+    muted: boolean;
+}
+/** Complete desired controls for the logical lanes addressed by an operation. */
+interface RecastAudioMix {
+    music?: RecastAudioMixControl;
+    video?: RecastAudioMixControl;
+}
+interface RecastAudioManifestV1 {
+    version: 1;
+    /** Opaque server-minted identity of the currently published audio delivery. */
+    revision: string;
+    mode: "bed" | "replace";
+    /** Logical layers in the delivery, including layers whose preview derivative failed. */
+    present: {
+        music?: true;
+        video?: true;
+    };
+    /** Browser-ready, CORS-enabled audio-only derivatives. */
+    layers: {
+        music?: {
+            url: string;
+        };
+        video?: {
+            url: string;
+        };
+    };
+    /** Effective integer gain percentages baked into the current `resultUrl`. */
+    bakedEffectiveGain: {
+        music?: number;
+        video?: number;
+    };
+    /** Present only while a paid audio operation is genuinely live. */
+    pendingRescore?: {
+        jobId: string;
+        requestId: string;
+        state: "pending" | "running";
+        expectedAudioRevision: string;
+        requestedEffectiveGain: {
+            music?: number;
+            video?: number;
+        };
+    };
+}
+interface RecastAudioSectionReplacement {
+    index: number;
+    brief: string;
+}
+/** Exactly one replacement lane may be combined with a mix. */
+type RecastRescoreReplacement = {
+    audioUrl: string;
+    sections?: never;
+} | {
+    sections: RecastAudioSectionReplacement[];
+    audioUrl?: never;
+};
+type RecastNoReplacement = {
+    audioUrl?: never;
+    sections?: never;
+};
+/** A mix, one Music replacement, or a replacement and its complete desired mix. */
+type RecastRescoreOperation = ({
+    mix: RecastAudioMix;
+} & (RecastRescoreReplacement | RecastNoReplacement)) | (RecastRescoreReplacement & {
+    mix?: RecastAudioMix;
+});
+/** Free quote input. `requestId` is deliberately absent because quoting has no side effects. */
+type EstimateRecastRescoreInput = RecastRescoreOperation & {
+    expectedAudioRevision: string;
+};
+/** Revision-safe paid operation. Reuse `requestId` only for transport retries. */
+type RecastRescoreRequestV2 = EstimateRecastRescoreInput & {
+    requestId: string;
+};
+interface RecastRescoreQuote {
+    credits: number;
+    audioRevision: string;
+    noOp: boolean;
+}
+type RecastRescoreResponse = {
+    recastId: string;
+    jobId: string;
+    noOp?: false;
+} | {
+    recastId: string;
+    noOp: true;
+    audioRevision: string;
+};
+/** Run snapshot — `status` plus, on interactive runs, the pending step. */
+interface RecastRunSnapshot {
+    status: string;
+    interactive?: Record<string, unknown>;
+    /** Presence of `audioLayers: 1` opts a client into the revisioned audio contract. */
+    capabilities?: {
+        audioLayers?: 1;
+        [key: string]: unknown;
+    };
+    /** Server-authored manifest for the selected completed take. */
+    audio?: RecastAudioManifestV1;
+    [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: NodaroClientCore);
+    /** 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>;
+    /** Quote a revisioned Music replacement and/or complete desired mix. Free. */
+    estimateRescore(recastId: string, input: EstimateRecastRescoreInput): Promise<RecastRescoreQuote>;
+    /** Apply a quoted audio operation. Reuse its request id only for a transport retry. */
+    rescore(recastId: string, input: RecastRescoreRequestV2): Promise<RecastRescoreResponse>;
+    /** Start rendering a `planned` run. Idempotent server-side. */
+    start(recastId: string, opts?: {
+        segmentSec?: RecastSegmentPack;
+        provider?: string;
+    }): Promise<{
+        gvpJobId?: string;
+    }>;
+    /** Answer a pending interactive gate (the pick itself is free). */
+    resolveGate(recastId: string, input: ResolveRecastGateInput): Promise<Record<string, unknown>>;
+}
+
+export { type CreateRecastInput, type EstimateRecastInput, type EstimateRecastRescoreInput, 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 ResolveRecastGateInput };

package/dist/entries/recast.js

@@ -0,0 +1,4 @@
+export { RECAST_SEGMENT_PACKS } from '../chunk-RJIJVVXS.js';
+export { RecastResource } from '../chunk-AJVSMNPZ.js';
+//# sourceMappingURL=recast.js.map
+//# sourceMappingURL=recast.js.map

package/dist/entries/recast.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"recast.js"}

package/dist/entries/reduce.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-GI7LROLL.cjs');
+var chunkGB6C5OEZ_cjs = require('../chunk-GB6C5OEZ.cjs');
+
+
+
+Object.defineProperty(exports, "ReduceResource", {
+  enumerable: true,
+  get: function () { return chunkGB6C5OEZ_cjs.ReduceResource; }
+});
+//# sourceMappingURL=reduce.cjs.map
+//# sourceMappingURL=reduce.cjs.map

package/dist/entries/reduce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"reduce.cjs"}

package/dist/entries/reduce.d.cts

@@ -0,0 +1,56 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { ReduceStrategyId, ReduceMeta } from '@nodaro/shared/workflow';
+export { ReduceMeta, ReduceStrategyId } from '@nodaro/shared/workflow';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface ReduceInput {
+    /** Which fan-in strategy to run. */
+    strategyId: ReduceStrategyId;
+    /**
+     * 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", 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" }`
+     *   - `first-non-empty`, `count`: `{}`
+     */
+    strategyConfig?: Record<string, unknown>;
+    /** Up to 1000 input strings (URLs, text fragments, etc.). */
+    inputs: string[];
+    /**
+     * Optional — associates this reduce run with a workflow execution. The
+     * server reads this from the body before Zod strips it (same path as
+     * other job-creating routes).
+     */
+    workflowId?: string;
+}
+interface ReduceResult {
+    jobId: string;
+    /**
+     * Stringified result — for `count` this is a numeric string, for
+     * `merge-json` this is the JSON-encoded merged object, otherwise the
+     * chosen / joined text.
+     */
+    output: string;
+    meta: ReduceMeta;
+}
+declare class ReduceResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Run the Reduce (fan-in) node directly — useful for scripted batch
+     * scoring, picking the best of N generations outside a workflow, or
+     * one-shot programmatic merges.
+     *
+     * Throws `NodaroError` on 4xx/5xx responses (e.g. `code: "no_valid_inputs"`
+     * with status 400 when every input is empty / whitespace; the underlying
+     * `EmptyInputError` is mapped to a 400 server-side).
+     */
+    run(input: ReduceInput): Promise<ReduceResult>;
+}
+
+export { type ReduceInput, ReduceResource, type ReduceResult };

package/dist/entries/reduce.d.ts

@@ -0,0 +1,56 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { ReduceStrategyId, ReduceMeta } from '@nodaro/shared/workflow';
+export { ReduceMeta, ReduceStrategyId } from '@nodaro/shared/workflow';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface ReduceInput {
+    /** Which fan-in strategy to run. */
+    strategyId: ReduceStrategyId;
+    /**
+     * 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", 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" }`
+     *   - `first-non-empty`, `count`: `{}`
+     */
+    strategyConfig?: Record<string, unknown>;
+    /** Up to 1000 input strings (URLs, text fragments, etc.). */
+    inputs: string[];
+    /**
+     * Optional — associates this reduce run with a workflow execution. The
+     * server reads this from the body before Zod strips it (same path as
+     * other job-creating routes).
+     */
+    workflowId?: string;
+}
+interface ReduceResult {
+    jobId: string;
+    /**
+     * Stringified result — for `count` this is a numeric string, for
+     * `merge-json` this is the JSON-encoded merged object, otherwise the
+     * chosen / joined text.
+     */
+    output: string;
+    meta: ReduceMeta;
+}
+declare class ReduceResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Run the Reduce (fan-in) node directly — useful for scripted batch
+     * scoring, picking the best of N generations outside a workflow, or
+     * one-shot programmatic merges.
+     *
+     * Throws `NodaroError` on 4xx/5xx responses (e.g. `code: "no_valid_inputs"`
+     * with status 400 when every input is empty / whitespace; the underlying
+     * `EmptyInputError` is mapped to a 400 server-side).
+     */
+    run(input: ReduceInput): Promise<ReduceResult>;
+}
+
+export { type ReduceInput, ReduceResource, type ReduceResult };

package/dist/entries/reduce.js

@@ -0,0 +1,4 @@
+import '../chunk-6JFNBAKV.js';
+export { ReduceResource } from '../chunk-IHKIYVZQ.js';
+//# sourceMappingURL=reduce.js.map
+//# sourceMappingURL=reduce.js.map

package/dist/entries/reduce.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"reduce.js"}

package/dist/entries/saved-posts.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-BAL576G2.cjs');
+var chunkSYVNY3AH_cjs = require('../chunk-SYVNY3AH.cjs');
+
+
+
+Object.defineProperty(exports, "SavedPostsResource", {
+  enumerable: true,
+  get: function () { return chunkSYVNY3AH_cjs.SavedPostsResource; }
+});
+//# sourceMappingURL=saved-posts.cjs.map
+//# sourceMappingURL=saved-posts.cjs.map

package/dist/entries/saved-posts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"saved-posts.cjs"}

package/dist/entries/saved-posts.d.cts

@@ -0,0 +1,33 @@
+import { ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostsLookupResult, UpdateSavedPostInput } from '@nodaro/shared/social';
+export { ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostSource, SavedPostsLookupResult, UpdateSavedPostInput } from '@nodaro/shared/social';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Saved posts — the inspiration wall.
+ *
+ * Save a post you found (a Social Search result, `nodes.run("social-search")`)
+ * with a note and tags, list and filter your saves, and change or remove them.
+ * A save keeps a snapshot of the post and a copy of its still in your storage.
+ * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.
+ */
+declare class SavedPostsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
+    list(params?: ListSavedPostsParams): Promise<ListSavedPostsResult>;
+    /**
+     * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
+     * updates its note and tags (when given) and returns the existing save.
+     */
+    save(input: SavePostInput): Promise<SavedPost>;
+    /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
+    lookup(postIds: readonly string[]): Promise<SavedPostsLookupResult>;
+    /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
+    update(id: string, input: UpdateSavedPostInput): Promise<SavedPost>;
+    /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
+    delete(id: string): Promise<void>;
+}
+
+export { SavedPostsResource };

package/dist/entries/saved-posts.d.ts

@@ -0,0 +1,33 @@
+import { ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostsLookupResult, UpdateSavedPostInput } from '@nodaro/shared/social';
+export { ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostSource, SavedPostsLookupResult, UpdateSavedPostInput } from '@nodaro/shared/social';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Saved posts — the inspiration wall.
+ *
+ * Save a post you found (a Social Search result, `nodes.run("social-search")`)
+ * with a note and tags, list and filter your saves, and change or remove them.
+ * A save keeps a snapshot of the post and a copy of its still in your storage.
+ * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.
+ */
+declare class SavedPostsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
+    list(params?: ListSavedPostsParams): Promise<ListSavedPostsResult>;
+    /**
+     * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
+     * updates its note and tags (when given) and returns the existing save.
+     */
+    save(input: SavePostInput): Promise<SavedPost>;
+    /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
+    lookup(postIds: readonly string[]): Promise<SavedPostsLookupResult>;
+    /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
+    update(id: string, input: UpdateSavedPostInput): Promise<SavedPost>;
+    /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
+    delete(id: string): Promise<void>;
+}
+
+export { SavedPostsResource };

package/dist/entries/saved-posts.js

@@ -0,0 +1,4 @@
+import '../chunk-OJDBSKC2.js';
+export { SavedPostsResource } from '../chunk-NCCBS6GU.js';
+//# sourceMappingURL=saved-posts.js.map
+//# sourceMappingURL=saved-posts.js.map

package/dist/entries/saved-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"saved-posts.js"}

package/dist/entries/scene3d.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+require('../chunk-KEDPGWIK.cjs');
+var chunkYDRXBRW2_cjs = require('../chunk-YDRXBRW2.cjs');
+
+
+
+Object.defineProperty(exports, "SCENE3D_DELIVERY_ASSET_USAGE", {
+  enumerable: true,
+  get: function () { return chunkYDRXBRW2_cjs.SCENE3D_DELIVERY_ASSET_USAGE; }
+});
+Object.defineProperty(exports, "Scene3DResource", {
+  enumerable: true,
+  get: function () { return chunkYDRXBRW2_cjs.Scene3DResource; }
+});
+//# sourceMappingURL=scene3d.cjs.map
+//# sourceMappingURL=scene3d.cjs.map

package/dist/entries/scene3d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"scene3d.cjs"}

package/dist/entries/scene3d.d.cts

@@ -0,0 +1,131 @@
+import { s as NodesResource, Q as Scene3DCapabilities, T as Scene3DDelivery, U as Scene3DDeliveryAsset, y as RetainedScene3DEditParams, z as RetainedScene3DEditResult, j as GenerateScene3DParams, K as RunNodeResult, C as RunAndWaitOptions, W as Scene3DJobOutput, d as EditScene3DParams, t as Pro3DRenderParams, u as Pro3DRenderQuote, w as Pro3DRenderRunParams, v as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, x as RenderScene3DParams, r as NodeJobOutput } from '../nodes-BPvrAoUs.cjs';
+export { S as SCENE3D_DELIVERY_ASSET_USAGE, M as Scene3DAuthoringEngine, V as Scene3DDeliveryAssetKind } from '../nodes-BPvrAoUs.cjs';
+import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/types';
+import '@nodaro/shared/video';
+import '@nodaro/shared/models';
+import '@nodaro/shared/nodes';
+import '@nodaro/shared/social';
+import '@nodaro/shared/media';
+import '@nodaro/shared/credits';
+import '@nodaro/shared/entities';
+import './jobs.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+import './errors.cjs';
+import '../studio-productions-DUHvdSvk.cjs';
+import '@nodaro/shared/model-catalog';
+import '@nodaro/prompts/prompt-builder';
+
+/** Scene authoring and render-only export through the same platform nodes. */
+declare class Scene3DResource {
+    private client;
+    /** Every operation runs a platform node, so the client must carry `nodes` too. */
+    constructor(client: NodaroClientCore & {
+        readonly nodes: NodesResource;
+    });
+    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. */
+    assetBytes(revisionId: string, asset: Scene3DAssetRef, options?: {
+        signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
+    /** The editable native file has its own authorization lane. */
+    sourceBytes(revisionId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
+    generate(params: GenerateScene3DParams): Promise<RunNodeResult>;
+    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. 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>;
+    /**
+     * Uses the supplied immutable revision; never starts authoring or a rebuild.
+     *
+     * Priced by the plan's frame size — see {@link RenderScene3DParams}.
+     */
+    render(params: RenderScene3DParams): Promise<RunNodeResult>;
+    renderAndWait(params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput>;
+}
+
+export { EditScene3DParams, GenerateScene3DParams, Pro3DRenderJobOutput, Pro3DRenderParams, Pro3DRenderQuote, Pro3DRenderRunOptions, Pro3DRenderRunParams, RenderScene3DParams, RetainedScene3DEditParams, RetainedScene3DEditResult, Scene3DCapabilities, Scene3DDelivery, Scene3DDeliveryAsset, Scene3DJobOutput, Scene3DResource };