@heyamiko/amiko-cli 0.8.4 → 0.9.0-beta.1

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.8.4)
+# @heyamiko/amiko-cli (v0.9.0-beta.0)
 
 Manage wallets, credits, swaps, MPP marketplace services, and your Amiko twin (identity, documents, voice, avatar, friends, feed, Composio apps) from the terminal. Works for both human users and AI agents running on OpenClaw.
 
@@ -16,28 +16,37 @@ amiko update
 
 ## Quick Start
 
-Auth is automatic on twins and OpenClaw agents via `.amiko.json`. On a local machine, generate an API key from your Amiko settings and place it in `~/.amiko/config.json` as `apiKey`.
+Auth is loaded from `.amiko.json` found in the current working directory (or any parent). The only required field is `amikoTwinToken`. The CLI walks upward from cwd; if none is found it falls back to `/data/.openclaw/workspace/.amiko.json`.
+
+```json
+{
+  "amikoTwinToken": "clawd-...",
+  "amikoTwinId": "twin_..."
+}
+```
+
+All paid operations (credits topup, wallet transfer, swap) are signed by the Amiko platform on your behalf — the CLI never holds private keys.
 
 ```bash
 # Check your balance
 amiko credits balance
 
-# Top up credits from your agent's wallet
+# Top up credits (platform signs the transfer from your agent wallet)
 amiko credits topup 10000 --token AMIKO --yes
 
-# Search X/Twitter (1 AMIKO)
-amiko search "AI agents"
+# Search X/Twitter (1 AMIKO, pass --wallet)
+amiko market search "AI agents" --wallet <solana-address>
 
 # Generate an image (5 AMIKO)
-amiko image "a sunset over mountains"
+amiko market image "a sunset over mountains" --wallet <solana-address>
 
 # Swap tokens on Solana
 amiko swap quote 1.0 SOL USDC
 amiko swap send 1.0 SOL USDC --yes
 
 # Call any MPP service
-amiko service list
-amiko service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'
+amiko market service list
+amiko market service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'
 ```
 
 ## Credits
@@ -84,9 +93,9 @@ amiko credits topup 10000 --wallet Gu2b...QVya        # specific wallet
 ## Search
 
 ```bash
-amiko search "AI agents"                 # search X/Twitter (1 AMIKO)
-amiko search "bitcoin" --token USDC      # pay with USDC instead
-amiko search "news" --raw                # raw JSON output
+amiko market search "AI agents"                 # search X/Twitter (1 AMIKO)
+amiko market search "bitcoin" --token USDC      # pay with USDC instead
+amiko market search "news" --raw                # raw JSON output
 ```
 
 Pays 1 AMIKO per search via Crossmint wallet transfer. Tries Solana wallet first, falls back to EVM.
@@ -94,12 +103,12 @@ Pays 1 AMIKO per search via Crossmint wallet transfer. Tries Solana wallet first
 ## Image Generation
 
 ```bash
-amiko image "a sunset over mountains"                    # gpt-image-1 (default)
-amiko image "logo" --background transparent              # transparent background
-amiko image "cat" --model dall-e-3                       # DALL-E 3
-amiko image "portrait" --size 1024x1792 --quality high   # portrait, high quality
-amiko image "icon" --format webp                         # webp output
-amiko image "banner" --raw                               # raw JSON
+amiko market image "a sunset over mountains"                    # gpt-image-1 (default)
+amiko market image "logo" --background transparent              # transparent background
+amiko market image "cat" --model dall-e-3                       # DALL-E 3
+amiko market image "portrait" --size 1024x1792 --quality high   # portrait, high quality
+amiko market image "icon" --format webp                         # webp output
+amiko market image "banner" --raw                               # raw JSON
 ```
 
 Costs 5 AMIKO per image. Returns a Supabase Storage URL.
@@ -109,8 +118,8 @@ Image generation typically takes 20–60s. In non-TTY environments (agents, pipe
 ## Amazon
 
 ```bash
-amiko amazon search "usb c cable"        # product search (1 AMIKO)
-amiko amazon quote B01GGKYKQM            # price quote (free)
+amiko market amazon search "usb c cable"        # product search (1 AMIKO)
+amiko market amazon quote B01GGKYKQM            # price quote (free)
 ```
 
 ## Swap
@@ -149,24 +158,24 @@ Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains.
 Call any endpoint on the Amiko marketplace with automatic AMIKO payment:
 
 ```bash
-amiko service list                       # all services + prices
-amiko service call <METHOD> <path> [body]
+amiko market service list                       # all services + prices
+amiko market service call <METHOD> <path> [body]
 ```
 
 **Examples:**
 
 ```bash
 # Sound effects ($0.05) — returns { url, format, service }
-amiko service call POST /v1/sfx '{"text":"Thunder with heavy rain","duration_seconds":5}'
+amiko market service call POST /v1/sfx '{"text":"Thunder with heavy rain","duration_seconds":5}'
 
 # Music generation ($0.10) — returns { url, format, service }
-amiko service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
+amiko market service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
 
 # Text-to-speech (1 AMIKO) — returns { url, format, service }
-amiko service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
+amiko market service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
 
 # Composition plan ($0.02)
-amiko service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
+amiko market service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
 ```
 
 Audio and image endpoints upload to Supabase Storage and return permanent URLs.
@@ -185,7 +194,7 @@ Every paid / value-moving command (`image`, `search`, `amazon search`, `service
   Action: Generate image: a sunset over mountains
   
   Quote the cost to the user, get their explicit approval, then re-run with --yes:
-    amiko image "a sunset over mountains" --yes
+    amiko market image "a sunset over mountains" --yes
   ```
 
 This makes cost confirmation effectively mandatory regardless of which model drives the agent — weak models can no longer silently burn tokens by ignoring the skill docs. The same refusal fires for `swap send` (Solana gas + 10 bps platform fee) and `bridge send` (Across fee + gas), so an agent cannot move tokens without a round-trip through user approval.
@@ -206,7 +215,7 @@ JSON `error` / `message` / `detail` fields are extracted when present; raw body
 ## Other Commands
 
 ```bash
-amiko discovery                          # MPP service info + pricing
+amiko market discover                          # MPP service info + pricing
 amiko config show                        # view config
 amiko config set <key> <value>           # set config value
 amiko update                             # update CLI to latest (full twin refresh — no restart needed)
@@ -243,42 +252,38 @@ Agents auto-authenticate via `.amiko.json` — no manual connect needed. The pla
 ```bash
 # Agent environment — just works
 amiko credits balance
-amiko search "trending topics"
+amiko market search "trending topics"
 amiko credits topup 10000 --token AMIKO --yes
 ```
 
-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`
+The CLI finds `.amiko.json` by:
+1. Walking up from the current working directory.
+2. Falling back to `/data/.openclaw/workspace/.amiko.json`.
 
 Supported keys (both camelCase and SCREAMING_SNAKE_CASE):
-- `amikoTwinToken` / `AMIKO_TWIN_TOKEN` — auth token
-- `amikoTwinId` / `AMIKO_TWIN_ID` — twin identifier
-- `amikoPlatformUrl` / `AMIKO_PLATFORM_URL` — platform base URL
-- `agentWallets` — array of `{ chain, address }`
-- `billingBase` — billing API URL
-- `platformKey` — API key override
-
-**Stale config pitfall:** If `~/.amiko/config.json` exists with an old `apiKey`, it takes priority over `.amiko.json` twin token. Remove stale keys or let the platform manage auth.
+- `amikoTwinToken` / `AMIKO_TWIN_TOKEN` — **required** auth token
+- `amikoTwinId` / `AMIKO_TWIN_ID` — twin identifier (needed for paid ops)
+- `amikoUserId` / `AMIKO_USER_ID` — user identifier (optional, for MPP topup)
+- `amikoPlatformUrl` / `AMIKO_PLATFORM_URL` — platform base URL override
+- `billingBase` — billing API URL override
+- `apiBase` — MPP service URL override
 
 ## Configuration
 
-Config file: `~/.amiko/config.json`
+Defaults (no config file needed — override in `.amiko.json` if needed):
 
 | Key | Default |
 |-----|---------|
 | `billingBase` | `https://billing.heyamiko.com` |
 | `apiBase` | `https://mpp.amikomarkets.com` |
-| `siteBase` | `https://platform.heyamiko.com` |
+| `platformUrl` | `https://platform.heyamiko.com` |
 
 ## Architecture
 
 ```
 src/
 ├── index.ts              # entry point (Commander)
-├── onboarding.ts         # first-run setup
+├── onboarding.ts         # no-op (auth is file-based)
 ├── commands/
 │   ├── credits.ts        # credits balance + topup
 │   ├── search.ts         # X/Twitter search (1 AMIKO via MPP)
@@ -299,7 +304,7 @@ src/
 │   ├── feed.ts           # feed, post:create, post:comment
 │   └── composio.ts       # composio:connect, composio:disconnect
 └── lib/
-    ├── config.ts          # ~/.amiko/config.json
+    ├── config.ts          # defaults + resolved auth wrapper
     ├── agent-config.ts    # .amiko.json reader + auth resolution
     ├── api.ts             # HTTP client (MPP + billing)
     ├── amiko-web.ts       # HTTP client for amiko-web (twin + social REST)
@@ -380,6 +385,14 @@ npm publish
 
 ## Changelog
 
+### 0.9.0-beta.0
+
+- **Breaking**: auth simplified to `.amiko.json` + `amikoTwinToken` only. Removed `apiKey`, `privyToken`, `platformKey`, `connectedKeyId`, `agentWallets`, and `~/.amiko/config.json`.
+- **Breaking**: `config set`, `config reset`, `config path` removed — `.amiko.json` is the single source of truth.
+- **Breaking**: `credits topup` now routes through platform (`POST /api/agents/{twinId}/credits/topup`). Platform signs and verifies; the CLI never holds keys.
+- **Breaking**: `swap send`, `search`, `image`, `amazon search`, and `service *` paid flows now require `--wallet <address>` and route transfers through the platform.
+- MPP-direct topup kept as an escape hatch: `credits topup --method mpp --key-id <keyId>`.
+
 ### 0.8.4
 
 - Documentation catch-up for 0.8.3 (header version, removed lingering references to `amiko connect` / `whoami`).