@heyamiko/amiko-cli 0.7.10 → 0.8.1

package/README.md

@@ -1,6 +1,6 @@
-# @heyamiko/amiko-cli (v0.7.10)
+# @heyamiko/amiko-cli (v0.8.1)
 
-Manage wallets, credits, swaps, and MPP marketplace services from the terminal. Works for both human users and AI agents running on OpenClaw.
+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.
 
 ## Install
 
@@ -148,19 +148,20 @@ amiko swap send 0.5 USDC AMIKO --yes
 amiko swap send 100 AMIKO SOL --slippage 100
 ```
 
-Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address.
+Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address. `swap send` is hard-gated: in a non-interactive shell you must pass `--yes` after quoting the cost to the user (`Solana gas + 10bps platform fee`).
 
 ## Bridge
 
 ```bash
 amiko bridge quote <amount>              # cross-chain USDC quote via Across Protocol
-amiko bridge send <amount>               # execute bridge transfer
+amiko bridge send <amount>               # execute bridge transfer (gated — requires --yes in non-TTY)
+amiko bridge send <amount> --raw         # print transaction JSON without sending (no gate)
 amiko bridge status <txHash>             # check bridge status
 amiko bridge routes                      # available bridge routes
 amiko bridge limits                      # min/max limits per route
 ```
 
-Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains.
+Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains. Like `swap send`, `bridge send` refuses to run in a non-interactive shell without `--yes` so agents must quote the Across fee + gas to the user before executing.
 
 ## MPP Services
 
@@ -191,7 +192,7 @@ Audio and image endpoints upload to Supabase Storage and return permanent URLs.
 
 ## Confirmation Gate for Paid Commands
 
-Every paid command (`image`, `search`, `amazon search`, `service tts`, `service stt`, `service chat`, `service call`, `credits topup`) requires explicit approval before spending:
+Every paid / value-moving command (`image`, `search`, `amazon search`, `service tts`, `service stt`, `service chat`, `service call`, `credits topup`, `swap send`, `bridge send`) requires explicit approval before spending:
 
 - **Human, interactive shell** — the command prints the cost and prompts `Proceed? [y/N]`. Answer `y` to run.
 - **Agent / non-interactive shell** — the command *refuses* to run without `--yes`, with a message telling the agent what to do:
@@ -206,7 +207,7 @@ Every paid command (`image`, `search`, `amazon search`, `service tts`, `service
     amiko 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.
+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.
 
 ## Error Output
 
@@ -323,21 +324,81 @@ src/
 │   ├── discovery.ts      # MPP service info
 │   ├── login.ts          # Privy browser login
 │   ├── config.ts         # config management
-│   └── update.ts         # self-update
+│   ├── update.ts         # self-update
+│   ├── accounts.ts       # accounts, info (twin identity readout)
+│   ├── twin.ts           # twin:update (name/description/public)
+│   ├── docs.ts           # RAG documents (list, upload, delete, presign)
+│   ├── voice.ts          # voice:design, voice:create, voice:clone, voice:reset
+│   ├── avatar.ts         # avatar:update
+│   ├── friends.ts        # friends list, add, accept, remove
+│   ├── feed.ts           # feed, post:comment
+│   └── composio.ts       # composio:connect, composio:disconnect
 └── lib/
     ├── config.ts          # ~/.amiko/config.json
     ├── agent-config.ts    # .amiko.json reader + auth resolution
     ├── api.ts             # HTTP client (MPP + billing)
-    ├── format.ts          # terminal output helpers
+    ├── amiko-web.ts       # HTTP client for amiko-web (twin + social REST)
+    ├── twin-context.ts    # resolveTwinId (--twin | .amiko.json | config.twinId)
+    ├── file-input.ts      # path | https URL | stdin → Buffer + mime
+    ├── format.ts          # terminal output helpers + renderOutput(--json)
+    ├── confirm.ts         # requireApproval + confirmDestructive
     ├── mpp-topup.ts       # MPP SDK topup helper
     ├── across.ts          # Across Protocol bridge
     └── tempo.ts           # Tempo chain helpers
 ```
 
+## Twin & Social Commands (v0.8.0)
+
+The CLI also manages the twin's identity, documents, voice, avatar, friends, feed, and Composio connections via the amiko-web platform API.
+
+```bash
+# Identity
+amiko accounts                          # show resolved identity (mode, platform, user, twin, wallets)
+amiko info                              # fetch twin info (name, description, voice, avatar, visibility)
+amiko twin:update --name "New Name"
+amiko twin:update --description "Bio"
+amiko twin:update --public true --yes   # change public visibility (destructive)
+
+# Documents (RAG)
+amiko docs                              # list
+amiko docs:upload ./notes.pdf           # path, URL, or `- --stdin`
+amiko docs:delete <docId> --yes
+amiko docs:presign ./file.pdf           # presigned S3 URL only
+
+# Voice
+amiko voice:design --description "warm, low, male, confident, measured"
+amiko voice:create --sample <generated_voice_id>
+amiko voice:clone ./me.mp3
+amiko voice:reset --yes
+
+# Avatar
+amiko avatar:update --file ./portrait.png --yes
+
+# Friends
+amiko friends                           # list
+amiko friends:add --id <userId>
+amiko friends:accept <friendshipId>
+amiko friends:remove <friendshipId> --yes
+
+# Feed & posts
+amiko feed                              # friends feed (default)
+amiko feed --type for_you --limit 20
+amiko post:comment --id <postId> --comment "great post"
+
+# Composio
+amiko composio:connect --app gmail      # prints OAuth URL
+amiko composio:disconnect --app gmail --yes
+```
+
+Every new command accepts `--json` for structured output and `--twin <id>` where a target twin is needed.
+
+**Destructive or identity-changing commands** (`docs:delete`, `friends:remove`, `composio:disconnect`, `voice:reset`, `avatar:update`, `twin:update --public`) prompt for confirmation in a TTY and require `--yes` in non-interactive shells.
+
 ## API Endpoints
 
 | Client | Base URL | Purpose |
 |--------|----------|---------|
+| Amiko Web | `platform.heyamiko.com` | Twin identity, docs, voice, avatar, friends, feed, Composio |
 | MPP API | `mpp.amikomarkets.com` | Marketplace services, search, image, audio |
 | Billing API | `billing.heyamiko.com` | Credits, topup, wallet balances, keys |