@heyamiko/amiko-cli 0.8.3 → 0.9.0-beta.0

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.8.3)
+# @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,20 +16,29 @@ 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 search "AI agents" --wallet <solana-address>
 
 # Generate an image (5 AMIKO)
-amiko image "a sunset over mountains"
+amiko image "a sunset over mountains" --wallet <solana-address>
 
 # Swap tokens on Solana
 amiko swap quote 1.0 SOL USDC
@@ -247,38 +256,34 @@ amiko 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,19 @@ 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`).
+- Test suite: removed stale `wallet`/`whoami` assertions; `--version` now reads from `package.json` so future bumps don't break it.
+
 ### 0.8.3
 
 - `post:create --media` and `post:comment --media` — attach media URLs to feed posts and comments.