clodds 1.2.8 → 1.3.0

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

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

@@ -0,0 +1,239 @@
+---
+name: mev
+description: "MEV protection against sandwich attacks and front-running"
+emoji: "🛡️"
+---
+
+# MEV Protection - Complete API Reference
+
+Protect trades from MEV (Maximal Extractable Value) attacks including sandwich attacks and front-running.
+
+---
+
+## Chat Commands
+
+### Protection Settings
+
+```
+/mev                                Show current protection
+/mev status                         Protection status
+/mev enable                         Enable protection
+/mev disable                        Disable protection
+```
+
+### Configure Protection
+
+```
+/mev level aggressive               Maximum protection
+/mev level standard                 Balanced protection
+/mev level minimal                  Basic protection
+/mev provider flashbots             Use Flashbots
+/mev provider mev-blocker           Use MEV Blocker
+```
+
+### Check Transaction
+
+```
+/mev check <tx-hash>                Check if tx was attacked
+/mev simulate <order>               Simulate MEV risk
+```
+
+---
+
+## TypeScript API Reference
+
+### Create MEV Protection
+
+```typescript
+import { createMEVProtection } from 'clodds/mev';
+
+const mev = createMEVProtection({
+  // Default level
+  level: 'standard',
+
+  // Providers
+  providers: {
+    ethereum: 'flashbots',    // 'flashbots' | 'mev-blocker'
+    solana: 'jito',           // 'jito' | 'standard'
+  },
+
+  // Settings
+  maxPriorityFee: 5,  // gwei
+  bundleTimeout: 60,  // seconds
+});
+```
+
+### Execute Protected Trade
+
+```typescript
+// EVM trade with protection
+const result = await mev.executeProtected({
+  chain: 'ethereum',
+  type: 'swap',
+  tokenIn: 'USDC',
+  tokenOut: 'ETH',
+  amountIn: 10000,
+  minAmountOut: calculateMinOut(10000, 0.5),  // 0.5% slippage
+});
+
+console.log(`Tx hash: ${result.txHash}`);
+console.log(`Protected: ${result.protected}`);
+console.log(`Bundle ID: ${result.bundleId}`);
+console.log(`Savings: $${result.estimatedSavings}`);
+```
+
+### Flashbots (Ethereum)
+
+```typescript
+// Submit via Flashbots Protect
+const result = await mev.flashbots({
+  to: routerAddress,
+  data: swapCalldata,
+  value: 0,
+  maxFeePerGas: parseGwei('50'),
+  maxPriorityFeePerGas: parseGwei('2'),
+});
+
+console.log(`Submitted to Flashbots`);
+console.log(`Bundle hash: ${result.bundleHash}`);
+
+// Wait for inclusion
+const status = await mev.waitForInclusion(result.bundleHash);
+console.log(`Included in block: ${status.blockNumber}`);
+```
+
+### MEV Blocker (Ethereum)
+
+```typescript
+// Use MEV Blocker by CoW Protocol
+const result = await mev.mevBlocker({
+  to: routerAddress,
+  data: swapCalldata,
+  value: 0,
+});
+
+// MEV Blocker automatically:
+// - Protects from sandwich attacks
+// - Backruns profitable MEV to you
+// - Returns any captured MEV
+console.log(`MEV captured: $${result.mevCaptured}`);
+```
+
+### Jito (Solana)
+
+```typescript
+// Submit via Jito bundles
+const result = await mev.jito({
+  instructions: swapInstructions,
+  tip: 10000,  // lamports tip to validators
+});
+
+console.log(`Bundle ID: ${result.bundleId}`);
+console.log(`Status: ${result.status}`);
+```
+
+### Check Transaction
+
+```typescript
+// Check if a past transaction was attacked
+const analysis = await mev.analyzeTransaction(txHash);
+
+console.log(`Was attacked: ${analysis.wasAttacked}`);
+if (analysis.wasAttacked) {
+  console.log(`Attack type: ${analysis.attackType}`);
+  console.log(`Attacker: ${analysis.attacker}`);
+  console.log(`Loss: $${analysis.estimatedLoss}`);
+  console.log(`Frontrun tx: ${analysis.frontrunTx}`);
+  console.log(`Backrun tx: ${analysis.backrunTx}`);
+}
+```
+
+### Simulate MEV Risk
+
+```typescript
+// Before trading, check MEV risk
+const risk = await mev.simulateRisk({
+  chain: 'ethereum',
+  type: 'swap',
+  tokenIn: 'USDC',
+  tokenOut: 'PEPE',
+  amountIn: 50000,
+});
+
+console.log(`MEV risk: ${risk.level}`);  // 'low' | 'medium' | 'high'
+console.log(`Estimated max loss: $${risk.maxLoss}`);
+console.log(`Recommendation: ${risk.recommendation}`);
+
+if (risk.level === 'high') {
+  console.log('⚠️ High MEV risk - use protection!');
+}
+```
+
+### Protection Levels
+
+```typescript
+// Aggressive - maximum protection, slower
+mev.setLevel('aggressive', {
+  usePrivateMempool: true,
+  bundleOnly: true,
+  maxSlippage: 0.1,
+  waitForProtection: true,
+});
+
+// Standard - balanced protection
+mev.setLevel('standard', {
+  usePrivateMempool: true,
+  bundleOnly: false,
+  maxSlippage: 0.5,
+});
+
+// Minimal - basic protection
+mev.setLevel('minimal', {
+  usePrivateMempool: false,
+  bundleOnly: false,
+  maxSlippage: 1.0,
+});
+```
+
+---
+
+## MEV Attack Types
+
+| Attack | Description | Protection |
+|--------|-------------|------------|
+| **Sandwich** | Front + backrun your trade | Private mempool |
+| **Front-running** | Copy your trade first | Private mempool |
+| **Back-running** | Profit after your trade | Jito/Flashbots |
+| **JIT Liquidity** | Manipulate pool | Slippage limits |
+
+---
+
+## Protection Providers
+
+| Chain | Provider | Method |
+|-------|----------|--------|
+| **Ethereum** | Flashbots Protect | Private relay |
+| **Ethereum** | MEV Blocker | CoW Protocol |
+| **Solana** | Jito | Bundle submission |
+| **L2s** | Native | Sequencer protection |
+
+---
+
+## When to Use Protection
+
+| Trade Size | Token | Recommendation |
+|------------|-------|----------------|
+| < $1,000 | Major | Minimal |
+| $1,000 - $10,000 | Major | Standard |
+| > $10,000 | Major | Aggressive |
+| Any size | Meme/Low liquidity | Aggressive |
+
+---
+
+## Best Practices
+
+1. **Always protect large trades** — MEV bots watch everything
+2. **Use tight slippage** — Limits attack profitability
+3. **Check before trading** — Simulate MEV risk
+4. **Review transactions** — Learn from past attacks
+5. **L2s are safer** — Sequencer provides natural protection

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/mev/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIH,IAAI,YAAY,GAAuB,OAAO,CAAC;AAE/C,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,wDAAa,mCAAmC,GAAC,CAAC;QAE9D,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,OAAO,uCAAuC,YAAY,+FAA+F,CAAC;YAE5J,KAAK,QAAQ;gBACX,OAAO,uCAAuC,YAAY,iOAAiO,CAAC;YAE9R,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;gBACtC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;oBACpE,OAAO,yCAAyC,CAAC;gBACnD,CAAC;gBACD,YAAY,GAAG,KAAK,CAAC;gBACrB,OAAO,iCAAiC,KAAK,KAAK,CAAC;YACrD,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,KAAK,CAAC,MAAM,CAAC;oBAAE,OAAO,6BAA6B,CAAC;gBACxD,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,aAAa;gBAClC,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC;gBACtE,OAAO,2CAA2C,MAAM,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,kBAAkB,SAAS,GAAG,CAAC;YACxN,CAAC;YAED,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;gBACjD,IAAI,KAAK,CAAC,GAAG,CAAC;oBAAE,OAAO,2CAA2C,CAAC;gBACnE,MAAM,QAAQ,GAAG,GAAG,CAAC,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC3D,OAAO,wBAAwB,GAAG,sBAAsB,QAAQ,SAAS,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;YACtJ,CAAC;YAED;gBACE,OAAO,QAAQ,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO;;;;;;;;;;;6DAWoD,CAAC;AAC9D,CAAC;AAED,kBAAe;IACb,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,qEAAqE;IAClF,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO;CAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/mev/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/bundled/mexc-futures/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: mexc-futures
+description: MEXC Futures trading with DB tracking (No KYC)
+emoji: "🔵"
+commands:
+  - /mx
+gates:
+  envs:
+    - MEXC_API_KEY
+---
+
+# MEXC Futures
+
+Trade perpetual futures on MEXC with up to 200x leverage. No KYC required for small amounts.
+
+## Quick Start
+
+```bash
+# Set credentials
+export MEXC_API_KEY="your-api-key"
+export MEXC_API_SECRET="your-api-secret"
+
+# Check balance
+/mx balance
+
+# Open position
+/mx long BTC_USDT 1 10x
+
+# View stats
+/mx stats
+```
+
+## Commands
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/mx balance` | Check account balance |
+| `/mx positions` | View open positions |
+| `/mx orders` | List open orders |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/mx long <symbol> <vol> [leverage]x` | Open long position |
+| `/mx short <symbol> <vol> [leverage]x` | Open short position |
+| `/mx close <symbol>` | Close position |
+| `/mx closeall` | Close all positions |
+| `/mx leverage <symbol> <value>` | Set leverage |
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/mx price <symbol>` | Get current price |
+| `/mx funding <symbol>` | Check funding rate |
+| `/mx markets [query]` | List markets |
+
+### Database/History
+
+| Command | Description |
+|---------|-------------|
+| `/mx trades [symbol] [limit]` | Trade history from database |
+| `/mx dbstats [symbol] [period]` | Win rate, PnL, profit factor |
+| `/mx dbfunding [symbol]` | Funding payments history |
+| `/mx dbpositions [all]` | Position history |
+
+**Stats periods:** `day`, `week`, `month`
+
+## Examples
+
+```bash
+/mx long BTC_USDT 1 10x        # 10x leveraged long, 1 contract
+/mx short ETH_USDT 5 20x       # 20x leveraged short, 5 contracts
+/mx close BTC_USDT             # Close BTC position
+/mx trades BTC_USDT 20         # Last 20 BTC trades
+/mx stats ETH_USDT week        # ETH stats for past week
+```
+
+## Notes
+
+- MEXC uses contract notation (e.g., `BTC_USDT` not `BTCUSDT`)
+- No KYC required for smaller trading volumes
+- Up to 200x leverage available

package/dist/skills/bundled/mexc-futures/index.d.ts

@@ -8,9 +8,6 @@ declare const skill: {
     name: string;
     description: string;
     commands: string[];
-    requires: {
-        env: string[];
-    };
     handle(args: string): Promise<string>;
 };
 export default skill;

package/dist/skills/bundled/mexc-futures/index.js

@@ -335,7 +335,6 @@ const skill = {
     name: 'mexc-futures',
     description: 'MEXC Futures trading with DB tracking (No KYC, 200x)',
     commands: ['/mx'],
-    requires: { env: ['MEXC_API_KEY', 'MEXC_API_SECRET'] },
     async handle(args) {
         const parts = args.trim().split(/\s+/);
         const cmd = parts[0]?.toLowerCase();