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

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.14.0-beta.13)
+# @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.
 
@@ -583,6 +583,10 @@ 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`.

package/dist/index.js

@@ -23655,7 +23655,9 @@ 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;
@@ -23674,6 +23676,8 @@ function readFromEnv() {
     userId: asString(process.env.AMIKO_USER_ID),
     platformUrl: asString(process.env.AMIKO_PLATFORM_URL),
     apiBase: asString(process.env.AMIKO_API_BASE),
+    billingApiKey: asString(process.env.AMIKO_API_KEY),
+    billingUrl: asString(process.env.AMIKO_BILLING_URL),
     ...readRoutingIdsFromEnv()
   };
 }
@@ -23681,7 +23685,13 @@ function resolveFileAuth(path) {
   const fromFile = readFromFile(path);
   if (!fromFile)
     return null;
-  return { ...fromFile, ...readRoutingIdsFromEnv() };
+  const fromEnv = readFromEnv();
+  return {
+    ...fromFile,
+    ...readRoutingIdsFromEnv(),
+    billingApiKey: fromEnv.billingApiKey ?? fromFile.billingApiKey,
+    billingUrl: fromEnv.billingUrl ?? fromFile.billingUrl
+  };
 }
 function resolveAuth() {
   const filePath = findAmikoJsonPath();
@@ -25418,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 {
@@ -25429,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) {
@@ -28639,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;
@@ -28663,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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.14.0-beta.13",
+  "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