httpcat-cli 0.2.13 → 0.3.0

package/dist/index.js

@@ -1,8 +1,28 @@
 #!/usr/bin/env node
+// Handle SIGINT (Ctrl+C) gracefully
+let isExiting = false;
+process.on("SIGINT", () => {
+    if (isExiting) {
+        // Force exit if already exiting
+        process.exit(130);
+    }
+    isExiting = true;
+    console.log("\n\nInterrupted by user. Exiting...");
+    process.exit(130);
+});
+process.on("SIGTERM", () => {
+    if (isExiting) {
+        process.exit(143);
+    }
+    isExiting = true;
+    console.log("\n\nTerminated. Exiting...");
+    process.exit(143);
+});
 import { Command } from "commander";
 import chalk from "chalk";
 import { privateKeyToAccount } from "viem/accounts";
 import { createRequire } from "module";
+import { randomUUID } from "crypto";
 import { config } from "./config.js";
 import { formatAddress, formatCurrency } from "./utils/formatting.js";
 import { HttpcatClient, HttpcatError } from "./client.js";
@@ -12,7 +32,8 @@ import { runCatSpinAnimation } from "./interactive/cat-spin.js";
 import { outputJson, outputError } from "./headless/json-output.js";
 import { promptForPrivateKey } from "./utils/privateKeyPrompt.js";
 import { withLoading } from "./utils/loading.js";
-import { readFileSync, writeFileSync, existsSync, statSync, unlinkSync, readlinkSync } from "fs";
+import { writeStatusLine, clearStatusLine, formatRetryMessage, } from "./utils/status.js";
+import { readFileSync, writeFileSync, existsSync, statSync, unlinkSync, readlinkSync, } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 import { tmpdir } from "os";
@@ -24,7 +45,7 @@ const VERSION = packageJson.version;
 const require = createRequire(import.meta.url);
 const { version: PACKAGE_VERSION } = require("../package.json");
 // Import commands
-import { createToken, displayCreateResult, processPhotoUrl, isFilePath } from "./commands/create.js";
+import { createToken, displayCreateResult, processPhotoUrl, isFilePath, } from "./commands/create.js";
 import { buyToken, displayBuyResult, displayBuyResultCompact, } from "./commands/buy.js";
 import { sellToken, displaySellResult, parseTokenAmount, } from "./commands/sell.js";
 import { getTokenInfo, displayTokenInfo } from "./commands/info.js";
@@ -84,6 +105,11 @@ function isConfigured(cliPrivateKey) {
         return true;
     return config.isConfigured();
 }
+// Helper function to get global options properly
+// IMPORTANT: Always use this instead of command.parent?.opts() to ensure global flags work
+function getGlobalOpts() {
+    return program.opts();
+}
 // Helper to ensure wallet is unlocked
 async function ensureWalletUnlocked() {
     const password = config.getPassword();
@@ -287,7 +313,20 @@ Examples:
   `)
     .action(async (name, symbol, options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        // Fallback: get arguments from command object if not provided as parameters
+        // This handles cases where Commander.js doesn't parse arguments correctly
+        // In Commander.js v9+, use processedArgs; fallback to args for older versions
+        const args = command.processedArgs || command.args || [];
+        const actualName = name || args[0];
+        const actualSymbol = symbol || args[1];
+        // Validate required arguments
+        if (!actualName || typeof actualName !== "string") {
+            throw new Error("Token name is required. Usage: httpcat create <name> <symbol> [options]");
+        }
+        if (!actualSymbol || typeof actualSymbol !== "string") {
+            throw new Error("Token symbol is required. Usage: httpcat create <name> <symbol> [options]");
+        }
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -302,10 +341,16 @@ Examples:
             privateKey = await promptForPrivateKey();
         }
         const client = await HttpcatClient.create(privateKey);
+        // Generate default robohash URL if no photo provided
+        let photoToUse = options.photo;
+        if (!photoToUse) {
+            const uuid = randomUUID();
+            photoToUse = `https://robohash.org/${uuid}?set=set4`;
+        }
         // Process photo if it's a file path (show loading state)
-        let processedPhotoUrl = options.photo;
-        if (options.photo && isFilePath(options.photo)) {
-            processedPhotoUrl = await withLoading(async () => processPhotoUrl(options.photo), {
+        let processedPhotoUrl = photoToUse;
+        if (photoToUse && isFilePath(photoToUse)) {
+            processedPhotoUrl = await withLoading(async () => processPhotoUrl(photoToUse), {
                 message: "Uploading image...",
                 json: globalOpts.json,
                 quiet: globalOpts.quiet,
@@ -314,8 +359,8 @@ Examples:
         }
         // Create token (show loading state)
         const result = await withLoading(() => createToken(client, {
-            name,
-            symbol,
+            name: actualName.trim(),
+            symbol: actualSymbol.trim(),
             photoUrl: processedPhotoUrl,
             websiteUrl: options.website,
         }), {
@@ -333,7 +378,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("create_token", error, getExitCode(error));
         }
@@ -365,7 +410,7 @@ Examples:
   `)
     .action(async (tokenId, amount, options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         const repeatCount = options.repeat;
         const delayMs = options.delay || 0;
@@ -382,7 +427,8 @@ Examples:
             privateKey = await promptForPrivateKey();
         }
         const client = await HttpcatClient.create(privateKey);
-        const isTestMode = client.getNetwork().includes("sepolia");
+        const network = client.getNetwork();
+        const isTestMode = network === "eip155:84532" || network === "eip155:11155111" || network.includes("sepolia");
         const silent = globalOpts.json || globalOpts.quiet;
         // Handle percentage amounts for graduated tokens
         let finalAmount = amount;
@@ -413,18 +459,82 @@ Examples:
             let stopReason = "";
             for (let i = 1; i <= repeatCount; i++) {
                 try {
-                    // Show progress for non-JSON mode
-                    if (!globalOpts.json && !globalOpts.quiet) {
-                        console.log(chalk.dim(`Buy ${i}/${repeatCount}...`));
+                    // Retry logic: try up to 10 times with exponential backoff on 402 errors
+                    // Client is recreated on each attempt to ensure fresh signature for new nonce
+                    let result = null;
+                    let lastError = null;
+                    const maxRetries = 10;
+                    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+                        try {
+                            // Show progress for non-JSON mode
+                            if (!globalOpts.json && !globalOpts.quiet) {
+                                if (attempt === 1) {
+                                    console.log(chalk.dim(`Buy ${i}/${repeatCount}...`));
+                                }
+                                else {
+                                    console.log(chalk.yellow(`  Retrying buy ${i}/${repeatCount} (attempt ${attempt}/${maxRetries})...`));
+                                }
+                            }
+                            // Recreate client inside the operation function to ensure fresh signature
+                            // for each attempt (including retries). This fixes the issue where x402-fetch
+                            // generates a new nonce but reuses the same signature, causing subsequent buys to fail
+                            result = await withLoading(async () => {
+                                // Recreate client for each attempt to ensure fresh signature for new nonce
+                                const client = await HttpcatClient.create(privateKey);
+                                return buyToken(client, tokenId, finalAmount, isTestMode, silent || i > 1, privateKey);
+                            }, {
+                                message: `Buying tokens (${i}/${repeatCount})...`,
+                                json: globalOpts.json,
+                                quiet: globalOpts.quiet || i > 1,
+                                spinner: "cat",
+                            });
+                            // Success! Break out of retry loop
+                            break;
+                        }
+                        catch (error) {
+                            lastError = error;
+                            // Only retry on 402 errors (payment required)
+                            const is402Error = error instanceof HttpcatError && error.status === 402;
+                            if (is402Error && attempt < maxRetries) {
+                                // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s (capped at 10s)
+                                const backoffMs = Math.min(Math.pow(2, attempt - 1) * 1000, 10000);
+                                const backoffSeconds = backoffMs / 1000;
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    // Write status on same line (overwrites previous)
+                                    const statusMessage = formatRetryMessage(attempt, maxRetries, backoffSeconds);
+                                    writeStatusLine(statusMessage);
+                                }
+                                await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                                continue; // Retry
+                            }
+                            else {
+                                // Not a 402 error, or max retries reached - clear status and throw
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    clearStatusLine();
+                                }
+                                throw error;
+                            }
+                        }
+                    }
+                    // If we exhausted retries, throw the last error
+                    if (!result) {
+                        // Clear status line before throwing
+                        if (!globalOpts.json && !globalOpts.quiet) {
+                            clearStatusLine();
+                        }
+                        if (lastError) {
+                            throw lastError;
+                        }
+                        else {
+                            throw new Error(`Failed to complete buy ${i}/${repeatCount} after ${maxRetries} attempts`);
+                        }
                     }
-                    const result = await withLoading(() => buyToken(client, tokenId, finalAmount, isTestMode, silent || i > 1, privateKey), {
-                        message: `Buying tokens (${i}/${repeatCount})...`,
-                        json: globalOpts.json,
-                        quiet: globalOpts.quiet || i > 1,
-                        spinner: "cat",
-                    });
                     results.push(result);
                     totalSpent += parseFloat(result.amountSpent);
+                    // Clear status line before showing result
+                    if (!globalOpts.json && !globalOpts.quiet) {
+                        clearStatusLine();
+                    }
                     // Display compact result for each buy
                     if (globalOpts.json) {
                         // In JSON mode, output each result
@@ -443,58 +553,79 @@ Examples:
                         }
                         break;
                     }
-                    // Apply delay between iterations (except after the last one)
-                    if (i < repeatCount && delayMs > 0) {
-                        await new Promise((resolve) => setTimeout(resolve, delayMs));
-                    }
-                }
-                catch (error) {
-                    // Handle insufficient funds (402) gracefully
-                    if (error instanceof HttpcatError && error.status === 402) {
-                        stoppedEarly = true;
-                        stopReason = "Insufficient funds";
-                        if (!globalOpts.json && !globalOpts.quiet) {
-                            console.log();
-                            console.log(chalk.yellow("💡 Insufficient funds. Stopping buy loop."));
-                            console.log();
-                            // Show current balance to help diagnose the issue
+                    // Wait for transaction confirmations if present
+                    // This ensures both the buy transaction and payment transaction are confirmed
+                    // before the next buy, preventing nonce/signature conflicts
+                    if (i < repeatCount) {
+                        const { createPublicClient, http } = await import("viem");
+                        const { baseSepolia } = await import("viem/chains");
+                        const publicClient = createPublicClient({
+                            chain: baseSepolia,
+                            transport: http(config.getRpcUrl()),
+                        });
+                        // Wait for payment transaction first (if present)
+                        // This is critical to ensure the payment nonce is consumed before next request
+                        if (result.paymentTxHash) {
+                            if (!globalOpts.json && !globalOpts.quiet) {
+                                console.log(chalk.dim(`  Waiting for payment transaction confirmation...`));
+                            }
                             try {
-                                const balance = await checkBalance(privateKey, true);
-                                console.log(chalk.cyan("💰 Current Wallet Balances:"));
-                                console.log(chalk.dim(`   ETH:  ${balance.ethFormatted}`));
-                                console.log(chalk.dim(`   USDC: ${balance.usdcFormatted}`));
-                                if (balance.cat402Formatted) {
-                                    console.log(chalk.dim(`   CAT:  ${balance.cat402Formatted}`));
-                                }
-                                console.log();
-                                // Provide guidance based on what might be insufficient
-                                const usdcBalance = parseFloat(balance.usdcFormatted.replace("$", "").replace(",", ""));
-                                const ethBalance = parseFloat(balance.ethFormatted.replace(" ETH", "").replace(",", ""));
-                                const buyAmount = parseFloat(finalAmount);
-                                console.log(chalk.yellow("💡 Possible issues:"));
-                                if (usdcBalance < buyAmount) {
-                                    console.log(chalk.dim(`   • Insufficient USDC for purchase: Need $${buyAmount.toFixed(6)}, have $${usdcBalance.toFixed(6)}`));
+                                await publicClient.waitForTransactionReceipt({
+                                    hash: result.paymentTxHash,
+                                });
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    console.log(chalk.dim(`  ✅ Payment transaction confirmed`));
                                 }
-                                if (usdcBalance < 0.01) {
-                                    console.log(chalk.dim(`   • Low USDC for API payments: x402 protocol requires USDC for API calls`));
+                            }
+                            catch (txError) {
+                                // If we can't wait for confirmation, log but continue
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    console.log(chalk.yellow(`  ⚠️  Could not confirm payment transaction, proceeding...`));
                                 }
-                                if (ethBalance < 0.001) {
-                                    console.log(chalk.dim(`   • Low ETH for gas: Need ETH to pay for transaction fees`));
+                            }
+                        }
+                        // Wait for buy transaction (if present)
+                        if (result.txHash) {
+                            if (!globalOpts.json && !globalOpts.quiet) {
+                                console.log(chalk.dim(`  Waiting for buy transaction confirmation...`));
+                            }
+                            try {
+                                await publicClient.waitForTransactionReceipt({
+                                    hash: result.txHash,
+                                });
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    console.log(chalk.dim(`  ✅ Buy transaction confirmed`));
                                 }
-                                console.log();
-                                console.log(chalk.dim("   Check your balance with: httpcat balances"));
                             }
-                            catch (balanceError) {
-                                // If we can't fetch balance, just show generic message
-                                console.log(chalk.dim("   Check your balance with: httpcat balances"));
+                            catch (txError) {
+                                // If we can't wait for confirmation, log but continue
+                                if (!globalOpts.json && !globalOpts.quiet) {
+                                    console.log(chalk.yellow(`  ⚠️  Could not confirm buy transaction, proceeding...`));
+                                }
                             }
                         }
-                        break;
                     }
-                    // For other errors, re-throw to be handled by outer catch
+                    // Apply delay between iterations (except after the last one)
+                    if (i < repeatCount && delayMs > 0) {
+                        await new Promise((resolve) => setTimeout(resolve, delayMs));
+                    }
+                }
+                catch (error) {
+                    // Clear status line before throwing
+                    if (!globalOpts.json && !globalOpts.quiet) {
+                        clearStatusLine();
+                    }
+                    // Don't catch 402 errors - x402-fetch handles payment automatically
+                    // 402 is the normal payment flow on first call, not an error
+                    // Let withLoading and x402-fetch handle payment retries
+                    // Only re-throw to let outer handler deal with persistent errors
                     throw error;
                 }
             }
+            // Clear status line before showing summary
+            if (!globalOpts.json && !globalOpts.quiet) {
+                clearStatusLine();
+            }
             // Show final summary
             if (!globalOpts.json && !globalOpts.quiet && results.length > 0) {
                 const lastResult = results[results.length - 1];
@@ -517,13 +648,60 @@ Examples:
             process.exit(0);
         }
         else {
-            // Normal single buy execution
-            const result = await withLoading(() => buyToken(client, tokenId, finalAmount, isTestMode, silent, privateKey), {
-                message: "Buying tokens...",
-                json: globalOpts.json,
-                quiet: globalOpts.quiet,
-                spinner: "cat",
-            });
+            // Normal single buy execution with retry logic
+            let result = null;
+            let lastError = null;
+            let attempt = 0;
+            const maxRetries = null; // Retry indefinitely for single buys
+            while (!result) {
+                attempt++;
+                try {
+                    // Show initial attempt message only on first try
+                    if (attempt === 1 && !globalOpts.json && !globalOpts.quiet) {
+                        console.log(chalk.dim("Buying tokens..."));
+                    }
+                    // Recreate client for each attempt to ensure fresh signature
+                    const freshClient = await HttpcatClient.create(privateKey);
+                    result = await buyToken(freshClient, tokenId, finalAmount, isTestMode, silent, privateKey);
+                    // Success! Clear any status line and break
+                    if (!globalOpts.json && !globalOpts.quiet) {
+                        clearStatusLine();
+                    }
+                    break;
+                }
+                catch (error) {
+                    lastError = error;
+                    // Only retry on 402 errors (payment required)
+                    const is402Error = error instanceof HttpcatError && error.status === 402;
+                    if (is402Error) {
+                        // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s (capped at 10s)
+                        const backoffMs = Math.min(Math.pow(2, attempt - 1) * 1000, 10000);
+                        const backoffSeconds = backoffMs / 1000;
+                        if (!globalOpts.json && !globalOpts.quiet) {
+                            // Write status on same line (overwrites previous)
+                            const statusMessage = formatRetryMessage(attempt, maxRetries, backoffSeconds);
+                            writeStatusLine(statusMessage);
+                        }
+                        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                        continue; // Retry
+                    }
+                    else {
+                        // Not a 402 error - throw immediately
+                        if (!globalOpts.json && !globalOpts.quiet) {
+                            clearStatusLine();
+                        }
+                        throw error;
+                    }
+                }
+            }
+            if (!result) {
+                if (lastError) {
+                    throw lastError;
+                }
+                else {
+                    throw new Error("Failed to complete buy");
+                }
+            }
             if (globalOpts.json) {
                 outputJson("token_buy", result);
             }
@@ -534,7 +712,11 @@ Examples:
         }
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
+        // Clear status line before showing error
+        if (!globalOpts.json && !globalOpts.quiet) {
+            clearStatusLine();
+        }
         if (globalOpts.json) {
             outputError("token_buy", error, getExitCode(error));
         }
@@ -559,15 +741,13 @@ Examples:
   `)
     .action(async (tokenId, amountInput, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
-        // Use program.opts() directly since command.parent?.opts() doesn't include global options
-        const programOpts = program.opts();
-        let privateKey = getPrivateKey(programOpts.privateKey || globalOpts.privateKey, accountIndex);
+        let privateKey = getPrivateKey(globalOpts.privateKey, accountIndex);
         // If not configured and not in JSON mode, prompt interactively
-        if (!isConfigured(programOpts.privateKey || globalOpts.privateKey)) {
+        if (!isConfigured(globalOpts.privateKey)) {
             if (globalOpts.json) {
                 console.error('❌ Not configured. Run "httpcat config" first or use --private-key flag.');
                 process.exit(2);
@@ -609,7 +789,7 @@ Examples:
                     const { baseSepolia } = await import("viem/chains");
                     const publicClient = createPublicClient({
                         chain: baseSepolia,
-                        transport: http(),
+                        transport: http(config.getRpcUrl()),
                     });
                     const ERC20_ABI = parseAbi([
                         "function balanceOf(address owner) view returns (uint256)",
@@ -650,7 +830,7 @@ Examples:
                 const { baseSepolia } = await import("viem/chains");
                 const publicClient = createPublicClient({
                     chain: baseSepolia,
-                    transport: http(),
+                    transport: http(config.getRpcUrl()),
                 });
                 const ERC20_ABI = parseAbi([
                     "function balanceOf(address owner) view returns (uint256)",
@@ -687,7 +867,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("token_sell", error, getExitCode(error));
         }
@@ -713,7 +893,7 @@ Examples:
   `)
     .action(async (identifier, options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -765,7 +945,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("claim", error, getExitCode(error));
         }
@@ -789,7 +969,7 @@ Examples:
   `)
     .action(async (tokenId, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -818,12 +998,13 @@ Examples:
             outputJson("token_info", result);
         }
         else if (!globalOpts.quiet) {
-            await displayTokenInfo(result, userAddress);
+            const client = await HttpcatClient.create(privateKey);
+            await displayTokenInfo(result, userAddress, client.getNetwork());
         }
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("token_info", error, getExitCode(error));
         }
@@ -849,7 +1030,7 @@ Examples:
   `)
     .action(async (options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -879,7 +1060,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("list_tokens", error, getExitCode(error));
         }
@@ -908,7 +1089,7 @@ Examples:
   `)
     .action(async (options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -981,7 +1162,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("transactions", error, getExitCode(error));
         }
@@ -1007,7 +1188,7 @@ Examples:
   `)
     .action(async (command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
@@ -1075,7 +1256,7 @@ Examples:
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("positions", error, getExitCode(error));
         }
@@ -1097,7 +1278,7 @@ Examples:
   `)
     .action(async (command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const privateKey = getPrivateKey(globalOpts.privateKey);
         if (!isConfigured(globalOpts.privateKey)) {
             console.error('❌ Not configured. Run "httpcat config" first or use --private-key flag.');
@@ -1119,7 +1300,7 @@ Examples:
         process.exit(result.status === "ok" ? 0 : 1);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("health", error, getExitCode(error));
         }
@@ -1141,14 +1322,15 @@ Examples:
   `)
     .action(async (command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
-        const accountIndex = globalOpts.account;
+        // Use program.opts() directly since command.parent?.opts() doesn't include global options
+        const programOpts = program.opts();
+        const accountIndex = programOpts.account;
         // Ensure wallet is unlocked
         await ensureWalletUnlocked();
-        let privateKey = getPrivateKey(globalOpts.privateKey, accountIndex);
+        let privateKey = getPrivateKey(programOpts.privateKey, accountIndex);
         // If not configured and not in JSON mode, prompt interactively
-        if (!isConfigured(globalOpts.privateKey)) {
-            if (globalOpts.json) {
+        if (!isConfigured(programOpts.privateKey)) {
+            if (programOpts.json) {
                 console.error('❌ Not configured. Run "httpcat config" first or use --private-key flag.');
                 process.exit(2);
             }
@@ -1157,25 +1339,25 @@ Examples:
         }
         const result = await withLoading(() => checkBalance(privateKey), {
             message: "Checking balances...",
-            json: globalOpts.json,
-            quiet: globalOpts.quiet,
+            json: programOpts.json,
+            quiet: programOpts.quiet,
             spinner: "cat",
         });
-        if (globalOpts.json) {
+        if (programOpts.json) {
             outputJson("balances", result);
         }
-        else if (!globalOpts.quiet) {
+        else if (!programOpts.quiet) {
             displayBalance(result);
         }
         process.exit(0);
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
-        if (globalOpts.json) {
+        const programOpts = program.opts();
+        if (programOpts.json) {
             outputError("balances", error, getExitCode(error));
         }
         else {
-            handleError(error, globalOpts.verbose);
+            handleError(error, programOpts.verbose);
         }
         process.exit(getExitCode(error));
     }
@@ -1304,7 +1486,7 @@ Examples:
   `)
     .action(async (tokenIdentifier, options, command) => {
     try {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         const chatOpts = options;
         const accountIndex = globalOpts.account;
         // Ensure wallet is unlocked
@@ -1332,7 +1514,7 @@ Examples:
         }
     }
     catch (error) {
-        const globalOpts = command.parent?.opts() || {};
+        const globalOpts = getGlobalOpts();
         if (globalOpts.json) {
             outputError("chat", error, getExitCode(error));
         }
@@ -1342,16 +1524,14 @@ Examples:
         process.exit(getExitCode(error));
     }
 });
-// Agent command
+// Agent setup command
 program
     .command("agent")
-    .alias("cat")
     .description("Configure AI agent for trading assistance")
     .option("-s, --setup", "Run setup wizard to configure API key")
     .addHelpText("after", `
 Examples:
   httpcat agent --setup               # Configure AI agent
-  httpcat cat --setup                 # Same, using 'cat' alias
 
 The AI agent helps you:
   • Trade tokens using natural language
@@ -1359,7 +1539,7 @@ The AI agent helps you:
   • Get market information
   • Execute commands hands-free
 
-You can use 'agent' or 'cat' interchangeably.
+Use 'httpcat cat' to start interactive agent mode.
   `)
     .action(async (options) => {
     try {
@@ -1371,16 +1551,13 @@ You can use 'agent' or 'cat' interchangeably.
         else {
             // Show help for agent command
             console.log();
-            console.log(chalk.cyan.bold("🐱 AI Agent"));
-            console.log();
-            console.log(chalk.yellow("The AI agent feature is currently available only in interactive mode."));
+            console.log(chalk.cyan.bold("🐱 AI Agent Setup"));
             console.log();
             console.log(chalk.bold("To configure:"));
             console.log(chalk.dim("  httpcat agent --setup"));
             console.log();
-            console.log(chalk.bold("Note:"));
-            console.log(chalk.dim("  The agent command has been temporarily disabled in interactive mode."));
-            console.log(chalk.dim("  Use the CLI setup above to configure your API keys for future use."));
+            console.log(chalk.bold("To start agent mode:"));
+            console.log(chalk.dim("  httpcat cat"));
             console.log();
             process.exit(0);
         }
@@ -1390,6 +1567,65 @@ You can use 'agent' or 'cat' interchangeably.
         process.exit(getExitCode(error));
     }
 });
+// Cat command - starts agent interactive mode
+program
+    .command("cat")
+    .description("Start interactive AI agent mode")
+    .addHelpText("after", `
+Examples:
+  httpcat cat                        # Start interactive agent mode
+
+The AI agent helps you:
+  • Trade tokens using natural language
+  • Check balances and positions
+  • Get market information
+  • Execute commands hands-free
+
+Type /exit to quit agent mode.
+  `)
+    .action(async (options, command) => {
+    try {
+        const globalOpts = getGlobalOpts();
+        const accountIndex = globalOpts.account;
+        // Ensure wallet is unlocked
+        await ensureWalletUnlocked();
+        let privateKey = getPrivateKey(globalOpts.privateKey, accountIndex);
+        // If not configured and not in JSON mode, prompt interactively
+        if (!isConfigured(globalOpts.privateKey)) {
+            if (globalOpts.json) {
+                console.error('❌ Not configured. Run "httpcat config" first or use --private-key flag.');
+                process.exit(2);
+            }
+            // Interactive prompt for private key
+            privateKey = await promptForPrivateKey();
+        }
+        const client = await HttpcatClient.create(privateKey);
+        // Check if agent is configured
+        const agentConfig = config.getAIAgentConfig();
+        if (!agentConfig) {
+            console.log();
+            console.log(chalk.yellow("⚠️  Agent not configured"));
+            console.log(chalk.dim("Run 'httpcat agent --setup' to configure the AI agent."));
+            console.log();
+            process.exit(1);
+        }
+        const apiKey = config.getAIAgentApiKey();
+        if (!apiKey) {
+            console.log();
+            console.log(chalk.red("❌ Failed to get API key"));
+            console.log(chalk.dim("Run 'httpcat agent --setup' to configure the API key."));
+            console.log();
+            process.exit(1);
+        }
+        // Start agent interactive mode
+        const { startAgentInteractiveMode } = await import("./interactive/shell.js");
+        await startAgentInteractiveMode(client);
+    }
+    catch (error) {
+        handleError(error, program.opts().verbose);
+        process.exit(getExitCode(error));
+    }
+});
 // MCP Server command
 program
     .command("mcp-server")
@@ -1438,10 +1674,10 @@ function displayGroupedHelp(program) {
     const commandGroups = {
         "Token Operations": ["create", "buy", "sell", "claim"],
         "Token Information": ["info", "list"],
-        "Portfolio": ["positions", "transactions", "balances"],
+        Portfolio: ["positions", "transactions", "balances"],
         "Account Management": ["account", "env"],
         "AI & Social": ["agent", "chat"],
-        "System": ["health", "config", "mcp-server"],
+        System: ["health", "config", "mcp-server"],
     };
     // Display grouped commands
     for (const [groupName, commandNames] of Object.entries(commandGroups)) {
@@ -1545,9 +1781,9 @@ function getTerminalSessionId() {
         // Fall through to other methods (e.g., on macOS or if /proc doesn't exist)
     }
     // Fall back to environment variables or user/term combination
-    return process.env.TERM_SESSION_ID ||
+    return (process.env.TERM_SESSION_ID ||
         process.env.SESSION_ID ||
-        `${process.env.USER || "default"}-${process.env.TERM || "unknown"}`;
+        `${process.env.USER || "default"}-${process.env.TERM || "unknown"}`);
 }
 // Helper function to check if animation has been shown in this terminal session
 function hasAnimationBeenShown() {