@nodaro/sdk 2.43.0 → 2.45.1

package/dist/entries/trends.d.ts

@@ -1,4 +1,5 @@
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { CastSwapEngine } from './cast-swap.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 
@@ -21,6 +22,11 @@ interface TrendChips {
 /** A chip's name: `body`, `outfit`, `hair`, `coat`, `shape` or `finish`. */
 type TrendChipKey = keyof TrendChips;
 type TrendResolution = "480p" | "720p" | "1080p";
+/**
+ * The video engine a trend runs on ({@link CastSwapEngine}): the trend
+ * chooses it, never the person running it.
+ */
+type TrendEngine = CastSwapEngine;
 /** A trend in the catalog (`list()`). Text is in the resolved locale. */
 interface TrendCard {
     id: string;
@@ -30,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;
@@ -49,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
@@ -70,14 +88,46 @@ 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;
+    /**
+     * The resolutions a run may ask for, the default first. Seedance 2.5:
+     * `["480p", "720p", "1080p"]`, where 480p is a draft (show it as one);
+     * Kling 4: `["720p", "1080p"]`, no draft. Offer exactly these.
+     */
     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}). */
@@ -88,18 +138,30 @@ 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;
     /** `true` runs a 4-second preview (only when the trend's `previewSec` is `4`). */
     preview?: boolean;
-    /** Default `"480p"`. */
+    /**
+     * One of the trend's {@link TrendDetail.resolutions}; default its first
+     * (`"480p"` on Seedance 2.5, `"720p"` on Kling 4). Another answers 400
+     * `resolution_unsupported`.
+     */
     resolution?: TrendResolution;
-    /** A draft run, only at 480p. Default `true` at 480p. */
+    /**
+     * A draft run, only at 480p on a Seedance 2.5 trend. Default `true` at
+     * 480p. `true` on a Kling 4 trend answers 400 `draft_unsupported`.
+     */
     draft?: boolean;
     /**
      * A generation session of yours. Accepted (and checked: one you may not use
@@ -159,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;
 }
 /**
@@ -194,21 +260,26 @@ 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;
     preview: boolean;
     resolution: string;
     draft: boolean;
+    /** The video engine the run was made on. Absent (an older server) = `"seedance-2-5"`. */
+    engine?: TrendEngine;
     /** The result, once completed. */
     videoUrl: string | null;
     posterUrl: string | null;
     creditsCharged: number | null;
-    /** A Full Quality version: the job id of the draft run it was made from. `null` for any other run. */
+    /** A Full Quality version: the job id of the run (a draft, or a Kling 4 720p run) it was made from. `null` for any other run. */
     fullQualityOf: string | null;
     /**
-     * A draft's newest Full Quality try, if one was started: a pointer only,
+     * A draft's (or Kling 4 720p run's) newest Full Quality try, if one was started: a pointer only,
      * to know an upgrade exists and how it is going. Its video and charge are on
      * that run, listed on its own (its `fullQualityOf` is this run's `jobId`) —
      * read it there (`getRun(fullQuality.jobId)`). Older tries of the draft (a
@@ -219,7 +290,11 @@ interface TrendRun {
         jobId: string;
         status: string;
     } | null;
-    /** Until when a completed draft can be redone in Full Quality; `null` otherwise. */
+    /**
+     * Until when a completed run can be redone in Full Quality — a Seedance 2.5
+     * draft (the same take at 1080p) or a Kling 4 run at 720p (a new take at
+     * 1080p); `null` otherwise.
+     */
     fullQualityUntil: string | null;
 }
 interface ListTrendsParams {
@@ -300,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 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-WK7C7TP6.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 chunkVHSMOBU7_cjs = require('../chunk-VHSMOBU7.cjs');
+var chunkWUM6CWTE_cjs = require('../chunk-WUM6CWTE.cjs');
 
 
 
 Object.defineProperty(exports, "WorkflowsResource", {
   enumerable: true,
-  get: function () { return chunkVHSMOBU7_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;
     /**
@@ -272,6 +279,64 @@ declare class WorkflowCollaboratorsResource {
         success: true;
     }>;
 }
+/** One MCP conversation: a flow its assistant built step by step (`GET /v1/mcp-conversations`). */
+interface McpConversation {
+    /** The conversation's workflow id — open it with {@link WorkflowsResource.get}. */
+    id: string;
+    projectId: string;
+    name: string;
+    /** The source: "claude", "claude-code", "chatgpt", or another client's name in lower case. */
+    client: string;
+    clientLabel: string;
+    /** The connection's own name, as the connector was named. */
+    clientName: string;
+    startedAt: string;
+    lastActivityAt: string;
+    /** Still receiving steps: its last step is less than 30 minutes old. */
+    live: boolean;
+    /** The user's first request, when the assistant passed it. */
+    firstRequest: string | null;
+    nodeCount: number;
+    counts: {
+        image: number;
+        video: number;
+        audio: number;
+    };
+    /** Credits charged for its jobs; null where credits are not billed. */
+    credits: number | null;
+    cover: {
+        url: string;
+        kind: "image" | "video";
+        setByUser: boolean;
+    } | null;
+    updatedAt: string;
+}
+interface ListMcpConversationsParams {
+    /** "YYYY-MM". Default: the latest month that has conversations. */
+    month?: string;
+    /** Keep only these sources ("claude", "claude-code", "chatgpt", …). */
+    sources?: readonly string[];
+}
+interface McpConversationList {
+    /** The month listed. */
+    month: string;
+    /** Every month that has conversations, newest first, with its count. */
+    months: Array<{
+        month: string;
+        conversations: number;
+    }>;
+    /** The month's sources, with the connection names each one folds in. */
+    sources: Array<{
+        client: string;
+        label: string;
+        conversations: number;
+        connections: Array<{
+            clientName: string;
+            conversations: number;
+        }>;
+    }>;
+    data: McpConversation[];
+}
 declare class WorkflowsResource {
     private client;
     /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */
@@ -394,6 +459,12 @@ declare class WorkflowsResource {
     sharedWithMe(): Promise<{
         data: SharedWorkflow[];
     }>;
+    /**
+     * Your MCP conversations of one month (`GET /v1/mcp-conversations`): each is a
+     * flow an assistant built from its steps, newest first. A conversation is a
+     * workflow, so open, rename, export or delete it with the other methods here.
+     */
+    listMcpConversations(params?: ListMcpConversationsParams): Promise<McpConversationList>;
 }
 
-export { type AddCollaboratorInput, type Collaborator, type CreateWorkflowInput, type DroppedCollaborator, type ListWorkflowsParams, type RenderFinalParams, type RenderFinalQuote, type RunWorkflowOptions, type RunWorkflowParams, type RunWorkflowResult, type SharedWorkflow, type UpdateWorkflowInput, type Workflow, WorkflowsResource };
+export { type AddCollaboratorInput, type Collaborator, type CreateWorkflowInput, type DroppedCollaborator, type ListMcpConversationsParams, type ListWorkflowsParams, type McpConversation, type McpConversationList, type RenderFinalParams, type RenderFinalQuote, type RunWorkflowOptions, type RunWorkflowParams, type RunWorkflowResult, type SharedWorkflow, type UpdateWorkflowInput, type Workflow, WorkflowsResource };

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;
     /**
@@ -272,6 +279,64 @@ declare class WorkflowCollaboratorsResource {
         success: true;
     }>;
 }
+/** One MCP conversation: a flow its assistant built step by step (`GET /v1/mcp-conversations`). */
+interface McpConversation {
+    /** The conversation's workflow id — open it with {@link WorkflowsResource.get}. */
+    id: string;
+    projectId: string;
+    name: string;
+    /** The source: "claude", "claude-code", "chatgpt", or another client's name in lower case. */
+    client: string;
+    clientLabel: string;
+    /** The connection's own name, as the connector was named. */
+    clientName: string;
+    startedAt: string;
+    lastActivityAt: string;
+    /** Still receiving steps: its last step is less than 30 minutes old. */
+    live: boolean;
+    /** The user's first request, when the assistant passed it. */
+    firstRequest: string | null;
+    nodeCount: number;
+    counts: {
+        image: number;
+        video: number;
+        audio: number;
+    };
+    /** Credits charged for its jobs; null where credits are not billed. */
+    credits: number | null;
+    cover: {
+        url: string;
+        kind: "image" | "video";
+        setByUser: boolean;
+    } | null;
+    updatedAt: string;
+}
+interface ListMcpConversationsParams {
+    /** "YYYY-MM". Default: the latest month that has conversations. */
+    month?: string;
+    /** Keep only these sources ("claude", "claude-code", "chatgpt", …). */
+    sources?: readonly string[];
+}
+interface McpConversationList {
+    /** The month listed. */
+    month: string;
+    /** Every month that has conversations, newest first, with its count. */
+    months: Array<{
+        month: string;
+        conversations: number;
+    }>;
+    /** The month's sources, with the connection names each one folds in. */
+    sources: Array<{
+        client: string;
+        label: string;
+        conversations: number;
+        connections: Array<{
+            clientName: string;
+            conversations: number;
+        }>;
+    }>;
+    data: McpConversation[];
+}
 declare class WorkflowsResource {
     private client;
     /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */
@@ -394,6 +459,12 @@ declare class WorkflowsResource {
     sharedWithMe(): Promise<{
         data: SharedWorkflow[];
     }>;
+    /**
+     * Your MCP conversations of one month (`GET /v1/mcp-conversations`): each is a
+     * flow an assistant built from its steps, newest first. A conversation is a
+     * workflow, so open, rename, export or delete it with the other methods here.
+     */
+    listMcpConversations(params?: ListMcpConversationsParams): Promise<McpConversationList>;
 }
 
-export { type AddCollaboratorInput, type Collaborator, type CreateWorkflowInput, type DroppedCollaborator, type ListWorkflowsParams, type RenderFinalParams, type RenderFinalQuote, type RunWorkflowOptions, type RunWorkflowParams, type RunWorkflowResult, type SharedWorkflow, type UpdateWorkflowInput, type Workflow, WorkflowsResource };
+export { type AddCollaboratorInput, type Collaborator, type CreateWorkflowInput, type DroppedCollaborator, type ListMcpConversationsParams, type ListWorkflowsParams, type McpConversation, type McpConversationList, type RenderFinalParams, type RenderFinalQuote, type RunWorkflowOptions, type RunWorkflowParams, type RunWorkflowResult, type SharedWorkflow, type UpdateWorkflowInput, type Workflow, WorkflowsResource };

package/dist/entries/workflows.js

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