@nodaro/sdk 2.10.0 → 2.11.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { SCENE3D_V2_LIMITS, WORKSPACE_HEADER } from '@nodaro/shared';
-export { 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, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER } from '@nodaro/shared';
+export { 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, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER, nodeStateMayCarryOutput } from '@nodaro/shared';
 import { buildPersonHints } from '@nodaro/prompts';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts';
 
@@ -475,8 +475,6 @@ var VideoProResource = class {
     });
   }
 };
-
-// src/resources/executions.ts
 var ExecutionsResource = class {
   constructor(client) {
     this.client = client;
@@ -625,6 +623,17 @@ var NodesResource = class {
     }
   }
 };
+
+// src/resources/scene3d-types.ts
+var SCENE3D_DELIVERY_ASSET_USAGE = {
+  poster: "poster",
+  "validation-report": "validation",
+  "shot-still": "shot-still",
+  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
+  "source-json": "checkpoint"
+};
+
+// src/resources/scene3d.ts
 function newIdempotencyKey() {
   const random = globalThis.crypto?.randomUUID?.();
   return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
@@ -641,8 +650,16 @@ var Scene3DResource = class {
   getDelivery(jobId) {
     return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
   }
+  /**
+   * 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, asset, options) {
-    if (asset.kind !== "poster" && asset.kind !== "validation-report" || asset.usage !== (asset.kind === "poster" ? "poster" : "validation")) {
+    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {
       throw new Error("This asset is not available through the delivery endpoint");
     }
     if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
@@ -653,6 +670,29 @@ var Scene3DResource = class {
       maxBytes: asset.byteLength
     });
   }
+  /**
+   * 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.
+   */
+  async retainedRecipe(jobId, options) {
+    const delivery = await this.getDelivery(jobId);
+    const asset = delivery.assets.find((item) => item.kind === "source-json");
+    if (!asset) return null;
+    const bytes = await this.deliveryAssetBytes(jobId, asset, options);
+    return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+  }
   /** Persist deterministic overlays without an LLM or a generation charge. */
   applyEdits(revisionId, params) {
     return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
@@ -725,9 +765,21 @@ var Scene3DResource = class {
    *
    * 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.
    */
   async renderProAndWait(params, options) {
     const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
@@ -1872,10 +1924,11 @@ var VoicesResource = class {
     return res.voiceClones;
   }
   /**
-   * 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) {
     return this.client.request("POST", "/v1/voice-clones/from-url", { body: input });
@@ -2009,12 +2062,9 @@ var VoicesResource = class {
     return this.client.request("POST", "/v1/text-to-dialogue", { body: input });
   }
   /**
-   * 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) {
     const form = new FormData();
@@ -3401,7 +3451,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.10.0" ;
+var SDK_VERSION = "2.11.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3662,6 +3712,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, Scene3DResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, Scene3DResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map