@heyamiko/amiko-cli 0.6.4 → 0.6.6

package/README.md

@@ -1,4 +1,4 @@
-# Amiko CLI
+# amiko-cli (v0.6.6)
 
 Manage agents, wallets, credits, and the MPP marketplace from your terminal. Works for both human users and AI agents running on OpenClaw.
 
@@ -147,6 +147,27 @@ amiko bridge routes               # available bridge routes
 amiko bridge limits               # min/max limits per route
 ```
 
+## Audio & Voice
+
+All audio endpoints return binary audio streams. Use `amiko service call` for direct access:
+
+```bash
+# Sound effects ($0.05)
+amiko service call POST /v1/sfx '{"text":"Thunder with heavy rain","duration_seconds":5}'
+
+# Music generation ($0.10)
+amiko service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
+
+# Composition plan ($0.02) — get JSON plan before generating
+amiko service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
+
+# Text-to-speech ($0.50/1K chars)
+amiko service call POST /v1/tts/21m00Tcm4TlvDq8ikWAM '{"text":"Hello world"}'
+
+# List all available services + prices
+amiko service list
+```
+
 ## Other Commands
 
 ```bash
@@ -158,24 +179,49 @@ amiko config set <key> <value>    # set config value
 amiko update                      # update CLI to latest
 ```
 
+## X Search
+
+```bash
+amiko search "AI agents"                 # search X (pays 1 AMIKO from Solana wallet)
+amiko search "bitcoin" --token USDC      # pay with USDC instead
+amiko search "news" --raw                # raw JSON output
+```
+
+Pays via Crossmint server-signed transfer from the agent's wallet. Tries Solana wallet first, falls back to EVM (Base/Tempo).
+
+## Image Generation
+
+```bash
+amiko image "a sunset over mountains"                    # gpt-image-1 (default, base64)
+amiko image "logo" --background transparent              # transparent background
+amiko image "cat" --model dall-e-3                       # DALL-E 3 (returns URL)
+amiko image "portrait" --size 1024x1792 --quality high   # portrait, high quality
+amiko image "icon" --format webp                         # webp output
+amiko image "banner" --raw                               # raw JSON (for piping)
+```
+
+Costs 5 AMIKO per image. Default model is `gpt-image-1` which returns base64 data (permanent, no expiring URLs).
+
 ## Agent Integration (OpenClaw)
 
-Agents install the CLI and connect with a code from the user:
+Agents auto-authenticate via `.amiko.json` — no manual connect needed. The platform writes this file during twin init with wallets, billing config, and twin token.
 
 ```bash
-npm install -g @heyamiko/amiko-cli
-amiko connect <CODE>
+# Agent environment — just works
 amiko credits balance
+amiko search "trending topics"
 amiko credits topup 10000 --token AMIKO --yes
 ```
 
-The CLI auto-detects `.amiko.json` (synced by the platform) when running on an agent. It checks:
+The CLI checks for `.amiko.json` in order:
 1. `$OPENCLAW_WORKSPACE_DIR/.amiko.json`
 2. `$OPENCLAW_HOME/.openclaw/workspace/.amiko.json`
 3. `/data/.openclaw/workspace/.amiko.json`
 4. Walking up from `cwd`
 
-When `.amiko.json` is found, the CLI automatically authenticates using the twin token -- no manual connect needed.
+The `.amiko.json` provides: `AMIKO_TWIN_TOKEN` (auth), `agentWallets` (Solana + Base addresses), `billingBase`, and optionally `platformKey`.
+
+**Important:** If `~/.amiko/config.json` exists with a stale `apiKey`, it takes priority over `.amiko.json` twin token. Remove stale keys or let the platform manage auth.
 
 ## Configuration
 

package/dist/index.js

@@ -71871,6 +71871,25 @@ function tryLoadConfig(filePath) {
   }
 }
 function resolveAuth(cliConfig) {
+  const agentConfig = loadAgentConfig();
+  if (agentConfig?.agentWallets?.length && !cliConfig.agentWallets?.length) {
+    cliConfig.agentWallets = agentConfig.agentWallets;
+  }
+  if (agentConfig?.billingBase && !cliConfig.billingBase) {
+    cliConfig.billingBase = agentConfig.billingBase;
+  }
+  if (agentConfig?.twinToken && !cliConfig.twinToken) {
+    cliConfig.twinToken = agentConfig.twinToken;
+  }
+  if (agentConfig?.twinId && !cliConfig.twinId) {
+    cliConfig.twinId = agentConfig.twinId;
+  }
+  if (agentConfig?.userId && !cliConfig.userId) {
+    cliConfig.userId = agentConfig.userId;
+  }
+  if (agentConfig?.platformKey && !cliConfig.apiKey) {
+    cliConfig.apiKey = agentConfig.platformKey;
+  }
   if (cliConfig.agentWallets?.length) {
     return {
       mode: "connected",
@@ -71916,7 +71935,6 @@ function resolveAuth(cliConfig) {
       platformUrl: process.env.AMIKO_PLATFORM_URL
     };
   }
-  const agentConfig = loadAgentConfig();
   if (agentConfig?.twinToken) {
     return {
       mode: "agent",
@@ -72981,25 +72999,6 @@ async function get(path) {
   }
   return res.json();
 }
-async function post(path, body) {
-  const res = await fetch(`${mppBase()}${path}`, {
-    method: "POST",
-    headers: authHeaders(),
-    body: body ? JSON.stringify(body) : undefined
-  });
-  if (res.status === 402) {
-    const data = await res.json();
-    const err = new Error("Payment required");
-    err.status = 402;
-    err.data = data;
-    throw err;
-  }
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`${res.status} ${res.statusText}: ${text}`);
-  }
-  return res.json();
-}
 async function creatorPost(path, body) {
   const res = await fetch(`${billingBase()}${path}`, {
     method: "POST",
@@ -73531,7 +73530,7 @@ function sanitizeTempoWhoamiOutput(output) {
 function buildConnectedKeyTopupInput(config, amount) {
   const token = getPrivyToken(config);
   if (!token) {
-    throw new Error('Not signed in. Run "amiko login" first.');
+    throw new Error("Not signed in. Check .amiko.json credentials.");
   }
   if (!config.connectedKeyId) {
     throw new Error("No connected API key is attached to this account. Sign in again after creating a server-side key.");
@@ -73557,32 +73556,6 @@ function openUrl(url) {
 }
 function registerWalletCommand(program2) {
   const cmd = program2.command("wallet").description("Manage MPP wallets");
-  cmd.command("create").description("Create a new MPP wallet on Tempo").option("--save", "Save the wallet address to CLI config").action(async (opts) => {
-    const spinner = ora("Creating wallet...").start();
-    try {
-      const data = await post("/v1/wallet/create");
-      spinner.stop();
-      console.log(success("Wallet created"));
-      console.log("");
-      console.log(label("Address", source_default.cyan(data.address)));
-      console.log(label("Wallet ID", data.walletId));
-      if (data.chain)
-        console.log(label("Chain", data.chain));
-      console.log("");
-      console.log(dim("Fund it with USDC.e on Tempo to start using paid services."));
-      if (opts.save) {
-        saveConfig({ wallet: data.address });
-        console.log(success("Saved to CLI config"));
-      } else {
-        console.log(dim(`
-Tip: amiko config set wallet ${data.address}`));
-      }
-    } catch (err) {
-      spinner.stop();
-      console.error(error(err instanceof Error ? err.message : "Failed to create wallet"));
-      process.exit(1);
-    }
-  });
   cmd.command("balance").description("Check wallet balance").argument("[address]", "Wallet address (uses configured wallet if omitted)").option("-w, --watch", "Poll balance every 5 seconds").option("--interval <seconds>", "Poll interval in seconds (with --watch)", "5").action(async (address, opts) => {
     const addr = address || loadConfig().wallet;
     if (!addr) {
@@ -73721,12 +73694,12 @@ Tip: add --open to auto-launch in browser.`));
     }
     const agentWallet = config.agentWallets?.find((w5) => w5.address === fromAddr);
     if (!agentWallet?.signerSecret) {
-      console.error(error('No signer secret for this wallet. Re-run "amiko connect" to fetch it.'));
+      console.error(error("No signer secret for this wallet. Re-init from the Amiko dashboard to provision wallet keys."));
       process.exit(1);
     }
     const apiKey = process.env.CROSSMINT_API_KEY || config.apiKey;
     if (!apiKey) {
-      console.error(error('No API key. Set CROSSMINT_API_KEY or run "amiko connect".'));
+      console.error(error("No API key. Check platformKey in .amiko.json or set CROSSMINT_API_KEY."));
       process.exit(1);
     }
     const spinner = ora(`Sending ${amount} ${token} to ${truncAddr(to)}...`).start();
@@ -73782,7 +73755,7 @@ function requireCreatorToken() {
   const token = getPrivyToken(config);
   if (!token) {
     console.error(error("Not signed in."));
-    console.log(dim("Run: amiko login"));
+    console.log(dim("Check .amiko.json credentials."));
     process.exit(1);
   }
   return token;
@@ -75256,7 +75229,7 @@ function registerCreditsCommand(program2) {
       const auth = resolveAuth(loadConfig());
       if (auth.mode === "none") {
         spinner.stop();
-        console.error(error("Not connected"));
+        console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       spinner.stop();
@@ -75365,19 +75338,19 @@ function registerCreditsCommand(program2) {
       const auth = resolveAuth(loadConfig());
       if (auth.mode === "none") {
         spinner.stop();
-        console.error(error("Not connected"));
+        console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       const billingBase2 = auth.billingBase || "https://billing.heyamiko.com";
       if (!billingBase2) {
         spinner.stop();
-        console.error(error("Billing service not configured. Run: amiko connect"));
+        console.error(error("Billing service not configured. Check billingBase in .amiko.json."));
         process.exit(1);
       }
       const authToken = auth.platformKey || auth.twinToken || auth.privyToken;
       if (!authToken) {
         spinner.stop();
-        console.error(error("No API key or auth token. Run: amiko connect"));
+        console.error(error("No API key or auth token. Check platformKey in .amiko.json."));
         process.exit(1);
       }
       const authHeaders2 = {
@@ -75661,7 +75634,7 @@ function registerSwapCommand(program2) {
       const config2 = loadConfig();
       const auth = resolveAuth(config2);
       if (auth.mode === "none") {
-        console.error(error("Not connected. Set up .amiko.json or run: amiko connect"));
+        console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       const allWallets = auth.agentWallets || config2.agentWallets || [];
@@ -75833,7 +75806,7 @@ function registerUpdateCommand(program2) {
 // src/commands/search.ts
 var TREASURY = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 function registerSearchCommand(program2) {
-  program2.command("search <query>").description("X Search — pays 1 AMIKO token per search").option("--raw", "Output raw JSON").action(async (query, opts) => {
+  program2.command("search <query>").description("X Search — pays 1 AMIKO token per search").option("--raw", "Output raw JSON").option("--token <token>", "Payment token (AMIKO, USDC, SOL)", "AMIKO").action(async (query, opts) => {
     const spinner = ora("X Search...").start();
     try {
       const config2 = loadConfig();
@@ -75843,18 +75816,25 @@ function registerSearchCommand(program2) {
       const billingToken = auth.platformKey || auth.twinToken || auth.privyToken;
       if (auth.mode === "none" || !billingToken) {
         spinner.stop();
-        console.error(error("Not connected."));
+        console.error(error("Not authenticated. Check .amiko.json has valid credentials."));
         process.exit(1);
       }
       const allWallets = auth.agentWallets || config2.agentWallets || [];
       const solanaWallet = allWallets.find((w5) => w5.chain === "solana")?.address;
-      if (!solanaWallet) {
+      const evmWallet = allWallets.find((w5) => w5.chain === "base" || w5.chain === "evm" || w5.chain === "tempo")?.address;
+      if (!solanaWallet && !evmWallet) {
         spinner.stop();
-        console.error(error("No Solana wallet found for AMIKO payment."));
+        console.error(error("No wallet found. Your twin needs a Solana or EVM wallet."));
+        console.log(dim("  Re-init your twin from the Amiko dashboard to provision wallets."));
         process.exit(1);
       }
-      spinner.text = "Paying 1 AMIKO...";
-      const transferRes = await fetch(`${billingBase2}/api/crossmint/wallets/${encodeURIComponent(solanaWallet)}/transfer`, {
+      const payWithSolana = !!solanaWallet;
+      const wallet = payWithSolana ? solanaWallet : evmWallet;
+      const chain = payWithSolana ? "solana" : "base";
+      const token = payWithSolana ? opts.token || "AMIKO" : "USDC";
+      const amount2 = token === "AMIKO" ? "1" : "0.01";
+      spinner.text = `Paying ${amount2} ${token} (${chain})...`;
+      const transferRes = await fetch(`${billingBase2}/api/crossmint/wallets/${encodeURIComponent(wallet)}/transfer`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -75862,15 +75842,15 @@ function registerSearchCommand(program2) {
         },
         body: JSON.stringify({
           to: TREASURY,
-          amount: "1",
-          token: "AMIKO",
-          chain: "solana"
+          amount: amount2,
+          token,
+          chain
         })
       });
       if (!transferRes.ok) {
         spinner.stop();
         const err = await transferRes.json().catch(() => ({ error: "Transfer failed" }));
-        console.error(error(err.error || `AMIKO payment failed: ${transferRes.status}`));
+        console.error(error(err.error || `${token} payment failed: ${transferRes.status}`));
         process.exit(1);
       }
       const transferData = await transferRes.json();
@@ -75880,21 +75860,22 @@ function registerSearchCommand(program2) {
         console.error(error("Payment sent but no tx hash returned."));
         process.exit(1);
       }
-      spinner.text = `Paid 1 AMIKO — searching X...`;
+      spinner.text = `Paid ${amount2} ${token} — searching X...`;
       const params = new URLSearchParams({ q: query });
       const res = await fetch(`${mppBase2}/v1/x/search?${params}`, {
         headers: {
           "Content-Type": "application/json",
           "X-Payment-Tx": txHash,
-          "X-Payment-Amount": "1",
-          "X-Payment-Token": "AMIKO"
+          "X-Payment-Amount": amount2,
+          "X-Payment-Token": token
         }
       });
       spinner.stop();
       if (!res.ok) {
         const text = await res.text().catch(() => "");
         console.error(error(`Search failed: ${res.status} ${text.slice(0, 200)}`));
-        console.log(dim(`Payment tx: https://solscan.io/tx/${txHash}`));
+        const explorer = chain === "solana" ? `https://solscan.io/tx/${txHash}` : `https://explorer.tempo.xyz/tx/${txHash}`;
+        console.log(dim(`Payment tx: ${explorer}`));
         process.exit(1);
       }
       const data = await res.json();
@@ -75920,7 +75901,7 @@ function registerSearchCommand(program2) {
           console.log("");
         }
       }
-      console.log(success("Paid 1 AMIKO") + dim(` tx: ${txHash.slice(0, 16)}...`));
+      console.log(success(`Paid ${amount2} ${token}`) + dim(` tx: ${txHash.slice(0, 16)}...`));
     } catch (err) {
       spinner.stop();
       console.error(error(err instanceof Error ? err.message : "Search failed"));
@@ -75932,7 +75913,7 @@ function registerSearchCommand(program2) {
 // src/commands/image.ts
 var TREASURY2 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 function registerImageCommand(program2) {
-  program2.command("image <prompt>").alias("img").description("Generate an image with DALL-E — costs 5 AMIKO").option("--size <size>", "Image size: 1024x1024, 1024x1792, 1792x1024", "1024x1024").option("--quality <q>", "Quality: standard or hd", "standard").option("--model <model>", "Model: dall-e-3 or dall-e-2", "dall-e-3").option("--raw", "Output raw JSON").action(async (prompt2, opts) => {
+  program2.command("image <prompt>").alias("img").description("Generate an image — costs 5 AMIKO").option("--size <size>", "Image size: 1024x1024, 1024x1792, 1792x1024", "1024x1024").option("--quality <q>", "Quality: auto, low, medium, high (gpt-image-1) or standard, hd (dall-e-3)", "auto").option("--model <model>", "Model: gpt-image-1 or dall-e-3", "gpt-image-1").option("--background <bg>", "Background: transparent, opaque, auto (gpt-image-1 only)").option("--format <fmt>", "Output: png, webp, jpeg (gpt-image-1 only)", "png").option("--raw", "Output raw JSON").action(async (prompt2, opts) => {
     const spinner = ora("Generating image...").start();
     try {
       const config2 = loadConfig();
@@ -75942,7 +75923,7 @@ function registerImageCommand(program2) {
       const billingToken = auth.platformKey || auth.twinToken || auth.privyToken;
       if (!billingToken) {
         spinner.stop();
-        console.error(error("Not connected."));
+        console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       const allWallets = auth.agentWallets || config2.agentWallets || [];
@@ -75990,7 +75971,9 @@ function registerImageCommand(program2) {
           prompt: prompt2,
           size: opts.size,
           quality: opts.quality,
-          model: opts.model
+          model: opts.model,
+          ...opts.background && { background: opts.background },
+          ...opts.model === "gpt-image-1" && { output_format: opts.format || "png" }
         })
       });
       spinner.stop();
@@ -76013,9 +75996,12 @@ function registerImageCommand(program2) {
       console.log("");
       const images = data.images || data.data || [];
       for (const img of images) {
-        const url2 = img.url || img.revised_prompt || "";
-        if (url2)
-          console.log(label("URL", url2));
+        if (img.url) {
+          console.log(label("URL", img.url));
+        } else if (img.b64_json) {
+          console.log(label("Format", "base64 (inline image data)"));
+          console.log(dim(`  ${img.b64_json.length.toLocaleString()} chars — save with: amiko image "..." --raw | jq -r '.images[0].b64_json' | base64 -d > image.png`));
+        }
         if (img.revised_prompt && img.revised_prompt !== prompt2) {
           console.log(label("Revised", dim(img.revised_prompt)));
         }
@@ -76062,7 +76048,7 @@ function registerAmazonCommand(program2) {
       const billingToken = auth.platformKey || auth.twinToken || auth.privyToken;
       if (!billingToken) {
         spinner.stop();
-        console.error(error("Not connected."));
+        console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       const allWallets = auth.agentWallets || config2.agentWallets || [];

package/package.json

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