@mrgoonie/multix 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.4](https://github.com/mrgoonie/multix-cli/compare/v1.0.3...v1.0.4) (2026-10-11)
+
+
+### Fixed
+
+* **core:** do not retry deterministic fetch failures ([#111](https://github.com/mrgoonie/multix-cli/issues/111)) ([8d2aa9b](https://github.com/mrgoonie/multix-cli/commit/8d2aa9baa3533cf199adc038911c9ea485b40083))
+
 ## [1.0.3](https://github.com/mrgoonie/multix-cli/compare/v1.0.2...v1.0.3) (2026-10-11)
 
 

package/dist/cli.js

@@ -58,8 +58,8 @@ var init_errors = __esm({
       code;
     };
     ConfigError = class extends MultixError {
-      constructor(message) {
-        super(message, "CONFIG_ERROR");
+      constructor(message, options) {
+        super(message, "CONFIG_ERROR", options);
         this.name = "ConfigError";
       }
     };
@@ -768,7 +768,11 @@ var PollTimeoutError = class extends MultixError {
 function isTransientHttpError(error) {
   if (!(error instanceof HttpError)) return false;
   const { status } = error;
-  return status === 0 || status === 408 || status === 429 || status >= 500;
+  return status === 408 || status === 429 || isRetryableServerStatus(status);
+}
+function isRetryableServerStatus(status) {
+  if (status === 501 || status === 505) return false;
+  return status === 0 || status >= 500;
 }
 var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function pollUntil(opts) {
@@ -817,6 +821,97 @@ async function pollUntil(opts) {
 // src/providers/atlascloud/client.ts
 init_errors();
 
+// src/core/fetch-error.ts
+init_errors();
+init_redact();
+var MAX_CAUSE_DEPTH = 4;
+var TLS_CODES = /* @__PURE__ */ new Set([
+  "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+  "SELF_SIGNED_CERT_IN_CHAIN",
+  "DEPTH_ZERO_SELF_SIGNED_CERT",
+  "ERR_TLS_CERT_ALTNAME_INVALID"
+]);
+function kindOfCode(code) {
+  if (typeof code !== "string") return void 0;
+  if (code === "ERR_INVALID_URL") return "url";
+  if (code === "ERR_INVALID_CHAR" || code === "ERR_INVALID_HTTP_TOKEN") return "header";
+  if (TLS_CODES.has(code) || code.startsWith("CERT_") || code.startsWith("UNABLE_TO_")) {
+    return "tls";
+  }
+  if (code === "UND_ERR_INVALID_ARG" || code === "UND_ERR_NOT_SUPPORTED") return "request";
+  return void 0;
+}
+function kindOfMessage(message) {
+  if (typeof message !== "string") return void 0;
+  if (/Invalid URL|Failed to parse URL/i.test(message)) return "url";
+  if (/ByteString|is not a legal HTTP header value|invalid header value|invalid header name/i.test(
+    message
+  )) {
+    return "header";
+  }
+  if (/duplex option is required|cannot have body|unexpected redirect/i.test(message)) {
+    return "request";
+  }
+  return void 0;
+}
+function causeChain(err2) {
+  const out = [];
+  let current = err2;
+  for (let depth = 0; depth <= MAX_CAUSE_DEPTH && current && typeof current === "object"; depth++) {
+    const e = current;
+    out.push(e);
+    if (Array.isArray(e.errors)) {
+      for (const member of e.errors) if (member && typeof member === "object") out.push(member);
+    }
+    current = e.cause;
+  }
+  return out;
+}
+function deterministicKind(err2) {
+  for (const e of causeChain(err2)) {
+    const kind = kindOfCode(e.code) ?? kindOfMessage(e.message);
+    if (kind) return kind;
+  }
+  return void 0;
+}
+function isNetworkFetchFailure(err2) {
+  return deterministicKind(err2) === void 0;
+}
+function scrub(message) {
+  return message.replace(/\b[a-z][a-z0-9+.-]*:\/\/[^\s"'<>]+/gi, (u) => redactUrl(u)).replace(/[?#](?!\[redacted\])[^\s"'<>]*=[^\s"'<>]*/g, "?[redacted]");
+}
+function messageOf(e) {
+  return typeof e?.message === "string" ? scrub(e.message) : "";
+}
+function detailOf(err2) {
+  const chain = causeChain(err2);
+  const parts = [messageOf(chain[0]), messageOf(chain[1])].filter(Boolean);
+  return parts.length > 0 ? parts.join(": ") : scrub(String(err2));
+}
+function toFetchError(err2, url, opts = {}) {
+  const options = { cause: err2 };
+  const prefix = opts.prefix ?? "";
+  const target = opts.target ?? redactUrl(url);
+  switch (deterministicKind(err2)) {
+    case "url":
+      return new ConfigError(`${prefix}Invalid request URL: ${target}`, options);
+    case "header":
+      return new ConfigError(
+        `${prefix}Invalid HTTP header value in the request to ${target}. Check the API key and other header values for non-ASCII characters such as smart quotes, or line breaks.`,
+        options
+      );
+    case "tls":
+    case "request":
+      return new ProviderError(
+        `${prefix}Request to ${target} failed: ${detailOf(err2)}`,
+        opts.provider ?? "http",
+        options
+      );
+    default:
+      return new HttpError(0, `${prefix}${detailOf(err2)}`, url, void 0, options);
+  }
+}
+
 // src/core/fetch-json.ts
 init_errors();
 
@@ -844,8 +939,7 @@ async function fetchFollowingRedirects(url, init = {}, opts = {}) {
       response = await doFetch(current, hopInit);
     } catch (cause) {
       if (!opts.wrapNetworkErrors) throw cause;
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      throw new HttpError(0, msg, current);
+      throw toFetchError(cause, current);
     }
     if (validateUrl && response.url && response.url !== current) {
       try {
@@ -913,8 +1007,7 @@ async function fetchWithValidatedRedirects(url, opts = {}) {
     try {
       return { response: await doFetch(url, init), url };
     } catch (cause) {
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      throw new HttpError(0, msg, url);
+      throw toFetchError(cause, url);
     }
   }
   return fetchFollowingRedirects(url, init, {
@@ -1365,7 +1458,7 @@ var AtlasCloudClient = class {
       );
     } catch (cause) {
       if (cause instanceof HttpError) throw cause;
-      throw new HttpError(0, cause instanceof Error ? cause.message : String(cause), url);
+      throw toFetchError(cause, url, { provider: "atlascloud" });
     }
     if (!response.ok) throw await httpErrorFromResponse(response, url);
     const json = await response.json();
@@ -1688,8 +1781,7 @@ async function fetchBytes(urlOrDataUri) {
       signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS)
     });
   } catch (cause) {
-    const msg = cause instanceof Error ? cause.message : String(cause);
-    throw new HttpError(0, msg, urlOrDataUri);
+    throw toFetchError(cause, urlOrDataUri);
   }
   if (!response.ok) {
     throw new HttpError(response.status, "(bytes fetch failed)", urlOrDataUri);
@@ -4231,11 +4323,17 @@ function apiPostJson(endpoint2, payload, apiKey, opts = {}) {
 }
 async function apiDelete(endpoint2, apiKey) {
   const url = `${ELEVENLABS_BASE_URL}/${endpoint2.replace(/^\//, "")}`;
-  const res = await fetchSameOrigin(url, {
-    method: "DELETE",
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS2)
-  });
+  let res;
+  try {
+    res = await fetchSameOrigin(url, {
+      method: "DELETE",
+      headers: authHeaders(apiKey),
+      signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS2)
+    });
+  } catch (cause) {
+    if (cause instanceof HttpError) throw cause;
+    throw toFetchError(cause, url, { provider: "elevenlabs" });
+  }
   if (!res.ok) {
     const text = await res.text().catch(() => "");
     throw new HttpError(res.status, text.slice(0, 500), url);
@@ -4268,8 +4366,7 @@ async function apiPostBinary(endpoint2, body, apiKey, opts = {}) {
     res = await fetchSameOrigin(url.toString(), init);
   } catch (cause) {
     if (cause instanceof HttpError) throw cause;
-    const msg = cause instanceof Error ? cause.message : String(cause);
-    throw new HttpError(0, msg, url.toString());
+    throw toFetchError(cause, url.toString(), { provider: "elevenlabs" });
   }
   if (!res.ok) {
     const text = await res.text().catch(() => "");
@@ -4289,8 +4386,7 @@ async function apiPostMultipart(endpoint2, form, apiKey, opts = {}) {
     });
   } catch (cause) {
     if (cause instanceof HttpError) throw cause;
-    const msg = cause instanceof Error ? cause.message : String(cause);
-    throw new HttpError(0, msg, url);
+    throw toFetchError(cause, url, { provider: "elevenlabs" });
   }
   if (!res.ok) {
     const text = await res.text().catch(() => "");
@@ -4916,9 +5012,9 @@ var FAL_DEFAULTS = {
 };
 
 // src/providers/fal/run-helpers.ts
-init_errors();
 import fs19 from "fs";
 import path22 from "path";
+init_errors();
 init_redact();
 
 // src/providers/fal/client.ts
@@ -5039,7 +5135,7 @@ function parseInputArg(raw) {
   return parseJsonInput(raw);
 }
 function isTransientError(e) {
-  if (e instanceof HttpError) return e.status === 0 || e.status >= 500;
+  if (e instanceof HttpError) return isRetryableServerStatus(e.status);
   return false;
 }
 function sleep(ms, signal) {
@@ -5646,6 +5742,13 @@ async function uploadFetch(url, init, timeoutMs, step) {
     if (redirected || timedOut && step === "upload") {
       throw new ProviderError(message, "gemini", { cause: err2 });
     }
+    if (!isNetworkFetchFailure(err2)) {
+      throw toFetchError(err2, FILES_BASE, {
+        provider: "gemini",
+        prefix: "File upload failed: ",
+        target: step === "start" ? FILES_BASE : "the upload session URL"
+      });
+    }
     throw new HttpError(0, message, FILES_BASE, void 0, { cause: err2 });
   }
   if (!resp.ok) {
@@ -7268,7 +7371,7 @@ var HeygenClient = class {
       return Math.min(error.retryAfterMs, MAX_RETRY_WAIT_MS);
     }
     if (!key) return void 0;
-    if (error.status === 0 || error.status >= 500 || code === "request_in_progress") {
+    if (isRetryableServerStatus(error.status) || code === "request_in_progress") {
       return Math.min(1e3 * 2 ** (attempt - 1), MAX_RETRY_WAIT_MS);
     }
     return void 0;
@@ -7430,8 +7533,9 @@ var HeygenClient = class {
         );
       } catch (cause) {
         if (cause instanceof HttpError) throw toHeygenApiError(cause);
-        const msg = cause instanceof Error ? cause.message : String(cause);
-        const err3 = toHeygenApiError(new HttpError(0, msg, url));
+        const failure = toFetchError(cause, url, { provider: "heygen" });
+        if (!(failure instanceof HttpError)) throw failure;
+        const err3 = toHeygenApiError(failure);
         if (attempt >= this.maxAttempts) throw err3;
         await this.sleep(this.retryDelay(err3, key, attempt) ?? 1e3);
         continue;
@@ -10298,7 +10402,7 @@ async function postOpenAIForm(pathname, form, apiKey, timeoutMs = DEFAULT_TIMEOU
     });
   } catch (cause) {
     if (cause instanceof HttpError) throw cause;
-    throw new HttpError(0, cause instanceof Error ? cause.message : String(cause), url);
+    throw toFetchError(cause, url, { provider: "openai" });
   }
   if (!res.ok) {
     const text = await res.text().catch(() => "");
@@ -10318,7 +10422,7 @@ async function postOpenAIBinary(pathname, body, apiKey, timeoutMs = DEFAULT_TIME
     });
   } catch (cause) {
     if (cause instanceof HttpError) throw cause;
-    throw new HttpError(0, cause instanceof Error ? cause.message : String(cause), url);
+    throw toFetchError(cause, url, { provider: "openai" });
   }
   if (!res.ok) {
     const text = await res.text().catch(() => "");
@@ -11424,8 +11528,8 @@ var CREATE_RETRY_CAP_MS = 3e4;
 var REQUEST_TIMEOUT_MS = 6e4;
 var UPLOAD_TIMEOUT_MS = 3e5;
 var ReplicateApiError = class extends ProviderError {
-  constructor(message, status, retryAfterMs) {
-    super(message, PROVIDER);
+  constructor(message, status, retryAfterMs, options) {
+    super(message, PROVIDER, options);
     this.status = status;
     this.retryAfterMs = retryAfterMs;
     this.name = "ReplicateApiError";
@@ -11485,7 +11589,7 @@ function mapReplicateError(error, subject) {
   } else {
     message = `Replicate request for ${subject} failed (${status})${suffix}`;
   }
-  return new ReplicateApiError(message, status, retryAfterMs);
+  return new ReplicateApiError(message, status, retryAfterMs, { cause: error });
 }
 var ORPHAN_HINT = "The prediction may have been created anyway (Replicate has no idempotency key); check https://replicate.com/predictions before retrying to avoid paying twice";
 function withOrphanHint(error) {
@@ -11493,10 +11597,14 @@ function withOrphanHint(error) {
     const { status } = error;
     const mayExist = status === 0 || status >= 200 && status < 300 || status >= 500;
     if (!mayExist) return error;
-    return new ReplicateApiError(`${error.message}. ${ORPHAN_HINT}`, status, error.retryAfterMs);
+    return new ReplicateApiError(`${error.message}. ${ORPHAN_HINT}`, status, error.retryAfterMs, {
+      cause: error.cause
+    });
   }
   if (error instanceof ProviderError) {
-    return new ProviderError(`${error.message}. ${ORPHAN_HINT}`, error.provider);
+    return new ProviderError(`${error.message}. ${ORPHAN_HINT}`, error.provider, {
+      cause: error.cause
+    });
   }
   return error;
 }
@@ -11650,8 +11758,7 @@ var ReplicateClient = class {
       );
     } catch (cause) {
       if (cause instanceof HttpError) throw mapReplicateError(cause, subject);
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      throw mapReplicateError(new HttpError(0, msg, url), subject);
+      throw mapReplicateError(toFetchError(cause, url, { provider: PROVIDER }), subject);
     }
     if (!response.ok) {
       if (response.status === 413) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrgoonie/multix",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "AI multimodal CLI — OpenAI, Gemini, MiniMax, OpenRouter, Leonardo, BytePlus, ElevenLabs, fal.ai, Atlas Cloud, Replicate, HeyGen, ffmpeg, ImageMagick, doc-to-md",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: multix
 description: AI multimodal CLI — generate and edit images (OpenAI, Codex driver, Gemini Nano Banana, Imagen, MiniMax, OpenRouter, Leonardo, BytePlus Seedream, Cloudflare Workers AI FLUX.1 Schnell, fal.ai FLUX, Replicate FLUX), generate video (Gemini Veo, MiniMax Hailuo, OpenRouter via Veo/Seedance/Kling, Leonardo via Motion/Veo/Kling/Hailuo/Seedance/LTX, BytePlus Seedance, Cloudflare AI Gateway via Replicate, fal.ai queue models, Replicate direct API models incl. P-Video, HeyGen Video Agent and scripted avatar videos), video translation and lipsync (HeyGen), TTS/STT/music (OpenAI, Gemini Flash TTS incl. Gemini 3.8 with delivery-style control, MiniMax, Cloudflare Workers AI MeloTTS, ElevenLabs), 3D models (BytePlus Hyper3D/Hitem3d), analyze/transcribe media, convert documents to Markdown, optimize media via ffmpeg/ImageMagick, and self-update the CLI. Use whenever the user wants to create, edit, or transform images/video/audio/3D/documents from a CLI, mentions any of: OpenAI, Codex image driver, image-to-image, i2i, image edit, watercolor/cyberpunk style transfer, reference image, OpenRouter, Nano Banana, Flux, Seedream, Veo, Hailuo, Seedance, Kling, Cloudflare Workers AI, AI Gateway, fal.ai, Atlas Cloud, Replicate, replicate.com models, Replicate predictions, HeyGen, avatar video, talking head, Video Agent, video translation, dubbing, lipsync, video generation, text-to-video, image-to-video, i2v, ElevenLabs voice cloning, updating/upgrading multix, or asks for batch media optimization.
-version: 1.0.3 # x-release-please-version
+version: 1.0.4 # x-release-please-version
 ---
 
 # multix — AI Multimodal CLI