@vultisig/cli 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @vultisig/cli
 
+## 0.11.0
+
+### Patch Changes
+
+- Updated dependencies [[`5286b98`](https://github.com/vultisig/vultisig-sdk/commit/5286b98d19692acd216a2c95d5a7a903217bef36)]:
+  - @vultisig/sdk@0.11.0
+  - @vultisig/rujira@7.0.0
+
+## 0.10.0
+
+### Patch Changes
+
+- Updated dependencies [[`67dc6ce`](https://github.com/vultisig/vultisig-sdk/commit/67dc6ceaa1b318144cfbe3812ddecb14b108eba4)]:
+  - @vultisig/sdk@0.10.0
+  - @vultisig/rujira@6.0.0
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # Vultisig CLI
 
-Command-line wallet for Vultisig - secure multi-party computation (MPC) wallet management across 40+ blockchains.
+Command-line wallet for Vultisig - secure multi-party computation (MPC) wallet management across 40+ blockchains. Designed for both human and AI agent use.
 
 > **Tip:** Use `vsig` as a shorthand alias for `vultisig` - all commands work with both!
 
@@ -584,6 +584,151 @@ vultisig sign --chain sui --bytes "<base64-tx-bytes>" -o json > sig.json
 vultisig broadcast --chain sui --raw-tx '{"unsignedTx":"<base64-tx-bytes>","signature":"<base64-signature-from-sig.json>"}'
 ```
 
+### AI Agent Integration
+
+The CLI has first-class support for AI coding agents (Claude Code, Cursor, Opencode, etc.).
+
+#### Non-Interactive Vault Creation
+
+When running in a non-TTY environment (pipes, scripts, AI agents), the CLI **automatically** uses two-step mode — no interactive OTP prompt that would hang your agent:
+
+```bash
+# Agent runs this — auto-detects non-TTY, skips interactive prompt
+vultisig create fast --name "Agent Wallet" --password "$VAULT_PASSWORD" --email agent@example.com
+
+# Returns immediately with vault ID (pending verification)
+# Vault ID: 023118...
+
+# Verify later when you have the email code
+vultisig verify 023118... --code 123456
+```
+
+You can also force two-step mode explicitly:
+
+```bash
+# Force two-step even in a TTY
+vultisig create fast --name "Agent Wallet" --password "$VAULT_PASSWORD" --email agent@example.com --two-step
+
+# JSON output for machine parsing
+vultisig create fast --name "Agent Wallet" --password "$VAULT_PASSWORD" --email agent@example.com --two-step -o json
+```
+
+JSON output for two-step create:
+```json
+{
+  "vaultId": "023118...",
+  "status": "pending_verification",
+  "message": "Vault created. Verify with email OTP to activate.",
+  "verifyCommand": "vultisig verify 023118... --code <OTP>",
+  "resendCommand": "vultisig verify 023118... --resend --email agent@example.com --password ..."
+}
+```
+
+#### Agent Ask (One-Shot Mode)
+
+Send a single natural-language message and get a structured response. Designed for AI-to-AI communication:
+
+```bash
+# Simple query
+vultisig agent ask "What is my ETH balance?" --password "$VAULT_PASSWORD"
+
+# Execute a transaction
+vultisig agent ask "Send 0.01 ETH to 0x742d..." --password "$VAULT_PASSWORD"
+
+# Continue a conversation (multi-turn)
+vultisig agent ask "Now swap it to USDC" --session abc123 --password "$VAULT_PASSWORD"
+
+# JSON output (for parsing)
+vultisig agent ask "Check my portfolio" --password "$VAULT_PASSWORD" --json
+```
+
+**Text output (default):**
+```
+session:abc123-def456
+
+Your ETH balance is 1.5 ETH ($3,750.00 USD).
+
+tx:ethereum:0x9f8e7d6c...
+explorer:https://etherscan.io/tx/0x9f8e7d6c...
+```
+
+**JSON output (`--json`):**
+```json
+{
+  "session_id": "abc123-def456",
+  "response": "Your ETH balance is 1.5 ETH ($3,750.00 USD).",
+  "tool_calls": [
+    { "action": "getBalance", "success": true, "data": { "chain": "ethereum", "balance": "1.5" } }
+  ],
+  "transactions": [
+    { "hash": "0x9f8e7d6c...", "chain": "ethereum", "explorerUrl": "https://etherscan.io/tx/0x9f8e7d6c..." }
+  ]
+}
+```
+
+**Agent ask options:**
+- `--session <id>` - Continue an existing conversation
+- `--backend-url <url>` - Agent backend URL (default: https://abe.vultisig.com)
+- `--password <password>` - Vault password for signing
+- `--verbose` - Show tool calls and debug info on stderr
+- `--json` - Output structured JSON
+
+#### Agent Chat (Interactive/Pipe Mode)
+
+For interactive TUI or piped agent-to-agent communication:
+
+```bash
+# Interactive TUI with chat interface
+vultisig agent
+
+# Pipe mode for agent-to-agent (NDJSON)
+vultisig agent --via-agent --password "$VAULT_PASSWORD"
+```
+
+**Agent chat options:**
+- `--via-agent` - NDJSON pipe mode for agent-to-agent communication (24h password cache)
+- `--verbose` - Show detailed tool call parameters
+- `--backend-url <url>` - Agent backend URL
+- `--password <password>` - Vault password
+- `--password-ttl <ms>` - Password cache TTL (default: 5min, 24h for `--via-agent`)
+- `--session-id <id>` - Resume an existing session
+
+#### Session Management
+
+```bash
+# List chat sessions for current vault
+vultisig agent sessions list
+
+# Delete a session
+vultisig agent sessions delete abc123
+```
+
+#### Agent Command Summary
+
+| Command | Description |
+|---------|-------------|
+| `agent ask <message>` | One-shot: send message, get response, exit |
+| `agent` | Interactive TUI chat interface |
+| `agent --via-agent` | NDJSON pipe mode for agent-to-agent |
+| `agent sessions list` | List chat sessions |
+| `agent sessions delete <id>` | Delete a session |
+
+#### Environment Variables for Automation
+
+```bash
+# Pre-select vault (no --vault flag needed)
+VULTISIG_VAULT=MyWallet
+
+# Vault password (avoids --password flag)
+VAULT_PASSWORD=mypassword
+
+# Multiple vault passwords
+VAULT_PASSWORDS="Vault1:pass1 Vault2:pass2"
+
+# Suppress spinners and info messages
+VULTISIG_SILENT=1
+```
+
 ### Settings
 
 | Command | Description |

package/dist/index.js

@@ -6426,6 +6426,12 @@ var AgentSession = class {
           ui.onSuggestions(suggestions);
         },
         onTxReady: (tx) => {
+          const txData = tx?.swap_tx || tx?.send_tx || tx?.tx;
+          if (txData?.status === "error" || txData?.error) {
+            if (this.config.verbose) process.stderr.write(`[session] skipping error tx_ready: ${txData.error || "unknown error"}
+`);
+            return;
+          }
           this.executor.storeServerTransaction(tx);
           if (this.config.password) {
             this.executor.setPassword(this.config.password);
@@ -6950,7 +6956,7 @@ function summarizeData(data) {
 async function executeAgent(ctx2, options) {
   const vault = await ctx2.ensureActiveVault();
   const config = {
-    backendUrl: options.backendUrl || process.env.VULTISIG_AGENT_URL || "http://localhost:9998",
+    backendUrl: options.backendUrl || process.env.VULTISIG_AGENT_URL || "https://abe.vultisig.com",
     vaultName: vault.name,
     password: options.password,
     viaAgent: options.viaAgent,
@@ -6990,7 +6996,7 @@ async function executeAgentAsk(ctx2, message, options) {
   try {
     const vault = await ctx2.ensureActiveVault();
     const config = {
-      backendUrl: options.backendUrl || process.env.VULTISIG_AGENT_URL || "http://localhost:9998",
+      backendUrl: options.backendUrl || process.env.VULTISIG_AGENT_URL || "https://abe.vultisig.com",
       vaultName: vault.name,
       password: options.password,
       sessionId: options.session,
@@ -7045,7 +7051,7 @@ tx:${tx.chain}:${tx.hash}
 }
 async function executeAgentSessionsList(ctx2, options) {
   const vault = await ctx2.ensureActiveVault();
-  const backendUrl = options.backendUrl || process.env.VULTISIG_AGENT_URL || "http://localhost:9998";
+  const backendUrl = options.backendUrl || process.env.VULTISIG_AGENT_URL || "https://abe.vultisig.com";
   const client = await createAuthenticatedClient(backendUrl, vault, options.password);
   const publicKey = vault.publicKeys.ecdsa;
   const PAGE_SIZE = 100;
@@ -7092,7 +7098,7 @@ async function executeAgentSessionsList(ctx2, options) {
 }
 async function executeAgentSessionsDelete(ctx2, sessionId, options) {
   const vault = await ctx2.ensureActiveVault();
-  const backendUrl = options.backendUrl || process.env.VULTISIG_AGENT_URL || "http://localhost:9998";
+  const backendUrl = options.backendUrl || process.env.VULTISIG_AGENT_URL || "https://abe.vultisig.com";
   const client = await createAuthenticatedClient(backendUrl, vault, options.password);
   const publicKey = vault.publicKeys.ecdsa;
   await client.deleteConversation(sessionId, publicKey);
@@ -8522,7 +8528,7 @@ var cachedVersion = null;
 function getVersion() {
   if (cachedVersion) return cachedVersion;
   if (true) {
-    cachedVersion = "0.9.0";
+    cachedVersion = "0.11.0";
     return cachedVersion;
   }
   try {
@@ -9525,7 +9531,7 @@ rujiraCmd.command("withdraw <asset> <amount> <l1Address>").description("Withdraw
     }
   )
 );
-var agentCmd = program.command("agent").description("AI-powered chat interface for wallet operations").option("--via-agent", "Use NDJSON pipe mode for agent-to-agent communication").option("--verbose", "Show detailed tool call parameters and debug output").option("--backend-url <url>", "Agent backend URL (default: http://localhost:9998)").option("--password <password>", "Vault password for signing operations").option("--password-ttl <ms>", "Password cache TTL in milliseconds (default: 300000, 86400000/24h for --via-agent)").option("--session-id <id>", "Resume an existing session").action(async (options) => {
+var agentCmd = program.command("agent").description("AI-powered chat interface for wallet operations").option("--via-agent", "Use NDJSON pipe mode for agent-to-agent communication").option("--verbose", "Show detailed tool call parameters and debug output").option("--backend-url <url>", "Agent backend URL (default: https://abe.vultisig.com)").option("--password <password>", "Vault password for signing operations").option("--password-ttl <ms>", "Password cache TTL in milliseconds (default: 300000, 86400000/24h for --via-agent)").option("--session-id <id>", "Resume an existing session").action(async (options) => {
   const MAX_TTL = 864e5;
   let passwordTTL;
   if (options.passwordTtl) {
@@ -9546,7 +9552,7 @@ var agentCmd = program.command("agent").description("AI-powered chat interface f
     sessionId: options.sessionId
   });
 });
-agentCmd.command("ask <message>").description("Send a single message and get the response (for AI agent integration)").option("--session <id>", "Continue an existing conversation").option("--backend-url <url>", "Agent backend URL (default: http://localhost:9998)").option("--password <password>", "Vault password for signing operations").option("--verbose", "Show tool calls and debug info on stderr").option("--json", "Output structured JSON instead of text").action(
+agentCmd.command("ask <message>").description("Send a single message and get the response (for AI agent integration)").option("--session <id>", "Continue an existing conversation").option("--backend-url <url>", "Agent backend URL (default: https://abe.vultisig.com)").option("--password <password>", "Vault password for signing operations").option("--verbose", "Show tool calls and debug info on stderr").option("--json", "Output structured JSON instead of text").action(
   async (message, options) => {
     const parentOpts = agentCmd.opts();
     const context = await init(
@@ -9562,7 +9568,7 @@ agentCmd.command("ask <message>").description("Send a single message and get the
   }
 );
 var sessionsCmd = agentCmd.command("sessions").description("Manage agent chat sessions");
-sessionsCmd.command("list").description("List chat sessions for the current vault").option("--backend-url <url>", "Agent backend URL (default: http://localhost:9998)").option("--password <password>", "Vault password for authentication").action(
+sessionsCmd.command("list").description("List chat sessions for the current vault").option("--backend-url <url>", "Agent backend URL (default: https://abe.vultisig.com)").option("--password <password>", "Vault password for authentication").action(
   withExit(async (options) => {
     const parentOpts = agentCmd.opts();
     const context = await init(program.opts().vault, options.password || parentOpts.password);
@@ -9572,7 +9578,7 @@ sessionsCmd.command("list").description("List chat sessions for the current vaul
     });
   })
 );
-sessionsCmd.command("delete <id>").description("Delete a chat session").option("--backend-url <url>", "Agent backend URL (default: http://localhost:9998)").option("--password <password>", "Vault password for authentication").action(
+sessionsCmd.command("delete <id>").description("Delete a chat session").option("--backend-url <url>", "Agent backend URL (default: https://abe.vultisig.com)").option("--password <password>", "Vault password for authentication").action(
   withExit(async (id, options) => {
     const parentOpts = agentCmd.opts();
     const context = await init(program.opts().vault, options.password || parentOpts.password);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/cli",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Command-line wallet for Vultisig - multi-chain MPC wallet management",
   "type": "module",
   "bin": {
@@ -53,8 +53,8 @@
     "@cosmjs/proto-signing": "^0.38.1",
     "@cosmjs/stargate": "^0.38.1",
     "@noble/hashes": "^2.0.1",
-    "@vultisig/rujira": "^5.0.0",
-    "@vultisig/sdk": "^0.9.0",
+    "@vultisig/rujira": "^7.0.0",
+    "@vultisig/sdk": "^0.11.0",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",