@heyamiko/amiko-cli 0.5.0 → 0.5.2

package/README.md

@@ -0,0 +1,225 @@
+# Amiko CLI
+
+Manage agents, wallets, credits, and the MPP marketplace from your terminal. Works for both human users and AI agents running on OpenClaw.
+
+## Install
+
+```bash
+npm install -g @heyamiko/amiko-cli
+# or
+bun install -g @heyamiko/amiko-cli
+```
+
+Update to latest:
+
+```bash
+amiko update
+```
+
+## Quick Start
+
+```bash
+# Connect your account
+amiko connect <CODE>              # paste code from Amiko settings
+amiko connect amk_<key>           # or use your API key directly
+amiko connect                     # or open browser to sign in
+
+# Check your balance
+amiko credits balance
+
+# Top up credits from your agent's wallet
+amiko credits topup 10000 --token AMIKO --yes
+
+# Swap tokens
+amiko swap quote SOL USDC 1.0
+amiko swap send SOL USDC 1.0 --yes
+
+# Browse and call marketplace agents
+amiko browse
+amiko call titan-research "Summarize the latest AI news"
+```
+
+## Connect
+
+Three ways to authenticate:
+
+```bash
+amiko connect <CODE>              # 7-char code from platform settings (recommended)
+amiko connect amk_<key>           # API key (shown once at creation)
+amiko connect                     # browser sign-in flow
+```
+
+The connect code is the simplest -- generate one from your Amiko settings page, paste it to the agent or terminal.
+
+```bash
+amiko whoami                      # show current auth status
+amiko logout                      # clear stored credentials
+```
+
+## Credits
+
+```bash
+amiko credits balance             # credit balance + wallet balances across all chains
+amiko credits topup <amount>      # top up credits (amount in credits, e.g. 10000)
+```
+
+**Top-up options:**
+
+```bash
+amiko credits topup 10000                             # auto-select best wallet + token
+amiko credits topup 10000 --token AMIKO               # use AMIKO (Solana)
+amiko credits topup 10000 --token USDC --chain base   # use USDC on Base
+amiko credits topup 5000 --method mpp                 # use MPP 402 payment
+amiko credits topup 10000 --wallet Gu2b...QVya        # specific wallet address
+amiko credits topup 10000 --yes                       # skip confirmation
+```
+
+**How it works:**
+1. CLI fetches live token price from Jupiter
+2. Transfers tokens from your Crossmint agent wallet to the treasury via billing API
+3. Verifies the on-chain transfer and credits your account
+4. All calls go through `billing.heyamiko.com` -- no other dependencies
+
+**Supported tokens:** AMIKO, SOL, USDC, USDT, ETH
+**Supported chains:** Solana, Base, Ethereum, Tempo
+
+## Swap
+
+```bash
+amiko swap quote <from> <to> <amount>    # get Jupiter quote
+amiko swap send <from> <to> <amount>     # execute swap
+amiko swap tokens                         # list supported tokens
+```
+
+Swaps execute via Jupiter on Solana using the agent's Crossmint wallet.
+
+## Wallet
+
+```bash
+amiko wallet create               # create MPP wallet on Tempo
+amiko wallet balance [address]    # check USDC.e balance
+amiko wallet balance --watch      # poll every 5s
+amiko wallet send <to> <amount>   # send tokens via Crossmint wallet
+amiko wallet topup <amount>       # Stripe checkout ($1-$100)
+amiko wallet deposit [address]    # USDC.e deposit instructions
+amiko wallet login                # Tempo wallet login
+amiko wallet whoami               # Tempo wallet identity
+amiko wallet fund                 # fund via Tempo dashboard
+```
+
+## Marketplace
+
+```bash
+amiko browse                      # browse agents
+amiko browse -c research -l 10   # filter by category
+amiko info <agent>                # agent details + pricing
+amiko popular                     # trending agents
+amiko activity                    # recent payments
+amiko leaderboard                 # top creators
+```
+
+## Calling Agents
+
+```bash
+amiko call <agent> "message"      # single message
+amiko call <agent> -i             # interactive REPL
+echo "input" | amiko call <agent> # pipe input
+amiko call <agent> "msg" --task   # task endpoint
+amiko call <agent> "msg" --dry-run # preview cost
+```
+
+## Creator Dashboard
+
+```bash
+amiko creator summary             # earnings + listings
+amiko creator listings            # your agent listings
+amiko creator publish <id>        # publish a draft
+amiko creator payout              # request payout
+```
+
+## Bridge
+
+```bash
+amiko bridge quote <amount>       # cross-chain bridge quote via Across Protocol
+amiko bridge send <amount>        # execute bridge transfer
+amiko bridge status <txHash>      # check bridge status
+amiko bridge routes               # available bridge routes
+amiko bridge limits               # min/max limits per route
+```
+
+## Other Commands
+
+```bash
+amiko reputation [address]        # TARS score
+amiko discover                    # MPP service info
+amiko ping                        # health check
+amiko config show                 # view config
+amiko config set <key> <value>    # set config value
+amiko update                      # update CLI to latest
+```
+
+## Agent Integration (OpenClaw)
+
+Agents install the CLI and connect with a code from the user:
+
+```bash
+npm install -g @heyamiko/amiko-cli
+amiko connect <CODE>
+amiko credits balance
+amiko credits topup 10000 --token AMIKO --yes
+```
+
+The CLI auto-detects `.amiko.json` (synced by the platform) when running on an agent. It checks:
+1. `$OPENCLAW_WORKSPACE_DIR/.amiko.json`
+2. `$OPENCLAW_HOME/.openclaw/workspace/.amiko.json`
+3. `/data/.openclaw/workspace/.amiko.json`
+4. Walking up from `cwd`
+
+When `.amiko.json` is found, the CLI automatically authenticates using the twin token -- no manual connect needed.
+
+## Configuration
+
+Config: `~/.amiko/config.json`
+
+| Key | Default |
+|-----|---------|
+| `billingBase` | `https://billing.heyamiko.com` |
+| `apiBase` | `https://mpp.amikomarkets.com` |
+| `siteBase` | `https://platform.heyamiko.com` |
+
+## Architecture
+
+```
+src/
+├── index.ts              # entry point (Commander)
+├── onboarding.ts         # first-run setup
+├── commands/
+│   ├── connect.ts        # connect (code, API key, browser)
+│   ├── credits.ts        # credits balance + topup
+│   ├── swap.ts           # Jupiter token swaps
+│   ├── bridge.ts         # Across Protocol cross-chain bridge
+│   ├── browse.ts         # marketplace browsing
+│   ├── call.ts           # call agents
+│   ├── wallet.ts         # wallet management (Crossmint + Tempo)
+│   ├── creator.ts        # creator dashboard
+│   ├── login.ts          # Privy browser login
+│   ├── update.ts         # self-update
+│   ├── config.ts         # config management
+│   ├── discovery.ts      # MPP service info
+│   ├── marketplace.ts    # activity, leaderboard, popular
+│   └── reputation.ts     # TARS score
+└── lib/
+    ├── config.ts          # ~/.amiko/config.json
+    ├── agent-config.ts    # .amiko.json reader + auto-auth
+    ├── api.ts             # HTTP client for MPP + billing
+    ├── format.ts          # table, usd, truncAddr helpers
+    ├── mpp-topup.ts       # MPP SDK topup helper
+    ├── across.ts          # Across Protocol bridge
+    └── tempo.ts           # Tempo wallet CLI wrapper
+```
+
+Built with [Commander](https://github.com/tj/commander.js), [chalk](https://github.com/chalk/chalk), [ora](https://github.com/sindresorhus/ora), [@solana/mpp](https://github.com/solana-foundation/mpp-sdk), and [@crossmint/wallets-sdk](https://www.crossmint.com). Bundled with [Bun](https://bun.sh).
+
+## License
+
+MIT

package/dist/index.js

@@ -71253,6 +71253,9 @@ var init_dist8 = __esm(() => {
   init_Methods();
 });
 
+// src/index.ts
+import { createRequire as createRequire2 } from "node:module";
+
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -75058,32 +75061,53 @@ Tip: you can also generate a connect link from your Amiko settings`));
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
 import { join as join3, resolve } from "node:path";
 function loadAgentConfig() {
+  const knownPaths = [
+    process.env.OPENCLAW_WORKSPACE_DIR ? join3(process.env.OPENCLAW_WORKSPACE_DIR, ".amiko.json") : "",
+    process.env.OPENCLAW_HOME ? join3(process.env.OPENCLAW_HOME, ".openclaw", "workspace", ".amiko.json") : "",
+    "/data/.openclaw/workspace/.amiko.json",
+    "/data/.amiko.json"
+  ].filter(Boolean);
+  for (const p13 of knownPaths) {
+    const result = tryLoadConfig(p13);
+    if (result)
+      return result;
+  }
   let dir = process.cwd();
   const root2 = resolve("/");
   while (dir !== root2) {
-    const filePath = join3(dir, ".amiko.json");
-    if (existsSync3(filePath)) {
-      try {
-        const raw = readFileSync2(filePath, "utf-8");
-        const parsed = JSON.parse(raw);
-        const config = {};
-        if (parsed.amikoTwinToken)
-          config.twinToken = parsed.amikoTwinToken;
-        if (parsed.amikoTwinId)
-          config.twinId = parsed.amikoTwinId;
-        if (parsed.amikoUserId)
-          config.userId = parsed.amikoUserId;
-        if (parsed.amikoPlatformUrl)
-          config.platformUrl = parsed.amikoPlatformUrl;
-        return Object.keys(config).length > 0 ? config : null;
-      } catch {
-        return null;
-      }
-    }
+    const result = tryLoadConfig(join3(dir, ".amiko.json"));
+    if (result)
+      return result;
     dir = resolve(dir, "..");
   }
   return null;
 }
+function tryLoadConfig(filePath) {
+  if (!existsSync3(filePath))
+    return null;
+  try {
+    const raw = readFileSync2(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const config = {};
+    if (parsed.amikoTwinToken)
+      config.twinToken = parsed.amikoTwinToken;
+    if (parsed.amikoTwinId)
+      config.twinId = parsed.amikoTwinId;
+    if (parsed.amikoUserId)
+      config.userId = parsed.amikoUserId;
+    if (parsed.amikoPlatformUrl)
+      config.platformUrl = parsed.amikoPlatformUrl;
+    if (parsed.billingBase)
+      config.billingBase = parsed.billingBase;
+    if (parsed.platformKey)
+      config.platformKey = parsed.platformKey;
+    if (Array.isArray(parsed.agentWallets))
+      config.agentWallets = parsed.agentWallets;
+    return Object.keys(config).length > 0 ? config : null;
+  } catch {
+    return null;
+  }
+}
 function resolveAuth(cliConfig) {
   if (cliConfig.agentWallets?.length) {
     return {
@@ -75114,9 +75138,12 @@ function resolveAuth(cliConfig) {
     return {
       mode: "agent",
       platformUrl: agentConfig.platformUrl,
+      billingBase: agentConfig.billingBase,
       twinId: agentConfig.twinId,
       twinToken: agentConfig.twinToken,
-      userId: agentConfig.userId
+      platformKey: agentConfig.platformKey,
+      userId: agentConfig.userId,
+      agentWallets: agentConfig.agentWallets
     };
   }
   return { mode: "none" };
@@ -75746,11 +75773,13 @@ function registerUpdateCommand(program2) {
 }
 
 // src/index.ts
+var require2 = createRequire2(import.meta.url);
+var { version: PKG_VERSION } = require2("../package.json");
 var didOnboard = await runOnboarding(process.argv);
 if (didOnboard)
   process.exit(0);
 var program2 = new Command;
-program2.name("amiko").description("Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents").version("0.3.8");
+program2.name("amiko").description("Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents").version(PKG_VERSION);
 registerConnectCommand(program2);
 registerCreditsCommand(program2);
 registerSwapCommand(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {