@heyamiko/amiko-cli 0.14.0-beta.12 → 0.14.0-beta.14

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.14.0-beta.0)
+# @heyamiko/amiko-cli (v0.14.0-beta.14)
 
 Manage wallets, credits, swaps, MPP marketplace services, and your Amiko twin (identity, documents, voice, avatar, friends, feed) from the terminal. Works for both human users and AI agents running on OpenClaw.
 
@@ -131,6 +131,10 @@ amiko create video "animate cover" --first-frame https://.../cover.png --yes
 amiko create video "dance clip" --model dreamina-seedance-2-0-fast-260128 \
   --reference-image https://.../ref1.png --reference-audio https://.../beat.mp3 --generate-audio --yes
 amiko create tts "Hello world" --voice 21m00Tcm4TlvDq8ikWAM
+amiko create tts "Hello world" --provider minimax --model speech-2.8-turbo
+amiko create tts "Hello" --provider minimax --voice English_expressive_narrator --yes
+amiko voice clone ./me.mp3 --provider minimax
+amiko voice clone ./me.mp3 --provider elevenlabs
 amiko create music "lo-fi chill beat" --duration 30000
 amiko create music --lyrics "..." --instrumental               # instrumental
 amiko create sfx "thunder and heavy rain" --duration 5
@@ -178,8 +182,20 @@ Reference flags accept URLs or data URIs (not local paths). Typical I2V flow: `c
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--model <model>` | `eleven_multilingual_v2` | TTS model id |
-| `--voice <voiceId>` | `21m00Tcm4TlvDq8ikWAM` | Voice id |
+| `--provider <name>` | inferred / `elevenlabs` | `minimax` or `elevenlabs` — sets model/voice defaults when those flags are omitted |
+| `--model <model>` | EL: `eleven_multilingual_v2`; MiniMax: `speech-2.8-turbo` | MiniMax: `speech-2.8-turbo\|hd`, `speech-2.6-turbo\|hd`. ElevenLabs: `eleven_*` |
+| `--voice <voiceId>` | EL default hash; MiniMax: `English_expressive_narrator` | MiniMax system or cloned `voice_id`; ElevenLabs voice id |
+
+Examples: `amiko create tts "Hi" --provider minimax --yes` · `amiko create tts "Hi" --provider minimax --model speech-2.8-turbo --voice <clonedId> --yes`
+
+**`amiko voice clone <source>`** — audio path, https URL, or `-` (stdin)
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--provider <name>` | `minimax` | `minimax` (mpp rapid clone + ownership registry) or `elevenlabs` (legacy IVC) |
+| `--voice-id <id>` | auto | **MiniMax only** — optional custom voice_id (ignored for elevenlabs) |
+| `--model <model>` | `speech-2.8-turbo` | **MiniMax only** — preview speech model (ignored for elevenlabs) |
+| `--preview-text <text>` | provider default | **MiniMax only** — preview line; empty string skips preview (ignored for elevenlabs) |
 
 **`amiko create music [prompt]`** — pass a prompt and/or `--lyrics`
 
@@ -345,8 +361,11 @@ amiko markets service call POST /v1/sfx '{"text":"Thunder with heavy rain","dura
 # Music generation ($0.10) — returns { url, format, service }
 amiko markets service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
 
-# Text-to-speech (1 AMIKO) — returns { url, format, service }
+# Text-to-speech — ElevenLabs voice id (default)
 amiko markets service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
+# MiniMax system or cloned voice_id
+amiko markets service tts English_expressive_narrator "Hello" --provider minimax --yes
+amiko markets service tts <clonedId> "Hello" --provider minimax --model speech-2.8-turbo --yes
 
 # Composition plan ($0.02)
 amiko markets service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
@@ -564,6 +583,16 @@ npm publish
 
 ## Changelog
 
+### 0.14.0-beta.14
+
+- `credits balance` prefers `AMIKO_API_KEY` (`amk_`) → `billing.heyamiko.com/api/credits` directly; falls back to twin-token platform proxy. Override base with `AMIKO_BILLING_URL`.
+
+### 0.14.0-beta.13
+
+- **Create Studio TTS + voice clone: MiniMax.** `amiko create tts` accepts `--provider minimax|elevenlabs` (infers from `speech-*` / `eleven_*` models when omitted), with provider-specific defaults (`speech-2.8-turbo` + `English_expressive_narrator` vs `eleven_multilingual_v2` + Rachel). Quote body includes `voiceId`. Cloned-voice examples require `--provider minimax` when using a MiniMax `voice_id`.
+- **`amiko voice clone`** defaults to MiniMax (mpp rapid clone + ownership registry); `--provider elevenlabs` keeps legacy IVC. MiniMax-only flags: `--voice-id`, `--model`, `--preview-text`.
+- **`amiko markets service tts`** gains `--provider minimax|elevenlabs` and `--model` for MiniMax speech routing on `/v1/tts/:voiceId`.
+
 ### 0.14.0-beta.7
 
 - **`amiko chat group invite <group>` — share a group's invite/join link + QR.** New read-only subcommand that fetches `GET /api/conversations/{id}/invite` (twin token) and prints the join link plus a scannable QR image URL. Admins-only: SKILL.md instructs the agent to confirm the asker holds `admin`/`owner` (via `amiko chat group info`) before sharing, and the endpoint is admin-gated server-side (403 → admin tip). Fails loudly if the response is missing its link/QR instead of printing a placeholder. Requires the companion amiko-web change (adds `qrUrl` to the invite response + a public `GET /api/conversations/join/[token]/qr` PNG route).

package/dist/index.js

@@ -861,7 +861,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          }
+          } else {}
         };
       }
       return this;
@@ -3596,7 +3596,7 @@ function getHumanReadableErrorMessage(code, context = {}) {
 function getErrorMessage(code, context = {}) {
   if (true) {
     return getHumanReadableErrorMessage(code, context);
-  }
+  } else {}
 }
 function isSolanaError(e, code) {
   const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
@@ -19992,7 +19992,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {}
+  } else if (ctx.target === "openapi-3.0") {} else {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -20257,7 +20257,7 @@ var formatMap, stringProcessor = (schema, ctx, _json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      }
+      } else {}
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -23655,27 +23655,50 @@ function readFromFile(path) {
       twinId: asString(parsed.amikoTwinId) ?? asString(parsed.AMIKO_TWIN_ID),
       userId: asString(parsed.amikoUserId) ?? asString(parsed.AMIKO_USER_ID),
       platformUrl: asString(parsed.amikoPlatformUrl) ?? asString(parsed.AMIKO_PLATFORM_URL),
-      apiBase: asString(parsed.amikoApiBase) ?? asString(parsed.AMIKO_API_BASE) ?? asString(parsed.apiBase)
+      apiBase: asString(parsed.amikoApiBase) ?? asString(parsed.AMIKO_API_BASE) ?? asString(parsed.apiBase),
+      billingApiKey: asString(parsed.amikoApiKey) ?? asString(parsed.AMIKO_API_KEY) ?? asString(parsed.billingApiKey),
+      billingUrl: asString(parsed.amikoBillingUrl) ?? asString(parsed.AMIKO_BILLING_URL) ?? asString(parsed.billingUrl)
     };
   } catch {
     return null;
   }
 }
+function readRoutingIdsFromEnv() {
+  return {
+    agentId: asString(process.env.AMIKO_AGENT_ID),
+    sessionId: asString(process.env.AMIKO_SESSION_ID)
+  };
+}
 function readFromEnv() {
   return {
     twinToken: asString(process.env.AMIKO_TWIN_TOKEN) ?? asString(process.env.AMIKO_USER_TOKEN),
     twinId: asString(process.env.AMIKO_TWIN_ID),
     userId: asString(process.env.AMIKO_USER_ID),
     platformUrl: asString(process.env.AMIKO_PLATFORM_URL),
-    apiBase: asString(process.env.AMIKO_API_BASE)
+    apiBase: asString(process.env.AMIKO_API_BASE),
+    billingApiKey: asString(process.env.AMIKO_API_KEY),
+    billingUrl: asString(process.env.AMIKO_BILLING_URL),
+    ...readRoutingIdsFromEnv()
+  };
+}
+function resolveFileAuth(path) {
+  const fromFile = readFromFile(path);
+  if (!fromFile)
+    return null;
+  const fromEnv = readFromEnv();
+  return {
+    ...fromFile,
+    ...readRoutingIdsFromEnv(),
+    billingApiKey: fromEnv.billingApiKey ?? fromFile.billingApiKey,
+    billingUrl: fromEnv.billingUrl ?? fromFile.billingUrl
   };
 }
 function resolveAuth() {
   const filePath = findAmikoJsonPath();
   if (filePath) {
-    const fromFile = readFromFile(filePath);
-    if (fromFile)
-      return fromFile;
+    const merged = resolveFileAuth(filePath);
+    if (merged)
+      return merged;
   }
   return readFromEnv();
 }
@@ -25405,7 +25428,31 @@ function registerBridgeCommand(program2) {
 import readline2 from "node:readline";
 
 // src/lib/balance.ts
-async function fetchCreditsBalance(auth) {
+var DEFAULT_BILLING_URL = "https://billing.heyamiko.com";
+function billingBase(auth) {
+  const url = auth.billingUrl || DEFAULT_BILLING_URL;
+  return url.replace(/\/$/, "");
+}
+async function fetchCreditsBalanceViaAmk(auth) {
+  const apiKey = auth.billingApiKey;
+  if (!apiKey || !apiKey.startsWith("amk_"))
+    return null;
+  try {
+    const res = await fetch(`${billingBase(auth)}/api/credits`, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(15000)
+    });
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    const raw = data.displayBalance;
+    return typeof raw === "number" && isFinite(raw) ? Math.round(raw) : null;
+  } catch {
+    return null;
+  }
+}
+async function fetchCreditsBalanceViaPlatformProxy(auth) {
   if (!auth.twinToken)
     return null;
   try {
@@ -25416,6 +25463,12 @@ async function fetchCreditsBalance(auth) {
     return null;
   }
 }
+async function fetchCreditsBalance(auth) {
+  const viaAmk = await fetchCreditsBalanceViaAmk(auth);
+  if (viaAmk != null)
+    return viaAmk;
+  return fetchCreditsBalanceViaPlatformProxy(auth);
+}
 async function printBalanceRemaining(auth) {
   const balance = await fetchCreditsBalance(auth);
   if (balance == null) {
@@ -26442,6 +26495,13 @@ var ETA = {
 function statusOf(err) {
   return err?.status;
 }
+function autoApproveLimit() {
+  const raw = process.env.AMIKO_AUTO_APPROVE_LIMIT;
+  if (typeof raw !== "string" || raw.trim() === "")
+    return;
+  const limit = Number(raw);
+  return Number.isFinite(limit) ? limit : undefined;
+}
 function collectOption(value, previous) {
   return [...previous ?? [], value];
 }
@@ -26451,7 +26511,7 @@ function assertMaxUrls(resourceName, urls, max) {
     process.exit(1);
   }
 }
-function printCompleted(final, title) {
+function printCompleted(final, title, deliveredToThisSession = false) {
   console.log(heading(`${title}
 `));
   if (final.prompt)
@@ -26460,6 +26520,9 @@ function printCompleted(final, title) {
     console.log(label("URL", final.assetUrl));
   if (final.assetMime)
     console.log(label("Type", final.assetMime));
+  if (deliveredToThisSession) {
+    console.log(success("Already delivered to the user in this chat automatically. Do NOT send this file again and do NOT paste the URL — you would duplicate it."));
+  }
   console.log("");
   if (final.charged) {
     const amt = final.chargeAmount ?? final.costAmiko ?? "?";
@@ -26488,6 +26551,7 @@ async function submitCreateJob(opts) {
     console.error(dim("--token is ignored with --pay credits (credits come from your Amiko account, not a wallet token)."));
   }
   let costLine = payCredits ? "reserved from your Amiko account credits, captured on success (released on failure)" : "charged from your twin wallet on success (nothing on failure)";
+  let quotedCostAmiko;
   try {
     const q = await amikoWebFetch(auth, "/api/create/quote", {
       method: "POST",
@@ -26497,11 +26561,29 @@ async function submitCreateJob(opts) {
     if (q.cost_usd != null) {
       costLine = payCredits ? `≈ ${Math.ceil(q.cost_usd * 1e4)} Amiko credits (≈ $${q.cost_usd.toFixed(4)}) — reserved on submit, captured only on success` : `${q.cost_amiko ?? "?"} AMIKO (≈ $${q.cost_usd.toFixed(4)}) — charged only on success`;
     }
+    if (typeof q.cost_amiko === "string" && q.cost_amiko.trim() !== "") {
+      const n = Number(q.cost_amiko);
+      if (Number.isFinite(n))
+        quotedCostAmiko = n;
+    }
   } catch {}
+  const preferredToken = typeof opts.jobBody.preferredToken === "string" ? opts.jobBody.preferredToken.toUpperCase() : undefined;
+  const chargeIsAmiko = !payCredits && (preferredToken === undefined || preferredToken === "AMIKO");
+  const effectiveChargeToken = preferredToken ?? "AMIKO";
+  let yes = opts.yes;
+  let autoApproved = false;
+  if (!yes) {
+    const limit = autoApproveLimit();
+    if (limit !== undefined && quotedCostAmiko !== undefined && quotedCostAmiko > 0 && chargeIsAmiko && quotedCostAmiko <= limit) {
+      yes = true;
+      autoApproved = true;
+      console.log(dim(`Auto-approved (cost ${quotedCostAmiko} ≤ limit ${limit} AMIKO)`));
+    }
+  }
   await requireApproval({
     cost: costLine,
     summary: opts.summary,
-    yes: opts.yes,
+    yes,
     commandExample: `amiko create ${opts.mode.toLowerCase()} ...`
   });
   const isTTY = process.stderr.isTTY;
@@ -26511,16 +26593,21 @@ async function submitCreateJob(opts) {
       spinner.stop();
   };
   let jobId;
+  let routedAgentId;
+  let routedSessionId;
   try {
     const submit = await amikoWebFetch(auth, "/api/create/jobs", {
       method: "POST",
       body: {
         ...opts.jobBody,
         twinId: auth.twinId,
+        ...autoApproved ? { preferredToken: effectiveChargeToken, strictToken: true } : {},
         ...payCredits ? {
           paymentMethod: { kind: "account_credits" },
           requestId: randomUUID()
-        } : {}
+        } : {},
+        ...auth.agentId ? { agentId: auth.agentId } : {},
+        ...auth.sessionId ? { sessionId: auth.sessionId } : {}
       },
       timeoutMs: 30000
     });
@@ -26530,6 +26617,8 @@ async function submitCreateJob(opts) {
       process.exit(1);
     }
     jobId = submit.jobId;
+    routedAgentId = submit.agentId;
+    routedSessionId = submit.sessionId;
   } catch (e5) {
     stop();
     const webErr = e5;
@@ -26550,19 +26639,24 @@ async function submitCreateJob(opts) {
     }
     process.exit(1);
   }
+  const sessionRouted = !!(routedAgentId && routedSessionId);
   stop();
   if (opts.raw) {
     console.log(JSON.stringify({
       jobId,
       status: "PENDING",
       check: `amiko create status ${jobId}`,
-      eta: ETA[opts.mode]
+      eta: ETA[opts.mode],
+      ...sessionRouted ? { sessionRouted: true, deliveredToSession: routedSessionId } : {}
     }, null, 2));
     return;
   }
   console.log(success(`Submitted — job ${jobId}`));
   console.log(label("Status", "PENDING — generating in the background"));
   console.log(label("Check result", `amiko create status ${jobId}`));
+  if (sessionRouted) {
+    console.log(dim("A generating-placeholder is already showing in the chat and the finished media will be delivered there automatically — do not send the file or URL yourself."));
+  }
   console.log(dim(`Usually ready in ${ETA[opts.mode]} — charged only on success. (Also: amiko create media)`));
   if (opts.mode === "VIDEO") {
     console.log(dim("Async video: HTTP 202 / PENDING means the job was accepted — not a failure. Poll status after ~2–9 min."));
@@ -26610,7 +26704,8 @@ function registerCreateCommand(create2) {
         mode: "VIDEO",
         model,
         size: opts.resolution,
-        seconds
+        seconds,
+        ...referenceVideoUrls.length ? { referenceVideoUrls } : {}
       },
       jobBody: {
         mode: "VIDEO",
@@ -26637,19 +26732,54 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("tts <text>").description("Generate speech from text (Create Studio)").option("--model <model>", "TTS model id", "eleven_multilingual_v2").option("--voice <voiceId>", "Voice id", "21m00Tcm4TlvDq8ikWAM").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--pay <method>", "Payment method: wallet (twin wallet, default) or credits (Amiko account credits — unified accounts only)", "wallet").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (text, opts) => {
+  const DEFAULT_EL_TTS_MODEL = "eleven_multilingual_v2";
+  const DEFAULT_EL_TTS_VOICE = "21m00Tcm4TlvDq8ikWAM";
+  const DEFAULT_MM_TTS_MODEL = "speech-2.8-turbo";
+  const DEFAULT_MM_TTS_VOICE = "English_expressive_narrator";
+  const MINIMAX_TTS_MODELS = new Set([
+    "speech-2.8-turbo",
+    "speech-2.8-hd",
+    "speech-2.6-turbo",
+    "speech-2.6-hd"
+  ]);
+  create2.command("tts <text>").description("Generate speech from text (Create Studio)").option("--provider <name>", "TTS provider: minimax | elevenlabs (sets defaults when --model/--voice omitted)").option("--model <model>", `TTS model id (MiniMax: speech-2.8-turbo|hd, speech-2.6-turbo|hd; ElevenLabs: eleven_*)`).option("--voice <voiceId>", "Voice id (MiniMax system e.g. English_expressive_narrator, or a cloned voice_id; ElevenLabs voice hash)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--pay <method>", "Payment method: wallet (twin wallet, default) or credits (Amiko account credits — unified accounts only)", "wallet").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (text, opts) => {
+    const providerRaw = typeof opts.provider === "string" ? opts.provider.trim().toLowerCase() : "";
+    if (providerRaw && providerRaw !== "minimax" && providerRaw !== "elevenlabs") {
+      console.error(error("--provider must be minimax or elevenlabs"));
+      process.exit(1);
+    }
+    let model = typeof opts.model === "string" && opts.model.trim().length > 0 ? opts.model.trim() : undefined;
+    let voice = typeof opts.voice === "string" && opts.voice.trim().length > 0 ? opts.voice.trim() : undefined;
+    let provider = providerRaw === "minimax" || providerRaw === "elevenlabs" ? providerRaw : model && MINIMAX_TTS_MODELS.has(model) ? "minimax" : model && model.startsWith("eleven") ? "elevenlabs" : "elevenlabs";
+    if (!model) {
+      model = provider === "minimax" ? DEFAULT_MM_TTS_MODEL : DEFAULT_EL_TTS_MODEL;
+    }
+    if (!voice) {
+      voice = provider === "minimax" ? DEFAULT_MM_TTS_VOICE : DEFAULT_EL_TTS_VOICE;
+    }
+    if (MINIMAX_TTS_MODELS.has(model) && providerRaw !== "elevenlabs") {
+      provider = "minimax";
+    }
+    if (provider === "minimax" && !MINIMAX_TTS_MODELS.has(model)) {
+      console.error(error(`--provider minimax requires a MiniMax speech model (${[...MINIMAX_TTS_MODELS].join(", ")})`));
+      process.exit(1);
+    }
+    if (provider === "elevenlabs" && !model.startsWith("eleven")) {
+      console.error(error("--provider elevenlabs requires an eleven_* model"));
+      process.exit(1);
+    }
     await submitCreateJob({
       mode: "TTS",
-      summary: `Create speech: ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
+      summary: `Create speech (${provider}/${model}): ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
       raw: opts.raw,
       pay: opts.pay,
       yes: opts.yes,
-      quoteBody: { mode: "TTS", model: opts.model, prompt: text },
+      quoteBody: { mode: "TTS", model, prompt: text, voiceId: voice },
       jobBody: {
         mode: "TTS",
         prompt: text,
-        model: opts.model,
-        voiceId: opts.voice,
+        model,
+        voiceId: voice,
         ...opts.token ? { preferredToken: opts.token } : {}
       }
     });
@@ -26713,8 +26843,9 @@ function registerCreateCommand(create2) {
       }
       process.exit(1);
     }
+    const deliveredToThisSession = !!(p.agentId && p.sessionId && auth.sessionId && p.sessionId === auth.sessionId);
     if (opts.raw) {
-      console.log(JSON.stringify(p, null, 2));
+      console.log(JSON.stringify(deliveredToThisSession ? { ...p, sessionRouted: true, deliveredToSession: p.sessionId } : p, null, 2));
       return;
     }
     if (p.status === "FAILED") {
@@ -26726,7 +26857,7 @@ function registerCreateCommand(create2) {
       console.log(dim(`Job id: ${jobId}`));
       return;
     }
-    printCompleted(p, "Job complete");
+    printCompleted(p, "Job complete", deliveredToThisSession);
   });
   create2.command("media").description("List your recent Create Studio generations").option("--limit <n>", "How many to show (max 50)", "20").option("--service <type>", "Filter by type: image, video, tts, music, sfx").option("--raw", "Output raw JSON").action(async (opts) => {
     let auth;
@@ -28311,18 +28442,32 @@ async function fetchWithTimeout2(url2, init = {}, timeoutMs) {
 }
 function registerServicesCommand(program2) {
   const svc = program2.command("service").alias("svc").description("Call any MPP service — pay in AMIKO, USDC, or USDT");
-  svc.command("tts <voiceId> <text>").description("Text-to-speech — 1 AMIKO").option("--raw", "Output raw response").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if none)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (voiceId, text, opts) => {
+  svc.command("tts <voiceId> <text>").description("Text-to-speech via mpp /v1/tts (pay-per-call)").option("--provider <name>", "elevenlabs (default) | minimax").option("--model <model>", "MiniMax speech-* model when provider=minimax").option("--raw", "Output raw response").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if none)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (voiceId, text, opts) => {
+    const provider = typeof opts.provider === "string" ? opts.provider.trim().toLowerCase() : "";
+    const body = { text };
+    if (provider === "minimax") {
+      body.provider = "minimax";
+      if (opts.model)
+        body.model_id = opts.model;
+      else
+        body.model_id = "speech-2.8-turbo";
+    } else if (provider && provider !== "elevenlabs") {
+      console.error(error("--provider must be minimax or elevenlabs"));
+      process.exit(1);
+    }
+    const providerArgs = provider ? ` --provider ${provider}` : "";
+    const modelArgs = provider === "minimax" ? ` --model ${JSON.stringify(typeof opts.model === "string" && opts.model ? opts.model : "speech-2.8-turbo")}` : "";
     await requireApproval({
-      cost: "1 AMIKO",
-      summary: `Text-to-speech (voice ${voiceId}): "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}"`,
+      cost: "variable (see mpp pricing)",
+      summary: `Text-to-speech (voice ${voiceId}${provider ? `, ${provider}` : ""}): "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}"`,
       yes: opts.yes,
-      commandExample: `amiko markets service tts ${voiceId} ${JSON.stringify(text)}`
+      commandExample: `amiko markets service tts ${voiceId} ${JSON.stringify(text)}${providerArgs}${modelArgs}`
     });
     await callService({
       name: "Text-to-Speech",
       method: "POST",
       path: `/v1/tts/${encodeURIComponent(voiceId)}`,
-      body: { text },
+      body,
       amiko: "1",
       opts
     });
@@ -28534,7 +28679,7 @@ function registerAccountsCommand(program2) {
       }
     }, { json: opts.json });
   });
-  program2.command("info").description("Get twin info (name, description, voice, avatar)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("info").description("Get twin info (name, description, voice ids, avatar)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     const config2 = loadConfig();
     const auth = resolveAuth();
     let twinId;
@@ -28558,13 +28703,24 @@ function registerAccountsCommand(program2) {
           console.log(label("Description", t.description));
         console.log(label("Public", t.is_public ? "yes" : "no"));
         if (t.voice_status)
-          console.log(label("Voice", t.voice_status));
+          console.log(label("Voice status", t.voice_status));
+        if (t.voice_id)
+          console.log(label("ElevenLabs voice_id", t.voice_id));
+        else
+          console.log(label("ElevenLabs voice_id", dim("(none)")));
+        if (t.minimax_voice_id)
+          console.log(label("MiniMax voice_id", t.minimax_voice_id));
+        else
+          console.log(label("MiniMax voice_id", dim("(none — clone with amiko voice clone)")));
         if (t.avatar_url)
           console.log(label("Avatar", t.avatar_url));
         if (t.shipped_at)
           console.log(label("Shipped", t.shipped_at));
         if (t.updated_at)
           console.log(dim(`Updated ${t.updated_at}`));
+        console.log("");
+        console.log(dim('MiniMax TTS: amiko create tts "…" --provider minimax --voice <MiniMax voice_id> --yes'));
+        console.log(dim('ElevenLabs TTS: amiko create tts "…" --provider elevenlabs --voice <ElevenLabs voice_id> --yes'));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();
@@ -29201,8 +29357,18 @@ function twinFromFlag2(opts) {
     throw e5;
   }
 }
+function parseProvider(raw, fallback2) {
+  if (raw == null || raw.trim() === "")
+    return fallback2;
+  const p = raw.trim().toLowerCase();
+  if (p !== "minimax" && p !== "elevenlabs") {
+    console.error(error("--provider must be minimax or elevenlabs"));
+    process.exit(1);
+  }
+  return p;
+}
 function registerVoiceCommand(program2) {
-  program2.command("design").description("Design a voice from a text description").requiredOption("--description <text>", "Voice description (min 20 chars)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("design").description("Design a voice from a text description (ElevenLabs)").requiredOption("--description <text>", "Voice description (min 20 chars)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     if (opts.description.trim().length < 20) {
       console.error(error("--description must be at least 20 characters"));
       process.exit(1);
@@ -29230,7 +29396,7 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("create").description("Create a voice from a previously designed preview").requiredOption("--sample <id>", "generated_voice_id from voice design").option("--description <text>", "Optional voice description").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("create").description("Create a voice from a previously designed preview (ElevenLabs)").requiredOption("--sample <id>", "generated_voice_id from voice design").option("--description <text>", "Optional voice description").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag2(opts);
     const spinner = opts.json ? null : ora("Creating voice...").start();
     try {
@@ -29256,7 +29422,8 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("clone <source>").description("Clone a voice from an audio file (path | https URL | -)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+  program2.command("clone <source>").description("Clone a voice from an audio file (path | https URL | -). Default provider: minimax").option("--provider <name>", "minimax (default, mpp rapid clone) | elevenlabs (platform IVC)", "minimax").option("--voice-id <id>", "MiniMax: optional custom voice_id (8–256 chars)").option("--model <model>", "MiniMax preview TTS model", "speech-2.8-turbo").option("--preview-text <text>", "MiniMax: preview line (empty string skips preview)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+    const provider = parseProvider(opts.provider, "minimax");
     const { twinId, auth } = twinFromFlag2(opts);
     const spinner = opts.json ? null : ora("Reading audio...").start();
     try {
@@ -29266,17 +29433,30 @@ function registerVoiceCommand(program2) {
         hintMime: "audio/mpeg"
       });
       if (spinner)
-        spinner.text = `Cloning voice from ${file2.name}...`;
+        spinner.text = `Cloning voice (${provider}) from ${file2.name}...`;
       const form = new FormData;
       form.set("audio", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+      form.set("provider", provider);
+      if (provider === "minimax") {
+        if (opts.voiceId)
+          form.set("voice_id", opts.voiceId);
+        if (opts.model)
+          form.set("model_id", opts.model);
+        if (opts.previewText !== undefined)
+          form.set("text", opts.previewText);
+      }
       const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/clone`, { method: "POST", multipart: form, timeoutMs: 180000 });
       spinner?.stop();
       renderOutput(result, (r) => {
-        console.log(success("Voice cloned"));
+        console.log(success(`Voice cloned (${String(r.provider ?? provider)})`));
         if (r.voice_id)
           console.log(label("Voice ID", String(r.voice_id)));
         if (r.voice_status)
           console.log(label("Status", String(r.voice_status)));
+        if (r.demo_audio)
+          console.log(label("Demo", String(r.demo_audio)));
+        console.log("");
+        console.log(dim(`Synthesize: amiko create tts "Hello" --provider ${provider} --voice ${String(r.voice_id ?? "<id>")} --yes`));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.14.0-beta.12",
+  "version": "0.14.0-beta.14",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -35,6 +35,8 @@ Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar)
 | "share the group's invite link" (asked by an admin) | shell → `amiko chat group info "<group>"` (confirm they're admin) → `amiko chat group invite "<group>"` |
 | "react to the latest message from Ava about the team with a heart" | shell → `amiko chat read "Ava"` (find that message, copy its `id`) → `amiko chat react <messageId> ❤️ --yes` |
 | "what can amiko do?" | shell → `amiko --help` |
+| "what's my MiniMax / ElevenLabs voice id?" | shell → `amiko info` |
+| "speak with my cloned MiniMax voice" | shell → `amiko info`, quote the cost, obtain explicit approval, then run `amiko create tts "…" --provider minimax --voice <minimax_voice_id> --yes` |
 
 The CLI is installed globally and is pre-authenticated when you're inside your workspace folder. Never suggest `amiko login` or `amiko connect` — they don't exist.
 
@@ -96,6 +98,21 @@ All paid markets commands auto-select the twin's active Solana wallet (see `--wa
 
 **Prefer `amiko create` for anything it supports.** For media generation — image, video, speech (TTS), music, SFX — use `amiko create` (async, charge-on-success, never loses money on a timeout), NOT `markets`. Reach for `markets` **only for what `create` does not cover**: X/Twitter search, Amazon, AI chat, speech-to-text/transcription, and arbitrary MPP endpoints via `markets service call`.
 
+### Voice IDs — never guess
+
+This twin has **two** optional TTS ids. They are **not** the same:
+
+| Field | Provider | How to get it | How to use |
+|---|---|---|---|
+| `voice_id` | ElevenLabs | shown by `amiko info` | quote cost + approval, then `amiko create tts "…" --provider elevenlabs --voice <voice_id> --yes` |
+| `minimax_voice_id` | MiniMax | shown by `amiko info` | quote cost + approval, then `amiko create tts "…" --provider minimax --voice <minimax_voice_id> --yes` |
+
+- **Before any TTS or clone follow-up**, run `amiko info` (or `amiko info --json`) and read the printed ids. Do **not** invent a `voice_id`, ask the owner to paste one you already have on the twin, or claim MiniMax TTS is blocked because you "don't know" the id.
+- Paid voice ops still need the Critical Rules gate: quote live cost, get explicit approval, only then append `--yes`.
+- If MiniMax voice_id is `(none)`, quote the clone cost, obtain explicit approval, then run `amiko voice clone <audio> --provider minimax --yes` and `amiko info` again.
+- System MiniMax voices (no clone) also work: e.g. `--voice English_expressive_narrator --provider minimax` (same approval gate before `--yes`).
+- `markets service tts <voiceId> "…" --provider minimax --yes` needs the same MiniMax id and approval gate.
+
 **Payment token:** `markets search`, `markets image`, and `markets amazon search` accept `--token <AMIKO|USDC|USDT>` (default AMIKO); `markets service call` uses `--usdc`/`--usdt` (pass `auto` to price from USD). Stables are pinned at $1.00 — the amount equals the endpoint's USD price — so there is no forced swap through AMIKO. When the owner asks to pay in USDT/USDC, pass the flag; do NOT swap first.
 
 ## Create Studio — behavior notes