clodds 1.2.9 → 1.4.0

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

@@ -0,0 +1,209 @@
+---
+name: memory
+description: "Persistent memory system for preferences, facts, and notes"
+emoji: "🧠"
+---
+
+# Memory - Complete API Reference
+
+Store and recall user preferences, facts, and notes across conversations. Semantic search powered by vector embeddings.
+
+---
+
+## Chat Commands
+
+### Store Memories
+
+```
+/remember preference risk=conservative      Save trading preference
+/remember fact BTC halving is in April 2028 Store a fact
+/remember note Check ETH before market open Save a note
+/remember rule Never trade during FOMC      Store trading rule
+```
+
+### Recall Memories
+
+```
+/memory                                     View all memories
+/memory preferences                         View preferences only
+/memory facts                               View facts only
+/memory notes                               View notes only
+/memory rules                               View trading rules
+/memory search "bitcoin"                    Search memories
+```
+
+### Forget Memories
+
+```
+/forget <key>                               Delete specific memory
+/forget all preferences                     Clear all preferences
+/forget all                                 Clear everything (careful!)
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Memory Service
+
+```typescript
+import { createMemoryService } from 'clodds/memory';
+
+const memory = createMemoryService({
+  // Storage backend
+  backend: 'lancedb',  // 'lancedb' | 'sqlite' | 'postgres'
+
+  // Embedding model
+  embeddings: {
+    provider: 'openai',
+    model: 'text-embedding-3-small',
+  },
+
+  // Options
+  encryptionKey: process.env.MEMORY_ENCRYPTION_KEY,
+});
+```
+
+### Remember (Store)
+
+```typescript
+// Store a preference
+await memory.remember({
+  userId: 'user-123',
+  type: 'preference',
+  key: 'risk_tolerance',
+  value: 'conservative',
+});
+
+// Store a fact
+await memory.remember({
+  userId: 'user-123',
+  type: 'fact',
+  content: 'BTC halving occurs approximately every 4 years',
+  metadata: { topic: 'crypto', confidence: 0.95 },
+});
+
+// Store a note
+await memory.remember({
+  userId: 'user-123',
+  type: 'note',
+  content: 'Check Polymarket for election markets before Tuesday',
+  metadata: { priority: 'high' },
+});
+
+// Store a trading rule
+await memory.remember({
+  userId: 'user-123',
+  type: 'rule',
+  content: 'Never trade more than 5% of portfolio on single position',
+});
+```
+
+### Recall (Retrieve)
+
+```typescript
+// Get all memories for user
+const all = await memory.recall({ userId: 'user-123' });
+
+// Get by type
+const preferences = await memory.recall({
+  userId: 'user-123',
+  type: 'preference',
+});
+
+// Get specific key
+const risk = await memory.recall({
+  userId: 'user-123',
+  type: 'preference',
+  key: 'risk_tolerance',
+});
+```
+
+### Semantic Search
+
+```typescript
+// Search by meaning (not just keywords)
+const results = await memory.semanticSearch({
+  userId: 'user-123',
+  query: 'what is my risk appetite?',
+  limit: 5,
+  threshold: 0.7,  // Similarity threshold
+});
+
+for (const result of results) {
+  console.log(`${result.type}: ${result.content}`);
+  console.log(`  Similarity: ${result.score}`);
+}
+```
+
+### Forget (Delete)
+
+```typescript
+// Delete specific memory
+await memory.forget({
+  userId: 'user-123',
+  type: 'preference',
+  key: 'risk_tolerance',
+});
+
+// Delete all of a type
+await memory.forgetByType({
+  userId: 'user-123',
+  type: 'note',
+});
+
+// Delete all memories
+await memory.forgetAll({ userId: 'user-123' });
+```
+
+### Daily Journal
+
+```typescript
+// Log daily activity
+await memory.logDaily({
+  userId: 'user-123',
+  date: new Date(),
+  trades: 5,
+  pnl: 123.45,
+  notes: 'Good day, caught BTC rally',
+});
+
+// Get journal entries
+const journal = await memory.getDailyLogs({
+  userId: 'user-123',
+  from: '2024-01-01',
+  to: '2024-01-31',
+});
+```
+
+---
+
+## Memory Types
+
+| Type | Purpose | Example |
+|------|---------|---------|
+| **preference** | User settings | `risk=conservative` |
+| **fact** | Stored knowledge | "ETH gas is cheaper on weekends" |
+| **note** | Reminders/todos | "Check election markets" |
+| **rule** | Trading rules | "Max 5% per position" |
+| **context** | Conversation context | Auto-saved by system |
+
+---
+
+## Storage Backends
+
+| Backend | Description | Best For |
+|---------|-------------|----------|
+| **LanceDB** | Vector DB with hybrid search | Production, semantic search |
+| **SQLite** | Local file-based | Development, single user |
+| **PostgreSQL** | Distributed with pgvector | Multi-user, production |
+
+---
+
+## Best Practices
+
+1. **Be specific with keys** — `max_position_size` not just `size`
+2. **Use types correctly** — Preferences for settings, rules for constraints
+3. **Semantic search** — Ask questions naturally, embeddings will match
+4. **Regular cleanup** — Delete outdated notes and facts
+5. **Backup memories** — Export before major changes

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

@@ -0,0 +1,62 @@
+---
+name: metaculus
+description: "Metaculus forecasting platform (read-only)"
+emoji: "🔮"
+commands:
+  - /mc
+---
+
+# Metaculus
+
+Integration with Metaculus, a community forecasting platform. View questions, predictions, and tournaments.
+
+## Quick Start
+
+```bash
+# Search questions
+/mc search AI
+
+# Get question details
+/mc question 12345
+
+# List tournaments
+/mc tournaments
+
+# Get tournament questions
+/mc tournament 123
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/mc search [query]` | Search questions |
+| `/mc question <id>` | Get question details |
+| `/mc tournaments` | List active tournaments |
+| `/mc tournament <id>` | Get tournament questions |
+
+**Examples:**
+```bash
+/mc search pandemic         # Search for pandemic questions
+/mc question 3479           # Get question details
+/mc tournament 1234         # Get tournament questions
+```
+
+## Features
+
+- **Community Forecasts** - Aggregate probability predictions
+- **Tournaments** - Forecasting competitions
+- **Question Types** - Binary, continuous, date ranges
+- **Historical Accuracy** - Track prediction calibration
+
+## Notes
+
+- Metaculus is a forecasting platform (not trading)
+- Questions show community prediction probabilities
+- No trading or betting functionality
+- Volume represents number of predictions
+
+## Resources
+
+- [Metaculus](https://www.metaculus.com/)
+- [Metaculus API](https://www.metaculus.com/api2/)

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

@@ -29,11 +29,14 @@ async function getFeed() {
 async function handleSearch(query) {
     const f = await getFeed();
     try {
+        const defaultQuery = !query;
         const markets = await f.searchMarkets(query || 'AI');
         if (markets.length === 0) {
             return 'No questions found.';
         }
-        let output = `**Metaculus Questions** (${markets.length} results)\n\n`;
+        let output = defaultQuery
+            ? `**Metaculus Questions** (showing default results — use \`/mc search <query>\` to filter)\n\n`
+            : `**Metaculus Questions** (${markets.length} results)\n\n`;
         for (const market of markets.slice(0, 15)) {
             const probability = market.outcomes[0]?.price || 0.5;
             output += `**${market.question}**\n`;

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

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

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

@@ -0,0 +1,28 @@
+---
+name: meteora
+description: "Meteora DLMM - dynamic liquidity market maker on Solana"
+command: met
+emoji: "☄️"
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Meteora DLMM
+
+Meteora uses Dynamic Liquidity Market Maker (DLMM) pools with bin-based pricing.
+
+## Commands
+
+```
+/met swap <amount> <from> to <to>    Execute swap
+/met quote <amount> <from> to <to>   Get quote
+/met pools <token>                   List DLMM pools
+```
+
+## Examples
+
+```
+/met swap 1 SOL to USDC
+/met pools SOL
+```

package/dist/skills/bundled/meteora-dbc/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: meteora-dbc
+description: "Launch tokens on Meteora dynamic bonding curves"
+command: dbc
+emoji: "🚀"
+---
+
+# Meteora DBC
+
+Launch tokens on Meteora's dynamic bonding curves with anti-sniper fees, configurable market caps, and automated DAMM migration.
+
+## Commands
+
+```
+/dbc launch <name> <symbol> <desc> [options]    Launch token on bonding curve
+/dbc status <mint>                               Check pool status and migration progress
+/dbc buy <mint> <amountSOL>                      Buy tokens on curve
+/dbc sell <mint> <amountTokens>                  Sell tokens back to curve
+/dbc quote <mint> <amount> [--sell]              Get swap quote
+/dbc claim <pool> [--partner]                    Claim creator/partner fees
+/dbc migrate <command> [args]                    Migration commands (v1, v2, locker, etc)
+/dbc fees <pool>                                 Show fee breakdown
+/dbc pools <command> [args]                      Query pools and configs
+/dbc help                                        Show all commands
+```

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

@@ -0,0 +1,338 @@
+---
+name: metrics
+description: "System metrics, telemetry, and performance monitoring"
+emoji: "📈"
+---
+
+# Metrics - Complete API Reference
+
+Monitor system health, track performance metrics, and analyze telemetry data.
+
+---
+
+## Chat Commands
+
+### System Metrics
+
+```
+/metrics                               Show current metrics
+/metrics system                        CPU, memory, latency
+/metrics api                           API performance stats
+/metrics ws                            WebSocket health
+```
+
+### Trading Metrics
+
+```
+/metrics trades                        Trade execution stats
+/metrics fills                         Fill rate metrics
+/metrics latency                       Order latency stats
+/metrics errors                        Error rates
+```
+
+### Custom Metrics
+
+```
+/metrics track <name> <value>          Track custom metric
+/metrics query <name>                  Query metric history
+/metrics alert <name> > 100            Set metric alert
+```
+
+### Export & Reports
+
+```
+/metrics export csv                    Export to CSV
+/metrics report daily                  Generate daily report
+/metrics dashboard                     Open metrics dashboard
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Metrics Service
+
+```typescript
+import { createMetricsService } from 'clodds/metrics';
+
+const metrics = createMetricsService({
+  // Collection
+  collectInterval: 5000,  // ms
+  retention: '30d',
+
+  // Storage
+  storage: 'sqlite',
+  dbPath: './metrics.db',
+
+  // Export
+  enablePrometheus: true,
+  prometheusPort: 9090,
+});
+
+// Start collection
+await metrics.start();
+```
+
+### System Metrics
+
+```typescript
+const system = await metrics.getSystemMetrics();
+
+console.log('=== System Health ===');
+console.log(`CPU Usage: ${system.cpuUsage}%`);
+console.log(`Memory: ${system.memoryUsed}MB / ${system.memoryTotal}MB`);
+console.log(`Uptime: ${system.uptimeHours}h`);
+console.log(`Active connections: ${system.activeConnections}`);
+console.log(`Event loop lag: ${system.eventLoopLag}ms`);
+```
+
+### API Metrics
+
+```typescript
+const api = await metrics.getApiMetrics();
+
+console.log('=== API Performance ===');
+console.log(`Total requests: ${api.totalRequests}`);
+console.log(`Requests/sec: ${api.requestsPerSecond}`);
+console.log(`Avg latency: ${api.avgLatency}ms`);
+console.log(`P50 latency: ${api.p50Latency}ms`);
+console.log(`P95 latency: ${api.p95Latency}ms`);
+console.log(`P99 latency: ${api.p99Latency}ms`);
+console.log(`Error rate: ${api.errorRate}%`);
+
+console.log('\nBy Endpoint:');
+for (const endpoint of api.byEndpoint) {
+  console.log(`  ${endpoint.path}: ${endpoint.avgLatency}ms (${endpoint.calls} calls)`);
+}
+```
+
+### WebSocket Metrics
+
+```typescript
+const ws = await metrics.getWebSocketMetrics();
+
+console.log('=== WebSocket Health ===');
+console.log(`Active connections: ${ws.activeConnections}`);
+console.log(`Messages/sec: ${ws.messagesPerSecond}`);
+console.log(`Avg message size: ${ws.avgMessageSize} bytes`);
+console.log(`Reconnections: ${ws.reconnections}`);
+console.log(`Dropped messages: ${ws.droppedMessages}`);
+
+console.log('\nBy Feed:');
+for (const feed of ws.byFeed) {
+  console.log(`  ${feed.name}: ${feed.messagesPerSecond}/s, ${feed.latency}ms lag`);
+}
+```
+
+### Trade Execution Metrics
+
+```typescript
+const trades = await metrics.getTradeMetrics();
+
+console.log('=== Trade Execution ===');
+console.log(`Total orders: ${trades.totalOrders}`);
+console.log(`Fill rate: ${trades.fillRate}%`);
+console.log(`Partial fills: ${trades.partialFillRate}%`);
+console.log(`Rejections: ${trades.rejectionRate}%`);
+console.log(`Avg fill time: ${trades.avgFillTime}ms`);
+console.log(`Avg slippage: ${trades.avgSlippage}%`);
+
+console.log('\nBy Platform:');
+for (const platform of trades.byPlatform) {
+  console.log(`  ${platform.name}:`);
+  console.log(`    Fill rate: ${platform.fillRate}%`);
+  console.log(`    Avg latency: ${platform.avgLatency}ms`);
+}
+```
+
+### Latency Breakdown
+
+```typescript
+const latency = await metrics.getLatencyBreakdown();
+
+console.log('=== Latency Breakdown ===');
+console.log(`Total order latency: ${latency.total}ms`);
+console.log(`  Signal processing: ${latency.signalProcessing}ms`);
+console.log(`  Order construction: ${latency.orderConstruction}ms`);
+console.log(`  Network round-trip: ${latency.networkRoundTrip}ms`);
+console.log(`  Exchange processing: ${latency.exchangeProcessing}ms`);
+console.log(`  Confirmation: ${latency.confirmation}ms`);
+```
+
+### Error Metrics
+
+```typescript
+const errors = await metrics.getErrorMetrics();
+
+console.log('=== Error Rates ===');
+console.log(`Total errors: ${errors.totalErrors}`);
+console.log(`Error rate: ${errors.errorRate}%`);
+console.log(`Errors/hour: ${errors.errorsPerHour}`);
+
+console.log('\nBy Type:');
+for (const type of errors.byType) {
+  console.log(`  ${type.name}: ${type.count} (${type.percentage}%)`);
+}
+
+console.log('\nBy Platform:');
+for (const platform of errors.byPlatform) {
+  console.log(`  ${platform.name}: ${platform.errorRate}%`);
+}
+```
+
+### Custom Metrics
+
+```typescript
+// Track custom metric
+metrics.track('edge_detected', 1, {
+  market: 'trump-2028',
+  edgeSize: 0.05,
+});
+
+// Increment counter
+metrics.increment('trades_executed');
+
+// Set gauge
+metrics.gauge('active_positions', 5);
+
+// Record timing
+const timer = metrics.startTimer('order_execution');
+// ... execute order ...
+timer.end();
+
+// Histogram
+metrics.histogram('slippage', 0.003, {
+  platform: 'polymarket',
+});
+```
+
+### Query Metrics
+
+```typescript
+const query = await metrics.query({
+  metric: 'edge_detected',
+  period: '7d',
+  aggregation: 'sum',
+  groupBy: 'market',
+});
+
+console.log('Edge Detection by Market:');
+for (const row of query.results) {
+  console.log(`  ${row.market}: ${row.value} detections`);
+}
+```
+
+### Metric Alerts
+
+```typescript
+// Set alert threshold
+metrics.setAlert({
+  metric: 'error_rate',
+  condition: '>',
+  threshold: 5,  // > 5% error rate
+  window: '5m',
+  action: 'notify',
+});
+
+metrics.setAlert({
+  metric: 'latency_p99',
+  condition: '>',
+  threshold: 1000,  // > 1000ms
+  window: '1m',
+  action: 'escalate',
+});
+
+// Alert handlers
+metrics.on('alert', (alert) => {
+  console.log(`🚨 Alert: ${alert.metric} ${alert.condition} ${alert.threshold}`);
+  console.log(`  Current value: ${alert.currentValue}`);
+});
+```
+
+### Export Metrics
+
+```typescript
+// Export to CSV
+await metrics.export({
+  format: 'csv',
+  metrics: ['api_latency', 'trade_fill_rate', 'error_rate'],
+  period: '30d',
+  outputPath: './metrics-export.csv',
+});
+
+// Export to Prometheus
+const prometheusFormat = metrics.toPrometheus();
+
+// Export to JSON
+const jsonMetrics = await metrics.toJSON({
+  period: '24h',
+});
+```
+
+### Generate Reports
+
+```typescript
+const report = await metrics.generateReport({
+  type: 'daily',
+  include: ['summary', 'api', 'trades', 'errors'],
+});
+
+console.log('=== Daily Metrics Report ===');
+console.log(`Date: ${report.date}`);
+console.log(`\nSummary:`);
+console.log(`  Uptime: ${report.summary.uptime}%`);
+console.log(`  Total requests: ${report.summary.totalRequests}`);
+console.log(`  Total trades: ${report.summary.totalTrades}`);
+console.log(`  Error rate: ${report.summary.errorRate}%`);
+console.log(`\nHighlights:`);
+for (const highlight of report.highlights) {
+  console.log(`  - ${highlight}`);
+}
+```
+
+### Real-time Streaming
+
+```typescript
+// Stream metrics in real-time
+const stream = metrics.stream(['cpu', 'memory', 'latency']);
+
+stream.on('data', (data) => {
+  console.log(`CPU: ${data.cpu}%, Memory: ${data.memory}MB, Latency: ${data.latency}ms`);
+});
+
+// Stop streaming
+stream.stop();
+```
+
+---
+
+## Metric Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| **Counter** | Monotonic increasing | `trades_total` |
+| **Gauge** | Point-in-time value | `active_positions` |
+| **Histogram** | Distribution | `latency_ms` |
+| **Timer** | Duration measurement | `order_execution_time` |
+
+---
+
+## Built-in Metrics
+
+| Category | Metrics |
+|----------|---------|
+| **System** | cpu_usage, memory_used, uptime, connections |
+| **API** | request_count, latency_p50/p95/p99, error_rate |
+| **WebSocket** | messages_per_sec, lag, reconnections |
+| **Trades** | orders_total, fill_rate, slippage, execution_time |
+| **Errors** | error_count, error_rate_by_type |
+
+---
+
+## Best Practices
+
+1. **Monitor latency percentiles** — P99 matters more than average
+2. **Set alerts proactively** — Catch issues before users notice
+3. **Track custom metrics** — Business-specific KPIs
+4. **Review daily reports** — Spot trends early
+5. **Export for analysis** — Use external tools for deep dives