minara 0.4.2 → 0.4.4

package/README.md

@@ -48,14 +48,14 @@ minara login
 # Check your account
 minara account
 
-# View deposit addresses
-minara deposit
+# Receive / deposit
+minara receive
 
-# Chat with Minara AI (interactive REPL)
-minara chat
+# Quick AI question
+minara ask "What's the best DeFi yield right now?"
 
-# Or send a single question
-minara chat "What's the best DeFi yield right now?"
+# Deep AI research
+minara research "Analyze ETH outlook for next quarter"
 
 # Swap tokens (chain auto-detected from token)
 minara swap -t '$BONK' -s buy -a 100
@@ -88,7 +88,8 @@ minara login -e user@mail.com # Email verification code
 | `minara assets`       | Full overview: spot holdings + perps account                   |
 | `minara assets spot`  | Spot wallet: portfolio value, cost, PnL, holdings              |
 | `minara assets perps` | Perps account: equity, margin, positions                       |
-| `minara deposit`      | Deposit to spot, perps, or buy crypto with credit card         |
+| `minara receive`      | Deposit / receive to spot, perps, or buy with credit card      |
+| `minara deposit`      | Same as `receive`                                              |
 | `minara deposit buy`  | Buy crypto with credit card via MoonPay                        |
 | `minara withdraw`     | Withdraw tokens to an external wallet                          |
 
@@ -97,9 +98,9 @@ minara balance                    # Quick total: Spot + Perps available balance
 minara assets                     # Full overview (spot + perps)
 minara assets spot                # Spot wallet with PnL breakdown
 minara assets perps               # Perps equity, margin, positions
-minara deposit                    # Interactive: Spot / Perps / Buy with credit card
-minara deposit spot               # Show spot wallet deposit addresses (EVM + Solana)
-minara deposit perps              # Perps: show Arbitrum deposit address, or transfer from Spot → Perps
+minara receive                    # Interactive: Spot / Perps / Buy with credit card
+minara receive spot               # Show spot wallet deposit addresses (EVM + Solana)
+minara receive perps              # Perps: show Arbitrum deposit address, or transfer from Spot → Perps
 minara deposit buy                # Buy crypto with credit card via MoonPay (opens browser)
 minara withdraw -c solana -t '$SOL' -a 10 --to <address>
 minara withdraw                   # Interactive mode (accepts ticker or address)
@@ -107,18 +108,28 @@ minara withdraw                   # Interactive mode (accepts ticker or address)
 
 ### Spot Trading
 
-| Command           | Description                        |
-| ----------------- | ---------------------------------- |
-| `minara swap`     | Swap tokens (chain auto-detected)  |
-| `minara transfer` | Transfer tokens to another address |
+| Command           | Description                                          |
+| ----------------- | ---------------------------------------------------- |
+| `minara swap`     | Swap tokens (chain auto-detected)                    |
+| `minara send`     | Send / transfer tokens to another address             |
+| `minara transfer` | Same as `send`                                       |
 
 ```bash
 minara swap                        # Interactive: side → token → amount
 minara swap -s buy -t '$BONK' -a 100              # Buy by ticker (chain auto-detected)
 minara swap -s sell -t '$NVDAx' -a all             # Sell entire balance
 minara swap --dry-run              # Simulate without executing
+
+# Send tokens
+minara send -c solana -t '$SOL' -a 5 --to <address>       # Send SOL on Solana
+minara send -c base -t '$USDC' -a 200 --to <address>      # Send USDC on Base
+minara send -c ethereum -t '$ETH' -a 0.1 --to <addr>      # Send ETH on Ethereum
+minara send                        # Interactive mode
+minara transfer -c solana -t '$SOL' -a 5 --to <address>   # Same as send
 ```
 
+> **`send` vs `withdraw`:** `send` is an alias for `transfer` — both transfer tokens to another address. `withdraw` is a separate command that moves tokens from your Minara wallet to an external address (shows your current assets before prompting).
+>
 > **Chain abstraction:** The chain is automatically detected from the token. If a token exists on multiple chains (e.g. USDC), you'll be prompted to pick one, sorted by gas cost (lowest first). Sell mode supports `all` to sell full balance, and caps amounts exceeding your balance.
 >
 > **Token input:** All token fields (`-t`) accept a `$TICKER` (e.g. `$BONK`), a token name, or a contract address.
@@ -193,24 +204,37 @@ minara limit-order cancel abc123   # Cancel order by ID
 
 ### AI Chat
 
-| Command                          | Description                                   |
-| -------------------------------- | --------------------------------------------- |
-| `minara chat`                    | Enter interactive REPL (Python/Node.js-style) |
-| `minara chat [message]`          | Send a single message and exit                |
-| `minara chat --list`             | List all your conversations                   |
-| `minara chat --history <chatId>` | View messages in a conversation               |
-| `minara chat -c <chatId>`        | Continue an existing conversation             |
+| Command                          | Description                                       |
+| -------------------------------- | ------------------------------------------------- |
+| `minara ask [message]`           | Quick AI chat (fast mode)                         |
+| `minara research [message]`      | Deep AI research (quality mode)                   |
+| `minara chat`                    | Enter interactive REPL (Python/Node.js-style)     |
+| `minara chat [message]`          | Send a single message and exit                    |
+| `minara chat --list`             | List all your conversations                       |
+| `minara chat --history <chatId>` | View messages in a conversation                   |
+| `minara chat -c <chatId>`        | Continue an existing conversation                 |
 
 ```bash
+# Quick questions (fast mode)
+minara ask "What is the current BTC price?"
+minara ask "Is SOL a good buy right now?"
+
+# Deep research (quality mode)
+minara research "Analyze ETH outlook for next quarter"
+minara research "Compare Layer 2 rollup ecosystems"
+
+# Full chat with all options
 minara chat                                    # Enter interactive REPL mode
 minara chat "What is the current BTC price?"   # Single question, streamed answer
-minara chat --quality "Analyze ETH outlook"     # Quality mode (default: fast)
+minara chat --quality "Analyze ETH outlook"     # Quality mode (same as research)
 minara chat --thinking "Analyze ETH outlook"   # Enable reasoning mode
 minara chat -c <chatId>                        # Continue a specific chat in REPL
 minara chat --list                             # List past conversations
 minara chat --history <chatId>                 # Replay a specific conversation
 ```
 
+> **`ask` vs `research` vs `chat`:** `ask` is a shortcut for `chat` in fast mode — quick questions, real-time prices, brief answers. `research` is a shortcut for `chat --quality` — deeper analysis, longer responses, more thorough reasoning. `chat` gives you the full feature set including interactive REPL, conversation history, and all mode flags.
+
 **Interactive REPL mode** — When launched without a message argument, the chat enters an interactive session:
 
 ```
@@ -327,7 +351,7 @@ Minara CLI supports macOS Touch ID to protect all fund-related operations. When
 minara config                     # Select "Touch ID" to enable / disable
 ```
 
-**Protected operations:** `withdraw`, `transfer`, `swap`, `deposit` (Spot→Perps transfer), `perps deposit`, `perps withdraw`, `perps order`, `perps close`, `limit-order create`
+**Protected operations:** `withdraw`, `send` / `transfer`, `swap`, `receive` / `deposit` (Spot→Perps transfer), `perps deposit`, `perps withdraw`, `perps order`, `perps close`, `limit-order create`
 
 > **Note:** Touch ID requires macOS with Touch ID hardware. The `--yes` flag skips the initial confirmation prompt but does **not** bypass transaction confirmation or Touch ID.
 

package/dist/commands/account.js

@@ -3,10 +3,21 @@ import chalk from 'chalk';
 import { getCurrentUser } from '../api/auth.js';
 import { requireAuth } from '../config.js';
 import { spinner, unwrapApi, wrapAction } from '../utils.js';
+// Wallets to show by default (user-facing addresses)
+const DEFAULT_WALLETS = new Set([
+    'abstraction-evm',
+    'abstraction-solana',
+    'perpetual-evm',
+]);
+// Descriptions for specific wallet types
+const WALLET_DESCRIPTIONS = {
+    'perpetual-evm': 'Only supports USDC deposits on Arbitrum',
+};
 export const accountCommand = new Command('account')
     .alias('me')
     .description('View your Minara account info')
-    .action(wrapAction(async () => {
+    .option('--show-all', 'Show all wallets including internal addresses')
+    .action(wrapAction(async (opts) => {
     const creds = requireAuth();
     const spin = spinner('Fetching account info…');
     const res = await getCurrentUser(creds.accessToken);
@@ -26,8 +37,18 @@ export const accountCommand = new Command('account')
         console.log(`  Invite Code : ${u.invitationCode}`);
     if (u.wallets && Object.keys(u.wallets).length > 0) {
         console.log(`  Wallets:`);
+        const showAll = opts.showAll === true;
         for (const [type, addr] of Object.entries(u.wallets)) {
-            console.log(`    ${chalk.dim(type)} : ${addr}`);
+            // Filter wallets: only show default wallets unless --show-all is used
+            if (showAll || DEFAULT_WALLETS.has(type)) {
+                const description = WALLET_DESCRIPTIONS[type];
+                if (description) {
+                    console.log(`    ${chalk.dim(type)} : ${addr} ${chalk.dim(`(${description})`)}`);
+                }
+                else {
+                    console.log(`    ${chalk.dim(type)} : ${addr}`);
+                }
+            }
         }
     }
     if (u.accounts && Object.keys(u.accounts).length > 0) {

package/dist/commands/chat.d.ts

@@ -1,2 +1,4 @@
 import { Command } from 'commander';
 export declare const chatCommand: Command;
+export declare const askCommand: Command;
+export declare const researchCommand: Command;

package/dist/commands/chat.js

@@ -75,15 +75,7 @@ async function* parseSSE(response) {
         reader.releaseLock();
     }
 }
-export const chatCommand = new Command('chat')
-    .description('Chat with Minara AI assistant (interactive REPL when no message given)')
-    .argument('[message]', 'Send a single message and exit')
-    .option('-c, --chat-id <id>', 'Continue existing chat')
-    .option('--list', 'List past chats')
-    .option('--history <chatId>', 'Show chat history')
-    .option('--thinking', 'Enable thinking/degen mode')
-    .option('--quality', 'Use quality mode instead of the default fast mode')
-    .action(wrapAction(async (messageArg, opts) => {
+async function chatAction(messageArg, opts) {
     const creds = requireAuth();
     // ── List chats ───────────────────────────────────────────────────────
     if (opts?.list) {
@@ -268,4 +260,29 @@ export const chatCommand = new Command('chat')
         }
         await sendAndPrintWithPause(userMsg);
     }
+}
+export const chatCommand = new Command('chat')
+    .description('Chat with Minara AI assistant (interactive REPL when no message given)')
+    .argument('[message]', 'Send a single message and exit')
+    .option('-c, --chat-id <id>', 'Continue existing chat')
+    .option('--list', 'List past chats')
+    .option('--history <chatId>', 'Show chat history')
+    .option('--thinking', 'Enable thinking/degen mode')
+    .option('--quality', 'Use quality mode instead of the default fast mode')
+    .action(wrapAction(chatAction));
+export const askCommand = new Command('ask')
+    .description('Quick AI chat (fast mode) — alias for chat')
+    .argument('[message]', 'Send a single message and exit')
+    .option('-c, --chat-id <id>', 'Continue existing chat')
+    .option('--thinking', 'Enable thinking/degen mode')
+    .action(wrapAction(async (messageArg, opts) => {
+    await chatAction(messageArg, { ...opts, quality: false });
+}));
+export const researchCommand = new Command('research')
+    .description('Deep AI research (quality mode) — alias for chat --quality')
+    .argument('[message]', 'Send a single message and exit')
+    .option('-c, --chat-id <id>', 'Continue existing chat')
+    .option('--thinking', 'Enable thinking/degen mode')
+    .action(wrapAction(async (messageArg, opts) => {
+    await chatAction(messageArg, { ...opts, quality: true });
 }));

package/dist/commands/deposit.js

@@ -184,7 +184,8 @@ const buyCmd = new Command('buy')
     await moonPayOnRamp(creds.accessToken);
 }));
 export const depositCommand = new Command('deposit')
-    .description('Deposit to spot wallet or perps account, or buy with credit card')
+    .alias('receive')
+    .description('Deposit / receive to spot wallet or perps account, or buy with credit card')
     .addCommand(spotCmd)
     .addCommand(perpsCmd)
     .addCommand(buyCmd)

package/dist/commands/transfer.js

@@ -6,7 +6,8 @@ import { success, spinner, assertApiOk, selectChain, wrapAction, requireTransact
 import { requireTouchId } from '../touchid.js';
 import { printTxResult } from '../formatters.js';
 export const transferCommand = new Command('transfer')
-    .description('Transfer tokens to another address')
+    .alias('send')
+    .description('Transfer / send tokens to another address')
     .option('-c, --chain <chain>', 'Blockchain')
     .option('-t, --token <address|ticker>', 'Token contract address or ticker symbol')
     .option('-a, --amount <amount>', 'Token amount to send')

package/dist/index.js

@@ -19,7 +19,7 @@ import { transferCommand } from './commands/transfer.js';
 import { perpsCommand } from './commands/perps.js';
 import { limitOrderCommand } from './commands/limit-order.js';
 // AI, Market, Premium, Config
-import { chatCommand } from './commands/chat.js';
+import { chatCommand, askCommand, researchCommand } from './commands/chat.js';
 import { discoverCommand } from './commands/discover.js';
 import { premiumCommand } from './commands/premium.js';
 import { configCommand } from './commands/config.js';
@@ -58,6 +58,8 @@ program.addCommand(perpsCommand);
 program.addCommand(limitOrderCommand);
 // ── AI Chat ──────────────────────────────────────────────────────────────
 program.addCommand(chatCommand);
+program.addCommand(askCommand);
+program.addCommand(researchCommand);
 // ── Market ───────────────────────────────────────────────────────────────
 program.addCommand(discoverCommand);
 // ── Premium ─────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minara",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "CLI client for Minara.ai — login, trade, deposit/withdraw, chat and more from your terminal.",
   "type": "module",
   "main": "dist/index.js",