httpcat-cli 0.2.13 → 0.3.0-rc.1

package/.github/workflows/release.yml

@@ -764,3 +764,99 @@ jobs:
           echo "Version: ${{ needs.prepare.outputs.version }}"
           echo "npm: https://www.npmjs.com/package/httpcat-cli/v/${{ needs.prepare.outputs.version }}"
           echo "GitHub: https://github.com/${{ github.repository }}/releases/tag/${{ needs.prepare.outputs.tag }}"
+
+  # Job 6: Sync version to develop branch
+  sync-version:
+    name: Sync Version to Develop
+    runs-on: ubuntu-latest
+    needs: [create-release]
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout develop branch
+        run: |
+          git checkout develop
+          git pull origin develop
+
+      - name: Check for new commits in develop
+        id: check-commits
+        run: |
+          # Check if develop has commits that aren't in main
+          COMMITS_AHEAD=$(git rev-list --count origin/main..HEAD 2>/dev/null || echo "0")
+          echo "commits_ahead=$COMMITS_AHEAD" >> $GITHUB_OUTPUT
+          
+          if [ "$COMMITS_AHEAD" -gt 0 ]; then
+            echo "ℹ️  Develop has $COMMITS_AHEAD commit(s) not in main"
+            echo "These will be preserved by rebasing onto main"
+          else
+            echo "✅ Develop has no new commits - can fast-forward to main"
+          fi
+
+      - name: Rebase develop onto main
+        run: |
+          echo "Updating develop to include latest from main..."
+          git fetch origin main
+          
+          # Check if we can fast-forward (no new commits in develop)
+          COMMITS_AHEAD="${{ steps.check-commits.outputs.commits_ahead }}"
+          
+          if [ "$COMMITS_AHEAD" -eq 0 ]; then
+            # Fast-forward: just move develop to main
+            echo "Fast-forwarding develop to main..."
+            git reset --hard origin/main
+          else
+            # Rebase: replay develop's commits on top of main
+            echo "Rebasing develop onto main..."
+            git rebase origin/main || {
+              echo "⚠️  Rebase conflict detected - this shouldn't happen if develop was properly merged"
+              echo "Falling back to reset (this will discard develop-only commits)"
+              git rebase --abort 2>/dev/null || true
+              git reset --hard origin/main
+            }
+          fi
+          echo "✅ Develop updated to include latest from main"
+
+      - name: Verify package.json version
+        run: |
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          RELEASE_VERSION="${{ needs.prepare.outputs.version }}"
+          
+          echo "Current version in package.json: $CURRENT_VERSION"
+          echo "Release version: $RELEASE_VERSION"
+          
+          if [ "$CURRENT_VERSION" != "$RELEASE_VERSION" ]; then
+            echo "Updating package.json version..."
+            npm version "$RELEASE_VERSION" --no-git-tag-version --allow-same-version
+            git add package.json
+            git commit -m "chore: sync version to $RELEASE_VERSION" || echo "No changes to commit"
+          else
+            echo "✅ Version already matches"
+          fi
+
+      - name: Push to develop
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # Check if there are any changes to push
+          if git diff --quiet origin/develop HEAD; then
+            echo "✅ No changes to push (develop already up to date)"
+          else
+            COMMITS_AHEAD="${{ steps.check-commits.outputs.commits_ahead }}"
+            if [ "$COMMITS_AHEAD" -eq 0 ]; then
+              # Fast-forward push (no force needed)
+              echo "Pushing fast-forward update..."
+              git push origin develop
+            else
+              # Rebase requires force push (but this is safe after rebase)
+              echo "Pushing rebased develop branch..."
+              git push origin develop --force-with-lease
+            fi
+            echo "✅ Develop updated and pushed"
+          fi

package/.github/workflows/sync-version.yml

@@ -1,9 +1,18 @@
 name: Sync Version to Develop
 
 # This workflow runs after a release to reset develop to match main and sync the version
+# It has multiple triggers to ensure it runs reliably:
+# 1. release event (when a release is published)
+# 2. workflow_run (when the release workflow completes - backup trigger)
+# 3. workflow_dispatch (manual trigger)
 on:
   release:
     types: [published]
+  workflow_run:
+    workflows: ["Publish Switch"]
+    types: [completed]
+    branches:
+      - main
   workflow_dispatch:
     inputs:
       version:
@@ -24,6 +33,12 @@ jobs:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Setup GitHub CLI
+        if: github.event_name == 'workflow_run'
+        uses: cli/cli@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Get version from release
         id: version
         run: |
@@ -32,16 +47,30 @@ jobs:
             VERSION="${{ inputs.version }}"
             echo "✅ Using provided version: $VERSION"
           elif [ -n "${{ github.event.release.tag_name }}" ]; then
+            # Release event trigger
             VERSION="${{ github.event.release.tag_name }}"
             # Remove 'v' prefix if present
             VERSION="${VERSION#v}"
-            echo "✅ Version from release: $VERSION"
+            echo "✅ Version from release event: $VERSION"
+          elif [ "${{ github.event_name }}" == "workflow_run" ]; then
+            # Workflow run trigger - get latest release tag
+            echo "Getting latest release tag..."
+            LATEST_TAG=$(gh api repos/${{ github.repository }}/releases/latest --jq '.tag_name' || echo "")
+            if [ -n "$LATEST_TAG" ]; then
+              VERSION="$LATEST_TAG"
+              # Remove 'v' prefix if present
+              VERSION="${VERSION#v}"
+              echo "✅ Version from latest release: $VERSION"
+            else
+              echo "❌ Could not get latest release tag"
+              exit 1
+            fi
           else
             echo "❌ No version provided and no release event found"
             exit 1
           fi
           echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "✅ Version from release: $VERSION"
+          echo "✅ Final version: $VERSION"
 
       - name: Checkout develop branch
         run: |

package/README.md

@@ -102,11 +102,17 @@ httpcat
 
 You'll be prompted to enter:
 
-- **Private Key** - Your wallet's private key (starts with 0x)
-- **Network** - `base-sepolia` (testnet) or `base` (mainnet)
-- **Agent URL** - The httpcat agent endpoint
+- **Private Key** - Your wallet's private key (starts with 0x) or seed phrase for HD wallet
+- **Password** - (Optional) Password to encrypt your private keys and seed phrase
+- **Network** - Network format: `eip155:84532` (Base Sepolia testnet) or `eip155:8453` (Base mainnet)
+- **Agent URL** - The httpcat agent endpoint (default: https://agent.402.cat)
 - **ASCII Art** - Enable or disable cat art
 
+**Network Format:** Uses CAIP-2 format (`eip155:<chainId>`):
+
+- Base Sepolia (testnet): `eip155:84532` (Chain ID: 84532)
+- Base (mainnet): `eip155:8453` (Chain ID: 8453)
+
 ### Interactive Mode
 
 Once configured, running `httpcat` without arguments starts an interactive shell:
@@ -118,7 +124,7 @@ $ httpcat
  ( ^.^ ) Welcome to httpcat!
   > ^ <  Your agent for token operations
 
-🔗 Connected to: base-sepolia
+🔗 Connected to: eip155:84532 (Base Sepolia)
 🌐 Agent: https://agent.402.cat
 
 httpcat> help
@@ -135,9 +141,8 @@ Available Commands:
   chat [token]                    Start streaming chat (optional: token symbol/name/address)
   balances                        Check wallet balances (ETH, USDC, and CAT)
   account [list|switch|add]       Manage accounts
-  agent <query> | cat <query>     Ask the cat to do something (agent and cat are synonyms)
-  agent --chat | cat --chat       Enter interactive chat mode
-  agent --setup | cat --setup     Configure API key/provider
+  cat                             Start interactive AI assistant chat mode
+  agent setup                     Configure autonomous trading agent settings
   health                          Check agent health
   config [--show|--set|--reset]   Manage configuration
   network                          Show current network
@@ -239,6 +244,8 @@ httpcat create "My Token" "MTK" --photo ./logo.png
 - `-p, --photo <url|path>` - Token photo URL or file path (supports http/https URLs, local file paths, or base64 data URLs)
 - `-w, --website <url>` - Website URL
 
+**Note:** If no photo is provided, a unique [Robohash](https://robohash.org/) avatar is automatically generated for your token based on the token address.
+
 **Cost:** $0.01 USDC
 
 ### Buy Tokens
@@ -284,7 +291,7 @@ httpcat buy MTK 0.10 -r 10 -d 500
 
 **Amounts:**
 
-- Test mode (base-sepolia): `0.05`, `0.10`, or `0.20` USDC
+- Test mode (Base Sepolia / eip155:84532): `0.05`, `0.10`, or `0.20` USDC
 - Production (base): `50`, `100`, or `200` USDC
 - Percentage: `10%`, `50%`, `100%` (percentage of your USDC balance)
   - Example: `httpcat buy MTK 50%` - Buy with 50% of your USDC balance
@@ -297,6 +304,8 @@ httpcat buy MTK 0.10 -r 10 -d 500
 When using `-r, --repeat`, the command will:
 
 - Execute the specified number of buys sequentially
+- Wait for transaction confirmation between each buy
+- Automatically retry failed transactions (up to 10 attempts with exponential backoff)
 - Stop early if the token graduates (reaches 100% graduation progress)
 - Stop early if you run out of funds (HTTP 402 error)
 - Display a compact summary for each buy
@@ -328,6 +337,39 @@ httpcat sell MTK all
 
 **Cost:** Dynamic based on amount (1% fee deducted from proceeds)
 
+### Swap Tokens
+
+Swap any ERC20 token to any other ERC20 token using pro DEX aggregation with optimal routing.
+
+**CLI:**
+
+```bash
+httpcat swap <tokenIn> <tokenOut> <amount>
+httpcat swap <tokenIn> <tokenOut> <amount> --slippage <bps>
+```
+
+**Parameters:**
+
+- `tokenIn` - Token to sell (contract address)
+- `tokenOut` - Token to buy (contract address)
+- `amount` - Amount to sell in smallest unit (e.g., 1000000 = 1 USDC with 6 decimals)
+
+**Options:**
+
+- `-s, --slippage <bps>` - Slippage tolerance in basis points (default: 50 = 0.5%)
+
+**Examples:**
+
+```bash
+# Swap 1 USDC for WETH with default 0.5% slippage
+httpcat swap 0x036cbd53842c5426634e7929541ec2318f3dcf7e 0x4200000000000000000000000000000000000006 1000000
+
+# Swap with 1% slippage tolerance
+httpcat swap 0x036c... 0x4200... 1000000 --slippage 100
+```
+
+**Cost:** $0.10 USDC
+
 ### Token Info
 
 Get detailed information about a token.
@@ -469,6 +511,7 @@ httpcat --json claim "My Token"
 **Output:**
 
 When viewing (without `--execute`):
+
 - Total accumulated fees (tokens and USDC)
 - Creator share (80%)
 - Platform share (20%)
@@ -476,6 +519,7 @@ When viewing (without `--execute`):
 - V4 position details (if applicable)
 
 When claiming (with `--execute`):
+
 - Transaction hash
 - Fees claimed (tokens and USDC)
 - Creator and platform shares distribution
@@ -515,6 +559,7 @@ httpcat --json transactions --offset 50
 **Output:**
 
 For each transaction:
+
 - Transaction type (buy, sell, or airdrop)
 - Status (pending, success, or failed)
 - Token information (name, symbol, ID)
@@ -596,6 +641,7 @@ httpcat --json account
 **Output:**
 
 Account information includes:
+
 - Account index and type (Seed-Derived or Custom)
 - Wallet address (checksummed)
 - ETH balance (for gas fees)
@@ -686,64 +732,87 @@ While in a chat session, you can use these commands:
 
 **Note:** For AI agents, consider using MCP tools (`chat_join`, `chat_send_message`, etc.) instead of CLI streaming for better integration. See [MCP Chat Tools](#chat-tools-usage-example) section.
 
-### Cat / Agent
+### Cat (Interactive AI Assistant)
 
-Interact with an AI-powered cat assistant that can help you with token operations, portfolio management, and more. **`agent` and `cat` are synonyms** - you can use either command name.
+Interact with an AI-powered assistant that can help you with token operations, portfolio management, and more using natural language.
 
 **Interactive:**
 
 ```bash
-httpcat> agent "Buy 100 WOW tokens"     # Ask the cat to do something
-httpcat> cat "What tokens do I own?"     # Same thing, different name
-httpcat> agent --chat                    # Enter interactive chat mode
-httpcat> cat --chat                      # Same thing
-httpcat> agent --setup                   # Configure API key/provider
-httpcat> cat --setup                     # Same thing
-```
-
-**CLI:**
-
-```bash
-httpcat agent "Buy 100 WOW tokens"
-httpcat cat "What tokens do I own?"
-httpcat agent --chat
-httpcat cat --chat
-httpcat agent --setup
-httpcat cat --setup
+httpcat> cat
+# Starts interactive AI chat session
+# Type /exit to quit
 ```
 
 **Usage:**
 
-- `agent <query>` or `cat <query>` - Ask the cat to execute a task (e.g., "Buy WOW tokens", "Check my balance", "List my positions")
-- `agent --chat` or `cat --chat` - Enter interactive chat mode for extended conversations
-- `agent --setup` or `cat --setup` - Configure or reconfigure your AI provider (OpenAI or Anthropic) and API key
+The `cat` command starts an interactive AI assistant session where you can ask questions and give trading commands in natural language. The assistant will execute operations on your behalf.
 
 **First-Time Setup:**
 
-Before using the cat/agent, you'll need to configure it:
+Before using the cat command, you'll need to configure your AI provider:
 
 ```bash
-httpcat> agent --setup
-# or
-httpcat> cat --setup
+httpcat config
 ```
 
-You'll be prompted to:
+During setup, you'll be prompted to:
+
 - Choose an AI provider (OpenAI or Anthropic)
 - Enter your API key
 - Select a model (defaults provided)
 
 **How It Works:**
 
-The cat uses an AI agent (powered by OpenAI GPT-4 or Anthropic Claude) to understand natural language requests and execute token operations on your behalf. It can:
+The cat assistant uses AI (powered by OpenAI GPT-4 or Anthropic Claude) to understand natural language requests and execute token operations on your behalf. It can:
+
 - Buy and sell tokens
 - Check balances and positions
 - List tokens
 - Get token information
+- Answer questions about your portfolio
 - And more!
 
 **Note:** The cat requires an API key from either OpenAI or Anthropic. Your API key is stored locally and encrypted, and is only sent to the LLM provider - never to any other server.
 
+### Agent (Autonomous Trading)
+
+Configure and run an autonomous trading agent that monitors token events and makes trading decisions based on your risk parameters.
+
+**Interactive:**
+
+```bash
+httpcat> agent setup     # Configure autonomous trading settings
+```
+
+**CLI:**
+
+```bash
+httpcat agent setup
+```
+
+**Configuration Options:**
+
+When setting up the autonomous agent, you can configure:
+
+- **Max Trade Amount** - Maximum USDC per trade
+- **Risk Tolerance** - Conservative, moderate, or aggressive
+- **Token Filters** - Minimum holders, max whale percentage, min liquidity
+- **Trading Thresholds** - Stop loss and take profit percentages
+- **Auto-Execute** - Enable automatic trade execution or recommendation-only mode
+
+**How It Works:**
+
+The autonomous agent:
+
+1. Monitors real-time token events via event stream
+2. Analyzes tokens based on your configured filters and risk parameters
+3. Makes trading decisions using AI reasoning
+4. Either executes trades automatically or provides recommendations (based on your settings)
+5. Tracks positions and maintains a decision history database
+
+**Note:** The autonomous agent requires AI provider configuration (same as the `cat` command). Always start with recommendation-only mode before enabling auto-execution.
+
 ### Help
 
 Display help information for httpcat.
@@ -1500,8 +1569,8 @@ Updates an existing environment's agent URL and optionally its network.
 
 #### Predefined Environments
 
-- **local** - `http://localhost:8787` (base-sepolia)
-- **sepolia** - `https://agent.402.cat` (base-sepolia)
+- **local** - `http://localhost:8787` (eip155:84532)
+- **sepolia** - `https://agent.402.cat` (eip155:84532)
 
 #### Environment Priority
 
@@ -1584,7 +1653,7 @@ Config is stored at `~/.config/httpcat/config.json`:
     }
   ],
   "activeAccountIndex": 0,
-  "network": "base-sepolia",
+  "network": "eip155:84532",
   "agentUrl": "https://agent.402.cat",
   "facilitatorUrl": "https://facilitators.x402scan.com",
   "defaultMaxPayment": "10.00",
@@ -1610,6 +1679,20 @@ Config is stored at `~/.config/httpcat/config.json`:
     "provider": "openai",
     "apiKey": "encrypted_key_here",
     "model": "gpt-4"
+  },
+  "autonomousAgent": {
+    "enabled": false,
+    "maxTradeAmount": "10.00",
+    "riskTolerance": "moderate",
+    "tokenFilters": {
+      "minHolders": 10,
+      "maxWhalePercentage": 20,
+      "minLiquidity": 1000
+    },
+    "stopLoss": 20,
+    "takeProfit": 50,
+    "eventStreamUrl": "wss://events.402.cat",
+    "databasePath": "~/.config/httpcat/agent.db"
   }
 }
 ```
@@ -1618,27 +1701,32 @@ Config is stored at `~/.config/httpcat/config.json`:
 
 - **Password Protection**: Set a password during setup to encrypt your private keys and seed phrase
 - **Session Management**: Configurable timeout (default: 15 minutes via `passwordTimeoutMinutes`)
+  - After the timeout, you'll need to re-enter your password to unlock the wallet
+  - Session tokens are managed automatically to keep your wallet secure
 - **Multi-Account Support**: Manage multiple accounts (seed-derived HD wallet accounts and custom imported accounts)
 - **Encrypted Storage**: Keys and seed phrases are encrypted when password is enabled
 - **Account Types**:
-  - **Seed-Derived** (Account 1+): Generated from your seed phrase using BIP-32/BIP-39
-  - **Custom** (Account 0): Imported via private key
+  - **Account 0 (Custom)**: Imported via private key during initial setup
+  - **Account 1+ (Seed-Derived)**: Generated from your seed phrase using BIP-32/BIP-39 HD wallet derivation
+  - You can add unlimited seed-derived accounts using `account add`
+  - All accounts share the same password protection
 
 **Security Notes:**
 
-- **Without password**: Private key stored in plain text (legacy `privateKey` field, auto-migrated to encrypted format)
-- **With password**: Private key, seed phrase, and AI API keys are encrypted
+- **Without password**: Private key stored in plain text (legacy `privateKey` field, auto-migrated to encrypted format on first password setup)
+- **With password**: Private key, seed phrase, and AI API keys are AES-256 encrypted
+- **Session Timeout**: Wallet automatically locks after 15 minutes of inactivity (configurable)
 - **For production use**:
   - Enable password protection during setup for encryption
-  - Use `HTTPCAT_PRIVATE_KEY` environment variable for additional security
+  - Use `HTTPCAT_PRIVATE_KEY` environment variable for additional security in scripts
   - Set restrictive file permissions: `chmod 600 ~/.config/httpcat/config.json`
-  - Use a dedicated wallet with limited funds
+  - Use a dedicated wallet with limited funds for trading operations
 
 ## How It Works
 
 ### x402 Payment Protocol
 
-httpcat uses the [x402 protocol](https://x402.org) for micropayments:
+httpcat uses the [x402 protocol V2](https://x402.org) for micropayments:
 
 1. **Request** - CLI makes a request to the agent
 2. **402 Response** - Agent returns payment requirements
@@ -1678,7 +1766,7 @@ export HTTPCAT_PRIVATE_KEY=0x...
 
 Make sure you have enough USDC in your wallet:
 
-- Test mode (base-sepolia): Get testnet USDC from faucets
+- Test mode (Base Sepolia / eip155:84532): Get testnet USDC from faucets
 - Production (base): Bridge USDC to Base
 
 You also need ETH for gas fees.
@@ -1688,7 +1776,7 @@ You also need ETH for gas fees.
 The payment verification failed. Check:
 
 1. Wallet has sufficient USDC and ETH
-2. Network is correct (base-sepolia vs base)
+2. Network is correct (eip155:84532 for testnet vs eip155:8453 for mainnet)
 3. Agent URL is reachable
 4. Facilitator URL is correct