@mrgoonie/multix 0.14.1 → 0.15.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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).
 
+## [0.15.1](https://github.com/mrgoonie/multix-cli/compare/v0.15.0...v0.15.1) (2026-10-11)
+
+
+### Performance
+
+* **gemini:** stream file uploads with resumable Files API ([#85](https://github.com/mrgoonie/multix-cli/issues/85)) ([b2cc886](https://github.com/mrgoonie/multix-cli/commit/b2cc886cf5bdf960e88aeea5155ae2623547d918))
+
+## [0.15.0](https://github.com/mrgoonie/multix-cli/compare/v0.14.1...v0.15.0) (2026-10-11)
+
+
+### Added
+
+* **mcp:** add Streamable HTTP MCP server for Cloudflare Workers ([#91](https://github.com/mrgoonie/multix-cli/issues/91)) ([45a662c](https://github.com/mrgoonie/multix-cli/commit/45a662c638d9211009e429bc129edc913a010729))
+
 ## [0.14.1](https://github.com/mrgoonie/multix-cli/compare/v0.14.0...v0.14.1) (2026-10-11)
 
 

package/README.md

@@ -99,6 +99,7 @@ Set at least one provider key. Add to `.env` in your project root or `~/.multix/
 | `CLOUDFLARE_AI_TTS_MODEL` | No | Speech model setting; only `@cf/myshell-ai/melotts` is accepted |
 | `MULTIX_OUTPUT_DIR` | No | Override default output dir (`./multix-output`) |
 | `MULTIX_MAX_DOWNLOAD_MB` | No | Size limit per downloaded Replicate output file (default `2048`) |
+| `MULTIX_UPLOAD_MIN_KBPS` | No | Slowest Gemini Files API upload speed to allow for, in KB/s (default `1000`); lower it on slow links |
 | `MULTIX_IMAGE_FORMAT` | No | `webp` (default) or `original` to keep provider image format/quality |
 | `OPENROUTER_IMAGE_MODEL` | No | Default OpenRouter model |
 | `OPENROUTER_FALLBACK_MODELS` | No | Comma-separated fallback model ids |
@@ -674,6 +675,37 @@ Thumbnail detection is automatic: if the provider response includes any of `cove
 
 Cloudflare video is intentionally separate: it has no thumbnail flags, and `generate-video --wait` already saves the completed MP4. See [`multix cloudflare`](#multix-cloudflare) for its exact polling and download behavior.
 
+## Remote MCP server (Cloudflare Workers)
+
+`worker/` contains an optional, stateless MCP server that exposes remote-safe
+image and video tools over Streamable HTTP at `/mcp`, for agents that cannot
+run the CLI locally. It is a separate package and is not included in the npm
+CLI.
+
+- Tools: `multix_list_providers`, `multix_generate_image` (Replicate, Atlas
+  Cloud), `multix_generate_video` (Replicate, Atlas Cloud, HeyGen, Cloudflare
+  AI Gateway; returns an ID without blocking), `multix_prediction_status`,
+  `multix_prediction_cancel` (Replicate). Results are provider URLs, not bytes.
+- Auth: `Authorization: Bearer <MCP_AUTH_TOKEN>` (at least 32 characters; the
+  server returns `503` if it is unset). `/health` is public.
+- Single-tenant: provider keys are Worker secrets, and every caller spends the
+  deployer's credits. Limit exposure with `MULTIX_MCP_ALLOWED_PROVIDERS`,
+  `MULTIX_MCP_ALLOWED_MODELS`, `MULTIX_MCP_MAX_OUTPUTS`,
+  `MULTIX_MCP_MAX_VIDEO_SECONDS` (also sent as `min(5, cap)` when a caller
+  omits `duration`), `MULTIX_MCP_ALLOWED_RESOLUTIONS` (default
+  `480p,720p,1080p`), `MULTIX_MCP_ALLOWED_ORIGINS` (browser origins, with
+  CORS), and the approximate per-IP rate limiter. JSON-RPC batches are
+  rejected.
+
+```bash
+npm ci --prefix worker
+cd worker && openssl rand -hex 32 | npx wrangler secret put MCP_AUTH_TOKEN
+npx wrangler secret put REPLICATE_API_TOKEN   # and any other provider keys
+cd .. && npm run deploy:mcp                   # or: npm run dev:mcp (local, port 8787)
+```
+
+Full guide: [Remote MCP server](https://multix.zuey.me/guides/mcp-server/).
+
 ## Troubleshooting
 
 **No API key found:** Run `multix check` — it prints setup instructions.

package/dist/cli.js

@@ -46,13 +46,14 @@ var init_errors = __esm({
     "use strict";
     init_redact();
     MultixError = class extends Error {
-      constructor(message, code) {
-        super(message);
+      constructor(message, code, options) {
+        super(message, options);
         this.code = code;
         this.name = "MultixError";
-        if (Error.captureStackTrace) {
-          Error.captureStackTrace(this, this.constructor);
-        }
+        Error.captureStackTrace?.(
+          this,
+          this.constructor
+        );
       }
       code;
     };
@@ -63,8 +64,8 @@ var init_errors = __esm({
       }
     };
     ProviderError = class extends MultixError {
-      constructor(message, provider) {
-        super(message, "PROVIDER_ERROR");
+      constructor(message, provider, options) {
+        super(message, "PROVIDER_ERROR", options);
         this.provider = provider;
         this.name = "ProviderError";
       }
@@ -77,8 +78,8 @@ var init_errors = __esm({
       }
     };
     HttpError = class extends MultixError {
-      constructor(status, snippet, url, retryAfterMs) {
-        super(`HTTP ${status} from ${redactUrl(url)}: ${snippet}`, "HTTP_ERROR");
+      constructor(status, snippet, url, retryAfterMs, options) {
+        super(`HTTP ${status} from ${redactUrl(url)}: ${snippet}`, "HTTP_ERROR", options);
         this.status = status;
         this.snippet = snippet;
         this.retryAfterMs = retryAfterMs;
@@ -640,8 +641,8 @@ function predictionErrorMessage(error) {
   }
   return "";
 }
-function collectOutputs(prediction2) {
-  const raw = prediction2.outputs ?? prediction2.output;
+function collectOutputs(prediction) {
+  const raw = prediction.outputs ?? prediction.output;
   const list = Array.isArray(raw) ? raw : raw ? [raw] : [];
   const out = [];
   for (const item of list) {
@@ -751,16 +752,16 @@ function defaultExtensionFor(category) {
       return "bin";
   }
 }
-function classifyOutputs(prediction2) {
-  const outputs = collectOutputs(prediction2);
+function classifyOutputs(prediction) {
+  const outputs = collectOutputs(prediction);
   if (outputs.length === 0) return { mode: "empty" };
   const urls = outputs.filter(isMediaOutput);
   const texts = outputs.filter((o) => !isMediaOutput(o));
   if (urls.length === 0) return { mode: "text", texts };
   return { mode: "media", urls, texts };
 }
-function hasNsfwFlag(prediction2) {
-  return Array.isArray(prediction2.has_nsfw_contents) && prediction2.has_nsfw_contents.some(Boolean);
+function hasNsfwFlag(prediction) {
+  return Array.isArray(prediction.has_nsfw_contents) && prediction.has_nsfw_contents.some(Boolean);
 }
 function outputFileName(predictionId, index, ext) {
   const prefix = predictionId.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 8) || "output";
@@ -773,10 +774,10 @@ var DEFAULT_UPLOAD_TIMEOUT_MS = 3e5;
 var CATALOG_TIMEOUT_MS = 15e3;
 var PREDICTION_ID_RE = /^[A-Za-z0-9_-]{1,128}$/;
 var AtlasPredictionFailedError = class extends ProviderError {
-  constructor(prediction2) {
-    const reason = predictionErrorMessage(prediction2.error) || `status "${prediction2.status}"`;
-    super(`Atlas Cloud prediction ${prediction2.id} failed: ${reason}`, ATLAS_PROVIDER);
-    this.prediction = prediction2;
+  constructor(prediction) {
+    const reason = predictionErrorMessage(prediction.error) || `status "${prediction.status}"`;
+    super(`Atlas Cloud prediction ${prediction.id} failed: ${reason}`, ATLAS_PROVIDER);
+    this.prediction = prediction;
     this.name = "AtlasPredictionFailedError";
   }
   prediction;
@@ -786,11 +787,11 @@ function assertValidPredictionId(id) {
     throw new ValidationError(`Invalid Atlas Cloud prediction id: "${id}"`);
   }
 }
-function assertPredictionSucceeded(prediction2) {
-  if (isFailureStatus(prediction2.status)) throw new AtlasPredictionFailedError(prediction2);
-  if (!isSuccessStatus(prediction2.status)) {
+function assertPredictionSucceeded(prediction) {
+  if (isFailureStatus(prediction.status)) throw new AtlasPredictionFailedError(prediction);
+  if (!isSuccessStatus(prediction.status)) {
     throw new ProviderError(
-      `Atlas Cloud prediction ${prediction2.id} is not finished (status "${prediction2.status}")`,
+      `Atlas Cloud prediction ${prediction.id} is not finished (status "${prediction.status}")`,
       ATLAS_PROVIDER
     );
   }
@@ -1694,22 +1695,22 @@ function planOutputPaths(urls, cfg) {
   const base = abs.slice(0, -path7.extname(abs).length);
   return exts.map((ext, i) => `${base}-${String(i + 1).padStart(2, "0")}.${ext}`);
 }
-async function deliverPrediction(prediction2, cfg) {
+async function deliverPrediction(prediction, cfg) {
   const { logger, opts } = cfg;
-  if (prediction2.price !== void 0 && prediction2.price !== "") {
-    logger.info(`Cost: $${prediction2.price}`);
+  if (prediction.price !== void 0 && prediction.price !== "") {
+    logger.info(`Cost: $${prediction.price}`);
   }
-  const classified = classifyOutputs(prediction2);
+  const classified = classifyOutputs(prediction);
   if (classified.mode === "empty") {
     throw new ProviderError(
-      hasNsfwFlag(prediction2) ? `Prediction ${prediction2.id} returned no output: blocked by content safety (has_nsfw_contents). Try a different prompt or input.` : `Prediction ${prediction2.id} completed but returned no outputs.`,
+      hasNsfwFlag(prediction) ? `Prediction ${prediction.id} returned no output: blocked by content safety (has_nsfw_contents). Try a different prompt or input.` : `Prediction ${prediction.id} completed but returned no outputs.`,
       ATLAS_PROVIDER
     );
   }
   for (const text of classified.texts) console.log(text);
   if (classified.mode === "text") {
     if (opts.output) {
-      const dest = isDirectoryOutput(opts.output) ? path7.resolve(opts.output, outputFileName(prediction2.id, 0, "txt")) : path7.resolve(opts.output);
+      const dest = isDirectoryOutput(opts.output) ? path7.resolve(opts.output, outputFileName(prediction.id, 0, "txt")) : path7.resolve(opts.output);
       fs8.mkdirSync(path7.dirname(dest), { recursive: true });
       fs8.writeFileSync(dest, `${classified.texts.join("\n\n")}
 `, "utf8");
@@ -1723,7 +1724,7 @@ async function deliverPrediction(prediction2, cfg) {
     return { files: [], texts: classified.texts };
   }
   const dests = planOutputPaths(classified.urls, {
-    predictionId: prediction2.id,
+    predictionId: prediction.id,
     outDir: getOutputDir,
     output: opts.output,
     hint: cfg.hint
@@ -1751,7 +1752,7 @@ async function deliverPrediction(prediction2, cfg) {
   }
   if (saved.length === 0) {
     throw new ProviderError(
-      `Prediction ${prediction2.id} produced ${classified.urls.length} output(s) but none downloaded. Retry with: ${resumeCommand(prediction2.id)}`,
+      `Prediction ${prediction.id} produced ${classified.urls.length} output(s) but none downloaded. Retry with: ${resumeCommand(prediction.id)}`,
       ATLAS_PROVIDER
     );
   }
@@ -1766,14 +1767,14 @@ async function deliverPrediction(prediction2, cfg) {
   const files = saved.map((f) => finalImages[images.indexOf(f)] ?? f);
   const firstVideo = files.find((f) => outputCategory(f) === "video");
   if (firstVideo) {
-    await maybeDownloadThumb(prediction2, firstVideo, { skip: opts.thumb === false, logger });
+    await maybeDownloadThumb(prediction, firstVideo, { skip: opts.thumb === false, logger });
   }
   console.log(`
-Prediction ${prediction2.id}: saved ${files.length} file(s)`);
+Prediction ${prediction.id}: saved ${files.length} file(s)`);
   for (const f of files) console.log(`  ${f}`);
   if (failed > 0) {
     throw new ProviderError(
-      `Prediction ${prediction2.id}: downloaded ${saved.length} of ${classified.urls.length} output(s); ${failed} failed. Saved: ${files.join(", ")}. Retry with: ${resumeCommand(prediction2.id)}`,
+      `Prediction ${prediction.id}: downloaded ${saved.length} of ${classified.urls.length} output(s); ${failed} failed. Saved: ${files.join(", ")}. Retry with: ${resumeCommand(prediction.id)}`,
       ATLAS_PROVIDER
     );
   }
@@ -2005,18 +2006,18 @@ function registerAtlasStatusCommand(parent) {
     const logger = createLogger({ verbose: opts.verbose ?? false });
     const client = createAtlasClientFromEnv();
     const wait = Boolean(opts.wait || opts.download);
-    const prediction2 = wait ? await client.waitForPrediction(predictionId, {
+    const prediction = wait ? await client.waitForPrediction(predictionId, {
       timeoutMs: parseTimeoutMs(opts.waitTimeout, STATUS_WAIT_MS),
       resumeHint: `Resume with: ${resumeCommand(predictionId)}`,
       onPoll: (p, n) => logger.debug(`poll ${n}: ${p.status}`)
     }) : await client.getPrediction(predictionId);
     if (!opts.download) {
-      console.log(JSON.stringify(prediction2, null, 2));
-      if (isFailureStatus(prediction2.status)) throw new AtlasPredictionFailedError(prediction2);
+      console.log(JSON.stringify(prediction, null, 2));
+      if (isFailureStatus(prediction.status)) throw new AtlasPredictionFailedError(prediction);
       return;
     }
-    assertPredictionSucceeded(prediction2);
-    await deliverPrediction(prediction2, { logger, opts: { ...opts, download: true } });
+    assertPredictionSucceeded(prediction);
+    await deliverPrediction(prediction, { logger, opts: { ...opts, download: true } });
   });
 }
 
@@ -3075,9 +3076,13 @@ init_errors();
 
 // src/providers/cloudflare/models.ts
 init_errors();
+
+// src/providers/cloudflare/model-ids.ts
 var CLOUDFLARE_IMAGE_MODEL = "@cf/black-forest-labs/flux-1-schnell";
 var CLOUDFLARE_TTS_MODEL = "@cf/myshell-ai/melotts";
 var CLOUDFLARE_VIDEO_MODEL = "prunaai/p-video";
+
+// src/providers/cloudflare/models.ts
 function required(name) {
   const value = resolveKey(name)?.trim();
   if (!value) throw new ConfigError(`${name} is required for Cloudflare media generation`);
@@ -3121,6 +3126,68 @@ function requireCloudflareVideoConfig() {
   };
 }
 
+// src/providers/cloudflare/video-client.ts
+init_errors();
+function cloudflareProviderFailure(status) {
+  return new ProviderError(`Cloudflare request failed with HTTP ${status}`, "Cloudflare");
+}
+async function readCloudflareJson(response) {
+  if (!response.ok) throw cloudflareProviderFailure(response.status);
+  try {
+    return await response.json();
+  } catch {
+    throw new ProviderError("Cloudflare returned an invalid JSON response", "Cloudflare");
+  }
+}
+function videoUrl(config, suffix = "") {
+  return `https://gateway.ai.cloudflare.com/v1/${encodeURIComponent(config.accountId)}/${encodeURIComponent(config.gatewayId)}/replicate/predictions${suffix}`;
+}
+function videoHeaders(config, opts) {
+  return {
+    Authorization: `Bearer ${config.replicateApiToken}`,
+    "cf-aig-authorization": `Bearer ${config.apiToken}`,
+    "cf-aig-collect-log-payload": opts.collectLogPayload ? "true" : "false",
+    "Content-Type": "application/json",
+    ...opts.wait ? { Prefer: "wait" } : {}
+  };
+}
+function send(opts, url, init) {
+  const f = opts.fetch;
+  const withTimeout = {
+    ...init,
+    signal: AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS)
+  };
+  return f ? f(url, withTimeout) : globalThis.fetch(url, withTimeout);
+}
+function parseCloudflareVideoPrediction(value) {
+  if (!value || typeof value !== "object") {
+    throw new ProviderError("Cloudflare returned an invalid video prediction", "Cloudflare");
+  }
+  const result = value;
+  if (typeof result.id !== "string" || typeof result.status !== "string") {
+    throw new ProviderError("Cloudflare returned an invalid video prediction", "Cloudflare");
+  }
+  const output = result.output === null ? void 0 : result.output;
+  if (output !== void 0 && typeof output !== "string" && (!Array.isArray(output) || !output.every((item) => typeof item === "string"))) {
+    throw new ProviderError("Cloudflare returned an invalid video output", "Cloudflare");
+  }
+  return { id: result.id, status: result.status, output };
+}
+async function createCloudflareVideoPrediction(config, input, opts = {}) {
+  const response = await send(opts, videoUrl(config), {
+    method: "POST",
+    headers: videoHeaders(config, opts),
+    body: JSON.stringify({ version: CLOUDFLARE_VIDEO_MODEL, input })
+  });
+  return parseCloudflareVideoPrediction(await readCloudflareJson(response));
+}
+async function getCloudflareVideoPrediction(config, id, opts = {}) {
+  const response = await send(opts, videoUrl(config, `/${encodeURIComponent(id)}`), {
+    headers: videoHeaders(config, { ...opts, wait: false })
+  });
+  return parseCloudflareVideoPrediction(await readCloudflareJson(response));
+}
+
 // src/providers/cloudflare/client.ts
 function collectPayloadHeader() {
   const envName = ["CLOUDFLARE", "AI", "GATEWAY", "COLLECT", "LOG", "PAYLOAD"].join("_");
@@ -3134,17 +3201,6 @@ function gatewayHeaders(config) {
     "cf-aig-collect-log-payload": collectPayloadHeader()
   };
 }
-function providerFailure(status) {
-  return new ProviderError(`Cloudflare request failed with HTTP ${status}`, "Cloudflare");
-}
-async function readJson(response) {
-  if (!response.ok) throw providerFailure(response.status);
-  try {
-    return await response.json();
-  } catch {
-    throw new ProviderError("Cloudflare returned an invalid JSON response", "Cloudflare");
-  }
-}
 function nativeUrl(accountId, model) {
   return `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(accountId)}/ai/run/${model}`;
 }
@@ -3162,7 +3218,7 @@ async function runCloudflareJson(model, input) {
       body: JSON.stringify(useGateway ? { model, input } : input)
     }
   );
-  const payload = await readJson(response);
+  const payload = await readCloudflareJson(response);
   if (payload.success === false || payload.result === void 0) {
     throw new ProviderError("Cloudflare returned no usable result", "Cloudflare");
   }
@@ -3179,53 +3235,23 @@ async function runCloudflareBytes(model, input) {
       body: JSON.stringify(useGateway ? { model, input } : input)
     }
   );
-  if (!response.ok) throw providerFailure(response.status);
+  if (!response.ok) throw cloudflareProviderFailure(response.status);
   const contentType = response.headers.get("content-type") ?? "";
   if (!contentType.includes("audio/mpeg")) {
     throw new ProviderError("Cloudflare did not return MPEG audio", "Cloudflare");
   }
   return new Uint8Array(await response.arrayBuffer());
 }
-function videoUrl(config, suffix = "") {
-  return `https://gateway.ai.cloudflare.com/v1/${encodeURIComponent(config.accountId)}/${encodeURIComponent(config.gatewayId)}/replicate/predictions${suffix}`;
-}
-function videoHeaders(config, wait = false) {
-  return {
-    Authorization: `Bearer ${config.replicateApiToken}`,
-    "cf-aig-authorization": `Bearer ${config.apiToken}`,
-    "cf-aig-collect-log-payload": collectPayloadHeader(),
-    "Content-Type": "application/json",
-    ...wait ? { Prefer: "wait" } : {}
-  };
-}
-function prediction(value) {
-  if (!value || typeof value !== "object") {
-    throw new ProviderError("Cloudflare returned an invalid video prediction", "Cloudflare");
-  }
-  const result = value;
-  if (typeof result.id !== "string" || typeof result.status !== "string") {
-    throw new ProviderError("Cloudflare returned an invalid video prediction", "Cloudflare");
-  }
-  if (result.output !== void 0 && typeof result.output !== "string" && (!Array.isArray(result.output) || !result.output.every((item) => typeof item === "string"))) {
-    throw new ProviderError("Cloudflare returned an invalid video output", "Cloudflare");
-  }
-  return { id: result.id, status: result.status, output: result.output };
-}
 async function createVideoPrediction(input, wait = false) {
-  const config = requireCloudflareVideoConfig();
-  const response = await globalThis.fetch(videoUrl(config), {
-    method: "POST",
-    headers: videoHeaders(config, wait),
-    body: JSON.stringify({ version: CLOUDFLARE_VIDEO_MODEL, input })
+  return createCloudflareVideoPrediction(requireCloudflareVideoConfig(), input, {
+    wait,
+    collectLogPayload: collectPayloadHeader() === "true"
   });
-  return prediction(await readJson(response));
 }
 async function getVideoPrediction(id) {
-  const config = requireCloudflareVideoConfig();
-  const response = await globalThis.fetch(videoUrl(config, `/${encodeURIComponent(id)}`), {
-    headers: videoHeaders(config)
+  return getCloudflareVideoPrediction(requireCloudflareVideoConfig(), id, {
+    collectLogPayload: collectPayloadHeader() === "true"
   });
-  return prediction(await readJson(response));
 }
 async function downloadVideo2(url) {
   let response;
@@ -3302,20 +3328,20 @@ function positiveInteger(value, flag) {
     throw new ValidationError(`${flag} must be a positive integer`);
   return parsed;
 }
-function outputUrl(prediction2) {
-  if (typeof prediction2.output === "string") return prediction2.output;
-  return prediction2.output?.find((value) => typeof value === "string");
+function outputUrl(prediction) {
+  if (typeof prediction.output === "string") return prediction.output;
+  return prediction.output?.find((value) => typeof value === "string");
 }
-async function saveCompletedVideo(prediction2, output) {
-  const url = outputUrl(prediction2);
+async function saveCompletedVideo(prediction, output) {
+  const url = outputUrl(prediction);
   if (!url)
     throw new ProviderError("Cloudflare completed the video without an output", "Cloudflare");
   const bytes = await downloadVideo2(url);
-  return saveBytes(bytes, `cloudflare_video_${prediction2.id}.mp4`, output);
+  return saveBytes(bytes, `cloudflare_video_${prediction.id}.mp4`, output);
 }
-async function waitForVideo(prediction2, timeoutMs, onTick) {
+async function waitForVideo(prediction, timeoutMs, onTick) {
   const deadline = Date.now() + timeoutMs;
-  let current = prediction2;
+  let current = prediction;
   while (!isTerminalVideoStatus(current.status)) {
     if (Date.now() >= deadline)
       throw new ProviderError("Cloudflare video polling timed out", "Cloudflare");
@@ -3347,15 +3373,15 @@ function registerCloudflareVideoCommand(parent) {
         fps: positiveInteger(opts.fps, "--fps")
       };
       const shouldWait = Boolean(opts.wait || opts.download);
-      const prediction2 = await createVideoPrediction(input, shouldWait);
-      logger.success(`Video job ${prediction2.id} (${prediction2.status})`);
+      const prediction = await createVideoPrediction(input, shouldWait);
+      logger.success(`Video job ${prediction.id} (${prediction.status})`);
       if (!shouldWait) {
-        console.log(prediction2.id);
-        console.error(`Poll with: multix cloudflare video-status ${prediction2.id}`);
+        console.log(prediction.id);
+        console.error(`Poll with: multix cloudflare video-status ${prediction.id}`);
         return;
       }
-      const completed = prediction2.status === "succeeded" ? prediction2 : await waitForVideo(
-        prediction2,
+      const completed = prediction.status === "succeeded" ? prediction : await waitForVideo(
+        prediction,
         positiveInteger(opts.waitTimeout, "--wait-timeout"),
         (status) => logger.debug(`Video status: ${status}`)
       );
@@ -3405,12 +3431,12 @@ function registerCloudflareVideoStatusCommand(parent) {
     async (id, opts) => {
       const logger = createLogger({ verbose: opts.verbose ?? false });
       const shouldWait = Boolean(opts.wait || opts.download);
-      const prediction2 = await getVideoPrediction(id);
-      const completed = shouldWait && prediction2.status !== "succeeded" ? await waitForVideo(
-        prediction2,
+      const prediction = await getVideoPrediction(id);
+      const completed = shouldWait && prediction.status !== "succeeded" ? await waitForVideo(
+        prediction,
         positiveInteger(opts.waitTimeout, "--wait-timeout"),
         (status) => logger.debug(`Video status: ${status}`)
-      ) : prediction2;
+      ) : prediction;
       console.log(`${completed.id}: ${completed.status}`);
       if (opts.download) {
         if (completed.status !== "succeeded") {
@@ -4625,11 +4651,20 @@ init_errors();
 import fs20 from "fs";
 import os2 from "os";
 import path23 from "path";
+
+// src/core/limits.ts
+var FILES_API_MAX_BYTES = 2e9;
+
+// src/core/stdin-file.ts
 var STDIN_ARG = "-";
 var STDIN_LABEL = "<stdin>";
 var HEAD_BYTES = 4096;
-var MAX_STDIN_BYTES = 2 * 1024 ** 3;
+var MAX_STDIN_BYTES = FILES_API_MAX_BYTES;
 var WAIT_HINT_MS = 2e3;
+function stdinTooLargeMessage(maxBytes) {
+  const bytes = maxBytes.toLocaleString("en-US");
+  return maxBytes === FILES_API_MAX_BYTES ? `Piped stdin exceeds the Gemini Files API limit of 2 GB (${bytes} bytes)` : `Piped stdin exceeds the ${bytes}-byte limit`;
+}
 var ascii = (buf, start, end) => buf.toString("latin1", start, end);
 var HEIF_BRANDS = /* @__PURE__ */ new Set([
   "heic",
@@ -4769,9 +4804,7 @@ async function stdinToTempFile(opts = {}) {
         clearTimeout(hint);
         const buf = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
         if (size + buf.length > maxBytes) {
-          throw new ValidationError(
-            `Piped stdin exceeds ${Math.floor(maxBytes / 1024 ** 2)} MB; save it to a file instead`
-          );
+          throw new ValidationError(stdinTooLargeMessage(maxBytes));
         }
         if (head.length < HEAD_BYTES) {
           head = Buffer.concat([head, buf.subarray(0, HEAD_BYTES - head.length)]);
@@ -4833,9 +4866,9 @@ async function resolveFileInputs(files, opts = {}) {
 }
 
 // src/providers/gemini/client.ts
-init_errors();
 import fs21 from "fs";
 import path25 from "path";
+init_errors();
 
 // src/providers/gemini/key-pool.ts
 init_errors();
@@ -4959,49 +4992,123 @@ function withKey(opts, fn) {
 function authHeaders2(apiKey) {
   return { "x-goog-api-key": apiKey };
 }
+var DEFAULT_TIMEOUT_MS3 = 3e5;
+var UPLOAD_MIN_KBPS_ENV = "MULTIX_UPLOAD_MIN_KBPS";
+var DEFAULT_MIN_UPLOAD_BYTES_PER_SEC = 1e6;
+var UPLOAD_TIMEOUT_SLACK_MS = 6e4;
+function minUploadBytesPerSec() {
+  const raw = resolveKey(UPLOAD_MIN_KBPS_ENV)?.trim();
+  if (!raw) return DEFAULT_MIN_UPLOAD_BYTES_PER_SEC;
+  const kbps = Number(raw);
+  if (!Number.isFinite(kbps) || kbps < 1) {
+    throw new ConfigError(
+      `${UPLOAD_MIN_KBPS_ENV} must be a number of kilobytes per second, at least 1, got "${raw}"`
+    );
+  }
+  return kbps * 1e3;
+}
+function uploadTimeoutMs(size, timeoutMs = DEFAULT_TIMEOUT_MS3, bytesPerSec = DEFAULT_MIN_UPLOAD_BYTES_PER_SEC) {
+  return Math.max(timeoutMs, UPLOAD_TIMEOUT_SLACK_MS + Math.ceil(size / bytesPerSec * 1e3));
+}
 async function uploadFile(filePath, opts = {}) {
-  return withKey(opts, (apiKey) => uploadFileWithKey(filePath, apiKey, opts));
+  const size = fs21.statSync(filePath).size;
+  if (size > FILES_API_MAX_BYTES) {
+    throw new ValidationError(
+      `File too large for the Gemini Files API: ${path25.basename(filePath)} is ${formatMb3(size)} MB (limit 2 GB = ${FILES_API_MAX_BYTES} bytes)`
+    );
+  }
+  const bytesPerSec = minUploadBytesPerSec();
+  return withKey(opts, (apiKey) => uploadFileWithKey(filePath, apiKey, { ...opts, bytesPerSec }));
+}
+function formatMb3(bytes) {
+  return (bytes / 1024 / 1024).toFixed(2);
+}
+async function uploadFetch(url, init, timeoutMs, step) {
+  let resp;
+  try {
+    resp = await globalThis.fetch(url, {
+      ...init,
+      // With the default "follow", fetch clones the request body (tee) to replay
+      // it on a redirect, and that copy keeps every chunk in memory.
+      redirect: "error",
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+  } catch (err2) {
+    const e = err2;
+    const timedOut = e?.name === "TimeoutError";
+    const redirected = e?.cause instanceof Error && e.cause.message === "unexpected redirect";
+    const reason = timedOut ? `timed out after ${Math.round(timeoutMs / 1e3)} s` : e?.cause instanceof Error ? `${e.message}: ${e.cause.message}` : String(e?.message ?? err2);
+    const message = `File upload failed: ${reason}`;
+    if (redirected || timedOut && step === "upload") {
+      throw new ProviderError(message, "gemini", { cause: err2 });
+    }
+    throw new HttpError(0, message, FILES_BASE, void 0, { cause: err2 });
+  }
+  if (!resp.ok) {
+    const txt = await resp.text();
+    throw new HttpError(resp.status, `File upload failed: ${txt.slice(0, 500)}`, FILES_BASE);
+  }
+  return resp;
+}
+async function readFinalizedFile(resp) {
+  const status = resp.headers.get("x-goog-upload-status")?.trim().toLowerCase();
+  let file;
+  let readError;
+  try {
+    file = (await resp.json())?.file;
+  } catch (err2) {
+    readError = err2;
+  }
+  if (status !== "final" || typeof file?.uri !== "string" || typeof file?.name !== "string") {
+    const detail = status !== "final" ? `upload status is "${status?.slice(0, 40) ?? "missing"}"` : readError ? "unreadable response body" : "no file in the response";
+    throw new ProviderError(`File upload failed: upload was not finalized (${detail})`, "gemini", {
+      cause: readError
+    });
+  }
+  return file;
 }
 async function uploadFileWithKey(filePath, apiKey, opts) {
-  const { timeoutMs = 3e5, logger } = opts;
+  const { timeoutMs = DEFAULT_TIMEOUT_MS3, logger, bytesPerSec } = opts;
   const mimeType = getMimeType(filePath);
-  const fileBytes = fs21.readFileSync(filePath);
   const displayName = path25.basename(filePath);
-  const boundary = `multix_${Date.now()}`;
-  const metaJson = JSON.stringify({ file: { displayName, mimeType } });
-  const body = Buffer.concat([
-    Buffer.from(
-      `--${boundary}\r
-Content-Type: application/json; charset=UTF-8\r
-\r
-${metaJson}\r
---${boundary}\r
-Content-Type: ${mimeType}\r
-\r
-`
-    ),
-    fileBytes,
-    Buffer.from(`\r
---${boundary}--`)
-  ]);
-  logger?.debug(`Uploading ${displayName} (${(fileBytes.length / 1024 / 1024).toFixed(2)} MB)`);
-  const resp = await globalThis.fetch(FILES_BASE, {
-    method: "POST",
-    headers: {
-      "x-goog-api-key": apiKey,
-      "Content-Type": `multipart/related; boundary=${boundary}`,
-      "Content-Length": String(body.length),
-      "X-Goog-Upload-Protocol": "multipart"
+  const file = await fs21.openAsBlob(filePath);
+  logger?.debug(`Uploading ${displayName} (${formatMb3(file.size)} MB)`);
+  const start = await uploadFetch(
+    FILES_BASE,
+    {
+      method: "POST",
+      headers: {
+        "x-goog-api-key": apiKey,
+        "Content-Type": "application/json",
+        "X-Goog-Upload-Protocol": "resumable",
+        "X-Goog-Upload-Command": "start",
+        "X-Goog-Upload-Header-Content-Length": String(file.size),
+        "X-Goog-Upload-Header-Content-Type": mimeType
+      },
+      body: JSON.stringify({ file: { display_name: displayName } })
     },
-    body,
-    signal: AbortSignal.timeout(timeoutMs)
-  });
-  if (!resp.ok) {
-    const txt = await resp.text();
-    throw new HttpError(resp.status, `File upload failed: ${txt.slice(0, 500)}`, FILES_BASE);
+    timeoutMs,
+    "start"
+  );
+  const uploadUrl = start.headers.get("x-goog-upload-url");
+  await start.body?.cancel();
+  if (!uploadUrl) {
+    throw new ProviderError("File upload failed: the Files API returned no upload URL", "gemini");
   }
-  const data = await resp.json();
-  let fileRef = data.file;
+  const resp = await uploadFetch(
+    uploadUrl,
+    {
+      method: "POST",
+      headers: {
+        "X-Goog-Upload-Offset": "0",
+        "X-Goog-Upload-Command": "upload, finalize"
+      },
+      body: file
+    },
+    uploadTimeoutMs(file.size, timeoutMs, bytesPerSec),
+    "upload"
+  );
+  let fileRef = await readFinalizedFile(resp);
   if (requiresProcessingWait(mimeType)) {
     const deadline = Date.now() + timeoutMs;
     while (fileRef.state === "PROCESSING" && Date.now() < deadline) {
@@ -9448,7 +9555,7 @@ import path45 from "path";
 import fs37 from "fs";
 import path44 from "path";
 init_errors();
-var DEFAULT_TIMEOUT_MS3 = 24e4;
+var DEFAULT_TIMEOUT_MS4 = 24e4;
 function requireOpenAIKey() {
   const key = resolveKey("OPENAI_API_KEY");
   if (!key) {
@@ -9464,7 +9571,7 @@ function endpoint(pathname) {
 function authHeaders4(apiKey, extra) {
   return { Authorization: `Bearer ${apiKey}`, ...extra ?? {} };
 }
-function postOpenAIJson(pathname, body, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS3) {
+function postOpenAIJson(pathname, body, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS4) {
   return httpJson({
     url: endpoint(pathname),
     method: "POST",
@@ -9473,7 +9580,7 @@ function postOpenAIJson(pathname, body, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS3)
     timeoutMs
   });
 }
-async function postOpenAIForm(pathname, form, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS3) {
+async function postOpenAIForm(pathname, form, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS4) {
   const url = endpoint(pathname);
   let res;
   try {
@@ -9492,7 +9599,7 @@ async function postOpenAIForm(pathname, form, apiKey, timeoutMs = DEFAULT_TIMEOU
   }
   return res.json();
 }
-async function postOpenAIBinary(pathname, body, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS3) {
+async function postOpenAIBinary(pathname, body, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS4) {
   const url = endpoint(pathname);
   let res;
   try {
@@ -10612,13 +10719,13 @@ var ReplicateApiError = class extends ProviderError {
   retryAfterMs;
 };
 var ReplicatePredictionError = class extends ProviderError {
-  constructor(prediction2) {
-    const detail = formatPredictionError(prediction2.error);
+  constructor(prediction) {
+    const detail = formatPredictionError(prediction.error);
     super(
-      `Replicate prediction ${prediction2.id} ${prediction2.status}${detail ? `: ${detail}` : ""}`,
+      `Replicate prediction ${prediction.id} ${prediction.status}${detail ? `: ${detail}` : ""}`,
       PROVIDER
     );
-    this.prediction = prediction2;
+    this.prediction = prediction;
     this.name = "ReplicatePredictionError";
   }
   prediction;
@@ -10687,11 +10794,11 @@ function validatePrediction(value) {
   }
   return value;
 }
-function assertSucceeded(prediction2) {
-  if (prediction2.status === "succeeded") return prediction2;
-  if (isTerminalStatus2(prediction2.status)) throw new ReplicatePredictionError(prediction2);
+function assertSucceeded(prediction) {
+  if (prediction.status === "succeeded") return prediction;
+  if (isTerminalStatus2(prediction.status)) throw new ReplicatePredictionError(prediction);
   throw new ProviderError(
-    `Replicate prediction ${prediction2.id} is not finished (status: ${prediction2.status})`,
+    `Replicate prediction ${prediction.id} is not finished (status: ${prediction.status})`,
     PROVIDER
   );
 }
@@ -10772,9 +10879,9 @@ var ReplicateClient = class {
    * canceled, aborted) and return it — callers decide success via
    * assertSucceeded. Retries network/429/5xx; throws PollTimeoutError on deadline.
    */
-  async waitForPrediction(prediction2, opts) {
-    if (typeof prediction2 !== "string" && isTerminalStatus2(prediction2.status)) return prediction2;
-    const safeId = assertPredictionId(typeof prediction2 === "string" ? prediction2 : prediction2.id);
+  async waitForPrediction(prediction, opts) {
+    if (typeof prediction !== "string" && isTerminalStatus2(prediction.status)) return prediction;
+    const safeId = assertPredictionId(typeof prediction === "string" ? prediction : prediction.id);
     try {
       return await pollUntil({
         fetchStatus: async ({ remainingMs }) => validatePrediction(
@@ -10877,13 +10984,13 @@ function registerReplicateCancelCommand(parent) {
   parent.command("cancel <predictionId>").description("Cancel a running Replicate prediction").option("-v, --verbose", "Verbose logging").action(async (predictionId, opts) => {
     const logger = createLogger({ verbose: opts.verbose ?? false });
     const client = createReplicateClient();
-    const prediction2 = await client.cancelPrediction(predictionId);
-    if (prediction2.status === "canceled") {
-      logger.success(`Prediction ${prediction2.id} canceled`);
-    } else if (isTerminalStatus2(prediction2.status)) {
-      logger.warn(`Prediction ${prediction2.id} already finished (status: ${prediction2.status})`);
+    const prediction = await client.cancelPrediction(predictionId);
+    if (prediction.status === "canceled") {
+      logger.success(`Prediction ${prediction.id} canceled`);
+    } else if (isTerminalStatus2(prediction.status)) {
+      logger.warn(`Prediction ${prediction.id} already finished (status: ${prediction.status})`);
     } else {
-      logger.info(`Cancel requested for ${prediction2.id} (status: ${prediction2.status})`);
+      logger.info(`Cancel requested for ${prediction.id} (status: ${prediction.status})`);
     }
   });
 }
@@ -11283,42 +11390,42 @@ function parsePositiveInt2(raw, flag, max) {
 function resumeCommand3(id) {
   return `multix replicate status ${id} --wait --download`;
 }
-function printAsyncHandle(prediction2) {
-  console.log(`Prediction submitted: ${prediction2.id} (status: ${prediction2.status})`);
-  console.log(`  Check:  multix replicate status ${prediction2.id}`);
-  console.log(`  Resume: ${resumeCommand3(prediction2.id)}`);
-  console.log(`  Cancel: multix replicate cancel ${prediction2.id}`);
+function printAsyncHandle(prediction) {
+  console.log(`Prediction submitted: ${prediction.id} (status: ${prediction.status})`);
+  console.log(`  Check:  multix replicate status ${prediction.id}`);
+  console.log(`  Resume: ${resumeCommand3(prediction.id)}`);
+  console.log(`  Cancel: multix replicate cancel ${prediction.id}`);
 }
-async function reportOutputs(prediction2, opts) {
-  const { media, texts } = extractOutput(prediction2.output);
+async function reportOutputs(prediction, opts) {
+  const { media, texts } = extractOutput(prediction.output);
   for (const text of texts) console.log(text);
   if (media.length === 0) {
-    if (texts.length === 0) console.log(JSON.stringify(summarizePrediction(prediction2), null, 2));
+    if (texts.length === 0) console.log(JSON.stringify(summarizePrediction(prediction), null, 2));
     return [];
   }
   if (!opts.download) {
     for (const m of media) console.log(m.url);
     return [];
   }
-  const saved = await saveMediaOutputs(prediction2.id, media, {
+  const saved = await saveMediaOutputs(prediction.id, media, {
     outDir: opts.output ? "" : getOutputDir(),
     output: opts.output,
     logger: opts.logger,
-    retryHint: `Retry while the output URLs are live: multix replicate status ${prediction2.id} --download`
+    retryHint: `Retry while the output URLs are live: multix replicate status ${prediction.id} --download`
   });
   const finals = opts.finalize ? opts.finalize(saved) : saved;
   console.log(`
-Saved ${finals.length} file(s) from prediction ${prediction2.id}:`);
+Saved ${finals.length} file(s) from prediction ${prediction.id}:`);
   for (const f of finals) console.log(`  ${f}`);
   return finals;
 }
-async function completePrediction(client, prediction2, opts) {
-  const id = typeof prediction2 === "string" ? prediction2 : prediction2.id;
-  let lastStatus = typeof prediction2 === "string" ? "" : prediction2.status;
-  if (typeof prediction2 === "string" || !isTerminalStatus2(prediction2.status)) {
+async function completePrediction(client, prediction, opts) {
+  const id = typeof prediction === "string" ? prediction : prediction.id;
+  let lastStatus = typeof prediction === "string" ? "" : prediction.status;
+  if (typeof prediction === "string" || !isTerminalStatus2(prediction.status)) {
     opts.logger.info(`Waiting for prediction ${id}...`);
   }
-  const final = await client.waitForPrediction(prediction2, {
+  const final = await client.waitForPrediction(prediction, {
     timeoutMs: opts.waitTimeoutMs,
     resumeHint: `Resume with: ${resumeCommand3(id)}`,
     onPoll: (p, attempt) => {
@@ -11339,17 +11446,17 @@ async function executePrediction2(params) {
   }
   const waitTimeoutMs = parsePositiveInt2(opts.waitTimeout, "--wait-timeout");
   logger.info(`Submitting to Replicate ${describeModelRef(model)}...`);
-  const prediction2 = await client.createPrediction({
+  const prediction = await client.createPrediction({
     model,
     input,
     preferWaitSeconds: opts.preferWait
   });
   if (opts.async) {
-    printAsyncHandle(prediction2);
+    printAsyncHandle(prediction);
     return;
   }
-  logger.info(`Prediction ${prediction2.id} (status: ${prediction2.status})`);
-  await completePrediction(client, prediction2, {
+  logger.info(`Prediction ${prediction.id} (status: ${prediction.status})`);
+  await completePrediction(client, prediction, {
     waitTimeoutMs,
     logger,
     download: opts.download !== false,
@@ -11415,7 +11522,7 @@ import fs45 from "fs";
 import path52 from "path";
 var DATA_URI_MAX_BYTES = 256 * 1024;
 var UPLOAD_MAX_BYTES = 100 * 1024 * 1024;
-function formatMb3(bytes) {
+function formatMb4(bytes) {
   return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
 }
 async function resolveFileInput(value, client, logger) {
@@ -11431,7 +11538,7 @@ async function resolveFileInput(value, client, logger) {
   if (stat.size === 0) throw new ValidationError(`Input file is empty: ${value}`);
   if (stat.size >= UPLOAD_MAX_BYTES) {
     throw new ValidationError(
-      `Input file ${value} is ${formatMb3(stat.size)}; Replicate accepts uploads under 100MB. Host it and pass an https URL instead.`
+      `Input file ${value} is ${formatMb4(stat.size)}; Replicate accepts uploads under 100MB. Host it and pass an https URL instead.`
     );
   }
   const filename = path52.basename(filePath);
@@ -11441,7 +11548,7 @@ async function resolveFileInput(value, client, logger) {
     logger.debug(`Inlining ${filename} (${stat.size} bytes) as a data URI`);
     return `data:${contentType};base64,${bytes.toString("base64")}`;
   }
-  logger.info(`Uploading ${filename} (${formatMb3(stat.size)}) to Replicate Files...`);
+  logger.info(`Uploading ${filename} (${formatMb4(stat.size)}) to Replicate Files...`);
   const file = await client.uploadFile({
     data: new Blob([bytes], { type: contentType }),
     filename,
@@ -11501,16 +11608,16 @@ function registerReplicateStatusCommand(parent) {
       });
       return;
     }
-    const prediction2 = await client.getPrediction(predictionId);
-    if (prediction2.status === "succeeded" && opts.download) {
-      await reportOutputs(prediction2, { download: true, output: opts.output, logger });
+    const prediction = await client.getPrediction(predictionId);
+    if (prediction.status === "succeeded" && opts.download) {
+      await reportOutputs(prediction, { download: true, output: opts.output, logger });
       return;
     }
-    console.log(JSON.stringify(summarizePrediction(prediction2), null, 2));
-    if (!isTerminalStatus2(prediction2.status)) {
-      logger.info(`Still running. Resume with: ${resumeCommand3(prediction2.id)}`);
-    } else if (prediction2.status !== "succeeded") {
-      throw new ReplicatePredictionError(prediction2);
+    console.log(JSON.stringify(summarizePrediction(prediction), null, 2));
+    if (!isTerminalStatus2(prediction.status)) {
+      logger.info(`Still running. Resume with: ${resumeCommand3(prediction.id)}`);
+    } else if (prediction.status !== "succeeded") {
+      throw new ReplicatePredictionError(prediction);
     }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrgoonie/multix",
-  "version": "0.14.1",
+  "version": "0.15.1",
   "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": {
@@ -35,7 +35,11 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:smoke": "vitest run tests/smoke",
-    "verify:docs": "npm run verify --prefix docs-site"
+    "verify:docs": "npm run verify --prefix docs-site",
+    "dev:mcp": "npm run dev --prefix worker",
+    "deploy:mcp": "npm run deploy --prefix worker",
+    "test:mcp": "npm test --prefix worker",
+    "check:mcp": "npm run typecheck --prefix worker && npm test --prefix worker && npm run check:bundle --prefix worker"
   },
   "keywords": [
     "cli",

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: 0.14.1 # x-release-please-version
+version: 0.15.1 # x-release-please-version
 ---
 
 # multix — AI Multimodal CLI
@@ -387,6 +387,7 @@ Requires `cwebp` (libwebp: `brew install webp`, `apt install webp`) on `PATH`.
 |---|---|
 | `MULTIX_OUTPUT_DIR` | Override default output dir |
 | `MULTIX_MAX_DOWNLOAD_MB` | Size limit per downloaded Replicate output file (default 2048) |
+| `MULTIX_UPLOAD_MIN_KBPS` | Slowest Gemini Files API upload speed to allow for, in KB/s (default 1000); lower it on slow links |
 | `OPENAI_IMAGE_MODEL` / `OPENAI_TTS_MODEL` / `OPENAI_STT_MODEL` | OpenAI model defaults |
 | `OPENROUTER_IMAGE_MODEL` | Default OpenRouter image model |
 | `OPENROUTER_FALLBACK_MODELS` | CSV; applies to `generate` AND `i2i` |
@@ -466,6 +467,19 @@ multix update --check
 multix update
 ```
 
+## Remote MCP server
+
+If the user cannot run the CLI locally but has deployed the optional multix
+MCP Worker (`worker/` in the repo; guide: https://multix.zuey.me/guides/mcp-server/),
+call its tools instead: `multix_list_providers` first, then
+`multix_generate_image` / `multix_generate_video`, and poll
+`multix_prediction_status` until `done` is true. It returns provider URLs (no
+local files), supports only Replicate, Atlas Cloud, HeyGen, and Cloudflare
+video, and accepts only public `https://` image URLs. Check `limits` from
+`multix_list_providers` before a video call: `duration` above
+`max_video_seconds` or a `resolution` outside `allowed_resolutions` is
+rejected, and an omitted `duration` becomes `default_video_seconds`.
+
 ## Security & scope
 
 This skill produces shell commands for the local `multix` CLI. It does NOT execute the commands itself, exfiltrate API keys, or modify provider accounts.