@mrgoonie/multix 0.0.5 → 0.0.6

package/dist/cli.js

@@ -67,8 +67,8 @@ __export(http_client_exports, {
   fetchBytes: () => fetchBytes,
   httpJson: () => httpJson
 });
-import fs2 from "fs";
-import path2 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import { pipeline } from "stream/promises";
 async function httpJson(opts) {
   const { url, method = "GET", headers = {}, body, timeoutMs = DEFAULT_TIMEOUT_MS } = opts;
@@ -103,7 +103,7 @@ async function httpJson(opts) {
   return response.json();
 }
 async function downloadFile(url, dest, timeoutMs = DEFAULT_TIMEOUT_MS) {
-  fs2.mkdirSync(path2.dirname(dest), { recursive: true });
+  fs4.mkdirSync(path4.dirname(dest), { recursive: true });
   let response;
   try {
     response = await globalThis.fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
@@ -117,7 +117,7 @@ async function downloadFile(url, dest, timeoutMs = DEFAULT_TIMEOUT_MS) {
   if (!response.body) {
     throw new HttpError(0, "Response body is null", url);
   }
-  const fileStream = fs2.createWriteStream(dest);
+  const fileStream = fs4.createWriteStream(dest);
   await pipeline(response.body, fileStream);
 }
 async function fetchBytes(urlOrDataUri) {
@@ -155,6 +155,90 @@ var init_http_client = __esm({
 import { createRequire } from "module";
 import { Command } from "commander";
 
+// src/providers/byteplus/commands/generate-3d.ts
+import path5 from "path";
+
+// src/core/image-input.ts
+import fs from "fs/promises";
+import path from "path";
+var IMAGE_MIME_BY_EXT = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".gif": "image/gif"
+};
+var VIDEO_MIME_BY_EXT = {
+  ".mp4": "video/mp4",
+  ".webm": "video/webm",
+  ".mov": "video/quicktime",
+  ".m4v": "video/x-m4v"
+};
+var AUDIO_MIME_BY_EXT = {
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".m4a": "audio/mp4",
+  ".flac": "audio/flac",
+  ".ogg": "audio/ogg"
+};
+var DEFAULT_SOFT_LIMIT_BYTES = 10 * 1024 * 1024;
+var DEFAULT_HARD_LIMIT_BYTES = 25 * 1024 * 1024;
+function isHttpUrl(input) {
+  return /^https?:\/\//i.test(input);
+}
+async function readAsDataUrl(filePath, mimeTable, kindLabel, opts = {}) {
+  const ext = path.extname(filePath).toLowerCase();
+  const mime = mimeTable[ext];
+  if (!mime) {
+    throw new Error(
+      `Unsupported ${kindLabel} extension '${ext}'. Allowed: ${Object.keys(mimeTable).join(", ")}`
+    );
+  }
+  const hard = opts.hardLimitBytes ?? DEFAULT_HARD_LIMIT_BYTES;
+  const soft = opts.softLimitBytes ?? DEFAULT_SOFT_LIMIT_BYTES;
+  const buf = await fs.readFile(filePath);
+  if (buf.byteLength > hard) {
+    throw new Error(
+      `${kindLabel} file ${filePath} is ${(buf.byteLength / 1024 / 1024).toFixed(1)}MB \u2014 exceeds ${(hard / 1024 / 1024).toFixed(0)}MB limit. Upload to a URL instead.`
+    );
+  }
+  if (buf.byteLength > soft) {
+    opts.logger?.warn(
+      `${kindLabel} payload ${(buf.byteLength / 1024 / 1024).toFixed(1)}MB is large; consider URL input.`
+    );
+  }
+  const dataUrl = `data:${mime};base64,${buf.toString("base64")}`;
+  return { dataUrl, mime, bytes: buf.byteLength };
+}
+async function resolveImageInput(input, opts = {}) {
+  const o = normalizeOpts(opts);
+  if (isHttpUrl(input)) return { kind: "url", url: input };
+  const { dataUrl, mime, bytes } = await readAsDataUrl(input, IMAGE_MIME_BY_EXT, "image", o);
+  return { kind: "data", dataUrl, mime, bytes };
+}
+async function resolveVideoInput(input, opts = {}) {
+  const o = normalizeOpts(opts);
+  if (isHttpUrl(input)) return { kind: "url", url: input };
+  const { dataUrl, mime, bytes } = await readAsDataUrl(input, VIDEO_MIME_BY_EXT, "video", o);
+  return { kind: "data", dataUrl, mime, bytes };
+}
+async function resolveAudioInput(input, opts = {}) {
+  const o = normalizeOpts(opts);
+  if (isHttpUrl(input)) return { kind: "url", url: input };
+  const { dataUrl, mime, bytes } = await readAsDataUrl(input, AUDIO_MIME_BY_EXT, "audio", o);
+  return { kind: "data", dataUrl, mime, bytes };
+}
+function refUrl(r) {
+  return r.kind === "url" ? r.url : r.dataUrl;
+}
+function normalizeOpts(opts) {
+  if (!opts) return {};
+  if (typeof opts.info === "function" && typeof opts.warn === "function") {
+    return { logger: opts };
+  }
+  return opts;
+}
+
 // src/core/logger.ts
 var ANSI = {
   reset: "\x1B[0m",
@@ -200,22 +284,69 @@ ${line}
 }
 var defaultLogger = createLogger({ verbose: false });
 
+// src/core/output-dir.ts
+import fs2 from "fs";
+import path2 from "path";
+var cachedOutputDir;
+function getOutputDir() {
+  if (cachedOutputDir) return cachedOutputDir;
+  const dir = process.env.MULTIX_OUTPUT_DIR ? path2.resolve(process.env.MULTIX_OUTPUT_DIR) : path2.resolve(process.cwd(), "multix-output");
+  fs2.mkdirSync(dir, { recursive: true });
+  cachedOutputDir = dir;
+  return dir;
+}
+
+// src/providers/leonardo/poll.ts
+var PollTimeoutError = class extends Error {
+  constructor() {
+    super("Polling timed out before the operation completed.");
+    this.name = "PollTimeoutError";
+  }
+};
+var PollFailedError = class extends Error {
+  constructor(value) {
+    super("Operation failed.");
+    this.value = value;
+    this.name = "PollFailedError";
+  }
+  value;
+};
+async function poll(opts) {
+  const interval = opts.intervalMs ?? 4e3;
+  const max = opts.maxAttempts ?? 120;
+  for (let attempt = 1; attempt <= max; attempt++) {
+    if (opts.signal?.aborted) throw new Error("Aborted");
+    const value = await opts.fetch();
+    opts.onTick?.(attempt, value);
+    if (opts.failed?.(value)) throw new PollFailedError(value);
+    if (opts.done(value)) return value;
+    await new Promise((resolve, reject) => {
+      const t = setTimeout(resolve, interval);
+      opts.signal?.addEventListener("abort", () => {
+        clearTimeout(t);
+        reject(new Error("Aborted"));
+      });
+    });
+  }
+  throw new PollTimeoutError();
+}
+
 // src/core/env-loader.ts
-import fs from "fs";
+import fs3 from "fs";
 import os from "os";
-import path from "path";
+import path3 from "path";
 import { config as dotenvConfig } from "dotenv";
 var loaded = false;
 function loadEnv() {
   if (loaded) return;
   loaded = true;
-  const cwdEnv = path.resolve(process.cwd(), ".env");
-  if (fs.existsSync(cwdEnv)) {
+  const cwdEnv = path3.resolve(process.cwd(), ".env");
+  if (fs3.existsSync(cwdEnv)) {
     dotenvConfig({ path: cwdEnv, override: false });
   }
   if (!process.env.MULTIX_DISABLE_HOME_ENV) {
-    const homeEnv = path.join(os.homedir(), ".multix", ".env");
-    if (fs.existsSync(homeEnv)) {
+    const homeEnv = path3.join(os.homedir(), ".multix", ".env");
+    if (fs3.existsSync(homeEnv)) {
       dotenvConfig({ path: homeEnv, override: false });
     }
   }
@@ -236,9 +367,15 @@ init_http_client();
 var DEFAULT_BYTEPLUS_BASE_URL = "https://ark.ap-southeast.bytepluses.com/api/v3";
 var DEFAULT_BYTEPLUS_IMAGE_MODEL = "seedream-4-0-250828";
 var DEFAULT_BYTEPLUS_VIDEO_MODEL = "seedance-2.0";
+var DEFAULT_BYTEPLUS_3D_MODEL = "hyper3d-gen2-260112";
+var BYTEPLUS_3D_MODELS = [
+  { id: "hyper3d-gen2-260112", name: "Hyper3D Gen2", family: "hyper3d" },
+  { id: "hitem3d-2-0-251223", name: "Hitem3d 2.0", family: "hitem3d" }
+];
 var BYTEPLUS_DEFAULTS = {
   imageModel: process.env.BYTEPLUS_IMAGE_MODEL ?? DEFAULT_BYTEPLUS_IMAGE_MODEL,
   videoModel: process.env.BYTEPLUS_VIDEO_MODEL ?? DEFAULT_BYTEPLUS_VIDEO_MODEL,
+  threeDModel: process.env.BYTEPLUS_3D_MODEL ?? DEFAULT_BYTEPLUS_3D_MODEL,
   videoResolution: "1080p",
   videoDuration: 8,
   videoAspectRatio: "16:9",
@@ -269,9 +406,9 @@ var BytePlusClient = class {
   }
   apiKey;
   baseUrl;
-  async request(path35, opts = {}) {
+  async request(path36, opts = {}) {
     const base = this.baseUrl.replace(/\/$/, "");
-    const url = new URL(base + path35);
+    const url = new URL(base + path36);
     if (opts.query) {
       for (const [k, v] of Object.entries(opts.query)) {
         if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
@@ -289,119 +426,145 @@ var BytePlusClient = class {
       timeoutMs: opts.timeoutMs ?? 12e4
     });
   }
-  get(path35, query, logger) {
-    return this.request(path35, { method: "GET", query, logger });
+  get(path36, query, logger) {
+    return this.request(path36, { method: "GET", query, logger });
   }
-  post(path35, body, logger) {
-    return this.request(path35, { method: "POST", body, logger });
+  post(path36, body, logger) {
+    return this.request(path36, { method: "POST", body, logger });
   }
-  delete(path35, logger) {
-    return this.request(path35, { method: "DELETE", logger });
+  delete(path36, logger) {
+    return this.request(path36, { method: "DELETE", logger });
   }
 };
 function createBytePlusClient() {
   return new BytePlusClient(requireBytePlusKey(), bytePlusBaseUrl());
 }
 
-// src/providers/byteplus/generators/image.ts
+// src/providers/byteplus/generators/three-d.ts
 init_http_client();
-import fs5 from "fs";
-import path5 from "path";
-
-// src/core/image-input.ts
-import fs3 from "fs/promises";
-import path3 from "path";
-var IMAGE_MIME_BY_EXT = {
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".png": "image/png",
-  ".webp": "image/webp",
-  ".gif": "image/gif"
-};
-var VIDEO_MIME_BY_EXT = {
-  ".mp4": "video/mp4",
-  ".webm": "video/webm",
-  ".mov": "video/quicktime",
-  ".m4v": "video/x-m4v"
-};
-var AUDIO_MIME_BY_EXT = {
-  ".mp3": "audio/mpeg",
-  ".wav": "audio/wav",
-  ".m4a": "audio/mp4",
-  ".flac": "audio/flac",
-  ".ogg": "audio/ogg"
-};
-var DEFAULT_SOFT_LIMIT_BYTES = 10 * 1024 * 1024;
-var DEFAULT_HARD_LIMIT_BYTES = 25 * 1024 * 1024;
-function isHttpUrl(input) {
-  return /^https?:\/\//i.test(input);
-}
-async function readAsDataUrl(filePath, mimeTable, kindLabel, opts = {}) {
-  const ext = path3.extname(filePath).toLowerCase();
-  const mime = mimeTable[ext];
-  if (!mime) {
-    throw new Error(
-      `Unsupported ${kindLabel} extension '${ext}'. Allowed: ${Object.keys(mimeTable).join(", ")}`
-    );
-  }
-  const hard = opts.hardLimitBytes ?? DEFAULT_HARD_LIMIT_BYTES;
-  const soft = opts.softLimitBytes ?? DEFAULT_SOFT_LIMIT_BYTES;
-  const buf = await fs3.readFile(filePath);
-  if (buf.byteLength > hard) {
-    throw new Error(
-      `${kindLabel} file ${filePath} is ${(buf.byteLength / 1024 / 1024).toFixed(1)}MB \u2014 exceeds ${(hard / 1024 / 1024).toFixed(0)}MB limit. Upload to a URL instead.`
-    );
+function buildThreeDTaskBody(opts) {
+  const promptText = (opts.prompt ?? "").trim();
+  const flagPart = opts.flags?.trim() ?? "";
+  const text = [promptText, flagPart].filter((s) => s.length > 0).join(" ");
+  const content = [];
+  if (text.length > 0) content.push({ type: "text", text });
+  for (const img of opts.imageInputs ?? []) {
+    content.push({ type: "image_url", image_url: { url: refUrl(img) } });
   }
-  if (buf.byteLength > soft) {
-    opts.logger?.warn(
-      `${kindLabel} payload ${(buf.byteLength / 1024 / 1024).toFixed(1)}MB is large; consider URL input.`
-    );
+  if (content.length === 0) {
+    throw new Error("3D task requires either a prompt or at least one image input.");
   }
-  const dataUrl = `data:${mime};base64,${buf.toString("base64")}`;
-  return { dataUrl, mime, bytes: buf.byteLength };
+  const body = { model: opts.model, content };
+  if (opts.seed !== void 0) body.seed = opts.seed;
+  return body;
 }
-async function resolveImageInput(input, opts = {}) {
-  const o = normalizeOpts(opts);
-  if (isHttpUrl(input)) return { kind: "url", url: input };
-  const { dataUrl, mime, bytes } = await readAsDataUrl(input, IMAGE_MIME_BY_EXT, "image", o);
-  return { kind: "data", dataUrl, mime, bytes };
+async function submitThreeDTask(client, body, logger) {
+  return client.post("/contents/generations/tasks", body, logger);
 }
-async function resolveVideoInput(input, opts = {}) {
-  const o = normalizeOpts(opts);
-  if (isHttpUrl(input)) return { kind: "url", url: input };
-  const { dataUrl, mime, bytes } = await readAsDataUrl(input, VIDEO_MIME_BY_EXT, "video", o);
-  return { kind: "data", dataUrl, mime, bytes };
+async function getThreeDTaskStatus(client, id, logger) {
+  return client.get(`/contents/generations/tasks/${id}`, void 0, logger);
 }
-async function resolveAudioInput(input, opts = {}) {
-  const o = normalizeOpts(opts);
-  if (isHttpUrl(input)) return { kind: "url", url: input };
-  const { dataUrl, mime, bytes } = await readAsDataUrl(input, AUDIO_MIME_BY_EXT, "audio", o);
-  return { kind: "data", dataUrl, mime, bytes };
+async function waitForThreeDTask(client, id, opts = {}) {
+  const intervalMs = opts.intervalMs ?? 4e3;
+  const maxAttempts = opts.maxAttempts ?? (opts.waitTimeoutMs ? Math.max(1, Math.ceil(opts.waitTimeoutMs / intervalMs)) : 180);
+  return poll({
+    fetch: () => getThreeDTaskStatus(client, id, opts.logger),
+    done: (v) => v.status === "succeeded",
+    failed: (v) => v.status === "failed" || v.status === "cancelled",
+    intervalMs,
+    maxAttempts,
+    onTick: (attempt, v) => opts.logger?.debug(`attempt ${attempt} \u2014 status: ${v.status}`)
+  });
 }
-function refUrl(r) {
-  return r.kind === "url" ? r.url : r.dataUrl;
+function inferModelFileExt(url) {
+  const m = url.match(/\.(glb|gltf|obj|fbx|usdz|stl|ply|zip)(?:\?|#|$)/i);
+  return m?.[1] ? m[1].toLowerCase() : "glb";
 }
-function normalizeOpts(opts) {
-  if (!opts) return {};
-  if (typeof opts.info === "function" && typeof opts.warn === "function") {
-    return { logger: opts };
-  }
-  return opts;
+async function downloadModelFile(url, outputPath, logger) {
+  await downloadFile(url, outputPath);
+  logger?.success(`Saved ${outputPath}`);
 }
 
-// src/core/output-dir.ts
-import fs4 from "fs";
-import path4 from "path";
-var cachedOutputDir;
-function getOutputDir() {
-  if (cachedOutputDir) return cachedOutputDir;
-  const dir = process.env.MULTIX_OUTPUT_DIR ? path4.resolve(process.env.MULTIX_OUTPUT_DIR) : path4.resolve(process.cwd(), "multix-output");
-  fs4.mkdirSync(dir, { recursive: true });
-  cachedOutputDir = dir;
-  return dir;
+// src/providers/byteplus/commands/generate-3d.ts
+function registerBytePlusGenerate3DCommand(parent) {
+  parent.command("generate-3d").alias("3d").description(
+    `Generate a 3D model via BytePlus (Hyper3D / Hitem3d). Models: ${BYTEPLUS_3D_MODELS.map((m) => m.id).join(", ")}`
+  ).option("--prompt <text>", "Text prompt (text-to-3D or to guide image-to-3D)").option(
+    "-m, --model <id>",
+    `Model id (default ${BYTEPLUS_DEFAULTS.threeDModel})`,
+    BYTEPLUS_DEFAULTS.threeDModel
+  ).option("--input-image <path|url...>", "1\u20135 reference images for image-to-3D (path or URL)").option(
+    "--flags <raw>",
+    "Raw flags appended to the prompt (e.g. '--mesh_mode Raw --hd_texture true' for Hyper3D, '--ff 2 --resolution 1536pro' for Hitem3d)"
+  ).option("--seed <n>", "Fixed seed").option("--async", "Submit task and exit; print taskId only").option("--wait-timeout <ms>", "Poll timeout in ms", "900000").option("--output <path>", "Output file path (extension auto-detected from URL if omitted)").option("-v, --verbose", "Verbose logging").action(
+    async (opts) => {
+      const logger = createLogger({ verbose: opts.verbose ?? false });
+      const client = createBytePlusClient();
+      const images = opts.inputImage ?? [];
+      if (images.length > 5) {
+        logger.error("BytePlus 3D supports at most 5 reference images.");
+        process.exit(1);
+      }
+      const imageInputs = await Promise.all(images.map((src) => resolveImageInput(src, logger)));
+      if (!opts.prompt && imageInputs.length === 0) {
+        logger.error("Provide --prompt and/or --input-image to describe the 3D content.");
+        process.exit(1);
+      }
+      const body = buildThreeDTaskBody({
+        model: opts.model,
+        prompt: opts.prompt,
+        flags: opts.flags,
+        seed: opts.seed ? Number.parseInt(opts.seed, 10) : void 0,
+        imageInputs
+      });
+      logger.info(
+        `Submitting 3D task (${opts.model}${imageInputs.length > 0 ? `, ${imageInputs.length} image ref${imageInputs.length === 1 ? "" : "s"}` : ""})`
+      );
+      const submitted = await submitThreeDTask(client, body, logger);
+      const taskId = submitted.id;
+      logger.debug(`taskId: ${taskId}`);
+      if (opts.async) {
+        console.log(taskId);
+        console.error(`Poll with: multix byteplus status ${taskId} --wait --download`);
+        return;
+      }
+      try {
+        const final = await waitForThreeDTask(client, taskId, {
+          waitTimeoutMs: Number.parseInt(opts.waitTimeout, 10) || 9e5,
+          logger
+        });
+        const url = final.content?.file_url;
+        if (!url) {
+          logger.error(`Task succeeded but no file_url in response: ${JSON.stringify(final)}`);
+          process.exit(1);
+        }
+        const ext = inferModelFileExt(url);
+        const outPath = opts.output ?? path5.join(getOutputDir(), `byteplus-3d-${taskId.slice(0, 8)}-${Date.now()}.${ext}`);
+        await downloadModelFile(url, outPath, logger);
+        console.log(`
+Task: ${taskId}`);
+        console.log(`Saved: ${outPath}`);
+      } catch (e) {
+        if (e instanceof PollTimeoutError) {
+          logger.error(
+            `Polling timed out \u2014 keep the task and check later: multix byteplus status ${taskId} --wait --download`
+          );
+          process.exit(1);
+        }
+        if (e instanceof PollFailedError) {
+          logger.error(`Task failed: ${JSON.stringify(e.value)}`);
+          process.exit(1);
+        }
+        throw e;
+      }
+    }
+  );
 }
 
 // src/providers/byteplus/generators/image.ts
+init_http_client();
+import fs5 from "fs";
+import path6 from "path";
 var ASPECT_TO_SIZE = {
   "1:1": "2048x2048",
   "16:9": "2560x1440",
@@ -465,14 +628,14 @@ async function generateSeedream(client, opts) {
     }
     const ext = (() => {
       try {
-        const e = path5.extname(new URL(url).pathname);
+        const e = path6.extname(new URL(url).pathname);
         return e || ".jpg";
       } catch {
         return ".jpg";
       }
     })();
-    const filename = opts.output && items.length === 1 ? path5.resolve(opts.output) : path5.join(outDir, `byteplus-image-${ts}-${i + 1}${ext}`);
-    fs5.mkdirSync(path5.dirname(filename), { recursive: true });
+    const filename = opts.output && items.length === 1 ? path6.resolve(opts.output) : path6.join(outDir, `byteplus-image-${ts}-${i + 1}${ext}`);
+    fs5.mkdirSync(path6.dirname(filename), { recursive: true });
     await downloadFile(url, filename);
     saved.push({ path: filename, url, seed: item.seed });
     logger?.success(`Saved ${filename}`);
@@ -552,12 +715,12 @@ function collect2(value, prev) {
 }
 
 // src/providers/byteplus/commands/image-to-video.ts
-import path7 from "path";
+import path8 from "path";
 
 // src/core/video-thumb.ts
 init_http_client();
 import fs6 from "fs";
-import path6 from "path";
+import path7 from "path";
 var THUMB_KEYS = /* @__PURE__ */ new Set([
   "cover_image_url",
   "coverImageUrl",
@@ -607,9 +770,9 @@ function detectThumbUrl(obj) {
 async function downloadThumbBeside(thumbUrl, videoPath, logger) {
   const match = thumbUrl.match(IMAGE_EXT_RE);
   const ext = match?.[1] ? match[1].toLowerCase().replace("jpeg", "jpg") : "jpg";
-  const dir = path6.dirname(videoPath);
-  const base = path6.basename(videoPath, path6.extname(videoPath));
-  const dest = path6.join(dir, `${base}_thumb.${ext}`);
+  const dir = path7.dirname(videoPath);
+  const base = path7.basename(videoPath, path7.extname(videoPath));
+  const dest = path7.join(dir, `${base}_thumb.${ext}`);
   try {
     await downloadFile(thumbUrl, dest);
     logger?.success(`Saved thumb ${dest}`);
@@ -628,10 +791,10 @@ async function maybeDownloadThumb(source, videoPath, opts = {}) {
   }
   const saved = await downloadThumbBeside(url, videoPath, opts.logger);
   if (saved && opts.copyTo) {
-    const copyExt = path6.extname(saved);
-    const copyBase = path6.basename(opts.copyTo, path6.extname(opts.copyTo));
-    const copyDir = path6.dirname(path6.resolve(opts.copyTo));
-    const copyDest = path6.join(copyDir, `${copyBase}_thumb${copyExt}`);
+    const copyExt = path7.extname(saved);
+    const copyBase = path7.basename(opts.copyTo, path7.extname(opts.copyTo));
+    const copyDir = path7.dirname(path7.resolve(opts.copyTo));
+    const copyDest = path7.join(copyDir, `${copyBase}_thumb${copyExt}`);
     fs6.mkdirSync(copyDir, { recursive: true });
     fs6.copyFileSync(saved, copyDest);
     opts.logger?.success(`Copied thumb to ${copyDest}`);
@@ -639,41 +802,6 @@ async function maybeDownloadThumb(source, videoPath, opts = {}) {
   return saved;
 }
 
-// src/providers/leonardo/poll.ts
-var PollTimeoutError = class extends Error {
-  constructor() {
-    super("Polling timed out before the operation completed.");
-    this.name = "PollTimeoutError";
-  }
-};
-var PollFailedError = class extends Error {
-  constructor(value) {
-    super("Operation failed.");
-    this.value = value;
-    this.name = "PollFailedError";
-  }
-  value;
-};
-async function poll(opts) {
-  const interval = opts.intervalMs ?? 4e3;
-  const max = opts.maxAttempts ?? 120;
-  for (let attempt = 1; attempt <= max; attempt++) {
-    if (opts.signal?.aborted) throw new Error("Aborted");
-    const value = await opts.fetch();
-    opts.onTick?.(attempt, value);
-    if (opts.failed?.(value)) throw new PollFailedError(value);
-    if (opts.done(value)) return value;
-    await new Promise((resolve, reject) => {
-      const t = setTimeout(resolve, interval);
-      opts.signal?.addEventListener("abort", () => {
-        clearTimeout(t);
-        reject(new Error("Aborted"));
-      });
-    });
-  }
-  throw new PollTimeoutError();
-}
-
 // src/providers/byteplus/generators/video.ts
 init_http_client();
 function buildFlagSuffix(opts) {
@@ -796,7 +924,7 @@ function registerBytePlusImageToVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path7.join(getOutputDir(), `byteplus-i2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path8.join(getOutputDir(), `byteplus-i2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -822,7 +950,7 @@ Task: ${taskId}`);
 }
 
 // src/providers/byteplus/commands/reference-to-video.ts
-import path8 from "path";
+import path9 from "path";
 
 // src/providers/byteplus/reference-input.ts
 var MAX_TOTAL_REFS = 12;
@@ -854,10 +982,10 @@ function toRef(kind, resolved, role) {
   return { kind, url: resolved.dataUrl, mime: resolved.mime, role };
 }
 async function resolveRefSpec(kind, spec, logger) {
-  const { path: path35, role } = parseRefSpec(spec);
-  if (kind === "image") return toRef(kind, await resolveImageInput(path35, logger), role);
-  if (kind === "video") return toRef(kind, await resolveVideoInput(path35, logger), role);
-  return toRef(kind, await resolveAudioInput(path35, logger), role);
+  const { path: path36, role } = parseRefSpec(spec);
+  if (kind === "image") return toRef(kind, await resolveImageInput(path36, logger), role);
+  if (kind === "video") return toRef(kind, await resolveVideoInput(path36, logger), role);
+  return toRef(kind, await resolveAudioInput(path36, logger), role);
 }
 async function resolveRefSpecs(specs, logger) {
   const out = [];
@@ -954,7 +1082,7 @@ function registerBytePlusReferenceToVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path8.join(getOutputDir(), `byteplus-r2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path9.join(getOutputDir(), `byteplus-r2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -980,7 +1108,7 @@ Task: ${taskId}`);
 }
 
 // src/providers/byteplus/commands/status.ts
-import path9 from "path";
+import path10 from "path";
 function registerBytePlusStatusCommand(parent) {
   parent.command("status <taskId>").description("Get a Seedance task's status; --wait + --download to fetch the result MP4").option("--wait", "Poll until terminal status").option("--wait-timeout <ms>", "Poll timeout in ms (with --wait)", "600000").option("--download", "Download MP4 on success (implies --wait)").option("--output <path>", "Output MP4 path (with --download)").option("--no-thumb", "Skip downloading the thumbnail if the API returns one").option("-v, --verbose", "Verbose logging").action(
     async (taskId, opts) => {
@@ -994,19 +1122,27 @@ function registerBytePlusStatusCommand(parent) {
         }) : await getVideoTaskStatus(client, taskId, logger);
         console.log(JSON.stringify(status, null, 2));
         if (opts.download && status.status === "succeeded") {
-          const url = status.content?.video_url;
-          if (!url) {
-            logger.error("Task succeeded but no video_url present");
+          const content = status.content;
+          const videoUrl = content?.video_url;
+          const fileUrl = content?.file_url;
+          if (videoUrl) {
+            const outPath = opts.output ?? path10.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}.mp4`);
+            await downloadVideo(videoUrl, outPath, logger);
+            await maybeDownloadThumb(status, outPath, {
+              skip: opts.thumb === false,
+              copyTo: opts.output,
+              logger
+            });
+            console.log(`Saved: ${outPath}`);
+          } else if (fileUrl) {
+            const ext = inferModelFileExt(fileUrl);
+            const outPath = opts.output ?? path10.join(getOutputDir(), `byteplus-3d-${taskId.slice(0, 8)}.${ext}`);
+            await downloadModelFile(fileUrl, outPath, logger);
+            console.log(`Saved: ${outPath}`);
+          } else {
+            logger.error("Task succeeded but no video_url or file_url present");
             process.exit(1);
           }
-          const outPath = opts.output ?? path9.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}.mp4`);
-          await downloadVideo(url, outPath, logger);
-          await maybeDownloadThumb(status, outPath, {
-            skip: opts.thumb === false,
-            copyTo: opts.output,
-            logger
-          });
-          console.log(`Saved: ${outPath}`);
         }
       } catch (e) {
         if (e instanceof PollTimeoutError) {
@@ -1024,7 +1160,7 @@ function registerBytePlusStatusCommand(parent) {
 }
 
 // src/providers/byteplus/commands/video.ts
-import path10 from "path";
+import path11 from "path";
 function registerBytePlusVideoCommand(parent) {
   parent.command("video").description("Generate a video from a text prompt via BytePlus Seedance 2.0").requiredOption("--prompt <text>", "Text prompt").option("-m, --model <id>", "Model id", BYTEPLUS_DEFAULTS.videoModel).option("--resolution <r>", "480p|720p|1080p|2k", BYTEPLUS_DEFAULTS.videoResolution).option("--duration <n>", "Duration seconds (4-15)", String(BYTEPLUS_DEFAULTS.videoDuration)).option(
     "--aspect-ratio <r>",
@@ -1066,7 +1202,7 @@ function registerBytePlusVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url in response: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path10.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path11.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -1095,12 +1231,15 @@ Task: ${taskId}`);
 
 // src/providers/byteplus/commands/index.ts
 function registerBytePlusCommands(program2) {
-  const byteplus = program2.command("byteplus").description("BytePlus ModelArk: Seedream image generation, Seedance video generation");
+  const byteplus = program2.command("byteplus").description(
+    "BytePlus ModelArk: Seedream image, Seedance video, Hyper3D / Hitem3d 3D generation"
+  );
   registerBytePlusGenerateCommand(byteplus);
   registerBytePlusImageToImageCommand(byteplus);
   registerBytePlusVideoCommand(byteplus);
   registerBytePlusImageToVideoCommand(byteplus);
   registerBytePlusReferenceToVideoCommand(byteplus);
+  registerBytePlusGenerate3DCommand(byteplus);
   registerBytePlusStatusCommand(byteplus);
 }
 
@@ -1110,12 +1249,12 @@ import fs9 from "fs";
 
 // src/providers/gemini/client.ts
 import fs7 from "fs";
-import path12 from "path";
+import path13 from "path";
 init_errors();
 init_http_client();
 
 // src/providers/gemini/task-resolver.ts
-import path11 from "path";
+import path12 from "path";
 var MIME_MAP = {
   // Audio
   ".mp3": "audio/mp3",
@@ -1156,7 +1295,7 @@ var MIME_MAP = {
   ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
 };
 function getMimeType(filePath) {
-  const ext = path11.extname(filePath).toLowerCase();
+  const ext = path12.extname(filePath).toLowerCase();
   return MIME_MAP[ext] ?? "application/octet-stream";
 }
 function requiresProcessingWait(mimeType) {
@@ -1183,7 +1322,7 @@ async function uploadFile(filePath, opts = {}) {
   const { timeoutMs = 3e5, logger } = opts;
   const mimeType = getMimeType(filePath);
   const fileBytes = fs7.readFileSync(filePath);
-  const displayName = path12.basename(filePath);
+  const displayName = path13.basename(filePath);
   const boundary = `multix_${Date.now()}`;
   const metaJson = JSON.stringify({ file: { displayName, mimeType } });
   const body = Buffer.concat([
@@ -1331,11 +1470,11 @@ function getDefaultModel(task) {
 
 // src/providers/gemini/result-formatter.ts
 import fs8 from "fs";
-import path13 from "path";
+import path14 from "path";
 function formatResults(results, format, outputPath) {
   const content = renderFormat(results, format);
   if (outputPath) {
-    fs8.mkdirSync(path13.dirname(path13.resolve(outputPath)), { recursive: true });
+    fs8.mkdirSync(path14.dirname(path14.resolve(outputPath)), { recursive: true });
     fs8.writeFileSync(outputPath, content, "utf8");
   } else {
     process.stdout.write(content);
@@ -1499,7 +1638,7 @@ init_errors();
 
 // src/providers/gemini/generators/speech.ts
 import fs11 from "fs";
-import path14 from "path";
+import path15 from "path";
 
 // src/providers/gemini/voices.ts
 var GEMINI_TTS_VOICES = [
@@ -1582,11 +1721,11 @@ async function generateGeminiSpeech(opts) {
   const sampleRate = parseSampleRate(audio.mimeType) ?? TTS_PCM_SAMPLE_RATE;
   const outBytes = outputFormat === "wav" ? wrapPcmInWav(pcmBytes, sampleRate, TTS_PCM_CHANNELS, TTS_PCM_BITS_PER_SAMPLE) : pcmBytes;
   const outDir = getOutputDir();
-  const dest = path14.join(outDir, `gemini_speech_${Date.now()}.${outputFormat}`);
+  const dest = path15.join(outDir, `gemini_speech_${Date.now()}.${outputFormat}`);
   fs11.writeFileSync(dest, outBytes);
   logger?.success(`Saved: ${dest} (${(outBytes.length / 1024).toFixed(1)} KB)`);
   if (output) {
-    fs11.mkdirSync(path14.dirname(path14.resolve(output)), { recursive: true });
+    fs11.mkdirSync(path15.dirname(path15.resolve(output)), { recursive: true });
     fs11.copyFileSync(dest, output);
     logger?.success(`Copied to: ${output}`);
   }
@@ -1687,7 +1826,7 @@ function collectSpeakers(value, prev) {
 
 // src/providers/gemini/commands/generate-video.ts
 import fs12 from "fs";
-import path15 from "path";
+import path16 from "path";
 init_errors();
 init_http_client();
 var BASE2 = "https://generativelanguage.googleapis.com";
@@ -1724,7 +1863,7 @@ function registerGenerateVideoCommand(parent) {
           if (!fs12.existsSync(imgPath))
             throw new ValidationError(`Reference image not found: ${imgPath}`);
           const data = fs12.readFileSync(imgPath).toString("base64");
-          const ext = path15.extname(imgPath).toLowerCase();
+          const ext = path16.extname(imgPath).toLowerCase();
           const mimeType = ext === ".png" ? "image/png" : "image/jpeg";
           contentParts.push({ inlineData: { mimeType, data } });
         }
@@ -1773,12 +1912,12 @@ function registerGenerateVideoCommand(parent) {
         );
       }
       const outDir = getOutputDir();
-      const dest = path15.join(outDir, `veo_generated_${Date.now()}.mp4`);
+      const dest = path16.join(outDir, `veo_generated_${Date.now()}.mp4`);
       const { downloadFile: downloadFile2 } = await Promise.resolve().then(() => (init_http_client(), http_client_exports));
       await downloadFile2(videoUri, dest);
       logger.success(`Saved video: ${dest}`);
       if (opts.output) {
-        fs12.mkdirSync(path15.dirname(path15.resolve(opts.output)), { recursive: true });
+        fs12.mkdirSync(path16.dirname(path16.resolve(opts.output)), { recursive: true });
         fs12.copyFileSync(dest, opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
@@ -1799,7 +1938,7 @@ function sleep2(ms) {
 // src/providers/gemini/commands/generate.ts
 init_errors();
 import fs13 from "fs";
-import path16 from "path";
+import path17 from "path";
 function registerGenerateCommand(parent) {
   parent.command("generate").description("Generate images with Gemini (Nano Banana / Imagen 4)").requiredOption("--prompt <text>", "Image generation prompt").option("--model <id>", "Gemini image model to use").option("--aspect-ratio <ratio>", `Aspect ratio (${ASPECT_RATIOS.join("|")})`, "1:1").option("--num-images <n>", "Number of images to generate (1-4)", "1").option("--size <sz>", `Image size (${IMAGE_SIZES.join("|")})`).option("--output <path>", "Copy first generated image to this path").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
@@ -1841,7 +1980,7 @@ function registerGenerateCommand(parent) {
             const outDir = getOutputDir();
             const ext = img.mimeType.includes("png") ? "png" : "jpg";
             const fname = `gemini_generated_${Date.now()}_${i}.${ext}`;
-            const dest = path16.join(outDir, fname);
+            const dest = path17.join(outDir, fname);
             fs13.writeFileSync(dest, Buffer.from(img.data, "base64"));
             savedFiles.push(dest);
             logger.success(`Saved: ${dest}`);
@@ -1857,7 +1996,7 @@ function registerGenerateCommand(parent) {
         process.exit(1);
       }
       if (opts.output && savedFiles[0]) {
-        fs13.mkdirSync(path16.dirname(path16.resolve(opts.output)), { recursive: true });
+        fs13.mkdirSync(path17.dirname(path17.resolve(opts.output)), { recursive: true });
         fs13.copyFileSync(savedFiles[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
@@ -1870,7 +2009,7 @@ Generated ${savedFiles.length} image(s):`);
 
 // src/providers/gemini/commands/image-to-image.ts
 import fs14 from "fs";
-import path17 from "path";
+import path18 from "path";
 var SOFT_LIMIT_BYTES = 5 * 1024 * 1024;
 var HARD_LIMIT_BYTES = 7 * 1024 * 1024;
 function registerGeminiImageToImageCommand(parent) {
@@ -1931,13 +2070,13 @@ function registerGeminiImageToImageCommand(parent) {
         const img = images[i];
         if (!img) continue;
         const ext = img.mimeType.includes("png") ? "png" : "jpg";
-        const dest = path17.join(outDir, `gemini-i2i-${ts}-${i + 1}.${ext}`);
+        const dest = path18.join(outDir, `gemini-i2i-${ts}-${i + 1}.${ext}`);
         fs14.writeFileSync(dest, Buffer.from(img.data, "base64"));
         saved.push(dest);
         logger.success(`Saved: ${dest}`);
       }
       if (opts.output && saved[0]) {
-        fs14.mkdirSync(path17.dirname(path17.resolve(opts.output)), { recursive: true });
+        fs14.mkdirSync(path18.dirname(path18.resolve(opts.output)), { recursive: true });
         fs14.copyFileSync(saved[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
@@ -1965,7 +2104,7 @@ function sniffImageMime(buf, url) {
     if (buf.length >= 12 && buf.slice(0, 4).toString() === "RIFF" && buf.slice(8, 12).toString() === "WEBP")
       return "image/webp";
   }
-  const ext = path17.extname(new URL(url).pathname).toLowerCase();
+  const ext = path18.extname(new URL(url).pathname).toLowerCase();
   if (ext === ".png") return "image/png";
   if (ext === ".webp") return "image/webp";
   if (ext === ".gif") return "image/gif";
@@ -1974,7 +2113,7 @@ function sniffImageMime(buf, url) {
 
 // src/providers/gemini/commands/image-to-video.ts
 import fs15 from "fs";
-import path18 from "path";
+import path19 from "path";
 init_errors();
 init_http_client();
 var BASE3 = "https://generativelanguage.googleapis.com";
@@ -1983,7 +2122,7 @@ function imagePart(imgPath) {
     throw new ValidationError(`Image not found: ${imgPath}`);
   }
   const data = fs15.readFileSync(imgPath).toString("base64");
-  const ext = path18.extname(imgPath).toLowerCase();
+  const ext = path19.extname(imgPath).toLowerCase();
   const mimeType = ext === ".png" ? "image/png" : "image/jpeg";
   return { inlineData: { mimeType, data } };
 }
@@ -2056,11 +2195,11 @@ function registerGeminiImageToVideoCommand(parent) {
           "gemini"
         );
       }
-      const dest = path18.join(getOutputDir(), `veo_i2v_${Date.now()}.mp4`);
+      const dest = path19.join(getOutputDir(), `veo_i2v_${Date.now()}.mp4`);
       await downloadFile(videoUri, dest);
       logger.success(`Saved video: ${dest}`);
       if (opts.output) {
-        fs15.mkdirSync(path18.dirname(path18.resolve(opts.output)), { recursive: true });
+        fs15.mkdirSync(path19.dirname(path19.resolve(opts.output)), { recursive: true });
         fs15.copyFileSync(dest, opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
@@ -2143,7 +2282,7 @@ function registerGeminiCommands(program2) {
 // src/providers/leonardo/commands/generate.ts
 init_http_client();
 import fs17 from "fs";
-import path19 from "path";
+import path20 from "path";
 
 // src/providers/leonardo/client.ts
 init_errors();
@@ -2217,11 +2356,11 @@ var LeonardoClient = class {
   }
   apiKey;
   baseUrl;
-  async request(path35, opts = {}) {
+  async request(path36, opts = {}) {
     const base = this.baseUrl.replace(/\/$/, "");
-    const v2Override = path35.startsWith("v2:");
+    const v2Override = path36.startsWith("v2:");
     const finalBase = v2Override ? base.replace(/\/v1$/, "/v2") : base;
-    const finalPath = v2Override ? path35.slice(3) : path35;
+    const finalPath = v2Override ? path36.slice(3) : path36;
     const url = new URL(finalBase + finalPath);
     if (opts.query) {
       for (const [k, v] of Object.entries(opts.query)) {
@@ -2240,14 +2379,14 @@ var LeonardoClient = class {
       timeoutMs: opts.timeoutMs ?? 12e4
     });
   }
-  get(path35, query, logger) {
-    return this.request(path35, { method: "GET", query, logger });
+  get(path36, query, logger) {
+    return this.request(path36, { method: "GET", query, logger });
   }
-  post(path35, body, logger) {
-    return this.request(path35, { method: "POST", body, logger });
+  post(path36, body, logger) {
+    return this.request(path36, { method: "POST", body, logger });
   }
-  delete(path35, logger) {
-    return this.request(path35, { method: "DELETE", logger });
+  delete(path36, logger) {
+    return this.request(path36, { method: "DELETE", logger });
   }
 };
 function createLeonardoClient() {
@@ -2258,7 +2397,7 @@ function createLeonardoClient() {
 function extFromUrl(url, fallback = ".png") {
   try {
     const u = new URL(url);
-    const e = path19.extname(u.pathname);
+    const e = path20.extname(u.pathname);
     return e.length > 0 ? e : fallback;
   } catch {
     return fallback;
@@ -2343,7 +2482,7 @@ function registerLeonardoGenerateCommand(parent) {
         if (!img) continue;
         const ext = extFromUrl(img.url);
         const filename = autoFilename(generationId, i + 1, ext);
-        const filepath = path19.join(outDir, filename);
+        const filepath = path20.join(outDir, filename);
         try {
           await downloadFile(img.url, filepath);
           saved.push(filepath);
@@ -2353,8 +2492,8 @@ function registerLeonardoGenerateCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        const dest = path19.resolve(opts.output);
-        fs17.mkdirSync(path19.dirname(dest), { recursive: true });
+        const dest = path20.resolve(opts.output);
+        fs17.mkdirSync(path20.dirname(dest), { recursive: true });
         fs17.copyFileSync(saved[0], dest);
         logger.success(`Copied to ${dest}`);
       }
@@ -2368,10 +2507,10 @@ Generated ${saved.length} image(s):`);
 // src/providers/leonardo/commands/image-to-image.ts
 init_http_client();
 import fs18 from "fs";
-import path20 from "path";
+import path21 from "path";
 function extFromUrl2(url, fallback = ".png") {
   try {
-    return path20.extname(new URL(url).pathname) || fallback;
+    return path21.extname(new URL(url).pathname) || fallback;
   } catch {
     return fallback;
   }
@@ -2433,7 +2572,7 @@ function registerLeonardoImageToImageCommand(parent) {
         if (!img) continue;
         const ext = extFromUrl2(img.url);
         const filename = `leonardo-i2i-${generationId.slice(0, 8)}-${String(i + 1).padStart(2, "0")}${ext}`;
-        const filepath = path20.join(outDir, filename);
+        const filepath = path21.join(outDir, filename);
         try {
           await downloadFile(img.url, filepath);
           saved.push(filepath);
@@ -2443,8 +2582,8 @@ function registerLeonardoImageToImageCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        const dest = path20.resolve(opts.output);
-        fs18.mkdirSync(path20.dirname(dest), { recursive: true });
+        const dest = path21.resolve(opts.output);
+        fs18.mkdirSync(path21.dirname(dest), { recursive: true });
         fs18.copyFileSync(saved[0], dest);
         logger.success(`Copied to ${dest}`);
       }
@@ -2457,7 +2596,7 @@ Generated ${saved.length} image(s):`);
 
 // src/providers/leonardo/commands/video.ts
 init_http_client();
-import path21 from "path";
+import path22 from "path";
 function v2DimsFor(resolution) {
   if (resolution === "RESOLUTION_1080") return { width: 1920, height: 1080 };
   if (resolution === "RESOLUTION_480") return { width: 854, height: 480 };
@@ -2568,7 +2707,7 @@ async function pollAndDownload(client, jobId, opts) {
     logger.error(`No video URL in completed generation: ${JSON.stringify(gen)}`);
     process.exit(1);
   }
-  const outPath = opts.output ?? path21.join(getOutputDir(), `${opts.basename}-${jobId.slice(0, 8)}.mp4`);
+  const outPath = opts.output ?? path22.join(getOutputDir(), `${opts.basename}-${jobId.slice(0, 8)}.mp4`);
   await downloadFile(videoUrl, outPath);
   logger.success(`Saved ${outPath}`);
   await maybeDownloadThumb(gen, outPath, {
@@ -2675,7 +2814,7 @@ function registerLeonardoModelsCommand(parent) {
 
 // src/providers/leonardo/commands/status.ts
 init_http_client();
-import path22 from "path";
+import path23 from "path";
 var VIDEO_KEYS = ["motionMP4URL", "url"];
 var IMAGE_EXT_RE2 = /\.(jpe?g|png|webp|gif)(\?|$)/i;
 var VIDEO_EXT_RE = /\.(mp4|webm|mov|m4v)(\?|$)/i;
@@ -2740,7 +2879,7 @@ function registerLeonardoStatusCommand(parent) {
       const outDir = getOutputDir();
       let idx = 0;
       for (const url of videos) {
-        const dest = opts.output && videos.length === 1 && images.length === 0 ? opts.output : path22.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.mp4`);
+        const dest = opts.output && videos.length === 1 && images.length === 0 ? opts.output : path23.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.mp4`);
         await downloadFile(url, dest);
         logger.success(`Saved ${dest}`);
         await maybeDownloadThumb(gen, dest, {
@@ -2753,7 +2892,7 @@ function registerLeonardoStatusCommand(parent) {
       for (const url of images) {
         const m = url.match(IMAGE_EXT_RE2);
         const ext = m?.[1] ? m[1].toLowerCase().replace("jpeg", "jpg") : "png";
-        const dest = path22.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.${ext}`);
+        const dest = path23.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.${ext}`);
         await downloadFile(url, dest);
         logger.success(`Saved ${dest}`);
         idx++;
@@ -2911,7 +3050,7 @@ function sleep4(ms) {
 // src/providers/minimax/generators/music.ts
 init_http_client();
 import fs19 from "fs";
-import path23 from "path";
+import path24 from "path";
 async function generateMinimaxMusic(opts) {
   const {
     apiKey,
@@ -2956,7 +3095,7 @@ async function generateMinimaxMusic(opts) {
   }
   const durationMs = resp.extra_info?.music_duration ?? 0;
   const outDir = getOutputDir();
-  const dest = path23.join(outDir, `minimax_music_${Date.now()}.${outputFormat}`);
+  const dest = path24.join(outDir, `minimax_music_${Date.now()}.${outputFormat}`);
   try {
     if (audioData.startsWith("http")) {
       const bytes = await fetchBytes(audioData);
@@ -2974,7 +3113,7 @@ async function generateMinimaxMusic(opts) {
   const durSec = durationMs / 1e3;
   logger?.success(`Saved: ${dest} (${durSec.toFixed(1)}s)`);
   if (output) {
-    fs19.mkdirSync(path23.dirname(path23.resolve(output)), { recursive: true });
+    fs19.mkdirSync(path24.dirname(path24.resolve(output)), { recursive: true });
     fs19.copyFileSync(dest, output);
   }
   return { status: "success", generatedAudio: dest, durationMs, model };
@@ -3050,7 +3189,7 @@ init_errors();
 
 // src/providers/minimax/generators/speech.ts
 import fs20 from "fs";
-import path24 from "path";
+import path25 from "path";
 async function generateMinimaxSpeech(opts) {
   const {
     apiKey,
@@ -3097,11 +3236,11 @@ async function generateMinimaxSpeech(opts) {
   const audioBytes = Buffer.from(audioHex, "hex");
   const ext = ["mp3", "wav", "flac"].includes(outputFormat) ? outputFormat : "mp3";
   const outDir = getOutputDir();
-  const dest = path24.join(outDir, `minimax_speech_${Date.now()}.${ext}`);
+  const dest = path25.join(outDir, `minimax_speech_${Date.now()}.${ext}`);
   fs20.writeFileSync(dest, audioBytes);
   logger?.success(`Saved: ${dest} (${(audioBytes.length / 1024).toFixed(1)} KB)`);
   if (output) {
-    fs20.mkdirSync(path24.dirname(path24.resolve(output)), { recursive: true });
+    fs20.mkdirSync(path25.dirname(path25.resolve(output)), { recursive: true });
     fs20.copyFileSync(dest, output);
   }
   return { status: "success", generatedAudio: dest, model };
@@ -3150,7 +3289,7 @@ init_errors();
 
 // src/providers/minimax/generators/video.ts
 import fs21 from "fs";
-import path25 from "path";
+import path26 from "path";
 async function generateMinimaxVideo(opts) {
   const {
     apiKey,
@@ -3196,7 +3335,7 @@ async function generateMinimaxVideo(opts) {
     return { status: "error", error: `No file_id in poll result: ${JSON.stringify(pollResult)}` };
   }
   const outDir = getOutputDir();
-  const dest = path25.join(outDir, `minimax_video_${Date.now()}.mp4`);
+  const dest = path26.join(outDir, `minimax_video_${Date.now()}.mp4`);
   try {
     await downloadMinimaxFile(fileId, apiKey, dest, logger);
   } catch (e) {
@@ -3206,7 +3345,7 @@ async function generateMinimaxVideo(opts) {
   const stat = fs21.statSync(dest);
   const fileSizeMb = stat.size / (1024 * 1024);
   if (output) {
-    fs21.mkdirSync(path25.dirname(path25.resolve(output)), { recursive: true });
+    fs21.mkdirSync(path26.dirname(path26.resolve(output)), { recursive: true });
     fs21.copyFileSync(dest, output);
   }
   await maybeDownloadThumb(pollResult, dest, {
@@ -3271,7 +3410,7 @@ Generated video: ${result.generatedVideo}`);
 init_errors();
 init_http_client();
 import fs22 from "fs";
-import path26 from "path";
+import path27 from "path";
 async function generateMinimaxImage(opts) {
   const {
     apiKey,
@@ -3309,7 +3448,7 @@ async function generateMinimaxImage(opts) {
     try {
       const bytes = await fetchBytes(url);
       const fname = `minimax_image_${Date.now()}_${i}.png`;
-      const dest = path26.join(outDir, fname);
+      const dest = path27.join(outDir, fname);
       fs22.writeFileSync(dest, bytes);
       savedFiles.push(dest);
       logger?.success(`Saved: ${dest}`);
@@ -3321,7 +3460,7 @@ async function generateMinimaxImage(opts) {
     }
   }
   if (output && savedFiles[0]) {
-    fs22.mkdirSync(path26.dirname(path26.resolve(output)), { recursive: true });
+    fs22.mkdirSync(path27.dirname(path27.resolve(output)), { recursive: true });
     fs22.copyFileSync(savedFiles[0], output);
   }
   return { status: "success", generatedImages: savedFiles, model };
@@ -3359,7 +3498,7 @@ Generated ${result.generatedImages?.length ?? 0} image(s):`);
 init_errors();
 init_http_client();
 import fs23 from "fs";
-import path27 from "path";
+import path28 from "path";
 function registerMinimaxImageToImageCommand(parent) {
   parent.command("image-to-image").alias("i2i").description(
     "MiniMax character/subject preservation. CAVEAT: NOT free-form image editing \u2014 the --ref image is used only as a character/face reference for a NEW scene described by --prompt."
@@ -3414,7 +3553,7 @@ function registerMinimaxImageToImageCommand(parent) {
         if (!url) continue;
         try {
           const bytes = await fetchBytes(url);
-          const dest = path27.join(outDir, `minimax-i2i-${ts}-${i + 1}.png`);
+          const dest = path28.join(outDir, `minimax-i2i-${ts}-${i + 1}.png`);
           fs23.writeFileSync(dest, bytes);
           saved.push(dest);
           logger.success(`Saved: ${dest}`);
@@ -3426,7 +3565,7 @@ function registerMinimaxImageToImageCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        fs23.mkdirSync(path27.dirname(path27.resolve(opts.output)), { recursive: true });
+        fs23.mkdirSync(path28.dirname(path28.resolve(opts.output)), { recursive: true });
         fs23.copyFileSync(saved[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
@@ -3449,7 +3588,7 @@ function registerMinimaxCommands(program2) {
 
 // src/providers/openrouter/client.ts
 import fs24 from "fs";
-import path28 from "path";
+import path29 from "path";
 init_errors();
 init_http_client();
 var OPENROUTER_API_URL = "https://openrouter.ai/api/v1/chat/completions";
@@ -3538,7 +3677,7 @@ async function generateOpenRouterImage(opts) {
     if (!url) continue;
     try {
       const bytes = await fetchBytes(url);
-      const dest = path28.join(outDir, `openrouter_image_${Date.now()}_${i}.png`);
+      const dest = path29.join(outDir, `openrouter_image_${Date.now()}_${i}.png`);
       fs24.writeFileSync(dest, bytes);
       savedFiles.push(dest);
       logger?.success(`Saved: ${dest}`);
@@ -3550,7 +3689,7 @@ async function generateOpenRouterImage(opts) {
     }
   }
   if (output && savedFiles[0]) {
-    fs24.mkdirSync(path28.dirname(path28.resolve(output)), { recursive: true });
+    fs24.mkdirSync(path29.dirname(path29.resolve(output)), { recursive: true });
     fs24.writeFileSync(output, fs24.readFileSync(savedFiles[0]));
   }
   return { status: "success", generatedImages: savedFiles, model: usedModel };
@@ -3587,7 +3726,7 @@ Generated ${result.generatedImages?.length ?? 0} image(s):`);
 
 // src/providers/openrouter/commands/image-to-image.ts
 import fs25 from "fs";
-import path29 from "path";
+import path30 from "path";
 init_errors();
 init_http_client();
 var DEFAULT_MODEL = "google/gemini-2.5-flash-image";
@@ -3674,13 +3813,13 @@ async function runImageToImage(opts) {
     const url = messageImages[i]?.image_url?.url;
     if (!url) continue;
     const bytes = await fetchBytes(url);
-    const dest = path29.join(outDir, `openrouter-i2i-${ts}-${i + 1}.png`);
+    const dest = path30.join(outDir, `openrouter-i2i-${ts}-${i + 1}.png`);
     fs25.writeFileSync(dest, bytes);
     saved.push(dest);
     opts.logger.success(`Saved: ${dest}`);
   }
   if (opts.output && saved[0]) {
-    fs25.mkdirSync(path29.dirname(path29.resolve(opts.output)), { recursive: true });
+    fs25.mkdirSync(path30.dirname(path30.resolve(opts.output)), { recursive: true });
     fs25.copyFileSync(saved[0], opts.output);
     opts.logger.success(`Copied to: ${opts.output}`);
   }
@@ -3728,12 +3867,12 @@ async function listVideoModels(apiKey = requireOpenRouterKey()) {
 
 // src/providers/openrouter/commands/video-status.ts
 import fs26 from "fs";
-import path30 from "path";
+import path31 from "path";
 async function downloadOpenRouterVideo(opts) {
   const { jobId, logger, source } = opts;
   const apiKey = requireOpenRouterKey();
   const url = videoContentUrl(jobId);
-  const dest = path30.join(getOutputDir(), `openrouter_video_${jobId}.mp4`);
+  const dest = path31.join(getOutputDir(), `openrouter_video_${jobId}.mp4`);
   const r = await globalThis.fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
   if (!r.ok) {
     logger.error(`Download HTTP ${r.status}`);
@@ -3743,13 +3882,13 @@ async function downloadOpenRouterVideo(opts) {
     logger.error("Empty response body");
     process.exit(1);
   }
-  fs26.mkdirSync(path30.dirname(dest), { recursive: true });
+  fs26.mkdirSync(path31.dirname(dest), { recursive: true });
   const ws = fs26.createWriteStream(dest);
   const { pipeline: pipeline2 } = await import("stream/promises");
   await pipeline2(r.body, ws);
   logger.success(`Saved ${dest}`);
   if (opts.output) {
-    fs26.mkdirSync(path30.dirname(path30.resolve(opts.output)), { recursive: true });
+    fs26.mkdirSync(path31.dirname(path31.resolve(opts.output)), { recursive: true });
     fs26.copyFileSync(dest, opts.output);
     logger.success(`Copied to ${opts.output}`);
   }
@@ -4099,7 +4238,7 @@ function registerCheckCommand(program2) {
 // src/commands/doc/convert.ts
 init_errors();
 import fs27 from "fs";
-import path31 from "path";
+import path32 from "path";
 
 // src/commands/doc/default-prompt.ts
 var DEFAULT_CONVERT_PROMPT = `Convert this document to clean, well-formatted Markdown.
@@ -4124,14 +4263,14 @@ async function convertDocuments(opts) {
   }
   let outputPath;
   if (output) {
-    outputPath = path31.resolve(output);
+    outputPath = path32.resolve(output);
   } else if (autoName && inputs.length === 1 && inputs[0]) {
-    const base = path31.basename(inputs[0], path31.extname(inputs[0]));
-    outputPath = path31.join(getOutputDir(), `${base}-extraction.md`);
+    const base = path32.basename(inputs[0], path32.extname(inputs[0]));
+    outputPath = path32.join(getOutputDir(), `${base}-extraction.md`);
   } else {
-    outputPath = path31.join(getOutputDir(), "document-extraction.md");
+    outputPath = path32.join(getOutputDir(), "document-extraction.md");
   }
-  fs27.mkdirSync(path31.dirname(outputPath), { recursive: true });
+  fs27.mkdirSync(path32.dirname(outputPath), { recursive: true });
   const results = [];
   for (let i = 0; i < inputs.length; i++) {
     const filePath = inputs[i];
@@ -4182,7 +4321,7 @@ async function convertDocuments(opts) {
 `);
   for (const r of results) {
     lines.push(`
-## ${path31.basename(r.file)}
+## ${path32.basename(r.file)}
 `);
     if (r.status === "success" && r.markdown) {
       lines.push(`${r.markdown}
@@ -4242,11 +4381,11 @@ function registerDocCommands(program2) {
 // src/commands/media/index.ts
 init_errors();
 import fs30 from "fs";
-import path34 from "path";
+import path35 from "path";
 
 // src/commands/media/batch.ts
 import fs28 from "fs";
-import path32 from "path";
+import path33 from "path";
 
 // src/commands/media/detect-type.ts
 var VIDEO_EXTS = /* @__PURE__ */ new Set([".mp4", ".mov", ".avi", ".mkv", ".webm", ".flv", ".mpg", ".mpeg"]);
@@ -4445,7 +4584,7 @@ async function batchOptimize(opts) {
   fs28.mkdirSync(outputDir, { recursive: true });
   const entries = fs28.readdirSync(inputDir);
   const mediaFiles = entries.filter((f) => {
-    const ext = path32.extname(f).toLowerCase();
+    const ext = path33.extname(f).toLowerCase();
     return ALL_EXTS.has(ext);
   });
   if (mediaFiles.length === 0) {
@@ -4456,9 +4595,9 @@ async function batchOptimize(opts) {
   let succeeded = 0;
   const errors = [];
   for (const file of mediaFiles) {
-    const inputPath = path32.join(inputDir, file);
-    const outputPath = path32.join(outputDir, file);
-    const ext = path32.extname(file).toLowerCase();
+    const inputPath = path33.join(inputDir, file);
+    const outputPath = path33.join(outputDir, file);
+    const ext = path33.extname(file).toLowerCase();
     const kind = extToKind(ext);
     logger?.debug(`Processing: ${file}`);
     try {
@@ -4496,7 +4635,7 @@ async function batchOptimize(opts) {
 // src/commands/media/split-video.ts
 init_errors();
 import fs29 from "fs";
-import path33 from "path";
+import path34 from "path";
 async function splitVideo(opts) {
   await assertFfmpeg();
   const { input, outputDir, chunkDuration = 3600, verbose, logger } = opts;
@@ -4508,9 +4647,9 @@ async function splitVideo(opts) {
     return [input];
   }
   fs29.mkdirSync(outputDir, { recursive: true });
-  const ext = path33.extname(input) || ".mp4";
-  const baseName = path33.basename(input, ext);
-  const outputPattern = path33.join(outputDir, `${baseName}_chunk_%03d${ext}`);
+  const ext = path34.extname(input) || ".mp4";
+  const baseName = path34.basename(input, ext);
+  const outputPattern = path34.join(outputDir, `${baseName}_chunk_%03d${ext}`);
   logger?.debug(`Splitting into ~${numChunks} chunks of ${chunkDuration}s each`);
   const args = [
     "-i",
@@ -4529,7 +4668,7 @@ async function splitVideo(opts) {
   await runFfmpeg(args, { verbose, logger });
   const files = [];
   for (let i = 0; i < numChunks + 1; i++) {
-    const fname = path33.join(outputDir, `${baseName}_chunk_${String(i).padStart(3, "0")}${ext}`);
+    const fname = path34.join(outputDir, `${baseName}_chunk_${String(i).padStart(3, "0")}${ext}`);
     if (fs29.existsSync(fname)) files.push(fname);
   }
   logger?.success(`Created ${files.length} chunks in ${outputDir}`);
@@ -4545,8 +4684,8 @@ function registerMediaCommands(program2) {
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       if (!fs30.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
-      fs30.mkdirSync(path34.dirname(path34.resolve(opts.output)), { recursive: true });
-      const ext = path34.extname(opts.input).toLowerCase();
+      fs30.mkdirSync(path35.dirname(path35.resolve(opts.output)), { recursive: true });
+      const ext = path35.extname(opts.input).toLowerCase();
       const kind = extToKind(ext);
       if (!kind) throw new ValidationError(`Unsupported file type: ${ext}`);
       const quality = Number.parseInt(opts.quality, 10);