@heyamiko/amiko-cli 0.11.0-beta.2 → 0.12.0-beta.1

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.11.0-beta.2)
+# @heyamiko/amiko-cli (v0.11.0-beta.3)
 
 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.
 
@@ -116,6 +116,88 @@ Pricing is OpenAI pass-through × 1.30 markup, paid in AMIKO at the live AMIKO/U
 
 Image generation typically takes 20–60s. In non-TTY environments (agents, piped shells), the CLI prints a `…still working (Ns elapsed)` tick to stderr every 3s so the parent process can tell it hasn't hung.
 
+## Create Studio
+
+The CLI half of the platform's Create Studio. `amiko create` generates media through Amiko's own authenticated endpoints (not the raw MPP pay-per-call surface `amiko markets` uses). Generation runs **asynchronously** and is **charged on success** from your twin's wallet — a failed or timed-out generation is never billed, and there's no up-front payment.
+
+```bash
+amiko create image "a sunset over mountains"                    # default gpt-image-2, 1:1
+amiko create image "logo" --aspect 16:9 --model gpt-image-2     # widescreen
+amiko create video "a whale in space" --resolution 768P --seconds 6
+amiko create tts "Hello world" --voice 21m00Tcm4TlvDq8ikWAM
+amiko create music "lo-fi chill beat" --duration 30000
+amiko create music --lyrics "..." --instrumental               # instrumental
+amiko create sfx "thunder and heavy rain" --duration 5
+amiko create image "banner" --raw                               # raw JSON
+```
+
+Modes: `image`, `video`, `tts`, `music`, `sfx` (mirrors the platform Create Studio).
+
+**Common flags (all subcommands):**
+
+| Flag | Description |
+|------|-------------|
+| `--token <symbol>` | Charge token: `AMIKO`, `USDC`, `USDT`, `SOL` (default: auto, AMIKO-first) |
+| `--yes` | Skip the pre-spend confirmation (required in non-interactive shells) |
+| `--raw` | Output the raw job result as JSON |
+
+**`amiko create image <prompt>`**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <model>` | `gpt-image-2` | Image model |
+| `--aspect <ratio>` | `1:1` | Aspect ratio: `1:1`, `16:9`, `9:16`, `4:3`, `3:4` |
+
+**`amiko create video <prompt>`**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <model>` | `MiniMax-Hailuo-2.3-Fast` | Video model |
+| `--resolution <res>` | `768P` | `512P`, `720P`, `768P`, `1080P` |
+| `--seconds <n>` | `6` | Clip length: `6` or `10` |
+| `--aspect <ratio>` | — | Aspect ratio (provider-dependent) |
+| `--first-frame <url>` | — | Image-to-video: first frame URL or data URI |
+
+**`amiko create tts <text>`**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <model>` | `eleven_multilingual_v2` | TTS model id |
+| `--voice <voiceId>` | `21m00Tcm4TlvDq8ikWAM` | Voice id |
+
+**`amiko create music [prompt]`** — pass a prompt and/or `--lyrics`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <model>` | `music-2.6` | `music_v1`, `music-2.6`, `music-cover` |
+| `--lyrics <lyrics>` | — | Lyrics (optional) |
+| `--duration <ms>` | — | Length in milliseconds |
+| `--instrumental` | — | Instrumental (no vocals) |
+
+**`amiko create sfx <text>`**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--duration <seconds>` | — | Clip length in seconds |
+
+### How it works (and getting the result)
+
+The CLI **submits the job, then blocks and polls until it finishes** (video can take several minutes), printing the asset URL, whether you were charged, and the charge tx on success. In non-TTY environments it prints a `…still generating (Ns elapsed)` tick to stderr. `--raw` prints the full job result as JSON.
+
+If the poll window elapses (10 min for video, 5 min otherwise) the CLI does **not** treat it as failure — the generation may still complete server-side. It prints the **job id**; retrieve the finished asset with either:
+
+```bash
+amiko create status <jobId>   # re-query that job (queryable ~24h)
+amiko create media            # list your recent generations (permanent)
+amiko create media --service video --limit 5
+```
+
+- **`amiko create status <jobId>`** — re-polls the job once and prints its status / asset. Jobs stay queryable for ~24h.
+- **`amiko create media`** — lists your recent Create Studio generations (URL, type, model, prompt, date). `--service <type>` filters, `--limit <n>` caps (max 50), `--raw` for JSON. Use this once a job id has expired, or just to browse.
+- **Web:** `https://platform.heyamiko.com/media`
+
+> `amiko markets image` still exists and is unchanged — it's the direct MPP pay-per-call path (pre-pay in AMIKO). Use `amiko create` for the Create Studio experience (async, charge-on-success); use `amiko markets` for raw MPP endpoints.
+
 ## Amazon
 
 ```bash
@@ -391,7 +473,7 @@ npm publish
 
 ## Changelog
 
-### 0.11.0-beta.2
+### 0.11.0-beta.3
 
 - **`amiko composio` removed (breaking).** The Composio OAuth-connection commands (`composio connect`, `composio disconnect`) are gone — `src/commands/composio.ts` deleted, `composio` command group dropped from `src/index.ts`. SKILL.md frontmatter, command-groups list, `--yes`-gated list, and the dedicated `## Composio` block are all removed; README's lead paragraph, architecture tree, destructive-ops list, Platform-table row, and Composio code-block example are updated to match. Scripts that called `amiko composio ...` will now error with "unknown command".