@mrgoonie/multix 0.14.1 → 0.15.0

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).
 
+## [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

@@ -674,6 +674,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

@@ -50,9 +50,10 @@ var init_errors = __esm({
         super(message);
         this.code = code;
         this.name = "MultixError";
-        if (Error.captureStackTrace) {
-          Error.captureStackTrace(this, this.constructor);
-        }
+        Error.captureStackTrace?.(
+          this,
+          this.constructor
+        );
       }
       code;
     };
@@ -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") {
@@ -10612,13 +10638,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 +10713,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 +10798,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 +10903,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 +11309,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 +11365,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,
@@ -11501,16 +11527,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.0",
   "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.0 # x-release-please-version
 ---
 
 # multix — AI Multimodal CLI
@@ -466,6 +466,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.