@heyamiko/amiko-cli 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # @heyamiko/amiko-cli (v0.8.0)
1
+ # @heyamiko/amiko-cli (v0.8.1)
2
2
 
3
3
  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.
4
4
 
@@ -148,19 +148,20 @@ amiko swap send 0.5 USDC AMIKO --yes
148
148
  amiko swap send 100 AMIKO SOL --slippage 100
149
149
  ```
150
150
 
151
- Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address.
151
+ 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`).
152
152
 
153
153
  ## Bridge
154
154
 
155
155
  ```bash
156
156
  amiko bridge quote <amount> # cross-chain USDC quote via Across Protocol
157
- amiko bridge send <amount> # execute bridge transfer
157
+ amiko bridge send <amount> # execute bridge transfer (gated — requires --yes in non-TTY)
158
+ amiko bridge send <amount> --raw # print transaction JSON without sending (no gate)
158
159
  amiko bridge status <txHash> # check bridge status
159
160
  amiko bridge routes # available bridge routes
160
161
  amiko bridge limits # min/max limits per route
161
162
  ```
162
163
 
163
- Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains.
164
+ 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.
164
165
 
165
166
  ## MPP Services
166
167
 
@@ -191,7 +192,7 @@ Audio and image endpoints upload to Supabase Storage and return permanent URLs.
191
192
 
192
193
  ## Confirmation Gate for Paid Commands
193
194
 
194
- Every paid command (`image`, `search`, `amazon search`, `service tts`, `service stt`, `service chat`, `service call`, `credits topup`) requires explicit approval before spending:
195
+ 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:
195
196
 
196
197
  - **Human, interactive shell** — the command prints the cost and prompts `Proceed? [y/N]`. Answer `y` to run.
197
198
  - **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
206
207
  amiko image "a sunset over mountains" --yes
207
208
  ```
208
209
 
209
- 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.
210
+ 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.
210
211
 
211
212
  ## Error Output
212
213
 
@@ -221,19 +222,6 @@ Payment tx: https://solscan.io/tx/2mtcNTkYksJz2j15...
221
222
 
222
223
  JSON `error` / `message` / `detail` fields are extracted when present; raw body up to 2000 chars otherwise. Agents should relay this verbatim to the user instead of guessing at reasons.
223
224
 
224
- ## Wallet
225
-
226
- ```bash
227
- amiko wallet balance [address] # check USDC.e balance on Tempo
228
- amiko wallet balance --watch # poll every 5s (stops after 10 errors)
229
- amiko wallet send <to> <amount> # send tokens from agent wallet
230
- amiko wallet topup <amount> # Stripe checkout ($1-$100)
231
- amiko wallet deposit [address] # USDC.e deposit instructions
232
- amiko wallet login # Tempo wallet login (browser)
233
- amiko wallet whoami # Tempo wallet identity
234
- amiko wallet fund # fund via Tempo dashboard
235
- ```
236
-
237
225
  ## Other Commands
238
226
 
239
227
  ```bash
@@ -318,10 +306,8 @@ src/
318
306
  │ ├── amazon.ts # Amazon search + quote
319
307
  │ ├── swap.ts # Jupiter token swaps (Solana)
320
308
  │ ├── bridge.ts # Across Protocol cross-chain bridge
321
- │ ├── wallet.ts # wallet management (Tempo + Crossmint)
322
309
  │ ├── services.ts # generic MPP service calling
323
310
  │ ├── discovery.ts # MPP service info
324
- │ ├── login.ts # Privy browser login
325
311
  │ ├── config.ts # config management
326
312
  │ ├── update.ts # self-update
327
313
  │ ├── accounts.ts # accounts, info (twin identity readout)
@@ -330,7 +316,7 @@ src/
330
316
  │ ├── voice.ts # voice:design, voice:create, voice:clone, voice:reset
331
317
  │ ├── avatar.ts # avatar:update
332
318
  │ ├── friends.ts # friends list, add, accept, remove
333
- │ ├── feed.ts # feed, post:comment
319
+ │ ├── feed.ts # feed, post:create, post:comment
334
320
  │ └── composio.ts # composio:connect, composio:disconnect
335
321
  └── lib/
336
322
  ├── config.ts # ~/.amiko/config.json
@@ -382,6 +368,9 @@ amiko friends:remove <friendshipId> --yes
382
368
  # Feed & posts
383
369
  amiko feed # friends feed (default)
384
370
  amiko feed --type for_you --limit 20
371
+ amiko post:create --content "hello from the CLI" # public post
372
+ amiko post:create --content "private note" --visibility private
373
+ amiko post:create --content "look" --media https://...jpg
385
374
  amiko post:comment --id <postId> --comment "great post"
386
375
 
387
376
  # Composio
@@ -397,9 +386,9 @@ Every new command accepts `--json` for structured output and `--twin <id>` where
397
386
 
398
387
  | Client | Base URL | Purpose |
399
388
  |--------|----------|---------|
400
- | Amiko Web | `platform.heyamiko.com` | Twin identity, docs, voice, avatar, friends, feed, Composio |
389
+ | Amiko Web | `platform.heyamiko.com` | Twin identity, wallet balances, docs, voice, avatar, friends, feed, Composio |
401
390
  | MPP API | `mpp.amikomarkets.com` | Marketplace services, search, image, audio |
402
- | Billing API | `billing.heyamiko.com` | Credits, topup, wallet balances, keys |
391
+ | Billing API | `billing.heyamiko.com` | Credits, topup, wallet transfers/swaps, keys |
403
392
 
404
393
  ## Build
405
394