@nodaro/sdk 2.43.0 → 2.44.0

package/dist/chunk-VYEGCEZ3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/workflows.ts"],"names":[],"mappings":"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","file":"chunk-VYEGCEZ3.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  GenericNode,\n  GenericEdge,\n} from \"@nodaro/shared/types\"\nimport type {\n  WorkflowExport,\n  WorkflowImportReport,\n} from \"@nodaro/shared/workflow\"\nimport type {\n  WorkflowVisibility,\n  CollaboratorRole,\n} from \"@nodaro/shared/organizations\"\n\n/**\n * Workflow metadata + (when fetched as a single record) full nodes/edges/settings.\n *\n * The list endpoint returns metadata only; `get`, `create`, and `update` return the\n * full record. `nodes`, `edges`, `settings`, and `sourcePrompt` are present only on\n * full records and omitted in list responses.\n */\nexport interface Workflow {\n  id: string\n  projectId: string | null\n  userId: string\n  name: string\n  description?: string | null\n  folderId?: string | null\n  isTemplate?: boolean\n  version?: number\n  thumbnailUrl?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListWorkflowsParams {\n  /** Required — list endpoint is `/v1/projects/:projectId/workflows`. */\n  projectId: string\n}\n\nexport interface CreateWorkflowInput {\n  /** Required — workflow is created under this project. */\n  projectId: string\n  name: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n}\n\nexport interface UpdateWorkflowInput {\n  name?: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n  thumbnailUrl?: string | null\n  /**\n   * Optimistic concurrency: the `updatedAt` your copy of the workflow was\n   * loaded with. When the row has since been written by another tab/device,\n   * the update is rejected with HTTP 409 `workflow_conflict`\n   * (`WorkflowConflictError`) carrying the current record — re-read/merge and\n   * retry instead of last-writer-wins clobbering the other writer's changes.\n   * Omit for the legacy unconditional replace.\n   */\n  expectedUpdatedAt?: string\n  /**\n   * Optimistic concurrency by monotonic version — preferred over\n   * `expectedUpdatedAt` (integer bumped by the DB on every content change).\n   */\n  expectedVersion?: number\n}\n\nexport interface RunWorkflowParams {\n  /**\n   * Optional subset of node IDs to execute. Omit to run the full workflow.\n   * With `continueMode: \"from-failed\"`, the nodes to consider (default: the\n   * nodes the run's chain was first started on, plus every node left failed or\n   * held back; see `continueMode`); the run executes only those the failed run\n   * did not complete. Every id sent counts as named: a node of work no run of\n   * the chain ever ran (each only handed on its saved results) runs and is\n   * priced, while a source, trigger, parameter picker or container keeps what\n   * the run handed on and a node set to skip never runs.\n   */\n  nodeIds?: string[]\n  /**\n   * Per-node field overrides for this run only, `{ [nodeId]: { field: value } }`,\n   * shallow-merged over each node's saved data (the node's saved results are\n   * not used). A run through the API has nobody to review a Preview render, so\n   * a workflow whose Apply EDL render is set to Preview is refused\n   * (`preview_review_required`) unless the run sets it to Final:\n   * `{ [renderNodeId]: { quality: \"final\" } }`. A node with Review before\n   * render on (Tighten Episode, Trailer) is refused the same way (turn its\n   * review off). A failed execution records what held it —\n   * `preview_review_required` / `preview_render_nested` (a render),\n   * `…_review_on` (a review-on node) or `…_mixed` (both); match all six with\n   * `isPreviewRefusalCode` from `@nodaro/shared`. A review-on Tighten Episode\n   * fed by a List is refused with `use_case_review_list_driven`; a Trailer fed\n   * by a List, with `use_case_list_driven`.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n  /**\n   * Continue from an earlier execution of this workflow — Render final after a\n   * run that stopped at its preview, or (with `continueMode: \"from-failed\"`) a\n   * failed run from where it stopped. The run executes `nodeIds` only\n   * (required with this field, except with `continueMode`); every other node\n   * hands on what that execution produced, not the workflow's saved results,\n   * and an Edit Plan hands on its plan with the person's review applied. The\n   * execution must be your own `completed` run of this workflow (`failed`,\n   * with `continueMode`), not of a published app version. Refused with\n   * `continuation_subset_required`, `continuation_not_found` (404),\n   * `continuation_workflow_mismatch`, `continuation_version_mismatch` or\n   * `continuation_not_completed` (409). A continuation its payer cannot cover\n   * (with or without `continueMode`, priced on the nodes it runs) throws\n   * `InsufficientCreditsError` before any execution exists, checked as a\n   * {@link WorkflowsResource.renderFinal} is.\n   */\n  continueFromExecutionId?: string\n  /**\n   * `\"from-failed\"`: continue a FAILED run (`continueFromExecutionId`) from\n   * where it stopped. It runs every node that run did not complete — of\n   * `nodeIds`, which default to the nodes the run was started on (a run\n   * started on named nodes is continued on those, a run of every node on every\n   * node; a continuation of a continuation keeps those of the first run of its\n   * chain) plus every node the run left failed or held back — and hands on\n   * what it completed,\n   * never run or charged again. That is per node: a node that failed runs\n   * again in full, every list item included. When a later continuation of it\n   * completed only part of what it left (a narrower `nodeIds`), the run builds\n   * on the newest such one: it is seeded from that run and runs only what is\n   * still left ({@link RunWorkflowResult.continuedFrom} names it). A node\n   * `nodeIds` names that no run of the chain ever ran runs too, and is priced\n   * (see `nodeIds`). A Render\n   * final, or a run of named nodes, continuing the newest of those counts as\n   * one of them too. Not combinable with {@link renderFinal}. Refused with\n   * `continuation_not_failed` (409) for a run that did not fail,\n   * `continuation_superseded` (409) when a later continuation supersedes it —\n   * the message names that run: one that failed (continue that one instead),\n   * or one that completed all this run left (the work is done, and its results\n   * are on that run) — `continuation_preview_pending` (409, a\n   * `ContinuationPreviewPendingError`) when the newest later continuation\n   * stopped at a Preview review of a render or of a Tighten Episode (the error\n   * names that run, what holds it, and in `next` the run that finishes it:\n   * `client.workflows.run(workflowId, error.next)` first — for a single render,\n   * its {@link renderFinal}), and\n   * `continuation_subset_required` (409) when nothing is left to run. Send an\n   * {@link RunWorkflowOptions.idempotencyKey} with each continuation.\n   */\n  continueMode?: \"from-failed\"\n}\n\n/** Per-call options for {@link WorkflowsResource.run}. */\nexport interface RunWorkflowOptions {\n  /**\n   * Sent as the `Idempotency-Key` header (at least 8 characters; the server\n   * ignores a shorter one). Reuse the same value when retrying the same\n   * request: the server answers the run it already started (`deduped: true`)\n   * instead of starting a second one — or, once that run is under way or has\n   * superseded the one it continued, refuses with `already_running` (an\n   * `AlreadyRunningError` carrying its `executionId`) or\n   * `continuation_superseded` naming it. Either way nothing runs twice.\n   */\n  idempotencyKey?: string\n}\n\nexport interface RunWorkflowResult {\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** `true` when an `idempotencyKey` retry found the run already started: `executionId` is that run. */\n  deduped?: boolean\n  /**\n   * With `continueMode: \"from-failed\"`: the execution the run continued from —\n   * its states seed the run. The run asked for (`continueFromExecutionId`), or\n   * the newest later continuation of it that completed part of what it left.\n   * Absent on any other run, and on a `deduped` answer.\n   */\n  continuedFrom?: string\n}\n\n/**\n * A Render final: the Apply EDL render at Final for this run only, and every\n * node after it (Camera Switch first, in multicam). The server works out which\n * nodes run — the same rule as the editor's Render final button.\n */\nexport interface RenderFinalParams {\n  /** The Apply EDL render node to finalize. */\n  renderNodeId: string\n  /**\n   * The execution that stopped at the preview: your own `completed` run of\n   * this workflow. Every node the Render final does not run hands on what it\n   * produced (an Edit Plan hands on its plan with the review applied).\n   */\n  continueFromExecutionId: string\n}\n\n/** What a Render final will run and charge. Nothing is created by the quote. */\nexport interface RenderFinalQuote {\n  renderNodeId: string\n  /** The nodes the run executes, in canvas order. */\n  nodeIds: string[]\n  /** The one-shot override it runs with: `{ [renderNodeId]: { quality: \"final\" } }`. */\n  inputOverrides: Record<string, Record<string, unknown>>\n  /** Estimated credits; `null` in an edition without credits. */\n  estimatedCredits: number | null\n  /**\n   * Present (`true`) when `estimatedCredits` includes an LLM node's estimate:\n   * an LLM call is charged its actual usage after it runs, so show `~N`.\n   * Absent for a fixed price.\n   */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Whether the payer can cover `estimatedCredits`; `null` in an edition\n   * without credits. When `false`, {@link WorkflowsResource.renderFinal} is\n   * refused with `InsufficientCreditsError` before any execution exists.\n   */\n  sufficient: boolean | null\n  /**\n   * The payer's spendable credits; `null` when it is not yours to see (a\n   * deployment's operator pays) or a workspace budget pays.\n   */\n  available: number | null\n}\n\n/** A person granted access to a workflow. Email is never returned (privacy). */\nexport interface Collaborator {\n  userId: string\n  name?: string | null\n  avatar?: string | null\n  role: CollaboratorRole\n}\n\nexport interface AddCollaboratorInput {\n  /** Provide exactly one of `userId` or `email`. */\n  userId?: string\n  email?: string\n  role: CollaboratorRole\n}\n\n/** A workflow someone else shared with you, plus the role you hold on it. */\nexport interface SharedWorkflow extends Workflow {\n  grantedRole: CollaboratorRole\n}\n\n/** A grant dropped because a move took the workflow out of the workspace the\n *  access came from. */\nexport interface DroppedCollaborator {\n  userId: string\n  name: string | null\n}\n\n/**\n * The people a workflow is shared with — reached as `client.workflows.collaborators`.\n * All four endpoints are served by the organizations feature and exist only when\n * it is enabled server-side; against an install without it they 404\n * (→ `NotFoundError`). The active workspace travels on the request like every\n * other call, so a workspace admin's grants apply automatically.\n */\nexport class WorkflowCollaboratorsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List a workflow's collaborators (id, name, avatar, role — never email). */\n  list(workflowId: string): Promise<{ data: Collaborator[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n    )\n  }\n\n  /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */\n  add(\n    workflowId: string,\n    input: AddCollaboratorInput,\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n      { body: input },\n    )\n  }\n\n  /** Change a collaborator's role. */\n  update(\n    workflowId: string,\n    userId: string,\n    input: { role: CollaboratorRole },\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n      { body: input },\n    )\n  }\n\n  /** Remove a collaborator — or yourself. Returns `{ success: true }`. */\n  remove(workflowId: string, userId: string): Promise<{ success: true }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n    )\n  }\n}\n\n/** One MCP conversation: a flow its assistant built step by step (`GET /v1/mcp-conversations`). */\nexport interface McpConversation {\n  /** The conversation's workflow id — open it with {@link WorkflowsResource.get}. */\n  id: string\n  projectId: string\n  name: string\n  /** The source: \"claude\", \"claude-code\", \"chatgpt\", or another client's name in lower case. */\n  client: string\n  clientLabel: string\n  /** The connection's own name, as the connector was named. */\n  clientName: string\n  startedAt: string\n  lastActivityAt: string\n  /** Still receiving steps: its last step is less than 30 minutes old. */\n  live: boolean\n  /** The user's first request, when the assistant passed it. */\n  firstRequest: string | null\n  nodeCount: number\n  counts: { image: number; video: number; audio: number }\n  /** Credits charged for its jobs; null where credits are not billed. */\n  credits: number | null\n  cover: { url: string; kind: \"image\" | \"video\"; setByUser: boolean } | null\n  updatedAt: string\n}\n\nexport interface ListMcpConversationsParams {\n  /** \"YYYY-MM\". Default: the latest month that has conversations. */\n  month?: string\n  /** Keep only these sources (\"claude\", \"claude-code\", \"chatgpt\", …). */\n  sources?: readonly string[]\n}\n\nexport interface McpConversationList {\n  /** The month listed. */\n  month: string\n  /** Every month that has conversations, newest first, with its count. */\n  months: Array<{ month: string; conversations: number }>\n  /** The month's sources, with the connection names each one folds in. */\n  sources: Array<{ client: string; label: string; conversations: number; connections: Array<{ clientName: string; conversations: number }> }>\n  data: McpConversation[]\n}\n\nexport class WorkflowsResource {\n  /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */\n  readonly collaborators: WorkflowCollaboratorsResource\n\n  constructor(private client: NodaroClientCore) {\n    this.collaborators = new WorkflowCollaboratorsResource(client)\n  }\n\n  /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */\n  list(params: ListWorkflowsParams): Promise<{ data: Workflow[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/projects/${encodeURIComponent(params.projectId)}/workflows`,\n    )\n  }\n\n  /** Get a workflow including its full nodes/edges/settings. */\n  get(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Get a PUBLICLY-SHARED workflow by id (`GET /v1/public/workflows/:id`) — the\n   * unauthenticated share-by-link read. Returns the workflow's nodes/edges/\n   * settings ONLY when it's opted into sharing server-side (`settings.studio.shared\n   * === true`); otherwise the route 404s (→ `NotFoundError`). No auth required —\n   * a share viewer has no session; the SDK omits the bearer when no token exists.\n   */\n  getPublic(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/public/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Create a workflow under a project. Returns the full record.\n   * NOTE: server route is `POST /v1/projects/:projectId/workflows`.\n   */\n  create(input: CreateWorkflowInput): Promise<{ data: Workflow }> {\n    const { projectId, ...body } = input\n    return this.client.request(\n      \"POST\",\n      `/v1/projects/${encodeURIComponent(projectId)}/workflows`,\n      { body },\n    )\n  }\n\n  /** Patch a workflow. Returns the full updated record. */\n  update(id: string, input: UpdateWorkflowInput): Promise<{ data: Workflow }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(id)}`,\n      { body: input },\n    )\n  }\n\n  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`\n   *  when the id doesn't exist or isn't yours (the delete is not silent). */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Run a workflow. Returns the executionId for polling via\n   * `client.executions.get(executionId)`.\n   */\n  run(id: string, params: RunWorkflowParams = {}, options?: RunWorkflowOptions): Promise<RunWorkflowResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(id)}/run`,\n      {\n        body: params,\n        ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n      },\n    )\n  }\n\n  /**\n   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the\n   * render at Final for this run only, and every node after it, continuing the\n   * execution that stopped at its preview. The server derives the nodes and\n   * the override — send nothing else. Quote it first with\n   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,\n   * `render_final_not_a_render`, or a continuation code (see `run`); a run\n   * its payer cannot cover throws `InsufficientCreditsError` (with `required`\n   * and, when it is yours to see, `available`) before any execution exists.\n   */\n  renderFinal(id: string, params: RenderFinalParams): Promise<RunWorkflowResult> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/run`, {\n      body: {\n        renderFinal: { renderNodeId: params.renderNodeId },\n        continueFromExecutionId: params.continueFromExecutionId,\n      },\n    })\n  }\n\n  /**\n   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the\n   * nodes it will run, the override it runs with and its estimated credits.\n   * Nothing is created or charged.\n   */\n  estimateRenderFinal(id: string, params: RenderFinalParams): Promise<{ data: RenderFinalQuote }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {\n      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId },\n    })\n  }\n\n  /**\n   * Export a workflow as a portable JSON bundle.\n   * Pass `opts.assets = true` to include character/object/location entity data.\n   */\n  export(\n    workflowId: string,\n    opts?: { assets?: boolean },\n  ): Promise<{ data: WorkflowExport }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/export`,\n      { query: { assets: opts?.assets ?? false } },\n    )\n  }\n\n  /**\n   * Import a `WorkflowExport` bundle into the specified project.\n   * Re-creates any bundled assets (characters, objects, creatures, locations)\n   * under your account, and re-points BOTH the entity nodes and every `@`-chip\n   * (`ConnectedReference`) bound in the graph at the rows it created.\n   * Media the bundle references on other hosts is copied onto this instance's\n   * storage where reachable; a bundled entity's images are copied whoever\n   * hosts them, because they are the exporter's bytes and their lifecycle is\n   * not yours. `importReport` says what was copied, what could not be reached\n   * and what was skipped (and why); `assetIdMap` maps each bundled entity id\n   * to the row created for it (for chips you hold outside the graph), and\n   * `assetsSkipped` names the entities your storage quota left uncreated —\n   * the workflow itself still lands.\n   */\n  import(input: WorkflowExport & { projectId: string }): Promise<{ data: Workflow; importReport?: WorkflowImportReport }> {\n    const { projectId, ...workflowJson } = input\n    return this.client.request(\"POST\", \"/v1/workflows/import\", {\n      body: { projectId, workflow_json: workflowJson },\n    })\n  }\n\n  /**\n   * Set a workflow's visibility — `\"private\"` (creator + explicit collaborators)\n   * or `\"workspace\"` (everyone in its workspace). Only the creator or a workspace\n   * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:\n   * the visibility lever lives on `PATCH /v1/workflows/:id`.\n   */\n  setVisibility(id: string, visibility: WorkflowVisibility): Promise<{ data: Workflow }> {\n    return this.client.request(\"PATCH\", `/v1/workflows/${encodeURIComponent(id)}`, {\n      body: { visibility },\n    })\n  }\n\n  /**\n   * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder\n   * is cleared. When the move takes the workflow out of a workspace, collaborator\n   * grants that came from that workspace are dropped and returned as\n   * `droppedCollaborators`.\n   */\n  move(\n    id: string,\n    params: { projectId: string },\n  ): Promise<{ data: Workflow; droppedCollaborators: DroppedCollaborator[] }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/move`, {\n      body: params,\n    })\n  }\n\n  /**\n   * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —\n   * grants on work that is NOT in a workspace you belong to (workspace work already\n   * shows in that workspace's own lists). Each carries the `grantedRole` you hold.\n   * Empty when the organizations feature is off server-side.\n   */\n  sharedWithMe(): Promise<{ data: SharedWorkflow[] }> {\n    return this.client.request(\"GET\", \"/v1/workflows/shared-with-me\")\n  }\n\n  /**\n   * Your MCP conversations of one month (`GET /v1/mcp-conversations`): each is a\n   * flow an assistant built from its steps, newest first. A conversation is a\n   * workflow, so open, rename, export or delete it with the other methods here.\n   */\n  listMcpConversations(params: ListMcpConversationsParams = {}): Promise<McpConversationList> {\n    const query: Record<string, string> = {}\n    if (params.month) query.month = params.month\n    if (params.sources?.length) query.sources = params.sources.join(\",\")\n    return this.client.request(\"GET\", \"/v1/mcp-conversations\", { query })\n  }\n}\n"]}

package/dist/entries/cast-swap.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-RQSGS7ZK.cjs');
-var chunkF6GENF6R_cjs = require('../chunk-F6GENF6R.cjs');
+var chunk55ZX6TE3_cjs = require('../chunk-55ZX6TE3.cjs');
 
 
 
 Object.defineProperty(exports, "CastSwapResource", {
   enumerable: true,
-  get: function () { return chunkF6GENF6R_cjs.CastSwapResource; }
+  get: function () { return chunk55ZX6TE3_cjs.CastSwapResource; }
 });
 //# sourceMappingURL=cast-swap.cjs.map
 //# sourceMappingURL=cast-swap.cjs.map

package/dist/entries/cast-swap.d.cts

@@ -14,6 +14,12 @@ import '@nodaro/shared/organizations';
  * photos if it fails, and is turned off with `prepareReferences: false`.
  * Locations are not prepared.
  *
+ * Engines: a run is made on Seedance 2.5 (`engine` left out, or
+ * `"seedance-2-5"`) or Kling 4 (`"kling-4"`). Kling 4 renders 720p (its
+ * default) or 1080p and has no draft; it makes a new take guided by the clip
+ * and pictures, so its Full Quality is a new take at 1080p rather than the
+ * same take re-rendered (`CastSwapFullQualityEstimate.kind`).
+ *
  * Cloud edition only: `/v1/cast-swap` is served by the cloud plugin and 404s
  * on self-hosted installs. `run()` answers 202 with a job id; follow it with
  * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.
@@ -29,18 +35,39 @@ import '@nodaro/shared/organizations';
  * no reference and no `prePrompt` or `postPrompt`, more roles of a kind
  * than allowed, more than 30 images in all, `draft: true` above 480p, a
  * `prePrompt` or `postPrompt` over 4,000 characters, a `faceMasking` setting
- * out of range), `raw_reference_token` (also in a reference's `line`),
+ * out of range); on Kling 4, `draft_unsupported` (`draft: true`),
+ * `resolution_unsupported` (480p), `output_format_unsupported` (a MOV edit
+ * output) and `too_many_images` (more than 10 images in the run, across every
+ * role and fixed reference); `raw_reference_token` (also in a reference's `line`),
  * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),
  * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),
  * `preview_out_of_range`, `no_roles_in_preview` (a preview with every role
  * `inPreview: false`, always refused even with a prompt, or with no role kept
  * in it that has images and no `prePrompt` or `postPrompt`), `prompt_too_long`
  * (the prompt would build too long: a `{role:N}` reads as the role's name when
- * it sends no images); 401; 402 `insufficient_credits` (`run()` only); 404
+ * it sends no images; Kling 4's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404
  * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`
  * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`
  * only).
  */
+/**
+ * The video engine a Cast Swap run is made on. Left out = `"seedance-2-5"`.
+ *
+ * - `"seedance-2-5"`: 480p (the default, a draft unless `draft: false`), 720p
+ *   or 1080p; Full Quality re-renders a draft's own take at 1080p.
+ * - `"kling-4"`: 720p (the default) or 1080p, never a draft (`draft: true`
+ *   answers 400 `draft_unsupported`); Full Quality makes a new take at 1080p
+ *   from a completed 720p run's inputs. A preview is still 4 s from
+ *   `previewStart`.
+ */
+type CastSwapEngine = "seedance-2-5" | "kling-4";
+/**
+ * Where a Kling 4 run cuts the clip to whole seconds (Kling renders whole
+ * seconds; asked for more than the clip, it would stretch the motion):
+ * - `"cut-end"` (the default): drop the fraction of a second at its end;
+ * - `"cut-start"`: drop it at its start.
+ */
+type CastSwapKlingLength = "cut-end" | "cut-start";
 /** Whether a swapped subject takes this trait from the references (`"new"`) or keeps the video's (`"original"`). */
 type CastSwapTraitSource = "new" | "original";
 /**
@@ -220,11 +247,28 @@ interface CastSwapParams {
     preview?: boolean;
     /** Where the preview starts, in seconds. Default 0. */
     previewStart?: number;
-    /** The output resolution. Default `"480p"`. */
+    /**
+     * The video engine (see {@link CastSwapEngine}). Default `"seedance-2-5"`.
+     * The job records it in `input_data.engine`, and a completed job's output
+     * in its `engine`. A Cast Swap engine older than Kling 4 support ignores
+     * the field and runs Seedance 2.5: a Kling 4 quote names `engine:
+     * "kling-4"`, so check the estimate's `engine` before running.
+     */
+    engine?: CastSwapEngine;
+    /**
+     * Kling 4 only (Seedance 2.5 ignores it): which end of the clip is cut to
+     * whole seconds (see {@link CastSwapKlingLength}). Default `"cut-end"`.
+     */
+    klingLength?: CastSwapKlingLength;
+    /**
+     * The output resolution. Seedance 2.5: `"480p"` (default), `"720p"` or
+     * `"1080p"`. Kling 4: `"720p"` (default) or `"1080p"`; `"480p"` answers 400.
+     */
     resolution?: "480p" | "720p" | "1080p";
     /**
-     * Render as a draft. Defaults to `true` at 480p and `false` above it; `true`
-     * with `"720p"` or `"1080p"` answers 400 (draft is 480p only).
+     * Render as a draft (Seedance 2.5 only). Defaults to `true` at 480p and
+     * `false` above it; `true` with `"720p"` or `"1080p"` answers 400 (draft is
+     * 480p only). Kling 4 has no draft: `true` answers 400 `draft_unsupported`.
      */
     draft?: boolean;
     /**
@@ -248,10 +292,16 @@ interface CastSwapParams {
 }
 /** What a run would cost, in credits. */
 interface CastSwapEstimate {
+    /**
+     * The engine the run would use. Sent by an engine that knows Kling 4 on a
+     * Kling 4 quote (`"kling-4"`); absent = Seedance 2.5.
+     */
+    engine?: CastSwapEngine;
     /**
      * What is held when the run starts: `breakdown.castSwap +
-     * breakdown.seedance + breakdown.references`, plus `breakdown.masking` with
-     * face masking `"always"`. The run is charged what it actually costs, which
+     * breakdown.seedance + breakdown.references` (on Kling 4,
+     * `breakdown.kling` in place of `breakdown.seedance`), plus
+     * `breakdown.masking` with face masking `"always"`. The run is charged what it actually costs, which
      * is expected to be `expectedCredits`.
      */
     totalCredits: number;
@@ -264,7 +314,9 @@ interface CastSwapEstimate {
      * `totalCredits` is what is held when the run starts; the run is charged
      * what it actually costs.
      *
-     * Absent from an older Cast Swap engine: read `totalCredits` then.
+     * Absent from an older Cast Swap engine: read `totalCredits` then. On
+     * Kling 4 it equals `totalCredits` (Kling renders exactly the length asked
+     * for, so the hold is what it settles at).
      */
     expectedCredits?: number;
     /**
@@ -276,6 +328,8 @@ interface CastSwapEstimate {
      *   clip in and about as much out), never above `seedance`. It takes
      *   `seedance`'s place in `expectedCredits`; it is not added to it. Absent
      *   from an older Cast Swap engine, like `expectedCredits`;
+     * - `kling`: Kling 4 only, in place of `seedance` and `seedanceExpected`:
+     *   what the Kling take costs (held and charged alike);
      * - `references`: preparing the reference pictures (0 when
      *   `prepareReferences` is off or there is nothing to prepare);
      * - `masking`: masking the faces, present only when `faceMasking` is on.
@@ -287,9 +341,10 @@ interface CastSwapEstimate {
      */
     breakdown: {
         castSwap: number;
-        seedance: number;
+        seedance?: number;
         references: number;
         seedanceExpected?: number;
+        kling?: number;
         masking?: number;
     };
     /**
@@ -300,9 +355,9 @@ interface CastSwapEstimate {
      */
     maskingCredits?: number;
     /**
-     * `true` when the video is made at Auto length (every run today): the final
-     * charge is expected to come out lower than `totalCredits`, at about
-     * `expectedCredits`.
+     * `true` when the video is made at Auto length (every Seedance 2.5 run): the
+     * final charge is expected to come out lower than `totalCredits`, at about
+     * `expectedCredits`. `false` on Kling 4.
      */
     settlesLower: boolean;
 }
@@ -319,22 +374,37 @@ interface CastSwapRunOptions {
     idempotencyKey?: string;
 }
 /**
- * What finishing a draft at Full Quality would cost
- * (`POST /v1/cast-swap/:jobId/full-quality/estimate`).
+ * What a Full Quality version would be: `"same-take"` re-renders a Seedance
+ * 2.5 draft's own take at 1080p; `"new-take"` makes a new Kling 4 take at
+ * 1080p from a 720p run's inputs (it will not match the 720p run frame for
+ * frame). The 720p run or draft stays either way.
+ */
+type CastSwapFullQualityKind = "same-take" | "new-take";
+/**
+ * What a Full Quality version of a run would cost
+ * (`POST /v1/cast-swap/:jobId/full-quality/estimate`): a Seedance 2.5 draft,
+ * or a completed Kling 4 run at 720p.
  */
 interface CastSwapFullQualityEstimate {
-    /** The quote in credits: `breakdown.castSwap + breakdown.seedanceHd`. */
+    /**
+     * Which Full Quality this is ({@link CastSwapFullQualityKind}), so it can
+     * be worded right. Absent from an older Cast Swap engine: `"same-take"`.
+     */
+    kind?: CastSwapFullQualityKind;
+    /** The quote in credits: `breakdown.castSwap` + `breakdown.seedanceHd` (same take) or `breakdown.kling` (new take). */
     totalCredits: number;
     /**
-     * `castSwap`: the Full Quality job's own steps; `seedanceHd`: the 1080p
-     * render of the draft's take (0 when an earlier try of this draft already
-     * finished that render, which is then reused).
+     * `castSwap`: the Full Quality job's own steps; `seedanceHd` (a same take):
+     * the 1080p render of the draft's take (0 when an earlier try of this draft
+     * already finished that render, which is then reused); `kling` (a new take,
+     * in place of `seedanceHd`): the new Kling 4 take at 1080p.
      */
     breakdown: {
         castSwap: number;
-        seedanceHd: number;
+        seedanceHd?: number;
+        kling?: number;
     };
-    /** ISO time until which the draft can be finished at Full Quality (7 days after it completed). */
+    /** ISO time until which the run can be finished at Full Quality (7 days after it completed). */
     availableUntil: string;
 }
 /** Options for {@link CastSwapResource.fullQuality}. */
@@ -345,7 +415,7 @@ interface CastSwapFullQualityParams {
 /** The Full Quality job (`POST /v1/cast-swap/:jobId/full-quality`). */
 interface CastSwapFullQualityResult {
     jobId: string;
-    /** `true` when this draft's Full Quality was already running or done: that job is answered, nothing new is started or charged. */
+    /** `true` when this run's Full Quality was already running or done: that job is answered, nothing new is started or charged. */
     existing?: boolean;
 }
 /**
@@ -355,7 +425,8 @@ interface CastSwapFullQualityResult {
  * - `not_found` (404): not your job, or not a Cast Swap run; also a
  *   `sessionId` you may not use;
  * - `not_completed` (409): the run has not finished;
- * - `not_a_draft` (409): the run was not made as a draft;
+ * - `not_a_draft` (409): the run is neither a Seedance 2.5 draft nor a
+ *   Kling 4 run at 720p (a Kling 4 run at 1080p is already Full Quality);
  * - `draft_expired` (410): more than 7 days after the draft completed, or
  *   the draft can no longer be finished at Full Quality;
  * - `full_quality_pending` (409, `details.retryable: true`): not final — an
@@ -392,21 +463,24 @@ declare class CastSwapResource {
     /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */
     estimate(params: CastSwapParams): Promise<CastSwapEstimate>;
     /**
-     * Quote finishing a draft at Full Quality (`POST
+     * Quote finishing a run at Full Quality (`POST
      * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a
-     * finished DRAFT run (a Cast Swap or trend run made as a draft). The quote
+     * finished Seedance 2.5 DRAFT run, or a finished Kling 4 run at 720p (a Cast
+     * Swap or trend run); the quote's `kind` says whether it is the same take
+     * re-rendered or a new take. The quote
      * does not look for a Full Quality already running: when one is,
      * {@link fullQuality} answers it (`existing: true`) and charges nothing.
      * Refusals: {@link CastSwapFullQualityRefusalCode}.
      */
     fullQualityEstimate(jobId: string): Promise<CastSwapFullQualityEstimate>;
     /**
-     * Finish a draft at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
-     * the same take re-rendered at 1080p, with the clip's audio, as a new job
-     * linked to the draft. SPENDS CREDITS: quote it first with
+     * Finish a run at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
+     * at 1080p, with the clip's audio, as a new job linked to the run — a
+     * Seedance 2.5 draft's own take re-rendered, or a new Kling 4 take from a
+     * 720p run's inputs (the quote's `kind`). SPENDS CREDITS: quote it first with
      * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200
-     * `{ jobId, existing: true }` when this draft's Full Quality is already
-     * running or done (one per draft; a failed one may be asked again). Follow
+     * `{ jobId, existing: true }` when this run's Full Quality is already
+     * running or done (one per run; a failed one may be asked again). Follow
      * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the
      * server keys the job by the draft. The new job keeps the draft's origin.
      * Refusals: {@link CastSwapFullQualityRefusalCode}.
@@ -414,4 +488,4 @@ declare class CastSwapResource {
     fullQuality(jobId: string, params?: CastSwapFullQualityParams): Promise<CastSwapFullQualityResult>;
 }
 
-export { type CastSwapEstimate, type CastSwapFaceMasking, type CastSwapFaceMaskingZone, type CastSwapFullQualityEstimate, type CastSwapFullQualityParams, type CastSwapFullQualityRefusalCode, type CastSwapFullQualityResult, type CastSwapLocationRole, type CastSwapParams, type CastSwapPersonRole, type CastSwapPetRole, type CastSwapProductRole, type CastSwapReference, CastSwapResource, type CastSwapRole, type CastSwapRolePreviewSettings, type CastSwapRunOptions, type CastSwapTraitSource };
+export { type CastSwapEngine, type CastSwapEstimate, type CastSwapFaceMasking, type CastSwapFaceMaskingZone, type CastSwapFullQualityEstimate, type CastSwapFullQualityKind, type CastSwapFullQualityParams, type CastSwapFullQualityRefusalCode, type CastSwapFullQualityResult, type CastSwapKlingLength, type CastSwapLocationRole, type CastSwapParams, type CastSwapPersonRole, type CastSwapPetRole, type CastSwapProductRole, type CastSwapReference, CastSwapResource, type CastSwapRole, type CastSwapRolePreviewSettings, type CastSwapRunOptions, type CastSwapTraitSource };

package/dist/entries/cast-swap.d.ts

@@ -14,6 +14,12 @@ import '@nodaro/shared/organizations';
  * photos if it fails, and is turned off with `prepareReferences: false`.
  * Locations are not prepared.
  *
+ * Engines: a run is made on Seedance 2.5 (`engine` left out, or
+ * `"seedance-2-5"`) or Kling 4 (`"kling-4"`). Kling 4 renders 720p (its
+ * default) or 1080p and has no draft; it makes a new take guided by the clip
+ * and pictures, so its Full Quality is a new take at 1080p rather than the
+ * same take re-rendered (`CastSwapFullQualityEstimate.kind`).
+ *
  * Cloud edition only: `/v1/cast-swap` is served by the cloud plugin and 404s
  * on self-hosted installs. `run()` answers 202 with a job id; follow it with
  * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.
@@ -29,18 +35,39 @@ import '@nodaro/shared/organizations';
  * no reference and no `prePrompt` or `postPrompt`, more roles of a kind
  * than allowed, more than 30 images in all, `draft: true` above 480p, a
  * `prePrompt` or `postPrompt` over 4,000 characters, a `faceMasking` setting
- * out of range), `raw_reference_token` (also in a reference's `line`),
+ * out of range); on Kling 4, `draft_unsupported` (`draft: true`),
+ * `resolution_unsupported` (480p), `output_format_unsupported` (a MOV edit
+ * output) and `too_many_images` (more than 10 images in the run, across every
+ * role and fixed reference); `raw_reference_token` (also in a reference's `line`),
  * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),
  * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),
  * `preview_out_of_range`, `no_roles_in_preview` (a preview with every role
  * `inPreview: false`, always refused even with a prompt, or with no role kept
  * in it that has images and no `prePrompt` or `postPrompt`), `prompt_too_long`
  * (the prompt would build too long: a `{role:N}` reads as the role's name when
- * it sends no images); 401; 402 `insufficient_credits` (`run()` only); 404
+ * it sends no images; Kling 4's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404
  * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`
  * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`
  * only).
  */
+/**
+ * The video engine a Cast Swap run is made on. Left out = `"seedance-2-5"`.
+ *
+ * - `"seedance-2-5"`: 480p (the default, a draft unless `draft: false`), 720p
+ *   or 1080p; Full Quality re-renders a draft's own take at 1080p.
+ * - `"kling-4"`: 720p (the default) or 1080p, never a draft (`draft: true`
+ *   answers 400 `draft_unsupported`); Full Quality makes a new take at 1080p
+ *   from a completed 720p run's inputs. A preview is still 4 s from
+ *   `previewStart`.
+ */
+type CastSwapEngine = "seedance-2-5" | "kling-4";
+/**
+ * Where a Kling 4 run cuts the clip to whole seconds (Kling renders whole
+ * seconds; asked for more than the clip, it would stretch the motion):
+ * - `"cut-end"` (the default): drop the fraction of a second at its end;
+ * - `"cut-start"`: drop it at its start.
+ */
+type CastSwapKlingLength = "cut-end" | "cut-start";
 /** Whether a swapped subject takes this trait from the references (`"new"`) or keeps the video's (`"original"`). */
 type CastSwapTraitSource = "new" | "original";
 /**
@@ -220,11 +247,28 @@ interface CastSwapParams {
     preview?: boolean;
     /** Where the preview starts, in seconds. Default 0. */
     previewStart?: number;
-    /** The output resolution. Default `"480p"`. */
+    /**
+     * The video engine (see {@link CastSwapEngine}). Default `"seedance-2-5"`.
+     * The job records it in `input_data.engine`, and a completed job's output
+     * in its `engine`. A Cast Swap engine older than Kling 4 support ignores
+     * the field and runs Seedance 2.5: a Kling 4 quote names `engine:
+     * "kling-4"`, so check the estimate's `engine` before running.
+     */
+    engine?: CastSwapEngine;
+    /**
+     * Kling 4 only (Seedance 2.5 ignores it): which end of the clip is cut to
+     * whole seconds (see {@link CastSwapKlingLength}). Default `"cut-end"`.
+     */
+    klingLength?: CastSwapKlingLength;
+    /**
+     * The output resolution. Seedance 2.5: `"480p"` (default), `"720p"` or
+     * `"1080p"`. Kling 4: `"720p"` (default) or `"1080p"`; `"480p"` answers 400.
+     */
     resolution?: "480p" | "720p" | "1080p";
     /**
-     * Render as a draft. Defaults to `true` at 480p and `false` above it; `true`
-     * with `"720p"` or `"1080p"` answers 400 (draft is 480p only).
+     * Render as a draft (Seedance 2.5 only). Defaults to `true` at 480p and
+     * `false` above it; `true` with `"720p"` or `"1080p"` answers 400 (draft is
+     * 480p only). Kling 4 has no draft: `true` answers 400 `draft_unsupported`.
      */
     draft?: boolean;
     /**
@@ -248,10 +292,16 @@ interface CastSwapParams {
 }
 /** What a run would cost, in credits. */
 interface CastSwapEstimate {
+    /**
+     * The engine the run would use. Sent by an engine that knows Kling 4 on a
+     * Kling 4 quote (`"kling-4"`); absent = Seedance 2.5.
+     */
+    engine?: CastSwapEngine;
     /**
      * What is held when the run starts: `breakdown.castSwap +
-     * breakdown.seedance + breakdown.references`, plus `breakdown.masking` with
-     * face masking `"always"`. The run is charged what it actually costs, which
+     * breakdown.seedance + breakdown.references` (on Kling 4,
+     * `breakdown.kling` in place of `breakdown.seedance`), plus
+     * `breakdown.masking` with face masking `"always"`. The run is charged what it actually costs, which
      * is expected to be `expectedCredits`.
      */
     totalCredits: number;
@@ -264,7 +314,9 @@ interface CastSwapEstimate {
      * `totalCredits` is what is held when the run starts; the run is charged
      * what it actually costs.
      *
-     * Absent from an older Cast Swap engine: read `totalCredits` then.
+     * Absent from an older Cast Swap engine: read `totalCredits` then. On
+     * Kling 4 it equals `totalCredits` (Kling renders exactly the length asked
+     * for, so the hold is what it settles at).
      */
     expectedCredits?: number;
     /**
@@ -276,6 +328,8 @@ interface CastSwapEstimate {
      *   clip in and about as much out), never above `seedance`. It takes
      *   `seedance`'s place in `expectedCredits`; it is not added to it. Absent
      *   from an older Cast Swap engine, like `expectedCredits`;
+     * - `kling`: Kling 4 only, in place of `seedance` and `seedanceExpected`:
+     *   what the Kling take costs (held and charged alike);
      * - `references`: preparing the reference pictures (0 when
      *   `prepareReferences` is off or there is nothing to prepare);
      * - `masking`: masking the faces, present only when `faceMasking` is on.
@@ -287,9 +341,10 @@ interface CastSwapEstimate {
      */
     breakdown: {
         castSwap: number;
-        seedance: number;
+        seedance?: number;
         references: number;
         seedanceExpected?: number;
+        kling?: number;
         masking?: number;
     };
     /**
@@ -300,9 +355,9 @@ interface CastSwapEstimate {
      */
     maskingCredits?: number;
     /**
-     * `true` when the video is made at Auto length (every run today): the final
-     * charge is expected to come out lower than `totalCredits`, at about
-     * `expectedCredits`.
+     * `true` when the video is made at Auto length (every Seedance 2.5 run): the
+     * final charge is expected to come out lower than `totalCredits`, at about
+     * `expectedCredits`. `false` on Kling 4.
      */
     settlesLower: boolean;
 }
@@ -319,22 +374,37 @@ interface CastSwapRunOptions {
     idempotencyKey?: string;
 }
 /**
- * What finishing a draft at Full Quality would cost
- * (`POST /v1/cast-swap/:jobId/full-quality/estimate`).
+ * What a Full Quality version would be: `"same-take"` re-renders a Seedance
+ * 2.5 draft's own take at 1080p; `"new-take"` makes a new Kling 4 take at
+ * 1080p from a 720p run's inputs (it will not match the 720p run frame for
+ * frame). The 720p run or draft stays either way.
+ */
+type CastSwapFullQualityKind = "same-take" | "new-take";
+/**
+ * What a Full Quality version of a run would cost
+ * (`POST /v1/cast-swap/:jobId/full-quality/estimate`): a Seedance 2.5 draft,
+ * or a completed Kling 4 run at 720p.
  */
 interface CastSwapFullQualityEstimate {
-    /** The quote in credits: `breakdown.castSwap + breakdown.seedanceHd`. */
+    /**
+     * Which Full Quality this is ({@link CastSwapFullQualityKind}), so it can
+     * be worded right. Absent from an older Cast Swap engine: `"same-take"`.
+     */
+    kind?: CastSwapFullQualityKind;
+    /** The quote in credits: `breakdown.castSwap` + `breakdown.seedanceHd` (same take) or `breakdown.kling` (new take). */
     totalCredits: number;
     /**
-     * `castSwap`: the Full Quality job's own steps; `seedanceHd`: the 1080p
-     * render of the draft's take (0 when an earlier try of this draft already
-     * finished that render, which is then reused).
+     * `castSwap`: the Full Quality job's own steps; `seedanceHd` (a same take):
+     * the 1080p render of the draft's take (0 when an earlier try of this draft
+     * already finished that render, which is then reused); `kling` (a new take,
+     * in place of `seedanceHd`): the new Kling 4 take at 1080p.
      */
     breakdown: {
         castSwap: number;
-        seedanceHd: number;
+        seedanceHd?: number;
+        kling?: number;
     };
-    /** ISO time until which the draft can be finished at Full Quality (7 days after it completed). */
+    /** ISO time until which the run can be finished at Full Quality (7 days after it completed). */
     availableUntil: string;
 }
 /** Options for {@link CastSwapResource.fullQuality}. */
@@ -345,7 +415,7 @@ interface CastSwapFullQualityParams {
 /** The Full Quality job (`POST /v1/cast-swap/:jobId/full-quality`). */
 interface CastSwapFullQualityResult {
     jobId: string;
-    /** `true` when this draft's Full Quality was already running or done: that job is answered, nothing new is started or charged. */
+    /** `true` when this run's Full Quality was already running or done: that job is answered, nothing new is started or charged. */
     existing?: boolean;
 }
 /**
@@ -355,7 +425,8 @@ interface CastSwapFullQualityResult {
  * - `not_found` (404): not your job, or not a Cast Swap run; also a
  *   `sessionId` you may not use;
  * - `not_completed` (409): the run has not finished;
- * - `not_a_draft` (409): the run was not made as a draft;
+ * - `not_a_draft` (409): the run is neither a Seedance 2.5 draft nor a
+ *   Kling 4 run at 720p (a Kling 4 run at 1080p is already Full Quality);
  * - `draft_expired` (410): more than 7 days after the draft completed, or
  *   the draft can no longer be finished at Full Quality;
  * - `full_quality_pending` (409, `details.retryable: true`): not final — an
@@ -392,21 +463,24 @@ declare class CastSwapResource {
     /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */
     estimate(params: CastSwapParams): Promise<CastSwapEstimate>;
     /**
-     * Quote finishing a draft at Full Quality (`POST
+     * Quote finishing a run at Full Quality (`POST
      * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a
-     * finished DRAFT run (a Cast Swap or trend run made as a draft). The quote
+     * finished Seedance 2.5 DRAFT run, or a finished Kling 4 run at 720p (a Cast
+     * Swap or trend run); the quote's `kind` says whether it is the same take
+     * re-rendered or a new take. The quote
      * does not look for a Full Quality already running: when one is,
      * {@link fullQuality} answers it (`existing: true`) and charges nothing.
      * Refusals: {@link CastSwapFullQualityRefusalCode}.
      */
     fullQualityEstimate(jobId: string): Promise<CastSwapFullQualityEstimate>;
     /**
-     * Finish a draft at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
-     * the same take re-rendered at 1080p, with the clip's audio, as a new job
-     * linked to the draft. SPENDS CREDITS: quote it first with
+     * Finish a run at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
+     * at 1080p, with the clip's audio, as a new job linked to the run — a
+     * Seedance 2.5 draft's own take re-rendered, or a new Kling 4 take from a
+     * 720p run's inputs (the quote's `kind`). SPENDS CREDITS: quote it first with
      * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200
-     * `{ jobId, existing: true }` when this draft's Full Quality is already
-     * running or done (one per draft; a failed one may be asked again). Follow
+     * `{ jobId, existing: true }` when this run's Full Quality is already
+     * running or done (one per run; a failed one may be asked again). Follow
      * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the
      * server keys the job by the draft. The new job keeps the draft's origin.
      * Refusals: {@link CastSwapFullQualityRefusalCode}.
@@ -414,4 +488,4 @@ declare class CastSwapResource {
     fullQuality(jobId: string, params?: CastSwapFullQualityParams): Promise<CastSwapFullQualityResult>;
 }
 
-export { type CastSwapEstimate, type CastSwapFaceMasking, type CastSwapFaceMaskingZone, type CastSwapFullQualityEstimate, type CastSwapFullQualityParams, type CastSwapFullQualityRefusalCode, type CastSwapFullQualityResult, type CastSwapLocationRole, type CastSwapParams, type CastSwapPersonRole, type CastSwapPetRole, type CastSwapProductRole, type CastSwapReference, CastSwapResource, type CastSwapRole, type CastSwapRolePreviewSettings, type CastSwapRunOptions, type CastSwapTraitSource };
+export { type CastSwapEngine, type CastSwapEstimate, type CastSwapFaceMasking, type CastSwapFaceMaskingZone, type CastSwapFullQualityEstimate, type CastSwapFullQualityKind, type CastSwapFullQualityParams, type CastSwapFullQualityRefusalCode, type CastSwapFullQualityResult, type CastSwapKlingLength, type CastSwapLocationRole, type CastSwapParams, type CastSwapPersonRole, type CastSwapPetRole, type CastSwapProductRole, type CastSwapReference, CastSwapResource, type CastSwapRole, type CastSwapRolePreviewSettings, type CastSwapRunOptions, type CastSwapTraitSource };

package/dist/entries/cast-swap.js

@@ -1,4 +1,4 @@
 import '../chunk-KARJ7P7Y.js';
-export { CastSwapResource } from '../chunk-RQH6IKDC.js';
+export { CastSwapResource } from '../chunk-HKDIIFG2.js';
 //# sourceMappingURL=cast-swap.js.map
 //# sourceMappingURL=cast-swap.js.map