ima2-gen 1.1.9 → 1.1.10

package/bin/commands/edit.ts

@@ -4,6 +4,7 @@ import { fileToDataUri, dataUriToFile, defaultOutName } from "../lib/files.js";
 import { out, die, dieWithError, color, json } from "../lib/output.js";
 import { config } from "../../config.js";
 
+import { errInfo } from "../../lib/errInfo.js";
 const VALID_MODES = new Set(["auto", "direct"]);
 const VALID_MODERATION = new Set(["auto", "low"]);
 const KNOWN_IMAGE_MODELS = new Set(["gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex-spark"]);
@@ -47,19 +48,19 @@ const HELP = `
         --web-search / --no-web-search    Override default web-search toggle
 `;
 
-export default async function editCmd(argv) {
+export default async function editCmd(argv: string[]) {
   const args = parseArgs(argv, SPEC);
   if (args.help) { out(HELP); return; }
   const input = args.positional[0];
   if (!input) die(2, "input image path required");
   if (!args.prompt) die(2, "--prompt is required");
-  if (!VALID_MODES.has(args.mode)) die(2, "--mode must be one of: auto, direct");
-  if (!VALID_MODERATION.has(args.moderation)) die(2, "--moderation must be one of: auto, low");
-  if (args.model && !KNOWN_IMAGE_MODELS.has(args.model)) {
+  if (!VALID_MODES.has(String(args.mode))) die(2, "--mode must be one of: auto, direct");
+  if (!VALID_MODERATION.has(String(args.moderation))) die(2, "--moderation must be one of: auto, low");
+  if (args.model && !KNOWN_IMAGE_MODELS.has(String(args.model))) {
     die(2, "--model must be one of: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark");
   }
   const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-  if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+  if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
     die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
   }
   if (args["web-search"] && args["no-web-search"]) {
@@ -69,14 +70,15 @@ export default async function editCmd(argv) {
   let server;
   try { server = await resolveServer({ serverFlag: args.server }); }
   catch (e) {
-    if (args.json) json({ ok: false, error: e.message, code: e.code, status: e.status });
+    const err = errInfo(e);
+    if (args.json) json({ ok: false, error: err.message, code: err.code, status: err.status });
     dieWithError(e);
   }
 
   const imageDataUri = await fileToDataUri(input);
   const imageB64 = imageDataUri.split(",")[1];
 
-  const timeoutMs = (parseInt(args.timeout) || 180) * 1000;
+  const timeoutMs = (parseInt(String(args.timeout)) || 180) * 1000;
   let resp;
   try {
     const editBody: any = {
@@ -98,14 +100,15 @@ export default async function editCmd(argv) {
       timeoutMs,
     });
   } catch (e) {
-    if (args.json) json({ ok: false, error: e.message, code: e.code });
+    const err = errInfo(e);
+    if (args.json) json({ ok: false, error: err.message, code: err.code });
     dieWithError(e);
   }
 
   const image = resp.image;
   if (!image) die(1, "server returned no image");
   const target = args.out || `${config.storage.generatedDir}/${defaultOutName(0, 1)}`;
-  await dataUriToFile(image, target);
+  await dataUriToFile(image, String(target));
 
   if (args.json) {
     json({ ok: true, path: target, requestId: resp.requestId, elapsed: resp.elapsed });

package/bin/commands/gen.js

@@ -3,6 +3,7 @@ import { resolveServer, request, normalizeGenerate } from "../lib/client.js";
 import { fileToDataUri, dataUriToFile, defaultOutName, readStdin } from "../lib/files.js";
 import { out, die, dieWithError, color, json } from "../lib/output.js";
 import { config } from "../../config.js";
+import { errInfo } from "../../lib/errInfo.js";
 const VALID_MODES = new Set(["auto", "direct"]);
 const VALID_MODERATION = new Set(["auto", "low"]);
 const KNOWN_IMAGE_MODELS = new Set(["gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex-spark"]);
@@ -75,32 +76,33 @@ export default async function genCmd(argv) {
     }
     if (!prompt)
         die(2, "prompt is required (positional or via --stdin)");
-    const refs = args.ref || [];
+    const refs = (Array.isArray(args.ref) ? args.ref : []);
     if (refs.length > 5)
         die(2, "max 5 --ref attachments");
-    if (!VALID_MODES.has(args.mode))
+    if (!VALID_MODES.has(String(args.mode)))
         die(2, "--mode must be one of: auto, direct");
-    if (!VALID_MODERATION.has(args.moderation))
+    if (!VALID_MODERATION.has(String(args.moderation)))
         die(2, "--moderation must be one of: auto, low");
-    if (args.model && !KNOWN_IMAGE_MODELS.has(args.model)) {
+    if (args.model && !KNOWN_IMAGE_MODELS.has(String(args.model))) {
         die(2, "--model must be one of: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark");
     }
     const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-    if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+    if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
         die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
     }
     if (args["web-search"] && args["no-web-search"]) {
         die(2, "--web-search and --no-web-search are mutually exclusive");
     }
-    const n = Math.max(1, Math.min(8, parseInt(args.count) || 1));
-    const timeoutMs = (parseInt(args.timeout) || 180) * 1000;
+    const n = Math.max(1, Math.min(8, parseInt(String(args.count)) || 1));
+    const timeoutMs = (parseInt(String(args.timeout)) || 180) * 1000;
     let server;
     try {
         server = await resolveServer({ serverFlag: args.server });
     }
     catch (e) {
+        const err = errInfo(e);
         if (args.json)
-            json({ ok: false, error: e.message, code: e.code, status: e.status });
+            json({ ok: false, error: err.message, code: err.code, status: err.status });
         dieWithError(e);
     }
     const references = await Promise.all(refs.map((p) => fileToDataUri(p)));
@@ -126,8 +128,9 @@ export default async function genCmd(argv) {
         resp = await request(server.base, "/api/generate", { method: "POST", body, timeoutMs });
     }
     catch (e) {
+        const err = errInfo(e);
         if (args.json)
-            json({ ok: false, error: e.message, code: e.code, status: e.status });
+            json({ ok: false, error: err.message, code: err.code, status: err.status });
         dieWithError(e);
     }
     const norm = normalizeGenerate(resp);
@@ -135,7 +138,7 @@ export default async function genCmd(argv) {
         die(1, "server returned no images");
     // --no-save path
     if (args["no-save"]) {
-        const totalBytes = norm.images.reduce((s, im) => s + im.image.length, 0);
+        const totalBytes = norm.images.reduce((s, im) => s + (im.image?.length ?? 0), 0);
         if (process.stdout.isTTY && totalBytes > 2 * 1024 * 1024 && !args.force) {
             die(2, "refusing to print >2MB of b64 to TTY; use --force or drop --no-save");
         }
@@ -144,8 +147,8 @@ export default async function genCmd(argv) {
         return;
     }
     // Save path
-    const outDir = args["out-dir"] || null;
-    const explicitOut = args.out || null;
+    const outDir = args["out-dir"] ? String(args["out-dir"]) : null;
+    const explicitOut = args.out ? String(args.out) : null;
     if (explicitOut && norm.images.length > 1) {
         die(2, "--out only supports a single image; use --out-dir for n>1");
     }
@@ -162,7 +165,7 @@ export default async function genCmd(argv) {
         else {
             target = `${config.storage.generatedDir}/${defaultOutName(i, norm.images.length)}`;
         }
-        await dataUriToFile(im.image, target);
+        await dataUriToFile(String(im.image), target);
         savedPaths.push(target);
     }
     if (args.json) {

package/bin/commands/gen.ts

@@ -4,6 +4,7 @@ import { fileToDataUri, dataUriToFile, defaultOutName, readStdin } from "../lib/
 import { out, die, dieWithError, color, json } from "../lib/output.js";
 import { config } from "../../config.js";
 
+import { errInfo } from "../../lib/errInfo.js";
 const VALID_MODES = new Set(["auto", "direct"]);
 const VALID_MODERATION = new Set(["auto", "low"]);
 const KNOWN_IMAGE_MODELS = new Set(["gpt-5.5", "gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex-spark"]);
@@ -65,7 +66,7 @@ const HELP = `
     cat prompt.txt | ima2 gen --stdin -n 2 -d ./out
 `;
 
-export default async function genCmd(argv) {
+export default async function genCmd(argv: string[]) {
   const args = parseArgs(argv, SPEC);
   if (args.help) { out(HELP); return; }
 
@@ -76,33 +77,34 @@ export default async function genCmd(argv) {
   }
   if (!prompt) die(2, "prompt is required (positional or via --stdin)");
 
-  const refs = args.ref || [];
+  const refs = (Array.isArray(args.ref) ? args.ref : []) as string[];
   if (refs.length > 5) die(2, "max 5 --ref attachments");
-  if (!VALID_MODES.has(args.mode)) die(2, "--mode must be one of: auto, direct");
-  if (!VALID_MODERATION.has(args.moderation)) die(2, "--moderation must be one of: auto, low");
-  if (args.model && !KNOWN_IMAGE_MODELS.has(args.model)) {
+  if (!VALID_MODES.has(String(args.mode))) die(2, "--mode must be one of: auto, direct");
+  if (!VALID_MODERATION.has(String(args.moderation))) die(2, "--moderation must be one of: auto, low");
+  if (args.model && !KNOWN_IMAGE_MODELS.has(String(args.model))) {
     die(2, "--model must be one of: gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark");
   }
   const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-  if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+  if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
     die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
   }
   if (args["web-search"] && args["no-web-search"]) {
     die(2, "--web-search and --no-web-search are mutually exclusive");
   }
 
-  const n = Math.max(1, Math.min(8, parseInt(args.count) || 1));
-  const timeoutMs = (parseInt(args.timeout) || 180) * 1000;
+  const n = Math.max(1, Math.min(8, parseInt(String(args.count)) || 1));
+  const timeoutMs = (parseInt(String(args.timeout)) || 180) * 1000;
 
   let server;
   try {
     server = await resolveServer({ serverFlag: args.server });
   } catch (e) {
-    if (args.json) json({ ok: false, error: e.message, code: e.code, status: e.status });
+    const err = errInfo(e);
+    if (args.json) json({ ok: false, error: err.message, code: err.code, status: err.status });
     dieWithError(e);
   }
 
-  const references = await Promise.all(refs.map((p) => fileToDataUri(p)));
+  const references = await Promise.all(refs.map((p: string) => fileToDataUri(p)));
 
   const body: any = {
     prompt,
@@ -123,7 +125,8 @@ export default async function genCmd(argv) {
   try {
     resp = await request(server.base, "/api/generate", { method: "POST", body, timeoutMs });
   } catch (e) {
-    if (args.json) json({ ok: false, error: e.message, code: e.code, status: e.status });
+    const err = errInfo(e);
+    if (args.json) json({ ok: false, error: err.message, code: err.code, status: err.status });
     dieWithError(e);
   }
 
@@ -132,7 +135,7 @@ export default async function genCmd(argv) {
 
   // --no-save path
   if (args["no-save"]) {
-    const totalBytes = norm.images.reduce((s, im) => s + im.image.length, 0);
+    const totalBytes = norm.images.reduce((s: number, im) => s + (im.image?.length ?? 0), 0);
     if (process.stdout.isTTY && totalBytes > 2 * 1024 * 1024 && !args.force) {
       die(2, "refusing to print >2MB of b64 to TTY; use --force or drop --no-save");
     }
@@ -141,16 +144,16 @@ export default async function genCmd(argv) {
   }
 
   // Save path
-  const outDir = args["out-dir"] || null;
-  const explicitOut = args.out || null;
+  const outDir = args["out-dir"] ? String(args["out-dir"]) : null;
+  const explicitOut = args.out ? String(args.out) : null;
   if (explicitOut && norm.images.length > 1) {
     die(2, "--out only supports a single image; use --out-dir for n>1");
   }
 
-  const savedPaths = [];
+  const savedPaths: string[] = [];
   for (let i = 0; i < norm.images.length; i++) {
     const im = norm.images[i];
-    let target;
+    let target: string;
     if (explicitOut) {
       target = explicitOut;
     } else if (outDir) {
@@ -158,7 +161,7 @@ export default async function genCmd(argv) {
     } else {
       target = `${config.storage.generatedDir}/${defaultOutName(i, norm.images.length)}`;
     }
-    await dataUriToFile(im.image, target);
+    await dataUriToFile(String(im.image), target);
     savedPaths.push(target);
   }
 

package/bin/commands/history.js

@@ -36,7 +36,8 @@ async function getServer(args) {
     }
 }
 function handle(e) {
-    die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`);
+    const err = e;
+    die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`);
 }
 async function readLine() {
     return new Promise((resolve) => {

package/bin/commands/history.ts

@@ -1,6 +1,6 @@
 import { readFile } from "fs/promises";
 import { extname, basename } from "path";
-import { parseArgs } from "../lib/args.js";
+import { parseArgs, type ParsedArgs } from "../lib/args.js";
 import { resolveServer, request } from "../lib/client.js";
 import { out, die, color, json, exitCodeForError } from "../lib/output.js";
 import { getCliBrowserId } from "../lib/browser-id.js";
@@ -29,20 +29,21 @@ const COMMON_FLAGS = {
   help: { short: "h", type: "boolean" },
 };
 
-async function getServer(args) {
+async function getServer(args: ParsedArgs) {
   try { return await resolveServer({ serverFlag: args.server }); }
   catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
 }
 
-function handle(e) {
-  die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`);
+function handle(e: unknown) {
+  const err = e as { message?: string; code?: string };
+  die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`);
 }
 
 async function readLine(): Promise<string> {
   return new Promise((resolve) => {
     let buf = "";
     process.stdin.setEncoding("utf-8");
-    const onData = (chunk) => {
+    const onData = (chunk: Buffer | string) => {
       buf += chunk;
       const nl = buf.indexOf("\n");
       if (nl !== -1) {
@@ -56,7 +57,7 @@ async function readLine(): Promise<string> {
   });
 }
 
-async function rmSub(argv) {
+async function rmSub(argv: string[]) {
   const args = parseArgs(argv, { flags: COMMON_FLAGS });
   const filename = args.positional[0];
   if (!filename) die(2, "filename required");
@@ -76,7 +77,7 @@ async function rmSub(argv) {
   if (resp?.trashId) out(color.dim(`  trashId: ${resp.trashId}`));
 }
 
-async function restoreSub(argv) {
+async function restoreSub(argv: string[]) {
   const args = parseArgs(argv, { flags: COMMON_FLAGS });
   const filename = args.positional[0];
   if (!filename) die(2, "filename required");
@@ -91,7 +92,7 @@ async function restoreSub(argv) {
   out(color.green("✓ restored"));
 }
 
-async function favoriteSub(argv) {
+async function favoriteSub(argv: string[]) {
   const args = parseArgs(argv, { flags: COMMON_FLAGS });
   const filename = args.positional[0];
   if (!filename) die(2, "filename required");
@@ -106,7 +107,7 @@ async function favoriteSub(argv) {
   out(color.green(resp.isFavorite ? "✓ favorited" : "✓ unfavorited"));
 }
 
-async function importSub(argv) {
+async function importSub(argv: string[]) {
   const args = parseArgs(argv, { flags: COMMON_FLAGS });
   const filepath = args.positional[0];
   if (!filepath) die(2, "filename required");
@@ -136,7 +137,7 @@ const SUB: Record<string, (argv: any[]) => Promise<void>> = {
   import: importSub,
 };
 
-export default async function historyCmd(argv) {
+export default async function historyCmd(argv: string[]) {
   const sub = argv[0];
   if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
   const handler = SUB[sub];

package/bin/commands/ls.js

@@ -1,6 +1,7 @@
 import { parseArgs } from "../lib/args.js";
 import { resolveServer, request } from "../lib/client.js";
 import { out, die, color, json, table, exitCodeForError } from "../lib/output.js";
+import { errInfo } from "../../lib/errInfo.js";
 const SPEC = {
     flags: {
         count: { short: "n", type: "string", default: "20" },
@@ -22,12 +23,13 @@ export default async function lsCmd(argv) {
         server = await resolveServer({ serverFlag: args.server });
     }
     catch (e) {
-        die(exitCodeForError(e), e.message);
+        const err = errInfo(e);
+        die(exitCodeForError(e), err.message);
     }
-    const limit = parseInt(args.count) || 20;
+    const limit = parseInt(String(args.count)) || 20;
     const qs = new URLSearchParams();
     if (args.session)
-        qs.set("sessionId", args.session);
+        qs.set("sessionId", String(args.session));
     qs.set("limit", String(Math.max(limit, args.favorites ? 200 : limit)));
     const path = `/api/history?${qs.toString()}`;
     let resp;
@@ -35,7 +37,8 @@ export default async function lsCmd(argv) {
         resp = await request(server.base, path);
     }
     catch (e) {
-        die(exitCodeForError(e), e.message);
+        const err = errInfo(e);
+        die(exitCodeForError(e), err.message);
     }
     let items = (resp.items || resp.history || []);
     if (args.favorites)

package/bin/commands/ls.ts

@@ -2,6 +2,7 @@ import { parseArgs } from "../lib/args.js";
 import { resolveServer, request } from "../lib/client.js";
 import { out, die, color, json, table, exitCodeForError } from "../lib/output.js";
 
+import { errInfo } from "../../lib/errInfo.js";
 const SPEC = {
   flags: {
     count:  { short: "n", type: "string", default: "20" },
@@ -13,7 +14,7 @@ const SPEC = {
   },
 };
 
-export default async function lsCmd(argv) {
+export default async function lsCmd(argv: string[]) {
   const args = parseArgs(argv, SPEC);
   if (args.help) {
     out("ima2 ls [-n count] [--session <id>] [--favorites] [--json]");
@@ -22,19 +23,21 @@ export default async function lsCmd(argv) {
 
   let server;
   try { server = await resolveServer({ serverFlag: args.server }); }
-  catch (e) { die(exitCodeForError(e), e.message); }
+  catch (e) {
+    const err = errInfo(e); die(exitCodeForError(e), err.message); }
 
-  const limit = parseInt(args.count) || 20;
+  const limit = parseInt(String(args.count)) || 20;
   const qs = new URLSearchParams();
-  if (args.session) qs.set("sessionId", args.session);
+  if (args.session) qs.set("sessionId", String(args.session));
   qs.set("limit", String(Math.max(limit, args.favorites ? 200 : limit)));
   const path = `/api/history?${qs.toString()}`;
   let resp;
   try { resp = await request(server.base, path); }
-  catch (e) { die(exitCodeForError(e), e.message); }
+  catch (e) {
+    const err = errInfo(e); die(exitCodeForError(e), err.message); }
 
-  let items = (resp.items || resp.history || []);
-  if (args.favorites) items = items.filter((it) => it.isFavorite === true);
+  let items: Record<string, unknown>[] = (resp.items || resp.history || []);
+  if (args.favorites) items = items.filter((it: Record<string, unknown>) => it.isFavorite === true);
   items = items.slice(0, limit);
 
   if (args.json) { json({ items }); return; }
@@ -47,12 +50,12 @@ export default async function lsCmd(argv) {
     { key: "filename", label: "FILENAME" },
     { key: "quality",  label: "Q" },
     { key: "size",     label: "SIZE" },
-    { key: "createdAt", label: "WHEN", format: (v) => {
+    { key: "createdAt", label: "WHEN", format: (v: unknown) => {
       if (!v) return "";
-      const d = new Date(v);
+      const d = new Date(v as string);
       return d.toISOString().replace("T", " ").slice(0, 19);
     } },
-    { key: "prompt", label: "PROMPT", format: (v) => {
+    { key: "prompt", label: "PROMPT", format: (v: unknown) => {
       const s = String(v || "").replace(/\s+/g, " ");
       return s.length > 48 ? s.slice(0, 45) + "…" : s;
     } },

package/bin/commands/metadata.js

@@ -36,7 +36,10 @@ export default async function metadataCmd(argv) {
     const resp = await request(server.base, "/api/metadata/read", {
         method: "POST",
         body: { dataUrl },
-    }).catch((e) => die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`));
+    }).catch((e) => {
+        const err = e;
+        die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`);
+    });
     if (args.json) {
         json(resp);
     }

package/bin/commands/metadata.ts

@@ -18,7 +18,7 @@ const HELP = `
   POSTs { dataUrl } to /api/metadata/read.
 `;
 
-export default async function metadataCmd(argv) {
+export default async function metadataCmd(argv: string[]) {
   const args = parseArgs(argv, SPEC);
   if (args.help) { out(HELP); return; }
   const file = args.positional[0];
@@ -30,7 +30,10 @@ export default async function metadataCmd(argv) {
   const resp = await request(server.base, "/api/metadata/read", {
     method: "POST",
     body: { dataUrl },
-  }).catch((e) => die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`));
+  }).catch((e: unknown) => {
+    const err = e as { message?: string; code?: string };
+    die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`);
+  });
   if (args.json) { json(resp); }
   else out(JSON.stringify(resp, null, 2));
 }

package/bin/commands/multimode.js

@@ -54,7 +54,7 @@ export default async function multimodeCmd(argv) {
     if (!prompt)
         die(2, "prompt required");
     const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-    if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+    if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
         die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
     }
     if (args["web-search"] && args["no-web-search"]) {
@@ -68,7 +68,7 @@ export default async function multimodeCmd(argv) {
         die(exitCodeForError(e), e.message);
         throw e;
     }
-    const maxImages = Math.max(1, Math.min(8, parseInt(args["max-images"]) || 4));
+    const maxImages = Math.max(1, Math.min(8, parseInt(String(args["max-images"])) || 4));
     const body = {
         prompt,
         quality: args.quality,
@@ -124,8 +124,8 @@ export default async function multimodeCmd(argv) {
         die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`);
     }
     // Save images
-    const outDir = args["out-dir"] || null;
-    const explicitOut = args.out || null;
+    const outDir = args["out-dir"] ? String(args["out-dir"]) : null;
+    const explicitOut = args.out ? String(args.out) : null;
     if (explicitOut && images.length > 1) {
         if (!args.json)
             out(color.yellow(`(received ${images.length} images, --out only saves first)`));

package/bin/commands/multimode.ts

@@ -1,4 +1,3 @@
-import { writeFile } from "fs/promises";
 import { parseArgs } from "../lib/args.js";
 import { resolveServer } from "../lib/client.js";
 import { streamSse } from "../lib/sse.js";
@@ -48,14 +47,14 @@ const HELP = `
         --timeout <sec>                 Default: 600
 `;
 
-export default async function multimodeCmd(argv) {
+export default async function multimodeCmd(argv: string[]) {
   const args = parseArgs(argv, SPEC);
   if (args.help) { out(HELP); return; }
   const prompt = args.positional.join(" ");
   if (!prompt) die(2, "prompt required");
 
   const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-  if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+  if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
     die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
   }
   if (args["web-search"] && args["no-web-search"]) {
@@ -66,7 +65,7 @@ export default async function multimodeCmd(argv) {
   try { server = await resolveServer({ serverFlag: args.server }); }
   catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
 
-  const maxImages = Math.max(1, Math.min(8, parseInt(args["max-images"]) || 4));
+  const maxImages = Math.max(1, Math.min(8, parseInt(String(args["max-images"])) || 4));
   const body: any = {
     prompt,
     quality: args.quality,
@@ -117,8 +116,8 @@ export default async function multimodeCmd(argv) {
   }
 
   // Save images
-  const outDir = args["out-dir"] || null;
-  const explicitOut = args.out || null;
+  const outDir = args["out-dir"] ? String(args["out-dir"]) : null;
+  const explicitOut = args.out ? String(args.out) : null;
   if (explicitOut && images.length > 1) {
     if (!args.json) out(color.yellow(`(received ${images.length} images, --out only saves first)`));
   }

package/bin/commands/node.js

@@ -53,9 +53,9 @@ async function generateSub(argv) {
     const prompt = args.positional.join(" ");
     if (!prompt)
         die(2, "prompt required");
-    const refs = args.ref || [];
+    const refs = (Array.isArray(args.ref) ? args.ref : []);
     const VALID_REASONING = new Set(["none", "low", "medium", "high", "xhigh"]);
-    if (args["reasoning-effort"] && !VALID_REASONING.has(args["reasoning-effort"])) {
+    if (args["reasoning-effort"] && !VALID_REASONING.has(String(args["reasoning-effort"]))) {
         die(2, "--reasoning-effort must be one of: none, low, medium, high, xhigh");
     }
     if (args["web-search"] && args["no-web-search"]) {
@@ -67,7 +67,7 @@ async function generateSub(argv) {
         prompt,
         quality: args.quality,
         size: args.size,
-        n: Math.max(1, Math.min(8, parseInt(args.count) || 1)),
+        n: Math.max(1, Math.min(8, parseInt(String(args.count)) || 1)),
         references,
         moderation: args.moderation,
         sessionId: args.session,
@@ -86,8 +86,8 @@ async function generateSub(argv) {
         const resp = await request(server.base, "/api/node/generate", {
             method: "POST",
             body,
-            timeoutMs: (parseInt(args.timeout) || 600) * 1000,
-        }).catch((e) => die(exitCodeForError(e), `${e.message}${e.code ? ` (${e.code})` : ""}`));
+            timeoutMs: (parseInt(String(args.timeout)) || 600) * 1000,
+        }).catch((e) => { const err = e; die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`); });
         if (args.json) {
             json(resp);
             return;
@@ -137,7 +137,7 @@ async function generateSub(argv) {
         if (!im.image)
             continue;
         const target = args.out && i === 0
-            ? args.out
+            ? String(args.out)
             : `${config.storage.generatedDir}/${defaultOutName(i, images.length)}`;
         await dataUriToFile(im.image, target);
         savedPaths.push(target);
@@ -156,7 +156,7 @@ async function showSub(argv) {
     if (!id)
         die(2, "nodeId required");
     const server = await getServer(args);
-    const resp = await request(server.base, `/api/node/${encodeURIComponent(id)}`).catch((e) => die(exitCodeForError(e), e.message));
+    const resp = await request(server.base, `/api/node/${encodeURIComponent(id)}`).catch((e) => { const err = e; die(exitCodeForError(e), err.message); });
     json(resp);
 }
 const SUB = {