@nodaro/sdk 2.44.0 → 2.45.1

package/dist/entries/media.d.cts

@@ -434,13 +434,16 @@ declare class MediaResource {
      * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded
      * to 4 decimals) and `kept` (any region left on any frame: false only when
      * the size / zone filters left an empty mask — read it rather than
-     * `coverage`, which a few pixels round to 0). Feed the mask to
+     * `coverage`, which a few pixels round to 0), and `recipe` (the version of
+     * the masking algorithm that made it, `VIDEO_MASK_RECIPE`: it changes
+     * whenever the same clip and settings would give a different mask). Feed the mask to
      * {@link MediaResource.maskComposite}.
      *
      * `holdLastMask: true` keeps the last mask on frames where the subject is
      * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a
      * hand): each such frame after the first detection repeats the most recent
-     * non-empty one; the output then also carries `heldFrames`.
+     * non-empty one, for at most 1 s of frames (`VIDEO_MASK_LIMITS.HOLD_MAX_SEC`;
+     * longer gaps stay empty after that); the output then also carries `heldFrames`.
      * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected
      * region whose bounding box is shorter than that % of the frame height
      * (extras' small faces behind the main subject); it runs before
@@ -456,7 +459,15 @@ declare class MediaResource {
      * detected again after every cut, `holdLastMask` never crosses a cut, and
      * each shot's mask is fitted to that shot's exact frame count; on a clip
      * with no cut it gives the same mask, fitted to the clip's exact frame
-     * count. The output carries `shots` (1 when off).
+     * count. The output carries `shots` (1 when off). `redetectEverySec` (0 =
+     * off, the default, or 1–10) also detects the subject again every that
+     * many seconds — the clip (each shot, with `perShot`) is sent to the model
+     * in pieces of at most that length, a last piece under 8 frames joining the
+     * one before — so someone who walks in or turns to the camera mid-shot is
+     * masked from the next boundary on. These boundaries are not cuts:
+     * `holdLastMask` holds across them. Each piece is one more model request
+     * (three run at a time), so it is slower; the price does not change. The
+     * output's `chunks` counts the requests.
      */
     videoMask(input: VideoMaskRequest): Promise<{
         jobId: string;

package/dist/entries/media.d.ts

@@ -434,13 +434,16 @@ declare class MediaResource {
      * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded
      * to 4 decimals) and `kept` (any region left on any frame: false only when
      * the size / zone filters left an empty mask — read it rather than
-     * `coverage`, which a few pixels round to 0). Feed the mask to
+     * `coverage`, which a few pixels round to 0), and `recipe` (the version of
+     * the masking algorithm that made it, `VIDEO_MASK_RECIPE`: it changes
+     * whenever the same clip and settings would give a different mask). Feed the mask to
      * {@link MediaResource.maskComposite}.
      *
      * `holdLastMask: true` keeps the last mask on frames where the subject is
      * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a
      * hand): each such frame after the first detection repeats the most recent
-     * non-empty one; the output then also carries `heldFrames`.
+     * non-empty one, for at most 1 s of frames (`VIDEO_MASK_LIMITS.HOLD_MAX_SEC`;
+     * longer gaps stay empty after that); the output then also carries `heldFrames`.
      * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected
      * region whose bounding box is shorter than that % of the frame height
      * (extras' small faces behind the main subject); it runs before
@@ -456,7 +459,15 @@ declare class MediaResource {
      * detected again after every cut, `holdLastMask` never crosses a cut, and
      * each shot's mask is fitted to that shot's exact frame count; on a clip
      * with no cut it gives the same mask, fitted to the clip's exact frame
-     * count. The output carries `shots` (1 when off).
+     * count. The output carries `shots` (1 when off). `redetectEverySec` (0 =
+     * off, the default, or 1–10) also detects the subject again every that
+     * many seconds — the clip (each shot, with `perShot`) is sent to the model
+     * in pieces of at most that length, a last piece under 8 frames joining the
+     * one before — so someone who walks in or turns to the camera mid-shot is
+     * masked from the next boundary on. These boundaries are not cuts:
+     * `holdLastMask` holds across them. Each piece is one more model request
+     * (three run at a time), so it is slower; the price does not change. The
+     * output's `chunks` counts the requests.
      */
     videoMask(input: VideoMaskRequest): Promise<{
         jobId: string;

package/dist/entries/media.js

@@ -1,5 +1,5 @@
 import '../chunk-ES2E65HT.js';
-export { MediaResource } from '../chunk-DQAYIVVS.js';
+export { MediaResource } from '../chunk-BQAW4RX2.js';
 import '../chunk-7CUWAVWB.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=media.js.map

package/dist/entries/nodes.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk7CK6I4CT_cjs = require('../chunk-7CK6I4CT.cjs');
-var chunk2VJOHJUZ_cjs = require('../chunk-2VJOHJUZ.cjs');
+var chunk5IXZLQNT_cjs = require('../chunk-5IXZLQNT.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
@@ -16,7 +16,7 @@ Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
 });
 Object.defineProperty(exports, "NodesResource", {
   enumerable: true,
-  get: function () { return chunk2VJOHJUZ_cjs.NodesResource; }
+  get: function () { return chunk5IXZLQNT_cjs.NodesResource; }
 });
 //# sourceMappingURL=nodes.cjs.map
 //# sourceMappingURL=nodes.cjs.map

package/dist/entries/nodes.d.cts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-DzBGNOUV.cjs';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-Szl6HrZ_.cjs';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.d.ts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-B4ZEqx2V.js';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-MThDit8l.js';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.js

@@ -1,5 +1,5 @@
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '../chunk-ZYPH2FPT.js';
-export { NodesResource } from '../chunk-ZWPDWFN2.js';
+export { NodesResource } from '../chunk-JB4GVP4Q.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=nodes.js.map
 //# sourceMappingURL=nodes.js.map

package/dist/entries/objects.d.cts

@@ -1,7 +1,7 @@
 import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities';
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DzBGNOUV.cjs';
+import { l as GenerationSessionParams } from '../nodes-Szl6HrZ_.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/objects.d.ts

@@ -1,7 +1,7 @@
 import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities';
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-B4ZEqx2V.js';
+import { l as GenerationSessionParams } from '../nodes-MThDit8l.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/scene3d.d.cts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-DzBGNOUV.cjs';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-DzBGNOUV.cjs';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-Szl6HrZ_.cjs';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-Szl6HrZ_.cjs';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
 import '@nodaro/shared/types';

package/dist/entries/scene3d.d.ts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-B4ZEqx2V.js';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-B4ZEqx2V.js';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-MThDit8l.js';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-MThDit8l.js';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
 import '@nodaro/shared/types';

package/dist/entries/templates.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-37YCKZX4.cjs');
-var chunkEK672FFM_cjs = require('../chunk-EK672FFM.cjs');
+var chunkUIBYZNDR_cjs = require('../chunk-UIBYZNDR.cjs');
 
 
 
 Object.defineProperty(exports, "TemplatesResource", {
   enumerable: true,
-  get: function () { return chunkEK672FFM_cjs.TemplatesResource; }
+  get: function () { return chunkUIBYZNDR_cjs.TemplatesResource; }
 });
 //# sourceMappingURL=templates.cjs.map
 //# sourceMappingURL=templates.cjs.map

package/dist/entries/templates.d.cts

@@ -19,7 +19,7 @@ interface TemplateBrowseCard {
     /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
     estimatedCredits: number;
     /** The listed price holds a metered LLM call's ESTIMATE (its model's typical
-     *  call, charged its actual usage per token): show it `~N`. Absent for a
+     *  call, charged its actual usage per token): show it `≈N`. Absent for a
      *  fixed price, and on a deployment running the tier-pricing rollback. */
     estimatedCreditsIsEstimate?: true;
     /**

package/dist/entries/templates.d.ts

@@ -19,7 +19,7 @@ interface TemplateBrowseCard {
     /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
     estimatedCredits: number;
     /** The listed price holds a metered LLM call's ESTIMATE (its model's typical
-     *  call, charged its actual usage per token): show it `~N`. Absent for a
+     *  call, charged its actual usage per token): show it `≈N`. Absent for a
      *  fixed price, and on a deployment running the tier-pricing rollback. */
     estimatedCreditsIsEstimate?: true;
     /**

package/dist/entries/templates.js

@@ -1,4 +1,4 @@
 import '../chunk-LHRQXWI5.js';
-export { TemplatesResource } from '../chunk-ILG5DHQQ.js';
+export { TemplatesResource } from '../chunk-M7VSFZMV.js';
 //# sourceMappingURL=templates.js.map
 //# sourceMappingURL=templates.js.map

package/dist/entries/trends.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-PG2GBS3K.cjs');
-var chunkQHXLMCBR_cjs = require('../chunk-QHXLMCBR.cjs');
+var chunkJ6FHBQ4Z_cjs = require('../chunk-J6FHBQ4Z.cjs');
 
 
 
 Object.defineProperty(exports, "TrendsResource", {
   enumerable: true,
-  get: function () { return chunkQHXLMCBR_cjs.TrendsResource; }
+  get: function () { return chunkJ6FHBQ4Z_cjs.TrendsResource; }
 });
 //# sourceMappingURL=trends.cjs.map
 //# sourceMappingURL=trends.cjs.map

package/dist/entries/trends.d.cts

@@ -36,7 +36,10 @@ interface TrendCard {
     tags: string[];
     /** e.g. `"trending"`, `"new"`. */
     badges: string[];
-    /** The trend's first example (never the clip it recasts). */
+    /**
+     * The trend's first example, else (a trend with no example) its original's
+     * display copy, as {@link TrendDetail.original}.
+     */
     cover: {
         videoUrl: string;
         posterUrl?: string;
@@ -55,9 +58,18 @@ interface TrendDetailSlot {
     key: string;
     label: string;
     kind: TrendSlotKind;
-    /** A required slot needs pictures; an optional one left empty takes the chosen example's. */
+    /**
+     * A required slot needs pictures; an optional one left empty takes the
+     * chosen example's, or, on a trend with no example, stays as in the original.
+     */
     required: boolean;
     hint?: string;
+    /**
+     * A picture showing who or what this slot is in the original (e.g. a frame
+     * of that actor), when the trend has one. Show it on an empty slot; a run
+     * never sends it.
+     */
+    hintImageUrl?: string;
     /**
      * The chips you may set on this slot, in its kind's order; `[]` = none (show
      * no chips row). A chip of the kind that is not listed is fixed by the
@@ -76,12 +88,36 @@ interface TrendExample {
     /** Slot key → the pictures this example used for it. */
     slots: Record<string, string[]>;
 }
+/**
+ * The clip a trend recasts, as you may show it: a browser-safe copy (H.264
+ * MP4) of the clip every run starts from. Its fields parallel
+ * {@link TrendExample}'s.
+ */
+interface TrendOriginal {
+    videoUrl: string;
+    posterUrl?: string;
+    width: number;
+    height: number;
+    /** The copy's length, in seconds. */
+    durationSec: number;
+    /**
+     * Where the 4-second preview starts in the clip, in seconds (`0` included),
+     * when the trend offers one ({@link TrendDetail.previewSec} is `4`); absent
+     * otherwise.
+     */
+    previewStartSec?: number;
+}
 /** A trend's page (`get()`). */
 interface TrendDetail extends TrendCard {
     /** The published version this page shows. */
     version: number;
     /** `4` when the trend offers a 4-second preview run, else `null`. */
     previewSec: 4 | null;
+    /**
+     * The original clip every run starts from, to show beside the examples.
+     * Absent only on a version without a display copy (and from an older server).
+     */
+    original?: TrendOriginal;
     /** The video engine every run of this trend uses. Absent (an older server) = `"seedance-2-5"`. */
     engine?: TrendEngine;
     /**
@@ -91,6 +127,7 @@ interface TrendDetail extends TrendCard {
      */
     resolutions: TrendResolution[];
     slots: TrendDetailSlot[];
+    /** Finished runs to show beside the original; may be empty (a trend with only its original). */
     examples: TrendExample[];
 }
 /** What you put in one slot of a run: 1–3 pictures, and the chips the slot offers ({@link TrendDetailSlot.chips}). */
@@ -101,10 +138,15 @@ interface TrendRunSlot extends TrendChips {
 interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
-     * optional slot left out takes the chosen example's. 1–3 pictures per slot.
+     * optional slot left out takes the chosen example's, or, on a trend with no
+     * example, stays as in the original. 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
-    /** 1-based example whose pictures fill the optional slots you leave empty. Default 1. */
+    /**
+     * 1-based example whose pictures fill the optional slots you leave empty.
+     * Default 1. Leave it out on a trend with no examples: sending one there
+     * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
+     */
     example?: number;
     /** Your own words, at most 1,000 characters. Mention a slot as `{slot:<key>}`. */
     details?: string;
@@ -179,7 +221,11 @@ interface TrendRunDisplaySlot extends TrendChips {
     label: string;
     kind: TrendSlotKind;
     images: string[];
-    /** `true` when the slot was left empty and the example's pictures filled it. */
+    /**
+     * `true` when the slot was left empty and the example's pictures filled it.
+     * `false` with no `images`: left empty on a trend with no example, so it
+     * stayed as in the original.
+     */
     fromExample: boolean;
 }
 /**
@@ -214,7 +260,10 @@ interface TrendRun {
         version: number;
         name: string;
     };
-    /** The 1-based example used for empty optional slots. */
+    /**
+     * The 1-based example used for empty optional slots; `0` = the trend had no
+     * example (none was used: never show it as "Example 0").
+     */
     example: number;
     slots: TrendRunDisplaySlot[];
     details?: string;
@@ -326,4 +375,4 @@ declare class TrendsResource {
     unfavorite(slug: string): Promise<void>;
 }
 
-export { type ListTrendRunsParams, type ListTrendsParams, type TrendCard, type TrendChipKey, type TrendChips, type TrendChoice, type TrendDetail, type TrendDetailSlot, type TrendEngine, type TrendEstimate, type TrendExample, type TrendPage, type TrendResolution, type TrendRun, type TrendRunDisplaySlot, type TrendRunOptions, type TrendRunRequest, type TrendRunSlot, type TrendSlotKind, type TrendTag, TrendsResource };
+export { type ListTrendRunsParams, type ListTrendsParams, type TrendCard, type TrendChipKey, type TrendChips, type TrendChoice, type TrendDetail, type TrendDetailSlot, type TrendEngine, type TrendEstimate, type TrendExample, type TrendOriginal, type TrendPage, type TrendResolution, type TrendRun, type TrendRunDisplaySlot, type TrendRunOptions, type TrendRunRequest, type TrendRunSlot, type TrendSlotKind, type TrendTag, TrendsResource };

package/dist/entries/trends.d.ts

@@ -36,7 +36,10 @@ interface TrendCard {
     tags: string[];
     /** e.g. `"trending"`, `"new"`. */
     badges: string[];
-    /** The trend's first example (never the clip it recasts). */
+    /**
+     * The trend's first example, else (a trend with no example) its original's
+     * display copy, as {@link TrendDetail.original}.
+     */
     cover: {
         videoUrl: string;
         posterUrl?: string;
@@ -55,9 +58,18 @@ interface TrendDetailSlot {
     key: string;
     label: string;
     kind: TrendSlotKind;
-    /** A required slot needs pictures; an optional one left empty takes the chosen example's. */
+    /**
+     * A required slot needs pictures; an optional one left empty takes the
+     * chosen example's, or, on a trend with no example, stays as in the original.
+     */
     required: boolean;
     hint?: string;
+    /**
+     * A picture showing who or what this slot is in the original (e.g. a frame
+     * of that actor), when the trend has one. Show it on an empty slot; a run
+     * never sends it.
+     */
+    hintImageUrl?: string;
     /**
      * The chips you may set on this slot, in its kind's order; `[]` = none (show
      * no chips row). A chip of the kind that is not listed is fixed by the
@@ -76,12 +88,36 @@ interface TrendExample {
     /** Slot key → the pictures this example used for it. */
     slots: Record<string, string[]>;
 }
+/**
+ * The clip a trend recasts, as you may show it: a browser-safe copy (H.264
+ * MP4) of the clip every run starts from. Its fields parallel
+ * {@link TrendExample}'s.
+ */
+interface TrendOriginal {
+    videoUrl: string;
+    posterUrl?: string;
+    width: number;
+    height: number;
+    /** The copy's length, in seconds. */
+    durationSec: number;
+    /**
+     * Where the 4-second preview starts in the clip, in seconds (`0` included),
+     * when the trend offers one ({@link TrendDetail.previewSec} is `4`); absent
+     * otherwise.
+     */
+    previewStartSec?: number;
+}
 /** A trend's page (`get()`). */
 interface TrendDetail extends TrendCard {
     /** The published version this page shows. */
     version: number;
     /** `4` when the trend offers a 4-second preview run, else `null`. */
     previewSec: 4 | null;
+    /**
+     * The original clip every run starts from, to show beside the examples.
+     * Absent only on a version without a display copy (and from an older server).
+     */
+    original?: TrendOriginal;
     /** The video engine every run of this trend uses. Absent (an older server) = `"seedance-2-5"`. */
     engine?: TrendEngine;
     /**
@@ -91,6 +127,7 @@ interface TrendDetail extends TrendCard {
      */
     resolutions: TrendResolution[];
     slots: TrendDetailSlot[];
+    /** Finished runs to show beside the original; may be empty (a trend with only its original). */
     examples: TrendExample[];
 }
 /** What you put in one slot of a run: 1–3 pictures, and the chips the slot offers ({@link TrendDetailSlot.chips}). */
@@ -101,10 +138,15 @@ interface TrendRunSlot extends TrendChips {
 interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
-     * optional slot left out takes the chosen example's. 1–3 pictures per slot.
+     * optional slot left out takes the chosen example's, or, on a trend with no
+     * example, stays as in the original. 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
-    /** 1-based example whose pictures fill the optional slots you leave empty. Default 1. */
+    /**
+     * 1-based example whose pictures fill the optional slots you leave empty.
+     * Default 1. Leave it out on a trend with no examples: sending one there
+     * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
+     */
     example?: number;
     /** Your own words, at most 1,000 characters. Mention a slot as `{slot:<key>}`. */
     details?: string;
@@ -179,7 +221,11 @@ interface TrendRunDisplaySlot extends TrendChips {
     label: string;
     kind: TrendSlotKind;
     images: string[];
-    /** `true` when the slot was left empty and the example's pictures filled it. */
+    /**
+     * `true` when the slot was left empty and the example's pictures filled it.
+     * `false` with no `images`: left empty on a trend with no example, so it
+     * stayed as in the original.
+     */
     fromExample: boolean;
 }
 /**
@@ -214,7 +260,10 @@ interface TrendRun {
         version: number;
         name: string;
     };
-    /** The 1-based example used for empty optional slots. */
+    /**
+     * The 1-based example used for empty optional slots; `0` = the trend had no
+     * example (none was used: never show it as "Example 0").
+     */
     example: number;
     slots: TrendRunDisplaySlot[];
     details?: string;
@@ -326,4 +375,4 @@ declare class TrendsResource {
     unfavorite(slug: string): Promise<void>;
 }
 
-export { type ListTrendRunsParams, type ListTrendsParams, type TrendCard, type TrendChipKey, type TrendChips, type TrendChoice, type TrendDetail, type TrendDetailSlot, type TrendEngine, type TrendEstimate, type TrendExample, type TrendPage, type TrendResolution, type TrendRun, type TrendRunDisplaySlot, type TrendRunOptions, type TrendRunRequest, type TrendRunSlot, type TrendSlotKind, type TrendTag, TrendsResource };
+export { type ListTrendRunsParams, type ListTrendsParams, type TrendCard, type TrendChipKey, type TrendChips, type TrendChoice, type TrendDetail, type TrendDetailSlot, type TrendEngine, type TrendEstimate, type TrendExample, type TrendOriginal, type TrendPage, type TrendResolution, type TrendRun, type TrendRunDisplaySlot, type TrendRunOptions, type TrendRunRequest, type TrendRunSlot, type TrendSlotKind, type TrendTag, TrendsResource };

package/dist/entries/trends.js

@@ -1,4 +1,4 @@
 import '../chunk-YCVRQZT3.js';
-export { TrendsResource } from '../chunk-4UPVE662.js';
+export { TrendsResource } from '../chunk-CKHCSZCV.js';
 //# sourceMappingURL=trends.js.map
 //# sourceMappingURL=trends.js.map

package/dist/entries/tutorials.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-VLCNNA76.cjs');
-var chunkFHVNTS4E_cjs = require('../chunk-FHVNTS4E.cjs');
+var chunkKMNSPC72_cjs = require('../chunk-KMNSPC72.cjs');
 
 
 
 Object.defineProperty(exports, "TutorialsResource", {
   enumerable: true,
-  get: function () { return chunkFHVNTS4E_cjs.TutorialsResource; }
+  get: function () { return chunkKMNSPC72_cjs.TutorialsResource; }
 });
 //# sourceMappingURL=tutorials.cjs.map
 //# sourceMappingURL=tutorials.cjs.map

package/dist/entries/tutorials.d.cts

@@ -34,7 +34,7 @@ interface TutorialFlowItem {
     /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
     estimatedCredits: number;
     /** The listed price holds a metered LLM call's ESTIMATE (its model's typical
-     *  call, charged its actual usage per token): show it `~N`. Absent for a
+     *  call, charged its actual usage per token): show it `≈N`. Absent for a
      *  fixed price, and on a deployment running the tier-pricing rollback. */
     estimatedCreditsIsEstimate?: true;
     /** Credits per minute of the recording the template is given (see `TemplateBrowseCard`); 0 or absent when none. */

package/dist/entries/tutorials.d.ts

@@ -34,7 +34,7 @@ interface TutorialFlowItem {
     /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
     estimatedCredits: number;
     /** The listed price holds a metered LLM call's ESTIMATE (its model's typical
-     *  call, charged its actual usage per token): show it `~N`. Absent for a
+     *  call, charged its actual usage per token): show it `≈N`. Absent for a
      *  fixed price, and on a deployment running the tier-pricing rollback. */
     estimatedCreditsIsEstimate?: true;
     /** Credits per minute of the recording the template is given (see `TemplateBrowseCard`); 0 or absent when none. */

package/dist/entries/tutorials.js

@@ -1,4 +1,4 @@
 import '../chunk-VT237QF2.js';
-export { TutorialsResource } from '../chunk-YSZM3N7Q.js';
+export { TutorialsResource } from '../chunk-HPXE3NZW.js';
 //# sourceMappingURL=tutorials.js.map
 //# sourceMappingURL=tutorials.js.map

package/dist/entries/workflows.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-45CK55BH.cjs');
-var chunkVYEGCEZ3_cjs = require('../chunk-VYEGCEZ3.cjs');
+var chunkWUM6CWTE_cjs = require('../chunk-WUM6CWTE.cjs');
 
 
 
 Object.defineProperty(exports, "WorkflowsResource", {
   enumerable: true,
-  get: function () { return chunkVYEGCEZ3_cjs.WorkflowsResource; }
+  get: function () { return chunkWUM6CWTE_cjs.WorkflowsResource; }
 });
 //# sourceMappingURL=workflows.cjs.map
 //# sourceMappingURL=workflows.cjs.map

package/dist/entries/workflows.d.cts

@@ -198,14 +198,21 @@ interface RenderFinalQuote {
     estimatedCredits: number | null;
     /**
      * Present (`true`) when `estimatedCredits` includes an LLM node's estimate:
-     * an LLM call is charged its actual usage after it runs, so show `~N`.
+     * an LLM call is charged its actual usage after it runs, so show `≈N`.
      * Absent for a fixed price.
      */
     estimatedCreditsIsEstimate?: true;
     /**
-     * Whether the payer can cover `estimatedCredits`; `null` in an edition
-     * without credits. When `false`, {@link WorkflowsResource.renderFinal} is
-     * refused with `InsufficientCreditsError` before any execution exists.
+     * What the run holds while it renders (a UGC clip at its hold), never below
+     * `estimatedCredits`: the figure `sufficient` is checked against. `null` in
+     * an edition without credits; absent from an older server.
+     */
+    holdCredits?: number | null;
+    /**
+     * Whether the payer can cover what the run holds (`holdCredits`); `null` in
+     * an edition without credits. When `false`, {@link WorkflowsResource.renderFinal}
+     * is refused with `InsufficientCreditsError` (its `required` is that hold)
+     * before any execution exists.
      */
     sufficient: boolean | null;
     /**

package/dist/entries/workflows.d.ts

@@ -198,14 +198,21 @@ interface RenderFinalQuote {
     estimatedCredits: number | null;
     /**
      * Present (`true`) when `estimatedCredits` includes an LLM node's estimate:
-     * an LLM call is charged its actual usage after it runs, so show `~N`.
+     * an LLM call is charged its actual usage after it runs, so show `≈N`.
      * Absent for a fixed price.
      */
     estimatedCreditsIsEstimate?: true;
     /**
-     * Whether the payer can cover `estimatedCredits`; `null` in an edition
-     * without credits. When `false`, {@link WorkflowsResource.renderFinal} is
-     * refused with `InsufficientCreditsError` before any execution exists.
+     * What the run holds while it renders (a UGC clip at its hold), never below
+     * `estimatedCredits`: the figure `sufficient` is checked against. `null` in
+     * an edition without credits; absent from an older server.
+     */
+    holdCredits?: number | null;
+    /**
+     * Whether the payer can cover what the run holds (`holdCredits`); `null` in
+     * an edition without credits. When `false`, {@link WorkflowsResource.renderFinal}
+     * is refused with `InsufficientCreditsError` (its `required` is that hold)
+     * before any execution exists.
      */
     sufficient: boolean | null;
     /**

package/dist/entries/workflows.js

@@ -1,4 +1,4 @@
 import '../chunk-PGYQ754I.js';
-export { WorkflowsResource } from '../chunk-RETNLKOC.js';
+export { WorkflowsResource } from '../chunk-33HT46A3.js';
 //# sourceMappingURL=workflows.js.map
 //# sourceMappingURL=workflows.js.map