clodds 1.5.1 → 1.5.2

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

@@ -1,242 +1,60 @@
 ---
 name: automation
-description: "Schedule cron jobs, manage webhooks, and automate recurring tasks"
-emoji: "⏰"
+description: "Schedule cron jobs and automate recurring tasks"
+commands:
+  - /auto
+  - /automation
 ---
 
-# Automation - Complete API Reference
+# Automation - Cron Scheduler
 
-Schedule recurring tasks with cron expressions, manage incoming webhooks, and automate workflows.
+Schedule recurring tasks using cron expressions with preset support.
 
----
-
-## Chat Commands
-
-### Cron Jobs
-
-```
-/cron list                                  # List all scheduled jobs
-/cron add "0 9 * * *" "scan for arbs"       # Add daily 9am job
-/cron add "*/30 * * * *" "check prices"     # Every 30 minutes
-/cron remove <job-id>                       # Remove job
-/cron enable <job-id>                       # Enable job
-/cron disable <job-id>                      # Disable job
-/cron run <job-id>                          # Run job now
-/cron history <job-id>                      # View run history
-```
+## Commands
 
-### Webhooks
-
-```
-/webhook list                               # List webhooks
-/webhook add <name> <url>                   # Add webhook endpoint
-/webhook remove <name>                      # Remove webhook
-/webhook test <name>                        # Send test payload
-/webhook logs <name>                        # View webhook logs
-```
-
-### Heartbeat
-
-```
-/heartbeat config --interval 60             # Set heartbeat interval
-/heartbeat status                           # View heartbeat status
-/heartbeat enable                           # Enable heartbeats
-/heartbeat disable                          # Disable heartbeats
 ```
-
----
-
-## TypeScript API Reference
-
-### Cron Scheduler
-
-```typescript
-import { createCronScheduler } from 'clodds/automation';
-
-const cron = createCronScheduler({
-  timezone: 'America/New_York',
-  autoStart: true,
-});
-
-// Add a job
-const jobId = cron.addJob({
-  name: 'daily-arb-scan',
-  schedule: '0 9 * * *',  // 9am daily
-  task: async () => {
-    console.log('Running arbitrage scan...');
-    // Your logic here
-  },
-  enabled: true,
-});
-
-// List jobs
-const jobs = cron.listJobs();
-for (const job of jobs) {
-  console.log(`${job.id}: ${job.name} (${job.schedule})`);
-  console.log(`  Next run: ${job.nextRun}`);
-  console.log(`  Enabled: ${job.enabled}`);
-}
-
-// Remove job
-cron.removeJob(jobId);
-
-// Enable/disable
-cron.enableJob(jobId);
-cron.disableJob(jobId);
-
-// Run immediately
-await cron.runJob(jobId);
-
-// Get history
-const history = cron.getHistory(jobId, { limit: 10 });
-for (const run of history) {
-  console.log(`${run.timestamp}: ${run.status} (${run.duration}ms)`);
-}
+/auto list                            - List all scheduled jobs
+/auto cron <schedule> <command>       - Create a cron job
+/auto remove <id>                     - Remove a job
+/auto enable <id>                     - Enable a job
+/auto disable <id>                    - Disable a job
+/auto trigger <id>                    - Manually run a job
+/auto presets                         - Show available schedule presets
 ```
 
-### Cron Expressions
+## Cron Expressions
 
 | Expression | Description |
 |------------|-------------|
 | `* * * * *` | Every minute |
 | `0 * * * *` | Every hour |
 | `0 9 * * *` | Daily at 9am |
-| `0 9 * * 1-5` | Weekdays at 9am |
 | `*/15 * * * *` | Every 15 minutes |
 | `0 0 1 * *` | First of month |
 
-### Webhook Manager
+## Presets
 
-```typescript
-import { createWebhookManager } from 'clodds/automation';
+Instead of a cron expression, you can use a named preset:
 
-const webhooks = createWebhookManager({
-  secret: process.env.WEBHOOK_SECRET,
-  validateSignatures: true,
-});
-
-// Register webhook endpoint
-webhooks.register({
-  name: 'trade-alerts',
-  handler: async (payload) => {
-    console.log('Received:', payload);
-    // Process webhook
-    return { status: 'ok' };
-  },
-  validatePayload: (payload) => {
-    return payload.type && payload.data;
-  },
-});
-
-// Get webhook URL
-const url = webhooks.getUrl('trade-alerts');
-console.log(`Webhook URL: ${url}`);
-
-// Send test
-await webhooks.test('trade-alerts', {
-  type: 'test',
-  data: { message: 'Hello' },
-});
-
-// View logs
-const logs = webhooks.getLogs('trade-alerts', { limit: 10 });
-for (const log of logs) {
-  console.log(`${log.timestamp}: ${log.status}`);
-  console.log(`  Payload: ${JSON.stringify(log.payload)}`);
-}
-
-// Remove webhook
-webhooks.remove('trade-alerts');
 ```
-
-### Heartbeat Service
-
-```typescript
-import { createHeartbeatService } from 'clodds/automation';
-
-const heartbeat = createHeartbeatService({
-  intervalMs: 60000,  // 1 minute
-  endpoint: 'https://healthcheck.example.com/ping',
-  onFailure: (error) => {
-    console.error('Heartbeat failed:', error);
-  },
-});
-
-// Start
-heartbeat.start();
-
-// Get status
-const status = heartbeat.getStatus();
-console.log(`Last ping: ${status.lastPing}`);
-console.log(`Failures: ${status.failures}`);
-console.log(`Uptime: ${status.uptime}%`);
-
-// Stop
-heartbeat.stop();
+/auto cron EVERY_MINUTE check-prices
+/auto cron EVERY_5_MINUTES portfolio-sync
+/auto cron EVERY_15_MINUTES scan-arbs
+/auto cron HOURLY report
+/auto cron DAILY_MIDNIGHT snapshot
+/auto cron DAILY_9AM morning-scan
+/auto cron WEEKLY_MONDAY_9AM weekly-report
+/auto cron MONTHLY monthly-summary
 ```
 
----
+## Examples
 
-## Example Automations
-
-### Daily Arbitrage Scan
-
-```typescript
-cron.addJob({
-  name: 'daily-arb',
-  schedule: '0 9,12,15,18 * * *',  // 9am, 12pm, 3pm, 6pm
-  task: async () => {
-    const opportunities = await opportunityFinder.scan();
-    if (opportunities.length > 0) {
-      await notify(`Found ${opportunities.length} arbitrage opportunities`);
-    }
-  },
-});
 ```
-
-### Portfolio Snapshot
-
-```typescript
-cron.addJob({
-  name: 'portfolio-snapshot',
-  schedule: '0 0 * * *',  // Midnight daily
-  task: async () => {
-    const portfolio = await trading.getPortfolio();
-    await database.saveSnapshot({
-      timestamp: Date.now(),
-      value: portfolio.totalValue,
-      positions: portfolio.positions.length,
-    });
-  },
-});
+/auto cron "*/5 * * * *" portfolio-sync
+/auto cron HOURLY check-positions
+/auto list
+/auto trigger job-1234567890
+/auto disable job-1234567890
+/auto remove job-1234567890
+/auto presets
 ```
-
-### Webhook for External Signals
-
-```typescript
-webhooks.register({
-  name: 'external-signals',
-  handler: async (payload) => {
-    if (payload.signal === 'buy') {
-      await executor.marketBuy({
-        platform: 'polymarket',
-        marketId: payload.marketId,
-        side: 'YES',
-        size: 100,
-      });
-    }
-    return { executed: true };
-  },
-});
-```
-
----
-
-## Best Practices
-
-1. **Use meaningful job names** - Easy to identify later
-2. **Set appropriate intervals** - Don't spam APIs
-3. **Handle failures gracefully** - Add retry logic
-4. **Monitor job history** - Check for failures
-5. **Validate webhook payloads** - Prevent bad data
-6. **Use heartbeats** - Know when system is down

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

@@ -32,8 +32,9 @@ Validate trading strategies using historical data, walk-forward analysis, and Mo
 
 ```
 /backtest results                  Show recent results
+/backtest stats                    Alias for results
 /backtest results <id> --detailed  Detailed breakdown
-/backtest export <id>              Export to CSV
+/backtest export                   Export last results as CSV
 ```
 
 ---

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

@@ -25,8 +25,9 @@ Securely store and manage API credentials for trading platforms with AES-256-GCM
 
 ```
 /creds list                                 List configured platforms
-/creds status                               Check credential health
+/creds status                               Encryption system status
 /creds test polymarket                      Test API connection
+/creds check polymarket                     Verify credentials work
 ```
 
 ### Remove Credentials

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

@@ -19,13 +19,16 @@ Compare prediction market prices to external models, polls, and data sources to
 
 ### Compare Specific Market
 ```
-/compare "Trump 2028" 538 betting-odds
+/edge compare "Trump 2028" 538 betting-odds
+/edge compare "BTC above 100k" polymarket kalshi
 ```
 
 ### Kelly Calculator
 ```
-/kelly 0.45 0.55 1000
-# market price, your estimate, bankroll
+/edge kelly 0.6 2.0 1000
+# probability, decimal odds, bankroll
+/edge kelly 55 2.5
+# 55% prob, 2.5 odds, $100 default bankroll
 ```
 
 ## Data Sources

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

@@ -1,257 +1,46 @@
 ---
 name: sandbox
-description: "Safe code execution in Docker containers with resource limits"
-emoji: "📦"
-gates:
-  envs:
-    anyOf:
-      - DOCKER_HOST
+description: "Visual HTML canvas sandbox for agent-driven UI and live previews"
+commands:
+  - /sandbox
+  - /canvas
 ---
 
-# Sandbox - Complete API Reference
+# Sandbox - Visual Canvas
 
-Execute code safely in isolated Docker containers with resource limits and timeout protection.
+Push HTML content to a live-updating canvas server for visual previews, dashboards, and agent-driven UI.
 
----
-
-## Chat Commands
-
-### Run Code
+## Commands
 
 ```
-/run python "print('Hello')"                Run Python code
-/run node "console.log('Hi')"               Run JavaScript
-/run bash "ls -la"                          Run shell command
-/run ruby "puts 'Hello'"                    Run Ruby code
+/sandbox start        - Start the canvas server (returns URL)
+/sandbox push <html>  - Push HTML content to the canvas
+/sandbox reset        - Reset canvas to blank state
+/sandbox screenshot   - Take a screenshot of the current canvas
+/sandbox status       - Show canvas server status and settings
 ```
 
-### With Options
+## Environment Variables
 
-```
-/run python "code" --timeout 30             Set timeout (seconds)
-/run node "code" --memory 512               Memory limit (MB)
-/run python "code" --file script.py         From file
-```
+| Variable | Description |
+|----------|-------------|
+| `CANVAS_ALLOW_JS_EVAL` | Enable JavaScript evaluation in canvas (default: `false`) |
+| `ALLOW_UNSAFE_SANDBOX` | Enable unsafe sandbox mode (default: `false`) |
 
-### Sandbox Management
+## Examples
 
 ```
-/sandbox status                             Container status
-/sandbox images                             Available images
-/sandbox cleanup                            Remove old containers
-```
-
----
-
-## TypeScript API Reference
-
-### Create Sandbox
-
-```typescript
-import { createSandbox } from 'clodds/sandbox';
-
-const sandbox = createSandbox({
-  // Docker settings
-  dockerHost: process.env.DOCKER_HOST,
-
-  // Default limits
-  defaultTimeoutMs: 30000,
-  defaultMemoryMB: 256,
-  defaultCpuShares: 512,
-
-  // Cleanup
-  autoCleanup: true,
-  maxContainerAgeMs: 3600000,
-});
-```
-
-### Run Code
-
-```typescript
-// Run Python
-const result = await sandbox.run({
-  language: 'python',
-  code: `
-import math
-print(f"Pi is {math.pi}")
-  `,
-});
-
-console.log(`Output: ${result.stdout}`);
-console.log(`Exit code: ${result.exitCode}`);
-console.log(`Duration: ${result.durationMs}ms`);
-
-// Run with limits
-const result = await sandbox.run({
-  language: 'node',
-  code: `console.log('Hello from Node.js')`,
-  timeout: 10000,
-  memoryMB: 128,
-});
-```
-
-### Supported Languages
-
-```typescript
-// Python
-await sandbox.run({ language: 'python', code: 'print("Hello")' });
-
-// JavaScript (Node.js)
-await sandbox.run({ language: 'node', code: 'console.log("Hello")' });
-
-// Bash
-await sandbox.run({ language: 'bash', code: 'echo "Hello"' });
-
-// Ruby
-await sandbox.run({ language: 'ruby', code: 'puts "Hello"' });
-
-// Go
-await sandbox.run({ language: 'go', code: 'package main\nimport "fmt"\nfunc main() { fmt.Println("Hello") }' });
-```
-
-### Run From File
-
-```typescript
-const result = await sandbox.runFile({
-  language: 'python',
-  filePath: '/path/to/script.py',
-  args: ['--input', 'data.csv'],
-});
-```
-
-### Install Packages
-
-```typescript
-// Python packages
-const result = await sandbox.run({
-  language: 'python',
-  code: `
-import pandas as pd
-print(pd.__version__)
-  `,
-  packages: ['pandas', 'numpy'],
-});
-
-// Node packages
-const result = await sandbox.run({
-  language: 'node',
-  code: `
-const _ = require('lodash');
-console.log(_.VERSION);
-  `,
-  packages: ['lodash'],
-});
+/sandbox start
+/sandbox push <h1>Hello World</h1><p>Live preview</p>
+/sandbox screenshot
+/sandbox status
+/sandbox reset
 ```
 
-### Resource Limits
-
-```typescript
-const result = await sandbox.run({
-  language: 'python',
-  code: 'import time; time.sleep(100)',
-
-  // Limits
-  timeout: 5000,        // 5 second timeout
-  memoryMB: 256,        // 256 MB RAM
-  cpuShares: 512,       // CPU shares (default 1024)
-  networkDisabled: true, // No network access
-});
-```
-
-### Container Management
-
-```typescript
-// Get status
-const status = await sandbox.getStatus();
-console.log(`Running containers: ${status.running}`);
-console.log(`Total containers: ${status.total}`);
-
-// List available images
-const images = await sandbox.listImages();
-for (const img of images) {
-  console.log(`${img.language}: ${img.image}`);
-}
-
-// Cleanup old containers
-await sandbox.cleanup({
-  olderThan: '1h',
-  status: 'exited',
-});
-```
-
----
-
-## Language Images
-
-| Language | Image | Version |
-|----------|-------|---------|
-| **python** | python:3.11-slim | 3.11 |
-| **node** | node:20-slim | 20.x |
-| **bash** | alpine:latest | Alpine |
-| **ruby** | ruby:3.2-slim | 3.2 |
-| **go** | golang:1.21-alpine | 1.21 |
-
----
-
-## Resource Limits
-
-| Resource | Default | Max |
-|----------|---------|-----|
-| **Timeout** | 30s | 300s |
-| **Memory** | 256 MB | 2048 MB |
-| **CPU** | 512 shares | 2048 shares |
-| **Disk** | 100 MB | 1 GB |
-
----
-
-## Security
-
-| Feature | Description |
-|---------|-------------|
-| **Isolation** | Each run in separate container |
-| **No network** | Network disabled by default |
-| **No volumes** | No host filesystem access |
-| **Read-only** | Filesystem is read-only |
-| **Resource caps** | Memory and CPU limits |
-| **Timeout** | Force kill after timeout |
-
----
-
-## Use Cases
-
-### Run Backtest
-
-```typescript
-const result = await sandbox.run({
-  language: 'python',
-  code: backtestCode,
-  packages: ['pandas', 'numpy', 'ta'],
-  timeout: 60000,
-  memoryMB: 512,
-});
-```
-
-### Data Processing
-
-```typescript
-const result = await sandbox.run({
-  language: 'python',
-  code: `
-import json
-data = ${JSON.stringify(inputData)}
-result = process(data)
-print(json.dumps(result))
-  `,
-});
-const output = JSON.parse(result.stdout);
-```
-
----
-
-## Best Practices
+## How It Works
 
-1. **Set timeouts** — Prevent runaway code
-2. **Limit memory** — Avoid OOM
-3. **Disable network** — Unless needed
-4. **Use slim images** — Faster startup
-5. **Cleanup regularly** — Remove old containers
+1. `/sandbox start` launches a local HTTP server that serves the canvas page
+2. `/sandbox push <html>` sends HTML to the canvas, rendered in real time
+3. `/sandbox screenshot` captures the current canvas state as an image
+4. `/sandbox reset` clears all HTML, CSS, and JS from the canvas
+5. `/sandbox status` shows whether the server is running, the URL, and content sizes