clodds 1.2.9 → 1.3.0

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

@@ -0,0 +1,433 @@
+---
+name: triggers
+description: "Conditional orders that auto-execute when price thresholds are met"
+emoji: "⚡"
+---
+
+# Triggers - Complete API Reference
+
+Set up conditional orders that automatically execute trades when price conditions are met. Works across prediction markets, futures, and crypto spot.
+
+---
+
+## Chat Commands
+
+### Create Trigger Orders
+
+```
+/trigger buy poly "Trump 2028" YES below 0.40 size 100
+/trigger buy poly "Fed rate" NO above 0.60 size 50
+/trigger sell poly "Trump 2028" YES above 0.55 size all
+```
+
+### Futures Triggers
+
+```
+/trigger long binance BTCUSDT below 95000 size 0.1 leverage 10x
+/trigger short binance ETHUSDT above 4000 size 1 leverage 20x
+/trigger close binance BTCUSDT above 105000
+```
+
+### Crypto Spot Triggers
+
+```
+/trigger buy sol SOL below 180 size 100usdc
+/trigger sell eth ETH above 4000 size 0.5
+/trigger swap arb USDC to ARB below 1.50 size 500
+```
+
+### Manage Triggers
+
+```
+/triggers                        List all active triggers
+/triggers pending                Show pending only
+/triggers history                Triggered order history
+/trigger cancel <id>             Cancel trigger
+/trigger cancel all              Cancel all triggers
+```
+
+### Stop-Loss & Take-Profit
+
+```
+/sl poly "Trump" at 0.35         Stop-loss on position
+/tp poly "Trump" at 0.65         Take-profit on position
+/trailing-stop poly "Trump" 10%  Trailing stop (% from high)
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Trigger Service
+
+```typescript
+import { createTriggerService } from 'clodds/triggers';
+
+const triggers = createTriggerService({
+  // Price monitoring
+  checkIntervalMs: 5000,  // Check every 5 seconds
+
+  // Execution
+  maxSlippagePercent: 2,
+  retryAttempts: 3,
+
+  // Storage
+  storage: 'sqlite',
+  dbPath: './triggers.db',
+});
+
+// Start monitoring
+await triggers.start();
+```
+
+### Create Prediction Market Trigger
+
+```typescript
+// Buy YES when price drops below threshold
+const trigger = await triggers.create({
+  type: 'entry',
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+  direction: 'below',
+  triggerPrice: 0.40,
+  size: 100,  // $100
+  orderType: 'limit',  // 'market' | 'limit'
+  limitPrice: 0.41,    // Optional: max price for limit
+});
+
+console.log(`Trigger ID: ${trigger.id}`);
+console.log(`Status: ${trigger.status}`);  // 'pending'
+
+// Sell when price rises above threshold
+await triggers.create({
+  type: 'exit',
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+  direction: 'above',
+  triggerPrice: 0.55,
+  size: 'all',  // Sell entire position
+});
+```
+
+### Create Futures Trigger
+
+```typescript
+// Long entry when BTC drops below support
+await triggers.create({
+  type: 'entry',
+  platform: 'binance',
+  symbol: 'BTCUSDT',
+  side: 'long',
+  direction: 'below',
+  triggerPrice: 95000,
+  size: 0.1,
+  leverage: 10,
+
+  // Auto-set SL/TP on fill
+  stopLoss: 93000,
+  takeProfit: 105000,
+});
+
+// Short entry when ETH breaks above resistance
+await triggers.create({
+  type: 'entry',
+  platform: 'bybit',
+  symbol: 'ETHUSDT',
+  side: 'short',
+  direction: 'above',
+  triggerPrice: 4000,
+  size: 1,
+  leverage: 20,
+});
+
+// Close position when price target hit
+await triggers.create({
+  type: 'exit',
+  platform: 'binance',
+  symbol: 'BTCUSDT',
+  direction: 'above',
+  triggerPrice: 105000,
+  size: 'all',
+});
+```
+
+### Create Crypto Spot Trigger
+
+```typescript
+// Buy SOL when price drops
+await triggers.create({
+  type: 'entry',
+  platform: 'jupiter',  // Solana DEX
+  tokenIn: 'USDC',
+  tokenOut: 'SOL',
+  direction: 'below',
+  triggerPrice: 180,
+  size: 100,  // 100 USDC
+  slippagePercent: 1,
+});
+
+// Sell ETH when price rises
+await triggers.create({
+  type: 'exit',
+  platform: 'uniswap',  // EVM DEX
+  chain: 'ethereum',
+  tokenIn: 'ETH',
+  tokenOut: 'USDC',
+  direction: 'above',
+  triggerPrice: 4000,
+  size: 0.5,
+});
+```
+
+### Stop-Loss & Take-Profit
+
+```typescript
+// Set stop-loss on existing position
+await triggers.setStopLoss({
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+  triggerPrice: 0.35,
+  size: 'all',
+});
+
+// Set take-profit
+await triggers.setTakeProfit({
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+  triggerPrice: 0.65,
+  size: 'all',
+});
+
+// Trailing stop (follows price up, triggers on pullback)
+await triggers.setTrailingStop({
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+  trailPercent: 10,  // Trigger if drops 10% from high
+  size: 'all',
+});
+```
+
+### Multi-Condition Triggers
+
+```typescript
+// Trigger only when multiple conditions met
+await triggers.create({
+  type: 'entry',
+  platform: 'polymarket',
+  market: 'will-trump-win-2028',
+  side: 'YES',
+
+  conditions: [
+    { type: 'price', direction: 'below', value: 0.40 },
+    { type: 'volume24h', direction: 'above', value: 100000 },
+    { type: 'spread', direction: 'below', value: 0.02 },
+  ],
+
+  // All conditions must be true
+  conditionLogic: 'AND',  // 'AND' | 'OR'
+
+  size: 100,
+});
+```
+
+### One-Cancels-Other (OCO)
+
+```typescript
+// OCO: Either SL or TP triggers, other cancels
+const oco = await triggers.createOCO({
+  platform: 'binance',
+  symbol: 'BTCUSDT',
+
+  stopLoss: {
+    direction: 'below',
+    triggerPrice: 93000,
+    size: 'all',
+  },
+
+  takeProfit: {
+    direction: 'above',
+    triggerPrice: 105000,
+    size: 'all',
+  },
+});
+```
+
+### List & Manage Triggers
+
+```typescript
+// List all triggers
+const all = await triggers.list();
+
+for (const t of all) {
+  console.log(`${t.id}: ${t.platform} ${t.market || t.symbol}`);
+  console.log(`  ${t.direction} ${t.triggerPrice}`);
+  console.log(`  Status: ${t.status}`);
+  console.log(`  Created: ${t.createdAt}`);
+}
+
+// Get pending only
+const pending = await triggers.list({ status: 'pending' });
+
+// Get history (triggered)
+const history = await triggers.list({ status: 'triggered' });
+
+// Cancel trigger
+await triggers.cancel(triggerId);
+
+// Cancel all
+await triggers.cancelAll();
+```
+
+### Event Handlers
+
+```typescript
+// Trigger activated
+triggers.on('triggered', async (trigger, result) => {
+  console.log(`Trigger ${trigger.id} activated!`);
+  console.log(`Order: ${result.orderId}`);
+  console.log(`Fill price: ${result.fillPrice}`);
+  console.log(`Size: ${result.filledSize}`);
+});
+
+// Trigger failed
+triggers.on('failed', (trigger, error) => {
+  console.error(`Trigger ${trigger.id} failed: ${error.message}`);
+});
+
+// Price approaching trigger
+triggers.on('approaching', (trigger, currentPrice) => {
+  console.log(`Price ${currentPrice} approaching trigger at ${trigger.triggerPrice}`);
+});
+```
+
+---
+
+## Supported Platforms
+
+### Prediction Markets
+
+| Platform | Entry Triggers | Exit Triggers | SL/TP |
+|----------|---------------|---------------|-------|
+| **Polymarket** | ✓ | ✓ | ✓ |
+| **Kalshi** | ✓ | ✓ | ✓ |
+| **Manifold** | ✓ | ✓ | ✓ |
+
+### Futures
+
+| Platform | Entry Triggers | Native Triggers | SL/TP |
+|----------|---------------|-----------------|-------|
+| **Binance** | ✓ | ✓ | ✓ |
+| **Bybit** | ✓ | ✓ | ✓ |
+| **MEXC** | ✓ | ✓ Native | ✓ |
+| **Hyperliquid** | ✓ | ✓ | ✓ |
+
+### Crypto Spot
+
+| Platform | Entry Triggers | Exit Triggers |
+|----------|---------------|---------------|
+| **Jupiter** (Solana) | ✓ | ✓ |
+| **Raydium** | ✓ | ✓ |
+| **Uniswap** (EVM) | ✓ | ✓ |
+| **1inch** (EVM) | ✓ | ✓ |
+
+---
+
+## Trigger Types
+
+| Type | Description |
+|------|-------------|
+| **entry** | Open new position when triggered |
+| **exit** | Close position when triggered |
+| **stop-loss** | Exit to limit losses |
+| **take-profit** | Exit to lock in gains |
+| **trailing-stop** | Dynamic stop that follows price |
+| **oco** | One-cancels-other (SL + TP pair) |
+
+---
+
+## Price Sources
+
+| Platform | Price Source |
+|----------|-------------|
+| Polymarket | WebSocket mid price |
+| Kalshi | REST API best bid/ask |
+| Binance | WebSocket mark price |
+| Bybit | WebSocket last price |
+| Jupiter | On-chain oracle |
+
+---
+
+## Examples
+
+### Prediction Market Strategy
+
+```typescript
+// Buy the dip, sell the rip
+await triggers.create({
+  platform: 'polymarket',
+  market: 'trump-2028',
+  side: 'YES',
+  direction: 'below',
+  triggerPrice: 0.40,
+  size: 200,
+});
+
+await triggers.create({
+  platform: 'polymarket',
+  market: 'trump-2028',
+  side: 'YES',
+  direction: 'above',
+  triggerPrice: 0.55,
+  size: 'all',
+});
+```
+
+### Futures Breakout Strategy
+
+```typescript
+// Enter long on breakout above resistance
+await triggers.create({
+  platform: 'binance',
+  symbol: 'BTCUSDT',
+  side: 'long',
+  direction: 'above',
+  triggerPrice: 100000,
+  size: 0.5,
+  leverage: 10,
+  stopLoss: 98000,
+  takeProfit: 110000,
+});
+```
+
+### DCA on Dips
+
+```typescript
+// Buy more as price drops
+const levels = [180, 170, 160, 150];
+for (const price of levels) {
+  await triggers.create({
+    platform: 'jupiter',
+    tokenOut: 'SOL',
+    tokenIn: 'USDC',
+    direction: 'below',
+    triggerPrice: price,
+    size: 50,  // $50 at each level
+  });
+}
+```
+
+---
+
+## Best Practices
+
+1. **Use limit orders** — Avoid slippage on triggers
+2. **Set expiration** — Don't leave triggers forever
+3. **Monitor execution** — Check fill prices
+4. **Use OCO for exits** — SL + TP together
+5. **Test with small size** — Verify triggers work
+6. **Account for fees** — Include in trigger price

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

@@ -0,0 +1,220 @@
+---
+name: tts
+description: "Text-to-speech synthesis with ElevenLabs and system voices"
+emoji: "🔊"
+gates:
+  envs:
+    anyOf:
+      - ELEVENLABS_API_KEY
+---
+
+# TTS (Text-to-Speech) - Complete API Reference
+
+Convert text to natural-sounding speech using ElevenLabs, macOS say, or espeak.
+
+---
+
+## Chat Commands
+
+### Synthesize Speech
+
+```
+/speak "Your order has been filled"         Speak text aloud
+/speak "Market alert" --voice rachel        Use specific voice
+/speak "Portfolio up 5%" --speed 1.2        Adjust speed
+```
+
+### Voice Management
+
+```
+/voices                                     List available voices
+/voices preview rachel                      Preview a voice
+/voice set rachel                           Set default voice
+```
+
+### Settings
+
+```
+/tts status                                 Check TTS status
+/tts provider elevenlabs                    Set provider
+/tts speed 1.0                              Set default speed
+/tts volume 0.8                             Set volume (0-1)
+```
+
+---
+
+## TypeScript API Reference
+
+### Create TTS Service
+
+```typescript
+import { createTTSService } from 'clodds/tts';
+
+const tts = createTTSService({
+  provider: 'elevenlabs',
+  apiKey: process.env.ELEVENLABS_API_KEY,
+
+  // Defaults
+  defaultVoice: 'rachel',
+  defaultSpeed: 1.0,
+  defaultPitch: 1.0,
+});
+```
+
+### Synthesize Speech
+
+```typescript
+// Basic synthesis
+const audio = await tts.synthesize('Hello, your trade was executed.');
+
+// Play immediately
+await tts.speak('Portfolio value is $10,000');
+
+// With options
+await tts.speak('Market alert: BTC crossed $100k', {
+  voice: 'josh',
+  speed: 1.2,
+  pitch: 1.0,
+  volume: 0.8,
+});
+```
+
+### Streaming Synthesis
+
+```typescript
+// Stream for long text (lower latency)
+const stream = await tts.streamSynthesize(longText, {
+  voice: 'rachel',
+});
+
+stream.on('data', (chunk) => {
+  // Play audio chunks as they arrive
+  audioPlayer.write(chunk);
+});
+
+stream.on('end', () => {
+  console.log('Synthesis complete');
+});
+```
+
+### List Voices
+
+```typescript
+// Get available voices
+const voices = await tts.listVoices();
+
+for (const voice of voices) {
+  console.log(`${voice.id}: ${voice.name}`);
+  console.log(`  Gender: ${voice.gender}`);
+  console.log(`  Accent: ${voice.accent}`);
+  console.log(`  Use case: ${voice.useCase}`);
+}
+```
+
+### Voice Preview
+
+```typescript
+// Preview a voice
+await tts.preview('rachel', 'This is a preview of the Rachel voice.');
+```
+
+### Queue Management
+
+```typescript
+// Queue multiple messages
+tts.queue('First message');
+tts.queue('Second message');
+tts.queue('Third message');
+
+// Messages play in order
+
+// Clear queue
+tts.clearQueue();
+
+// Skip current
+tts.skip();
+```
+
+---
+
+## ElevenLabs Voices
+
+| Voice ID | Name | Gender | Accent | Best For |
+|----------|------|--------|--------|----------|
+| `rachel` | Rachel | F | American | Narration |
+| `domi` | Domi | F | American | Conversational |
+| `bella` | Bella | F | American | Soft, gentle |
+| `antoni` | Antoni | M | American | Narration |
+| `josh` | Josh | M | American | Deep, authoritative |
+| `arnold` | Arnold | M | American | Gruff, character |
+| `adam` | Adam | M | American | Deep, narration |
+| `sam` | Sam | M | American | Raspy, character |
+
+---
+
+## Providers
+
+| Provider | Quality | Latency | Cost | Setup |
+|----------|---------|---------|------|-------|
+| **ElevenLabs** | Premium | ~500ms | $5/100k chars | API key |
+| **say** (macOS) | Good | ~100ms | Free | Built-in |
+| **espeak** | Basic | ~50ms | Free | Install |
+
+### Provider Configuration
+
+```typescript
+// ElevenLabs (best quality)
+const tts = createTTSService({
+  provider: 'elevenlabs',
+  apiKey: process.env.ELEVENLABS_API_KEY,
+});
+
+// macOS say (free, local)
+const tts = createTTSService({
+  provider: 'say',
+  defaultVoice: 'Samantha',  // macOS voice
+});
+
+// espeak (cross-platform, free)
+const tts = createTTSService({
+  provider: 'espeak',
+  defaultVoice: 'en-us',
+});
+```
+
+---
+
+## Audio Output
+
+```typescript
+// Set output device
+tts.setOutputDevice('Built-in Speakers');
+
+// Get available devices
+const devices = await tts.listOutputDevices();
+```
+
+---
+
+## SSML Support (ElevenLabs)
+
+```typescript
+// Use SSML for advanced control
+await tts.speak(`
+  <speak>
+    <prosody rate="slow">Important alert:</prosody>
+    <break time="500ms"/>
+    Your stop loss was triggered.
+  </speak>
+`, { ssml: true });
+```
+
+---
+
+## Best Practices
+
+1. **Use streaming** — For long text, reduces time to first audio
+2. **Cache common phrases** — "Order filled", "Alert triggered"
+3. **Adjust speed** — Faster for alerts, slower for details
+4. **Queue management** — Don't overlap important messages
+5. **Fallback provider** — Use say/espeak if ElevenLabs unavailable

package/dist/skills/bundled/tweet-ideas/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: tweet-ideas
+description: "Generate tweet ideas from trends and project updates"
+command: tweets
+emoji: "💭"
+---
+
+# Tweet Ideas Generator
+
+Generate tweet ideas from market trends OR your project's latest developments.
+
+## Commands
+
+```
+/tweets generate [topic]             Generate from trends/topic
+/tweets spicy                        Contrarian/provocative takes
+/tweets project <path>               Generate about project updates
+/tweets changelog <path>             Announce latest changelog entries
+/tweets feature <description>        Announce a specific feature
+/tweets launch <path>                Generate launch thread
+/tweets style <description>          Set your voice/style
+/tweets trends                       Show what's trending to riff on
+/tweets drafts                       View saved ideas
+/tweets save <id>                    Save to drafts
+/tweets clear                        Clear drafts
+```
+
+## Examples
+
+### Set Your Style
+```
+/tweets style "contrarian crypto takes, short punchy sentences, no emojis, slightly unhinged, call out hypocrisy"
+/tweets style "builder sharing wins, technical but accessible, authentic not hype"
+```
+
+### Generate From Trends
+```
+/tweets generate
+/tweets generate "bitcoin etf"
+/tweets spicy
+```
+
+### Project Announcements
+```
+/tweets project /path/to/myproject
+/tweets changelog /path/to/CHANGELOG.md
+/tweets feature "Added SPL token escrow with Pyth oracle conditions"
+/tweets launch /path/to/myproject
+```
+
+## How It Works
+
+### Trend Mode
+- Pulls from crypto news feeds, market data, social signals
+- Generates takes in your style
+- `/tweets spicy` deliberately goes contrarian
+
+### Project Mode
+- Reads CHANGELOG.md for latest updates
+- Reads README.md for project description
+- Reads package.json for name/version
+- Generates announcement tweets in your style
+
+### Style Memory
+Your style is saved and persists across sessions. Examples:
+- "degen energy, lowercase, lots of slang"
+- "thoughtful builder, focus on technical details"
+- "provocative, question everything, short sentences"
+
+## Output
+
+Returns 3-5 tweet ideas per generation. Each shows:
+- The tweet text
+- Character count
+- Thread potential (if topic is big)
+
+Save the ones you like with `/tweets save <id>`.