clodds 1.2.8 → 1.3.0

package/dist/skills/bundled/search-config/SKILL.md

@@ -0,0 +1,257 @@
+---
+name: search-config
+description: "Search indexing configuration and full-text search management"
+emoji: "🔎"
+---
+
+# Search Config - Complete API Reference
+
+Configure search indexing, manage search backends, and optimize full-text search.
+
+---
+
+## Chat Commands
+
+### View Status
+
+```
+/search-config                              Show search config
+/search-config status                       Index status
+/search-config stats                        Search statistics
+```
+
+### Index Management
+
+```
+/search-config rebuild                      Rebuild all indexes
+/search-config rebuild memories             Rebuild specific index
+/search-config optimize                     Optimize indexes
+/search-config clear <index>                Clear index
+```
+
+### Configuration
+
+```
+/search-config backend sqlite               Set backend
+/search-config backend elasticsearch        Use Elasticsearch
+/search-config mode hybrid                  Set search mode
+/search-config boost semantic 0.7           Set semantic weight
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Search Service
+
+```typescript
+import { createSearchService } from 'clodds/search';
+
+const search = createSearchService({
+  // Backend
+  backend: 'sqlite',  // 'sqlite' | 'elasticsearch' | 'typesense' | 'meilisearch'
+
+  // Search mode
+  mode: 'hybrid',  // 'fulltext' | 'semantic' | 'hybrid'
+
+  // Hybrid weights
+  semanticWeight: 0.6,
+  fulltextWeight: 0.4,
+
+  // Embedding provider (for semantic)
+  embeddings: {
+    provider: 'openai',
+    model: 'text-embedding-3-small',
+  },
+
+  // Storage
+  dbPath: './search.db',
+});
+```
+
+### Index Documents
+
+```typescript
+// Index single document
+await search.index({
+  collection: 'memories',
+  id: 'mem-1',
+  content: 'User prefers conservative trading',
+  metadata: {
+    type: 'preference',
+    userId: 'user-123',
+  },
+});
+
+// Index batch
+await search.indexBatch({
+  collection: 'documents',
+  documents: [
+    { id: 'doc-1', content: 'First document', metadata: {} },
+    { id: 'doc-2', content: 'Second document', metadata: {} },
+  ],
+});
+```
+
+### Search
+
+```typescript
+// Full-text search
+const results = await search.search({
+  query: 'trading strategies',
+  collection: 'documents',
+  limit: 10,
+});
+
+for (const result of results) {
+  console.log(`${result.id}: ${result.score}`);
+  console.log(`  ${result.snippet}`);
+}
+
+// With filters
+const results = await search.search({
+  query: 'bitcoin',
+  collection: 'news',
+  filters: {
+    date: { gte: '2024-01-01' },
+    source: 'reuters',
+  },
+  limit: 20,
+});
+```
+
+### Hybrid Search
+
+```typescript
+// Combine full-text and semantic
+const results = await search.hybridSearch({
+  query: 'how to manage risk in trading',
+  collection: 'documents',
+  semanticWeight: 0.7,
+  fulltextWeight: 0.3,
+  limit: 10,
+});
+```
+
+### Get Index Stats
+
+```typescript
+const stats = await search.getStats();
+
+console.log('Index Statistics:');
+for (const [collection, info] of Object.entries(stats.collections)) {
+  console.log(`${collection}:`);
+  console.log(`  Documents: ${info.documentCount}`);
+  console.log(`  Size: ${info.sizeMB} MB`);
+  console.log(`  Last indexed: ${info.lastIndexed}`);
+}
+
+console.log(`\nSearch Stats:`);
+console.log(`  Queries today: ${stats.queriesToday}`);
+console.log(`  Avg latency: ${stats.avgLatencyMs}ms`);
+console.log(`  Cache hit rate: ${stats.cacheHitRate}%`);
+```
+
+### Rebuild Index
+
+```typescript
+// Rebuild all indexes
+await search.rebuildAll();
+
+// Rebuild specific collection
+await search.rebuild('memories');
+
+// With progress callback
+await search.rebuild('documents', {
+  onProgress: (progress) => {
+    console.log(`${progress.current}/${progress.total} (${progress.percent}%)`);
+  },
+});
+```
+
+### Optimize Index
+
+```typescript
+// Optimize for better performance
+await search.optimize();
+
+// Optimize specific collection
+await search.optimize('documents');
+```
+
+### Clear Index
+
+```typescript
+// Clear specific collection
+await search.clear('memories');
+
+// Clear all
+await search.clearAll();
+```
+
+### Configure Backend
+
+```typescript
+// Switch to Elasticsearch
+await search.setBackend('elasticsearch', {
+  url: process.env.ELASTICSEARCH_URL,
+  index: 'clodds',
+});
+
+// Switch to Typesense
+await search.setBackend('typesense', {
+  url: process.env.TYPESENSE_URL,
+  apiKey: process.env.TYPESENSE_API_KEY,
+});
+```
+
+---
+
+## Search Backends
+
+| Backend | Best For | Features |
+|---------|----------|----------|
+| **SQLite** | Development, small data | Simple, embedded |
+| **Elasticsearch** | Production, large data | Scalable, powerful |
+| **Typesense** | Fast search | Typo tolerance |
+| **Meilisearch** | Instant search | Easy setup |
+
+---
+
+## Search Modes
+
+| Mode | Description |
+|------|-------------|
+| `fulltext` | Traditional keyword matching |
+| `semantic` | Vector similarity search |
+| `hybrid` | Combined (best of both) |
+
+---
+
+## Hybrid Search Weights
+
+```typescript
+// More emphasis on meaning
+const results = await search.hybridSearch({
+  query: 'risk management',
+  semanticWeight: 0.8,  // 80% semantic
+  fulltextWeight: 0.2,  // 20% keyword
+});
+
+// More emphasis on exact matches
+const results = await search.hybridSearch({
+  query: 'BTCUSDT',
+  semanticWeight: 0.2,  // 20% semantic
+  fulltextWeight: 0.8,  // 80% keyword
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use hybrid search** — Best results for most queries
+2. **Rebuild periodically** — Keep indexes fresh
+3. **Optimize after bulk inserts** — Improve performance
+4. **Monitor latency** — Scale if too slow
+5. **Tune weights** — Adjust semantic/fulltext balance

package/dist/skills/bundled/search-config/index.js

@@ -145,8 +145,8 @@ Adjust with:
                 return helpText();
         }
     }
-    catch {
-        return helpText();
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
 function helpText() {

package/dist/skills/bundled/search-config/index.js.map

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

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

@@ -0,0 +1,251 @@
+---
+name: sessions
+description: "Session management, conversation history, and checkpoints"
+emoji: "💬"
+---
+
+# Sessions - Complete API Reference
+
+Manage conversation sessions, history, checkpoints, and resets across channels.
+
+---
+
+## Chat Commands
+
+### Session Control
+
+```
+/new                                        Start new conversation
+/reset                                      Reset current session
+/session                                    View session info
+/session list                               List active sessions
+```
+
+### Checkpoints
+
+```
+/checkpoint save "before refactor"          Save checkpoint
+/checkpoint list                            List checkpoints
+/checkpoint restore <id>                    Restore checkpoint
+/checkpoint delete <id>                     Delete checkpoint
+```
+
+### History
+
+```
+/history                                    View conversation history
+/history export                             Export as markdown
+/history clear                              Clear history (keeps session)
+```
+
+### Settings
+
+```
+/session scope main                         Use main session
+/session scope channel                      Per-channel sessions
+/session scope peer                         Per-user sessions
+/session reset-time 00:00                   Set daily reset time
+/session idle-reset 30                      Reset after 30 min idle
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Session Manager
+
+```typescript
+import { createSessionManager } from 'clodds/sessions';
+
+const sessions = createSessionManager({
+  // Session scope
+  scope: 'per-channel-peer',  // 'main' | 'per-peer' | 'per-channel-peer'
+
+  // Auto-reset
+  dailyResetHour: 0,  // Reset at midnight
+  idleResetMinutes: 30,  // Reset after 30 min idle
+
+  // Storage
+  storage: 'sqlite',
+  dbPath: './sessions.db',
+
+  // Encryption
+  encryptTranscripts: true,
+  encryptionKey: process.env.SESSION_KEY,
+});
+```
+
+### Get or Create Session
+
+```typescript
+const session = await sessions.getOrCreateSession({
+  userId: 'user-123',
+  channelId: 'telegram-456',
+  peerId: 'peer-789',
+});
+
+console.log(`Session ID: ${session.id}`);
+console.log(`Created: ${session.createdAt}`);
+console.log(`Messages: ${session.messageCount}`);
+console.log(`Last activity: ${session.lastActivityAt}`);
+```
+
+### Add Message to History
+
+```typescript
+// Add user message
+await sessions.addMessage({
+  sessionId: session.id,
+  role: 'user',
+  content: 'What is my portfolio value?',
+});
+
+// Add assistant message
+await sessions.addMessage({
+  sessionId: session.id,
+  role: 'assistant',
+  content: 'Your portfolio is worth $10,234.56',
+  usage: {
+    inputTokens: 500,
+    outputTokens: 200,
+  },
+});
+```
+
+### Get History
+
+```typescript
+// Get conversation history
+const history = await sessions.getHistory(session.id, {
+  limit: 50,
+  format: 'messages',  // 'messages' | 'markdown' | 'text'
+});
+
+for (const msg of history) {
+  console.log(`[${msg.role}] ${msg.content}`);
+}
+```
+
+### Clear History
+
+```typescript
+// Clear conversation but keep session
+await sessions.clearHistory(session.id);
+```
+
+### Reset Session
+
+```typescript
+// Full reset (new session)
+await sessions.reset({
+  userId: 'user-123',
+  channelId: 'telegram-456',
+});
+```
+
+### Checkpoints
+
+```typescript
+// Save checkpoint
+const checkpoint = await sessions.saveCheckpoint({
+  sessionId: session.id,
+  name: 'Before major change',
+  description: 'Saving state before refactoring trading strategy',
+});
+
+console.log(`Checkpoint ID: ${checkpoint.id}`);
+console.log(`Messages saved: ${checkpoint.messageCount}`);
+
+// List checkpoints
+const checkpoints = await sessions.listCheckpoints(session.id);
+
+for (const cp of checkpoints) {
+  console.log(`${cp.id}: ${cp.name} (${cp.messageCount} messages)`);
+}
+
+// Restore checkpoint
+await sessions.restoreCheckpoint(checkpoint.id);
+
+// Delete checkpoint
+await sessions.deleteCheckpoint(checkpoint.id);
+```
+
+### Export Session
+
+```typescript
+// Export as markdown
+const markdown = await sessions.export(session.id, {
+  format: 'markdown',
+  includeMetadata: true,
+});
+
+// Export as JSON
+const json = await sessions.export(session.id, {
+  format: 'json',
+});
+```
+
+### Session Cleanup
+
+```typescript
+// Delete old sessions
+await sessions.cleanup({
+  olderThan: '30d',  // Delete sessions older than 30 days
+  keepCheckpoints: true,
+});
+```
+
+---
+
+## Session Scopes
+
+| Scope | Description | Use Case |
+|-------|-------------|----------|
+| `main` | Single global session | Personal use |
+| `per-peer` | Session per user | Multi-user, shared channels |
+| `per-channel-peer` | Session per user per channel | Full isolation |
+
+---
+
+## Auto-Reset Behavior
+
+| Trigger | Behavior |
+|---------|----------|
+| **Daily reset** | New session at configured hour |
+| **Idle reset** | New session after inactivity |
+| **Manual reset** | User runs `/new` or `/reset` |
+
+---
+
+## Encryption
+
+When `encryptTranscripts: true`:
+- All messages encrypted with AES-256-GCM
+- Per-session encryption keys
+- Secure key derivation from master key
+
+---
+
+## Context Window Management
+
+```typescript
+// Get context-aware history (for LLM)
+const context = await sessions.getContextHistory({
+  sessionId: session.id,
+  maxTokens: 100000,  // Fit in context window
+  strategy: 'smart',  // 'recent' | 'smart' | 'summarize'
+});
+
+// 'smart' keeps system messages + recent + important messages
+// 'summarize' compresses old messages into summaries
+```
+
+---
+
+## Best Practices
+
+1. **Choose appropriate scope** — Per-channel-peer for multi-user
+2. **Use checkpoints** — Before major changes or experiments
+3. **Export regularly** — Keep backups of important conversations
+4. **Set idle reset** — Prevents stale context
+5. **Enable encryption** — For sensitive conversations

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

@@ -187,7 +187,7 @@ async function execute(args) {
 exports.default = {
     name: 'sessions',
     description: 'Session management, conversation history, and checkpoints',
-    commands: ['/session', '/new', '/reset', '/checkpoint', '/history'],
+    commands: ['/session', '/new', '/reset', '/checkpoint'],
     handle: execute,
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,53 @@
+---
+name: setup
+description: "Setup Wizard — Configure environment for all skills"
+emoji: "🔧"
+commands:
+  - /setup
+---
+
+# Setup Wizard
+
+Interactive onboarding that checks which skills are ready and guides you through configuration.
+
+## Quick Start
+
+```bash
+# See what's configured and what needs setup
+/setup
+
+# Configure a specific category
+/setup defi
+/setup futures
+/setup prediction
+/setup solana
+/setup ai
+
+# Check all environment variables
+/setup env
+
+# Quick health check
+/setup check
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/setup` | Overview of all categories and their status |
+| `/setup defi` | Configure DeFi & DEX skills (EVM chains) |
+| `/setup futures` | Configure Futures & Perps exchanges |
+| `/setup prediction` | Configure Prediction Market platforms |
+| `/setup solana` | Configure Solana DeFi skills |
+| `/setup ai` | Configure AI & Strategy features |
+| `/setup env` | List all environment variables and their status |
+| `/setup check` | Health check across all skills |
+
+## How It Works
+
+The setup wizard:
+1. Scans which environment variables are set
+2. Groups skills by category
+3. Shows what's ready vs what needs configuration
+4. Provides exact `export` commands to copy-paste
+5. Suggests related skills to try first

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

@@ -0,0 +1,21 @@
+---
+name: shield
+description: "Security scanner for code, addresses, and transactions"
+command: shield
+emoji: "🛡️"
+---
+
+# Security Shield
+
+Multi-chain security scanner for code, addresses, transactions, and scam detection.
+
+## Commands
+
+```
+/shield scan <code>                        Scan code for malicious patterns
+/shield check <address>                    Check address safety (auto-detect chain)
+/shield validate <dest> <amt> [token]      Pre-flight transaction validation
+/shield scams [solana|evm]                 List known scam addresses
+/shield status                             Show scanner statistics
+/shield help                               Show help
+```