clodds 1.2.8 → 1.3.0

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

@@ -0,0 +1,235 @@
+---
+name: mcp
+description: "Model Context Protocol server management and tool integration"
+emoji: "🔌"
+---
+
+# MCP - Complete API Reference
+
+Manage Model Context Protocol (MCP) servers, external tools, and AI integrations.
+
+---
+
+## Chat Commands
+
+### Server Management
+
+```
+/mcp list                                   List configured MCP servers
+/mcp status                                 Check server connection status
+/mcp add <name> <command>                   Add new MCP server
+/mcp remove <name>                          Remove MCP server
+/mcp restart <name>                         Restart server
+```
+
+### Tool Interaction
+
+```
+/mcp tools                                  List available tools
+/mcp tools <server>                         Tools from specific server
+/mcp call <server> <tool> [args]            Call a tool directly
+/mcp resources <server>                     List server resources
+```
+
+### Configuration
+
+```
+/mcp config <server>                        View server config
+/mcp config <server> set <key> <value>      Update config
+/mcp logs <server>                          View server logs
+```
+
+---
+
+## TypeScript API Reference
+
+### Create MCP Client
+
+```typescript
+import { createMCPClient } from 'clodds/mcp';
+
+const mcp = createMCPClient({
+  // Transport
+  transport: 'stdio',  // 'stdio' | 'sse'
+
+  // Server command
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-filesystem'],
+
+  // Options
+  timeout: 30000,
+  retries: 3,
+});
+```
+
+### Connect to Server
+
+```typescript
+// Connect
+await mcp.connect();
+
+// Check status
+const status = mcp.getStatus();
+console.log(`Connected: ${status.connected}`);
+console.log(`Server: ${status.serverInfo?.name}`);
+console.log(`Version: ${status.serverInfo?.version}`);
+
+// Disconnect
+await mcp.disconnect();
+```
+
+### List Tools
+
+```typescript
+// Get available tools
+const tools = await mcp.listTools();
+
+for (const tool of tools) {
+  console.log(`${tool.name}: ${tool.description}`);
+  console.log(`  Input schema: ${JSON.stringify(tool.inputSchema)}`);
+}
+```
+
+### Call Tool
+
+```typescript
+// Call a tool
+const result = await mcp.callTool({
+  name: 'read_file',
+  arguments: {
+    path: '/path/to/file.txt',
+  },
+});
+
+console.log(`Result: ${JSON.stringify(result)}`);
+```
+
+### List Resources
+
+```typescript
+// Get available resources
+const resources = await mcp.listResources();
+
+for (const resource of resources) {
+  console.log(`${resource.uri}: ${resource.name}`);
+  console.log(`  Type: ${resource.mimeType}`);
+}
+
+// Read a resource
+const content = await mcp.readResource('file:///path/to/file.txt');
+console.log(content);
+```
+
+### List Prompts
+
+```typescript
+// Get available prompts
+const prompts = await mcp.listPrompts();
+
+for (const prompt of prompts) {
+  console.log(`${prompt.name}: ${prompt.description}`);
+}
+
+// Get prompt content
+const prompt = await mcp.getPrompt('code-review', {
+  code: 'function add(a, b) { return a + b; }',
+});
+
+console.log(prompt.messages);
+```
+
+### MCP Registry
+
+```typescript
+import { createMCPRegistry } from 'clodds/mcp';
+
+const registry = createMCPRegistry({
+  configPath: './mcp-servers.json',
+});
+
+// Add server
+registry.addServer({
+  name: 'filesystem',
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-filesystem', '/home/user'],
+  env: {},
+});
+
+// List servers
+const servers = registry.listServers();
+
+// Get server
+const server = registry.getServer('filesystem');
+
+// Remove server
+registry.removeServer('filesystem');
+
+// Start all servers
+await registry.startAll();
+
+// Stop all servers
+await registry.stopAll();
+```
+
+---
+
+## Popular MCP Servers
+
+| Server | Purpose | Install |
+|--------|---------|---------|
+| **filesystem** | File operations | `@modelcontextprotocol/server-filesystem` |
+| **github** | GitHub API | `@modelcontextprotocol/server-github` |
+| **postgres** | Database queries | `@modelcontextprotocol/server-postgres` |
+| **brave-search** | Web search | `@modelcontextprotocol/server-brave-search` |
+| **puppeteer** | Browser automation | `@modelcontextprotocol/server-puppeteer` |
+
+---
+
+## Server Configuration
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
+      "env": {}
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_..."
+      }
+    }
+  }
+}
+```
+
+---
+
+## CLI Commands
+
+```bash
+# List MCP servers
+clodds mcp list
+
+# Add MCP server
+clodds mcp add filesystem "npx -y @modelcontextprotocol/server-filesystem /home"
+
+# Test server connection
+clodds mcp test filesystem
+
+# Remove server
+clodds mcp remove filesystem
+```
+
+---
+
+## Best Practices
+
+1. **Use official servers** — Start with well-tested MCP servers
+2. **Limit file access** — Restrict filesystem server to specific directories
+3. **Secure credentials** — Use env vars for tokens, not command args
+4. **Monitor logs** — Check server logs for errors
+5. **Timeout handling** — Set appropriate timeouts for slow operations

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

@@ -44,7 +44,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const logger_1 = require("../../../utils/logger");
 function helpText() {
     return `**MCP Commands**
 
@@ -199,8 +198,7 @@ async function execute(args) {
         }
     }
     catch (error) {
-        logger_1.logger.debug({ error }, 'MCP skill init failed');
-        return helpText();
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
 exports.default = {

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

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

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/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
+```