@mrgoonie/multix 0.5.1 → 0.6.0

package/dist/cli.js

@@ -414,9 +414,9 @@ var BytePlusClient = class {
   }
   apiKey;
   baseUrl;
-  async request(path46, opts = {}) {
+  async request(path47, opts = {}) {
     const base = this.baseUrl.replace(/\/$/, "");
-    const url = new URL(base + path46);
+    const url = new URL(base + path47);
     if (opts.query) {
       for (const [k, v] of Object.entries(opts.query)) {
         if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
@@ -434,14 +434,14 @@ var BytePlusClient = class {
       timeoutMs: opts.timeoutMs ?? 12e4
     });
   }
-  get(path46, query, logger) {
-    return this.request(path46, { method: "GET", query, logger });
+  get(path47, query, logger) {
+    return this.request(path47, { method: "GET", query, logger });
   }
-  post(path46, body, logger) {
-    return this.request(path46, { method: "POST", body, logger });
+  post(path47, body, logger) {
+    return this.request(path47, { method: "POST", body, logger });
   }
-  delete(path46, logger) {
-    return this.request(path46, { method: "DELETE", logger });
+  delete(path47, logger) {
+    return this.request(path47, { method: "DELETE", logger });
   }
 };
 function createBytePlusClient() {
@@ -569,10 +569,197 @@ Task: ${taskId}`);
   );
 }
 
+// src/core/image-webp-finalize.ts
+init_errors();
+import { spawnSync } from "child_process";
+import fs6 from "fs";
+import path6 from "path";
+import { Option } from "commander";
+
+// src/core/image-header.ts
+import fs5 from "fs";
+function sniffImageKind(buf) {
+  if (buf.length >= 8 && buf.readUInt32BE(0) === 2303741511) return "png";
+  if (buf.length >= 3 && buf[0] === 255 && buf[1] === 216 && buf[2] === 255) return "jpeg";
+  if (buf.length >= 12 && buf.toString("ascii", 0, 4) === "RIFF" && buf.toString("ascii", 8, 12) === "WEBP")
+    return "webp";
+  return void 0;
+}
+function readPng(buf) {
+  if (buf.length < 33) return void 0;
+  const width = buf.readUInt32BE(16);
+  const height = buf.readUInt32BE(20);
+  const colorType = buf[25];
+  let hasAlpha = colorType === 4 || colorType === 6;
+  let offset = 8;
+  while (!hasAlpha && offset + 8 <= buf.length) {
+    const len = buf.readUInt32BE(offset);
+    const type = buf.toString("ascii", offset + 4, offset + 8);
+    if (type === "tRNS") hasAlpha = true;
+    if (type === "IDAT" || type === "IEND") break;
+    offset += 12 + len;
+  }
+  return { kind: "png", width, height, hasAlpha };
+}
+function readJpeg(buf) {
+  let offset = 2;
+  while (offset + 9 < buf.length) {
+    if (buf[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = buf[offset + 1] ?? 0;
+    if (marker >= 192 && marker <= 207 && ![196, 200, 204].includes(marker)) {
+      return {
+        kind: "jpeg",
+        height: buf.readUInt16BE(offset + 5),
+        width: buf.readUInt16BE(offset + 7),
+        hasAlpha: false
+      };
+    }
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    offset += 2 + buf.readUInt16BE(offset + 2);
+  }
+  return void 0;
+}
+function readWebp(buf) {
+  if (buf.length < 30) return void 0;
+  const chunk = buf.toString("ascii", 12, 16);
+  if (chunk === "VP8X") {
+    const flags = buf[20] ?? 0;
+    return {
+      kind: "webp",
+      width: 1 + buf.readUIntLE(24, 3),
+      height: 1 + buf.readUIntLE(27, 3),
+      hasAlpha: (flags & 16) !== 0
+    };
+  }
+  if (chunk === "VP8L") {
+    const bits = buf.readUInt32LE(21);
+    return {
+      kind: "webp",
+      width: 1 + (bits & 16383),
+      height: 1 + (bits >>> 14 & 16383),
+      hasAlpha: (bits >>> 28 & 1) === 1
+    };
+  }
+  if (chunk === "VP8 ") {
+    return {
+      kind: "webp",
+      width: buf.readUInt16LE(26) & 16383,
+      height: buf.readUInt16LE(28) & 16383,
+      hasAlpha: false
+    };
+  }
+  return void 0;
+}
+function readImageHeader(buf) {
+  const kind = sniffImageKind(buf);
+  if (kind === "png") return readPng(buf);
+  if (kind === "jpeg") return readJpeg(buf);
+  if (kind === "webp") return readWebp(buf);
+  return void 0;
+}
+function readImageHeaderFromFile(file) {
+  return readImageHeader(fs5.readFileSync(file));
+}
+
+// src/core/image-webp-finalize.ts
+var CWEBP_ARGS = ["-q", "85", "-m", "6", "-metadata", "none"];
+var IMAGE_EXTS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp", ".tif", ".tiff"]);
+function imageFormatOption() {
+  return new Option(
+    "--image-format <mode>",
+    "Final image format: webp (default, cwebp -q 85) | original (keep provider format/quality)"
+  );
+}
+function noWebpOption() {
+  return new Option("--no-webp", "Keep the provider's original image format and quality");
+}
+function resolveImageFormatMode(opts, explicitProviderFormat = false) {
+  if (opts.webp === false && opts.imageFormat === void 0) return "original";
+  const raw = opts.imageFormat ?? process.env.MULTIX_IMAGE_FORMAT;
+  if (raw !== void 0 && raw !== "") {
+    const mode = raw.toLowerCase();
+    if (mode !== "webp" && mode !== "original") {
+      throw new ValidationError(`Invalid --image-format: ${raw}. Valid: webp, original`);
+    }
+    return mode;
+  }
+  if (explicitProviderFormat) return "original";
+  const ext = opts.output ? path6.extname(opts.output).toLowerCase() : "";
+  if (ext && ext !== ".webp" && IMAGE_EXTS.has(ext)) return "original";
+  return "webp";
+}
+function hasCwebp() {
+  const res = spawnSync("cwebp", ["-version"], { stdio: "ignore" });
+  return !res.error && res.status === 0;
+}
+function webpTarget(file) {
+  const ext = path6.extname(file);
+  return ext.toLowerCase() === ".webp" ? file : `${file.slice(0, -ext.length || void 0)}.webp`;
+}
+function convertToWebp(file, logger, keepPath = false) {
+  const src = readImageHeaderFromFile(file);
+  if (!src) {
+    logger?.warn(`Skipping WebP conversion (unrecognized image): ${file}`);
+    return file;
+  }
+  if (src.kind === "webp") {
+    const target2 = keepPath ? file : webpTarget(file);
+    if (target2 !== file) fs6.renameSync(file, target2);
+    return target2;
+  }
+  const target = keepPath ? file : webpTarget(file);
+  const tmp = `${target}.tmp-${process.pid}.webp`;
+  const res = spawnSync("cwebp", [...CWEBP_ARGS, file, "-o", tmp], { encoding: "utf8" });
+  if (res.error || res.status !== 0) {
+    fs6.rmSync(tmp, { force: true });
+    logger?.warn(`cwebp failed, keeping original ${file}: ${res.stderr || res.error?.message}`);
+    return file;
+  }
+  const out = fs6.existsSync(tmp) ? readImageHeaderFromFile(tmp) : void 0;
+  const problem = !out ? "output is not a valid WebP" : out.width !== src.width || out.height !== src.height ? `size changed ${src.width}x${src.height} -> ${out.width}x${out.height}` : src.hasAlpha && !out.hasAlpha ? "transparency lost" : void 0;
+  if (problem) {
+    fs6.rmSync(tmp, { force: true });
+    logger?.warn(`WebP verification failed (${problem}), keeping original ${file}`);
+    return file;
+  }
+  if (target !== file) fs6.rmSync(file, { force: true });
+  fs6.renameSync(tmp, target);
+  logger?.debug(`WebP verified ${out?.width}x${out?.height} alpha=${out?.hasAlpha}: ${target}`);
+  return target;
+}
+function finalizeGeneratedImages(files, opts) {
+  const mode = resolveImageFormatMode(opts, opts.explicitProviderFormat);
+  if (mode === "original" || files.length === 0) return files;
+  if (!hasCwebp()) {
+    opts.logger?.warn(
+      "cwebp not found on PATH; keeping original image format (install libwebp, or pass --image-format original)"
+    );
+    return files;
+  }
+  const outputAbs = opts.output ? path6.resolve(opts.output) : void 0;
+  const wroteOutputDirectly = outputAbs !== void 0 && files.some((f) => path6.resolve(f) === outputAbs);
+  const finals = files.map(
+    (f) => convertToWebp(f, opts.logger, outputAbs !== void 0 && path6.resolve(f) === outputAbs)
+  );
+  if (opts.output && outputAbs && !wroteOutputDirectly && finals[0] && fs6.existsSync(outputAbs)) {
+    const outExt = path6.extname(outputAbs).toLowerCase();
+    if ((outExt === ".webp" || outExt === "") && path6.extname(finals[0]).toLowerCase() === ".webp") {
+      fs6.copyFileSync(finals[0], outputAbs);
+    }
+  }
+  return finals;
+}
+
 // src/providers/byteplus/generators/image.ts
 init_http_client();
-import fs5 from "fs";
-import path6 from "path";
+import fs7 from "fs";
+import path7 from "path";
 var ASPECT_TO_SIZE = {
   "1:1": "2048x2048",
   "16:9": "2560x1440",
@@ -636,14 +823,14 @@ async function generateSeedream(client, opts) {
     }
     const ext = (() => {
       try {
-        const e = path6.extname(new URL(url).pathname);
+        const e = path7.extname(new URL(url).pathname);
         return e || ".jpg";
       } catch {
         return ".jpg";
       }
     })();
-    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 });
+    const filename = opts.output && items.length === 1 ? path7.resolve(opts.output) : path7.join(outDir, `byteplus-image-${ts}-${i + 1}${ext}`);
+    fs7.mkdirSync(path7.dirname(filename), { recursive: true });
     await downloadFile(url, filename);
     saved.push({ path: filename, url, seed: item.seed });
     logger?.success(`Saved ${filename}`);
@@ -658,7 +845,7 @@ function registerBytePlusGenerateCommand(parent) {
     "Reference image (URL or local path); repeatable",
     collect,
     []
-  ).option("--output <path>", "Save single image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).option("--output <path>", "Save single image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const client = createBytePlusClient();
@@ -674,9 +861,13 @@ function registerBytePlusGenerateCommand(parent) {
         output: opts.output,
         logger
       });
+      const finalImages = finalizeGeneratedImages(
+        saved.map((f) => f.path),
+        { ...opts, logger }
+      );
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f.path}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
@@ -693,7 +884,7 @@ function registerBytePlusImageToImageCommand(parent) {
     "Reference image (URL or local path); repeatable for multi-ref",
     collect2,
     []
-  ).option("-m, --model <id>", "Model id (default seedream-4-0-250828)").option("--size <size>", "Image size (e.g. 1024x1024, 1K, 2K, 4K)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9, 9:16); maps to size").option("-n, --num-images <n>", "Number of images", "1").option("--seed <n>", "Fixed seed").option("--no-watermark", "Disable watermark").option("--output <path>", "Save single image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).option("-m, --model <id>", "Model id (default seedream-4-0-250828)").option("--size <size>", "Image size (e.g. 1024x1024, 1K, 2K, 4K)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9, 9:16); maps to size").option("-n, --num-images <n>", "Number of images", "1").option("--seed <n>", "Fixed seed").option("--no-watermark", "Disable watermark").option("--output <path>", "Save single image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       if (!opts.ref || opts.ref.length === 0) {
         throw new Error("At least one --ref is required for image-to-image.");
@@ -712,9 +903,13 @@ function registerBytePlusImageToImageCommand(parent) {
         output: opts.output,
         logger
       });
+      const finalImages = finalizeGeneratedImages(
+        saved.map((f) => f.path),
+        { ...opts, logger }
+      );
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f.path}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
@@ -723,12 +918,12 @@ function collect2(value, prev) {
 }
 
 // src/providers/byteplus/commands/image-to-video.ts
-import path8 from "path";
+import path9 from "path";
 
 // src/core/video-thumb.ts
 init_http_client();
-import fs6 from "fs";
-import path7 from "path";
+import fs8 from "fs";
+import path8 from "path";
 var THUMB_KEYS = /* @__PURE__ */ new Set([
   "cover_image_url",
   "coverImageUrl",
@@ -778,9 +973,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 = path7.dirname(videoPath);
-  const base = path7.basename(videoPath, path7.extname(videoPath));
-  const dest = path7.join(dir, `${base}_thumb.${ext}`);
+  const dir = path8.dirname(videoPath);
+  const base = path8.basename(videoPath, path8.extname(videoPath));
+  const dest = path8.join(dir, `${base}_thumb.${ext}`);
   try {
     await downloadFile(thumbUrl, dest);
     logger?.success(`Saved thumb ${dest}`);
@@ -799,12 +994,12 @@ async function maybeDownloadThumb(source, videoPath, opts = {}) {
   }
   const saved = await downloadThumbBeside(url, videoPath, opts.logger);
   if (saved && opts.copyTo) {
-    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);
+    const copyExt = path8.extname(saved);
+    const copyBase = path8.basename(opts.copyTo, path8.extname(opts.copyTo));
+    const copyDir = path8.dirname(path8.resolve(opts.copyTo));
+    const copyDest = path8.join(copyDir, `${copyBase}_thumb${copyExt}`);
+    fs8.mkdirSync(copyDir, { recursive: true });
+    fs8.copyFileSync(saved, copyDest);
     opts.logger?.success(`Copied thumb to ${copyDest}`);
   }
   return saved;
@@ -932,7 +1127,7 @@ function registerBytePlusImageToVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path8.join(getOutputDir(), `byteplus-i2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path9.join(getOutputDir(), `byteplus-i2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -958,7 +1153,7 @@ Task: ${taskId}`);
 }
 
 // src/providers/byteplus/commands/reference-to-video.ts
-import path9 from "path";
+import path10 from "path";
 
 // src/providers/byteplus/reference-input.ts
 var MAX_TOTAL_REFS = 12;
@@ -990,10 +1185,10 @@ function toRef(kind, resolved, role) {
   return { kind, url: resolved.dataUrl, mime: resolved.mime, role };
 }
 async function resolveRefSpec(kind, spec, logger) {
-  const { path: path46, role } = parseRefSpec(spec);
-  if (kind === "image") return toRef(kind, await resolveImageInput(path46, logger), role);
-  if (kind === "video") return toRef(kind, await resolveVideoInput(path46, logger), role);
-  return toRef(kind, await resolveAudioInput(path46, logger), role);
+  const { path: path47, role } = parseRefSpec(spec);
+  if (kind === "image") return toRef(kind, await resolveImageInput(path47, logger), role);
+  if (kind === "video") return toRef(kind, await resolveVideoInput(path47, logger), role);
+  return toRef(kind, await resolveAudioInput(path47, logger), role);
 }
 async function resolveRefSpecs(specs, logger) {
   const out = [];
@@ -1090,7 +1285,7 @@ function registerBytePlusReferenceToVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path9.join(getOutputDir(), `byteplus-r2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path10.join(getOutputDir(), `byteplus-r2v-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -1116,7 +1311,7 @@ Task: ${taskId}`);
 }
 
 // src/providers/byteplus/commands/status.ts
-import path10 from "path";
+import path11 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) => {
@@ -1134,7 +1329,7 @@ function registerBytePlusStatusCommand(parent) {
           const videoUrl2 = content?.video_url;
           const fileUrl = content?.file_url;
           if (videoUrl2) {
-            const outPath = opts.output ?? path10.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}.mp4`);
+            const outPath = opts.output ?? path11.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}.mp4`);
             await downloadVideo(videoUrl2, outPath, logger);
             await maybeDownloadThumb(status, outPath, {
               skip: opts.thumb === false,
@@ -1144,7 +1339,7 @@ function registerBytePlusStatusCommand(parent) {
             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}`);
+            const outPath = opts.output ?? path11.join(getOutputDir(), `byteplus-3d-${taskId.slice(0, 8)}.${ext}`);
             await downloadModelFile(fileUrl, outPath, logger);
             console.log(`Saved: ${outPath}`);
           } else {
@@ -1168,7 +1363,7 @@ function registerBytePlusStatusCommand(parent) {
 }
 
 // src/providers/byteplus/commands/video.ts
-import path11 from "path";
+import path12 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>",
@@ -1210,7 +1405,7 @@ function registerBytePlusVideoCommand(parent) {
           logger.error(`Task succeeded but no video_url in response: ${JSON.stringify(final)}`);
           process.exit(1);
         }
-        const outPath = opts.output ?? path11.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
+        const outPath = opts.output ?? path12.join(getOutputDir(), `byteplus-video-${taskId.slice(0, 8)}-${Date.now()}.mp4`);
         await downloadVideo(url, outPath, logger);
         await maybeDownloadThumb(final, outPath, {
           skip: opts.thumb === false,
@@ -1428,15 +1623,15 @@ async function downloadVideo2(url) {
 
 // src/providers/cloudflare/media-output.ts
 init_errors();
-import fs7 from "fs";
-import path12 from "path";
+import fs9 from "fs";
+import path13 from "path";
 function destination(filename, output) {
-  return output ? path12.resolve(output) : path12.join(getOutputDir(), filename);
+  return output ? path13.resolve(output) : path13.join(getOutputDir(), filename);
 }
 function saveBytes(bytes, filename, output) {
   const dest = destination(filename, output);
-  fs7.mkdirSync(path12.dirname(dest), { recursive: true });
-  fs7.writeFileSync(dest, bytes);
+  fs9.mkdirSync(path13.dirname(dest), { recursive: true });
+  fs9.writeFileSync(dest, bytes);
   return dest;
 }
 function saveBase64Image(image, output) {
@@ -1553,7 +1748,7 @@ function registerCloudflareVideoCommand(parent) {
 // src/providers/cloudflare/commands/generate.ts
 init_errors();
 function registerCloudflareGenerateCommand(parent) {
-  parent.command("generate").description("Generate an image with Cloudflare Workers AI FLUX.1 Schnell").requiredOption("--prompt <text>", "Image prompt").option("--model <id>", "Cloudflare image model").option("--steps <n>", "Inference steps (1-8)", "4").option("--seed <n>", "Optional non-negative integer seed").option("--output <path>", "Save image at this path").option("-v, --verbose", "Verbose logging").action(
+  parent.command("generate").description("Generate an image with Cloudflare Workers AI FLUX.1 Schnell").requiredOption("--prompt <text>", "Image prompt").option("--model <id>", "Cloudflare image model").option("--steps <n>", "Inference steps (1-8)", "4").option("--seed <n>", "Optional non-negative integer seed").option("--output <path>", "Save image at this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       if (!opts.prompt.trim()) throw new ValidationError("--prompt must not be empty");
       const logger = createLogger({ verbose: opts.verbose ?? false });
@@ -1575,8 +1770,9 @@ function registerCloudflareGenerateCommand(parent) {
       if (typeof result.image !== "string") {
         throw new ProviderError("Cloudflare returned no image result", "Cloudflare");
       }
-      const destination2 = saveBase64Image(result.image, opts.output);
-      logger.success(`Saved ${destination2}`);
+      const saved = saveBase64Image(result.image, opts.output);
+      logger.success(`Saved ${saved}`);
+      const [destination2] = finalizeGeneratedImages([saved], { ...opts, logger });
       console.log(destination2);
     }
   );
@@ -1618,8 +1814,8 @@ function registerCloudflareCommands(program2) {
 }
 
 // src/providers/elevenlabs/client.ts
-import fs8 from "fs";
-import path13 from "path";
+import fs10 from "fs";
+import path14 from "path";
 init_errors();
 init_http_client();
 
@@ -1781,10 +1977,10 @@ async function apiPostMultipart(endpoint2, form, apiKey, opts = {}) {
   return res.json();
 }
 function readFileAsBlob(filePath, fieldFilename) {
-  const abs = path13.resolve(filePath);
-  if (!fs8.existsSync(abs)) throw new ValidationError(`File not found: ${abs}`);
-  const buf = fs8.readFileSync(abs);
-  const name = fieldFilename ?? path13.basename(abs);
+  const abs = path14.resolve(filePath);
+  if (!fs10.existsSync(abs)) throw new ValidationError(`File not found: ${abs}`);
+  const buf = fs10.readFileSync(abs);
+  const name = fieldFilename ?? path14.basename(abs);
   return new File([new Uint8Array(buf)], name);
 }
 async function pollUntil(fetchStatus, isDone, isFailed, opts = {}) {
@@ -1808,12 +2004,12 @@ async function pollUntil(fetchStatus, isDone, isFailed, opts = {}) {
 function saveBytes2(opts) {
   const { bytes, task, ext, outputCopy, logger } = opts;
   const dir = getOutputDir();
-  const dest = path13.join(dir, `elevenlabs_${task}_${Date.now()}.${ext}`);
-  fs8.writeFileSync(dest, bytes);
+  const dest = path14.join(dir, `elevenlabs_${task}_${Date.now()}.${ext}`);
+  fs10.writeFileSync(dest, bytes);
   logger?.success(`Saved: ${dest} (${(bytes.length / 1024).toFixed(1)} KB)`);
   if (outputCopy) {
-    fs8.mkdirSync(path13.dirname(path13.resolve(outputCopy)), { recursive: true });
-    fs8.copyFileSync(dest, outputCopy);
+    fs10.mkdirSync(path14.dirname(path14.resolve(outputCopy)), { recursive: true });
+    fs10.copyFileSync(dest, outputCopy);
   }
   return dest;
 }
@@ -1852,14 +2048,14 @@ ${models.length} models`);
 }
 
 // src/providers/elevenlabs/commands/align.ts
-import fs9 from "fs";
-import path14 from "path";
+import fs11 from "fs";
+import path15 from "path";
 function registerAlignCommand(parent) {
   parent.command("align").description("Forced alignment of audio to a transcript (returns word/char timestamps)").requiredOption("--input <path>", "Source audio file").requiredOption("--text <str>", "Transcript text (or pass --text-file)").option("--text-file <path>", "Read transcript from file").option("--output <path>", "Save JSON to this path (default: multix-output)").option("-v, --verbose", "Verbose logging").action(async (opts) => {
     const logger = createLogger({ verbose: opts.verbose ?? false });
     const apiKey = requireElevenLabsKey();
     let text = opts.text;
-    if (opts.textFile) text = fs9.readFileSync(path14.resolve(opts.textFile), "utf8");
+    if (opts.textFile) text = fs11.readFileSync(path15.resolve(opts.textFile), "utf8");
     const form = new FormData();
     form.append("file", readFileAsBlob(opts.input));
     form.append("text", text);
@@ -1867,9 +2063,9 @@ function registerAlignCommand(parent) {
     const data = await apiPostMultipart("forced-alignment", form, apiKey, {
       timeoutMs: 6e5
     });
-    const dest = opts.output ? path14.resolve(opts.output) : path14.join(getOutputDir(), `elevenlabs_align_${Date.now()}.json`);
-    fs9.mkdirSync(path14.dirname(dest), { recursive: true });
-    fs9.writeFileSync(dest, JSON.stringify(data, null, 2));
+    const dest = opts.output ? path15.resolve(opts.output) : path15.join(getOutputDir(), `elevenlabs_align_${Date.now()}.json`);
+    fs11.mkdirSync(path15.dirname(dest), { recursive: true });
+    fs11.writeFileSync(dest, JSON.stringify(data, null, 2));
     logger.success(`Saved alignment: ${dest}`);
     if (data.words) console.log(`Aligned ${data.words.length} words (loss=${data.loss ?? "?"})`);
   });
@@ -1912,8 +2108,8 @@ function registerCloneCommand(parent) {
 // src/providers/elevenlabs/commands/dub.ts
 init_errors();
 init_http_client();
-import fs10 from "fs";
-import path15 from "path";
+import fs12 from "fs";
+import path16 from "path";
 function registerDubCommand(parent) {
   parent.command("dub").description("Dub a video/audio file into target languages (async)").option("--input <path>", "Source media file (use --input or --source-url)").option("--source-url <url>", "Public URL of source media").requiredOption("--target-lang <code>", "Target language ISO code (e.g. es, fr, de)").option("--source-lang <code>", "Source language (auto if omitted)").option("--num-speakers <n>", "Speaker count (auto if omitted)").option("--watermark", "Add ElevenLabs watermark", false).option("--start-time <s>", "Start time in seconds").option("--end-time <s>", "End time in seconds").option("--highest-resolution", "Use highest resolution video", false).option("--name <n>", "Project display name").option("--async", "Return job id immediately, do not wait", false).option("--wait", "Wait until status=dubbed (implied by --download)", false).option("--download", "Download dubbed media when ready", false).option("--poll-interval <s>", "Poll interval seconds", "10").option("--wait-timeout <ms>", "Poll timeout", "1800000").option("--output <path>", "Output path for downloaded dub").option("-v, --verbose", "Verbose logging").action(async (opts) => {
     const logger = createLogger({ verbose: opts.verbose ?? false });
@@ -1956,7 +2152,7 @@ function registerDubCommand(parent) {
     );
     logger.success(`Dub complete: ${start.dubbing_id}`);
     if (opts.download) {
-      const dest = opts.output ? path15.resolve(opts.output) : path15.join(getOutputDir(), `elevenlabs_dub_${start.dubbing_id}_${opts.targetLang}.mp4`);
+      const dest = opts.output ? path16.resolve(opts.output) : path16.join(getOutputDir(), `elevenlabs_dub_${start.dubbing_id}_${opts.targetLang}.mp4`);
       const url = `${ELEVENLABS_BASE_URL}/dubbing/${start.dubbing_id}/audio/${opts.targetLang}`;
       await downloadDub(url, apiKey, dest);
       logger.success(`Saved: ${dest}`);
@@ -1971,7 +2167,7 @@ Dubbed file: ${dest}`);
     const status = await apiGet(`dubbing/${dubbingId}`, apiKey);
     console.log(JSON.stringify(status, null, 2));
     if (opts.download) {
-      const dest = opts.output ? path15.resolve(opts.output) : path15.join(getOutputDir(), `elevenlabs_dub_${dubbingId}_${opts.download}.mp4`);
+      const dest = opts.output ? path16.resolve(opts.output) : path16.join(getOutputDir(), `elevenlabs_dub_${dubbingId}_${opts.download}.mp4`);
       const url = `${ELEVENLABS_BASE_URL}/dubbing/${dubbingId}/audio/${opts.download}`;
       await downloadDub(url, apiKey, dest);
       console.log(`Saved: ${dest}`);
@@ -1979,7 +2175,7 @@ Dubbed file: ${dest}`);
   });
 }
 async function downloadDub(url, apiKey, dest) {
-  fs10.mkdirSync(path15.dirname(dest), { recursive: true });
+  fs12.mkdirSync(path16.dirname(dest), { recursive: true });
   const res = await globalThis.fetch(url, {
     headers: { "xi-api-key": apiKey },
     signal: AbortSignal.timeout(6e5)
@@ -1988,7 +2184,7 @@ async function downloadDub(url, apiKey, dest) {
     throw new Error(`Failed to download dub: HTTP ${res.status}`);
   }
   const arr = new Uint8Array(await res.arrayBuffer());
-  fs10.writeFileSync(dest, arr);
+  fs12.writeFileSync(dest, arr);
   void downloadFile;
 }
 
@@ -2017,8 +2213,8 @@ Isolated audio: ${dest}`);
 
 // src/providers/elevenlabs/commands/music.ts
 init_errors();
-import fs11 from "fs";
-import path16 from "path";
+import fs13 from "fs";
+import path17 from "path";
 function registerMusicCommand(parent) {
   parent.command("music").description("Generate music from a text prompt or composition plan").option("--prompt <str>", "Music prompt (mutually exclusive with --plan)").option("--plan <path>", "Path to composition plan JSON file").option("--music-length-ms <n>", "Total length in milliseconds (default 30000)").option("--model <id>", "Music model", "music_v1").option(
     "--format <fmt>",
@@ -2033,9 +2229,9 @@ function registerMusicCommand(parent) {
     const payload = { model_id: opts.model };
     if (opts.prompt) payload.prompt = opts.prompt;
     if (opts.plan) {
-      const planPath = path16.resolve(opts.plan);
-      if (!fs11.existsSync(planPath)) throw new ValidationError(`Plan file not found: ${planPath}`);
-      const planJson = JSON.parse(fs11.readFileSync(planPath, "utf8"));
+      const planPath = path17.resolve(opts.plan);
+      if (!fs13.existsSync(planPath)) throw new ValidationError(`Plan file not found: ${planPath}`);
+      const planJson = JSON.parse(fs13.readFileSync(planPath, "utf8"));
       payload.composition_plan = planJson;
     }
     if (opts.musicLengthMs) payload.music_length_ms = Number.parseInt(opts.musicLengthMs, 10);
@@ -2094,8 +2290,8 @@ Generated SFX: ${dest}`);
 }
 
 // src/providers/elevenlabs/commands/transcribe.ts
-import fs12 from "fs";
-import path17 from "path";
+import fs14 from "fs";
+import path18 from "path";
 function registerTranscribeCommand(parent) {
   parent.command("transcribe").description("Speech-to-text transcription with Scribe").requiredOption("--input <path>", "Audio or video file to transcribe").option(
     "--model <id>",
@@ -2118,7 +2314,7 @@ function registerTranscribeCommand(parent) {
     });
     const ext = opts.format === "json" ? "json" : opts.format === "srt" ? "srt" : opts.format === "vtt" ? "vtt" : "txt";
     const dir = getOutputDir();
-    const dest = opts.output ? path17.resolve(opts.output) : path17.join(dir, `elevenlabs_transcribe_${Date.now()}.${ext}`);
+    const dest = opts.output ? path18.resolve(opts.output) : path18.join(dir, `elevenlabs_transcribe_${Date.now()}.${ext}`);
     let body;
     switch (opts.format) {
       case "json":
@@ -2133,8 +2329,8 @@ function registerTranscribeCommand(parent) {
       default:
         body = data.text ?? "";
     }
-    fs12.mkdirSync(path17.dirname(dest), { recursive: true });
-    fs12.writeFileSync(dest, body);
+    fs14.mkdirSync(path18.dirname(dest), { recursive: true });
+    fs14.writeFileSync(dest, body);
     logger.success(`Saved transcript: ${dest}`);
     if (data.language_code) {
       logger.info(
@@ -2381,16 +2577,16 @@ function registerElevenLabsCommands(program2) {
 
 // src/providers/gemini/commands/analyze.ts
 init_errors();
-import fs15 from "fs";
+import fs17 from "fs";
 
 // src/providers/gemini/client.ts
-import fs13 from "fs";
-import path19 from "path";
+import fs15 from "fs";
+import path20 from "path";
 init_errors();
 init_http_client();
 
 // src/providers/gemini/task-resolver.ts
-import path18 from "path";
+import path19 from "path";
 var MIME_MAP = {
   // Audio
   ".mp3": "audio/mp3",
@@ -2431,7 +2627,7 @@ var MIME_MAP = {
   ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
 };
 function getMimeType(filePath) {
-  const ext = path18.extname(filePath).toLowerCase();
+  const ext = path19.extname(filePath).toLowerCase();
   return MIME_MAP[ext] ?? "application/octet-stream";
 }
 function requiresProcessingWait(mimeType) {
@@ -2457,8 +2653,8 @@ async function uploadFile(filePath, opts = {}) {
   const apiKey = requireApiKey();
   const { timeoutMs = 3e5, logger } = opts;
   const mimeType = getMimeType(filePath);
-  const fileBytes = fs13.readFileSync(filePath);
-  const displayName = path19.basename(filePath);
+  const fileBytes = fs15.readFileSync(filePath);
+  const displayName = path20.basename(filePath);
   const boundary = `multix_${Date.now()}`;
   const metaJson = JSON.stringify({ file: { displayName, mimeType } });
   const body = Buffer.concat([
@@ -2547,12 +2743,12 @@ function extractImages(resp) {
   ).map((p) => ({ mimeType: p.inlineData.mimeType, data: p.inlineData.data }));
 }
 function inlinePart(filePath) {
-  const data = fs13.readFileSync(filePath).toString("base64");
+  const data = fs15.readFileSync(filePath).toString("base64");
   const mimeType = getMimeType(filePath);
   return { inlineData: { mimeType, data } };
 }
 function shouldUseFileApi(filePath) {
-  const stat = fs13.statSync(filePath);
+  const stat = fs15.statSync(filePath);
   return stat.size > 20 * 1024 * 1024;
 }
 function sleep(ms) {
@@ -2606,13 +2802,13 @@ function getDefaultModel(task) {
 }
 
 // src/providers/gemini/result-formatter.ts
-import fs14 from "fs";
-import path20 from "path";
+import fs16 from "fs";
+import path21 from "path";
 function formatResults(results, format, outputPath) {
   const content = renderFormat(results, format);
   if (outputPath) {
-    fs14.mkdirSync(path20.dirname(path20.resolve(outputPath)), { recursive: true });
-    fs14.writeFileSync(outputPath, content, "utf8");
+    fs16.mkdirSync(path21.dirname(path21.resolve(outputPath)), { recursive: true });
+    fs16.writeFileSync(outputPath, content, "utf8");
   } else {
     process.stdout.write(content);
   }
@@ -2679,7 +2875,7 @@ function registerAnalyzeCommand(parent) {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const model = opts.model ?? getDefaultModel("analyze");
       for (const f of opts.files) {
-        if (!fs15.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
+        if (!fs17.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
       }
       const results = [];
       for (let i = 0; i < opts.files.length; i++) {
@@ -2725,14 +2921,14 @@ function registerAnalyzeCommand(parent) {
 
 // src/providers/gemini/commands/extract.ts
 init_errors();
-import fs16 from "fs";
+import fs18 from "fs";
 function registerExtractCommand(parent) {
   parent.command("extract").description("Extract structured information from files with Gemini").requiredOption("--files <paths...>", "Input file paths").requiredOption("--prompt <text>", "Extraction prompt (required)").option("--model <id>", "Gemini model to use").option("--format <fmt>", "Output format: text|json|csv|markdown", "text").option("--output <path>", "Write results to file").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const model = opts.model ?? getDefaultModel("extract");
       for (const f of opts.files) {
-        if (!fs16.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
+        if (!fs18.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
       }
       const generationConfig = opts.format === "json" ? { responseMimeType: "application/json" } : void 0;
       const results = [];
@@ -2774,8 +2970,8 @@ function registerExtractCommand(parent) {
 init_errors();
 
 // src/providers/gemini/generators/speech.ts
-import fs17 from "fs";
-import path21 from "path";
+import fs19 from "fs";
+import path22 from "path";
 
 // src/providers/gemini/voices.ts
 var GEMINI_TTS_VOICES = [
@@ -2858,12 +3054,12 @@ 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 = path21.join(outDir, `gemini_speech_${Date.now()}.${outputFormat}`);
-  fs17.writeFileSync(dest, outBytes);
+  const dest = path22.join(outDir, `gemini_speech_${Date.now()}.${outputFormat}`);
+  fs19.writeFileSync(dest, outBytes);
   logger?.success(`Saved: ${dest} (${(outBytes.length / 1024).toFixed(1)} KB)`);
   if (output) {
-    fs17.mkdirSync(path21.dirname(path21.resolve(output)), { recursive: true });
-    fs17.copyFileSync(dest, output);
+    fs19.mkdirSync(path22.dirname(path22.resolve(output)), { recursive: true });
+    fs19.copyFileSync(dest, output);
     logger?.success(`Copied to: ${output}`);
   }
   return { status: "success", generatedAudio: dest, model, mimeType: audio.mimeType };
@@ -2962,8 +3158,8 @@ function collectSpeakers(value, prev) {
 }
 
 // src/providers/gemini/commands/generate-video.ts
-import fs18 from "fs";
-import path22 from "path";
+import fs20 from "fs";
+import path23 from "path";
 init_errors();
 init_http_client();
 var BASE2 = "https://generativelanguage.googleapis.com";
@@ -2997,10 +3193,10 @@ function registerGenerateVideoCommand(parent) {
       const contentParts = [{ text: opts.prompt }];
       if (opts.referenceImages?.length) {
         for (const imgPath of opts.referenceImages.slice(0, 2)) {
-          if (!fs18.existsSync(imgPath))
+          if (!fs20.existsSync(imgPath))
             throw new ValidationError(`Reference image not found: ${imgPath}`);
-          const data = fs18.readFileSync(imgPath).toString("base64");
-          const ext = path22.extname(imgPath).toLowerCase();
+          const data = fs20.readFileSync(imgPath).toString("base64");
+          const ext = path23.extname(imgPath).toLowerCase();
           const mimeType = ext === ".png" ? "image/png" : "image/jpeg";
           contentParts.push({ inlineData: { mimeType, data } });
         }
@@ -3049,13 +3245,13 @@ function registerGenerateVideoCommand(parent) {
         );
       }
       const outDir = getOutputDir();
-      const dest = path22.join(outDir, `veo_generated_${Date.now()}.mp4`);
+      const dest = path23.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) {
-        fs18.mkdirSync(path22.dirname(path22.resolve(opts.output)), { recursive: true });
-        fs18.copyFileSync(dest, opts.output);
+        fs20.mkdirSync(path23.dirname(path23.resolve(opts.output)), { recursive: true });
+        fs20.copyFileSync(dest, opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
       await maybeDownloadThumb(finalOp.response, dest, {
@@ -3074,10 +3270,10 @@ function sleep2(ms) {
 
 // src/providers/gemini/commands/generate.ts
 init_errors();
-import fs19 from "fs";
-import path23 from "path";
+import fs21 from "fs";
+import path24 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(
+  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").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const model = opts.model ?? getDefaultModel("generate");
@@ -3117,8 +3313,8 @@ function registerGenerateCommand(parent) {
             const outDir = getOutputDir();
             const ext = img.mimeType.includes("png") ? "png" : "jpg";
             const fname = `gemini_generated_${Date.now()}_${i}.${ext}`;
-            const dest = path23.join(outDir, fname);
-            fs19.writeFileSync(dest, Buffer.from(img.data, "base64"));
+            const dest = path24.join(outDir, fname);
+            fs21.writeFileSync(dest, Buffer.from(img.data, "base64"));
             savedFiles.push(dest);
             logger.success(`Saved: ${dest}`);
           }
@@ -3133,20 +3329,21 @@ function registerGenerateCommand(parent) {
         process.exit(1);
       }
       if (opts.output && savedFiles[0]) {
-        fs19.mkdirSync(path23.dirname(path23.resolve(opts.output)), { recursive: true });
-        fs19.copyFileSync(savedFiles[0], opts.output);
+        fs21.mkdirSync(path24.dirname(path24.resolve(opts.output)), { recursive: true });
+        fs21.copyFileSync(savedFiles[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
+      const finalImages = finalizeGeneratedImages(savedFiles, { ...opts, logger });
       console.log(`
-Generated ${savedFiles.length} image(s):`);
-      for (const f of savedFiles) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
 
 // src/providers/gemini/commands/image-to-image.ts
-import fs20 from "fs";
-import path24 from "path";
+import fs22 from "fs";
+import path25 from "path";
 var SOFT_LIMIT_BYTES = 5 * 1024 * 1024;
 var HARD_LIMIT_BYTES = 7 * 1024 * 1024;
 function registerGeminiImageToImageCommand(parent) {
@@ -3157,7 +3354,7 @@ function registerGeminiImageToImageCommand(parent) {
     "Reference image (URL or local path); repeatable for multi-ref",
     collect4,
     []
-  ).option("-m, --model <id>", `Gemini image model (default ${IMAGE_MODEL_FALLBACK})`).option("--output <path>", "Save first generated image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).option("-m, --model <id>", `Gemini image model (default ${IMAGE_MODEL_FALLBACK})`).option("--output <path>", "Save first generated image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       if (!opts.ref || opts.ref.length === 0) {
         throw new Error("At least one --ref is required for image-to-image.");
@@ -3207,19 +3404,20 @@ function registerGeminiImageToImageCommand(parent) {
         const img = images[i];
         if (!img) continue;
         const ext = img.mimeType.includes("png") ? "png" : "jpg";
-        const dest = path24.join(outDir, `gemini-i2i-${ts}-${i + 1}.${ext}`);
-        fs20.writeFileSync(dest, Buffer.from(img.data, "base64"));
+        const dest = path25.join(outDir, `gemini-i2i-${ts}-${i + 1}.${ext}`);
+        fs22.writeFileSync(dest, Buffer.from(img.data, "base64"));
         saved.push(dest);
         logger.success(`Saved: ${dest}`);
       }
       if (opts.output && saved[0]) {
-        fs20.mkdirSync(path24.dirname(path24.resolve(opts.output)), { recursive: true });
-        fs20.copyFileSync(saved[0], opts.output);
+        fs22.mkdirSync(path25.dirname(path25.resolve(opts.output)), { recursive: true });
+        fs22.copyFileSync(saved[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
+      const finalImages = finalizeGeneratedImages(saved, { ...opts, logger });
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
@@ -3241,7 +3439,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 = path24.extname(new URL(url).pathname).toLowerCase();
+  const ext = path25.extname(new URL(url).pathname).toLowerCase();
   if (ext === ".png") return "image/png";
   if (ext === ".webp") return "image/webp";
   if (ext === ".gif") return "image/gif";
@@ -3249,17 +3447,17 @@ function sniffImageMime(buf, url) {
 }
 
 // src/providers/gemini/commands/image-to-video.ts
-import fs21 from "fs";
-import path25 from "path";
+import fs23 from "fs";
+import path26 from "path";
 init_errors();
 init_http_client();
 var BASE3 = "https://generativelanguage.googleapis.com";
 function imagePart(imgPath) {
-  if (!fs21.existsSync(imgPath)) {
+  if (!fs23.existsSync(imgPath)) {
     throw new ValidationError(`Image not found: ${imgPath}`);
   }
-  const data = fs21.readFileSync(imgPath).toString("base64");
-  const ext = path25.extname(imgPath).toLowerCase();
+  const data = fs23.readFileSync(imgPath).toString("base64");
+  const ext = path26.extname(imgPath).toLowerCase();
   const mimeType = ext === ".png" ? "image/png" : "image/jpeg";
   return { inlineData: { mimeType, data } };
 }
@@ -3332,12 +3530,12 @@ function registerGeminiImageToVideoCommand(parent) {
           "gemini"
         );
       }
-      const dest = path25.join(getOutputDir(), `veo_i2v_${Date.now()}.mp4`);
+      const dest = path26.join(getOutputDir(), `veo_i2v_${Date.now()}.mp4`);
       await downloadFile(videoUri, dest);
       logger.success(`Saved video: ${dest}`);
       if (opts.output) {
-        fs21.mkdirSync(path25.dirname(path25.resolve(opts.output)), { recursive: true });
-        fs21.copyFileSync(dest, opts.output);
+        fs23.mkdirSync(path26.dirname(path26.resolve(opts.output)), { recursive: true });
+        fs23.copyFileSync(dest, opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
       await maybeDownloadThumb(finalOp.response, dest, {
@@ -3353,14 +3551,14 @@ Generated video: ${dest}`);
 
 // src/providers/gemini/commands/transcribe.ts
 init_errors();
-import fs22 from "fs";
+import fs24 from "fs";
 function registerTranscribeCommand2(parent) {
   parent.command("transcribe").description("Transcribe audio or video files with Gemini").requiredOption("--files <paths...>", "Audio/video file paths to transcribe").option("--prompt <text>", "Transcription prompt", "Generate a transcript with timestamps").option("--model <id>", "Gemini model to use").option("--format <fmt>", "Output format: text|json|csv|markdown", "text").option("--output <path>", "Write results to file").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const model = opts.model ?? getDefaultModel("transcribe");
       for (const f of opts.files) {
-        if (!fs22.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
+        if (!fs24.existsSync(f)) throw new ValidationError(`File not found: ${f}`);
       }
       const results = [];
       for (let i = 0; i < opts.files.length; i++) {
@@ -3418,8 +3616,8 @@ function registerGeminiCommands(program2) {
 
 // src/providers/leonardo/commands/generate.ts
 init_http_client();
-import fs23 from "fs";
-import path26 from "path";
+import fs25 from "fs";
+import path27 from "path";
 
 // src/providers/leonardo/client.ts
 init_errors();
@@ -3493,11 +3691,11 @@ var LeonardoClient = class {
   }
   apiKey;
   baseUrl;
-  async request(path46, opts = {}) {
+  async request(path47, opts = {}) {
     const base = this.baseUrl.replace(/\/$/, "");
-    const v2Override = path46.startsWith("v2:");
+    const v2Override = path47.startsWith("v2:");
     const finalBase = v2Override ? base.replace(/\/v1$/, "/v2") : base;
-    const finalPath = v2Override ? path46.slice(3) : path46;
+    const finalPath = v2Override ? path47.slice(3) : path47;
     const url = new URL(finalBase + finalPath);
     if (opts.query) {
       for (const [k, v] of Object.entries(opts.query)) {
@@ -3516,14 +3714,14 @@ var LeonardoClient = class {
       timeoutMs: opts.timeoutMs ?? 12e4
     });
   }
-  get(path46, query, logger) {
-    return this.request(path46, { method: "GET", query, logger });
+  get(path47, query, logger) {
+    return this.request(path47, { method: "GET", query, logger });
   }
-  post(path46, body, logger) {
-    return this.request(path46, { method: "POST", body, logger });
+  post(path47, body, logger) {
+    return this.request(path47, { method: "POST", body, logger });
   }
-  delete(path46, logger) {
-    return this.request(path46, { method: "DELETE", logger });
+  delete(path47, logger) {
+    return this.request(path47, { method: "DELETE", logger });
   }
 };
 function createLeonardoClient() {
@@ -3534,7 +3732,7 @@ function createLeonardoClient() {
 function extFromUrl(url, fallback = ".png") {
   try {
     const u = new URL(url);
-    const e = path26.extname(u.pathname);
+    const e = path27.extname(u.pathname);
     return e.length > 0 ? e : fallback;
   } catch {
     return fallback;
@@ -3545,7 +3743,7 @@ function autoFilename(generationId, index, ext) {
   return `leonardo-${generationId.slice(0, 8)}-${String(index).padStart(2, "0")}${e}`;
 }
 function registerLeonardoGenerateCommand(parent) {
-  parent.command("generate <prompt>").alias("gen").description("Generate images from a text prompt via Leonardo").option("-m, --model <id>", "Model UUID or GPT-image id").option("-w, --width <n>", "Image width").option("-h, --height <n>", "Image height").option("-n, --num <n>", "Number of images").option("--alchemy", "Enable Alchemy").option("--ultra", "Enable Ultra mode").option("--contrast <n>", "Contrast").option("--style <uuid>", "Style UUID").option("--seed <n>", "Seed").option("--negative <text>", "Negative prompt").option("--enhance", "Enhance prompt").option("--quality <level>", "GPT Image quality: LOW|MEDIUM|HIGH", "HIGH").option("--output <path>", "Copy first image to this path (single-image only)").option("--no-download", "Skip downloading; print URLs only").option("--wait-timeout <ms>", "Polling timeout in milliseconds", "480000").option("-v, --verbose", "Verbose logging").action(
+  parent.command("generate <prompt>").alias("gen").description("Generate images from a text prompt via Leonardo").option("-m, --model <id>", "Model UUID or GPT-image id").option("-w, --width <n>", "Image width").option("-h, --height <n>", "Image height").option("-n, --num <n>", "Number of images").option("--alchemy", "Enable Alchemy").option("--ultra", "Enable Ultra mode").option("--contrast <n>", "Contrast").option("--style <uuid>", "Style UUID").option("--seed <n>", "Seed").option("--negative <text>", "Negative prompt").option("--enhance", "Enhance prompt").option("--quality <level>", "GPT Image quality: LOW|MEDIUM|HIGH", "HIGH").option("--output <path>", "Copy first image to this path (single-image only)").addOption(imageFormatOption()).addOption(noWebpOption()).option("--no-download", "Skip downloading; print URLs only").option("--wait-timeout <ms>", "Polling timeout in milliseconds", "480000").option("-v, --verbose", "Verbose logging").action(
     async (prompt, opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const client = createLeonardoClient();
@@ -3619,7 +3817,7 @@ function registerLeonardoGenerateCommand(parent) {
         if (!img) continue;
         const ext = extFromUrl(img.url);
         const filename = autoFilename(generationId, i + 1, ext);
-        const filepath = path26.join(outDir, filename);
+        const filepath = path27.join(outDir, filename);
         try {
           await downloadFile(img.url, filepath);
           saved.push(filepath);
@@ -3629,31 +3827,32 @@ function registerLeonardoGenerateCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        const dest = path26.resolve(opts.output);
-        fs23.mkdirSync(path26.dirname(dest), { recursive: true });
-        fs23.copyFileSync(saved[0], dest);
+        const dest = path27.resolve(opts.output);
+        fs25.mkdirSync(path27.dirname(dest), { recursive: true });
+        fs25.copyFileSync(saved[0], dest);
         logger.success(`Copied to ${dest}`);
       }
+      const finalImages = finalizeGeneratedImages(saved, { ...opts, logger });
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
 
 // src/providers/leonardo/commands/image-to-image.ts
 init_http_client();
-import fs24 from "fs";
-import path27 from "path";
+import fs26 from "fs";
+import path28 from "path";
 function extFromUrl2(url, fallback = ".png") {
   try {
-    return path27.extname(new URL(url).pathname) || fallback;
+    return path28.extname(new URL(url).pathname) || fallback;
   } catch {
     return fallback;
   }
 }
 function registerLeonardoImageToImageCommand(parent) {
-  parent.command("image-to-image").alias("i2i").description("Generate an image conditioned on an existing Leonardo image id (init image)").requiredOption("--prompt <text>", "Text prompt describing the desired output").requiredOption("--ref <imageId>", "Existing Leonardo image id to use as init image").option("--image-type <type>", "GENERATED | UPLOADED", "GENERATED").option("--init-strength <n>", "Init image strength (0.0-0.9)", "0.5").option("-m, --model <id>", "Model UUID").option("-w, --width <n>", "Image width").option("-h, --height <n>", "Image height").option("-n, --num <n>", "Number of images").option("--seed <n>", "Seed").option("--negative <text>", "Negative prompt").option("--output <path>", "Copy first image to this path (single-image only)").option("--no-download", "Skip downloading; print URLs only").option("--wait-timeout <ms>", "Polling timeout in milliseconds", "480000").option("-v, --verbose", "Verbose logging").action(
+  parent.command("image-to-image").alias("i2i").description("Generate an image conditioned on an existing Leonardo image id (init image)").requiredOption("--prompt <text>", "Text prompt describing the desired output").requiredOption("--ref <imageId>", "Existing Leonardo image id to use as init image").option("--image-type <type>", "GENERATED | UPLOADED", "GENERATED").option("--init-strength <n>", "Init image strength (0.0-0.9)", "0.5").option("-m, --model <id>", "Model UUID").option("-w, --width <n>", "Image width").option("-h, --height <n>", "Image height").option("-n, --num <n>", "Number of images").option("--seed <n>", "Seed").option("--negative <text>", "Negative prompt").option("--output <path>", "Copy first image to this path (single-image only)").addOption(imageFormatOption()).addOption(noWebpOption()).option("--no-download", "Skip downloading; print URLs only").option("--wait-timeout <ms>", "Polling timeout in milliseconds", "480000").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const imageType = opts.imageType.toUpperCase();
@@ -3709,7 +3908,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 = path27.join(outDir, filename);
+        const filepath = path28.join(outDir, filename);
         try {
           await downloadFile(img.url, filepath);
           saved.push(filepath);
@@ -3719,21 +3918,22 @@ function registerLeonardoImageToImageCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        const dest = path27.resolve(opts.output);
-        fs24.mkdirSync(path27.dirname(dest), { recursive: true });
-        fs24.copyFileSync(saved[0], dest);
+        const dest = path28.resolve(opts.output);
+        fs26.mkdirSync(path28.dirname(dest), { recursive: true });
+        fs26.copyFileSync(saved[0], dest);
         logger.success(`Copied to ${dest}`);
       }
+      const finalImages = finalizeGeneratedImages(saved, { ...opts, logger });
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
 
 // src/providers/leonardo/commands/video.ts
 init_http_client();
-import path28 from "path";
+import path29 from "path";
 function v2DimsFor(resolution) {
   if (resolution === "RESOLUTION_1080") return { width: 1920, height: 1080 };
   if (resolution === "RESOLUTION_480") return { width: 854, height: 480 };
@@ -3844,7 +4044,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 ?? path28.join(getOutputDir(), `${opts.basename}-${jobId.slice(0, 8)}.mp4`);
+  const outPath = opts.output ?? path29.join(getOutputDir(), `${opts.basename}-${jobId.slice(0, 8)}.mp4`);
   await downloadFile(videoUrl2, outPath);
   logger.success(`Saved ${outPath}`);
   await maybeDownloadThumb(gen, outPath, {
@@ -3951,7 +4151,7 @@ function registerLeonardoModelsCommand(parent) {
 
 // src/providers/leonardo/commands/status.ts
 init_http_client();
-import path29 from "path";
+import path30 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;
@@ -4016,7 +4216,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 : path29.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.mp4`);
+        const dest = opts.output && videos.length === 1 && images.length === 0 ? opts.output : path30.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.mp4`);
         await downloadFile(url, dest);
         logger.success(`Saved ${dest}`);
         await maybeDownloadThumb(gen, dest, {
@@ -4029,7 +4229,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 = path29.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.${ext}`);
+        const dest = path30.join(outDir, `leonardo-${generationId.slice(0, 8)}-${idx}.${ext}`);
         await downloadFile(url, dest);
         logger.success(`Saved ${dest}`);
         idx++;
@@ -4188,8 +4388,8 @@ function sleep4(ms) {
 
 // src/providers/minimax/generators/music.ts
 init_http_client();
-import fs25 from "fs";
-import path30 from "path";
+import fs27 from "fs";
+import path31 from "path";
 async function generateMinimaxMusic(opts) {
   const {
     apiKey,
@@ -4234,14 +4434,14 @@ async function generateMinimaxMusic(opts) {
   }
   const durationMs = resp.extra_info?.music_duration ?? 0;
   const outDir = getOutputDir();
-  const dest = path30.join(outDir, `minimax_music_${Date.now()}.${outputFormat}`);
+  const dest = path31.join(outDir, `minimax_music_${Date.now()}.${outputFormat}`);
   try {
     if (audioData.startsWith("http")) {
       const bytes = await fetchBytes(audioData);
-      fs25.writeFileSync(dest, bytes);
+      fs27.writeFileSync(dest, bytes);
     } else {
       const audioBytes = Buffer.from(audioData, "hex");
-      fs25.writeFileSync(dest, audioBytes);
+      fs27.writeFileSync(dest, audioBytes);
     }
   } catch (e) {
     return {
@@ -4252,8 +4452,8 @@ async function generateMinimaxMusic(opts) {
   const durSec = durationMs / 1e3;
   logger?.success(`Saved: ${dest} (${durSec.toFixed(1)}s)`);
   if (output) {
-    fs25.mkdirSync(path30.dirname(path30.resolve(output)), { recursive: true });
-    fs25.copyFileSync(dest, output);
+    fs27.mkdirSync(path31.dirname(path31.resolve(output)), { recursive: true });
+    fs27.copyFileSync(dest, output);
   }
   return { status: "success", generatedAudio: dest, durationMs, model };
 }
@@ -4327,8 +4527,8 @@ Generated music: ${result.generatedAudio}`);
 init_errors();
 
 // src/providers/minimax/generators/speech.ts
-import fs26 from "fs";
-import path31 from "path";
+import fs28 from "fs";
+import path32 from "path";
 async function generateMinimaxSpeech(opts) {
   const {
     apiKey,
@@ -4375,12 +4575,12 @@ async function generateMinimaxSpeech(opts) {
   const audioBytes = Buffer.from(audioHex, "hex");
   const ext = ["mp3", "wav", "flac"].includes(outputFormat) ? outputFormat : "mp3";
   const outDir = getOutputDir();
-  const dest = path31.join(outDir, `minimax_speech_${Date.now()}.${ext}`);
-  fs26.writeFileSync(dest, audioBytes);
+  const dest = path32.join(outDir, `minimax_speech_${Date.now()}.${ext}`);
+  fs28.writeFileSync(dest, audioBytes);
   logger?.success(`Saved: ${dest} (${(audioBytes.length / 1024).toFixed(1)} KB)`);
   if (output) {
-    fs26.mkdirSync(path31.dirname(path31.resolve(output)), { recursive: true });
-    fs26.copyFileSync(dest, output);
+    fs28.mkdirSync(path32.dirname(path32.resolve(output)), { recursive: true });
+    fs28.copyFileSync(dest, output);
   }
   return { status: "success", generatedAudio: dest, model };
 }
@@ -4427,8 +4627,8 @@ Generated audio: ${result.generatedAudio}`);
 init_errors();
 
 // src/providers/minimax/generators/video.ts
-import fs27 from "fs";
-import path32 from "path";
+import fs29 from "fs";
+import path33 from "path";
 async function generateMinimaxVideo(opts) {
   const {
     apiKey,
@@ -4474,18 +4674,18 @@ async function generateMinimaxVideo(opts) {
     return { status: "error", error: `No file_id in poll result: ${JSON.stringify(pollResult)}` };
   }
   const outDir = getOutputDir();
-  const dest = path32.join(outDir, `minimax_video_${Date.now()}.mp4`);
+  const dest = path33.join(outDir, `minimax_video_${Date.now()}.mp4`);
   try {
     await downloadMinimaxFile(fileId, apiKey, dest, logger);
   } catch (e) {
     return { status: "error", error: e instanceof Error ? e.message : String(e) };
   }
   const elapsed = (Date.now() - start) / 1e3;
-  const stat = fs27.statSync(dest);
+  const stat = fs29.statSync(dest);
   const fileSizeMb = stat.size / (1024 * 1024);
   if (output) {
-    fs27.mkdirSync(path32.dirname(path32.resolve(output)), { recursive: true });
-    fs27.copyFileSync(dest, output);
+    fs29.mkdirSync(path33.dirname(path33.resolve(output)), { recursive: true });
+    fs29.copyFileSync(dest, output);
   }
   await maybeDownloadThumb(pollResult, dest, {
     skip: thumb === false,
@@ -4548,8 +4748,8 @@ Generated video: ${result.generatedVideo}`);
 // src/providers/minimax/generators/image.ts
 init_errors();
 init_http_client();
-import fs28 from "fs";
-import path33 from "path";
+import fs30 from "fs";
+import path34 from "path";
 async function generateMinimaxImage(opts) {
   const {
     apiKey,
@@ -4587,8 +4787,8 @@ async function generateMinimaxImage(opts) {
     try {
       const bytes = await fetchBytes(url);
       const fname = `minimax_image_${Date.now()}_${i}.png`;
-      const dest = path33.join(outDir, fname);
-      fs28.writeFileSync(dest, bytes);
+      const dest = path34.join(outDir, fname);
+      fs30.writeFileSync(dest, bytes);
       savedFiles.push(dest);
       logger?.success(`Saved: ${dest}`);
     } catch (e) {
@@ -4599,15 +4799,15 @@ async function generateMinimaxImage(opts) {
     }
   }
   if (output && savedFiles[0]) {
-    fs28.mkdirSync(path33.dirname(path33.resolve(output)), { recursive: true });
-    fs28.copyFileSync(savedFiles[0], output);
+    fs30.mkdirSync(path34.dirname(path34.resolve(output)), { recursive: true });
+    fs30.copyFileSync(savedFiles[0], output);
   }
   return { status: "success", generatedImages: savedFiles, model };
 }
 
 // src/providers/minimax/commands/generate.ts
 function registerMinimaxGenerateCommand(parent) {
-  parent.command("generate").description("Generate images with MiniMax").requiredOption("--prompt <text>", "Image generation prompt").option("--model <id>", `Model (${[...MINIMAX_IMAGE_MODELS].join("|")})`).option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--num-images <n>", "Number of images (1-9)", "1").option("--output <path>", "Copy first image to this path").option("-v, --verbose", "Verbose logging").action(
+  parent.command("generate").description("Generate images with MiniMax").requiredOption("--prompt <text>", "Image generation prompt").option("--model <id>", `Model (${[...MINIMAX_IMAGE_MODELS].join("|")})`).option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--num-images <n>", "Number of images (1-9)", "1").option("--output <path>", "Copy first image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const apiKey = requireMinimaxKey();
@@ -4626,9 +4826,13 @@ function registerMinimaxGenerateCommand(parent) {
         logger.error(result.error ?? "Unknown error");
         process.exit(1);
       }
+      const finalImages = finalizeGeneratedImages(result.generatedImages ?? [], {
+        ...opts,
+        logger
+      });
       console.log(`
-Generated ${result.generatedImages?.length ?? 0} image(s):`);
-      for (const f of result.generatedImages ?? []) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
@@ -4636,15 +4840,15 @@ Generated ${result.generatedImages?.length ?? 0} image(s):`);
 // src/providers/minimax/commands/image-to-image.ts
 init_errors();
 init_http_client();
-import fs29 from "fs";
-import path34 from "path";
+import fs31 from "fs";
+import path35 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."
   ).requiredOption("--prompt <text>", "Prompt describing the desired NEW scene/composition").requiredOption(
     "--ref <path>",
     "Subject reference image (URL or local path) \u2014 character/face reference only, single image"
-  ).option("--model <id>", "Model id (default image-01)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--num-images <n>", "Number of images (1-9)", "1").option("--output <path>", "Copy first image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).option("--model <id>", "Model id (default image-01)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--num-images <n>", "Number of images (1-9)", "1").option("--output <path>", "Copy first image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const apiKey = requireMinimaxKey();
@@ -4692,8 +4896,8 @@ function registerMinimaxImageToImageCommand(parent) {
         if (!url) continue;
         try {
           const bytes = await fetchBytes(url);
-          const dest = path34.join(outDir, `minimax-i2i-${ts}-${i + 1}.png`);
-          fs29.writeFileSync(dest, bytes);
+          const dest = path35.join(outDir, `minimax-i2i-${ts}-${i + 1}.png`);
+          fs31.writeFileSync(dest, bytes);
           saved.push(dest);
           logger.success(`Saved: ${dest}`);
         } catch (e) {
@@ -4704,13 +4908,14 @@ function registerMinimaxImageToImageCommand(parent) {
         }
       }
       if (opts.output && saved[0]) {
-        fs29.mkdirSync(path34.dirname(path34.resolve(opts.output)), { recursive: true });
-        fs29.copyFileSync(saved[0], opts.output);
+        fs31.mkdirSync(path35.dirname(path35.resolve(opts.output)), { recursive: true });
+        fs31.copyFileSync(saved[0], opts.output);
         logger.success(`Copied to: ${opts.output}`);
       }
+      const finalImages = finalizeGeneratedImages(saved, { ...opts, logger });
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
     }
   );
 }
@@ -4839,12 +5044,12 @@ function validateKnownSpeakerPairing(names = [], refs = []) {
 
 // src/providers/openai/openai-audio.ts
 init_http_client();
-import fs31 from "fs";
-import path36 from "path";
+import fs33 from "fs";
+import path37 from "path";
 
 // src/providers/openai/client.ts
-import fs30 from "fs";
-import path35 from "path";
+import fs32 from "fs";
+import path36 from "path";
 init_errors();
 init_http_client();
 var DEFAULT_TIMEOUT_MS3 = 24e4;
@@ -4911,10 +5116,10 @@ async function postOpenAIBinary(pathname, body, apiKey, timeoutMs = DEFAULT_TIME
   return Buffer.from(await res.arrayBuffer());
 }
 function fileFromPath(filePath) {
-  const abs = path35.resolve(filePath);
-  if (!fs30.existsSync(abs)) throw new ValidationError(`File not found: ${abs}`);
-  const bytes = fs30.readFileSync(abs);
-  return new File([new Uint8Array(bytes)], path35.basename(abs));
+  const abs = path36.resolve(filePath);
+  if (!fs32.existsSync(abs)) throw new ValidationError(`File not found: ${abs}`);
+  const bytes = fs32.readFileSync(abs);
+  return new File([new Uint8Array(bytes)], path36.basename(abs));
 }
 
 // src/providers/openai/openai-audio.ts
@@ -4953,7 +5158,7 @@ async function resolveAudioReferenceDataUrl(ref) {
 }
 function audioMimeFromReference(ref) {
   const pathname = new URL(ref).pathname;
-  const ext = path36.extname(pathname).toLowerCase();
+  const ext = path37.extname(pathname).toLowerCase();
   switch (ext) {
     case ".mp3":
       return "audio/mpeg";
@@ -4972,12 +5177,12 @@ function audioMimeFromReference(ref) {
 async function generateOpenAISpeech(opts) {
   const bytes = await postOpenAIBinary("/audio/speech", buildSpeechBody(opts), requireOpenAIKey());
   const ext = extFromAudioFormat(opts.outputFormat);
-  const dest = path36.join(getOutputDir(), `openai-speech-${Date.now()}.${ext}`);
-  fs31.writeFileSync(dest, bytes);
+  const dest = path37.join(getOutputDir(), `openai-speech-${Date.now()}.${ext}`);
+  fs33.writeFileSync(dest, bytes);
   opts.logger?.success(`Saved: ${dest} (${(bytes.length / 1024).toFixed(1)} KB)`);
   if (opts.output) {
-    fs31.mkdirSync(path36.dirname(path36.resolve(opts.output)), { recursive: true });
-    fs31.copyFileSync(dest, opts.output);
+    fs33.mkdirSync(path37.dirname(path37.resolve(opts.output)), { recursive: true });
+    fs33.copyFileSync(dest, opts.output);
   }
   return dest;
 }
@@ -4999,9 +5204,9 @@ async function transcribeOpenAIAudio(opts) {
   );
   const text = typeof data.text === "string" ? data.text : void 0;
   const ext = opts.format === "text" ? "txt" : "json";
-  const dest = opts.output ? path36.resolve(opts.output) : path36.join(getOutputDir(), `openai-transcribe-${Date.now()}.${ext}`);
-  fs31.mkdirSync(path36.dirname(dest), { recursive: true });
-  fs31.writeFileSync(dest, opts.format === "text" ? text ?? "" : JSON.stringify(data, null, 2));
+  const dest = opts.output ? path37.resolve(opts.output) : path37.join(getOutputDir(), `openai-transcribe-${Date.now()}.${ext}`);
+  fs33.mkdirSync(path37.dirname(dest), { recursive: true });
+  fs33.writeFileSync(dest, opts.format === "text" ? text ?? "" : JSON.stringify(data, null, 2));
   opts.logger?.success(`Saved transcript: ${dest}`);
   return { path: dest, text };
 }
@@ -5028,9 +5233,9 @@ Generated audio: ${dest}`);
 }
 
 // src/providers/openai/codex-image-driver.ts
-import fs32 from "fs";
+import fs34 from "fs";
 import os2 from "os";
-import path37 from "path";
+import path38 from "path";
 import { execa } from "execa";
 init_errors();
 var defaultRunner = async (cmd, args, opts) => {
@@ -5079,12 +5284,12 @@ function sanitizeCodexEnv() {
 async function runCodexImageGeneration(opts) {
   const runner = opts.runner ?? defaultRunner;
   const ext = extFromImageFormat(opts.outputFormat);
-  const dest = opts.output ? path37.resolve(opts.output) : path37.join(getOutputDir(), `codex-image-${Date.now()}.${ext}`);
-  fs32.mkdirSync(path37.dirname(dest), { recursive: true });
-  const tmp = fs32.mkdtempSync(path37.join(os2.tmpdir(), "multix-codex-image-"));
-  const schema = path37.join(tmp, "schema.json");
-  const result = path37.join(tmp, "result.json");
-  fs32.writeFileSync(
+  const dest = opts.output ? path38.resolve(opts.output) : path38.join(getOutputDir(), `codex-image-${Date.now()}.${ext}`);
+  fs34.mkdirSync(path38.dirname(dest), { recursive: true });
+  const tmp = fs34.mkdtempSync(path38.join(os2.tmpdir(), "multix-codex-image-"));
+  const schema = path38.join(tmp, "schema.json");
+  const result = path38.join(tmp, "result.json");
+  fs34.writeFileSync(
     schema,
     JSON.stringify({
       type: "object",
@@ -5114,7 +5319,7 @@ async function runCodexImageGeneration(opts) {
   if (res.exitCode !== 0) {
     throw new ProviderError(`Codex image driver failed: ${res.stderr || res.stdout}`, "openai");
   }
-  if (!fs32.existsSync(dest) || fs32.statSync(dest).size === 0) {
+  if (!fs34.existsSync(dest) || fs34.statSync(dest).size === 0) {
     throw new ProviderError(`Codex did not create a non-empty image at ${dest}`, "openai");
   }
   return { path: dest };
@@ -5132,8 +5337,8 @@ function buildCodexPrompt(userPrompt, outputPath) {
 // src/providers/openai/openai-image.ts
 init_errors();
 init_http_client();
-import fs33 from "fs";
-import path38 from "path";
+import fs35 from "fs";
+import path39 from "path";
 function buildImageGenerationBody(opts) {
   return {
     model: opts.model ?? DEFAULT_OPENAI_IMAGE_MODEL,
@@ -5166,14 +5371,14 @@ function saveOpenAIImages(opts) {
   for (let i = 0; i < items.length; i++) {
     const b64 = items[i]?.b64_json;
     if (!b64) throw new ProviderError("No b64_json in OpenAI image response", "openai");
-    const dest = path38.join(outDir, `openai-${opts.task}-${ts}-${i + 1}.${ext}`);
-    fs33.writeFileSync(dest, Buffer.from(b64, "base64"));
+    const dest = path39.join(outDir, `openai-${opts.task}-${ts}-${i + 1}.${ext}`);
+    fs35.writeFileSync(dest, Buffer.from(b64, "base64"));
     saved.push(dest);
     opts.logger?.success(`Saved: ${dest}`);
   }
   if (opts.output && saved[0]) {
-    fs33.mkdirSync(path38.dirname(path38.resolve(opts.output)), { recursive: true });
-    fs33.copyFileSync(saved[0], opts.output);
+    fs35.mkdirSync(path39.dirname(path39.resolve(opts.output)), { recursive: true });
+    fs35.copyFileSync(saved[0], opts.output);
     opts.logger?.success(`Copied to: ${opts.output}`);
   }
   return saved;
@@ -5182,7 +5387,7 @@ async function resolveImageRefBytes(ref) {
   if (isHttpUrl(ref)) {
     const bytes2 = await fetchBytes(ref);
     const pathname = new URL(ref).pathname;
-    const filename = path38.basename(pathname) || "reference.png";
+    const filename = path39.basename(pathname) || "reference.png";
     return { filename, bytes: bytes2, mime: sniffImageMime2(bytes2, filename) };
   }
   const file = fileFromPath(ref);
@@ -5227,7 +5432,7 @@ function sniffImageMime2(buf, name) {
   if (buf[0] === 137 && buf[1] === 80 && buf[2] === 78 && buf[3] === 71) return "image/png";
   if (buf.slice(0, 4).toString() === "RIFF" && buf.slice(8, 12).toString() === "WEBP")
     return "image/webp";
-  const ext = path38.extname(name).toLowerCase();
+  const ext = path39.extname(name).toLowerCase();
   if (ext === ".jpg" || ext === ".jpeg") return "image/jpeg";
   if (ext === ".webp") return "image/webp";
   return "image/png";
@@ -5239,9 +5444,12 @@ function registerOpenAIGenerateCommand(parent) {
     "-m, --model <id>",
     "Image model",
     resolveKey("OPENAI_IMAGE_MODEL") ?? DEFAULT_OPENAI_IMAGE_MODEL
-  ).option("--size <size>", "1024x1024|1024x1536|1536x1024|auto", "1024x1024").option("--quality <q>", "low|medium|high", "medium").option("--format <fmt>", "png|jpeg|webp", "png").option("-n, --num-images <n>", "Number of images for API driver", "1").option("--output <path>", "Save first image to this path").option("-v, --verbose", "Verbose logging").action(async (opts) => {
+  ).option("--size <size>", "1024x1024|1024x1536|1536x1024|auto", "1024x1024").option("--quality <q>", "low|medium|high", "medium").option(
+    "--format <fmt>",
+    "Provider output format png|jpeg|webp (explicit value keeps it; default png then WebP)"
+  ).option("-n, --num-images <n>", "Number of images for API driver", "1").option("--output <path>", "Save first image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(async (opts) => {
     const logger = createLogger({ verbose: opts.verbose ?? false });
-    const outputFormat = parseImageFormat(opts.format);
+    const outputFormat = parseImageFormat(opts.format ?? "png");
     const driver = await resolveImageDriver({ requested: parseDriver(opts.driver) });
     const saved = driver === "codex" ? [
       (await runCodexImageGeneration({
@@ -5259,9 +5467,14 @@ function registerOpenAIGenerateCommand(parent) {
       output: opts.output,
       logger
     });
+    const finalImages = finalizeGeneratedImages(saved, {
+      ...opts,
+      logger,
+      explicitProviderFormat: opts.format !== void 0
+    });
     console.log(`
-Generated ${saved.length} image(s):`);
-    for (const file of saved) console.log(`  ${file}`);
+Generated ${finalImages.length} image(s):`);
+    for (const f of finalImages) console.log(`  ${f}`);
   });
 }
 
@@ -5277,12 +5490,15 @@ function registerOpenAIImageToImageCommand(parent) {
     "-m, --model <id>",
     "Image model",
     resolveKey("OPENAI_IMAGE_MODEL") ?? DEFAULT_OPENAI_IMAGE_MODEL
-  ).option("--size <size>", "1024x1024|1024x1536|1536x1024|auto", "1024x1024").option("--quality <q>", "low|medium|high", "medium").option("--format <fmt>", "png|jpeg|webp", "png").option("--output <path>", "Save first image to this path").option("-v, --verbose", "Verbose logging").action(async (opts) => {
+  ).option("--size <size>", "1024x1024|1024x1536|1536x1024|auto", "1024x1024").option("--quality <q>", "low|medium|high", "medium").option(
+    "--format <fmt>",
+    "Provider output format png|jpeg|webp (explicit value keeps it; default png then WebP)"
+  ).option("--output <path>", "Save first image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(async (opts) => {
     if (!opts.ref || opts.ref.length === 0) {
       throw new ValidationError("At least one --ref is required for image-to-image.");
     }
     const logger = createLogger({ verbose: opts.verbose ?? false });
-    const outputFormat = parseImageFormat(opts.format);
+    const outputFormat = parseImageFormat(opts.format ?? "png");
     const driver = await resolveImageDriver({ requested: parseDriver(opts.driver) });
     const saved = driver === "codex" ? [
       (await runCodexImageGeneration({
@@ -5301,9 +5517,14 @@ function registerOpenAIImageToImageCommand(parent) {
       output: opts.output,
       logger
     });
+    const finalImages = finalizeGeneratedImages(saved, {
+      ...opts,
+      logger,
+      explicitProviderFormat: opts.format !== void 0
+    });
     console.log(`
-Generated ${saved.length} image(s):`);
-    for (const file of saved) console.log(`  ${file}`);
+Generated ${finalImages.length} image(s):`);
+    for (const f of finalImages) console.log(`  ${f}`);
   });
 }
 function collect5(value, prev) {
@@ -5355,8 +5576,8 @@ function registerOpenAICommands(program2) {
 }
 
 // src/providers/openrouter/client.ts
-import fs34 from "fs";
-import path39 from "path";
+import fs36 from "fs";
+import path40 from "path";
 init_errors();
 init_http_client();
 
@@ -5521,8 +5742,8 @@ async function generateOpenRouterImage(opts) {
     if (!url) continue;
     try {
       const bytes = await fetchBytes(url);
-      const dest = path39.join(outDir, `openrouter_image_${Date.now()}_${i}.png`);
-      fs34.writeFileSync(dest, bytes);
+      const dest = path40.join(outDir, `openrouter_image_${Date.now()}_${i}.png`);
+      fs36.writeFileSync(dest, bytes);
       savedFiles.push(dest);
       logger?.success(`Saved: ${dest}`);
     } catch (e) {
@@ -5533,8 +5754,8 @@ async function generateOpenRouterImage(opts) {
     }
   }
   if (output && savedFiles[0]) {
-    fs34.mkdirSync(path39.dirname(path39.resolve(output)), { recursive: true });
-    fs34.writeFileSync(output, fs34.readFileSync(savedFiles[0]));
+    fs36.mkdirSync(path40.dirname(path40.resolve(output)), { recursive: true });
+    fs36.writeFileSync(output, fs36.readFileSync(savedFiles[0]));
   }
   return { status: "success", generatedImages: savedFiles, model: usedModel };
 }
@@ -5543,7 +5764,7 @@ async function generateOpenRouterImage(opts) {
 function registerOpenRouterGenerateCommand(parent) {
   parent.command("generate").description(
     "Generate images via OpenRouter (text-to-image); models: Gemini, GPT-Image, Flux, Recraft, Seedream"
-  ).requiredOption("--prompt <text>", "Image generation prompt").option("--model <id>", "OpenRouter model id (e.g. google/gemini-3.1-flash-image-preview)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--image-size <size>", "Image size hint (e.g. 1K, 2K)").option("--num-images <n>", "Number of images to generate", "1").option("--output <path>", "Copy first image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).requiredOption("--prompt <text>", "Image generation prompt").option("--model <id>", "OpenRouter model id (e.g. google/gemini-3.1-flash-image-preview)").option("--aspect-ratio <ratio>", "Aspect ratio (e.g. 1:1, 16:9)", "1:1").option("--image-size <size>", "Image size hint (e.g. 1K, 2K)").option("--num-images <n>", "Number of images to generate", "1").option("--output <path>", "Copy first image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const model = opts.model ?? resolveKey("OPENROUTER_IMAGE_MODEL") ?? DEFAULT_OPENROUTER_MODEL;
@@ -5562,17 +5783,21 @@ function registerOpenRouterGenerateCommand(parent) {
         logger.error(result.error ?? "Unknown error");
         process.exit(1);
       }
+      const finalImages = finalizeGeneratedImages(result.generatedImages ?? [], {
+        ...opts,
+        logger
+      });
       console.log(`
-Generated ${result.generatedImages?.length ?? 0} image(s):`);
-      for (const f of result.generatedImages ?? []) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
       if (result.model) console.log(`Model used: ${result.model}`);
     }
   );
 }
 
 // src/providers/openrouter/commands/image-to-image.ts
-import fs35 from "fs";
-import path40 from "path";
+import fs37 from "fs";
+import path41 from "path";
 init_errors();
 init_http_client();
 var DEFAULT_MODEL = "google/gemini-2.5-flash-image";
@@ -5586,7 +5811,7 @@ function registerOpenRouterImageToImageCommand(parent) {
     "Reference image (URL or local path); repeatable (most models accept 1)",
     collect7,
     []
-  ).option("-m, --model <id>", `OpenRouter model id (default ${DEFAULT_MODEL})`).option("--strength <n>", "Recraft init-image strength 0..1 (Recraft models only)").option("--output <path>", "Save first generated image to this path").option("-v, --verbose", "Verbose logging").action(
+  ).option("-m, --model <id>", `OpenRouter model id (default ${DEFAULT_MODEL})`).option("--strength <n>", "Recraft init-image strength 0..1 (Recraft models only)").option("--output <path>", "Save first generated image to this path").addOption(imageFormatOption()).addOption(noWebpOption()).option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       if (!opts.ref || opts.ref.length === 0) {
         throw new ValidationError("At least one --ref is required for image-to-image.");
@@ -5618,9 +5843,10 @@ function registerOpenRouterImageToImageCommand(parent) {
         output: opts.output,
         logger
       });
+      const finalImages = finalizeGeneratedImages(saved, { ...opts, logger });
       console.log(`
-Generated ${saved.length} image(s):`);
-      for (const f of saved) console.log(`  ${f}`);
+Generated ${finalImages.length} image(s):`);
+      for (const f of finalImages) console.log(`  ${f}`);
       console.log(`Model used: ${model}`);
     }
   );
@@ -5664,14 +5890,14 @@ async function runImageToImage(opts) {
     const url = parsed.urls[i];
     if (!url) continue;
     const bytes = await fetchBytes(url);
-    const dest = path40.join(outDir, `openrouter-i2i-${ts}-${i + 1}.png`);
-    fs35.writeFileSync(dest, bytes);
+    const dest = path41.join(outDir, `openrouter-i2i-${ts}-${i + 1}.png`);
+    fs37.writeFileSync(dest, bytes);
     saved.push(dest);
     opts.logger.success(`Saved: ${dest}`);
   }
   if (opts.output && saved[0]) {
-    fs35.mkdirSync(path40.dirname(path40.resolve(opts.output)), { recursive: true });
-    fs35.copyFileSync(saved[0], opts.output);
+    fs37.mkdirSync(path41.dirname(path41.resolve(opts.output)), { recursive: true });
+    fs37.copyFileSync(saved[0], opts.output);
     opts.logger.success(`Copied to: ${opts.output}`);
   }
   return saved;
@@ -5717,13 +5943,13 @@ async function listVideoModels(apiKey = requireOpenRouterKey()) {
 }
 
 // src/providers/openrouter/commands/video-status.ts
-import fs36 from "fs";
-import path41 from "path";
+import fs38 from "fs";
+import path42 from "path";
 async function downloadOpenRouterVideo(opts) {
   const { jobId, logger, source } = opts;
   const apiKey = requireOpenRouterKey();
   const url = videoContentUrl(jobId);
-  const dest = path41.join(getOutputDir(), `openrouter_video_${jobId}.mp4`);
+  const dest = path42.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}`);
@@ -5733,14 +5959,14 @@ async function downloadOpenRouterVideo(opts) {
     logger.error("Empty response body");
     process.exit(1);
   }
-  fs36.mkdirSync(path41.dirname(dest), { recursive: true });
-  const ws = fs36.createWriteStream(dest);
+  fs38.mkdirSync(path42.dirname(dest), { recursive: true });
+  const ws = fs38.createWriteStream(dest);
   const { pipeline: pipeline2 } = await import("stream/promises");
   await pipeline2(r.body, ws);
   logger.success(`Saved ${dest}`);
   if (opts.output) {
-    fs36.mkdirSync(path41.dirname(path41.resolve(opts.output)), { recursive: true });
-    fs36.copyFileSync(dest, opts.output);
+    fs38.mkdirSync(path42.dirname(path42.resolve(opts.output)), { recursive: true });
+    fs38.copyFileSync(dest, opts.output);
     logger.success(`Copied to ${opts.output}`);
   }
   await maybeDownloadThumb(source, dest, {
@@ -6151,8 +6377,8 @@ function registerCheckCommand(program2) {
 
 // src/commands/doc/convert.ts
 init_errors();
-import fs37 from "fs";
-import path42 from "path";
+import fs39 from "fs";
+import path43 from "path";
 
 // src/commands/doc/default-prompt.ts
 var DEFAULT_CONVERT_PROMPT = `Convert this document to clean, well-formatted Markdown.
@@ -6173,18 +6399,18 @@ async function convertDocuments(opts) {
   const model = opts.model ?? DOC_MODEL_DEFAULT;
   const prompt = opts.prompt ?? DEFAULT_CONVERT_PROMPT;
   for (const f of inputs) {
-    if (!fs37.existsSync(f)) throw new ValidationError(`Input file not found: ${f}`);
+    if (!fs39.existsSync(f)) throw new ValidationError(`Input file not found: ${f}`);
   }
   let outputPath;
   if (output) {
-    outputPath = path42.resolve(output);
+    outputPath = path43.resolve(output);
   } else if (autoName && inputs.length === 1 && inputs[0]) {
-    const base = path42.basename(inputs[0], path42.extname(inputs[0]));
-    outputPath = path42.join(getOutputDir(), `${base}-extraction.md`);
+    const base = path43.basename(inputs[0], path43.extname(inputs[0]));
+    outputPath = path43.join(getOutputDir(), `${base}-extraction.md`);
   } else {
-    outputPath = path42.join(getOutputDir(), "document-extraction.md");
+    outputPath = path43.join(getOutputDir(), "document-extraction.md");
   }
-  fs37.mkdirSync(path42.dirname(outputPath), { recursive: true });
+  fs39.mkdirSync(path43.dirname(outputPath), { recursive: true });
   const results = [];
   for (let i = 0; i < inputs.length; i++) {
     const filePath = inputs[i];
@@ -6235,7 +6461,7 @@ async function convertDocuments(opts) {
 `);
   for (const r of results) {
     lines.push(`
-## ${path42.basename(r.file)}
+## ${path43.basename(r.file)}
 `);
     if (r.status === "success" && r.markdown) {
       lines.push(`${r.markdown}
@@ -6248,7 +6474,7 @@ async function convertDocuments(opts) {
     }
     lines.push("\n---\n");
   }
-  fs37.writeFileSync(outputPath, lines.join("\n"), "utf8");
+  fs39.writeFileSync(outputPath, lines.join("\n"), "utf8");
   const succeeded = results.filter((r) => r.status === "success").length;
   console.log(`
 ${"=".repeat(50)}`);
@@ -6296,22 +6522,22 @@ function registerDocCommands(program2) {
 
 // src/commands/media/index.ts
 init_errors();
-import fs40 from "fs";
-import path45 from "path";
+import fs42 from "fs";
+import path46 from "path";
 
 // src/commands/media/batch.ts
-import fs38 from "fs";
-import path43 from "path";
+import fs40 from "fs";
+import path44 from "path";
 
 // src/commands/media/detect-type.ts
 var VIDEO_EXTS = /* @__PURE__ */ new Set([".mp4", ".mov", ".avi", ".mkv", ".webm", ".flv", ".mpg", ".mpeg"]);
 var AUDIO_EXTS = /* @__PURE__ */ new Set([".mp3", ".wav", ".m4a", ".flac", ".aac", ".ogg", ".aiff"]);
-var IMAGE_EXTS = /* @__PURE__ */ new Set([".jpg", ".jpeg", ".png", ".webp", ".heic", ".heif", ".gif", ".bmp"]);
+var IMAGE_EXTS2 = /* @__PURE__ */ new Set([".jpg", ".jpeg", ".png", ".webp", ".heic", ".heif", ".gif", ".bmp"]);
 function extToKind(ext) {
   const lower = ext.toLowerCase();
   if (VIDEO_EXTS.has(lower)) return "video";
   if (AUDIO_EXTS.has(lower)) return "audio";
-  if (IMAGE_EXTS.has(lower)) return "image";
+  if (IMAGE_EXTS2.has(lower)) return "image";
   return void 0;
 }
 
@@ -6486,7 +6712,7 @@ async function optimizeVideo(opts) {
 }
 
 // src/commands/media/batch.ts
-var ALL_EXTS = /* @__PURE__ */ new Set([...VIDEO_EXTS, ...AUDIO_EXTS, ...IMAGE_EXTS]);
+var ALL_EXTS = /* @__PURE__ */ new Set([...VIDEO_EXTS, ...AUDIO_EXTS, ...IMAGE_EXTS2]);
 async function batchOptimize(opts) {
   const {
     inputDir,
@@ -6497,10 +6723,10 @@ async function batchOptimize(opts) {
     verbose,
     logger
   } = opts;
-  fs38.mkdirSync(outputDir, { recursive: true });
-  const entries = fs38.readdirSync(inputDir);
+  fs40.mkdirSync(outputDir, { recursive: true });
+  const entries = fs40.readdirSync(inputDir);
   const mediaFiles = entries.filter((f) => {
-    const ext = path43.extname(f).toLowerCase();
+    const ext = path44.extname(f).toLowerCase();
     return ALL_EXTS.has(ext);
   });
   if (mediaFiles.length === 0) {
@@ -6511,9 +6737,9 @@ async function batchOptimize(opts) {
   let succeeded = 0;
   const errors = [];
   for (const file of mediaFiles) {
-    const inputPath = path43.join(inputDir, file);
-    const outputPath = path43.join(outputDir, file);
-    const ext = path43.extname(file).toLowerCase();
+    const inputPath = path44.join(inputDir, file);
+    const outputPath = path44.join(outputDir, file);
+    const ext = path44.extname(file).toLowerCase();
     const kind = extToKind(ext);
     logger?.debug(`Processing: ${file}`);
     try {
@@ -6550,8 +6776,8 @@ async function batchOptimize(opts) {
 
 // src/commands/media/split-video.ts
 init_errors();
-import fs39 from "fs";
-import path44 from "path";
+import fs41 from "fs";
+import path45 from "path";
 async function splitVideo(opts) {
   await assertFfmpeg();
   const { input, outputDir, chunkDuration = 3600, verbose, logger } = opts;
@@ -6562,10 +6788,10 @@ async function splitVideo(opts) {
     logger?.info("Video is short enough \u2014 no splitting needed");
     return [input];
   }
-  fs39.mkdirSync(outputDir, { recursive: true });
-  const ext = path44.extname(input) || ".mp4";
-  const baseName = path44.basename(input, ext);
-  const outputPattern = path44.join(outputDir, `${baseName}_chunk_%03d${ext}`);
+  fs41.mkdirSync(outputDir, { recursive: true });
+  const ext = path45.extname(input) || ".mp4";
+  const baseName = path45.basename(input, ext);
+  const outputPattern = path45.join(outputDir, `${baseName}_chunk_%03d${ext}`);
   logger?.debug(`Splitting into ~${numChunks} chunks of ${chunkDuration}s each`);
   const args = [
     "-i",
@@ -6584,8 +6810,8 @@ async function splitVideo(opts) {
   await runFfmpeg(args, { verbose, logger });
   const files = [];
   for (let i = 0; i < numChunks + 1; i++) {
-    const fname = path44.join(outputDir, `${baseName}_chunk_${String(i).padStart(3, "0")}${ext}`);
-    if (fs39.existsSync(fname)) files.push(fname);
+    const fname = path45.join(outputDir, `${baseName}_chunk_${String(i).padStart(3, "0")}${ext}`);
+    if (fs41.existsSync(fname)) files.push(fname);
   }
   logger?.success(`Created ${files.length} chunks in ${outputDir}`);
   return files;
@@ -6599,9 +6825,9 @@ function registerMediaCommands(program2) {
   media.command("optimize").description("Optimize a single media file (video, audio, or image)").requiredOption("--input <file>", "Input media file").requiredOption("--output <file>", "Output file path").option("--target-size <MB>", "Target file size in MB").option("--quality <n>", "Quality: video CRF (0-51) or image (1-100)", "85").option("--max-width <px>", "Max image/video width in pixels", "1920").option("--bitrate <rate>", "Audio bitrate (e.g. 64k)", "64k").option("--resolution <WxH>", "Force video resolution (e.g. 1920x1080)").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs40.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
-      fs40.mkdirSync(path45.dirname(path45.resolve(opts.output)), { recursive: true });
-      const ext = path45.extname(opts.input).toLowerCase();
+      if (!fs42.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
+      fs42.mkdirSync(path46.dirname(path46.resolve(opts.output)), { recursive: true });
+      const ext = path46.extname(opts.input).toLowerCase();
       const kind = extToKind(ext);
       if (!kind) throw new ValidationError(`Unsupported file type: ${ext}`);
       const quality = Number.parseInt(opts.quality, 10);
@@ -6641,7 +6867,7 @@ function registerMediaCommands(program2) {
   media.command("split").description("Split a long video into fixed-duration chunks").requiredOption("--input <file>", "Input video file").option("--output-dir <dir>", "Output directory for chunks", "./chunks").option("--chunk-duration <sec>", "Chunk duration in seconds", "3600").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs40.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
+      if (!fs42.existsSync(opts.input)) throw new ValidationError(`Input not found: ${opts.input}`);
       const chunks = await splitVideo({
         input: opts.input,
         outputDir: opts.outputDir,
@@ -6657,7 +6883,7 @@ Created ${chunks.length} chunk(s) in ${opts.outputDir}`);
   media.command("batch").description("Batch optimize all media files in a directory").requiredOption("--input-dir <dir>", "Input directory").requiredOption("--output-dir <dir>", "Output directory").option("--quality <n>", "Quality setting", "85").option("--max-width <px>", "Max image/video width", "1920").option("--bitrate <rate>", "Audio bitrate", "64k").option("-v, --verbose", "Verbose logging").action(
     async (opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
-      if (!fs40.existsSync(opts.inputDir))
+      if (!fs42.existsSync(opts.inputDir))
         throw new ValidationError(`Input dir not found: ${opts.inputDir}`);
       const result = await batchOptimize({
         inputDir: opts.inputDir,