clodds 1.2.8 → 1.3.0

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

@@ -0,0 +1,82 @@
+---
+name: virtuals
+description: "Virtuals Protocol AI Agent marketplace (Base chain)"
+emoji: "🤖"
+commands:
+  - /virt
+---
+
+# Virtuals Protocol
+
+Integration with Virtuals Protocol, an AI Agent marketplace on Base chain. View agents, prices, and bonding curve data.
+
+## Quick Start
+
+```bash
+# Search agents
+/virt search luna
+
+# Get agent details
+/virt agent <id>
+
+# Trending agents
+/virt trending
+
+# New agents
+/virt new
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/virt search [query]` | Search agents |
+| `/virt agent <id>` | Get agent details |
+| `/virt agents` | List all agents |
+| `/virt trending` | Trending agents (by volume) |
+| `/virt new` | Recently launched agents |
+| `/virt price <tokenAddress>` | Get bonding curve price |
+| `/virt graduation <tokenAddress>` | Check graduation progress |
+
+**Examples:**
+```bash
+/virt search gaming         # Search gaming agents
+/virt agent abc123          # Get specific agent
+/virt trending              # Top volume agents
+/virt graduation 0x...      # Check if graduated
+```
+
+## Features
+
+- **AI Agents** - Discover AI agents with unique personalities
+- **Bonding Curves** - Price discovery via bonding curves
+- **Graduation** - Track agents graduating to Uniswap
+- **Categories** - Gaming, social, utility, etc.
+
+## Agent Status
+
+| Status | Description |
+|--------|-------------|
+| prototype | New, on bonding curve |
+| sentient | Active, growing community |
+| graduated | Migrated to Uniswap |
+
+## Bonding Curve
+
+Agents start on bonding curves:
+- Price increases with demand
+- ~42K VIRTUAL triggers graduation
+- Graduation creates Uniswap pair
+- LP tokens sent to creator vault
+
+## Configuration
+
+```bash
+# Optional - custom RPC
+export BASE_RPC_URL="https://mainnet.base.org"
+```
+
+## Resources
+
+- [Virtuals Protocol](https://virtuals.io/)
+- [Base Chain](https://base.org/)

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

@@ -0,0 +1,217 @@
+---
+name: voice
+description: "Voice recognition, wake words, and voice-controlled trading"
+emoji: "🎤"
+gates:
+  envs:
+    anyOf:
+      - OPENAI_API_KEY
+      - WHISPER_MODEL_PATH
+---
+
+# Voice - Complete API Reference
+
+Voice-controlled interface with wake word detection, speech-to-text, and text-to-speech.
+
+---
+
+## Chat Commands
+
+### Voice Control
+
+```
+/voice start                                Start voice listening
+/voice stop                                 Stop voice listening
+/voice status                               Check voice status
+/voice wake "hey clodds"                    Set wake word
+```
+
+### Settings
+
+```
+/voice language en-US                       Set language
+/voice sensitivity high                     Wake word sensitivity
+/voice timeout 30                           Silence timeout (seconds)
+/voice continuous on                        Enable continuous mode
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Voice Assistant
+
+```typescript
+import { createVoiceAssistant } from 'clodds/voice';
+
+const voice = createVoiceAssistant({
+  // Wake word
+  wakeWord: 'hey clodds',
+  wakeWordSensitivity: 0.5,  // 0-1
+
+  // Speech-to-text
+  stt: {
+    provider: 'whisper',  // 'whisper' | 'vosk' | 'google'
+    model: 'base',        // 'tiny' | 'base' | 'small' | 'medium' | 'large'
+    language: 'en',
+  },
+
+  // Text-to-speech
+  tts: {
+    provider: 'elevenlabs',  // 'elevenlabs' | 'say' | 'espeak'
+    voice: 'rachel',
+    speed: 1.0,
+  },
+
+  // Timeouts
+  silenceTimeoutMs: 3000,
+  maxRecordingMs: 30000,
+});
+```
+
+### Start/Stop Listening
+
+```typescript
+// Start listening for wake word
+await voice.start();
+
+// Check if listening
+const isListening = voice.isListening();
+
+// Stop listening
+await voice.stop();
+```
+
+### Event Handlers
+
+```typescript
+// Wake word detected
+voice.on('wake', () => {
+  console.log('Wake word detected!');
+});
+
+// Speech recognized
+voice.on('speech', (text: string) => {
+  console.log(`User said: ${text}`);
+});
+
+// Transcription complete
+voice.on('transcript', (result) => {
+  console.log(`Final: ${result.text}`);
+  console.log(`Confidence: ${result.confidence}`);
+  console.log(`Duration: ${result.durationMs}ms`);
+});
+
+// Error handling
+voice.on('error', (error) => {
+  console.error('Voice error:', error);
+});
+
+// Silence detected
+voice.on('silence', () => {
+  console.log('User stopped speaking');
+});
+```
+
+### Speak (TTS)
+
+```typescript
+// Speak text
+await voice.speak('Your order has been placed');
+
+// Speak with options
+await voice.speak('Market is up 5%', {
+  voice: 'josh',
+  speed: 1.2,
+  pitch: 1.0,
+});
+
+// Cancel speaking
+voice.cancelSpeech();
+```
+
+### Manual Transcription
+
+```typescript
+// Transcribe audio buffer
+const result = await voice.transcribe(audioBuffer, {
+  language: 'en',
+  prompt: 'Trading commands',  // Context hint
+});
+
+console.log(`Text: ${result.text}`);
+console.log(`Language: ${result.language}`);
+```
+
+### Voice Activity Detection
+
+```typescript
+// Check if user is speaking
+const vad = voice.getVAD();
+
+vad.on('speechStart', () => {
+  console.log('User started speaking');
+});
+
+vad.on('speechEnd', (audio) => {
+  console.log('User stopped speaking');
+  // audio contains the recorded speech
+});
+```
+
+---
+
+## Wake Word Configuration
+
+| Setting | Values | Description |
+|---------|--------|-------------|
+| `wakeWord` | Any phrase | Trigger phrase |
+| `sensitivity` | 0.0 - 1.0 | Detection threshold |
+
+**Built-in wake words:**
+- "hey clodds"
+- "okay clodds"
+- "clodds"
+
+---
+
+## STT Providers
+
+| Provider | Quality | Speed | Offline |
+|----------|---------|-------|---------|
+| **Whisper** | Excellent | Medium | Yes |
+| **Vosk** | Good | Fast | Yes |
+| **Google** | Excellent | Fast | No |
+
+---
+
+## TTS Providers
+
+| Provider | Quality | Voices | API Key |
+|----------|---------|--------|---------|
+| **ElevenLabs** | Premium | 30+ | Required |
+| **say** (macOS) | Good | System | None |
+| **espeak** | Basic | Many | None |
+
+---
+
+## Voice Commands Examples
+
+Once voice is active, speak naturally:
+
+```
+"Hey Clodds, what's my portfolio value?"
+"Hey Clodds, buy 100 dollars of Trump YES"
+"Hey Clodds, what are the top arbitrage opportunities?"
+"Hey Clodds, set a price alert for Bitcoin at 100k"
+```
+
+---
+
+## Best Practices
+
+1. **Quiet environment** — Background noise affects accuracy
+2. **Clear speech** — Speak clearly for best recognition
+3. **Short commands** — Keep voice commands concise
+4. **Confirmation** — Enable confirmations for trades
+5. **Fallback** — Text input always available

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

@@ -166,8 +166,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/voice/index.js.map

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

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

@@ -0,0 +1,80 @@
+---
+name: weather
+description: "Weather betting - NOAA data for Polymarket weather markets"
+command: weather
+emoji: "🌤️"
+gates:
+  envs:
+    - POLY_API_KEY
+---
+
+# Weather Betting
+
+Use NOAA weather forecasts to find edge on Polymarket weather markets.
+
+## Commands
+
+```
+/weather scan                              Scan all weather markets for edge
+/weather forecast <city>                   Get NOAA forecast for a city
+/weather markets                           List active weather markets
+/weather edge <market-id>                  Calculate edge for specific market
+/weather bet <market-id> <amount>          Execute bet
+/weather auto [--threshold 10]             Auto-bet on high-edge markets
+/weather history                           View bet history
+```
+
+## Examples
+
+```
+/weather forecast "New York"
+/weather scan
+/weather edge abc123
+/weather bet abc123 10
+/weather auto --threshold 15
+```
+
+## How It Works
+
+1. **Fetch NOAA Forecast**: Get official NWS weather data (free, no API key)
+2. **Match to Markets**: Find Polymarket weather markets for the same location/date
+3. **Calculate Edge**: Compare NOAA probability to market YES price
+4. **Bet if Edge**: If NOAA probability differs significantly from market, bet
+
+## Edge Calculation
+
+```
+Edge = NOAA Probability - Market Price
+
+Example:
+  NOAA says 80% chance of rain in NYC tomorrow
+  Polymarket "Will it rain in NYC?" YES price: 0.65 (65%)
+  Edge = 80% - 65% = +15% -> Bet YES
+```
+
+## Supported Market Types
+
+- **Temperature**: "Will NYC exceed 90°F on Saturday?"
+- **Precipitation**: "Will it rain in LA tomorrow?"
+- **Snow**: "Will Chicago get 6+ inches of snow?"
+- **Record**: "Will Phoenix hit a record high this week?"
+
+## Confidence Levels
+
+- **High**: Edge >= 15%, reliable forecast data
+- **Medium**: Edge 10-15%, some uncertainty
+- **Low**: Edge 5-10%, more speculative
+
+## Position Sizing
+
+Uses quarter-Kelly criterion for conservative sizing:
+
+```
+Bet Size = Bankroll * (Edge / Odds) * 0.25
+```
+
+Capped at 10% of bankroll per bet.
+
+## Supported Cities
+
+Major US cities including: New York, Los Angeles, Chicago, Houston, Phoenix, Philadelphia, San Antonio, San Diego, Dallas, San Jose, Austin, Jacksonville, San Francisco, Seattle, Denver, Washington DC, Boston, Nashville, Detroit, and more.

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

@@ -0,0 +1,297 @@
+---
+name: webhooks
+description: "Incoming webhooks for custom data and signal ingestion"
+emoji: "🪝"
+---
+
+# Webhooks - Complete API Reference
+
+Create incoming webhook endpoints to receive external signals, data, and trigger actions.
+
+---
+
+## Chat Commands
+
+### Create Webhooks
+
+```
+/webhook create trading-signals             Create new webhook
+/webhook create alerts --secret abc123      With custom secret
+/webhook list                               List all webhooks
+```
+
+### Manage Webhooks
+
+```
+/webhook info <name>                        View webhook details
+/webhook url <name>                         Get webhook URL
+/webhook regenerate <name>                  New URL/secret
+/webhook delete <name>                      Remove webhook
+```
+
+### Testing
+
+```
+/webhook test <name>                        Send test payload
+/webhook test <name> '{"signal":"BUY"}'     Custom test payload
+/webhook logs <name>                        View recent payloads
+/webhook debug <name>                       Enable debug mode
+```
+
+### Actions
+
+```
+/webhook action <name> add notify           Add action on trigger
+/webhook action <name> add execute          Add trading action
+/webhook action <name> remove <id>          Remove action
+/webhook action <name> list                 List actions
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Webhook Manager
+
+```typescript
+import { createWebhookManager } from 'clodds/webhooks';
+
+const webhooks = createWebhookManager({
+  // Base URL for webhooks
+  baseUrl: 'https://your-domain.com',
+
+  // Default settings
+  defaultSecret: process.env.WEBHOOK_SECRET,
+  validateSignatures: true,
+
+  // Storage
+  storage: 'sqlite',
+  dbPath: './webhooks.db',
+
+  // Logging
+  logPayloads: true,
+  maxLogEntries: 1000,
+});
+```
+
+### Create Webhook
+
+```typescript
+// Create simple webhook
+const hook = await webhooks.create({
+  name: 'trading-signals',
+  description: 'Receive external trading signals',
+});
+
+console.log(`Webhook URL: ${hook.url}`);
+console.log(`Secret: ${hook.secret}`);
+
+// Create with schema validation
+const hook = await webhooks.create({
+  name: 'price-alerts',
+  description: 'Price alert triggers',
+  schema: {
+    type: 'object',
+    properties: {
+      symbol: { type: 'string' },
+      price: { type: 'number' },
+      direction: { enum: ['above', 'below'] },
+    },
+    required: ['symbol', 'price', 'direction'],
+  },
+});
+```
+
+### Handle Webhook
+
+```typescript
+// Register handler
+webhooks.onReceive('trading-signals', async (payload, metadata) => {
+  console.log(`Received signal: ${JSON.stringify(payload)}`);
+  console.log(`From IP: ${metadata.ip}`);
+  console.log(`Timestamp: ${metadata.timestamp}`);
+
+  // Process the signal
+  if (payload.action === 'BUY') {
+    await tradingBot.buy(payload.symbol, payload.amount);
+  }
+
+  // Return response
+  return { status: 'processed', id: metadata.id };
+});
+```
+
+### Add Actions
+
+```typescript
+// Add notification action
+await webhooks.addAction('trading-signals', {
+  type: 'notify',
+  channels: ['telegram', 'discord'],
+  template: 'New signal: {{action}} {{symbol}} @ {{price}}',
+});
+
+// Add trading action
+await webhooks.addAction('trading-signals', {
+  type: 'execute',
+  condition: (payload) => payload.confidence > 0.8,
+  action: async (payload) => {
+    return await tradingBot.execute({
+      platform: 'polymarket',
+      market: payload.market,
+      side: payload.side,
+      size: payload.size,
+    });
+  },
+});
+
+// Add logging action
+await webhooks.addAction('trading-signals', {
+  type: 'log',
+  destination: 'database',
+  table: 'signal_history',
+});
+```
+
+### Get Webhook Info
+
+```typescript
+const info = await webhooks.get('trading-signals');
+
+console.log(`Name: ${info.name}`);
+console.log(`URL: ${info.url}`);
+console.log(`Created: ${info.createdAt}`);
+console.log(`Triggers: ${info.triggerCount}`);
+console.log(`Last trigger: ${info.lastTrigger}`);
+console.log(`Actions: ${info.actions.length}`);
+```
+
+### View Logs
+
+```typescript
+// Get recent payloads
+const logs = await webhooks.getLogs('trading-signals', {
+  limit: 50,
+  since: Date.now() - 24 * 60 * 60 * 1000,  // Last 24h
+});
+
+for (const log of logs) {
+  console.log(`[${log.timestamp}] ${log.status}`);
+  console.log(`  Payload: ${JSON.stringify(log.payload)}`);
+  console.log(`  Response: ${JSON.stringify(log.response)}`);
+}
+```
+
+### Test Webhook
+
+```typescript
+// Send test payload
+const result = await webhooks.test('trading-signals', {
+  action: 'BUY',
+  symbol: 'BTC',
+  price: 100000,
+  confidence: 0.95,
+});
+
+console.log(`Test result: ${result.status}`);
+console.log(`Response: ${JSON.stringify(result.response)}`);
+```
+
+### Delete Webhook
+
+```typescript
+await webhooks.delete('trading-signals');
+```
+
+---
+
+## Webhook Security
+
+### Signature Validation
+
+```typescript
+// Webhooks use HMAC-SHA256 signatures
+// Header: X-Webhook-Signature: sha256=<signature>
+
+// Verify in your sender:
+const crypto = require('crypto');
+const signature = crypto
+  .createHmac('sha256', webhookSecret)
+  .update(JSON.stringify(payload))
+  .digest('hex');
+
+fetch(webhookUrl, {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'X-Webhook-Signature': `sha256=${signature}`,
+  },
+  body: JSON.stringify(payload),
+});
+```
+
+### IP Allowlist
+
+```typescript
+const hook = await webhooks.create({
+  name: 'secure-signals',
+  allowedIps: ['192.168.1.0/24', '10.0.0.1'],
+});
+```
+
+---
+
+## Sending Webhooks (External)
+
+```bash
+# Send signal to your webhook
+curl -X POST https://your-domain.com/webhooks/trading-signals \
+  -H "Content-Type: application/json" \
+  -H "X-Webhook-Signature: sha256=<signature>" \
+  -d '{"action": "BUY", "symbol": "TRUMP-YES", "size": 100}'
+```
+
+```python
+# Python example
+import requests
+import hmac
+import hashlib
+import json
+
+payload = {"action": "BUY", "symbol": "TRUMP-YES", "size": 100}
+secret = "your-webhook-secret"
+signature = hmac.new(
+    secret.encode(),
+    json.dumps(payload).encode(),
+    hashlib.sha256
+).hexdigest()
+
+requests.post(
+    "https://your-domain.com/webhooks/trading-signals",
+    json=payload,
+    headers={"X-Webhook-Signature": f"sha256={signature}"}
+)
+```
+
+---
+
+## Action Types
+
+| Type | Description |
+|------|-------------|
+| `notify` | Send notification to channels |
+| `execute` | Execute trading action |
+| `log` | Log to database |
+| `forward` | Forward to another webhook |
+| `custom` | Custom function |
+
+---
+
+## Best Practices
+
+1. **Always use signatures** — Validate webhook authenticity
+2. **Schema validation** — Reject malformed payloads
+3. **Idempotency** — Handle duplicate deliveries
+4. **Logging** — Keep payload history for debugging
+5. **Rate limiting** — Protect against floods
+6. **Error handling** — Return proper status codes