@heyamiko/amiko-cli 0.6.5 → 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

@@ -75913,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();
@@ -75971,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();
@@ -75994,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)));
         }

package/package.json

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