videodraft 0.13.2 → 0.14.0

package/README.md

@@ -91,9 +91,19 @@ videodraft create "<idea>" --ar 9:16            # idea → script → visual ass
 videodraft shots <project> --grid --estimate    # preview the cost…
 videodraft shots <project> --grid               # …then batch-generate every shot image
 videodraft produce <project>                    # voiceovers + captions + production timeline
+videodraft produce <project> --mode full_video --allow-real-people
 videodraft export <project> --download final.mp4
 ```
 
+Seedance 2.x uses Byteplus only at the default lower price. If supplied visual
+input media, including a start/end frame or image/video reference, visibly
+contains a real identifiable person, pass
+`--allow-real-people` on the first request. It keeps Byteplus first, permits a
+submit-time Fal fallback, and uses Fal's higher tier-specific rate. If an
+unflagged request returns `SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED`, estimate the
+higher rate and retry once with the flag. Do not loop if it was already set;
+late Byteplus output refusals are refunded but cannot be rerouted.
+
 ## Commands
 
 | Group           | Commands                                                                                                                                                                             |

package/dist/client.d.ts

@@ -277,7 +277,9 @@ declare class CliError extends Error {
     exitCode: number;
     /** One-line remediation shown under the error (human mode only). */
     hint?: string;
-    constructor(message: string, exitCode?: number, hint?: string);
+    /** Optional machine-readable server recovery contract. */
+    data?: unknown;
+    constructor(message: string, exitCode?: number, hint?: string, data?: unknown);
 }
 declare class AuthError extends CliError {
     constructor(message?: string);
@@ -291,7 +293,7 @@ declare class RpcError extends CliError {
 /** A tools/call result that came back isError:true. */
 declare class ToolError extends CliError {
     toolName: string;
-    constructor(toolName: string, message: string);
+    constructor(toolName: string, message: string, data?: unknown);
 }
 declare class TimeoutError extends CliError {
     constructor(message: string);

package/dist/client.js

@@ -10,11 +10,14 @@ var CliError = class extends Error {
   exitCode;
   /** One-line remediation shown under the error (human mode only). */
   hint;
-  constructor(message, exitCode = EXIT.ERROR, hint) {
+  /** Optional machine-readable server recovery contract. */
+  data;
+  constructor(message, exitCode = EXIT.ERROR, hint, data) {
     super(message);
     this.name = "CliError";
     this.exitCode = exitCode;
     this.hint = hint;
+    this.data = data;
   }
 };
 var AuthError = class extends CliError {
@@ -40,17 +43,26 @@ var RpcError = class extends CliError {
 var CREDIT_ERROR_RE = /insufficient credits|not enough credits|credit balance/i;
 var ToolError = class extends CliError {
   toolName;
-  constructor(toolName, message) {
+  constructor(toolName, message, data) {
     const isCredits = CREDIT_ERROR_RE.test(message);
+    const realPersonHint = seedanceRealPersonRetryHint(data);
     super(
       message,
       isCredits ? EXIT.CREDITS : EXIT.ERROR,
-      isCredits ? "Check your balance with `videodraft credits` or top up at https://app.videodraft.ai/pricing" : void 0
+      isCredits ? "Check your balance with `videodraft credits` or top up at https://app.videodraft.ai/pricing" : realPersonHint,
+      data
     );
     this.name = "ToolError";
     this.toolName = toolName;
   }
 };
+function seedanceRealPersonRetryHint(value) {
+  const payload = value;
+  if (payload?.code !== "SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED" && payload?.retry_with?.allow_real_people !== true) {
+    return void 0;
+  }
+  return "Retry this Seedance request once with --allow-real-people. This uses higher Fal-tier pricing.";
+}
 var TimeoutError = class extends CliError {
   constructor(message) {
     super(message, EXIT.ERROR);
@@ -383,7 +395,11 @@ var VideoDraftClient = class {
     );
     const text = result?.content?.[0]?.text ?? "";
     if (result?.isError) {
-      throw new ToolError(name, text.replace(/^Error:\s*/, "") || `Tool ${name} failed`);
+      throw new ToolError(
+        name,
+        text.replace(/^Error:\s*/, "") || `Tool ${name} failed`,
+        result.structuredContent
+      );
     }
     try {
       return JSON.parse(text);