@heyamiko/amiko-cli 0.14.0-beta.11 → 0.14.0-beta.13

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.14.0-beta.0)
+# @heyamiko/amiko-cli (v0.14.0-beta.13)
 
 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,12 @@ npm publish
 
 ## Changelog
 
+### 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

@@ -23661,21 +23661,34 @@ function readFromFile(path) {
     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),
+    ...readRoutingIdsFromEnv()
   };
 }
+function resolveFileAuth(path) {
+  const fromFile = readFromFile(path);
+  if (!fromFile)
+    return null;
+  return { ...fromFile, ...readRoutingIdsFromEnv() };
+}
 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();
 }
@@ -26442,6 +26455,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 +26471,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 +26480,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 +26511,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 +26521,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 +26553,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 +26577,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 +26599,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 +26664,8 @@ function registerCreateCommand(create2) {
         mode: "VIDEO",
         model,
         size: opts.resolution,
-        seconds
+        seconds,
+        ...referenceVideoUrls.length ? { referenceVideoUrls } : {}
       },
       jobBody: {
         mode: "VIDEO",
@@ -26637,19 +26692,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 +26803,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 +26817,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;
@@ -27061,6 +27152,53 @@ async function resolveGroup(auth, target) {
   return fetchConversationById(auth, matches[0].id);
 }
 
+// src/lib/reactions.ts
+var EMOJI_MAX = 32;
+function validateEmoji(raw) {
+  const emoji3 = (raw ?? "").trim();
+  if (!emoji3)
+    throw new Error("No emoji given. Pass the emoji to react with, e.g. ❤️.");
+  if (emoji3.length > EMOJI_MAX) {
+    throw new Error(`Emoji is too long (max ${EMOJI_MAX} characters).`);
+  }
+  return emoji3;
+}
+async function fetchMessage(auth, messageId) {
+  const data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}`, { timeoutMs: 20000 });
+  if (!data.message?.id) {
+    throw new Error(`Message ${messageId} not found.`);
+  }
+  return { ...data.message, reactions: data.message.reactions ?? [] };
+}
+function ownReaction(reactions, userId) {
+  if (!userId)
+    return null;
+  const me = normalizeUserId(userId);
+  const mine = reactions.find((r) => normalizeUserId(r.user_id) === me);
+  return mine?.emoji ?? null;
+}
+function previewText(msg, max = 60) {
+  const content = (msg.content ?? "").trim();
+  if (content) {
+    return content.length > max ? `${content.slice(0, max)}…` : content;
+  }
+  if (msg.message_type === "voice")
+    return "[voice message]";
+  if (msg.metadata?.images?.length)
+    return "[image]";
+  return `[${msg.message_type || "message"}]`;
+}
+function groupReactions(reactions) {
+  const counts = new Map;
+  for (const r of reactions) {
+    counts.set(r.emoji, (counts.get(r.emoji) ?? 0) + 1);
+  }
+  return Array.from(counts.entries());
+}
+function summarizeReactions(reactions) {
+  return groupReactions(reactions).map(([emoji3, count]) => `${emoji3}×${count}`).join(" ");
+}
+
 // src/commands/chat-group.ts
 var collect = (v, prev) => [...prev, v];
 function statusOf2(e5) {
@@ -27650,8 +27788,11 @@ function registerChatCommand(chat) {
       const who = m.sender?.name ?? m.name ?? (m.sender_id ? m.sender_id.slice(0, 8) : "?");
       const when = m.created_at ? m.created_at.slice(0, 19).replace("T", " ") : "";
       console.log(label(who, m.content));
-      if (when)
-        console.log(dim(`  ${when}`));
+      const meta3 = [when, `id ${m.id}`].filter(Boolean).join("  ");
+      console.log(dim(`  ${meta3}`));
+      if (m.reactions?.length) {
+        console.log(dim(`  reactions: ${summarizeReactions(m.reactions)}`));
+      }
     }
   });
   chat.command("send <target> <message>").description("Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically)").option("--image <pathOrUrl>", "Attach an image: local file (jpg/png/webp/gif, ≤10MB) or an Amiko URL (e.g. from `amiko create`)").option("--audio <pathOrUrl>", "Attach audio as a voice note: local file (≤25MB) or an Amiko URL").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, message, opts) => {
@@ -27717,6 +27858,113 @@ function registerChatCommand(chat) {
     const what = opts.image ? "Message + image sent" : opts.audio ? "Message + voice note sent" : "Message sent";
     console.log(success(what) + dim(` (conversation ${convId.slice(0, 8)}…)`));
   });
+  chat.command("react <messageId> <emoji>").description("React to a message as yourself (the owner). Get the message id from `amiko chat read`. One reaction per message — a new emoji replaces your previous one.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, emojiArg, opts) => {
+    const auth = authOrExit();
+    let emoji3;
+    try {
+      emoji3 = validateEmoji(emojiArg);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Invalid emoji"));
+      process.exit(1);
+    }
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    if (ownReaction(msg.reactions, auth.userId) === emoji3) {
+      if (opts.raw) {
+        console.log(JSON.stringify({ success: true, action: "unchanged", reactions: msg.reactions }, null, 2));
+        return;
+      }
+      console.log(success(`Already reacted with ${emoji3}`));
+      return;
+    }
+    await requireApproval({
+      free: "adds your reaction — people in the chat see it",
+      summary: `React ${emoji3} to "${previewText(msg)}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat react ${JSON.stringify(messageId)} ${JSON.stringify(emoji3)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/reactions`, { method: "POST", body: { emoji: emoji3 }, timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to react"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const what = data.action === "removed" ? `Removed your ${emoji3} reaction` : data.action === "updated" ? `Reaction changed to ${emoji3}` : `Reacted ${emoji3}`;
+    console.log(success(what));
+  });
+  chat.command("unreact <messageId>").description("Remove your (the owner's) reaction from a message. Get the message id from `amiko chat read`.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    const mine = ownReaction(msg.reactions, auth.userId);
+    if (!mine) {
+      if (opts.raw) {
+        console.log(JSON.stringify({ success: true, action: "none", reactions: msg.reactions }, null, 2));
+        return;
+      }
+      console.log(dim("You have no reaction on that message."));
+      return;
+    }
+    await requireApproval({
+      free: "removes your reaction from the chat",
+      summary: `Remove your ${mine} reaction from "${previewText(msg)}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat unreact ${JSON.stringify(messageId)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/reactions`, { method: "POST", body: { emoji: mine }, timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to remove reaction"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const what = data.action === "removed" ? `Removed your ${mine} reaction` : data.action === "updated" ? `Reaction changed to ${mine}` : `Reacted ${mine}`;
+    console.log(success(what));
+  });
+  chat.command("reactions <messageId>").description("Show the reactions on a message. Get the message id from `amiko chat read`.").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify({ reactions: msg.reactions }, null, 2));
+      return;
+    }
+    if (msg.reactions.length === 0) {
+      console.log(dim("No reactions yet."));
+      return;
+    }
+    const mine = ownReaction(msg.reactions, auth.userId);
+    console.log(heading(`Reactions (${msg.reactions.length})
+`));
+    for (const [emoji3, count] of groupReactions(msg.reactions)) {
+      const you = emoji3 === mine ? dim("  (includes you)") : "";
+      console.log(label(emoji3, `×${count}`) + you);
+    }
+  });
   const group = chat.command("group").description("Group chats — create, list, info, rename, add/remove members, leave");
   registerChatGroupCommand(group);
 }
@@ -28154,18 +28402,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
     });
@@ -29044,8 +29306,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);
@@ -29073,7 +29345,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 {
@@ -29099,7 +29371,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 {
@@ -29109,17 +29382,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.11",
+  "version": "0.14.0-beta.13",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -33,6 +33,7 @@ Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar)
 | "what comments are on my post?" | shell → `amiko post comments --id <postId>` |
 | "search memory for X" | shell → `amiko memory search "X"` |
 | "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` |
 
 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.
@@ -129,6 +130,7 @@ MiniMax Hailuo is silent — there is no CLI mux step to attach a separate music
 - `amiko chat send <target> "message"` — send **as the owner**. Delivered in real time. `--yes` required in non-interactive shells (it's an outward message to a real person). `<target>` = a conversation id, a **user id**, an `@handle`, or a name. A user id / @handle / unambiguous name opens (or reuses) the DM for you — but only **after** the owner approves the send (via the confirmation, or `--yes` in your shell); nothing is created if approval is refused. **The owner never needs to start the conversation first, and there is no platform authorization step for starting a DM.** For **group chats**, use the conversation id from `list`.
 - **Inline media**: `--image <pathOrUrl>` (jpg/png/webp/gif, local ≤10MB or an Amiko URL — e.g. a generated image) and `--audio <pathOrUrl>` (local ≤25MB or an Amiko URL → sent as a voice note). One media block per message (image XOR audio). **Video is not supported** on chat yet. To share a generated asset, pass its URL from `amiko create status` (no re-upload). A local audio file is sent as a voice note with the text as a separate message.
 - Plain names resolve against the owner's **friends first**, then people search; if ambiguous the CLI errors listing the candidates — ask the owner which one, don't blind-send. A plain name that exactly matches one of the owner's group titles targets that **group**. If a send fails, surface the CLI's error verbatim — don't invent permission explanations or ask the owner to open the chat from the app.
+- **Reactions** — `amiko chat react <messageId> <emoji>`, `amiko chat unreact <messageId>`, `amiko chat reactions <messageId>`. The owner **won't give you a message id** — they'll say something like *"react to the latest Ava message about the team with a heart"*. Get ids from `amiko chat read <target>`: it prints each message's `id` and any existing reactions — match the message by its **content**, then act on that id. `react` adds (or replaces) your reaction — **one per message**, a new emoji replaces the previous one, and re-reacting the same emoji is a no-op (use `unreact` to remove). Pass the **actual emoji character** (`❤️`, `👍`, `😂`). `react`/`unreact` are outward (other people see them), so `--yes` is required in non-interactive shells and the confirmation shows a preview of the target message; `reactions` (read) is ungated. These act **as the owner** (人对人), just like `chat send` — not the twin's own `session_*`.
 
 ### Group chats — `amiko chat group`