clodds 1.2.8 → 1.3.0

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

@@ -0,0 +1,266 @@
+---
+name: strategy
+description: "Build and manage custom trading strategies with natural language"
+emoji: "🎯"
+---
+
+# Strategy - Complete API Reference
+
+Create custom trading strategies using natural language or templates, then deploy to live trading.
+
+---
+
+## Chat Commands
+
+### Create Strategy
+
+```
+/strategy create "Buy when price drops 5% in 1 hour"
+/strategy create momentum --lookback 14 --threshold 2%
+/strategy from-template mean-reversion
+```
+
+### Manage Strategies
+
+```
+/strategies                         List all strategies
+/strategy <name>                    View strategy details
+/strategy edit <name>               Modify strategy
+/strategy delete <name>             Remove strategy
+```
+
+### Activate/Deactivate
+
+```
+/strategy activate <name>           Start running strategy
+/strategy deactivate <name>         Stop strategy
+/strategy pause <name>              Pause temporarily
+/strategy resume <name>             Resume paused strategy
+```
+
+### Test & Validate
+
+```
+/strategy test <name> --dry-run     Test without real trades
+/strategy backtest <name>           Run backtest
+/strategy validate <name>           Check for errors
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Strategy Builder
+
+```typescript
+import { createStrategyBuilder } from 'clodds/strategy';
+
+const builder = createStrategyBuilder({
+  // Validation
+  requireDryRun: true,
+  validateParameters: true,
+
+  // Storage
+  storage: 'sqlite',
+  dbPath: './strategies.db',
+});
+```
+
+### Natural Language Strategy
+
+```typescript
+// Create from natural language
+const strategy = await builder.fromNaturalLanguage({
+  description: `
+    Buy YES on any market when:
+    - Price drops more than 5% in the last hour
+    - Volume is above average
+    - Spread is less than 2%
+
+    Sell when:
+    - Price recovers 3% from entry
+    - Or after 24 hours (timeout)
+
+    Risk: Max 5% of portfolio per trade
+  `,
+  name: 'dip-buyer',
+});
+
+console.log(`Created: ${strategy.name}`);
+console.log(`Conditions: ${strategy.conditions.length}`);
+```
+
+### Template-Based Strategy
+
+```typescript
+// Momentum strategy
+const momentum = await builder.fromTemplate('momentum', {
+  lookbackPeriod: 14,
+  entryThreshold: 0.02,
+  exitThreshold: 0.01,
+  stopLoss: 0.05,
+  takeProfit: 0.10,
+  maxPositionPct: 10,
+});
+
+// Mean reversion strategy
+const meanReversion = await builder.fromTemplate('mean-reversion', {
+  lookbackPeriod: 20,
+  deviationThreshold: 2,  // Standard deviations
+  exitOnMean: true,
+  stopLoss: 0.08,
+});
+
+// Arbitrage strategy
+const arbitrage = await builder.fromTemplate('arbitrage', {
+  minSpread: 0.02,
+  platforms: ['polymarket', 'kalshi'],
+  maxSlippage: 0.01,
+});
+
+// Breakout strategy
+const breakout = await builder.fromTemplate('breakout', {
+  rangePeriod: '7d',
+  breakoutThreshold: 0.05,
+  confirmationVolume: 1.5,  // 1.5x average volume
+});
+```
+
+### Custom Strategy Code
+
+```typescript
+// Full custom strategy
+const custom = await builder.create({
+  name: 'my-custom-strategy',
+  description: 'Buy low-priced markets with high volume',
+
+  // Entry conditions (all must be true)
+  entryConditions: [
+    { type: 'price', operator: '<', value: 0.30 },
+    { type: 'volume24h', operator: '>', value: 50000 },
+    { type: 'spread', operator: '<', value: 0.02 },
+  ],
+
+  // Exit conditions (any triggers exit)
+  exitConditions: [
+    { type: 'profit', operator: '>=', value: 0.15 },
+    { type: 'loss', operator: '>=', value: 0.10 },
+    { type: 'holdTime', operator: '>=', value: '48h' },
+  ],
+
+  // Risk management
+  risk: {
+    maxPositionPct: 5,
+    stopLoss: 0.10,
+    takeProfit: 0.20,
+    maxConcurrentPositions: 5,
+  },
+
+  // Execution
+  execution: {
+    orderType: 'limit',
+    limitBuffer: 0.005,
+    retries: 3,
+  },
+});
+```
+
+### Validate Strategy
+
+```typescript
+const validation = await builder.validate(strategy);
+
+if (validation.valid) {
+  console.log('✅ Strategy is valid');
+} else {
+  console.log('❌ Validation errors:');
+  for (const error of validation.errors) {
+    console.log(`  - ${error}`);
+  }
+}
+
+// Warnings (not blocking)
+for (const warning of validation.warnings) {
+  console.log(`⚠️ ${warning}`);
+}
+```
+
+### Activate Strategy
+
+```typescript
+// Start with dry-run first (required)
+await builder.activate(strategy.name, {
+  dryRun: true,
+  notifyOnTrade: true,
+});
+
+// After validation, go live
+await builder.activate(strategy.name, {
+  dryRun: false,
+  capital: 5000,  // Allocate $5000
+});
+```
+
+### Monitor Strategy
+
+```typescript
+const status = await builder.getStatus(strategy.name);
+
+console.log(`Status: ${status.status}`);  // 'active' | 'paused' | 'stopped'
+console.log(`Trades: ${status.trades}`);
+console.log(`P&L: $${status.pnl}`);
+console.log(`Win Rate: ${status.winRate}%`);
+console.log(`Active Positions: ${status.activePositions}`);
+console.log(`Last Signal: ${status.lastSignal}`);
+```
+
+### List Strategies
+
+```typescript
+const strategies = await builder.list();
+
+for (const s of strategies) {
+  console.log(`${s.name}: ${s.status}`);
+  console.log(`  Type: ${s.template || 'custom'}`);
+  console.log(`  P&L: $${s.pnl}`);
+  console.log(`  Trades: ${s.trades}`);
+}
+```
+
+---
+
+## Built-in Templates
+
+| Template | Description |
+|----------|-------------|
+| `momentum` | Follow price trends |
+| `mean-reversion` | Buy dips, sell rallies |
+| `arbitrage` | Cross-platform spreads |
+| `breakout` | Range breakout entries |
+| `pairs` | Correlated market pairs |
+| `news-reactive` | React to news events |
+| `volume-spike` | Trade on volume surges |
+
+---
+
+## Condition Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| `price` | Current price | `< 0.30` |
+| `volume24h` | 24h volume | `> 50000` |
+| `spread` | Bid-ask spread | `< 0.02` |
+| `profit` | Unrealized profit | `>= 0.15` |
+| `loss` | Unrealized loss | `>= 0.10` |
+| `holdTime` | Time in position | `>= 48h` |
+| `priceChange` | Price change % | `< -0.05` (5% drop) |
+
+---
+
+## Best Practices
+
+1. **Always dry-run first** — Test before real money
+2. **Start small** — Low capital until proven
+3. **Set stop-losses** — Protect against bad trades
+4. **Monitor actively** — Check strategy performance
+5. **Iterate** — Improve based on results

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

@@ -0,0 +1,150 @@
+---
+name: streaming
+description: "Response streaming configuration and real-time output"
+emoji: "📡"
+---
+
+# Streaming - Complete API Reference
+
+Configure response streaming, typing indicators, and real-time message delivery.
+
+---
+
+## Chat Commands
+
+### View Settings
+
+```
+/streaming                                  Show current settings
+/streaming status                           Streaming status
+```
+
+### Configure Streaming
+
+```
+/streaming enable                           Enable streaming
+/streaming disable                          Disable streaming
+/streaming chunk-size 50                    Set chunk size (chars)
+/streaming delay 100                        Set delay between chunks (ms)
+```
+
+### Typing Indicators
+
+```
+/streaming typing on                        Enable typing indicators
+/streaming typing off                       Disable typing indicators
+/streaming typing duration 3000             Typing duration (ms)
+```
+
+### Platform Settings
+
+```
+/streaming platforms                        Show platform limits
+/streaming platform telegram chunk 100      Set per-platform
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Streaming Config
+
+```typescript
+import { createStreamingConfig } from 'clodds/streaming';
+
+const streaming = createStreamingConfig({
+  // Enable streaming
+  enabled: true,
+
+  // Chunk settings
+  minChunkSize: 20,    // Min chars per chunk
+  maxChunkSize: 200,   // Max chars per chunk
+  chunkDelayMs: 50,    // Delay between chunks
+
+  // Typing indicators
+  showTyping: true,
+  typingDurationMs: 3000,
+
+  // Platform-specific limits
+  platformLimits: {
+    telegram: { maxMessageLength: 4096, maxChunkSize: 100 },
+    discord: { maxMessageLength: 2000, maxChunkSize: 150 },
+    slack: { maxMessageLength: 40000, maxChunkSize: 200 },
+  },
+});
+```
+
+### Enable/Disable
+
+```typescript
+// Enable streaming
+streaming.enable();
+
+// Disable streaming
+streaming.disable();
+
+// Check status
+const enabled = streaming.isEnabled();
+```
+
+### Configure Chunks
+
+```typescript
+// Set chunk size
+streaming.setChunkSize(100);
+
+// Set delay
+streaming.setChunkDelay(75);
+
+// Get current settings
+const settings = streaming.getSettings();
+console.log(`Chunk size: ${settings.chunkSize}`);
+console.log(`Delay: ${settings.chunkDelayMs}ms`);
+```
+
+### Platform Settings
+
+```typescript
+// Set platform-specific limit
+streaming.setPlatformLimit('telegram', {
+  maxMessageLength: 4096,
+  maxChunkSize: 80,
+});
+
+// Get platform limits
+const limits = streaming.getPlatformLimits();
+```
+
+### Typing Indicators
+
+```typescript
+// Enable typing
+streaming.enableTyping();
+
+// Disable typing
+streaming.disableTyping();
+
+// Set duration
+streaming.setTypingDuration(5000);
+```
+
+---
+
+## Platform Limits
+
+| Platform | Max Message | Recommended Chunk |
+|----------|-------------|-------------------|
+| Telegram | 4,096 chars | 80-100 |
+| Discord | 2,000 chars | 100-150 |
+| Slack | 40,000 chars | 150-200 |
+| WhatsApp | 65,536 chars | 100-150 |
+| WebChat | Unlimited | 150-200 |
+
+---
+
+## Best Practices
+
+1. **Smaller chunks for mobile** — Better UX on slow connections
+2. **Adjust delay for readability** — 50-100ms feels natural
+3. **Disable for short responses** — Don't stream "OK"
+4. **Monitor performance** — Streaming adds overhead

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

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

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

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

@@ -0,0 +1,249 @@
+---
+name: tailscale
+description: "Tailscale VPN sharing, Serve, and Funnel for remote access"
+emoji: "🔗"
+gates:
+  envs:
+    anyOf:
+      - TAILSCALE_AUTHKEY
+---
+
+# Tailscale - Complete API Reference
+
+Share local services via Tailscale Serve (private) and Funnel (public internet access).
+
+---
+
+## Chat Commands
+
+### Share Local Services (Private)
+
+```
+/tailscale serve 3000                       Share port on tailnet
+/tailscale serve 3000 --path /api           Share at specific path
+/tailscale serve stop 3000                  Stop sharing port
+/tailscale serve status                     View active shares
+```
+
+### Public Access (Funnel)
+
+```
+/tailscale funnel 3000                      Expose to internet
+/tailscale funnel 3000 --https              Force HTTPS
+/tailscale funnel stop 3000                 Stop public access
+/tailscale funnel status                    View funnels
+```
+
+### Network Status
+
+```
+/tailscale status                           Network status
+/tailscale ip                               Show Tailscale IP
+/tailscale peers                            List connected peers
+/tailscale ping <peer>                      Ping a peer
+```
+
+### File Transfer
+
+```
+/tailscale send <file> <peer>               Send file to peer
+/tailscale receive                          Receive incoming files
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Tailscale Client
+
+```typescript
+import { createTailscaleClient } from 'clodds/tailscale';
+
+const tailscale = createTailscaleClient({
+  // Auth (optional if already logged in)
+  authKey: process.env.TAILSCALE_AUTHKEY,
+
+  // Socket path
+  socketPath: '/var/run/tailscale/tailscaled.sock',
+});
+```
+
+### Serve (Private Sharing)
+
+```typescript
+// Share local port on tailnet
+await tailscale.serve({
+  port: 3000,
+  protocol: 'https',  // 'http' | 'https'
+});
+
+console.log(`Shared at: https://${tailscale.hostname}:3000`);
+
+// Share at specific path
+await tailscale.serve({
+  port: 8080,
+  path: '/api',
+  protocol: 'https',
+});
+
+// Share with custom hostname
+await tailscale.serve({
+  port: 3000,
+  hostname: 'clodds',  // clodds.tailnet-name.ts.net
+});
+
+// Stop sharing
+await tailscale.serveStop(3000);
+
+// Get serve status
+const serves = await tailscale.serveStatus();
+for (const serve of serves) {
+  console.log(`Port ${serve.port} → ${serve.url}`);
+}
+```
+
+### Funnel (Public Internet)
+
+```typescript
+// Expose to public internet
+await tailscale.funnel({
+  port: 3000,
+  protocol: 'https',
+});
+
+console.log(`Public URL: https://${tailscale.hostname}.ts.net`);
+
+// With custom domain (if configured)
+await tailscale.funnel({
+  port: 3000,
+  hostname: 'api.example.com',
+});
+
+// Stop funnel
+await tailscale.funnelStop(3000);
+
+// Get funnel status
+const funnels = await tailscale.funnelStatus();
+for (const funnel of funnels) {
+  console.log(`Port ${funnel.port} → ${funnel.publicUrl}`);
+}
+```
+
+### Network Status
+
+```typescript
+// Get status
+const status = await tailscale.status();
+
+console.log(`Hostname: ${status.hostname}`);
+console.log(`IP: ${status.ip}`);
+console.log(`Tailnet: ${status.tailnet}`);
+console.log(`Online: ${status.online}`);
+
+// List peers
+const peers = await tailscale.peers();
+for (const peer of peers) {
+  console.log(`${peer.hostname} (${peer.ip})`);
+  console.log(`  OS: ${peer.os}`);
+  console.log(`  Online: ${peer.online}`);
+  console.log(`  Last seen: ${peer.lastSeen}`);
+}
+
+// Ping peer
+const ping = await tailscale.ping('other-machine');
+console.log(`Latency: ${ping.latencyMs}ms`);
+```
+
+### File Transfer
+
+```typescript
+// Send file to peer
+await tailscale.sendFile({
+  file: '/path/to/file.zip',
+  peer: 'other-machine',
+});
+
+// Receive files (returns when file received)
+const received = await tailscale.receiveFile({
+  savePath: '/downloads',
+  timeout: 60000,
+});
+
+console.log(`Received: ${received.filename}`);
+console.log(`From: ${received.sender}`);
+console.log(`Size: ${received.size} bytes`);
+```
+
+### Get Tailscale IP
+
+```typescript
+const ip = await tailscale.getIP();
+console.log(`Tailscale IP: ${ip}`);  // 100.x.x.x
+```
+
+---
+
+## Serve vs Funnel
+
+| Feature | Serve | Funnel |
+|---------|-------|--------|
+| **Access** | Tailnet only | Public internet |
+| **Auth** | Tailscale identity | None (public) |
+| **URL** | machine.tailnet.ts.net | machine.ts.net |
+| **Use case** | Internal tools | Public APIs |
+
+---
+
+## URL Formats
+
+| Type | Format |
+|------|--------|
+| **Serve** | `https://machine.tailnet-name.ts.net:port` |
+| **Funnel** | `https://machine.ts.net` |
+| **Custom domain** | `https://your-domain.com` |
+
+---
+
+## Use Cases
+
+### Share Dev Server
+
+```typescript
+// Share local dev server with team
+await tailscale.serve({ port: 3000 });
+// Team can access at https://your-machine.tailnet.ts.net:3000
+```
+
+### Expose Webhook Endpoint
+
+```typescript
+// Make webhook publicly accessible
+await tailscale.funnel({ port: 3000, path: '/webhooks' });
+// External services can POST to https://your-machine.ts.net/webhooks
+```
+
+### Share Bot with Phone
+
+```typescript
+// Access bot from phone while away from desk
+await tailscale.serve({ port: 18789 });
+// Open https://your-machine.tailnet.ts.net:18789/webchat on phone
+```
+
+---
+
+## Requirements
+
+- Tailscale installed and running
+- Logged into a Tailnet
+- For Funnel: Funnel enabled in Tailscale admin
+
+---
+
+## Best Practices
+
+1. **Use Serve for internal** — Keep private services private
+2. **Use Funnel sparingly** — Only for truly public endpoints
+3. **Add authentication** — Funnel bypasses Tailscale auth
+4. **Monitor access** — Check who's connecting
+5. **Stop when done** — Don't leave services exposed

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

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