clodds 1.2.9 → 1.3.0

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

@@ -0,0 +1,321 @@
+---
+name: integrations
+description: "External data sources, connectors, and custom data streams"
+emoji: "🔗"
+---
+
+# Integrations - Complete API Reference
+
+Manage external data sources, add custom connectors, and plug in new data streams for trading bots.
+
+---
+
+## Chat Commands
+
+### List Data Sources
+
+```
+/integrations                               List all data sources
+/integrations status                        Show source health
+/integrations sources                       Available source types
+```
+
+### Manage Sources
+
+```
+/integrations enable fedwatch              Enable CME FedWatch
+/integrations disable 538                   Disable FiveThirtyEight
+/integrations add webhook "my-signals"      Add custom webhook source
+/integrations add rest "my-api" <url>       Add REST API source
+/integrations remove <source-id>            Remove data source
+```
+
+### Configure Sources
+
+```
+/integrations config fedwatch              View source config
+/integrations set fedwatch interval 60     Set refresh interval
+/integrations set fedwatch key <api-key>   Set API key
+/integrations test <source-id>             Test source connection
+```
+
+### View Data
+
+```
+/integrations data fedwatch                Latest data from source
+/integrations history <source> --hours 24  Historical data
+/integrations subscribe <source>           Real-time updates
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Integrations Manager
+
+```typescript
+import { createIntegrationsManager } from 'clodds/integrations';
+
+const integrations = createIntegrationsManager({
+  // Storage
+  storage: 'sqlite',
+  dbPath: './integrations.db',
+
+  // Default refresh interval
+  defaultIntervalMs: 60000,
+
+  // Retry settings
+  maxRetries: 3,
+  retryDelayMs: 5000,
+});
+```
+
+### Built-in Data Sources
+
+```typescript
+// Enable built-in sources
+await integrations.enable('fedwatch');     // CME FedWatch
+await integrations.enable('538');          // FiveThirtyEight
+await integrations.enable('silver');       // Silver Bulletin
+await integrations.enable('rcp');          // RealClearPolitics
+await integrations.enable('odds-api');     // The Odds API
+await integrations.enable('polymarket');   // Polymarket prices
+await integrations.enable('kalshi');       // Kalshi prices
+await integrations.enable('binance');      // Binance spot prices
+await integrations.enable('crypto');       // Multi-exchange crypto
+```
+
+### Add Custom Webhook Source
+
+```typescript
+// Add webhook to receive custom signals
+const source = await integrations.addWebhook({
+  name: 'my-signals',
+  description: 'Custom trading signals',
+
+  // Webhook config
+  path: '/webhooks/my-signals',
+  secret: process.env.WEBHOOK_SECRET,
+
+  // Data schema (optional validation)
+  schema: {
+    type: 'object',
+    properties: {
+      signal: { type: 'string', enum: ['BUY', 'SELL', 'HOLD'] },
+      symbol: { type: 'string' },
+      confidence: { type: 'number', min: 0, max: 1 },
+    },
+    required: ['signal', 'symbol'],
+  },
+
+  // Transform incoming data
+  transform: (payload) => ({
+    signal: payload.signal,
+    symbol: payload.symbol,
+    confidence: payload.confidence || 0.5,
+    timestamp: Date.now(),
+  }),
+});
+
+console.log(`Webhook URL: ${source.url}`);
+// POST to: https://your-domain.com/webhooks/my-signals
+```
+
+### Add Custom REST Source
+
+```typescript
+// Add REST API data source
+const source = await integrations.addRest({
+  name: 'my-api',
+  description: 'Custom price API',
+
+  // API config
+  url: 'https://api.example.com/prices',
+  method: 'GET',
+  headers: {
+    'Authorization': `Bearer ${process.env.MY_API_KEY}`,
+  },
+
+  // Polling interval
+  intervalMs: 30000,
+
+  // Transform response
+  transform: (response) => ({
+    price: response.data.price,
+    volume: response.data.volume,
+    timestamp: Date.now(),
+  }),
+});
+```
+
+### Add WebSocket Source
+
+```typescript
+// Add WebSocket data source
+const source = await integrations.addWebSocket({
+  name: 'live-prices',
+  description: 'Real-time price feed',
+
+  // WebSocket config
+  url: 'wss://stream.example.com/prices',
+
+  // Message handlers
+  onMessage: (data) => ({
+    type: 'price',
+    symbol: data.s,
+    price: parseFloat(data.p),
+    timestamp: data.t,
+  }),
+
+  // Subscription message
+  subscribe: {
+    method: 'SUBSCRIBE',
+    params: ['btcusdt@trade'],
+  },
+
+  // Reconnect settings
+  reconnect: true,
+  reconnectIntervalMs: 5000,
+});
+```
+
+### Subscribe to Data
+
+```typescript
+// Subscribe to real-time updates
+integrations.subscribe('my-signals', (data) => {
+  console.log(`Signal: ${data.signal} ${data.symbol}`);
+  console.log(`Confidence: ${data.confidence}`);
+
+  if (data.signal === 'BUY' && data.confidence > 0.8) {
+    // Execute trade logic
+  }
+});
+
+// Subscribe to multiple sources
+integrations.subscribeAll(['fedwatch', 'crypto', 'my-signals'], (source, data) => {
+  console.log(`[${source}] ${JSON.stringify(data)}`);
+});
+```
+
+### Get Latest Data
+
+```typescript
+// Get current data from source
+const fedData = await integrations.getData('fedwatch');
+
+console.log('Fed Rate Probabilities:');
+for (const meeting of fedData.meetings) {
+  console.log(`${meeting.date}: ${meeting.probabilities}`);
+}
+
+// Get with freshness check
+const data = await integrations.getData('crypto', {
+  maxAgeMs: 60000,  // Refetch if older than 60s
+});
+```
+
+### Check Status
+
+```typescript
+// Get source status
+const status = await integrations.getStatus('my-api');
+
+console.log(`Status: ${status.status}`);  // 'healthy' | 'degraded' | 'error'
+console.log(`Last fetch: ${status.lastFetch}`);
+console.log(`Last error: ${status.lastError}`);
+console.log(`Fetch count: ${status.fetchCount}`);
+console.log(`Error count: ${status.errorCount}`);
+
+// Get all statuses
+const all = await integrations.getAllStatuses();
+```
+
+---
+
+## Built-in Data Sources
+
+| Source | Type | Data | Refresh |
+|--------|------|------|---------|
+| **fedwatch** | REST | Fed rate probabilities | 5 min |
+| **538** | REST | Election forecasts | 1 hour |
+| **silver** | REST | Silver Bulletin forecasts | 1 hour |
+| **rcp** | REST | Polling averages | 15 min |
+| **odds-api** | REST | Sports betting odds | 1 min |
+| **polymarket** | WebSocket | Market prices | Real-time |
+| **kalshi** | WebSocket | Market prices | Real-time |
+| **binance** | WebSocket | Crypto prices | Real-time |
+
+---
+
+## Custom Source Types
+
+| Type | Best For | Latency |
+|------|----------|---------|
+| **webhook** | External signals pushed to you | Instant |
+| **rest** | APIs you poll periodically | Seconds |
+| **websocket** | Real-time streaming data | Milliseconds |
+
+---
+
+## Using Data in Bots
+
+```typescript
+import { createTradingBot } from 'clodds/trading';
+import { createIntegrationsManager } from 'clodds/integrations';
+
+const integrations = createIntegrationsManager();
+const bot = createTradingBot();
+
+// Use custom signals in bot strategy
+integrations.subscribe('my-signals', async (signal) => {
+  if (signal.signal === 'BUY' && signal.confidence > 0.9) {
+    await bot.execute({
+      platform: 'polymarket',
+      market: signal.symbol,
+      side: 'YES',
+      size: 100 * signal.confidence,
+    });
+  }
+});
+
+// Use Fed data for macro bets
+integrations.subscribe('fedwatch', async (data) => {
+  const cutProb = data.meetings[0].probabilities['25bp_cut'];
+  if (cutProb > 0.8) {
+    // High probability of rate cut
+    await bot.execute({
+      platform: 'kalshi',
+      market: 'fed-rate-cut',
+      side: 'YES',
+      size: 500,
+    });
+  }
+});
+```
+
+---
+
+## Environment Variables
+
+```bash
+# Built-in sources
+CME_FEDWATCH_API_KEY=your-key
+FIVETHIRTYEIGHT_API_KEY=your-key
+ODDS_API_KEY=your-key
+
+# Custom sources
+MY_SIGNALS_WEBHOOK_SECRET=your-secret
+MY_API_KEY=your-key
+```
+
+---
+
+## Best Practices
+
+1. **Validate incoming data** — Use schemas for webhooks
+2. **Set appropriate intervals** — Don't poll too frequently
+3. **Handle errors gracefully** — Sources will fail sometimes
+4. **Monitor freshness** — Alert on stale data
+5. **Transform consistently** — Normalize data formats
+6. **Use WebSocket for latency** — When milliseconds matter

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

@@ -116,8 +116,8 @@ async function execute(args) {
                 return helpText();
         }
     }
-    catch {
-        return helpText();
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
 function helpText() {

package/dist/skills/bundled/integrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/integrations/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/integrations/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,163 @@
+---
+name: jupiter
+description: "Jupiter DEX aggregator - swaps, limit orders, and DCA on Solana"
+command: jup
+emoji: "🪐"
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Jupiter Aggregator
+
+Jupiter finds the best swap routes across all Solana DEXes, plus limit orders and DCA (Dollar Cost Averaging).
+
+## Commands
+
+### Swaps
+```
+/jup swap <amount> <from> to <to>    Execute swap via Jupiter
+/jup quote <amount> <from> to <to>   Get quote without executing
+/jup route <from> <to> <amount>      Show detailed route info
+```
+
+### Limit Orders
+```
+/jup limit create <sell> <from> for <buy> <to>   Create limit order
+/jup limit cancel <order_pubkey>                  Cancel limit order
+/jup limit list                                   List your open orders
+/jup limit history                                Order history
+```
+
+### DCA (Dollar Cost Averaging)
+```
+/jup dca create <total> <from> to <to> every <interval>   Create DCA
+/jup dca close <dca_pubkey>                               Close DCA
+/jup dca list                                             List active DCAs
+/jup dca deposit <dca_pubkey> <amount>                    Add funds
+/jup dca withdraw <dca_pubkey>                            Withdraw funds
+```
+
+## Examples
+
+### Swaps
+```
+/jup swap 1 SOL to USDC
+/jup quote 100 USDC to JUP
+/jup route SOL BONK 1
+```
+
+### Limit Orders
+```
+/jup limit create 1 SOL for 250 USDC        # Sell 1 SOL when price hits $250
+/jup limit create 100 USDC for 0.5 SOL      # Buy SOL at $200
+/jup limit list
+/jup limit cancel ABC123...
+```
+
+### DCA
+```
+/jup dca create 10 SOL to USDC every 1 day   # DCA 10 SOL into USDC daily
+/jup dca create 1000 USDC to JUP every 1 hour # Accumulate JUP hourly
+/jup dca list
+/jup dca close XYZ789...
+```
+
+## Features
+
+- Best route across 20+ DEXes
+- Automatic route splitting
+- MEV protection
+- Priority fee support
+- **Limit Orders** - set target prices
+- **DCA** - automated periodic swaps
+
+## Tools Available
+
+### Swap Tools
+| Tool | Description |
+|------|-------------|
+| `solana_jupiter_swap` | Execute swap |
+| `solana_jupiter_quote` | Get quote (no execution) |
+
+### Limit Order Tools
+| Tool | Description |
+|------|-------------|
+| `solana_jupiter_limit_order_create` | Create limit order |
+| `solana_jupiter_limit_order_cancel` | Cancel order |
+| `solana_jupiter_limit_orders_list` | List open orders |
+| `solana_jupiter_limit_order_get` | Get order details |
+| `solana_jupiter_limit_order_history` | Order history |
+| `solana_jupiter_trade_history` | Trade fill history |
+
+### DCA Tools
+| Tool | Description |
+|------|-------------|
+| `solana_jupiter_dca_create` | Create DCA order |
+| `solana_jupiter_dca_close` | Close DCA |
+| `solana_jupiter_dca_deposit` | Add funds |
+| `solana_jupiter_dca_withdraw` | Withdraw funds |
+| `solana_jupiter_dca_list` | List active DCAs |
+| `solana_jupiter_dca_get` | Get DCA details |
+| `solana_jupiter_dca_balance` | Check balances |
+| `solana_jupiter_dca_fills` | Fill history |
+
+## TypeScript API
+
+```typescript
+import {
+  // Swaps
+  executeJupiterSwap,
+  getJupiterQuote,
+
+  // Limit Orders
+  createJupiterLimitOrder,
+  cancelJupiterLimitOrder,
+  listJupiterLimitOrders,
+  getJupiterLimitOrder,
+  getJupiterLimitOrderHistory,
+  getJupiterTradeHistory,
+
+  // DCA
+  createJupiterDCA,
+  closeJupiterDCA,
+  depositJupiterDCA,
+  withdrawJupiterDCA,
+  listJupiterDCAs,
+  getJupiterDCA,
+  getJupiterDCABalance,
+  getJupiterDCAFillHistory,
+} from 'clodds/solana/jupiter';
+
+// Swap example
+const swap = await executeJupiterSwap(connection, keypair, {
+  inputMint: 'So11111111111111111111111111111111111111112',
+  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  amount: '1000000000', // 1 SOL
+  slippageBps: 50,
+});
+
+// Limit order example
+const order = await createJupiterLimitOrder(connection, keypair, {
+  inputMint: 'So11111111111111111111111111111111111111112',
+  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  inAmount: '1000000000',   // Sell 1 SOL
+  outAmount: '250000000',   // For 250 USDC (min)
+});
+
+// DCA example
+const dca = await createJupiterDCA(connection, keypair, {
+  inputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  outputMint: 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
+  inAmount: '100000000',           // Total 100 USDC
+  inAmountPerCycle: '10000000',    // 10 USDC per swap
+  cycleSecondsApart: 3600,         // Every hour
+});
+```
+
+## Environment Variables
+
+```bash
+SOLANA_PRIVATE_KEY=<base58 or JSON array>
+SOLANA_RPC_URL=https://api.mainnet-beta.solana.com  # optional
+```

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

@@ -0,0 +1,69 @@
+---
+name: kamino
+description: "Kamino Finance — Solana lending, borrowing, and liquidity vaults"
+emoji: "🌀"
+commands:
+  - /kamino
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Kamino Finance
+
+Kamino is Solana's largest lending protocol and liquidity vault provider. Deposit collateral, borrow assets, provide liquidity to automated vaults, and monitor health to avoid liquidation.
+
+## Commands
+
+### Lending
+```
+/kamino deposit <amount> <token>          Deposit collateral
+/kamino withdraw <amount|all> <token>     Withdraw collateral
+/kamino borrow <amount> <token>           Borrow assets
+/kamino repay <amount|all> <token>        Repay borrowed assets
+/kamino obligation                        View your positions
+/kamino health                            Check health factor & liquidation risk
+/kamino reserves                          List available reserves with rates
+/kamino rates                             View supply/borrow APYs
+```
+
+### Liquidity Vaults
+```
+/kamino strategies                        List all vault strategies
+/kamino strategy <address>                Get strategy details
+/kamino vault-deposit <strat> <amtA> [amtB]  Deposit to vault
+/kamino vault-withdraw <strat> [shares|all]  Withdraw from vault
+/kamino shares                            View your vault shares
+/kamino share-price <strategy>            Get strategy share price
+```
+
+### Info
+```
+/kamino markets                           List lending markets
+```
+
+## Examples
+
+```
+/kamino deposit 100 USDC
+/kamino borrow 50 SOL
+/kamino health
+/kamino repay all SOL
+/kamino rates
+/kamino strategies
+/kamino vault-deposit ABC123... 1000 500
+```
+
+## Configuration
+
+```bash
+export SOLANA_PRIVATE_KEY="your-base58-private-key"
+export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"  # Optional
+```
+
+## See Also
+
+- `/marginfi` — MarginFi lending protocol
+- `/solend` — Solend lending protocol
+- `/jup` — Jupiter DEX aggregator
+- `/bags` — Portfolio overview

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

@@ -0,0 +1,20 @@
+---
+name: ledger
+description: "Trade decision audit trail and statistics"
+command: ledger
+emoji: "📒"
+---
+
+# Ledger
+
+Decision audit trail and performance statistics for all trading decisions.
+
+## Commands
+
+```
+/ledger list [n] [category]    View recent decisions (with optional filters)
+/ledger get <id>               Show detailed decision information
+/ledger stats [period]         Decision statistics (24h, 7d, 30d, 90d, all)
+/ledger calibration            Confidence accuracy analysis
+/ledger help                   Show help
+```

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

@@ -0,0 +1,83 @@
+---
+name: lighter
+description: "Lighter — Orderbook DEX on Arbitrum"
+emoji: "⚡"
+commands:
+  - /lighter
+gates:
+  envs:
+    - EVM_PRIVATE_KEY
+---
+
+# Lighter
+
+On-chain orderbook DEX on Arbitrum. Trade perpetual futures with deep liquidity and low fees.
+
+## Quick Start
+
+```bash
+# Set credentials
+export EVM_PRIVATE_KEY="0x..."
+
+# Check markets
+/lighter markets
+
+# Get price
+/lighter price ETH-USD
+
+# Open positions
+/lighter long ETH-USD 1
+/lighter short BTC-USD 0.1 45000
+```
+
+## Commands
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/lighter markets` | List available markets |
+| `/lighter price <market>` | Get current price |
+| `/lighter book <market>` | Show orderbook depth |
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/lighter balance` | Show balances |
+| `/lighter positions` | Show open positions |
+| `/lighter orders` | List open orders |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/lighter long <market> <size> [price]` | Open long position |
+| `/lighter short <market> <size> [price]` | Open short position |
+| `/lighter close <market>` | Close position |
+| `/lighter closeall` | Close all positions |
+| `/lighter cancel <orderId>` | Cancel order |
+| `/lighter cancelall` | Cancel all orders |
+
+**Examples:**
+```bash
+/lighter long ETH-USD 1           # Market long 1 ETH
+/lighter long ETH-USD 1 3000      # Limit long at $3,000
+/lighter short BTC-USD 0.1        # Market short 0.1 BTC
+/lighter close ETH-USD            # Close ETH position
+```
+
+## Configuration
+
+```bash
+# Required
+export EVM_PRIVATE_KEY="0x..."
+
+# Optional
+export DRY_RUN=true
+```
+
+## Resources
+
+- [Lighter App](https://app.lighter.xyz)
+- [Lighter Docs](https://docs.lighter.xyz)

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

@@ -11,9 +11,6 @@ export declare const skill: {
         description: string;
         usage: string;
     }[];
-    requires: {
-        env: string[];
-    };
     handler(args: string): Promise<string>;
 };
 export default skill;