clodds 1.2.9 → 1.3.0

package/dist/skills/bundled/pump-swarm/SKILL.md

@@ -0,0 +1,309 @@
+---
+name: pump-swarm
+description: "Coordinated multi-wallet trading on Pump.fun"
+command: swarm
+emoji: "🐝"
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Pump.fun Swarm Trading
+
+Coordinate up to **20 wallets** to execute synchronized trades on Pump.fun tokens.
+
+## Quick Start
+
+```bash
+# Set up wallets
+export SOLANA_PRIVATE_KEY="your-main-wallet-key"     # wallet_0
+export SOLANA_SWARM_KEY_1="second-wallet-key"        # wallet_1
+export SOLANA_SWARM_KEY_2="third-wallet-key"         # wallet_2
+# ... up to SOLANA_SWARM_KEY_20
+
+# Optional
+export SOLANA_RPC_URL="https://your-rpc.com"
+export PUMPPORTAL_API_KEY="your-api-key"
+```
+
+## Commands
+
+### Wallet Management
+
+```
+/swarm wallets              List all swarm wallets with addresses
+/swarm balances             Fetch SOL balances from chain
+/swarm enable <wallet_id>   Enable a wallet for trading
+/swarm disable <wallet_id>  Disable a wallet
+```
+
+### Trading
+
+```
+/swarm buy <mint> <sol> [options]      Buy with all enabled wallets
+/swarm sell <mint> <amount|%> [opts]   Sell from wallets with positions
+```
+
+### Position Management
+
+```
+/swarm position <mint>      Show cached token positions
+/swarm refresh <mint>       Fetch fresh positions from chain (required before sell)
+```
+
+## Execution Modes
+
+| Mode | Flag | Best For | Description |
+|------|------|----------|-------------|
+| **Parallel** | `--parallel` | Speed (>5 wallets) | All wallets execute simultaneously |
+| **Bundle** | `--bundle` | Atomicity (≤5) | Single Jito bundle, all-or-nothing |
+| **Multi-Bundle** | `--multi-bundle` | Atomicity (6-20) | Multiple Jito bundles in parallel |
+| **Sequential** | `--sequential` | Stealth | Staggered 200-400ms delays |
+
+### Auto Mode Selection (Default)
+- 1 wallet → Parallel (direct submit)
+- 2-5 wallets → Single Jito Bundle
+- 6-20 wallets → Multi-Bundle (chunks of 5)
+
+## Other Options
+
+| Option | Description |
+|--------|-------------|
+| `--preset <name>` | Apply a saved preset |
+| `--wallets <id1,id2>` | Use specific wallets only |
+| `--slippage <bps>` | Slippage tolerance (default: 500 = 5%) |
+| `--pool <pool>` | Pool: pump, raydium, auto (pumpfun only) |
+| `--dex <dex>` | DEX: pumpfun (default), bags, meteora |
+| `--pool-address <addr>` | Specific pool address (for Meteora) |
+
+## Examples
+
+```bash
+# Buy 0.1 SOL worth on each enabled wallet (auto mode)
+/swarm buy ABC123mint... 0.1
+
+# Buy with specific wallets only
+/swarm buy ABC123mint... 0.2 --wallets wallet_0,wallet_1
+
+# Buy with a preset
+/swarm buy ABC123mint... 0.1 --preset stealth
+
+# Sell 100% with multiple Jito bundles (for >5 wallets)
+/swarm sell ABC123mint... 100% --multi-bundle
+
+# Sell 50% with staggered timing (stealth mode)
+/swarm sell ABC123mint... 50% --sequential
+
+# Sell with preset
+/swarm sell ABC123mint... 100% --preset fast
+
+# Check positions before selling
+/swarm refresh ABC123mint...
+/swarm position ABC123mint...
+
+# Multi-DEX examples
+/swarm buy ABC123mint... 0.1 --dex bags          # Buy on Bags.fm
+/swarm buy ABC123mint... 0.1 --dex meteora       # Buy on Meteora DLMM
+/swarm sell ABC123mint... 100% --dex bags        # Sell on Bags.fm
+```
+
+## Execution Modes Deep Dive
+
+### Parallel (Default for >5 wallets)
+- **Speed:** All wallets submit simultaneously via `Promise.all`
+- **Risk:** No atomicity - some may succeed, others fail
+- **Use when:** Speed is priority, or bundles keep failing
+
+### Jito Bundle (Default for 2-5 wallets)
+- **Atomic:** All transactions succeed or all fail together
+- **MEV-protected:** No front-running between your own wallets
+- **Cost:** ~10,000 lamports tip per bundle
+- **Limit:** Max 5 transactions per bundle (Jito constraint)
+
+### Multi-Bundle (Recommended for 6-20 wallets)
+- **Chunked:** Splits wallets into groups of 5
+- **Parallel bundles:** All chunks submit simultaneously
+- **Partial atomicity:** Each chunk is atomic, but chunks are independent
+- **Example:** 12 wallets → 3 bundles of [5, 5, 2] wallets
+
+### Sequential (Stealth mode)
+- **Staggered:** 200-400ms random delay between wallets
+- **Amount variance:** ±5% to avoid detection patterns
+- **Rate limited:** 5 seconds minimum between trades per wallet
+- **Use when:** Want to avoid pattern detection
+
+## How It Works
+
+### Buy Flow
+1. Refreshes SOL balances from chain
+2. Filters wallets with sufficient balance (≥0.01 SOL + amount)
+3. Builds transaction for each wallet via PumpPortal API
+4. Signs all transactions locally
+5. Submits via selected execution mode
+6. Reports results per wallet
+
+### Sell Flow
+1. **Fetches actual token balances from chain** (critical!)
+2. Filters wallets with positions
+3. Calculates sell amount (% of position or exact)
+4. Builds and signs transactions
+5. Submits via selected execution mode
+6. Reports results per wallet
+
+## Safety Features
+
+- **Balance check:** Verifies sufficient SOL before buy
+- **Position check:** Fetches real token balances before sell
+- **Max amount:** Rejects buy amounts > 10 SOL per wallet
+- **Confirmation timeout:** 60 second timeout per transaction
+- **Error reporting:** Shows detailed errors per wallet
+- **Bundle fallback:** Failed bundles automatically retry as parallel
+
+## Configuration
+
+| Env Variable | Description |
+|--------------|-------------|
+| `SOLANA_PRIVATE_KEY` | Main wallet (wallet_0) |
+| `SOLANA_SWARM_KEY_1..20` | Additional swarm wallets |
+| `SOLANA_RPC_URL` | Custom RPC endpoint (faster = better) |
+| `PUMPPORTAL_API_KEY` | PumpPortal API key (optional, for pumpfun) |
+| `BAGS_API_KEY` | Bags.fm API key (required for bags DEX) |
+
+## Multi-DEX Support
+
+The swarm system supports trading across multiple DEXes:
+
+| DEX | Flag | Best For | Requires |
+|-----|------|----------|----------|
+| Pump.fun | `--dex pumpfun` (default) | Memecoins, new launches | `PUMPPORTAL_API_KEY` (optional) |
+| Bags.fm | `--dex bags` | Bags-launched tokens | `BAGS_API_KEY` |
+| Meteora | `--dex meteora` | DLMM pools, concentrated liquidity | - |
+
+### Multi-DEX Examples
+
+```bash
+# Buy on Pump.fun (default)
+/swarm buy ABC123... 0.1
+
+# Buy on Bags.fm
+/swarm buy ABC123... 0.1 --dex bags
+
+# Buy on Meteora with specific pool
+/swarm buy ABC123... 0.1 --dex meteora --pool-address <pool_address>
+
+# Sell on Bags.fm with stealth preset
+/swarm sell ABC123... 100% --dex bags --preset stealth
+```
+
+### Notes
+- Default DEX is `pumpfun` for backward compatibility
+- Bags requires `BAGS_API_KEY` - will error if missing
+- Meteora can auto-discover pools or use a specific `--pool-address`
+- All execution modes (parallel, bundle, sequential) work with all DEXes
+- Presets work with all DEXes
+
+## Agent Tools (12)
+
+| Tool | Description |
+|------|-------------|
+| `swarm_wallets` | List all swarm wallets |
+| `swarm_balances` | Refresh SOL balances from chain |
+| `swarm_buy` | Coordinated buy across wallets (supports `preset` param) |
+| `swarm_sell` | Coordinated sell across wallets (supports `preset` param) |
+| `swarm_position` | Get cached positions |
+| `swarm_refresh` | Fetch fresh positions from chain |
+| `swarm_enable` | Enable a wallet |
+| `swarm_disable` | Disable a wallet |
+| `swarm_preset_save` | Save a trading preset |
+| `swarm_preset_list` | List saved presets |
+| `swarm_preset_get` | Get preset details |
+| `swarm_preset_delete` | Delete a preset |
+
+## Scaling Notes
+
+- **Max wallets:** 20 (wallet_0 + SOLANA_SWARM_KEY_1..20)
+- **Jito bundle limit:** 5 txs per bundle (handled automatically)
+- **Multi-bundle parallel:** All bundles submit simultaneously
+- **RPC recommendation:** Use dedicated RPC for best performance
+- **Tip amount:** 10,000 lamports per bundle (~$0.002)
+
+## Presets
+
+Save and reuse trading configurations across tokens and strategies.
+
+### Preset Commands
+
+```bash
+/swarm preset save <name> [options]   Save a preset
+/swarm preset list [type]             List presets
+/swarm preset show <name>             Show preset details
+/swarm preset delete <name>           Delete a preset
+```
+
+### Preset Save Options
+
+| Option | Description |
+|--------|-------------|
+| `--type <type>` | Preset type: strategy, token, wallet_group |
+| `--desc "..."` | Preset description |
+| `--mint <addr>` | Token address (for token presets) |
+| `--amount <sol>` | Default SOL per wallet |
+| `--slippage <bps>` | Slippage in basis points |
+| `--pool <pool>` | Pool: pump, raydium, auto |
+| `--mode <mode>` | parallel, bundle, multi-bundle, sequential |
+| `--wallets <ids>` | Wallet IDs (for wallet_group presets) |
+
+### Built-in Presets
+
+| Name | Mode | Slippage | Pool | Use Case |
+|------|------|----------|------|----------|
+| `fast` | parallel | 5% | auto | Speed priority |
+| `atomic` | multi-bundle | 5% | auto | All-or-nothing execution |
+| `stealth` | sequential | 3% | auto | Pattern avoidance |
+| `aggressive` | parallel | 10% | pump | High volatility tokens |
+| `safe` | bundle | 2% | auto | Conservative trading |
+
+### Preset Examples
+
+```bash
+# Create a custom strategy preset
+/swarm preset save my_stealth --type strategy --mode sequential --slippage 300
+
+# Create a token preset for BONK
+/swarm preset save bonk_entry --type token --mint DezXAZ... --slippage 1000 --amount 0.1
+
+# Create a wallet group preset
+/swarm preset save top5 --type wallet_group --wallets wallet_0,wallet_1,wallet_2,wallet_3,wallet_4
+
+# List all presets
+/swarm preset list
+
+# List only strategy presets
+/swarm preset list strategy
+
+# Use preset in trade
+/swarm buy ABC... 0.1 --preset my_stealth
+/swarm sell ABC... 100% --preset fast
+
+# Delete a preset
+/swarm preset delete old_preset
+```
+
+### Preset Types
+
+| Type | Purpose |
+|------|---------|
+| `strategy` | Reusable trading settings (mode, slippage, pool) |
+| `token` | Token-specific settings with saved mint address |
+| `wallet_group` | Named wallet combinations for specific trades |
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Bundle keeps failing | Try `--parallel` or check network congestion |
+| Positions not showing | Run `/swarm refresh <mint>` first |
+| Insufficient balance | Check with `/swarm balances` |
+| Slow execution | Use dedicated RPC via `SOLANA_RPC_URL` |
+| Some wallets skipped | Wallet disabled or insufficient balance |
+| Preset not found | Check name with `/swarm preset list` |

package/dist/skills/bundled/pumpfun/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: pumpfun
+description: "Pump.fun - Complete Solana memecoin launchpad. Discovery, trending, gainers, losers, token data all work without a key. Trading requires SOLANA_PRIVATE_KEY."
+command: pump
+emoji: "🚀"
+---
+
+# Pump.fun - Complete API Coverage (32 Tools)
+
+Pump.fun is the leading Solana memecoin launchpad with bonding curve trading.
+
+## Trading
+
+```
+/pump buy <mint> <amount> [options]     Buy tokens (amount in SOL)
+/pump sell <mint> <amount|%> [options]  Sell tokens (amount or percentage)
+/pump quote <mint> <amount> <action>    Get swap quote
+```
+
+**Options:**
+- `--pool <pool>` - Pool: pump, raydium, pump-amm, launchlab, bonk, auto
+- `--slippage <bps>` - Slippage in basis points (default: 500 = 5%)
+- `--priority <lamports>` - Priority fee for faster execution
+
+**Examples:**
+```
+/pump buy ABC123... 0.1
+/pump buy ABC123... 0.5 --pool auto --slippage 1000
+/pump sell ABC123... 100%
+/pump sell ABC123... 50% --pool raydium
+```
+
+## Discovery
+
+```
+/pump trending               Top tokens by 24h volume (DexScreener enriched)
+/pump gainers                Top 24h price gainers
+/pump losers                 Top 24h price losers
+/pump hot                    Most active right now (1h transactions)
+/pump new-hot                Hottest new tokens by volume
+/pump new                    Recently created tokens
+/pump live                   Currently trading tokens
+/pump graduated              Tokens migrated to Raydium
+/pump search <query>         Search tokens by name/symbol
+/pump volatile               High volatility tokens
+/pump koth                   King of the Hill (30-35K mcap)
+/pump for-you                Personalized recommendations
+/pump metas                  Trending narratives/keywords
+```
+
+## Token Data
+
+```
+/pump token <mint>                      Full token info
+/pump stats <mint>                      Volume, txns, liquidity, price change (DexScreener)
+/pump price <mint>                      Current price + 24h stats
+/pump holders <mint>                    Top holders list
+/pump trades <mint> [--limit N]         Recent trades for token
+/pump chart <mint> [--interval X]       OHLCV price chart
+/pump similar <mint>                    Find similar tokens
+```
+
+**Intervals:** 1m, 5m, 15m, 1h, 4h, 1d
+
+## Creator Tools
+
+```
+/pump user-coins <address>              Tokens created by wallet
+/pump create <name> <symbol> <desc>     Launch new token
+/pump claim <mint>                      Claim creator fees
+/pump ipfs-upload <name> <symbol> <desc>  Upload metadata to IPFS
+```
+
+**Create Options:**
+- `--image <url>` - Token image URL
+- `--twitter <url>` - Twitter link
+- `--telegram <url>` - Telegram link
+- `--website <url>` - Website link
+- `--initial <SOL>` - Initial buy amount
+
+## Platform Data
+
+```
+/pump latest-trades [--limit N]         Latest trades platform-wide
+/pump sol-price                         Current SOL price
+```
+
+## Monitoring (WebSocket)
+
+```
+/pump watch <mint>           Watch token for real-time trades
+/pump snipe <symbol>         Wait for token with symbol to launch
+```
+
+## Configuration
+
+```bash
+export SOLANA_PRIVATE_KEY="your-private-key"
+export PUMPPORTAL_API_KEY="your-api-key"     # Optional, for trading API
+export SOLANA_RPC_URL="your-rpc-url"         # Optional, custom RPC
+```
+
+## Pool Options
+
+| Pool | Description |
+|------|-------------|
+| `pump` | Pump.fun bonding curve (default) |
+| `raydium` | Raydium AMM (graduated tokens) |
+| `pump-amm` | Pump.fun native AMM |
+| `launchlab` | LaunchLab pools |
+| `raydium-cpmm` | Raydium CPMM pools |
+| `bonk` | Bonk pools |
+| `auto` | Automatic best route |
+
+## API Sources
+
+- **Trading:** PumpPortal (pumpportal.fun) - 0.5% fee
+- **Data:** Pump.fun Frontend API v3 (frontend-api-v3.pump.fun)
+- **Analytics:** Advanced API v2 (advanced-api-v2.pump.fun)
+- **Volatility:** Volatility API v2 (volatility-api-v2.pump.fun)
+- **WebSocket:** wss://pumpportal.fun/api/data
+
+## Complete Tool List (32 Tools)
+
+| Category | Tools |
+|----------|-------|
+| **Trading** | trade (buy/sell), quote |
+| **Discovery** | trending, gainers, losers, hot, new-hot, new, live, graduated, search, volatile, koth, for-you, metas |
+| **Token Data** | token, stats, price, holders, trades, chart, similar |
+| **Creator** | user-coins, create, claim, ipfs-upload |
+| **Platform** | latest-trades, sol-price |
+
+## Features
+
+- Bonding curve trading with automatic graduation
+- Multi-pool routing (Pump, Raydium, CPMM, etc.)
+- Token creation with IPFS metadata upload
+- Creator fee claiming
+- Real-time trade streaming via WebSocket
+- Token sniping support
+- OHLCV charts and analytics
+- Holder analysis
+- Trending metas/narratives discovery
+- Similar token recommendations
+- Platform-wide trade feed

package/dist/skills/bundled/qmd/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: qmd
+description: Local hybrid search for markdown notes and docs. Use when searching notes, finding related content, or retrieving documents from indexed collections.
+homepage: https://github.com/tobi/qmd
+metadata: {"clawdbot":{"emoji":"🔍","os":["darwin","linux"],"requires":{"bins":["qmd"]},"install":[{"id":"bun-qmd","kind":"shell","command":"bun install -g https://github.com/tobi/qmd","bins":["qmd"],"label":"Install qmd via Bun"}]}}
+---
+
+# qmd - Quick Markdown Search
+
+Local search engine for Markdown notes, docs, and knowledge bases. Index once, search fast.
+
+## When to use (trigger phrases)
+
+- "search my notes / docs / knowledge base"
+- "find related notes"
+- "retrieve a markdown document from my collection"
+- "search local markdown files"
+
+## Default behavior (important)
+
+- Prefer `qmd search` (BM25). It's typically instant and should be the default.
+- Use `qmd vsearch` only when keyword search fails and you need semantic similarity (can be very slow on a cold start).
+- Avoid `qmd query` unless the user explicitly wants the highest quality hybrid results and can tolerate long runtimes/timeouts.
+
+## Prerequisites
+
+- Bun >= 1.0.0
+- macOS: `brew install sqlite` (SQLite extensions)
+- Ensure PATH includes: `$HOME/.bun/bin`
+
+Install Bun (macOS): `brew install oven-sh/bun/bun`
+
+## Install
+
+`bun install -g https://github.com/tobi/qmd`
+
+## Setup
+
+```bash
+qmd collection add /path/to/notes --name notes --mask "**/*.md"
+qmd context add qmd://notes "Description of this collection"  # optional
+qmd embed  # one-time to enable vector + hybrid search
+```
+
+## What it indexes
+
+- Intended for Markdown collections (commonly `**/*.md`).
+- In our testing, "messy" Markdown is fine: chunking is content-based (roughly a few hundred tokens per chunk), not strict heading/structure based.
+- Not a replacement for code search; use code search tools for repositories/source trees.
+
+## Search modes
+
+- `qmd search` (default): fast keyword match (BM25)
+- `qmd vsearch` (last resort): semantic similarity (vector). Often slow due to local LLM work before the vector lookup.
+- `qmd query` (generally skip): hybrid search + LLM reranking. Often slower than `vsearch` and may timeout.
+
+## Performance notes
+
+- `qmd search` is typically instant.
+- `qmd vsearch` can be ~1 minute on some machines because query expansion may load a local model (e.g., Qwen3-1.7B) into memory per run; the vector lookup itself is usually fast.
+- `qmd query` adds LLM reranking on top of `vsearch`, so it can be even slower and less reliable for interactive use.
+- If you need repeated semantic searches, consider keeping the process/model warm (e.g., a long-lived qmd/MCP server mode if available in your setup) rather than invoking a cold-start LLM each time.
+
+## Common commands
+
+```bash
+qmd search "query"             # default
+qmd vsearch "query"
+qmd query "query"
+qmd search "query" -c notes     # Search specific collection
+qmd search "query" -n 10        # More results
+qmd search "query" --json       # JSON output
+qmd search "query" --all --files --min-score 0.3
+```
+
+## Useful options
+
+- `-n <num>`: number of results
+- `-c, --collection <name>`: restrict to a collection
+- `--all --min-score <num>`: return all matches above a threshold
+- `--json` / `--files`: agent-friendly output formats
+- `--full`: return full document content
+
+## Retrieve
+
+```bash
+qmd get "path/to/file.md"       # Full document
+qmd get "#docid"                # By ID from search results
+qmd multi-get "journals/2025-05*.md"
+qmd multi-get "doc1.md, doc2.md, #abc123" --json
+```
+
+## Maintenance
+
+```bash
+qmd status                      # Index health
+qmd update                      # Re-index changed files
+qmd embed                       # Update embeddings
+```
+
+## Keeping the index fresh
+
+Automate indexing so results stay current as you add/edit notes.
+
+- For keyword search (`qmd search`), `qmd update` is usually enough (fast).
+- If you rely on semantic/hybrid search (`vsearch`/`query`), you may also want `qmd embed`, but it can be slow.
+
+Example schedules (cron):
+
+```bash
+# Hourly incremental updates (keeps BM25 fresh):
+0 * * * * export PATH="$HOME/.bun/bin:$PATH" && qmd update
+
+# Optional: nightly embedding refresh (can be slow):
+0 5 * * * export PATH="$HOME/.bun/bin:$PATH" && qmd embed
+```
+
+If your Clawdbot/agent environment supports a built-in scheduler, you can run the same commands there instead of system cron.
+
+## Models and cache
+
+- Uses local GGUF models; first run auto-downloads them.
+- Default cache: `~/.cache/qmd/models/` (override with `XDG_CACHE_HOME`).
+
+## Relationship to Clawdbot memory search
+
+- `qmd` searches *your local files* (notes/docs) that you explicitly index into collections.
+- Clawdbot's `memory_search` searches *agent memory* (saved facts/context from prior interactions).
+- Use both: `memory_search` for "what did we decide/learn before?", `qmd` for "what's in my notes/docs on disk?".

package/dist/skills/bundled/qrcoin/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: qrcoin
+description: "Participate in QR Coin auctions on Base - bid to display URLs on QR codes"
+command: qr
+emoji: "📱"
+gates:
+  envs:
+    - PRIVATE_KEY
+---
+
+# QR Coin Auction
+
+Participate in [QR Coin](https://qrcoin.fun) auctions on Base blockchain. Bid to display URLs on QR codes.
+
+## Contracts (Base)
+
+| Contract | Address |
+|----------|---------|
+| QR Auction | `0x7309779122069EFa06ef71a45AE0DB55A259A176` |
+| USDC | `0x833589fCD6eDb6E08f4c7c32D4f71b54bdA02913` |
+
+## How It Works
+
+1. Each auction runs ~24 hours
+2. Bidders submit URLs with USDC
+3. Creating a new bid: ~11.11 USDC
+4. Contributing to existing bid: ~1.00 USDC
+5. Highest bid wins; winner's URL encoded in QR code
+
+## Commands
+
+### Status
+```
+/qr status                       Current auction info
+/qr bids                         List active bids
+/qr reserves                     Check reserve prices
+```
+
+### Bidding
+```
+/qr bid <url> <name>             Create new bid (~11 USDC)
+/qr contribute <url> <name>      Contribute to existing bid (~1 USDC)
+/qr approve <amount>             Approve USDC for bidding
+```
+
+## Examples
+
+```
+/qr status
+/qr bid https://mysite.com "MyProject"
+/qr contribute https://mysite.com "MyProject"
+```
+
+## Setup
+
+```bash
+export PRIVATE_KEY="0x..."  # Your wallet key
+```
+
+Requires USDC on Base for bidding.

package/dist/skills/bundled/qrcoin/index.d.ts

@@ -50,9 +50,6 @@ declare const _default: {
     name: string;
     description: string;
     commands: string[];
-    requires: {
-        env: string[];
-    };
     handle: typeof execute;
     tools: ({
         name: string;

package/dist/skills/bundled/qrcoin/index.js

@@ -321,7 +321,6 @@ exports.default = {
     name: 'qrcoin',
     description: 'QR Coin auctions on Base - bid, check status, and manage QR code NFTs',
     commands: ['/qrcoin'],
-    requires: { env: ['PRIVATE_KEY'] },
     handle: execute,
     tools: exports.tools,
 };